agentic-qe 1.8.4 → 1.9.0

package/dist/visualization/api/WebSocketServer.js

@@ -0,0 +1,518 @@
+"use strict";
+/**
+ * @fileoverview WebSocket server for real-time event streaming
+ * @module visualization/api/WebSocketServer
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WebSocketServer = void 0;
+const events_1 = require("events");
+const DataTransformer_1 = require("../core/DataTransformer");
+const http = __importStar(require("http"));
+const ws_1 = require("ws");
+/**
+ * WebSocket server for real-time visualization event streaming
+ *
+ * Features:
+ * - Real-time event streaming with <500ms latency
+ * - Client subscription management with filtering
+ * - Backpressure handling for high-throughput scenarios
+ * - Automatic heartbeat and connection management
+ * - Message types: event, reasoning, metrics, heartbeat
+ *
+ * @example
+ * ```typescript
+ * const wsServer = new WebSocketServer(eventStore, reasoningStore, {
+ *   port: 8080,
+ *   heartbeatInterval: 30000,
+ *   maxBacklogSize: 1000
+ * });
+ *
+ * await wsServer.start();
+ *
+ * // Broadcast event to subscribed clients
+ * wsServer.broadcastEvent({
+ *   type: 'event',
+ *   timestamp: new Date().toISOString(),
+ *   data: { agent_id: 'test-gen', event_type: 'test_generated' }
+ * });
+ * ```
+ */
+class WebSocketServer extends events_1.EventEmitter {
+    constructor(eventStore, reasoningStore, config = {}) {
+        super();
+        this.eventStore = eventStore;
+        this.reasoningStore = reasoningStore;
+        this.transformer = new DataTransformer_1.DataTransformer(eventStore, reasoningStore);
+        this.config = { ...WebSocketServer.DEFAULT_CONFIG, ...config };
+        this.clients = new Map();
+        this.messageQueue = new Map();
+        this.isRunning = false;
+    }
+    /**
+     * Start the WebSocket server
+     */
+    async start() {
+        if (this.isRunning) {
+            throw new Error('WebSocket server is already running');
+        }
+        return new Promise((resolve, reject) => {
+            try {
+                // Create HTTP server if not provided
+                this.httpServer = this.config.server || http.createServer();
+                // Create WebSocket server
+                this.wss = new ws_1.WebSocketServer({
+                    server: this.httpServer,
+                    perMessageDeflate: this.config.compression,
+                });
+                // Handle WebSocket connections
+                this.wss.on('connection', (socket, req) => {
+                    this.handleConnection(socket, req);
+                });
+                // Handle WebSocket server errors
+                this.wss.on('error', (error) => {
+                    this.emit('error', { error: error.message, source: 'wss' });
+                });
+                // Start HTTP server if we created it
+                if (!this.config.server) {
+                    this.httpServer.listen(this.config.port, () => {
+                        console.log(`WebSocket server listening on port ${this.config.port}`);
+                        this.startHeartbeat();
+                        this.isRunning = true;
+                        this.emit('started', { port: this.config.port });
+                        resolve();
+                    });
+                    this.httpServer.on('error', (error) => {
+                        this.emit('error', { error: error.message, source: 'http' });
+                        reject(error);
+                    });
+                }
+                else {
+                    // Server already listening, just start heartbeat
+                    this.startHeartbeat();
+                    this.isRunning = true;
+                    this.emit('started', { port: this.config.port });
+                    resolve();
+                }
+            }
+            catch (error) {
+                reject(error);
+            }
+        });
+    }
+    /**
+     * Stop the WebSocket server
+     */
+    async stop() {
+        if (!this.isRunning) {
+            return;
+        }
+        this.stopHeartbeat();
+        // Close all client connections
+        for (const client of this.clients.values()) {
+            this.disconnectClient(client.id, 'Server shutting down');
+        }
+        // Close WebSocket server
+        return new Promise((resolve) => {
+            if (this.wss) {
+                this.wss.close(() => {
+                    // Close HTTP server if we created it
+                    if (this.httpServer && !this.config.server) {
+                        this.httpServer.close(() => {
+                            this.isRunning = false;
+                            this.emit('stopped');
+                            resolve();
+                        });
+                    }
+                    else {
+                        this.isRunning = false;
+                        this.emit('stopped');
+                        resolve();
+                    }
+                });
+            }
+            else {
+                this.isRunning = false;
+                this.emit('stopped');
+                resolve();
+            }
+        });
+    }
+    /**
+     * Handle new WebSocket connection
+     */
+    handleConnection(socket, request) {
+        const clientId = this.generateClientId();
+        const client = {
+            id: clientId,
+            socket,
+            subscriptions: this.parseSubscriptionOptions(request.url),
+            lastHeartbeat: Date.now(),
+        };
+        this.clients.set(clientId, client);
+        this.messageQueue.set(clientId, []);
+        // Setup WebSocket event handlers
+        socket.on('message', (data) => {
+            try {
+                this.handleMessage(clientId, data);
+            }
+            catch (error) {
+                this.emit('error', { clientId, error, source: 'message_handler' });
+            }
+        });
+        socket.on('close', () => {
+            this.handleDisconnect(clientId);
+        });
+        socket.on('error', (error) => {
+            this.handleError(clientId, error);
+        });
+        socket.on('pong', () => {
+            this.handlePong(clientId);
+        });
+        this.emit('client_connected', { clientId, subscriptions: client.subscriptions });
+        // Send initial data based on subscriptions
+        this.sendInitialData(client);
+    }
+    /**
+     * Send initial data to newly connected client
+     */
+    sendInitialData(client) {
+        const { session_id, agent_id, since } = client.subscriptions;
+        // Send recent events
+        if (session_id) {
+            const events = this.eventStore.getEventsBySession(session_id);
+            const filteredEvents = since
+                ? events.filter(e => e.timestamp >= since)
+                : events.slice(-50); // Last 50 events
+            for (const event of filteredEvents) {
+                this.sendMessage(client.id, {
+                    type: 'event',
+                    timestamp: event.timestamp,
+                    data: event,
+                });
+            }
+        }
+        // Send reasoning chains
+        if (session_id) {
+            const chains = this.reasoningStore.getChainsBySession(session_id, { limit: 10 });
+            for (const chain of chains) {
+                const tree = this.transformer.buildReasoningTree(chain.id);
+                if (tree) {
+                    this.sendMessage(client.id, {
+                        type: 'reasoning',
+                        timestamp: chain.created_at,
+                        data: tree,
+                    });
+                }
+            }
+        }
+    }
+    /**
+     * Handle incoming message from client
+     */
+    handleMessage(clientId, data) {
+        try {
+            const message = JSON.parse(data.toString());
+            if (message.type === 'subscribe') {
+                this.updateSubscription(clientId, message.options);
+            }
+            else if (message.type === 'unsubscribe') {
+                this.removeSubscription(clientId);
+            }
+            else if (message.type === 'ping') {
+                this.sendMessage(clientId, {
+                    type: 'heartbeat',
+                    timestamp: new Date().toISOString(),
+                    data: { status: 'pong' },
+                });
+            }
+        }
+        catch (error) {
+            this.emit('error', { clientId, error });
+        }
+    }
+    /**
+     * Handle client disconnection
+     */
+    handleDisconnect(clientId) {
+        this.disconnectClient(clientId, 'Client disconnected');
+    }
+    /**
+     * Handle client error
+     */
+    handleError(clientId, error) {
+        this.emit('error', { clientId, error });
+        this.disconnectClient(clientId, `Error: ${error.message}`);
+    }
+    /**
+     * Handle pong response (heartbeat)
+     */
+    handlePong(clientId) {
+        const client = this.clients.get(clientId);
+        if (client) {
+            client.lastHeartbeat = Date.now();
+        }
+    }
+    /**
+     * Disconnect a client
+     */
+    disconnectClient(clientId, reason) {
+        const client = this.clients.get(clientId);
+        if (!client)
+            return;
+        try {
+            // Close the WebSocket connection
+            if (client.socket.readyState === ws_1.WebSocket.OPEN || client.socket.readyState === ws_1.WebSocket.CONNECTING) {
+                client.socket.close(1000, reason);
+            }
+        }
+        catch (error) {
+            this.emit('error', { clientId, error, source: 'disconnect' });
+        }
+        this.clients.delete(clientId);
+        this.messageQueue.delete(clientId);
+        this.emit('client_disconnected', { clientId, reason });
+    }
+    /**
+     * Update client subscription
+     */
+    updateSubscription(clientId, options) {
+        const client = this.clients.get(clientId);
+        if (!client)
+            return;
+        client.subscriptions = { ...client.subscriptions, ...options };
+        this.emit('subscription_updated', { clientId, subscriptions: client.subscriptions });
+    }
+    /**
+     * Remove client subscription
+     */
+    removeSubscription(clientId) {
+        const client = this.clients.get(clientId);
+        if (!client)
+            return;
+        client.subscriptions = {};
+        this.emit('subscription_removed', { clientId });
+    }
+    /**
+     * Broadcast event to all subscribed clients
+     * @param message - Event message to broadcast
+     */
+    broadcastEvent(message) {
+        const startTime = Date.now();
+        for (const client of this.clients.values()) {
+            if (this.shouldSendToClient(client, message)) {
+                this.sendMessage(client.id, message);
+            }
+        }
+        const latency = Date.now() - startTime;
+        this.emit('broadcast_complete', { latency, clientCount: this.clients.size });
+        // Emit warning if latency exceeds 500ms threshold
+        if (latency > 500) {
+            this.emit('latency_warning', { latency, threshold: 500 });
+        }
+    }
+    /**
+     * Send message to specific client with backpressure handling
+     */
+    sendMessage(clientId, message) {
+        const client = this.clients.get(clientId);
+        if (!client)
+            return;
+        const queue = this.messageQueue.get(clientId);
+        // Check backlog size
+        if (queue.length >= this.config.maxBacklogSize) {
+            // Drop oldest message (FIFO)
+            queue.shift();
+            this.emit('backpressure', { clientId, queueSize: queue.length });
+        }
+        queue.push(message);
+        // Attempt to flush queue
+        this.flushMessageQueue(clientId);
+    }
+    /**
+     * Flush message queue for a client
+     */
+    flushMessageQueue(clientId) {
+        const client = this.clients.get(clientId);
+        const queue = this.messageQueue.get(clientId);
+        if (!client || !queue)
+            return;
+        while (queue.length > 0) {
+            const message = queue[0];
+            // Check if socket is open
+            if (client.socket.readyState !== ws_1.WebSocket.OPEN) {
+                break;
+            }
+            // Check for backpressure (buffered data)
+            if (client.socket.bufferedAmount > 0) {
+                // Socket buffer is full, wait for next flush
+                break;
+            }
+            // Send message
+            try {
+                client.socket.send(JSON.stringify(message));
+                queue.shift();
+            }
+            catch (error) {
+                this.emit('send_error', { clientId, error });
+                break;
+            }
+        }
+    }
+    /**
+     * Check if message should be sent to client based on subscriptions
+     */
+    shouldSendToClient(client, message) {
+        const { session_id, agent_id, event_types, since } = client.subscriptions;
+        // Check timestamp filter
+        if (since && message.timestamp < since) {
+            return false;
+        }
+        // Check event-specific filters
+        if (message.type === 'event') {
+            const eventData = message.data;
+            if (session_id && eventData.session_id !== session_id) {
+                return false;
+            }
+            if (agent_id && eventData.agent_id !== agent_id) {
+                return false;
+            }
+            if (event_types && eventData.event_type && !event_types.includes(eventData.event_type)) {
+                return false;
+            }
+        }
+        return true;
+    }
+    /**
+     * Start heartbeat timer
+     */
+    startHeartbeat() {
+        this.heartbeatTimer = setInterval(() => {
+            const now = Date.now();
+            for (const client of this.clients.values()) {
+                // Check for timeout
+                if (now - client.lastHeartbeat > this.config.clientTimeout) {
+                    this.disconnectClient(client.id, 'Heartbeat timeout');
+                    continue;
+                }
+                // Send WebSocket ping frame
+                try {
+                    if (client.socket.readyState === ws_1.WebSocket.OPEN) {
+                        client.socket.ping();
+                    }
+                }
+                catch (error) {
+                    this.emit('error', { clientId: client.id, error, source: 'ping' });
+                }
+                // Send heartbeat message
+                this.sendMessage(client.id, {
+                    type: 'heartbeat',
+                    timestamp: new Date().toISOString(),
+                    data: {
+                        connected_clients: this.clients.size,
+                        uptime_ms: now - (client.lastHeartbeat - this.config.heartbeatInterval),
+                    },
+                });
+            }
+        }, this.config.heartbeatInterval);
+    }
+    /**
+     * Stop heartbeat timer
+     */
+    stopHeartbeat() {
+        if (this.heartbeatTimer) {
+            clearInterval(this.heartbeatTimer);
+            this.heartbeatTimer = undefined;
+        }
+    }
+    /**
+     * Generate unique client ID
+     */
+    generateClientId() {
+        return `client-${Date.now()}-${Math.random().toString(36).substring(2, 9)}`;
+    }
+    /**
+     * Parse subscription options from URL query parameters
+     */
+    parseSubscriptionOptions(url) {
+        if (!url)
+            return {};
+        const urlObj = new URL(url, 'http://localhost');
+        const params = urlObj.searchParams;
+        return {
+            session_id: params.get('session_id') || undefined,
+            agent_id: params.get('agent_id') || undefined,
+            event_types: params.get('event_types')?.split(','),
+            since: params.get('since') || undefined,
+        };
+    }
+    /**
+     * Get server statistics
+     */
+    getStatistics() {
+        let totalQueueSize = 0;
+        for (const queue of this.messageQueue.values()) {
+            totalQueueSize += queue.length;
+        }
+        return {
+            isRunning: this.isRunning,
+            connectedClients: this.clients.size,
+            totalMessagesSent: 0, // Would track in real implementation
+            averageQueueSize: this.clients.size > 0 ? totalQueueSize / this.clients.size : 0,
+        };
+    }
+    /**
+     * Get connected clients
+     */
+    getConnectedClients() {
+        return Array.from(this.clients.values()).map(client => ({
+            id: client.id,
+            subscriptions: client.subscriptions,
+        }));
+    }
+}
+exports.WebSocketServer = WebSocketServer;
+/**
+ * Default configuration
+ */
+WebSocketServer.DEFAULT_CONFIG = {
+    server: undefined,
+    port: 8080,
+    heartbeatInterval: 30000, // 30 seconds
+    clientTimeout: 60000, // 60 seconds
+    maxBacklogSize: 1000,
+    compression: true,
+};
+//# sourceMappingURL=WebSocketServer.js.map

