@defai.digital/agent-parallel 13.4.0

package/dist/orchestrator.js

@@ -0,0 +1,494 @@
+/**
+ * Parallel Agent Orchestrator
+ *
+ * Main orchestration logic for executing multiple agents in parallel
+ * with DAG-based dependency management.
+ *
+ * Invariants:
+ * - INV-APE-001: Concurrent agents MUST NOT exceed maxConcurrentAgents
+ * - INV-APE-002: Dependencies honored (DAG ordering)
+ * - INV-APE-003: Shared context immutable during execution
+ * - INV-APE-004: Result aggregation follows configured strategy
+ * - INV-APE-005: Timeout enforced per-agent independently
+ */
+import { createDefaultAgentParallelExecutionConfig, ParallelExecutionErrorCodes, } from '@defai.digital/contracts';
+import { createDAGAnalyzer, DAGAnalysisError } from './dag-analyzer.js';
+import { createContextManager } from './context-manager.js';
+import { createResultAggregator } from './result-aggregator.js';
+/**
+ * Error thrown during parallel execution
+ */
+export class ParallelExecutionError extends Error {
+    code;
+    taskId;
+    constructor(code, message, taskId) {
+        super(message);
+        this.code = code;
+        this.taskId = taskId;
+        this.name = 'ParallelExecutionError';
+    }
+}
+/**
+ * Creates a parallel agent orchestrator
+ */
+export function createAgentParallelOrchestrator(options) {
+    const { agentExecutor, defaultConfig, onProgress } = options;
+    const dagAnalyzer = createDAGAnalyzer();
+    const contextManager = createContextManager();
+    const resultAggregator = createResultAggregator();
+    const config = {
+        ...createDefaultAgentParallelExecutionConfig(),
+        ...defaultConfig,
+    };
+    // Track active executions for proper cancellation scoping
+    // Each execution has its own cancelled state to prevent cross-execution interference
+    const activeExecutions = new Map();
+    let currentGroupId = null;
+    /**
+     * Check if a specific execution is cancelled
+     */
+    function isCancelled(groupId) {
+        return activeExecutions.get(groupId)?.cancelled ?? false;
+    }
+    /**
+     * Mark an execution as cancelled
+     */
+    function setCancelled(groupId) {
+        const execution = activeExecutions.get(groupId);
+        if (execution) {
+            execution.cancelled = true;
+        }
+    }
+    /**
+     * Emit progress event
+     */
+    function emitProgress(event, groupId) {
+        const gId = groupId ?? currentGroupId;
+        if (onProgress && gId) {
+            onProgress({
+                ...event,
+                timestamp: new Date().toISOString(),
+                groupId: gId,
+            });
+        }
+    }
+    /**
+     * Execute a single task with timeout
+     * INV-APE-005: Timeout enforced independently
+     */
+    async function executeTask(task, sharedContext, taskConfig, layerIndex, groupId) {
+        const startTime = Date.now();
+        const startedAt = new Date().toISOString();
+        emitProgress({
+            type: 'task.started',
+            taskId: task.taskId,
+            agentId: task.agentId,
+            layerIndex,
+        }, groupId);
+        // Task-specific timeout or default
+        const timeout = task.timeout ?? taskConfig.agentTimeout;
+        try {
+            // Check cancellation (scoped to this execution)
+            if (isCancelled(groupId)) {
+                return {
+                    taskId: task.taskId,
+                    agentId: task.agentId,
+                    status: 'cancelled',
+                    success: false,
+                    errorCode: ParallelExecutionErrorCodes.CANCELLED,
+                    durationMs: Date.now() - startTime,
+                    layer: layerIndex,
+                    startedAt,
+                    completedAt: new Date().toISOString(),
+                    retryCount: 0,
+                };
+            }
+            // Check if agent exists
+            const exists = await agentExecutor.exists(task.agentId);
+            if (!exists) {
+                const errorMsg = `Agent "${task.agentId}" not found`;
+                const result = {
+                    taskId: task.taskId,
+                    agentId: task.agentId,
+                    status: 'failed',
+                    success: false,
+                    error: errorMsg,
+                    errorCode: ParallelExecutionErrorCodes.AGENT_NOT_FOUND,
+                    durationMs: Date.now() - startTime,
+                    layer: layerIndex,
+                    startedAt,
+                    completedAt: new Date().toISOString(),
+                    retryCount: 0,
+                };
+                emitProgress({
+                    type: 'task.failed',
+                    taskId: task.taskId,
+                    agentId: task.agentId,
+                    layerIndex,
+                    message: errorMsg,
+                });
+                return result;
+            }
+            // Build input with shared context
+            const input = taskConfig.shareContext && sharedContext
+                ? { ...sharedContext, __taskInput: task.input }
+                : task.input;
+            // Execute with timeout
+            // Build execution request, only include optional fields if defined
+            const execRequest = {
+                agentId: task.agentId,
+                input,
+                timeout,
+            };
+            if (task.provider)
+                execRequest.provider = task.provider;
+            if (task.model)
+                execRequest.model = task.model;
+            const executePromise = agentExecutor.execute(execRequest);
+            // Create timeout with cleanup to prevent memory leak
+            let timeoutId;
+            const timeoutPromise = new Promise((_, reject) => {
+                timeoutId = setTimeout(() => {
+                    reject(new Error(`Task timeout after ${timeout}ms`));
+                }, timeout);
+            });
+            let execResult;
+            try {
+                execResult = await Promise.race([executePromise, timeoutPromise]);
+            }
+            finally {
+                // Clean up timeout to prevent memory leak
+                if (timeoutId !== undefined) {
+                    clearTimeout(timeoutId);
+                }
+            }
+            const completedAt = new Date().toISOString();
+            const durationMs = Date.now() - startTime;
+            if (execResult.success) {
+                emitProgress({
+                    type: 'task.completed',
+                    taskId: task.taskId,
+                    agentId: task.agentId,
+                    layerIndex,
+                });
+                return {
+                    taskId: task.taskId,
+                    agentId: task.agentId,
+                    status: 'completed',
+                    success: true,
+                    output: execResult.output,
+                    durationMs,
+                    layer: layerIndex,
+                    startedAt,
+                    completedAt,
+                    retryCount: 0,
+                };
+            }
+            else {
+                emitProgress({
+                    type: 'task.failed',
+                    taskId: task.taskId,
+                    agentId: task.agentId,
+                    layerIndex,
+                    message: execResult.error ?? 'Task execution failed',
+                });
+                return {
+                    taskId: task.taskId,
+                    agentId: task.agentId,
+                    status: 'failed',
+                    success: false,
+                    error: execResult.error,
+                    errorCode: execResult.errorCode ?? ParallelExecutionErrorCodes.TASK_FAILED,
+                    durationMs,
+                    layer: layerIndex,
+                    startedAt,
+                    completedAt,
+                    retryCount: 0,
+                };
+            }
+        }
+        catch (error) {
+            const completedAt = new Date().toISOString();
+            const durationMs = Date.now() - startTime;
+            const isTimeout = error instanceof Error && error.message.includes('timeout');
+            emitProgress({
+                type: 'task.failed',
+                taskId: task.taskId,
+                agentId: task.agentId,
+                layerIndex,
+                message: error instanceof Error ? error.message : 'Unknown error',
+            });
+            return {
+                taskId: task.taskId,
+                agentId: task.agentId,
+                status: isTimeout ? 'timeout' : 'failed',
+                success: false,
+                error: error instanceof Error ? error.message : 'Unknown error',
+                errorCode: isTimeout
+                    ? ParallelExecutionErrorCodes.TASK_TIMEOUT
+                    : ParallelExecutionErrorCodes.TASK_FAILED,
+                durationMs,
+                layer: layerIndex,
+                startedAt,
+                completedAt,
+                retryCount: 0,
+            };
+        }
+    }
+    /**
+     * Execute a layer of tasks with concurrency limit
+     * INV-APE-001: Respects maxConcurrentAgents
+     */
+    async function executeLayer(layer, sharedContext, taskConfig, failedTaskIds, groupId) {
+        const results = [];
+        const pending = new Set();
+        emitProgress({
+            type: 'layer.started',
+            layerIndex: layer.index,
+            totalTasks: layer.tasks.length,
+        }, groupId);
+        // Filter out tasks whose dependencies failed
+        // INV-APE-201: Dependency cascading
+        const tasksToExecute = [];
+        const skippedTasks = [];
+        for (const task of layer.tasks) {
+            const dependencyFailed = task.dependencies.some((depId) => failedTaskIds.has(depId));
+            if (dependencyFailed) {
+                skippedTasks.push(task);
+            }
+            else {
+                tasksToExecute.push(task);
+            }
+        }
+        // Mark skipped tasks
+        for (const task of skippedTasks) {
+            const now = new Date().toISOString();
+            const result = {
+                taskId: task.taskId,
+                agentId: task.agentId,
+                status: 'skipped',
+                success: false,
+                error: 'Dependency failed',
+                errorCode: ParallelExecutionErrorCodes.DEPENDENCY_FAILED,
+                durationMs: 0,
+                layer: layer.index,
+                startedAt: now,
+                completedAt: now,
+                retryCount: 0,
+            };
+            results.push(result);
+            failedTaskIds.add(task.taskId);
+            emitProgress({
+                type: 'task.skipped',
+                taskId: task.taskId,
+                agentId: task.agentId,
+                layerIndex: layer.index,
+                message: 'Dependency failed',
+            }, groupId);
+        }
+        // Execute remaining tasks with concurrency control
+        let taskIndex = 0;
+        async function executeAndCollect(task) {
+            const result = await executeTask(task, sharedContext, taskConfig, layer.index, groupId);
+            results.push(result);
+            if (!result.success) {
+                failedTaskIds.add(task.taskId);
+                // Handle failFast strategy (scoped to this execution)
+                if (taskConfig.failureStrategy === 'failFast' && !isCancelled(groupId)) {
+                    setCancelled(groupId);
+                }
+            }
+        }
+        // INV-APE-001: Concurrency limit enforcement
+        while (taskIndex < tasksToExecute.length || pending.size > 0) {
+            // Check cancellation (scoped to this execution)
+            if (isCancelled(groupId) && taskConfig.failureStrategy === 'failFast') {
+                // Mark remaining as cancelled
+                while (taskIndex < tasksToExecute.length) {
+                    const task = tasksToExecute[taskIndex++];
+                    const now = new Date().toISOString();
+                    results.push({
+                        taskId: task.taskId,
+                        agentId: task.agentId,
+                        status: 'cancelled',
+                        success: false,
+                        errorCode: ParallelExecutionErrorCodes.CANCELLED,
+                        durationMs: 0,
+                        layer: layer.index,
+                        startedAt: now,
+                        completedAt: now,
+                        retryCount: 0,
+                    });
+                }
+                break;
+            }
+            // Start new tasks up to concurrency limit
+            while (pending.size < taskConfig.maxConcurrentAgents &&
+                taskIndex < tasksToExecute.length) {
+                const task = tasksToExecute[taskIndex++];
+                const promise = executeAndCollect(task).finally(() => {
+                    pending.delete(promise);
+                });
+                pending.add(promise);
+            }
+            // Wait for at least one to complete
+            if (pending.size > 0) {
+                await Promise.race(pending);
+            }
+        }
+        emitProgress({
+            type: 'layer.completed',
+            layerIndex: layer.index,
+            completedTasks: results.filter((r) => r.success).length,
+            failedTasks: results.filter((r) => !r.success).length,
+        }, groupId);
+        return results;
+    }
+    return {
+        getConfig() {
+            return { ...config };
+        },
+        buildExecutionPlan(tasks) {
+            const planId = crypto.randomUUID();
+            const analysis = dagAnalyzer.analyze(tasks);
+            const layers = analysis.layers.map((layer) => ({
+                index: layer.index,
+                tasks: layer.tasks,
+                taskCount: layer.tasks.length,
+            }));
+            return {
+                planId,
+                layers,
+                totalTasks: tasks.length,
+                totalLayers: analysis.totalLayers,
+                maxParallelism: analysis.maxParallelism,
+                hasCycles: analysis.hasCycles,
+                createdAt: new Date().toISOString(),
+            };
+        },
+        async executeParallel(tasks, configOverride, sharedContext) {
+            const groupId = crypto.randomUUID();
+            currentGroupId = groupId;
+            // Register this execution with its own cancellation state
+            activeExecutions.set(groupId, { cancelled: false });
+            const startTime = Date.now();
+            const startedAt = new Date().toISOString();
+            // Merge config
+            const taskConfig = {
+                ...config,
+                ...configOverride,
+            };
+            // Setup context if provided
+            // INV-APE-003: Context frozen before execution
+            // INV-APE-300: Context snapshot timing
+            if (sharedContext && taskConfig.shareContext) {
+                contextManager.create(sharedContext);
+            }
+            emitProgress({
+                type: 'execution.started',
+                totalTasks: tasks.length,
+            }, groupId);
+            try {
+                // Analyze DAG
+                // INV-APE-002: Dependencies honored
+                // INV-APE-200: Cycles detected
+                const analysis = dagAnalyzer.analyze(tasks);
+                // Track failed tasks for dependency cascading
+                const failedTaskIds = new Set();
+                // Execute layers sequentially, tasks within layers in parallel
+                const allResults = [];
+                let peakConcurrency = 0;
+                for (const layer of analysis.layers) {
+                    if (isCancelled(groupId) && taskConfig.failureStrategy === 'failFast') {
+                        // Mark remaining layers as cancelled
+                        for (const task of layer.tasks) {
+                            const now = new Date().toISOString();
+                            allResults.push({
+                                taskId: task.taskId,
+                                agentId: task.agentId,
+                                status: 'cancelled',
+                                success: false,
+                                errorCode: ParallelExecutionErrorCodes.CANCELLED,
+                                durationMs: 0,
+                                layer: layer.index,
+                                startedAt: now,
+                                completedAt: now,
+                                retryCount: 0,
+                            });
+                        }
+                        continue;
+                    }
+                    const layerResults = await executeLayer(layer, sharedContext, taskConfig, failedTaskIds, groupId);
+                    allResults.push(...layerResults);
+                    // Track peak concurrency
+                    const layerConcurrency = Math.min(layer.tasks.length, taskConfig.maxConcurrentAgents);
+                    if (layerConcurrency > peakConcurrency) {
+                        peakConcurrency = layerConcurrency;
+                    }
+                }
+                // Aggregate results
+                // INV-APE-004: Follows configured strategy
+                const aggregatedOutput = resultAggregator.aggregate(allResults, {
+                    strategy: taskConfig.resultAggregation,
+                });
+                const completedAt = new Date().toISOString();
+                const totalDurationMs = Date.now() - startTime;
+                const failedTasks = allResults
+                    .filter((r) => !r.success && r.status !== 'cancelled' && r.status !== 'skipped')
+                    .map((r) => r.taskId);
+                const cancelledTasks = allResults
+                    .filter((r) => r.status === 'cancelled')
+                    .map((r) => r.taskId);
+                const skippedTasks = allResults
+                    .filter((r) => r.status === 'skipped')
+                    .map((r) => r.taskId);
+                emitProgress({
+                    type: 'execution.completed',
+                    totalTasks: tasks.length,
+                    completedTasks: allResults.filter((r) => r.success).length,
+                    failedTasks: failedTasks.length,
+                }, groupId);
+                return {
+                    groupId,
+                    taskResults: allResults,
+                    aggregatedOutput,
+                    allSucceeded: failedTasks.length === 0 && cancelledTasks.length === 0,
+                    failedTasks,
+                    cancelledTasks: cancelledTasks.length > 0 ? cancelledTasks : undefined,
+                    skippedTasks: skippedTasks.length > 0 ? skippedTasks : undefined,
+                    totalDurationMs,
+                    tasksExecuted: allResults.filter((r) => r.status !== 'skipped' && r.status !== 'cancelled').length,
+                    tasksSkipped: skippedTasks.length + cancelledTasks.length,
+                    layerCount: analysis.totalLayers,
+                    peakConcurrency,
+                    config: taskConfig,
+                    startedAt,
+                    completedAt,
+                };
+            }
+            catch (error) {
+                // Handle DAG analysis errors
+                if (error instanceof DAGAnalysisError) {
+                    throw new ParallelExecutionError(error.code, error.message);
+                }
+                throw error;
+            }
+            finally {
+                // Cleanup - remove execution state to prevent memory leak
+                contextManager.clear();
+                activeExecutions.delete(groupId);
+                currentGroupId = null;
+            }
+        },
+        cancel() {
+            // Cancel all active executions
+            for (const [gId, state] of activeExecutions) {
+                state.cancelled = true;
+                emitProgress({
+                    type: 'execution.cancelled',
+                }, gId);
+            }
+        },
+    };
+}
+//# sourceMappingURL=orchestrator.js.map

