@cogitator-ai/workflows 0.1.0

package/dist/saga/retry.js

@@ -0,0 +1,222 @@
+/**
+ * Retry module with exponential backoff and jitter
+ *
+ * Features:
+ * - Configurable backoff strategies (constant, linear, exponential)
+ * - Jitter to prevent thundering herd
+ * - Retryable error detection
+ * - Per-attempt hooks for logging/metrics
+ */
+const DEFAULT_MAX_RETRIES = 3;
+const DEFAULT_INITIAL_DELAY = 1000;
+const DEFAULT_MAX_DELAY = 30000;
+const DEFAULT_BACKOFF = 'exponential';
+const DEFAULT_MULTIPLIER = 2;
+const DEFAULT_JITTER = 0.1;
+/**
+ * Default retryable error checker - retries on network/timeout errors
+ */
+function defaultIsRetryable(error) {
+    const retryableErrors = [
+        'ECONNRESET',
+        'ECONNREFUSED',
+        'ETIMEDOUT',
+        'ENOTFOUND',
+        'ENETUNREACH',
+        'EAI_AGAIN',
+        'EPIPE',
+    ];
+    const retryableMessages = [
+        'timeout',
+        'network',
+        'connection',
+        'socket',
+        'ETIMEDOUT',
+        'rate limit',
+        '429',
+        '500',
+        '502',
+        '503',
+        '504',
+    ];
+    const errorCode = error.code;
+    if (errorCode && retryableErrors.includes(errorCode)) {
+        return true;
+    }
+    const message = error.message.toLowerCase();
+    return retryableMessages.some((m) => message.includes(m.toLowerCase()));
+}
+/**
+ * Calculate delay with jitter
+ */
+function calculateDelay(attempt, config) {
+    let baseDelay;
+    switch (config.backoff) {
+        case 'constant':
+            baseDelay = config.initialDelay;
+            break;
+        case 'linear':
+            baseDelay = config.initialDelay * attempt;
+            break;
+        case 'exponential':
+        default:
+            baseDelay = config.initialDelay * Math.pow(config.multiplier, attempt - 1);
+            break;
+    }
+    baseDelay = Math.min(baseDelay, config.maxDelay);
+    const jitterRange = baseDelay * config.jitter;
+    const jitter = (Math.random() * 2 - 1) * jitterRange;
+    return Math.max(0, Math.round(baseDelay + jitter));
+}
+/**
+ * Sleep for specified milliseconds
+ */
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+/**
+ * Execute function with retry logic
+ */
+export async function executeWithRetry(fn, options = {}) {
+    const maxRetries = options.maxRetries ?? DEFAULT_MAX_RETRIES;
+    const backoff = options.backoff ?? DEFAULT_BACKOFF;
+    const initialDelay = options.initialDelay ?? DEFAULT_INITIAL_DELAY;
+    const maxDelay = options.maxDelay ?? DEFAULT_MAX_DELAY;
+    const multiplier = options.multiplier ?? DEFAULT_MULTIPLIER;
+    const jitter = options.jitter ?? DEFAULT_JITTER;
+    const isRetryable = options.isRetryable ?? defaultIsRetryable;
+    const delays = [];
+    const startTime = Date.now();
+    let lastError;
+    for (let attempt = 1; attempt <= maxRetries + 1; attempt++) {
+        if (options.abortSignal?.aborted) {
+            return {
+                success: false,
+                error: new Error('Retry aborted'),
+                attempts: attempt - 1,
+                totalDuration: Date.now() - startTime,
+                delays,
+            };
+        }
+        const attemptStart = Date.now();
+        try {
+            const attemptInfo = {
+                attempt,
+                maxAttempts: maxRetries + 1,
+                delay: 0,
+                startTime: attemptStart,
+                duration: 0,
+            };
+            options.onAttempt?.(attemptInfo);
+            const result = await fn(attempt);
+            const duration = Date.now() - attemptStart;
+            options.onSuccess?.(result, { ...attemptInfo, duration });
+            return {
+                success: true,
+                result,
+                attempts: attempt,
+                totalDuration: Date.now() - startTime,
+                delays,
+            };
+        }
+        catch (error) {
+            lastError = error instanceof Error ? error : new Error(String(error));
+            const duration = Date.now() - attemptStart;
+            const canRetry = attempt <= maxRetries && isRetryable(lastError);
+            if (!canRetry) {
+                const attemptInfo = {
+                    attempt,
+                    maxAttempts: maxRetries + 1,
+                    delay: 0,
+                    error: lastError,
+                    startTime: attemptStart,
+                    duration,
+                };
+                options.onFailure?.(lastError, attemptInfo);
+                break;
+            }
+            const delay = calculateDelay(attempt, {
+                backoff,
+                initialDelay,
+                maxDelay,
+                multiplier,
+                jitter,
+            });
+            delays.push(delay);
+            const attemptInfo = {
+                attempt,
+                maxAttempts: maxRetries + 1,
+                delay,
+                error: lastError,
+                startTime: attemptStart,
+                duration,
+            };
+            options.onRetry?.(attemptInfo);
+            await sleep(delay);
+        }
+    }
+    return {
+        success: false,
+        error: lastError,
+        attempts: delays.length + 1,
+        totalDuration: Date.now() - startTime,
+        delays,
+    };
+}
+/**
+ * Create a retryable version of a function
+ */
+export function withRetry(fn, options = {}) {
+    return async (...args) => {
+        const result = await executeWithRetry(() => fn(...args), options);
+        if (!result.success) {
+            throw result.error ?? new Error('Retry failed');
+        }
+        return result.result;
+    };
+}
+/**
+ * Decorator for retryable class methods
+ */
+export function Retryable(options = {}) {
+    return function (_target, _propertyKey, descriptor) {
+        const originalMethod = descriptor.value;
+        descriptor.value = async function (...args) {
+            const result = await executeWithRetry(() => originalMethod.apply(this, args), options);
+            if (!result.success) {
+                throw result.error ?? new Error('Retry failed');
+            }
+            return result.result;
+        };
+        return descriptor;
+    };
+}
+/**
+ * Calculate total expected retry time (for timeout estimation)
+ */
+export function estimateRetryDuration(config = {}) {
+    const maxRetries = config.maxRetries ?? DEFAULT_MAX_RETRIES;
+    const backoff = config.backoff ?? DEFAULT_BACKOFF;
+    const initialDelay = config.initialDelay ?? DEFAULT_INITIAL_DELAY;
+    const maxDelay = config.maxDelay ?? DEFAULT_MAX_DELAY;
+    const multiplier = config.multiplier ?? DEFAULT_MULTIPLIER;
+    let total = 0;
+    for (let attempt = 1; attempt <= maxRetries; attempt++) {
+        let delay;
+        switch (backoff) {
+            case 'constant':
+                delay = initialDelay;
+                break;
+            case 'linear':
+                delay = initialDelay * attempt;
+                break;
+            case 'exponential':
+            default:
+                delay = initialDelay * Math.pow(multiplier, attempt - 1);
+                break;
+        }
+        total += Math.min(delay, maxDelay);
+    }
+    return total;
+}
+//# sourceMappingURL=retry.js.map

