@sudocode-ai/local-server 0.1.0 → 0.1.2

package/dist/execution/output/ag-ui-adapter.js

@@ -0,0 +1,438 @@
+/**
+ * AG-UI Event Adapter
+ *
+ * Transforms SPEC-007 output processing events into AG-UI protocol events.
+ * This adapter subscribes to events from IOutputProcessor and emits standardized
+ * AG-UI events that can be consumed by frontends via SSE or WebSocket transports.
+ *
+ * @module execution/output/ag-ui-adapter
+ */
+import { EventType, } from "@ag-ui/core";
+/**
+ * AgUiEventAdapter - Transforms SPEC-007 events to AG-UI events
+ *
+ * This adapter bridges the gap between the Output Processing Layer (SPEC-007)
+ * and the AG-UI protocol (SPEC-009). It subscribes to output processor events
+ * and emits corresponding AG-UI protocol events.
+ *
+ * @example
+ * ```typescript
+ * const adapter = new AgUiEventAdapter('run-123');
+ * adapter.onEvent((event) => {
+ *   console.log('AG-UI event:', event);
+ *   // Send to SSE transport or WebSocket
+ * });
+ *
+ * const processor = new ClaudeCodeOutputProcessor();
+ * adapter.connectToProcessor(processor);
+ * adapter.emitRunStarted({ model: 'claude-sonnet-4' });
+ * ```
+ */
+export class AgUiEventAdapter {
+    runId;
+    threadId;
+    listeners = new Set();
+    processor = null;
+    currentState = {};
+    activeToolCalls = new Map();
+    messageCounter = 0;
+    /**
+     * Create a new AG-UI event adapter
+     *
+     * @param runId - Unique identifier for this execution run
+     * @param threadId - Thread identifier (defaults to runId if not provided)
+     */
+    constructor(runId, threadId) {
+        this.runId = runId;
+        this.threadId = threadId || runId;
+    }
+    /**
+     * Connect to an output processor and subscribe to its events
+     *
+     * @param processor - The output processor to subscribe to
+     */
+    connectToProcessor(processor) {
+        this.processor = processor;
+        // Subscribe to all SPEC-007 events
+        processor.onToolCall(this.handleToolCall.bind(this));
+        processor.onFileChange(this.handleFileChange.bind(this));
+        processor.onProgress(this.handleProgress.bind(this));
+        processor.onError(this.handleError.bind(this));
+        processor.onMessage(this.handleMessage.bind(this));
+        processor.onUsage(this.handleUsage.bind(this));
+    }
+    /**
+     * Register an event listener
+     *
+     * @param listener - Callback to invoke when AG-UI events are emitted
+     */
+    onEvent(listener) {
+        this.listeners.add(listener);
+    }
+    /**
+     * Remove an event listener
+     *
+     * @param listener - Callback to remove
+     */
+    offEvent(listener) {
+        this.listeners.delete(listener);
+    }
+    /**
+     * Emit RUN_STARTED event
+     *
+     * @param metadata - Optional run metadata (model, config, etc.)
+     */
+    emitRunStarted(metadata) {
+        const event = {
+            type: EventType.RUN_STARTED,
+            threadId: this.threadId,
+            runId: this.runId,
+            timestamp: Date.now(),
+            ...(metadata && { rawEvent: metadata }),
+        };
+        this.emit(event);
+        this.emitStateSnapshot();
+    }
+    /**
+     * Emit RUN_FINISHED event
+     *
+     * @param result - Optional result data
+     */
+    emitRunFinished(result) {
+        const event = {
+            type: EventType.RUN_FINISHED,
+            threadId: this.threadId,
+            runId: this.runId,
+            timestamp: Date.now(),
+            ...(result && { result }),
+        };
+        this.emit(event);
+    }
+    /**
+     * Emit a state snapshot with current execution state
+     */
+    emitStateSnapshot() {
+        const metrics = this.processor?.getMetrics();
+        const event = {
+            type: EventType.STATE_SNAPSHOT,
+            timestamp: Date.now(),
+            snapshot: {
+                ...this.currentState,
+                ...(metrics && {
+                    totalMessages: metrics.totalMessages,
+                    toolCallCount: metrics.toolCalls.length,
+                    fileChangeCount: metrics.fileChanges.length,
+                    errorCount: metrics.errors.length,
+                    usage: {
+                        inputTokens: metrics.usage.inputTokens,
+                        outputTokens: metrics.usage.outputTokens,
+                        totalTokens: metrics.usage.totalTokens,
+                    },
+                }),
+            },
+        };
+        this.emit(event);
+    }
+    /**
+     * Handle tool call events from SPEC-007
+     *
+     * Transforms a single ToolCall into a sequence of AG-UI events:
+     * - TOOL_CALL_START (when tool is invoked)
+     * - TOOL_CALL_ARGS (with input parameters)
+     * - TOOL_CALL_END (when tool completes)
+     * - TOOL_CALL_RESULT (with result/error)
+     */
+    handleToolCall = (toolCall) => {
+        const toolCallId = toolCall.id;
+        const timestamp = Date.now();
+        // Check if this is a new tool call or an update to existing one
+        if (!this.activeToolCalls.has(toolCallId)) {
+            // New tool call - emit START and ARGS
+            const messageId = `msg-${this.messageCounter++}`;
+            this.activeToolCalls.set(toolCallId, {
+                startTime: Date.now(),
+                messageId,
+            });
+            const startEvent = {
+                type: EventType.TOOL_CALL_START,
+                timestamp,
+                toolCallId,
+                toolCallName: toolCall.name,
+            };
+            this.emit(startEvent);
+            const argsEvent = {
+                type: EventType.TOOL_CALL_ARGS,
+                timestamp,
+                toolCallId,
+                delta: JSON.stringify(toolCall.input),
+            };
+            this.emit(argsEvent);
+        }
+        // If tool call is complete (success or error), emit END and RESULT
+        if (toolCall.status === "success" || toolCall.status === "error") {
+            const toolInfo = this.activeToolCalls.get(toolCallId);
+            const duration = toolInfo ? Date.now() - toolInfo.startTime : undefined;
+            const endEvent = {
+                type: EventType.TOOL_CALL_END,
+                timestamp,
+                toolCallId,
+                ...(duration !== undefined && { rawEvent: { duration } }),
+            };
+            this.emit(endEvent);
+            if (toolInfo) {
+                const resultEvent = {
+                    type: EventType.TOOL_CALL_RESULT,
+                    timestamp,
+                    messageId: toolInfo.messageId,
+                    toolCallId,
+                    content: toolCall.status === "success"
+                        ? typeof toolCall.result === "string"
+                            ? toolCall.result
+                            : JSON.stringify(toolCall.result)
+                        : toolCall.error || "Tool call failed",
+                };
+                this.emit(resultEvent);
+            }
+            this.activeToolCalls.delete(toolCallId);
+            // Emit state delta with updated tool call count
+            this.emitStateDelta({
+                toolCallCount: this.processor?.getToolCalls().length || 0,
+            });
+        }
+    };
+    /**
+     * Handle file change events from SPEC-007
+     *
+     * Transforms FileChange into a CUSTOM event with file operation details
+     */
+    handleFileChange = (fileChange) => {
+        const event = {
+            type: EventType.CUSTOM,
+            timestamp: Date.now(),
+            name: "file_change",
+            value: {
+                path: fileChange.path,
+                operation: fileChange.operation,
+                toolCallId: fileChange.toolCallId,
+                changes: fileChange.changes,
+            },
+        };
+        this.emit(event);
+        // Emit state delta with updated file change count
+        this.emitStateDelta({
+            fileChangeCount: this.processor?.getFileChanges().length || 0,
+        });
+    };
+    /**
+     * Handle progress updates from SPEC-007
+     *
+     * Transforms ProcessingMetrics into STATE_DELTA events
+     */
+    handleProgress = (metrics) => {
+        this.emitStateDelta({
+            totalMessages: metrics.totalMessages,
+            toolCallCount: metrics.toolCalls.length,
+            fileChangeCount: metrics.fileChanges.length,
+            errorCount: metrics.errors.length,
+            usage: {
+                inputTokens: metrics.usage.inputTokens,
+                outputTokens: metrics.usage.outputTokens,
+                totalTokens: metrics.usage.totalTokens,
+            },
+        });
+    };
+    /**
+     * Handle error events from SPEC-007
+     *
+     * Transforms errors into RUN_ERROR events
+     */
+    handleError = (error) => {
+        const event = {
+            type: EventType.RUN_ERROR,
+            timestamp: error.timestamp.getTime(),
+            message: error.message,
+            ...(error.details && { rawEvent: { details: error.details } }),
+        };
+        this.emit(event);
+        // Emit state delta with updated error count
+        this.emitStateDelta({
+            errorCount: this.processor?.getMetrics().errors.length || 0,
+        });
+    };
+    /**
+     * Handle message events
+     *
+     * Transforms text messages into TEXT_MESSAGE_* AG-UI events.
+     * For now, we emit the full message content in a single event.
+     */
+    handleMessage = (message) => {
+        if (message.type !== "text")
+            return;
+        const messageId = `msg-${this.messageCounter++}`;
+        const timestamp = Date.now();
+        // Emit TEXT_MESSAGE_START
+        const startEvent = {
+            type: EventType.TEXT_MESSAGE_START,
+            timestamp,
+            messageId,
+            role: "assistant",
+        };
+        this.emit(startEvent);
+        // Emit TEXT_MESSAGE_CONTENT with the full message
+        const contentEvent = {
+            type: EventType.TEXT_MESSAGE_CONTENT,
+            timestamp,
+            messageId,
+            delta: message.content,
+        };
+        this.emit(contentEvent);
+        // Emit TEXT_MESSAGE_END
+        const endEvent = {
+            type: EventType.TEXT_MESSAGE_END,
+            timestamp,
+            messageId,
+        };
+        this.emit(endEvent);
+    };
+    /**
+     * Handle usage metric updates
+     *
+     * Transforms usage metrics into CUSTOM usage events and updates state.
+     */
+    handleUsage = (usage) => {
+        const timestamp = Date.now();
+        // Emit USAGE event as CUSTOM event
+        const usageEvent = {
+            type: EventType.CUSTOM,
+            timestamp,
+            name: "USAGE_UPDATE",
+            value: {
+                inputTokens: usage.inputTokens,
+                outputTokens: usage.outputTokens,
+                cacheTokens: usage.cacheTokens,
+                totalTokens: usage.totalTokens,
+                cost: usage.cost,
+                provider: usage.provider,
+                model: usage.model,
+            },
+        };
+        this.emit(usageEvent);
+        // Update state with latest usage
+        this.emitStateDelta({
+            usage: {
+                inputTokens: usage.inputTokens,
+                outputTokens: usage.outputTokens,
+                totalTokens: usage.totalTokens,
+            },
+        });
+    };
+    /**
+     * Emit a state delta with partial state updates
+     *
+     * @param updates - Partial state updates to apply
+     */
+    emitStateDelta(updates) {
+        // Update current state
+        this.currentState = { ...this.currentState, ...updates };
+        // Convert updates to JSON Patch operations
+        const delta = Object.entries(updates).map(([key, value]) => ({
+            op: "replace",
+            path: `/${key}`,
+            value,
+        }));
+        const event = {
+            type: EventType.STATE_DELTA,
+            timestamp: Date.now(),
+            delta,
+        };
+        this.emit(event);
+    }
+    /**
+     * Emit an AG-UI event to all registered listeners
+     *
+     * @param event - The event to emit
+     */
+    emit(event) {
+        this.listeners.forEach((listener) => {
+            try {
+                listener(event);
+            }
+            catch (error) {
+                console.error("Error in AG-UI event listener:", error);
+            }
+        });
+    }
+    /**
+     * Emit STEP_STARTED event for workflow step execution
+     *
+     * @param stepId - Unique identifier for the step (stored in rawEvent)
+     * @param stepName - Human-readable name of the step
+     */
+    emitStepStarted(stepId, stepName) {
+        const event = {
+            type: EventType.STEP_STARTED,
+            timestamp: Date.now(),
+            stepName,
+            rawEvent: {
+                runId: this.runId,
+                stepId,
+            },
+        };
+        this.emit(event);
+    }
+    /**
+     * Emit STEP_FINISHED event for workflow step completion
+     *
+     * @param stepId - Unique identifier for the step (stored in rawEvent)
+     * @param status - Status of the step ('success' or 'error', stored in rawEvent)
+     * @param output - Optional output data from the step (stored in rawEvent)
+     */
+    emitStepFinished(stepId, status, output) {
+        const event = {
+            type: EventType.STEP_FINISHED,
+            timestamp: Date.now(),
+            stepName: stepId, // Use stepId as stepName for now
+            rawEvent: {
+                runId: this.runId,
+                stepId,
+                status,
+                ...(output && { output }),
+            },
+        };
+        this.emit(event);
+    }
+    /**
+     * Emit RUN_ERROR event when workflow execution fails
+     *
+     * @param message - Error message
+     * @param stack - Optional error stack trace
+     * @param code - Optional error code
+     */
+    emitRunError(message, stack, code) {
+        const event = {
+            type: EventType.RUN_ERROR,
+            timestamp: Date.now(),
+            message,
+            ...(code && { code }),
+            ...(stack && { rawEvent: { stack } }),
+        };
+        this.emit(event);
+    }
+    /**
+     * Get current adapter state
+     *
+     * @returns Current state object
+     */
+    getState() {
+        return { ...this.currentState };
+    }
+    /**
+     * Get the run ID
+     *
+     * @returns The run ID this adapter is tracking
+     */
+    getRunId() {
+        return this.runId;
+    }
+}
+//# sourceMappingURL=ag-ui-adapter.js.map

