@sudocode-ai/local-server 0.1.0

package/dist/execution/transport/transport-manager.d.ts

@@ -0,0 +1,176 @@
+/**
+ * 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 type { AgUiEventAdapter } from "../output/ag-ui-adapter.js";
+import type { RunStartedEvent, RunFinishedEvent, RunErrorEvent, StepStartedEvent, StepFinishedEvent, ToolCallStartEvent, ToolCallArgsEvent, ToolCallEndEvent, ToolCallResultEvent, TextMessageStartEvent, TextMessageContentEvent, TextMessageEndEvent, StateDeltaEvent, StateSnapshotEvent, CustomEvent } from "@ag-ui/core";
+import { SseTransport } from "./sse-transport.js";
+/**
+ * Union type for all AG-UI events
+ */
+export type AgUiEvent = RunStartedEvent | RunFinishedEvent | RunErrorEvent | StepStartedEvent | StepFinishedEvent | ToolCallStartEvent | ToolCallArgsEvent | ToolCallEndEvent | ToolCallResultEvent | TextMessageStartEvent | TextMessageContentEvent | TextMessageEndEvent | StateDeltaEvent | StateSnapshotEvent | CustomEvent;
+/**
+ * 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 declare class TransportManager {
+    private sseTransport;
+    private eventBuffer;
+    private adapterListeners;
+    private pruneInterval;
+    /**
+     * Create a new transport manager
+     *
+     * Initializes the SSE transport layer and event buffer
+     */
+    constructor();
+    /**
+     * 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: AgUiEventAdapter, runId?: string): void;
+    /**
+     * 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: AgUiEventAdapter): boolean;
+    /**
+     * 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: AgUiEvent): number;
+    /**
+     * 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: string, event: AgUiEvent): number;
+    /**
+     * 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(): SseTransport;
+    /**
+     * Get number of connected adapters
+     *
+     * @returns Number of active adapter connections
+     */
+    getAdapterCount(): number;
+    /**
+     * 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: string, fromSequence?: number): import("./event-buffer.js").BufferedEvent[];
+    /**
+     * Check if events are buffered for an execution
+     *
+     * @param runId - Target run ID
+     * @returns true if events are buffered
+     */
+    hasBufferedEvents(runId: string): boolean;
+    /**
+     * Get buffer statistics
+     *
+     * @returns Buffer statistics
+     */
+    getBufferStats(): {
+        bufferCount: number;
+        totalEvents: number;
+        avgEventsPerBuffer: number;
+        oldestBuffer: number | null;
+        newestBuffer: number | null;
+    };
+    /**
+     * Shutdown transport manager
+     *
+     * Disconnects all adapters and shuts down SSE transport.
+     * Closes all client connections and releases resources.
+     */
+    shutdown(): void;
+}
+//# sourceMappingURL=transport-manager.d.ts.map