package/dist/saga/retry.js.map

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

package/dist/scheduler.d.ts

@@ -0,0 +1,37 @@
+/**
+ * WorkflowScheduler - Manages DAG execution order and parallel scheduling
+ */
+import type { Workflow, WorkflowState } from '@cogitator-ai/types';
+interface DependencyGraph {
+    dependencies: Map<string, Set<string>>;
+    dependents: Map<string, Set<string>>;
+}
+export declare class WorkflowScheduler {
+    /**
+     * Build dependency graph from workflow edges
+     */
+    buildDependencyGraph<S extends WorkflowState>(workflow: Workflow<S>): DependencyGraph;
+    /**
+     * Get nodes ready to execute (all dependencies completed)
+     */
+    getReadyNodes(graph: DependencyGraph, completed: Set<string>, pending: Set<string>): string[];
+    /**
+     * Get topological order of nodes (grouped by execution level)
+     * Returns array of arrays, where each inner array can be executed in parallel
+     */
+    getExecutionLevels<S extends WorkflowState>(workflow: Workflow<S>): string[][];
+    /**
+     * Find the next node(s) to execute based on current state and edge conditions
+     */
+    getNextNodes<S extends WorkflowState>(workflow: Workflow<S>, currentNode: string, state: S): string[];
+    /**
+     * Run multiple async tasks with concurrency limit
+     */
+    runWithConcurrency<T>(tasks: (() => Promise<T>)[], maxConcurrency: number): Promise<T[]>;
+    /**
+     * Simpler parallel execution with Promise.all and concurrency via chunking
+     */
+    runParallel<T>(tasks: (() => Promise<T>)[], maxConcurrency: number): Promise<T[]>;
+}
+export {};
+//# sourceMappingURL=scheduler.d.ts.map