package/dist/execution/output/ag-ui-adapter.js.map

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

package/dist/execution/output/ag-ui-integration.js

@@ -0,0 +1,96 @@
+/**
+ * AG-UI Integration Helpers
+ *
+ * Factory functions and helpers to wire SPEC-007 output processing with SPEC-009 AG-UI streaming.
+ * Simplifies the integration between ClaudeCodeOutputProcessor and AgUiEventAdapter.
+ *
+ * @module execution/output/ag-ui-integration
+ */
+import { ClaudeCodeOutputProcessor } from './claude-code-output-processor.js';
+import { AgUiEventAdapter } from './ag-ui-adapter.js';
+/**
+ * Create a complete AG-UI system with processor and adapter pre-wired
+ *
+ * This is the recommended way to create an AG-UI streaming system.
+ * It automatically:
+ * - Creates a ClaudeCodeOutputProcessor
+ * - Creates an AgUiEventAdapter with the provided runId
+ * - Wires the processor to emit events through the adapter
+ *
+ * @param runId - Unique identifier for this execution run
+ * @param threadId - Optional thread ID (defaults to runId)
+ * @returns Complete AG-UI system ready to process output
+ *
+ * @example
+ * ```typescript
+ * const { processor, adapter } = createAgUiSystem('run-123');
+ *
+ * // Wire adapter to transport for SSE streaming
+ * transportManager.connectAdapter(adapter, 'run-123');
+ *
+ * // Process Claude Code output
+ * await processor.processLine('{"type":"assistant",...}');
+ *
+ * // Events automatically flow: processor -> adapter -> transport -> SSE clients
+ * ```
+ */
+export function createAgUiSystem(runId, threadId) {
+    const processor = new ClaudeCodeOutputProcessor();
+    const adapter = new AgUiEventAdapter(runId, threadId);
+    // Wire processor events to adapter
+    adapter.connectToProcessor(processor);
+    return { processor, adapter };
+}
+/**
+ * Manually wire an output processor to an AG-UI adapter
+ *
+ * Use this when you need more control over processor/adapter creation.
+ * This function handles all the event handler registration.
+ *
+ * @param processor - Output processor to wire
+ * @param adapter - AG-UI adapter to receive events
+ *
+ * @example
+ * ```typescript
+ * const processor = new ClaudeCodeOutputProcessor();
+ * const adapter = new AgUiEventAdapter('run-123');
+ *
+ * // Manually wire them together
+ * wireManually(processor, adapter);
+ *
+ * // Now processor events will flow to adapter
+ * ```
+ */
+export function wireManually(processor, adapter) {
+    adapter.connectToProcessor(processor);
+}
+/**
+ * Create an AG-UI system with custom processor implementation
+ *
+ * Use this when you have a custom output processor that implements IOutputProcessor.
+ * The processor will be wired to a new AgUiEventAdapter.
+ *
+ * @param processor - Custom output processor implementation
+ * @param runId - Unique identifier for this execution run
+ * @param threadId - Optional thread ID (defaults to runId)
+ * @returns AG-UI system with your custom processor
+ *
+ * @example
+ * ```typescript
+ * class CustomProcessor implements IOutputProcessor {
+ *   // ... your implementation
+ * }
+ *
+ * const processor = new CustomProcessor();
+ * const { processor, adapter } = createAgUiSystemWithProcessor(
+ *   processor,
+ *   'run-123'
+ * );
+ * ```
+ */
+export function createAgUiSystemWithProcessor(processor, runId, threadId) {
+    const adapter = new AgUiEventAdapter(runId, threadId);
+    adapter.connectToProcessor(processor);
+    return { processor, adapter };
+}
+//# sourceMappingURL=ag-ui-integration.js.map

