xt/agcore
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
94 Commits 2 Branches 7 Tags
6e1182e64cc1f8622b7b1b9b4d0f22423810b333
Commit Graph

94 Commits

This Branch
This Branch
All Branches
Author SHA1 Message Date
徐涛 6e1182e64c feat(core): 14 个公开枚举标记 #[non_exhaustive] 
为 v0.2.0-rc.1 API 稳定性收尾。覆盖：
- P0 核心 IR: Message / ContentBlock / ContentBlockType / StreamEvent / HookEvent
- P0 Error: AgentError / LlmError / ToolError / MemoryError / PromptError
- P1 其他: MemoryStrategy / StepStatus / ToolChoice / ResponseFormat

明确不加的: 内部 wire-format (OpenaiChatMessage 等) /
语义已收敛 (Role/ServiceTier 等) / 使用面窄 (Permission 等)。

示例侧的 3 处 Message exhaustive match (prompt_composer /
conversation_memory_demo) 补全 `_` 通配分支，零行为变化。

验收: cargo build + clippy -D warnings + test --all-targets 全绿 (200 passed)
 2026-07-05 19:47:03 +08:00
徐涛 b8f4fe0fe3 docs(AGENTS.md): 添加进度同步规范，明确 roadmap 更新要求 2026-07-05 17:40:22 +08:00
徐涛 7574f9c24c docs(roadmap): 标记 Phase 7 SqliteStore 已完成 
更新当前状态描述、Phase 7 交付物详情、里程碑 M3 状态、依赖性图谱及下一步行动
 2026-07-05 17:25:32 +08:00
徐涛 c82af60f81 feat(memory): 实现 SqliteStore 持久化 
- 新增 src/memory/store/sqlite_store.rs（SqliteStore + 9 个内联测试）
- 基于 rusqlite 0.32（bundled），使用 Arc<Mutex<Connection>> + spawn_blocking
- WAL 模式 + synchronous=NORMAL + busy_timeout=5s + PRAGMA user_version
  schema 版本管理
- created_at 归一化为 UTC 的 RFC 3339 TEXT，字典序等价时间序
- 错误精细映射：SqliteFailure/InvalidQuery → InvalidInput；
  FromSqlConversionFailure → Serialization；其他 → Storage
- 9 个测试覆盖 CRUD、upsert、prefix/since/offset+limit 过滤、
  10 写者 × 10 次并发、持久化 round-trip、trait-box 互换兼容性

依赖：
- rusqlite = { version = "0.32", features = ["bundled"] }
- time 增补 features: parsing, formatting, macros
- dev-dependencies: tempfile = "3"

测试：199 → 200 pass（191 原有 + 9 新增）
 2026-07-05 17:13:28 +08:00
徐涛 c8a91f6eaf refactor(memory): 将 store.rs 拆分为模块目录，仅结构搬移 
- 将 src/memory/store.rs 单体文件拆分为模块根 + store/ 目录结构
- InMemoryStore（struct + impl + Default + 6 个内联测试）整体提取到
  src/memory/store/in_memory.rs
- store.rs 保留 MemoryStore trait 与 EvictionPolicy/EvictionConfig
- 外部消费者导入路径 crate::memory::store::MemoryStore 不变
 2026-07-05 17:09:45 +08:00
徐涛 13edacd775 feat(memory): 添加 SqliteStore 持久化方案文档 2026-07-05 16:54:29 +08:00
徐涛 821cea8e60 feat(docs): 更新 roadmap，标记 Phase 6 交付完成 
Phase 6 ToolDef IR 的 5 个子步骤全部标注已完成，新增实际变更摘要，更新里程碑状态及下一步行动计划
 2026-07-05 10:49:50 +08:00
徐涛 517ef7db32 docs: 添加 Phase 6 ToolDefinition IR 正式化实施方案 2026-07-05 10:46:46 +08:00
徐涛 4cf5918b9c refactor(llm): 移除 ToolDefinition 别名与遗留 deprecation 抑制点 
完成 ToolDef IR 切换的最后清理：移除 ToolDefinition 别名与
OpenaiToolDefinition 的公共 re-export；各调用点（cycle/registry/mcp/agent）
直接使用 ToolDef 并清理对应的 #[allow(deprecated)] 抑制点；新增
roundtrip 测试验证 ToolDef 序列化兼容性。
 2026-07-05 10:32:35 +08:00
