@aipanel/core 1.2.0-beta.0

package/lib/node-utils.cjs

@@ -0,0 +1,93 @@
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+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 __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var node_utils_exports = {};
+__export(node_utils_exports, {
+  checkChromeDevToolsAvailable: () => checkChromeDevToolsAvailable,
+  createPackageRequire: () => createPackageRequire,
+  findAvailablePort: () => findAvailablePort,
+  isPortAvailable: () => isPortAvailable,
+  resolvePackageDir: () => resolvePackageDir
+});
+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");
+function createPackageRequire(baseDir = process.cwd()) {
+  return (0, import_node_module.createRequire)(import_node_path.default.join(baseDir, "package.json"));
+}
+function resolvePackageDir(packageName, baseDir = process.cwd()) {
+  const require2 = createPackageRequire(baseDir);
+  const entryPath = require2.resolve(packageName);
+  return import_node_path.default.dirname(import_node_path.default.dirname(entryPath));
+}
+async function checkChromeDevToolsAvailable(port = import_constants.CHROME_DEVTOOLS_PORT, timeout = import_constants.CHROME_DEVTOOLS_CHECK_TIMEOUT) {
+  const net = await import("net");
+  return new Promise((resolve) => {
+    const socket = new net.Socket();
+    const timer = setTimeout(() => {
+      socket.destroy();
+      resolve(false);
+    }, timeout);
+    socket.connect(port, "localhost", () => {
+      clearTimeout(timer);
+      socket.removeAllListeners();
+      socket.destroy();
+      resolve(true);
+    });
+    socket.on("error", () => {
+      clearTimeout(timer);
+      resolve(false);
+    });
+  });
+}
+async function isPortAvailable(port, hostname) {
+  const net = await import("net");
+  return new Promise((resolve) => {
+    const server = net.createServer();
+    server.once("error", () => resolve(false));
+    server.once("listening", () => {
+      server.close();
+      resolve(true);
+    });
+    server.listen(port, hostname);
+  });
+}
+async function findAvailablePort(startPort, hostname, maxTries = 100) {
+  for (let port = startPort; port < startPort + maxTries; port++) {
+    if (await isPortAvailable(port, hostname)) return port;
+  }
+  throw new Error(`No available port in range ${startPort}-${startPort + maxTries}`);
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  checkChromeDevToolsAvailable,
+  createPackageRequire,
+  findAvailablePort,
+  isPortAvailable,
+  resolvePackageDir
+});

package/lib/node-utils.d.ts

@@ -0,0 +1,28 @@
+/**
+ * @fileoverview Node.js 专用工具函数（仅服务端可用）
+ */
+/**
+ * 创建一个锚定到指定目录（默认 process.cwd()）的 require。
+ * 跨 ESM/CJS 安全，避免依赖 __dirname / import.meta.url（CJS 打包时会与 Node 内置变量冲突或被置空）。
+ */
+export declare function createPackageRequire(baseDir?: string): NodeJS.Require;
+/**
+ * 解析 npm 包根目录（跨 ESM/CJS 安全）。
+ * @param packageName - 包名，例如 "vite-plugin-aipanel"
+ * @param baseDir - 解析基准目录，默认当前工作目录
+ */
+export declare function resolvePackageDir(packageName: string, baseDir?: string): string;
+/**
+ * 检查 Chrome DevTools 是否可用
+ * @param timeout - 超时时间（毫秒），默认 2000ms
+ * @returns Chrome DevTools 是否可用
+ */
+export declare function checkChromeDevToolsAvailable(port?: number, timeout?: number): Promise<boolean>;
+/**
+ * 检查指定端口是否可用
+ */
+export declare function isPortAvailable(port: number, hostname?: string): Promise<boolean>;
+/**
+ * 从 startPort 开始寻找可用端口
+ */
+export declare function findAvailablePort(startPort: number, hostname?: string, maxTries?: number): Promise<number>;

package/lib/node.cjs

@@ -0,0 +1,31 @@
+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 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);
+// 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")
+});

package/lib/node.d.ts

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

package/lib/options.cjs

