@orbytautomation/engine 0.1.0

package/dist/guards/StepGuard.js

@@ -0,0 +1,184 @@
+/**
+ * Step Guard
+ *
+ * Validates individual step configurations:
+ * - Step structure validation
+ * - Input parameter validation
+ * - Timeout validation
+ * - Retry policy validation
+ *
+ * @module guards
+ */
+import { VariableResolver } from '../context/VariableResolver.js';
+/**
+ * Step validation guard
+ */
+export class StepGuard {
+    /**
+     * Validate a single step
+     *
+     * @param step - Step to validate
+     * @param availableSteps - Set of all step IDs in workflow
+     * @throws {Error} If validation fails
+     */
+    static validate(step, availableSteps) {
+        this.validateRequired(step);
+        this.validateTimeout(step);
+        this.validateRetryPolicy(step);
+        this.validateDependencies(step, availableSteps);
+        this.validateVariableReferences(step, availableSteps);
+    }
+    /**
+     * Validate required fields
+     *
+     * @param step - Step to validate
+     * @throws {Error} If required fields missing
+     */
+    static validateRequired(step) {
+        if (!step.id || typeof step.id !== 'string') {
+            throw new Error('Step missing required field: id (string)');
+        }
+        if (!step.action || typeof step.action !== 'string') {
+            throw new Error(`Step '${step.id}' missing required field: uses/action`);
+        }
+        if (!step.adapter || typeof step.adapter !== 'string') {
+            throw new Error(`Step '${step.id}' missing adapter type`);
+        }
+    }
+    /**
+     * Validate timeout values
+     *
+     * @param step - Step to validate
+     * @throws {Error} If timeout invalid
+     */
+    static validateTimeout(step) {
+        if (step.timeout !== undefined) {
+            if (typeof step.timeout !== 'number' || step.timeout <= 0) {
+                throw new Error(`Step '${step.id}': timeout must be a positive number (milliseconds)`);
+            }
+            // Warn about very large timeouts (> 24 hours)
+            if (step.timeout > 24 * 60 * 60 * 1000) {
+                console.warn(`Step '${step.id}': timeout is very large (${step.timeout}ms = ${Math.round(step.timeout / 3600000)}h)`);
+            }
+        }
+    }
+    /**
+     * Validate retry policy
+     *
+     * @param step - Step to validate
+     * @throws {Error} If retry policy invalid
+     */
+    static validateRetryPolicy(step) {
+        if (step.retry) {
+            const { max, delay } = step.retry;
+            if (max < 0 || max > 10) {
+                throw new Error(`Step '${step.id}': retry.max must be between 0 and 10`);
+            }
+            if (delay !== undefined && delay < 0) {
+                throw new Error(`Step '${step.id}': retry.delay must be positive (got ${delay}ms)`);
+            }
+        }
+    }
+    /**
+     * Validate step dependencies exist
+     *
+     * @param step - Step to validate
+     * @param availableSteps - Set of all step IDs
+     * @throws {Error} If dependency doesn't exist
+     */
+    static validateDependencies(step, availableSteps) {
+        for (const depId of step.needs) {
+            if (!availableSteps.has(depId)) {
+                throw new Error(`Step '${step.id}' depends on unknown step '${depId}'`);
+            }
+            // Check for self-dependency
+            if (depId === step.id) {
+                throw new Error(`Step '${step.id}' cannot depend on itself`);
+            }
+        }
+    }
+    /**
+     * Validate variable references in step inputs
+     *
+     * @param step - Step to validate
+     * @param availableSteps - Set of all step IDs
+     * @throws {Error} If variable references unknown step
+     */
+    static validateVariableReferences(step, availableSteps) {
+        try {
+            VariableResolver.validateStepReferences(step.input, availableSteps);
+        }
+        catch (error) {
+            if (error instanceof Error) {
+                throw new Error(`Step '${step.id}': ${error.message}`);
+            }
+            throw error;
+        }
+    }
+    /**
+     * Validate adapter-specific requirements
+     *
+     * @param step - Step to validate
+     * @throws {Error} If adapter requirements not met
+     */
+    static validateAdapterRequirements(step) {
+        switch (step.adapter) {
+            case 'http':
+                this.validateHttpAdapter(step);
+                break;
+            case 'shell':
+                this.validateShellAdapter(step);
+                break;
+            case 'cli':
+                this.validateCliAdapter(step);
+                break;
+            // Add more adapter validations as needed
+        }
+    }
+    /**
+     * Validate HTTP adapter requirements
+     */
+    static validateHttpAdapter(step) {
+        const required = ['url'];
+        for (const field of required) {
+            if (!step.input[field]) {
+                throw new Error(`Step '${step.id}' (http adapter): missing required input '${field}'`);
+            }
+        }
+    }
+    /**
+     * Validate shell adapter requirements
+     */
+    static validateShellAdapter(step) {
+        if (!step.input.command && !step.input.script) {
+            throw new Error(`Step '${step.id}' (shell adapter): must provide either 'command' or 'script'`);
+        }
+    }
+    /**
+     * Validate CLI adapter requirements
+     */
+    static validateCliAdapter(step) {
+        if (!step.input.command) {
+            throw new Error(`Step '${step.id}' (cli adapter): missing required input 'command'`);
+        }
+    }
+    /**
+     * Check if step has any conditional execution
+     *
+     * @param step - Step to check
+     * @returns True if step has 'when' condition
+     */
+    static isConditional(step) {
+        return !!step.when;
+    }
+    /**
+     * Check if step is retryable
+     *
+     * @param step - Step to check
+     * @returns True if step has retry policy configured
+     */
+    static isRetryable(step) {
+        return !!step.retry && step.retry.max > 0;
+    }
+}
+//# sourceMappingURL=StepGuard.js.map

