@defai.digital/agent-parallel 13.4.0

package/LICENSE

@@ -0,0 +1,38 @@
+Business Source License 1.1
+
+Parameters
+
+Licensor: DEFAI Private Limited
+Licensed Work: AutomatosX
+The Licensed Work is (c) 2024-2025 DEFAI Private Limited
+Additional Use Grant: You may make production use of the Licensed Work,
+provided that your organization has less than US$2,000,000 in annual gross
+revenue in the prior fiscal year. "Production use" means use in a live
+production environment to support business or operational activities for end
+users.
+Change Date: Four years after the release date of the Licensed Work version
+Change License: Apache License, Version 2.0
+
+Terms
+
+The Licensor hereby grants you the right to copy, modify, create derivative
+works, redistribute, and make non-production use of the Licensed Work. The
+Licensor may make an Additional Use Grant, above, permitting other uses of the
+Licensed Work. The rights granted to you under this license are subject to the
+following condition.
+
+If you make any use of the Licensed Work, you must ensure that the Licensed
+Work, or any modified version of it, carries prominent notices stating that
+you have modified the Licensed Work.
+
+This license does not grant permission to use the Licensor's trademarks.
+
+The Licensed Work is provided "as is", without warranty of any kind, express
+or implied, including but not limited to the warranties of merchantability,
+fitness for a particular purpose and noninfringement. In no event shall the
+Licensor be liable for any claim, damages or other liability, whether in an
+action of contract, tort or otherwise, arising from, out of or in connection
+with the Licensed Work or the use or other dealings in the Licensed Work.
+
+On the Change Date, the Licensed Work will be made available under the Change
+License.

package/dist/context-manager.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Context Manager
+ *
+ * Manages shared immutable context for parallel agent execution.
+ * Ensures context is frozen before execution and cannot be modified.
+ *
+ * Invariants:
+ * - INV-APE-003: Shared context immutable during execution
+ * - INV-APE-300: Context snapshot timing (frozen before first task)
+ */
+import type { ContextManager } from './types.js';
+/**
+ * Error thrown when context mutation is attempted
+ */
+export declare class ContextMutationError extends Error {
+    constructor(message: string);
+    static readonly code: "PARALLEL_CONTEXT_MUTATION";
+}
+/**
+ * Creates a context manager for shared immutable context
+ */
+export declare function createContextManager(): ContextManager;
+/**
+ * Creates a proxy that throws on any mutation attempt
+ * Alternative approach for stricter runtime enforcement
+ */
+export declare function createImmutableContextProxy<T extends Record<string, unknown>>(data: T): Readonly<T>;
+/**
+ * Validates that context data is JSON-serializable
+ */
+export declare function validateContextData(data: unknown): {
+    valid: boolean;
+    errors: string[];
+};
+//# sourceMappingURL=context-manager.d.ts.map

package/dist/context-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-manager.d.ts","sourceRoot":"","sources":["../src/context-manager.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjD;;GAEG;AACH,qBAAa,oBAAqB,SAAQ,KAAK;gBACjC,OAAO,EAAE,MAAM;IAK3B,MAAM,CAAC,QAAQ,CAAC,IAAI,8BAAgD;CACrE;AAsBD;;GAEG;AACH,wBAAgB,oBAAoB,IAAI,cAAc,CAkDrD;AAED;;;GAGG;AACH,wBAAgB,2BAA2B,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC3E,IAAI,EAAE,CAAC,GACN,QAAQ,CAAC,CAAC,CAAC,CAyCb;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,OAAO,GACZ;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAA;CAAE,CAqCtC"}

package/dist/context-manager.js

