lattice-orchestrator 0.7.0

package/dist/services/infrastructure/stream-manager.js

@@ -0,0 +1,436 @@
+import { EventEmitter } from 'events';
+import { createLogger } from '../infrastructure/logger.js';
+import { connectionDebugLogger } from '../connection-debug-logger.js';
+/**
+ * Manages streaming connections to multiple clients
+ */
+export class StreamManager extends EventEmitter {
+    clients = new Map();
+    logger;
+    heartbeatInterval;
+    // Event buffering for race condition between session start and SSE connection
+    eventBuffers = new Map();
+    // Buffer events for up to 2 seconds after session start
+    // This covers network latency + React state updates + SSE connection establishment
+    EVENT_BUFFER_WINDOW_MS = 2000;
+    // Maximum events to buffer per session (safety limit)
+    MAX_BUFFERED_EVENTS = 100;
+    // Send heartbeat every 30 seconds to keep connections alive
+    // IMPORTANT: Client expects heartbeat within 45s (1.5x this interval)
+    // See: web/chat/config/connection.ts HEARTBEAT_TIMEOUT_MS
+    HEARTBEAT_INTERVAL_MS = 30000;
+    constructor() {
+        super();
+        this.logger = createLogger('StreamManager');
+    }
+    /**
+     * Start buffering events for a session.
+     * Call this when a session is created, before any clients connect.
+     * Events will be replayed when the first client connects.
+     */
+    startBuffering(streamingId) {
+        // Don't start if already buffering
+        if (this.eventBuffers.has(streamingId)) {
+            return;
+        }
+        const timeoutId = setTimeout(() => {
+            this.stopBuffering(streamingId);
+        }, this.EVENT_BUFFER_WINDOW_MS);
+        this.eventBuffers.set(streamingId, {
+            events: [],
+            createdAt: Date.now(),
+            timeoutId,
+        });
+        this.logger.info('[BUFFERING] Started event buffering for session', {
+            streamingId: streamingId.slice(0, 8),
+            bufferWindowMs: this.EVENT_BUFFER_WINDOW_MS,
+        });
+    }
+    /**
+     * Stop buffering events for a session and discard any buffered events.
+     * Called automatically after the buffer window expires.
+     */
+    stopBuffering(streamingId) {
+        const buffer = this.eventBuffers.get(streamingId);
+        if (buffer) {
+            clearTimeout(buffer.timeoutId);
+            const eventCount = buffer.events.length;
+            this.eventBuffers.delete(streamingId);
+            if (eventCount > 0) {
+                this.logger.info('Discarded buffered events (no client connected in time)', {
+                    streamingId: streamingId.slice(0, 8),
+                    discardedEvents: eventCount,
+                    bufferAgeMs: Date.now() - buffer.createdAt,
+                });
+            }
+        }
+    }
+    /**
+     * Replay buffered events to a client and stop buffering.
+     * Called when the first client connects.
+     */
+    replayBufferedEvents(streamingId, res) {
+        const buffer = this.eventBuffers.get(streamingId);
+        if (!buffer || buffer.events.length === 0) {
+            this.stopBuffering(streamingId);
+            return;
+        }
+        clearTimeout(buffer.timeoutId);
+        const events = buffer.events;
+        this.eventBuffers.delete(streamingId);
+        this.logger.info('Replaying buffered events to first client', {
+            streamingId: streamingId.slice(0, 8),
+            eventCount: events.length,
+            bufferAgeMs: Date.now() - buffer.createdAt,
+        });
+        for (const event of events) {
+            try {
+                this.sendSSEEvent(res, event);
+            }
+            catch (error) {
+                this.logger.error('Failed to replay buffered event', error, {
+                    streamingId,
+                    eventType: event?.type,
+                });
+                break;
+            }
+        }
+    }
+    /**
+     * Add a client to receive stream updates
+     */
+    addClient(streamingId, res) {
+        this.logger.debug('Adding client to stream', { streamingId });
+        connectionDebugLogger.log('StreamManager', 'client-add-start', {
+            streamingId: streamingId.slice(0, 8),
+            existingClients: this.clients.get(streamingId)?.size || 0,
+            totalSessions: this.clients.size,
+        });
+        // Configure response for Server-Sent Events
+        res.setHeader('Content-Type', 'text/event-stream');
+        res.setHeader('Cache-Control', 'no-cache');
+        res.setHeader('X-Accel-Buffering', 'no');
+        res.setHeader('Access-Control-Allow-Origin', '*');
+        // Initialize client set if needed
+        if (!this.clients.has(streamingId)) {
+            this.clients.set(streamingId, new Set());
+        }
+        // Add this client to the session
+        this.clients.get(streamingId).add(res);
+        const clientCount = this.clients.get(streamingId).size;
+        this.logger.debug('Client added successfully', {
+            streamingId,
+            totalClients: clientCount
+        });
+        connectionDebugLogger.log('StreamManager', 'client-added', {
+            streamingId: streamingId.slice(0, 8),
+            clientCount,
+            totalSessions: this.clients.size,
+        });
+        // Send initial connection confirmation
+        const connectionMessage = {
+            type: 'connected',
+            streaming_id: streamingId,
+            timestamp: new Date().toISOString()
+        };
+        this.logger.debug('Sending initial SSE connection confirmation', {
+            streamingId,
+            clientCount: this.clients.get(streamingId).size
+        });
+        this.sendSSEEvent(res, connectionMessage);
+        // Replay any buffered events to the first client
+        // This handles the race condition where events are broadcast before SSE connection
+        if (clientCount === 1) {
+            this.replayBufferedEvents(streamingId, res);
+        }
+        // Start heartbeat if this is the first client
+        this.startHeartbeat();
+        // Clean up when client disconnects
+        res.on('close', () => {
+            connectionDebugLogger.log('StreamManager', 'client-close-event', {
+                streamingId: streamingId.slice(0, 8),
+                reason: 'res.close',
+            });
+            this.removeClient(streamingId, res);
+        });
+        res.on('error', (error) => {
+            this.logger.error('Stream error for session', error, { streamingId });
+            connectionDebugLogger.log('StreamManager', 'client-error-event', {
+                streamingId: streamingId.slice(0, 8),
+                error: error.message,
+            });
+            this.removeClient(streamingId, res);
+        });
+    }
+    /**
+     * Remove a client connection
+     */
+    removeClient(streamingId, res) {
+        const clients = this.clients.get(streamingId);
+        const hadClient = clients?.has(res);
+        if (clients) {
+            clients.delete(res);
+            if (clients.size === 0) {
+                this.clients.delete(streamingId);
+            }
+        }
+        connectionDebugLogger.log('StreamManager', 'client-removed', {
+            streamingId: streamingId.slice(0, 8),
+            wasTracked: hadClient,
+            remainingClients: clients?.size || 0,
+            remainingSessions: this.clients.size,
+        });
+        this.emit('client-disconnected', { streamingId });
+        // Stop heartbeat if no clients remain
+        if (this.getTotalClientCount() === 0) {
+            this.stopHeartbeat();
+        }
+    }
+    /**
+     * Broadcast an event to all clients watching a session
+     */
+    broadcast(streamingId, event) {
+        // Log question_request events at info level for debugging
+        const isQuestionRequest = event?.type === 'question_request';
+        const logLevel = isQuestionRequest ? 'info' : 'debug';
+        this.logger[logLevel]('Broadcasting event to clients', {
+            streamingId,
+            eventType: event?.type,
+            eventSubtype: 'subtype' in event ? event.subtype : undefined
+        });
+        const clients = this.clients.get(streamingId);
+        if (!clients || clients.size === 0) {
+            // Check if we should buffer this event (session just started, client not yet connected)
+            const buffer = this.eventBuffers.get(streamingId);
+            if (buffer) {
+                if (buffer.events.length < this.MAX_BUFFERED_EVENTS) {
+                    buffer.events.push(event);
+                    this.logger.debug('Buffered event for session (no clients yet)', {
+                        streamingId: streamingId.slice(0, 8),
+                        eventType: event?.type,
+                        bufferedCount: buffer.events.length,
+                    });
+                }
+                else {
+                    this.logger.warn('Event buffer full, dropping event', {
+                        streamingId: streamingId.slice(0, 8),
+                        eventType: event?.type,
+                        maxBuffered: this.MAX_BUFFERED_EVENTS,
+                    });
+                }
+                return;
+            }
+            // No buffer and no clients - event will be lost
+            // Log at info level for question_request events to diagnose issues
+            this.logger[isQuestionRequest ? 'info' : 'debug']('No clients found for streaming session, dropping message', {
+                streamingId,
+                eventType: event?.type
+            });
+            connectionDebugLogger.log('StreamManager', 'broadcast-no-clients', {
+                streamingId: streamingId.slice(0, 8),
+                eventType: event?.type,
+                trackedSessions: Array.from(this.clients.keys()).map(s => s.slice(0, 8)),
+            });
+            return;
+        }
+        this.logger.debug('Found clients for broadcast', {
+            streamingId,
+            clientCount: clients.size
+        });
+        const deadClients = [];
+        for (const client of clients) {
+            try {
+                this.sendSSEEvent(client, event);
+                this.logger.debug('Successfully sent SSE event to client', {
+                    streamingId,
+                    eventType: event?.type,
+                    eventSubtype: 'subtype' in event ? event.subtype : undefined
+                });
+            }
+            catch (error) {
+                this.logger.error('Failed to send SSE event to client', error, { streamingId });
+                deadClients.push(client);
+            }
+        }
+        // Clean up dead clients
+        deadClients.forEach(client => this.removeClient(streamingId, client));
+    }
+    /**
+     * Send an SSE event to a specific client
+     */
+    sendSSEEvent(res, message, eventType) {
+        if (res.writableEnded || res.destroyed) {
+            throw new Error('Response is no longer writable');
+        }
+        let sseData = '';
+        if (eventType) {
+            sseData += `event: ${eventType}\n`;
+        }
+        sseData += `data: ${JSON.stringify(message)}\n\n`;
+        // Log SSE event data
+        this.logger.debug('Sending SSE event', {
+            eventType,
+            messageType: message?.type,
+            messageSubtype: 'subtype' in message ? message.subtype : undefined,
+            streamingId: 'streamingId' in message ? message.streamingId : 'streaming_id' in message ? message.streaming_id : undefined,
+            sseDataLength: sseData.length
+        });
+        res.write(sseData);
+    }
+    /**
+     * Send SSE heartbeat (comment) to keep connection alive
+     */
+    sendHeartbeat(res) {
+        if (!res.writableEnded && !res.destroyed) {
+            res.write(': heartbeat\n\n');
+        }
+    }
+    /**
+     * Get number of clients connected to a session
+     */
+    getClientCount(streamingId) {
+        return this.clients.get(streamingId)?.size || 0;
+    }
+    /**
+     * Get all active sessions
+     */
+    getActiveSessions() {
+        return Array.from(this.clients.keys());
+    }
+    /**
+     * Close all connections for a session
+     */
+    closeSession(streamingId) {
+        // Clean up any pending event buffer
+        this.stopBuffering(streamingId);
+        const clients = this.clients.get(streamingId);
+        if (!clients)
+            return;
+        const closeEvent = {
+            type: 'closed',
+            streamingId: streamingId,
+            timestamp: new Date().toISOString()
+        };
+        // Create array to avoid modifying set while iterating
+        const clientsArray = Array.from(clients);
+        this.logger.debug('Closing SSE session, sending close events to all clients', {
+            streamingId,
+            clientCount: clientsArray.length
+        });
+        for (const client of clientsArray) {
+            try {
+                this.sendSSEEvent(client, closeEvent);
+                this.logger.debug('Sent SSE close event to client', { streamingId });
+                client.end();
+            }
+            catch (error) {
+                this.logger.error('Error closing SSE client connection', error, { streamingId });
+            }
+        }
+        // Remove the entire session
+        this.clients.delete(streamingId);
+        // Stop heartbeat if no clients remain
+        if (this.getTotalClientCount() === 0) {
+            this.stopHeartbeat();
+        }
+    }
+    /**
+     * Get total number of clients across all sessions
+     */
+    getTotalClientCount() {
+        let total = 0;
+        for (const clients of this.clients.values()) {
+            total += clients.size;
+        }
+        return total;
+    }
+    /**
+     * Clean up orphaned sessions that don't have an active Claude process.
+     * Call this with a set of active streamingIds to close any sessions not in that set.
+     */
+    cleanupOrphanedSessions(activeStreamingIds) {
+        const orphanedSessions = [];
+        for (const streamingId of this.clients.keys()) {
+            if (!activeStreamingIds.has(streamingId)) {
+                orphanedSessions.push(streamingId);
+            }
+        }
+        if (orphanedSessions.length > 0) {
+            this.logger.info('Cleaning up orphaned SSE sessions', {
+                count: orphanedSessions.length,
+                orphanedIds: orphanedSessions.map(s => s.slice(0, 8)),
+            });
+            for (const streamingId of orphanedSessions) {
+                this.closeSession(streamingId);
+            }
+        }
+        return orphanedSessions.length;
+    }
+    /**
+     * Disconnect all clients from all sessions
+     */
+    disconnectAll() {
+        // Clean up all event buffers first
+        for (const streamingId of this.eventBuffers.keys()) {
+            this.stopBuffering(streamingId);
+        }
+        for (const streamingId of this.clients.keys()) {
+            this.closeSession(streamingId);
+        }
+        this.stopHeartbeat();
+    }
+    /**
+     * Start periodic heartbeat to keep SSE connections alive
+     * Also prunes stale/dead clients that failed to disconnect properly
+     */
+    startHeartbeat() {
+        if (this.heartbeatInterval) {
+            return; // Already running
+        }
+        this.heartbeatInterval = setInterval(() => {
+            this.logger.debug('Sending heartbeat to all clients');
+            // Collect dead clients during heartbeat check
+            const deadClients = [];
+            for (const [streamingId, clients] of this.clients.entries()) {
+                for (const client of clients) {
+                    try {
+                        // Check if the response is still writable before sending
+                        if (client.writableEnded || client.destroyed) {
+                            deadClients.push({ streamingId, client });
+                            continue;
+                        }
+                        this.sendHeartbeat(client);
+                    }
+                    catch (error) {
+                        this.logger.debug('Failed to send heartbeat to client, marking as dead', {
+                            error,
+                            streamingId: streamingId.slice(0, 8),
+                        });
+                        deadClients.push({ streamingId, client });
+                    }
+                }
+            }
+            // Clean up dead clients discovered during heartbeat
+            if (deadClients.length > 0) {
+                this.logger.info('Pruning stale SSE clients discovered during heartbeat', {
+                    count: deadClients.length,
+                    sessions: [...new Set(deadClients.map(d => d.streamingId.slice(0, 8)))],
+                });
+                for (const { streamingId, client } of deadClients) {
+                    this.removeClient(streamingId, client);
+                }
+            }
+        }, this.HEARTBEAT_INTERVAL_MS);
+    }
+    /**
+     * Stop periodic heartbeat
+     */
+    stopHeartbeat() {
+        if (this.heartbeatInterval) {
+            clearInterval(this.heartbeatInterval);
+            this.heartbeatInterval = undefined;
+            this.logger.debug('Stopped heartbeat');
+        }
+    }
+}
+//# sourceMappingURL=stream-manager.js.map

