@aipanel/core 1.2.9 → 1.2.10

package/es/node/node-utils.mjs

@@ -1,6 +1,15 @@
+import { spawn } from "node:child_process";
 import { createRequire } from "node:module";
+import fs from "node:fs";
+import http from "node:http";
 import path from "node:path";
-import { CHROME_DEVTOOLS_PORT, CHROME_DEVTOOLS_CHECK_TIMEOUT } from "../common/constants.mjs";
+import {
+  CHROME_DEVTOOLS_PORT,
+  CHROME_DEVTOOLS_CHECK_TIMEOUT,
+  SERVER_CHECK_INTERVAL
+} from "../common/constants.mjs";
+import { PerformanceTimer, createLogger } from "./node-logger.mjs";
+const log = createLogger("NodeUtils");
 function createPackageRequire(baseDir = process.cwd()) {
   return createRequire(path.join(baseDir, "package.json"));
 }
@@ -47,10 +56,236 @@ async function findAvailablePort(startPort, hostname, maxTries = 100) {
   }
   throw new Error(`No available port in range ${startPort}-${startPort + maxTries}`);
 }
+function waitForServer(url, timeout = 1e4, proc) {
+  const timer = new PerformanceTimer("waitForServer", { url, timeout });
+  return new Promise((resolve, reject) => {
+    const startTime = Date.now();
+    let attempts = 0;
+    const check = () => {
+      attempts++;
+      log.debug(`Checking server availability (attempt ${attempts})`, { url });
+      if (proc?.exitCode !== null && proc?.exitCode !== void 0) {
+        timer.end(`\u2716 Process exited with code ${proc.exitCode}`);
+        reject(new Error(`Process exited with code ${proc.exitCode}`));
+        return;
+      }
+      const req = http.get(url, (res) => {
+        if (res.statusCode && res.statusCode < 500) {
+          timer.end(`\u2713 Server ready after ${attempts} attempts`);
+          resolve();
+        } else {
+          log.debug(`Server returned status ${res.statusCode}, retrying...`);
+          retryOrReject();
+        }
+      });
+      req.on("error", (err) => {
+        log.debug(`Server check failed: ${err.message}`);
+        retryOrReject();
+      });
+    };
+    const retryOrReject = () => {
+      const elapsed = Date.now() - startTime;
+      if (elapsed < timeout) {
+        setTimeout(check, SERVER_CHECK_INTERVAL);
+      } else {
+        timer.end("\u2716 Timeout");
+        reject(new Error(`Server not ready after ${timeout}ms (${attempts} attempts)`));
+      }
+    };
+    check();
+  });
+}
+function findGitRoot(startDir, maxDepth = 10) {
+  const timer = new PerformanceTimer("findGitRoot", { startDir, maxDepth });
+  let currentDir = startDir;
+  let depth = 0;
+  while (depth < maxDepth) {
+    const gitDir = path.join(currentDir, ".git");
+    try {
+      if (fs.existsSync(gitDir)) {
+        timer.end(`\u2713 Found git root at depth ${depth}: ${currentDir}`);
+        return currentDir;
+      }
+    } catch (err) {
+      log.debug(`Error checking .git directory at ${currentDir}`, {
+        error: err.message
+      });
+    }
+    const parentDir = path.dirname(currentDir);
+    if (parentDir === currentDir) {
+      log.debug("Reached filesystem root");
+      break;
+    }
+    currentDir = parentDir;
+    depth++;
+  }
+  timer.end(`\u2716 No git root found after ${depth} levels, using start directory`);
+  return startDir;
+}
+async function checkCliInstalled(bin) {
+  const timer = new PerformanceTimer(`checkCliInstalled:${bin}`);
+  return new Promise((resolve) => {
+    const proc = spawn(bin, ["--version"], { stdio: "ignore", shell: true });
+    proc.on("close", (code) => {
+      const installed = code === 0;
+      timer.end(installed ? `\u2713 ${bin} is installed` : `\u2716 ${bin} not found`);
+      resolve(installed);
+    });
+    proc.on("error", (err) => {
+      log.debug(`Failed to check ${bin} installation`, { error: err.message });
+      timer.end("\u2716 Check failed");
+      resolve(false);
+    });
+  });
+}
+function getCliVersion(bin) {
+  return new Promise((resolve) => {
+    const proc = spawn(bin, ["--version"], { stdio: "pipe", shell: true });
+    let output = "";
+    proc.stdout?.on("data", (data) => {
+      output += data.toString();
+    });
+    proc.on("close", (code) => {
+      resolve(code === 0 && output.trim() ? output.trim() : null);
+    });
+    proc.on("error", () => resolve(null));
+  });
+}
+function killOrphanCliProcesses(bin, options) {
+  const label = options.label ?? bin;
+  const timeoutMs = options.timeout ?? 5e3;
+  const timer = new PerformanceTimer(`killOrphanCliProcesses:${label}`);
+  log.debug(`Looking for orphan ${label} processes (PPID=1)`);
+  return new Promise((resolve) => {
+    let settled = false;
+    const done = (count) => {
+      if (!settled) {
+        settled = true;
+        resolve(count);
+      }
+    };
+    const timeout = setTimeout(() => {
+      log.warn(`Kill orphan ${label} processes timed out, skipping`);
+      timer.end("\u26A0 Timeout, skipped");
+      done(0);
+    }, timeoutMs);
+    const wrappedResolve = (count) => {
+      clearTimeout(timeout);
+      done(count);
+    };
+    if (process.platform === "win32") {
+      killOrphansOnWindows(wrappedResolve, options, label, timer);
+    } else {
+      killOrphansOnUnix(wrappedResolve, options, label, timer);
+    }
+  });
+}
+function killOrphansOnWindows(resolve, options, label, timer) {
+  log.debug(`Using Windows method to find orphan ${label} processes`);
+  const proc = spawn(
+    "wmic",
+    ["process", "where", `name="${options.winName}"`, "get", "processid,parentprocessid,commandline"],
+    { stdio: "pipe" }
+  );
+  let output = "";
+  proc.stdout?.on("data", (data) => {
+    output += data.toString();
+  });
+  proc.on("close", () => {
+    const pidsToKill = [];
+    output.split("\n").forEach((rawLine) => {
+      const line = rawLine.trim();
+      if (!line.includes(options.match)) return;
+      const parts = line.split(/\s+/);
+      if (parts.length >= 3) {
+        const ppid = parts[0];
+        const pid = parts[1];
+        if (ppid === "1" && pid && !Number.isNaN(Number(pid))) pidsToKill.push(pid);
+      }
+    });
+    finishOrphanKillWindows(pidsToKill, resolve, label, timer);
+  });
+  proc.on("error", (err) => {
+    log.debug(`Failed to find orphan ${label} processes`, { error: err.message });
+    timer.end("\u2716 Failed to find orphan processes");
+    resolve(0);
+  });
+}
+function finishOrphanKillWindows(pidsToKill, resolve, label, timer) {
+  if (pidsToKill.length === 0) {
+    log.debug("No orphan processes found");
+    timer.end("No orphan processes found");
+    resolve(0);
+    return;
+  }
+  log.debug(`Found ${pidsToKill.length} orphan processes`, { pids: pidsToKill });
+  let killedCount = 0;
+  let completedCount = 0;
+  pidsToKill.forEach((pid) => {
+    const killProc = spawn("taskkill", ["/F", "/PID", pid], { stdio: "ignore" });
+    killProc.on("close", (code) => {
+      completedCount++;
+      if (code === 0) killedCount++;
+      if (completedCount === pidsToKill.length) {
+        timer.end(`\u2713 Killed ${killedCount} orphan ${label} processes`);
+        resolve(killedCount);
+      }
+    });
+  });
+}
+function killOrphansOnUnix(resolve, options, label, timer) {
+  log.debug(`Using Unix method to find orphan ${label} processes`);
+  const proc = spawn("ps", ["-e", "-o", "pid,ppid,args"], { stdio: "pipe" });
+  let output = "";
+  proc.stdout?.on("data", (data) => {
+    output += data.toString();
+  });
+  proc.on("close", () => {
+    const pidsToKill = [];
+    output.split("\n").forEach((line) => {
+      if (!line.includes(options.match)) return;
+      const parts = line.trim().split(/\s+/);
+      if (parts.length >= 3) {
+        const pid = parts[0];
+        const ppid = parts[1];
+        if (ppid === "1" && pid && !Number.isNaN(Number(pid))) pidsToKill.push(pid);
+      }
+    });
+    if (pidsToKill.length === 0) {
+      log.debug("No orphan processes found");
+      timer.end("No orphan processes found");
+      resolve(0);
+      return;
+    }
+    log.debug(`Found ${pidsToKill.length} orphan processes`, { pids: pidsToKill });
+    const killProc = spawn("kill", ["-9", ...pidsToKill], { stdio: "ignore" });
+    killProc.on("close", (code) => {
+      const killedCount = code === 0 ? pidsToKill.length : 0;
+      timer.end(
+        killedCount > 0 ? `\u2713 Killed ${killedCount} orphan ${label} processes` : "\u2716 Failed to kill processes"
+      );
+      resolve(killedCount);
+    });
+    killProc.on("error", () => {
+      timer.end("\u2716 Failed to kill processes");
+      resolve(0);
+    });
+  });
+  proc.on("error", (err) => {
+    log.debug(`Failed to find orphan ${label} processes`, { error: err.message });
+    timer.end("\u2716 Failed to find orphan processes");
+    resolve(0);
+  });
+}
 export {
   checkChromeDevToolsAvailable,
+  checkCliInstalled,
   createPackageRequire,
   findAvailablePort,
+  findGitRoot,
+  getCliVersion,
   isPortAvailable,
-  resolvePackageDir
+  killOrphanCliProcesses,
+  resolvePackageDir,
+  waitForServer
 };

