sudocode 1.0.0 → 1.1.1

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

@@ -0,0 +1,103 @@
+/**
+ * Execution Engine Interface
+ *
+ * Core abstraction for task execution engines. Provides methods for
+ * submitting, controlling, monitoring, and waiting for task execution.
+ *
+ * @module execution/engine/engine
+ */
+import type { ExecutionTask, ExecutionResult, TaskStatus, EngineMetrics, TaskCompleteHandler, TaskFailedHandler } from './types.js';
+/**
+ * IExecutionEngine - Interface for task execution engines
+ *
+ * Defines the contract for engines that manage Claude Code agent execution.
+ * Implementations may use different strategies (queue-based, pool-based, etc.)
+ * but must provide these core capabilities.
+ */
+export interface IExecutionEngine {
+    /**
+     * Submit a single task for execution
+     *
+     * @param task - The task to execute
+     * @returns Promise resolving to the task ID
+     */
+    submitTask(task: ExecutionTask): Promise<string>;
+    /**
+     * Submit multiple tasks for execution
+     *
+     * @param tasks - Array of tasks to execute
+     * @returns Promise resolving to array of task IDs
+     */
+    submitTasks(tasks: ExecutionTask[]): Promise<string[]>;
+    /**
+     * Cancel a queued or running task
+     *
+     * For queued tasks, removes from queue without execution.
+     * For running tasks, terminates the process.
+     *
+     * @param taskId - ID of task to cancel
+     * @returns Promise that resolves when cancellation complete
+     */
+    cancelTask(taskId: string): Promise<void>;
+    /**
+     * Get current status of a task
+     *
+     * @param taskId - ID of task to query
+     * @returns Current task status or null if task not found
+     */
+    getTaskStatus(taskId: string): TaskStatus | null;
+    /**
+     * Wait for a task to complete
+     *
+     * Returns immediately if task already completed, otherwise
+     * waits for completion and returns result.
+     *
+     * @param taskId - ID of task to wait for
+     * @returns Promise resolving to execution result
+     * @throws Error if task fails
+     */
+    waitForTask(taskId: string): Promise<ExecutionResult>;
+    /**
+     * Wait for multiple tasks to complete
+     *
+     * @param taskIds - IDs of tasks to wait for
+     * @returns Promise resolving to array of execution results
+     * @throws Error if any task fails
+     */
+    waitForTasks(taskIds: string[]): Promise<ExecutionResult[]>;
+    /**
+     * Get current engine metrics
+     *
+     * Returns real-time statistics about engine performance
+     * and resource utilization.
+     *
+     * @returns Current engine metrics (defensive copy)
+     */
+    getMetrics(): EngineMetrics;
+    /**
+     * Register handler for task completion events
+     *
+     * Called when any task completes successfully.
+     *
+     * @param handler - Callback function to invoke on completion
+     */
+    onTaskComplete(handler: TaskCompleteHandler): void;
+    /**
+     * Register handler for task failure events
+     *
+     * Called when any task fails after all retries exhausted.
+     *
+     * @param handler - Callback function to invoke on failure
+     */
+    onTaskFailed(handler: TaskFailedHandler): void;
+    /**
+     * Gracefully shutdown the engine
+     *
+     * Stops accepting new tasks, cancels queued tasks,
+     * terminates running tasks, and releases all resources.
+     *
+     * @returns Promise that resolves when shutdown complete
+     */
+    shutdown(): Promise<void>;
+}
+//# sourceMappingURL=engine.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"engine.d.ts","sourceRoot":"","sources":["../../../src/execution/engine/engine.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EACV,aAAa,EACb,eAAe,EACf,UAAU,EACV,aAAa,EACb,mBAAmB,EACnB,iBAAiB,EAClB,MAAM,YAAY,CAAC;AAEpB;;;;;;GAMG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;;;;OAKG;IACH,UAAU,CAAC,IAAI,EAAE,aAAa,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAEjD;;;;;OAKG;IACH,WAAW,CAAC,KAAK,EAAE,aAAa,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAEvD;;;;;;;;OAQG;IACH,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE1C;;;;;OAKG;IACH,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI,CAAC;IAEjD;;;;;;;;;OASG;IACH,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;IAEtD;;;;;;OAMG;IACH,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC,CAAC;IAE5D;;;;;;;OAOG;IACH,UAAU,IAAI,aAAa,CAAC;IAE5B;;;;;;OAMG;IACH,cAAc,CAAC,OAAO,EAAE,mBAAmB,GAAG,IAAI,CAAC;IAEnD;;;;;;OAMG;IACH,YAAY,CAAC,OAAO,EAAE,iBAAiB,GAAG,IAAI,CAAC;IAE/C;;;;;;;OAOG;IACH,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3B"}

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

