@sudocode-ai/local-server 0.1.0 → 0.1.1

package/dist/execution/transport/sse-transport.js

@@ -0,0 +1,282 @@
+/**
+ * Server-Sent Events (SSE) Transport Layer
+ *
+ * Provides real-time streaming of AG-UI events to frontend clients using SSE.
+ * Supports connection management, heartbeat, and run-specific event filtering.
+ *
+ * @module execution/transport/sse-transport
+ */
+/**
+ * SseTransport - Server-Sent Events transport for AG-UI events
+ *
+ * Manages SSE connections and streams AG-UI protocol events to connected clients.
+ * Supports multiple concurrent connections, heartbeat mechanism, and run-specific filtering.
+ *
+ * @example
+ * ```typescript
+ * const transport = new SseTransport();
+ *
+ * // Handle new connection
+ * app.get('/api/events', (req, res) => {
+ *   const clientId = req.query.clientId as string;
+ *   const runId = req.query.runId as string | undefined;
+ *   transport.handleConnection(clientId, res, runId);
+ * });
+ *
+ * // Send event to specific client
+ * transport.sendToClient('client-123', {
+ *   event: 'TOOL_CALL_START',
+ *   data: { type: 'TOOL_CALL_START', toolCallId: 'tool-1' }
+ * });
+ *
+ * // Broadcast to all clients watching a specific run
+ * transport.broadcastToRun('run-123', {
+ *   event: 'RUN_FINISHED',
+ *   data: { type: 'RUN_FINISHED', runId: 'run-123' }
+ * });
+ * ```
+ */
+export class SseTransport {
+    clients = new Map();
+    heartbeatInterval = null;
+    HEARTBEAT_INTERVAL_MS = 30000; // 30 seconds
+    /**
+     * Create a new SSE transport instance
+     */
+    constructor() {
+        this.startHeartbeat();
+    }
+    /**
+     * Handle a new SSE connection from a client
+     *
+     * Sets up proper SSE headers, registers the client, and handles cleanup on disconnect.
+     *
+     * @param clientId - Unique identifier for this client
+     * @param res - Express response object
+     * @param runId - Optional run ID to filter events
+     * @param replayEvents - Optional: buffered events to replay to this client
+     */
+    handleConnection(clientId, res, runId, replayEvents) {
+        // Set SSE headers
+        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
+        // Enable CORS for SSE (if needed)
+        res.setHeader("Access-Control-Allow-Origin", "*");
+        // Disable compression for SSE
+        res.flushHeaders();
+        const client = {
+            clientId,
+            response: res,
+            runId,
+            connectedAt: new Date(),
+            lastActivity: new Date(),
+        };
+        this.clients.set(clientId, client);
+        // Send initial connection acknowledgment
+        this.sendToClient(clientId, {
+            event: "connected",
+            data: {
+                clientId,
+                runId,
+                timestamp: Date.now(),
+            },
+        });
+        // Replay buffered events if provided
+        if (replayEvents && replayEvents.length > 0) {
+            for (const event of replayEvents) {
+                this.sendToClient(clientId, event);
+            }
+        }
+        // Handle client disconnect
+        res.on("close", () => {
+            this.removeClient(clientId);
+        });
+    }
+    /**
+     * Send an event to a specific client
+     *
+     * @param clientId - Target client ID
+     * @param event - Event to send
+     * @returns true if sent successfully, false if client not found
+     */
+    sendToClient(clientId, event) {
+        const client = this.clients.get(clientId);
+        if (!client) {
+            return false;
+        }
+        return this.writeEvent(client, event);
+    }
+    /**
+     * Broadcast an event to all connected clients
+     *
+     * @param event - Event to broadcast
+     * @returns Number of clients that received the event
+     */
+    broadcast(event) {
+        let sentCount = 0;
+        for (const client of this.clients.values()) {
+            if (this.writeEvent(client, event)) {
+                sentCount++;
+            }
+        }
+        return sentCount;
+    }
+    /**
+     * Broadcast an event to all clients watching a specific run
+     *
+     * @param runId - Target run ID
+     * @param event - Event to send
+     * @returns Number of clients that received the event
+     */
+    broadcastToRun(runId, event) {
+        let sentCount = 0;
+        let matchingClients = 0;
+        for (const client of this.clients.values()) {
+            if (client.runId === runId) {
+                matchingClients++;
+                if (this.writeEvent(client, event)) {
+                    sentCount++;
+                }
+            }
+        }
+        return sentCount;
+    }
+    /**
+     * Remove a client connection
+     *
+     * @param clientId - Client to remove
+     * @returns true if client was removed, false if not found
+     */
+    removeClient(clientId) {
+        const client = this.clients.get(clientId);
+        if (!client) {
+            return false;
+        }
+        // Try to close the response if it's still open
+        try {
+            if (!client.response.writableEnded) {
+                client.response.end();
+            }
+        }
+        catch (error) {
+            // Connection already closed, ignore
+        }
+        this.clients.delete(clientId);
+        return true;
+    }
+    /**
+     * Get the number of active connections
+     *
+     * @returns Number of connected clients
+     */
+    getClientCount() {
+        return this.clients.size;
+    }
+    /**
+     * Get the number of clients watching a specific run
+     *
+     * @param runId - Run ID to check
+     * @returns Number of clients watching this run
+     */
+    getRunClientCount(runId) {
+        let count = 0;
+        for (const client of this.clients.values()) {
+            if (client.runId === runId) {
+                count++;
+            }
+        }
+        return count;
+    }
+    /**
+     * Get all active client IDs
+     *
+     * @returns Array of client IDs
+     */
+    getClientIds() {
+        return Array.from(this.clients.keys());
+    }
+    /**
+     * Shutdown the transport and close all connections
+     */
+    shutdown() {
+        // Stop heartbeat
+        if (this.heartbeatInterval) {
+            clearInterval(this.heartbeatInterval);
+            this.heartbeatInterval = null;
+        }
+        // Close all client connections
+        for (const clientId of this.clients.keys()) {
+            this.removeClient(clientId);
+        }
+    }
+    /**
+     * Write an event to a client connection
+     *
+     * Formats the event according to SSE specification and writes it to the response.
+     *
+     * @param client - Target client
+     * @param event - Event to write
+     * @returns true if successful, false if write failed
+     */
+    writeEvent(client, event) {
+        try {
+            const { response } = client;
+            // Check if response is still writable
+            if (response.writableEnded || !response.writable) {
+                this.removeClient(client.clientId);
+                return false;
+            }
+            // Format SSE message
+            let message = "";
+            // Add event type if specified
+            if (event.event) {
+                message += `event: ${event.event}\n`;
+            }
+            // Add event ID if specified
+            if (event.id) {
+                message += `id: ${event.id}\n`;
+            }
+            // Add data (JSON stringify if object)
+            const dataString = typeof event.data === "string"
+                ? event.data
+                : JSON.stringify(event.data);
+            // SSE spec requires data to be on separate lines if multiline
+            const dataLines = dataString.split("\n");
+            for (const line of dataLines) {
+                message += `data: ${line}\n`;
+            }
+            // SSE messages end with double newline
+            message += "\n";
+            // Write to response
+            response.write(message);
+            // Update last activity
+            client.lastActivity = new Date();
+            return true;
+        }
+        catch (error) {
+            // Connection error, remove client
+            this.removeClient(client.clientId);
+            return false;
+        }
+    }
+    /**
+     * Start the heartbeat mechanism
+     *
+     * Sends periodic ping events to keep connections alive
+     */
+    startHeartbeat() {
+        this.heartbeatInterval = setInterval(() => {
+            const pingEvent = {
+                event: "ping",
+                data: { timestamp: Date.now() },
+            };
+            // Send ping to all clients
+            for (const client of this.clients.values()) {
+                this.writeEvent(client, pingEvent);
+            }
+        }, this.HEARTBEAT_INTERVAL_MS);
+    }
+}
+//# sourceMappingURL=sse-transport.js.map

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

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

