@orbytautomation/engine 0.1.0

package/dist/execution/drivers/DriverResolver.d.ts

@@ -0,0 +1,91 @@
+/**
+ * Driver Resolver
+ *
+ * Resolves and dispatches steps to the appropriate execution driver.
+ *
+ * @module execution/drivers
+ */
+import type { ExecutionDriver, DriverStep, DriverContext } from './ExecutionDriver.js';
+import type { AdapterResult } from '@dev-ecosystem/core';
+import { OrbytError } from '../../errors/OrbytError.js';
+/**
+ * Driver not found error
+ */
+export declare class DriverNotFoundError extends OrbytError {
+    constructor(stepId: string, uses: string, availableDrivers: string[]);
+}
+/**
+ * Driver Resolver
+ *
+ * Manages driver registration and resolves steps to appropriate drivers.
+ */
+export declare class DriverResolver {
+    private drivers;
+    private initialized;
+    /**
+     * Register a driver
+     */
+    register(driver: ExecutionDriver): void;
+    /**
+     * Register multiple drivers
+     */
+    registerAll(drivers: ExecutionDriver[]): void;
+    /**
+     * Unregister a driver
+     */
+    unregister(driverType: string): boolean;
+    /**
+     * Resolve driver for a step
+     *
+     * @param step - Step to resolve driver for
+     * @returns Driver that can handle this step
+     * @throws {DriverNotFoundError} If no driver can handle the step
+     */
+    resolve(step: DriverStep): ExecutionDriver;
+    /**
+     * Execute a step using the appropriate driver
+     *
+     * @param step - Step to execute
+     * @param context - Execution context
+     * @returns Execution result
+     */
+    execute(step: DriverStep, context: DriverContext): Promise<AdapterResult>;
+    /**
+     * Get all registered drivers
+     */
+    getAll(): ExecutionDriver[];
+    /**
+     * Get driver by type
+     */
+    get(type: string): ExecutionDriver | undefined;
+    /**
+     * Initialize all drivers
+     */
+    initializeAll(): Promise<void>;
+    /**
+     * Cleanup all drivers
+     */
+    cleanupAll(): Promise<void>;
+    /**
+     * Clear all drivers
+     */
+    clear(): void;
+    /**
+     * Get resolver statistics
+     */
+    getStats(): {
+        total: number;
+        initialized: number;
+        drivers: Array<{
+            type: string;
+            name: string;
+            version: string;
+            isInitialized: boolean;
+        }>;
+    };
+}
+/**
+ * Global driver resolver instance (singleton pattern)
+ */
+export declare const globalDriverResolver: DriverResolver;
+//# sourceMappingURL=DriverResolver.d.ts.map

package/dist/execution/drivers/DriverResolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DriverResolver.d.ts","sourceRoot":"","sources":["../../../src/execution/drivers/DriverResolver.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACvF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AAGxD;;GAEG;AACH,qBAAa,mBAAoB,SAAQ,UAAU;gBACrC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,EAAE;CAcrE;AAED;;;;GAIG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,OAAO,CAAyB;IACxC,OAAO,CAAC,WAAW,CAAqB;IAExC;;OAEG;IACH,QAAQ,CAAC,MAAM,EAAE,eAAe,GAAG,IAAI;IAUvC;;OAEG;IACH,WAAW,CAAC,OAAO,EAAE,eAAe,EAAE,GAAG,IAAI;IAM7C;;OAEG;IACH,UAAU,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO;IAmBvC;;;;;;OAMG;IACH,OAAO,CAAC,IAAI,EAAE,UAAU,GAAG,eAAe;IAY1C;;;;;;OAMG;IACG,OAAO,CACX,IAAI,EAAE,UAAU,EAChB,OAAO,EAAE,aAAa,GACrB,OAAO,CAAC,aAAa,CAAC;IAezB;;OAEG;IACH,MAAM,IAAI,eAAe,EAAE;IAI3B;;OAEG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS;IAI9C;;OAEG;IACG,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC;IAWpC;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IASjC;;OAEG;IACH,KAAK,IAAI,IAAI;IAKb;;OAEG;IACH,QAAQ,IAAI;QACV,KAAK,EAAE,MAAM,CAAC;QACd,WAAW,EAAE,MAAM,CAAC;QACpB,OAAO,EAAE,KAAK,CAAC;YACb,IAAI,EAAE,MAAM,CAAC;YACb,IAAI,EAAE,MAAM,CAAC;YACb,OAAO,EAAE,MAAM,CAAC;YAChB,aAAa,EAAE,OAAO,CAAC;SACxB,CAAC,CAAC;KACJ;CAYF;AAED;;GAEG;AACH,eAAO,MAAM,oBAAoB,gBAAuB,CAAC"}

