Skip to content

docs: co-design agent chat, approval and notification APIs - #53

Closed
guohai wants to merge 3 commits into
mainfrom
docs/agent-control-api
Closed

guohai wants to merge 3 commits into
mainfrom
docs/agent-control-api

Conversation

@guohai

@guohai guohai commented Oct 17, 2026 •

Copy link
Copy Markdown
Contributor

Scripts need conversation history and approval/completion events as well as command submission. This draft defines the protected Astation API/chat/SSE milestone and its ownership split with Atem.

The r2 review of Atem PR #74 at 13f81b3 approves the r8 design for implementation. The four earlier contract findings are closed: required hello revision, ordered page/live delivery, bounded lookup recovery, and persistent coverage without reopen loops. Two draft fixture corrections remain before conformance: the long-turn open counter and the client truncation page byte total. The 12 r8 fixtures are explicitly NOT RUN until implemented; design approval is not deployment approval.

The proposal also records the planned r7.3 control-permission-only session-rule revoke. Astation adopts that change once the exact wire contract and fixtures are published. The local r7.2 approval implementation is separate from this documentation PR and remains unmerged.

Review documents:

Tracker: #52. Files: #51. Native/API readers share one host conversation; HTTP/SSE merge and replay stay in Astation. Browser/account-wide access and offline push keep their existing gates.

Validation: all 12 draft JSON fixtures parse with no duplicate keys and matching revision/name metadata; document links and git whitespace checks pass; the hosted review matches committed bytes. Static inspection reproduces the two fixture inconsistencies. This review does not claim r8 runtime conformance, and no Atem checkout was edited or built.

Generated with SMT smt@agora.build

Define the first complete agent-control API milestone and the joint Atem/Astation history, recovery, approval and notification contract.

🤖 Built with SMT <smt@agora.build>
Correct Codex chat and session-rule support, record remaining r8 agreement points, and distinguish current Astation support from the proposed API.

🤖 Built with SMT <smt@agora.build>
Close the four r1 contract findings, record two draft fixture corrections, and preserve the conformance gate. Track the planned r7.3 permission-only session-rule revocation separately.

🤖 Built with SMT <smt@agora.build>
@guohai guohai closed this Oct 18, 2026
@guohai
guohai deleted the docs/agent-control-api branch October 18, 2026 21:34
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant