vite-plugin-aipanel 1.2.9 → 1.2.11

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

@@ -1,8 +1,13 @@
 /**
- * 自定义 DevTools 工具定义
- * 所有工具（除 chrome-devtools_list_pages）必须传入 pageId 参数，
- * 代理层校验 pageId 是否为项目页面后方可调用 chrome-devtools-mcp。
+ * Chrome DevTools 工具层的项目维度元数据与自定义工具。
+ *
+ * 模型可见的 chrome-devtools_* 工具 = 官方 chrome-devtools-mcp 工具的白名单子集
+ * （schema/描述运行时同步自官方 tools/list，见 official-tools.ts）+ 本项目自定义工具。
+ * 工具层限制（白名单、必填 pageId、仅项目页）由本文件 + endpoints/mcp.ts 的 tools/call 共同执行。
  */
+/** 模型可见名前缀：官方短名 → chrome-devtools_<name> */
+export declare const MCP_PREFIX = "chrome-devtools_";
+export declare function displayToolName(short: string): string;
 export interface CustomTool {
     name: string;
     description: string;
@@ -12,4 +17,50 @@ export interface CustomTool {
         required?: string[];
     };
 }
+/**
+ * 默认暴露的官方页面级工具 = 元数据规则推导（pageScoped && 无条件 && 分类安全），
+ * 具体由 officialDefaultShorts() 给出。
+ * 以下为 meta 无法从 pageScoped 推断、需要“按页面上下文使用/列表/新建”的产品全局特例（短名）。
+ */
+export declare const OFFICIAL_GLOBAL_POLICY: readonly ["evaluate_script", "list_console_messages", "list_pages", "new_page"];
+export type OfficialToolShortName = string;
+/** 不需要 pageId 的官方工具（无目标页，由调用层特别处理） */
+export declare const OFFICIAL_NO_PAGE_TOOLS: ReadonlySet<string>;
+/** 目标页参数：pageId 必须在可操作范围（项目页或 allowOrigins 白名单页）内 */
+export declare const PAGE_ID_PROP: {
+    readonly pageId: {
+        readonly type: "number";
+        readonly description: "The ID of a page within the operation scope (project pages or chromeMcp.project.allowOrigins pages) to operate on";
+    };
+};
+/** 往官方 schema 上统一追加必填 pageId（保持工具层项目限制） */
+export declare function withPageIdSchema(schema: CustomTool["inputSchema"]): CustomTool["inputSchema"];
+/**
+ * 追加到官方描述末尾的项目维度说明（英文，按工具特例）。
+ * 只填“调用层真正实现的语义与官方不一样”的工具，
+ * 避免描述过度承诺（如 navigate_page 目标 URL 未被调用层限制，不填“必须在项目内”）。
+ * 其余页面级工具的项目边界由必填 pageId 参数说明表达（PAGE_ID_PROP）。
+ */
+export declare const PROJECT_DESCRIPTION_NOTES: Record<string, string>;
+/** 自定义工具（官方无对应，工具层本地实现） */
 export declare const CUSTOM_TOOLS: CustomTool[];
+/** 官方声明了条件、且属于可开启范围的工具（由官方元数据派生，无手写） */
+export declare function isOfficialExtraTool(short: string): boolean;
+/** 由官方 conditions 推导所需 flag（experimentalX → --experimental-x，与官方 CLI 一致） */
+export declare function extraToolFlag(short: string): string | undefined;
+/** 可开启的二级工具名单（用于验证与提示） */
+export declare function officialExtraCandidates(): string[];
+/**
+ * 默认暴露的官方工具集：
+ * 页面级（pageScoped && 无 conditions && 分类安全）由官方元数据规则推导 + 全局特例 GLOBAL_POLICY。
+ */
+export declare function officialDefaultShorts(): string[];
+/** 配置工具面范围（默认为纯白名单） */
+export declare function configureToolScope(extra?: readonly string[], deny?: readonly string[], warn?: (msg: string) => void): void;
+/**
+ * 当前生效的官方白名单（短名，含 extra 减 deny）。
+ * deny 同时作用于默认面与 extra，保证 tools/list 暴露面与 isAllowedToolName 调用守卫一致。
+ */
+export declare function currentOfficialShorts(): string[];
+/** tools/call 白名单守卫（含 current_page 与动态 extra/deny） */
+export declare function isAllowedToolName(name: string): boolean;

package/lib/core/official-meta.cjs