package/dist/execution/transport/transport-manager.js

@@ -0,0 +1,231 @@
+/**
+ * Transport Manager
+ *
+ * Coordinates between AG-UI adapter and SSE transport layer.
+ * Acts as a facade that routes adapter events to appropriate transport methods.
+ *
+ * @module execution/transport/transport-manager
+ */
+import { SseTransport } from "./sse-transport.js";
+import { EventBuffer } from "./event-buffer.js";
+/**
+ * TransportManager - Coordinates AG-UI events with SSE transport
+ *
+ * Manages the connection between AG-UI adapters and SSE transport,
+ * routing events to appropriate broadcast methods based on run filtering.
+ *
+ * @example
+ * ```typescript
+ * const manager = new TransportManager();
+ * const adapter = new AgUiEventAdapter('run-123');
+ *
+ * // Connect adapter to transport
+ * manager.connectAdapter(adapter, 'run-123');
+ *
+ * // Events from adapter are now automatically broadcast via SSE
+ * ```
+ */
+export class TransportManager {
+    sseTransport;
+    eventBuffer;
+    adapterListeners = new Map();
+    pruneInterval = null;
+    /**
+     * Create a new transport manager
+     *
+     * Initializes the SSE transport layer and event buffer
+     */
+    constructor() {
+        this.sseTransport = new SseTransport();
+        this.eventBuffer = new EventBuffer();
+        // Start periodic pruning of stale buffers (every 15 minutes)
+        this.pruneInterval = setInterval(() => {
+            this.eventBuffer.pruneStale();
+        }, 15 * 60 * 1000);
+    }
+    /**
+     * Connect AG-UI adapter to SSE transport
+     *
+     * Subscribes to adapter's event stream and routes events to SSE transport.
+     * If runId is provided, events are broadcast only to clients watching that run.
+     * Otherwise, events are broadcast to all connected clients.
+     *
+     * @param adapter - AG-UI event adapter to connect
+     * @param runId - Optional run ID for filtering events
+     *
+     * @example
+     * ```typescript
+     * const adapter = new AgUiEventAdapter('run-123');
+     * manager.connectAdapter(adapter, 'run-123');
+     * ```
+     */
+    connectAdapter(adapter, runId) {
+        // Create listener function
+        const listener = (event) => {
+            // Buffer the event if runId is provided
+            if (runId) {
+                this.eventBuffer.addEvent(runId, event);
+                this.broadcastToRun(runId, event);
+            }
+            else {
+                this.broadcast(event);
+            }
+        };
+        // Store listener for cleanup
+        this.adapterListeners.set(adapter, listener);
+        // Subscribe to adapter events
+        adapter.onEvent(listener);
+    }
+    /**
+     * Disconnect AG-UI adapter from transport
+     *
+     * Removes the adapter's event listener and stops broadcasting its events.
+     *
+     * @param adapter - AG-UI event adapter to disconnect
+     * @returns true if adapter was disconnected, false if not found
+     */
+    disconnectAdapter(adapter) {
+        const listener = this.adapterListeners.get(adapter);
+        if (!listener) {
+            return false;
+        }
+        adapter.offEvent(listener);
+        this.adapterListeners.delete(adapter);
+        return true;
+    }
+    /**
+     * Broadcast event to all connected clients
+     *
+     * @param event - AG-UI event to broadcast
+     * @returns Number of clients that received the event
+     *
+     * @example
+     * ```typescript
+     * manager.broadcast({
+     *   type: EventType.RUN_STARTED,
+     *   runId: 'run-123',
+     *   threadId: 'run-123',
+     *   timestamp: Date.now()
+     * });
+     * ```
+     */
+    broadcast(event) {
+        return this.sseTransport.broadcast({
+            event: event.type,
+            data: event,
+        });
+    }
+    /**
+     * Broadcast event to clients watching a specific run
+     *
+     * @param runId - Target run ID
+     * @param event - AG-UI event to broadcast
+     * @returns Number of clients that received the event
+     *
+     * @example
+     * ```typescript
+     * manager.broadcastToRun('run-123', {
+     *   type: EventType.TOOL_CALL_START,
+     *   toolCallId: 'tool-1',
+     *   toolCallName: 'Read',
+     *   timestamp: Date.now()
+     * });
+     * ```
+     */
+    broadcastToRun(runId, event) {
+        const clientCount = this.sseTransport.broadcastToRun(runId, {
+            event: event.type,
+            data: event,
+        });
+        return clientCount;
+    }
+    /**
+     * Get underlying SSE transport
+     *
+     * Provides access to the SSE transport for route handlers
+     * that need to manage client connections.
+     *
+     * @returns SSE transport instance
+     *
+     * @example
+     * ```typescript
+     * const transport = manager.getSseTransport();
+     *
+     * // Handle SSE connection in route
+     * app.get('/api/events', (req, res) => {
+     *   transport.handleConnection(clientId, res, runId);
+     * });
+     * ```
+     */
+    getSseTransport() {
+        return this.sseTransport;
+    }
+    /**
+     * Get number of connected adapters
+     *
+     * @returns Number of active adapter connections
+     */
+    getAdapterCount() {
+        return this.adapterListeners.size;
+    }
+    /**
+     * Get buffered events for an execution
+     *
+     * Returns all events that have been buffered for the specified execution.
+     * Useful for replaying events to late-joining clients.
+     *
+     * @param runId - Target run ID
+     * @param fromSequence - Optional: only return events >= this sequence number
+     * @returns Array of buffered events
+     *
+     * @example
+     * ```typescript
+     * const events = manager.getBufferedEvents('run-123');
+     * for (const buffered of events) {
+     *   console.log(buffered.event.type, buffered.sequenceNumber);
+     * }
+     * ```
+     */
+    getBufferedEvents(runId, fromSequence) {
+        return this.eventBuffer.getEvents(runId, fromSequence);
+    }
+    /**
+     * Check if events are buffered for an execution
+     *
+     * @param runId - Target run ID
+     * @returns true if events are buffered
+     */
+    hasBufferedEvents(runId) {
+        return this.eventBuffer.hasBuffer(runId);
+    }
+    /**
+     * Get buffer statistics
+     *
+     * @returns Buffer statistics
+     */
+    getBufferStats() {
+        return this.eventBuffer.getStats();
+    }
+    /**
+     * Shutdown transport manager
+     *
+     * Disconnects all adapters and shuts down SSE transport.
+     * Closes all client connections and releases resources.
+     */
+    shutdown() {
+        // Stop pruning interval
+        if (this.pruneInterval) {
+            clearInterval(this.pruneInterval);
+            this.pruneInterval = null;
+        }
+        // Disconnect all adapters
+        for (const adapter of this.adapterListeners.keys()) {
+            this.disconnectAdapter(adapter);
+        }
+        // Shutdown SSE transport
+        this.sseTransport.shutdown();
+        // Clear event buffers
+        this.eventBuffer.clearAll();
+    }
+}
+//# sourceMappingURL=transport-manager.js.map