@@ -0,0 +1,10 @@
+/**
+ * Execution Engine Interface
+ *
+ * Core abstraction for task execution engines. Provides methods for
+ * submitting, controlling, monitoring, and waiting for task execution.
+ *
+ * @module execution/engine/engine
+ */
+export {};
+//# sourceMappingURL=engine.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"engine.js","sourceRoot":"","sources":["../../../src/execution/engine/engine.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG"}

package/node_modules/@sudocode-ai/local-server/dist/execution/engine/simple-engine.d.ts

@@ -0,0 +1,190 @@
+/**
+ * Simple Execution Engine
+ *
+ * Queue-based execution engine that spawns a process per task
+ * with concurrency limits. Implements the "simple first" approach.
+ *
+ * @module execution/engine/simple-engine
+ */
+import type { IExecutionEngine } from "./engine.js";
+import type { ExecutionTask, ExecutionResult, TaskStatus, EngineMetrics, TaskCompleteHandler, TaskFailedHandler, EngineConfig } from "./types.js";
+import type { IProcessManager } from "../process/manager.js";
+/**
+ * SimpleExecutionEngine - Queue-based task execution with concurrency control
+ *
+ * Key features:
+ * - FIFO queue for task ordering
+ * - Configurable concurrency limit (default: 3)
+ * - Automatic retry on failure
+ * - Event emission for task lifecycle
+ * - Promise-based waiting
+ * - Graceful shutdown
+ */
+export declare class SimpleExecutionEngine implements IExecutionEngine {
+    private _processManager;
+    private _config;
+    private taskQueue;
+    private runningTasks;
+    private completedResults;
+    private taskResolvers;
+    private metrics;
+    private completeHandlers;
+    private failedHandlers;
+    private pollingIntervals;
+    /**
+     * Create a new SimpleExecutionEngine
+     *
+     * @param processManager - Process manager for spawning Claude processes
+     * @param config - Engine configuration options
+     */
+    constructor(_processManager: IProcessManager, _config?: EngineConfig);
+    /**
+     * Submit a single task for execution
+     *
+     * Adds task to queue and attempts to start execution if capacity available.
+     *
+     * @param task - The task to execute
+     * @returns Promise resolving to the task ID
+     */
+    submitTask(task: ExecutionTask): Promise<string>;
+    /**
+     * Submit multiple tasks for execution
+     *
+     * @param tasks - Array of tasks to execute
+     * @returns Promise resolving to array of task IDs
+     */
+    submitTasks(tasks: ExecutionTask[]): Promise<string[]>;
+    /**
+     * Process the task queue
+     *
+     * Dequeues tasks and starts execution while capacity is available.
+     * Checks dependencies before execution and re-queues if not met.
+     *
+     * @private
+     */
+    private processQueue;
+    /**
+     * Check if all task dependencies are met
+     *
+     * @param task - Task to check
+     * @returns True if all dependencies completed successfully
+     * @private
+     */
+    private areDependenciesMet;
+    /**
+     * Check if any task dependency has failed
+     *
+     * @param task - Task to check
+     * @returns True if any dependency failed
+     * @private
+     */
+    private hasFailedDependency;
+    /**
+     * Track task as running and update capacity metrics
+     *
+     * @param task - Task to start tracking
+     * @private
+     */
+    private trackTaskStart;
+    /**
+     * Track task completion and release capacity
+     *
+     * @param taskId - ID of completed task
+     * @private
+     */
+    private trackTaskComplete;
+    /**
+     * Execute a task
+     *
+     * Acquires a process, sends the prompt, collects output, and builds the result.
+     *
+     * @param task - Task to execute
+     * @private
+     */
+    private executeTask;
+    /**
+     * Wait for a process to exit
+     *
+     * @param process - The managed process to wait for
+     * @param timeoutMs - Optional timeout in milliseconds
+     * @private
+     */
+    private waitForProcessExit;
+    /**
+     * Parse metadata from stream-json output
+     *
+     * Extracts tools used, files changed, tokens, etc. from the output.
+     *
+     * @param output - Raw output from Claude Code
+     * @returns Parsed metadata
+     * @private
+     */
+    private parseMetadata;
+    /**
+     * Handle task failure
+     *
+     * Implements automatic retry logic if maxRetries is configured.
+     * Re-queues failed tasks at front of queue for priority retry.
+     *
+     * @param taskId - ID of failed task
+     * @param error - Error that occurred
+     * @private
+     */
+    private handleTaskFailure;
+    /**
+     * Cancel a queued or running task
+     *
+     * Removes task from queue if still queued, or terminates process if running.
+     * Idempotent - safe to call multiple times or for non-existent tasks.
+     *
+     * @param taskId - ID of task to cancel
+     */
+    cancelTask(taskId: string): Promise<void>;
+    /**
+     * Get current status of a task
+     */
+    getTaskStatus(taskId: string): TaskStatus | null;
+    /**
+     * Wait for a task to complete
+     *
+     * Returns a promise that resolves with the task result when complete.
+     * Supports multiple concurrent waiters for the same task.
+     *
+     * @param taskId - ID of the task to wait for
+     * @returns Promise resolving to the execution result
+     */
+    waitForTask(taskId: string): Promise<ExecutionResult>;
+    /**
+     * Wait for multiple tasks to complete
+     *
+     * Returns a promise that resolves when all tasks complete.
+     *
+     * @param taskIds - Array of task IDs to wait for
+     * @returns Promise resolving to array of execution results
+     */
+    waitForTasks(taskIds: string[]): Promise<ExecutionResult[]>;
+    /**
+     * Get current engine metrics
+     *
+     * Returns defensive copy of current metrics.
+     *
+     * @returns Current engine metrics
+     */
+    getMetrics(): EngineMetrics;
+    /**
+     * Register handler for task completion events
+     */
+    onTaskComplete(handler: TaskCompleteHandler): void;
+    /**
+     * Register handler for task failure events
+     */
+    onTaskFailed(handler: TaskFailedHandler): void;
+    /**
+     * Gracefully shutdown the engine
+     *
+     * Cancels all running tasks, clears the queue, and shuts down the process manager.
+     * Idempotent - safe to call multiple times.
+     */
+    shutdown(): Promise<void>;
+}
+//# sourceMappingURL=simple-engine.d.ts.map

