Release Notes

v0.2-code-design

这是 kgent Phase 1 的代码详细设计版本。

本版本目标是把已确认的产品目标、关键特性、整体技术设计和 Phase 1 feature design 落到可执行的代码模块、接口边界、运行流、测试策略和验收标准上，支撑工程师进入 skeleton 与测试优先实现。

范围

本版本新增：

• Phase 1 代码蓝图。
• 配置模块详细设计。
• Runtime 与 Sandbox 模块详细设计。
• Records 模块详细设计。
• Skills 模块详细设计。
• Tools 与 Memory 模块详细设计。
• Engine 模块详细设计。
• Governance 模块详细设计。

关键决策

• runtime/options.py 统一承载 CLI/runtime 边界模型。
• RunContext 只在 sandbox root、workspace 和 RunRecords 准备完成后构造。
• ToolDefinition / ToolHandler 是 kgent-native 工具协议。
• AgentRunRequest.tools 使用 list[ToolDefinition]，Pydantic AI 适配隔离在 tools/pydantic_adapter.py 和 engine/pydantic_ai.py。
• ErrorInfo 统一位于 kgent/errors.py。
• ToolCallRecord 统一位于 records/logs.py。
• RunStatus Phase 1 包含 incomplete，可恢复中断不折叠为普通 failed。

后续方向

v0.2 之后可以进入 Phase 1 代码 skeleton、测试骨架和最小 CLI run 实现。

v0.1-design-baseline

这是 kgent 的第一版设计基线。

本版本目标是固化 kgent 的产品目标、关键特性、整体技术设计和 Phase 1 特性实现设计，为后续代码实现提供 source of truth。

范围

本版本包含：

• kgent 产品定位和愿景。
• 产品目标、关键特性和优先级。
• 目标与特性的支撑关系。
• 整体技术设计。
• 性能关键路径。
• 调度就绪性设计。
• 多任务、角色、会话和 revision 思路。
• Phase 1 特性实现设计。
• 沙箱、技能、工具、记忆、治理和运行记录边界。

关键决策

• kgent 是技能驱动、记忆增强、沙箱优先的专业智能体运行时。
• kgent 不局限于 Coding，也不是通用聊天机器人。
• Pydantic AI 是 Phase 1 的 agent execution engine。
• Phase 1 采用 CLI-first、本地优先的运行方式。
• 每次 run 都是 durable、sandboxed、artifact-based。
• Memory 外部化，通过显式 contract 访问。
• Skills 使用 filesystem packages，并支持 progressive loading。
• Tools 必须 explicit、permissioned、observable。
• Quality and Governance 是顶层关键特性。
• Future scheduler 通过 stable IDs、run state、manifests 和 append-only events 打底。

Phase 1 关键特性

Phase 1 重点验证：

1. Configurable Professional Identity。
2. Skill-Driven Capability System。
3. Tool-Mediated Action System。
4. Memory-Aware Context System。
5. Sandbox-First Work Execution。

同时提供最小 Quality and Governance baseline。

Phase 1 实现设计文档

• 项目与包结构
• 配置与 Profile 模型
• Run 与沙箱模型
• 事件与 Transcript 记录
• 技能注册表
• 工具系统
• Pydantic AI 运行时适配器
• 最小治理

后续方向

v0.1 之后可以进入代码实现阶段。

建议实现顺序：

1. 项目结构和 Python package skeleton。
2. Config/Profile typed models。
3. Run/Sandbox model。
4. Event/Transcript recorder。
5. Skill registry。
6. Tool system。
7. Pydantic AI runtime adapter。
8. Minimal governance。