用途：把 Codex 嵌入宿主产品，使用与 OpenAI 官方 Codex 客户端相同的协议，适配 Electron、Swift、Next.js 等不同宿主。
主要能力：区分 App Server 与 Codex SDK 的适用面；选择 stdio 或 WebSocket 传输；生成与运行版本匹配的 schema；实现 initialize 握手、线程（thread/start、resume、fork、read、list）与回合（turn/start、steer、interrupt）管理；渲染 item 流与增量；处理命令执行、文件变更、工具与 requestUserInput 的审批；支持 apiKey、managed chatgpt、chatgptAuthTokens 三种认证模式及账号状态与速率限制展示。
使用方式：先用 ./scripts/generate-schemas.sh ./schemas 生成 schema；从 assets/ 选择对应宿主起步模板（node-stdio-starter、existing-app-auth-bridge、electron-main-process、nextjs-web-sidecar、swift-bridge-patterns）；按“打开传输→发送 initialize→等待响应→发送 initialized”的顺序完成握手，之后才发其他请求。
适用场景：需要嵌入式认证、会话历史、审批、流式事件、review 模式、速率限制或自定义线程 UI 的宿主产品；自动化、CI、服务端任务更适合 Codex SDK。
限制：WebSocket 与 experimentalApi 属可选特性，非最安全的生产默认；浏览器优先的 Web 应用通常需要服务端桥接或宿主管理令牌，因为 managed ChatGPT 流程依赖 localhost 回调；iOS 等受限环境不应假设能启动本地 codex 进程；不要承诺未文档化的订阅管理 API；生产集成需应对背压、重连、Not initialized、Already initialized 与审批中断。