sudocode 1.0.0 → 1.1.1

package/node_modules/@sudocode-ai/local-server/dist/execution/resilience/types.d.ts

@@ -0,0 +1,226 @@
+/**
+ * Resilience Layer Types
+ *
+ * Core types for the Resilience Layer (Layer 3) that adds retry logic,
+ * circuit breakers, and fault tolerance to task execution.
+ *
+ * @module execution/resilience/types
+ */
+import type { ExecutionResult } from '../engine/types.js';
+/**
+ * RetryPolicy - Configuration for retry behavior
+ */
+export interface RetryPolicy {
+    /**
+     * Maximum number of retry attempts (0 = no retry)
+     */
+    maxAttempts: number;
+    /**
+     * Backoff strategy configuration
+     */
+    backoff: {
+        /**
+         * Type of backoff strategy
+         * - exponential: delay = baseDelay * 2^(attempt-1)
+         * - linear: delay = baseDelay * attempt
+         * - fixed: delay = baseDelay (constant)
+         */
+        type: 'exponential' | 'linear' | 'fixed';
+        /**
+         * Initial delay in milliseconds
+         */
+        baseDelayMs: number;
+        /**
+         * Maximum delay cap in milliseconds
+         */
+        maxDelayMs: number;
+        /**
+         * Add randomness to prevent thundering herd
+         * Adds ±10% jitter to delay
+         */
+        jitter: boolean;
+    };
+    /**
+     * Error types/messages that should trigger a retry
+     * Examples: 'ECONNREFUSED', 'timeout', 'network'
+     */
+    retryableErrors: string[];
+    /**
+     * Exit codes that should trigger a retry
+     * Examples: [1, 137] for generic error and SIGKILL
+     */
+    retryableExitCodes: number[];
+    /**
+     * Optional callback to determine if circuit breaker should open
+     */
+    shouldOpenCircuit?: (error: Error, attempts: number) => boolean;
+}
+/**
+ * CircuitState - State of a circuit breaker
+ */
+export type CircuitState = 'closed' | 'open' | 'half-open';
+/**
+ * CircuitBreaker - Circuit breaker for preventing cascading failures
+ */
+export interface CircuitBreaker {
+    /**
+     * Unique name for this circuit breaker
+     * Typically matches the task type (e.g., 'issue', 'spec', 'custom')
+     */
+    name: string;
+    /**
+     * Current state of the circuit
+     * - closed: Normal operation, requests pass through
+     * - open: Too many failures, requests rejected
+     * - half-open: Testing if service recovered, limited requests allowed
+     */
+    state: CircuitState;
+    /**
+     * Circuit breaker configuration
+     */
+    config: {
+        /**
+         * Number of consecutive failures before opening circuit
+         */
+        failureThreshold: number;
+        /**
+         * Number of consecutive successes in half-open to close circuit
+         */
+        successThreshold: number;
+        /**
+         * Time to wait before transitioning from open to half-open (ms)
+         */
+        timeout: number;
+    };
+    /**
+     * Circuit breaker metrics
+     */
+    metrics: {
+        /**
+         * Total requests processed
+         */
+        totalRequests: number;
+        /**
+         * Total failed requests
+         */
+        failedRequests: number;
+        /**
+         * Total successful requests
+         */
+        successfulRequests: number;
+        /**
+         * Timestamp of last failure
+         */
+        lastFailureTime?: Date;
+        /**
+         * Timestamp of last success
+         */
+        lastSuccessTime?: Date;
+    };
+}
+/**
+ * ExecutionAttempt - Record of a single execution attempt
+ */
+export interface ExecutionAttempt {
+    /**
+     * Attempt number (1-indexed)
+     */
+    attemptNumber: number;
+    /**
+     * When this attempt started
+     */
+    startedAt: Date;
+    /**
+     * When this attempt completed (if finished)
+     */
+    completedAt?: Date;
+    /**
+     * Duration of this attempt in milliseconds
+     */
+    duration?: number;
+    /**
+     * Whether this attempt succeeded
+     */
+    success: boolean;
+    /**
+     * Error that occurred during this attempt
+     */
+    error?: Error;
+    /**
+     * Exit code from this attempt
+     */
+    exitCode?: number;
+    /**
+     * Whether another retry will be attempted after this
+     */
+    willRetry: boolean;
+    /**
+     * When the next retry will occur (if willRetry is true)
+     */
+    nextRetryAt?: Date;
+}
+/**
+ * ResilientExecutionResult - Enhanced execution result with retry information
+ *
+ * Extends the base ExecutionResult with detailed retry tracking
+ */
+export interface ResilientExecutionResult extends ExecutionResult {
+    /**
+     * All execution attempts made for this task
+     */
+    attempts: ExecutionAttempt[];
+    /**
+     * Total number of attempts made
+     */
+    totalAttempts: number;
+    /**
+     * The final attempt (may be success or failure)
+     */
+    finalAttempt: ExecutionAttempt;
+    /**
+     * Human-readable reason for failure (if failed)
+     */
+    failureReason?: string;
+    /**
+     * Whether the circuit breaker prevented execution
+     */
+    circuitBreakerTriggered?: boolean;
+}
+/**
+ * RetryMetrics - Aggregate metrics for retry behavior
+ */
+export interface RetryMetrics {
+    /**
+     * Total number of retries attempted across all tasks
+     */
+    totalRetries: number;
+    /**
+     * Number of retries that eventually succeeded
+     */
+    successfulRetries: number;
+    /**
+     * Number of retries that ultimately failed
+     */
+    failedRetries: number;
+    /**
+     * Average number of attempts needed for successful tasks
+     */
+    averageAttemptsToSuccess: number;
+    /**
+     * Circuit breakers by name
+     */
+    circuitBreakers: Map<string, CircuitBreaker>;
+}
+/**
+ * RetryAttemptHandler - Callback for retry attempt events
+ */
+export type RetryAttemptHandler = (taskId: string, attempt: ExecutionAttempt) => void;
+/**
+ * CircuitOpenHandler - Callback for circuit breaker open events
+ */
+export type CircuitOpenHandler = (circuitName: string, breaker: CircuitBreaker) => void;
+/**
+ * Default retry policy for resilient execution
+ */
+export declare const DEFAULT_RETRY_POLICY: RetryPolicy;
+//# sourceMappingURL=types.d.ts.map

package/node_modules/@sudocode-ai/local-server/dist/execution/resilience/types.d.ts.map

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

package/node_modules/@sudocode-ai/local-server/dist/execution/resilience/types.js

@@ -0,0 +1,30 @@
+/**
+ * Resilience Layer Types
+ *
+ * Core types for the Resilience Layer (Layer 3) that adds retry logic,
+ * circuit breakers, and fault tolerance to task execution.
+ *
+ * @module execution/resilience/types
+ */
+/**
+ * Default retry policy for resilient execution
+ */
+export const DEFAULT_RETRY_POLICY = {
+    maxAttempts: 3,
+    backoff: {
+        type: 'exponential',
+        baseDelayMs: 1000,
+        maxDelayMs: 30000,
+        jitter: true,
+    },
+    retryableErrors: [
+        'ECONNREFUSED',
+        'ETIMEDOUT',
+        'ENOTFOUND',
+        'timeout',
+        'network',
+        'Process execution timeout',
+    ],
+    retryableExitCodes: [1, 137], // Generic error, SIGKILL
+};
+//# sourceMappingURL=types.js.map

package/node_modules/@sudocode-ai/local-server/dist/execution/resilience/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/execution/resilience/types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAsQH;;GAEG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAgB;IAC/C,WAAW,EAAE,CAAC;IACd,OAAO,EAAE;QACP,IAAI,EAAE,aAAa;QACnB,WAAW,EAAE,IAAI;QACjB,UAAU,EAAE,KAAK;QACjB,MAAM,EAAE,IAAI;KACb;IACD,eAAe,EAAE;QACf,cAAc;QACd,WAAW;QACX,WAAW;QACX,SAAS;QACT,SAAS;QACT,2BAA2B;KAC5B;IACD,kBAAkB,EAAE,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,yBAAyB;CACxD,CAAC"}

package/node_modules/@sudocode-ai/local-server/dist/execution/transport/event-buffer.d.ts

