@townco/agent 0.1.47 → 0.1.48

package/dist/utils/logger.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Node.js logger with file rotation support
+ * Outputs to both stdout and .logs/<service>.log files
+ */
+export type LogLevel = "trace" | "debug" | "info" | "warn" | "error" | "fatal";
+export declare class Logger {
+    private service;
+    private minLevel;
+    private logFilePath;
+    private logsDir;
+    private writeQueue;
+    private isWriting;
+    private silent;
+    constructor(service: string, minLevel?: LogLevel, options?: {
+        silent?: boolean;
+        logsDir?: string;
+    });
+    private ensureLogsDirectory;
+    private shouldLog;
+    private rotateLogFile;
+    private writeToFile;
+    private log;
+    trace(message: string, metadata?: Record<string, unknown>): void;
+    debug(message: string, metadata?: Record<string, unknown>): void;
+    info(message: string, metadata?: Record<string, unknown>): void;
+    warn(message: string, metadata?: Record<string, unknown>): void;
+    error(message: string, metadata?: Record<string, unknown>): void;
+    fatal(message: string, metadata?: Record<string, unknown>): void;
+}
+/**
+ * Create a logger instance for a service
+ * @param service - Service name (e.g., "gui", "http-agent", "tui")
+ * @param minLevel - Minimum log level to display (default: "debug")
+ * @param options - Logger options (silent mode, custom logs directory, etc.)
+ */
+export declare function createLogger(service: string, minLevel?: LogLevel, options?: {
+    silent?: boolean;
+    logsDir?: string;
+}): Logger;

package/dist/utils/logger.js

