min-agent 0.3.0 → 0.4.0

package/dist/xml-search.js

@@ -0,0 +1,194 @@
+/**
+ * Some OpenAI-compatible gateways (and a few models) dump built-in web search
+ * into the assistant text as <web_search>…</web_search> instead of a tool call,
+ * then stop. This module splits those blocks out of the stream so the agent can
+ * turn them into search_web tool results and keep going.
+ */
+const OPEN_NAME = "<web_search";
+const CLOSE_NAME = "</web_search";
+const PARTIAL_TAG_HOLD = 80;
+const UNCLOSED_MAX = 64 * 1024;
+function collapse(s) {
+    return s.replace(/\s+/g, " ").trim();
+}
+function isNameBoundary(ch) {
+    return ch === undefined || ch === ">" || ch === "/" || ch === " " || ch === "\t" || ch === "\n" || ch === "\r";
+}
+function findOpen(buf) {
+    const l = buf.toLowerCase();
+    let from = 0;
+    while (from < l.length) {
+        const index = l.indexOf(OPEN_NAME, from);
+        if (index < 0)
+            return null;
+        if (!isNameBoundary(l[index + OPEN_NAME.length])) {
+            from = index + 1;
+            continue;
+        }
+        const gt = buf.indexOf(">", index);
+        if (gt < 0)
+            return null;
+        return { index, openLen: gt - index + 1, raw: buf.slice(index, gt + 1) };
+    }
+    return null;
+}
+function findClose(buf, from) {
+    const l = buf.toLowerCase();
+    let start = from;
+    while (start < l.length) {
+        const index = l.indexOf(CLOSE_NAME, start);
+        if (index < 0)
+            return null;
+        if (!isNameBoundary(l[index + CLOSE_NAME.length])) {
+            start = index + 1;
+            continue;
+        }
+        const gt = buf.indexOf(">", index);
+        if (gt < 0)
+            return null;
+        return { innerEnd: index, tagEnd: gt + 1 };
+    }
+    return null;
+}
+function queryFromOpenTag(raw) {
+    const m = /\bquery\s*=\s*"([^"]*)"/i.exec(raw) ?? /\bquery\s*=\s*'([^']*)'/i.exec(raw);
+    return m?.[1]?.trim() ?? "";
+}
+const RESULTS_HEADER = /^Search results for\s+"([^"]*)"\s*:/im;
+export function classifyXmlSearchBody(inner, attrQuery = "") {
+    const trimmed = inner.trim();
+    if (!trimmed) {
+        const query = attrQuery.trim();
+        return query ? { kind: "invoke", query } : { kind: "results", query: "", body: "" };
+    }
+    const header = RESULTS_HEADER.exec(trimmed);
+    if (header) {
+        return { kind: "results", query: header[1].trim() || attrQuery, body: trimmed };
+    }
+    if (/^\d+\.\s+Title\s*:/m.test(trimmed) && /\bURL\s*:/m.test(trimmed)) {
+        return { kind: "results", query: attrQuery, body: trimmed };
+    }
+    const query = collapse(trimmed) || attrQuery;
+    if (query && query.length <= 500 && !/\bURL\s*:\s*https?:\/\//i.test(trimmed)) {
+        return { kind: "invoke", query };
+    }
+    return { kind: "results", query: attrQuery || query, body: trimmed };
+}
+function lastPotentialPartialOpen(buf) {
+    const start = Math.max(0, buf.length - PARTIAL_TAG_HOLD);
+    const tail = buf.slice(start);
+    const lt = tail.lastIndexOf("<");
+    if (lt < 0)
+        return -1;
+    const globalLt = start + lt;
+    const cand = buf.slice(globalLt).toLowerCase();
+    if (cand.length > 72)
+        return -1;
+    if (OPEN_NAME.startsWith(cand) || CLOSE_NAME.startsWith(cand))
+        return globalLt;
+    if (cand.startsWith(OPEN_NAME) && !cand.includes(">"))
+        return globalLt;
+    if (cand.startsWith(CLOSE_NAME) && !cand.includes(">"))
+        return globalLt;
+    return -1;
+}
+export class XmlSearchSplitter {
+    buf = "";
+    feed(chunk) {
+        this.buf += chunk;
+        return this.drain(false);
+    }
+    flush() {
+        return this.drain(true);
+    }
+    drain(isFinal) {
+        const out = [];
+        let hadBlock = false;
+        const pushDisplay = (text) => {
+            if (!text)
+                return;
+            const last = out[out.length - 1];
+            if (last?.type === "display")
+                last.text += text;
+            else
+                out.push({ type: "display", text });
+        };
+        while (this.buf.length > 0) {
+            const open = findOpen(this.buf);
+            if (!open) {
+                if (isFinal) {
+                    pushDisplay(this.buf);
+                    this.buf = "";
+                }
+                else {
+                    const holdFrom = lastPotentialPartialOpen(this.buf);
+                    if (holdFrom >= 0) {
+                        pushDisplay(this.buf.slice(0, holdFrom));
+                        this.buf = this.buf.slice(holdFrom);
+                    }
+                    else {
+                        pushDisplay(this.buf);
+                        this.buf = "";
+                    }
+                }
+                break;
+            }
+            if (open.index > 0) {
+                let pre = this.buf.slice(0, open.index);
+                pre = pre.replace(/\n+$/, "");
+                if (pre)
+                    pushDisplay(pre);
+                this.buf = this.buf.slice(open.index);
+            }
+            const close = findClose(this.buf, open.openLen);
+            if (!close) {
+                const innerLen = this.buf.length - open.openLen;
+                if (isFinal || innerLen > UNCLOSED_MAX) {
+                    const inner = this.buf.slice(open.openLen);
+                    out.push({ type: "search", block: classifyXmlSearchBody(inner, queryFromOpenTag(open.raw)) });
+                    hadBlock = true;
+                    this.buf = "";
+                }
+                break;
+            }
+            const inner = this.buf.slice(open.openLen, close.innerEnd);
+            out.push({ type: "search", block: classifyXmlSearchBody(inner, queryFromOpenTag(open.raw)) });
+            hadBlock = true;
+            this.buf = this.buf.slice(close.tagEnd).replace(/^\n+/, "");
+        }
+        if (hadBlock) {
+            const first = out[0];
+            if (first?.type === "display")
+                first.text = first.text.replace(/^\n+/, "");
+        }
+        return out.filter((sl) => sl.type === "search" || sl.text.length > 0);
+    }
+}
+export function extractXmlSearch(text) {
+    const splitter = new XmlSearchSplitter();
+    const slices = [...splitter.feed(text), ...splitter.flush()];
+    let display = "";
+    const blocks = [];
+    for (const sl of slices) {
+        if (sl.type === "display")
+            display += sl.text;
+        else
+            blocks.push(sl.block);
+    }
+    return { display, blocks, slices };
+}
+/** Drop the XML wrappers but keep the inner query/results, for sub-agent returns. */
+export function unwrapXmlSearchTags(text) {
+    const { slices } = extractXmlSearch(text);
+    if (slices.every((sl) => sl.type === "display"))
+        return text;
+    return slices
+        .map((sl) => {
+        if (sl.type === "display")
+            return sl.text;
+        return sl.block.kind === "results" ? sl.block.body : sl.block.query;
+    })
+        .join("")
+        .replace(/^\n+/, "")
+        .replace(/\n+$/, "");
+}

