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 状态

src/agent/agent.rs

@@ -0,0 +1,30 @@
+//! Agent trait —— 智能体的"角色"抽象。
+//!
+//! 设计要点（参见 `docs/7-agent-runtime.md` §3.2.1）：
+//!
+//! - **角色与会话分离**：`Agent` 定义"做什么、用什么工具"，`AgentSession` 维护"当前状态"
+//! - **工具白名单扩展点**：默认从 `RuntimeBundle.tool_registry` 取全部，子 trait 可覆盖做白名单/过滤
+//! - **不绑定业务循环**：`submit_turn` 在 `AgentSession` 上，不在 trait 上
+
+use crate::agent::runtime::RuntimeBundle;
+use crate::llm::types::ToolDefinition;
+
+/// Agent 角色抽象。
+///
+/// 实现此 trait 即可接入 Agent Runtime。典型实现是 struct 持有静态配置（name、system prompt 模板），
+/// 也可以是基于配置动态生成的轻量实现。
+pub trait Agent: Send + Sync {
+    /// 角色名（用于日志、调试、UI 展示）。
+    fn name(&self) -> &str;
+
+    /// 系统提示词。无提示词的纯工具型 agent 返回 `None`。
+    fn system_prompt(&self) -> Option<&str>;
+
+    /// 列出该 Agent 想暴露给 LLM 的工具定义。
+    ///
+    /// **默认实现**：从 `bundle.tool_registry` 取全部工具（最常用模式）。
+    /// **子 trait / 具体实现可覆盖**：做白名单、过滤、按状态动态调整等。
+    fn tool_definitions(&self, bundle: &RuntimeBundle) -> Vec<ToolDefinition> {
+        bundle.tool_registry.definitions()
+    }
+}