Workspace ids look like `w17`. Start here to orient in the session.

Pane ids look like `w17:p1` and are the target of every pane tool.

Status is one of idle, working, blocked, done, unknown. Agents are addressed
by pane id (`w17:p1`) or by their agent name.

target: a pane id like `w17:p1` or an agent name; get them from list_agents.

pane: pane id like `w17:p1` (see list_panes / list_agents).
lines: keep only the last N lines of the snapshot.
source: visible (what the user sees), recent (default scrollback tail),
recent-unwrapped (recent without soft wrapping), detection (bottom buffer
used for agent detection).
Note: herdr may return an empty string for source=recent with lines set on
panes with short scrollback; if that happens, retry without lines or with
source="visible".

target: pane id like `w17:p1` or an agent name; see list_agents.
wait: also wait for the agent to settle (idle, done, or blocked) afterwards.
timeout_ms: only used with wait=True; the call fails if nothing matches in time.

target: pane id like `w17:p1` or an agent name.
until: any of idle, working, blocked, done, unknown. Default: idle, done, blocked.
timeout_ms: the call fails if no requested state is observed in time.

pane: pane id like `w17:p1`. Use run_command to send a command and Enter.

pane: pane id like `w17:p1`. Keys are sent in order; use `esc` for Escape.

pane: pane id like `w17:p1`.
command: argv-style words, e.g. ["git", "status"]. This does not wait for the
command to finish; use wait_for_output or read_pane afterwards.

pane: pane id like `w17:p1`.
pattern: literal substring, or a Rust regular expression when regex=True.
The existing snapshot is searched first, then polled until timeout_ms.
source: visible, recent (default), or recent-unwrapped.

pane: pane id like `w17:p1` to split.
direction: right or down.
ratio: fraction of the split given to the new pane, between 0 and 1.