@@ -0,0 +1,85 @@
+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 official_meta_exports = {};
+__export(official_meta_exports, {
+  OFFICIAL_TOOL_META: () => OFFICIAL_TOOL_META
+});
+module.exports = __toCommonJS(official_meta_exports);
+const OFFICIAL_TOOL_META = [
+  { name: "click", category: "INPUT", readOnlyHint: false, pageScoped: true, conditions: [] },
+  { name: "click_at", category: "INPUT", readOnlyHint: false, pageScoped: true, conditions: ["experimentalVision"] },
+  { name: "close_heapsnapshot", category: "MEMORY", readOnlyHint: false, pageScoped: false, conditions: ["memoryDebugging"] },
+  { name: "close_page", category: "NAVIGATION", readOnlyHint: false, pageScoped: false, conditions: [] },
+  { name: "compare_heapsnapshots", category: "MEMORY", readOnlyHint: true, pageScoped: false, conditions: ["memoryDebugging"] },
+  { name: "drag", category: "INPUT", readOnlyHint: false, pageScoped: true, conditions: [] },
+  { name: "emulate", category: "EMULATION", readOnlyHint: false, pageScoped: true, conditions: [] },
+  { name: "evaluate_script", category: "DEBUGGING", readOnlyHint: false, pageScoped: false, conditions: [] },
+  { name: "execute_3p_developer_tool", category: "THIRD_PARTY", readOnlyHint: false, pageScoped: true, conditions: [] },
+  { name: "execute_webmcp_tool", category: "WEBMCP", readOnlyHint: false, pageScoped: true, conditions: [] },
+  { name: "fill", category: "INPUT", readOnlyHint: false, pageScoped: true, conditions: [] },
+  { name: "fill_form", category: "INPUT", readOnlyHint: false, pageScoped: true, conditions: [] },
+  { name: "get_console_message", category: "DEBUGGING", readOnlyHint: true, pageScoped: true, conditions: [] },
+  { name: "get_heapsnapshot_class_nodes", category: "MEMORY", readOnlyHint: true, pageScoped: false, conditions: ["memoryDebugging"] },
+  { name: "get_heapsnapshot_details", category: "MEMORY", readOnlyHint: true, pageScoped: false, conditions: ["memoryDebugging"] },
+  { name: "get_heapsnapshot_dominators", category: "MEMORY", readOnlyHint: true, pageScoped: false, conditions: ["memoryDebugging"] },
+  { name: "get_heapsnapshot_duplicate_strings", category: "MEMORY", readOnlyHint: true, pageScoped: false, conditions: ["memoryDebugging"] },
+  { name: "get_heapsnapshot_edges", category: "MEMORY", readOnlyHint: true, pageScoped: false, conditions: ["memoryDebugging"] },
+  { name: "get_heapsnapshot_object_details", category: "MEMORY", readOnlyHint: true, pageScoped: false, conditions: ["memoryDebugging"] },
+  { name: "get_heapsnapshot_retainers", category: "MEMORY", readOnlyHint: true, pageScoped: false, conditions: ["memoryDebugging"] },
+  { name: "get_heapsnapshot_retaining_paths", category: "MEMORY", readOnlyHint: true, pageScoped: false, conditions: ["memoryDebugging"] },
+  { name: "get_heapsnapshot_summary", category: "MEMORY", readOnlyHint: true, pageScoped: false, conditions: ["memoryDebugging"] },
+  { name: "get_network_request", category: "NETWORK", readOnlyHint: false, pageScoped: true, conditions: [] },
+  { name: "get_os_app_state", category: "PWA", readOnlyHint: true, pageScoped: false, conditions: [] },
+  { name: "get_tab_id", category: "NAVIGATION", readOnlyHint: true, pageScoped: true, conditions: ["experimentalInteropTools"] },
+  { name: "handle_dialog", category: "INPUT", readOnlyHint: false, pageScoped: true, conditions: [] },
+  { name: "hover", category: "INPUT", readOnlyHint: false, pageScoped: true, conditions: [] },
+  { name: "install_extension", category: "EXTENSIONS", readOnlyHint: false, pageScoped: false, conditions: [] },
+  { name: "install_pwa", category: "PWA", readOnlyHint: false, pageScoped: false, conditions: [] },
+  { name: "launch_pwa", category: "PWA", readOnlyHint: false, pageScoped: false, conditions: [] },
+  { name: "lighthouse_audit", category: "DEBUGGING", readOnlyHint: false, pageScoped: true, conditions: [] },
+  { name: "list_3p_developer_tools", category: "THIRD_PARTY", readOnlyHint: true, pageScoped: true, conditions: [] },
+  { name: "list_extensions", category: "EXTENSIONS", readOnlyHint: true, pageScoped: false, conditions: [] },
+  { name: "list_network_requests", category: "NETWORK", readOnlyHint: true, pageScoped: true, conditions: [] },
+  { name: "list_pages", category: "NAVIGATION", readOnlyHint: true, pageScoped: false, conditions: [] },
+  { name: "list_webmcp_tools", category: "WEBMCP", readOnlyHint: true, pageScoped: true, conditions: [] },
+  { name: "navigate_page", category: "NAVIGATION", readOnlyHint: false, pageScoped: true, conditions: [] },
+  { name: "new_page", category: "NAVIGATION", readOnlyHint: false, pageScoped: false, conditions: [] },
+  { name: "performance_analyze_insight", category: "PERFORMANCE", readOnlyHint: true, pageScoped: true, conditions: [] },
+  { name: "performance_start_trace", category: "PERFORMANCE", readOnlyHint: false, pageScoped: true, conditions: [] },
+  { name: "performance_stop_trace", category: "PERFORMANCE", readOnlyHint: false, pageScoped: true, conditions: [] },
+  { name: "press_key", category: "INPUT", readOnlyHint: false, pageScoped: true, conditions: [] },
+  { name: "query_heapsnapshot_objects", category: "MEMORY", readOnlyHint: true, pageScoped: false, conditions: ["memoryDebugging"] },
+  { name: "reload_extension", category: "EXTENSIONS", readOnlyHint: false, pageScoped: false, conditions: [] },
+  { name: "resize_page", category: "EMULATION", readOnlyHint: false, pageScoped: true, conditions: [] },
+  { name: "screencast_start", category: "DEBUGGING", readOnlyHint: false, pageScoped: true, conditions: ["experimentalScreencast"] },
+  { name: "screencast_stop", category: "DEBUGGING", readOnlyHint: false, pageScoped: true, conditions: ["experimentalScreencast"] },
+  { name: "select_page", category: "NAVIGATION", readOnlyHint: true, pageScoped: false, conditions: [] },
+  { name: "take_heapsnapshot", category: "MEMORY", readOnlyHint: false, pageScoped: true, conditions: [] },
+  { name: "take_screenshot", category: "DEBUGGING", readOnlyHint: false, pageScoped: true, conditions: [] },
+  { name: "take_snapshot", category: "DEBUGGING", readOnlyHint: false, pageScoped: true, conditions: [] },
+  { name: "trigger_extension_action", category: "EXTENSIONS", readOnlyHint: false, pageScoped: false, conditions: [] },
+  { name: "type_text", category: "INPUT", readOnlyHint: false, pageScoped: true, conditions: [] },
+  { name: "uninstall_extension", category: "EXTENSIONS", readOnlyHint: false, pageScoped: false, conditions: [] },
+  { name: "uninstall_pwa", category: "PWA", readOnlyHint: false, pageScoped: false, conditions: [] },
+  { name: "upload_file", category: "INPUT", readOnlyHint: false, pageScoped: true, conditions: [] },
+  { name: "wait_for", category: "NAVIGATION", readOnlyHint: true, pageScoped: true, conditions: [] }
+];
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  OFFICIAL_TOOL_META
+});

