docs(agent): mark coordination API experimental

This commit is contained in:
Aamer Akhter committed 2026-10-24 22:37:18 -04:00
1 parent 4c2f050a96
commit 1a2c3be0ea
12 files changed
+61 -12

No files matched your search

+1 -1
View File
@@ -30,7 +30,7 @@ through: the verbs in detail (the old §5) in [reference/verbs.md](reference/ver
worked multi-worker flows in [reference/recipes.md](reference/recipes.md), endpoint
tables and a symptom gallery in [reference/endpoints.md](reference/endpoints.md), and
direct messaging to claude workers in [reference/messaging.md](reference/messaging.md).
Bounded inspection and guarded stage/submit load only when needed from
Experimental bounded inspection and guarded stage/submit load only when needed from
[reference/inspection-and-staging.md](reference/inspection-and-staging.md).
This skill works the same whichever CLI you are: Codeman puts it where each CLI looks
@@ -1,4 +1,11 @@
# Bounded inspection and guarded submission
# Experimental bounded inspection and guarded submission
**Experimental:** `codeman agent inspect`, `stage` and `submit`, and their
`/api/v1/sessions/:id/inspect|stage|submit` routes (including `/api` aliases),
are excluded from the stable CLI/HTTP contract. Their commands, flags, paths,
payloads and behavior may change or be removed in a minor or patch release.
Pin a compatible Codeman version when automating them. Authentication and
session ownership checks still apply.
Use these commands inside a Codeman session. They use its authenticated HTTP API.
They supplement `send`, `wait` and `read` over the same HTTP transport; no direct
@@ -814,7 +814,10 @@ Rules that matter:
- **Lifetime.** An inbox goes with its session on delete. A server restart empties all
inboxes unless the user turned on *Keep agent inbox across restarts* in Settings.
## Bounded inspection and guarded submission
## Experimental bounded inspection and guarded submission
These three commands and their HTTP routes may change or be removed in minor or
patch releases; they are excluded from the stable CLI/HTTP contract.
Use `codeman agent inspect` for bounded evidence and incremental local Codex cursors.
Use `codeman agent stage --message-file` followed by one hash-confirmed