package/dist/guards/StepGuard.js.map

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

package/dist/guards/WorkflowGuard.d.ts

@@ -0,0 +1,71 @@
+/**
+ * Workflow Guard
+ *
+ * Validates workflow-level concerns:
+ * - Circular dependency detection
+ * - Step dependency validation
+ * - Workflow structure validation
+ *
+ * @module guards
+ */
+import type { ParsedStep } from '../parser/StepParser.js';
+/**
+ * Workflow validation guard
+ */
+export declare class WorkflowGuard {
+    /**
+     * Validate entire workflow structure
+     *
+     * @param steps - Array of workflow steps
+     * @throws {Error} If validation fails
+     */
+    static validate(steps: ParsedStep[]): void;
+    /**
+     * Validate all step IDs are unique
+     *
+     * @param steps - Array of workflow steps
+     * @throws {Error} If duplicate IDs found
+     */
+    private static validateStepIds;
+    /**
+     * Validate all step dependencies exist
+     *
+     * @param steps - Array of workflow steps
+     * @throws {Error} If dependency references non-existent step
+     */
+    private static validateDependencies;
+    /**
+     * Detect circular dependencies in workflow
+     *
+     * Uses depth-first search with cycle detection.
+     *
+     * @param steps - Array of workflow steps
+     * @throws {Error} If circular dependency detected
+     */
+    private static detectCircularDependencies;
+    /**
+     * Calculate topological order (execution order respecting dependencies)
+     *
+     * @param steps - Array of workflow steps
+     * @returns Steps ordered by dependencies
+     * @throws {Error} If circular dependency exists
+     */
+    static getExecutionOrder(steps: ParsedStep[]): ParsedStep[];
+    /**
+     * Get all steps that depend on a given step
+     *
+     * @param stepId - Step ID to check
+     * @param steps - Array of workflow steps
+     * @returns Array of step IDs that depend on the given step
+     */
+    static getDependents(stepId: string, steps: ParsedStep[]): string[];
+    /**
+     * Get all dependencies of a step (recursive)
+     *
+     * @param stepId - Step ID to check
+     * @param steps - Array of workflow steps
+     * @returns Set of all transitive dependencies
+     */
+    static getAllDependencies(stepId: string, steps: ParsedStep[]): Set<string>;
+}
+//# sourceMappingURL=WorkflowGuard.d.ts.map

package/dist/guards/WorkflowGuard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WorkflowGuard.d.ts","sourceRoot":"","sources":["../../src/guards/WorkflowGuard.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAE1D;;GAEG;AACH,qBAAa,aAAa;IACxB;;;;;OAKG;IACH,MAAM,CAAC,QAAQ,CAAC,KAAK,EAAE,UAAU,EAAE,GAAG,IAAI;IAM1C;;;;;OAKG;IACH,OAAO,CAAC,MAAM,CAAC,eAAe;IAW9B;;;;;OAKG;IACH,OAAO,CAAC,MAAM,CAAC,oBAAoB;IAcnC;;;;;;;OAOG;IACH,OAAO,CAAC,MAAM,CAAC,0BAA0B;IA4CzC;;;;;;OAMG;IACH,MAAM,CAAC,iBAAiB,CAAC,KAAK,EAAE,UAAU,EAAE,GAAG,UAAU,EAAE;IA0D3D;;;;;;OAMG;IACH,MAAM,CAAC,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,EAAE,GAAG,MAAM,EAAE;IAMnE;;;;;;OAMG;IACH,MAAM,CAAC,kBAAkB,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,EAAE,GAAG,GAAG,CAAC,MAAM,CAAC;CAmB5E"}

