用途:构建适配层,把 AI 智能体运行时(Claude Code SDK、Codex CLI)包装成多轮对话系统。各运行时接口不同,但可归一化为统一事件模型与共享会话生命周期,让用户持续发消息、恢复会话、分叉线程并接收流式事件。
主要能力:统一适配器接口(createSession、sendMessage、stopTurn、resumeSession、archiveSession、addEventListener、getSession、capabilities);归一化事件模型 {type, data, ts},事件含 session_ready、delta、thinking、tool_start、tool_result、permission_request、permission_resolved、result、done、error;Claude 侧通过 query() 的 resume 选项与 init 消息中的 session_id 实现多轮;Codex 侧通过 codex app-server 子进程以 JSON-RPC 2.0 over stdio 通信,管理 thread 生命周期(thread/start、thread/resume);支持工具权限回调 canUseTool、hooks、AsyncIterable 流式输入,以及生成式 UI 与双向状态同步。
使用方式:Claude 适配器用 @anthropic-ai/claude-code 的 query(),首轮捕获 system init 的 session_id,后续轮传 resume;Codex 用 spawn('codex', ['app-server', '--listen', 'stdio://']),先发 initialize(clientInfo 必填)再发 initialized 通知,thread/start 的线程 ID 位于 result.thread.id。
适用场景:多轮智能体会话、HTTP/WebSocket 后端 sidecar、事件归一化、会话恢复/分叉/归档、stdio 上的 JSON-RPC 2.0 客户端、沙箱工具策略、聊天内富组件渲染。
限制:不适用于一次性调用(直接用 query() 或 codex exec)或构建运行时本身。资料未提供收费、价格、平台与效果信息。