@@ -0,0 +1,156 @@
+/**
+ * Context Manager
+ *
+ * Manages shared immutable context for parallel agent execution.
+ * Ensures context is frozen before execution and cannot be modified.
+ *
+ * Invariants:
+ * - INV-APE-003: Shared context immutable during execution
+ * - INV-APE-300: Context snapshot timing (frozen before first task)
+ */
+import { ParallelExecutionErrorCodes } from '@defai.digital/contracts';
+/**
+ * Error thrown when context mutation is attempted
+ */
+export class ContextMutationError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'ContextMutationError';
+    }
+    static code = ParallelExecutionErrorCodes.CONTEXT_MUTATION;
+}
+/**
+ * Deep freeze an object and all nested objects
+ * INV-APE-003: Ensures true immutability
+ */
+function deepFreeze(obj) {
+    // Get property names
+    const propNames = Object.getOwnPropertyNames(obj);
+    // Freeze nested objects first
+    for (const name of propNames) {
+        const value = obj[name];
+        if (value && typeof value === 'object' && !Object.isFrozen(value)) {
+            deepFreeze(value);
+        }
+    }
+    // Freeze self
+    return Object.freeze(obj);
+}
+/**
+ * Creates a context manager for shared immutable context
+ */
+export function createContextManager() {
+    let context = null;
+    let frozen = false;
+    return {
+        /**
+         * Create frozen shared context
+         * INV-APE-300: Context snapshot timing
+         */
+        create(data) {
+            // Deep clone to prevent external mutation
+            const clonedData = JSON.parse(JSON.stringify(data));
+            // Create context object
+            const newContext = {
+                data: clonedData,
+                createdAt: new Date().toISOString(),
+                version: '1',
+            };
+            // Deep freeze the entire context
+            // INV-APE-003: Immutable during execution
+            context = deepFreeze(newContext);
+            frozen = true;
+            return context;
+        },
+        /**
+         * Get read-only view of context
+         */
+        get() {
+            return context;
+        },
+        /**
+         * Check if context is frozen/immutable
+         */
+        isFrozen() {
+            return frozen && context !== null && Object.isFrozen(context);
+        },
+        /**
+         * Clear context (for cleanup after execution)
+         */
+        clear() {
+            context = null;
+            frozen = false;
+        },
+    };
+}
+/**
+ * Creates a proxy that throws on any mutation attempt
+ * Alternative approach for stricter runtime enforcement
+ */
+export function createImmutableContextProxy(data) {
+    const handler = {
+        get(target, prop, receiver) {
+            const value = Reflect.get(target, prop, receiver);
+            // Recursively wrap nested objects
+            if (value && typeof value === 'object') {
+                return createImmutableContextProxy(value);
+            }
+            return value;
+        },
+        set(_target, prop) {
+            throw new ContextMutationError(`Cannot modify shared context: attempted to set "${String(prop)}". ` +
+                'Shared context is immutable during parallel execution (INV-APE-003).');
+        },
+        deleteProperty(_target, prop) {
+            throw new ContextMutationError(`Cannot modify shared context: attempted to delete "${String(prop)}". ` +
+                'Shared context is immutable during parallel execution (INV-APE-003).');
+        },
+        defineProperty(_target, prop) {
+            throw new ContextMutationError(`Cannot modify shared context: attempted to define "${String(prop)}". ` +
+                'Shared context is immutable during parallel execution (INV-APE-003).');
+        },
+        setPrototypeOf() {
+            throw new ContextMutationError('Cannot modify shared context prototype. ' +
+                'Shared context is immutable during parallel execution (INV-APE-003).');
+        },
+    };
+    return new Proxy(data, handler);
+}
+/**
+ * Validates that context data is JSON-serializable
+ */
+export function validateContextData(data) {
+    const errors = [];
+    try {
+        // Check JSON serializability
+        JSON.stringify(data);
+    }
+    catch (e) {
+        errors.push(`Context data is not JSON-serializable: ${e instanceof Error ? e.message : 'Unknown error'}`);
+        return { valid: false, errors };
+    }
+    // Check for functions (not serializable)
+    function checkForFunctions(obj, path) {
+        if (typeof obj === 'function') {
+            errors.push(`Context contains function at ${path}`);
+        }
+        else if (obj && typeof obj === 'object') {
+            if (Array.isArray(obj)) {
+                obj.forEach((item, index) => checkForFunctions(item, `${path}[${index}]`));
+            }
+            else {
+                for (const [key, value] of Object.entries(obj)) {
+                    checkForFunctions(value, path ? `${path}.${key}` : key);
+                }
+            }
+        }
+    }
+    checkForFunctions(data, '');
+    // Check for circular references (JSON.stringify would have failed)
+    // Already caught above
+    return {
+        valid: errors.length === 0,
+        errors,
+    };
+}
+//# sourceMappingURL=context-manager.js.map