package/dist/guards/WorkflowGuard.js

@@ -0,0 +1,187 @@
+/**
+ * Workflow Guard
+ *
+ * Validates workflow-level concerns:
+ * - Circular dependency detection
+ * - Step dependency validation
+ * - Workflow structure validation
+ *
+ * @module guards
+ */
+/**
+ * Workflow validation guard
+ */
+export class WorkflowGuard {
+    /**
+     * Validate entire workflow structure
+     *
+     * @param steps - Array of workflow steps
+     * @throws {Error} If validation fails
+     */
+    static validate(steps) {
+        this.validateStepIds(steps);
+        this.validateDependencies(steps);
+        this.detectCircularDependencies(steps);
+    }
+    /**
+     * Validate all step IDs are unique
+     *
+     * @param steps - Array of workflow steps
+     * @throws {Error} If duplicate IDs found
+     */
+    static validateStepIds(steps) {
+        const ids = steps.map(s => s.id);
+        const duplicates = ids.filter((id, index) => ids.indexOf(id) !== index);
+        if (duplicates.length > 0) {
+            throw new Error(`Duplicate step IDs found: ${[...new Set(duplicates)].join(', ')}`);
+        }
+    }
+    /**
+     * Validate all step dependencies exist
+     *
+     * @param steps - Array of workflow steps
+     * @throws {Error} If dependency references non-existent step
+     */
+    static validateDependencies(steps) {
+        const stepIds = new Set(steps.map(s => s.id));
+        for (const step of steps) {
+            for (const depId of step.needs) {
+                if (!stepIds.has(depId)) {
+                    throw new Error(`Step '${step.id}' depends on non-existent step '${depId}'`);
+                }
+            }
+        }
+    }
+    /**
+     * Detect circular dependencies in workflow
+     *
+     * Uses depth-first search with cycle detection.
+     *
+     * @param steps - Array of workflow steps
+     * @throws {Error} If circular dependency detected
+     */
+    static detectCircularDependencies(steps) {
+        // Build adjacency map
+        const graph = new Map();
+        for (const step of steps) {
+            graph.set(step.id, step.needs);
+        }
+        // Track visited nodes during DFS
+        const visiting = new Set();
+        const visited = new Set();
+        const dfs = (stepId, path) => {
+            if (visiting.has(stepId)) {
+                // Found cycle
+                const cycleStart = path.indexOf(stepId);
+                const cycle = [...path.slice(cycleStart), stepId];
+                throw new Error(`Circular dependency detected: ${cycle.join(' -> ')}`);
+            }
+            if (visited.has(stepId)) {
+                return; // Already processed
+            }
+            visiting.add(stepId);
+            const dependencies = graph.get(stepId) || [];
+            for (const depId of dependencies) {
+                dfs(depId, [...path, stepId]);
+            }
+            visiting.delete(stepId);
+            visited.add(stepId);
+        };
+        // Check from each step
+        for (const step of steps) {
+            if (!visited.has(step.id)) {
+                dfs(step.id, []);
+            }
+        }
+    }
+    /**
+     * Calculate topological order (execution order respecting dependencies)
+     *
+     * @param steps - Array of workflow steps
+     * @returns Steps ordered by dependencies
+     * @throws {Error} If circular dependency exists
+     */
+    static getExecutionOrder(steps) {
+        // Build adjacency map and in-degree count
+        const graph = new Map();
+        const inDegree = new Map();
+        const stepMap = new Map();
+        for (const step of steps) {
+            stepMap.set(step.id, step);
+            graph.set(step.id, step.needs);
+            inDegree.set(step.id, 0);
+        }
+        // Count in-degrees
+        for (const step of steps) {
+            for (const depId of step.needs) {
+                inDegree.set(depId, (inDegree.get(depId) || 0) + 1);
+            }
+        }
+        // Kahn's algorithm for topological sort
+        const queue = [];
+        const result = [];
+        // Start with nodes that have no dependencies
+        for (const [stepId, degree] of inDegree.entries()) {
+            if (degree === 0) {
+                queue.push(stepId);
+            }
+        }
+        while (queue.length > 0) {
+            const stepId = queue.shift();
+            const step = stepMap.get(stepId);
+            result.push(step);
+            // Process dependents
+            for (const [otherId, deps] of graph.entries()) {
+                if (deps.includes(stepId)) {
+                    const newDegree = (inDegree.get(otherId) || 0) - 1;
+                    inDegree.set(otherId, newDegree);
+                    if (newDegree === 0) {
+                        queue.push(otherId);
+                    }
+                }
+            }
+        }
+        // Check if all steps were processed
+        if (result.length !== steps.length) {
+            throw new Error('Circular dependency detected - cannot determine execution order');
+        }
+        return result;
+    }
+    /**
+     * Get all steps that depend on a given step
+     *
+     * @param stepId - Step ID to check
+     * @param steps - Array of workflow steps
+     * @returns Array of step IDs that depend on the given step
+     */
+    static getDependents(stepId, steps) {
+        return steps
+            .filter(step => step.needs.includes(stepId))
+            .map(step => step.id);
+    }
+    /**
+     * Get all dependencies of a step (recursive)
+     *
+     * @param stepId - Step ID to check
+     * @param steps - Array of workflow steps
+     * @returns Set of all transitive dependencies
+     */
+    static getAllDependencies(stepId, steps) {
+        const stepMap = new Map(steps.map(s => [s.id, s]));
+        const dependencies = new Set();
+        const collect = (id) => {
+            const step = stepMap.get(id);
+            if (!step)
+                return;
+            for (const depId of step.needs) {
+                if (!dependencies.has(depId)) {
+                    dependencies.add(depId);
+                    collect(depId);
+                }
+            }
+        };
+        collect(stepId);
+        return dependencies;
+    }
+}
+//# sourceMappingURL=WorkflowGuard.js.map

