docs: add AGENTS.md guidance for message and approval API patterns#9171
Conversation
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
There was a problem hiding this comment.
💡 Codex Review
Here are some automated review suggestions for this pull request.
Reviewed commit: e216824ab2
ℹ️ About Codex in GitHub
Codex has been enabled to automatically review pull requests in this repo. Reviews are triggered when you
- Open a pull request for review
- Mark a draft as ready
- Comment "@codex review".
If Codex has suggestions, it will comment; otherwise it will react with 👍.
When you sign up for Codex through ChatGPT, Codex can also answer questions or update the PR, like "@codex address that feedback".
| - **Resolution**: Clients respond via standalone endpoints keyed by `requestId`: | ||
| - `POST /v1/confirm` — `{ requestId, decision: "allow" | "deny" }` | ||
| - `POST /v1/secret` — `{ requestId, value, delivery }` | ||
| - `POST /v1/trust-rules` — `{ requestId, pattern, scope }` |
There was a problem hiding this comment.
Include decision in /v1/trust-rules payload docs
The documented request shape for POST /v1/trust-rules omits decision, but the runtime handler requires decision: "allow" | "deny" and returns 400 when it is missing (assistant/src/runtime/routes/approval-routes.ts). This mismatch will cause clients/agents that follow AGENTS.md to send invalid requests and fail to create trust rules.
Useful? React with 👍 / 👎.
Summary
POST /v1/messagesas the single send endpoint (queue-if-busy, fire-and-forget, hub publishing)/v1/confirm,/v1/secret,/v1/trust-rules) keyed byrequestIdFinal PR in the remove-runs plan (PRs #8400, #8407, #8428, #8410, #9166).
Test plan
🤖 Generated with Claude Code