@@ -0,0 +1,119 @@
+/**
+ * Execution Event Buffer
+ *
+ * Stores AG-UI events for executions so they can be replayed to late-joining clients
+ * or retrieved for historical display.
+ *
+ * @module execution/transport/event-buffer
+ */
+import type { AgUiEvent } from "./transport-manager.js";
+/**
+ * Buffered event with metadata
+ */
+export interface BufferedEvent {
+    /** The AG-UI event */
+    event: AgUiEvent;
+    /** When the event was buffered */
+    timestamp: number;
+    /** Event sequence number within the execution */
+    sequenceNumber: number;
+}
+/**
+ * Event buffer for a single execution
+ */
+export interface ExecutionEventBuffer {
+    /** Execution/run ID */
+    executionId: string;
+    /** Buffered events in order */
+    events: BufferedEvent[];
+    /** Next sequence number */
+    nextSequence: number;
+    /** When the buffer was created */
+    createdAt: number;
+    /** When the buffer was last updated */
+    lastUpdatedAt: number;
+}
+/**
+ * EventBuffer - In-memory storage for execution events
+ *
+ * Stores events for active executions and allows replay when clients connect.
+ * Events are automatically pruned after executions complete to prevent memory leaks.
+ */
+export declare class EventBuffer {
+    private buffers;
+    private readonly MAX_EVENTS_PER_EXECUTION;
+    private readonly RETENTION_MS;
+    /**
+     * Add an event to the buffer for an execution
+     *
+     * @param executionId - Execution ID
+     * @param event - AG-UI event to buffer
+     */
+    addEvent(executionId: string, event: AgUiEvent): void;
+    /**
+     * Get all buffered events for an execution
+     *
+     * @param executionId - Execution ID
+     * @param fromSequence - Optional: only return events >= this sequence number
+     * @returns Array of buffered events, or empty array if no buffer exists
+     */
+    getEvents(executionId: string, fromSequence?: number): BufferedEvent[];
+    /**
+     * Check if a buffer exists for an execution
+     *
+     * @param executionId - Execution ID
+     * @returns true if buffer exists
+     */
+    hasBuffer(executionId: string): boolean;
+    /**
+     * Get buffer metadata without events
+     *
+     * @param executionId - Execution ID
+     * @returns Buffer metadata or null if not found
+     */
+    getBufferInfo(executionId: string): Omit<ExecutionEventBuffer, "events"> | null;
+    /**
+     * Remove a buffer for an execution
+     *
+     * @param executionId - Execution ID
+     * @returns true if buffer was removed, false if it didn't exist
+     */
+    removeBuffer(executionId: string): boolean;
+    /**
+     * Clear all buffers
+     */
+    clearAll(): void;
+    /**
+     * Prune stale buffers that haven't been updated recently
+     *
+     * Should be called periodically to prevent memory leaks.
+     *
+     * @returns Number of buffers pruned
+     */
+    pruneStale(): number;
+    /**
+     * Get total number of buffers
+     *
+     * @returns Number of active buffers
+     */
+    getBufferCount(): number;
+    /**
+     * Get total number of events across all buffers
+     *
+     * @returns Total event count
+     */
+    getTotalEventCount(): number;
+    /**
+     * Get statistics about buffer usage
+     *
+     * @returns Buffer statistics
+     */
+    getStats(): {
+        bufferCount: number;
+        totalEvents: number;
+        avgEventsPerBuffer: number;
+        oldestBuffer: number | null;
+        newestBuffer: number | null;
+    };
+}
+//# sourceMappingURL=event-buffer.d.ts.map

package/node_modules/@sudocode-ai/local-server/dist/execution/transport/event-buffer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-buffer.d.ts","sourceRoot":"","sources":["../../../src/execution/transport/event-buffer.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAExD;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,sBAAsB;IACtB,KAAK,EAAE,SAAS,CAAC;IACjB,kCAAkC;IAClC,SAAS,EAAE,MAAM,CAAC;IAClB,iDAAiD;IACjD,cAAc,EAAE,MAAM,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,uBAAuB;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,+BAA+B;IAC/B,MAAM,EAAE,aAAa,EAAE,CAAC;IACxB,2BAA2B;IAC3B,YAAY,EAAE,MAAM,CAAC;IACrB,kCAAkC;IAClC,SAAS,EAAE,MAAM,CAAC;IAClB,uCAAuC;IACvC,aAAa,EAAE,MAAM,CAAC;CACvB;AAED;;;;;GAKG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,OAAO,CAA2C;IAC1D,OAAO,CAAC,QAAQ,CAAC,wBAAwB,CAAS;IAClD,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAkB;IAE/C;;;;;OAKG;IACH,QAAQ,CAAC,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,GAAG,IAAI;IAmDrD;;;;;;OAMG;IACH,SAAS,CAAC,WAAW,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,aAAa,EAAE;IAatE;;;;;OAKG;IACH,SAAS,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO;IAIvC;;;;;OAKG;IACH,aAAa,CACX,WAAW,EAAE,MAAM,GAClB,IAAI,CAAC,oBAAoB,EAAE,QAAQ,CAAC,GAAG,IAAI;IAc9C;;;;;OAKG;IACH,YAAY,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO;IAY1C;;OAEG;IACH,QAAQ,IAAI,IAAI;IAMhB;;;;;;OAMG;IACH,UAAU,IAAI,MAAM;IAsBpB;;;;OAIG;IACH,cAAc,IAAI,MAAM;IAIxB;;;;OAIG;IACH,kBAAkB,IAAI,MAAM;IAQ5B;;;;OAIG;IACH,QAAQ,IAAI;QACV,WAAW,EAAE,MAAM,CAAC;QACpB,WAAW,EAAE,MAAM,CAAC;QACpB,kBAAkB,EAAE,MAAM,CAAC;QAC3B,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;QAC5B,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;KAC7B;CAwBF"}