package/dist/execution/drivers/DriverResolver.js

@@ -0,0 +1,172 @@
+/**
+ * Driver Resolver
+ *
+ * Resolves and dispatches steps to the appropriate execution driver.
+ *
+ * @module execution/drivers
+ */
+import { OrbytError } from '../../errors/OrbytError.js';
+import { OrbytErrorCode, ErrorSeverity } from '../../errors/ErrorCodes.js';
+/**
+ * Driver not found error
+ */
+export class DriverNotFoundError extends OrbytError {
+    constructor(stepId, uses, availableDrivers) {
+        super({
+            code: OrbytErrorCode.EXECUTION_ADAPTER_ERROR,
+            message: `No driver found to execute step '${stepId}' with uses '${uses}'`,
+            severity: ErrorSeverity.ERROR,
+            path: `workflow.steps.${stepId}`,
+            hint: `Available drivers: ${availableDrivers.join(', ')}. Check your step configuration.`,
+            context: {
+                stepId,
+                uses,
+                availableDrivers,
+            },
+        });
+    }
+}
+/**
+ * Driver Resolver
+ *
+ * Manages driver registration and resolves steps to appropriate drivers.
+ */
+export class DriverResolver {
+    drivers = [];
+    initialized = new Set();
+    /**
+     * Register a driver
+     */
+    register(driver) {
+        // Check for duplicate
+        const existing = this.drivers.find(d => d.type === driver.type);
+        if (existing) {
+            throw new Error(`Driver '${driver.type}' is already registered`);
+        }
+        this.drivers.push(driver);
+    }
+    /**
+     * Register multiple drivers
+     */
+    registerAll(drivers) {
+        for (const driver of drivers) {
+            this.register(driver);
+        }
+    }
+    /**
+     * Unregister a driver
+     */
+    unregister(driverType) {
+        const index = this.drivers.findIndex(d => d.type === driverType);
+        if (index !== -1) {
+            const driver = this.drivers[index];
+            // Cleanup if initialized
+            if (this.initialized.has(driverType) && driver.cleanup) {
+                driver.cleanup().catch(err => {
+                    console.error(`Error cleaning up driver ${driverType}:`, err);
+                });
+            }
+            this.initialized.delete(driverType);
+            this.drivers.splice(index, 1);
+            return true;
+        }
+        return false;
+    }
+    /**
+     * Resolve driver for a step
+     *
+     * @param step - Step to resolve driver for
+     * @returns Driver that can handle this step
+     * @throws {DriverNotFoundError} If no driver can handle the step
+     */
+    resolve(step) {
+        for (const driver of this.drivers) {
+            if (driver.canHandle(step)) {
+                return driver;
+            }
+        }
+        // No driver found
+        const availableDrivers = this.drivers.map(d => d.type);
+        throw new DriverNotFoundError(step.id, step.uses, availableDrivers);
+    }
+    /**
+     * Execute a step using the appropriate driver
+     *
+     * @param step - Step to execute
+     * @param context - Execution context
+     * @returns Execution result
+     */
+    async execute(step, context) {
+        // Resolve driver
+        const driver = this.resolve(step);
+        // Initialize driver if needed
+        if (!this.initialized.has(driver.type) && driver.initialize) {
+            await driver.initialize();
+            this.initialized.add(driver.type);
+        }
+        // Execute step
+        context.log(`Using driver: ${driver.name} (${driver.type})`);
+        return driver.execute(step, context);
+    }
+    /**
+     * Get all registered drivers
+     */
+    getAll() {
+        return [...this.drivers];
+    }
+    /**
+     * Get driver by type
+     */
+    get(type) {
+        return this.drivers.find(d => d.type === type);
+    }
+    /**
+     * Initialize all drivers
+     */
+    async initializeAll() {
+        const initPromises = this.drivers
+            .filter(d => d.initialize && !this.initialized.has(d.type))
+            .map(async (d) => {
+            await d.initialize();
+            this.initialized.add(d.type);
+        });
+        await Promise.all(initPromises);
+    }
+    /**
+     * Cleanup all drivers
+     */
+    async cleanupAll() {
+        const cleanupPromises = this.drivers
+            .filter(d => d.cleanup)
+            .map(d => d.cleanup());
+        await Promise.allSettled(cleanupPromises);
+        this.initialized.clear();
+    }
+    /**
+     * Clear all drivers
+     */
+    clear() {
+        this.drivers = [];
+        this.initialized.clear();
+    }
+    /**
+     * Get resolver statistics
+     */
+    getStats() {
+        return {
+            total: this.drivers.length,
+            initialized: this.initialized.size,
+            drivers: this.drivers.map(d => ({
+                type: d.type,
+                name: d.name,
+                version: d.version,
+                isInitialized: this.initialized.has(d.type),
+            })),
+        };
+    }
+}
+/**
+ * Global driver resolver instance (singleton pattern)
+ */
+export const globalDriverResolver = new DriverResolver();
+//# sourceMappingURL=DriverResolver.js.map

