@brutalist/mcp 0.6.0 → 0.6.1

package/dist/streaming/sse-transport.js

@@ -0,0 +1,319 @@
+import { EventEmitter } from 'events';
+import { logger } from '../logger.js';
+/**
+ * Enhanced Server-Sent Events transport with session isolation
+ *
+ * Features:
+ * - Session-scoped connections with isolation guarantees
+ * - Connection pooling with resource limits
+ * - Heartbeat monitoring and automatic cleanup
+ * - Graceful connection management
+ * - Event filtering and routing by session
+ * - Memory-efficient streaming with backpressure
+ */
+export class EnhancedSSETransport extends EventEmitter {
+    connections = new Map();
+    sessionManager;
+    heartbeatInterval = null;
+    // Configuration constants
+    MAX_CONNECTIONS = 100;
+    HEARTBEAT_INTERVAL = 30000; // 30 seconds
+    CONNECTION_TIMEOUT = 300000; // 5 minutes
+    MAX_EVENTS_PER_CONNECTION = 10000;
+    constructor(sessionManager) {
+        super();
+        this.sessionManager = sessionManager;
+        this.startHeartbeat();
+        // Handle session events
+        this.sessionManager.on('streamingEvent', this.handleSessionEvent.bind(this));
+        this.sessionManager.on('sessionComplete', this.handleSessionComplete.bind(this));
+    }
+    /**
+     * Establish SSE connection for a session
+     */
+    async connect(req, res, sessionId) {
+        const connectionId = `${sessionId}-${Date.now()}`;
+        const clientOrigin = req.headers.origin || 'unknown';
+        // Validate session exists
+        if (!this.sessionManager.hasSession(sessionId)) {
+            res.status(404).json({ error: 'Session not found' });
+            return;
+        }
+        // Check connection limits
+        if (this.connections.size >= this.MAX_CONNECTIONS) {
+            logger.warn(`🚫 SSE connection limit reached (${this.MAX_CONNECTIONS})`);
+            res.status(503).json({ error: 'Connection limit reached' });
+            return;
+        }
+        // Set SSE headers
+        res.writeHead(200, {
+            'Content-Type': 'text/event-stream',
+            'Cache-Control': 'no-cache',
+            'Connection': 'keep-alive',
+            'Access-Control-Allow-Origin': clientOrigin,
+            'Access-Control-Allow-Credentials': 'true'
+        });
+        // Send initial connection event
+        this.sendEvent(res, {
+            type: 'connection',
+            data: {
+                connectionId,
+                sessionId,
+                connectedAt: Date.now()
+            }
+        });
+        // Create connection record
+        const connection = {
+            id: connectionId,
+            sessionId,
+            response: res,
+            clientOrigin,
+            connectedAt: Date.now(),
+            lastActivity: Date.now(),
+            eventsSent: 0,
+            isActive: true
+        };
+        this.connections.set(connectionId, connection);
+        logger.info(`🔗 SSE connection established: ${connectionId} for session ${sessionId}`);
+        // Handle client disconnect
+        req.on('close', () => {
+            this.disconnect(connectionId, 'client_disconnect');
+        });
+        req.on('error', (error) => {
+            logger.error(`💥 SSE connection error for ${connectionId}:`, error);
+            this.disconnect(connectionId, 'connection_error');
+        });
+        // Send buffered events for this session
+        this.sendBufferedEvents(connection);
+    }
+    /**
+     * Handle streaming events from session manager
+     */
+    handleSessionEvent(event) {
+        if (!event.sessionId) {
+            logger.warn('⚠️ Received streaming event without session ID');
+            return;
+        }
+        // Find connections for this session
+        const sessionConnections = Array.from(this.connections.values())
+            .filter(conn => conn.sessionId === event.sessionId && conn.isActive);
+        if (sessionConnections.length === 0) {
+            logger.debug(`📭 No active SSE connections for session ${event.sessionId}`);
+            return;
+        }
+        // Send event to all session connections
+        for (const connection of sessionConnections) {
+            this.sendStreamingEvent(connection, event);
+        }
+    }
+    /**
+     * Handle session completion
+     */
+    handleSessionComplete(sessionId) {
+        logger.info(`🏁 Session ${sessionId} completed, closing SSE connections`);
+        const sessionConnections = Array.from(this.connections.values())
+            .filter(conn => conn.sessionId === sessionId);
+        for (const connection of sessionConnections) {
+            this.sendEvent(connection.response, {
+                type: 'session_complete',
+                data: {
+                    sessionId,
+                    completedAt: Date.now()
+                }
+            });
+            this.disconnect(connection.id, 'session_complete');
+        }
+    }
+    /**
+     * Send streaming event to specific connection
+     */
+    sendStreamingEvent(connection, event) {
+        if (!connection.isActive) {
+            return;
+        }
+        // Check event limit
+        if (connection.eventsSent >= this.MAX_EVENTS_PER_CONNECTION) {
+            logger.warn(`📊 Connection ${connection.id} reached event limit`);
+            this.disconnect(connection.id, 'event_limit_reached');
+            return;
+        }
+        try {
+            this.sendEvent(connection.response, {
+                type: 'streaming_event',
+                data: event
+            });
+            connection.eventsSent++;
+            connection.lastActivity = Date.now();
+        }
+        catch (error) {
+            logger.error(`💥 Failed to send event to ${connection.id}:`, error);
+            this.disconnect(connection.id, 'send_error');
+        }
+    }
+    /**
+     * Send buffered events for a newly connected session
+     */
+    sendBufferedEvents(connection) {
+        const sessionContext = this.sessionManager.getSession(connection.sessionId);
+        if (!sessionContext) {
+            return;
+        }
+        const bufferedEvents = sessionContext.eventBuffer.flush(connection.sessionId);
+        if (bufferedEvents && bufferedEvents.events.length > 0) {
+            logger.info(`📤 Sending ${bufferedEvents.events.length} buffered events to ${connection.id}`);
+            for (const event of bufferedEvents.events) {
+                this.sendStreamingEvent(connection, event);
+            }
+        }
+    }
+    /**
+     * Send raw SSE event
+     */
+    sendEvent(res, event) {
+        const eventId = Date.now().toString();
+        const eventData = JSON.stringify(event.data);
+        res.write(`id: ${eventId}\n`);
+        res.write(`event: ${event.type}\n`);
+        res.write(`data: ${eventData}\n\n`);
+    }
+    /**
+     * Disconnect and cleanup SSE connection
+     */
+    disconnect(connectionId, reason) {
+        const connection = this.connections.get(connectionId);
+        if (!connection) {
+            return;
+        }
+        logger.info(`🔌 Disconnecting SSE ${connectionId}: ${reason}`);
+        connection.isActive = false;
+        try {
+            if (!connection.response.destroyed) {
+                this.sendEvent(connection.response, {
+                    type: 'disconnect',
+                    data: {
+                        reason,
+                        disconnectedAt: Date.now(),
+                        eventsSent: connection.eventsSent
+                    }
+                });
+                connection.response.end();
+            }
+        }
+        catch (error) {
+            logger.debug(`Failed to send disconnect event: ${error}`);
+        }
+        this.connections.delete(connectionId);
+        this.emit('connectionClosed', {
+            connectionId,
+            sessionId: connection.sessionId,
+            reason,
+            duration: Date.now() - connection.connectedAt,
+            eventsSent: connection.eventsSent
+        });
+    }
+    /**
+     * Start heartbeat monitoring
+     */
+    startHeartbeat() {
+        this.heartbeatInterval = setInterval(() => {
+            this.checkConnectionHealth();
+        }, this.HEARTBEAT_INTERVAL);
+    }
+    /**
+     * Check connection health and cleanup stale connections
+     */
+    checkConnectionHealth() {
+        const now = Date.now();
+        const staleConnections = [];
+        for (const [connectionId, connection] of this.connections) {
+            if (!connection.isActive) {
+                staleConnections.push(connectionId);
+                continue;
+            }
+            // Check for timeout
+            if (now - connection.lastActivity > this.CONNECTION_TIMEOUT) {
+                logger.info(`⏰ Connection ${connectionId} timed out`);
+                staleConnections.push(connectionId);
+                continue;
+            }
+            // Send heartbeat
+            try {
+                this.sendEvent(connection.response, {
+                    type: 'heartbeat',
+                    data: {
+                        timestamp: now,
+                        sessionId: connection.sessionId
+                    }
+                });
+                connection.lastActivity = now;
+            }
+            catch (error) {
+                logger.debug(`Heartbeat failed for ${connectionId}, marking for cleanup`);
+                staleConnections.push(connectionId);
+            }
+        }
+        // Cleanup stale connections
+        for (const connectionId of staleConnections) {
+            this.disconnect(connectionId, 'stale_connection');
+        }
+        if (this.connections.size > 0) {
+            logger.debug(`💓 Heartbeat: ${this.connections.size} active SSE connections`);
+        }
+    }
+    /**
+     * Get connection statistics
+     */
+    getStats() {
+        const activeConnections = Array.from(this.connections.values())
+            .filter(conn => conn.isActive);
+        const sessionDistribution = {};
+        let totalEvents = 0;
+        for (const connection of activeConnections) {
+            sessionDistribution[connection.sessionId] =
+                (sessionDistribution[connection.sessionId] || 0) + 1;
+            totalEvents += connection.eventsSent;
+        }
+        return {
+            totalConnections: this.connections.size,
+            activeConnections: activeConnections.length,
+            sessionDistribution,
+            averageEventsPerConnection: activeConnections.length > 0
+                ? totalEvents / activeConnections.length
+                : 0
+        };
+    }
+    /**
+     * Force disconnect all connections for a session
+     */
+    disconnectSession(sessionId, reason = 'forced_disconnect') {
+        const sessionConnections = Array.from(this.connections.values())
+            .filter(conn => conn.sessionId === sessionId);
+        for (const connection of sessionConnections) {
+            this.disconnect(connection.id, reason);
+        }
+    }
+    /**
+     * Cleanup and shutdown transport
+     */
+    shutdown() {
+        logger.info('🛑 Shutting down SSE transport');
+        if (this.heartbeatInterval) {
+            clearInterval(this.heartbeatInterval);
+            this.heartbeatInterval = null;
+        }
+        // Disconnect all connections
+        const connectionIds = Array.from(this.connections.keys());
+        for (const connectionId of connectionIds) {
+            this.disconnect(connectionId, 'server_shutdown');
+        }
+        this.removeAllListeners();
+    }
+    /**
+     * Get active connection for session (for testing)
+     */
+    getSessionConnections(sessionId) {
+        return Array.from(this.connections.values())
+            .filter(conn => conn.sessionId === sessionId && conn.isActive);
+    }
+}
+//# sourceMappingURL=sse-transport.js.map

