docs(oa): define codex stdio terminal authority

2026-06-24 10:05:03 +00:00
parent 668c73b7e0
commit f759149d45
1 changed files with 6 additions and 0 deletions
@@ -109,6 +109,12 @@ Codex stdio backend 必须把 app-server 发来的 JSON-RPC client request 当

 命令执行 trace 必须由 backend/result 层做有界裁剪和摘要，保留 command bytes、output bytes、truncated 标记、stderr 摘要和可展开入口。前端、CLI 或 prompt 不应要求 Code Agent 默认给 shell 命令加 `head`、`grep` 或管道来避免输出过长；输出裁剪属于 trace/result 表达职责，不是工具调用完成条件。

+Codex stdio backend 的终态权威只能来自明确终止事件：Codex app-server 明确返回的 completed、failed 或 canceled terminal event，`turn/interrupt` 的明确取消结果，以及 app-server 或子进程在当前 turn 未得到 terminal 前明确关闭形成的 transport/protocol failure。这些事件必须立即进入 AgentRun terminal status，不得等待 watchdog。
+
+工具调用完成、工具调用失败、assistant final text、final response artifact、stdout/stderr 片段或 trace tail 都不是 terminal authority。Backend adapter 不得因为这些派生信号推断 `completed`，也不得引入 `missing-terminal-after-tool` 一类二级终态超时来替代协议终态。
+
+无事件 watchdog 只负责检测整个 turn 在一段时间内没有任何 backend、stdio、tool 或 activity 事件的沉默卡死。watchdog 阈值必须来自 YAML-first 运行配置；它不能覆盖、延后或修补明确停止事件，也不能作为多来源仲裁或隐式 fallback。
+
 ### 6.3 AR-BACKEND-REQ-003 Profile 隔离与切换

 | 编号 | 短名 | 主责模块 | 关联模块 |