package/lib/core/official-meta.d.ts

@@ -0,0 +1,9 @@
+/** AUTO-GENERATED by packages/vite/scripts/sync-official-meta.mjs (build) — 不手改；升级 chrome-devtools-mcp 后重跑构建即可。 */
+export interface OfficialToolMeta {
+    name: string;
+    category: "INPUT" | "NAVIGATION" | "EMULATION" | "PERFORMANCE" | "NETWORK" | "DEBUGGING" | "EXTENSIONS" | "THIRD_PARTY" | "MEMORY" | "WEBMCP" | "PWA" | "";
+    readOnlyHint: boolean;
+    pageScoped: boolean;
+    conditions: string[];
+}
+export declare const OFFICIAL_TOOL_META: OfficialToolMeta[];

package/lib/core/official-tools.cjs

@@ -0,0 +1,70 @@
+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 official_tools_exports = {};
+__export(official_tools_exports, {
+  getOfficialProjectTools: () => getOfficialProjectTools
+});
+module.exports = __toCommonJS(official_tools_exports);
+var import_node = require("@aipanel/core/node");
+var import_mcp_tools = require("./mcp-tools.cjs");
+const log = (0, import_node.createLogger)("OfficialChromeTools");
+let cached = null;
+async function fetchOfficialEntries(mcp) {
+  const res = await mcp.call("tools/list", {});
+  const map = /* @__PURE__ */ new Map();
+  for (const t of res?.result?.tools ?? []) {
+    const raw = String(t?.name ?? "");
+    const short = raw.startsWith(import_mcp_tools.MCP_PREFIX) ? raw.slice(import_mcp_tools.MCP_PREFIX.length) : raw;
+    if (!short) continue;
+    const schema = t?.inputSchema ?? { type: "object", properties: {} };
+    map.set(short, { short, description: String(t?.description ?? ""), schema });
+  }
+  return map;
+}
+function ensureOfficialEntries(mcp) {
+  if (!cached) {
+    cached = fetchOfficialEntries(mcp).catch((e) => {
+      cached = null;
+      log.warn("Failed to fetch official chrome-devtools-mcp tools", {
+        error: e instanceof Error ? e.message : String(e)
+      });
+      throw e;
+    });
+  }
+  return cached;
+}
+async function getOfficialProjectTools(mcp) {
+  const map = await ensureOfficialEntries(mcp);
+  const tools = [];
+  for (const short of (0, import_mcp_tools.currentOfficialShorts)()) {
+    const entry = map.get(short);
+    if (!entry) {
+      log.warn("Requested official tool missing from server tools/list (skip)", { short });
+      continue;
+    }
+    const schema = import_mcp_tools.OFFICIAL_NO_PAGE_TOOLS.has(short) ? entry.schema : (0, import_mcp_tools.withPageIdSchema)(entry.schema);
+    const note = import_mcp_tools.PROJECT_DESCRIPTION_NOTES[short];
+    const description = note ? entry.description ? `${entry.description} ${note}` : note : entry.description;
+    tools.push({ name: (0, import_mcp_tools.displayToolName)(short), description, inputSchema: schema });
+  }
+  return tools;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  getOfficialProjectTools
+});