package/dist/visualization/api/WebSocketServer.js.map

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

package/dist/visualization/core/DataTransformer.d.ts

@@ -0,0 +1,89 @@
+/**
+ * @fileoverview Data transformer for converting telemetry data to visualization formats
+ * @module visualization/core/DataTransformer
+ */
+import { EventStore } from '../../persistence/event-store';
+import { ReasoningStore } from '../../persistence/reasoning-store';
+import { VisualizationGraph, ReasoningTree, AgentActivitySummary, SessionVisualization, LayoutOptions, VisualizationFilter } from '../types';
+/**
+ * DataTransformer converts raw telemetry data into visualization-friendly structures
+ *
+ * @example
+ * ```typescript
+ * const transformer = new DataTransformer(eventStore, reasoningStore);
+ *
+ * // Build visualization graph for a session
+ * const graph = transformer.buildSessionGraph('session-123', {
+ *   algorithm: 'hierarchical',
+ *   spacing: 100
+ * });
+ *
+ * // Transform reasoning chain to tree
+ * const tree = transformer.buildReasoningTree('chain-456');
+ * ```
+ */
+export declare class DataTransformer {
+    private eventStore;
+    private reasoningStore;
+    constructor(eventStore: EventStore, reasoningStore: ReasoningStore);
+    /**
+     * Build a visualization graph from events in a session
+     * @param sessionId - Session identifier
+     * @param layoutOptions - Graph layout configuration
+     * @param filter - Optional filters
+     * @returns Complete visualization graph with positioned nodes
+     */
+    buildSessionGraph(sessionId: string, layoutOptions: LayoutOptions, filter?: VisualizationFilter): VisualizationGraph;
+    /**
+     * Build a reasoning tree from a reasoning chain
+     * @param chainId - Chain identifier
+     * @returns Hierarchical tree structure
+     */
+    buildReasoningTree(chainId: string): ReasoningTree | null;
+    /**
+     * Generate agent activity summaries for a session
+     * @param sessionId - Session identifier
+     * @returns Array of agent summaries
+     */
+    generateAgentSummaries(sessionId: string): AgentActivitySummary[];
+    /**
+     * Build complete session visualization
+     * @param sessionId - Session identifier
+     * @returns Complete session visualization data
+     */
+    buildSessionVisualization(sessionId: string): SessionVisualization;
+    /**
+     * Build time-series metrics from events
+     * @param events - Array of events
+     * @returns Aggregated time-series data
+     */
+    private buildEventsTimeline;
+    /**
+     * Apply layout algorithm to position nodes
+     * @param nodes - Graph nodes
+     * @param edges - Graph edges
+     * @param options - Layout options
+     */
+    private applyLayout;
+    /**
+     * Apply hierarchical layout (top-down or left-right)
+     */
+    private applyHierarchicalLayout;
+    /**
+     * Apply force-directed layout (simplified spring model)
+     */
+    private applyForceDirectedLayout;
+    /**
+     * Apply circular layout
+     */
+    private applyCircularLayout;
+    /**
+     * Apply grid layout
+     */
+    private applyGridLayout;
+    /**
+     * Apply filter to events
+     */
+    private applyEventFilter;
+}
+//# sourceMappingURL=DataTransformer.d.ts.map