package/dist/execution/drivers/DriverResolver.js.map

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

package/dist/execution/drivers/ExecutionDriver.d.ts

@@ -0,0 +1,127 @@
+/**
+ * Execution Driver System
+ *
+ * Drivers determine HOW steps are executed, while adapters determine WHAT is executed.
+ * This abstraction allows the engine to support multiple execution strategies.
+ *
+ * @module execution/drivers
+ */
+import type { AdapterResult } from '@dev-ecosystem/core';
+/**
+ * Step execution context for drivers
+ */
+export interface DriverContext {
+    /** Current step ID */
+    stepId: string;
+    /** Workflow execution ID */
+    executionId: string;
+    /** Workflow name */
+    workflowName: string;
+    /** Logger function */
+    log: (message: string, level?: 'info' | 'warn' | 'error' | 'debug') => void;
+    /** Abort signal for cancellation */
+    signal?: AbortSignal;
+    /** Step timeout in milliseconds */
+    timeout?: number;
+    /** Working directory */
+    cwd?: string;
+    /** Environment variables */
+    env?: Record<string, string>;
+    /** Secrets access */
+    secrets?: Record<string, string>;
+    /** Temporary directory */
+    tempDir?: string;
+    /** Previous step outputs */
+    stepOutputs?: Record<string, any>;
+    /** Workflow inputs */
+    inputs?: Record<string, any>;
+    /** Workflow context */
+    workflowContext?: Record<string, any>;
+}
+/**
+ * Step definition for driver execution
+ */
+export interface DriverStep {
+    /** Step ID */
+    id: string;
+    /** Step name (optional) */
+    name?: string;
+    /** Action to execute (e.g., 'http.request.get', 'cli.run') */
+    uses: string;
+    /** Input parameters */
+    with?: Record<string, any>;
+    /** Conditional execution */
+    when?: string;
+    /** Environment variables */
+    env?: Record<string, string>;
+    /** Retry configuration */
+    retry?: {
+        max: number;
+        backoff?: 'linear' | 'exponential';
+        delay?: number;
+    };
+    /** Timeout */
+    timeout?: string;
+    /** Continue on error */
+    continueOnError?: boolean;
+}
+/**
+ * Base execution driver interface
+ */
+export interface ExecutionDriver {
+    /** Driver type identifier */
+    readonly type: string;
+    /** Driver name */
+    readonly name: string;
+    /** Driver version */
+    readonly version: string;
+    /** Driver description */
+    readonly description?: string;
+    /**
+     * Check if this driver can handle a step
+     *
+     * @param step - Step to check
+     * @returns True if driver can handle this step
+     */
+    canHandle(step: DriverStep): boolean;
+    /**
+     * Execute a step
+     *
+     * @param step - Step to execute
+     * @param context - Execution context
+     * @returns Execution result
+     */
+    execute(step: DriverStep, context: DriverContext): Promise<AdapterResult>;
+    /**
+     * Optional: Initialize driver
+     */
+    initialize?(): Promise<void>;
+    /**
+     * Optional: Cleanup driver
+     */
+    cleanup?(): Promise<void>;
+}
+/**
+ * Base driver implementation with common logic
+ */
+export declare abstract class BaseDriver implements ExecutionDriver {
+    abstract readonly type: string;
+    abstract readonly name: string;
+    abstract readonly version: string;
+    abstract readonly description?: string;
+    abstract canHandle(step: DriverStep): boolean;
+    abstract execute(step: DriverStep, context: DriverContext): Promise<AdapterResult>;
+    /**
+     * Validate step has required fields
+     */
+    protected validateStep(step: DriverStep, required: string[]): void;
+    /**
+     * Get step input with default value
+     */
+    protected getStepInput<T>(step: DriverStep, key: string, defaultValue: T): T;
+    /**
+     * Parse timeout string to milliseconds
+     */
+    protected parseTimeout(timeout?: string): number | undefined;
+}
+//# sourceMappingURL=ExecutionDriver.d.ts.map

