codexapi 0.10.1__tar.gz → 0.12.2__tar.gz

{codexapi-0.10.1/src/codexapi.egg-info → codexapi-0.12.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: codexapi
-Version: 0.10.1
+Version: 0.12.2
 Summary: Minimal Python API for running the Codex CLI.
 License: MIT
 Keywords: codex,agent,cli,openai
@@ -173,6 +173,10 @@ codexapi agent whoami
 codexapi agent install-cron
 ```
 
+`codexapi agent install-cron` installs one background scheduler hook for this
+`CODEXAPI_HOME`. The wrapper runs `codexapi tick`, which drives the durable
+agent wake scan.
+
 If you skip `install-cron`, `codexapi agent start` warns on stderr because
 background wakes will not run until the scheduler hook is installed.
 When `gh` is installed and authenticated, `agent start` also captures a
@@ -203,6 +207,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."
@@ -212,11 +218,27 @@ codexapi agent wake --wait ci-fixer
 codexapi agent pause ci-fixer
 codexapi agent resume ci-fixer
 codexapi agent resume --wait ci-fixer
+codexapi agent recover ci-fixer
+codexapi agent recover --wait ci-fixer
 codexapi agent set-heartbeat ci-fixer 30
 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.
+For local-owned agents, `send`, `wake`, and `resume` now also nudge an
+immediate non-blocking wake even without `--wait`; `--wait` only changes
+whether the CLI blocks for completion.
+`codexapi agent recover` is for a different failure mode: a local wake that is
+still marked `running` but has stopped making rollout progress. `agent list`,
+`agent show`, and `agent status` now surface stale running wakes, and `recover`
+terminates the stuck local wake, marks it recoverable, and queues a fresh one.
+`agent list` also surfaces queued operator intent for local commands, so a
+paused agent with a queued `resume` shows as `resuming` with separate queued
+message and queued command counts.
+
 Create a child agent explicitly:
 
 ```bash
@@ -237,6 +259,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.

{codexapi-0.10.1 → codexapi-0.12.2}/README.md

@@ -158,6 +158,10 @@ codexapi agent whoami
 codexapi agent install-cron
 ```
 
+`codexapi agent install-cron` installs one background scheduler hook for this
+`CODEXAPI_HOME`. The wrapper runs `codexapi tick`, which drives the durable
+agent wake scan.
+
 If you skip `install-cron`, `codexapi agent start` warns on stderr because
 background wakes will not run until the scheduler hook is installed.
 When `gh` is installed and authenticated, `agent start` also captures a
@@ -188,6 +192,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."
@@ -197,11 +203,27 @@ codexapi agent wake --wait ci-fixer
 codexapi agent pause ci-fixer
 codexapi agent resume ci-fixer
 codexapi agent resume --wait ci-fixer
+codexapi agent recover ci-fixer
+codexapi agent recover --wait ci-fixer
 codexapi agent set-heartbeat ci-fixer 30
 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.
+For local-owned agents, `send`, `wake`, and `resume` now also nudge an
+immediate non-blocking wake even without `--wait`; `--wait` only changes
+whether the CLI blocks for completion.
+`codexapi agent recover` is for a different failure mode: a local wake that is
+still marked `running` but has stopped making rollout progress. `agent list`,
+`agent show`, and `agent status` now surface stale running wakes, and `recover`
+terminates the stuck local wake, marks it recoverable, and queues a fresh one.
+`agent list` also surfaces queued operator intent for local commands, so a
+paused agent with a queued `resume` shows as `resuming` with separate queued
+message and queued command counts.
+
 Create a child agent explicitly:
 
 ```bash
@@ -222,6 +244,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.

{codexapi-0.10.1 → codexapi-0.12.2}/pyproject.toml

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

{codexapi-0.10.1 → codexapi-0.12.2}/src/codexapi/__init__.py

@@ -27,4 +27,4 @@ __all__ = [
     "task_result",
     "lead",
 ]
-__version__ = "0.10.1"
+__version__ = "0.12.2"