package/dist/context-manager.js.map

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

package/dist/dag-analyzer.d.ts

@@ -0,0 +1,32 @@
+/**
+ * DAG Analyzer
+ *
+ * Analyzes task dependencies and builds execution layers using topological sort.
+ * Detects circular dependencies and validates DAG structure.
+ *
+ * Invariants:
+ * - INV-APE-002: Dependencies honored (DAG ordering)
+ * - INV-APE-200: Circular dependencies detected before execution
+ */
+import type { AgentParallelTask } from '@defai.digital/contracts';
+import type { DAGAnalyzer } from './types.js';
+/**
+ * Error thrown when DAG analysis fails
+ */
+export declare class DAGAnalysisError extends Error {
+    readonly code: string;
+    readonly cycleNodes?: string[] | undefined;
+    constructor(code: string, message: string, cycleNodes?: string[] | undefined);
+    static circularDependency(nodeIds: string[]): DAGAnalysisError;
+    static invalidDependency(taskId: string, depId: string): DAGAnalysisError;
+}
+/**
+ * Creates a DAG analyzer for parallel task execution
+ * Uses Kahn's algorithm for topological sorting
+ */
+export declare function createDAGAnalyzer(): DAGAnalyzer;
+/**
+ * Utility: Find tasks in a cycle using DFS
+ */
+export declare function findCyclePath(tasks: AgentParallelTask[]): string[] | null;
+//# sourceMappingURL=dag-analyzer.d.ts.map

package/dist/dag-analyzer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dag-analyzer.d.ts","sourceRoot":"","sources":["../src/dag-analyzer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAElE,OAAO,KAAK,EAAE,WAAW,EAAgC,MAAM,YAAY,CAAC;AAE5E;;GAEG;AACH,qBAAa,gBAAiB,SAAQ,KAAK;aAEvB,IAAI,EAAE,MAAM;aAEZ,UAAU,CAAC,EAAE,MAAM,EAAE;gBAFrB,IAAI,EAAE,MAAM,EAC5B,OAAO,EAAE,MAAM,EACC,UAAU,CAAC,EAAE,MAAM,EAAE,YAAA;IAMvC,MAAM,CAAC,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,gBAAgB;IAQ9D,MAAM,CAAC,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,gBAAgB;CAM1E;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,IAAI,WAAW,CAqL/C;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,iBAAiB,EAAE,GAAG,MAAM,EAAE,GAAG,IAAI,CAkDzE"}

package/dist/dag-analyzer.js

