@aipanel/core 1.2.8 → 1.2.9

package/es/{logger.d.ts → client/logger.d.ts}

@@ -1,4 +1,4 @@
-import { type LogContext } from "./logger-core";
+import { type LogContext } from "../common/logger-core";
 export declare const logger: {
     debug(message: string, context?: LogContext, ...args: unknown[]): void;
     info(message: string, context?: LogContext, ...args: unknown[]): void;

package/es/{logger.mjs → client/logger.mjs}

@@ -1,11 +1,11 @@
-import { LOG_PREFIX } from "./constants.mjs";
+import { LOG_PREFIX } from "../common/constants.mjs";
 import {
   LogLevel,
   getConfig,
   getTimestamp,
   formatContext,
   formatValue
-} from "./logger-core.mjs";
+} from "../common/logger-core.mjs";
 const LEVEL_NAMES = {
   [LogLevel.DEBUG]: "DEBUG",
   [LogLevel.INFO]: "INFO ",

package/es/client.d.ts

@@ -0,0 +1 @@
+export * from "./client/logger";

package/es/client.mjs

@@ -0,0 +1 @@
+export * from "./client/logger.mjs";

package/es/{constants.d.ts → common/constants.d.ts}

@@ -56,6 +56,8 @@ export declare const NOTIFICATION_DURATION = 3000;
 export declare const INIT_MARKER = "__AIPANEL_INITIALIZED__";
 /** 选中元素存储键 */
 export declare const SELECTED_ELEMENTS_KEY = "__aipanel_selected_elements__";
+/** 页面会话标识键（sessionStorage，跨导航标识同一 Tab 的页面上下文） */
+export declare const SESSION_ID_KEY = "_aipanel_pk";
 /** ==================== 缓存目录 ==================== */
 /**
  * AIPanel 项目级资源/缓存目录（相对于项目根目录，各 Provider 统一使用）。
@@ -83,6 +85,8 @@ export declare const EXT_MSG: {
     readonly SELECTION_START: "SELECTION_START";
     readonly SELECTION_STOP: "SELECTION_STOP";
     readonly CS_QUERY_WINDOW: "__CS_QUERY_WINDOW__";
+    /** Side Panel → Background：立即轮询一次并回传当前服务信息 */
+    readonly FORCE_POLL: "FORCE_POLL";
     readonly PAGE_CONTEXT: "PAGE_CONTEXT";
     readonly THEME_CHANGE: "THEME_CHANGE";
     readonly SERVICE_APPEARED: "SERVICE_APPEARED";
@@ -137,6 +141,10 @@ 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";

package/es/{constants.mjs → common/constants.mjs}

@@ -22,6 +22,7 @@ const AUTO_OPEN_DELAY = 1e3;
 const NOTIFICATION_DURATION = 3e3;
 const INIT_MARKER = "__AIPANEL_INITIALIZED__";
 const SELECTED_ELEMENTS_KEY = "__aipanel_selected_elements__";
+const SESSION_ID_KEY = "_aipanel_pk";
 const AIPANEL_CACHE_DIR = "node_modules/.cache/aipanel";
 const CHROME_DEVTOOLS_PORT = 9222;
 const CHROME_DEVTOOLS_CHECK_TIMEOUT = 2e3;
@@ -38,7 +39,9 @@ const EXT_MSG = {
   REQUEST_PAGE_CONTEXT: "REQUEST_PAGE_CONTEXT",
   SELECTION_START: "SELECTION_START",
   SELECTION_STOP: "SELECTION_STOP",
-  CS_QUERY_WINDOW: "__CS_QUERY_WINDOW__"
+  CS_QUERY_WINDOW: "__CS_QUERY_WINDOW__",
+  /** Side Panel → Background：立即轮询一次并回传当前服务信息 */
+  FORCE_POLL: "FORCE_POLL"
 };
 const WIDGET_MSG = {
   READY: "AIPANEL_READY",
@@ -70,6 +73,8 @@ 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 = {
@@ -115,11 +120,14 @@ export {
   SERVER_START_TIMEOUT,
   SERVER_SYNC_INTERVAL,
   SESSIONS_API_PATH,
+  SESSION_ID_KEY,
   SEVERITY_ERROR,
   SEVERITY_WARN,
   SSE_EVENTS_PATH,
   START_API_PATH,
   VSCODE_EXTENSION_PORT,
+  VSCODE_ROUTE_FORMAT,
+  VSCODE_ROUTE_HEALTH,
   VUE_DEVTOOLS_ACTIONS,
   WARMUP_API_PATH,
   WIDGET_MSG,

package/{lib → es/common}/options.d.ts

@@ -3,6 +3,20 @@
  * Provider 专属配置通过泛型 P 注入，核心层不感知具体 schema。
  */
 import type { DisplayMode, LogFileConfig, SplitModeOptions } from "./types";
+/**
+ * chrome-devtools-mcp 进程的用户透传配置。
+ * 只允许“追加”，不允许覆盖核心受保护参数（由 McpProxy 统一过滤）。
+ */
+export interface ChromeMcpOptions {
+    /**
+     * 追加的 CLI 参数（先于核心参数注入）。
+     * 与核心受保护项（auto-connect / usage-statistics / performance-crux /
+     * page-id-routing 及其反义）冲突的参数会被剔除并告警。
+     */
+    args?: string[];
+    /** 透传给 chrome-devtools-mcp 进程的额外环境变量（合并到 process.env 之上） */
+    env?: Record<string, string>;
+}
 /**
  * 插件配置选项
  * @typeParam P - 当前 Provider 的专属配置段（schema 由具体 Provider 声明）
@@ -34,6 +48,8 @@ export interface PluginOptions<P extends Record<string, unknown> = Record<string
     warmupChromeMcp?: boolean;
     /** Chrome DevTools Protocol 端口，默认 9222 */
     chromeDevtoolsPort?: number;
+    /** chrome-devtools-mcp 进程透传配置（只可追加，不可覆盖核心受保护参数） */
+    chromeMcp?: ChromeMcpOptions;
     /** 展示模式，默认 'bubble' */
     displayMode?: DisplayMode;
     /** 分屏模式配置 */

package/{lib → es/common}/types.d.ts

@@ -84,6 +84,8 @@ export interface SelectedElement {
     innerText: string;
     /** 元素描述（标签名+选择器） */
     description?: string;
+    /** 用户选中节点时的页面 URL（AIPanel 附加；host 端上下文注入用） */
+    previewPageUrl?: string;
 }
 /**
  * 页面上下文数据
@@ -154,6 +156,22 @@ export interface AIPanelSelectedElement {
     column: number | null;
     innerText: string;
     description?: string;
+    /** 用户选中节点时的页面 URL（AIPanel 附加；host 端上下文注入用） */
+    previewPageUrl?: string;
+}
+/**
+ * 单条代码诊断（1-based 行列坐标）——AIPanel 诊断工具（run_diagnostics 等）的
+ * canonical 持久化/展示共用协议：宿主插件写 tool/result.meta，client 插件据此渲染卡片。
+ */
+export interface AIPanelDiagnosticEntry {
+    /** 所属文件（绝对路径） */
+    file: string;
+    /** 1-based 行号 */
+    line: number;
+    /** 1-based 列号 */
+    column: number;
+    severity: "error" | "warning";
+    message: string;
 }
 /**
  * 删除选中节点的载荷
@@ -185,6 +203,22 @@ export interface AIPanelSelectedElementItem {
     panelFileText: string;
     element: AIPanelSelectedElement;
 }
+/**
+ * 服务实例信息（Chrome 扩展 Background ↔ Side Panel 共享的服务载荷；
+ * 由 widget 的 SERVICE_INFO 上报与 vite start 端点探测归一化而来）。
+ */
+export interface AIPanelServiceInfo {
+    /** 代理端口 */
+    proxyPort: number;
+    /** Vite 开发服务端口（字符串；可能来自 widget 上报或探测 origin） */
+    vitePort: string;
+    /** 项目根目录 */
+    projectRoot: string;
+    /** 服务实例唯一 id（多实例隔离） */
+    serviceInstanceId: string;
+    /** 是否开启 verbose（可选） */
+    verbose?: boolean;
+}
 /**
  * 挂件组件 Props
  */

package/es/index.d.ts

@@ -1,7 +1,6 @@
-export * from "./constants";
-export * from "./logger-core";
-export * from "./logger";
-export * from "./options";
-export * from "./provider";
-export * from "./types";
-export * from "./utils";
+export * from "./common/constants";
+export * from "./common/logger-core";
+export * from "./common/options";
+export * from "./common/provider";
+export * from "./common/types";
+export * from "./common/utils";

package/es/index.mjs

@@ -1,7 +1,6 @@
-export * from "./constants.mjs";
-export * from "./logger-core.mjs";
-export * from "./logger.mjs";
-export * from "./options.mjs";
-export * from "./provider.mjs";
-export * from "./types.mjs";
-export * from "./utils.mjs";
+export * from "./common/constants.mjs";
+export * from "./common/logger-core.mjs";
+export * from "./common/options.mjs";
+export * from "./common/provider.mjs";
+export * from "./common/types.mjs";
+export * from "./common/utils.mjs";

package/es/node/diagnostics.mjs

@@ -2,8 +2,8 @@ import fs from "node:fs";
 import path from "node:path";
 import { exec } from "node:child_process";
 import { createRequire } from "node:module";
-import { SEVERITY_ERROR, SEVERITY_WARN } from "../constants.mjs";
-import { createLogger } from "../node-logger.mjs";
+import { SEVERITY_ERROR, SEVERITY_WARN } from "../common/constants.mjs";
+import { createLogger } from "./node-logger.mjs";
 const log = createLogger("Diagnostics");
 const JS_EXTENSIONS = /* @__PURE__ */ new Set([
   ".js",

package/es/{file-log-watcher.mjs → node/file-log-watcher.mjs}

@@ -1,6 +1,6 @@
 import fs from "fs";
 import path from "path";
-import { createLogger } from "./logger.mjs";
+import { createLogger } from "../client/logger.mjs";
 const log = createLogger("FileLogReader");
 function detectLogLevel(line) {
   const lowerLine = line.toLowerCase();

package/{lib → es/node}/node-logger.d.ts

@@ -1,4 +1,4 @@
-import { type LogContext } from "./logger-core";
+import { type LogContext } from "../common/logger-core";
 export declare const nodeLogger: {
     debug(message: string, context?: LogContext, ...args: unknown[]): void;
     info(message: string, context?: LogContext, ...args: unknown[]): void;

package/es/{node-logger.mjs → node/node-logger.mjs}

@@ -1,14 +1,14 @@
 var __defProp = Object.defineProperty;
 var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
 var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
-import { LOG_PREFIX } from "./constants.mjs";
+import { LOG_PREFIX } from "../common/constants.mjs";
 import {
   LogLevel,
   getConfig,
   formatContext,
   formatValue,
   generateTraceId as _generateTraceId
-} from "./logger-core.mjs";
+} from "../common/logger-core.mjs";
 const COLORS = {
   reset: "\x1B[0m",
   dim: "\x1B[2m",

package/es/{node-utils.mjs → node/node-utils.mjs}

@@ -1,6 +1,6 @@
 import { createRequire } from "node:module";
 import path from "node:path";
-import { CHROME_DEVTOOLS_PORT, CHROME_DEVTOOLS_CHECK_TIMEOUT } from "./constants.mjs";
+import { CHROME_DEVTOOLS_PORT, CHROME_DEVTOOLS_CHECK_TIMEOUT } from "../common/constants.mjs";
 function createPackageRequire(baseDir = process.cwd()) {
   return createRequire(path.join(baseDir, "package.json"));
 }

package/es/node.d.ts

@@ -1,7 +1,7 @@
-export * from "./constants";
-export * from "./logger-core";
-export * from "./node-logger";
-export * from "./process-logger";
-export * from "./file-log-watcher";
-export * from "./node-utils";
+export * from "./common/constants";
+export * from "./common/logger-core";
+export * from "./node/node-logger";
+export * from "./node/process-logger";
+export * from "./node/file-log-watcher";
+export * from "./node/node-utils";
 export * from "./node/diagnostics";

package/es/node.mjs

@@ -1,7 +1,7 @@
-export * from "./constants.mjs";
-export * from "./logger-core.mjs";
-export * from "./node-logger.mjs";
-export * from "./process-logger.mjs";
-export * from "./file-log-watcher.mjs";
-export * from "./node-utils.mjs";
+export * from "./common/constants.mjs";
+export * from "./common/logger-core.mjs";
+export * from "./node/node-logger.mjs";
+export * from "./node/process-logger.mjs";
+export * from "./node/file-log-watcher.mjs";
+export * from "./node/node-utils.mjs";
 export * from "./node/diagnostics.mjs";

package/lib/{logger.cjs → client/logger.cjs}

@@ -21,8 +21,8 @@ __export(logger_exports, {
   logger: () => logger
 });
 module.exports = __toCommonJS(logger_exports);
-var import_constants = require("./constants.cjs");
-var import_logger_core = require("./logger-core.cjs");
+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 ",

package/lib/{logger.d.ts → client/logger.d.ts}

@@ -1,4 +1,4 @@
-import { type LogContext } from "./logger-core";
+import { type LogContext } from "../common/logger-core";
 export declare const logger: {
     debug(message: string, context?: LogContext, ...args: unknown[]): void;
     info(message: string, context?: LogContext, ...args: unknown[]): void;

package/lib/client.cjs

@@ -0,0 +1,21 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+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 __reExport = (target, mod, secondTarget) => (__copyProps(target, mod, "default"), secondTarget && __copyProps(secondTarget, mod, "default"));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var client_exports = {};
+module.exports = __toCommonJS(client_exports);
+__reExport(client_exports, require("./client/logger.cjs"), module.exports);
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  ...require("./client/logger.cjs")
+});

package/lib/client.d.ts

@@ -0,0 +1 @@
+export * from "./client/logger";

package/lib/{constants.cjs → common/constants.cjs}

@@ -51,11 +51,14 @@ __export(constants_exports, {
   SERVER_START_TIMEOUT: () => SERVER_START_TIMEOUT,
   SERVER_SYNC_INTERVAL: () => SERVER_SYNC_INTERVAL,
   SESSIONS_API_PATH: () => SESSIONS_API_PATH,
+  SESSION_ID_KEY: () => SESSION_ID_KEY,
   SEVERITY_ERROR: () => SEVERITY_ERROR,
   SEVERITY_WARN: () => SEVERITY_WARN,
   SSE_EVENTS_PATH: () => SSE_EVENTS_PATH,
   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,
   WARMUP_API_PATH: () => WARMUP_API_PATH,
   WIDGET_MSG: () => WIDGET_MSG,
@@ -87,6 +90,7 @@ const AUTO_OPEN_DELAY = 1e3;
 const NOTIFICATION_DURATION = 3e3;
 const INIT_MARKER = "__AIPANEL_INITIALIZED__";
 const SELECTED_ELEMENTS_KEY = "__aipanel_selected_elements__";
+const SESSION_ID_KEY = "_aipanel_pk";
 const AIPANEL_CACHE_DIR = "node_modules/.cache/aipanel";
 const CHROME_DEVTOOLS_PORT = 9222;
 const CHROME_DEVTOOLS_CHECK_TIMEOUT = 2e3;
@@ -103,7 +107,9 @@ const EXT_MSG = {
   REQUEST_PAGE_CONTEXT: "REQUEST_PAGE_CONTEXT",
   SELECTION_START: "SELECTION_START",
   SELECTION_STOP: "SELECTION_STOP",
-  CS_QUERY_WINDOW: "__CS_QUERY_WINDOW__"
+  CS_QUERY_WINDOW: "__CS_QUERY_WINDOW__",
+  /** Side Panel → Background：立即轮询一次并回传当前服务信息 */
+  FORCE_POLL: "FORCE_POLL"
 };
 const WIDGET_MSG = {
   READY: "AIPANEL_READY",
@@ -135,6 +141,8 @@ 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 = {
@@ -181,11 +189,14 @@ const VUE_DEVTOOLS_ACTIONS = {
   SERVER_START_TIMEOUT,
   SERVER_SYNC_INTERVAL,
   SESSIONS_API_PATH,
+  SESSION_ID_KEY,
   SEVERITY_ERROR,
   SEVERITY_WARN,
   SSE_EVENTS_PATH,
   START_API_PATH,
   VSCODE_EXTENSION_PORT,
+  VSCODE_ROUTE_FORMAT,
+  VSCODE_ROUTE_HEALTH,
   VUE_DEVTOOLS_ACTIONS,
   WARMUP_API_PATH,
   WIDGET_MSG,

package/lib/{constants.d.ts → common/constants.d.ts}

@@ -56,6 +56,8 @@ export declare const NOTIFICATION_DURATION = 3000;
 export declare const INIT_MARKER = "__AIPANEL_INITIALIZED__";
 /** 选中元素存储键 */
 export declare const SELECTED_ELEMENTS_KEY = "__aipanel_selected_elements__";
+/** 页面会话标识键（sessionStorage，跨导航标识同一 Tab 的页面上下文） */
+export declare const SESSION_ID_KEY = "_aipanel_pk";
 /** ==================== 缓存目录 ==================== */
 /**
  * AIPanel 项目级资源/缓存目录（相对于项目根目录，各 Provider 统一使用）。
@@ -83,6 +85,8 @@ export declare const EXT_MSG: {
     readonly SELECTION_START: "SELECTION_START";
     readonly SELECTION_STOP: "SELECTION_STOP";
     readonly CS_QUERY_WINDOW: "__CS_QUERY_WINDOW__";
+    /** Side Panel → Background：立即轮询一次并回传当前服务信息 */
+    readonly FORCE_POLL: "FORCE_POLL";
     readonly PAGE_CONTEXT: "PAGE_CONTEXT";
     readonly THEME_CHANGE: "THEME_CHANGE";
     readonly SERVICE_APPEARED: "SERVICE_APPEARED";
@@ -137,6 +141,10 @@ 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";

package/{es → lib/common}/options.d.ts

@@ -3,6 +3,20 @@
  * Provider 专属配置通过泛型 P 注入，核心层不感知具体 schema。
  */
 import type { DisplayMode, LogFileConfig, SplitModeOptions } from "./types";
+/**
+ * chrome-devtools-mcp 进程的用户透传配置。
+ * 只允许“追加”，不允许覆盖核心受保护参数（由 McpProxy 统一过滤）。
+ */
+export interface ChromeMcpOptions {
+    /**
+     * 追加的 CLI 参数（先于核心参数注入）。
+     * 与核心受保护项（auto-connect / usage-statistics / performance-crux /
+     * page-id-routing 及其反义）冲突的参数会被剔除并告警。
+     */
+    args?: string[];
+    /** 透传给 chrome-devtools-mcp 进程的额外环境变量（合并到 process.env 之上） */
+    env?: Record<string, string>;
+}
 /**
  * 插件配置选项
  * @typeParam P - 当前 Provider 的专属配置段（schema 由具体 Provider 声明）
@@ -34,6 +48,8 @@ export interface PluginOptions<P extends Record<string, unknown> = Record<string
     warmupChromeMcp?: boolean;
     /** Chrome DevTools Protocol 端口，默认 9222 */
     chromeDevtoolsPort?: number;
+    /** chrome-devtools-mcp 进程透传配置（只可追加，不可覆盖核心受保护参数） */
+    chromeMcp?: ChromeMcpOptions;
     /** 展示模式，默认 'bubble' */
     displayMode?: DisplayMode;
     /** 分屏模式配置 */

package/{es → lib/common}/types.d.ts

@@ -84,6 +84,8 @@ export interface SelectedElement {
     innerText: string;
     /** 元素描述（标签名+选择器） */
     description?: string;
+    /** 用户选中节点时的页面 URL（AIPanel 附加；host 端上下文注入用） */
+    previewPageUrl?: string;
 }
 /**
  * 页面上下文数据
@@ -154,6 +156,22 @@ export interface AIPanelSelectedElement {
     column: number | null;
     innerText: string;
     description?: string;
+    /** 用户选中节点时的页面 URL（AIPanel 附加；host 端上下文注入用） */
+    previewPageUrl?: string;
+}
+/**
+ * 单条代码诊断（1-based 行列坐标）——AIPanel 诊断工具（run_diagnostics 等）的
+ * canonical 持久化/展示共用协议：宿主插件写 tool/result.meta，client 插件据此渲染卡片。
+ */
+export interface AIPanelDiagnosticEntry {
+    /** 所属文件（绝对路径） */
+    file: string;
+    /** 1-based 行号 */
+    line: number;
+    /** 1-based 列号 */
+    column: number;
+    severity: "error" | "warning";
+    message: string;
 }
 /**
  * 删除选中节点的载荷
@@ -185,6 +203,22 @@ export interface AIPanelSelectedElementItem {
     panelFileText: string;
     element: AIPanelSelectedElement;
 }
+/**
+ * 服务实例信息（Chrome 扩展 Background ↔ Side Panel 共享的服务载荷；
+ * 由 widget 的 SERVICE_INFO 上报与 vite start 端点探测归一化而来）。
+ */
+export interface AIPanelServiceInfo {
+    /** 代理端口 */
+    proxyPort: number;
+    /** Vite 开发服务端口（字符串；可能来自 widget 上报或探测 origin） */
+    vitePort: string;
+    /** 项目根目录 */
+    projectRoot: string;
+    /** 服务实例唯一 id（多实例隔离） */
+    serviceInstanceId: string;
+    /** 是否开启 verbose（可选） */
+    verbose?: boolean;
+}
 /**
  * 挂件组件 Props
  */

package/lib/index.cjs

@@ -14,20 +14,18 @@ var __reExport = (target, mod, secondTarget) => (__copyProps(target, mod, "defau
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 var lib_exports = {};
 module.exports = __toCommonJS(lib_exports);
-__reExport(lib_exports, require("./constants.cjs"), module.exports);
-__reExport(lib_exports, require("./logger-core.cjs"), module.exports);
-__reExport(lib_exports, require("./logger.cjs"), module.exports);
-__reExport(lib_exports, require("./options.cjs"), module.exports);
-__reExport(lib_exports, require("./provider.cjs"), module.exports);
-__reExport(lib_exports, require("./types.cjs"), module.exports);
-__reExport(lib_exports, require("./utils.cjs"), module.exports);
+__reExport(lib_exports, require("./common/constants.cjs"), module.exports);
+__reExport(lib_exports, require("./common/logger-core.cjs"), module.exports);
+__reExport(lib_exports, require("./common/options.cjs"), module.exports);
+__reExport(lib_exports, require("./common/provider.cjs"), module.exports);
+__reExport(lib_exports, require("./common/types.cjs"), module.exports);
+__reExport(lib_exports, require("./common/utils.cjs"), module.exports);
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
-  ...require("./constants.cjs"),
-  ...require("./logger-core.cjs"),
-  ...require("./logger.cjs"),
-  ...require("./options.cjs"),
-  ...require("./provider.cjs"),
-  ...require("./types.cjs"),
-  ...require("./utils.cjs")
+  ...require("./common/constants.cjs"),
+  ...require("./common/logger-core.cjs"),
+  ...require("./common/options.cjs"),
+  ...require("./common/provider.cjs"),
+  ...require("./common/types.cjs"),
+  ...require("./common/utils.cjs")
 });

package/lib/index.d.ts

@@ -1,7 +1,6 @@
-export * from "./constants";
-export * from "./logger-core";
-export * from "./logger";
-export * from "./options";
-export * from "./provider";
-export * from "./types";
-export * from "./utils";
+export * from "./common/constants";
+export * from "./common/logger-core";
+export * from "./common/options";
+export * from "./common/provider";
+export * from "./common/types";
+export * from "./common/utils";

package/lib/node/diagnostics.cjs

@@ -41,8 +41,8 @@ var import_node_fs = __toESM(require("node:fs"));
 var import_node_path = __toESM(require("node:path"));
 var import_node_child_process = require("node:child_process");
 var import_node_module = require("node:module");
-var import_constants = require("../constants.cjs");
-var import_node_logger = require("../node-logger.cjs");
+var import_constants = require("../common/constants.cjs");
+var import_node_logger = require("./node-logger.cjs");
 const import_meta = {};
 const log = (0, import_node_logger.createLogger)("Diagnostics");
 const JS_EXTENSIONS = /* @__PURE__ */ new Set([

package/lib/{file-log-watcher.cjs → node/file-log-watcher.cjs}

@@ -33,7 +33,7 @@ __export(file_log_watcher_exports, {
 module.exports = __toCommonJS(file_log_watcher_exports);
 var import_fs = __toESM(require("fs"));
 var import_path = __toESM(require("path"));
-var import_logger = require("./logger.cjs");
+var import_logger = require("../client/logger.cjs");
 const log = (0, import_logger.createLogger)("FileLogReader");
 function detectLogLevel(line) {
   const lowerLine = line.toLowerCase();

package/lib/{node-logger.cjs → node/node-logger.cjs}

@@ -28,8 +28,8 @@ __export(node_logger_exports, {
   nodeLogger: () => nodeLogger
 });
 module.exports = __toCommonJS(node_logger_exports);
-var import_constants = require("./constants.cjs");
-var import_logger_core = require("./logger-core.cjs");
+var import_constants = require("../common/constants.cjs");
+var import_logger_core = require("../common/logger-core.cjs");
 const COLORS = {
   reset: "\x1B[0m",
   dim: "\x1B[2m",

package/{es → lib/node}/node-logger.d.ts

@@ -1,4 +1,4 @@
-import { type LogContext } from "./logger-core";
+import { type LogContext } from "../common/logger-core";
 export declare const nodeLogger: {
     debug(message: string, context?: LogContext, ...args: unknown[]): void;
     info(message: string, context?: LogContext, ...args: unknown[]): void;

package/lib/{node-utils.cjs → node/node-utils.cjs}

@@ -36,7 +36,7 @@ __export(node_utils_exports, {
 module.exports = __toCommonJS(node_utils_exports);
 var import_node_module = require("node:module");
 var import_node_path = __toESM(require("node:path"));
-var import_constants = require("./constants.cjs");
+var import_constants = require("../common/constants.cjs");
 function createPackageRequire(baseDir = process.cwd()) {
   return (0, import_node_module.createRequire)(import_node_path.default.join(baseDir, "package.json"));
 }

package/lib/node.cjs

@@ -14,20 +14,20 @@ var __reExport = (target, mod, secondTarget) => (__copyProps(target, mod, "defau
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 var node_exports = {};
 module.exports = __toCommonJS(node_exports);
-__reExport(node_exports, require("./constants.cjs"), module.exports);
-__reExport(node_exports, require("./logger-core.cjs"), module.exports);
-__reExport(node_exports, require("./node-logger.cjs"), module.exports);
-__reExport(node_exports, require("./process-logger.cjs"), module.exports);
-__reExport(node_exports, require("./file-log-watcher.cjs"), module.exports);
-__reExport(node_exports, require("./node-utils.cjs"), module.exports);
+__reExport(node_exports, require("./common/constants.cjs"), module.exports);
+__reExport(node_exports, require("./common/logger-core.cjs"), module.exports);
+__reExport(node_exports, require("./node/node-logger.cjs"), module.exports);
+__reExport(node_exports, require("./node/process-logger.cjs"), module.exports);
+__reExport(node_exports, require("./node/file-log-watcher.cjs"), module.exports);
+__reExport(node_exports, require("./node/node-utils.cjs"), module.exports);
 __reExport(node_exports, require("./node/diagnostics.cjs"), module.exports);
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
-  ...require("./constants.cjs"),
-  ...require("./logger-core.cjs"),
-  ...require("./node-logger.cjs"),
-  ...require("./process-logger.cjs"),
-  ...require("./file-log-watcher.cjs"),
-  ...require("./node-utils.cjs"),
+  ...require("./common/constants.cjs"),
+  ...require("./common/logger-core.cjs"),
+  ...require("./node/node-logger.cjs"),
+  ...require("./node/process-logger.cjs"),
+  ...require("./node/file-log-watcher.cjs"),
+  ...require("./node/node-utils.cjs"),
   ...require("./node/diagnostics.cjs")
 });

package/lib/node.d.ts

@@ -1,7 +1,7 @@
-export * from "./constants";
-export * from "./logger-core";
-export * from "./node-logger";
-export * from "./process-logger";
-export * from "./file-log-watcher";
-export * from "./node-utils";
+export * from "./common/constants";
+export * from "./common/logger-core";
+export * from "./node/node-logger";
+export * from "./node/process-logger";
+export * from "./node/file-log-watcher";
+export * from "./node/node-utils";
 export * from "./node/diagnostics";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aipanel/core",
-  "version": "1.2.8",
+  "version": "1.2.9",
   "type": "module",
   "sideEffects": false,
   "main": "lib/index.cjs",
@@ -16,6 +16,11 @@
       "import": "./es/index.mjs",
       "require": "./lib/index.cjs"
     },
+    "./client": {
+      "types": "./es/client.d.ts",
+      "import": "./es/client.mjs",
+      "require": "./lib/client.cjs"
+    },
     "./node": {
       "types": "./es/node.d.ts",
       "import": "./es/node.mjs",