@@ -0,0 +1,54 @@
+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 options_exports = {};
+__export(options_exports, {
+  DEFAULT_PLUGIN_OPTIONS: () => DEFAULT_PLUGIN_OPTIONS,
+  resolvePluginConfig: () => resolvePluginConfig
+});
+module.exports = __toCommonJS(options_exports);
+var import_constants = require("./constants.cjs");
+const DEFAULT_PLUGIN_OPTIONS = {
+  enabled: true,
+  provider: "default",
+  webPort: import_constants.DEFAULT_WEB_PORT,
+  hostname: import_constants.DEFAULT_HOSTNAME,
+  theme: "dark",
+  open: false,
+  verbose: false,
+  mcpOnly: false,
+  hotkey: "ctrl+k",
+  warmupChromeMcp: true,
+  chromeDevtoolsPort: import_constants.CHROME_DEVTOOLS_PORT,
+  displayMode: "extension",
+  splitMode: void 0,
+  providerOptions: void 0
+};
+function resolvePluginConfig(options = {}) {
+  return {
+    ...DEFAULT_PLUGIN_OPTIONS,
+    ...options,
+    providerOptions: {
+      ...options.providerOptions ?? {}
+    }
+  };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  DEFAULT_PLUGIN_OPTIONS,
+  resolvePluginConfig
+});

package/lib/options.d.ts

@@ -0,0 +1,63 @@
+/**
+ * 插件通用配置（Provider 无关）
+ * Provider 专属配置通过泛型 P 注入，核心层不感知具体 schema。
+ */
+import type { DisplayMode, LogFileConfig, SplitModeOptions } from "./types";
+/**
+ * 插件配置选项
+ * @typeParam P - 当前 Provider 的专属配置段（schema 由具体 Provider 声明）
+ */
+export interface PluginOptions<P extends Record<string, unknown> = Record<string, unknown>> {
+    /** 是否启用插件，默认 true */
+    enabled?: boolean;
+    /** 选择的 Web Provider 标识，默认 "default" */
+    provider?: string;
+    /** Web 服务端口，默认 5097 */
+    webPort?: number;
+    /** 代理服务端口，默认 6097 */
+    proxyPort?: number;
+    /** 服务主机名，默认 '127.0.0.1' */
+    hostname?: string;
+    /** 挂件位置，默认 'bottom-right' */
+    position?: "bottom-right" | "bottom-left" | "top-right" | "top-left";
+    /** 主题模式，默认 'dark' */
+    theme?: "light" | "dark" | "auto";
+    /** 是否自动打开面板，默认 false */
+    open?: boolean;
+    /** 是否输出详细日志，默认 false */
+    verbose?: boolean;
+    /** 纯净 MCP 模式：只暴露 MCP 工具服务，不注入挂件、不启动 provider Web 进程，默认为 false */
+    mcpOnly?: boolean;
+    /** 快捷键配置，默认 'ctrl+k' */
+    hotkey?: string;
+    /** 服务启动后是否立即预热 Chrome MCP，默认 true */
+    warmupChromeMcp?: boolean;
+    /** Chrome DevTools Protocol 端口，默认 9222 */
+    chromeDevtoolsPort?: number;
+    /** 展示模式，默认 'bubble' */
+    displayMode?: DisplayMode;
+    /** 分屏模式配置 */
+    splitMode?: SplitModeOptions;
+    /** 自定义日志文件配置，为 Agent 提供查看外部服务日志的能力 */
+    logFiles?: LogFileConfig[];
+    /** Provider 专属配置段（schema 由具体 Provider 声明，核心层不感知） */
+    providerOptions?: P;
+    /** @deprecated 使用 providerOptions.language */
+    language?: string;
+    /** @deprecated 使用 providerOptions.settings */
+    settings?: unknown;
+    /** @deprecated 使用 providerOptions.enableLsp */
+    enableLsp?: boolean;
+    /** @deprecated 使用 providerOptions.enableBlockOnError */
+    enableBlockOnError?: boolean;
+    /** @deprecated 使用 providerOptions.enablePrettier */
+    enablePrettier?: boolean;
+}
+/** 插件通用配置默认值（Provider 无关部分） */
+export declare const DEFAULT_PLUGIN_OPTIONS: Partial<PluginOptions>;
+/**
+ * 组装运行时配置（通用默认 + 用户配置）
+ * Provider 专属段原样合并透传，schema 由 Provider 自行解析；
+ * deprecated 顶层字段不在此迁移，保留在 config 顶层，由 Provider 读取兜底。
+ */
+export declare function resolvePluginConfig<P extends Record<string, unknown> = Record<string, unknown>>(options?: PluginOptions<P>): Required<PluginOptions<P>>;