package/lib/core/official-tools.d.ts

@@ -0,0 +1,7 @@
+import { type CustomTool } from "./mcp-tools";
+import type { McpProxy } from "./mcp-proxy";
+/**
+ * 项目白名单的官方工具集（英文 schema/描述，已追加 pageId）。
+ * 官方当前版本缺失某名时跳过（名称跟随官方，不本地复制）。
+ */
+export declare function getOfficialProjectTools(mcp: McpProxy): Promise<CustomTool[]>;

package/lib/core/service.cjs

@@ -25,7 +25,6 @@ module.exports = __toCommonJS(service_exports);
 var import_node_crypto = require("node:crypto");
 var import_core = require("@aipanel/core");
 var import_node = require("@aipanel/core/node");
-var import_system = require("../utils/system.cjs");
 var import_proxy_server = require("./proxy-server.cjs");
 const log = (0, import_node.createLogger)("Service");
 class AIPanelService {
@@ -64,7 +63,7 @@ class AIPanelService {
     this.currentTask = { task, ...data };
     this.sseClients.forEach((client) => {
       try {
-        client.write(`data: ${JSON.stringify({ type: "TASK_UPDATE", task, ...data })}
+        client.write(`data: ${JSON.stringify({ type: import_core.SSE_EVENT_TYPES.TASK_UPDATE, task, ...data })}
 
 `);
       } catch (e) {
@@ -119,7 +118,7 @@ class AIPanelService {
         log.debug(`Using port ${this.actualWebPort}`);
       }
       timer.checkpoint("Port allocated");
-      this.workspaceRoot = (0, import_system.findGitRoot)(process.cwd());
+      this.workspaceRoot = (0, import_node.findGitRoot)(process.cwd());
       log.debug(`Using workspace root: ${this.workspaceRoot}`);
       this.sendTaskUpdate("preparing_runtime");
       this.sendTaskUpdate("starting_web");
@@ -145,7 +144,7 @@ class AIPanelService {
         webAuthCookie = startResult.webAuthCookie;
         log.debug(`Waiting for Web UI to become ready at ${webUrl}...`);
         this.sendTaskUpdate("waiting_web_ready");
-        await (0, import_system.waitForServer)(webUrl, import_core.SERVER_START_TIMEOUT, this.webProcess ?? void 0);
+        await (0, import_node.waitForServer)(webUrl, import_core.SERVER_START_TIMEOUT, this.webProcess ?? void 0);
         if (this.webProcess?.exitCode !== null && this.webProcess?.exitCode !== void 0) {
           throw new Error(`Web process exited with code ${this.webProcess.exitCode}`);
         }
@@ -251,7 +250,7 @@ class AIPanelService {
   pushProviderEvent(event) {
     this.sseClients.forEach((client) => {
       try {
-        client.write(`data: ${JSON.stringify({ type: "SESSION_EVENT", event })}
+        client.write(`data: ${JSON.stringify({ type: import_core.SSE_EVENT_TYPES.SESSION_EVENT, event })}
 
 `);
       } catch (e) {

package/lib/endpoints/context.cjs

@@ -50,7 +50,7 @@ function setupContextEndpoint(server, ctx) {
       let sentCount = 0;
       ctx.sseClients.forEach((client) => {
         try {
-          client.write(`data: ${JSON.stringify({ type: "CLEAR_ELEMENTS" })}
+          client.write(`data: ${JSON.stringify({ type: import_core.SSE_EVENT_TYPES.CLEAR_ELEMENTS })}
 
 `);
           sentCount++;

package/lib/endpoints/host-events.cjs

@@ -22,7 +22,6 @@ __export(host_events_exports, {
 module.exports = __toCommonJS(host_events_exports);
 var import_core = require("@aipanel/core");
 var import_node = require("@aipanel/core/node");
-const log = (0, import_node.createLogger)("Endpoints:HostEvents");
 function setupHostEventsEndpoint(server, ctx) {
   server.middlewares.use(import_core.HOST_EVENTS_API_PATH, async (req, res) => {
     const reqCtx = new import_node.RequestContext(req.method || "GET", import_core.HOST_EVENTS_API_PATH);
@@ -84,7 +83,7 @@ function setupHostEventsEndpoint(server, ctx) {
 function isProviderEvent(value) {
   if (typeof value !== "object" || value === null) return false;
   const v = value;
-  if (v.type === "session.status" || v.type === "thinking") {
+  if (v.type === "session.status" || v.type === "thinking" || v.type === "session.pending" || v.type === "session.subagents") {
     return typeof v.sessionId === "string" && v.sessionId.length > 0;
   }
   if (v.type === "session.updated") {

package/lib/endpoints/index.cjs

@@ -36,7 +36,7 @@ var import_mcp = require("./mcp.cjs");
 var import_vue_devtools = require("./vue-devtools.cjs");
 var import_core = require("@aipanel/core");
 __reExport(endpoints_exports, require("./types.cjs"), module.exports);
-function setupMiddlewares(server, ctx, mcp, logFiles) {
+function setupMiddlewares(server, ctx, mcp, logFiles, chromeProject) {
   (0, import_widget.setupWidgetEndpoints)(server, ctx);
   (0, import_context.setupContextEndpoint)(server, ctx);
   (0, import_start.setupStartEndpoint)(server, ctx);
@@ -46,7 +46,7 @@ function setupMiddlewares(server, ctx, mcp, logFiles) {
   (0, import_warmup.setupWarmupEndpoint)(server, ctx);
   (0, import_logs.setupLogsEndpoint)(server);
   if (mcp) {
-    (0, import_mcp.setupMcpEndpoint)(server, mcp, () => ctx.getPageContext(), logFiles ?? []);
+    (0, import_mcp.setupMcpEndpoint)(server, mcp, () => ctx.getPageContext(), logFiles ?? [], chromeProject);
     (0, import_vue_devtools.setupVueDevtoolsEndpoint)(server, mcp);
   }
 }

package/lib/endpoints/index.d.ts

@@ -3,7 +3,7 @@ import type { EndpointContext } from "./types";
 import { MCP_API_PATH } from "./mcp";
 import { VUE_DEVTOOLS_API_PATH } from "./vue-devtools";
 import type { McpProxy } from "../core/mcp-proxy";
-import { LOGS_API_PATH, type LogFileConfig } from "@aipanel/core";
+import { LOGS_API_PATH, type ChromeProjectOptions, type LogFileConfig } from "@aipanel/core";
 export * from "./types";
 export { LOGS_API_PATH, MCP_API_PATH, VUE_DEVTOOLS_API_PATH };
-export declare function setupMiddlewares(server: ViteDevServer, ctx: EndpointContext, mcp?: McpProxy, logFiles?: LogFileConfig[]): void;
+export declare function setupMiddlewares(server: ViteDevServer, ctx: EndpointContext, mcp?: McpProxy, logFiles?: LogFileConfig[], chromeProject?: ChromeProjectOptions): void;