xt/agcore
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
127 Commits 2 Branches 7 Tags
34eec9f54623a6b59ec761c9467b8d832cadf706
Commit Graph

14 Commits

Author SHA1 Message Date
徐涛 34eec9f546 feat(engine): 实现 Agent 执行引擎（SessionManager + Checkpointer + SessionSnapshot） 
Phase 17 主体交付：解决 v0.2 中 session 在变量里、无父子关系、无 checkpoint、
不可序列化的空白。

新增模块 src/engine/（5 文件，约 1300 行纯实现 + 21 个内联测试）：

- error.rs（46 行）—— EngineError 枚举（6 变体）
  - SessionNotFound / SessionAlreadyExists / CheckpointNotFound
  - Memory(#[from] MemoryError) 透传（与 AgentError 风格一致）
  - Serialization / Agent(#[from] AgentError)

- snapshot.rs（36 行）—— SessionSnapshot + SessionMemoryEntry
  - 独立 struct 避开 Arc<dyn Agent> 不可序列化限制
  - SessionMemoryEntry 保留 value/metadata/created_at 完整信息
  - 所有字段 #[serde(default)] 宽松反序列化保证前向兼容

- checkpointer.rs（377 行）—— Time-travel 检查点管理器
  - checkpoint() / rollback_load() / list_checkpoints() / delete_all() / latest_snapshot()
  - 存储 key：ckpt:{session_id}:{ckpt_id}
  - ckpt_id 纳秒+计数器（无外部依赖，ponytail）
  - CkptMeta.created_at_nanos 字段确保同秒内精确降序
  - 6 个内联测试覆盖 roundtrip / 不存在 ckpt / 降序排序 / delete_all 幂等 /
    latest_snapshot / 跨 session 隔离

- session_manager.rs（906 行）—— SessionManager 会话树管理
  - 内部 RwLock<HashMap> + Arc<tokio::sync::Mutex<AgentSession>> 双重锁
  - create / create_child / get / recover / replace / children / parent /
    destroy / submit_turn / submit_turn_stream / finalize_turn_stream 共 11 个公开方法
  - SessionManagerConfig.auto_checkpoint 默认 true（同步写入 +
    tracing::error! 失败不阻断主流程，不提供强持久化保证）
  - 孤儿策略：destroy 不递归删除子 session；父被销毁后 parent() 返回 None
  - create_child 限制：父 session 必须先 get/recover 到内存（bundle 不可序列化）
  - 15 个内联测试覆盖 CRUD / recover / replace / 树形 / 孤儿 / auto_checkpoint 开关 /
    序列化兼容性 / 幂等 / 10 并发创建

- mod.rs（20 行）—— 统一 pub use 重导出 EngineError / SessionManager /
  SessionManagerConfig / Checkpointer / CkptMeta / SessionSnapshot /
  SessionMemoryEntry

AgentSession 扩展（src/agent/session.rs，+152 行）：
- to_snapshot() pub async —— 从 MemoryStore 拍平 session_memory 全量数据
- from_snapshot() pub fn Result —— 纯同步构造器（pending_memory_restore 暂存）
- restore_memory() pub async &mut self —— 写回持久层并清空 pending
- has_pending_memory_restore() —— 查询 pending 状态
- pub(crate) fn bundle() —— accessor 供 SessionManager::create_child 继承

SessionMemory 扩展（src/agent/session_memory.rs，+57 行）：
- list_entries() —— 返回 Vec<(key, value, metadata, created_at_unix_secs)>
- set_with_meta() —— 保留 metadata/created_at 写入（供 restore_memory 完整恢复）

src/lib.rs —— pub mod engine 声明

examples/engine_demo.rs（+251 行）：
端到端演示 create → submit_turn → checkpoint → list_checkpoints →
rollback_load → from_snapshot → restore_memory → replace → destroy 完整链路，
含 rollback 一致性 assert（turn_index 和 cost 恢复到 checkpoint 时刻）。

零新外部依赖（serde_json 已有）。全量 353 → 374（+21 新测试）。
clippy 0 警告，doc 0 warning，example exit 0。

Phase 17: Agent 执行引擎 — Step 2-7（合并提交）
 2026-07-15 08:59:46 +08:00
徐涛 cc1c68b69d feat(agent): 实现摘要自动生成（SummaryConfig + 内联检查点） 
SummaryConfig 6 字段配置（trigger_token_ratio / max_context_tokens /
summary_prompt / debounce_turns / summary_model / max_tool_result_chars），
AgentBuilder 链式 summary_config()；AgentSession 在 submit_turn /
finalize_turn 的 OnTurnEnd 之后内联检查点：水位 + 防抖（首次不受
约束）→ 独立 LlmCycle 调 submit_messages 生成摘要 → 写入
FocusedConfig.summary_override + slot.save() + SessionMemory 全局快照。

should_summarize 接收 current_turn 参数避免流式路径 turn_index 偏差；
format_messages_as_text 简洁版格式化含 30K 整体截断保留最新；空消息
守卫直接返回空串。所有错误静默 tracing::error!，成功路径
tracing::info!。

src/agent/summary.rs 新增 ~240 行；agent/session.rs +428 行（双路径
检查点 + 关联函数 + 测试 + 公开 API）。零新外部依赖。全量 335 → 353
测试（+18 新测试），clippy 0 警告，doc 0 warning。两轮审查 PASS——
第一轮 PM/SA 修复 11 项，第二轮 Code Reviewer 修复 9 项（含 🔴
generate_summary 空消息 bug + 🟡 5 项 + 💭 2 项）。方案文档 docs/
22-phase16-summary-auto-generation.md（471 行）；roadmap.md 标记
Phase 16 完成 + M12 里程碑达成。
 2026-07-10 06:43:06 +08:00
徐涛 c36668071e fix(agent): Phase 9 实施审查修复 
- cycle.rs: run_tool_loop 实现 PreRequest hook（之前 `let _ = hook_executor.as_ref()` 是空操作，
  导致 hook-based logging/monitoring 在流式工具循环中失效；现在与 submit_with_tools 行为对齐，
  含 should_block 检查，阻断时通过 StreamEvent::Error 事件化）
- session.rs: 删除 submit_turn_stream 末尾的 `let _ = hook_executor;` 死代码（Arc 引用生命周期
  由 Arc 自动管理）
- session.rs: 新增 2 个集成测试覆盖方案 §4 Step 5：
  - submit_turn_stream_end_to_end：mock provider → 消费流 → finalize_turn 后 cost_so_far
    正确更新（10/5 tokens）+ turn_index=1 + default slot 包含 user/assistant 消息
  - submit_turn_stream_triggers_turn_hooks：OnTurnStart 在 submit_turn_stream 返回流前
    触发（计数=1）+ OnTurnEnd 在 finalize_turn 前不触发（计数=0）+ finalize_turn 后触发（计数=1）
- docs/16-phase9-streaming-experience.md: 标注 finalize_turn Phase 10 签名变更（new_messages_from_cycle
  + Result 返回），Step 5 测试实现位置
- 测试 288 passed / 0 failed（基线 286 + 2 新增），clippy 0 警告，doc 0 warning
 2026-07-08 23:19:24 +08:00
徐涛 802518b5fe feat(agent): 实现 ContextSlot fork/merge 
- 新增 MergeStrategy 枚举（#[non_exhaustive]，为 Phase 16 Summarize 预留）
- 新增 ContextSlot::fork() 从父 slot 派生独立子 slot（Full / Focused 策略）
- 新增 ContextSlot::merge() 将子 slot 消息合入父 slot（Append / Replace 策略）
- 防御性检查：禁止 self-merge、跨 session merge、合并到 Readonly slot
- 重构 AgentSession::derive_slot 复用 fork() 消除重复代码
- 新增 9 个内联测试覆盖 fork/merge happy path 与 error path
- agent.rs 追加 MergeStrategy re-export（agcore::agent::MergeStrategy 路径可用）
 2026-07-08 22:52:38 +08:00
徐涛 635942248b feat(core): 新增 Phase 10 ContextSlot 多上下文分区管理 
- 新增 ContextSlot 类型（Full / Focused / Readonly 三种模式，
  New / Derived / Static 三种来源），支持 JSON blob 批次持久化
- AgentSession 新增 slots 字段与 5 个管理方法
  （create_slot / switch_slot / list_slots / derive_slot / delete_slot），
  自动创建 "default" slot
- submit_turn / finalize_turn 改造为基于当前 slot 的增量追加写回，
  确保 Focused 模式"读时过滤"语义不丢失数据
- finalize_turn 签名变更（新增 new_messages_from_cycle 参数，
  返回 Result<(), AgentError>），向后兼容列于 docs/17
- 新增 3 个 AgentError 变体（SlotReadonly / SlotNotFound / SlotAlreadyExists）
- 新增分支对话示例 context_slot_demo（法律咨询→两个派生方向→切换→隔离验证）
- 新增 43 个测试覆盖持久化、Focused 过滤、Readonly 阻断、delete 保护、
  派生逻辑、流式 finalize_turn、key 注入防护等场景
- 方案文档：docs/17-phase10-contextslot.md（含 §5 推荐方案、§6 实施建议、
  §9 实施计划，经过 4 轮方案/计划/实施审查 + 1 轮非阻塞建议修复）
 2026-07-06 09:46:04 +08:00
徐涛 212cfcc916 feat(core): 新增 Phase 9 流式体验增强 submit_turn_stream 
- 新增 StreamEvent::ToolExecutionStarted/Completed 变体（apply_to 元事件）
- 新增 LlmCycle::submit_with_tools_stream + run_tool_loop（spawn + mpsc 状态机）
- 新增 AgentSession::submit_turn_stream + finalize_turn（手动同步状态）
- CycleConfig 加 Clone derive

- 新增 9 个单元测试 + 2 个集成测试（211 passed）
- clippy 0 警告，存量 0 回归

docs: 追加 Phase 9 实施方案（docs/16-phase9-streaming-experience.md）
 2026-07-05 23:37:37 +08:00
徐涛 5648b1d217 style(tools, llm): 统一导入顺序与代码格式 2026-07-05 08:19:13 +08:00
徐涛 7b2d2db322 feat(llm): 公开 MockProvider 并修复测试与 API 一致性 
- 新增 src/llm/mock.rs：公开 MockProvider，实现 chat 与 chat_stream
  (chat_stream 从 MessageResponse 拆解为 StreamEvent 序列)，含 5 个内联测试
- src/llm.rs 注册 pub mod mock，供示例与外部 crate 引用
- src/agent/session.rs 测试改用 crate::llm::mock::MockProvider，
  删除内嵌私有副本，统一公开路径
- src/prompt.rs re-export validate_messages，与 PromptComposer 对齐公开路径
 2026-07-03 15:50:39 +08:00
徐涛 c084c57e2c refactor(core): 扫清 v0.1 Phase A 技术债 
- 修复测试编译回归：补全 session.rs/cycle.rs 测试模块导入；
convert.rs 2 处 irrefutable if let 改为 let
- composer.rs 迁移至 IR：OpenaiChatMessage → Message，
ContentField/OpenaiContentPart → ContentBlock；删除 set_message_name
和 build_request；developer 消息映射为 Message::System
- knowledge.rs 锁修复：std::sync::Mutex → tokio::sync::Mutex；
search() 优化锁粒度（锁内仅 clone IDs，避免锁内异步 IO）
- 标记 ChatResponse / ToolDefinition 为废弃（#[deprecated(since = "0.1.0")]），
内部使用点加 #[allow(deprecated)] 抑制警告
- clippy 清零：合并冗余 if、手动 strip_prefix 改 strip_prefix、
多处 dead_code 抑制、测试代码清理
 2026-07-03 15:19:37 +08:00
徐涛 e54edbc037 feat(agent): 移除未使用的导入并简化条件表达式 2026-07-03 13:55:24 +08:00
徐涛 9e4f50c955 feat(llm): LlmCycle 切换 IR 消息类型，移除 Phase 0 桥接层 
核心改动：
- LlmCycle.messages 从 Vec<OpenaiChatMessage> 切换为 Vec<Message>，
  移除 Phase 0 引入的 chat_message_to_message / message_to_chat_message
  转换函数
- 移除 LlmCycle.system_prompt 字段（FIX-D），调用方通过
  Message::system_text() + with_messages() 管理系统提示；
  with_system_prompt() 标记 #[deprecated] 保留为过渡期 shim
- submit_stream 简化（FIX-E）：Item = StreamEvent 不再带 Result 包装，
  错误用 StreamEvent::Error 传出；self.messages 不再自动 push_message，
  调用方在收到 MessageComplete 后手动调用 cycle.push_message()
- compact.rs 适配 Message 类型 + ContentBlock 估算；microcompact
  跳过 is_error:true 的 ToolResult（FIX-F），保留 LLM 错误诊断
- ConversationMemory 持久化从 OpenaiChatMessage 切换为 Message
- ToolInvocation 增加 tool_call_id 字段（FIX-A），
  invoke/invoke_all 签名增加 tool_call_id 参数

调用方迁移：
- AgentSession::submit_turn 用 Message::system_text() + with_messages()
- simple_visit example 同步迁移

测试 177 passed / 0 failed（compact 新增 5 个单元测试覆盖 FIX-F + 估计全变体）。
 2026-07-02 22:48:00 +08:00
徐涛 7c299f1cfd feat(llm): 新增 IR 类型层 + 切换 LlmProvider trait 签名 
引入跨 Provider 统一的新类型系统：
- Message 扁平大枚举（System/User/UserImage/Assistant/ToolResult）
- MessageRequest + MessageResponse + StreamEvent（高精度 IR）
- PartialMessageResponse 含 apply_to/finalize 汇聚算法
- ProviderType enum 扩展 + ProviderCapabilities

切换 LlmProvider trait 签名为 chat(MessageRequest) → MessageResponse，
chat_stream 返回 Stream<Item = Result<StreamEvent, LlmError>>，新增 capabilities()。

StreamEvent 命名冲突处理：旧变体迁移至 old_stream::LegacyStreamEvent，
stream.rs 通过 pub use 重新导出新高精度事件。

OpenaiProvider 添加 Phase 0 临时桥接（MessageRequest ↔ OpenaiChatRequest 转换），
标注 ponytail: Phase 0 临时桥接 标记，Phase 1 重写时移除。

测试 147 passed / 0 failed（新增 31 个新类型测试）。
 2026-07-02 21:58:07 +08:00
徐涛 ce1f1aaca0 feat(agent): 实现 Phase 4c 会话级记忆功能 
- 新增 `SessionMemory` 结构体，基于 `MemoryStore` 按 namespace 隔离键值数据
- `AgentBuilder` 增加 `session_memory_backend` 配置入口
- `RuntimeBundle` 透传 `session_memory_backend` 字段
- `AgentSession` 将内联 `HashMap` 替换为完整的 `SessionMemory`，`set_session_data` 和 `get_session_data` 改为异步方法
- 新增 3 个内联测试，全量测试从 113 增至 116，clippy 0 警告
 2026-06-11 22:14:15 +08:00
徐涛 2b189880a9 feat(agent): 实现 Agent Runtime 核心胶水层 (Phase 4a) 
- 添加 Agent trait、AgentSession、RuntimeBundle、AgentBuilder
- 添加 Plan/Step/StepStatus 任务规划数据结构
- 添加 AgentError 统一错误类型（聚合 LlmError/ToolError/MemoryError）
- 实现 submit_turn 单轮对话流程（含 hook 触发与 cost 累计）
- 扩展 LlmCycle 支持 Arc<dyn LlmProvider>
- 扩展 HookEvent 添加 OnTurnStart/OnTurnEnd
- 更新 roadmap 状态
 2026-06-11 21:45:28 +08:00