@attson/atwebpilot-mcp 0.0.70 → 0.0.72

package/README.md

@@ -49,20 +49,36 @@ listen 端口的能力，所以方向只能如此。这也是配对页存在的
 ## 工具面
 
 - 控制面 4 个：`list_tabs / open_session / close_session / get_quota`
-- 执行面 54 个 `browser_*`：扩展的全部内置工具，除了 `askUser`（MCP 会话没有人在侧边栏应答）和
-  `attachTab` / `detachTab`（侧边栏多 tab 记账，MCP 的目标 tab 已由 `open_session` 绑定）。
+- 发现 1 个：`browser_discoverTools` —— 不带参数返回未发布工具目录（按 `export / network / storage / browser-data / inspect / legacy-dom / form / tabs` 分组）；带 `enable: [...]` 把它们加进本进程的 `tools/list`（发送 `tools/list_changed`），并直接返回完整 schema。
+- 执行面默认 **core 31 个** `browser_*`：浏览 / 采集 / 填表 / 导航 / 截图 闭环所需的工具。其余 20 个由 AI 按需 `discoverTools` 拉取，用户不用配置。
+- 不暴露 `askUser`（MCP 会话没有人在侧边栏应答）和 `attachTab` / `detachTab`（目标 tab 已由 `open_session` 绑定）。
+
+MCP 层的描述是精简英文（≈2.5k tokens for core），侧边栏内置 LLM 仍用中文长描述；两者共享同一份 `TOOL_DEFS`，靠 `mcp` 字段区分。
 
 工具列表会和扩展 `HELLO` 里上报的 `supported_tools` 求交集，所以旧版扩展配新版 server 时不会
-出现「列出来但一调就 unknown tool」。字段缺失（Plan 32 之前的扩展）时回落到旧的 19 个。
+出现「列出来但一调就 unknown tool」。字段缺失（Plan 32 之前的扩展）时回落到旧版扩展支持的内置
+工具集，与 core 求交集后只剩 9 个（`extractText / click / fillInput / selectOption / setCheckbox /
+hover / uploadFile / scroll / waitFor`）；`browser_storage` 也不会列出，因为旧版没有
+`writeStorage`。请升级扩展。
 
 ### 环境变量 `ATWEBPILOT_MCP_TOOLS`
 
 | 值 | 效果 |
 |---|---|
-| `full`（默认） | 全部 54 个 |
-| `parity` | 只出对标 playwright-ext 那 24 个能力的子集，省上下文 |
+| `core`（默认） | 31 个核心工具 + `browser_discoverTools`，其余按需发现 |
+| `full` | 一开始就全部列出（51 个），适合不想让 AI 多一步发现的用户 |
+
+无法识别的值（包括已移除的 `parity`）按 `core` 处理，并往 stderr 打一条提示。
 
-无法识别的值按 `full` 处理，并往 stderr 打一条提示。
+### 从 0.0.70 及更早版本迁移
+
+| 旧 | 新 |
+|---|---|
+| `browser_navigateBack` / `browser_navigateForward` | `browser_navigate({ action: "back" \| "forward" })` |
+| `browser_highlightElement` / `browser_highlightText` | `browser_highlight({ selector \| uid \| text })` |
+| `browser_readStorage` / `browser_writeStorage` | `browser_storage({ op: "get" \| "set", store, key, value? })` |
+| `ATWEBPILOT_MCP_TOOLS=parity` | 已移除；默认即 `core` |
+| 默认列出全部工具 | 默认只列 core；其余通过 `browser_discoverTools` 获取，或设 `ATWEBPILOT_MCP_TOOLS=full` |
 
 ## 替代 playwright-ext
 
@@ -78,8 +94,8 @@ listen 端口的能力，所以方向只能如此。这也是配对页存在的
 | `browser_select_option` / `browser_hover` / `browser_press_key` | 同名去掉下划线：`browser_selectOption` / `browser_hover` / `browser_pressKey` |
 | `browser_drag` / `browser_drop` | `browser_drag` / `browser_drop` |
 | `browser_file_upload` | `browser_uploadFile` |
-| `browser_navigate` / `browser_navigate_back` | `browser_navigate` / `browser_navigateBack`（另有 `navigateForward`） |
-| `browser_tabs` | `browser_listTabs` / `openTab` / `closeTab` / `switchToTab` |
+| `browser_navigate` / `browser_navigate_back` | `browser_navigate`（`action` 取 `goto` / `back` / `forward` / `reload`） |
+| `browser_tabs` | `browser_listTabs` / `openTab` / `closeTab`; `switchToTab` 需按需发现，仅用于用户明确要求前台切换 |
 | `browser_close` | `browser_closeTab` |
 | `browser_resize` | `browser_resize` |
 | `browser_take_screenshot` | `browser_screenshot`（含 `fullPage` / `format` / `scale`） |

package/dist/index.js