package/docs/API.md

@@ -30,21 +30,36 @@ min-agent serve --host 0.0.0.0 --port 3000
 |------|------|------|
 | GET | `/health` | 存活检查 |
 | GET | `/v1/meta` | 运行环境 |
+| GET | `/v1/update` | 检查 npm 是否有新版本（不执行安装） |
 | GET | `/v1/models` | 模型列表 |
 | GET | `/v1/context` | 上下文窗口信息 |
 | GET | `/v1/project` | 项目扫描 |
-| POST | `/v1/chat` | 对话 |
-| POST | `/v1/code` | Code 模式对话 |
+| POST | `/v1/chat` | 对话（项目感知） |
+| POST | `/v1/code` | 与 `/v1/chat` 相同（兼容路径） |
 | POST | `/v1/paste` | 图片+文本对话 |
 | POST | `/v1/chat/compact` | 手动压缩会话 |
 | POST | `/v1/chat/reload-instructions` | 重载规则 |
+| POST | `/v1/chat/redo` | 重发会话最后一条用户消息 |
 | GET | `/v1/sessions` | 列出会话 |
 | DELETE | `/v1/sessions/:id` | 删除会话 |
-| GET | `/v1/memory` | 列出记忆 |
+| GET | `/v1/memory` | 列出记忆（含 `project_memories`） |
 | POST | `/v1/memory` | 添加记忆 |
 | GET | `/v1/memory/search?q=xxx` | 搜索记忆 |
 | DELETE | `/v1/memory/:index` | 删除记忆 |