package/dist/execution/drivers/ExecutionDriver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ExecutionDriver.d.ts","sourceRoot":"","sources":["../../../src/execution/drivers/ExecutionDriver.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEzD;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,sBAAsB;IACtB,MAAM,EAAE,MAAM,CAAC;IAEf,4BAA4B;IAC5B,WAAW,EAAE,MAAM,CAAC;IAEpB,oBAAoB;IACpB,YAAY,EAAE,MAAM,CAAC;IAErB,sBAAsB;IACtB,GAAG,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,OAAO,KAAK,IAAI,CAAC;IAE5E,oCAAoC;IACpC,MAAM,CAAC,EAAE,WAAW,CAAC;IAErB,mCAAmC;IACnC,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,wBAAwB;IACxB,GAAG,CAAC,EAAE,MAAM,CAAC;IAEb,4BAA4B;IAC5B,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAE7B,qBAAqB;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAEjC,0BAA0B;IAC1B,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,4BAA4B;IAC5B,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAElC,sBAAsB;IACtB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAE7B,uBAAuB;IACvB,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CACvC;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,cAAc;IACd,EAAE,EAAE,MAAM,CAAC;IAEX,2BAA2B;IAC3B,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd,8DAA8D;IAC9D,IAAI,EAAE,MAAM,CAAC;IAEb,uBAAuB;IACvB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAE3B,4BAA4B;IAC5B,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd,4BAA4B;IAC5B,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAE7B,0BAA0B;IAC1B,KAAK,CAAC,EAAE;QACN,GAAG,EAAE,MAAM,CAAC;QACZ,OAAO,CAAC,EAAE,QAAQ,GAAG,aAAa,CAAC;QACnC,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,CAAC;IAEF,cAAc;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,wBAAwB;IACxB,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,6BAA6B;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB,kBAAkB;IAClB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB,qBAAqB;IACrB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IAEzB,yBAAyB;IACzB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAE9B;;;;;OAKG;IACH,SAAS,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC;IAErC;;;;;;OAMG;IACH,OAAO,CACL,IAAI,EAAE,UAAU,EAChB,OAAO,EAAE,aAAa,GACrB,OAAO,CAAC,aAAa,CAAC,CAAC;IAE1B;;OAEG;IACH,UAAU,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAE7B;;OAEG;IACH,OAAO,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3B;AAED;;GAEG;AACH,8BAAsB,UAAW,YAAW,eAAe;IACzD,QAAQ,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAEvC,QAAQ,CAAC,SAAS,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO;IAE7C,QAAQ,CAAC,OAAO,CACd,IAAI,EAAE,UAAU,EAChB,OAAO,EAAE,aAAa,GACrB,OAAO,CAAC,aAAa,CAAC;IAEzB;;OAEG;IACH,SAAS,CAAC,YAAY,CAAC,IAAI,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,IAAI;IAUlE;;OAEG;IACH,SAAS,CAAC,YAAY,CAAC,CAAC,EACtB,IAAI,EAAE,UAAU,EAChB,GAAG,EAAE,MAAM,EACX,YAAY,EAAE,CAAC,GACd,CAAC;IAIJ;;OAEG;IACH,SAAS,CAAC,YAAY,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;CAmB7D"}

