@aipanel/core 1.2.8 → 1.2.10

package/lib/node/node-utils.cjs

@@ -0,0 +1,329 @@
+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,
+  checkCliInstalled: () => checkCliInstalled,
+  createPackageRequire: () => createPackageRequire,
+  findAvailablePort: () => findAvailablePort,
+  findGitRoot: () => findGitRoot,
+  getCliVersion: () => getCliVersion,
+  isPortAvailable: () => isPortAvailable,
+  killOrphanCliProcesses: () => killOrphanCliProcesses,
+  resolvePackageDir: () => resolvePackageDir,
+  waitForServer: () => waitForServer
+});
+module.exports = __toCommonJS(node_utils_exports);
+var import_node_child_process = require("node:child_process");
+var import_node_module = require("node:module");
+var import_node_fs = __toESM(require("node:fs"));
+var import_node_http = __toESM(require("node:http"));
+var import_node_path = __toESM(require("node:path"));
+var import_constants = require("../common/constants.cjs");
+var import_node_logger = require("./node-logger.cjs");
+const log = (0, import_node_logger.createLogger)("NodeUtils");
+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}`);
+}
+function waitForServer(url, timeout = 1e4, proc) {
+  const timer = new import_node_logger.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 = import_node_http.default.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, import_constants.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 import_node_logger.PerformanceTimer("findGitRoot", { startDir, maxDepth });
+  let currentDir = startDir;
+  let depth = 0;
+  while (depth < maxDepth) {
+    const gitDir = import_node_path.default.join(currentDir, ".git");
+    try {
+      if (import_node_fs.default.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 = import_node_path.default.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 import_node_logger.PerformanceTimer(`checkCliInstalled:${bin}`);
+  return new Promise((resolve) => {
+    const proc = (0, import_node_child_process.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 = (0, import_node_child_process.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 import_node_logger.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 = (0, import_node_child_process.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 = (0, import_node_child_process.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 = (0, import_node_child_process.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 = (0, import_node_child_process.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);
+  });
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  checkChromeDevToolsAvailable,
+  checkCliInstalled,
+  createPackageRequire,
+  findAvailablePort,
+  findGitRoot,
+  getCliVersion,
+  isPortAvailable,
+  killOrphanCliProcesses,
+  resolvePackageDir,
+  waitForServer
+});

package/lib/node/node-utils.d.ts

@@ -0,0 +1,69 @@
+/**
+ * @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>;
+/**
+ * 可等待的进程接口（ResultPromise 等匹配就够）
+ */
+export interface WaitableProcess {
+    exitCode: number | null | undefined;
+}
+/**
+ * 轮询等待服务准备就绪（HTTP 状态码 < 500 即当作 ready）；超时或进程退出时 reject
+ * @param url - 检查的服务 URL
+ * @param timeout - 超时毫秒数
+ * @param proc - 可选进程，提前退出时直接失败
+ */
+export declare function waitForServer(url: string, timeout?: number, proc?: WaitableProcess): Promise<void>;
+/**
+ * 从指定目录往上查找 .git 根目录（找不到时返回起始目录）
+ */
+export declare function findGitRoot(startDir: string, maxDepth?: number): string;
+/**
+ * 检查某 CLI 是否安装（运行 <bin> --version，退出码 0 即存在）
+ */
+export declare function checkCliInstalled(bin: string): Promise<boolean>;
+/**
+ * 获取某 CLI 版本号（<bin> --version 的第一行，败路返回 null）
+ */
+export declare function getCliVersion(bin: string): Promise<string | null>;
+/** 孤儿进程清理配置（提供商的 check/kill 统一实现） */
+export interface KillOrphanCliOptions {
+    /** 进程命令行/参数中需匹配的子串（如 opencode / dsh） */
+    match: string;
+    /** Windows wmic 按名称查询的进程名（如 opencode.exe / node.exe） */
+    winName: string;
+    /** 超时毫秒（默认 5000） */
+    timeout?: number;
+    /** 运行名（仅用于日志，默认等于 match） */
+    label?: string;
+}
+/**
+ * 清理被 reparent 到 init（PPID=1）的孤儿进程（win: wmic+taskkill；unix: ps+kill）
+ * @returns 被成功结束的进程数
+ */
+export declare function killOrphanCliProcesses(bin: string, options: KillOrphanCliOptions): Promise<number>;

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.10",
   "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",

package/es/node-utils.d.ts

@@ -1,28 +0,0 @@
-/**
- * @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/es/node-utils.mjs

@@ -1,56 +0,0 @@
-import { createRequire } from "node:module";
-import path from "node:path";
-import { CHROME_DEVTOOLS_PORT, CHROME_DEVTOOLS_CHECK_TIMEOUT } from "./constants.mjs";
-function createPackageRequire(baseDir = process.cwd()) {
-  return createRequire(path.join(baseDir, "package.json"));
-}
-function resolvePackageDir(packageName, baseDir = process.cwd()) {
-  const require2 = createPackageRequire(baseDir);
-  const entryPath = require2.resolve(packageName);
-  return path.dirname(path.dirname(entryPath));
-}
-async function checkChromeDevToolsAvailable(port = CHROME_DEVTOOLS_PORT, timeout = 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}`);
-}
-export {
-  checkChromeDevToolsAvailable,
-  createPackageRequire,
-  findAvailablePort,
-  isPortAvailable,
-  resolvePackageDir
-};

package/lib/node-utils.cjs

@@ -1,93 +0,0 @@
-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

@@ -1,28 +0,0 @@
-/**
- * @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>;