package/dist/execution/output/ag-ui-integration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ag-ui-integration.js","sourceRoot":"","sources":["../../../src/execution/output/ag-ui-integration.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,yBAAyB,EAAE,MAAM,mCAAmC,CAAC;AAC9E,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAgBtD;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,MAAM,UAAU,gBAAgB,CAC9B,KAAa,EACb,QAAiB;IAEjB,MAAM,SAAS,GAAG,IAAI,yBAAyB,EAAE,CAAC;IAClD,MAAM,OAAO,GAAG,IAAI,gBAAgB,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;IAEtD,mCAAmC;IACnC,OAAO,CAAC,kBAAkB,CAAC,SAAS,CAAC,CAAC;IAEtC,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC;AAChC,CAAC;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,UAAU,YAAY,CAC1B,SAA2B,EAC3B,OAAyB;IAEzB,OAAO,CAAC,kBAAkB,CAAC,SAAS,CAAC,CAAC;AACxC,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,UAAU,6BAA6B,CAC3C,SAA2B,EAC3B,KAAa,EACb,QAAiB;IAEjB,MAAM,OAAO,GAAG,IAAI,gBAAgB,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;IACtD,OAAO,CAAC,kBAAkB,CAAC,SAAS,CAAC,CAAC;IAEtC,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC;AAChC,CAAC"}