feat: 添加 Agent 步骤事件与图片附件功能

- 新增 stepStarted/stepFinished 事件类型支持
- 前端实现图片附件上传和预览功能
- 后端增强工具结果存储和事件处理
- 完善相关单元测试和集成测试

docs/plans/2026-03-11-agent-multimodal-smoke-runbook.md

@@ -67,3 +67,60 @@ uv run pytest tests/integration/v1/agent/test_sse_flow_live.py::test_agent_runs_
 2. **连续会话记忆测试** - 验证 session 是否从数据库读取历史上下文
 3. **工具调用测试** - calendar 读/写/删/分享 + 用户查找 + 时间感知
 4. **session 失败排查** - 找出最新失败原因并修复
+
+## 9. 本轮进展与结论（2026-03-12）
+
+### 9.1 反馈闭环状态
+
+1. **intent/execution 阶段 tokens/cost 入库**：已解决。
+2. **连续会话记忆（今天+昨天上下文）**：已解决。
+3. **工具调用冒烟（读/写/删/分享 + user 查询 + 时间感知）**：部分解决。
+4. **最新失败 session 根因定位与修复**：已解决。
+5. **反馈同步到文档**：已完成（本节）。
+
+### 9.2 关键修复
+
+1. **stage telemetry 补齐**（intent/execution）：
+   - usage 缺失时补 token 估算；
+   - 通过 `LiteLLMService.calculate_cost` 按项目定价估算 cost；
+   - 回填 `response_metadata.inputTokens/outputTokens/cost` 并落库。
+
+2. **会话记忆上下文注入**：
+   - runtime 在执行前读取同一 session 最近两天（今天+昨天）的 user/assistant 消息；
+   - intent prompt 增加 `[Conversation Context]`，避免只看最新用户输入。
+
+3. **工具调用稳定性修复**：
+   - tool 名统一为下划线（`calendar_read`/`calendar_write`/`user_resolve`），修复 OpenAI/LiteLLM tool name 正则错误；
+   - intent prompt 注入 intent+execution 合并工具 schema，避免误判“无可用写入工具”。
+
+### 9.3 Live 证据
+
+#### A) tokens/cost 入库（thread=`cb1681c2-c223-4ced-bcfd-76f7252ba2d8`）
+
+- intent: `input_tokens=1541`，`output_tokens=37`，`cost=0.000382`
+- execution: `input_tokens=2161`，`output_tokens=376`，`cost=0.005450`
+- report: `input_tokens=3266`，`output_tokens=318`，`cost=0.007256`
+- session 聚合：`total_tokens=13518`，`total_cost=0.019473`
+
+#### B) 连续会话记忆（thread=`9c456736-d5e5-48a4-b9db-55f507baf573`）
+
+- run `mem-1`：`请记住口令是蓝鲸42，只回复已记住。`
+- run `mem-2`：`只回复我刚才让你记住的口令，不要解释。`
+- assistant 回复：`蓝鲸42`（记忆命中）。
+
+#### C) 工具调用 + 时间感知（thread=`cb1681c2-c223-4ced-bcfd-76f7252ba2d8`，run=`run-tool-1`）
+
+- 事件序列含 execution 阶段与多次 `TOOL_CALL_RESULT`
+- 工具调用结果：`calendar_write`、`calendar_read`（多次）
+- assistant 回复包含时间感知信息（北京时间日期/星期/时刻）
+
+### 9.4 最新失败 session 根因
+
+- 失败样本：`d6bc4dbd-8361-4a39-bf09-12b3392e0e70`
+- 根因：tool 名含点号（如 `calendar.write`）触发校验失败：
+  - `Invalid 'tools[0].function.name' ... expected pattern ^[a-zA-Z0-9_-]+$`
+- 修复后：同类执行链路已可稳定进入 execution 并产出 `TOOL_CALL_RESULT`。
+
+### 9.5 当前未闭环项
+
+- `user_resolve` + calendar **分享 + 删除** 组合链路的完整 live 证据还未补齐（本轮执行中断：`Tool execution aborted`）。