ai-workflows 2.1.1 → 2.3.0

package/dist/cascade-executor.d.ts

@@ -0,0 +1,196 @@
+/**
+ * CascadeExecutor - Code -> Generative -> Agentic -> Human escalation pattern
+ *
+ * Implements a tiered execution strategy that tries deterministic code first,
+ * then escalates to AI-powered solutions, and finally to human-in-the-loop
+ * if all automated approaches fail.
+ *
+ * Features:
+ * - Tier escalation on failure
+ * - Per-tier and total cascade timeouts
+ * - 5W+H event emission for audit trails
+ * - Context propagation through tiers
+ * - Retry support per tier
+ * - Custom skip conditions
+ *
+ * @packageDocumentation
+ */
+import { type CascadeContext, type FiveWHEvent } from './cascade-context.js';
+/**
+ * Ordered list of capability tiers
+ */
+export declare const TIER_ORDER: readonly ["code", "generative", "agentic", "human"];
+/**
+ * Default timeouts per tier (from capability-tiers)
+ */
+export declare const DEFAULT_TIER_TIMEOUTS: Record<CapabilityTier, number>;
+/**
+ * Capability tier levels
+ */
+export type CapabilityTier = 'code' | 'generative' | 'agentic' | 'human';
+/**
+ * Context passed to tier handlers
+ */
+export interface TierContext {
+    /** Correlation ID for tracing */
+    correlationId: string;
+    /** Current tier being executed */
+    tier: CapabilityTier;
+    /** Input data */
+    input: unknown;
+    /** Cascade context */
+    cascadeContext: CascadeContext;
+}
+/**
+ * Handler for a specific tier
+ */
+export interface TierHandler<T = unknown> {
+    /** Handler name for debugging */
+    name: string;
+    /** Execute the tier logic */
+    execute: (input: unknown, context: TierContext) => Promise<T>;
+}
+/**
+ * Retry configuration per tier
+ */
+export interface TierRetryConfig {
+    /** Maximum number of retries */
+    maxRetries: number;
+    /** Base delay in milliseconds */
+    baseDelay: number;
+    /** Multiplier for exponential backoff */
+    multiplier?: number;
+}
+/**
+ * Result from a single tier execution
+ */
+export interface TierResult {
+    /** Tier that was executed */
+    tier: CapabilityTier;
+    /** Whether the tier succeeded */
+    success: boolean;
+    /** Result value (if success) */
+    value?: unknown;
+    /** Error (if failure) */
+    error?: Error;
+    /** Whether the tier timed out */
+    timedOut?: boolean;
+    /** Duration in milliseconds */
+    duration: number;
+}
+/**
+ * Metrics from cascade execution
+ */
+export interface CascadeMetrics {
+    /** Total execution duration */
+    totalDuration: number;
+    /** Duration per tier */
+    tierDurations: Partial<Record<CapabilityTier, number>>;
+    /** Number of retries per tier */
+    tierRetries?: Partial<Record<CapabilityTier, number>>;
+}
+/**
+ * Result from cascade execution
+ */
+export interface CascadeResult<T = unknown> {
+    /** Final result value */
+    value: T;
+    /** Tier that produced the result */
+    tier: CapabilityTier;
+    /** History of all tier executions */
+    history: TierResult[];
+    /** Tiers that were skipped */
+    skippedTiers: CapabilityTier[];
+    /** Cascade context with tracing info */
+    context: CascadeContext;
+    /** Execution metrics */
+    metrics: CascadeMetrics;
+}
+/**
+ * Skip condition function
+ */
+export type SkipCondition = (input: unknown) => boolean;
+/**
+ * Configuration for CascadeExecutor
+ */
+export interface CascadeConfig<T = unknown> {
+    /** Tier handlers */
+    tiers: Partial<Record<CapabilityTier, TierHandler<T>>>;
+    /** Per-tier timeouts in milliseconds */
+    timeouts?: Partial<Record<CapabilityTier, number>>;
+    /** Total cascade timeout in milliseconds */
+    totalTimeout?: number;
+    /** Use default timeouts from capability-tiers */
+    useDefaultTimeouts?: boolean;
+    /** Actor identifier for 5W+H events */
+    actor?: string;
+    /** Cascade name for 5W+H events */
+    cascadeName?: string;
+    /** Event callback for 5W+H events */
+    onEvent?: (event: FiveWHEvent) => void;
+    /** Skip conditions per tier */
+    skipConditions?: Partial<Record<CapabilityTier, SkipCondition>>;
+    /** Retry configuration per tier */
+    retryConfig?: Partial<Record<CapabilityTier, TierRetryConfig>>;
+}
+/**
+ * Error thrown when cascade times out
+ */
+export declare class CascadeTimeoutError extends Error {
+    readonly timeout: number;
+    readonly elapsed: number;
+    constructor(timeout: number, elapsed: number);
+}
+/**
+ * Error thrown when a tier is skipped
+ */
+export declare class TierSkippedError extends Error {
+    readonly tier: CapabilityTier;
+    readonly reason: string;
+    constructor(tier: CapabilityTier, reason: string);
+}
+/**
+ * Error thrown when all tiers fail
+ */
+export declare class AllTiersFailedError extends Error {
+    readonly history: TierResult[];
+    constructor(history: TierResult[]);
+}
+/**
+ * CascadeExecutor implements the code -> generative -> agentic -> human pattern
+ */
+export declare class CascadeExecutor<T = unknown> {
+    private readonly config;
+    private readonly actor;
+    private readonly cascadeName;
+    constructor(config: CascadeConfig<T>);
+    /**
+     * Execute the cascade
+     */
+    execute(input: unknown): Promise<CascadeResult<T>>;
+    /**
+     * Execute a single tier with timeout and retry support
+     */
+    private executeTier;
+    /**
+     * Execute a function with a timeout
+     */
+    private executeWithTimeout;
+    /**
+     * Get timeout for a tier
+     */
+    private getTierTimeout;
+    /**
+     * Get the next configured tier after the given tier
+     */
+    private getNextConfiguredTier;
+    /**
+     * Emit a 5W+H event
+     */
+    private emitEvent;
+    /**
+     * Sleep for a given duration
+     */
+    private sleep;
+}
+//# sourceMappingURL=cascade-executor.d.ts.map

