vite-plugin-opencode-assistant 1.1.25 → 1.1.26

package/es/endpoints/mcp.mjs

@@ -1,3 +1,19 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropSymbols = Object.getOwnPropertySymbols;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __propIsEnum = Object.prototype.propertyIsEnumerable;
+var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __spreadValues = (a, b) => {
+  for (var prop in b || (b = {}))
+    if (__hasOwnProp.call(b, prop))
+      __defNormalProp(a, prop, b[prop]);
+  if (__getOwnPropSymbols)
+    for (var prop of __getOwnPropSymbols(b)) {
+      if (__propIsEnum.call(b, prop))
+        __defNormalProp(a, prop, b[prop]);
+    }
+  return a;
+};
 var __async = (__this, __arguments, generator) => {
   return new Promise((resolve, reject) => {
     var fulfilled = (value) => {
@@ -20,18 +36,22 @@ var __async = (__this, __arguments, generator) => {
 };
 import { MCP_API_PATH } from "@vite-plugin-opencode-assistant/shared";
 import { createLogger } from "@vite-plugin-opencode-assistant/shared/node";
-import { parseListPages, resolveChromePageId, getProjectOrigin } from "../endpoints/context.mjs";
+import {
+  parseListPages,
+  resolveChromePageId,
+  getProjectOrigins,
+  isProjectPage
+} from "../core/mcp-chrome.mjs";
 import { CUSTOM_TOOLS, TOOL_MAP } from "./mcp-tools.mjs";
 const log = createLogger("McpEndpoint");
 function setupMcpEndpoint(server, mcp, getPageContext) {
   server.middlewares.use((req, res, next) => __async(null, null, function* () {
-    var _a, _b, _c, _d, _e, _f, _g, _h, _i, _j;
+    var _a, _b, _c;
     if (!((_a = req.url) == null ? void 0 : _a.startsWith(MCP_API_PATH))) return next();
     const url = new URL(req.url, `http://localhost`);
     const token = (_c = url.searchParams.get("token")) != null ? _c : (_b = req.headers["authorization"]) == null ? void 0 : _b.replace(/^Bearer /i, "");
     if (token !== mcp.accessToken) {
-      res.writeHead(401, { "Content-Type": "application/json" });
-      res.end(JSON.stringify({ error: "Unauthorized" }));
+      sendMcpJson(res, 401, { error: "Unauthorized" });
       return;
     }
     res.setHeader("Access-Control-Allow-Origin", "*");
@@ -44,15 +64,7 @@ function setupMcpEndpoint(server, mcp, getPageContext) {
       return;
     }
     if (req.method === "GET") {
-      res.writeHead(200, {
-        "Content-Type": "text/event-stream",
-        "Cache-Control": "no-cache",
-        Connection: "keep-alive",
-        "Mcp-Session-Id": mcp.sessionId
-      });
-      res.write(":ok\n\n");
-      const keepAlive = setInterval(() => res.write(":ping\n\n"), 15e3);
-      req.on("close", () => clearInterval(keepAlive));
+      handleGetSse(req, res, mcp);
       return;
     }
     if (req.method === "DELETE") {
@@ -61,167 +73,186 @@ function setupMcpEndpoint(server, mcp, getPageContext) {
       return;
     }
     if (req.method === "POST") {
-      try {
-        const body = yield readBody(req);
-        if (!body) {
-          res.writeHead(400);
-          res.end("Empty body");
-          return;
-        }
-        const { method, id } = tryParseRequest(body);
-        log.debug("MCP request", { method, body: body.substring(0, 150) });
-        if (method === "tools/list") {
-          res.writeHead(200, {
-            "Content-Type": "application/json",
-            "Mcp-Session-Id": mcp.sessionId
-          });
-          res.end(JSON.stringify({ jsonrpc: "2.0", id, result: { tools: CUSTOM_TOOLS } }));
-          return;
-        }
-        if (method === "tools/call") {
-          const params = tryParseParams(body);
-          const toolName = params == null ? void 0 : params.name;
-          const mapped = toolName != null ? TOOL_MAP[toolName] : void 0;
-          if (!mapped) {
-            res.writeHead(200, {
-              "Content-Type": "application/json",
-              "Mcp-Session-Id": mcp.sessionId
-            });
-            res.end(
-              JSON.stringify({
-                jsonrpc: "2.0",
-                id,
-                error: { code: -32601, message: `Tool not found: ${toolName}` }
-              })
-            );
-            return;
-          }
-          if (toolName === "devtools_list_pages") {
-            const listResult = yield mcp.callChromeDevTool("list_pages", {});
-            const text = (_f = (_e = (_d = listResult == null ? void 0 : listResult.result) == null ? void 0 : _d.content) == null ? void 0 : _e[0]) == null ? void 0 : _f.text;
-            const allPages = text ? parseListPages(text) : [];
-            const pc = getPageContext();
-            const projectOrigin = getProjectOrigin(pc.url);
-            if (!projectOrigin) {
-              res.writeHead(200, {
-                "Content-Type": "application/json",
-                "Mcp-Session-Id": mcp.sessionId
-              });
-              res.end(
-                JSON.stringify({
-                  jsonrpc: "2.0",
-                  id,
-                  result: {
-                    content: [
-                      { type: "text", text: "\u6682\u65E0\u9879\u76EE\u9875\u9762\uFF0C\u8BF7\u5148\u5728\u6D4F\u89C8\u5668\u4E2D\u6253\u5F00\u672C\u5730\u5F00\u53D1\u9875\u9762" }
-                    ]
-                  }
-                })
-              );
-              return;
-            }
-            const filtered = allPages.filter((p) => p.url.startsWith(projectOrigin));
-            const chromeSelectedPageId = (_g = allPages.find((p) => p.selected)) == null ? void 0 : _g.pageId;
-            const resolved = yield resolveChromePageId(
-              mcp,
-              pc.url,
-              pc.title,
-              pc.sessionId,
-              filtered,
-              chromeSelectedPageId
-            );
-            const activePageId = resolved.ok ? resolved.pageId : null;
-            res.writeHead(200, {
-              "Content-Type": "application/json",
-              "Mcp-Session-Id": mcp.sessionId
-            });
-            res.end(
-              JSON.stringify({
-                jsonrpc: "2.0",
-                id,
-                result: {
-                  content: [
-                    {
-                      type: "text",
-                      text: JSON.stringify(
-                        filtered.map((p) => ({
-                          pageId: p.pageId,
-                          url: p.url,
-                          title: p.title,
-                          active: activePageId != null ? p.pageId === activePageId : false,
-                          selected: p.selected
-                        })),
-                        null,
-                        2
-                      )
-                    }
-                  ]
-                }
-              })
-            );
-            return;
-          }
-          if (toolName !== "devtools_select_page") {
-            const checkResult = yield mcp.callChromeDevTool("list_pages", {});
-            const checkText = (_j = (_i = (_h = checkResult == null ? void 0 : checkResult.result) == null ? void 0 : _h.content) == null ? void 0 : _i[0]) == null ? void 0 : _j.text;
-            const checkPages = checkText ? parseListPages(checkText) : [];
-            const pc = getPageContext();
-            const origin = getProjectOrigin(pc.url);
-            const hasProjectSelected = origin ? checkPages.some((p) => p.selected && p.url.startsWith(origin)) : true;
-            if (!hasProjectSelected) {
-              res.writeHead(200, {
-                "Content-Type": "application/json",
-                "Mcp-Session-Id": mcp.sessionId
-              });
-              res.end(
-                JSON.stringify({
-                  jsonrpc: "2.0",
-                  id,
-                  error: {
-                    code: -32e3,
-                    message: "Chrome DevTools \u5F53\u524D\u672A\u9009\u4E2D\u9879\u76EE\u9875\u9762\uFF0C\u8BF7\u5148\u8C03\u7528 devtools_list_pages \u67E5\u770B\u53EF\u7528\u9875\u9762\uFF0C\u518D\u8C03\u7528 devtools_select_page \u9009\u62E9\u76EE\u6807\u9875\u9762"
-                  }
-                })
-              );
-              return;
-            }
-          }
-          const forwardBody = JSON.stringify({
-            jsonrpc: "2.0",
-            id,
-            method: "tools/call",
-            params: {
-              name: mapped,
-              arguments: (params == null ? void 0 : params.arguments) || {}
-            }
-          });
-          const responseText2 = yield mcp.forward(forwardBody);
-          log.debug("MCP response", { method: toolName, response: responseText2.substring(0, 100) });
-          res.writeHead(200, {
-            "Content-Type": "application/json",
-            "Mcp-Session-Id": mcp.sessionId
-          });
-          res.end(responseText2);
-          return;
-        }
-        const responseText = yield mcp.forward(body);
-        res.writeHead(200, { "Content-Type": "application/json", "Mcp-Session-Id": mcp.sessionId });
-        res.end(responseText);
-      } catch (e) {
-        log.debug("MCP POST error", { error: e.message });
-        res.writeHead(500, { "Content-Type": "application/json" });
-        res.end(
-          JSON.stringify({
-            jsonrpc: "2.0",
-            error: { code: -32603, message: e.message }
-          })
-        );
-      }
+      yield handlePost(req, res, mcp, getProjectOrigins(server), getPageContext);
       return;
     }
     next();
   }));
 }
+function handleGetSse(req, res, mcp) {
+  res.writeHead(200, {
+    "Content-Type": "text/event-stream",
+    "Cache-Control": "no-cache",
+    Connection: "keep-alive",
+    "Mcp-Session-Id": mcp.sessionId
+  });
+  res.write(":ok\n\n");
+  const keepAlive = setInterval(() => res.write(":ping\n\n"), 15e3);
+  req.on("close", () => clearInterval(keepAlive));
+}
+function handlePost(req, res, mcp, projectOrigins, getPageContext) {
+  return __async(this, null, function* () {
+    try {
+      const body = yield readBody(req);
+      if (!body) {
+        res.writeHead(400);
+        res.end("Empty body");
+        return;
+      }
+      const { method, id } = tryParseRequest(body);
+      log.debug("MCP request", { method, body: body.substring(0, 150) });
+      switch (method) {
+        case "tools/list":
+          return handleToolsList(res, id, mcp.sessionId);
+        case "tools/call":
+          return handleToolsCall(res, id, body, mcp, projectOrigins, getPageContext);
+        default:
+          return handleForward(res, body, mcp);
+      }
+    } catch (e) {
+      log.debug("MCP POST error", { error: e.message });
+      sendMcpJson(res, 500, {
+        jsonrpc: "2.0",
+        error: { code: -32603, message: e.message }
+      });
+    }
+  });
+}
+function handleToolsList(res, id, sessionId) {
+  sendMcpJson(res, 200, { jsonrpc: "2.0", id, result: { tools: CUSTOM_TOOLS } }, sessionId);
+}
+function handleToolsCall(res, id, body, mcp, projectOrigins, getPageContext) {
+  const params = tryParseParams(body);
+  const toolName = params == null ? void 0 : params.name;
+  const mapped = toolName != null ? TOOL_MAP[toolName] : void 0;
+  if (!mapped) {
+    sendMcpError(res, id, -32601, `Tool not found: ${toolName}`, mcp.sessionId);
+    return;
+  }
+  switch (toolName) {
+    case "devtools_list_pages":
+      return handleListPages(res, id, mcp, projectOrigins, getPageContext);
+    default:
+      return handleDevTool(res, id, mcp, mapped, (params == null ? void 0 : params.arguments) || {}, projectOrigins);
+  }
+}
+function handleListPages(res, id, mcp, projectOrigins, getPageContext) {
+  return __async(this, null, function* () {
+    var _a, _b, _c, _d;
+    const listResult = yield mcp.callChromeDevTool("list_pages", {});
+    const text = (_c = (_b = (_a = listResult == null ? void 0 : listResult.result) == null ? void 0 : _a.content) == null ? void 0 : _b[0]) == null ? void 0 : _c.text;
+    const allPages = text ? parseListPages(text) : [];
+    log.debug("Chrome pages", { total: allPages.length, urls: allPages.map((p) => p.url) });
+    log.debug("project origins", { origins: projectOrigins });
+    const filtered = allPages.filter((p) => isProjectPage(p.url, projectOrigins));
+    log.debug("filtered pages", { count: filtered.length, pageIds: filtered.map((p) => p.pageId) });
+    if (filtered.length === 0) {
+      sendMcpResult(res, id, "\u6682\u65E0\u9879\u76EE\u9875\u9762\uFF0C\u8BF7\u5148\u5728\u6D4F\u89C8\u5668\u4E2D\u6253\u5F00\u672C\u5730\u5F00\u53D1\u9875\u9762", mcp.sessionId);
+      return;
+    }
+    const pc = getPageContext();
+    const chromeSelectedPageId = (_d = allPages.find((p) => p.selected)) == null ? void 0 : _d.pageId;
+    const resolved = yield resolveChromePageId(
+      mcp,
+      pc.url,
+      pc.title,
+      projectOrigins,
+      pc.sessionId,
+      filtered,
+      chromeSelectedPageId
+    );
+    const activePageId = resolved.ok ? resolved.pageId : null;
+    const pageList = filtered.map((p) => ({
+      pageId: p.pageId,
+      url: p.url,
+      title: p.title,
+      active: activePageId != null ? p.pageId === activePageId : false,
+      selected: p.selected
+    }));
+    sendMcpResult(res, id, JSON.stringify(pageList, null, 2), mcp.sessionId);
+  });
+}
+function handleDevTool(res, id, mcp, mapped, args, projectOrigins) {
+  return __async(this, null, function* () {
+    var _a, _b, _c;
+    const pageId = args["pageId"];
+    if (typeof pageId !== "number") {
+      sendMcpError(
+        res,
+        id,
+        -32e3,
+        "\u7F3A\u5C11 pageId \u53C2\u6570\uFF0C\u8BF7\u5148\u8C03\u7528 devtools_list_pages \u83B7\u53D6\u53EF\u7528\u9875\u9762\u5217\u8868",
+        mcp.sessionId
+      );
+      return;
+    }
+    const checkResult = yield mcp.callChromeDevTool("list_pages", {});
+    const checkText = (_c = (_b = (_a = checkResult == null ? void 0 : checkResult.result) == null ? void 0 : _a.content) == null ? void 0 : _b[0]) == null ? void 0 : _c.text;
+    const checkPages = checkText ? parseListPages(checkText) : [];
+    const projectPages = checkPages.filter((p) => isProjectPage(p.url, projectOrigins));
+    const isValid = projectPages.some((p) => p.pageId === pageId);
+    log.debug("handleDevTool validation", {
+      pageId,
+      totalChromePages: checkPages.length,
+      projectPages: projectPages.length,
+      projectPageIds: projectPages.map((p) => p.pageId),
+      origins: projectOrigins,
+      isValid
+    });
+    if (!isValid) {
+      sendMcpError(res, id, -32e3, "pageId \u65E0\u6548\u6216\u975E\u9879\u76EE\u9875\u9762", mcp.sessionId);
+      return;
+    }
+    yield mcp.callChromeDevTool("select_page", { pageId, bringToFront: false });
+    const forwardArgs = __spreadValues({}, args);
+    delete forwardArgs["pageId"];
+    const forwardBody = JSON.stringify({
+      jsonrpc: "2.0",
+      id,
+      method: "tools/call",
+      params: { name: mapped, arguments: forwardArgs }
+    });
+    const responseText = yield mcp.forward(forwardBody);
+    log.debug("MCP response", { mapped, response: responseText.substring(0, 100) });
+    sendMcpJson(res, 200, responseText, mcp.sessionId);
+  });
+}
+function handleForward(res, body, mcp) {
+  return __async(this, null, function* () {
+    const responseText = yield mcp.forward(body);
+    sendMcpJson(res, 200, responseText, mcp.sessionId);
+  });
+}
+function sendMcpResult(res, id, text, sessionId) {
+  sendMcpJson(
+    res,
+    200,
+    {
+      jsonrpc: "2.0",
+      id,
+      result: { content: [{ type: "text", text }] }
+    },
+    sessionId
+  );
+}
+function sendMcpError(res, id, code, message, sessionId) {
+  sendMcpJson(
+    res,
+    200,
+    {
+      jsonrpc: "2.0",
+      id,
+      error: { code, message }
+    },
+    sessionId
+  );
+}
+function sendMcpJson(res, statusCode, body, sessionId) {
+  const headers = { "Content-Type": "application/json" };
+  if (sessionId) headers["Mcp-Session-Id"] = sessionId;
+  res.writeHead(statusCode, headers);
+  res.end(typeof body === "string" ? body : JSON.stringify(body));
+}
 function readBody(req, maxSize = 1024 * 1024) {
   return new Promise((resolve, reject) => {
     let body = "";

package/lib/core/mcp-chrome.cjs

@@ -0,0 +1,174 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var __async = (__this, __arguments, generator) => {
+  return new Promise((resolve, reject) => {
+    var fulfilled = (value) => {
+      try {
+        step(generator.next(value));
+      } catch (e) {
+        reject(e);
+      }
+    };
+    var rejected = (value) => {
+      try {
+        step(generator.throw(value));
+      } catch (e) {
+        reject(e);
+      }
+    };
+    var step = (x) => x.done ? resolve(x.value) : Promise.resolve(x.value).then(fulfilled, rejected);
+    step((generator = generator.apply(__this, __arguments)).next());
+  });
+};
+var mcp_chrome_exports = {};
+__export(mcp_chrome_exports, {
+  extractEvalValue: () => extractEvalValue,
+  getProjectOrigins: () => getProjectOrigins,
+  isProjectPage: () => isProjectPage,
+  parseListPages: () => parseListPages,
+  resolveChromePageId: () => resolveChromePageId
+});
+module.exports = __toCommonJS(mcp_chrome_exports);
+var import_node = require("@vite-plugin-opencode-assistant/shared/node");
+const log = (0, import_node.createLogger)("McpChrome");
+function getProjectOrigins(server) {
+  var _a, _b, _c, _d;
+  const local = (_b = (_a = server.resolvedUrls) == null ? void 0 : _a.local) != null ? _b : [];
+  const network = (_d = (_c = server.resolvedUrls) == null ? void 0 : _c.network) != null ? _d : [];
+  const origins = [...new Set([...local, ...network].map((u) => new URL(u).origin))];
+  log.debug("project origins", { origins });
+  return origins;
+}
+function isProjectPage(url, origins) {
+  return origins.some((origin) => url.startsWith(origin));
+}
+function parseListPages(text) {
+  const pages = [];
+  for (const line of text.split("\n")) {
+    const match = line.match(/^(\d+):\s*(.+?)\s*\((\S+)\)/);
+    if (match) {
+      pages.push({
+        pageId: parseInt(match[1], 10),
+        title: match[2].replace(/\s*\.{3}$/, "").trim(),
+        url: match[3],
+        selected: /\[selected\]/i.test(line)
+      });
+    }
+  }
+  return pages;
+}
+function extractEvalValue(text) {
+  if (!text) return void 0;
+  const marker = "```json\n";
+  const startIdx = text.indexOf(marker);
+  if (startIdx < 0) return text.trim();
+  const contentStart = startIdx + marker.length;
+  const endIdx = text.indexOf("\n```", contentStart);
+  const jsonStr = endIdx < 0 ? text.substring(contentStart) : text.substring(contentStart, endIdx);
+  try {
+    return JSON.parse(jsonStr.trim());
+  } catch (e) {
+    return jsonStr.trim();
+  }
+}
+function resolveChromePageId(mcp, url, title, projectOrigins, sessionId, pages, chromeSelectedPageId) {
+  return __async(this, null, function* () {
+    var _a, _b, _c, _d, _e, _f, _g;
+    if (!mcp || !mcp.isRunning) {
+      const reason = !mcp ? "MCP \u6A21\u5757\u672A\u521D\u59CB\u5316" : "Chrome DevTools MCP \u8FDB\u7A0B\u672A\u542F\u52A8";
+      log.debug(`resolveChromePageId: ${reason}`);
+      return { ok: false, error: reason };
+    }
+    if (!url) {
+      return { ok: false, error: "\u9875\u9762 URL \u4E3A\u7A7A\uFF0C\u5C1A\u672A\u6536\u5230\u4E0A\u4E0B\u6587\u4FE1\u606F" };
+    }
+    try {
+      if (!pages) {
+        const listResult = yield mcp.callChromeDevTool("list_pages", {});
+        const text = (_c = (_b = (_a = listResult == null ? void 0 : listResult.result) == null ? void 0 : _a.content) == null ? void 0 : _b[0]) == null ? void 0 : _c.text;
+        if (!text) {
+          return { ok: false, error: "\u65E0\u6CD5\u83B7\u53D6 Chrome \u9875\u9762\u5217\u8868\uFF0C\u8BF7\u786E\u8BA4\u5DF2\u6253\u5F00\u76EE\u6807\u9875\u9762" };
+        }
+        const allPages = parseListPages(text);
+        chromeSelectedPageId = (_d = allPages.find((p) => p.selected)) == null ? void 0 : _d.pageId;
+        pages = allPages.filter((p) => isProjectPage(p.url, projectOrigins));
+      }
+      log.debug("resolveChromePageId: list_pages result", {
+        pages: pages.map((p) => ({ id: p.pageId, url: p.url, title: p.title.substring(0, 40) })),
+        target: { url, title }
+      });
+      const normalizeUrl = (u) => u.replace(/\/$/, "");
+      const targetUrl = normalizeUrl(url);
+      if (sessionId) {
+        let matchedPageId = null;
+        for (const page of pages) {
+          yield mcp.callChromeDevTool("select_page", { pageId: page.pageId, bringToFront: false });
+          const evalResult = yield mcp.callChromeDevTool("evaluate_script", {
+            function: "() => sessionStorage.getItem('_opencode_pk')"
+          });
+          const rawText = (_g = (_f = (_e = evalResult == null ? void 0 : evalResult.result) == null ? void 0 : _e.content) == null ? void 0 : _f[0]) == null ? void 0 : _g.text;
+          const extracted = extractEvalValue(rawText);
+          if (extracted === sessionId) {
+            matchedPageId = page.pageId;
+            break;
+          }
+        }
+        if (chromeSelectedPageId != null && chromeSelectedPageId !== matchedPageId) {
+          yield mcp.callChromeDevTool("select_page", {
+            pageId: chromeSelectedPageId,
+            bringToFront: false
+          });
+        }
+        if (matchedPageId != null) {
+          return { ok: true, pageId: matchedPageId };
+        }
+        return {
+          ok: false,
+          error: `\u672A\u80FD\u901A\u8FC7\u4F1A\u8BDD\u6807\u8BC6\u627E\u5230\u76EE\u6807\u9875\u9762\uFF0C\u8BF7\u786E\u8BA4\u76EE\u6807\u9875\u9762\u5DF2\u6253\u5F00`
+        };
+      }
+      const matches = pages.filter((p) => normalizeUrl(p.url) === targetUrl);
+      if (matches.length === 0) {
+        return {
+          ok: false,
+          error: `Chrome \u4E2D\u672A\u627E\u5230\u5339\u914D\u7684\u9875\u9762 (${targetUrl})\uFF0C\u8BF7\u786E\u8BA4\u672C\u5730\u5F00\u53D1\u9875\u9762\u5DF2\u5728 Chrome DevTools \u4E2D\u6253\u5F00`
+        };
+      }
+      if (matches.length === 1) {
+        log.debug("resolveChromePageId: URL matched", { pageId: matches[0].pageId });
+        return { ok: true, pageId: matches[0].pageId };
+      }
+      return {
+        ok: false,
+        error: `\u5B58\u5728 ${matches.length} \u4E2A\u540C URL \u7684\u9875\u9762\uFF0C\u7F3A\u5C11\u9875\u9762\u6807\u8BC6\u65E0\u6CD5\u533A\u5206\uFF0C\u8BF7\u5237\u65B0\u9875\u9762\u540E\u91CD\u8BD5`
+      };
+    } catch (err) {
+      const msg = `MCP \u8C03\u7528\u5931\u8D25: ${err.message}`;
+      log.debug("Failed to resolve pageId via MCP", { error: err.message });
+      return { ok: false, error: msg };
+    }
+  });
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  extractEvalValue,
+  getProjectOrigins,
+  isProjectPage,
+  parseListPages,
+  resolveChromePageId
+});

package/lib/core/mcp-chrome.d.ts

@@ -0,0 +1,43 @@
+/**
+ * MCP Chrome 页面相关工具
+ *
+ * 专注于 Chrome DevTools 页面匹配与解析逻辑
+ */
+import type { ViteDevServer } from "vite";
+import type { McpProxy } from "./mcp-proxy";
+/** 从 Vite 服务器解析的所有 URL 中提取项目 origin 列表 */
+export declare function getProjectOrigins(server: ViteDevServer): string[];
+/** 判断页面 URL 是否属于项目的某个 origin */
+export declare function isProjectPage(url: string, origins: string[]): boolean;
+export interface PageInfo {
+    pageId: number;
+    url: string;
+    title: string;
+    /** Chrome DevTools 当前选中的页面 */
+    selected: boolean;
+}
+/** 解析 list_pages 返回的文本。格式："56: Title (URL) [selected]" */
+export declare function parseListPages(text: string): PageInfo[];
+/** 从 evaluate_script 返回的格式化文本中提取 JSON 值 */
+export declare function extractEvalValue(text: string | undefined): string | undefined;
+type PageIdResult = {
+    ok: true;
+    pageId: number;
+} | {
+    ok: false;
+    error: string;
+};
+/**
+ * 通过 MCP 解析当前页面对应的 Chrome DevTools pageId
+ *
+ * 策略：
+ * 1. list_pages → 解析每行的 "pageId: title (URL)" 格式
+ * 2. 优先用 sessionId 匹配（跨导航可靠，遍历所有页面 evaluate_script）
+ * 3. 无 sessionId 时降级为 URL 精确匹配
+ *
+ * 失败时返回具体原因，由调用方透传给 Agent。
+ */
+export declare function resolveChromePageId(mcp: McpProxy | undefined, url: string, title: string, projectOrigins: string[], sessionId?: string, pages?: PageInfo[], 
+/** Chrome 当前选中的 pageId（调用方传入，避免过滤后丢失非项目页面信息） */
+chromeSelectedPageId?: number): Promise<PageIdResult>;
+export {};