@aipanel/core 1.2.0-beta.0

package/es/utils.mjs

@@ -0,0 +1,53 @@
+function truncate(value, maxLength) {
+  if (value.length <= maxLength) {
+    return value;
+  }
+  return `${value.slice(0, maxLength)}...`;
+}
+function sleep(ms) {
+  return new Promise((resolve) => setTimeout(resolve, ms));
+}
+function base64Encode(str) {
+  if (!str) {
+    throw new Error("base64Encode: input string is required");
+  }
+  const bytes = new TextEncoder().encode(str);
+  const binString = Array.from(bytes, (byte) => String.fromCodePoint(byte)).join("");
+  return btoa(binString).replace(/\+/g, "-").replace(/\//g, "_").replace(/=/g, "");
+}
+function base64Decode(base64) {
+  const standard = base64.replace(/-/g, "+").replace(/_/g, "/");
+  const binString = atob(standard);
+  const bytes = Uint8Array.from(binString, (c) => c.charCodeAt(0));
+  return new TextDecoder().decode(bytes);
+}
+function extractTextFromResponse(data) {
+  if (!data || typeof data !== "object") return null;
+  const obj = data;
+  if (obj.parts && Array.isArray(obj.parts)) {
+    const textParts = obj.parts.filter(
+      (p) => p && typeof p === "object" && p.type === "text"
+    ).map((p) => p.text).filter(Boolean);
+    if (textParts.length > 0) return textParts.join("");
+  }
+  if (obj.text && typeof obj.text === "string") {
+    return obj.text;
+  }
+  if (obj.content && typeof obj.content === "string") {
+    return obj.content;
+  }
+  if (obj.message && typeof obj.message === "string") {
+    return obj.message;
+  }
+  if (typeof data === "string") {
+    return data;
+  }
+  return null;
+}
+export {
+  base64Decode,
+  base64Encode,
+  extractTextFromResponse,
+  sleep,
+  truncate
+};

package/lib/constants.cjs

@@ -0,0 +1,188 @@
+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 constants_exports = {};
+__export(constants_exports, {
+  AUTO_OPEN_DELAY: () => AUTO_OPEN_DELAY,
+  BRIDGE_SCRIPT_PATH: () => BRIDGE_SCRIPT_PATH,
+  CHROME_DEVTOOLS_CHECK_TIMEOUT: () => CHROME_DEVTOOLS_CHECK_TIMEOUT,
+  CHROME_DEVTOOLS_PORT: () => CHROME_DEVTOOLS_PORT,
+  CONFIG_DATA_ATTR: () => CONFIG_DATA_ATTR,
+  CONTEXT_API_PATH: () => CONTEXT_API_PATH,
+  CONTEXT_MARKER: () => CONTEXT_MARKER,
+  CONTEXT_UPDATE_INTERVAL: () => CONTEXT_UPDATE_INTERVAL,
+  DEFAULT_HOSTNAME: () => DEFAULT_HOSTNAME,
+  DEFAULT_PROXY_PORT: () => DEFAULT_PROXY_PORT,
+  DEFAULT_RETRIES: () => DEFAULT_RETRIES,
+  DEFAULT_WEB_PORT: () => DEFAULT_WEB_PORT,
+  ENV_VSCODE_MODE: () => ENV_VSCODE_MODE,
+  ENV_VSCODE_PORT: () => ENV_VSCODE_PORT,
+  EXT_BROADCAST: () => EXT_BROADCAST,
+  EXT_MSG: () => EXT_MSG,
+  INIT_MARKER: () => INIT_MARKER,
+  INSPECTOR_CHECK_INTERVAL: () => INSPECTOR_CHECK_INTERVAL,
+  LOGS_API_PATH: () => LOGS_API_PATH,
+  LOG_PREFIX: () => LOG_PREFIX,
+  MAX_PORT_TRIES: () => MAX_PORT_TRIES,
+  MAX_TEXT_LENGTH: () => MAX_TEXT_LENGTH,
+  MCP_API_PATH: () => MCP_API_PATH,
+  NOTIFICATION_DURATION: () => NOTIFICATION_DURATION,
+  PAGE_CONTEXT_MARKER: () => PAGE_CONTEXT_MARKER,
+  PAGE_CONTEXT_MAX_TEXT_LENGTH: () => PAGE_CONTEXT_MAX_TEXT_LENGTH,
+  RETRY_DELAY: () => RETRY_DELAY,
+  SELECTED_ELEMENTS_KEY: () => SELECTED_ELEMENTS_KEY,
+  SERVER_CHECK_INTERVAL: () => SERVER_CHECK_INTERVAL,
+  SERVER_START_TIMEOUT: () => SERVER_START_TIMEOUT,
+  SERVER_SYNC_INTERVAL: () => SERVER_SYNC_INTERVAL,
+  SESSIONS_API_PATH: () => SESSIONS_API_PATH,
+  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,
+  VUE_DEVTOOLS_ACTIONS: () => VUE_DEVTOOLS_ACTIONS,
+  WARMUP_API_PATH: () => WARMUP_API_PATH,
+  WIDGET_MSG: () => WIDGET_MSG,
+  WIDGET_SCRIPT_PATH: () => WIDGET_SCRIPT_PATH,
+  WIDGET_STYLE_PATH: () => WIDGET_STYLE_PATH
+});
+module.exports = __toCommonJS(constants_exports);
+const DEFAULT_HOSTNAME = "127.0.0.1";
+const DEFAULT_WEB_PORT = 5097;
+const DEFAULT_PROXY_PORT = 6097;
+const SERVER_START_TIMEOUT = 3e5;
+const SERVER_CHECK_INTERVAL = 100;
+const DEFAULT_RETRIES = 5;
+const RETRY_DELAY = 500;
+const MAX_PORT_TRIES = 10;
+const LOG_PREFIX = "[vite-plugin-aipanel]";
+const WIDGET_SCRIPT_PATH = "/__aipanel_widget__.js";
+const CONFIG_DATA_ATTR = "data-aipanel-config";
+const CONTEXT_API_PATH = "/__aipanel_context__";
+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 CONTEXT_UPDATE_INTERVAL = 500;
+const SERVER_SYNC_INTERVAL = 2e3;
+const INSPECTOR_CHECK_INTERVAL = 500;
+const AUTO_OPEN_DELAY = 1e3;
+const NOTIFICATION_DURATION = 3e3;
+const INIT_MARKER = "__AIPANEL_INITIALIZED__";
+const SELECTED_ELEMENTS_KEY = "__aipanel_selected_elements__";
+const CHROME_DEVTOOLS_PORT = 9222;
+const CHROME_DEVTOOLS_CHECK_TIMEOUT = 2e3;
+const EXT_BROADCAST = {
+  PAGE_CONTEXT: "PAGE_CONTEXT",
+  THEME_CHANGE: "THEME_CHANGE",
+  SERVICE_APPEARED: "SERVICE_APPEARED",
+  SERVICE_GONE: "SERVICE_GONE"
+};
+const EXT_MSG = {
+  ...EXT_BROADCAST,
+  GET_PORT_INFO: "GET_PORT_INFO",
+  TAB_SWITCHED: "TAB_SWITCHED",
+  REQUEST_PAGE_CONTEXT: "REQUEST_PAGE_CONTEXT",
+  SELECTION_START: "SELECTION_START",
+  SELECTION_STOP: "SELECTION_STOP",
+  CS_QUERY_WINDOW: "__CS_QUERY_WINDOW__"
+};
+const WIDGET_MSG = {
+  READY: "AIPANEL_READY",
+  KEYDOWN: "AIPANEL_KEYDOWN",
+  SET_THEME: "AIPANEL_SET_THEME",
+  INSERT_FILE_PART: "AIPANEL_INSERT_FILE_PART",
+  SELECT_MODE_CHANGE: "AIPANEL_SELECT_MODE_CHANGE",
+  ELEMENT_SELECTED: "AIPANEL_ELEMENT_SELECTED",
+  SELECTION_CANCELLED: "AIPANEL_SELECTION_CANCELLED",
+  SELECTOR_START: "AIPANEL_SELECTOR_START",
+  SELECTOR_STOP: "AIPANEL_SELECTOR_STOP",
+  SERVICE_INFO: "AIPANEL_SERVICE_INFO",
+  MINIMIZE_STATE: "MINIMIZE_STATE_CHANGE",
+  PROMPT_DOCK_VISIBILITY: "PROMPT_DOCK_VISIBILITY_CHANGE",
+  REVIEW_PANEL_TOGGLE: "REVIEW_PANEL_TOGGLE",
+  /** 无 deepLink 能力的 Provider：通知 iframe 聚焦指定会话 */
+  FOCUS_SESSION: "AIPANEL_FOCUS_SESSION",
+  /** 无 deepLink 能力的 Provider：iframe 确认目标会话已激活且渲染稳定（携带 sessionId） */
+  SESSION_READY: "AIPANEL_SESSION_READY"
+};
+const WARMUP_API_PATH = "/__aipanel_warmup__";
+const BRIDGE_SCRIPT_PATH = "/__aipanel_bridge__.js";
+const LOGS_API_PATH = "/__aipanel_process_logs__";
+const WIDGET_STYLE_PATH = "/__aipanel_widget__.css";
+const MAX_TEXT_LENGTH = 100;
+const CONTEXT_MARKER = "[\u5143\u7D20\u4E0A\u4E0B\u6587]";
+const PAGE_CONTEXT_MARKER = "__AIPANEL_CONTEXT__";
+const PAGE_CONTEXT_MAX_TEXT_LENGTH = 1e4;
+const SEVERITY_ERROR = 1;
+const SEVERITY_WARN = 2;
+const VSCODE_EXTENSION_PORT = 51939;
+const ENV_VSCODE_MODE = "AIPANEL_VSCODE_MODE";
+const ENV_VSCODE_PORT = "AIPANEL_VSCODE_PORT";
+const VUE_DEVTOOLS_ACTIONS = {
+  GET_COMPONENT_TREE: "getComponentTree",
+  GET_COMPONENT_STATE: "getComponentState",
+  GET_COMPONENT_RENDER_CODE: "getComponentRenderCode",
+  GET_APPS: "getApps",
+  TOGGLE_APP: "toggleApp",
+  GET_ROUTER_INFO: "getRouterInfo"
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  AUTO_OPEN_DELAY,
+  BRIDGE_SCRIPT_PATH,
+  CHROME_DEVTOOLS_CHECK_TIMEOUT,
+  CHROME_DEVTOOLS_PORT,
+  CONFIG_DATA_ATTR,
+  CONTEXT_API_PATH,
+  CONTEXT_MARKER,
+  CONTEXT_UPDATE_INTERVAL,
+  DEFAULT_HOSTNAME,
+  DEFAULT_PROXY_PORT,
+  DEFAULT_RETRIES,
+  DEFAULT_WEB_PORT,
+  ENV_VSCODE_MODE,
+  ENV_VSCODE_PORT,
+  EXT_BROADCAST,
+  EXT_MSG,
+  INIT_MARKER,
+  INSPECTOR_CHECK_INTERVAL,
+  LOGS_API_PATH,
+  LOG_PREFIX,
+  MAX_PORT_TRIES,
+  MAX_TEXT_LENGTH,
+  MCP_API_PATH,
+  NOTIFICATION_DURATION,
+  PAGE_CONTEXT_MARKER,
+  PAGE_CONTEXT_MAX_TEXT_LENGTH,
+  RETRY_DELAY,
+  SELECTED_ELEMENTS_KEY,
+  SERVER_CHECK_INTERVAL,
+  SERVER_START_TIMEOUT,
+  SERVER_SYNC_INTERVAL,
+  SESSIONS_API_PATH,
+  SEVERITY_ERROR,
+  SEVERITY_WARN,
+  SSE_EVENTS_PATH,
+  START_API_PATH,
+  VSCODE_EXTENSION_PORT,
+  VUE_DEVTOOLS_ACTIONS,
+  WARMUP_API_PATH,
+  WIDGET_MSG,
+  WIDGET_SCRIPT_PATH,
+  WIDGET_STYLE_PATH
+});

