agentic-qe 3.3.4 → 3.4.0

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

@@ -0,0 +1,381 @@
+/**
+ * Agentic QE v3 - SSE Transport
+ * Server-Sent Events transport implementation for AG-UI protocol
+ */
+import { v4 as uuid } from 'uuid';
+import { createConnectionManager } from './connection-manager.js';
+import { AGUIEventType } from './types.js';
+// ============================================================================
+// Configuration
+// ============================================================================
+const DEFAULT_CONFIG = {
+    keepAliveInterval: 15000,
+    maxBufferSize: 100,
+    flushInterval: 50,
+    parseBody: true,
+    maxBodySize: 1024 * 1024, // 1MB
+    connectionTimeout: 300000, // 5 minutes
+    customHeaders: {},
+};
+// ============================================================================
+// Event Buffer for Backpressure Handling
+// ============================================================================
+class EventBuffer {
+    buffer = [];
+    flushTimer = null;
+    flushInterval;
+    maxSize;
+    onFlush;
+    constructor(flushInterval, maxSize, onFlush) {
+        this.flushInterval = flushInterval;
+        this.maxSize = maxSize;
+        this.onFlush = onFlush;
+    }
+    add(event) {
+        this.buffer.push(event);
+        // Immediate flush if buffer is full (backpressure)
+        if (this.buffer.length >= this.maxSize) {
+            this.flush();
+            return;
+        }
+        // Schedule flush if not already scheduled
+        if (!this.flushTimer) {
+            this.flushTimer = setTimeout(() => {
+                this.flush();
+            }, this.flushInterval);
+        }
+    }
+    flush() {
+        if (this.flushTimer) {
+            clearTimeout(this.flushTimer);
+            this.flushTimer = null;
+        }
+        if (this.buffer.length > 0) {
+            const events = this.buffer;
+            this.buffer = [];
+            this.onFlush(events);
+        }
+    }
+    clear() {
+        if (this.flushTimer) {
+            clearTimeout(this.flushTimer);
+            this.flushTimer = null;
+        }
+        this.buffer = [];
+    }
+    get size() {
+        return this.buffer.length;
+    }
+}
+// ============================================================================
+// SSE Transport Implementation
+// ============================================================================
+export class SSETransport {
+    config;
+    connectionManager;
+    agentHandler = null;
+    disposed = false;
+    constructor(config = {}) {
+        this.config = { ...DEFAULT_CONFIG, ...config };
+        this.connectionManager = createConnectionManager({
+            keepAliveInterval: this.config.keepAliveInterval,
+            connectionTimeout: this.config.connectionTimeout,
+        });
+    }
+    /**
+     * Set the agent handler for processing requests
+     */
+    setAgentHandler(handler) {
+        this.agentHandler = handler;
+    }
+    /**
+     * Handle incoming SSE request
+     * This is the main entry point for the `/agent/stream` endpoint
+     */
+    async handleRequest(req, res) {
+        if (this.disposed) {
+            this.sendError(res, 503, 'Service Unavailable', 'Transport disposed');
+            return;
+        }
+        // Only accept POST requests
+        if (req.method !== 'POST') {
+            this.sendError(res, 405, 'Method Not Allowed', 'Only POST is supported');
+            return;
+        }
+        // Parse request body if needed
+        let agentRequest;
+        try {
+            agentRequest = await this.parseRequestBody(req);
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : 'Failed to parse request body';
+            this.sendError(res, 400, 'Bad Request', message);
+            return;
+        }
+        // Validate required fields
+        if (!agentRequest.threadId) {
+            this.sendError(res, 400, 'Bad Request', 'Missing required field: threadId');
+            return;
+        }
+        // Generate run ID if not provided
+        const runId = agentRequest.runId || uuid();
+        // Set SSE headers
+        this.setSSEHeaders(res);
+        // Create connection
+        let connection;
+        try {
+            connection = this.connectionManager.createConnection(agentRequest.threadId, runId, res);
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : 'Failed to create connection';
+            this.sendError(res, 503, 'Service Unavailable', message);
+            return;
+        }
+        // Mark connection as open
+        this.connectionManager.updateState(connection.id, 'open');
+        // Set up event buffer for backpressure handling
+        const buffer = new EventBuffer(this.config.flushInterval, this.config.maxBufferSize, (events) => this.writeEvents(connection, events));
+        // Create event emitter function
+        const emit = (event) => {
+            if (connection.state !== 'open') {
+                return;
+            }
+            // Add timestamp if not present
+            if (!event.timestamp) {
+                event.timestamp = Date.now();
+            }
+            buffer.add(event);
+        };
+        // Handle client disconnect
+        req.on('close', () => {
+            buffer.clear();
+            this.connectionManager.closeConnection(connection.id, 'Client disconnected');
+        });
+        req.on('error', () => {
+            buffer.clear();
+            this.connectionManager.recordError(connection.id);
+            this.connectionManager.closeConnection(connection.id, 'Request error');
+        });
+        res.on('error', () => {
+            buffer.clear();
+            this.connectionManager.recordError(connection.id);
+            this.connectionManager.closeConnection(connection.id, 'Response error');
+        });
+        // Emit RUN_STARTED event
+        emit({
+            type: AGUIEventType.RUN_STARTED,
+            threadId: agentRequest.threadId,
+            runId,
+        });
+        // Flush the RUN_STARTED event immediately
+        buffer.flush();
+        // Process agent request
+        try {
+            if (!this.agentHandler) {
+                throw new Error('No agent handler registered');
+            }
+            await this.agentHandler(agentRequest, emit, connection.abortController.signal);
+            // Flush any remaining buffered events
+            buffer.flush();
+            // Emit RUN_FINISHED event if connection is still open
+            if (connection.state === 'open') {
+                this.writeEvent(connection, {
+                    type: AGUIEventType.RUN_FINISHED,
+                    runId,
+                    outcome: 'success',
+                    timestamp: Date.now(),
+                });
+            }
+        }
+        catch (error) {
+            // Flush buffer before error event
+            buffer.flush();
+            const message = error instanceof Error ? error.message : 'Unknown error';
+            const isAborted = error instanceof Error && error.name === 'AbortError';
+            if (!isAborted && connection.state === 'open') {
+                this.writeEvent(connection, {
+                    type: AGUIEventType.RUN_ERROR,
+                    runId,
+                    message,
+                    code: 'INTERNAL_ERROR',
+                    timestamp: Date.now(),
+                });
+                this.connectionManager.recordError(connection.id);
+            }
+        }
+        finally {
+            // Close connection
+            buffer.clear();
+            this.connectionManager.closeConnection(connection.id, 'Request complete');
+        }
+    }
+    /**
+     * Get transport metrics
+     */
+    getMetrics() {
+        return this.connectionManager.getMetrics();
+    }
+    /**
+     * Get active connections count
+     */
+    getActiveConnectionsCount() {
+        return this.connectionManager.getActiveConnections().length;
+    }
+    /**
+     * Close all connections
+     */
+    closeAllConnections(reason) {
+        const connections = this.connectionManager.getActiveConnections();
+        for (const connection of connections) {
+            this.connectionManager.closeConnection(connection.id, reason);
+        }
+    }
+    /**
+     * Dispose of the transport
+     */
+    dispose() {
+        if (this.disposed) {
+            return;
+        }
+        this.disposed = true;
+        this.connectionManager.dispose();
+    }
+    // ============================================================================
+    // Private Methods
+    // ============================================================================
+    async parseRequestBody(req) {
+        // If body is already parsed (e.g., by express.json())
+        if (req.body) {
+            return req.body;
+        }
+        if (!this.config.parseBody) {
+            throw new Error('Request body parsing is disabled');
+        }
+        return new Promise((resolve, reject) => {
+            const chunks = [];
+            let size = 0;
+            req.on('data', (chunk) => {
+                size += chunk.length;
+                if (size > this.config.maxBodySize) {
+                    reject(new Error(`Request body exceeds maximum size of ${this.config.maxBodySize} bytes`));
+                    return;
+                }
+                chunks.push(chunk);
+            });
+            req.on('end', () => {
+                try {
+                    const body = Buffer.concat(chunks).toString('utf-8');
+                    if (!body) {
+                        reject(new Error('Empty request body'));
+                        return;
+                    }
+                    const parsed = JSON.parse(body);
+                    resolve(parsed);
+                }
+                catch (error) {
+                    reject(new Error('Invalid JSON in request body'));
+                }
+            });
+            req.on('error', (error) => {
+                reject(error);
+            });
+        });
+    }
+    setSSEHeaders(res) {
+        res.setHeader('Content-Type', 'text/event-stream');
+        res.setHeader('Cache-Control', 'no-cache');
+        res.setHeader('Connection', 'keep-alive');
+        res.setHeader('X-Accel-Buffering', 'no'); // Disable nginx buffering
+        // Add custom headers
+        for (const [key, value] of Object.entries(this.config.customHeaders)) {
+            res.setHeader(key, value);
+        }
+        // Flush headers immediately
+        res.flushHeaders();
+    }
+    writeEvent(connection, event) {
+        if (connection.state !== 'open' || connection.response.writableEnded) {
+            return;
+        }
+        try {
+            const data = this.formatSSEEvent(event);
+            connection.response.write(data);
+            this.connectionManager.recordEventSent(connection.id, Buffer.byteLength(data, 'utf-8'));
+            // Flush if available (Express-style flush for compression middleware)
+            const res = connection.response;
+            if (res.flush && typeof res.flush === 'function') {
+                res.flush();
+            }
+        }
+        catch {
+            this.connectionManager.recordError(connection.id);
+        }
+    }
+    writeEvents(connection, events) {
+        if (connection.state !== 'open' || connection.response.writableEnded) {
+            return;
+        }
+        try {
+            let totalBytes = 0;
+            const chunks = [];
+            for (const event of events) {
+                const data = this.formatSSEEvent(event);
+                chunks.push(data);
+                totalBytes += Buffer.byteLength(data, 'utf-8');
+            }
+            const combined = chunks.join('');
+            connection.response.write(combined);
+            this.connectionManager.recordEventSent(connection.id, totalBytes);
+            // Flush if available (Express-style flush for compression middleware)
+            const res = connection.response;
+            if (res.flush && typeof res.flush === 'function') {
+                res.flush();
+            }
+        }
+        catch {
+            this.connectionManager.recordError(connection.id);
+        }
+    }
+    formatSSEEvent(event) {
+        const eventType = event.type;
+        const data = JSON.stringify(event);
+        return `event: ${eventType}\ndata: ${data}\n\n`;
+    }
+    sendError(res, statusCode, statusMessage, errorMessage) {
+        if (res.headersSent) {
+            return;
+        }
+        res.statusCode = statusCode;
+        res.statusMessage = statusMessage;
+        res.setHeader('Content-Type', 'application/json');
+        res.end(JSON.stringify({ error: errorMessage }));
+    }
+}
+// ============================================================================
+// Factory Function
+// ============================================================================
+export function createSSETransport(config) {
+    return new SSETransport(config);
+}
+/**
+ * Create Express middleware for SSE transport
+ */
+export function createSSEMiddleware(agentHandler, options = {}) {
+    const { path = '/agent/stream', ...config } = options;
+    const transport = createSSETransport(config);
+    transport.setAgentHandler(agentHandler);
+    return (req, res, next) => {
+        // Check if this request matches our path
+        const url = req.url || '';
+        const requestPath = url.split('?')[0];
+        if (requestPath !== path) {
+            next();
+            return;
+        }
+        // Handle SSE request
+        transport.handleRequest(req, res).catch(() => {
+            // Error already handled
+        });
+    };
+}
+//# sourceMappingURL=sse-transport.js.map

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

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

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

