agentic-qe 3.3.4 → 3.4.0

package/v3/dist/mcp/transport/sse/connection-manager.js

@@ -0,0 +1,271 @@
+/**
+ * Agentic QE v3 - SSE Connection Manager
+ * Manages SSE connection lifecycle, keep-alive, and cleanup
+ */
+import { v4 as uuid } from 'uuid';
+const DEFAULT_CONFIG = {
+    keepAliveInterval: 15000,
+    connectionTimeout: 300000,
+    maxConnections: 1000,
+    enableMetrics: true,
+};
+// ============================================================================
+// Connection Manager Implementation
+// ============================================================================
+export class ConnectionManager {
+    config;
+    connections = new Map();
+    closedConnections = []; // Keep closed connections for metrics
+    keepAliveTimers = new Map();
+    timeoutTimers = new Map();
+    disposed = false;
+    constructor(config = {}) {
+        this.config = { ...DEFAULT_CONFIG, ...config };
+    }
+    /**
+     * Create a new SSE connection
+     */
+    createConnection(threadId, runId, response) {
+        if (this.disposed) {
+            throw new Error('ConnectionManager has been disposed');
+        }
+        if (this.connections.size >= this.config.maxConnections) {
+            throw new Error(`Maximum connections (${this.config.maxConnections}) exceeded`);
+        }
+        const id = uuid();
+        const now = Date.now();
+        const connection = {
+            id,
+            threadId,
+            runId,
+            createdAt: now,
+            lastActivity: now,
+            response,
+            abortController: new AbortController(),
+            state: 'connecting',
+            metrics: {
+                eventsSent: 0,
+                bytesSent: 0,
+                keepAlivesSent: 0,
+                errors: 0,
+                startTime: now,
+            },
+        };
+        this.connections.set(id, connection);
+        this.startKeepAlive(id);
+        this.startTimeout(id);
+        return connection;
+    }
+    /**
+     * Get connection by ID
+     */
+    getConnection(id) {
+        return this.connections.get(id);
+    }
+    /**
+     * Get connection by thread ID
+     */
+    getConnectionByThreadId(threadId) {
+        const connections = Array.from(this.connections.values());
+        for (const connection of connections) {
+            if (connection.threadId === threadId) {
+                return connection;
+            }
+        }
+        return undefined;
+    }
+    /**
+     * Get all active connections
+     */
+    getActiveConnections() {
+        return Array.from(this.connections.values()).filter((conn) => conn.state === 'open' || conn.state === 'connecting');
+    }
+    /**
+     * Update connection state
+     */
+    updateState(id, state) {
+        const connection = this.connections.get(id);
+        if (connection) {
+            connection.state = state;
+            connection.lastActivity = Date.now();
+            if (state === 'closed') {
+                connection.metrics.endTime = Date.now();
+            }
+        }
+    }
+    /**
+     * Record event sent
+     */
+    recordEventSent(id, bytes) {
+        const connection = this.connections.get(id);
+        if (connection) {
+            connection.metrics.eventsSent++;
+            connection.metrics.bytesSent += bytes;
+            connection.lastActivity = Date.now();
+            this.resetTimeout(id);
+        }
+    }
+    /**
+     * Record error
+     */
+    recordError(id) {
+        const connection = this.connections.get(id);
+        if (connection) {
+            connection.metrics.errors++;
+        }
+    }
+    /**
+     * Close connection
+     */
+    closeConnection(id, reason) {
+        const connection = this.connections.get(id);
+        if (!connection) {
+            return;
+        }
+        // Stop timers
+        this.stopKeepAlive(id);
+        this.stopTimeout(id);
+        // Update state
+        connection.state = 'closing';
+        connection.metrics.endTime = Date.now();
+        // Abort any ongoing operations
+        connection.abortController.abort(reason || 'Connection closed');
+        // End response if not already ended
+        if (!connection.response.writableEnded) {
+            try {
+                connection.response.end();
+            }
+            catch {
+                // Ignore errors when ending response
+            }
+        }
+        connection.state = 'closed';
+        // Store in closed connections for metrics tracking
+        this.closedConnections.push(connection);
+        // Limit closed connections history to prevent memory leak
+        while (this.closedConnections.length > 1000) {
+            this.closedConnections.shift();
+        }
+        this.connections.delete(id);
+    }
+    /**
+     * Close all connections for a thread
+     */
+    closeThreadConnections(threadId, reason) {
+        const connections = Array.from(this.connections.values());
+        for (const connection of connections) {
+            if (connection.threadId === threadId) {
+                this.closeConnection(connection.id, reason);
+            }
+        }
+    }
+    /**
+     * Get transport metrics
+     */
+    getMetrics() {
+        const activeConnectionsList = Array.from(this.connections.values());
+        const allConnections = [...activeConnectionsList, ...this.closedConnections];
+        const activeConnections = activeConnectionsList.filter((c) => c.state === 'open' || c.state === 'connecting');
+        const durations = allConnections
+            .filter((c) => c.metrics.endTime)
+            .map((c) => (c.metrics.endTime ?? 0) - c.metrics.startTime);
+        const averageDuration = durations.length > 0
+            ? durations.reduce((a, b) => a + b, 0) / durations.length
+            : 0;
+        return {
+            totalConnections: allConnections.length,
+            activeConnections: activeConnections.length,
+            totalEventsSent: allConnections.reduce((sum, c) => sum + c.metrics.eventsSent, 0),
+            totalBytesSent: allConnections.reduce((sum, c) => sum + c.metrics.bytesSent, 0),
+            totalErrors: allConnections.reduce((sum, c) => sum + c.metrics.errors, 0),
+            averageConnectionDuration: averageDuration,
+        };
+    }
+    /**
+     * Dispose of the manager and close all connections
+     */
+    dispose() {
+        if (this.disposed) {
+            return;
+        }
+        this.disposed = true;
+        // Close all connections
+        const connectionIds = Array.from(this.connections.keys());
+        for (const id of connectionIds) {
+            this.closeConnection(id, 'Manager disposed');
+        }
+        // Clear all timers
+        const keepAliveTimersList = Array.from(this.keepAliveTimers.values());
+        for (const timer of keepAliveTimersList) {
+            clearInterval(timer);
+        }
+        this.keepAliveTimers.clear();
+        const timeoutTimersList = Array.from(this.timeoutTimers.values());
+        for (const timer of timeoutTimersList) {
+            clearTimeout(timer);
+        }
+        this.timeoutTimers.clear();
+    }
+    // ============================================================================
+    // Private Methods
+    // ============================================================================
+    startKeepAlive(id) {
+        const timer = setInterval(() => {
+            this.sendKeepAlive(id);
+        }, this.config.keepAliveInterval);
+        this.keepAliveTimers.set(id, timer);
+    }
+    stopKeepAlive(id) {
+        const timer = this.keepAliveTimers.get(id);
+        if (timer) {
+            clearInterval(timer);
+            this.keepAliveTimers.delete(id);
+        }
+    }
+    sendKeepAlive(id) {
+        const connection = this.connections.get(id);
+        if (!connection || connection.state !== 'open') {
+            return;
+        }
+        try {
+            // SSE comment format for keep-alive
+            const keepAlive = `: keep-alive\n\n`;
+            connection.response.write(keepAlive);
+            connection.metrics.keepAlivesSent++;
+            connection.lastActivity = Date.now();
+            // Flush if available (Express-style flush for compression middleware)
+            const res = connection.response;
+            if (res.flush && typeof res.flush === 'function') {
+                res.flush();
+            }
+        }
+        catch {
+            // Connection might be closed
+            this.closeConnection(id, 'Keep-alive failed');
+        }
+    }
+    startTimeout(id) {
+        const timer = setTimeout(() => {
+            this.closeConnection(id, 'Connection timeout');
+        }, this.config.connectionTimeout);
+        this.timeoutTimers.set(id, timer);
+    }
+    stopTimeout(id) {
+        const timer = this.timeoutTimers.get(id);
+        if (timer) {
+            clearTimeout(timer);
+            this.timeoutTimers.delete(id);
+        }
+    }
+    resetTimeout(id) {
+        this.stopTimeout(id);
+        this.startTimeout(id);
+    }
+}
+// ============================================================================
+// Factory Function
+// ============================================================================
+export function createConnectionManager(config) {
+    return new ConnectionManager(config);
+}
+//# sourceMappingURL=connection-manager.js.map