+| GET | `/v1/budget` | 当前预算上限 |
+| POST | `/v1/budget` | 设置预算上限 |
+| GET | `/v1/permission` | 当前确认模式 |
+| POST | `/v1/permission` | 设置确认模式 |
+| GET | `/v1/sandbox` | 当前隔离策略 |
+| POST | `/v1/sandbox` | 设置隔离策略 |
+| GET | `/v1/diff` | 工作区未提交变更 |
+| POST | `/v1/approvals` | 回答危险操作确认 |
+| POST | `/v1/answers` | 回答代理提问 |
 | GET | `/v1/mcp` | MCP 状态 |
+| GET | `/v1/mcp/:name/resources` | 列出资源与 URI 模板 |
+| GET | `/v1/mcp/:name/prompts` | 列出 prompt 模板 |
+| POST | `/v1/mcp/:name/resources/read` | 读取一条资源 |
+| POST | `/v1/mcp/:name/prompts/get` | 填充一条 prompt |
 | POST | `/v1/mcp` | 添加 MCP 服务器 |
 | DELETE | `/v1/mcp/:name` | 删除 MCP 服务器 |
 | GET | `/v1/skills` | 技能列表（含启用状态） |
@@ -71,9 +86,25 @@ min-agent serve --host 0.0.0.0 --port 3000
 ## `GET /v1/meta`
 
 ```json
-{ "version": "0.1.0", "cwd": "/path/to/project", "instructions_chars": 1234 }
+{ "version": "0.1.0", "cwd": "/path/to/project", "instructions_chars": 1234, "sandbox": { "mode": "off", "network": "allow", "extraWriteRoots": [], "extraReadRoots": [], "source": null, "label": "未隔离，允许联网" }, "permission": { "permission": "ask", "source": null, "label": "询问确认" } }
 ```
 
+## `GET /v1/update`
+
+查询当前运行版本与 npm 上的最新版本。此接口只检查，不会执行 `npm install`。
+
+```json
+{ "current": "0.3.0", "latest": "0.3.1", "update_available": true }
+```
+
+无法访问 npm registry 时：
+
+```json
+{ "current": "0.3.0", "latest": null, "update_available": false, "error": "registry_unavailable" }
+```
+
+CLI 升级请使用 `min-agent update`（执行 `npm install -g min-agent`）。
+
 ## `GET /v1/models`
 
 ```json
@@ -83,9 +114,11 @@ min-agent serve --host 0.0.0.0 --port 3000
 ## `GET /v1/context`
 
 ```json
-{ "context_window": 128000, "model": "gpt-4o" }
+{ "context_window": 1000000, "source": "config", "model": "gpt-4o" }
 ```
 
+`source` 为 `config`（配置中的 `contextWindow`）、`detected`（从接口读到）或 `fallback`（未读到，按 512k 处理）。
+
 ## `GET /v1/project`
 
 ```json
@@ -120,6 +153,14 @@ min-agent serve --host 0.0.0.0 --port 3000
 | `temperature` | number | 采样温度（透传模型 API） |
 | `maxTokens` | number | 最大输出 token 数 |
 | `topP` | number | 核采样参数 |