@@ -0,0 +1,237 @@
+/**
+ * Agentic QE v3 - SSE Transport Types
+ * Type definitions for AG-UI SSE transport layer
+ */
+import type { IncomingMessage, ServerResponse } from 'http';
+/**
+ * AG-UI event type enumeration
+ */
+export declare const AGUIEventType: {
+    readonly RUN_STARTED: "RUN_STARTED";
+    readonly RUN_FINISHED: "RUN_FINISHED";
+    readonly RUN_ERROR: "RUN_ERROR";
+    readonly STEP_STARTED: "STEP_STARTED";
+    readonly STEP_FINISHED: "STEP_FINISHED";
+    readonly TEXT_MESSAGE_START: "TEXT_MESSAGE_START";
+    readonly TEXT_MESSAGE_CONTENT: "TEXT_MESSAGE_CONTENT";
+    readonly TEXT_MESSAGE_END: "TEXT_MESSAGE_END";
+    readonly TOOL_CALL_START: "TOOL_CALL_START";
+    readonly TOOL_CALL_ARGS: "TOOL_CALL_ARGS";
+    readonly TOOL_CALL_END: "TOOL_CALL_END";
+    readonly TOOL_CALL_RESULT: "TOOL_CALL_RESULT";
+    readonly STATE_SNAPSHOT: "STATE_SNAPSHOT";
+    readonly STATE_DELTA: "STATE_DELTA";
+    readonly MESSAGES_SNAPSHOT: "MESSAGES_SNAPSHOT";
+    readonly ACTIVITY_SNAPSHOT: "ACTIVITY_SNAPSHOT";
+    readonly ACTIVITY_DELTA: "ACTIVITY_DELTA";
+    readonly RAW: "RAW";
+    readonly CUSTOM: "CUSTOM";
+};
+export type AGUIEventTypeValue = (typeof AGUIEventType)[keyof typeof AGUIEventType];
+export interface BaseAGUIEvent {
+    type: AGUIEventTypeValue;
+    timestamp?: number;
+}
+export interface RunStartedEvent extends BaseAGUIEvent {
+    type: typeof AGUIEventType.RUN_STARTED;
+    threadId: string;
+    runId: string;
+}
+export interface RunFinishedEvent extends BaseAGUIEvent {
+    type: typeof AGUIEventType.RUN_FINISHED;
+    runId: string;
+    outcome: 'success' | 'interrupt';
+    interrupt?: {
+        id: string;
+        reason: string;
+        payload?: unknown;
+    };
+}
+export interface RunErrorEvent extends BaseAGUIEvent {
+    type: typeof AGUIEventType.RUN_ERROR;
+    runId: string;
+    message: string;
+    code: string;
+}
+export interface StepStartedEvent extends BaseAGUIEvent {
+    type: typeof AGUIEventType.STEP_STARTED;
+    stepId: string;
+    name: string;
+    runId?: string;
+}
+export interface StepFinishedEvent extends BaseAGUIEvent {
+    type: typeof AGUIEventType.STEP_FINISHED;
+    stepId: string;
+    result?: unknown;
+}
+export interface TextMessageStartEvent extends BaseAGUIEvent {
+    type: typeof AGUIEventType.TEXT_MESSAGE_START;
+    messageId: string;
+    role: 'assistant' | 'system';
+}
+export interface TextMessageContentEvent extends BaseAGUIEvent {
+    type: typeof AGUIEventType.TEXT_MESSAGE_CONTENT;
+    messageId: string;
+    delta: string;
+}
+export interface TextMessageEndEvent extends BaseAGUIEvent {
+    type: typeof AGUIEventType.TEXT_MESSAGE_END;
+    messageId: string;
+}
+export interface ToolCallStartEvent extends BaseAGUIEvent {
+    type: typeof AGUIEventType.TOOL_CALL_START;
+    toolCallId: string;
+    toolCallName: string;
+    parentMessageId?: string;
+}
+export interface ToolCallArgsEvent extends BaseAGUIEvent {
+    type: typeof AGUIEventType.TOOL_CALL_ARGS;
+    toolCallId: string;
+    delta: string;
+}
+export interface ToolCallEndEvent extends BaseAGUIEvent {
+    type: typeof AGUIEventType.TOOL_CALL_END;
+    toolCallId: string;
+}
+export interface ToolCallResultEvent extends BaseAGUIEvent {
+    type: typeof AGUIEventType.TOOL_CALL_RESULT;
+    toolCallId: string;
+    content: string;
+    messageId: string;
+}
+export interface StateSnapshotEvent extends BaseAGUIEvent {
+    type: typeof AGUIEventType.STATE_SNAPSHOT;
+    state: Record<string, unknown>;
+}
+export interface StateDeltaEvent extends BaseAGUIEvent {
+    type: typeof AGUIEventType.STATE_DELTA;
+    delta: JsonPatchOperation[];
+}
+export interface MessagesSnapshotEvent extends BaseAGUIEvent {
+    type: typeof AGUIEventType.MESSAGES_SNAPSHOT;
+    messages: Message[];
+}
+export interface CustomEvent extends BaseAGUIEvent {
+    type: typeof AGUIEventType.CUSTOM;
+    name: string;
+    value: unknown;
+}
+export type AGUIEvent = RunStartedEvent | RunFinishedEvent | RunErrorEvent | StepStartedEvent | StepFinishedEvent | TextMessageStartEvent | TextMessageContentEvent | TextMessageEndEvent | ToolCallStartEvent | ToolCallArgsEvent | ToolCallEndEvent | ToolCallResultEvent | StateSnapshotEvent | StateDeltaEvent | MessagesSnapshotEvent | CustomEvent;
+export interface JsonPatchOperation {
+    op: 'add' | 'replace' | 'remove' | 'move' | 'copy' | 'test';
+    path: string;
+    value?: unknown;
+    from?: string;
+}
+export interface Message {
+    id?: string;
+    role: 'user' | 'assistant' | 'system';
+    content: string;
+}
+export interface SSETransportConfig {
+    /**
+     * Keep-alive interval in milliseconds (default: 15000)
+     */
+    keepAliveInterval?: number;
+    /**
+     * Maximum buffer size before backpressure (default: 100 events)
+     */
+    maxBufferSize?: number;
+    /**
+     * Flush interval for batching events (default: 50ms for 60fps)
+     */
+    flushInterval?: number;
+    /**
+     * Enable request body parsing (default: true)
+     */
+    parseBody?: boolean;
+    /**
+     * Maximum request body size in bytes (default: 1MB)
+     */
+    maxBodySize?: number;
+    /**
+     * Connection timeout in milliseconds (default: 300000 = 5 minutes)
+     */
+    connectionTimeout?: number;
+    /**
+     * Custom headers to include in SSE response
+     */
+    customHeaders?: Record<string, string>;
+}
+export interface AgentRequest {
+    /**
+     * Thread ID for conversation context
+     */
+    threadId: string;
+    /**
+     * Run ID for this specific agent run
+     */
+    runId?: string;
+    /**
+     * Messages in the conversation
+     */
+    messages?: Message[];
+    /**
+     * Tools available for the agent
+     */
+    tools?: AgentTool[];
+    /**
+     * Agent state to sync
+     */
+    state?: Record<string, unknown>;
+    /**
+     * Resume configuration for interrupted runs
+     */
+    resume?: {
+        interruptId: string;
+        payload: unknown;
+    };
+}
+export interface AgentTool {
+    name: string;
+    description: string;
+    parameters?: {
+        type: string;
+        properties?: Record<string, unknown>;
+        required?: string[];
+    };
+}
+export type AgentHandler = (request: AgentRequest, emit: EventEmitter, signal: AbortSignal) => Promise<void>;
+export type EventEmitter = (event: AGUIEvent) => void;
+export interface SSEConnection {
+    id: string;
+    threadId: string;
+    runId: string;
+    createdAt: number;
+    lastActivity: number;
+    response: ServerResponse;
+    abortController: AbortController;
+    state: ConnectionState;
+    metrics: ConnectionMetrics;
+}
+export type ConnectionState = 'connecting' | 'open' | 'closing' | 'closed';
+export interface ConnectionMetrics {
+    eventsSent: number;
+    bytesSent: number;
+    keepAlivesSent: number;
+    errors: number;
+    startTime: number;
+    endTime?: number;
+}
+export interface SSETransportMetrics {
+    totalConnections: number;
+    activeConnections: number;
+    totalEventsSent: number;
+    totalBytesSent: number;
+    totalErrors: number;
+    averageConnectionDuration: number;
+}
+export interface SSERequest extends IncomingMessage {
+    body?: AgentRequest;
+    params?: Record<string, string>;
+    query?: Record<string, string>;
+}
+export interface SSEResponse extends ServerResponse {
+    flush?: () => void;
+}
+//# sourceMappingURL=types.d.ts.map

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

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

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