徐涛 9da9b83167 feat(llm): 切换至 ToolDef IR 并适配 OpenAI Provider 
将 MessageRequest.tools 切换为 Provider 无关的 ToolDef IR；
ToolDefinition 别名切换指向 ToolDef，registry/mcp 构造去掉
strict 字段；OpenAI 适配层通过 From 转换将 ToolDef 转为
OpenaiToolDefinition wire format。Anthropic 适配层字段名一致
无需改动，openai_compat/ollama 委托 GenericOpenaiProvider 无影响。
 2026-07-05 10:14:32 +08:00
徐涛 b1875192fd feat(llm): 引入 ToolDef IR 类型 
新增 Provider 无关的工具定义中间表示 ToolDef，配套实现双向 From 转换；
旧 OpenaiToolDefinition 标记 doc(hidden)。本次仅新增类型，不影响现有
代码路径。
 2026-07-05 10:06:52 +08:00
徐涛 d3067e2f53 docs(roadmap): 更新 Phase 5 完成状态和下一阶段计划 2026-07-05 09:04:44 +08:00
徐涛 5648b1d217 style(tools, llm): 统一导入顺序与代码格式 2026-07-05 08:19:13 +08:00
徐涛 98dfe6c1ed feat(llm): 完成 Phase 5 热身准备（Ollama / non_exhaustive / ProviderConfig） 
Phase 5 三个 Step 全部落地：

Step 5.2 — Ollama Provider
- 新增 OllamaProvider newtype 包装（默认 localhost:11434/v1，零 API key）
- ProviderType 新增 Ollama 变体与 FromStr 解析

Step 5.3 — #[non_exhaustive] 前置标记
- ProviderType / StopReason / FinishReason / EvictionPolicy 加 #[non_exhaustive]
- 编译期兼容护栏，避免下游 silent break

Step 5.1 — ProviderConfig 扩展
- 加 timeout_secs / max_retries 字段、Default、from_env(prefix)
- create_provider 各分支通过 pub(crate) from_parts 一次性构造并注入 timeout
  （同时避开 Anthropic 的 default_headers 与双重 client 构造）
- map_reqwest_error 改为方法读取 self.timeout_secs（移除硬编码 120s）
- AnthropicProvider::with_timeout 同值短路，with_client 标 #[deprecated]
- DeepSeek / Qwen 加公开 with_client，new_with_client 走代理
- 7 个新测试：5 个 from_env 单元测试 + 3 个 timeout 传导 wiremock
  （OpenAI Chat / DeepSeek / Anthropic）
- Cargo.toml 加 temp-env dev-dep
 2026-07-05 08:12:40 +08:00
徐涛 9e476e79bb merge: 合并 release/v0.1 全部修改（4 个 commit 含 v0.2 路线图与 Phase 5 实施方案） 2026-07-05 07:32:23 +08:00
徐涛 3bd135ec98 docs(roadmap): 添加 Phase 5 warmup 实施方案 
明确 Step 5.2 Ollama Provider、Step 5.3 non_exhaustive 前置标记、
Step 5.1 ProviderConfig 扩展三个独立 Step 的执行顺序与交付物
 2026-07-05 07:32:19 +08:00
徐涛 76f3235ed7 docs(roadmap): 更新 v0.2 规划为 8 个增量 Phase 并细化实施步骤 2026-07-04 10:32:24 +08:00
徐涛 6315f2d008 docs: 添加 opencode 子代理调度分发与合并机制调研笔记 2026-07-04 10:19:54 +08:00
徐涛 fba78f5f33 docs(roadmap): 更新路线图为 v0.2 生产就绪规划 
同步 v0.1.0 发布状态，将 v0.2+ 扩展项重
组为 12 项基础功能和 ContextSlot 上下文管
理，明确 v0.3+ 展望及边界范围
 2026-07-04 08:11:09 +08:00
