@172ai/containers-mcp-server 1.9.3 → 1.10.1

package/dist/utils/logBuffer.js

@@ -0,0 +1,198 @@
+"use strict";
+/**
+ * Log Buffer Utility for Runtime Log Streaming
+ * Prevents duplicate logs and manages streaming log display
+ *
+ * Features:
+ * - insertId-based deduplication (matches backend processor)
+ * - Per-execution log buffering with configurable max size
+ * - Automatic cleanup of old execution buffers
+ * - Statistics tracking for monitoring
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.logBuffer = exports.LogBuffer = void 0;
+class LogBuffer {
+    constructor(maxLogsPerExecution = 1000, bufferInactivityTimeout = 60 * 60 * 1000 // 1 hour default
+    ) {
+        this.buffers = new Map();
+        this.cleanupInterval = null;
+        this.maxLogsPerExecution = maxLogsPerExecution;
+        this.bufferInactivityTimeout = bufferInactivityTimeout;
+        // Start automatic cleanup of stale buffers
+        this.startCleanupTimer();
+    }
+    /**
+     * Add logs for an execution with deduplication
+     * Returns only the new (non-duplicate) logs
+     */
+    addLogs(executionId, logs, containerId, containerName) {
+        // Get or create buffer for this execution
+        let buffer = this.buffers.get(executionId);
+        if (!buffer) {
+            buffer = {
+                executionId,
+                containerId: containerId || 'unknown',
+                containerName: containerName || 'Unknown Container',
+                logs: [],
+                seenInsertIds: new Set(),
+                createdAt: Date.now(),
+                lastActivity: Date.now(),
+                totalLogsReceived: 0,
+                duplicatesFiltered: 0
+            };
+            this.buffers.set(executionId, buffer);
+        }
+        // Filter out duplicates using insertId
+        const newLogs = [];
+        for (const log of logs) {
+            buffer.totalLogsReceived++;
+            if (!log.insertId || buffer.seenInsertIds.has(log.insertId)) {
+                buffer.duplicatesFiltered++;
+                continue;
+            }
+            buffer.seenInsertIds.add(log.insertId);
+            newLogs.push(log);
+        }
+        // Add new logs to buffer
+        buffer.logs.push(...newLogs);
+        buffer.lastActivity = Date.now();
+        // Enforce max size by removing oldest logs
+        if (buffer.logs.length > this.maxLogsPerExecution) {
+            const logsToRemove = buffer.logs.length - this.maxLogsPerExecution;
+            const removedLogs = buffer.logs.splice(0, logsToRemove);
+            // Remove insertIds from tracking for removed logs
+            removedLogs.forEach(log => {
+                if (log.insertId) {
+                    buffer.seenInsertIds.delete(log.insertId);
+                }
+            });
+        }
+        return newLogs;
+    }
+    /**
+     * Get logs for a specific execution
+     */
+    getLogs(executionId, limit) {
+        const buffer = this.buffers.get(executionId);
+        if (!buffer) {
+            return [];
+        }
+        const logs = buffer.logs;
+        if (limit && limit < logs.length) {
+            return logs.slice(-limit); // Return most recent N logs
+        }
+        return logs;
+    }
+    /**
+     * Clear logs for a specific execution
+     */
+    clear(executionId) {
+        this.buffers.delete(executionId);
+    }
+    /**
+     * Get statistics about all buffers
+     */
+    getStats() {
+        const now = Date.now();
+        let totalLogs = 0;
+        let totalDuplicatesFiltered = 0;
+        let oldestBufferAge = 0;
+        let newestBufferAge = Infinity;
+        let totalBufferSize = 0;
+        for (const buffer of this.buffers.values()) {
+            totalLogs += buffer.logs.length;
+            totalDuplicatesFiltered += buffer.duplicatesFiltered;
+            const age = now - buffer.createdAt;
+            oldestBufferAge = Math.max(oldestBufferAge, age);
+            newestBufferAge = Math.min(newestBufferAge, age);
+            totalBufferSize += buffer.logs.length;
+        }
+        return {
+            totalBuffers: this.buffers.size,
+            totalLogs,
+            totalDuplicatesFiltered,
+            oldestBufferAge,
+            newestBufferAge: newestBufferAge === Infinity ? 0 : newestBufferAge,
+            averageBufferSize: this.buffers.size > 0 ? totalBufferSize / this.buffers.size : 0
+        };
+    }
+    /**
+     * Get all execution IDs with active buffers
+     */
+    getActiveExecutions() {
+        return Array.from(this.buffers.keys());
+    }
+    /**
+     * Check if an execution has an active buffer
+     */
+    hasBuffer(executionId) {
+        return this.buffers.has(executionId);
+    }
+    /**
+     * Get buffer info for monitoring
+     */
+    getBufferInfo(executionId) {
+        const buffer = this.buffers.get(executionId);
+        if (!buffer) {
+            return null;
+        }
+        return {
+            executionId: buffer.executionId,
+            containerId: buffer.containerId,
+            containerName: buffer.containerName,
+            logs: buffer.logs,
+            createdAt: buffer.createdAt,
+            lastActivity: buffer.lastActivity,
+            totalLogsReceived: buffer.totalLogsReceived,
+            duplicatesFiltered: buffer.duplicatesFiltered
+        };
+    }
+    /**
+     * Start automatic cleanup timer for stale buffers
+     */
+    startCleanupTimer() {
+        // Run cleanup every 5 minutes
+        this.cleanupInterval = setInterval(() => {
+            this.cleanupStaleBuffers();
+        }, 5 * 60 * 1000);
+    }
+    /**
+     * Clean up buffers that haven't had activity recently
+     */
+    cleanupStaleBuffers() {
+        const now = Date.now();
+        const staleExecutions = [];
+        for (const [executionId, buffer] of this.buffers.entries()) {
+            const inactiveTime = now - buffer.lastActivity;
+            if (inactiveTime > this.bufferInactivityTimeout) {
+                staleExecutions.push(executionId);
+            }
+        }
+        if (staleExecutions.length > 0) {
+            console.log(`[LogBuffer] Cleaning up ${staleExecutions.length} stale execution buffers`);
+            staleExecutions.forEach(executionId => {
+                this.buffers.delete(executionId);
+            });
+        }
+    }
+    /**
+     * Stop cleanup timer (for testing or shutdown)
+     */
+    destroy() {
+        if (this.cleanupInterval) {
+            clearInterval(this.cleanupInterval);
+            this.cleanupInterval = null;
+        }
+        this.buffers.clear();
+    }
+    /**
+     * Clear all buffers
+     */
+    clearAll() {
+        this.buffers.clear();
+    }
+}
+exports.LogBuffer = LogBuffer;
+// Export singleton instance
+exports.logBuffer = new LogBuffer();
+//# sourceMappingURL=logBuffer.js.map

package/dist/utils/logBuffer.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@172ai/containers-mcp-server",
-  "version": "1.9.3",
+  "version": "1.10.1",
   "description": "MCP server for 172.ai container management platform - enables AI assistants to manage containers, builds, and files with comprehensive workflow prompts",
   "main": "dist/cli.js",
   "bin": {