package/lib/client/logger.cjs

@@ -23,13 +23,6 @@ __export(logger_exports, {
 module.exports = __toCommonJS(logger_exports);
 var import_constants = require("../common/constants.cjs");
 var import_logger_core = require("../common/logger-core.cjs");
-const LEVEL_NAMES = {
-  [import_logger_core.LogLevel.DEBUG]: "DEBUG",
-  [import_logger_core.LogLevel.INFO]: "INFO ",
-  [import_logger_core.LogLevel.WARN]: "WARN ",
-  [import_logger_core.LogLevel.ERROR]: "ERROR",
-  [import_logger_core.LogLevel.NONE]: "NONE "
-};
 const C = {
   dim: "color: #888",
   bright: "font-weight: bold",
@@ -56,7 +49,7 @@ function log(level, message, context, ...args) {
     segments.push("%c%s");
     styles.push(C.dim, (0, import_logger_core.getTimestamp)());
   }
-  segments.push(`%c${LEVEL_NAMES[level]}`);
+  segments.push(`%c${import_logger_core.LEVEL_NAMES[level].padEnd(5)}`);
   styles.push(LEVEL_COLORS[level]);
   segments.push(`%c${import_constants.LOG_PREFIX}`);
   styles.push(C.bright);

package/lib/client/storage.cjs

@@ -0,0 +1,58 @@
+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 storage_exports = {};
+__export(storage_exports, {
+  storageGet: () => storageGet,
+  storageRemove: () => storageRemove,
+  storageSet: () => storageSet
+});
+module.exports = __toCommonJS(storage_exports);
+function storageArea(area) {
+  try {
+    if (typeof window === "undefined") return void 0;
+    return area === "local" ? window.localStorage : window.sessionStorage;
+  } catch {
+    return void 0;
+  }
+}
+function storageGet(area, key) {
+  try {
+    const raw = storageArea(area)?.getItem(key);
+    return raw == null ? null : JSON.parse(raw);
+  } catch {
+    return null;
+  }
+}
+function storageSet(area, key, value) {
+  try {
+    storageArea(area)?.setItem(key, JSON.stringify(value));
+  } catch {
+  }
+}
+function storageRemove(area, key) {
+  try {
+    storageArea(area)?.removeItem(key);
+  } catch {
+  }
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  storageGet,
+  storageRemove,
+  storageSet
+});

package/lib/client/storage.d.ts

@@ -0,0 +1,15 @@
+/**
+ * 浏览器存储辅助（window.localStorage/sessionStorage，仅 client 端；通过 @aipanel/core/client 导出）
+ */
+/**
+ * 安全读取浏览器存储（JSON 解码；不可用/异常返回 null）
+ */
+export declare function storageGet<T>(area: "local" | "session", key: string): T | null;
+/**
+ * 安全写入浏览器存储（JSON 序列化；异常忽略）
+ */
+export declare function storageSet(area: "local" | "session", key: string, value: unknown): void;
+/**
+ * 安全删除浏览器存储项
+ */
+export declare function storageRemove(area: "local" | "session", key: string): void;

package/lib/client/theme.cjs

@@ -0,0 +1,35 @@
+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 theme_exports = {};
+__export(theme_exports, {
+  getSystemTheme: () => getSystemTheme,
+  resolveWidgetTheme: () => resolveWidgetTheme
+});
+module.exports = __toCommonJS(theme_exports);
+function getSystemTheme() {
+  if (typeof window === "undefined" || typeof window.matchMedia !== "function") return "light";
+  return window.matchMedia("(prefers-color-scheme: dark)").matches ? "dark" : "light";
+}
+function resolveWidgetTheme(theme, system = getSystemTheme()) {
+  return theme === "auto" ? system : theme;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  getSystemTheme,
+  resolveWidgetTheme
+});

package/lib/client/theme.d.ts

@@ -0,0 +1,15 @@
+/**
+ * 浏览器主题辅助（依赖 window.matchMedia，仅 client 端使用；通过 @aipanel/core/client 导出）
+ */
+import type { AIPanelWidgetTheme } from "../common/types";
+/**
+ * 当前系统主题（仅浏览器有效；SSR/无 window 环境返回 light）
+ */
+export declare function getSystemTheme(): "light" | "dark";
+/**
+ * 挂件主题偏好解析：auto 按系统主题折算为 light/dark
+ * @param theme - 挂件主题偏好（AIPanelWidgetTheme）
+ * @param system - 系统主题（默认当前系统）
+ * @returns 实际应用主题
+ */
+export declare function resolveWidgetTheme(theme: AIPanelWidgetTheme, system?: "light" | "dark"): "light" | "dark";

package/lib/client.cjs

@@ -15,7 +15,11 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 var client_exports = {};
 module.exports = __toCommonJS(client_exports);
 __reExport(client_exports, require("./client/logger.cjs"), module.exports);
+__reExport(client_exports, require("./client/storage.cjs"), module.exports);
+__reExport(client_exports, require("./client/theme.cjs"), module.exports);
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
-  ...require("./client/logger.cjs")
+  ...require("./client/logger.cjs"),
+  ...require("./client/storage.cjs"),
+  ...require("./client/theme.cjs")
 });