package/lib/process-logger.cjs

@@ -0,0 +1,217 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+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 __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
+var process_logger_exports = {};
+__export(process_logger_exports, {
+  getProcessLogBuffer: () => getProcessLogBuffer,
+  initProcessLogCapture: () => initProcessLogCapture,
+  stopProcessLogCapture: () => stopProcessLogCapture
+});
+module.exports = __toCommonJS(process_logger_exports);
+const DEFAULT_MAX_SIZE = 500;
+class ProcessLogBuffer {
+  constructor(options = {}) {
+    __publicField(this, "buffer", []);
+    __publicField(this, "maxSize");
+    __publicField(this, "enabled", true);
+    __publicField(this, "originalConsole", null);
+    this.maxSize = options.maxSize ?? DEFAULT_MAX_SIZE;
+    this.enabled = options.enabled ?? true;
+  }
+  /**
+   * 启动 console 拦截
+   */
+  intercept() {
+    if (this.originalConsole) {
+      return;
+    }
+    this.originalConsole = {
+      log: console.log,
+      info: console.info,
+      warn: console.warn,
+      error: console.error,
+      debug: console.debug
+    };
+    console.log = this.createInterceptor("log", this.originalConsole.log);
+    console.info = this.createInterceptor("info", this.originalConsole.info);
+    console.warn = this.createInterceptor("warn", this.originalConsole.warn);
+    console.error = this.createInterceptor("error", this.originalConsole.error);
+    console.debug = this.createInterceptor("debug", this.originalConsole.debug);
+  }
+  /**
+   * 停止拦截，恢复原始 console
+   */
+  restore() {
+    if (!this.originalConsole) {
+      return;
+    }
+    console.log = this.originalConsole.log;
+    console.info = this.originalConsole.info;
+    console.warn = this.originalConsole.warn;
+    console.error = this.originalConsole.error;
+    console.debug = this.originalConsole.debug;
+    this.originalConsole = null;
+  }
+  /**
+   * 创建拦截器函数
+   */
+  createInterceptor(level, original) {
+    return (...args) => {
+      original.apply(console, args);
+      if (this.enabled) {
+        this.addEntry({
+          level,
+          message: this.serializeArgs(args),
+          timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+          source: "console"
+        });
+      }
+    };
+  }
+  /**
+   * 序列化参数为字符串
+   */
+  serializeArgs(args) {
+    return args.map((arg) => {
+      if (typeof arg === "string") {
+        return arg;
+      }
+      if (typeof arg === "number" || typeof arg === "boolean") {
+        return String(arg);
+      }
+      if (arg === null) {
+        return "null";
+      }
+      if (arg === void 0) {
+        return "undefined";
+      }
+      if (typeof arg === "object") {
+        try {
+          return JSON.stringify(arg, null, 2);
+        } catch {
+          return String(arg);
+        }
+      }
+      return String(arg);
+    }).join(" ");
+  }
+  /**
+   * 添加日志条目
+   */
+  addEntry(entry) {
+    if (!this.enabled) {
+      return;
+    }
+    if (this.buffer.length >= this.maxSize) {
+      this.buffer.shift();
+    }
+    this.buffer.push(entry);
+  }
+  /**
+   * 添加 Provider stdout 日志
+   */
+  addProviderStdout(message) {
+    this.addEntry({
+      level: "info",
+      message,
+      timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+      source: "provider-stdout"
+    });
+  }
+  /**
+   * 添加 Provider stderr 日志
+   */
+  addProviderStderr(message) {
+    this.addEntry({
+      level: "error",
+      message,
+      timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+      source: "provider-stderr"
+    });
+  }
+  /**
+   * 获取日志
+   * @param options 过滤选项
+   */
+  getLogs(options = {}) {
+    let logs = [...this.buffer];
+    if (options.level) {
+      const levels = Array.isArray(options.level) ? options.level : [options.level];
+      logs = logs.filter((log) => levels.includes(log.level));
+    }
+    if (options.source) {
+      logs = logs.filter((log) => log.source === options.source);
+    }
+    if (options.since) {
+      const sinceDate = new Date(options.since);
+      logs = logs.filter((log) => new Date(log.timestamp) >= sinceDate);
+    }
+    if (options.limit && options.limit > 0) {
+      logs = logs.slice(-options.limit);
+    }
+    return logs;
+  }
+  /**
+   * 清空缓冲区
+   */
+  clear() {
+    this.buffer = [];
+  }
+  /**
+   * 获取缓冲区大小
+   */
+  size() {
+    return this.buffer.length;
+  }
+  /**
+   * 启用/禁用捕获
+   */
+  setEnabled(enabled) {
+    this.enabled = enabled;
+  }
+  /**
+   * 获取是否启用
+   */
+  isEnabled() {
+    return this.enabled;
+  }
+}
+let globalBuffer = null;
+function getProcessLogBuffer(options) {
+  if (!globalBuffer) {
+    globalBuffer = new ProcessLogBuffer(options);
+  }
+  return globalBuffer;
+}
+function initProcessLogCapture(options) {
+  const buffer = getProcessLogBuffer(options);
+  buffer.intercept();
+  return buffer;
+}
+function stopProcessLogCapture() {
+  if (globalBuffer) {
+    globalBuffer.restore();
+  }
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  getProcessLogBuffer,
+  initProcessLogCapture,
+  stopProcessLogCapture
+});

