@creatoria/miniapp-mcp 0.1.3 → 0.2.2

package/dist/runtime/logging/logger.js

@@ -0,0 +1,379 @@
+/* eslint-disable @typescript-eslint/no-explicit-any */
+/**
+ * Logger implementation for structured logging with file support
+ */
+import { open, mkdir, rename } from 'fs/promises';
+import { statfs } from 'fs/promises'; // Issue #6: Disk space check (Node 18+)
+import { join } from 'path';
+/**
+ * Default logger configuration
+ */
+const DEFAULT_LOGGER_CONFIG = {
+    level: 'info',
+    enableFileLog: false,
+    outputDir: '.mcp-artifacts',
+    bufferSize: 100,
+    flushInterval: 5000,
+    enableFailureSnapshot: false,
+};
+/**
+ * Log level priorities for filtering
+ */
+const LOG_LEVELS = {
+    debug: 0,
+    info: 1,
+    warn: 2,
+    error: 3,
+};
+/**
+ * Internal file writer with buffering for async log writing
+ */
+class FileWriter {
+    sessionId;
+    outputDir;
+    bufferSize;
+    flushInterval;
+    buffer = [];
+    flushTimer;
+    fileHandle;
+    disposed = false;
+    filePath;
+    flushInProgress = false; // Issue #2: Prevent concurrent flushes
+    failureCount = 0; // Issue #1: Circuit breaker for persistent failures
+    MAX_FAILURES = 3; // Disable after 3 consecutive failures
+    constructor(sessionId, outputDir, bufferSize, flushInterval) {
+        this.sessionId = sessionId;
+        this.outputDir = outputDir;
+        this.bufferSize = bufferSize;
+        this.flushInterval = flushInterval;
+        this.startFlushTimer();
+    }
+    /**
+     * Add log entry to buffer (non-blocking)
+     */
+    write(entry) {
+        if (this.disposed)
+            return;
+        this.buffer.push(entry);
+        // Trigger flush if buffer is full
+        if (this.buffer.length >= this.bufferSize) {
+            // Fire-and-forget flush (non-blocking)
+            void this.flush().catch((err) => {
+                console.error('Failed to flush log buffer:', err);
+            });
+        }
+    }
+    /**
+     * Flush buffer to file
+     */
+    async flush() {
+        // Issue #2: Prevent concurrent flushes
+        if (this.buffer.length === 0 || this.disposed || this.flushInProgress)
+            return;
+        this.flushInProgress = true;
+        try {
+            // Extract buffer entries
+            const entries = this.buffer.splice(0, this.buffer.length);
+            const lines = entries
+                .map((e) => {
+                try {
+                    // Issue #13: Handle circular references
+                    return JSON.stringify(e);
+                }
+                catch (error) {
+                    return JSON.stringify({
+                        ...e,
+                        context: '<Serialization failed: circular reference>',
+                        _serializationError: error instanceof Error ? error.message : String(error),
+                    });
+                }
+            })
+                .join('\n') + '\n';
+            try {
+                // Ensure file handle is open
+                if (!this.fileHandle) {
+                    await this.ensureLogDirectory();
+                    this.filePath = join(this.outputDir, 'logs', `session-${this.sessionId}.log`);
+                    this.fileHandle = await open(this.filePath, 'a');
+                }
+                // Issue #6: Check disk space before writing
+                await this.checkDiskSpace();
+                if (this.disposed)
+                    return; // Disk space check may have disabled logging
+                // Issue #8: Rotate file if too large
+                await this.rotateIfNeeded();
+                // Write to file
+                await this.fileHandle.write(lines);
+                // Issue #1: Reset failure count on success
+                this.failureCount = 0;
+            }
+            catch (error) {
+                const err = error instanceof Error ? error.message : String(error);
+                // Handle disk full error
+                if (error && typeof error === 'object' && 'code' in error && error.code === 'ENOSPC') {
+                    console.error('Disk full, disabling file logging');
+                    // Issue #4: Close file handle before disposing to prevent leak
+                    if (this.fileHandle) {
+                        await this.fileHandle.close().catch(() => { });
+                        this.fileHandle = undefined;
+                    }
+                    this.disposed = true;
+                    return;
+                }
+                console.error('Failed to write logs to file:', err);
+                // Issue #1: Circuit breaker - disable after too many failures
+                this.failureCount++;
+                if (this.failureCount >= this.MAX_FAILURES) {
+                    console.error(`Too many flush failures (${this.failureCount}), disabling file logging`);
+                    // Issue #4: Close file handle before disposing
+                    if (this.fileHandle) {
+                        await this.fileHandle.close().catch(() => { });
+                        this.fileHandle = undefined;
+                    }
+                    this.disposed = true;
+                    return;
+                }
+                // Issue #1: Smart retry with buffer size limit
+                // Only keep the most recent entries to prevent unbounded growth
+                const entriesToKeep = Math.min(entries.length, this.bufferSize - this.buffer.length);
+                if (entriesToKeep > 0) {
+                    // Keep newest entries, drop oldest
+                    this.buffer.unshift(...entries.slice(-entriesToKeep));
+                    if (entriesToKeep < entries.length) {
+                        console.warn(`Dropped ${entries.length - entriesToKeep} old log entries due to buffer limit`);
+                    }
+                }
+                else {
+                    console.warn(`Buffer full, dropped ${entries.length} failed log entries`);
+                }
+            }
+        }
+        finally {
+            this.flushInProgress = false;
+        }
+    }
+    /**
+     * Dispose writer and flush remaining buffer
+     */
+    async dispose() {
+        this.disposed = true;
+        if (this.flushTimer) {
+            clearInterval(this.flushTimer);
+        }
+        await this.flush();
+        if (this.fileHandle) {
+            await this.fileHandle.close();
+            this.fileHandle = undefined;
+        }
+    }
+    /**
+     * Start periodic flush timer
+     */
+    startFlushTimer() {
+        this.flushTimer = setInterval(() => {
+            void this.flush().catch((err) => {
+                console.error('Scheduled flush failed:', err);
+            });
+        }, this.flushInterval);
+    }
+    /**
+     * Ensure log directory exists
+     */
+    async ensureLogDirectory() {
+        const logDir = join(this.outputDir, 'logs');
+        await mkdir(logDir, { recursive: true });
+    }
+    /**
+     * Check disk space and warn/disable if low (Issue #6)
+     */
+    async checkDiskSpace() {
+        if (!this.fileHandle || !this.filePath)
+            return;
+        try {
+            const stats = await statfs(this.outputDir);
+            const freeBytes = BigInt(stats.bsize) * BigInt(stats.bavail);
+            const freeMB = Number(freeBytes / BigInt(1024 * 1024));
+            if (freeMB < 100) {
+                console.warn(`[Logger] Low disk space: ${freeMB.toFixed(2)}MB remaining`);
+            }
+            if (freeMB < 10) {
+                console.error('[Logger] Critical disk space (<10MB), disabling file logging');
+                // Close file handle and dispose
+                await this.fileHandle.close().catch(() => { });
+                this.fileHandle = undefined;
+                this.disposed = true;
+            }
+        }
+        catch (error) {
+            // statfs may not be available on all platforms/Node versions
+            // Silently ignore to avoid breaking on older Node versions
+        }
+    }
+    /**
+     * Rotate log file if it exceeds 10MB (Issue #8)
+     */
+    async rotateIfNeeded() {
+        if (!this.fileHandle || !this.filePath)
+            return;
+        try {
+            const stats = await this.fileHandle.stat();
+            const sizeMB = stats.size / (1024 * 1024);
+            if (sizeMB > 10) {
+                console.warn(`[Logger] Log file exceeds 10MB (${sizeMB.toFixed(2)}MB), rotating...`);
+                // Close current file
+                await this.fileHandle.close();
+                // Rename to timestamped backup
+                const timestamp = new Date().toISOString().replace(/[:.]/g, '-').slice(0, -5); // Remove .xxxZ
+                const rotatedPath = `${this.filePath}.${timestamp}`;
+                await rename(this.filePath, rotatedPath);
+                console.error(`[Logger] Rotated log file to: ${rotatedPath}`);
+                // Reopen new file
+                this.fileHandle = await open(this.filePath, 'a');
+            }
+        }
+        catch (error) {
+            console.error('[Logger] Failed to rotate log file:', error);
+            // Continue with existing file handle
+        }
+    }
+}
+/**
+ * Console-based logger implementation
+ */
+export class ConsoleLogger {
+    sessionId;
+    toolName;
+    config;
+    fileWriter;
+    constructor(sessionId, toolName, config) {
+        this.sessionId = sessionId;
+        this.toolName = toolName;
+        this.config = this.mergeConfig(config);
+        // Initialize file writer if enabled
+        if (this.config.enableFileLog && sessionId) {
+            this.fileWriter = new FileWriter(sessionId, this.config.outputDir, this.config.bufferSize, this.config.flushInterval);
+        }
+    }
+    /**
+     * Merge user config with defaults and validate values (Issue #7)
+     */
+    mergeConfig(userConfig) {
+        // Start with defaults
+        const merged = {
+            ...DEFAULT_LOGGER_CONFIG,
+            ...userConfig,
+        };
+        // Issue #7: Validate and clamp buffer size (10 - 10000)
+        const rawBufferSize = merged.bufferSize;
+        merged.bufferSize = Math.max(10, Math.min(merged.bufferSize, 10000));
+        if (rawBufferSize !== merged.bufferSize) {
+            console.warn(`Logger bufferSize clamped to ${merged.bufferSize} (was ${rawBufferSize}). Valid range: 10-10000`);
+        }
+        // Issue #7: Validate and clamp flush interval (100ms - 60s)
+        const rawFlushInterval = merged.flushInterval;
+        merged.flushInterval = Math.max(100, Math.min(merged.flushInterval, 60000));
+        if (rawFlushInterval !== merged.flushInterval) {
+            console.warn(`Logger flushInterval clamped to ${merged.flushInterval}ms (was ${rawFlushInterval}ms). Valid range: 100-60000ms`);
+        }
+        // Issue #7: Validate log level
+        const validLevels = ['debug', 'info', 'warn', 'error'];
+        if (!validLevels.includes(merged.level)) {
+            console.warn(`Invalid log level "${merged.level}", using default "info". Valid levels: ${validLevels.join(', ')}`);
+            merged.level = 'info';
+        }
+        // Issue #7: Validate outputDir is non-empty string
+        if (typeof merged.outputDir !== 'string' || merged.outputDir.trim() === '') {
+            console.warn(`Invalid outputDir "${merged.outputDir}", using default ".mcp-artifacts"`);
+            merged.outputDir = '.mcp-artifacts';
+        }
+        return merged;
+    }
+    /**
+     * Check if log level should be output
+     */
+    shouldLog(level) {
+        return LOG_LEVELS[level] >= LOG_LEVELS[this.config.level];
+    }
+    /**
+     * Create log entry with metadata
+     */
+    createEntry(level, message, context) {
+        return {
+            timestamp: new Date(),
+            level,
+            message,
+            sessionId: this.sessionId,
+            toolName: this.toolName,
+            context,
+        };
+    }
+    /**
+     * Format log entry for console output
+     */
+    format(entry) {
+        const timestamp = entry.timestamp.toISOString();
+        const level = entry.level.toUpperCase().padEnd(5);
+        const sessionInfo = entry.sessionId ? ` [${entry.sessionId}]` : '';
+        const toolInfo = entry.toolName ? ` [${entry.toolName}]` : '';
+        const contextInfo = entry.context ? ` ${JSON.stringify(entry.context)}` : '';
+        return `${timestamp} ${level}${sessionInfo}${toolInfo}: ${entry.message}${contextInfo}`;
+    }
+    info(message, context) {
+        if (!this.shouldLog('info'))
+            return;
+        const entry = this.createEntry('info', message, context);
+        this.log(entry);
+    }
+    warn(message, context) {
+        if (!this.shouldLog('warn'))
+            return;
+        const entry = this.createEntry('warn', message, context);
+        this.log(entry);
+    }
+    error(message, context) {
+        if (!this.shouldLog('error'))
+            return;
+        const entry = this.createEntry('error', message, context);
+        this.log(entry);
+    }
+    debug(message, context) {
+        if (!this.shouldLog('debug'))
+            return;
+        const entry = this.createEntry('debug', message, context);
+        this.log(entry);
+    }
+    /**
+     * Log entry to console and optionally to file
+     */
+    log(entry) {
+        // Console output (always)
+        console.error(this.format(entry));
+        // File output (if enabled)
+        this.fileWriter?.write(entry);
+    }
+    /**
+     * Flush log buffer to file
+     */
+    async flush() {
+        await this.fileWriter?.flush();
+    }
+    /**
+     * Dispose logger and flush buffer
+     */
+    async dispose() {
+        await this.fileWriter?.dispose();
+    }
+    /**
+     * Create a child logger with specific tool name
+     */
+    child(toolName) {
+        return new ConsoleLogger(this.sessionId, toolName, this.config);
+    }
+}
+/**
+ * Create a logger for a session
+ */
+export function createLogger(sessionId, config) {
+    return new ConsoleLogger(sessionId, undefined, config);
+}
+//# sourceMappingURL=logger.js.map