package/dist/services/infrastructure/stream-manager.js.map

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

package/dist/services/infrastructure/timing.d.ts

@@ -0,0 +1,72 @@
+/**
+ * Timing utility for measuring and logging operation durations.
+ *
+ * Provides a simple, reusable way to measure performance of operations
+ * (especially API endpoints) with automatic debug logging.
+ *
+ * Usage:
+ * ```ts
+ * const timer = createTimer('fetchConversations', logger);
+ *
+ * timer.mark('listSessions');
+ * const sessions = await listSessions();
+ *
+ * timer.mark('fetchInsights');
+ * const insights = await fetchInsights();
+ *
+ * timer.end({ sessionCount: sessions.length }); // logs all timings
+ * ```
+ */
+import { type CUILogger } from './logger.js';
+export interface TimingResult {
+    total: number;
+    marks: Record<string, number>;
+}
+export interface Timer {
+    /** Mark the start of a named phase */
+    mark(name: string): void;
+    /** End timing and log results (only in debug mode) */
+    end(extraContext?: Record<string, unknown>): TimingResult;
+    /** Get elapsed time since timer creation */
+    elapsed(): number;
+    /** Get current timings without ending */
+    getTimings(): TimingResult;
+}
+/**
+ * Create a timer for measuring operation phases.
+ *
+ * @param operation - Name of the operation being timed (e.g., 'fetchConversations')
+ * @param logger - Logger instance to use for debug output
+ * @returns Timer object with mark() and end() methods
+ */
+export declare function createTimer(operation: string, logger?: CUILogger): Timer;
+/**
+ * Time a single async operation and return result with duration.
+ *
+ * @param fn - Async function to time
+ * @returns Tuple of [result, durationMs]
+ *
+ * @example
+ * const [data, ms] = await timeAsync(() => fetch('/api/data'));
+ * logger.debug('Fetch completed', { durationMs: ms });
+ */
+export declare function timeAsync<T>(fn: () => Promise<T>): Promise<[T, number]>;
+/**
+ * Time a synchronous operation and return result with duration.
+ *
+ * @param fn - Function to time
+ * @returns Tuple of [result, durationMs]
+ */
+export declare function timeSync<T>(fn: () => T): [T, number];
+/**
+ * Express middleware for timing requests (debug mode only).
+ * Adds X-Response-Time header in development.
+ */
+export declare function requestTimingMiddleware(): (req: {
+    method: string;
+    path: string;
+}, res: {
+    setHeader: (name: string, value: string) => void;
+    on: (event: string, fn: () => void) => void;
+}, next: () => void) => void;
+//# sourceMappingURL=timing.d.ts.map

