ADR-0003 Codex 通过 app-server 接入

状态：Accepted · 日期：2026-10-22

决策

使用 codex app-server（JSON-RPC over stdio），不使用 Codex TS SDK 或 codex exec --json。

理由

只有 app-server 支持服务端向客户端发起审批请求，满足交互审批需求
事件粒度最细（item + delta），支持 thread 恢复、turn 中断、账户状态查询
与官方 VS Code 插件使用同一协议，长期维护有保障

代价

协议仍标注 experimental：锁定 CLI 版本，用 codex app-server generate-ts 生成类型并纳入版本控制
需要自己实现 JSON-RPC 客户端和进程管理（每份凭证一个常驻进程）