package/dist/scheduler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scheduler.d.ts","sourceRoot":"","sources":["../src/scheduler.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EACV,QAAQ,EACR,aAAa,EACd,MAAM,qBAAqB,CAAC;AAE7B,UAAU,eAAe;IACvB,YAAY,EAAE,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC;IACvC,UAAU,EAAE,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC;CACtC;AAED,qBAAa,iBAAiB;IAC5B;;OAEG;IACH,oBAAoB,CAAC,CAAC,SAAS,aAAa,EAC1C,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC,GACpB,eAAe;IAwBlB;;OAEG;IACH,aAAa,CACX,KAAK,EAAE,eAAe,EACtB,SAAS,EAAE,GAAG,CAAC,MAAM,CAAC,EACtB,OAAO,EAAE,GAAG,CAAC,MAAM,CAAC,GACnB,MAAM,EAAE;IAuBX;;;OAGG;IACH,kBAAkB,CAAC,CAAC,SAAS,aAAa,EACxC,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC,GACpB,MAAM,EAAE,EAAE;IA0Bb;;OAEG;IACH,YAAY,CAAC,CAAC,SAAS,aAAa,EAClC,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC,EACrB,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,CAAC,GACP,MAAM,EAAE;IAgCX;;OAEG;IACG,kBAAkB,CAAC,CAAC,EACxB,KAAK,EAAE,CAAC,MAAM,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,EAC3B,cAAc,EAAE,MAAM,GACrB,OAAO,CAAC,CAAC,EAAE,CAAC;IAgCf;;OAEG;IACG,WAAW,CAAC,CAAC,EACjB,KAAK,EAAE,CAAC,MAAM,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,EAC3B,cAAc,EAAE,MAAM,GACrB,OAAO,CAAC,CAAC,EAAE,CAAC;CAWhB"}

package/dist/scheduler.js