package/dist/execution/drivers/ExecutionDriver.js

@@ -0,0 +1,50 @@
+/**
+ * Execution Driver System
+ *
+ * Drivers determine HOW steps are executed, while adapters determine WHAT is executed.
+ * This abstraction allows the engine to support multiple execution strategies.
+ *
+ * @module execution/drivers
+ */
+/**
+ * Base driver implementation with common logic
+ */
+export class BaseDriver {
+    /**
+     * Validate step has required fields
+     */
+    validateStep(step, required) {
+        for (const field of required) {
+            if (!(field in step)) {
+                throw new Error(`${this.name} driver: step missing required field '${field}'`);
+            }
+        }
+    }
+    /**
+     * Get step input with default value
+     */
+    getStepInput(step, key, defaultValue) {
+        return step.with?.[key] !== undefined ? step.with[key] : defaultValue;
+    }
+    /**
+     * Parse timeout string to milliseconds
+     */
+    parseTimeout(timeout) {
+        if (!timeout)
+            return undefined;
+        const match = timeout.match(/^(\d+)(ms|s|m|h)$/);
+        if (!match) {
+            throw new Error(`Invalid timeout format: ${timeout}`);
+        }
+        const value = parseInt(match[1], 10);
+        const unit = match[2];
+        switch (unit) {
+            case 'ms': return value;
+            case 's': return value * 1000;
+            case 'm': return value * 60 * 1000;
+            case 'h': return value * 60 * 60 * 1000;
+            default: return value;
+        }
+    }
+}
+//# sourceMappingURL=ExecutionDriver.js.map

package/dist/execution/drivers/ExecutionDriver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ExecutionDriver.js","sourceRoot":"","sources":["../../../src/execution/drivers/ExecutionDriver.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAmIH;;GAEG;AACH,MAAM,OAAgB,UAAU;IAa9B;;OAEG;IACO,YAAY,CAAC,IAAgB,EAAE,QAAkB;QACzD,KAAK,MAAM,KAAK,IAAI,QAAQ,EAAE,CAAC;YAC7B,IAAI,CAAC,CAAC,KAAK,IAAI,IAAI,CAAC,EAAE,CAAC;gBACrB,MAAM,IAAI,KAAK,CACb,GAAG,IAAI,CAAC,IAAI,yCAAyC,KAAK,GAAG,CAC9D,CAAC;YACJ,CAAC;QACH,CAAC;IACH,CAAC;IAED;;OAEG;IACO,YAAY,CACpB,IAAgB,EAChB,GAAW,EACX,YAAe;QAEf,OAAO,IAAI,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC;IACxE,CAAC;IAED;;OAEG;IACO,YAAY,CAAC,OAAgB;QACrC,IAAI,CAAC,OAAO;YAAE,OAAO,SAAS,CAAC;QAE/B,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,mBAAmB,CAAC,CAAC;QACjD,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,MAAM,IAAI,KAAK,CAAC,2BAA2B,OAAO,EAAE,CAAC,CAAC;QACxD,CAAC;QAED,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QACrC,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;QAEtB,QAAQ,IAAI,EAAE,CAAC;YACb,KAAK,IAAI,CAAC,CAAC,OAAO,KAAK,CAAC;YACxB,KAAK,GAAG,CAAC,CAAC,OAAO,KAAK,GAAG,IAAI,CAAC;YAC9B,KAAK,GAAG,CAAC,CAAC,OAAO,KAAK,GAAG,EAAE,GAAG,IAAI,CAAC;YACnC,KAAK,GAAG,CAAC,CAAC,OAAO,KAAK,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;YACxC,OAAO,CAAC,CAAC,OAAO,KAAK,CAAC;QACxB,CAAC;IACH,CAAC;CACF"}