@@ -970,6 +970,10 @@ var TOOL_DEFS = [
   {
     name: "snapshotDOM",
     description: "[FIRST\xB7LEGACY] \u8FD4\u56DE\u9875\u9762 DOM \u7B80\u5316\u6811\uFF08tag/id/classes/\u76F4\u63A5\u6587\u672C/children\uFF09\u3002\n\u5982\u679C\u4F60\u53EA\u662F\u8981\u627E\u4EA4\u4E92\u5143\u7D20\u5E76\u968F\u540E\u64CD\u4F5C\uFF0C**\u4F18\u5148\u7528 takeSnapshot**\uFF08UID \u7A33\u5B9A\uFF0CclickByUid \u5065\u58EE\uFF09\uFF1B\nsnapshotDOM \u66F4\u9002\u5408\u300C\u6211\u8981\u5206\u6790\u6574\u4E2A\u9875\u9762\u7ED3\u6784\u300D\u8FD9\u79CD\u63A2\u67E5\u7C7B\u9700\u6C42\u3002\n\n\u793A\u4F8B\uFF1A\n- \u770B\u6574\u9875\uFF1A{ }\uFF08\u9ED8\u8BA4 maxDepth=3\uFF09\n- \u770B\u67D0\u533A\u57DF\uFF1A{ root: '.main-content', maxDepth: 5 }\n- \u770B\u5230\u5E95\uFF1A{ maxDepth: 8 }",
+    mcp: {
+      description: "Simplified DOM tree (tag/id/classes/text/children) for analysing page structure. Prefer takeSnapshot when you intend to click or fill.",
+      params: { root: "CSS selector to start from; defaults to <html>" }
+    },
     input_schema: {
       type: "object",
       properties: {
@@ -982,6 +986,7 @@ var TOOL_DEFS = [
   {
     name: "querySelector",
     description: "[FAST] \u8FD4\u56DE\u9996\u4E2A\u5339\u914D\u5143\u7D20\u7684\u6D45\u5C42\u6458\u8981 (tag/id/classes/text/attrs)\u3002\u4EC5\u63A2\u67E5\u7528\u3002\n\u8981\u540E\u7EED\u70B9\u51FB\u6216\u586B\u503C\uFF0C\u914D\u5408 selector \u76F4\u63A5\u4F20\u7ED9 click / fillInput\uFF0C\u6216\u7528 takeSnapshot \u62FF UID\u3002\n\n\u793A\u4F8B\uFF1A\n- \u627E\u6309\u94AE\uFF1A{ selector: 'button[type=submit]' }\n- \u627E\u8F93\u5165\uFF1A{ selector: 'input[name=email]' }",
+    mcp: { description: "Shallow summary (tag/id/classes/text/attrs) of the first element matching a CSS selector." },
     input_schema: {
       type: "object",
       properties: {
@@ -995,6 +1000,7 @@ var TOOL_DEFS = [
   {
     name: "querySelectorAll",
     description: "[FAST] \u8FD4\u56DE\u6240\u6709\u5339\u914D\u5143\u7D20\u7684\u6D45\u5C42\u6458\u8981\u6570\u7EC4\u3002\n\n\u793A\u4F8B\uFF1A\n- \u6240\u6709\u8BC4\u8BBA\uFF1A{ selector: '.comment-item', limit: 50 }\n- \u6240\u6709\u94FE\u63A5\uFF1A{ selector: 'a[href]', limit: 20 }",
+    mcp: { description: "Shallow summaries of all elements matching a CSS selector." },
     input_schema: {
       type: "object",
       properties: {
@@ -1009,6 +1015,10 @@ var TOOL_DEFS = [
   {
     name: "inspectElement",
     description: "[FAST\xB7READ\xB7LAYOUT] \u8BFB\u53D6\u5143\u7D20\u7684\u8FD0\u884C\u65F6\u5E03\u5C40\u771F\u76F8\uFF1Acomputed style\u3001viewport/document rect\u3001\u53EF\u89C1\u6027\u3001\u7956\u5148\u94FE\u4E0E shadow root \u4FE1\u606F\u3002\n\u8C03\u8BD5 display/box-sizing/position/overflow/z-index\u3001\u5F39\u7A97\u6302\u8F7D\u70B9\u6216\u7236\u7EA7\u5E03\u5C40\u65F6\u4F18\u5148\u7528\u5B83\uFF0C\u4E0D\u8981\u4E3A\u8FD9\u4E9B\u53EA\u8BFB\u4FE1\u606F\u8C03\u7528 runJS\u3002",
+    mcp: {
+      description: "Runtime layout truth for one element: computed style, rects, visibility, ancestor chain, shadow root. Use for display/overflow/z-index/positioning questions instead of runJS.",
+      params: { selector: "CSS selector; one of selector/uid", uid: "uid from takeSnapshot/findElements; one of selector/uid", styleProperties: "CSS properties to read; defaults to common layout props" }
+    },
     input_schema: {
       type: "object",
       properties: {
@@ -1028,6 +1038,7 @@ var TOOL_DEFS = [
   {
     name: "extractText",
     description: "[FAST\xB7TARGETED] \u63D0\u53D6\u9009\u62E9\u5668\u547D\u4E2D\u5143\u7D20\u7684\u6587\u672C\u3002single=true \u8FD4\u56DE\u5B57\u7B26\u4E32\uFF0C\u5426\u5219\u8FD4\u56DE\u6570\u7EC4\u3002\n\u53EA\u7528\u4E8E\u660E\u786E\u7684\u5C0F\u8303\u56F4 selector\uFF1B\u666E\u901A\u7F51\u9875\u7406\u89E3/\u5B57\u6BB5\u63D0\u53D6\u4E0D\u8981\u7528 extractText({selector:'body'})\uFF0C\u5148\u7528 createPageIndex + extractPageFields/searchPageIndex\u3002\n\n\u793A\u4F8B\uFF1A\n- \u63D0\u53D6\u6807\u9898\uFF1A{ selector: 'h1', single: true }\n- \u63D0\u53D6\u6240\u6709\u6BB5\u843D\uFF1A{ selector: 'article p' }",
+    mcp: { description: "Text of elements matching a small, targeted CSS selector. single=true returns a string, else an array. Do not use on body; use createPageIndex for whole pages." },
     input_schema: {
       type: "object",
       properties: {
@@ -1043,6 +1054,10 @@ var TOOL_DEFS = [
   {
     name: "createPageIndex",
     description: "[PAGE-INDEX][FIRST\xB7READ] \u5728\u5185\u5BB9\u811A\u672C\u672C\u5730\u6784\u5EFA/\u5237\u65B0\u9875\u9762\u7D22\u5F15\uFF0C\u8FD4\u56DE\u5C0F\u578B\u9875\u9762\u5730\u56FE\u3001blockId\u3001kinds\u3001truncation \u5143\u6570\u636E\u3002\n\u7528\u4E8E\u666E\u901A\u7F51\u9875\u7406\u89E3\u3001\u5546\u54C1/\u6587\u7AE0/\u8868\u683C\u5B57\u6BB5\u63D0\u53D6\u3001\u91C7\u96C6\u524D\u5B9A\u4F4D\u3002\u4E0D\u8981\u5148\u8BFB\u53D6 body\uFF1B\u5148\u5EFA\u7D22\u5F15\uFF0C\u518D\u7528 extractPageFields/searchPageIndex\u3002",
+    mcp: {
+      description: "Build or refresh a local page index; returns a compact page map with blockIds. Call first on any content page before extractPageFields/searchPageIndex.",
+      params: { refresh: "true = rescan, ignore cache" }
+    },
     input_schema: {
       type: "object",
       properties: {
@@ -1056,6 +1071,7 @@ var TOOL_DEFS = [
   {
     name: "searchPageIndex",
     description: "[PAGE-INDEX] \u5728\u672C\u5730\u9875\u9762\u7D22\u5F15\u4E2D\u641C\u7D22\u5173\u952E\u8BCD/\u5B57\u6BB5\uFF0C\u8FD4\u56DE\u5C0F\u8BC1\u636E\u7247\u6BB5\u3001blockId\u3001complete/availableChars\u3001truncation \u5143\u6570\u636E\u3002\n\u9002\u5408\u5B9A\u4F4D\u6392\u540D\u3001\u4EF7\u683C\u3001\u8BC4\u8BBA\u6570\u3001\u65E5\u671F\u7B49\u8BC1\u636E\uFF1B\u4E0D\u8981\u7528 extractText({selector:'body'}) \u6765\u641C\u7D22\u5927\u9875\u9762\u3002",
+    mcp: { description: "Search the page index for a keyword/field; returns evidence snippets with blockIds.", params: { query: "keyword or phrase" } },
     input_schema: {
       type: "object",
       properties: {
@@ -1071,6 +1087,10 @@ var TOOL_DEFS = [
   {
     name: "readPageBlock",
     description: "[PAGE-INDEX] \u6309 blockId \u8BFB\u53D6\u5C40\u90E8\u5185\u5BB9\uFF1B\u957F\u5185\u5BB9\u6309 offset/maxChars \u5206\u9875\uFF0C\u8FD4\u56DE hasMore\u3001nextOffset\u3001recommendedNext \u548C truncation \u65E5\u5FD7\u3002\n\u53EA\u5728 searchPageIndex/extractPageFields \u8BC1\u636E\u4E0D\u8DB3\u6216\u9700\u8981\u6838\u5BF9\u90BB\u8FD1\u4E0A\u4E0B\u6587\u65F6\u4F7F\u7528\u3002",
+    mcp: {
+      description: "Read one index block by blockId, paged via offset/maxChars. Use when search/extract evidence is insufficient.",
+      params: { blockId: "blockId from createPageIndex/searchPageIndex/extractPageFields", indexId: "bind to the index that produced blockId" }
+    },
     input_schema: {
       type: "object",
       properties: {
@@ -1087,6 +1107,7 @@ var TOOL_DEFS = [
   {
     name: "extractPageFields",
     description: "[PAGE-INDEX][FIELD-FIRST] \u901A\u7528\u5B57\u6BB5\u5019\u9009\u63D0\u53D6\uFF1A\u8F93\u5165\u5B57\u6BB5\u540D\u6570\u7EC4\uFF0C\u8FD4\u56DE value candidates\u3001confidence\u3001evidence\u3001blockId\u3001truncation\u3002\n\u9002\u5408\u5546\u54C1\u4FE1\u606F\u3001\u6587\u7AE0\u5143\u4FE1\u606F\u3001\u8868\u683C\u8BE6\u60C5\u3001\u8868\u5355\u5B57\u6BB5\u7B49\u7ED3\u6784\u5316\u63D0\u53D6\uFF1B\u8BC1\u636E\u4E0D\u8DB3\u518D\u7528 readPageBlock \u5B9A\u5411\u8BFB\u53D6\u3002",
+    mcp: { description: "Extract named fields (price, author, date, \u2026) from the page index with candidates, confidence and evidence.", params: { fields: "field names to extract" } },
     input_schema: {
       type: "object",
       properties: {
@@ -1102,6 +1123,7 @@ var TOOL_DEFS = [
   {
     name: "extractImages",
     description: "[FAST] \u5728 root \u8303\u56F4\u5185\u63D0\u53D6\u6240\u6709 <img> \u7684 src/data-src/srcset\uFF1BincludeBg=true \u65F6\u4E5F\u63D0\u53D6\u80CC\u666F\u56FE\u3002\u8FD4\u56DE [{url, via}].\n\n\u793A\u4F8B\uFF1A\n- \u5168\u9875\u56FE\uFF1A{ }\uFF08\u9ED8\u8BA4 root=document\uFF09\n- \u5546\u54C1\u4E3B\u56FE\uFF1A{ root: '.product-gallery' }",
+    mcp: { description: "All <img> src/data-src/srcset under root; includeBg=true adds CSS background images." },
     input_schema: {
       type: "object",
       properties: {
@@ -1114,6 +1136,7 @@ var TOOL_DEFS = [
   {
     name: "scroll",
     description: "[FLOW] \u6EDA\u52A8\u9875\u9762\u3002to \u53EF\u4E3A 'bottom' / 'top' / number\u3002max \u662F\u6EDA\u52A8\u6B21\u6570\uFF1BuntilSelector \u51FA\u73B0\u65F6\u63D0\u524D\u505C\u3002\n\n\u793A\u4F8B\uFF1A\n- \u89E6\u53D1\u61D2\u52A0\u8F7D\uFF1A{ to: 'bottom', max: 5 }\n- \u6EDA\u5230\u951A\u70B9\uFF1A{ to: 'top' } \u540E\u7528 element.scrollIntoView \u4E5F\u53EF\n- \u7B49\u5F85\u65B0\u5143\u7D20\uFF1A{ to: 'bottom', max: 10, untilSelector: '.item:nth-child(20)' }",
+    mcp: { description: "Scroll the page. to = 'top' | 'bottom' | pixel number; max = repeat count; untilSelector stops early when it appears (lazy-load).", params: { to: "'bottom' | 'top' | number" } },
     input_schema: {
       type: "object",
       properties: {
@@ -1129,6 +1152,7 @@ var TOOL_DEFS = [
   {
     name: "waitFor",
     description: "[FLOW] \u7B49\u5F85\u56FA\u5B9A ms\uFF0C\u6216\u7B49\u5F85\u9009\u62E9\u5668\u51FA\u73B0\uFF08\u5E26 timeoutMs \u515C\u5E95\uFF09\u3002\n\n\u793A\u4F8B\uFF1A\n- \u7B49 500ms\uFF1A{ ms: 500 }\n- \u7B49\u5143\u7D20\u51FA\u73B0\uFF1A{ selector: '.lazy-loaded', timeoutMs: 8000 }",
+    mcp: { description: "Wait a fixed ms, or until a selector/text appears or text disappears, with timeoutMs.", params: { text: "wait until this text appears", textGone: "wait until this text disappears" } },
     input_schema: {
       type: "object",
       properties: {
@@ -1144,6 +1168,7 @@ var TOOL_DEFS = [
   {
     name: "click",
     description: "[ACT] \u70B9\u51FB\u9009\u62E9\u5668\u547D\u4E2D\u7684\u5143\u7D20\u3002required=false \u65F6\u627E\u4E0D\u5230\u4E0D\u62A5\u9519\u3002\u4F1A\u7ECF\u8FC7\u5BA1\u9605\uFF08caution\uFF09\u3002\n\u7528 takeSnapshot \u62FF\u5230 UID \u540E\u5EFA\u8BAE\u6539\u7528 clickByUid\uFF0C\u66F4\u7A33\u3002",
+    mcp: { description: "Click the element matching a CSS selector. Supports button/doubleClick/modifiers. required=false makes a missing element a no-op. Prefer clickByUid after takeSnapshot." },
     input_schema: {
       type: "object",
       properties: {
@@ -1163,6 +1188,7 @@ var TOOL_DEFS = [
   {
     name: "httpRequest",
     description: "[ACT] \u901A\u8FC7\u540E\u53F0\u4EE3\u7406\u53D1\u8BF7\u6C42\u3002withCredentials=true \u65F6\u5E26 cookie\uFF08dangerous\uFF0C\u8981\u5BA1\u9605\uFF09\uFF1B\u9ED8\u8BA4 omit\u3002\n\n\u793A\u4F8B\uFF1A\n- \u7FFB\u8BC4\u8BBA\u9875\uFF1A{ url: 'https://x.com/api/comments?page=2', withCredentials: false }\n- \u5E26\u767B\u5F55\u6001\u8C03\u5185\u90E8\u63A5\u53E3\uFF1A{ url: '...', withCredentials: true }",
+    mcp: { description: "HTTP request via the background proxy. withCredentials=true sends cookies (dangerous, reviewed); default omits them.", params: { body: "any JSON value" } },
     input_schema: {
       type: "object",
       properties: {
@@ -1179,6 +1205,7 @@ var TOOL_DEFS = [
   {
     name: "readStorage",
     description: "[DANGER] \u8BFB localStorage \u6216 sessionStorage \u6307\u5B9A key\u3002\u9700\u8981\u5BA1\u9605\u3002",
+    mcp: { description: "Read one key from localStorage or sessionStorage (dangerous, reviewed)." },
     input_schema: {
       type: "object",
       properties: {
@@ -1192,6 +1219,10 @@ var TOOL_DEFS = [
   {
     name: "fillInput",
     description: "[ACT] \u5F80 input/textarea/contenteditable \u586B\u503C\uFF1B\u89E6\u53D1 input/change \u4E8B\u4EF6\u517C\u5BB9 React/Vue\u3002\n**\u6279\u91CF\u586B\u8868\u8BF7\u7528 fillForm**\uFF08\u66F4\u9AD8\u6548\uFF09\u3002\n\n\u793A\u4F8B\uFF1A\n- \u586B\u90AE\u7BB1\uFF1A{ selector: 'input[name=email]', value: 'a@b.c' }\n- \u4E0D\u6E05\u7A7A\u76F4\u63A5\u8FFD\u52A0\uFF1A{ selector: '.editor', value: 'tail', clear: false }",
+    mcp: {
+      description: "Set the value of an input/textarea/contenteditable and fire input/change. Use fillForm for several fields.",
+      params: { slowly: "type char by char for controlled components", submit: "press Enter afterwards" }
+    },
     input_schema: {
       type: "object",
       properties: {
@@ -1212,6 +1243,7 @@ var TOOL_DEFS = [
   {
     name: "setCheckbox",
     description: "[ACT] \u8BBE\u7F6E checkbox \u52FE\u9009\u72B6\u6001\uFF1B\u6D3E\u53D1 change \u4E8B\u4EF6\u3002",
+    mcp: { description: "Set a checkbox's checked state and dispatch change." },
     input_schema: {
       type: "object",
       properties: {
@@ -1225,6 +1257,7 @@ var TOOL_DEFS = [
   {
     name: "selectOption",
     description: "[ACT] <select> \u5143\u7D20\u6309 value \u6216 label \u9009\u9879\u3002\u540C\u65F6\u7ED9\u4E24\u8005\u65F6\u4F18\u5148 value\u3002",
+    mcp: { description: "Choose a <select> option by value or label (value wins if both given)." },
     input_schema: {
       type: "object",
       properties: {
@@ -1239,6 +1272,7 @@ var TOOL_DEFS = [
   {
     name: "submitForm",
     description: "[CONFIRM\xB7DANGER] \u63D0\u4EA4 <form>\u3002\u4F1A\u89E6\u53D1\u670D\u52A1\u7AEF\u52A8\u4F5C\uFF08\u4E0B\u5355\u3001\u7559\u8A00\u7B49\uFF09\uFF0C\u7528\u6237\u5FC5\u987B\u5BA1\u9605\u3002\n\u8C03\u7528\u524D\u5EFA\u8BAE\u5148\u7528 askUser \u8BA9\u7528\u6237\u6700\u7EC8\u786E\u8BA4\u3002",
+    mcp: { description: "Submit a <form> (dangerous: triggers server-side actions, reviewed)." },
     input_schema: {
       type: "object",
       properties: {
@@ -1251,6 +1285,7 @@ var TOOL_DEFS = [
   {
     name: "hover",
     description: "[ACT] \u628A\u9F20\u6807\u60AC\u505C\u5728\u5143\u7D20\u4E0A\uFF08\u89E6\u53D1 mouseenter / mouseover / mousemove\uFF09\u3002",
+    mcp: { description: "Hover an element (mouseenter/mouseover/mousemove)." },
     input_schema: {
       type: "object",
       properties: {
@@ -1263,6 +1298,7 @@ var TOOL_DEFS = [
   {
     name: "focus",
     description: "[ACT] \u628A\u7126\u70B9\u7ED9\u67D0\u5143\u7D20\uFF08\u89E6\u53D1 focus / focusin\uFF09\u3002",
+    mcp: { description: "Focus an element (focus/focusin)." },
     input_schema: {
       type: "object",
       properties: {
@@ -1275,6 +1311,7 @@ var TOOL_DEFS = [
   {
     name: "uploadFile",
     description: "[CONFIRM\xB7DANGER] \u628A\u540E\u7AEF\u4EE3\u7406\u62C9\u5230\u7684\u6587\u4EF6\u586B\u5230 <input type=file>\u3002\u67D0\u4E9B\u7AD9\u70B9\u4F1A\u62D2\u7EDD\u5408\u6210 File\u3002",
+    mcp: { description: "Fetch a URL through the proxy and put it into an <input type=file> (dangerous, reviewed). Some sites reject synthetic files." },
     input_schema: {
       type: "object",
       properties: {
@@ -1290,6 +1327,7 @@ var TOOL_DEFS = [
   {
     name: "getValue",
     description: "[FAST] \u8BFB input/select/textarea/contenteditable \u7684\u5F53\u524D\u503C\u3002",
+    mcp: { description: "Current value of an input/select/textarea/contenteditable." },
     input_schema: {
       type: "object",
       properties: {
@@ -1302,6 +1340,7 @@ var TOOL_DEFS = [
   {
     name: "extractFormState",
     description: "[FAST\xB7USE BEFORE FILL] \u628A <form> \u5185\u6240\u6709\u53EF\u586B\u5B57\u6BB5\u8BFB\u6210 {name: value} \u5BF9\u8C61\uFF08radio \u53D6\u9009\u4E2D\u503C\uFF1Bcheckbox \u591A\u9009\u53D6\u6570\u7EC4\uFF09\u3002\n\u586B\u8868\u524D\u5148\u8C03\u4E00\u6B21\uFF0C\u80FD\u7701\u4E0B\u5927\u91CF\u76F2\u586B\u3002",
+    mcp: { description: "All fillable fields of a <form> as {name: value}. Call before filling to avoid blind fills.", params: { form: "CSS selector of the form; defaults to the first form" } },
     input_schema: {
       type: "object",
       properties: {
@@ -1313,6 +1352,10 @@ var TOOL_DEFS = [
   {
     name: "runJS",
     description: "[LAST RESORT\xB7DANGER] \u5728 MAIN world \u6CE8\u5165\u5E76\u6267\u884C async \u51FD\u6570\u4F53\uFF08receives `ctx` = bindings\uFF09\u3002\u5FC5\u987B return \u503C\u3002\n**\u4EC5\u5728\u7ED3\u6784\u5316\u5DE5\u5177\u4E0D\u591F\u7528\u65F6\u4F7F\u7528**\u2014\u2014\u4F1A\u7ECF\u8FC7\u9759\u6001\u626B\u63CF\u4E0E\u4EBA\u5DE5\u5BA1\u9605\u3002\u4E25\u683C CSP \u9875\u9762\u9700\u8981\u7528\u6237\u9884\u5148\u5728\u6269\u5C55\u8BBE\u7F6E\u4E2D\u5F00\u542F CDP/debugger\uFF1B\u8BFB\u53D6\u6837\u5F0F\u3001\u4F4D\u7F6E\u6216\u7956\u5148\u94FE\u8BF7\u4F18\u5148\u4F7F\u7528 inspectElement\u3002",
+    mcp: {
+      description: "Last resort: run an async function body in the page MAIN world; must return a value. Statically scanned and reviewed. Strict-CSP pages need CDP enabled in extension settings.",
+      params: { source: "async function body" }
+    },
     input_schema: {
       type: "object",
       properties: {
@@ -1327,6 +1370,7 @@ var TOOL_DEFS = [
   {
     name: "listTabs",
     description: "[META] \u5217\u51FA\u6240\u6709\u7A97\u53E3\u7684\u53EF\u8BBF\u95EE tab\uFF1B\u8FD4\u56DE [{tabId, windowId, url, title, attached, isCurrent}]\u3002\n\u5728\u4F60\u9700\u8981\u8BC6\u522B / \u627E\u65B0 tab \u65F6\u8C03\u7528\u3002",
+    mcp: { description: "List accessible tabs across windows: [{tabId, windowId, url, title, attached, isCurrent}].", params: { windowId: "restrict to one window" } },
     input_schema: {
       type: "object",
       properties: {
@@ -1337,6 +1381,7 @@ var TOOL_DEFS = [
   {
     name: "openTab",
     description: "[META] \u6253\u5F00\u65B0 tab\uFF0C\u6210\u529F\u540E\u81EA\u52A8\u52A0\u5165\u4F1A\u8BDD attachedTabs\uFF08source=ai-open\uFF09\u3002\u8FD4\u56DE {tabId, url, title}\u3002",
+    mcp: { description: "Open a new tab and attach it to the session. Returns {tabId, url, title}.", params: { active: "true = switch to it" } },
     input_schema: {
       type: "object",
       properties: {
@@ -1370,6 +1415,7 @@ var TOOL_DEFS = [
   {
     name: "closeTab",
     description: "[META] \u771F\u6B63\u5173\u95ED\u4E00\u4E2A tab\u3002**\u53EA\u80FD\u5173 attachedTabs \u91CC\u7684 tab**\uFF08\u9632\u6B62\u8BEF\u5173\u7528\u6237\u5176\u5B83\u7A97\u53E3\uFF09\u3002",
+    mcp: { description: "Close the session's tab." },
     input_schema: {
       type: "object",
       properties: { tabId: { type: "integer" } },
@@ -1379,6 +1425,9 @@ var TOOL_DEFS = [
   {
     name: "switchToTab",
     description: "[META] \u628A Chrome \u524D\u53F0\u5207\u5230\u76EE\u6807 tab\u3002tabId \u5FC5\u987B\u5DF2\u5728 attachedTabs \u6216\u5F53\u524D tab\u3002",
+    mcp: {
+      description: "Bring the session's tab and Chrome window to the foreground. Use only when the user explicitly asks to see that tab; all other browser tools already operate on the session-bound tab without this setup step."
+    },
     input_schema: {
       type: "object",
       properties: { tabId: { type: "integer" } },
@@ -1389,6 +1438,10 @@ var TOOL_DEFS = [
   {
     name: "screenshot",
     description: "[VISION] \u622A\u5F53\u524D tab \u53EF\u89C1\u533A\u57DF\u4E3A PNG\uFF08\u81EA\u52A8\u4F5C\u4E3A image block \u6CE8\u5165\u4E0B\u8F6E\uFF09\u3002\u7528\u4E8E\u89C6\u89C9\u8C03\u8BD5\u3001\u770B\u56FE\u56DE\u7B54\u3001\u6838\u5BF9 page-index \u8BC1\u636E\u3002\n\u5982\u679C\u5DF2\u6709 searchPageIndex/extractPageFields \u8FD4\u56DE\u7684 blockId/indexId\uFF0C\u4F18\u5148\u4F20 {blockId,indexId}\uFF1B\u5DE5\u5177\u4F1A\u6EDA\u52A8\u5E76\u9AD8\u4EAE\u8BE5\u5C40\u90E8\u533A\u57DF\u540E\u622A\u56FE\u3002\u4E5F\u53EF\u4F20 selector\u3002",
+    mcp: {
+      description: "PNG/JPEG returned as an image block. With opt-in CDP enabled, captures viewport/fullPage/selector in the background without activating or scrolling the tab; compatibility mode may temporarily activate the tab.",
+      params: { blockId: "page-index blockId to frame", indexId: "indexId that produced blockId", scale: "0.1\u20131; smaller saves tokens" }
+    },
     input_schema: {
       type: "object",
       properties: {
@@ -1436,6 +1489,7 @@ var TOOL_DEFS = [
   {
     name: "searchBookmarks",
     description: "[META] \u641C\u7D22\u6D4F\u89C8\u5668\u4E66\u7B7E\uFF08chrome.bookmarks.search\uFF09\u3002\u8FD4\u56DE [{id, title, url}]\u3002\n\n\u793A\u4F8B\uFF1A{ query: 'react', limit: 20 }",
+    mcp: { description: "Search browser bookmarks: [{id, title, url}]." },
     input_schema: {
       type: "object",
       properties: {
@@ -1448,6 +1502,7 @@ var TOOL_DEFS = [
   {
     name: "searchHistory",
     description: "[META] \u641C\u7D22\u6D4F\u89C8\u5668\u5386\u53F2\u3002daysBack \u9ED8\u8BA4 7\u3002\u8FD4\u56DE [{url, title, lastVisitTime, visitCount}]\u3002",
+    mcp: { description: "Search browser history (daysBack default 7): [{url, title, lastVisitTime, visitCount}]." },
     input_schema: {
       type: "object",
       properties: {
@@ -1461,6 +1516,7 @@ var TOOL_DEFS = [
   {
     name: "downloadImage",
     description: "[ACT] \u628A\u4E00\u4E2A URL \u4E0B\u8F7D\u5230\u672C\u5730\uFF08Chrome Downloads\uFF09\u3002\u8FD4\u56DE {downloadId, filename}\u3002caution \u7EA7\u3002",
+    mcp: { description: "Download a URL to Chrome Downloads. Returns {downloadId, filename}.", params: { filename: "suggested file name with extension" } },
     input_schema: {
       type: "object",
       properties: {
@@ -1473,6 +1529,10 @@ var TOOL_DEFS = [
   {
     name: "downloadSpreadsheet",
     description: "[ACT] \u751F\u6210\u5E76\u4E0B\u8F7D\u771F\u6B63\u7684 .xlsx Excel \u6587\u4EF6\uFF08Chrome Downloads\uFF09\u3002\u9002\u5408\u628A\u91C7\u96C6/\u62BD\u53D6\u7ED3\u679C\u5BFC\u51FA\u4E3A\u8868\u683C\u3002\u652F\u6301\u591A\u4E2A sheet\uFF1Brows \u53EF\u4EE5\u662F\u4E8C\u7EF4\u6570\u7EC4\uFF0C\u4E5F\u53EF\u4EE5\u662F\u5BF9\u8C61\u6570\u7EC4\u3002\u5BF9\u8C61\u6570\u7EC4\u53EF\u914D columns \u63A7\u5236\u5217\u987A\u5E8F\u548C\u8868\u5934\u3002\u8FD4\u56DE {downloadId, filename, sheets, rows, bytes}\u3002caution \u7EA7\u3002",
+    mcp: {
+      description: "Generate and download a real .xlsx. sheets[].rows may be 2-D arrays or objects; columns orders object keys and sets headers.",
+      params: { filename: "suggested name; .xlsx optional" }
+    },
     input_schema: {
       type: "object",
       properties: {
@@ -1518,6 +1578,7 @@ var TOOL_DEFS = [
   {
     name: "takeSnapshot",
     description: "[FIRST\xB7UID] \u6293\u53D6\u9875\u9762 accessibility snapshot\uFF1A\u8FD4\u56DE [{uid, role, name, tag, text, bounds}]\u3002\nUID \u5728\u672C\u6B21 snapshot \u5185\u7A33\u5B9A\uFF0C\u540E\u7EED clickByUid / fillByUid \u5F15\u7528\uFF1B\u6BD4 selector \u5065\u58EE\uFF0C\u4E0D\u6015 class \u6539\u540D\u3002\n\u6BCF\u6B21\u5927\u52A8\u4F5C\u524D\u5237\u65B0\u4E00\u6B21\u3002snapshot \u9ED8\u8BA4\u53EA\u8FD4\u56DE\u4EA4\u4E92\u5143\u7D20\uFF08button / link / input / textarea / select / [role] / [data-testid]\uFF09\u3002",
+    mcp: { description: "Accessibility snapshot: [{uid, role, name, tag, text, bounds}]. uids feed clickByUid/fillByUid. Refresh before each major action.", params: { includeAll: "true = every element, not just interactive" } },
     input_schema: {
       type: "object",
       properties: {
@@ -1529,6 +1590,7 @@ var TOOL_DEFS = [
   {
     name: "clickByUid",
     description: "[ACT\xB7UID] \u7528 takeSnapshot \u8FD4\u56DE\u7684 uid \u70B9\u51FB\u5143\u7D20\u3002\u6BD4 selector \u7248\u7A33\u5B9A\u3002",
+    mcp: { description: "Click an element by uid from takeSnapshot/findElements. More robust than a selector." },
     input_schema: {
       type: "object",
       properties: {
@@ -1541,6 +1603,7 @@ var TOOL_DEFS = [
   {
     name: "fillByUid",
     description: "[ACT\xB7UID] \u7528 takeSnapshot \u8FD4\u56DE\u7684 uid \u586B\u503C\uFF08input/textarea/contenteditable\uFF09\u3002",
+    mcp: { description: "Set a value on an element by uid from takeSnapshot." },
     input_schema: {
       type: "object",
       properties: {
@@ -1555,6 +1618,7 @@ var TOOL_DEFS = [
   {
     name: "highlightElement",
     description: "[VISUAL] \u7ED9\u9875\u9762\u67D0\u5143\u7D20\u52A0\u7EA2\u8272\u865A\u7EBF\u6846\uFF08\u9ED8\u8BA4 3s \u81EA\u52A8\u6D88\u5931\uFF09\uFF0C\u8BA9\u7528\u6237\u770B\u6E05\u4F60\u8BF4\u7684\u662F\u54EA\u4E2A\u3002\u4EC5\u89C6\u89C9\uFF0C\u4E0D\u6539 DOM\u3002\n\u53EF\u7528 selector \u6216 uid \u4EFB\u4E00\u79CD\u3002",
+    mcp: { description: "Draw a temporary red outline around an element (visual only)." },
     input_schema: {
       type: "object",
       properties: {
@@ -1568,6 +1632,7 @@ var TOOL_DEFS = [
   {
     name: "highlightText",
     description: "[VISUAL] \u5728\u9875\u9762\u6587\u672C\u91CC\u9AD8\u4EAE\u67D0\u6BB5\u6587\u5B57\uFF08\u9EC4\u8272\u80CC\u666F\uFF0C3s \u540E\u8FD8\u539F\uFF09\u3002\u4EC5\u627E\u5230\u7B2C\u4E00\u6B21\u51FA\u73B0\u7684\u4F4D\u7F6E\u3002",
+    mcp: { description: "Temporarily highlight the first occurrence of a text string (visual only)." },
     input_schema: {
       type: "object",
       properties: {
@@ -1581,6 +1646,7 @@ var TOOL_DEFS = [
   {
     name: "fillForm",
     description: "[BATCH\xB7ACT] \u4E00\u6B21\u6027\u586B\u591A\u4E2A\u5B57\u6BB5\u3002\u6BCF\u9879\u5199 selector + value \u6216 uid + value\u3002\u8FD4\u56DE {filled: N, failed: [{at, error}]}\u3002\n\u6BD4\u5FAA\u73AF\u8C03 fillInput \u5FEB\u5F97\u591A\uFF0C\u4E5F\u7701 round-trip\u3002\n\n\u793A\u4F8B\uFF1A\n{ fields: [\n  { selector: 'input[name=name]', value: '\u5F20\u4E09' },\n  { selector: 'input[name=phone]', value: '13800000000' },\n  { uid: 'el_5', value: 'mushroom' }\n] }",
+    mcp: { description: "Fill several fields in one call; each item is {selector|uid, value}. Returns {filled, failed}." },
     input_schema: {
       type: "object",
       properties: {
@@ -1605,6 +1671,7 @@ var TOOL_DEFS = [
   {
     name: "navigate",
     description: "[ACT] \u9875\u9762\u5BFC\u822A\uFF1A\u540E\u9000 / \u524D\u8FDB / \u91CD\u8F7D / \u8DF3\u8F6C\u3002**\u4F18\u5148**\u7528\u672C\u5DE5\u5177\u800C\u4E0D\u662F runJS('location.href = ...')\u3002\n\u793A\u4F8B\uFF1A\n- \u540E\u9000\u4E00\u9875\uFF1A{ action: 'back' }\n- \u8DF3\u5230\u65B0 URL\uFF1A{ action: 'goto', url: 'https://example.com/page' }",
+    mcp: { description: "Navigate: action = back | forward | reload | goto (with url). Prefer this over runJS location changes.", params: { url: "goto only; http/https/file/ftp" } },
     input_schema: {
       type: "object",
       properties: {
@@ -1618,6 +1685,7 @@ var TOOL_DEFS = [
   {
     name: "getPageInfo",
     description: "[FAST\xB7READ] \u8BFB\u5F53\u524D\u9875\u57FA\u672C\u4FE1\u606F\uFF1AURL / title / hostname / \u8BED\u8A00 / OpenGraph meta\u3002\n\u591A\u9875\u5BF9\u8BDD\u4E2D\u300C\u6211\u5728\u54EA\u4E2A\u9875\u9762\u300D\u7684\u9996\u9009\uFF1B\u6BD4 snapshotDOM \u4FBF\u5B9C\u5F97\u591A\u3002",
+    mcp: { description: "URL, title, hostname, language and OpenGraph meta of the current page. Cheapest 'where am I' check." },
     input_schema: {
       type: "object",
       properties: {
@@ -1628,6 +1696,7 @@ var TOOL_DEFS = [
   {
     name: "pressKey",
     description: "[ACT] \u6A21\u62DF\u952E\u76D8\u4E8B\u4EF6\uFF08keydown + \u53EF\u6253\u5370\u5B57\u7B26 keypress + keyup\uFF09\u3002\n\u5E38\u7528\uFF1AEnter \u63D0\u4EA4\u65E0 form \u7684\u641C\u7D22\u6846 / Escape \u5173 modal / Tab \u5207\u7126\u70B9\u3002key \u7528 KeyboardEvent.key \u503C\u3002\n\u672C\u5DE5\u5177**\u4E0D**\u6539 input \u503C\u2014\u2014\u586B\u503C\u4ECD\u8D70 fillInput / fillByUid\u3002\n\u793A\u4F8B\uFF1A\n- \u63D0\u4EA4\u641C\u7D22\uFF1A{ selector: 'input[name=q]', key: 'Enter' }\n- \u5173 modal\uFF1A{ key: 'Escape' }",
+    mcp: { description: "Dispatch a key (keydown/keypress/keyup) to a selector or the active element; e.g. Enter, Escape, Tab. Does not change input values.", params: { key: "KeyboardEvent.key value" } },
     input_schema: {
       type: "object",
       properties: {
@@ -1644,6 +1713,7 @@ var TOOL_DEFS = [
   {
     name: "writeStorage",
     description: "[DANGER] \u5199 localStorage \u6216 sessionStorage\u3002\u6539\u7AD9\u70B9\u72B6\u6001\uFF0C\u9700\u8981\u5BA1\u9605\u3002",
+    mcp: { description: "Write one key to localStorage or sessionStorage (dangerous, reviewed).", params: { value: "string; JSON.stringify non-strings yourself" } },
     input_schema: {
       type: "object",
       properties: {
@@ -1662,6 +1732,7 @@ var TOOL_DEFS = [
   {
     name: "consoleMessages",
     description: "[OBSERVE] \u8BFB\u53D6\u672C\u9875 console \u65E5\u5FD7\u4E0E\u672A\u6355\u83B7\u9519\u8BEF\u3002\u8FD4\u56DE\u91CC\u5E26 backend \u5B57\u6BB5\uFF1Amain-world \u6863\u770B\u4E0D\u5230\u811A\u672C\u6CE8\u5165\u4E4B\u524D\u7684\u6D88\u606F\u548C\u6D4F\u89C8\u5668\u7EA7 CORS/CSP \u62A5\u9519\uFF0Ccdp \u6863\u80FD\u770B\u5230\u3002\n\u793A\u4F8B\uFF1A\u53EA\u770B\u62A5\u9519 { level: 'error', limit: 50 }\uFF1B\u589E\u91CF\u8F6E\u8BE2 { sinceId: \u4E0A\u6B21\u8FD4\u56DE\u7684\u6700\u5927 id }",
+    mcp: { description: "Console output and uncaught errors of the page. Filter by level; sinceId for incremental reads.", params: { sinceId: "only messages with id greater than this" } },
     input_schema: {
       type: "object",
       properties: {
@@ -1675,6 +1746,7 @@ var TOOL_DEFS = [
   {
     name: "networkRequests",
     description: "[OBSERVE] \u5217\u51FA\u672C\u9875\u53D1\u51FA\u7684\u7F51\u7EDC\u8BF7\u6C42\u6458\u8981\uFF08method / url / status / \u8017\u65F6\uFF09\u3002\u9ED8\u8BA4\u9690\u85CF PerformanceObserver \u89C2\u6D4B\u5230\u7684\u9759\u6001\u8D44\u6E90\uFF0CincludeStatic:true \u624D\u5E26\u4E0A\u3002\n\u8981\u770B headers \u6216 body \u7528 networkRequestDetail\u3002",
+    mcp: { description: "Summaries of the page's network requests (method/url/status/duration). Static assets hidden unless includeStatic.", params: { urlPattern: "substring, or /regex/ with optional i flag" } },
     input_schema: {
       type: "object",
       properties: {
@@ -1691,6 +1763,10 @@ var TOOL_DEFS = [
   {
     name: "networkRequestDetail",
     description: "[OBSERVE] \u8BFB\u53D6\u5355\u6761\u8BF7\u6C42\u7684 headers \u4E0E body\u3002**dangerous**\uFF1A\u54CD\u5E94\u5934\u91CC\u53EF\u80FD\u6709 Authorization / Set-Cookie / token\u3002\nmain-world \u6863\u9700\u5148 recorderConfig({bodies:true}) \u624D\u4F1A\u8BB0\u5F55 body\uFF0C\u4E14\u53EA\u8BB0 256KB \u4EE5\u5185\u7684\u6587\u672C\u7C7B\u54CD\u5E94\uFF1Bcdp \u6863\u76F4\u63A5\u53EF\u53D6\u3002",
+    mcp: {
+      description: "Headers and bodies of one request from networkRequests (dangerous: may expose tokens). Bodies need recorderConfig({bodies:true}) unless CDP is on.",
+      params: { id: "id from networkRequests", part: "return only this part" }
+    },
     input_schema: {
       type: "object",
       properties: {
@@ -1708,6 +1784,7 @@ var TOOL_DEFS = [
   {
     name: "handleDialog",
     description: "[OBSERVE] \u8BBE\u5B9A alert / confirm / prompt \u7684\u5E94\u7B54\u7B56\u7565\uFF0C\u5E76\u8FD4\u56DE\u5DF2\u8BB0\u5F55\u7684\u5F39\u7A97\u3002\nmain-world \u6863\u4E0B\u5F39\u7A97\u662F\u540C\u6B65\u7684\uFF0C\u65E0\u6CD5\u6302\u8D77\u7B49\u4F60\u51B3\u5B9A\uFF0C\u6240\u4EE5\u8FD9\u91CC\u8BBE\u7684\u662F**\u9884\u5148\u7B56\u7565**\uFF1A\u8C03\u7528\u4E4B\u540E\u53D1\u751F\u7684\u5F39\u7A97\u6309\u6B64\u5904\u7406\u3002cdp \u6863\u4E0B\u5F39\u7A97\u771F\u6302\u8D77\uFF0C\u672C\u8C03\u7528\u4F1A\u7ACB\u5373\u5E94\u7B54\u5F53\u524D\u6302\u8D77\u7684\u5F39\u7A97\u3002\n\u672A\u8C03\u7528\u8FC7\u672C\u5DE5\u5177\u65F6\u5F39\u7A97\u4FDD\u6301\u539F\u751F\u884C\u4E3A\uFF08passthrough\uFF09\uFF0C\u9875\u9762\u8868\u73B0\u4E0E\u6CA1\u88C5\u6269\u5C55\u4E00\u81F4\u3002",
+    mcp: { description: "Set the accept/dismiss policy for alert/confirm/prompt and return recorded dialogs. Pre-set policy in main-world mode; answers a pending dialog under CDP.", params: { promptText: "text for prompt dialogs" } },
     input_schema: {
       type: "object",
       properties: {
@@ -1722,6 +1799,7 @@ var TOOL_DEFS = [
   {
     name: "recorderConfig",
     description: "[OBSERVE] \u5F00\u5173\u9875\u9762\u4E8B\u4EF6\u5F55\u5236\u3002bodies:true \u6253\u5F00\u8BF7\u6C42/\u54CD\u5E94 body \u6355\u83B7\uFF08\u9ED8\u8BA4\u5173\uFF0C\u6709\u5185\u5B58\u4EE3\u4EF7\uFF09\uFF1Bdialog:true \u8BA9\u5F39\u7A97\u8D70\u7B56\u7565\u800C\u4E0D\u662F\u539F\u751F\u884C\u4E3A\uFF1Bclear \u6E05\u7A7A\u7F13\u51B2\u3002\u7701\u7565\u7684\u5B57\u6BB5\u4FDD\u6301\u539F\u6837\u3002",
+    mcp: { description: "Toggle console/network/dialog recording, arm request/response body capture, clear buffers." },
     input_schema: {
       type: "object",
       properties: {
@@ -1740,16 +1818,19 @@ var TOOL_DEFS = [
   {
     name: "navigateBack",
     description: "[FLOW] \u540E\u9000\u4E00\u9875\u3002\u5DF2\u5728\u5386\u53F2\u8D77\u70B9\u65F6\u8FD4\u56DE { ok:false, reason }\uFF0C\u4E0D\u629B\u9519\u3002",
+    mcp: { description: "Go back one page; returns {ok:false, reason} at history start." },
     input_schema: { type: "object", properties: { tabId: TAB_ID_FIELD } }
   },
   {
     name: "navigateForward",
     description: "[FLOW] \u524D\u8FDB\u4E00\u9875\u3002\u5DF2\u5728\u5386\u53F2\u672B\u5C3E\u65F6\u8FD4\u56DE { ok:false, reason }\uFF0C\u4E0D\u629B\u9519\u3002",
+    mcp: { description: "Go forward one page; returns {ok:false, reason} at history end." },
     input_schema: { type: "object", properties: { tabId: TAB_ID_FIELD } }
   },
   {
     name: "resize",
     description: "[FLOW] \u628A\u89C6\u53E3\u8C03\u6574\u5230\u6307\u5B9A\u5C3A\u5BF8\u3002main-world \u6863\u91CF\u53D6 outerWidth-innerWidth \u53CD\u63A8\u6D4F\u89C8\u5668\u8FB9\u6846\u540E\u6539\u7A97\u53E3\u5916\u6846\uFF0C\u89C6\u53E3\u7CBE\u786E\u4F46**\u7528\u6237\u7684\u7A97\u53E3\u4F1A\u771F\u7684\u53D8\u5927\u5C0F**\uFF1Bcdp \u6863\u7528 Emulation \u8986\u76D6\u8BBE\u5907\u5C3A\u5BF8\uFF0C\u4E0D\u52A8\u771F\u5B9E\u7A97\u53E3\u3002",
+    mcp: { description: "Resize the viewport to width\xD7height." },
     input_schema: {
       type: "object",
       properties: {
@@ -1763,6 +1844,7 @@ var TOOL_DEFS = [
   {
     name: "drag",
     description: "[ACT] \u628A\u4E00\u4E2A\u5143\u7D20\u62D6\u5230\u53E6\u4E00\u4E2A\u5143\u7D20\u4E0A\u3002\u540C\u65F6\u53D1 pointer \u5E8F\u5217\u548C HTML5 DragEvent\uFF08\u5171\u7528\u4E00\u4E2A DataTransfer\uFF09\uFF0C\u517C\u5BB9\u539F\u751F\u62D6\u653E\u548C\u81EA\u5B9A\u4E49 pointer \u62D6\u653E\u3002\n\u8FD4\u56DE { consumed: { pointer, html5 } } \u8BF4\u660E\u76EE\u6807\u5B9E\u9645\u6D88\u8D39\u4E86\u54EA\u4E00\u7C7B\u4E8B\u4EF6\u2014\u2014\u90FD\u4E3A false \u8BF4\u660E\u8FD9\u4E2A\u62D6\u653E\u5B9E\u73B0\u4E24\u6761\u8DEF\u90FD\u4E0D\u5403\u3002",
+    mcp: { description: "Drag one element onto another by selector or uid. Emits pointer and HTML5 drag events; returns which the target consumed." },
     input_schema: {
       type: "object",
       properties: {
@@ -1777,6 +1859,7 @@ var TOOL_DEFS = [
   {
     name: "drop",
     description: "[ACT] \u6A21\u62DF\u4ECE\u6D4F\u89C8\u5668\u5916\u90E8\u628A\u6587\u4EF6\u6216\u6570\u636E\u62D6\u653E\u5230\u9875\u9762\u5143\u7D20\u4E0A\u3002\u5E26 files \u65F6\u7B49\u540C\u4E0A\u4F20\uFF08dangerous\uFF09\u3002\n\u793A\u4F8B\uFF1A{ selector:'#dropzone', files:[{ name:'a.csv', mimeType:'text/csv', base64:'...' }] }",
+    mcp: { description: "Simulate dropping external files/data onto an element. files present = upload (dangerous, reviewed).", params: { data: "MIME \u2192 string map" } },
     input_schema: {
       type: "object",
       properties: {
@@ -1802,6 +1885,7 @@ var TOOL_DEFS = [
   {
     name: "findElements",
     description: "[READ] \u6309\u6587\u672C\u6216\u6B63\u5219\u5728\u53EF\u4EA4\u4E92\u5143\u7D20\u91CC\u627E\u76EE\u6807\uFF0C\u8FD4\u56DE uid / role / name / bounds\u3002\u4E0D\u9700\u8981\u5148 createPageIndex\u3002\n\u62FF\u5230 uid \u540E\u7528 clickByUid / fillByUid \u64CD\u4F5C\u6700\u7A33\u3002",
+    mcp: { description: "Find interactive elements by text or regex; returns uid/role/name/bounds without needing a page index.", params: { text: "case-insensitive substring", regex: "regex; alternative to text" } },
     input_schema: {
       type: "object",
       properties: {
@@ -1816,14 +1900,21 @@ var TOOL_DEFS = [
 
 // src/tool-gen.ts
 var BLOCKED_TOOLS = /* @__PURE__ */ new Set(["askUser", "attachTab", "detachTab"]);
-var PARITY_TOOLS = [
-  // page state and search
+var CORE_TOOLS = [
+  // page state
   "takeSnapshot",
   "findElements",
   "getPageInfo",
+  "extractText",
+  // page index
+  "createPageIndex",
+  "searchPageIndex",
+  "readPageBlock",
+  "extractPageFields",
   // interaction
   "clickByUid",
   "click",
+  "fillByUid",
   "fillInput",
   "fillForm",
   "selectOption",
@@ -1835,10 +1926,11 @@ var PARITY_TOOLS = [
   "uploadFile",
   // navigation and tabs
   "navigate",
-  "navigateBack",
   "listTabs",
   "openTab",
+  "closeTab",
   "resize",
+  "scroll",
   // observation
   "screenshot",
   "waitFor",
@@ -1848,40 +1940,199 @@ var PARITY_TOOLS = [
 ];
 var IMAGE_RESULT_TOOLS = /* @__PURE__ */ new Set(["screenshot"]);
 var JS_STEP_TOOLS = /* @__PURE__ */ new Set(["runJS"]);
-function rebuildSchema(src) {
+var SESSION_ID_FIELD = {
+  type: "string",
+  description: "Session id from open_session"
+};
+function stripDescriptions(value) {
+  if (Array.isArray(value)) {
+    return value.map(stripDescriptions);
+  }
+  if (value !== null && typeof value === "object") {
+    const out = {};
+    for (const [key, v] of Object.entries(value)) {
+      if (key === "description") continue;
+      out[key] = stripDescriptions(v);
+    }
+    return out;
+  }
+  return value;
+}
+function rebuildSchema(src, params) {
   const s = src;
-  const properties = { ...s.properties ?? {} };
-  delete properties.tabId;
-  properties.session_id = {
-    type: "string",
-    description: "open_session \u8FD4\u56DE\u7684\u4F1A\u8BDD id\uFF08\u51B3\u5B9A\u76EE\u6807 worker \u4E0E tab\uFF09"
-  };
+  const properties = {};
+  for (const [key, prop] of Object.entries(s.properties ?? {})) {
+    if (key === "tabId") continue;
+    const stripped = stripDescriptions(prop);
+    properties[key] = params[key] ? { ...stripped, description: params[key] } : stripped;
+  }
+  properties.session_id = SESSION_ID_FIELD;
   const required = [.../* @__PURE__ */ new Set([...(s.required ?? []).filter((r) => r !== "tabId"), "session_id"])];
   return { type: "object", properties, required };
 }
-function generateBrowserTools(mode = "full") {
-  const parity = new Set(PARITY_TOOLS);
-  return TOOL_DEFS.filter((t) => {
-    if (BLOCKED_TOOLS.has(t.name)) return false;
-    return mode === "full" || parity.has(t.name);
-  }).map((t) => ({
+function fromDef(t) {
+  return {
     name: `browser_${t.name}`,
     builtinTool: t.name,
-    description: t.description,
+    builtinTools: [t.name],
+    description: t.mcp?.description ?? t.description,
     resultKind: IMAGE_RESULT_TOOLS.has(t.name) ? "image" : "json",
     stepKind: JS_STEP_TOOLS.has(t.name) ? "js" : "tool",
-    inputSchema: rebuildSchema(t.input_schema)
-  }));
+    inputSchema: rebuildSchema(t.input_schema, t.mcp?.params ?? {})
+  };
+}
+var MERGED_AWAY_TOOLS = /* @__PURE__ */ new Set([
+  "navigateBack",
+  "navigateForward",
+  "highlightElement",
+  "highlightText",
+  "readStorage",
+  "writeStorage"
+]);
+function schemaWithSession(properties, required) {
+  return { type: "object", properties: { ...properties, session_id: SESSION_ID_FIELD }, required: [...required, "session_id"] };
+}
+var STORE_ENUM = { type: "string", enum: ["local", "session"] };
+var MERGED_TOOLS = [
+  {
+    name: "browser_highlight",
+    builtinTool: "highlightElement",
+    builtinTools: ["highlightElement", "highlightText"],
+    description: "Temporarily outline an element (selector or uid) or highlight the first occurrence of text. Visual only; exactly one of text/selector/uid.",
+    resultKind: "json",
+    stepKind: "tool",
+    inputSchema: schemaWithSession(
+      {
+        text: { type: "string" },
+        selector: { type: "string" },
+        uid: { type: "string" },
+        ms: { type: "integer", default: 3e3 }
+      },
+      []
+    ),
+    resolve(args) {
+      const given = ["text", "selector", "uid"].filter((k) => args[k] != null && args[k] !== "");
+      if (given.length !== 1) {
+        throw new Error("InvalidArgs: browser_highlight needs exactly one of text / selector / uid");
+      }
+      const { text, selector, uid, ms } = args;
+      const withMs = (o) => ms == null ? o : { ...o, ms };
+      if (given[0] === "text") return { builtinTool: "highlightText", args: withMs({ text }) };
+      return { builtinTool: "highlightElement", args: withMs(selector != null ? { selector } : { uid }) };
+    }
+  },
+  {
+    name: "browser_storage",
+    builtinTool: "readStorage",
+    builtinTools: ["readStorage", "writeStorage"],
+    description: "Read (op=get) or write (op=set, needs value) one key in localStorage or sessionStorage. Dangerous, reviewed.",
+    resultKind: "json",
+    stepKind: "tool",
+    inputSchema: schemaWithSession(
+      {
+        op: { type: "string", enum: ["get", "set"] },
+        store: STORE_ENUM,
+        key: { type: "string" },
+        value: { type: "string", description: "set only; JSON.stringify non-strings yourself" }
+      },
+      ["op", "store", "key"]
+    ),
+    resolve(args) {
+      const { op, store, key, value } = args;
+      if (op === "get") return { builtinTool: "readStorage", args: { store, key } };
+      if (op === "set") {
+        if (typeof value !== "string") throw new Error("InvalidArgs: browser_storage op=set requires a string value");
+        return { builtinTool: "writeStorage", args: { store, key, value } };
+      }
+      throw new Error(`InvalidArgs: browser_storage op must be "get" or "set", got ${JSON.stringify(op)}`);
+    }
+  }
+];
+function generateBrowserTools(mode = "core") {
+  const core = new Set(CORE_TOOLS);
+  const plain = TOOL_DEFS.filter((t) => {
+    if (BLOCKED_TOOLS.has(t.name) || MERGED_AWAY_TOOLS.has(t.name)) return false;
+    return mode === "full" || core.has(t.name);
+  }).map(fromDef);
+  return mode === "full" ? [...plain, ...MERGED_TOOLS] : plain;
 }
 function readToolMode(env) {
   const raw = env.ATWEBPILOT_MCP_TOOLS;
-  if (raw == null || raw === "") return "full";
-  if (raw === "full" || raw === "parity") return raw;
+  if (raw == null || raw === "") return "core";
+  if (raw === "core" || raw === "full") return raw;
   process.stderr.write(
-    `[atwebpilot-mcp] ATWEBPILOT_MCP_TOOLS="${raw}" is not recognised; using "full"
+    `[atwebpilot-mcp] ATWEBPILOT_MCP_TOOLS="${raw}" is not recognised; using "core"
 `
   );
-  return "full";
+  return "core";
+}
+var DISCOVERABLE_GROUPS = {
+  export: ["browser_downloadImage", "browser_downloadSpreadsheet"],
+  network: ["browser_httpRequest", "browser_networkRequestDetail", "browser_recorderConfig", "browser_handleDialog"],
+  storage: ["browser_storage"],
+  "browser-data": ["browser_searchBookmarks", "browser_searchHistory"],
+  inspect: ["browser_inspectElement", "browser_highlight", "browser_getValue", "browser_extractFormState"],
+  "legacy-dom": ["browser_snapshotDOM", "browser_querySelector", "browser_querySelectorAll", "browser_extractImages", "browser_focus"],
+  form: ["browser_submitForm"],
+  tabs: ["browser_switchToTab"]
+};
+var GROUP_BY_NAME = new Map(
+  Object.entries(DISCOVERABLE_GROUPS).flatMap(([g, names]) => names.map((n) => [n, g]))
+);
+function groupOf(mcpName) {
+  return GROUP_BY_NAME.get(mcpName);
+}
+function discoveryCatalog(all, advertised) {
+  return all.filter((t) => !advertised.has(t.name)).map((t) => ({ name: t.name, group: groupOf(t.name) ?? "legacy-dom", description: t.description })).sort((a, b) => a.group < b.group ? -1 : a.group > b.group ? 1 : a.name < b.name ? -1 : a.name > b.name ? 1 : 0);
+}
+
+// src/discover-tool.ts
+var DISCOVER_TOOL = {
+  name: "browser_discoverTools",
+  description: "The default tool list is the core set. Call with no arguments to see the catalog of additional browser tools (export, network, storage, browser-data, inspect, legacy-dom, form). Call with enable=[names] to add them to tools/list for this server; the response includes their full schemas so you can call them immediately. Use this instead of rebuilding missing capabilities with runJS.",
+  inputSchema: {
+    type: "object",
+    properties: {
+      enable: { type: "array", items: { type: "string" }, description: "Tool names from the catalog to advertise" }
+    },
+    additionalProperties: false
+  }
+};
+function isRunnable(t, supported) {
+  return !supported || t.builtinTools.every((b) => supported.has(b));
+}
+function handleDiscover(input) {
+  const { all, advertised, args, supported } = input;
+  const byName = new Map(all.map((t) => [t.name, t]));
+  const requested = Array.isArray(args.enable) ? args.enable.map(String) : null;
+  if (!requested) {
+    const runnable = all.filter((t) => isRunnable(t, supported));
+    return { catalog: discoveryCatalog(runnable, advertised), changed: false };
+  }
+  const enabled = [];
+  const unknown = [];
+  const unsupported = [];
+  for (const raw of requested) {
+    const name = raw.startsWith("browser_") ? raw : `browser_${raw}`;
+    const t = byName.get(name);
+    if (!t) {
+      unknown.push(raw);
+      continue;
+    }
+    if (!isRunnable(t, supported)) {
+      unsupported.push(raw);
+      continue;
+    }
+    if (advertised.has(name)) continue;
+    advertised.add(name);
+    enabled.push({ name: t.name, description: t.description, inputSchema: t.inputSchema });
+  }
+  return {
+    enabled,
+    ...unknown.length ? { unknown } : {},
+    ...unsupported.length ? { unsupported } : {},
+    changed: enabled.length > 0
+  };
 }
 
 // ../shared/src/static-scan.ts
@@ -2031,8 +2282,9 @@ async function handleBrowserTool(deps, gen, args) {
   const session = coordinator.sessions.get(session_id);
   if (!session) throw new Error(`session ${session_id} not found`);
   const { session_id: _omit, ...suppliedToolArgs } = args;
-  const toolArgs = { ...suppliedToolArgs };
-  const tool = gen.builtinTool;
+  const resolved = gen.resolve ? gen.resolve(suppliedToolArgs) : { builtinTool: gen.builtinTool, args: suppliedToolArgs };
+  const toolArgs = { ...resolved.args };
+  const tool = resolved.builtinTool;
   if (gen.stepKind === "js") {
     const source = String(toolArgs.source ?? "");
     if (!source) throw new Error("browser_runJS: source required");
@@ -2057,14 +2309,14 @@ async function handleBrowserTool(deps, gen, args) {
     }
     return jsResult.return ?? null;
   }
-  if (gen.builtinTool === "switchToTab" || gen.builtinTool === "closeTab") {
+  if (tool === "switchToTab" || tool === "closeTab") {
     const boundTabId = Number.parseInt(session.tab_id, 10);
     if (!Number.isFinite(boundTabId)) {
       throw new Error(`InvalidArgs: session tab_id "${session.tab_id}" is not numeric`);
     }
     toolArgs.tabId = boundTabId;
   }
-  const override = NON_BUILTIN_CAPABILITY[gen.builtinTool];
+  const override = NON_BUILTIN_CAPABILITY[tool];
   if (override) {
     const v = coordinator.validateCall({ session_id, kind: "capability", capability: override });
     if (!v.ok) throw new Error(`${v.error.code}: ${v.error.message}`);
@@ -2129,9 +2381,12 @@ var SKILL_TOOL = {
 };
 
 // src/mcp-server.ts
-var TOOL_MODE = readToolMode(process.env);
-var BROWSER_TOOLS = generateBrowserTools(TOOL_MODE);
-var BROWSER_BY_NAME = new Map(BROWSER_TOOLS.map((t) => [t.name, t]));
+var ALL_BROWSER_TOOLS = generateBrowserTools("full");
+var BROWSER_BY_NAME = new Map(ALL_BROWSER_TOOLS.map((t) => [t.name, t]));
+function createToolState(mode) {
+  return { advertised: new Set(generateBrowserTools(mode).map((t) => t.name)) };
+}
+var DEFAULT_STATE = createToolState(readToolMode(process.env));
 var LEGACY_TOOLS = [
   "snapshotDOM",
   "querySelector",
@@ -2161,12 +2416,13 @@ function workerToolSupport(deps) {
   const supported = workers[0].supported_tools;
   return supported ?? new Set(LEGACY_TOOLS);
 }
-function buildToolList(deps) {
+function buildToolList(deps, state = DEFAULT_STATE) {
   const supported = workerToolSupport(deps);
-  const browser = supported ? BROWSER_TOOLS.filter((t) => supported.has(t.builtinTool)) : BROWSER_TOOLS;
+  const browser = ALL_BROWSER_TOOLS.filter((t) => state.advertised.has(t.name)).filter((t) => !supported || t.builtinTools.every((b) => supported.has(b)));
   return [
     { name: SKILL_TOOL.name, description: SKILL_TOOL.description, inputSchema: SKILL_TOOL.inputSchema },
     ...CONTROL_TOOLS.map((t) => ({ name: t.name, description: t.description, inputSchema: t.inputSchema })),
+    { name: DISCOVER_TOOL.name, description: DISCOVER_TOOL.description, inputSchema: DISCOVER_TOOL.inputSchema },
     ...browser.map((t) => ({ name: t.name, description: t.description, inputSchema: t.inputSchema }))
   ];
 }
@@ -2181,12 +2437,23 @@ function toolResult(gen, data) {
   return { content: [{ type: "image", data: d.data, mimeType }] };
 }
 var fail2 = (message) => ({ content: [{ type: "text", text: message }], isError: true });
-async function dispatchCall(deps, name, args, onPairingRequired) {
+async function dispatchCall(deps, name, args, onPairingRequired, state = DEFAULT_STATE, onListChanged) {
   try {
     if (name === SKILL_TOOL.name) {
       const bundle = readSkillBundle();
       return { content: [{ type: "text", text: bundle.content }] };
     }
+    if (name === DISCOVER_TOOL.name) {
+      const r = handleDiscover({
+        all: ALL_BROWSER_TOOLS,
+        advertised: state.advertised,
+        args,
+        supported: workerToolSupport(deps)
+      });
+      if (r.changed && onListChanged) await onListChanged();
+      const { changed: _c, ...body } = r;
+      return ok(body);
+    }
     if (name === "list_tabs") return ok(await handleListTabs(deps, onPairingRequired));
     if (name === "open_session") return ok(await handleOpenSession(deps, args, onPairingRequired));
     if (name === "close_session") return ok(await handleCloseSession(deps, args));
@@ -2198,12 +2465,12 @@ async function dispatchCall(deps, name, args, onPairingRequired) {
     return fail2(e instanceof Error ? e.message : String(e));
   }
 }
-function createMcpServer(deps) {
+function createMcpServer(deps, state = DEFAULT_STATE) {
   const server = new Server(
     { name: "atwebpilot-mcp", version: "0.1.0" },
-    { capabilities: { tools: {}, logging: {} } }
+    { capabilities: { tools: { listChanged: true }, logging: {} } }
   );
-  server.setRequestHandler(ListToolsRequestSchema, async () => ({ tools: buildToolList(deps) }));
+  server.setRequestHandler(ListToolsRequestSchema, async () => ({ tools: buildToolList(deps, state) }));
   server.setRequestHandler(CallToolRequestSchema, async (req, extra) => {
     const args = req.params.arguments ?? {};
     const onPairingRequired = async (url) => {
@@ -2225,7 +2492,14 @@ function createMcpServer(deps) {
         );
       }
     };
-    return dispatchCall(deps, req.params.name, args, onPairingRequired);
+    const onListChanged = async () => {
+      try {
+        await server.sendToolListChanged();
+      } catch (error) {
+        console.error("[atwebpilot-mcp] failed to send tools/list_changed:", error instanceof Error ? error.message : String(error));
+      }
+    };
+    return dispatchCall(deps, req.params.name, args, onPairingRequired, state, onListChanged);
   });
   return server;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@attson/atwebpilot-mcp",
-  "version": "0.0.70",
+  "version": "0.0.72",
   "license": "Apache-2.0",
   "description": "MCP server for the atwebpilot browser extension - let Codex or Claude Code drive your browser.",
   "homepage": "https://github.com/attson/atwebpilot#readme",