package/lib/process-logger.d.ts

@@ -0,0 +1,97 @@
+/**
+ * @fileoverview 进程日志捕获器
+ * @description 拦截 console 方法并存储日志到内存缓冲区，供 agent 通过工具获取
+ */
+export interface ProcessLogEntry {
+    /** 日志级别 */
+    level: "log" | "info" | "warn" | "error" | "debug";
+    /** 日志内容（已序列化为字符串） */
+    message: string;
+    /** 时间戳（ISO 格式） */
+    timestamp: string;
+    /** 来源标识 */
+    source?: "console" | "provider-stdout" | "provider-stderr" | "vite";
+}
+export interface ProcessLogBufferOptions {
+    /** 最大日志条数，默认 500 */
+    maxSize?: number;
+    /** 是否启用捕获，默认 true */
+    enabled?: boolean;
+}
+/**
+ * 进程日志缓冲区
+ */
+declare class ProcessLogBuffer {
+    private buffer;
+    private maxSize;
+    private enabled;
+    private originalConsole;
+    constructor(options?: ProcessLogBufferOptions);
+    /**
+     * 启动 console 拦截
+     */
+    intercept(): void;
+    /**
+     * 停止拦截，恢复原始 console
+     */
+    restore(): void;
+    /**
+     * 创建拦截器函数
+     */
+    private createInterceptor;
+    /**
+     * 序列化参数为字符串
+     */
+    private serializeArgs;
+    /**
+     * 添加日志条目
+     */
+    addEntry(entry: ProcessLogEntry): void;
+    /**
+     * 添加 Provider stdout 日志
+     */
+    addProviderStdout(message: string): void;
+    /**
+     * 添加 Provider stderr 日志
+     */
+    addProviderStderr(message: string): void;
+    /**
+     * 获取日志
+     * @param options 过滤选项
+     */
+    getLogs(options?: {
+        level?: ProcessLogEntry["level"] | ProcessLogEntry["level"][];
+        limit?: number;
+        source?: ProcessLogEntry["source"];
+        since?: string;
+    }): ProcessLogEntry[];
+    /**
+     * 清空缓冲区
+     */
+    clear(): void;
+    /**
+     * 获取缓冲区大小
+     */
+    size(): number;
+    /**
+     * 启用/禁用捕获
+     */
+    setEnabled(enabled: boolean): void;
+    /**
+     * 获取是否启用
+     */
+    isEnabled(): boolean;
+}
+/**
+ * 获取全局日志缓冲区
+ */
+export declare function getProcessLogBuffer(options?: ProcessLogBufferOptions): ProcessLogBuffer;
+/**
+ * 初始化进程日志捕获
+ */
+export declare function initProcessLogCapture(options?: ProcessLogBufferOptions): ProcessLogBuffer;
+/**
+ * 停止进程日志捕获
+ */
+export declare function stopProcessLogCapture(): void;
+export {};

package/lib/provider.cjs

@@ -0,0 +1,15 @@
+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 __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var provider_exports = {};
+module.exports = __toCommonJS(provider_exports);