package/dist/execution/drivers/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Execution Drivers
+ *
+ * Driver system for pluggable step execution strategies.
+ *
+ * @module execution/drivers
+ */
+export * from './ExecutionDriver.js';
+export * from './DriverResolver.js';
+export * from './AdapterDriver.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/execution/drivers/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/execution/drivers/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,cAAc,sBAAsB,CAAC;AACrC,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC"}

package/dist/execution/drivers/index.js

@@ -0,0 +1,11 @@
+/**
+ * Execution Drivers
+ *
+ * Driver system for pluggable step execution strategies.
+ *
+ * @module execution/drivers
+ */
+export * from './ExecutionDriver.js';
+export * from './DriverResolver.js';
+export * from './AdapterDriver.js';
+//# sourceMappingURL=index.js.map

package/dist/execution/drivers/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/execution/drivers/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,cAAc,sBAAsB,CAAC;AACrC,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC"}

package/dist/execution/index.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Execution Layer
+ *
+ * Handles workflow execution planning and orchestration:
+ * - ExecutionNode: Pure data model for execution steps
+ * - ExecutionPlan: Coordinates graph analysis to create execution plans
+ * - StepExecutor: Executes individual steps with retry/timeout
+ * - WorkflowExecutor: Orchestrates full workflow execution
+ * - ExecutionEngine: Main orchestrator integrating scheduling, queueing, and execution
+ * - Drivers: Pluggable execution strategies (optional enhancement)
+ */
+export * from './ExecutionNode.js';
+export * from './ExecutionPlan.js';
+export * from './StepExecutor.js';
+export * from './WorkflowExecutor.js';
+export * from './ExecutionEngine.js';
+export * from './drivers/index.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/execution/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/execution/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,uBAAuB,CAAC;AACtC,cAAc,sBAAsB,CAAC;AAGrC,cAAc,oBAAoB,CAAC"}

package/dist/execution/index.js

@@ -0,0 +1,19 @@
+/**
+ * Execution Layer
+ *
+ * Handles workflow execution planning and orchestration:
+ * - ExecutionNode: Pure data model for execution steps
+ * - ExecutionPlan: Coordinates graph analysis to create execution plans
+ * - StepExecutor: Executes individual steps with retry/timeout
+ * - WorkflowExecutor: Orchestrates full workflow execution
+ * - ExecutionEngine: Main orchestrator integrating scheduling, queueing, and execution
+ * - Drivers: Pluggable execution strategies (optional enhancement)
+ */
+export * from './ExecutionNode.js';
+export * from './ExecutionPlan.js';
+export * from './StepExecutor.js';
+export * from './WorkflowExecutor.js';
+export * from './ExecutionEngine.js';
+// Optional: Driver system for advanced execution strategies
+export * from './drivers/index.js';
+//# sourceMappingURL=index.js.map

package/dist/execution/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/execution/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,uBAAuB,CAAC;AACtC,cAAc,sBAAsB,CAAC;AAErC,4DAA4D;AAC5D,cAAc,oBAAoB,CAAC"}

package/dist/graph/CycleDetector.d.ts