+| `plan_mode` | boolean | 只读计划模式（去掉写入类工具） |
+| `auto_approve` | boolean | 默认 `true`。设为 `false` 时必须 `stream: true`，并通过 `POST /v1/approvals` / `POST /v1/answers` 回调 |
+| `sandbox` | string | 本轮隔离：`off` / `workspace` / `strict`。只能比服务当前策略更严，不能放宽 |
+| `network` | string | 本轮联网：`allow` / `deny`。`deny` 只能收紧 |
+
+`auto_approve: false` 且未开流式时返回 `400 auto_approve_requires_stream`。确认/提问最多等待 5 分钟，超时视为拒绝或跳过。客户端断开连接时未完成的确认视为拒绝。
+
+`max_steps_reached` 为 `true` 表示本轮已用尽自动续跑次数（上下文压缩/空回复等），或显式设置了 `agent.maxSteps` 且已到达该上限。默认不按固定步数切断一轮生成。`incomplete` 为 `true` 表示模型在调用工具后没有给出完整回复，或连续多次空回复。`stopped` 为 `true` 表示因同一操作反复执行而主动结束本轮。`empty_response` 为 `true` 表示 provider 连续返回空流（HTTP 200 但没有任何内容，多为上游超时/限流），`empty_attempts` 为已尝试次数；这类空回复会以原请求重发重试（首次立即，之后指数退避），可用 `agent.maxEmptyAttempts`（默认 4）与 `agent.emptyRetryDelayMs`（默认 1000）调整。发送下一条消息即可继续。`continues` 为本轮实际自动续跑次数。`task_state` 为当前任务目标与待办列表，会写入会话并在压缩后保留。网页检索连续过久、或检索后尚未写出用户要求的结果时，代理会改为基于已有资料产出结果；本轮内再调用搜索/抓取会收到停止检索并直接产出的提示，而不是新的检索结果（即使 `autoContinue` 为 `false`）。
 
 ### 非流式响应
 
@@ -132,11 +173,23 @@ min-agent serve --host 0.0.0.0 --port 3000
   "session_id": "abc123",
   "step_count": 2,
   "usage": { "inputTokens": 1200, "outputTokens": 300 },
+  "context_tokens": 1200,
   "has_error": false,
-  "aborted": false
+  "aborted": false,
+  "max_steps_reached": false,
+  "incomplete": false,
+  "budget_exceeded": false,
+  "continues": 0,
+  "stopped": false,
+  "empty_response": false,
+  "empty_attempts": 0,
+  "task_state": { "goal": "...", "todos": [], "nextId": 1 },
+  "project": { "languages": [...], "directory": "...", "...": "..." }
 }
 ```
 
+`usage` 为本轮各次模型请求的 token 合计（计费口径；多步工具调用会把每次请求的 input 加总）。`context_tokens` 为最近一次请求占用的上下文大小，用来衡量窗口占用，不要把 `usage.inputTokens` 当占用百分比的分子。
+
 ### 流式 SSE 事件
 
 | type | 字段 | 说明 |
@@ -146,20 +199,18 @@ min-agent serve --host 0.0.0.0 --port 3000
 | `tool_call` | name, input | 工具调用 |
 | `tool_result` | name, output | 工具返回 |
 | `compaction` | line | 压缩进度 |
+| `notice` | kind, attempt, max_attempts, delay_ms | 提示（目前只有 `kind: "empty_response"`，表示 provider 返回空流后即将重发同一请求） |
 | `error` | message | 错误 |
-| `done` | step_count, usage, has_error, aborted, max_steps_reached, budget_exceeded, messages, session_id | 结束 |
+| `done` | step_count, usage, context_tokens, has_error, aborted, max_steps_reached, incomplete, budget_exceeded, continues, stopped, empty_response, empty_attempts, messages, session_id, task_state, project | 结束 |
+| `confirm` | id, message | 等待确认（仅 `auto_approve: false`） |
+| `question` | id, prompt, options | 等待回答（仅 `auto_approve: false`）。`options` 为字符串数组；对象选项（如 `{label, description}`）会先被规范成字符串再下发 |
 | `fatal` | message | 致命错误 |
 
 ---
 
 ## `POST /v1/code`
 
-Code 模式对话（项目感知 prompt + explore 工具）。请求体与 `/v1/chat` 相同。
-
-响应额外包含：
-```json
-{ "mode": "code", "project": { "languages": [...], ... }, ... }
-```
+与 `/v1/chat` 相同的兼容路径。请求体与响应结构一致（含 `project`）。
 
 ---
 
@@ -176,16 +227,17 @@ Code 模式对话（项目感知 prompt + explore 工具）。请求体与 `/v1/
 | `provider` | string | 指定 provider（默认 activeProvider） |
 | `session_id` | string | 追加到会话 |
 | `stream` | boolean | SSE 流式 |