package/lib/client.d.ts

@@ -1 +1,3 @@
 export * from "./client/logger";
+export * from "./client/storage";
+export * from "./client/theme";

package/lib/common/constants.cjs

@@ -30,8 +30,6 @@ __export(constants_exports, {
   DEFAULT_PROXY_PORT: () => DEFAULT_PROXY_PORT,
   DEFAULT_RETRIES: () => DEFAULT_RETRIES,
   DEFAULT_WEB_PORT: () => DEFAULT_WEB_PORT,
-  ENV_VSCODE_MODE: () => ENV_VSCODE_MODE,
-  ENV_VSCODE_PORT: () => ENV_VSCODE_PORT,
   EXT_BROADCAST: () => EXT_BROADCAST,
   EXT_MSG: () => EXT_MSG,
   HOST_EVENTS_API_PATH: () => HOST_EVENTS_API_PATH,
@@ -42,7 +40,9 @@ __export(constants_exports, {
   MAX_PORT_TRIES: () => MAX_PORT_TRIES,
   MAX_TEXT_LENGTH: () => MAX_TEXT_LENGTH,
   MCP_API_PATH: () => MCP_API_PATH,
+  MUTATING_TOOLS: () => MUTATING_TOOLS,
   NOTIFICATION_DURATION: () => NOTIFICATION_DURATION,
+  OPENCODE_ENV: () => OPENCODE_ENV,
   PAGE_CONTEXT_MARKER: () => PAGE_CONTEXT_MARKER,
   PAGE_CONTEXT_MAX_TEXT_LENGTH: () => PAGE_CONTEXT_MAX_TEXT_LENGTH,
   RETRY_DELAY: () => RETRY_DELAY,
@@ -55,15 +55,15 @@ __export(constants_exports, {
   SEVERITY_ERROR: () => SEVERITY_ERROR,
   SEVERITY_WARN: () => SEVERITY_WARN,
   SSE_EVENTS_PATH: () => SSE_EVENTS_PATH,
+  SSE_EVENT_TYPES: () => SSE_EVENT_TYPES,
   START_API_PATH: () => START_API_PATH,
-  VSCODE_EXTENSION_PORT: () => VSCODE_EXTENSION_PORT,
-  VSCODE_ROUTE_FORMAT: () => VSCODE_ROUTE_FORMAT,
-  VSCODE_ROUTE_HEALTH: () => VSCODE_ROUTE_HEALTH,
   VUE_DEVTOOLS_ACTIONS: () => VUE_DEVTOOLS_ACTIONS,
+  VUE_DEVTOOLS_API_PATH: () => VUE_DEVTOOLS_API_PATH,
   WARMUP_API_PATH: () => WARMUP_API_PATH,
   WIDGET_MSG: () => WIDGET_MSG,
   WIDGET_SCRIPT_PATH: () => WIDGET_SCRIPT_PATH,
-  WIDGET_STYLE_PATH: () => WIDGET_STYLE_PATH
+  WIDGET_STYLE_PATH: () => WIDGET_STYLE_PATH,
+  WIDGET_THEME_MODES: () => WIDGET_THEME_MODES
 });
 module.exports = __toCommonJS(constants_exports);
 const DEFAULT_HOSTNAME = "127.0.0.1";
@@ -134,17 +134,13 @@ const WARMUP_API_PATH = "/__aipanel_warmup__";
 const BRIDGE_SCRIPT_PATH = "/__aipanel_bridge__.js";
 const LOGS_API_PATH = "/__aipanel_process_logs__";
 const WIDGET_STYLE_PATH = "/__aipanel_widget__.css";
+const VUE_DEVTOOLS_API_PATH = "/__aipanel_vue_devtools__";
 const MAX_TEXT_LENGTH = 100;
 const CONTEXT_MARKER = "[\u5143\u7D20\u4E0A\u4E0B\u6587]";
 const PAGE_CONTEXT_MARKER = "__AIPANEL_CONTEXT__";
 const PAGE_CONTEXT_MAX_TEXT_LENGTH = 1e4;
 const SEVERITY_ERROR = 1;
 const SEVERITY_WARN = 2;
-const VSCODE_EXTENSION_PORT = 51939;
-const VSCODE_ROUTE_HEALTH = "/health";
-const VSCODE_ROUTE_FORMAT = "/format";
-const ENV_VSCODE_MODE = "AIPANEL_VSCODE_MODE";
-const ENV_VSCODE_PORT = "AIPANEL_VSCODE_PORT";
 const VUE_DEVTOOLS_ACTIONS = {
   GET_COMPONENT_TREE: "getComponentTree",
   GET_COMPONENT_STATE: "getComponentState",
@@ -153,6 +149,25 @@ const VUE_DEVTOOLS_ACTIONS = {
   TOGGLE_APP: "toggleApp",
   GET_ROUTER_INFO: "getRouterInfo"
 };
+const MUTATING_TOOLS = /* @__PURE__ */ new Set(["write", "edit", "apply_patch"]);
+const WIDGET_THEME_MODES = ["auto", "light", "dark"];
+const OPENCODE_ENV = {
+  CONFIG_DIR: "OPENCODE_CONFIG_DIR",
+  CONTEXT_API_URL: "OPENCODE_CONTEXT_API_URL",
+  VITE_LOGS_API_URL: "OPENCODE_VITE_LOGS_API_URL",
+  LOG_FILES_JSON: "OPENCODE_LOG_FILES_JSON",
+  VERBOSE: "OPENCODE_VERBOSE",
+  ENABLE_LINT: "OPENCODE_ENABLE_LINT",
+  VUE_DEVTOOLS_API_URL: "OPENCODE_VUE_DEVTOOLS_API_URL",
+  WORKSPACE: "OPENCODE_WORKSPACE"
+};
+const SSE_EVENT_TYPES = {
+  CONNECTED: "CONNECTED",
+  STATUS_SYNC: "STATUS_SYNC",
+  TASK_UPDATE: "TASK_UPDATE",
+  SESSION_EVENT: "SESSION_EVENT",
+  CLEAR_ELEMENTS: "CLEAR_ELEMENTS"
+};
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   AIPANEL_CACHE_DIR,
@@ -168,8 +183,6 @@ const VUE_DEVTOOLS_ACTIONS = {
   DEFAULT_PROXY_PORT,
   DEFAULT_RETRIES,
   DEFAULT_WEB_PORT,
-  ENV_VSCODE_MODE,
-  ENV_VSCODE_PORT,
   EXT_BROADCAST,
   EXT_MSG,
   HOST_EVENTS_API_PATH,
@@ -180,7 +193,9 @@ const VUE_DEVTOOLS_ACTIONS = {
   MAX_PORT_TRIES,
   MAX_TEXT_LENGTH,
   MCP_API_PATH,
+  MUTATING_TOOLS,
   NOTIFICATION_DURATION,
+  OPENCODE_ENV,
   PAGE_CONTEXT_MARKER,
   PAGE_CONTEXT_MAX_TEXT_LENGTH,
   RETRY_DELAY,
@@ -193,13 +208,13 @@ const VUE_DEVTOOLS_ACTIONS = {
   SEVERITY_ERROR,
   SEVERITY_WARN,
   SSE_EVENTS_PATH,
+  SSE_EVENT_TYPES,
   START_API_PATH,
-  VSCODE_EXTENSION_PORT,
-  VSCODE_ROUTE_FORMAT,
-  VSCODE_ROUTE_HEALTH,
   VUE_DEVTOOLS_ACTIONS,
+  VUE_DEVTOOLS_API_PATH,
   WARMUP_API_PATH,
   WIDGET_MSG,
   WIDGET_SCRIPT_PATH,
-  WIDGET_STYLE_PATH
+  WIDGET_STYLE_PATH,
+  WIDGET_THEME_MODES
 });

package/lib/common/constants.d.ts

@@ -122,6 +122,8 @@ export declare const BRIDGE_SCRIPT_PATH = "/__aipanel_bridge__.js";
 export declare const LOGS_API_PATH = "/__aipanel_process_logs__";
 /** Widget 样式路径 */
 export declare const WIDGET_STYLE_PATH = "/__aipanel_widget__.css";
+/** Vue DevTools API 路径 */
+export declare const VUE_DEVTOOLS_API_PATH = "/__aipanel_vue_devtools__";
 /** ==================== 文本处理 ==================== */
 /** 元素文本最大显示长度 */
 export declare const MAX_TEXT_LENGTH = 100;
@@ -138,16 +140,6 @@ export declare const PAGE_CONTEXT_MAX_TEXT_LENGTH = 10000;
  */
 export declare const SEVERITY_ERROR = 1;
 export declare const SEVERITY_WARN = 2;
-/** ==================== VS Code 扩展桥接 ==================== */
-/** VS Code 扩展 HTTP 服务端口（vscode-extension ↔ provider 通信协议） */
-export declare const VSCODE_EXTENSION_PORT = 51939;
-/** VS Code 扩展 HTTP 路由：健康检查 */
-export declare const VSCODE_ROUTE_HEALTH = "/health";
-/** VS Code 扩展 HTTP 路由：文件格式化 */
-export declare const VSCODE_ROUTE_FORMAT = "/format";
-/** VS Code 扩展相关环境变量名 */
-export declare const ENV_VSCODE_MODE = "AIPANEL_VSCODE_MODE";
-export declare const ENV_VSCODE_PORT = "AIPANEL_VSCODE_PORT";
 /** ==================== Vue DevTools API ==================== */
 /** Vue DevTools API action 名称 */
 export declare const VUE_DEVTOOLS_ACTIONS: {
@@ -159,3 +151,31 @@ export declare const VUE_DEVTOOLS_ACTIONS: {
     readonly GET_ROUTER_INFO: "getRouterInfo";
 };
 export type VueDevtoolsAction = (typeof VUE_DEVTOOLS_ACTIONS)[keyof typeof VUE_DEVTOOLS_ACTIONS];
+/** ==================== 写类工具名单 ==================== */
+/** 会修改文件的工具名（host 插件与编辑后自动诊断共用的单一来源） */
+export declare const MUTATING_TOOLS: ReadonlySet<string>;
+/** ==================== 挂件主题 ==================== */
+/** 挂件主题可选值（对应 AIPanelWidgetTheme） */
+export declare const WIDGET_THEME_MODES: readonly ["auto", "light", "dark"];
+/** ==================== OpenCode 环境变量名 ==================== */
+/** OpenCode 相关环境变量名（opencode provider 写、es/plugins 与 dsh-plugin 读，统一引用防止字面量漂移） */
+export declare const OPENCODE_ENV: {
+    readonly CONFIG_DIR: "OPENCODE_CONFIG_DIR";
+    readonly CONTEXT_API_URL: "OPENCODE_CONTEXT_API_URL";
+    readonly VITE_LOGS_API_URL: "OPENCODE_VITE_LOGS_API_URL";
+    readonly LOG_FILES_JSON: "OPENCODE_LOG_FILES_JSON";
+    readonly VERBOSE: "OPENCODE_VERBOSE";
+    readonly ENABLE_LINT: "OPENCODE_ENABLE_LINT";
+    readonly VUE_DEVTOOLS_API_URL: "OPENCODE_VUE_DEVTOOLS_API_URL";
+    readonly WORKSPACE: "OPENCODE_WORKSPACE";
+};
+/** ==================== SSE 事件流消息类型 ==================== */
+/** 服务端 → 客户端 SSE 信封 type 字段（vite endpoints 写、client useServerSSE 读） */
+export declare const SSE_EVENT_TYPES: {
+    readonly CONNECTED: "CONNECTED";
+    readonly STATUS_SYNC: "STATUS_SYNC";
+    readonly TASK_UPDATE: "TASK_UPDATE";
+    readonly SESSION_EVENT: "SESSION_EVENT";
+    readonly CLEAR_ELEMENTS: "CLEAR_ELEMENTS";
+};
+export type SSEEventType = (typeof SSE_EVENT_TYPES)[keyof typeof SSE_EVENT_TYPES];

package/lib/common/options.d.ts

@@ -16,6 +16,30 @@ export interface ChromeMcpOptions {
     args?: string[];
     /** 透传给 chrome-devtools-mcp 进程的额外环境变量（合并到 process.env 之上） */
     env?: Record<string, string>;
+    /** 项目边界策略（默认缺失 = 现状行为） */
+    project?: ChromeProjectOptions;
+}
+/**
+ * 项目边界策略（chrome-devtools-mcp 工具层的“本项目内操作”可配选项，默认均为现状）。
+ * 所有项只会收窄/放宽我们的边界判定，不改变白名单的权威性。
+ */
+export interface ChromeProjectOptions {
+    /**
+     * 白名单条目：除自动项目页外，可开启/可见/可操作的额外页面。每条三种写法：
+     * - 精确 origin："https://example.com"（前缀匹配该 origin 下任意路径）
+     * - glob 通配符："https://*.example.com/**"（picomatch，* 不跨 /，放开路径需 /**）
+     * - 正则字面量："/^https:\\/\\/app\\.example\\.com\\//"（以 / 起止、可带 flags，对完整 URL 匹配）
+     */
+    allowOrigins?: string[];
+    /** 是否允许扩展页（chrome-extension://）纳入可操作页面；启用时自动注入 --experimental-include-all-pages */
+    includeExtensionPages?: boolean;
+    /** 工具面选择：在默认白名单上按名字调整 */
+    tools?: {
+        /** 从默认白名单隐藏（如 ["upload_file"]） */
+        deny?: string[];
+        /** 仅可开启官方二级目录中的工具（如 click_at）；非目录名将被忽略并告警 */
+        extra?: string[];
+    };
 }
 /**
  * 插件配置选项

package/lib/common/types.d.ts

@@ -2,6 +2,7 @@
  * 通用类型（Provider 无关）
  * Provider 专属类型已下沉至 @aipanel/provider-opencode。
  */
+import type { SessionStatus } from "./provider";
 /**
  * 展示模式类型
  */
@@ -123,9 +124,9 @@ export type AIPanelWidgetTheme = "light" | "dark" | "auto";
  */
 export type ServiceStatus = "idle" | "starting" | "ready" | "partial" | "failed";
 /**
- * Session 状态类型
+ * Session 状态类型（别名：以 ./provider 的 SessionStatus 为单一来源）
  */
-export type AIPanelSessionStatusType = "idle" | "running" | "streaming" | "completed";
+export type AIPanelSessionStatusType = SessionStatus;
 /**
  * Session 思考状态
  */
@@ -146,19 +147,9 @@ export interface AIPanelWidgetSession {
     url?: string;
 }
 /**
- * 挂件选中的元素
+ * 挂件选中的元素（别名：与 host 端 SelectedElement 同构，单一来源为本文件上方的 SelectedElement）
  */
-export interface AIPanelSelectedElement {
-    /** 节点唯一 id（与 SelectedElement.id 同源，`@节点[n<id>]` 标记与上下文注入共用） */
-    id?: string;
-    filePath: string | null;
-    line: number | null;
-    column: number | null;
-    innerText: string;
-    description?: string;
-    /** 用户选中节点时的页面 URL（AIPanel 附加；host 端上下文注入用） */
-    previewPageUrl?: string;
-}
+export type AIPanelSelectedElement = SelectedElement;
 /**
  * 单条代码诊断（1-based 行列坐标）——AIPanel 诊断工具（run_diagnostics 等）的
  * canonical 持久化/展示共用协议：宿主插件写 tool/result.meta，client 插件据此渲染卡片。