徐涛 3c1a3ee62e docs: 修正 v0.1 release URL 到实际 remote 
CHANGELOG.md:91 的对比链接从 github.com/anomalyco/agcore
改为实际 remote git.archgrid.xyz/xt/agcore（Gitea 1.26.1），
避免 tag 发布后 CHANGELOG 链接 404
v0.1.0 		2026-07-04 07:07:01 +08:00
徐涛 8dcd1f2482 docs(v0.1): 同步 roadmap 并初始化 CHANGELOG 
- docs/roadmap.md：更新顶部状态至 v0.1 发布完成（182 测试 / 0 警告 / 7 离线示例），末尾追加 v0.1 发布里程碑章节
- CHANGELOG.md：按 Keep a Changelog 规范记录 0.1.0 的 Added / Changed / Deprecated / Fixed / Removed 及版本基线
 2026-07-04 06:54:13 +08:00
徐涛 602bd43fce fix(llm,docs): 修复 Phase C 审查发现的两个警告 
- LlmError::Request 变体补可操作建议：请检查 Provider 端点地址（base_url）和网络连通性
- README.md Mermaid 依赖图删除 Agent --> Prompt 边（编译级不存在）
- README.md 依赖规则文本同步：明确 agent 实际编译依赖为 llm/tools/memory，与 prompt 无直接依赖（system prompt 以 &str 传入）

参考审查：PM Director + SA Director 对 Phase C 的联合审查结论
 2026-07-04 06:35:21 +08:00
徐涛 a52588cd0f docs: 完善 README 完整版 
- 8 节结构：定位 / 快速上手 / 核心模块 / 架构图 / 依赖关系 / 环境变量 / 参考项目 / 许可证
- 快速上手代码段（MockProvider）已验证在外部 crate 离线可编译运行
- 核心模块表覆盖五大模块（llm / prompt / tools / memory / agent）
- ASCII 架构关系图 + Mermaid 模块依赖关系图 + 依赖规则说明
- 环境变量表列出 simple_visit 示例所需变量与推荐值
- 参考项目章节引用 4 个公开 Agent Harness 项目（OpenClaw / Hermes / OpenHuman / OpenHarness）
- 许可证章节同步改为 Apache-2.0 单协议，附标准 boilerplate 并指向 LICENSE 文件
 2026-07-04 06:21:36 +08:00
徐涛 4fdc62754c feat(errors): 错误消息面向最终用户友好化 
- memory::MemoryError 英文 → 中文 + 操作建议（namespace 拼写 / 后端存储 / 数据兼容性）
- llm::LlmError 各变体补充修复建议（API key / 超时 / 上下文压缩）
- tools::ToolError 各变体补充修复指引（注册工具 / 检查 Schema / 调权限 / MCP 握手）
- prompt::PromptError 各变体补充修复指引（注册子模板 / 检查语法 / 调深度限制）
- agent::AgentError::Config 中文化 + 提示需调用的 builder 方法名
 2026-07-04 06:21:31 +08:00
徐涛 9f5e8702a2 chore(license): 添加 Apache-2.0 标准 LICENSE 文件 
- 新增 LICENSE（Apache License 2.0 全文，Copyright 2026 AG Core Contributors）
- 项目由双协议改为 Apache-2.0 单协议
 2026-07-04 06:21:24 +08:00
徐涛 2d0d5c1592 feat(examples): 新增 Phase B 7 个离线可运行示例 
新增 7 个示例覆盖全 Phase 公共 API（不依赖 API key 即可运行）：
- agent_session_demo：AgentBuilder → AgentSession → SessionMemory
- custom_tool：BaseTool 注册 + invoke/invoke_all + 权限检查
- prompt_composer：PromptTemplate + PromptComposer + validate_messages
- task_agent_demo：JsonPlanParser + Step 状态机 + 错误路径
- conversation_memory_demo：滑动窗口 + 多角色 + 隔离
- knowledge_search_demo：KnowledgeStore + 关键词检索 + 停用词过滤
- streaming_events_demo：submit_stream 事件消费 + 队列耗尽错误路径
 2026-07-03 15:50:51 +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