@@ -0,0 +1,175 @@
+/**
+ * Node.js logger with file rotation support
+ * Outputs to both stdout and .logs/<service>.log files
+ */
+import * as fs from "node:fs";
+import * as path from "node:path";
+const LOG_LEVELS = {
+    trace: 0,
+    debug: 1,
+    info: 2,
+    warn: 3,
+    error: 4,
+    fatal: 5,
+};
+// ANSI color codes for terminal output
+const LOG_COLORS = {
+    trace: "\x1b[90m", // gray
+    debug: "\x1b[34m", // blue
+    info: "\x1b[32m", // green
+    warn: "\x1b[33m", // yellow
+    error: "\x1b[31m", // red
+    fatal: "\x1b[41m\x1b[37m", // white on red background
+};
+const RESET = "\x1b[0m";
+const MAX_LOG_SIZE = 10 * 1024 * 1024; // 10MB
+const MAX_ROTATED_FILES = 5;
+export class Logger {
+    service;
+    minLevel;
+    logFilePath;
+    logsDir;
+    writeQueue = [];
+    isWriting = false;
+    silent;
+    constructor(service, minLevel = "debug", options) {
+        this.service = service;
+        this.minLevel = minLevel;
+        this.silent = options?.silent ?? false;
+        // Setup log file path - use custom logsDir if provided, otherwise use process.cwd()
+        const baseDir = options?.logsDir ?? process.cwd();
+        this.logsDir = path.join(baseDir, ".logs");
+        this.logFilePath = path.join(this.logsDir, `${service}.log`);
+        // Create logs directory if it doesn't exist
+        this.ensureLogsDirectory();
+    }
+    ensureLogsDirectory() {
+        try {
+            if (!fs.existsSync(this.logsDir)) {
+                fs.mkdirSync(this.logsDir, { recursive: true });
+            }
+        }
+        catch (error) {
+            console.error("Failed to create logs directory:", error);
+        }
+    }
+    shouldLog(level) {
+        return LOG_LEVELS[level] >= LOG_LEVELS[this.minLevel];
+    }
+    rotateLogFile() {
+        try {
+            // Check if rotation is needed
+            if (!fs.existsSync(this.logFilePath)) {
+                return;
+            }
+            const stats = fs.statSync(this.logFilePath);
+            if (stats.size < MAX_LOG_SIZE) {
+                return;
+            }
+            // Remove oldest rotated file if it exists
+            const oldestFile = `${this.logFilePath}.${MAX_ROTATED_FILES}`;
+            if (fs.existsSync(oldestFile)) {
+                fs.unlinkSync(oldestFile);
+            }
+            // Rotate existing files
+            for (let i = MAX_ROTATED_FILES - 1; i >= 1; i--) {
+                const oldFile = `${this.logFilePath}.${i}`;
+                const newFile = `${this.logFilePath}.${i + 1}`;
+                if (fs.existsSync(oldFile)) {
+                    fs.renameSync(oldFile, newFile);
+                }
+            }
+            // Rotate current log file
+            fs.renameSync(this.logFilePath, `${this.logFilePath}.1`);
+        }
+        catch (error) {
+            console.error("Failed to rotate log file:", error);
+        }
+    }
+    async writeToFile(content) {
+        this.writeQueue.push(content);
+        if (this.isWriting) {
+            return;
+        }
+        this.isWriting = true;
+        while (this.writeQueue.length > 0) {
+            const batch = this.writeQueue.splice(0, this.writeQueue.length);
+            const data = `${batch.join("\n")}\n`;
+            try {
+                // Check if rotation is needed before writing
+                this.rotateLogFile();
+                // Append to log file
+                await fs.promises.appendFile(this.logFilePath, data, "utf-8");
+            }
+            catch (error) {
+                console.error("Failed to write to log file:", error);
+            }
+        }
+        this.isWriting = false;
+    }
+    log(level, message, metadata) {
+        if (!this.shouldLog(level)) {
+            return;
+        }
+        const entry = {
+            timestamp: new Date().toISOString(),
+            level,
+            service: this.service,
+            message,
+            ...(metadata && { metadata }),
+        };
+        // Console output with color-coding
+        const color = LOG_COLORS[level];
+        const levelUpper = level.toUpperCase().padEnd(5);
+        const prefix = `${color}[${entry.timestamp}] [${this.service}] [${levelUpper}]${RESET}`;
+        const formattedMessage = metadata
+            ? `${message} ${JSON.stringify(metadata)}`
+            : message;
+        // Output to stdout/stderr (unless silent)
+        if (!this.silent) {
+            if (level === "error" || level === "fatal") {
+                console.error(`${prefix} ${formattedMessage}`);
+            }
+            else if (level === "warn") {
+                console.warn(`${prefix} ${formattedMessage}`);
+            }
+            else {
+                console.log(`${prefix} ${formattedMessage}`);
+            }
+        }
+        // Write to file (JSON format)
+        const jsonLine = JSON.stringify(entry);
+        this.writeToFile(jsonLine).catch((error) => {
+            if (!this.silent) {
+                console.error("Failed to queue log write:", error);
+            }
+        });
+    }
+    trace(message, metadata) {
+        this.log("trace", message, metadata);
+    }
+    debug(message, metadata) {
+        this.log("debug", message, metadata);
+    }
+    info(message, metadata) {
+        this.log("info", message, metadata);
+    }
+    warn(message, metadata) {
+        this.log("warn", message, metadata);
+    }
+    error(message, metadata) {
+        this.log("error", message, metadata);
+    }
+    fatal(message, metadata) {
+        this.log("fatal", message, metadata);
+    }
+}
+/**
+ * Create a logger instance for a service
+ * @param service - Service name (e.g., "gui", "http-agent", "tui")
+ * @param minLevel - Minimum log level to display (default: "debug")
+ * @param options - Logger options (silent mode, custom logs directory, etc.)
+ */
+export function createLogger(service, minLevel = "debug", options) {
+    return new Logger(service, minLevel, options);
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@townco/agent",
-  "version": "0.1.47",
+  "version": "0.1.48",
   "type": "module",
   "module": "index.ts",
   "files": [
@@ -56,11 +56,11 @@
     "@langchain/google-genai": "^1.0.3",
     "@langchain/google-vertexai": "^1.0.3",
     "@langchain/mcp-adapters": "^1.0.0",
-    "@townco/core": "0.0.20",
-    "@townco/gui-template": "0.1.39",
-    "@townco/tui-template": "0.1.39",
-    "@townco/tsconfig": "0.1.39",
-    "@townco/ui": "0.1.42",
+    "@townco/core": "0.0.21",
+    "@townco/gui-template": "0.1.40",
+    "@townco/tui-template": "0.1.40",
+    "@townco/tsconfig": "0.1.40",
+    "@townco/ui": "0.1.43",
     "exa-js": "^2.0.0",
     "hono": "^4.10.4",
     "langchain": "^1.0.3",