自定义界面与 SDK Run Modes

三种运行模式

InteractiveMode 提供完整 TUI，runPrintMode 发送初始消息并输出结果，runRpcMode 在当前进程启动 JSONL 协议。它们都建立在 createAgentSessionRuntime 之上。

自定义应用可以通过 services 工厂共享模型、资源和诊断，但每个 Session 的状态必须独立。

• 终端产品使用 InteractiveMode。
• 一次性 CLI 使用 runPrintMode。
• 跨进程客户端使用 runRpcMode。
• 同进程 Node.js 集成优先直接使用 AgentSession。
• 不同语言或隔离需求优先 RPC。

生命周期

Run Mode 结束时关闭流、Extension 资源和持久化写入。对 SIGINT、超时和客户端断开做显式处理。

接口层不要直接暴露无限工具和宿主文件系统。