徐涛 c2c0d498ee docs(v0.1): 添加发布实施计划文档 2026-07-03 14:13:30 +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
徐涛 a74c24b6fe feat(llm): 重写 Provider 适配层，支持 OpenAI Chat / Anthropic / DeepSeek / Qwen 
重写 OpenaiChatProvider：移除 Phase 0 临时桥接，实现真实流式状态机
（ContentBlockStart / *Delta / ContentBlockEnd / ToolCallEnd），
MessageComplete.full_response 由 PartialMessageResponse::finalize 产出。

新增 AnthropicProvider：实现 Messages API + SSE 事件序列
（message_start → content_block_start → content_block_delta →
content_block_stop → message_delta → message_stop），
529（overloaded）映射为 RateLimit；thinking signature 由
partial.set_thinking_signature 内部写入。

新增 DeepSeekProvider / QwenProvider：OpenAI-compatible 协议的
newtype 包装，共享 GenericOpenaiProvider 的 HTTP / SSE / 转换逻辑；
Qwen 通过 extra_headers 注入 X-DashScope-SSE: enable。

新增 convert.rs 公共转换模块：从 Phase 0 cycle.rs / Phase 0
OpenaiProvider 桥接层提取 from_openai / to_openai /
content_to_blocks / blocks_to_content，避免跨 Provider 重复逻辑。

新增 wiremock dev-dependency + 14 个集成测试：
- OpenaiChatProvider：基础文本 / 401 / 500 / 流式 MessageComplete
- AnthropicProvider：基础 / 401 / 529 / 流式 SSE 序列 / max_tokens 默认值
- DeepSeek / Qwen：基础文本响应

171 个测试全部通过（之前 157，新增 14）。
 2026-07-02 22:24:30 +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
徐涛 925c8f9729 docs: 更新方案文档，补充 StreamEvent 迁移和 OpenaiProvider 桥接方案 2026-06-30 22:59:05 +08:00
徐涛 832ebf2665 docs(phase0): 新增 Phase 0 实施计划文档 
定义类型层落地计划，涵盖新类型定义、Trait 签名切换及上游适配方案
 2026-06-30 22:22:12 +08:00
徐涛 000cd2022d feat(llm): 实现 Provider 重构方案并更新文档 
根据复核反馈修正以下内容：
- 补充 §2.4 中扁平大枚举对 9e 依赖验证的说明
- 消除 §2.3 MessageComplete 冗余字段
- 明确 Phase 0 add-only 策略和 trait 签名切换时点
- 补充 HTTP mock 策略和兼容性验证标准
 2026-06-26 08:12:12 +08:00
徐涛 ac7fca8b40 feat(docs): 新增 LLM Provider 重构方案文档 2026-06-25 23:07:22 +08:00
徐涛 f639229d09 docs: 添加 commit body 规则，禁止逐文件列举变更 2026-06-24 17:00:43 +08:00
徐涛 4423024974 docs: 更新 compact 主题状态为已推演 2026-06-22 08:43:48 +08:00
徐涛 3babc5567f enhance(docs): 补全 compact 在 IR 上的改法推演结论 2026-06-22 06:52:04 +08:00
徐涛 3ddd0b6d80 enhance(docs): 更新 system prompt 双重表达冲突推演结论为方案 D 2026-06-22 06:34:11 +08:00
徐涛 80d44ee687 docs(AGENTS): 添加 Commit 提交流程说明 2026-06-19 08:23:00 +08:00
徐涛 ee7fcab71c docs(9): 完善 Anthropic 流式状态机设计推演结论 2026-06-18 06:51:13 +08:00
徐涛 8c9324350b docs(9d): 补全 OpenAI 流式转换推演结论 2026-06-18 06:34:20 +08:00
徐涛 c0eae92b10 docs: 更新方案9推演结论并调整StreamEvent设计 2026-06-17 22:55:47 +08:00
徐涛 8686a2e1d6 docs(llm): 新增 LLM Provider 统一接口设计文档 2026-06-15 23:07:33 +08:00
徐涛 829be90d19 docs: 新增示例程序方案文档 2026-06-11 22:49:27 +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
徐涛 4de7db0b2c docs(roadmap): 更新 Phase 4b 状态为已完成 2026-06-11 21:57:10 +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