package/dist/execution/transport/transport-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport-manager.d.ts","sourceRoot":"","sources":["../../../src/execution/transport/transport-manager.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AACnE,OAAO,KAAK,EACV,eAAe,EACf,gBAAgB,EAChB,aAAa,EACb,gBAAgB,EAChB,iBAAiB,EACjB,kBAAkB,EAClB,iBAAiB,EACjB,gBAAgB,EAChB,mBAAmB,EACnB,qBAAqB,EACrB,uBAAuB,EACvB,mBAAmB,EACnB,eAAe,EACf,kBAAkB,EAClB,WAAW,EACZ,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAGlD;;GAEG;AACH,MAAM,MAAM,SAAS,GACjB,eAAe,GACf,gBAAgB,GAChB,aAAa,GACb,gBAAgB,GAChB,iBAAiB,GACjB,kBAAkB,GAClB,iBAAiB,GACjB,gBAAgB,GAChB,mBAAmB,GACnB,qBAAqB,GACrB,uBAAuB,GACvB,mBAAmB,GACnB,eAAe,GACf,kBAAkB,GAClB,WAAW,CAAC;AAEhB;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,YAAY,CAAe;IACnC,OAAO,CAAC,WAAW,CAAc;IACjC,OAAO,CAAC,gBAAgB,CACZ;IACZ,OAAO,CAAC,aAAa,CAA+B;IAEpD;;;;OAIG;;IAcH;;;;;;;;;;;;;;;OAeG;IACH,cAAc,CAAC,OAAO,EAAE,gBAAgB,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI;IAmB/D;;;;;;;OAOG;IACH,iBAAiB,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO;IAWrD;;;;;;;;;;;;;;;OAeG;IACH,SAAS,CAAC,KAAK,EAAE,SAAS,GAAG,MAAM;IAOnC;;;;;;;;;;;;;;;;OAgBG;IACH,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,GAAG,MAAM;IAQvD;;;;;;;;;;;;;;;;;OAiBG;IACH,eAAe,IAAI,YAAY;IAI/B;;;;OAIG;IACH,eAAe,IAAI,MAAM;IAIzB;;;;;;;;;;;;;;;;;OAiBG;IACH,iBAAiB,CAAC,KAAK,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM;IAItD;;;;;OAKG;IACH,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;IAIzC;;;;OAIG;IACH,cAAc;;;;;;;IAId;;;;;OAKG;IACH,QAAQ,IAAI,IAAI;CAkBjB"}

package/dist/execution/workflow/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Workflow Layer Exports
+ *
+ * Layer 4: Task Execution Layer - Workflow Orchestration & State Management
+ *
+ * @module execution/workflow
+ */
+export type { WorkflowDefinition, WorkflowStep, WorkflowExecution, WorkflowStatus, WorkflowCheckpoint, WorkflowResult, StepStatus, WorkflowStartHandler, WorkflowCompleteHandler, WorkflowFailedHandler, StepStartHandler, StepCompleteHandler, StepFailedHandler, WorkflowCheckpointHandler, WorkflowResumeHandler, WorkflowPauseHandler, WorkflowCancelHandler, } from './types.js';
+export type { IWorkflowOrchestrator, IWorkflowStorage } from './orchestrator.js';
+export { generateId, renderTemplate, extractValue, mergeContext, evaluateCondition, createContext, } from './utils.js';
+export { LinearOrchestrator } from './linear-orchestrator.js';
+export { InMemoryWorkflowStorage } from './memory-storage.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/execution/workflow/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/execution/workflow/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,YAAY,EACV,kBAAkB,EAClB,YAAY,EACZ,iBAAiB,EACjB,cAAc,EACd,kBAAkB,EAClB,cAAc,EACd,UAAU,EACV,oBAAoB,EACpB,uBAAuB,EACvB,qBAAqB,EACrB,gBAAgB,EAChB,mBAAmB,EACnB,iBAAiB,EACjB,yBAAyB,EACzB,qBAAqB,EACrB,oBAAoB,EACpB,qBAAqB,GACtB,MAAM,YAAY,CAAC;AAGpB,YAAY,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAGjF,OAAO,EACL,UAAU,EACV,cAAc,EACd,YAAY,EACZ,YAAY,EACZ,iBAAiB,EACjB,aAAa,GACd,MAAM,YAAY,CAAC;AAGpB,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAC9D,OAAO,EAAE,uBAAuB,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/execution/workflow/linear-orchestrator.d.ts