package/dist/orchestrator.js.map

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

package/dist/result-aggregator.d.ts

@@ -0,0 +1,64 @@
+/**
+ * Result Aggregator
+ *
+ * Combines results from parallel agent execution based on configured strategy.
+ *
+ * Invariants:
+ * - INV-APE-004: Result aggregation follows configured strategy
+ */
+import type { AgentParallelTaskResult } from '@defai.digital/contracts';
+import type { ResultAggregator, CustomAggregator, AggregationStrategy } from './types.js';
+/**
+ * Merge strategy: Combine all outputs into single object
+ * INV-APE-004: Later tasks override earlier for same keys
+ */
+declare function mergeResults(results: AgentParallelTaskResult[]): unknown;
+/**
+ * List strategy: Return array of individual results
+ * INV-APE-004: Ordered by task definition order (taskId)
+ */
+declare function listResults(results: AgentParallelTaskResult[]): unknown;
+/**
+ * First success strategy: Return first successful result
+ * INV-APE-004: First by layer, then by completion time
+ */
+declare function firstSuccessResult(results: AgentParallelTaskResult[]): unknown;
+/**
+ * Creates a result aggregator
+ */
+export declare function createResultAggregator(): ResultAggregator;
+/**
+ * Built-in aggregation strategies for convenience
+ */
+export declare const AggregationStrategies: {
+    /**
+     * Merge all successful outputs into single object
+     */
+    readonly merge: typeof mergeResults;
+    /**
+     * Return array of all successful results
+     */
+    readonly list: typeof listResults;
+    /**
+     * Return first successful result only
+     */
+    readonly firstSuccess: typeof firstSuccessResult;
+    /**
+     * Create custom strategy from function
+     */
+    readonly custom: (fn: CustomAggregator) => CustomAggregator;
+};
+/**
+ * Utility: Create a keyed aggregator that groups results by a key
+ */
+export declare function createKeyedAggregator(keyFn: (result: AgentParallelTaskResult) => string): CustomAggregator;
+/**
+ * Utility: Create aggregator that filters by success and transforms
+ */
+export declare function createTransformAggregator<T>(transform: (output: unknown, result: AgentParallelTaskResult) => T): CustomAggregator;
+/**
+ * Get aggregation strategy from string
+ */
+export declare function getAggregationStrategy(name: string): AggregationStrategy;
+export {};
+//# sourceMappingURL=result-aggregator.d.ts.map

