network-ai 4.12.1 → 4.13.0

package/dist/lib/fan-out.js

@@ -0,0 +1,221 @@
+"use strict";
+/**
+ * Fan-Out / Fan-In — Parallel agent spawning and result aggregation
+ *
+ * Launches multiple agents in parallel (fan-out) and combines their results
+ * using pluggable strategies (fan-in). Supports concurrency limits, timeouts,
+ * and custom aggregation. Inspired by Claude Code's parallel agent patterns.
+ *
+ * @module FanOutFanIn
+ * @version 1.0.0
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FanOutFanIn = void 0;
+// ============================================================================
+// FAN-OUT / FAN-IN
+// ============================================================================
+/**
+ * Parallel agent execution with pluggable result aggregation.
+ *
+ * @example
+ * ```typescript
+ * const fanout = new FanOutFanIn(registry, { agentId: 'orchestrator' });
+ *
+ * const steps: FanOutStep[] = [
+ *   { agentId: 'researcher-a', payload: { action: 'search', params: { q: 'AI safety' } }, label: 'web' },
+ *   { agentId: 'researcher-b', payload: { action: 'search', params: { q: 'AI safety' } }, label: 'papers' },
+ *   { agentId: 'researcher-c', payload: { action: 'search', params: { q: 'AI safety' } }, label: 'news' },
+ * ];
+ *
+ * const results = await fanout.fanOut(steps, { concurrency: 2 });
+ * const aggregated = fanout.fanIn(results, 'merge');
+ * ```
+ */
+class FanOutFanIn {
+    registry;
+    baseContext;
+    /**
+     * @param registry Adapter registry for agent execution
+     * @param baseContext Default execution context (merged with step-level overrides)
+     */
+    constructor(registry, baseContext) {
+        this.registry = registry;
+        this.baseContext = baseContext;
+    }
+    /**
+     * Execute agents in parallel (fan-out phase).
+     *
+     * @param steps Steps to execute
+     * @param options Concurrency and timeout settings
+     */
+    async fanOut(steps, options = {}) {
+        const concurrency = options.concurrency ?? steps.length;
+        const continueOnError = options.continueOnError ?? true;
+        const results = new Array(steps.length);
+        // Process in chunks of `concurrency`
+        for (let i = 0; i < steps.length; i += concurrency) {
+            const chunk = steps.slice(i, i + concurrency);
+            const chunkPromises = chunk.map((step, cIdx) => {
+                const idx = i + cIdx;
+                return this.executeStep(step, idx, options.timeoutMs);
+            });
+            const settled = await Promise.allSettled(chunkPromises);
+            for (let j = 0; j < settled.length; j++) {
+                const outcome = settled[j];
+                if (outcome.status === 'fulfilled') {
+                    results[i + j] = outcome.value;
+                    // Check for logical failure (agent returned success: false)
+                    if (!continueOnError && !outcome.value.result.success) {
+                        for (let k = i + j + 1; k < steps.length; k++) {
+                            results[k] = {
+                                agentId: steps[k].agentId,
+                                label: steps[k].label,
+                                index: k,
+                                result: { success: false, error: { code: 'FANOUT_SKIPPED', message: 'Skipped due to earlier failure', recoverable: false } },
+                                durationMs: 0,
+                            };
+                        }
+                        return results.filter(Boolean);
+                    }
+                }
+                else {
+                    const step = chunk[j];
+                    results[i + j] = {
+                        agentId: step.agentId,
+                        label: step.label,
+                        index: i + j,
+                        result: { success: false, error: { code: 'FANOUT_ERROR', message: String(outcome.reason), recoverable: false } },
+                        durationMs: 0,
+                    };
+                    if (!continueOnError) {
+                        // Fill remaining with skipped results
+                        for (let k = i + j + 1; k < steps.length; k++) {
+                            results[k] = {
+                                agentId: steps[k].agentId,
+                                label: steps[k].label,
+                                index: k,
+                                result: { success: false, error: { code: 'FANOUT_SKIPPED', message: 'Skipped due to earlier failure', recoverable: false } },
+                                durationMs: 0,
+                            };
+                        }
+                        return results.filter(Boolean);
+                    }
+                }
+            }
+        }
+        return results;
+    }
+    /**
+     * Aggregate results (fan-in phase).
+     *
+     * @param results Tagged results from fan-out
+     * @param strategy Aggregation strategy to apply
+     * @param customReducer Required when strategy is 'custom'
+     */
+    fanIn(results, strategy = 'merge', customReducer) {
+        const totalMs = results.reduce((sum, r) => sum + r.durationMs, 0);
+        const successCount = results.filter(r => r.result.success).length;
+        const failureCount = results.length - successCount;
+        let success;
+        let data;
+        switch (strategy) {
+            case 'merge': {
+                success = successCount > 0;
+                data = results.map(r => ({
+                    agentId: r.agentId,
+                    label: r.label,
+                    success: r.result.success,
+                    data: r.result.data,
+                }));
+                break;
+            }
+            case 'firstSuccess': {
+                const first = results.find(r => r.result.success);
+                success = !!first;
+                data = first?.result.data ?? null;
+                break;
+            }
+            case 'vote': {
+                const votes = new Map();
+                for (const r of results) {
+                    if (!r.result.success)
+                        continue;
+                    const key = JSON.stringify(r.result.data);
+                    const existing = votes.get(key);
+                    if (existing) {
+                        existing.count++;
+                    }
+                    else {
+                        votes.set(key, { count: 1, data: r.result.data });
+                    }
+                }
+                let best;
+                for (const v of votes.values()) {
+                    if (!best || v.count > best.count)
+                        best = v;
+                }
+                success = !!best;
+                data = best?.data ?? null;
+                break;
+            }
+            case 'consensus': {
+                const successResults = results.filter(r => r.result.success);
+                if (successResults.length === 0) {
+                    success = false;
+                    data = null;
+                }
+                else {
+                    const first = JSON.stringify(successResults[0].result.data);
+                    const allAgree = successResults.every(r => JSON.stringify(r.result.data) === first);
+                    success = allAgree;
+                    data = allAgree ? successResults[0].result.data : null;
+                }
+                break;
+            }
+            case 'custom': {
+                if (!customReducer) {
+                    throw new Error('customReducer is required when strategy is "custom"');
+                }
+                const reduced = customReducer(results);
+                success = reduced.success;
+                data = reduced.data;
+                break;
+            }
+        }
+        return { success, strategy, data, results, totalMs, successCount, failureCount };
+    }
+    /**
+     * Convenience: fan-out + fan-in in a single call.
+     */
+    async run(steps, strategy = 'merge', options, customReducer) {
+        const results = await this.fanOut(steps, options);
+        return this.fanIn(results, strategy, customReducer);
+    }
+    // --------------------------------------------------------------------------
+    // Private helpers
+    // --------------------------------------------------------------------------
+    async executeStep(step, index, globalTimeout) {
+        const ctx = { ...this.baseContext, ...step.context };
+        const timeout = step.timeoutMs ?? globalTimeout;
+        const start = Date.now();
+        let result;
+        if (timeout) {
+            result = await Promise.race([
+                this.registry.executeAgent(step.agentId, step.payload, ctx),
+                new Promise((_, reject) => setTimeout(() => reject(new Error(`Fan-out timeout: agent "${step.agentId}" exceeded ${timeout}ms`)), timeout)),
+            ]);
+        }
+        else {
+            result = await this.registry.executeAgent(step.agentId, step.payload, ctx);
+        }
+        return {
+            agentId: step.agentId,
+            label: step.label,
+            index,
+            result,
+            durationMs: Date.now() - start,
+        };
+    }
+}
+exports.FanOutFanIn = FanOutFanIn;
+//# sourceMappingURL=fan-out.js.map