@@ -0,0 +1,216 @@
+/**
+ * Linear Workflow Orchestrator Implementation
+ *
+ * Executes workflow steps sequentially with state management and checkpointing.
+ *
+ * @module execution/workflow/linear-orchestrator
+ */
+import type { IWorkflowOrchestrator, IWorkflowStorage } from "./orchestrator.js";
+import type { IResilientExecutor } from "../resilience/executor.js";
+import type { WorkflowDefinition, WorkflowExecution, WorkflowCheckpoint, StepStatus, WorkflowStartHandler, WorkflowCompleteHandler, WorkflowFailedHandler, StepStartHandler, StepCompleteHandler, StepFailedHandler, WorkflowCheckpointHandler, WorkflowResumeHandler, WorkflowPauseHandler, WorkflowCancelHandler } from "./types.js";
+import type { AgUiEventAdapter } from "../output/ag-ui-adapter.js";
+import type { ExecutionLifecycleService } from "../../services/execution-lifecycle.js";
+/**
+ * LinearOrchestrator - Sequential workflow execution with state management
+ *
+ * Implements the IWorkflowOrchestrator interface to provide:
+ * - Sequential step execution
+ * - State persistence via checkpoints
+ * - Crash recovery and resumption
+ * - Event-driven monitoring
+ */
+export declare class LinearOrchestrator implements IWorkflowOrchestrator {
+    private _executions;
+    private _cleanedUpExecutions;
+    private _storage?;
+    private _executor;
+    private _agUiAdapter?;
+    private _lifecycleService?;
+    private _workflowStartHandlers;
+    private _workflowCompleteHandlers;
+    private _workflowFailedHandlers;
+    private _stepStartHandlers;
+    private _stepCompleteHandlers;
+    private _stepFailedHandlers;
+    private _checkpointHandlers;
+    private _resumeHandlers;
+    private _pauseHandlers;
+    private _cancelHandlers;
+    /**
+     * Create a new LinearOrchestrator
+     *
+     * @param executor - Resilient executor for running tasks
+     * @param storage - Optional storage for checkpoints
+     * @param agUiAdapter - Optional AG-UI event adapter for real-time event streaming
+     * @param lifecycleService - Optional execution lifecycle service for worktree management
+     */
+    constructor(executor: IResilientExecutor, storage?: IWorkflowStorage, agUiAdapter?: AgUiEventAdapter, lifecycleService?: ExecutionLifecycleService);
+    /**
+     * Start a new workflow execution
+     *
+     * @param workflow - Workflow definition to execute
+     * @param workDir - Working directory for task execution
+     * @param options - Execution options (executionId is required)
+     * @returns Promise resolving to execution ID
+     */
+    startWorkflow(workflow: WorkflowDefinition, workDir: string, options: {
+        executionId: string;
+        checkpointInterval?: number;
+        initialContext?: Record<string, any>;
+    }): Promise<string>;
+    /**
+     * Resume a workflow from a checkpoint
+     *
+     * @param executionId - Execution ID to resume
+     * @param options - Resume options
+     * @returns Promise resolving to execution ID
+     */
+    resumeWorkflow(executionId: string, options?: {
+        checkpointInterval?: number;
+    }): Promise<string>;
+    /**
+     * Pause a running workflow
+     *
+     * @param executionId - Execution ID to pause
+     */
+    pauseWorkflow(executionId: string): Promise<void>;
+    /**
+     * Cancel a running workflow
+     *
+     * @param executionId - Execution ID to cancel
+     */
+    cancelWorkflow(executionId: string): Promise<void>;
+    /**
+     * Get current execution state
+     *
+     * @param executionId - Execution ID to query
+     * @returns Execution state or null if not found
+     */
+    getExecution(executionId: string): WorkflowExecution | null;
+    /**
+     * Get status of a specific step
+     *
+     * @param executionId - Execution ID
+     * @param stepId - Step ID to query
+     * @returns Step status or null if not found
+     */
+    getStepStatus(executionId: string, stepId: string): StepStatus | null;
+    /**
+     * Wait for workflow to complete
+     *
+     * @param executionId - Execution ID to wait for
+     * @returns Promise resolving to workflow execution
+     */
+    waitForWorkflow(executionId: string): Promise<WorkflowExecution>;
+    /**
+     * List all checkpoints for a workflow
+     *
+     * @param workflowId - Optional workflow ID to filter by
+     * @returns Promise resolving to list of checkpoints
+     */
+    listCheckpoints(workflowId?: string): Promise<WorkflowCheckpoint[]>;
+    /**
+     * Register handler for workflow start events
+     */
+    onWorkflowStart(handler: WorkflowStartHandler): void;
+    /**
+     * Register handler for workflow completion events
+     */
+    onWorkflowComplete(handler: WorkflowCompleteHandler): void;
+    /**
+     * Register handler for workflow failure events
+     */
+    onWorkflowFailed(handler: WorkflowFailedHandler): void;
+    /**
+     * Register handler for step start events
+     */
+    onStepStart(handler: StepStartHandler): void;
+    /**
+     * Register handler for step completion events
+     */
+    onStepComplete(handler: StepCompleteHandler): void;
+    /**
+     * Register handler for step failure events
+     */
+    onStepFailed(handler: StepFailedHandler): void;
+    /**
+     * Register handler for checkpoint events
+     */
+    onCheckpoint(handler: WorkflowCheckpointHandler): void;
+    /**
+     * Register handler for resume events
+     */
+    onResume(handler: WorkflowResumeHandler): void;
+    /**
+     * Register handler for pause events
+     */
+    onPause(handler: WorkflowPauseHandler): void;
+    /**
+     * Register handler for cancel events
+     */
+    onCancel(handler: WorkflowCancelHandler): void;
+    /**
+     * Execute workflow (main execution loop)
+     *
+     * @param workflow - Workflow definition
+     * @param execution - Workflow execution state
+     * @param workDir - Working directory for task execution
+     * @param checkpointInterval - Optional checkpoint interval (in steps)
+     * @returns Promise that resolves when workflow completes
+     * @private
+     */
+    private _executeWorkflow;
+    /**
+     * Save checkpoint to storage
+     *
+     * @param execution - Workflow execution to checkpoint
+     * @private
+     */
+    private _saveCheckpoint;
+    /**
+     * Clean up execution resources (worktree)
+     * Ensures cleanup is called only once per execution
+     *
+     * @param execution - Workflow execution to cleanup
+     * @private
+     */
+    private _cleanupExecution;
+    /**
+     * Execute a single workflow step
+     *
+     * @param step - Workflow step to execute
+     * @param execution - Current workflow execution state
+     * @param workDir - Working directory for task execution
+     * @returns Promise resolving to execution result
+     * @private
+     */
+    private _executeStep;
+    /**
+     * Apply output mapping from step result to workflow context
+     *
+     * @param step - Workflow step with output mapping
+     * @param result - Execution result from step
+     * @param context - Workflow context to update
+     * @private
+     */
+    private _applyOutputMapping;
+    /**
+     * Check if all step dependencies are met
+     *
+     * @param step - Workflow step to check
+     * @param execution - Current workflow execution state
+     * @returns True if all dependencies are met, false otherwise
+     * @private
+     */
+    private _areDependenciesMet;
+    /**
+     * Evaluate a step condition
+     *
+     * @param step - Workflow step with condition
+     * @param context - Workflow context
+     * @returns True if condition evaluates to true or no condition exists
+     * @private
+     */
+    private _shouldExecuteStep;
+}
+//# sourceMappingURL=linear-orchestrator.d.ts.map