@@ -0,0 +1,37 @@
+/**
+ * Agentic QE v3 - SSE Transport Types
+ * Type definitions for AG-UI SSE transport layer
+ */
+// ============================================================================
+// AG-UI Event Types (from AG-UI Protocol 1.0)
+// ============================================================================
+/**
+ * AG-UI event type enumeration
+ */
+export const AGUIEventType = {
+    // Lifecycle events
+    RUN_STARTED: 'RUN_STARTED',
+    RUN_FINISHED: 'RUN_FINISHED',
+    RUN_ERROR: 'RUN_ERROR',
+    STEP_STARTED: 'STEP_STARTED',
+    STEP_FINISHED: 'STEP_FINISHED',
+    // Text message events
+    TEXT_MESSAGE_START: 'TEXT_MESSAGE_START',
+    TEXT_MESSAGE_CONTENT: 'TEXT_MESSAGE_CONTENT',
+    TEXT_MESSAGE_END: 'TEXT_MESSAGE_END',
+    // Tool call events
+    TOOL_CALL_START: 'TOOL_CALL_START',
+    TOOL_CALL_ARGS: 'TOOL_CALL_ARGS',
+    TOOL_CALL_END: 'TOOL_CALL_END',
+    TOOL_CALL_RESULT: 'TOOL_CALL_RESULT',
+    // State events
+    STATE_SNAPSHOT: 'STATE_SNAPSHOT',
+    STATE_DELTA: 'STATE_DELTA',
+    MESSAGES_SNAPSHOT: 'MESSAGES_SNAPSHOT',
+    ACTIVITY_SNAPSHOT: 'ACTIVITY_SNAPSHOT',
+    ACTIVITY_DELTA: 'ACTIVITY_DELTA',
+    // Special events
+    RAW: 'RAW',
+    CUSTOM: 'CUSTOM',
+};
+//# sourceMappingURL=types.js.map