docs: 更新协议文档和设计文档

docs/protocols/agent/sse-events.md

@@ -84,7 +84,7 @@ data: <json>
   "type": "STEP_STARTED",
   "threadId": "...",
   "runId": "...",
-  "stepName": "router" | "worker"
+  "stepName": "worker" | "memory"
 }
 ```
 
@@ -95,7 +95,7 @@ data: <json>
   "type": "STEP_FINISHED",
   "threadId": "...",
   "runId": "...",
-  "stepName": "router" | "worker"
+  "stepName": "worker" | "memory"
 }
 ```
 
@@ -197,6 +197,11 @@ data: <json>
 
 `inputTokens`、`outputTokens`、`cost`、`latencyMs`、`model` 属于后端内部统计字段，不在 SSE 对外协议中暴露。
 
+当前实现补充说明：
+
+- `TEXT_MESSAGE_END` 在 wire payload 中会包含 `totalTokens`、`cachedPromptTokens`、`promptCacheHitTokens`、`promptCacheMissTokens`、`reasoningTokens`、`costSource`、`usageComplete` 等 usage 摘要字段，供前端观测面板使用。
+- 这些字段来自后端 usage 归一化层，属于 AG-UI 事件数据的一部分，不改变 `TEXT_MESSAGE_END` 主结构。
+
 ---
 
 ## 5) Usage 审计协议（后端内部）