@@ -0,0 +1,151 @@
+/**
+ * WorkflowScheduler - Manages DAG execution order and parallel scheduling
+ */
+export class WorkflowScheduler {
+    /**
+     * Build dependency graph from workflow edges
+     */
+    buildDependencyGraph(workflow) {
+        const dependencies = new Map();
+        const dependents = new Map();
+        for (const nodeName of workflow.nodes.keys()) {
+            dependencies.set(nodeName, new Set());
+            dependents.set(nodeName, new Set());
+        }
+        for (const edge of workflow.edges) {
+            if (edge.type === 'sequential') {
+                dependencies.get(edge.to)?.add(edge.from);
+                dependents.get(edge.from)?.add(edge.to);
+            }
+            else if (edge.type === 'parallel') {
+                for (const to of edge.to) {
+                    dependencies.get(to)?.add(edge.from);
+                    dependents.get(edge.from)?.add(to);
+                }
+            }
+        }
+        return { dependencies, dependents };
+    }
+    /**
+     * Get nodes ready to execute (all dependencies completed)
+     */
+    getReadyNodes(graph, completed, pending) {
+        const ready = [];
+        for (const nodeName of pending) {
+            const deps = graph.dependencies.get(nodeName);
+            if (!deps)
+                continue;
+            let allDepsCompleted = true;
+            for (const dep of deps) {
+                if (!completed.has(dep)) {
+                    allDepsCompleted = false;
+                    break;
+                }
+            }
+            if (allDepsCompleted) {
+                ready.push(nodeName);
+            }
+        }
+        return ready;
+    }
+    /**
+     * Get topological order of nodes (grouped by execution level)
+     * Returns array of arrays, where each inner array can be executed in parallel
+     */
+    getExecutionLevels(workflow) {
+        const graph = this.buildDependencyGraph(workflow);
+        const levels = [];
+        const completed = new Set();
+        const pending = new Set(workflow.nodes.keys());
+        while (pending.size > 0) {
+            const ready = this.getReadyNodes(graph, completed, pending);
+            if (ready.length === 0 && pending.size > 0) {
+                throw new Error(`Workflow has cycles or unreachable nodes: ${Array.from(pending).join(', ')}`);
+            }
+            levels.push(ready);
+            for (const node of ready) {
+                completed.add(node);
+                pending.delete(node);
+            }
+        }
+        return levels;
+    }
+    /**
+     * Find the next node(s) to execute based on current state and edge conditions
+     */
+    getNextNodes(workflow, currentNode, state) {
+        const nextNodes = [];
+        for (const edge of workflow.edges) {
+            if (edge.from !== currentNode)
+                continue;
+            if (edge.type === 'sequential') {
+                nextNodes.push(edge.to);
+            }
+            else if (edge.type === 'parallel') {
+                nextNodes.push(...edge.to);
+            }
+            else if (edge.type === 'conditional') {
+                const result = edge.condition(state);
+                const targets = Array.isArray(result) ? result : [result];
+                for (const target of targets) {
+                    if (edge.targets.includes(target)) {
+                        nextNodes.push(target);
+                    }
+                }
+            }
+            else if (edge.type === 'loop') {
+                const shouldLoop = edge.condition(state);
+                if (shouldLoop) {
+                    nextNodes.push(edge.back);
+                }
+                else {
+                    nextNodes.push(edge.exit);
+                }
+            }
+        }
+        return [...new Set(nextNodes)];
+    }
+    /**
+     * Run multiple async tasks with concurrency limit
+     */
+    async runWithConcurrency(tasks, maxConcurrency) {
+        const results = [];
+        const executing = [];
+        for (const task of tasks) {
+            const promise = task().then((result) => {
+                results.push(result);
+            });
+            executing.push(promise);
+            if (executing.length >= maxConcurrency) {
+                await Promise.race(executing);
+                const newExecuting = [];
+                for (const p of executing) {
+                    const pending = await Promise.race([
+                        p.then(() => false),
+                        Promise.resolve(true),
+                    ]);
+                    if (pending) {
+                        newExecuting.push(p);
+                    }
+                }
+                executing.length = 0;
+                executing.push(...newExecuting);
+            }
+        }
+        await Promise.all(executing);
+        return results;
+    }
+    /**
+     * Simpler parallel execution with Promise.all and concurrency via chunking
+     */
+    async runParallel(tasks, maxConcurrency) {
+        const results = [];
+        for (let i = 0; i < tasks.length; i += maxConcurrency) {
+            const chunk = tasks.slice(i, i + maxConcurrency);
+            const chunkResults = await Promise.all(chunk.map((t) => t()));
+            results.push(...chunkResults);
+        }
+        return results;
+    }
+}
+//# sourceMappingURL=scheduler.js.map

package/dist/scheduler.js.map

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

package/dist/subworkflows/index.d.ts

@@ -0,0 +1,16 @@
+/**
+ * @cogitator-ai/workflows - Subworkflows module
+ *
+ * Enables nested and parallel workflow execution.
+ *
+ * Features:
+ * - Single subworkflow execution
+ * - Parallel subworkflows with concurrency control
+ * - State mapping between parent and child
+ * - Error handling strategies
+ * - Depth limits to prevent infinite recursion
+ * - Race and fallback patterns
+ */
+export { type SubworkflowErrorStrategy, type SubworkflowRetryConfig, type SubworkflowConfig, type SubworkflowContext, type SubworkflowResult, MaxDepthExceededError, executeSubworkflow, subworkflowNode, simpleSubworkflow, nestedSubworkflow, conditionalSubworkflow, } from './subworkflow-node';
+export { type ParallelSubworkflowDef, type ParallelSubworkflowsConfig, type ParallelProgress, type ParallelSubworkflowsResult, executeParallelSubworkflows, parallelSubworkflows, fanOutFanIn, scatterGather, raceSubworkflows, fallbackSubworkflows, } from './parallel-subworkflows';
+//# sourceMappingURL=index.d.ts.map

