@vite-plugin-opencode-assistant/shared 1.0.57 → 1.0.58

package/es/constants.d.ts

@@ -109,4 +109,11 @@ export declare const DEFAULT_CONFIG: {
     } | undefined;
     language: OpenCodeLanguage | undefined;
     settings: OpenCodeSettings | undefined;
+    logFiles: Array<{
+        name: string;
+        path: string;
+        description: string;
+        watchExisting?: boolean;
+        maxBufferSize?: number;
+    }> | undefined;
 };

package/es/constants.mjs

@@ -54,7 +54,9 @@ const DEFAULT_CONFIG = {
   splitMode: void 0,
   // OpenCode 内部配置默认值
   language: void 0,
-  settings: void 0
+  settings: void 0,
+  // 日志文件配置
+  logFiles: void 0
 };
 export {
   AUTO_OPEN_DELAY,

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

@@ -0,0 +1,53 @@
+export interface FileLogEntry {
+    level: "info" | "warn" | "error";
+    message: string;
+    timestamp: string;
+    source: string;
+}
+export interface FileLogBufferOptions {
+    name: string;
+    filePath: string;
+    maxBufferSize?: number;
+    watchExisting?: boolean;
+}
+declare class FileLogBuffer {
+    private buffer;
+    private maxSize;
+    private name;
+    private filePath;
+    private lastPosition;
+    private watcher;
+    private enabled;
+    constructor(options: FileLogBufferOptions);
+    start(projectRoot?: string): void;
+    stop(): void;
+    private resolvePath;
+    private readNewLogs;
+    private processLogContent;
+    private detectLogLevel;
+    addEntry(entry: FileLogEntry): void;
+    getLogs(options?: {
+        level?: FileLogEntry["level"] | FileLogEntry["level"][];
+        limit?: number;
+        since?: string;
+    }): FileLogEntry[];
+    clear(): void;
+    size(): number;
+    setEnabled(enabled: boolean): void;
+    isEnabled(): boolean;
+    getName(): string;
+    getFilePath(): string;
+}
+export declare class ServiceLogWatcher {
+    private buffers;
+    private projectRoot;
+    setProjectRoot(root: string): void;
+    addLogFile(options: FileLogBufferOptions): void;
+    removeLogFile(name: string): void;
+    getBuffer(name: string): FileLogBuffer | undefined;
+    getAllBuffers(): Map<string, FileLogBuffer>;
+    stopAll(): void;
+    getLogFileNames(): string[];
+}
+export declare function getServiceLogWatcher(): ServiceLogWatcher;
+export {};

package/es/file-log-watcher.mjs

@@ -0,0 +1,193 @@
+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 fs from "fs";
+import path from "path";
+import { createLogger } from "./logger.mjs";
+const log = createLogger("FileLogWatcher");
+class FileLogBuffer {
+  constructor(options) {
+    __publicField(this, "buffer", []);
+    __publicField(this, "maxSize");
+    __publicField(this, "name");
+    __publicField(this, "filePath");
+    __publicField(this, "lastPosition", 0);
+    __publicField(this, "watcher", null);
+    __publicField(this, "enabled", false);
+    var _a;
+    this.name = options.name;
+    this.filePath = options.filePath;
+    this.maxSize = (_a = options.maxBufferSize) != null ? _a : 200;
+    this.enabled = true;
+  }
+  start(projectRoot) {
+    const resolvedPath = this.resolvePath(projectRoot);
+    if (!fs.existsSync(resolvedPath)) {
+      log.debug(`Log file does not exist: ${resolvedPath}`);
+      return;
+    }
+    const stat = fs.statSync(resolvedPath);
+    this.lastPosition = stat.size;
+    this.watcher = fs.watch(resolvedPath, (eventType) => {
+      if (eventType === "change") {
+        this.readNewLogs(resolvedPath);
+      }
+    });
+    this.watcher.on("error", (err) => {
+      log.error(`Error watching file ${resolvedPath}`, { error: err });
+    });
+    log.info(`Started watching log file: ${resolvedPath}`);
+  }
+  stop() {
+    if (this.watcher) {
+      this.watcher.close();
+      this.watcher = null;
+      log.debug(`Stopped watching log file: ${this.filePath}`);
+    }
+  }
+  resolvePath(projectRoot) {
+    if (path.isAbsolute(this.filePath)) {
+      return this.filePath;
+    }
+    if (projectRoot) {
+      return path.resolve(projectRoot, this.filePath);
+    }
+    return path.resolve(process.cwd(), this.filePath);
+  }
+  readNewLogs(filePath) {
+    try {
+      const stat = fs.statSync(filePath);
+      if (stat.size <= this.lastPosition) {
+        return;
+      }
+      const fd = fs.openSync(filePath, "r");
+      const buffer = Buffer.alloc(stat.size - this.lastPosition);
+      fs.readSync(fd, buffer, 0, buffer.length, this.lastPosition);
+      fs.closeSync(fd);
+      this.lastPosition = stat.size;
+      const content = buffer.toString("utf-8").trim();
+      if (content) {
+        this.processLogContent(content);
+      }
+    } catch (err) {
+      log.error(`Error reading log file ${filePath}`, { error: err });
+    }
+  }
+  processLogContent(content) {
+    const lines = content.split("\n");
+    for (const line of lines) {
+      if (!line.trim()) continue;
+      this.addEntry({
+        level: this.detectLogLevel(line),
+        message: line,
+        timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+        source: `file:${this.name}`
+      });
+    }
+  }
+  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";
+  }
+  addEntry(entry) {
+    if (!this.enabled) return;
+    if (this.buffer.length >= this.maxSize) {
+      this.buffer.shift();
+    }
+    this.buffer.push(entry);
+  }
+  getLogs(options = {}) {
+    let logs = [...this.buffer];
+    if (options.level) {
+      const levels = Array.isArray(options.level) ? options.level : [options.level];
+      logs = logs.filter((log2) => levels.includes(log2.level));
+    }
+    if (options.since) {
+      const sinceDate = new Date(options.since);
+      logs = logs.filter((log2) => new Date(log2.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;
+  }
+  getName() {
+    return this.name;
+  }
+  getFilePath() {
+    return this.filePath;
+  }
+}
+class ServiceLogWatcher {
+  constructor() {
+    __publicField(this, "buffers", /* @__PURE__ */ new Map());
+    __publicField(this, "projectRoot", null);
+  }
+  setProjectRoot(root) {
+    this.projectRoot = root;
+  }
+  addLogFile(options) {
+    var _a;
+    if (this.buffers.has(options.name)) {
+      log.warn(`Log file "${options.name}" already exists, skipping`);
+      return;
+    }
+    const buffer = new FileLogBuffer(options);
+    buffer.start((_a = this.projectRoot) != null ? _a : void 0);
+    this.buffers.set(options.name, buffer);
+    log.info(`Added log file watcher: ${options.name} -> ${options.filePath}`);
+  }
+  removeLogFile(name) {
+    const buffer = this.buffers.get(name);
+    if (buffer) {
+      buffer.stop();
+      this.buffers.delete(name);
+      log.info(`Removed log file watcher: ${name}`);
+    }
+  }
+  getBuffer(name) {
+    return this.buffers.get(name);
+  }
+  getAllBuffers() {
+    return this.buffers;
+  }
+  stopAll() {
+    for (const [name, buffer] of this.buffers) {
+      buffer.stop();
+      log.debug(`Stopped log file watcher: ${name}`);
+    }
+    this.buffers.clear();
+  }
+  getLogFileNames() {
+    return Array.from(this.buffers.keys());
+  }
+}
+let globalWatcher = null;
+function getServiceLogWatcher() {
+  if (!globalWatcher) {
+    globalWatcher = new ServiceLogWatcher();
+  }
+  return globalWatcher;
+}
+export {
+  ServiceLogWatcher,
+  getServiceLogWatcher
+};

package/es/index.d.ts

@@ -1,4 +1,5 @@
 export * from "./constants";
+export * from "./file-log-watcher";
 export * from "./logger";
 export * from "./process-logger";
 export * from "./types";

package/es/index.mjs

@@ -1,4 +1,5 @@
 export * from "./constants.mjs";
+export * from "./file-log-watcher.mjs";
 export * from "./logger.mjs";
 export * from "./process-logger.mjs";
 export * from "./types.mjs";

package/es/types.d.ts

@@ -84,6 +84,21 @@ export interface SplitModeOptions {
     /** 面板位置，默认 'right' */
     position?: "left" | "right";
 }
+/**
+ * 日志文件配置
+ */
+export interface LogFileConfig {
+    /** 日志文件的唯一标识符，用于工具调用时指定 */
+    name: string;
+    /** 日志文件路径（绝对路径或相对于项目根目录的相对路径） */
+    path: string;
+    /** 工具描述，告诉 Agent 何时使用此工具查看日志 */
+    description: string;
+    /** 是否监控已存在的文件内容，默认 false（只监控新增内容） */
+    watchExisting?: boolean;
+    /** 日志缓冲区最大条数，默认 200 */
+    maxBufferSize?: number;
+}
 /**
  * OpenCode Vite 插件配置选项
  */
@@ -116,6 +131,8 @@ export interface OpenCodeOptions {
     language?: OpenCodeLanguage;
     /** OpenCode 内部设置，直接映射到 localStorage settings.v3 */
     settings?: OpenCodeSettings;
+    /** 自定义日志文件配置，为 Agent 提供查看外部服务日志的能力 */
+    logFiles?: LogFileConfig[];
 }
 /**
  * OpenCode Web 服务启动选项
@@ -137,6 +154,8 @@ export interface WebOptions {
     contextApiUrl?: string;
     /** 进程日志 API URL */
     logsApiUrl?: string;
+    /** 日志文件配置（JSON 字符串） */
+    logFilesJson?: string;
 }
 /**
  * 挂件注入配置选项

package/lib/constants.cjs

@@ -108,7 +108,9 @@ const DEFAULT_CONFIG = {
   splitMode: void 0,
   // OpenCode 内部配置默认值
   language: void 0,
-  settings: void 0
+  settings: void 0,
+  // 日志文件配置
+  logFiles: void 0
 };
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {

package/lib/constants.d.ts

@@ -109,4 +109,11 @@ export declare const DEFAULT_CONFIG: {
     } | undefined;
     language: OpenCodeLanguage | undefined;
     settings: OpenCodeSettings | undefined;
+    logFiles: Array<{
+        name: string;
+        path: string;
+        description: string;
+        watchExisting?: boolean;
+        maxBufferSize?: number;
+    }> | undefined;
 };

package/lib/file-log-watcher.cjs

@@ -0,0 +1,226 @@
+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 __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 __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 __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
+var file_log_watcher_exports = {};
+__export(file_log_watcher_exports, {
+  ServiceLogWatcher: () => ServiceLogWatcher,
+  getServiceLogWatcher: () => getServiceLogWatcher
+});
+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)("FileLogWatcher");
+class FileLogBuffer {
+  constructor(options) {
+    __publicField(this, "buffer", []);
+    __publicField(this, "maxSize");
+    __publicField(this, "name");
+    __publicField(this, "filePath");
+    __publicField(this, "lastPosition", 0);
+    __publicField(this, "watcher", null);
+    __publicField(this, "enabled", false);
+    var _a;
+    this.name = options.name;
+    this.filePath = options.filePath;
+    this.maxSize = (_a = options.maxBufferSize) != null ? _a : 200;
+    this.enabled = true;
+  }
+  start(projectRoot) {
+    const resolvedPath = this.resolvePath(projectRoot);
+    if (!import_fs.default.existsSync(resolvedPath)) {
+      log.debug(`Log file does not exist: ${resolvedPath}`);
+      return;
+    }
+    const stat = import_fs.default.statSync(resolvedPath);
+    this.lastPosition = stat.size;
+    this.watcher = import_fs.default.watch(resolvedPath, (eventType) => {
+      if (eventType === "change") {
+        this.readNewLogs(resolvedPath);
+      }
+    });
+    this.watcher.on("error", (err) => {
+      log.error(`Error watching file ${resolvedPath}`, { error: err });
+    });
+    log.info(`Started watching log file: ${resolvedPath}`);
+  }
+  stop() {
+    if (this.watcher) {
+      this.watcher.close();
+      this.watcher = null;
+      log.debug(`Stopped watching log file: ${this.filePath}`);
+    }
+  }
+  resolvePath(projectRoot) {
+    if (import_path.default.isAbsolute(this.filePath)) {
+      return this.filePath;
+    }
+    if (projectRoot) {
+      return import_path.default.resolve(projectRoot, this.filePath);
+    }
+    return import_path.default.resolve(process.cwd(), this.filePath);
+  }
+  readNewLogs(filePath) {
+    try {
+      const stat = import_fs.default.statSync(filePath);
+      if (stat.size <= this.lastPosition) {
+        return;
+      }
+      const fd = import_fs.default.openSync(filePath, "r");
+      const buffer = Buffer.alloc(stat.size - this.lastPosition);
+      import_fs.default.readSync(fd, buffer, 0, buffer.length, this.lastPosition);
+      import_fs.default.closeSync(fd);
+      this.lastPosition = stat.size;
+      const content = buffer.toString("utf-8").trim();
+      if (content) {
+        this.processLogContent(content);
+      }
+    } catch (err) {
+      log.error(`Error reading log file ${filePath}`, { error: err });
+    }
+  }
+  processLogContent(content) {
+    const lines = content.split("\n");
+    for (const line of lines) {
+      if (!line.trim()) continue;
+      this.addEntry({
+        level: this.detectLogLevel(line),
+        message: line,
+        timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+        source: `file:${this.name}`
+      });
+    }
+  }
+  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";
+  }
+  addEntry(entry) {
+    if (!this.enabled) return;
+    if (this.buffer.length >= this.maxSize) {
+      this.buffer.shift();
+    }
+    this.buffer.push(entry);
+  }
+  getLogs(options = {}) {
+    let logs = [...this.buffer];
+    if (options.level) {
+      const levels = Array.isArray(options.level) ? options.level : [options.level];
+      logs = logs.filter((log2) => levels.includes(log2.level));
+    }
+    if (options.since) {
+      const sinceDate = new Date(options.since);
+      logs = logs.filter((log2) => new Date(log2.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;
+  }
+  getName() {
+    return this.name;
+  }
+  getFilePath() {
+    return this.filePath;
+  }
+}
+class ServiceLogWatcher {
+  constructor() {
+    __publicField(this, "buffers", /* @__PURE__ */ new Map());
+    __publicField(this, "projectRoot", null);
+  }
+  setProjectRoot(root) {
+    this.projectRoot = root;
+  }
+  addLogFile(options) {
+    var _a;
+    if (this.buffers.has(options.name)) {
+      log.warn(`Log file "${options.name}" already exists, skipping`);
+      return;
+    }
+    const buffer = new FileLogBuffer(options);
+    buffer.start((_a = this.projectRoot) != null ? _a : void 0);
+    this.buffers.set(options.name, buffer);
+    log.info(`Added log file watcher: ${options.name} -> ${options.filePath}`);
+  }
+  removeLogFile(name) {
+    const buffer = this.buffers.get(name);
+    if (buffer) {
+      buffer.stop();
+      this.buffers.delete(name);
+      log.info(`Removed log file watcher: ${name}`);
+    }
+  }
+  getBuffer(name) {
+    return this.buffers.get(name);
+  }
+  getAllBuffers() {
+    return this.buffers;
+  }
+  stopAll() {
+    for (const [name, buffer] of this.buffers) {
+      buffer.stop();
+      log.debug(`Stopped log file watcher: ${name}`);
+    }
+    this.buffers.clear();
+  }
+  getLogFileNames() {
+    return Array.from(this.buffers.keys());
+  }
+}
+let globalWatcher = null;
+function getServiceLogWatcher() {
+  if (!globalWatcher) {
+    globalWatcher = new ServiceLogWatcher();
+  }
+  return globalWatcher;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  ServiceLogWatcher,
+  getServiceLogWatcher
+});

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