package/lib/constants.d.ts

@@ -0,0 +1,145 @@
+/**
+ * @fileoverview 通用常量定义（Provider 无关）
+ * Provider 专属常量已下沉至 @aipanel/provider-opencode。
+ */
+/** ==================== 网络相关 ==================== */
+/** 默认主机名 */
+export declare const DEFAULT_HOSTNAME = "127.0.0.1";
+/** 默认 Web 服务端口 */
+export declare const DEFAULT_WEB_PORT = 5097;
+/** 默认代理服务端口 */
+export declare const DEFAULT_PROXY_PORT = 6097;
+/** 服务器启动超时时间（毫秒） */
+export declare const SERVER_START_TIMEOUT = 300000;
+/** 服务器检查间隔（毫秒） */
+export declare const SERVER_CHECK_INTERVAL = 100;
+/** ==================== 重试相关 ==================== */
+/** 默认重试次数 */
+export declare const DEFAULT_RETRIES = 5;
+/** 重试延迟（毫秒） */
+export declare const RETRY_DELAY = 500;
+/** ==================== 端口查找 ==================== */
+/** 最大端口尝试次数 */
+export declare const MAX_PORT_TRIES = 10;
+/** ==================== 日志相关 ==================== */
+/** 插件日志前缀 */
+export declare const LOG_PREFIX = "[vite-plugin-aipanel]";
+/** ==================== 挂件相关 ==================== */
+/** 挂件脚本路径 */
+export declare const WIDGET_SCRIPT_PATH = "/__aipanel_widget__.js";
+/** 配置数据属性名 */
+export declare const CONFIG_DATA_ATTR = "data-aipanel-config";
+/** 上下文 API 路径 */
+export declare const CONTEXT_API_PATH = "/__aipanel_context__";
+/** 启动 API 路径 */
+export declare const START_API_PATH = "/__aipanel_start__";
+/** 会话列表 API 路径 */
+export declare const SESSIONS_API_PATH = "/__aipanel_sessions__";
+/** MCP 代理 API 路径 */
+export declare const MCP_API_PATH = "/__aipanel_mcp__";
+/** SSE 事件流路径 */
+export declare const SSE_EVENTS_PATH = "/__aipanel_events__";
+/** 上下文更新间隔（毫秒） */
+export declare const CONTEXT_UPDATE_INTERVAL = 500;
+/** 服务器同步间隔（毫秒） */
+export declare const SERVER_SYNC_INTERVAL = 2000;
+/** Vue Inspector 检查间隔（毫秒） */
+export declare const INSPECTOR_CHECK_INTERVAL = 500;
+/** 自动打开延迟（毫秒） */
+export declare const AUTO_OPEN_DELAY = 1000;
+/** 通知显示时间（毫秒） */
+export declare const NOTIFICATION_DURATION = 3000;
+/** ==================== 存储相关 ==================== */
+/** 初始化标记 */
+export declare const INIT_MARKER = "__AIPANEL_INITIALIZED__";
+/** 选中元素存储键 */
+export declare const SELECTED_ELEMENTS_KEY = "__aipanel_selected_elements__";
+/** ==================== Chrome DevTools ==================== */
+/** Chrome DevTools Protocol 默认端口 */
+export declare const CHROME_DEVTOOLS_PORT = 9222;
+/** Chrome DevTools 检查超时时间（毫秒） */
+export declare const CHROME_DEVTOOLS_CHECK_TIMEOUT = 2000;
+/** ==================== 扩展消息类型 ==================== */
+/** 需要后台转发的消息类型（多实例间通信） */
+export declare const EXT_BROADCAST: {
+    readonly PAGE_CONTEXT: "PAGE_CONTEXT";
+    readonly THEME_CHANGE: "THEME_CHANGE";
+    readonly SERVICE_APPEARED: "SERVICE_APPEARED";
+    readonly SERVICE_GONE: "SERVICE_GONE";
+};
+/** Chrome 扩展内部消息类型（chrome.runtime.sendMessage） */
+export declare const EXT_MSG: {
+    readonly GET_PORT_INFO: "GET_PORT_INFO";
+    readonly TAB_SWITCHED: "TAB_SWITCHED";
+    readonly REQUEST_PAGE_CONTEXT: "REQUEST_PAGE_CONTEXT";
+    readonly SELECTION_START: "SELECTION_START";
+    readonly SELECTION_STOP: "SELECTION_STOP";
+    readonly CS_QUERY_WINDOW: "__CS_QUERY_WINDOW__";
+    readonly PAGE_CONTEXT: "PAGE_CONTEXT";
+    readonly THEME_CHANGE: "THEME_CHANGE";
+    readonly SERVICE_APPEARED: "SERVICE_APPEARED";
+    readonly SERVICE_GONE: "SERVICE_GONE";
+};
+/** ==================== Widget PostMessage 类型 ==================== */
+/** Widget PostMessage 消息类型 */
+export declare const WIDGET_MSG: {
+    readonly READY: "AIPANEL_READY";
+    readonly KEYDOWN: "AIPANEL_KEYDOWN";
+    readonly SET_THEME: "AIPANEL_SET_THEME";
+    readonly INSERT_FILE_PART: "AIPANEL_INSERT_FILE_PART";
+    readonly SELECT_MODE_CHANGE: "AIPANEL_SELECT_MODE_CHANGE";
+    readonly ELEMENT_SELECTED: "AIPANEL_ELEMENT_SELECTED";
+    readonly SELECTION_CANCELLED: "AIPANEL_SELECTION_CANCELLED";
+    readonly SELECTOR_START: "AIPANEL_SELECTOR_START";
+    readonly SELECTOR_STOP: "AIPANEL_SELECTOR_STOP";
+    readonly SERVICE_INFO: "AIPANEL_SERVICE_INFO";
+    readonly MINIMIZE_STATE: "MINIMIZE_STATE_CHANGE";
+    readonly PROMPT_DOCK_VISIBILITY: "PROMPT_DOCK_VISIBILITY_CHANGE";
+    readonly REVIEW_PANEL_TOGGLE: "REVIEW_PANEL_TOGGLE";
+    /** 无 deepLink 能力的 Provider：通知 iframe 聚焦指定会话 */
+    readonly FOCUS_SESSION: "AIPANEL_FOCUS_SESSION";
+    /** 无 deepLink 能力的 Provider：iframe 确认目标会话已激活且渲染稳定（携带 sessionId） */
+    readonly SESSION_READY: "AIPANEL_SESSION_READY";
+};
+/** ==================== API 路径补充 ==================== */
+/** Provider 预热 API 路径 */
+export declare const WARMUP_API_PATH = "/__aipanel_warmup__";
+/** Bridge 脚本路径 */
+export declare const BRIDGE_SCRIPT_PATH = "/__aipanel_bridge__.js";
+/** 进程日志 API 路径 */
+export declare const LOGS_API_PATH = "/__aipanel_process_logs__";
+/** Widget 样式路径 */
+export declare const WIDGET_STYLE_PATH = "/__aipanel_widget__.css";
+/** ==================== 文本处理 ==================== */
+/** 元素文本最大显示长度 */
+export declare const MAX_TEXT_LENGTH = 100;
+/** 元素上下文标记 */
+export declare const CONTEXT_MARKER = "[\u5143\u7D20\u4E0A\u4E0B\u6587]";
+/** 页面上下文内部标记（用于插件） */
+export declare const PAGE_CONTEXT_MARKER = "__AIPANEL_CONTEXT__";
+/** 页面上下文文本最大长度 */
+export declare const PAGE_CONTEXT_MAX_TEXT_LENGTH = 10000;
+/** ==================== 诊断 Severity ==================== */
+/**
+ * 诊断 severity 常量，使用 LSP DiagnosticSeverity 规范值
+ * Error=1, Warning=2, Information=3, Hint=4
+ */
+export declare const SEVERITY_ERROR = 1;
+export declare const SEVERITY_WARN = 2;
+/** ==================== VS Code 扩展桥接 ==================== */
+/** VS Code 扩展 HTTP 服务端口（vscode-extension ↔ provider 通信协议） */
+export declare const VSCODE_EXTENSION_PORT = 51939;
+/** VS Code 扩展相关环境变量名 */
+export declare const ENV_VSCODE_MODE = "AIPANEL_VSCODE_MODE";
+export declare const ENV_VSCODE_PORT = "AIPANEL_VSCODE_PORT";
+/** ==================== Vue DevTools API ==================== */
+/** Vue DevTools API action 名称 */
+export declare const VUE_DEVTOOLS_ACTIONS: {
+    readonly GET_COMPONENT_TREE: "getComponentTree";
+    readonly GET_COMPONENT_STATE: "getComponentState";
+    readonly GET_COMPONENT_RENDER_CODE: "getComponentRenderCode";
+    readonly GET_APPS: "getApps";
+    readonly TOGGLE_APP: "toggleApp";
+    readonly GET_ROUTER_INFO: "getRouterInfo";
+};
+export type VueDevtoolsAction = (typeof VUE_DEVTOOLS_ACTIONS)[keyof typeof VUE_DEVTOOLS_ACTIONS];