package/dist/subworkflows/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/subworkflows/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EACL,KAAK,wBAAwB,EAC7B,KAAK,sBAAsB,EAC3B,KAAK,iBAAiB,EACtB,KAAK,kBAAkB,EACvB,KAAK,iBAAiB,EACtB,qBAAqB,EACrB,kBAAkB,EAClB,eAAe,EACf,iBAAiB,EACjB,iBAAiB,EACjB,sBAAsB,GACvB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACL,KAAK,sBAAsB,EAC3B,KAAK,0BAA0B,EAC/B,KAAK,gBAAgB,EACrB,KAAK,0BAA0B,EAC/B,2BAA2B,EAC3B,oBAAoB,EACpB,WAAW,EACX,aAAa,EACb,gBAAgB,EAChB,oBAAoB,GACrB,MAAM,yBAAyB,CAAC"}

package/dist/subworkflows/index.js

@@ -0,0 +1,16 @@
+/**
+ * @cogitator-ai/workflows - Subworkflows module
+ *
+ * Enables nested and parallel workflow execution.
+ *
+ * Features:
+ * - Single subworkflow execution
+ * - Parallel subworkflows with concurrency control
+ * - State mapping between parent and child
+ * - Error handling strategies
+ * - Depth limits to prevent infinite recursion
+ * - Race and fallback patterns
+ */
+export { MaxDepthExceededError, executeSubworkflow, subworkflowNode, simpleSubworkflow, nestedSubworkflow, conditionalSubworkflow, } from './subworkflow-node';
+export { executeParallelSubworkflows, parallelSubworkflows, fanOutFanIn, scatterGather, raceSubworkflows, fallbackSubworkflows, } from './parallel-subworkflows';
+//# sourceMappingURL=index.js.map

package/dist/subworkflows/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/subworkflows/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAML,qBAAqB,EACrB,kBAAkB,EAClB,eAAe,EACf,iBAAiB,EACjB,iBAAiB,EACjB,sBAAsB,GACvB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EAKL,2BAA2B,EAC3B,oBAAoB,EACpB,WAAW,EACX,aAAa,EACb,gBAAgB,EAChB,oBAAoB,GACrB,MAAM,yBAAyB,CAAC"}

package/dist/subworkflows/parallel-subworkflows.d.ts

