Add agent status command

Author: yieldthought

README.md

@@ -188,6 +188,8 @@ Inspect and talk to agents:
 ```bash
 codexapi agent list
 codexapi agent show ci-fixer
+codexapi agent status ci-fixer
+codexapi agent status --actions ci-fixer
 codexapi agent read ci-fixer
 codexapi agent book ci-fixer
 codexapi agent send ci-fixer "Prefer the smallest safe fix."
@@ -202,6 +204,10 @@ codexapi agent cancel ci-fixer
 codexapi agent delete ci-fixer
 ```
 
+`codexapi agent resume` can reopen a `done` agent. Sending to a `done` or
+`canceled` agent still triggers a one-off wake on the next tick so you can get
+a reply without putting the agent back into continuous heartbeat mode.
+
 Create a child agent explicitly:
 
 ```bash
@@ -222,6 +228,10 @@ wrappers report inconsistent hostnames for the same machine.
 
 `codexapi agent show` also prints the resolved `AGENTBOOK.md` path so you can
 jump directly to the durable working memory file.
+`codexapi agent status` reads the latest turn from the agent's rollout log and
+shows recent commentary plus the final visible output. Pass `--actions` to
+include the tool-action summary. If a wake is still in progress, it shows the
+active turn so far.
 
 See [docs/agent-v1.md](docs/agent-v1.md) for the filesystem model and scheduling
 details.

docs/agent-v1.md

@@ -547,9 +547,10 @@ Processing rules:
 - commands are applied in timestamp order
 - `pause` and `cancel` are applied before starting a new backend wake
 - `send` contributes to the next prompt and increments unread counts until
-  consumed
+  consumed; `done` and `canceled` agents still process queued messages as a
+  one-off wake
 - `wake` means run soon even if no heartbeat is due
-- `resume` only changes state when the agent is paused
+- `resume` reopens a `paused` or `done` agent
 - after successful application, the owner host records the result in state or a
   run record and deletes the claimed file
 
@@ -644,6 +645,7 @@ V1 CLI surface:
 - `codexapi agent read`
 - `codexapi agent book`
 - `codexapi agent show`
+- `codexapi agent status`
 - `codexapi agent send`
 - `codexapi agent wake`
 - `codexapi agent pause`

pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "codexapi"
-version = "0.10.1"
+version = "0.11.0"
 description = "Minimal Python API for running the Codex CLI."
 readme = "README.md"
 requires-python = ">=3.8"

src/codexapi/__init__.py

@@ -27,4 +27,4 @@
     "task_result",
     "lead",
 ]
-__version__ = "0.10.1"
+__version__ = "0.11.0"