-| `code` | boolean | 使用 code 模式（项目感知） |
 | `temperature` | number | 采样温度 |
 | `maxTokens` | number | 最大输出 token 数 |
 | `topP` | number | 核采样参数 |
+| `plan_mode` | boolean | 只读计划模式 |
+| `auto_approve` | boolean | 同 `/v1/chat` |
 
-`stream: true` 时 SSE 事件与 `/v1/chat` 一致（含 `X-Accel-Buffering: no` 响应头、`done` 事件的 usage/has_error/aborted/max_steps_reached/messages 字段）；非流式响应与 `/v1/chat` 非流式响应结构一致。
+`stream: true` 时 SSE 事件与 `/v1/chat` 一致（含 `X-Accel-Buffering: no` 响应头、`done` 事件的 usage/context_tokens/has_error/aborted/max_steps_reached/incomplete/continues/stopped/empty_response/empty_attempts/task_state/messages 字段）；非流式响应与 `/v1/chat` 非流式响应结构一致。
 
 `session_id` 不存在时返回 `404 session_not_found`（与 `/v1/chat` 一致）。
 
-`code: true` 时非流式响应额外包含 `mode: "code"` 与 `project` 字段。
+非流式响应与 `/v1/chat` 相同，始终包含 `project`。请求里多传 `code` 会被忽略。
 
 ---
 
@@ -201,7 +253,13 @@ Code 模式对话（项目感知 prompt + explore 工具）。请求体与 `/v1/
 ## `GET /v1/sessions/:id`
 
 ```json
-{ "session": { "meta": { "id": "abc", "title": "...", ... }, "messages": [...] } }
+{
+  "session": {
+    "meta": { "id": "abc", "title": "...", "created": "...", "updated": "...", "messageCount": 2 },
+    "taskState": { "goal": "...", "todos": [{ "id": 1, "text": "...", "status": "in_progress" }], "nextId": 2 },
+    "messages": [...]
+  }
+}
 ```
 
 ## `POST /v1/sessions/:id/rename`
@@ -224,6 +282,106 @@ Code 模式对话（项目感知 prompt + explore 工具）。请求体与 `/v1/
 
 截断到最后一条 user 消息（保留该消息，删除其后的 assistant/tool 消息）。
 
