feat(cli): add --pane-id option to dump-screen action (#4598)

* feat(cli): add --pane-id option to dump-screen action

Adds the ability to dump a specific terminal pane's content by passing
`--pane-id <ID>` to the `dump-screen` CLI action. When omitted, the
existing behavior of dumping the focused pane is preserved.

This enables coding agents running inside Zellij to inspect the content
of other panes programmatically, without needing complex workarounds.

Prior art: https://github.com/theslyprofessor/zellij-pane-tracker, whose
design complexity is due to current limitations that this PR addresses.

* address review

* improve man page entry

1 files changed, 4 insertions, 0 deletions

diff --git a/zellij-utils/src/plugin_api/action.rs b/zellij-utils/src/plugin_api/action.rs
index b115b86d..5ccd349c 100644
--- a/zellij-utils/src/plugin_api/action.rs
+++ b/zellij-utils/src/plugin_api/action.rs
@@ -213,9 +213,11 @@ impl TryFrom<ProtobufAction> for Action {
                 Some(OptionalPayload::DumpScreenPayload(payload)) => {
                     let file_path = payload.file_path;
                     let include_scrollback = payload.include_scrollback;
+                    let pane_id = payload.pane_id.and_then(|p| p.try_into().ok());
                     Ok(Action::DumpScreen {
                         file_path,
                         include_scrollback,
+                        pane_id,
                     })
                 },
                 _ => Err("Wrong payload for Action::DumpScreen"),
@@ -1146,11 +1148,13 @@ impl TryFrom<Action> for ProtobufAction {
             Action::DumpScreen {
                 file_path,
                 include_scrollback,
+                pane_id,
             } => Ok(ProtobufAction {
                 name: ProtobufActionName::DumpScreen as i32,
                 optional_payload: Some(OptionalPayload::DumpScreenPayload(DumpScreenPayload {
                     file_path,
                     include_scrollback,
+                    pane_id: pane_id.and_then(|p| p.try_into().ok()),
                 })),
             }),
             Action::EditScrollback => Ok(ProtobufAction {