package/dist/execution/workflow/linear-orchestrator.d.ts.map

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

package/dist/execution/workflow/memory-storage.d.ts

@@ -0,0 +1,54 @@
+/**
+ * In-Memory Workflow Storage Implementation
+ *
+ * Simple in-memory implementation of IWorkflowStorage for testing and development.
+ *
+ * @module execution/workflow/memory-storage
+ */
+import type { IWorkflowStorage } from './orchestrator.js';
+import type { WorkflowCheckpoint } from './types.js';
+/**
+ * InMemoryWorkflowStorage - In-memory checkpoint storage
+ *
+ * Simple implementation that stores checkpoints in a Map.
+ * Suitable for testing and single-process workflows.
+ * Not suitable for production use with multiple processes.
+ */
+export declare class InMemoryWorkflowStorage implements IWorkflowStorage {
+    _checkpoints: Map<string, WorkflowCheckpoint>;
+    /**
+     * Save a checkpoint to memory
+     *
+     * @param checkpoint - Checkpoint to save
+     */
+    saveCheckpoint(checkpoint: WorkflowCheckpoint): Promise<void>;
+    /**
+     * Load a checkpoint from memory
+     *
+     * @param executionId - Execution ID to load
+     * @returns Checkpoint or null if not found
+     */
+    loadCheckpoint(executionId: string): Promise<WorkflowCheckpoint | null>;
+    /**
+     * List all checkpoints, optionally filtered by workflow ID
+     *
+     * @param workflowId - Optional workflow ID to filter by
+     * @returns Array of checkpoints
+     */
+    listCheckpoints(workflowId?: string): Promise<WorkflowCheckpoint[]>;
+    /**
+     * Delete a checkpoint from memory
+     *
+     * @param executionId - Execution ID to delete
+     */
+    deleteCheckpoint(executionId: string): Promise<void>;
+    /**
+     * Clear all checkpoints (useful for testing)
+     */
+    clear(): void;
+    /**
+     * Get the number of stored checkpoints (useful for testing)
+     */
+    size(): number;
+}
+//# sourceMappingURL=memory-storage.d.ts.map

