feat(api): expose REST-only agent routes

README.md

@@ -4,7 +4,7 @@
 
 ## 主要能力
 
-- 提供 `POST /api/v1/agent/chat/stream` SSE 聊天接口。
+- 提供 `POST /api/v1/agent/sessions/{session_id}/runs` SSE 聊天接口。
 - 支持 embedded OpenCode 运行时，也可连接外部 OpenCode server。
 - 管理前端 `session_id` 与 OpenCode session 的映射。
 - 在服务端保存当前会话的用户 token、项目、network 和 trace 上下文。
@@ -43,6 +43,8 @@ bun run dev
 
 ```bash
 bun run check
+bun run contract:generate
+bun run test:api
 bun run test:cli
 bun run start
 bun run start:prod
@@ -50,6 +52,8 @@ docker build -t tjwater-agent:local .
 ```
 
 - `bun run check`：检查主项目和 `.opencode` 的 TypeScript 类型。
+- `bun run contract:generate`：生成 `contracts/agent-v1.openapi.json`。
+- `bun run test:api`：验证公开 REST 契约和聊天路由。
 - `bun run test:cli`：运行 `node-tests/cli/*.node.mjs`。
 - `bun run start`：直接启动服务。
 - `bun run start:prod`：先类型检查，再启动服务。