package/v3/dist/mcp/transport/sse/connection-manager.js.map

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

package/v3/dist/mcp/transport/sse/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Agentic QE v3 - SSE Transport
+ * Server-Sent Events transport for AG-UI protocol compliance
+ *
+ * @module mcp/transport/sse
+ */
+export { SSETransport, createSSETransport, createSSEMiddleware, type SSEMiddlewareOptions, } from './sse-transport.js';
+export { ConnectionManager, createConnectionManager, type ConnectionManagerConfig, } from './connection-manager.js';
+export { AGUIEventType, type AGUIEventTypeValue, type AGUIEvent, type BaseAGUIEvent, type RunStartedEvent, type RunFinishedEvent, type RunErrorEvent, type StepStartedEvent, type StepFinishedEvent, type TextMessageStartEvent, type TextMessageContentEvent, type TextMessageEndEvent, type ToolCallStartEvent, type ToolCallArgsEvent, type ToolCallEndEvent, type ToolCallResultEvent, type StateSnapshotEvent, type StateDeltaEvent, type MessagesSnapshotEvent, type CustomEvent, type JsonPatchOperation, type Message, type SSETransportConfig, type AgentRequest, type AgentTool, type AgentHandler, type EventEmitter, type SSEConnection, type ConnectionState, type ConnectionMetrics, type SSETransportMetrics, type SSERequest, type SSEResponse, } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/v3/dist/mcp/transport/sse/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/mcp/transport/sse/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EACL,YAAY,EACZ,kBAAkB,EAClB,mBAAmB,EACnB,KAAK,oBAAoB,GAC1B,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EACL,iBAAiB,EACjB,uBAAuB,EACvB,KAAK,uBAAuB,GAC7B,MAAM,yBAAyB,CAAC;AAGjC,OAAO,EAEL,aAAa,EACb,KAAK,kBAAkB,EACvB,KAAK,SAAS,EACd,KAAK,aAAa,EAGlB,KAAK,eAAe,EACpB,KAAK,gBAAgB,EACrB,KAAK,aAAa,EAClB,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,EAGtB,KAAK,qBAAqB,EAC1B,KAAK,uBAAuB,EAC5B,KAAK,mBAAmB,EAGxB,KAAK,kBAAkB,EACvB,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,EACrB,KAAK,mBAAmB,EAGxB,KAAK,kBAAkB,EACvB,KAAK,eAAe,EACpB,KAAK,qBAAqB,EAC1B,KAAK,WAAW,EAGhB,KAAK,kBAAkB,EACvB,KAAK,OAAO,EAGZ,KAAK,kBAAkB,EACvB,KAAK,YAAY,EACjB,KAAK,SAAS,EACd,KAAK,YAAY,EACjB,KAAK,YAAY,EAGjB,KAAK,aAAa,EAClB,KAAK,eAAe,EACpB,KAAK,iBAAiB,EACtB,KAAK,mBAAmB,EAGxB,KAAK,UAAU,EACf,KAAK,WAAW,GACjB,MAAM,YAAY,CAAC"}