package/dist/streaming/sse-transport.js.map

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

package/dist/streaming/streaming-orchestrator.d.ts

@@ -0,0 +1,153 @@
+import { EventEmitter } from 'events';
+import { CLIAgentOptions } from '../cli-agents.js';
+import { CLIAgentResponse } from '../types/brutalist.js';
+import { CircuitBreakerConfig } from './circuit-breaker.js';
+/**
+ * Enhanced streaming CLI execution options
+ */
+export interface StreamingExecutionOptions extends CLIAgentOptions {
+    enableProgress?: boolean;
+    enableCircuitBreaker?: boolean;
+    fallbackResponse?: any;
+    cacheResponses?: boolean;
+    streamingTimeout?: number;
+    bufferConfig?: {
+        maxBatchSize?: number;
+        throttleDelay?: number;
+        priorityRules?: Record<string, any>;
+    };
+}
+/**
+ * Streaming execution result with enhanced metadata
+ */
+export interface StreamingExecutionResult {
+    success: boolean;
+    responses: CLIAgentResponse[];
+    sessionId: string;
+    analysis: {
+        startTime: number;
+        endTime: number;
+        duration: number;
+        eventsEmitted: number;
+        progressMilestones: number;
+        circuitBreakerTrips: number;
+        fallbacksUsed: number;
+    };
+    streaming: {
+        connectedClients: number;
+        eventsSent: number;
+        averageLatency: number;
+        bufferHits: number;
+    };
+    errors?: string[];
+}
+/**
+ * Streaming orchestrator configuration
+ */
+export interface StreamingOrchestratorConfig {
+    maxConcurrentAnalyses: number;
+    defaultTimeout: number;
+    circuitBreakerConfig: CircuitBreakerConfig;
+    enableMetrics: boolean;
+    cleanupInterval: number;
+}
+/**
+ * Advanced streaming CLI orchestrator with comprehensive real-time capabilities
+ *
+ * Integrates all streaming components:
+ * - Real-time output parsing with semantic boundaries
+ * - Intelligent buffering with adaptive throttling
+ * - Session management with lifecycle tracking
+ * - SSE transport with session isolation
+ * - Progress tracking with milestone detection
+ * - Circuit breaker with fallback strategies
+ * - Comprehensive monitoring and analytics
+ */
+export declare class StreamingCLIOrchestrator extends EventEmitter {
+    private cliOrchestrator;
+    private sessionManager;
+    private sseTransport;
+    private circuitBreakers;
+    private responseCache;
+    private activeAnalyses;
+    private config;
+    private metrics;
+    private cleanupTimer?;
+    constructor(config?: Partial<StreamingOrchestratorConfig>);
+    /**
+     * Execute CLI analysis with full streaming capabilities
+     */
+    executeWithStreaming(analysisType: string, cliAgents: string[], systemPrompt: string, userPrompt: string, options?: StreamingExecutionOptions): Promise<StreamingExecutionResult>;
+    /**
+     * Create streaming event handler for session
+     */
+    private createStreamingEventHandler;
+    /**
+     * Execute CLI agents with circuit breaker protection
+     */
+    private executeWithCircuitBreaker;
+    /**
+     * Setup event handlers for internal components
+     */
+    private setupEventHandlers;
+    /**
+     * Setup circuit breakers for each CLI agent
+     */
+    private setupCircuitBreakers;
+    /**
+     * Update average analysis duration metric
+     */
+    private updateAverageAnalysisDuration;
+    /**
+     * Start cleanup timer for stale sessions and cache
+     */
+    private startCleanupTimer;
+    /**
+     * Perform periodic cleanup
+     */
+    private performCleanup;
+    /**
+     * Get orchestrator statistics
+     */
+    getStats(): {
+        metrics: {
+            totalAnalyses: number;
+            successfulAnalyses: number;
+            failedAnalyses: number;
+            totalEventsSent: number;
+            totalCircuitBreakerTrips: number;
+            totalFallbacksUsed: number;
+            averageAnalysisDuration: number;
+        };
+        activeAnalyses: number;
+        sessionManager: import("./session-manager.js").SessionManagerStats;
+        sseTransport: {
+            totalConnections: number;
+            activeConnections: number;
+            sessionDistribution: Record<string, number>;
+            averageEventsPerConnection: number;
+        };
+        circuitBreakers: Record<string, any>;
+    };
+    /**
+     * Get active session IDs
+     */
+    getActiveSessions(): string[];
+    /**
+     * Force disconnect session
+     */
+    disconnectSession(sessionId: string, reason?: string): void;
+    /**
+     * Reset circuit breaker for specific agent
+     */
+    resetCircuitBreaker(agent: string): void;
+    /**
+     * Add response to cache for fallback strategies
+     */
+    cacheResponse(key: string, response: any): void;
+    /**
+     * Shutdown orchestrator and cleanup resources
+     */
+    shutdown(): void;
+}
+//# sourceMappingURL=streaming-orchestrator.d.ts.map

package/dist/streaming/streaming-orchestrator.d.ts.map

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