package/dist/cascade-executor.d.ts.map

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

package/dist/cascade-executor.js

@@ -0,0 +1,384 @@
+/**
+ * CascadeExecutor - Code -> Generative -> Agentic -> Human escalation pattern
+ *
+ * Implements a tiered execution strategy that tries deterministic code first,
+ * then escalates to AI-powered solutions, and finally to human-in-the-loop
+ * if all automated approaches fail.
+ *
+ * Features:
+ * - Tier escalation on failure
+ * - Per-tier and total cascade timeouts
+ * - 5W+H event emission for audit trails
+ * - Context propagation through tiers
+ * - Retry support per tier
+ * - Custom skip conditions
+ *
+ * @packageDocumentation
+ */
+import { createCascadeContext, recordStep, } from './cascade-context.js';
+// ============================================================================
+// Constants
+// ============================================================================
+/**
+ * Ordered list of capability tiers
+ */
+export const TIER_ORDER = ['code', 'generative', 'agentic', 'human'];
+/**
+ * Default timeouts per tier (from capability-tiers)
+ */
+export const DEFAULT_TIER_TIMEOUTS = {
+    code: 5000, // 5 seconds
+    generative: 30000, // 30 seconds
+    agentic: 300000, // 5 minutes
+    human: 86400000, // 24 hours
+};
+// ============================================================================
+// Errors
+// ============================================================================
+/**
+ * Error thrown when cascade times out
+ */
+export class CascadeTimeoutError extends Error {
+    timeout;
+    elapsed;
+    constructor(timeout, elapsed) {
+        super(`Cascade timed out after ${elapsed}ms (limit: ${timeout}ms)`);
+        this.name = 'CascadeTimeoutError';
+        this.timeout = timeout;
+        this.elapsed = elapsed;
+    }
+}
+/**
+ * Error thrown when a tier is skipped
+ */
+export class TierSkippedError extends Error {
+    tier;
+    reason;
+    constructor(tier, reason) {
+        super(`Tier '${tier}' was skipped: ${reason}`);
+        this.name = 'TierSkippedError';
+        this.tier = tier;
+        this.reason = reason;
+    }
+}
+/**
+ * Error thrown when all tiers fail
+ */
+export class AllTiersFailedError extends Error {
+    history;
+    constructor(history) {
+        super('All cascade tiers failed');
+        this.name = 'AllTiersFailedError';
+        this.history = history;
+    }
+}
+// ============================================================================
+// CascadeExecutor
+// ============================================================================
+/**
+ * CascadeExecutor implements the code -> generative -> agentic -> human pattern
+ */
+export class CascadeExecutor {
+    config;
+    actor;
+    cascadeName;
+    constructor(config) {
+        this.config = config;
+        this.actor = config.actor || 'system';
+        this.cascadeName = config.cascadeName || 'cascade';
+    }
+    /**
+     * Execute the cascade
+     */
+    async execute(input) {
+        const startTime = Date.now();
+        const context = createCascadeContext({ name: this.cascadeName });
+        const history = [];
+        const skippedTiers = [];
+        const tierDurations = {};
+        // Emit cascade start event
+        this.emitEvent({
+            who: this.actor,
+            what: 'cascade-start',
+            when: startTime,
+            where: this.cascadeName,
+            how: {
+                status: 'running',
+                metadata: { input },
+            },
+        });
+        // Set up total timeout if configured
+        let totalTimeoutId;
+        let totalTimedOut = false;
+        const totalTimeoutPromise = new Promise((_, reject) => {
+            if (this.config.totalTimeout) {
+                totalTimeoutId = setTimeout(() => {
+                    totalTimedOut = true;
+                    reject(new CascadeTimeoutError(this.config.totalTimeout, Date.now() - startTime));
+                }, this.config.totalTimeout);
+            }
+        });
+        try {
+            // Execute tiers in order
+            for (const tier of TIER_ORDER) {
+                if (totalTimedOut)
+                    break;
+                const handler = this.config.tiers[tier];
+                // Check if tier should be skipped
+                if (!handler) {
+                    skippedTiers.push(tier);
+                    continue;
+                }
+                // Check skip condition
+                const skipCondition = this.config.skipConditions?.[tier];
+                if (skipCondition && skipCondition(input)) {
+                    skippedTiers.push(tier);
+                    continue;
+                }
+                // Execute tier
+                const tierResult = await this.executeTier(tier, handler, input, context, startTime, totalTimeoutPromise);
+                history.push(tierResult);
+                tierDurations[tier] = tierResult.duration;
+                // If tier succeeded, we're done
+                if (tierResult.success && tierResult.value !== undefined) {
+                    if (totalTimeoutId)
+                        clearTimeout(totalTimeoutId);
+                    const endTime = Date.now();
+                    this.emitEvent({
+                        who: this.actor,
+                        what: 'cascade-complete',
+                        when: endTime,
+                        where: this.cascadeName,
+                        how: {
+                            status: 'completed',
+                            duration: endTime - startTime,
+                            metadata: { tier, value: tierResult.value },
+                        },
+                    });
+                    return {
+                        value: tierResult.value,
+                        tier,
+                        history,
+                        skippedTiers,
+                        context,
+                        metrics: {
+                            totalDuration: endTime - startTime,
+                            tierDurations,
+                        },
+                    };
+                }
+            }
+            // Check if we timed out
+            if (totalTimedOut) {
+                if (totalTimeoutId)
+                    clearTimeout(totalTimeoutId);
+                throw new CascadeTimeoutError(this.config.totalTimeout, Date.now() - startTime);
+            }
+            // All tiers failed
+            if (totalTimeoutId)
+                clearTimeout(totalTimeoutId);
+            throw new AllTiersFailedError(history);
+        }
+        catch (error) {
+            if (totalTimeoutId)
+                clearTimeout(totalTimeoutId);
+            const endTime = Date.now();
+            this.emitEvent({
+                who: this.actor,
+                what: 'cascade-failed',
+                when: endTime,
+                where: this.cascadeName,
+                why: error instanceof Error ? error.message : String(error),
+                how: {
+                    status: 'failed',
+                    duration: endTime - startTime,
+                },
+            });
+            throw error;
+        }
+    }
+    /**
+     * Execute a single tier with timeout and retry support
+     */
+    async executeTier(tier, handler, input, cascadeContext, cascadeStartTime, totalTimeoutPromise) {
+        const tierStartTime = Date.now();
+        // Record step start
+        const step = recordStep(cascadeContext, tier, {
+            actor: this.actor,
+            action: `execute-${tier}`,
+        });
+        // Emit tier start event
+        this.emitEvent({
+            who: this.actor,
+            what: `tier-${tier}-execute`,
+            when: tierStartTime,
+            where: this.cascadeName,
+            how: {
+                status: 'running',
+                metadata: { tier },
+            },
+        });
+        // Determine timeout
+        const timeout = this.getTierTimeout(tier);
+        // Create tier context
+        const tierContext = {
+            correlationId: cascadeContext.correlationId,
+            tier,
+            input,
+            cascadeContext,
+        };
+        // Get retry config
+        const retryConfig = this.config.retryConfig?.[tier];
+        const maxRetries = retryConfig?.maxRetries ?? 0;
+        let lastError;
+        let attempts = 0;
+        while (attempts <= maxRetries) {
+            try {
+                // Execute with timeout
+                const result = await this.executeWithTimeout(() => handler.execute(input, tierContext), timeout, totalTimeoutPromise);
+                const duration = Date.now() - tierStartTime;
+                // Mark step complete
+                step.complete();
+                // Emit tier success event
+                this.emitEvent({
+                    who: this.actor,
+                    what: `tier-${tier}-execute`,
+                    when: Date.now(),
+                    where: this.cascadeName,
+                    how: {
+                        status: 'completed',
+                        duration,
+                        metadata: { tier, result },
+                    },
+                });
+                return {
+                    tier,
+                    success: true,
+                    value: result,
+                    duration,
+                };
+            }
+            catch (error) {
+                lastError = error instanceof Error ? error : new Error(String(error));
+                attempts++;
+                // Check if it's a timeout error
+                const isTimeout = lastError.message.includes('timed out') || lastError.name === 'TimeoutError';
+                // If we've exhausted retries or it's a total timeout, stop
+                if (attempts > maxRetries || lastError instanceof CascadeTimeoutError) {
+                    const duration = Date.now() - tierStartTime;
+                    // Mark step failed
+                    step.fail(lastError);
+                    // Emit tier failure event
+                    this.emitEvent({
+                        who: this.actor,
+                        what: `tier-${tier}-execute`,
+                        when: Date.now(),
+                        where: this.cascadeName,
+                        why: lastError.message,
+                        how: {
+                            status: 'failed',
+                            duration,
+                            metadata: { tier, error: lastError.message },
+                        },
+                    });
+                    // Emit escalation event if not last tier
+                    const nextTier = this.getNextConfiguredTier(tier);
+                    if (nextTier) {
+                        this.emitEvent({
+                            who: this.actor,
+                            what: `escalate-to-${nextTier}`,
+                            when: Date.now(),
+                            where: this.cascadeName,
+                            why: lastError.message,
+                            how: {
+                                status: 'running',
+                                metadata: { fromTier: tier, toTier: nextTier },
+                            },
+                        });
+                    }
+                    return {
+                        tier,
+                        success: false,
+                        error: lastError,
+                        timedOut: isTimeout,
+                        duration,
+                    };
+                }
+                // Wait before retry with exponential backoff
+                if (retryConfig) {
+                    const delay = retryConfig.baseDelay * Math.pow(retryConfig.multiplier ?? 2, attempts - 1);
+                    await this.sleep(delay);
+                }
+            }
+        }
+        // Should not reach here, but handle edge case
+        const duration = Date.now() - tierStartTime;
+        return {
+            tier,
+            success: false,
+            ...(lastError !== undefined && { error: lastError }),
+            duration,
+        };
+    }
+    /**
+     * Execute a function with a timeout
+     */
+    async executeWithTimeout(fn, timeout, totalTimeoutPromise) {
+        const promises = [fn()];
+        // Add total timeout race
+        if (this.config.totalTimeout) {
+            promises.push(totalTimeoutPromise);
+        }
+        // Add tier timeout
+        if (timeout) {
+            promises.push(new Promise((_, reject) => {
+                setTimeout(() => {
+                    const error = new Error(`Tier timed out after ${timeout}ms`);
+                    error.name = 'TimeoutError';
+                    reject(error);
+                }, timeout);
+            }));
+        }
+        return Promise.race(promises);
+    }
+    /**
+     * Get timeout for a tier
+     */
+    getTierTimeout(tier) {
+        if (this.config.timeouts?.[tier]) {
+            return this.config.timeouts[tier];
+        }
+        if (this.config.useDefaultTimeouts) {
+            return DEFAULT_TIER_TIMEOUTS[tier];
+        }
+        return undefined;
+    }
+    /**
+     * Get the next configured tier after the given tier
+     */
+    getNextConfiguredTier(currentTier) {
+        const currentIndex = TIER_ORDER.indexOf(currentTier);
+        for (let i = currentIndex + 1; i < TIER_ORDER.length; i++) {
+            const tier = TIER_ORDER[i];
+            if (tier && this.config.tiers[tier]) {
+                return tier;
+            }
+        }
+        return undefined;
+    }
+    /**
+     * Emit a 5W+H event
+     */
+    emitEvent(event) {
+        if (this.config.onEvent) {
+            this.config.onEvent(event);
+        }
+    }
+    /**
+     * Sleep for a given duration
+     */
+    sleep(ms) {
+        return new Promise((resolve) => setTimeout(resolve, ms));
+    }
+}
+//# sourceMappingURL=cascade-executor.js.map