package/node_modules/@sudocode-ai/local-server/dist/execution/engine/simple-engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"simple-engine.d.ts","sourceRoot":"","sources":["../../../src/execution/engine/simple-engine.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AACpD,OAAO,KAAK,EACV,aAAa,EACb,eAAe,EACf,UAAU,EACV,aAAa,EACb,mBAAmB,EACnB,iBAAiB,EACjB,YAAY,EAGb,MAAM,YAAY,CAAC;AACpB,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAI7D;;;;;;;;;;GAUG;AACH,qBAAa,qBAAsB,YAAW,gBAAgB;IA8B1D,OAAO,CAAC,eAAe;IACvB,OAAO,CAAC,OAAO;IA7BjB,OAAO,CAAC,SAAS,CAAuB;IAGxC,OAAO,CAAC,YAAY,CAAkC;IAGtD,OAAO,CAAC,gBAAgB,CAAsC;IAG9D,OAAO,CAAC,aAAa,CAAqC;IAG1D,OAAO,CAAC,OAAO,CAAgB;IAG/B,OAAO,CAAC,gBAAgB,CAA6B;IACrD,OAAO,CAAC,cAAc,CAA2B;IAGjD,OAAO,CAAC,gBAAgB,CAAqC;IAE7D;;;;;OAKG;gBAEO,eAAe,EAAE,eAAe,EAChC,OAAO,GAAE,YAAiB;IAkBpC;;;;;;;OAOG;IACG,UAAU,CAAC,IAAI,EAAE,aAAa,GAAG,OAAO,CAAC,MAAM,CAAC;IAWtD;;;;;OAKG;IACG,WAAW,CAAC,KAAK,EAAE,aAAa,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAW5D;;;;;;;OAOG;IACH,OAAO,CAAC,YAAY;IA2CpB;;;;;;OAMG;IACH,OAAO,CAAC,kBAAkB;IAyB1B;;;;;;OAMG;IACH,OAAO,CAAC,mBAAmB;IAa3B;;;;;OAKG;IACH,OAAO,CAAC,cAAc;IAmBtB;;;;;OAKG;IACH,OAAO,CAAC,iBAAiB;IAazB;;;;;;;OAOG;YACW,WAAW;IAyGzB;;;;;;OAMG;YACW,kBAAkB;IA+ChC;;;;;;;;OAQG;IACH,OAAO,CAAC,aAAa;IAWrB;;;;;;;;;OASG;IACH,OAAO,CAAC,iBAAiB;IA6EzB;;;;;;;OAOG;IACG,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IA6C/C;;OAEG;IACH,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI;IA0BhD;;;;;;;;OAQG;IACG,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC;IAa3D;;;;;;;OAOG;IACG,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;IAIjE;;;;;;OAMG;IACH,UAAU,IAAI,aAAa;IAK3B;;OAEG;IACH,cAAc,CAAC,OAAO,EAAE,mBAAmB,GAAG,IAAI;IAIlD;;OAEG;IACH,YAAY,CAAC,OAAO,EAAE,iBAAiB,GAAG,IAAI;IAI9C;;;;;OAKG;IACG,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;CA6BhC"}