@@ -0,0 +1,90 @@
+/**
+ * CycleDetector
+ *
+ * Detects cycles in the dependency graph using Depth-First Search (DFS).
+ * This is about VALIDATION - fail fast with clear error messages.
+ *
+ * Purpose:
+ * - Detect circular dependencies before execution
+ * - Provide clear error messages showing the cycle path
+ * - Fail fast - prevent impossible execution plans
+ *
+ * Algorithm: DFS with three-color marking
+ * - WHITE (unvisited): Node not yet explored
+ * - GRAY (visiting): Node currently in DFS path (on stack)
+ * - BLACK (visited): Node fully explored, all descendants visited
+ *
+ * A cycle exists if we encounter a GRAY node during traversal.
+ *
+ * What it does NOT do:
+ * - Does NOT order the graph (that's TopologicalSort's job)
+ * - Does NOT execute anything (that's StepExecutor's job)
+ * - Does NOT schedule steps (that's WorkflowExecutor's job)
+ */
+import { DependencyGraph } from './DependencyResolver.js';
+/**
+ * Result of cycle detection
+ */
+export interface CycleDetectionResult {
+    /** Whether a cycle was detected */
+    readonly hasCycle: boolean;
+    /** The cycle path if one was found (e.g., ['A', 'B', 'C', 'A']) */
+    readonly cyclePath?: readonly string[];
+}
+/**
+ * Detects cycles in dependency graphs.
+ * Pure function - takes graph, returns cycle information.
+ */
+export declare class CycleDetector {
+    /**
+     * Check if the graph contains a cycle.
+     * Uses DFS with three-color marking.
+     *
+     * @param graph - The dependency graph to check
+     * @returns Cycle detection result
+     */
+    static detect(graph: DependencyGraph): CycleDetectionResult;
+    /**
+     * Depth-first search to detect cycles.
+     *
+     * @param nodeId - Current node being visited
+     * @param graph - The dependency graph
+     * @param visitState - Visit state for each node
+     * @param parent - Parent pointers for cycle reconstruction
+     * @returns Cycle detection result
+     */
+    private static dfs;
+    /**
+     * Reconstruct the cycle path from parent pointers.
+     *
+     * @param start - Node where cycle was detected
+     * @param cycleNode - The GRAY node that created the cycle
+     * @param parent - Parent pointers
+     * @returns The cycle path
+     */
+    private static reconstructCycle;
+    /**
+     * Check for cycles and throw if found (convenience method).
+     * This is the "fail fast" version.
+     *
+     * @param graph - The dependency graph to check
+     * @throws WorkflowValidationError if a cycle is detected
+     */
+    static detectAndThrow(graph: DependencyGraph): void;
+    /**
+     * Find all strongly connected components (SCCs) in the graph.
+     * This is more advanced than simple cycle detection - it finds
+     * all groups of nodes that form cycles with each other.
+     *
+     * Uses Tarjan's algorithm.
+     *
+     * @param graph - The dependency graph
+     * @returns Array of strongly connected components (each is an array of step IDs)
+     */
+    static findStronglyConnectedComponents(graph: DependencyGraph): string[][];
+    /**
+     * Tarjan's SCC algorithm helper
+     */
+    private static strongConnect;
+}
+//# sourceMappingURL=CycleDetector.d.ts.map

package/dist/graph/CycleDetector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CycleDetector.d.ts","sourceRoot":"","sources":["../../src/graph/CycleDetector.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAGH,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAE1D;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,mCAAmC;IACnC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,mEAAmE;IACnE,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CACxC;AAcD;;;GAGG;AACH,qBAAa,aAAa;IACxB;;;;;;OAMG;IACH,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,eAAe,GAAG,oBAAoB;IAsB3D;;;;;;;;OAQG;IACH,OAAO,CAAC,MAAM,CAAC,GAAG;IA0ClB;;;;;;;OAOG;IACH,OAAO,CAAC,MAAM,CAAC,gBAAgB;IAsB/B;;;;;;OAMG;IACH,MAAM,CAAC,cAAc,CAAC,KAAK,EAAE,eAAe,GAAG,IAAI;IAiBnD;;;;;;;;;OASG;IACH,MAAM,CAAC,+BAA+B,CAAC,KAAK,EAAE,eAAe,GAAG,MAAM,EAAE,EAAE;IA0B1E;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,aAAa;CAyD7B"}