package/dist/cascade-executor.js.map

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

package/dist/context.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../src/context.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,eAAe,EAA4D,MAAM,YAAY,CAAA;AAE3G;;GAEG;AACH,UAAU,YAAY;IACpB,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CAClD;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,YAAY,GAAG,eAAe,CAwE7E;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,IAAI,eAAe,GAAG;IAAE,gBAAgB,EAAE,MAAM,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,OAAO,CAAA;KAAE,CAAC,CAAA;CAAE,CAa7H"}
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../src/context.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EACV,eAAe,EAOhB,MAAM,YAAY,CAAA;AAGnB;;GAEG;AACH,UAAU,YAAY;IACpB,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CAClD;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,YAAY,GAAG,eAAe,CA+F7E;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,IAAI,eAAe,GAAG;IACzD,gBAAgB,EAAE,MAAM,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,OAAO,CAAA;KAAE,CAAC,CAAA;CAChE,CAaA"}

package/dist/context.js

@@ -1,6 +1,7 @@
 /**
  * Workflow context implementation
  */
+import { getLogger } from './logger.js';
 /**
  * Create a workflow context
  */
@@ -21,20 +22,38 @@ export function createWorkflowContext(eventBus) {
             return new Proxy({}, {
                 get() {
                     return () => { };
-                }
+                },
             });