package/dist/lib/fan-out.js.map

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

package/dist/lib/phase-pipeline.d.ts

@@ -0,0 +1,153 @@
+/**
+ * Phase Pipeline — Multi-phase workflows with approval gates
+ *
+ * Defines ordered execution phases. Each phase can optionally require human
+ * approval before proceeding. Phases may run their assigned agents in parallel
+ * or sequentially. Inspired by Claude Code's multi-phase orchestration pattern.
+ *
+ * @module PhasePipeline
+ * @version 1.0.0
+ */
+import type { AgentPayload, AgentContext, AgentResult } from '../types/agent-adapter';
+import type { AdapterRegistry } from '../adapters/adapter-registry';
+/** Current execution status of a phase */
+export type PhaseStatus = 'pending' | 'running' | 'awaiting_approval' | 'approved' | 'rejected' | 'completed' | 'failed' | 'skipped';
+/**
+ * Defines a single phase in the pipeline.
+ */
+export interface PhaseDefinition {
+    /** Unique phase name */
+    name: string;
+    /** Human-readable description */
+    description?: string;
+    /** Agent IDs to execute in this phase */
+    agents: string[];
+    /** If true, pipeline pauses after this phase until approval is granted */
+    requiresApproval?: boolean;
+    /** If true, agents within this phase run in parallel (default: sequential) */
+    parallel?: boolean;
+    /** Payload factory — builds the payload for each agent in this phase */
+    payloadFactory?: (agentId: string, previousResults: PhaseResult[]) => AgentPayload;
+    /** Maximum time (ms) allowed for this phase before timeout */
+    timeoutMs?: number;
+}
+/**
+ * Result from a single phase execution.
+ */
+export interface PhaseResult {
+    /** Phase name */
+    phaseName: string;
+    /** Final status */
+    status: PhaseStatus;
+    /** Agent results, keyed by agentId */
+    agentResults: Map<string, AgentResult>;
+    /** Phase execution time in milliseconds */
+    durationMs: number;
+    /** Approval metadata (if phase required approval) */
+    approval?: {
+        approvedBy?: string;
+        reason?: string;
+        timestamp: number;
+    };
+}
+/**
+ * Result from the entire pipeline execution.
+ */
+export interface PipelineResult {
+    /** Whether the entire pipeline completed successfully */
+    success: boolean;
+    /** Results per phase */
+    phases: PhaseResult[];
+    /** Total execution time in milliseconds */
+    totalMs: number;
+    /** Name of the phase that stopped the pipeline (if any) */
+    stoppedAt?: string;
+    /** Reason the pipeline stopped (rejection, failure, timeout) */
+    stopReason?: string;
+}
+/**
+ * Callback signature for approval gates.
+ * Return `{ approved: true }` to proceed, `{ approved: false, reason }` to reject.
+ */
+export type ApprovalCallback = (phaseName: string, phaseResult: PhaseResult, pipelineContext: PipelineExecutionContext) => Promise<{
+    approved: boolean;
+    approvedBy?: string;
+    reason?: string;
+}>;
+/**
+ * Options for creating a PhasePipeline.
+ */
+export interface PhasePipelineOptions {
+    /** Ordered list of phase definitions */
+    phases: PhaseDefinition[];
+    /** Called when a phase requires approval */
+    onApproval?: ApprovalCallback;
+    /** Called when each phase starts */
+    onPhaseStart?: (phaseName: string, index: number) => void;
+    /** Called when each phase completes */
+    onPhaseComplete?: (result: PhaseResult, index: number) => void;
+    /** If true, auto-approve all gates (useful for testing) */
+    autoApprove?: boolean;
+}
+/**
+ * Runtime context available during pipeline execution.
+ */
+export interface PipelineExecutionContext {
+    /** Results from previously completed phases */
+    completedPhases: PhaseResult[];
+    /** Index of the current phase */
+    currentPhaseIndex: number;
+    /** Total number of phases */
+    totalPhases: number;
+}
+/**
+ * Orchestrates multi-phase workflows with optional approval gates.
+ *
+ * @example
+ * ```typescript
+ * const pipeline = new PhasePipeline(registry, baseContext, {
+ *   phases: [
+ *     { name: 'research', agents: ['researcher'], parallel: false },
+ *     { name: 'review', agents: ['reviewer-a', 'reviewer-b'], parallel: true, requiresApproval: true },
+ *     { name: 'publish', agents: ['publisher'] },
+ *   ],
+ *   onApproval: async (name, result) => {
+ *     // In production: prompt the user
+ *     return { approved: true, approvedBy: 'admin' };
+ *   },
+ * });
+ *
+ * const result = await pipeline.run();
+ * ```
+ */
+export declare class PhasePipeline {
+    private registry;
+    private baseContext;
+    private options;
+    private phaseResults;
+    private _status;
+    constructor(registry: AdapterRegistry, baseContext: AgentContext, options: PhasePipelineOptions);
+    /** Current pipeline status */
+    get status(): string;
+    /** Results from all executed phases (even if pipeline was aborted) */
+    get results(): ReadonlyArray<PhaseResult>;
+    /** Phase definitions */
+    get phases(): ReadonlyArray<PhaseDefinition>;
+    /**
+     * Execute the entire pipeline, phase by phase.
+     *
+     * For each phase:
+     * 1. Run all assigned agents (parallel or sequential)
+     * 2. If `requiresApproval`, call the approval callback and wait
+     * 3. If rejected, stop the pipeline
+     * 4. Otherwise move to the next phase
+     */
+    run(defaultPayload?: AgentPayload): Promise<PipelineResult>;
+    /**
+     * Reset the pipeline for re-execution.
+     */
+    reset(): void;
+    private buildPayload;
+    private executeWithTimeout;
+}
+//# sourceMappingURL=phase-pipeline.d.ts.map