+## `POST /v1/chat/redo`
+
+取出会话中最后一条用户文本，追加一轮后再跑。请求体与 `/v1/chat` 相同的可选字段（`stream`、`model`、`provider`、`plan_mode`、`auto_approve`、采样参数），`session_id` 必填。
+
+```json
+// 请求
+{ "session_id": "abc123", "stream": false }
+```
+
+没有用户文本时返回 `400 no_user_message`。
+
+## `GET /v1/budget`
+
+```json
+{ "maxCostUSD": 5, "source": "global" }
+```
+
+`source` 为 `project`、`global` 或 `null`（未设置）。`maxCostUSD` 为合并后的生效值。
+
+## `POST /v1/budget`
+
+```json
+// 请求
+{ "maxCostUSD": 8, "scope": "project" }
+// 响应
+{ "ok": true, "maxCostUSD": 8, "source": "project", "scope": "project" }
+```
+
+`scope` 省略时写入全局。`maxCostUSD` 必须为正数。
+
+## `GET /v1/permission`
+
+```json
+{ "permission": "ask", "source": null, "label": "询问确认" }
+```
+
+`permission` 为 `ask` / `accept-edits` / `allow-all`。`source` 为 `cli`、`project`、`global` 或 `null`（使用默认：询问确认）。
+
+## `POST /v1/permission`
+
+```json
+// 请求
+{ "permission": "accept-edits", "scope": "project" }
+// 响应
+{ "ok": true, "scope": "project", "permission": "accept-edits", "source": "project", "label": "自动允许改文件" }
+```
+
+`scope` 省略时写入全局。`permission` 必须为 `ask` / `accept-edits` / `allow-all`。
+
+## `GET /v1/sandbox`
+
+```json
+{ "mode": "off", "network": "allow", "extraWriteRoots": [], "extraReadRoots": [], "source": null, "label": "未隔离，允许联网" }
+```
+
+`source` 为 `cli`、`env`、`project`、`global` 或 `null`（使用默认：不隔离）。未配置时 `mode` 为 `off`。
+
+## `POST /v1/sandbox`
+
+```json
+// 请求
+{ "mode": "workspace", "network": "deny", "scope": "project" }
+// 响应
+{ "ok": true, "scope": "project", "mode": "workspace", "network": "deny", "extraWriteRoots": [], "extraReadRoots": [], "source": "project", "label": "工作区隔离，禁止联网" }
+```
+
+`scope` 省略时写入全局。至少提供 `mode`、`network`、`extraWriteRoots`、`extraReadRoots` 之一。`mode` 为 `off` / `workspace` / `strict`；`network` 为 `allow` / `deny`。
+
+## `GET /v1/diff`
+
+```json
+{ "ok": true, "diff": "..." }
+```
+
+非 git 仓库或无变更时仍返回 200：`{ "ok": false, "reason": "not_git"|"no_changes"|"error", "message": "..." }`。
+
+## `POST /v1/approvals`
+
+配合 SSE `confirm` 事件。
+
+```json
+// 请求
+{ "id": "…", "accepted": true }
+// 响应
+{ "ok": true, "id": "…", "accepted": true }
+```
+
+未知 id 返回 `404 unknown_approval_id`。
+
+## `POST /v1/answers`
+
+配合 SSE `question` 事件。`answer` 为 `null` 表示跳过。
+
+```json
+// 请求
+{ "id": "…", "answer": "use bun" }
+```
+
+未知 id 返回 `404 unknown_answer_id`。
+
 ## `GET /v1/skills`
 
 ```json
@@ -246,6 +404,7 @@ Code 模式对话（项目感知 prompt + explore 工具）。请求体与 `/v1/
 ```
 
 禁用项额外带 `disabled_scope`（`global` 或 `project`）。
+随包装载的技能额外带 `builtin: true`；会话开始即注入正文的技能额外带 `always_load: true`（内置 `self-config` 即如此）。
 `stale_disabled` 列出两个范围的 `disabledSkills` 中没有对应技能的名字（拼写错误或技能已删除）。
 
 ## `GET /v1/skills/:name`
@@ -328,28 +487,42 @@ Code 模式对话（项目感知 prompt + explore 工具）。请求体与 `/v1/
 ## `GET /v1/memory`
 
 ```json
-{ "memories": [{ "content": "...", "tags": [...], "created": "..." }] }
+{
+  "memories": [{ "content": "...", "tags": [...], "created": "..." }],
+  "project_memories": [{ "content": "...", "tags": [...], "created": "..." }]
+}
 ```
 
+`memories` 始终为全局；`project_memories` 为当前目录 `.min-agent/memory.json`。
+
 ## `POST /v1/memory`
 
 ```json
 // 请求
-{ "content": "prefer TypeScript", "tags": ["preference"] }
+{ "content": "prefer TypeScript", "tags": ["preference"], "scope": "project" }
 // 响应
-{ "ok": true, "memory": {...} }
+{ "ok": true, "memory": {...}, "scope": "project" }
 ```
 
+`scope` 省略时写入全局（兼容旧客户端）。非法值返回 `400 invalid_scope`。
+
 ## `GET /v1/memory/search?q=typescript`
 
+可选 `scope=global|project`。省略时两个商店都搜。
+
 ```json
-{ "results": [{ "content": "...", "tags": [...], "index": 0 }] }
+{
+  "results": [{ "content": "...", "tags": [...], "index": 0 }],
+  "project_results": []
+}
 ```
 
 ## `DELETE /v1/memory/:index`
 
