@aipanel/core 1.2.7 → 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}

@@ -37,8 +37,10 @@ export declare const START_API_PATH = "/__aipanel_start__";
 export declare const SESSIONS_API_PATH = "/__aipanel_sessions__";
 /** MCP 代理 API 路径 */
 export declare const MCP_API_PATH = "/__aipanel_mcp__";
-/** SSE 事件流路径 */
+/** SSE 事件流路径（客户端订阅 SESSION_EVENT 等） */
 export declare const SSE_EVENTS_PATH = "/__aipanel_events__";
+/** 宿主侧事件推送 API 路径（dsh-plugin 等 Host 插件把归一化 ProviderEvent POST 到这里，core 再广播给 SSE 客户端） */
+export declare const HOST_EVENTS_API_PATH = "/__aipanel_host_events__";
 /** 上下文更新间隔（毫秒） */
 export declare const CONTEXT_UPDATE_INTERVAL = 500;
 /** 服务器同步间隔（毫秒） */
@@ -54,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 统一使用）。
@@ -81,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";
@@ -135,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}

@@ -14,6 +14,7 @@ const START_API_PATH = "/__aipanel_start__";
 const SESSIONS_API_PATH = "/__aipanel_sessions__";
 const MCP_API_PATH = "/__aipanel_mcp__";
 const SSE_EVENTS_PATH = "/__aipanel_events__";
+const HOST_EVENTS_API_PATH = "/__aipanel_host_events__";
 const CONTEXT_UPDATE_INTERVAL = 500;
 const SERVER_SYNC_INTERVAL = 2e3;
 const INSPECTOR_CHECK_INTERVAL = 500;