package/dist/runtime/logging/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../../src/runtime/logging/logger.ts"],"names":[],"mappings":"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"}

package/dist/runtime/logging/tool-logger.d.ts

@@ -0,0 +1,83 @@
+/**
+ * Tool call logger wrapper for automatic logging
+ */
+import type { Logger } from '../../types.js';
+import type { SessionState } from '../../types.js';
+/**
+ * Tool logger wrapper for automatic START/END/ERROR logging
+ */
+export declare class ToolLogger {
+    private logger;
+    private config?;
+    private capturing;
+    constructor(logger: Logger, config?: import("../../types.js").LoggerConfig | undefined);
+    /**
+     * Wrap a tool handler with automatic logging
+     *
+     * @param toolName - Name of the tool (e.g., "page_query")
+     * @param handler - Original tool handler function
+     * @returns Wrapped handler with automatic logging
+     */
+    wrap<TArgs, TResult>(toolName: string, handler: (session: SessionState, args: TArgs) => Promise<TResult>): (session: SessionState, args: TArgs) => Promise<TResult>;
+    /**
+     * Check if a key name matches sensitive patterns (Issue #3)
+     */
+    private isSensitiveKey;
+    /**
+     * Sanitize arguments for logging (remove sensitive data, limit size)
+     * Issue #3: Enhanced with deep recursion and pattern matching
+     */
+    private sanitizeArgs;
+    /**
+     * Sanitize result for logging (limit size, remove large objects)
+     * Issue #3: Use same deep sanitization as args
+     */
+    private sanitizeResult;
+    /**
+     * Capture failure snapshot when tool call fails (F2 feature)
+     *
+     * Creates a failure directory with:
+     * - snapshot.json: Page data
+     * - snapshot.png: Screenshot
+     * - error-context.json: Error details + tool context
+     *
+     * @param context Failure context
+     * @returns Relative path to the failure directory (for F3 reporting)
+     */
+    private captureFailureSnapshot;
+    /**
+     * Record a tool call to session report data (F3 feature)
+     *
+     * Adds a tool call record to the session's reportData. Implements
+     * memory protection by limiting to MAX_TOOL_CALL_RECORDS with FIFO eviction.
+     *
+     * @param session Session state
+     * @param record Tool call record to add
+     */
+    private recordToolCall;
+    /**
+     * Sanitize error message to remove sensitive information (F3-S1)
+     *
+     * Removes:
+     * - File paths (Unix, Linux, Windows)
+     * - API keys and tokens (32+ character alphanumeric strings)
+     * - Stack trace locations
+     *
+     * @param message Raw error message
+     * @returns Sanitized error message with placeholders
+     */
+    private sanitizeErrorMessage;
+    /**
+     * Sanitize stack trace to remove sensitive file paths (Issue #P2)
+     *
+     * Removes:
+     * - Absolute user paths (/Users/<username>/, /home/<username>/)
+     * - Windows paths (C:\Users\<username>\)
+     * - Environment-specific paths
+     *
+     * @param stack Raw stack trace
+     * @returns Sanitized stack trace with placeholders
+     */
+    private sanitizeStackTrace;
+}
+//# sourceMappingURL=tool-logger.d.ts.map