package/dist/result-aggregator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"result-aggregator.d.ts","sourceRoot":"","sources":["../src/result-aggregator.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,0BAA0B,CAAC;AACxE,OAAO,KAAK,EACV,gBAAgB,EAEhB,gBAAgB,EAChB,mBAAmB,EACpB,MAAM,YAAY,CAAC;AAmCpB;;;GAGG;AACH,iBAAS,YAAY,CAAC,OAAO,EAAE,uBAAuB,EAAE,GAAG,OAAO,CA4BjE;AAED;;;GAGG;AACH,iBAAS,WAAW,CAAC,OAAO,EAAE,uBAAuB,EAAE,GAAG,OAAO,CAUhE;AAED;;;GAGG;AACH,iBAAS,kBAAkB,CAAC,OAAO,EAAE,uBAAuB,EAAE,GAAG,OAAO,CAevE;AAED;;GAEG;AACH,wBAAgB,sBAAsB,IAAI,gBAAgB,CAqCzD;AAED;;GAEG;AACH,eAAO,MAAM,qBAAqB;IAChC;;OAEG;;IAGH;;OAEG;;IAGH;;OAEG;;IAGH;;OAEG;0BACU,gBAAgB;CACrB,CAAC;AAEX;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,CAAC,MAAM,EAAE,uBAAuB,KAAK,MAAM,GACjD,gBAAgB,CAgBlB;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,CAAC,EACzC,SAAS,EAAE,CAAC,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,uBAAuB,KAAK,CAAC,GACjE,gBAAgB,CAMlB;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,MAAM,GACX,mBAAmB,CAQrB"}