@defai.digital/agent-parallel 13.4.0

package/dist/result-aggregator.js

@@ -0,0 +1,187 @@
+/**
+ * Result Aggregator
+ *
+ * Combines results from parallel agent execution based on configured strategy.
+ *
+ * Invariants:
+ * - INV-APE-004: Result aggregation follows configured strategy
+ */
+/**
+ * Deep merge two objects
+ * Later values override earlier values
+ */
+function deepMerge(target, source) {
+    const result = { ...target };
+    for (const [key, value] of Object.entries(source)) {
+        if (value &&
+            typeof value === 'object' &&
+            !Array.isArray(value) &&
+            result[key] &&
+            typeof result[key] === 'object' &&
+            !Array.isArray(result[key])) {
+            // Recursively merge objects
+            result[key] = deepMerge(result[key], value);
+        }
+        else {
+            // Override with new value
+            result[key] = value;
+        }
+    }
+    return result;
+}
+/**
+ * Merge strategy: Combine all outputs into single object
+ * INV-APE-004: Later tasks override earlier for same keys
+ */
+function mergeResults(results) {
+    const merged = {};
+    // Sort by layer then completion time to ensure deterministic merge order
+    const sortedResults = [...results].sort((a, b) => {
+        // First by layer
+        const layerDiff = (a.layer ?? 0) - (b.layer ?? 0);
+        if (layerDiff !== 0)
+            return layerDiff;
+        // Then by completion time
+        const aTime = a.completedAt ? new Date(a.completedAt).getTime() : 0;
+        const bTime = b.completedAt ? new Date(b.completedAt).getTime() : 0;
+        return aTime - bTime;
+    });
+    for (const result of sortedResults) {
+        if (result.success && result.output !== undefined) {
+            if (typeof result.output === 'object' && result.output !== null && !Array.isArray(result.output)) {
+                // Deep merge object outputs
+                Object.assign(merged, deepMerge(merged, result.output));
+            }
+            else {
+                // For non-object outputs, use agent ID as key
+                merged[result.agentId] = result.output;
+            }
+        }
+    }
+    return Object.keys(merged).length > 0 ? merged : undefined;
+}
+/**
+ * List strategy: Return array of individual results
+ * INV-APE-004: Ordered by task definition order (taskId)
+ */
+function listResults(results) {
+    return results
+        .filter((r) => r.success)
+        .sort((a, b) => a.taskId.localeCompare(b.taskId))
+        .map((r) => ({
+        taskId: r.taskId,
+        agentId: r.agentId,
+        output: r.output,
+        durationMs: r.durationMs,
+    }));
+}
+/**
+ * First success strategy: Return first successful result
+ * INV-APE-004: First by layer, then by completion time
+ */
+function firstSuccessResult(results) {
+    const successResults = results
+        .filter((r) => r.success && r.output !== undefined)
+        .sort((a, b) => {
+        // First by layer
+        const layerDiff = (a.layer ?? 0) - (b.layer ?? 0);
+        if (layerDiff !== 0)
+            return layerDiff;
+        // Then by completion time
+        const aTime = a.completedAt ? new Date(a.completedAt).getTime() : 0;
+        const bTime = b.completedAt ? new Date(b.completedAt).getTime() : 0;
+        return aTime - bTime;
+    });
+    return successResults[0]?.output;
+}
+/**
+ * Creates a result aggregator
+ */
+export function createResultAggregator() {
+    return {
+        /**
+         * Aggregate task results based on strategy
+         * INV-APE-004: Follows configured strategy exactly
+         */
+        aggregate(results, options) {
+            const { strategy, customAggregator } = options;
+            switch (strategy) {
+                case 'merge':
+                    return mergeResults(results);
+                case 'list':
+                    return listResults(results);
+                case 'firstSuccess':
+                    return firstSuccessResult(results);
+                case 'custom':
+                    if (!customAggregator) {
+                        throw new Error('Custom aggregation strategy requires a customAggregator function');
+                    }
+                    return customAggregator(results);
+                default:
+                    // Exhaustive check
+                    const _exhaustive = strategy;
+                    throw new Error(`Unknown aggregation strategy: ${_exhaustive}`);
+            }
+        },
+    };
+}
+/**
+ * Built-in aggregation strategies for convenience
+ */
+export const AggregationStrategies = {
+    /**
+     * Merge all successful outputs into single object
+     */
+    merge: mergeResults,
+    /**
+     * Return array of all successful results
+     */
+    list: listResults,
+    /**
+     * Return first successful result only
+     */
+    firstSuccess: firstSuccessResult,
+    /**
+     * Create custom strategy from function
+     */
+    custom: (fn) => fn,
+};
+/**
+ * Utility: Create a keyed aggregator that groups results by a key
+ */
+export function createKeyedAggregator(keyFn) {
+    return (results) => {
+        const grouped = {};
+        for (const result of results) {
+            if (result.success && result.output !== undefined) {
+                const key = keyFn(result);
+                if (!grouped[key]) {
+                    grouped[key] = [];
+                }
+                grouped[key].push(result.output);
+            }
+        }
+        return grouped;
+    };
+}
+/**
+ * Utility: Create aggregator that filters by success and transforms
+ */
+export function createTransformAggregator(transform) {
+    return (results) => {
+        return results
+            .filter((r) => r.success && r.output !== undefined)
+            .map((r) => transform(r.output, r));
+    };
+}
+/**
+ * Get aggregation strategy from string
+ */
+export function getAggregationStrategy(name) {
+    const valid = ['merge', 'list', 'firstSuccess', 'custom'];
+    if (valid.includes(name)) {
+        return name;
+    }
+    throw new Error(`Invalid aggregation strategy: ${name}. Valid strategies: ${valid.join(', ')}`);
+}
+//# sourceMappingURL=result-aggregator.js.map