package/dist/execution/workflow/memory-storage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-storage.d.ts","sourceRoot":"","sources":["../../../src/execution/workflow/memory-storage.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAC1D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAErD;;;;;;GAMG;AACH,qBAAa,uBAAwB,YAAW,gBAAgB;IACvD,YAAY,kCAAyC;IAE5D;;;;OAIG;IACG,cAAc,CAAC,UAAU,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC;IAInE;;;;;OAKG;IACG,cAAc,CAClB,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC;IAIrC;;;;;OAKG;IACG,eAAe,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,EAAE,CAAC;IAQzE;;;;OAIG;IACG,gBAAgB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI1D;;OAEG;IACH,KAAK,IAAI,IAAI;IAIb;;OAEG;IACH,IAAI,IAAI,MAAM;CAGf"}

package/dist/execution/workflow/orchestrator.d.ts

@@ -0,0 +1,158 @@
+/**
+ * Workflow Orchestrator Interface
+ *
+ * Defines the contract for workflow orchestration implementations.
+ *
+ * @module execution/workflow/orchestrator
+ */
+import type { WorkflowDefinition, WorkflowExecution, WorkflowCheckpoint, StepStatus, WorkflowStartHandler, WorkflowCompleteHandler, WorkflowFailedHandler, StepStartHandler, StepCompleteHandler, StepFailedHandler, WorkflowCheckpointHandler, WorkflowResumeHandler, WorkflowPauseHandler, WorkflowCancelHandler } from './types.js';
+/**
+ * IWorkflowOrchestrator - Core interface for workflow orchestration
+ *
+ * Implementations of this interface coordinate the execution of multi-step
+ * workflows, managing state, checkpointing, and resumption.
+ */
+export interface IWorkflowOrchestrator {
+    /**
+     * Start a new workflow execution
+     *
+     * @param workflow - Workflow definition to execute
+     * @param workDir - Working directory for task execution
+     * @param options - Execution options
+     * @returns Promise resolving to execution ID
+     */
+    startWorkflow(workflow: WorkflowDefinition, workDir: string, options?: {
+        checkpointInterval?: number;
+        initialContext?: Record<string, any>;
+    }): Promise<string>;
+    /**
+     * Resume a workflow from a checkpoint
+     *
+     * @param executionId - Execution ID to resume
+     * @param options - Resume options
+     * @returns Promise resolving to execution ID
+     */
+    resumeWorkflow(executionId: string, options?: {
+        checkpointInterval?: number;
+    }): Promise<string>;
+    /**
+     * Pause a running workflow
+     *
+     * @param executionId - Execution ID to pause
+     * @returns Promise that resolves when paused
+     */
+    pauseWorkflow(executionId: string): Promise<void>;
+    /**
+     * Cancel a running workflow
+     *
+     * @param executionId - Execution ID to cancel
+     * @returns Promise that resolves when cancelled
+     */
+    cancelWorkflow(executionId: string): Promise<void>;
+    /**
+     * Get current execution state
+     *
+     * @param executionId - Execution ID to query
+     * @returns Execution state or null if not found
+     */
+    getExecution(executionId: string): WorkflowExecution | null;
+    /**
+     * Get status of a specific step
+     *
+     * @param executionId - Execution ID
+     * @param stepId - Step ID to query
+     * @returns Step status or null if not found
+     */
+    getStepStatus(executionId: string, stepId: string): StepStatus | null;
+    /**
+     * Wait for workflow to complete
+     *
+     * @param executionId - Execution ID to wait for
+     * @returns Promise resolving to workflow result
+     */
+    waitForWorkflow(executionId: string): Promise<WorkflowExecution>;
+    /**
+     * List all checkpoints for a workflow
+     *
+     * @param workflowId - Optional workflow ID to filter by
+     * @returns Promise resolving to list of checkpoints
+     */
+    listCheckpoints(workflowId?: string): Promise<WorkflowCheckpoint[]>;
+    /**
+     * Register handler for workflow start events
+     */
+    onWorkflowStart(handler: WorkflowStartHandler): void;
+    /**
+     * Register handler for workflow completion events
+     */
+    onWorkflowComplete(handler: WorkflowCompleteHandler): void;
+    /**
+     * Register handler for workflow failure events
+     */
+    onWorkflowFailed(handler: WorkflowFailedHandler): void;
+    /**
+     * Register handler for step start events
+     */
+    onStepStart(handler: StepStartHandler): void;
+    /**
+     * Register handler for step completion events
+     */
+    onStepComplete(handler: StepCompleteHandler): void;
+    /**
+     * Register handler for step failure events
+     */
+    onStepFailed(handler: StepFailedHandler): void;
+    /**
+     * Register handler for checkpoint events
+     */
+    onCheckpoint(handler: WorkflowCheckpointHandler): void;
+    /**
+     * Register handler for resume events
+     */
+    onResume(handler: WorkflowResumeHandler): void;
+    /**
+     * Register handler for pause events
+     */
+    onPause(handler: WorkflowPauseHandler): void;
+    /**
+     * Register handler for cancel events
+     */
+    onCancel(handler: WorkflowCancelHandler): void;
+}
+/**
+ * IWorkflowStorage - Interface for workflow checkpoint storage
+ *
+ * Implementations provide persistence for workflow checkpoints,
+ * enabling crash recovery and workflow resumption.
+ */
+export interface IWorkflowStorage {
+    /**
+     * Save a workflow checkpoint
+     *
+     * @param checkpoint - Checkpoint to save
+     * @returns Promise that resolves when saved
+     */
+    saveCheckpoint(checkpoint: WorkflowCheckpoint): Promise<void>;
+    /**
+     * Load a workflow checkpoint
+     *
+     * @param executionId - Execution ID to load
+     * @returns Promise resolving to checkpoint or null if not found
+     */
+    loadCheckpoint(executionId: string): Promise<WorkflowCheckpoint | null>;
+    /**
+     * List all checkpoints for a workflow
+     *
+     * @param workflowId - Optional workflow ID to filter by
+     * @returns Promise resolving to list of checkpoints
+     */
+    listCheckpoints(workflowId?: string): Promise<WorkflowCheckpoint[]>;
+    /**
+     * Delete a checkpoint
+     *
+     * @param executionId - Execution ID to delete
+     * @returns Promise that resolves when deleted
+     */
+    deleteCheckpoint(executionId: string): Promise<void>;
+}
+//# sourceMappingURL=orchestrator.d.ts.map