package/dist/visualization/core/DataTransformer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DataTransformer.d.ts","sourceRoot":"","sources":["../../../src/visualization/core/DataTransformer.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,UAAU,EAAgC,MAAM,+BAA+B,CAAC;AACzF,OAAO,EAAE,cAAc,EAAqB,MAAM,mCAAmC,CAAC;AAEtF,OAAO,EACL,kBAAkB,EAGlB,aAAa,EAEb,oBAAoB,EACpB,oBAAoB,EAEpB,aAAa,EACb,mBAAmB,EACpB,MAAM,UAAU,CAAC;AASlB;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,eAAe;IAExB,OAAO,CAAC,UAAU;IAClB,OAAO,CAAC,cAAc;gBADd,UAAU,EAAE,UAAU,EACtB,cAAc,EAAE,cAAc;IAGxC;;;;;;OAMG;IACH,iBAAiB,CACf,SAAS,EAAE,MAAM,EACjB,aAAa,EAAE,aAAa,EAC5B,MAAM,CAAC,EAAE,mBAAmB,GAC3B,kBAAkB;IAoHrB;;;;OAIG;IACH,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI;IA+BzD;;;;OAIG;IACH,sBAAsB,CAAC,SAAS,EAAE,MAAM,GAAG,oBAAoB,EAAE;IA4CjE;;;;OAIG;IACH,yBAAyB,CAAC,SAAS,EAAE,MAAM,GAAG,oBAAoB;IA+ClE;;;;OAIG;IACH,OAAO,CAAC,mBAAmB;IAiB3B;;;;;OAKG;IACH,OAAO,CAAC,WAAW;IAqBnB;;OAEG;IACH,OAAO,CAAC,uBAAuB;IAgE/B;;OAEG;IACH,OAAO,CAAC,wBAAwB;IAqEhC;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAa3B;;OAEG;IACH,OAAO,CAAC,eAAe;IAcvB;;OAEG;IACH,OAAO,CAAC,gBAAgB;CAgBzB"}