package/dist/execution/transport/transport-manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport-manager.js","sourceRoot":"","sources":["../../../src/execution/transport/transport-manager.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAoBH,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAsBhD;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,OAAO,gBAAgB;IACnB,YAAY,CAAe;IAC3B,WAAW,CAAc;IACzB,gBAAgB,GACtB,IAAI,GAAG,EAAE,CAAC;IACJ,aAAa,GAA0B,IAAI,CAAC;IAEpD;;;;OAIG;IACH;QACE,IAAI,CAAC,YAAY,GAAG,IAAI,YAAY,EAAE,CAAC;QACvC,IAAI,CAAC,WAAW,GAAG,IAAI,WAAW,EAAE,CAAC;QAErC,6DAA6D;QAC7D,IAAI,CAAC,aAAa,GAAG,WAAW,CAC9B,GAAG,EAAE;YACH,IAAI,CAAC,WAAW,CAAC,UAAU,EAAE,CAAC;QAChC,CAAC,EACD,EAAE,GAAG,EAAE,GAAG,IAAI,CACf,CAAC;IACJ,CAAC;IAED;;;;;;;;;;;;;;;OAeG;IACH,cAAc,CAAC,OAAyB,EAAE,KAAc;QACtD,2BAA2B;QAC3B,MAAM,QAAQ,GAAG,CAAC,KAAgB,EAAE,EAAE;YACpC,wCAAwC;YACxC,IAAI,KAAK,EAAE,CAAC;gBACV,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;gBACxC,IAAI,CAAC,cAAc,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;YACpC,CAAC;iBAAM,CAAC;gBACN,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;YACxB,CAAC;QACH,CAAC,CAAC;QAEF,6BAA6B;QAC7B,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;QAE7C,8BAA8B;QAC9B,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IAC5B,CAAC;IAED;;;;;;;OAOG;IACH,iBAAiB,CAAC,OAAyB;QACzC,MAAM,QAAQ,GAAG,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QACpD,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,OAAO,KAAK,CAAC;QACf,CAAC;QAED,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;QAC3B,IAAI,CAAC,gBAAgB,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QACtC,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;;;;;;;;;;;;OAeG;IACH,SAAS,CAAC,KAAgB;QACxB,OAAO,IAAI,CAAC,YAAY,CAAC,SAAS,CAAC;YACjC,KAAK,EAAE,KAAK,CAAC,IAAI;YACjB,IAAI,EAAE,KAAK;SACZ,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;;;;;;;;;;OAgBG;IACH,cAAc,CAAC,KAAa,EAAE,KAAgB;QAC5C,MAAM,WAAW,GAAG,IAAI,CAAC,YAAY,CAAC,cAAc,CAAC,KAAK,EAAE;YAC1D,KAAK,EAAE,KAAK,CAAC,IAAI;YACjB,IAAI,EAAE,KAAK;SACZ,CAAC,CAAC;QACH,OAAO,WAAW,CAAC;IACrB,CAAC;IAED;;;;;;;;;;;;;;;;;OAiBG;IACH,eAAe;QACb,OAAO,IAAI,CAAC,YAAY,CAAC;IAC3B,CAAC;IAED;;;;OAIG;IACH,eAAe;QACb,OAAO,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC;IACpC,CAAC;IAED;;;;;;;;;;;;;;;;;OAiBG;IACH,iBAAiB,CAAC,KAAa,EAAE,YAAqB;QACpD,OAAO,IAAI,CAAC,WAAW,CAAC,SAAS,CAAC,KAAK,EAAE,YAAY,CAAC,CAAC;IACzD,CAAC;IAED;;;;;OAKG;IACH,iBAAiB,CAAC,KAAa;QAC7B,OAAO,IAAI,CAAC,WAAW,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IAC3C,CAAC;IAED;;;;OAIG;IACH,cAAc;QACZ,OAAO,IAAI,CAAC,WAAW,CAAC,QAAQ,EAAE,CAAC;IACrC,CAAC;IAED;;;;;OAKG;IACH,QAAQ;QACN,wBAAwB;QACxB,IAAI,IAAI,CAAC,aAAa,EAAE,CAAC;YACvB,aAAa,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;YAClC,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC;QAC5B,CAAC;QAED,0BAA0B;QAC1B,KAAK,MAAM,OAAO,IAAI,IAAI,CAAC,gBAAgB,CAAC,IAAI,EAAE,EAAE,CAAC;YACnD,IAAI,CAAC,iBAAiB,CAAC,OAAO,CAAC,CAAC;QAClC,CAAC;QAED,yBAAyB;QACzB,IAAI,CAAC,YAAY,CAAC,QAAQ,EAAE,CAAC;QAE7B,sBAAsB;QACtB,IAAI,CAAC,WAAW,CAAC,QAAQ,EAAE,CAAC;IAC9B,CAAC;CACF"}

package/dist/execution/workflow/index.js

@@ -0,0 +1,13 @@
+/**
+ * Workflow Layer Exports
+ *
+ * Layer 4: Task Execution Layer - Workflow Orchestration & State Management
+ *
+ * @module execution/workflow
+ */
+// Utilities
+export { generateId, renderTemplate, extractValue, mergeContext, evaluateCondition, createContext, } from './utils.js';
+// Implementation
+export { LinearOrchestrator } from './linear-orchestrator.js';
+export { InMemoryWorkflowStorage } from './memory-storage.js';
+//# sourceMappingURL=index.js.map

package/dist/execution/workflow/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/execution/workflow/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AA0BH,YAAY;AACZ,OAAO,EACL,UAAU,EACV,cAAc,EACd,YAAY,EACZ,YAAY,EACZ,iBAAiB,EACjB,aAAa,GACd,MAAM,YAAY,CAAC;AAEpB,iBAAiB;AACjB,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAC9D,OAAO,EAAE,uBAAuB,EAAE,MAAM,qBAAqB,CAAC"}