API 与协议参考

核对公开 REST、SSE、执行器和错误协议。

本组文档

• 地址、身份与权限：REST /v1 与 MCP 地址；Bearer Key、可信 Subject、scope/Agent 范围；网页账号身份与 OAuth；401/403 与资源隔离；公共接口清单入口
• 配置与生命周期 API：Agent 与工具集配置、revision 和幂等；max_context_tokens 与 max_result_context_bytes；旧字段删除、发布新版本与会话生效步骤
• 会话与运行 API：capabilities/models/bootstrap/runtime 元数据；Session、历史、Run、追加输入、取消、审批和诊断；逻辑 Agent 与固定版本选择；状态和结束分类
• SSE 事件与恢复：事件信封、sequence、事件类型、展示推理、增量与最终结果、快照/cursor/去重、终态及旧客户端处理未知可选字段
• 执行器与工具回执协议：执行器、claim/grant 与可靠回执；max_result_context_bytes 默认 16 KiB、上限 32 KiB；UTF-8 字节裁剪、完整回执、分页设计与 context_preview 模拟预览
• 错误码、限制与重试：HTTP 状态、稳定错误 code 与安全重试；余额、权限、版本、模型、工具和上下文边界；当前默认值、配置范围及已删除字段