@@ -0,0 +1,53 @@
+export interface FileLogEntry {
+    level: "info" | "warn" | "error";
+    message: string;
+    timestamp: string;
+    source: string;
+}
+export interface FileLogBufferOptions {
+    name: string;
+    filePath: string;
+    maxBufferSize?: number;
+    watchExisting?: boolean;
+}
+declare class FileLogBuffer {
+    private buffer;
+    private maxSize;
+    private name;
+    private filePath;
+    private lastPosition;
+    private watcher;
+    private enabled;
+    constructor(options: FileLogBufferOptions);
+    start(projectRoot?: string): void;
+    stop(): void;
+    private resolvePath;
+    private readNewLogs;
+    private processLogContent;
+    private detectLogLevel;
+    addEntry(entry: FileLogEntry): void;
+    getLogs(options?: {
+        level?: FileLogEntry["level"] | FileLogEntry["level"][];
+        limit?: number;
+        since?: string;
+    }): FileLogEntry[];
+    clear(): void;
+    size(): number;
+    setEnabled(enabled: boolean): void;
+    isEnabled(): boolean;
+    getName(): string;
+    getFilePath(): string;
+}
+export declare class ServiceLogWatcher {
+    private buffers;
+    private projectRoot;
+    setProjectRoot(root: string): void;
+    addLogFile(options: FileLogBufferOptions): void;
+    removeLogFile(name: string): void;
+    getBuffer(name: string): FileLogBuffer | undefined;
+    getAllBuffers(): Map<string, FileLogBuffer>;
+    stopAll(): void;
+    getLogFileNames(): string[];
+}
+export declare function getServiceLogWatcher(): ServiceLogWatcher;
+export {};