package/dist/result-aggregator.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,207 @@
+/**
+ * Parallel Agent Execution Types
+ *
+ * Port interfaces and type definitions for parallel agent execution.
+ */
+import type { AgentParallelTask, AgentParallelTaskResult, AgentParallelGroupResult, AgentParallelExecutionConfig, ExecutionPlan, SharedContext } from '@defai.digital/contracts';
+/**
+ * Agent execution request
+ */
+export interface AgentExecuteRequest {
+    agentId: string;
+    input: unknown;
+    provider?: string;
+    model?: string;
+    timeout?: number;
+    sessionId?: string;
+}
+/**
+ * Agent execution result
+ */
+export interface AgentExecuteResult {
+    success: boolean;
+    agentId: string;
+    output?: unknown;
+    error?: string;
+    errorCode?: string;
+    durationMs: number;
+}
+/**
+ * Port interface for agent execution
+ * Implementations inject actual agent executor at runtime
+ */
+export interface AgentExecutorPort {
+    /**
+     * Execute a single agent with input
+     */
+    execute(request: AgentExecuteRequest): Promise<AgentExecuteResult>;
+    /**
+     * Check if an agent exists
+     */
+    exists(agentId: string): Promise<boolean>;
+}
+/**
+ * Parallel agent orchestrator interface
+ */
+export interface AgentParallelOrchestrator {
+    /**
+     * Execute multiple agents in parallel with DAG-based dependency management
+     * INV-APE-001: Respects maxConcurrentAgents
+     * INV-APE-002: Honors dependencies
+     * INV-APE-003: Shared context immutable
+     */
+    executeParallel(tasks: AgentParallelTask[], config?: Partial<AgentParallelExecutionConfig>, sharedContext?: Record<string, unknown>): Promise<AgentParallelGroupResult>;
+    /**
+     * Build execution plan without executing
+     * Returns DAG analysis showing execution layers
+     */
+    buildExecutionPlan(tasks: AgentParallelTask[]): ExecutionPlan;
+    /**
+     * Cancel ongoing execution
+     */
+    cancel(): void;
+    /**
+     * Get current configuration
+     */
+    getConfig(): AgentParallelExecutionConfig;
+}
+/**
+ * Execution layer - tasks at same level can run in parallel
+ */
+export interface TaskLayer {
+    index: number;
+    tasks: AgentParallelTask[];
+}
+/**
+ * DAG analysis result
+ */
+export interface DAGAnalysisResult {
+    layers: TaskLayer[];
+    totalLayers: number;
+    maxParallelism: number;
+    hasCycles: boolean;
+    cycleNodes?: string[];
+}
+/**
+ * DAG analyzer interface
+ */
+export interface DAGAnalyzer {
+    /**
+     * Analyze tasks and build execution layers
+     * INV-APE-002: Ensures dependencies honored
+     * INV-APE-200: Detects circular dependencies
+     */
+    analyze(tasks: AgentParallelTask[]): DAGAnalysisResult;
+    /**
+     * Validate DAG structure
+     */
+    validate(tasks: AgentParallelTask[]): {
+        valid: boolean;
+        errors: string[];
+    };
+}
+/**
+ * Context manager for shared immutable context
+ * INV-APE-003: Context immutable during execution
+ */
+export interface ContextManager {
+    /**
+     * Create frozen shared context
+     */
+    create(data: Record<string, unknown>): SharedContext;
+    /**
+     * Get read-only view of context
+     */
+    get(): SharedContext | null;
+    /**
+     * Check if context is frozen/immutable
+     */
+    isFrozen(): boolean;
+    /**
+     * Clear context (for cleanup)
+     */
+    clear(): void;
+}
+/**
+ * Result aggregation strategy
+ */
+export type AggregationStrategy = 'merge' | 'list' | 'firstSuccess' | 'custom';
+/**
+ * Custom aggregation function
+ */
+export type CustomAggregator = (results: AgentParallelTaskResult[]) => unknown;
+/**
+ * Result aggregator options
+ */
+export interface ResultAggregatorOptions {
+    strategy: AggregationStrategy;
+    customAggregator?: CustomAggregator;
+}
+/**
+ * Result aggregator interface
+ * INV-APE-004: Aggregation follows configured strategy
+ */
+export interface ResultAggregator {
+    /**
+     * Aggregate task results based on strategy
+     */
+    aggregate(results: AgentParallelTaskResult[], options: ResultAggregatorOptions): unknown;
+}
+/**
+ * Progress event types
+ */
+export type ParallelProgressEventType = 'execution.started' | 'layer.started' | 'layer.completed' | 'task.started' | 'task.completed' | 'task.failed' | 'task.skipped' | 'execution.completed' | 'execution.cancelled';
+/**
+ * Progress event
+ */
+export interface ParallelProgressEvent {
+    type: ParallelProgressEventType;
+    timestamp: string;
+    groupId: string;
+    layerIndex?: number;
+    taskId?: string;
+    agentId?: string;
+    totalTasks?: number;
+    completedTasks?: number;
+    failedTasks?: number;
+    message?: string;
+}
+/**
+ * Progress callback
+ */
+export type ParallelProgressCallback = (event: ParallelProgressEvent) => void;
+/**
+ * Options for creating parallel orchestrator
+ */
+export interface AgentParallelOrchestratorOptions {
+    /**
+     * Agent executor port (for dependency injection)
+     */
+    agentExecutor: AgentExecutorPort;
+    /**
+     * Default configuration
+     */
+    defaultConfig?: Partial<AgentParallelExecutionConfig>;
+    /**
+     * Progress callback for execution updates
+     */
+    onProgress?: ParallelProgressCallback;
+}
+/**
+ * Stub agent executor for testing
+ */
+export declare class StubAgentExecutor implements AgentExecutorPort {
+    private results;
+    private existingAgents;
+    /**
+     * Set expected result for an agent
+     */
+    setResult(agentId: string, result: Partial<AgentExecuteResult>): void;
+    /**
+     * Set agent as existing
+     */
+    setExists(agentId: string, exists: boolean): void;
+    execute(request: AgentExecuteRequest): Promise<AgentExecuteResult>;
+    exists(agentId: string): Promise<boolean>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,54 @@
+/**
+ * Parallel Agent Execution Types
+ *
+ * Port interfaces and type definitions for parallel agent execution.
+ */
+// ============================================================================
+// Stub Implementation (for testing)
+// ============================================================================
+/**
+ * Stub agent executor for testing
+ */
+export class StubAgentExecutor {
+    results = new Map();
+    existingAgents = new Set();
+    /**
+     * Set expected result for an agent
+     */
+    setResult(agentId, result) {
+        this.results.set(agentId, {
+            success: true,
+            agentId,
+            durationMs: 100,
+            ...result,
+        });
+    }
+    /**
+     * Set agent as existing
+     */
+    setExists(agentId, exists) {
+        if (exists) {
+            this.existingAgents.add(agentId);
+        }
+        else {
+            this.existingAgents.delete(agentId);
+        }
+    }
+    async execute(request) {
+        const result = this.results.get(request.agentId);
+        if (result) {
+            return result;
+        }
+        // Default: return success with echo output
+        return {
+            success: true,
+            agentId: request.agentId,
+            output: { input: request.input, echo: true },
+            durationMs: 50,
+        };
+    }
+    async exists(agentId) {
+        return this.existingAgents.has(agentId) || this.results.has(agentId);
+    }
+}
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAuQH,+EAA+E;AAC/E,oCAAoC;AACpC,+EAA+E;AAE/E;;GAEG;AACH,MAAM,OAAO,iBAAiB;IACpB,OAAO,GAAoC,IAAI,GAAG,EAAE,CAAC;IACrD,cAAc,GAAgB,IAAI,GAAG,EAAE,CAAC;IAEhD;;OAEG;IACH,SAAS,CAAC,OAAe,EAAE,MAAmC;QAC5D,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,EAAE;YACxB,OAAO,EAAE,IAAI;YACb,OAAO;YACP,UAAU,EAAE,GAAG;YACf,GAAG,MAAM;SACV,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,SAAS,CAAC,OAAe,EAAE,MAAe;QACxC,IAAI,MAAM,EAAE,CAAC;YACX,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QACnC,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QACtC,CAAC;IACH,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,OAA4B;QACxC,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QACjD,IAAI,MAAM,EAAE,CAAC;YACX,OAAO,MAAM,CAAC;QAChB,CAAC;QAED,2CAA2C;QAC3C,OAAO;YACL,OAAO,EAAE,IAAI;YACb,OAAO,EAAE,OAAO,CAAC,OAAO;YACxB,MAAM,EAAE,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE;YAC5C,UAAU,EAAE,EAAE;SACf,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,OAAe;QAC1B,OAAO,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IACvE,CAAC;CACF"}

package/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "@defai.digital/agent-parallel",
+  "version": "13.4.0",
+  "type": "module",
+  "description": "Parallel agent execution orchestration for AutomatosX",
+  "license": "BUSL-1.1",
+  "author": "DEFAI Private Limited",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/defai-digital/automatosx.git",
+    "directory": "packages/core/agent-parallel"
+  },
+  "homepage": "https://github.com/defai-digital/automatosx#readme",
+  "bugs": {
+    "url": "https://github.com/defai-digital/automatosx/issues"
+  },
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "src"
+  ],
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@defai.digital/contracts": "13.4.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.7.2"
+  },
+  "peerDependencies": {
+    "zod": "^3.23.0"
+  },
+  "scripts": {
+    "build": "tsc --build",
+    "clean": "rm -rf dist"
+  }
+}