package/node_modules/@sudocode-ai/local-server/dist/execution/transport/event-buffer.js

@@ -0,0 +1,208 @@
+/**
+ * Execution Event Buffer
+ *
+ * Stores AG-UI events for executions so they can be replayed to late-joining clients
+ * or retrieved for historical display.
+ *
+ * @module execution/transport/event-buffer
+ */
+/**
+ * EventBuffer - In-memory storage for execution events
+ *
+ * Stores events for active executions and allows replay when clients connect.
+ * Events are automatically pruned after executions complete to prevent memory leaks.
+ */
+export class EventBuffer {
+    buffers = new Map();
+    MAX_EVENTS_PER_EXECUTION = 10000; // Prevent unbounded growth
+    RETENTION_MS = 1000 * 60 * 60; // 1 hour after last update
+    /**
+     * Add an event to the buffer for an execution
+     *
+     * @param executionId - Execution ID
+     * @param event - AG-UI event to buffer
+     */
+    addEvent(executionId, event) {
+        let buffer = this.buffers.get(executionId);
+        if (!buffer) {
+            buffer = {
+                executionId,
+                events: [],
+                nextSequence: 0,
+                createdAt: Date.now(),
+                lastUpdatedAt: Date.now(),
+            };
+            this.buffers.set(executionId, buffer);
+            console.log("[EventBuffer] Created buffer for execution", {
+                executionId,
+                timestamp: new Date().toISOString(),
+            });
+        }
+        // Add event with sequence number
+        const bufferedEvent = {
+            event,
+            timestamp: Date.now(),
+            sequenceNumber: buffer.nextSequence++,
+        };
+        buffer.events.push(bufferedEvent);
+        buffer.lastUpdatedAt = Date.now();
+        // Enforce max events limit
+        if (buffer.events.length > this.MAX_EVENTS_PER_EXECUTION) {
+            // Remove oldest 10% of events
+            const toRemove = Math.floor(this.MAX_EVENTS_PER_EXECUTION * 0.1);
+            buffer.events.splice(0, toRemove);
+            console.warn("[EventBuffer] Buffer size limit reached, removing oldest events", {
+                executionId,
+                removedCount: toRemove,
+                remainingCount: buffer.events.length,
+            });
+        }
+        console.log("[EventBuffer] Event added to buffer", {
+            executionId,
+            eventType: event.type,
+            sequenceNumber: bufferedEvent.sequenceNumber,
+            totalEvents: buffer.events.length,
+        });
+    }
+    /**
+     * Get all buffered events for an execution
+     *
+     * @param executionId - Execution ID
+     * @param fromSequence - Optional: only return events >= this sequence number
+     * @returns Array of buffered events, or empty array if no buffer exists
+     */
+    getEvents(executionId, fromSequence) {
+        const buffer = this.buffers.get(executionId);
+        if (!buffer) {
+            return [];
+        }
+        if (fromSequence !== undefined) {
+            return buffer.events.filter((e) => e.sequenceNumber >= fromSequence);
+        }
+        return [...buffer.events];
+    }
+    /**
+     * Check if a buffer exists for an execution
+     *
+     * @param executionId - Execution ID
+     * @returns true if buffer exists
+     */
+    hasBuffer(executionId) {
+        return this.buffers.has(executionId);
+    }
+    /**
+     * Get buffer metadata without events
+     *
+     * @param executionId - Execution ID
+     * @returns Buffer metadata or null if not found
+     */
+    getBufferInfo(executionId) {
+        const buffer = this.buffers.get(executionId);
+        if (!buffer) {
+            return null;
+        }
+        return {
+            executionId: buffer.executionId,
+            nextSequence: buffer.nextSequence,
+            createdAt: buffer.createdAt,
+            lastUpdatedAt: buffer.lastUpdatedAt,
+        };
+    }
+    /**
+     * Remove a buffer for an execution
+     *
+     * @param executionId - Execution ID
+     * @returns true if buffer was removed, false if it didn't exist
+     */
+    removeBuffer(executionId) {
+        const existed = this.buffers.has(executionId);
+        if (existed) {
+            this.buffers.delete(executionId);
+            console.log("[EventBuffer] Buffer removed", {
+                executionId,
+                timestamp: new Date().toISOString(),
+            });
+        }
+        return existed;
+    }
+    /**
+     * Clear all buffers
+     */
+    clearAll() {
+        const count = this.buffers.size;
+        this.buffers.clear();
+        console.log("[EventBuffer] All buffers cleared", { count });
+    }
+    /**
+     * Prune stale buffers that haven't been updated recently
+     *
+     * Should be called periodically to prevent memory leaks.
+     *
+     * @returns Number of buffers pruned
+     */
+    pruneStale() {
+        const now = Date.now();
+        const threshold = now - this.RETENTION_MS;
+        let pruned = 0;
+        for (const [executionId, buffer] of this.buffers.entries()) {
+            if (buffer.lastUpdatedAt < threshold) {
+                this.buffers.delete(executionId);
+                pruned++;
+            }
+        }
+        if (pruned > 0) {
+            console.log("[EventBuffer] Pruned stale buffers", {
+                count: pruned,
+                remaining: this.buffers.size,
+            });
+        }
+        return pruned;
+    }
+    /**
+     * Get total number of buffers
+     *
+     * @returns Number of active buffers
+     */
+    getBufferCount() {
+        return this.buffers.size;
+    }
+    /**
+     * Get total number of events across all buffers
+     *
+     * @returns Total event count
+     */
+    getTotalEventCount() {
+        let total = 0;
+        for (const buffer of this.buffers.values()) {
+            total += buffer.events.length;
+        }
+        return total;
+    }
+    /**
+     * Get statistics about buffer usage
+     *
+     * @returns Buffer statistics
+     */
+    getStats() {
+        const bufferCount = this.buffers.size;
+        const totalEvents = this.getTotalEventCount();
+        let oldest = null;
+        let newest = null;
+        for (const buffer of this.buffers.values()) {
+            if (oldest === null || buffer.createdAt < oldest) {
+                oldest = buffer.createdAt;
+            }
+            if (newest === null || buffer.createdAt > newest) {
+                newest = buffer.createdAt;
+            }
+        }
+        return {
+            bufferCount,
+            totalEvents,
+            avgEventsPerBuffer: bufferCount > 0 ? totalEvents / bufferCount : 0,
+            oldestBuffer: oldest,
+            newestBuffer: newest,
+        };
+    }
+}
+//# sourceMappingURL=event-buffer.js.map

package/node_modules/@sudocode-ai/local-server/dist/execution/transport/event-buffer.js.map

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

package/node_modules/@sudocode-ai/local-server/dist/execution/transport/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Transport Layer
+ *
+ * Exports transport implementations for streaming AG-UI events to clients.
+ *
+ * @module execution/transport
+ */
+export { SseTransport } from './sse-transport.js';
+export { TransportManager } from './transport-manager.js';
+//# sourceMappingURL=index.d.ts.map

package/node_modules/@sudocode-ai/local-server/dist/execution/transport/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/execution/transport/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC"}

package/node_modules/@sudocode-ai/local-server/dist/execution/transport/index.js

@@ -0,0 +1,10 @@
+/**
+ * Transport Layer
+ *
+ * Exports transport implementations for streaming AG-UI events to clients.
+ *
+ * @module execution/transport
+ */
+export { SseTransport } from './sse-transport.js';
+export { TransportManager } from './transport-manager.js';
+//# sourceMappingURL=index.js.map

package/node_modules/@sudocode-ai/local-server/dist/execution/transport/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/execution/transport/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC"}