package/lib/file-log-watcher.cjs

@@ -0,0 +1,160 @@
+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 file_log_watcher_exports = {};
+__export(file_log_watcher_exports, {
+  readLogFile: () => readLogFile,
+  readLogFileTail: () => readLogFileTail
+});
+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");
+const log = (0, import_logger.createLogger)("FileLogReader");
+function detectLogLevel(line) {
+  const lowerLine = line.toLowerCase();
+  if (lowerLine.includes("error") || lowerLine.includes("err") || lowerLine.includes("fatal")) {
+    return "error";
+  }
+  if (lowerLine.includes("warn") || lowerLine.includes("warning")) {
+    return "warn";
+  }
+  return "info";
+}
+async function readLogFile(options) {
+  const { name, filePath, projectRoot, level, limit } = options;
+  const resolvedPath = resolvePath(filePath, projectRoot);
+  if (!import_fs.default.existsSync(resolvedPath)) {
+    log.debug(`Log file does not exist: ${resolvedPath}`);
+    return [];
+  }
+  try {
+    const content = await import_fs.default.promises.readFile(resolvedPath, "utf-8");
+    const lines = content.split("\n").filter((line) => line.trim());
+    const entries = [];
+    for (const line of lines) {
+      const entry = {
+        level: detectLogLevel(line),
+        message: line,
+        source: `file:${name}`
+      };
+      if (level) {
+        const levels = Array.isArray(level) ? level : [level];
+        if (!levels.includes(entry.level)) {
+          continue;
+        }
+      }
+      entries.push(entry);
+    }
+    if (limit && limit > 0) {
+      return entries.slice(-limit);
+    }
+    return entries;
+  } catch (err) {
+    log.error(`Error reading log file ${resolvedPath}`, { error: err });
+    return [];
+  }
+}
+async function readLogFileTail(options) {
+  const { name, filePath, projectRoot, lines = 200, limit, level } = options;
+  const resolvedPath = resolvePath(filePath, projectRoot);
+  if (!import_fs.default.existsSync(resolvedPath)) {
+    log.debug(`Log file does not exist: ${resolvedPath}`);
+    return [];
+  }
+  try {
+    const stat = import_fs.default.statSync(resolvedPath);
+    const fd = import_fs.default.openSync(resolvedPath, "r");
+    const chunkSize = 16 * 1024;
+    let position = stat.size;
+    let buffer = Buffer.alloc(0);
+    let lineCount = 0;
+    while (position > 0 && lineCount <= lines) {
+      const readSize = Math.min(chunkSize, position);
+      position -= readSize;
+      const chunk = Buffer.alloc(readSize);
+      import_fs.default.readSync(fd, chunk, 0, readSize, position);
+      buffer = Buffer.concat([chunk, buffer]);
+      const newLineCount = buffer.filter((byte) => byte === 10).length;
+      lineCount = newLineCount;
+      if (newLineCount >= lines) {
+        const linesArray = buffer.toString("utf-8").split("\n");
+        const excessLines = newLineCount - lines;
+        let charsToRemove = 0;
+        let count = 0;
+        for (let i = 0; i < linesArray.length; i++) {
+          count += linesArray[i].length + 1;
+          if (count > excessLines) {
+            charsToRemove = linesArray.slice(0, i + 1).join("\n").length + 1;
+            break;
+          }
+        }
+        buffer = buffer.slice(charsToRemove);
+        break;
+      }
+    }
+    import_fs.default.closeSync(fd);
+    const content = buffer.toString("utf-8").trim();
+    const logLines = content.split("\n").filter((line) => line.trim());
+    const entries = [];
+    for (const line of logLines) {
+      const entry = {
+        level: detectLogLevel(line),
+        message: line,
+        source: `file:${name}`
+      };
+      if (level) {
+        const levels = Array.isArray(level) ? level : [level];
+        if (!levels.includes(entry.level)) {
+          continue;
+        }
+      }
+      entries.push(entry);
+    }
+    if (limit && limit > 0) {
+      return entries.slice(-limit);
+    }
+    return entries;
+  } catch (err) {
+    log.error(`Error reading log file ${resolvedPath}`, { error: err });
+    return [];
+  }
+}
+function resolvePath(filePath, projectRoot) {
+  if (import_path.default.isAbsolute(filePath)) {
+    return filePath;
+  }
+  if (projectRoot) {
+    return import_path.default.resolve(projectRoot, filePath);
+  }
+  return import_path.default.resolve(process.cwd(), filePath);
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  readLogFile,
+  readLogFileTail
+});

package/lib/file-log-watcher.d.ts

@@ -0,0 +1,20 @@
+export interface FileLogEntry {
+    level: "info" | "warn" | "error";
+    message: string;
+    source: string;
+}
+export interface LogFileOptions {
+    name: string;
+    filePath: string;
+}
+export declare function readLogFile(options: LogFileOptions & {
+    projectRoot?: string;
+    level?: ("info" | "warn" | "error") | ("info" | "warn" | "error")[];
+    limit?: number;
+}): Promise<FileLogEntry[]>;
+export declare function readLogFileTail(options: LogFileOptions & {
+    projectRoot?: string;
+    lines?: number;
+    limit?: number;
+    level?: ("info" | "warn" | "error") | ("info" | "warn" | "error")[];
+}): Promise<FileLogEntry[]>;

package/lib/index.cjs

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

package/lib/index.d.ts

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