-        }
+        },
     });
-    const noOpEveryProxy = new Proxy(function () { }, {
+    // Cast to EveryProxy is safe: Proxy handler implements all EveryProxy behaviors dynamically
+    const noOpEveryProxy = new Proxy(
+    // eslint-disable-next-line @typescript-eslint/no-unused-vars
+    ((_description, _handler) => { }), {
         get() {
             return () => () => { };
         },
-        apply() { }
+        apply() { },
     });
     return {
-        async send(event, data) {
+        track(event, data) {
+            // Fire and forget - swallow errors
+            try {
+                addHistory({ type: 'event', name: `track:${event}`, data });
+                eventBus.emit(event, data).catch(() => { });
+            }
+            catch {
+                // Silently swallow errors
+            }
+        },
+        send(event, data) {
+            const eventId = crypto.randomUUID();
             addHistory({ type: 'event', name: event, data });
-            await eventBus.emit(event, data);
+            // Fire async but don't await - guaranteed delivery via event bus
+            eventBus.emit(event, { ...data, _eventId: eventId }).catch((err) => {
+                getLogger().error(`[workflow] Failed to send event ${event}:`, err);
+            });
+            return eventId;
         },
         async do(_event, _data) {
             throw new Error('$.do not available in this context');
@@ -48,7 +67,7 @@ export function createWorkflowContext(eventBus) {
         getState() {
             // Return a deep copy to prevent mutation
             return {
-                current: workflowState.current,
+                ...(workflowState.current !== undefined && { current: workflowState.current }),
                 context: { ...workflowState.context },
                 history: [...workflowState.history],
             };
@@ -61,7 +80,7 @@ export function createWorkflowContext(eventBus) {
         },
         log(message, data) {
             addHistory({ type: 'action', name: 'log', data: { message, data } });
-            console.log(`[workflow] ${message}`, data ?? '');
+            getLogger().log(`[workflow] ${message}`, data ?? '');
         },
     };
 }