package/dist/runtime/logging/tool-logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-logger.d.ts","sourceRoot":"","sources":["../../../src/runtime/logging/tool-logger.ts"],"names":[],"mappings":"AACA;;GAEG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAkB,MAAM,gBAAgB,CAAA;AAC5D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAA;AA4ClD;;GAEG;AACH,qBAAa,UAAU;IAInB,OAAO,CAAC,MAAM;IACd,OAAO,CAAC,MAAM,CAAC;IAJjB,OAAO,CAAC,SAAS,CAAQ;gBAGf,MAAM,EAAE,MAAM,EACd,MAAM,CAAC,EAAE,OAAO,gBAAgB,EAAE,YAAY,YAAA;IAGxD;;;;;;OAMG;IACH,IAAI,CAAC,KAAK,EAAE,OAAO,EACjB,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,CAAC,OAAO,EAAE,YAAY,EAAE,IAAI,EAAE,KAAK,KAAK,OAAO,CAAC,OAAO,CAAC,GAChE,CAAC,OAAO,EAAE,YAAY,EAAE,IAAI,EAAE,KAAK,KAAK,OAAO,CAAC,OAAO,CAAC;IAgF3D;;OAEG;IACH,OAAO,CAAC,cAAc;IAItB;;;OAGG;IACH,OAAO,CAAC,YAAY;IAoEpB;;;OAGG;IACH,OAAO,CAAC,cAAc;IA0EtB;;;;;;;;;;OAUG;YACW,sBAAsB;IAqGpC;;;;;;;;OAQG;IACH,OAAO,CAAC,cAAc;IA6BtB;;;;;;;;;;OAUG;IACH,OAAO,CAAC,oBAAoB;IA0B5B;;;;;;;;;;OAUG;IACH,OAAO,CAAC,kBAAkB;CAqB3B"}