@@ -21,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;
@@ -37,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",
@@ -69,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 = {
@@ -97,6 +103,7 @@ export {
   ENV_VSCODE_PORT,
   EXT_BROADCAST,
   EXT_MSG,
+  HOST_EVENTS_API_PATH,
   INIT_MARKER,
   INSPECTOR_CHECK_INTERVAL,
   LOGS_API_PATH,
@@ -113,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/es/{options.d.ts → 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}/provider.d.ts

@@ -74,6 +74,12 @@ export interface ProviderStartOptions {
     logsApiUrl?: string;
     /** Vue DevTools API 地址（核心层提供的回连地址） */
     vueDevtoolsApiUrl?: string;
+    /**
+     * 宿主事件推送令牌（核心层每轮启动随机生成，透传给 Host 侧插件）。
+     * dsh-plugin 监听宿主事件（session/event 总线）时须携带该令牌 POST 到 HOST_EVENTS_API_PATH，
+     * core 校验通过后按 SESSION_EVENT 广播给 SSE 客户端。无该能力/无需求的 Provider 忽略即可。
+     */
+    eventsToken?: string;
     /** 启用 verbose 模式 */
     verbose?: boolean;
 }
@@ -99,6 +105,12 @@ export interface ProviderStartResult {
     url: string;
     /** 进程句柄（供编排层做就绪等待与退出检测，不透明） */
     processHandle?: unknown;
+    /**
+     * 对 Provider Web 服务做浏览器会话认证所需的 Cookie（可选）。
+     * dsh web 升级后在索引页与 /api 上强制 browser-session 认证（launch token → 签名 cookie），
+     * 代理需在转发请求时注入该 Cookie 才能通过 401 门禁。opencode 等无需认证的 Provider 不设置。
+     */
+    webAuthCookie?: string;
 }
 /** Provider 初始化配置（主题/语言/设置等，schema 由 Provider 定义） */
 export interface ProviderConfig {
@@ -142,8 +154,12 @@ export interface WebProvider {
     stop(): Promise<void>;
     /** 清理孤儿进程（上次退出残留的 provider 进程），返回清理数量（可选） */
     killOrphans?(): Promise<number>;
-    /** 会话管理（归一化到 ChatSession，过滤逻辑在此内部完成） */
-    listSessions(projectDir: string): Promise<ChatSession[]>;
+    /**
+     * 会话管理（归一化到 ChatSession，过滤逻辑在此内部完成）。
+     * @param activeSessionId 当前选中会话 id（可选）：用于对齐 dsh 等 UI 的可见性规则
+     *   （blank 会话仅当其为当前选中会话时展示）。无选中态概念的 Provider 忽略即可。
+     */
+    listSessions(projectDir: string, activeSessionId?: string): Promise<ChatSession[]>;
     createSession(projectDir: string, title?: string): Promise<ChatSession>;
     /** 可选：部分 Provider 无删除语义；core 不支持时隐藏删除入口 */
     deleteSession?(sessionId: string): Promise<void>;

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;
@@ -28,7 +28,10 @@ export declare class RequestContext {
     path: string;
     startTime: number;
     private checkpoints;
-    constructor(method: string, path: string);
+    private quiet;
+    constructor(method: string, path: string, options?: {
+        quiet?: boolean;
+    });
     checkpoint(label: string): void;
     end(statusCode: number): void;
     error(error: Error | 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",
@@ -168,25 +168,32 @@ class PerformanceTimer {
   }
 }
 class RequestContext {
-  constructor(method, path) {
+  constructor(method, path, options) {
     __publicField(this, "traceId");
     __publicField(this, "method");
     __publicField(this, "path");
     __publicField(this, "startTime");
     __publicField(this, "checkpoints", []);
+    __publicField(this, "quiet");
     this.traceId = _generateTraceId();
     this.method = method;
     this.path = path;
+    this.quiet = options?.quiet ?? false;
     this.startTime = performance.now();
-    nodeLogger.debug(`\u2192 ${method} ${path}`, { traceId: this.traceId, module: "HTTP" });
+    if (!this.quiet) {
+      nodeLogger.debug(`\u2192 ${method} ${path}`, { traceId: this.traceId, module: "HTTP" });
+    }
   }
   checkpoint(label) {
     const elapsed = Math.round(performance.now() - this.startTime);
     this.checkpoints.push({ time: elapsed, label });
-    nodeLogger.debug(`  \u2192 ${label}`, { traceId: this.traceId, duration: elapsed });
+    if (!this.quiet) {
+      nodeLogger.debug(`  \u2192 ${label}`, { traceId: this.traceId, duration: elapsed });
+    }
   }
   end(statusCode) {
     const duration = Math.round(performance.now() - this.startTime);
+    if (this.quiet) return;
     const statusColor = statusCode < 400 ? COLORS.green : COLORS.red;
     nodeLogger.debug(`\u2190 ${this.method} ${this.path} ${statusColor}${statusCode}${COLORS.reset}`, {
       traceId: this.traceId,

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}

@@ -34,6 +34,7 @@ __export(constants_exports, {
   ENV_VSCODE_PORT: () => ENV_VSCODE_PORT,
   EXT_BROADCAST: () => EXT_BROADCAST,
   EXT_MSG: () => EXT_MSG,
+  HOST_EVENTS_API_PATH: () => HOST_EVENTS_API_PATH,
   INIT_MARKER: () => INIT_MARKER,
   INSPECTOR_CHECK_INTERVAL: () => INSPECTOR_CHECK_INTERVAL,
   LOGS_API_PATH: () => LOGS_API_PATH,
@@ -50,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,
@@ -78,6 +82,7 @@ const START_API_PATH = "/__aipanel_start__";
 const SESSIONS_API_PATH = "/__aipanel_sessions__";
 const MCP_API_PATH = "/__aipanel_mcp__";
 const SSE_EVENTS_PATH = "/__aipanel_events__";
+const HOST_EVENTS_API_PATH = "/__aipanel_host_events__";
 const CONTEXT_UPDATE_INTERVAL = 500;
 const SERVER_SYNC_INTERVAL = 2e3;
 const INSPECTOR_CHECK_INTERVAL = 500;
@@ -85,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;
@@ -101,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",
@@ -133,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 = {
@@ -162,6 +172,7 @@ const VUE_DEVTOOLS_ACTIONS = {
   ENV_VSCODE_PORT,
   EXT_BROADCAST,
   EXT_MSG,
+  HOST_EVENTS_API_PATH,
   INIT_MARKER,
   INSPECTOR_CHECK_INTERVAL,
   LOGS_API_PATH,
@@ -178,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}

@@ -37,8 +37,10 @@ export declare const START_API_PATH = "/__aipanel_start__";
 export declare const SESSIONS_API_PATH = "/__aipanel_sessions__";
 /** MCP 代理 API 路径 */
 export declare const MCP_API_PATH = "/__aipanel_mcp__";
-/** SSE 事件流路径 */
+/** SSE 事件流路径（客户端订阅 SESSION_EVENT 等） */
 export declare const SSE_EVENTS_PATH = "/__aipanel_events__";
+/** 宿主侧事件推送 API 路径（dsh-plugin 等 Host 插件把归一化 ProviderEvent POST 到这里，core 再广播给 SSE 客户端） */
+export declare const HOST_EVENTS_API_PATH = "/__aipanel_host_events__";
 /** 上下文更新间隔（毫秒） */
 export declare const CONTEXT_UPDATE_INTERVAL = 500;
 /** 服务器同步间隔（毫秒） */
@@ -54,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 统一使用）。
@@ -81,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";
@@ -135,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/lib/{options.d.ts → 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}/provider.d.ts

@@ -74,6 +74,12 @@ export interface ProviderStartOptions {
     logsApiUrl?: string;
     /** Vue DevTools API 地址（核心层提供的回连地址） */
     vueDevtoolsApiUrl?: string;
+    /**
+     * 宿主事件推送令牌（核心层每轮启动随机生成，透传给 Host 侧插件）。
+     * dsh-plugin 监听宿主事件（session/event 总线）时须携带该令牌 POST 到 HOST_EVENTS_API_PATH，
+     * core 校验通过后按 SESSION_EVENT 广播给 SSE 客户端。无该能力/无需求的 Provider 忽略即可。
+     */
+    eventsToken?: string;
     /** 启用 verbose 模式 */
     verbose?: boolean;
 }
@@ -99,6 +105,12 @@ export interface ProviderStartResult {
     url: string;
     /** 进程句柄（供编排层做就绪等待与退出检测，不透明） */
     processHandle?: unknown;
+    /**
+     * 对 Provider Web 服务做浏览器会话认证所需的 Cookie（可选）。
+     * dsh web 升级后在索引页与 /api 上强制 browser-session 认证（launch token → 签名 cookie），
+     * 代理需在转发请求时注入该 Cookie 才能通过 401 门禁。opencode 等无需认证的 Provider 不设置。
+     */
+    webAuthCookie?: string;
 }
 /** Provider 初始化配置（主题/语言/设置等，schema 由 Provider 定义） */
 export interface ProviderConfig {
@@ -142,8 +154,12 @@ export interface WebProvider {
     stop(): Promise<void>;
     /** 清理孤儿进程（上次退出残留的 provider 进程），返回清理数量（可选） */
     killOrphans?(): Promise<number>;
-    /** 会话管理（归一化到 ChatSession，过滤逻辑在此内部完成） */
-    listSessions(projectDir: string): Promise<ChatSession[]>;
+    /**
+     * 会话管理（归一化到 ChatSession，过滤逻辑在此内部完成）。
+     * @param activeSessionId 当前选中会话 id（可选）：用于对齐 dsh 等 UI 的可见性规则
+     *   （blank 会话仅当其为当前选中会话时展示）。无选中态概念的 Provider 忽略即可。
+     */
+    listSessions(projectDir: string, activeSessionId?: string): Promise<ChatSession[]>;
     createSession(projectDir: string, title?: string): Promise<ChatSession>;
     /** 可选：部分 Provider 无删除语义；core 不支持时隐藏删除入口 */
     deleteSession?(sessionId: string): Promise<void>;

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",
@@ -189,25 +189,32 @@ class PerformanceTimer {
   }
 }
 class RequestContext {
-  constructor(method, path) {
+  constructor(method, path, options) {
     __publicField(this, "traceId");
     __publicField(this, "method");
     __publicField(this, "path");
     __publicField(this, "startTime");
     __publicField(this, "checkpoints", []);
+    __publicField(this, "quiet");
     this.traceId = (0, import_logger_core.generateTraceId)();
     this.method = method;
     this.path = path;
+    this.quiet = options?.quiet ?? false;
     this.startTime = performance.now();
-    nodeLogger.debug(`\u2192 ${method} ${path}`, { traceId: this.traceId, module: "HTTP" });
+    if (!this.quiet) {
+      nodeLogger.debug(`\u2192 ${method} ${path}`, { traceId: this.traceId, module: "HTTP" });
+    }
   }
   checkpoint(label) {
     const elapsed = Math.round(performance.now() - this.startTime);
     this.checkpoints.push({ time: elapsed, label });
-    nodeLogger.debug(`  \u2192 ${label}`, { traceId: this.traceId, duration: elapsed });
+    if (!this.quiet) {
+      nodeLogger.debug(`  \u2192 ${label}`, { traceId: this.traceId, duration: elapsed });
+    }
   }
   end(statusCode) {
     const duration = Math.round(performance.now() - this.startTime);
+    if (this.quiet) return;
     const statusColor = statusCode < 400 ? COLORS.green : COLORS.red;
     nodeLogger.debug(`\u2190 ${this.method} ${this.path} ${statusColor}${statusCode}${COLORS.reset}`, {
       traceId: this.traceId,

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;
@@ -28,7 +28,10 @@ export declare class RequestContext {
     path: string;
     startTime: number;
     private checkpoints;
-    constructor(method: string, path: string);
+    private quiet;
+    constructor(method: string, path: string, options?: {
+        quiet?: boolean;
+    });
     checkpoint(label: string): void;
     end(statusCode: number): void;
     error(error: Error | 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.7",
+  "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",