@@ -0,0 +1,237 @@
+/**
+ * DAG Analyzer
+ *
+ * Analyzes task dependencies and builds execution layers using topological sort.
+ * Detects circular dependencies and validates DAG structure.
+ *
+ * Invariants:
+ * - INV-APE-002: Dependencies honored (DAG ordering)
+ * - INV-APE-200: Circular dependencies detected before execution
+ */
+import { ParallelExecutionErrorCodes } from '@defai.digital/contracts';
+/**
+ * Error thrown when DAG analysis fails
+ */
+export class DAGAnalysisError extends Error {
+    code;
+    cycleNodes;
+    constructor(code, message, cycleNodes) {
+        super(message);
+        this.code = code;
+        this.cycleNodes = cycleNodes;
+        this.name = 'DAGAnalysisError';
+    }
+    static circularDependency(nodeIds) {
+        return new DAGAnalysisError(ParallelExecutionErrorCodes.CIRCULAR_DEPENDENCY, `Circular dependency detected: ${nodeIds.join(' -> ')}`, nodeIds);
+    }
+    static invalidDependency(taskId, depId) {
+        return new DAGAnalysisError(ParallelExecutionErrorCodes.INVALID_PLAN, `Task "${taskId}" depends on non-existent task "${depId}"`);
+    }
+}
+/**
+ * Creates a DAG analyzer for parallel task execution
+ * Uses Kahn's algorithm for topological sorting
+ */
+export function createDAGAnalyzer() {
+    /**
+     * Build execution layers using Kahn's algorithm
+     * INV-APE-002: Ensures dependencies honored
+     * INV-APE-200: Detects cycles via incomplete processing
+     */
+    function buildLayers(tasks) {
+        // Handle empty input
+        if (tasks.length === 0) {
+            return {
+                layers: [],
+                totalLayers: 0,
+                maxParallelism: 0,
+                hasCycles: false,
+            };
+        }
+        // Build task lookup map
+        const taskMap = new Map();
+        for (const task of tasks) {
+            taskMap.set(task.taskId, task);
+        }
+        // Validate all dependencies exist
+        for (const task of tasks) {
+            for (const depId of task.dependencies) {
+                if (!taskMap.has(depId)) {
+                    throw DAGAnalysisError.invalidDependency(task.taskId, depId);
+                }
+            }
+        }
+        // Calculate in-degree for each task
+        const inDegree = new Map();
+        for (const task of tasks) {
+            inDegree.set(task.taskId, task.dependencies.length);
+        }
+        // Build reverse dependency map (who depends on me)
+        const dependents = new Map();
+        for (const task of tasks) {
+            dependents.set(task.taskId, []);
+        }
+        for (const task of tasks) {
+            for (const depId of task.dependencies) {
+                const depList = dependents.get(depId) ?? [];
+                depList.push(task.taskId);
+                dependents.set(depId, depList);
+            }
+        }
+        // Build layers using BFS
+        const layers = [];
+        let processedCount = 0;
+        // Start with tasks that have no dependencies
+        let currentLayerTaskIds = Array.from(inDegree.entries())
+            .filter(([_, degree]) => degree === 0)
+            .map(([id]) => id);
+        let layerIndex = 0;
+        while (currentLayerTaskIds.length > 0) {
+            // Get tasks for current layer, sorted by priority (descending)
+            const layerTasks = currentLayerTaskIds
+                .map((id) => taskMap.get(id))
+                .sort((a, b) => (b.priority ?? 50) - (a.priority ?? 50));
+            layers.push({
+                index: layerIndex,
+                tasks: layerTasks,
+            });
+            processedCount += layerTasks.length;
+            // Find next layer
+            const nextLayerTaskIds = [];
+            for (const taskId of currentLayerTaskIds) {
+                const deps = dependents.get(taskId) ?? [];
+                for (const depId of deps) {
+                    const degree = (inDegree.get(depId) ?? 0) - 1;
+                    inDegree.set(depId, degree);
+                    if (degree === 0) {
+                        nextLayerTaskIds.push(depId);
+                    }
+                }
+            }
+            currentLayerTaskIds = nextLayerTaskIds;
+            layerIndex++;
+        }
+        // Check for cycles - if we didn't process all tasks, there's a cycle
+        const hasCycles = processedCount !== tasks.length;
+        let cycleNodes;
+        if (hasCycles) {
+            // Find nodes involved in cycle (those not processed)
+            cycleNodes = tasks
+                .filter((t) => (inDegree.get(t.taskId) ?? 0) > 0)
+                .map((t) => t.taskId);
+        }
+        // Calculate max parallelism (largest layer)
+        const maxParallelism = Math.max(0, ...layers.map((l) => l.tasks.length));
+        const result = {
+            layers,
+            totalLayers: layers.length,
+            maxParallelism,
+            hasCycles,
+        };
+        // Only include cycleNodes if there are cycles
+        if (cycleNodes) {
+            result.cycleNodes = cycleNodes;
+        }
+        return result;
+    }
+    /**
+     * Validate DAG structure
+     */
+    function validate(tasks) {
+        const errors = [];
+        // Check for duplicate task IDs
+        const taskIds = new Set();
+        for (const task of tasks) {
+            if (taskIds.has(task.taskId)) {
+                errors.push(`Duplicate task ID: ${task.taskId}`);
+            }
+            taskIds.add(task.taskId);
+        }
+        // Check for self-dependencies
+        for (const task of tasks) {
+            if (task.dependencies.includes(task.taskId)) {
+                errors.push(`Task "${task.taskId}" depends on itself`);
+            }
+        }
+        // Check for missing dependencies
+        for (const task of tasks) {
+            for (const depId of task.dependencies) {
+                if (!taskIds.has(depId)) {
+                    errors.push(`Task "${task.taskId}" depends on non-existent task "${depId}"`);
+                }
+            }
+        }
+        // Check for cycles
+        if (errors.length === 0) {
+            const result = buildLayers(tasks);
+            if (result.hasCycles) {
+                errors.push(`Circular dependency detected involving: ${result.cycleNodes?.join(', ')}`);
+            }
+        }
+        return {
+            valid: errors.length === 0,
+            errors,
+        };
+    }
+    return {
+        analyze(tasks) {
+            const result = buildLayers(tasks);
+            // Throw if cycles detected
+            if (result.hasCycles && result.cycleNodes) {
+                throw DAGAnalysisError.circularDependency(result.cycleNodes);
+            }
+            return result;
+        },
+        validate,
+    };
+}
+/**
+ * Utility: Find tasks in a cycle using DFS
+ */
+export function findCyclePath(tasks) {
+    const taskMap = new Map();
+    for (const task of tasks) {
+        taskMap.set(task.taskId, task);
+    }
+    const visited = new Set();
+    const recursionStack = new Set();
+    const path = [];
+    function dfs(taskId) {
+        visited.add(taskId);
+        recursionStack.add(taskId);
+        path.push(taskId);
+        const task = taskMap.get(taskId);
+        if (task) {
+            for (const depId of task.dependencies) {
+                if (!visited.has(depId)) {
+                    if (dfs(depId)) {
+                        return true;
+                    }
+                }
+                else if (recursionStack.has(depId)) {
+                    // Found cycle
+                    path.push(depId);
+                    return true;
+                }
+            }
+        }
+        recursionStack.delete(taskId);
+        path.pop();
+        return false;
+    }
+    for (const task of tasks) {
+        if (!visited.has(task.taskId)) {
+            if (dfs(task.taskId)) {
+                // Trim path to only include cycle
+                const lastNode = path[path.length - 1];
+                if (lastNode) {
+                    const cycleStart = path.indexOf(lastNode);
+                    return path.slice(cycleStart);
+                }
+                return path;
+            }
+        }
+    }
+    return null;
+}
+//# sourceMappingURL=dag-analyzer.js.map