package/v3/dist/mcp/transport/sse/index.js

@@ -0,0 +1,15 @@
+/**
+ * Agentic QE v3 - SSE Transport
+ * Server-Sent Events transport for AG-UI protocol compliance
+ *
+ * @module mcp/transport/sse
+ */
+// Main transport
+export { SSETransport, createSSETransport, createSSEMiddleware, } from './sse-transport.js';
+// Connection management
+export { ConnectionManager, createConnectionManager, } from './connection-manager.js';
+// Types
+export { 
+// Event types
+AGUIEventType, } from './types.js';
+//# sourceMappingURL=index.js.map

package/v3/dist/mcp/transport/sse/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/mcp/transport/sse/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,iBAAiB;AACjB,OAAO,EACL,YAAY,EACZ,kBAAkB,EAClB,mBAAmB,GAEpB,MAAM,oBAAoB,CAAC;AAE5B,wBAAwB;AACxB,OAAO,EACL,iBAAiB,EACjB,uBAAuB,GAExB,MAAM,yBAAyB,CAAC;AAEjC,QAAQ;AACR,OAAO;AACL,cAAc;AACd,aAAa,GAiDd,MAAM,YAAY,CAAC"}

package/v3/dist/mcp/transport/sse/sse-transport.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Agentic QE v3 - SSE Transport
+ * Server-Sent Events transport implementation for AG-UI protocol
+ */
+import type { IncomingMessage, ServerResponse } from 'http';
+import type { SSETransportConfig, AgentHandler, SSERequest, SSEResponse, SSETransportMetrics } from './types.js';
+export declare class SSETransport {
+    private readonly config;
+    private readonly connectionManager;
+    private agentHandler;
+    private disposed;
+    constructor(config?: SSETransportConfig);
+    /**
+     * Set the agent handler for processing requests
+     */
+    setAgentHandler(handler: AgentHandler): void;
+    /**
+     * Handle incoming SSE request
+     * This is the main entry point for the `/agent/stream` endpoint
+     */
+    handleRequest(req: SSERequest | IncomingMessage, res: SSEResponse | ServerResponse): Promise<void>;
+    /**
+     * Get transport metrics
+     */
+    getMetrics(): SSETransportMetrics;
+    /**
+     * Get active connections count
+     */
+    getActiveConnectionsCount(): number;
+    /**
+     * Close all connections
+     */
+    closeAllConnections(reason?: string): void;
+    /**
+     * Dispose of the transport
+     */
+    dispose(): void;
+    private parseRequestBody;
+    private setSSEHeaders;
+    private writeEvent;
+    private writeEvents;
+    private formatSSEEvent;
+    private sendError;
+}
+export declare function createSSETransport(config?: SSETransportConfig): SSETransport;
+export interface SSEMiddlewareOptions extends SSETransportConfig {
+    /**
+     * Path to mount the SSE endpoint (default: '/agent/stream')
+     */
+    path?: string;
+}
+/**
+ * Create Express middleware for SSE transport
+ */
+export declare function createSSEMiddleware(agentHandler: AgentHandler, options?: SSEMiddlewareOptions): (req: IncomingMessage, res: ServerResponse, next: () => void) => void;
+//# sourceMappingURL=sse-transport.d.ts.map

