vite-plugin-opencode-assistant 1.1.25 → 1.1.26

package/es/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 {};

package/es/core/mcp-chrome.mjs

@@ -0,0 +1,147 @@
+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());
+  });
+};
+import { createLogger } from "@vite-plugin-opencode-assistant/shared/node";
+const log = 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 };
+    }
+  });
+}
+export {
+  extractEvalValue,
+  getProjectOrigins,
+  isProjectPage,
+  parseListPages,
+  resolveChromePageId
+};

package/es/endpoints/context.d.ts

@@ -1,38 +1,3 @@
 import type { ViteDevServer } from "vite";
-import type { McpProxy } from "../core/mcp-proxy";
 import type { EndpointContext } from "./types";
-/** 从页面 URL 提取项目 origin（protocol + host + port） */
-export declare function getProjectOrigin(pageUrl: string): string | null;
-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, sessionId?: string, pages?: PageInfo[], 
-/** Chrome 当前选中的 pageId（调用方传入，避免过滤后丢失非项目页面信息） */
-chromeSelectedPageId?: number): Promise<PageIdResult>;
 export declare function setupContextEndpoint(server: ViteDevServer, ctx: EndpointContext): void;
-export {};

package/es/endpoints/context.mjs

@@ -21,121 +21,6 @@ var __async = (__this, __arguments, generator) => {
 import { CONTEXT_API_PATH } from "@vite-plugin-opencode-assistant/shared";
 import { RequestContext, createLogger } from "@vite-plugin-opencode-assistant/shared/node";
 const log = createLogger("Endpoints:Context");
-function getProjectOrigin(pageUrl) {
-  try {
-    return new URL(pageUrl).origin;
-  } catch (e) {
-    return null;
-  }
-}
-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, 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;
-        const projectOrigin = getProjectOrigin(url);
-        pages = projectOrigin ? allPages.filter((p) => p.url.startsWith(projectOrigin)) : allPages;
-      }
-      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 };
-    }
-  });
-}
 function setupContextEndpoint(server, ctx) {
   server.middlewares.use(CONTEXT_API_PATH, (req, res) => __async(null, null, function* () {
     const reqCtx = new RequestContext(req.method || "GET", CONTEXT_API_PATH);
@@ -241,9 +126,5 @@ function setupContextEndpoint(server, ctx) {
   }));
 }
 export {
-  extractEvalValue,
-  getProjectOrigin,
-  parseListPages,
-  resolveChromePageId,
   setupContextEndpoint
 };

package/es/endpoints/mcp-tools.d.ts

@@ -1,6 +1,7 @@
 /**
  * 自定义 DevTools 工具定义
- * 所有工具自动映射到 chrome-devtools-mcp 底层工具
+ * 所有工具（除 devtools_list_pages）必须传入 pageId 参数，
+ * 代理层校验 pageId 是否为项目页面后方可调用 chrome-devtools-mcp。
  */
 export interface CustomTool {
     name: string;