vite-plugin-aipanel 1.2.8 → 1.2.10

package/es/core/mcp-tools.mjs

@@ -1,671 +1,121 @@
+import { OFFICIAL_TOOL_META } from "./official-meta.mjs";
+const MCP_PREFIX = "chrome-devtools_";
+function displayToolName(short) {
+  return MCP_PREFIX + short;
+}
+const OFFICIAL_GLOBAL_POLICY = [
+  "evaluate_script",
+  "list_console_messages",
+  "list_pages",
+  "new_page"
+];
+const OFFICIAL_NO_PAGE_TOOLS = /* @__PURE__ */ new Set(["list_pages", "new_page"]);
 const PAGE_ID_PROP = {
-  pageId: { type: "number", description: "\u76EE\u6807\u9875\u9762 ID" }
+  pageId: {
+    type: "number",
+    description: "The ID of a page within the operation scope (project pages or chromeMcp.project.allowOrigins pages) to operate on"
+  }
 };
-function withPageId(properties, required = []) {
+function withPageIdSchema(schema) {
   return {
-    properties: { ...PAGE_ID_PROP, ...properties },
-    required: ["pageId", ...required]
+    type: "object",
+    properties: { ...PAGE_ID_PROP, ...schema.properties },
+    required: ["pageId", ...schema.required ?? []]
   };
 }
+const PROJECT_DESCRIPTION_NOTES = {
+  list_pages: "Lists pages within the operation scope (project pages + chromeMcp.project.allowOrigins).",
+  new_page: "Only URLs within the operation scope (project or allowOrigins) can be opened. Opening a project page is de-duplicated (returns the already-open page); allowOrigins pages are opened without a count limit.",
+  navigate_page: "Navigation target (type=url) must stay within the operation scope (project or allowOrigins)."
+};
 const CUSTOM_TOOLS = [
-  // ===== 页面管理 =====
-  {
-    name: "chrome-devtools_list_pages",
-    description: "\u83B7\u53D6\u5F53\u524D\u9879\u76EE\u6240\u6709\u6253\u5F00\u7684\u9875\u9762\u5217\u8868\uFF0C\u542B active\uFF08\u7528\u6237\u6B63\u5728\u6D4F\u89C8\uFF09\u548C selected\uFF08Chrome DevTools \u5F53\u524D\u64CD\u4F5C\u76EE\u6807\uFF09\u6807\u8BB0",
-    inputSchema: {
-      type: "object",
-      properties: {}
-    }
-  },
-  {
-    name: "chrome-devtools_current_page",
-    description: "\u83B7\u53D6\u7528\u6237\u5F53\u524D\u6B63\u5728\u6D4F\u89C8\u5668\u6D4F\u89C8\u7684\u9875\u9762\u4E0A\u4E0B\u6587\u4FE1\u606F\uFF0C\u5305\u542B\u9875\u9762 URL\u3001\u6807\u9898\u3001\u9875\u9762 ID",
-    inputSchema: {
-      type: "object",
-      properties: {}
-    }
-  },
-  {
-    name: "chrome-devtools_new_page",
-    description: "\u6253\u5F00\u4E00\u4E2A\u65B0\u6807\u7B7E\u9875\u5E76\u52A0\u8F7D URL\uFF08\u4EC5\u5141\u8BB8\u6253\u5F00\u5F53\u524D\u9879\u76EE\u7684\u9875\u9762\uFF09\u3002\u82E5\u5F53\u524D\u9879\u76EE\u5DF2\u6709\u6253\u5F00\u7684\u9875\u9762\uFF0C\u5219\u4E0D\u4F1A\u91CD\u590D\u6253\u5F00\uFF0C\u800C\u662F\u8FD4\u56DE\u5DF2\u6709\u9875\u9762\u4FE1\u606F",
-    inputSchema: {
-      type: "object",
-      properties: {
-        url: {
-          type: "string",
-          description: "\u8981\u6253\u5F00\u7684\u9875\u9762 URL\uFF08\u5FC5\u987B\u662F\u5F53\u524D\u9879\u76EE\u7684\u9875\u9762\uFF09"
-        },
-        timeout: {
-          type: "integer",
-          description: "\u6700\u5927\u7B49\u5F85\u65F6\u95F4\uFF08\u6BEB\u79D2\uFF09\uFF0C0 \u4F7F\u7528\u9ED8\u8BA4\u8D85\u65F6"
-        }
-      },
-      required: ["url"]
-    }
-  },
-  // ===== 截图与快照 =====
-  {
-    name: "chrome-devtools_take_snapshot",
-    description: "\u83B7\u53D6\u6307\u5B9A\u9875\u9762\u53EF\u8BBF\u95EE\u6027\u6811\u5FEB\u7167\uFF0C\u8FD4\u56DE\u5143\u7D20 uid\u3001\u89D2\u8272\u3001\u6587\u672C\u7B49",
-    inputSchema: {
-      type: "object",
-      ...withPageId({
-        verbose: { type: "boolean", description: "\u662F\u5426\u83B7\u53D6\u5B8C\u6574 a11y \u6811\u4FE1\u606F\uFF0C\u9ED8\u8BA4 false" },
-        filePath: { type: "string", description: "\u4FDD\u5B58\u5FEB\u7167\u7684\u6587\u4EF6\u8DEF\u5F84\uFF0C\u7701\u7565\u5219\u5185\u8054\u8FD4\u56DE" }
-      })
-    }
-  },
-  {
-    name: "chrome-devtools_take_screenshot",
-    description: "\u622A\u53D6\u6307\u5B9A\u9875\u9762\u6216\u5143\u7D20\u5C4F\u5E55\u622A\u56FE\uFF0C\u8FD4\u56DE base64 \u6216\u4FDD\u5B58\u5230\u6587\u4EF6",
-    inputSchema: {
-      type: "object",
-      ...withPageId({
-        format: {
-          type: "string",
-          enum: ["png", "jpeg", "webp"],
-          description: "\u56FE\u7247\u683C\u5F0F\uFF0C\u9ED8\u8BA4 png"
-        },
-        quality: {
-          type: "number",
-          minimum: 0,
-          maximum: 100,
-          description: "JPEG/WebP \u538B\u7F29\u8D28\u91CF 0-100"
-        },
-        uid: {
-          type: "string",
-          description: "\u5143\u7D20 uid\uFF08\u4ECE chrome-devtools_take_snapshot \u83B7\u53D6\uFF09\uFF0C\u7701\u7565\u622A\u53D6\u6574\u9875"
-        },
-        fullPage: { type: "boolean", description: "\u662F\u5426\u622A\u53D6\u5B8C\u6574\u9875\u9762\uFF08\u4E0E uid \u4E92\u65A5\uFF09" },
-        filePath: { type: "string", description: "\u4FDD\u5B58\u622A\u56FE\u7684\u6587\u4EF6\u8DEF\u5F84\uFF0C\u7701\u7565\u8FD4\u56DE base64" }
-      })
-    }
-  },
-  // ===== 交互操作 =====
-  {
-    name: "chrome-devtools_click",
-    description: "\u70B9\u51FB\u9875\u9762\u5143\u7D20",
-    inputSchema: {
-      type: "object",
-      ...withPageId(
-        {
-          uid: { type: "string", description: "\u5143\u7D20 uid\uFF08\u4ECE chrome-devtools_take_snapshot \u83B7\u53D6\uFF09" },
-          dblClick: { type: "boolean", description: "\u662F\u5426\u53CC\u51FB\uFF0C\u9ED8\u8BA4 false" },
-          includeSnapshot: { type: "boolean", description: "\u662F\u5426\u5728\u54CD\u5E94\u4E2D\u5305\u542B\u5FEB\u7167\uFF0C\u9ED8\u8BA4 false" }
-        },
-        ["uid"]
-      )
-    }
-  },
-  {
-    name: "chrome-devtools_hover",
-    description: "\u9F20\u6807\u60AC\u505C\u5728\u9875\u9762\u5143\u7D20\u4E0A",
-    inputSchema: {
-      type: "object",
-      ...withPageId(
-        {
-          uid: { type: "string", description: "\u5143\u7D20 uid" },
-          includeSnapshot: { type: "boolean", description: "\u662F\u5426\u5728\u54CD\u5E94\u4E2D\u5305\u542B\u5FEB\u7167\uFF0C\u9ED8\u8BA4 false" }
-        },
-        ["uid"]
-      )
-    }
-  },
-  {
-    name: "chrome-devtools_drag",
-    description: "\u62D6\u62FD\u9875\u9762\u5143\u7D20\u5230\u53E6\u4E00\u4E2A\u5143\u7D20\u4E0A",
-    inputSchema: {
-      type: "object",
-      ...withPageId(
-        {
-          from_uid: { type: "string", description: "\u88AB\u62D6\u62FD\u5143\u7D20\u7684 uid" },
-          to_uid: { type: "string", description: "\u76EE\u6807\u653E\u7F6E\u5143\u7D20\u7684 uid" },
-          includeSnapshot: { type: "boolean", description: "\u662F\u5426\u5728\u54CD\u5E94\u4E2D\u5305\u542B\u5FEB\u7167\uFF0C\u9ED8\u8BA4 false" }
-        },
-        ["from_uid", "to_uid"]
-      )
-    }
-  },
-  {
-    name: "chrome-devtools_type_text",
-    description: "\u5728\u5DF2\u805A\u7126\u7684\u8F93\u5165\u6846\u4E2D\u4F7F\u7528\u952E\u76D8\u8F93\u5165\u6587\u672C",
-    inputSchema: {
-      type: "object",
-      ...withPageId(
-        {
-          text: { type: "string", description: "\u8981\u8F93\u5165\u7684\u6587\u672C" },
-          submitKey: {
-            type: "string",
-            description: '\u8F93\u5165\u540E\u6309\u4E0B\u7684\u6309\u952E\uFF0C\u5982 "Enter"\u3001"Tab"\u3001"Escape"'
-          }
-        },
-        ["text"]
-      )
-    }
-  },
-  {
-    name: "chrome-devtools_press_key",
-    description: "\u6309\u4E0B\u952E\u76D8\u6309\u952E\u6216\u7EC4\u5408\u952E\uFF08\u5FEB\u6377\u952E\u3001\u5BFC\u822A\u952E\u7B49\uFF09",
-    inputSchema: {
-      type: "object",
-      ...withPageId(
-        {
-          key: {
-            type: "string",
-            description: '\u6309\u952E\u6216\u7EC4\u5408\u952E\uFF0C\u5982 "Enter"\u3001"Control+A"\u3002\u4FEE\u9970\u952E: Control, Shift, Alt, Meta'
-          },
-          includeSnapshot: { type: "boolean", description: "\u662F\u5426\u5728\u54CD\u5E94\u4E2D\u5305\u542B\u5FEB\u7167\uFF0C\u9ED8\u8BA4 false" }
-        },
-        ["key"]
-      )
-    }
-  },
-  {
-    name: "chrome-devtools_fill",
-    description: "\u586B\u5199\u8F93\u5165\u6846\u503C\u6216\u9009\u62E9 select \u9009\u9879\uFF0C\u89E6\u53D1 input/change \u4E8B\u4EF6",
-    inputSchema: {
-      type: "object",
-      ...withPageId(
-        {
-          uid: { type: "string", description: "\u8F93\u5165\u6846/select \u5143\u7D20 uid" },
-          value: {
-            type: "string",
-            description: '\u8981\u586B\u5165\u7684\u503C\u3002checkbox/toggle \u7528 "true"/"false"\uFF0Cradio \u7528 "true"'
-          },
-          includeSnapshot: { type: "boolean", description: "\u662F\u5426\u5728\u54CD\u5E94\u4E2D\u5305\u542B\u5FEB\u7167\uFF0C\u9ED8\u8BA4 false" }
-        },
-        ["uid", "value"]
-      )
-    }
-  },
-  {
-    name: "chrome-devtools_fill_form",
-    description: "\u6279\u91CF\u586B\u5199\u8868\u5355\u5B57\u6BB5\uFF0C\u6BD4\u591A\u6B21\u8C03\u7528 fill/click \u66F4\u5FEB\u66F4\u53EF\u9760",
-    inputSchema: {
-      type: "object",
-      ...withPageId(
-        {
-          elements: {
-            type: "array",
-            items: {
-              type: "object",
-              properties: { uid: { type: "string" }, value: { type: "string" } }
-            },
-            description: "\u8868\u5355\u5143\u7D20\u6570\u7EC4 [{ uid, value }]"
-          },
-          includeSnapshot: { type: "boolean", description: "\u662F\u5426\u5728\u54CD\u5E94\u4E2D\u5305\u542B\u5FEB\u7167\uFF0C\u9ED8\u8BA4 false" }
-        },
-        ["elements"]
-      )
-    }
-  },
-  // ===== 页面导航 =====
-  {
-    name: "chrome-devtools_navigate_page",
-    description: "\u5BFC\u822A\u9875\u9762\uFF08url/reload/back/forward\uFF09",
-    inputSchema: {
-      type: "object",
-      ...withPageId(
-        {
-          type: {
-            type: "string",
-            enum: ["url", "back", "forward", "reload"],
-            description: "\u5BFC\u822A\u7C7B\u578B"
-          },
-          url: { type: "string", description: "\u76EE\u6807 URL\uFF08type=url \u65F6\u5FC5\u586B\uFF09" },
-          ignoreCache: { type: "boolean", description: "reload \u65F6\u662F\u5426\u5FFD\u7565\u7F13\u5B58" },
-          handleBeforeUnload: {
-            type: "string",
-            enum: ["accept", "dismiss"],
-            description: "beforeunload \u5BF9\u8BDD\u6846\u5904\u7406\u65B9\u5F0F"
-          },
-          initScript: {
-            type: "string",
-            description: "\u4E0B\u4E00\u6B21\u5BFC\u822A\u65F6\uFF0C\u5728\u6BCF\u4E2A\u65B0 document \u52A0\u8F7D\u524D\u6267\u884C\u7684 JS \u811A\u672C"
-          },
-          timeout: { type: "integer", description: "\u6700\u5927\u7B49\u5F85\u65F6\u95F4\uFF08\u6BEB\u79D2\uFF09\uFF0C0 \u4F7F\u7528\u9ED8\u8BA4\u8D85\u65F6" }
-        },
-        ["type"]
-      )
-    }
-  },
-  {
-    name: "chrome-devtools_resize_page",
-    description: "\u8C03\u6574\u9875\u9762\u89C6\u53E3\u5927\u5C0F",
-    inputSchema: {
-      type: "object",
-      ...withPageId(
-        {
-          width: { type: "number", description: "\u89C6\u53E3\u5BBD\u5EA6" },
-          height: { type: "number", description: "\u89C6\u53E3\u9AD8\u5EA6" }
-        },
-        ["width", "height"]
-      )
-    }
-  },
-  {
-    name: "chrome-devtools_emulate",
-    description: "\u6A21\u62DF\u8BBE\u5907\u7279\u6027\uFF08\u7F51\u7EDC\u8282\u6D41\u3001CPU \u964D\u901F\u3001\u5730\u7406\u4F4D\u7F6E\u3001UA\u3001\u989C\u8272\u65B9\u6848\u3001\u89C6\u53E3\u7B49\uFF09",
-    inputSchema: {
-      type: "object",
-      ...withPageId({
-        networkConditions: {
-          type: "string",
-          enum: ["Offline", "Slow 3G", "Fast 3G", "Slow 4G", "Fast 4G"],
-          description: "\u7F51\u7EDC\u8282\u6D41\u6A21\u5F0F"
-        },
-        cpuThrottlingRate: {
-          type: "number",
-          minimum: 1,
-          maximum: 20,
-          description: "CPU \u964D\u901F\u500D\u6570\uFF0C1 \u4E0D\u964D\u901F"
-        },
-        geolocation: { type: "string", description: "\u5730\u7406\u4F4D\u7F6E\uFF0C\u683C\u5F0F `<\u7EAC\u5EA6>,<\u7ECF\u5EA6>`" },
-        userAgent: { type: "string", description: "UA \u5B57\u7B26\u4E32\uFF0C\u7A7A\u5B57\u7B26\u4E32\u6E05\u9664" },
-        colorScheme: {
-          type: "string",
-          enum: ["dark", "light", "auto"],
-          description: '\u989C\u8272\u65B9\u6848\uFF0C"auto" \u6062\u590D\u9ED8\u8BA4'
-        },
-        viewport: {
-          type: "string",
-          description: "\u89C6\u53E3\u6A21\u62DF\uFF0C\u683C\u5F0F `<\u5BBD>x<\u9AD8>x<\u7F29\u653E\u6BD4>[,mobile][,touch][,landscape]`"
-        },
-        extraHttpHeaders: {
-          type: "string",
-          description: `\u989D\u5916 HTTP \u8BF7\u6C42\u5934 JSON\uFF0C\u5982 '{"X-Custom":"value"}'`
-        }
-      })
-    }
-  },
-  // ===== JS 执行 =====
-  {
-    name: "chrome-devtools_evaluate_script",
-    description: "\u5728\u6307\u5B9A\u9875\u9762\u6267\u884C JavaScript \u51FD\u6570\u5E76\u8FD4\u56DE\u7ED3\u679C\uFF08\u8FD4\u56DE\u503C\u9700\u53EF JSON \u5E8F\u5217\u5316\uFF09",
-    inputSchema: {
-      type: "object",
-      ...withPageId(
-        {
-          function: {
-            type: "string",
-            description: "JS \u51FD\u6570\u58F0\u660E\u3002\u65E0\u53C2\u6570: `() => document.title`\uFF0C\u6709\u53C2\u6570: `(el) => el.innerText`"
-          },
-          args: {
-            type: "array",
-            items: { type: "string" },
-            description: "\u4F20\u7ED9\u51FD\u6570\u7684\u53C2\u6570\u5217\u8868\uFF08\u5143\u7D20 uid\uFF09"
-          },
-          filePath: { type: "string", description: "\u4FDD\u5B58\u8F93\u51FA\u5230\u6587\u4EF6\uFF0C\u7701\u7565\u5219\u5185\u8054\u8FD4\u56DE" },
-          dialogAction: {
-            type: "string",
-            description: '\u5BF9\u8BDD\u6846\u5904\u7406: "accept"\u3001"dismiss" \u6216 prompt \u6587\u672C'
-          }
-        },
-        ["function"]
-      )
-    }
-  },
-  // ===== 网络监控 =====
-  {
-    name: "chrome-devtools_list_network_requests",
-    description: "\u83B7\u53D6\u6307\u5B9A\u9875\u9762\u7F51\u7EDC\u8BF7\u6C42\u5217\u8868\uFF08\u652F\u6301\u5206\u9875\u548C\u8FC7\u6EE4\uFF09",
-    inputSchema: {
-      type: "object",
-      ...withPageId({
-        pageSize: { type: "integer", description: "\u6BCF\u9875\u6700\u5927\u8BF7\u6C42\u6570" },
-        pageIdx: { type: "integer", minimum: 0, description: "\u9875\u7801\uFF08\u4ECE 0 \u5F00\u59CB\uFF09" },
-        resourceTypes: {
-          type: "array",
-          items: {
-            type: "string",
-            enum: [
-              "document",
-              "stylesheet",
-              "image",
-              "media",
-              "font",
-              "script",
-              "xhr",
-              "fetch",
-              "websocket",
-              "manifest",
-              "other"
-            ]
-          },
-          description: "\u6309\u8D44\u6E90\u7C7B\u578B\u8FC7\u6EE4"
-        },
-        includePreservedRequests: {
-          type: "boolean",
-          description: "\u662F\u5426\u8FD4\u56DE\u6700\u8FD1 3 \u6B21\u5BFC\u822A\u7684\u4FDD\u7559\u8BF7\u6C42"
-        }
-      })
-    }
-  },
-  {
-    name: "chrome-devtools_get_network_request",
-    description: "\u83B7\u53D6\u7F51\u7EDC\u8BF7\u6C42\u7684\u8BE6\u7EC6\u4FE1\u606F\uFF0C\u53EF\u4FDD\u5B58\u8BF7\u6C42/\u54CD\u5E94\u4F53\u5230\u6587\u4EF6",
-    inputSchema: {
-      type: "object",
-      ...withPageId({
-        reqid: {
-          type: "number",
-          description: "\u8BF7\u6C42 ID\uFF08\u4ECE chrome-devtools_list_network_requests \u83B7\u53D6\uFF09\uFF0C\u7701\u7565\u8FD4\u56DE\u5F53\u524D\u9009\u4E2D\u8BF7\u6C42"
-        },
-        requestFilePath: {
-          type: "string",
-          description: "\u4FDD\u5B58\u8BF7\u6C42\u4F53\u5230 .network-request \u6587\u4EF6\u7684\u8DEF\u5F84"
-        },
-        responseFilePath: {
-          type: "string",
-          description: "\u4FDD\u5B58\u54CD\u5E94\u4F53\u5230 .network-response \u6587\u4EF6\u7684\u8DEF\u5F84"
-        }
-      })
-    }
-  },
-  // ===== 控制台 =====
-  {
-    name: "chrome-devtools_list_console_messages",
-    description: "\u83B7\u53D6\u6307\u5B9A\u9875\u9762\u63A7\u5236\u53F0\u6D88\u606F\uFF08\u652F\u6301\u5206\u9875\u548C\u8FC7\u6EE4\uFF09",
-    inputSchema: {
-      type: "object",
-      ...withPageId({
-        pageSize: { type: "integer", description: "\u6BCF\u9875\u6700\u5927\u6D88\u606F\u6570" },
-        pageIdx: { type: "integer", minimum: 0, description: "\u9875\u7801\uFF08\u4ECE 0 \u5F00\u59CB\uFF09" },
-        types: {
-          type: "array",
-          items: {
-            type: "string",
-            enum: ["log", "debug", "info", "error", "warn", "trace", "verbose", "issue"]
-          },
-          description: "\u6309\u6D88\u606F\u7C7B\u578B\u8FC7\u6EE4"
-        },
-        includePreservedMessages: {
-          type: "boolean",
-          description: "\u662F\u5426\u8FD4\u56DE\u6700\u8FD1 3 \u6B21\u5BFC\u822A\u7684\u4FDD\u7559\u6D88\u606F"
-        },
-        serviceWorkerId: { type: "string", description: "\u6309 service worker ID \u8FC7\u6EE4" }
-      })
-    }
-  },
-  {
-    name: "chrome-devtools_get_console_message",
-    description: "\u83B7\u53D6\u67D0\u6761\u63A7\u5236\u53F0\u6D88\u606F\u7684\u8BE6\u7EC6\u4FE1\u606F",
-    inputSchema: {
-      type: "object",
-      ...withPageId(
-        {
-          msgid: {
-            type: "number",
-            description: "\u6D88\u606F ID\uFF08\u4ECE chrome-devtools_list_console_messages \u83B7\u53D6\uFF09"
-          }
-        },
-        ["msgid"]
-      )
-    }
-  },
-  // ===== 其他 =====
-  {
-    name: "chrome-devtools_wait_for",
-    description: "\u7B49\u5F85\u6307\u5B9A\u9875\u9762\u51FA\u73B0\u6307\u5B9A\u6587\u672C\uFF08\u4EFB\u4E00\u5339\u914D\u5373\u8FD4\u56DE\uFF09",
-    inputSchema: {
-      type: "object",
-      ...withPageId(
-        {
-          text: {
-            type: "array",
-            items: { type: "string" },
-            minItems: 1,
-            description: "\u7B49\u5F85\u51FA\u73B0\u7684\u6587\u672C\u5217\u8868"
-          },
-          timeout: { type: "integer", description: "\u6700\u5927\u7B49\u5F85\u65F6\u95F4\uFF08\u6BEB\u79D2\uFF09\uFF0C0 \u4F7F\u7528\u9ED8\u8BA4\u8D85\u65F6" }
-        },
-        ["text"]
-      )
-    }
-  },
-  {
-    name: "chrome-devtools_handle_dialog",
-    description: "\u5904\u7406 JavaScript \u5BF9\u8BDD\u6846\uFF08alert/confirm/prompt\uFF09",
-    inputSchema: {
-      type: "object",
-      ...withPageId(
-        {
-          action: { type: "string", enum: ["accept", "dismiss"], description: "\u63A5\u53D7\u6216\u5173\u95ED\u5BF9\u8BDD\u6846" },
-          promptText: { type: "string", description: "prompt \u5BF9\u8BDD\u6846\u7684\u8F93\u5165\u6587\u672C" }
-        },
-        ["action"]
-      )
-    }
-  },
-  {
-    name: "chrome-devtools_upload_file",
-    description: "\u4E0A\u4F20\u6587\u4EF6\u5230\u6587\u4EF6\u8F93\u5165\u6846",
-    inputSchema: {
-      type: "object",
-      ...withPageId(
-        {
-          uid: { type: "string", description: "\u6587\u4EF6\u8F93\u5165\u6846\u5143\u7D20 uid" },
-          filePath: { type: "string", description: "\u672C\u5730\u6587\u4EF6\u8DEF\u5F84" },
-          includeSnapshot: { type: "boolean", description: "\u662F\u5426\u5728\u54CD\u5E94\u4E2D\u5305\u542B\u5FEB\u7167\uFF0C\u9ED8\u8BA4 false" }
-        },
-        ["uid", "filePath"]
-      )
-    }
-  },
-  // ===== 性能分析 =====
-  {
-    name: "chrome-devtools_performance_start_trace",
-    description: "\u5728\u6307\u5B9A\u9875\u9762\u5F00\u59CB\u8BB0\u5F55\u6027\u80FD trace\uFF08\u7528\u4E8E\u53D1\u73B0 Core Web Vitals \u6027\u80FD\u95EE\u9898\uFF09",
-    inputSchema: {
-      type: "object",
-      ...withPageId({
-        reload: { type: "boolean", description: "\u5F00\u59CB\u540E\u662F\u5426\u81EA\u52A8\u5237\u65B0\u9875\u9762\uFF0C\u9ED8\u8BA4 true" },
-        autoStop: { type: "boolean", description: "\u662F\u5426\u81EA\u52A8\u505C\u6B62\u5F55\u5236\uFF0C\u9ED8\u8BA4 true" },
-        filePath: { type: "string", description: "\u4FDD\u5B58\u539F\u59CB trace \u6570\u636E\u7684\u8DEF\u5F84\uFF0C\u5982 trace.json.gz" }
-      })
-    }
-  },
-  {
-    name: "chrome-devtools_performance_stop_trace",
-    description: "\u505C\u6B62\u6027\u80FD trace \u8BB0\u5F55\u5E76\u8FD4\u56DE\u7ED3\u679C",
-    inputSchema: {
-      type: "object",
-      ...withPageId({
-        filePath: { type: "string", description: "\u4FDD\u5B58\u539F\u59CB trace \u6570\u636E\u7684\u8DEF\u5F84\uFF0C\u5982 trace.json.gz" }
-      })
-    }
-  },
   {
-    name: "chrome-devtools_performance_analyze_insight",
-    description: "\u83B7\u53D6\u7279\u5B9A\u6027\u80FD\u6307\u6807\u7684\u8BE6\u7EC6\u5206\u6790",
-    inputSchema: {
-      type: "object",
-      ...withPageId(
-        {
-          insightSetId: { type: "string", description: "\u6307\u6807\u96C6 ID\uFF08\u4ECE trace \u7ED3\u679C\u83B7\u53D6\uFF09" },
-          insightName: {
-            type: "string",
-            description: '\u6307\u6807\u540D\u79F0\uFF0C\u5982 "DocumentLatency"\u3001"LCPBreakdown"'
-          }
-        },
-        ["insightSetId", "insightName"]
-      )
-    }
-  },
-  {
-    name: "chrome-devtools_lighthouse_audit",
-    description: "\u5BF9\u6307\u5B9A\u9875\u9762\u8FD0\u884C Lighthouse \u5BA1\u8BA1\uFF08\u53EF\u8BBF\u95EE\u6027/SEO/\u6700\u4F73\u5B9E\u8DF5\uFF0C\u4E0D\u542B\u6027\u80FD\uFF09",
-    inputSchema: {
-      type: "object",
-      ...withPageId({
-        mode: {
-          type: "string",
-          enum: ["navigation", "snapshot"],
-          description: "navigation \u5237\u65B0\u5BA1\u8BA1\uFF0Csnapshot \u5206\u6790\u5F53\u524D\u72B6\u6001"
-        },
-        device: {
-          type: "string",
-          enum: ["desktop", "mobile"],
-          description: "\u6A21\u62DF\u8BBE\u5907\u7C7B\u578B\uFF0C\u9ED8\u8BA4 desktop"
-        },
-        outputDirPath: { type: "string", description: "\u62A5\u544A\u8F93\u51FA\u76EE\u5F55\uFF0C\u7701\u7565\u4F7F\u7528\u4E34\u65F6\u6587\u4EF6" }
-      })
-    }
-  },
-  {
-    name: "chrome-devtools_take_heapsnapshot",
-    description: "\u6355\u83B7\u6307\u5B9A\u9875\u9762\u5806\u5185\u5B58\u5FEB\u7167\uFF0C\u7528\u4E8E\u5206\u6790 JS \u5BF9\u8C61\u5185\u5B58\u5206\u5E03\u548C\u8C03\u8BD5\u5185\u5B58\u6CC4\u6F0F",
-    inputSchema: {
-      type: "object",
-      ...withPageId(
-        {
-          filePath: { type: "string", description: "\u4FDD\u5B58 .heapsnapshot \u6587\u4EF6\u7684\u8DEF\u5F84" }
-        },
-        ["filePath"]
-      )
-    }
-  },
-  // ===== Vue DevTools =====
-  {
-    name: "vue-devtools_get_apps",
-    description: `\u83B7\u53D6\u6307\u5B9A\u9875\u9762\u6240\u6709 Vue \u5E94\u7528\u5B9E\u4F8B\u5217\u8868\u3002
-
-**\u4F55\u65F6\u4F7F\u7528**\uFF1A
-- \u6392\u67E5\u5FAE\u524D\u7AEF/\u591A\u5B9E\u4F8B\u573A\u666F\u4E0B\u64CD\u4F5C\u7684\u662F\u54EA\u4E2A\u5E94\u7528
-- \u5207\u6362\u6D3B\u8DC3\u5E94\u7528\u524D\u67E5\u770B\u6709\u54EA\u4E9B\u53EF\u7528`,
-    inputSchema: {
-      type: "object",
-      ...withPageId({})
-    }
-  },
-  {
-    name: "vue-devtools_set_active_app",
-    description: `\u5207\u6362\u6307\u5B9A\u9875\u9762\u7684\u6D3B\u8DC3 Vue \u5E94\u7528\u5B9E\u4F8B\u3002\u540E\u7EED\u6240\u6709 vue-devtools_* \u5DE5\u5177\u90FD\u64CD\u4F5C\u8FD9\u4E2A\u5E94\u7528\u3002`,
-    inputSchema: {
-      type: "object",
-      ...withPageId(
-        {
-          appId: { type: "string", description: "\u5E94\u7528 ID\uFF08\u4ECE vue-devtools_get_apps \u83B7\u53D6\uFF09" }
-        },
-        ["appId"]
-      )
-    }
-  },
-  {
-    name: "vue-devtools_get_component_tree",
-    description: `\u83B7\u53D6\u6307\u5B9A\u9875\u9762\u5F53\u524D\u6D3B\u8DC3 Vue \u5E94\u7528\u7684\u7EC4\u4EF6\u6811\u3002
-
-**\u4F55\u65F6\u4F7F\u7528**\uFF1A
-- \u4E86\u89E3\u9875\u9762\u7EC4\u4EF6\u5C42\u7EA7\u7ED3\u6784
-- \u627E\u5230\u76EE\u6807\u7EC4\u4EF6\u7684 nodeId\uFF08\u540E\u7EED\u67E5\u72B6\u6001\u7528\uFF09
-- \u6392\u67E5\u7EC4\u4EF6\u672A\u6E32\u67D3\u95EE\u9898
-- \u53EA\u5173\u5FC3\u67D0\u7C7B\u7EC4\u4EF6\u65F6\u7528 filter \u7F29\u5C0F\u8303\u56F4
-
-**\u8FD4\u56DE**\uFF1A\u7EC4\u4EF6\u6811 [{ id, name, children, file, ... }]`,
-    inputSchema: {
-      type: "object",
-      ...withPageId({
-        filter: { type: "string", description: "\u6309\u7EC4\u4EF6\u540D\u8FC7\u6EE4\uFF08\u5927\u5C0F\u5199\u4E0D\u654F\u611F\u7684\u5B50\u4E32\u5339\u914D\uFF09\uFF0C\u53EF\u9009" }
-      })
-    }
-  },
-  {
-    name: "vue-devtools_get_component_state",
-    description: `\u83B7\u53D6\u6307\u5B9A\u7EC4\u4EF6\u7684\u5B8C\u6574\u8FD0\u884C\u65F6\u72B6\u6001\u3002
-
-**\u4F55\u65F6\u4F7F\u7528**\uFF1A
-- \u6392\u67E5 props \u4F20\u503C\u662F\u5426\u6B63\u786E
-- \u67E5\u770B ref/reactive \u54CD\u5E94\u5F0F\u6570\u636E\u7684\u5F53\u524D\u503C
-- \u68C0\u67E5 computed \u8BA1\u7B97\u7ED3\u679C
-- \u67E5\u770B attrs / events / inject / provide / template refs`,
-    inputSchema: {
-      type: "object",
-      ...withPageId(
-        {
-          nodeId: {
-            type: "string",
-            description: "\u7EC4\u4EF6\u8282\u70B9 ID\uFF08\u4ECE vue-devtools_get_component_tree \u83B7\u53D6\uFF09"
-          }
-        },
-        ["nodeId"]
-      )
-    }
-  },
-  {
-    name: "vue-devtools_get_component_render_code",
-    description: `\u83B7\u53D6\u7EC4\u4EF6\u7684\u6E32\u67D3\u51FD\u6570\u6E90\u7801\u3002`,
-    inputSchema: {
-      type: "object",
-      ...withPageId({ nodeId: { type: "string", description: "\u7EC4\u4EF6\u8282\u70B9 ID" } }, ["nodeId"])
-    }
-  },
-  {
-    name: "vue-devtools_get_current_route",
-    description: `\u83B7\u53D6 Vue Router \u7684\u5F53\u524D\u8DEF\u7531\u4FE1\u606F\u3002
-
-**\u4F55\u65F6\u4F7F\u7528**\uFF1A
-- \u6392\u67E5\u8DEF\u7531\u8DF3\u8F6C\u95EE\u9898
-- \u67E5\u770B\u5F53\u524D\u8DEF\u7531 path/params/query/hash
-- \u786E\u8BA4\u8DEF\u7531\u5B88\u536B\u548C matched \u8BB0\u5F55`,
-    inputSchema: {
-      type: "object",
-      ...withPageId({})
-    }
-  },
-  {
-    name: "vue-devtools_get_routes",
-    description: `\u83B7\u53D6 Vue Router \u7684\u5B8C\u6574\u8DEF\u7531\u8868\u3002
-
-**\u4F55\u65F6\u4F7F\u7528**\uFF1A
-- \u67E5\u770B\u6240\u6709\u5DF2\u6CE8\u518C\u8DEF\u7531
-- \u786E\u8BA4\u8DEF\u7531\u914D\u7F6E\u662F\u5426\u6B63\u786E
-- \u67E5\u770B\u8DEF\u7531\u5D4C\u5957\u5173\u7CFB`,
-    inputSchema: {
-      type: "object",
-      ...withPageId({})
+    name: displayToolName("current_page"),
+    description: "Get the page the user is currently browsing (URL, title, and page ID). Resolves the project page with injected context; for allowOrigins pages use list_pages and pass its pageId to page tools instead.",
+    inputSchema: { type: "object", properties: {} }
+  }
+];
+const UNSAFE_CATEGORIES = /* @__PURE__ */ new Set(["EXTENSIONS", "PWA", "THIRD_PARTY", "WEBMCP"]);
+function metaByName(short) {
+  return OFFICIAL_TOOL_META.find((m) => m.name === short);
+}
+function isOfficialExtraTool(short) {
+  const m = metaByName(short);
+  return !!m && m.conditions.length > 0 && !UNSAFE_CATEGORIES.has(m.category);
+}
+function camelToKebab(name) {
+  return name.replace(/([a-z0-9])([A-Z])/g, "$1-$2").toLowerCase();
+}
+function extraToolFlag(short) {
+  const m = metaByName(short);
+  if (!m) return void 0;
+  const cond = m.conditions.find((c) => c.startsWith("experimental"));
+  return cond ? `--${camelToKebab(cond)}` : void 0;
+}
+function officialExtraCandidates() {
+  return OFFICIAL_TOOL_META.filter(
+    (m) => m.conditions.length > 0 && !UNSAFE_CATEGORIES.has(m.category)
+  ).map((m) => m.name);
+}
+function officialDefaultShorts() {
+  const pages = OFFICIAL_TOOL_META.filter(
+    (m) => m.pageScoped && m.conditions.length === 0 && !UNSAFE_CATEGORIES.has(m.category)
+  ).map((m) => m.name).sort();
+  return [...pages, ...OFFICIAL_GLOBAL_POLICY];
+}
+let extraAllowed = /* @__PURE__ */ new Set();
+let deniedShorts = /* @__PURE__ */ new Set();
+function configureToolScope(extra = [], deny = [], warn = (msg) => console.warn(msg)) {
+  const allowedExtra = /* @__PURE__ */ new Set();
+  for (const short of extra) {
+    if (isOfficialExtraTool(short)) {
+      allowedExtra.add(short);
+    } else {
+      warn(`chromeMcp.project.tools.extra \u5DF2\u5FFD\u7565\u975E\u4E8C\u7EA7\u76EE\u5F55\u5DE5\u5177: ${short}`);
     }
-  },
-  // ===== Vite 进程日志 =====
-  {
-    name: "logs-devtools_vite_logs",
-    description: `\u83B7\u53D6 Vite \u5F00\u53D1\u670D\u52A1\u5668\u7684\u8FD0\u884C\u65E5\u5FD7\u3002
-
-**\u4F55\u65F6\u4F7F\u7528\u6B64\u5DE5\u5177**\uFF1A
-- \u7528\u6237\u62A5\u544A"\u9875\u9762\u6CA1\u66F4\u65B0"\u3001"\u70ED\u66F4\u65B0\u4E0D\u5DE5\u4F5C"\u3001"HMR \u5931\u6548"\u65F6
-- \u6784\u5EFA\u62A5\u9519\u6216\u7F16\u8BD1\u5931\u8D25\uFF0C\u9700\u8981\u67E5\u770B\u8BE6\u7EC6\u9519\u8BEF\u4FE1\u606F
-- \u9875\u9762\u767D\u5C4F\u3001\u6837\u5F0F\u4E22\u5931\u3001\u6A21\u5757\u52A0\u8F7D\u5931\u8D25\u7B49\u5F00\u53D1\u95EE\u9898
-- \u7528\u6237\u63D0\u5230"\u5F00\u53D1\u670D\u52A1\u5668\u6709\u95EE\u9898"\u3001"vite \u62A5\u9519"
-- \u9700\u8981\u786E\u8BA4\u6700\u8FD1\u7684\u6587\u4EF6\u53D8\u66F4\u662F\u5426\u88AB Vite \u6B63\u786E\u5904\u7406
-
-**\u65E5\u5FD7\u5185\u5BB9**\uFF1A
-- Vite HMR \u70ED\u66F4\u65B0\u65E5\u5FD7\uFF08\u54EA\u4E9B\u6587\u4EF6\u88AB\u66F4\u65B0\u3001\u66F4\u65B0\u72B6\u6001\uFF09
-- \u6784\u5EFA\u7F16\u8BD1\u65E5\u5FD7\uFF08\u9519\u8BEF\u3001\u8B66\u544A\u3001\u6210\u529F\u4FE1\u606F\uFF09
-- OpenCode Web \u8FDB\u7A0B\u8F93\u51FA
-- \u63D2\u4EF6\u8FD0\u884C\u65E5\u5FD7
-
-\u65E5\u5FD7\u4FDD\u5B58\u5728\u5185\u5B58\u7F13\u51B2\u533A\uFF08\u6700\u8FD1 500 \u6761\uFF09\u3002`,
-    inputSchema: {
-      type: "object",
-      properties: {
-        level: {
-          type: "string",
-          description: "\u65E5\u5FD7\u7EA7\u522B\u8FC7\u6EE4\uFF1Aerror(\u9519\u8BEF)\u3001warn(\u8B66\u544A)\u3001info(\u4FE1\u606F)\u3001debug(\u8C03\u8BD5)\u3001log(\u666E\u901A)\u3002\u591A\u4E2A\u7528\u9017\u53F7\u5206\u9694\uFF0C\u5982 'error,warn'"
-        },
-        limit: {
-          type: "integer",
-          minimum: 1,
-          maximum: 200,
-          default: 50,
-          description: "\u8FD4\u56DE\u6761\u6570\uFF0C\u9ED8\u8BA4 50\uFF0C\u6700\u5927 200"
-        },
-        source: {
-          type: "string",
-          description: "\u6765\u6E90\u8FC7\u6EE4\uFF1Aconsole(\u63A7\u5236\u53F0)\u3001provider-stdout(\u670D\u52A1\u8F93\u51FA)\u3001provider-stderr(\u670D\u52A1\u9519\u8BEF)"
-        }
-      }
+  }
+  const known = /* @__PURE__ */ new Set([
+    ...officialDefaultShorts(),
+    ...officialExtraCandidates(),
+    "current_page"
+  ]);
+  const denied = /* @__PURE__ */ new Set();
+  for (const short of deny) {
+    if (known.has(short)) {
+      denied.add(short);
+    } else {
+      warn(`chromeMcp.project.tools.deny \u5DF2\u5FFD\u7565\u672A\u77E5\u5DE5\u5177\u540D: ${short}`);
     }
   }
-];
+  extraAllowed = allowedExtra;
+  deniedShorts = denied;
+}
+function currentOfficialShorts() {
+  const base = officialDefaultShorts().filter((s) => !deniedShorts.has(s));
+  const extra = [...extraAllowed].filter((s) => !officialDefaultShorts().includes(s));
+  return [...base, ...extra];
+}
+function isAllowedToolName(name) {
+  if (name === displayToolName("current_page")) return true;
+  const short = name.startsWith(MCP_PREFIX) ? name.slice(MCP_PREFIX.length) : name;
+  if (deniedShorts.has(short)) return false;
+  if (officialDefaultShorts().includes(short)) return true;
+  return extraAllowed.has(short);
+}
 export {
-  CUSTOM_TOOLS
+  CUSTOM_TOOLS,
+  MCP_PREFIX,
+  OFFICIAL_GLOBAL_POLICY,
+  OFFICIAL_NO_PAGE_TOOLS,
+  PAGE_ID_PROP,
+  PROJECT_DESCRIPTION_NOTES,
+  configureToolScope,
+  currentOfficialShorts,
+  displayToolName,
+  extraToolFlag,
+  isAllowedToolName,
+  isOfficialExtraTool,
+  officialDefaultShorts,
+  officialExtraCandidates,
+  withPageIdSchema
 };