llm-to-agent/docs/features/runtime.md

Runtime 与 Kernel 生命周期

工程基座与依赖边界

实现阶段：P1

• 建立 TypeScript + Node.js 单包工程、统一测试、类型检查和开发命令。
• 落实 main → products → extensions → kernel 的单向依赖。
• 保证 Kernel 不导入具体 Extension，三条产品线的私有扩展互不依赖。

Kernel 与 Extension 生命周期

实现阶段：P1

• Kernel 支持安装 Extension、依次执行 setup/start 并逆序执行 stop。
• Extension 在 setup 中注册能力和事件处理器，所有注册完成后再启动运行资源。
• 处理重复 ID、启动失败、部分初始化清理和停止异常，不留下未知状态。

Runtime 进程生命周期

实现阶段：P1

• 提供常驻 Node.js Runtime、单实例检测、启动、停止、退出信号和基础健康检查。
• 读取配置，创建 Kernel，并装配公共 Extension 与当前启用产品的私有 Extension。
• CLI 在 Runtime 未启动时能够拉起并连接，退出 CLI 不终止 Runtime。

Kernel 状态与首版 Run

实现阶段：P1

• 管理 Space、Conversation、Message、Run、本地 Repository 和当前上下文。
• 创建一个同时包含内存控制器与持久化状态的 Run，支持流式输出、取消和错误记录。
• 跑通 CLI 输入、Kernel 执行、DeepSeek Extension、Run Event 输出和消息持久化的主链路。

产品操作、Run 与事件订阅

实现阶段：P1

• Kernel 为 Space、Conversation、配置和审批等状态操作提供统一入口。
• Kernel 同时提供 Run 提交、查询、取消、继续与事件重订阅入口。
• CLI、Web、Desktop 私有 Extension 分别把终端、网络或 IPC 交互转换为这些入口；进程外启动器只负责连接和输入输出转发。
• 产品断开不影响 Runtime 中 Run 的执行和基本记录完整性。

运行诊断与环境信息

实现阶段：P4

• 提供 Runtime 版本、进程、端口、数据目录、已安装 Extension 和健康状态查询。
• 支持诊断报告、连接恢复、配置来源追踪和调试模式。
• CLI、Web、Desktop 复用同一份诊断数据，各自负责展示。

后台队列与并发运行

实现阶段：P5

• 从首版串行执行发展为后台 Run、排队、按 Space 并发和资源占用控制。
• 支持产品断开后继续运行、重新订阅和跨子 Run 的取消传播。
• 为多 Agent、自动化和长期任务提供统一运行基础。