+可选 `?scope=project`；默认全局。索引从 1 开始，按对应商店编号。
+
 ```json
-{ "ok": true, "deleted": 1 }
+{ "ok": true, "deleted": 1, "scope": "global" }
 ```
 
 ---
@@ -359,12 +532,53 @@ Code 模式对话（项目感知 prompt + explore 工具）。请求体与 `/v1/
 ```json
 {
   "servers": {
-    "filesystem": { "connected": true, "enabled": true, "tools": ["read_file", "write_file"] },
-    "broken": { "connected": false, "enabled": true, "tools": [], "error": "connection timed out after 30000ms" }
+    "filesystem": { "connected": true, "enabled": true, "tools": ["read_file", "write_file"], "resource_count": 2, "prompt_count": 1 },
+    "broken": { "connected": false, "enabled": true, "tools": [], "resource_count": 0, "prompt_count": 0, "error": "connection timed out after 30000ms" }
   }
 }
 ```
 
+`resource_count` / `prompt_count` 为连接时缓存的数量。未声明 resources/prompts 的服务器为 0。
+
+## `GET /v1/mcp/:name/resources`
+
+```json
+{
+  "name": "filesystem",
+  "resources": [{ "uri": "file:///tmp/a.txt", "name": "a.txt", "mimeType": "text/plain" }],
+  "templates": [{ "uriTemplate": "file:///{path}", "name": "file" }]
+}
+```
+
+未配置返回 `404 mcp_not_found`；已配置但未连接返回 `404 mcp_not_connected`。
+
+## `GET /v1/mcp/:name/prompts`
+
+```json
+{
+  "name": "docs",
+  "prompts": [{ "name": "review", "description": "Review a file", "arguments": [{ "name": "path", "required": true }] }]
+}
+```
+
+## `POST /v1/mcp/:name/resources/read`
+
+```json
+// 请求
+{ "uri": "file:///tmp/a.txt" }
+// 响应
+{ "ok": true, "name": "filesystem", "uri": "file:///tmp/a.txt", "content": "..." }
+```
+
+## `POST /v1/mcp/:name/prompts/get`
+
+```json
+// 请求
+{ "prompt": "review", "arguments": { "path": "src/a.ts" } }
+// 响应
+{ "ok": true, "name": "docs", "prompt": "review", "content": "user: ..." }
+```
+
 ## `POST /v1/mcp`
 
 添加或覆盖一个 MCP 服务器。保存后立即重连（`sync`），响应带实时状态。
@@ -431,7 +645,7 @@ curl -N http://127.0.0.1:8787/v1/chat \
   -H "Content-Type: application/json" \
   -d '{"message":"say hi","stream":true}'
 
-# Code 模式
+# 兼容路径 /v1/code
 curl http://127.0.0.1:8787/v1/code \
   -H "Content-Type: application/json" \
   -d '{"message":"add error handling to login"}'
@@ -451,6 +665,24 @@ curl -X POST http://127.0.0.1:8787/v1/memory \
   -H "Content-Type: application/json" \
   -d '{"content":"prefer TypeScript","tags":["preference"]}'
 
+# 设置项目预算
+curl -X POST http://127.0.0.1:8787/v1/budget \
+  -H "Content-Type: application/json" \
+  -d '{"maxCostUSD":5,"scope":"project"}'
+
+# 设置确认模式
+curl -X POST http://127.0.0.1:8787/v1/permission \
+  -H "Content-Type: application/json" \
+  -d '{"permission":"accept-edits","scope":"project"}'
+
+# 启用工作区隔离
+curl -X POST http://127.0.0.1:8787/v1/sandbox \
+  -H "Content-Type: application/json" \
+  -d '{"mode":"workspace","scope":"project"}'
+
+# 查看工作区变更
+curl http://127.0.0.1:8787/v1/diff
+
 # 压缩会话
 curl -X POST http://127.0.0.1:8787/v1/chat/compact \
   -H "Content-Type: application/json" \