package/dist/lib/phase-pipeline.d.ts.map

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

package/dist/lib/phase-pipeline.js

@@ -0,0 +1,216 @@
+"use strict";
+/**
+ * Phase Pipeline — Multi-phase workflows with approval gates
+ *
+ * Defines ordered execution phases. Each phase can optionally require human
+ * approval before proceeding. Phases may run their assigned agents in parallel
+ * or sequentially. Inspired by Claude Code's multi-phase orchestration pattern.
+ *
+ * @module PhasePipeline
+ * @version 1.0.0
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PhasePipeline = void 0;
+// ============================================================================
+// PHASE PIPELINE
+// ============================================================================
+/**
+ * Orchestrates multi-phase workflows with optional approval gates.
+ *
+ * @example
+ * ```typescript
+ * const pipeline = new PhasePipeline(registry, baseContext, {
+ *   phases: [
+ *     { name: 'research', agents: ['researcher'], parallel: false },
+ *     { name: 'review', agents: ['reviewer-a', 'reviewer-b'], parallel: true, requiresApproval: true },
+ *     { name: 'publish', agents: ['publisher'] },
+ *   ],
+ *   onApproval: async (name, result) => {
+ *     // In production: prompt the user
+ *     return { approved: true, approvedBy: 'admin' };
+ *   },
+ * });
+ *
+ * const result = await pipeline.run();
+ * ```
+ */
+class PhasePipeline {
+    registry;
+    baseContext;
+    options;
+    phaseResults = [];
+    _status = 'idle';
+    constructor(registry, baseContext, options) {
+        if (!options.phases.length) {
+            throw new Error('PhasePipeline requires at least one phase');
+        }
+        const names = new Set();
+        for (const p of options.phases) {
+            if (names.has(p.name)) {
+                throw new Error(`Duplicate phase name: "${p.name}"`);
+            }
+            names.add(p.name);
+        }
+        this.registry = registry;
+        this.baseContext = baseContext;
+        this.options = options;
+    }
+    /** Current pipeline status */
+    get status() {
+        return this._status;
+    }
+    /** Results from all executed phases (even if pipeline was aborted) */
+    get results() {
+        return this.phaseResults;
+    }
+    /** Phase definitions */
+    get phases() {
+        return this.options.phases;
+    }
+    /**
+     * Execute the entire pipeline, phase by phase.
+     *
+     * For each phase:
+     * 1. Run all assigned agents (parallel or sequential)
+     * 2. If `requiresApproval`, call the approval callback and wait
+     * 3. If rejected, stop the pipeline
+     * 4. Otherwise move to the next phase
+     */
+    async run(defaultPayload) {
+        const pipelineStart = Date.now();
+        this._status = 'running';
+        this.phaseResults = [];
+        for (let i = 0; i < this.options.phases.length; i++) {
+            const phaseDef = this.options.phases[i];
+            this.options.onPhaseStart?.(phaseDef.name, i);
+            const phaseStart = Date.now();
+            const agentResults = new Map();
+            let phaseStatus = 'running';
+            // --- Execute agents -------------------------------------------------
+            try {
+                if (phaseDef.parallel) {
+                    const executions = phaseDef.agents.map(agentId => {
+                        const payload = this.buildPayload(agentId, phaseDef, defaultPayload);
+                        const ctx = { ...this.baseContext, metadata: { ...this.baseContext.metadata, phase: phaseDef.name } };
+                        return this.executeWithTimeout(agentId, payload, ctx, phaseDef.timeoutMs)
+                            .then(result => ({ agentId, result }));
+                    });
+                    const results = await Promise.all(executions);
+                    for (const { agentId, result } of results) {
+                        agentResults.set(agentId, result);
+                    }
+                }
+                else {
+                    for (const agentId of phaseDef.agents) {
+                        const payload = this.buildPayload(agentId, phaseDef, defaultPayload);
+                        const ctx = { ...this.baseContext, metadata: { ...this.baseContext.metadata, phase: phaseDef.name } };
+                        const result = await this.executeWithTimeout(agentId, payload, ctx, phaseDef.timeoutMs);
+                        agentResults.set(agentId, result);
+                        if (!result.success)
+                            break; // stop this phase on first failure
+                    }
+                }
+                // Check if any agent failed
+                const anyFailed = Array.from(agentResults.values()).some(r => !r.success);
+                phaseStatus = anyFailed ? 'failed' : 'completed';
+            }
+            catch (err) {
+                phaseStatus = 'failed';
+            }
+            const phaseResult = {
+                phaseName: phaseDef.name,
+                status: phaseStatus,
+                agentResults,
+                durationMs: Date.now() - phaseStart,
+            };
+            // --- Check failure --------------------------------------------------
+            if (phaseStatus === 'failed') {
+                phaseResult.status = 'failed';
+                this.phaseResults.push(phaseResult);
+                this.options.onPhaseComplete?.(phaseResult, i);
+                this._status = 'failed';
+                return {
+                    success: false,
+                    phases: this.phaseResults,
+                    totalMs: Date.now() - pipelineStart,
+                    stoppedAt: phaseDef.name,
+                    stopReason: 'Phase failed',
+                };
+            }
+            // --- Approval gate --------------------------------------------------
+            if (phaseDef.requiresApproval) {
+                phaseResult.status = 'awaiting_approval';
+                const pipelineCtx = {
+                    completedPhases: [...this.phaseResults],
+                    currentPhaseIndex: i,
+                    totalPhases: this.options.phases.length,
+                };
+                let approval;
+                if (this.options.autoApprove) {
+                    approval = { approved: true, approvedBy: 'auto' };
+                }
+                else if (this.options.onApproval) {
+                    approval = await this.options.onApproval(phaseDef.name, phaseResult, pipelineCtx);
+                }
+                else {
+                    // No approval handler and not auto-approved → reject by default
+                    approval = { approved: false, reason: 'No approval callback configured' };
+                }
+                phaseResult.approval = {
+                    approvedBy: approval.approvedBy,
+                    reason: approval.reason,
+                    timestamp: Date.now(),
+                };
+                if (!approval.approved) {
+                    phaseResult.status = 'rejected';
+                    this.phaseResults.push(phaseResult);
+                    this.options.onPhaseComplete?.(phaseResult, i);
+                    this._status = 'rejected';
+                    return {
+                        success: false,
+                        phases: this.phaseResults,
+                        totalMs: Date.now() - pipelineStart,
+                        stoppedAt: phaseDef.name,
+                        stopReason: approval.reason ?? 'Approval rejected',
+                    };
+                }
+                phaseResult.status = 'approved';
+            }
+            this.phaseResults.push(phaseResult);
+            this.options.onPhaseComplete?.(phaseResult, i);
+        }
+        this._status = 'completed';
+        return {
+            success: true,
+            phases: this.phaseResults,
+            totalMs: Date.now() - pipelineStart,
+        };
+    }
+    /**
+     * Reset the pipeline for re-execution.
+     */
+    reset() {
+        this.phaseResults = [];
+        this._status = 'idle';
+    }
+    // --------------------------------------------------------------------------
+    // Private helpers
+    // --------------------------------------------------------------------------
+    buildPayload(agentId, phase, defaultPayload) {
+        if (phase.payloadFactory) {
+            return phase.payloadFactory(agentId, this.phaseResults);
+        }
+        return defaultPayload ?? { action: phase.name, params: {} };
+    }
+    async executeWithTimeout(agentId, payload, ctx, timeoutMs) {
+        if (!timeoutMs) {
+            return this.registry.executeAgent(agentId, payload, ctx);
+        }
+        return Promise.race([
+            this.registry.executeAgent(agentId, payload, ctx),
+            new Promise((_, reject) => setTimeout(() => reject(new Error(`Phase timeout: agent "${agentId}" exceeded ${timeoutMs}ms`)), timeoutMs)),
+        ]);
+    }
+}
+exports.PhasePipeline = PhasePipeline;
+//# sourceMappingURL=phase-pipeline.js.map

package/dist/lib/phase-pipeline.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "network-ai",
-  "version": "4.12.1",
+  "version": "4.13.0",
   "description": "AI agent orchestration framework for TypeScript/Node.js - 17 adapters (LangChain, AutoGen, CrewAI, OpenAI Assistants, LlamaIndex, Semantic Kernel, Haystack, DSPy, Agno, MCP, OpenClaw, A2A, Codex, MiniMax, NemoClaw, APS + streaming variants). Built-in CLI, security, swarm intelligence, real-time streaming, and agentic workflow patterns.",
   "homepage": "https://network-ai.org",
   "main": "dist/index.js",
@@ -34,6 +34,7 @@
     "test:cli": "npx ts-node test-cli.ts",
     "test:qa": "npx ts-node test-qa.ts",
     "test:phase7": "npx ts-node test-phase7.ts",
+    "test:phase8": "npx ts-node test-phase8.ts",
     "test:all": "npx ts-node run-tests.ts",
     "setup": "npx ts-node setup.ts",
     "setup:check": "npx ts-node setup.ts --check",