package/lib/index.cjs

@@ -15,6 +15,7 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 var lib_exports = {};
 module.exports = __toCommonJS(lib_exports);
 __reExport(lib_exports, require("./constants.cjs"), module.exports);
+__reExport(lib_exports, require("./file-log-watcher.cjs"), module.exports);
 __reExport(lib_exports, require("./logger.cjs"), module.exports);
 __reExport(lib_exports, require("./process-logger.cjs"), module.exports);
 __reExport(lib_exports, require("./types.cjs"), module.exports);
@@ -22,6 +23,7 @@ __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("./file-log-watcher.cjs"),
   ...require("./logger.cjs"),
   ...require("./process-logger.cjs"),
   ...require("./types.cjs"),

package/lib/index.d.ts

@@ -1,4 +1,5 @@
 export * from "./constants";
+export * from "./file-log-watcher";
 export * from "./logger";
 export * from "./process-logger";
 export * from "./types";

package/lib/types.d.ts

@@ -84,6 +84,21 @@ export interface SplitModeOptions {
     /** 面板位置，默认 'right' */
     position?: "left" | "right";
 }
+/**
+ * 日志文件配置
+ */
+export interface LogFileConfig {
+    /** 日志文件的唯一标识符，用于工具调用时指定 */
+    name: string;
+    /** 日志文件路径（绝对路径或相对于项目根目录的相对路径） */
+    path: string;
+    /** 工具描述，告诉 Agent 何时使用此工具查看日志 */
+    description: string;
+    /** 是否监控已存在的文件内容，默认 false（只监控新增内容） */
+    watchExisting?: boolean;
+    /** 日志缓冲区最大条数，默认 200 */
+    maxBufferSize?: number;
+}
 /**
  * OpenCode Vite 插件配置选项
  */
@@ -116,6 +131,8 @@ export interface OpenCodeOptions {
     language?: OpenCodeLanguage;
     /** OpenCode 内部设置，直接映射到 localStorage settings.v3 */
     settings?: OpenCodeSettings;
+    /** 自定义日志文件配置，为 Agent 提供查看外部服务日志的能力 */
+    logFiles?: LogFileConfig[];
 }
 /**
  * OpenCode Web 服务启动选项
@@ -137,6 +154,8 @@ export interface WebOptions {
     contextApiUrl?: string;
     /** 进程日志 API URL */
     logsApiUrl?: string;
+    /** 日志文件配置（JSON 字符串） */
+    logFilesJson?: string;
 }
 /**
  * 挂件注入配置选项

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vite-plugin-opencode-assistant/shared",
-  "version": "1.0.57",
+  "version": "1.0.58",
   "type": "module",
   "main": "lib/index.cjs",
   "module": "es/index.mjs",