Files
orca/docs
Brennan Benson c5733d7367 List and read any agent by its Orca session ID: orca agent list/show/read (#41815)
* feat(cli): list and read agents by their Orca session ID with orca agent list/show/read

Live terminal and chat agents are listed, shown and read by Orca session ID on the selected host; sleeping native agents can be shown and read by ID. Chat reads walk the chat's own bounded history pages back to the latest /clear.

* fix(cli): agent show names a live agent and its last reply as agent list does; help says sleeping terminal agents aren't listed yet

* Bound agent reads and scoped workspace inventories

* fix(cli): agent read carries the conversation's state, so a running chat turn reads as working

agent read now reports the same state agent list/show report, from the same status
rows, in text (a leading state line) and --json (state). A turn still running no
longer reads like a finished chat with no reply.

* Fix agent conversation read consistency and limits

* fix(cli): agent read derives its state from the history it returns

agent read no longer samples live status. A chat's state comes from the
journal snapshot that produced its entries: an open turn or an accepted
send with no turn yet reads working; done needs an explicitly successful
latest turn whose reply is the newest entry shown. A terminal agent's
state comes from the provider turn markers in the same transcript bytes:
a prompt with no end after it reads working, done needs an explicit end
(Claude stop_reason, Codex task_complete) with the reply as the newest
entry. Anything else omits state. The journal lane wait added for the
live state is removed.

* Tighten agent read snapshot evidence

* Keep agent read done for finished turns

A dead owner now only voids working. Codex completion is proved by the turn's own
decoded reply rather than row adjacency, and Claude's by its end row's own reply,
without needing the prompt inside the read window.

* Adapt agent commands to reorganized shared contracts

* Warn on incomplete agent lists, read sleeping transcript paths, and retry unanswered provider id lookups

* Follow main's moved shared modules

* Bound live transcript recovery to conversation panes

* Show sleeping terminal agents where agent list lists them

agent list lists a finished terminal agent while its pane sleeps, since main keeps
that status row. agent show now counts the same sleeping place, and the help says
which sleeping agents are listed. Messaging still ignores sleeping panes.

* Clarify sleeping agent discovery and messaging help

* Say sleeping terminal agents can't be messaged and note the WSL read exception

* Follow the moved CLI argument boundary after rebasing

* Show plain Orca session IDs in agent command help

* Expect plain UUID Orca session IDs in the transcript source test

* Follow main's moved shared modules after rebasing

* Name Orca session IDs <id> in agent help, since older IDs keep their agent prefix

* Follow main's moved agent-session modules after rebasing
2026-11-16 14:07:46 -08:00
..