package/dist/execution/workflow/orchestrator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"orchestrator.d.ts","sourceRoot":"","sources":["../../../src/execution/workflow/orchestrator.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EACV,kBAAkB,EAClB,iBAAiB,EACjB,kBAAkB,EAClB,UAAU,EACV,oBAAoB,EACpB,uBAAuB,EACvB,qBAAqB,EACrB,gBAAgB,EAChB,mBAAmB,EACnB,iBAAiB,EACjB,yBAAyB,EACzB,qBAAqB,EACrB,oBAAoB,EACpB,qBAAqB,EACtB,MAAM,YAAY,CAAC;AAEpB;;;;;GAKG;AACH,MAAM,WAAW,qBAAqB;IACpC;;;;;;;OAOG;IACH,aAAa,CACX,QAAQ,EAAE,kBAAkB,EAC5B,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE;QACR,kBAAkB,CAAC,EAAE,MAAM,CAAC;QAC5B,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;KACtC,GACA,OAAO,CAAC,MAAM,CAAC,CAAC;IAEnB;;;;;;OAMG;IACH,cAAc,CACZ,WAAW,EAAE,MAAM,EACnB,OAAO,CAAC,EAAE;QACR,kBAAkB,CAAC,EAAE,MAAM,CAAC;KAC7B,GACA,OAAO,CAAC,MAAM,CAAC,CAAC;IAEnB;;;;;OAKG;IACH,aAAa,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAElD;;;;;OAKG;IACH,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEnD;;;;;OAKG;IACH,YAAY,CAAC,WAAW,EAAE,MAAM,GAAG,iBAAiB,GAAG,IAAI,CAAC;IAE5D;;;;;;OAMG;IACH,aAAa,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI,CAAC;IAEtE;;;;;OAKG;IACH,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC;IAEjE;;;;;OAKG;IACH,eAAe,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,EAAE,CAAC,CAAC;IAEpE;;OAEG;IACH,eAAe,CAAC,OAAO,EAAE,oBAAoB,GAAG,IAAI,CAAC;IAErD;;OAEG;IACH,kBAAkB,CAAC,OAAO,EAAE,uBAAuB,GAAG,IAAI,CAAC;IAE3D;;OAEG;IACH,gBAAgB,CAAC,OAAO,EAAE,qBAAqB,GAAG,IAAI,CAAC;IAEvD;;OAEG;IACH,WAAW,CAAC,OAAO,EAAE,gBAAgB,GAAG,IAAI,CAAC;IAE7C;;OAEG;IACH,cAAc,CAAC,OAAO,EAAE,mBAAmB,GAAG,IAAI,CAAC;IAEnD;;OAEG;IACH,YAAY,CAAC,OAAO,EAAE,iBAAiB,GAAG,IAAI,CAAC;IAE/C;;OAEG;IACH,YAAY,CAAC,OAAO,EAAE,yBAAyB,GAAG,IAAI,CAAC;IAEvD;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,qBAAqB,GAAG,IAAI,CAAC;IAE/C;;OAEG;IACH,OAAO,CAAC,OAAO,EAAE,oBAAoB,GAAG,IAAI,CAAC;IAE7C;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,qBAAqB,GAAG,IAAI,CAAC;CAChD;AAED;;;;;GAKG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;;;;OAKG;IACH,cAAc,CAAC,UAAU,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE9D;;;;;OAKG;IACH,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC,CAAC;IAExE;;;;;OAKG;IACH,eAAe,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,EAAE,CAAC,CAAC;IAEpE;;;;;OAKG;IACH,gBAAgB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACtD"}