@defai.digital/workflow-engine 13.0.3

package/dist/runner.js

@@ -0,0 +1,205 @@
+import { DEFAULT_RETRY_POLICY } from '@defai.digital/contracts';
+import { WorkflowErrorCodes } from './types.js';
+import { prepareWorkflow, deepFreezeStepResult } from './validation.js';
+import { defaultStepExecutor, createStepError, normalizeError } from './executor.js';
+import { mergeRetryPolicy, shouldRetry, calculateBackoff, sleep, } from './retry.js';
+/**
+ * Workflow runner that executes workflows following contract invariants
+ *
+ * Invariants enforced:
+ * - INV-WF-001: Step execution order matches definition exactly
+ * - INV-WF-002: Retries are scoped to the current step only
+ * - INV-WF-003: Schema strictness (via validation)
+ * - INV-WF-004: Step ID uniqueness (via validation)
+ * - INV-WF-005: Immutable definition (via freezing)
+ */
+export class WorkflowRunner {
+    config;
+    constructor(config = {}) {
+        this.config = {
+            stepExecutor: config.stepExecutor ?? defaultStepExecutor,
+            defaultRetryPolicy: config.defaultRetryPolicy ?? DEFAULT_RETRY_POLICY,
+        };
+        if (config.onStepStart !== undefined) {
+            this.config.onStepStart = config.onStepStart;
+        }
+        if (config.onStepComplete !== undefined) {
+            this.config.onStepComplete = config.onStepComplete;
+        }
+    }
+    /**
+     * Executes a workflow
+     * INV-WF-001: Steps are executed in definition order
+     */
+    async run(workflowData, input) {
+        const startTime = Date.now();
+        // Validate and prepare workflow (INV-WF-003, INV-WF-004, INV-WF-005)
+        let prepared;
+        try {
+            prepared = prepareWorkflow(workflowData);
+        }
+        catch (error) {
+            return this.createErrorResult('unknown', startTime, [], normalizeError(error));
+        }
+        const { workflow } = prepared;
+        const stepResults = [];
+        // INV-WF-001: Execute steps in exact definition order
+        for (let i = 0; i < workflow.steps.length; i++) {
+            const step = workflow.steps[i];
+            if (step === undefined) {
+                continue;
+            }
+            const context = {
+                workflowId: workflow.workflowId,
+                stepIndex: i,
+                previousResults: [...stepResults],
+                input: i === 0 ? input : stepResults[i - 1]?.output,
+            };
+            // Notify step start
+            this.config.onStepStart?.(step, context);
+            // Execute step with retry logic (INV-WF-002)
+            const result = await this.executeStepWithRetry(step, context);
+            // Freeze step result to ensure immutability
+            const frozenResult = deepFreezeStepResult(result);
+            stepResults.push(frozenResult);
+            // Notify step complete (pass frozen result for consistency)
+            this.config.onStepComplete?.(step, frozenResult);
+            // Stop on failure
+            if (!frozenResult.success) {
+                const workflowError = {
+                    code: WorkflowErrorCodes.STEP_EXECUTION_FAILED,
+                    message: `Step ${step.stepId} failed: ${frozenResult.error?.message ?? 'Unknown error'}`,
+                    failedStepId: step.stepId,
+                };
+                if (frozenResult.error?.details !== undefined) {
+                    workflowError.details = frozenResult.error.details;
+                }
+                return {
+                    workflowId: workflow.workflowId,
+                    success: false,
+                    stepResults,
+                    error: workflowError,
+                    totalDurationMs: Date.now() - startTime,
+                };
+            }
+        }
+        // All steps succeeded
+        const lastResult = stepResults[stepResults.length - 1];
+        return {
+            workflowId: workflow.workflowId,
+            success: true,
+            stepResults,
+            output: lastResult?.output,
+            totalDurationMs: Date.now() - startTime,
+        };
+    }
+    /**
+     * Executes a single step with retry logic
+     * INV-WF-002: Retries are scoped to current step only
+     */
+    async executeStepWithRetry(step, context) {
+        const retryPolicy = mergeRetryPolicy(step.retryPolicy ?? this.config.defaultRetryPolicy);
+        let lastResult = null;
+        let attempt = 0;
+        while (attempt < retryPolicy.maxAttempts) {
+            attempt++;
+            try {
+                const result = await this.executeStepWithTimeout(step, context);
+                result.retryCount = attempt - 1;
+                if (result.success) {
+                    return result;
+                }
+                lastResult = result;
+                // Check if we should retry
+                if (result.error !== undefined &&
+                    shouldRetry(result.error, retryPolicy, attempt)) {
+                    const backoffMs = calculateBackoff(retryPolicy, attempt);
+                    await sleep(backoffMs);
+                    continue;
+                }
+                // Not retryable, return the result
+                return result;
+            }
+            catch (error) {
+                const stepError = normalizeError(error);
+                lastResult = {
+                    stepId: step.stepId,
+                    success: false,
+                    error: stepError,
+                    durationMs: 0,
+                    retryCount: attempt - 1,
+                };
+                if (shouldRetry(stepError, retryPolicy, attempt)) {
+                    const backoffMs = calculateBackoff(retryPolicy, attempt);
+                    await sleep(backoffMs);
+                    continue;
+                }
+                return lastResult;
+            }
+        }
+        // Max retries exceeded
+        return lastResult ?? {
+            stepId: step.stepId,
+            success: false,
+            error: createStepError(WorkflowErrorCodes.MAX_RETRIES_EXCEEDED, `Max retries (${String(retryPolicy.maxAttempts)}) exceeded for step ${step.stepId}`, false),
+            durationMs: 0,
+            retryCount: attempt - 1,
+        };
+    }
+    /**
+     * Executes a step with optional timeout
+     */
+    async executeStepWithTimeout(step, context) {
+        const timeout = step.timeout;
+        if (timeout === undefined) {
+            return this.config.stepExecutor(step, context);
+        }
+        // Execute with timeout (using cancellable timeout to prevent timer leaks)
+        let timeoutId;
+        const timeoutPromise = new Promise((_, reject) => {
+            timeoutId = setTimeout(() => {
+                const stepError = createStepError(WorkflowErrorCodes.STEP_TIMEOUT, `Step ${step.stepId} timed out after ${String(timeout)}ms`, true);
+                reject(new Error(stepError.message));
+            }, timeout);
+        });
+        try {
+            const result = await Promise.race([
+                this.config.stepExecutor(step, context),
+                timeoutPromise,
+            ]);
+            return result;
+        }
+        finally {
+            // Always clean up timeout to prevent timer leaks
+            if (timeoutId !== undefined) {
+                clearTimeout(timeoutId);
+            }
+        }
+    }
+    /**
+     * Creates an error result
+     */
+    createErrorResult(workflowId, startTime, stepResults, error) {
+        const workflowError = {
+            code: error.code,
+            message: error.message,
+        };
+        if (error.details !== undefined) {
+            workflowError.details = error.details;
+        }
+        return {
+            workflowId,
+            success: false,
+            stepResults,
+            error: workflowError,
+            totalDurationMs: Date.now() - startTime,
+        };
+    }
+}
+/**
+ * Creates a workflow runner with the given configuration
+ */
+export function createWorkflowRunner(config) {
+    return new WorkflowRunner(config);
+}
+//# sourceMappingURL=runner.js.map