package/dist/dag-analyzer.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,18 @@
+/**
+ * @defai.digital/agent-parallel
+ *
+ * Parallel Agent Execution Domain
+ *
+ * Provides orchestration for executing multiple agents in parallel
+ * with DAG-based dependency management, shared immutable context,
+ * and configurable result aggregation.
+ *
+ * @module @defai.digital/agent-parallel
+ */
+export { createAgentParallelOrchestrator, ParallelExecutionError, } from './orchestrator.js';
+export { createDAGAnalyzer, DAGAnalysisError, findCyclePath, } from './dag-analyzer.js';
+export { createContextManager, createImmutableContextProxy, validateContextData, ContextMutationError, } from './context-manager.js';
+export { createResultAggregator, AggregationStrategies, createKeyedAggregator, createTransformAggregator, getAggregationStrategy, } from './result-aggregator.js';
+export type { AgentParallelOrchestrator, AgentParallelOrchestratorOptions, AgentExecutorPort, AgentExecuteRequest, AgentExecuteResult, DAGAnalyzer, DAGAnalysisResult, TaskLayer, ContextManager, ResultAggregator, ResultAggregatorOptions, AggregationStrategy, CustomAggregator, ParallelProgressEvent, ParallelProgressEventType, ParallelProgressCallback, } from './types.js';
+export { StubAgentExecutor } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,EACL,+BAA+B,EAC/B,sBAAsB,GACvB,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EACL,iBAAiB,EACjB,gBAAgB,EAChB,aAAa,GACd,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EACL,oBAAoB,EACpB,2BAA2B,EAC3B,mBAAmB,EACnB,oBAAoB,GACrB,MAAM,sBAAsB,CAAC;AAG9B,OAAO,EACL,sBAAsB,EACtB,qBAAqB,EACrB,qBAAqB,EACrB,yBAAyB,EACzB,sBAAsB,GACvB,MAAM,wBAAwB,CAAC;AAGhC,YAAY,EAEV,yBAAyB,EACzB,gCAAgC,EAEhC,iBAAiB,EACjB,mBAAmB,EACnB,kBAAkB,EAElB,WAAW,EACX,iBAAiB,EACjB,SAAS,EAET,cAAc,EAEd,gBAAgB,EAChB,uBAAuB,EACvB,mBAAmB,EACnB,gBAAgB,EAEhB,qBAAqB,EACrB,yBAAyB,EACzB,wBAAwB,GACzB,MAAM,YAAY,CAAC;AAGpB,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,22 @@
+/**
+ * @defai.digital/agent-parallel
+ *
+ * Parallel Agent Execution Domain
+ *
+ * Provides orchestration for executing multiple agents in parallel
+ * with DAG-based dependency management, shared immutable context,
+ * and configurable result aggregation.
+ *
+ * @module @defai.digital/agent-parallel
+ */
+// Main Orchestrator
+export { createAgentParallelOrchestrator, ParallelExecutionError, } from './orchestrator.js';
+// DAG Analyzer
+export { createDAGAnalyzer, DAGAnalysisError, findCyclePath, } from './dag-analyzer.js';
+// Context Manager
+export { createContextManager, createImmutableContextProxy, validateContextData, ContextMutationError, } from './context-manager.js';
+// Result Aggregator
+export { createResultAggregator, AggregationStrategies, createKeyedAggregator, createTransformAggregator, getAggregationStrategy, } from './result-aggregator.js';
+// Stub implementation for testing
+export { StubAgentExecutor } from './types.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,oBAAoB;AACpB,OAAO,EACL,+BAA+B,EAC/B,sBAAsB,GACvB,MAAM,mBAAmB,CAAC;AAE3B,eAAe;AACf,OAAO,EACL,iBAAiB,EACjB,gBAAgB,EAChB,aAAa,GACd,MAAM,mBAAmB,CAAC;AAE3B,kBAAkB;AAClB,OAAO,EACL,oBAAoB,EACpB,2BAA2B,EAC3B,mBAAmB,EACnB,oBAAoB,GACrB,MAAM,sBAAsB,CAAC;AAE9B,oBAAoB;AACpB,OAAO,EACL,sBAAsB,EACtB,qBAAqB,EACrB,qBAAqB,EACrB,yBAAyB,EACzB,sBAAsB,GACvB,MAAM,wBAAwB,CAAC;AA4BhC,kCAAkC;AAClC,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC"}