@@ -0,0 +1,139 @@
+/**
+ * Parallel subworkflow execution
+ *
+ * Features:
+ * - Execute multiple subworkflows in parallel
+ * - Configurable concurrency
+ * - Aggregate results
+ * - Partial failure handling
+ */
+import type { Workflow, WorkflowState, WorkflowResult } from '@cogitator-ai/types';
+import { type SubworkflowContext, type SubworkflowConfig, type SubworkflowResult, type SubworkflowErrorStrategy } from './subworkflow-node';
+/**
+ * Parallel subworkflow definition
+ */
+export interface ParallelSubworkflowDef<PS extends WorkflowState, CS extends WorkflowState> {
+    id: string;
+    config: SubworkflowConfig<PS, CS>;
+}
+/**
+ * Parallel subworkflows configuration
+ */
+export interface ParallelSubworkflowsConfig<S extends WorkflowState> {
+    name: string;
+    /**
+     * Get subworkflow definitions to execute
+     */
+    subworkflows: ParallelSubworkflowDef<S, WorkflowState>[] | ((state: S) => ParallelSubworkflowDef<S, WorkflowState>[]);
+    /**
+     * Maximum concurrent subworkflows
+     * @default Infinity
+     */
+    concurrency?: number;
+    /**
+     * Continue if some subworkflows fail
+     * @default false
+     */
+    continueOnError?: boolean;
+    /**
+     * Error handling strategy for all subworkflows
+     */
+    onError?: SubworkflowErrorStrategy;
+    /**
+     * Aggregate results into parent state
+     */
+    aggregator: (results: Map<string, SubworkflowResult<S, WorkflowState>>, parentState: S) => S;
+    /**
+     * Maximum nesting depth for all subworkflows
+     * @default 10
+     */
+    maxDepth?: number;
+    /**
+     * Share checkpoint store with parent
+     * @default true
+     */
+    shareCheckpoints?: boolean;
+    /**
+     * Called when a subworkflow starts
+     */
+    onSubworkflowStart?: (id: string, config: SubworkflowConfig<S, WorkflowState>) => void;
+    /**
+     * Called when a subworkflow completes
+     */
+    onSubworkflowComplete?: (id: string, result: SubworkflowResult<S, WorkflowState>) => void;
+    /**
+     * Called on progress
+     */
+    onProgress?: (progress: ParallelProgress) => void;
+}
+/**
+ * Progress event for parallel execution
+ */
+export interface ParallelProgress {
+    total: number;
+    completed: number;
+    successful: number;
+    failed: number;
+    pending: number;
+    running: number;
+}
+/**
+ * Parallel subworkflows result
+ */
+export interface ParallelSubworkflowsResult<S extends WorkflowState> {
+    success: boolean;
+    parentState: S;
+    results: Map<string, SubworkflowResult<S, WorkflowState>>;
+    errors: Map<string, Error>;
+    duration: number;
+    stats: {
+        total: number;
+        successful: number;
+        failed: number;
+        skipped: number;
+    };
+}
+/**
+ * Execute multiple subworkflows in parallel
+ */
+export declare function executeParallelSubworkflows<S extends WorkflowState>(parentState: S, config: ParallelSubworkflowsConfig<S>, context: SubworkflowContext): Promise<ParallelSubworkflowsResult<S>>;
+/**
+ * Create a parallel subworkflows node factory
+ */
+export declare function parallelSubworkflows<S extends WorkflowState>(name: string, config: Omit<ParallelSubworkflowsConfig<S>, 'name'>): ParallelSubworkflowsConfig<S>;
+/**
+ * Create a fan-out/fan-in pattern
+ * Fans out to multiple identical subworkflows with different inputs
+ */
+export declare function fanOutFanIn<S extends WorkflowState, CS extends WorkflowState>(name: string, config: {
+    workflow: Workflow<CS>;
+    getInputs: (state: S) => {
+        id: string;
+        input: Partial<CS>;
+    }[];
+    aggregator: (results: Map<string, WorkflowResult<CS>>, state: S) => S;
+    concurrency?: number;
+    continueOnError?: boolean;
+}): ParallelSubworkflowsConfig<S>;
+/**
+ * Create a scatter-gather pattern
+ * Scatters work across multiple workflows and gathers results
+ */
+export declare function scatterGather<S extends WorkflowState, CS extends WorkflowState>(name: string, config: {
+    workflows: Map<string, Workflow<CS>>;
+    inputMapper: (state: S, workflowId: string) => Partial<CS>;
+    outputMapper: (results: Map<string, WorkflowResult<CS>>, state: S) => S;
+    concurrency?: number;
+    timeout?: number;
+}): ParallelSubworkflowsConfig<S>;
+/**
+ * Create a race pattern
+ * Executes multiple subworkflows and returns the first successful result
+ */
+export declare function raceSubworkflows<PS extends WorkflowState, CS extends WorkflowState>(parentState: PS, subworkflows: SubworkflowConfig<PS, CS>[], context: SubworkflowContext): Promise<SubworkflowResult<PS, CS> | null>;
+/**
+ * Create a fallback pattern
+ * Tries subworkflows in order until one succeeds
+ */
+export declare function fallbackSubworkflows<PS extends WorkflowState, CS extends WorkflowState>(parentState: PS, subworkflows: SubworkflowConfig<PS, CS>[], context: SubworkflowContext): Promise<SubworkflowResult<PS, CS>>;
+//# sourceMappingURL=parallel-subworkflows.d.ts.map

package/dist/subworkflows/parallel-subworkflows.d.ts.map

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