package/dist/runner.js.map

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

package/dist/step-executor-factory.d.ts

@@ -0,0 +1,179 @@
+/**
+ * Step Executor Factory
+ *
+ * Creates real step executors for workflow execution using injected dependencies.
+ * Eliminates placeholder implementations by bridging to actual LLM providers and tools.
+ *
+ * Invariants:
+ * - INV-WF-001: Steps execute in defined order
+ * - INV-TOOL-001: Tool execution validates inputs
+ * - INV-TOOL-002: Tool results are immutable
+ */
+import type { StepExecutor } from './types.js';
+/**
+ * Prompt executor interface (minimal for workflow-engine)
+ * Matches the interface from agent-domain but doesn't require importing it
+ */
+export interface PromptExecutorLike {
+    execute(request: {
+        prompt: string;
+        systemPrompt?: string;
+        provider?: string;
+        model?: string;
+        maxTokens?: number;
+        temperature?: number;
+        timeout?: number;
+    }): Promise<{
+        success: boolean;
+        content?: string;
+        error?: string;
+        errorCode?: string;
+        provider?: string;
+        model?: string;
+        latencyMs: number;
+        usage?: {
+            inputTokens: number;
+            outputTokens: number;
+            totalTokens: number;
+        };
+    }>;
+    getDefaultProvider(): string;
+}
+/**
+ * Tool executor interface (minimal for workflow-engine)
+ * Matches the interface from agent-domain but doesn't require importing it
+ */
+export interface ToolExecutorLike {
+    execute(toolName: string, args: Record<string, unknown>): Promise<{
+        success: boolean;
+        output?: unknown;
+        error?: string;
+        errorCode?: string;
+        retryable?: boolean;
+        durationMs?: number;
+    }>;
+    isToolAvailable(toolName: string): boolean;
+    getAvailableTools(): string[];
+}
+/**
+ * Discussion executor interface (minimal for workflow-engine)
+ * Matches the interface from discussion-domain but doesn't require importing it
+ */
+export interface DiscussionExecutorLike {
+    execute(config: DiscussStepConfigLike, options?: {
+        abortSignal?: AbortSignal;
+        onProgress?: (event: DiscussionProgressEventLike) => void;
+    }): Promise<DiscussionResultLike>;
+}
+/**
+ * Minimal DiscussStepConfig for workflow-engine (avoids importing full schema)
+ */
+export interface DiscussStepConfigLike {
+    pattern: string;
+    rounds: number;
+    providers: string[];
+    prompt: string;
+    providerPrompts?: Record<string, string> | undefined;
+    roles?: Record<string, string> | undefined;
+    consensus: {
+        method: string;
+        threshold?: number | undefined;
+        synthesizer?: string | undefined;
+        includeDissent?: boolean | undefined;
+    };
+    providerTimeout: number;
+    continueOnProviderFailure: boolean;
+    minProviders: number;
+    temperature: number;
+    context?: string | undefined;
+    verbose: boolean;
+}
+/**
+ * Discussion progress event
+ */
+export interface DiscussionProgressEventLike {
+    type: string;
+    round?: number | undefined;
+    provider?: string | undefined;
+    message?: string | undefined;
+    timestamp: string;
+}
+/**
+ * Discussion result
+ */
+export interface DiscussionResultLike {
+    success: boolean;
+    pattern: string;
+    topic: string;
+    participatingProviders: string[];
+    failedProviders: string[];
+    rounds: {
+        roundNumber: number;
+        responses: {
+            provider: string;
+            content: string;
+            round: number;
+            role?: string | undefined;
+            confidence?: number | undefined;
+            vote?: string | undefined;
+            timestamp: string;
+            durationMs: number;
+            tokenCount?: number | undefined;
+            truncated?: boolean | undefined;
+            error?: string | undefined;
+        }[];
+        durationMs: number;
+    }[];
+    synthesis: string;
+    consensus: {
+        method: string;
+        winner?: string | undefined;
+        votes?: Record<string, number> | undefined;
+        confidence?: number | undefined;
+        dissent?: string[] | undefined;
+    };
+    totalDurationMs: number;
+    metadata: {
+        startedAt: string;
+        completedAt: string;
+        traceId?: string | undefined;
+        sessionId?: string | undefined;
+    };
+    error?: {
+        code: string;
+        message: string;
+    } | undefined;
+}
+/**
+ * Configuration for creating a real step executor
+ */
+export interface RealStepExecutorConfig {
+    /**
+     * Prompt executor for LLM calls
+     */
+    promptExecutor: PromptExecutorLike;
+    /**
+     * Tool executor for tool calls (optional)
+     */
+    toolExecutor?: ToolExecutorLike;
+    /**
+     * Discussion executor for multi-model discussions (optional)
+     */
+    discussionExecutor?: DiscussionExecutorLike;
+    /**
+     * Default provider for prompts
+     */
+    defaultProvider?: string;
+    /**
+     * Default model for prompts
+     */
+    defaultModel?: string;
+}
+/**
+ * Creates a real step executor with actual prompt and tool execution
+ *
+ * @param config - Configuration with prompt and tool executors
+ * @returns A step executor function
+ */
+export declare function createRealStepExecutor(config: RealStepExecutorConfig): StepExecutor;
+//# sourceMappingURL=step-executor-factory.d.ts.map

package/dist/step-executor-factory.d.ts.map

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