package/dist/guards/WorkflowGuard.js.map

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

package/dist/guards/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Guards Module
+ *
+ * Validation and safety guards for workflow execution.
+ */
+export * from './WorkflowGuard.js';
+export * from './StepGuard.js';
+export * from './ResourceGuard.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/guards/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,oBAAoB,CAAC;AACnC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,oBAAoB,CAAC"}

package/dist/guards/index.js

@@ -0,0 +1,9 @@
+/**
+ * Guards Module
+ *
+ * Validation and safety guards for workflow execution.
+ */
+export * from './WorkflowGuard.js';
+export * from './StepGuard.js';
+export * from './ResourceGuard.js';
+//# sourceMappingURL=index.js.map

package/dist/guards/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/guards/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,oBAAoB,CAAC;AACnC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,oBAAoB,CAAC"}

package/dist/hooks/HookManager.d.ts

@@ -0,0 +1,114 @@
+import type { LifecycleHook, WorkflowHookContext, StepHookContext, HookResult } from './LifecycleHooks.js';
+/**
+ * HookManager - Manages and executes lifecycle hooks
+ *
+ * Responsibilities:
+ * - Register user-defined hooks
+ * - Execute hooks at appropriate lifecycle moments
+ * - Handle hook errors gracefully
+ * - Maintain hook execution order
+ *
+ * Design principles:
+ * - Hooks run sequentially (not parallel) for predictability
+ * - Hook errors are isolated - one failing hook doesn't break the workflow
+ * - Hooks can be async (awaited)
+ * - Hook failures are logged but don't stop execution (unless configured)
+ *
+ * @example
+ * ```ts
+ * const manager = new HookManager();
+ *
+ * manager.register({
+ *   async afterStep(ctx) {
+ *     console.log('Step done:', ctx.stepName);
+ *   }
+ * });
+ *
+ * await manager.run('afterStep', stepContext);
+ * ```
+ */
+export declare class HookManager {
+    private hooks;
+    private failOnHookError;
+    constructor(options?: {
+        failOnHookError?: boolean;
+    });
+    /**
+     * Register a lifecycle hook
+     *
+     * @param hook - The hook implementation
+     */
+    register(hook: LifecycleHook): void;
+    /**
+     * Register multiple hooks at once
+     *
+     * @param hooks - Array of hook implementations
+     */
+    registerMany(hooks: LifecycleHook[]): void;
+    /**
+     * Remove a specific hook
+     *
+     * @param hook - The hook to remove
+     */
+    unregister(hook: LifecycleHook): void;
+    /**
+     * Clear all registered hooks
+     */
+    clear(): void;
+    /**
+     * Execute a specific hook type for all registered hooks
+     *
+     * @param type - The hook method name to execute
+     * @param ctx - Context to pass to the hook
+     * @param error - Optional error (for onError hook)
+     * @returns Array of hook results
+     */
+    run(type: keyof LifecycleHook, ctx: WorkflowHookContext | StepHookContext, error?: Error): Promise<HookResult[]>;
+    /**
+     * Execute beforeWorkflow hooks
+     */
+    runBeforeWorkflow(ctx: WorkflowHookContext): Promise<HookResult[]>;
+    /**
+     * Execute afterWorkflow hooks
+     */
+    runAfterWorkflow(ctx: WorkflowHookContext): Promise<HookResult[]>;
+    /**
+     * Execute beforeStep hooks
+     */
+    runBeforeStep(ctx: StepHookContext): Promise<HookResult[]>;
+    /**
+     * Execute afterStep hooks
+     */
+    runAfterStep(ctx: StepHookContext): Promise<HookResult[]>;
+    /**
+     * Execute onError hooks
+     */
+    runOnError(ctx: WorkflowHookContext | StepHookContext, error: Error): Promise<HookResult[]>;
+    /**
+     * Execute onRetry hooks
+     */
+    runOnRetry(ctx: StepHookContext): Promise<HookResult[]>;
+    /**
+     * Execute onPause hooks
+     */
+    runOnPause(ctx: WorkflowHookContext): Promise<HookResult[]>;
+    /**
+     * Execute onResume hooks
+     */
+    runOnResume(ctx: WorkflowHookContext): Promise<HookResult[]>;
+    /**
+     * Get count of registered hooks
+     */
+    count(): number;
+    /**
+     * Check if any hooks are registered
+     */
+    hasHooks(): boolean;
+    /**
+     * Get list of hook types that have implementations
+     *
+     * @returns Array of hook type names that are implemented
+     */
+    getImplementedHooks(): (keyof LifecycleHook)[];
+}
+//# sourceMappingURL=HookManager.d.ts.map