package/dist/orchestrator.d.ts

@@ -0,0 +1,27 @@
+/**
+ * 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 type { AgentParallelOrchestrator, AgentParallelOrchestratorOptions } from './types.js';
+/**
+ * Error thrown during parallel execution
+ */
+export declare class ParallelExecutionError extends Error {
+    readonly code: string;
+    readonly taskId?: string | undefined;
+    constructor(code: string, message: string, taskId?: string | undefined);
+}
+/**
+ * Creates a parallel agent orchestrator
+ */
+export declare function createAgentParallelOrchestrator(options: AgentParallelOrchestratorOptions): AgentParallelOrchestrator;
+//# sourceMappingURL=orchestrator.d.ts.map

package/dist/orchestrator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"orchestrator.d.ts","sourceRoot":"","sources":["../src/orchestrator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAaH,OAAO,KAAK,EACV,yBAAyB,EACzB,gCAAgC,EAGjC,MAAM,YAAY,CAAC;AAMpB;;GAEG;AACH,qBAAa,sBAAuB,SAAQ,KAAK;aAE7B,IAAI,EAAE,MAAM;aAEZ,MAAM,CAAC,EAAE,MAAM;gBAFf,IAAI,EAAE,MAAM,EAC5B,OAAO,EAAE,MAAM,EACC,MAAM,CAAC,EAAE,MAAM,YAAA;CAKlC;AAED;;GAEG;AACH,wBAAgB,+BAA+B,CAC7C,OAAO,EAAE,gCAAgC,GACxC,yBAAyB,CA2hB3B"}