package/v3/dist/mcp/transport/sse/sse-transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sse-transport.d.ts","sourceRoot":"","sources":["../../../../src/mcp/transport/sse/sse-transport.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,MAAM,CAAC;AAE5D,OAAO,KAAK,EACV,kBAAkB,EAIlB,YAAY,EAEZ,UAAU,EACV,WAAW,EACX,mBAAmB,EAEpB,MAAM,YAAY,CAAC;AAqFpB,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA+B;IACtD,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAoB;IACtD,OAAO,CAAC,YAAY,CAA6B;IACjD,OAAO,CAAC,QAAQ,CAAS;gBAEb,MAAM,GAAE,kBAAuB;IAQ3C;;OAEG;IACH,eAAe,CAAC,OAAO,EAAE,YAAY,GAAG,IAAI;IAI5C;;;OAGG;IACG,aAAa,CACjB,GAAG,EAAE,UAAU,GAAG,eAAe,EACjC,GAAG,EAAE,WAAW,GAAG,cAAc,GAChC,OAAO,CAAC,IAAI,CAAC;IA8IhB;;OAEG;IACH,UAAU,IAAI,mBAAmB;IAIjC;;OAEG;IACH,yBAAyB,IAAI,MAAM;IAInC;;OAEG;IACH,mBAAmB,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI;IAO1C;;OAEG;IACH,OAAO,IAAI,IAAI;YAYD,gBAAgB;IA2C9B,OAAO,CAAC,aAAa;IAerB,OAAO,CAAC,UAAU;IAoBlB,OAAO,CAAC,WAAW;IA6BnB,OAAO,CAAC,cAAc;IAMtB,OAAO,CAAC,SAAS;CAelB;AAMD,wBAAgB,kBAAkB,CAAC,MAAM,CAAC,EAAE,kBAAkB,GAAG,YAAY,CAE5E;AAMD,MAAM,WAAW,oBAAqB,SAAQ,kBAAkB;IAC9D;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,YAAY,EAAE,YAAY,EAC1B,OAAO,GAAE,oBAAyB,GACjC,CAAC,GAAG,EAAE,eAAe,EAAE,GAAG,EAAE,cAAc,EAAE,IAAI,EAAE,MAAM,IAAI,KAAK,IAAI,CAoBvE"}