package/dist/hooks/HookManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"HookManager.d.ts","sourceRoot":"","sources":["../../src/hooks/HookManager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACR,aAAa,EACb,mBAAmB,EACnB,eAAe,EACf,UAAU,EACb,MAAM,qBAAqB,CAAC;AAE7B;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,qBAAa,WAAW;IACpB,OAAO,CAAC,KAAK,CAAuB;IACpC,OAAO,CAAC,eAAe,CAAkB;gBAE7B,OAAO,CAAC,EAAE;QAAE,eAAe,CAAC,EAAE,OAAO,CAAA;KAAE;IAInD;;;;OAIG;IACH,QAAQ,CAAC,IAAI,EAAE,aAAa,GAAG,IAAI;IAInC;;;;OAIG;IACH,YAAY,CAAC,KAAK,EAAE,aAAa,EAAE,GAAG,IAAI;IAI1C;;;;OAIG;IACH,UAAU,CAAC,IAAI,EAAE,aAAa,GAAG,IAAI;IAOrC;;OAEG;IACH,KAAK,IAAI,IAAI;IAIb;;;;;;;OAOG;IACG,GAAG,CACL,IAAI,EAAE,MAAM,aAAa,EACzB,GAAG,EAAE,mBAAmB,GAAG,eAAe,EAC1C,KAAK,CAAC,EAAE,KAAK,GACd,OAAO,CAAC,UAAU,EAAE,CAAC;IA4CxB;;OAEG;IACG,iBAAiB,CAAC,GAAG,EAAE,mBAAmB,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;IAIxE;;OAEG;IACG,gBAAgB,CAAC,GAAG,EAAE,mBAAmB,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;IAIvE;;OAEG;IACG,aAAa,CAAC,GAAG,EAAE,eAAe,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;IAIhE;;OAEG;IACG,YAAY,CAAC,GAAG,EAAE,eAAe,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;IAI/D;;OAEG;IACG,UAAU,CACZ,GAAG,EAAE,mBAAmB,GAAG,eAAe,EAC1C,KAAK,EAAE,KAAK,GACb,OAAO,CAAC,UAAU,EAAE,CAAC;IAIxB;;OAEG;IACG,UAAU,CAAC,GAAG,EAAE,eAAe,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;IAI7D;;OAEG;IACG,UAAU,CAAC,GAAG,EAAE,mBAAmB,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;IAIjE;;OAEG;IACG,WAAW,CAAC,GAAG,EAAE,mBAAmB,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;IAIlE;;OAEG;IACH,KAAK,IAAI,MAAM;IAIf;;OAEG;IACH,QAAQ,IAAI,OAAO;IAInB;;;;OAIG;IACH,mBAAmB,IAAI,CAAC,MAAM,aAAa,CAAC,EAAE;CAUjD"}