package/dist/services/infrastructure/timing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"timing.d.ts","sourceRoot":"","sources":["../../../src/services/infrastructure/timing.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,aAAa,CAAC;AAE7C,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC/B;AAED,MAAM,WAAW,KAAK;IACpB,sCAAsC;IACtC,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,sDAAsD;IACtD,GAAG,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,YAAY,CAAC;IAC1D,4CAA4C;IAC5C,OAAO,IAAI,MAAM,CAAC;IAClB,yCAAyC;IACzC,UAAU,IAAI,YAAY,CAAC;CAC5B;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,SAAS,GAAG,KAAK,CAiDxE;AAED;;;;;;;;;GASG;AACH,wBAAsB,SAAS,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,CAI7E;AAED;;;;;GAKG;AACH,wBAAgB,QAAQ,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,EAAE,MAAM,CAAC,CAIpD;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,KAC7B,KAAK;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,EAAE,KAAK;IAAE,SAAS,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAAC,EAAE,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,IAAI,KAAK,IAAI,CAAA;CAAE,EAAE,MAAM,MAAM,IAAI,UAiBxK"}

package/dist/services/infrastructure/timing.js

@@ -0,0 +1,115 @@
+/**
+ * Timing utility for measuring and logging operation durations.
+ *
+ * Provides a simple, reusable way to measure performance of operations
+ * (especially API endpoints) with automatic debug logging.
+ *
+ * Usage:
+ * ```ts
+ * const timer = createTimer('fetchConversations', logger);
+ *
+ * timer.mark('listSessions');
+ * const sessions = await listSessions();
+ *
+ * timer.mark('fetchInsights');
+ * const insights = await fetchInsights();
+ *
+ * timer.end({ sessionCount: sessions.length }); // logs all timings
+ * ```
+ */
+/**
+ * Create a timer for measuring operation phases.
+ *
+ * @param operation - Name of the operation being timed (e.g., 'fetchConversations')
+ * @param logger - Logger instance to use for debug output
+ * @returns Timer object with mark() and end() methods
+ */
+export function createTimer(operation, logger) {
+    const startTime = Date.now();
+    const marks = [];
+    let lastMarkTime = startTime;
+    return {
+        mark(name) {
+            const now = Date.now();
+            marks.push({ name, time: now - lastMarkTime });
+            lastMarkTime = now;
+        },
+        end(extraContext) {
+            const total = Date.now() - startTime;
+            const timings = {};
+            for (const mark of marks) {
+                timings[mark.name] = mark.time;
+            }
+            const result = { total, marks: timings };
+            // Only log in debug mode
+            if (logger) {
+                logger.debug(`${operation} timing`, {
+                    durationMs: total,
+                    timingsMs: timings,
+                    ...extraContext
+                });
+            }
+            return result;
+        },
+        elapsed() {
+            return Date.now() - startTime;
+        },
+        getTimings() {
+            const total = Date.now() - startTime;
+            const timings = {};
+            for (const mark of marks) {
+                timings[mark.name] = mark.time;
+            }
+            return { total, marks: timings };
+        }
+    };
+}
+/**
+ * Time a single async operation and return result with duration.
+ *
+ * @param fn - Async function to time
+ * @returns Tuple of [result, durationMs]
+ *
+ * @example
+ * const [data, ms] = await timeAsync(() => fetch('/api/data'));
+ * logger.debug('Fetch completed', { durationMs: ms });
+ */
+export async function timeAsync(fn) {
+    const start = Date.now();
+    const result = await fn();
+    return [result, Date.now() - start];
+}
+/**
+ * Time a synchronous operation and return result with duration.
+ *
+ * @param fn - Function to time
+ * @returns Tuple of [result, durationMs]
+ */
+export function timeSync(fn) {
+    const start = Date.now();
+    const result = fn();
+    return [result, Date.now() - start];
+}
+/**
+ * Express middleware for timing requests (debug mode only).
+ * Adds X-Response-Time header in development.
+ */
+export function requestTimingMiddleware() {
+    return (req, res, next) => {
+        const start = Date.now();
+        res.on('finish', () => {
+            const duration = Date.now() - start;
+            // Only set header in non-production (it's already handled by most frameworks)
+            if (process.env.NODE_ENV !== 'production') {
+                try {
+                    res.setHeader('X-Response-Time', `${duration}ms`);
+                }
+                catch {
+                    // Response already sent, ignore
+                }
+            }
+        });
+        next();
+    };
+}
+//# sourceMappingURL=timing.js.map

package/dist/services/infrastructure/timing.js.map

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