feat(auth): validate agent context upstream

README.md

@@ -30,7 +30,7 @@ TJWaterAgent/
 1. 启动 HTTP 服务。
 2. 通过 `@opencode-ai/sdk` 启动内嵌 opencode server，或连接外部 opencode server。
 3. 管理前端 `session_id -> opencode sessionId` 的映射。
-4. 保存并传递用户 `Authorization`、`x-user-id`、`x-project-id`、`x-trace-id`。
+4. 保存并传递后端认证后的用户 token、metadata 用户 ID、项目 ID 和 trace。
 5. 把 opencode 输出适配成前端需要的 SSE 事件。
 6. 为 `.opencode/tools/tjwater_cli.ts` 提供内部回调接口。
 7. 代理调用真实 TJWater 后端 API。
@@ -50,6 +50,7 @@ POST /api/v1/agent/chat/stream
 | `tool_call` | 前端地图/面板/图表动作 |
 | `done` | 当前轮完成 |
 | `error` | 当前轮失败 |
+| `auth_required` | 运行中 access token 过期或被后端拒绝，需要前端刷新登录态后重试 |
 
 主要目录和文件：