@orbytautomation/engine 0.4.0 → 0.4.1

package/dist/explanation/ExplanationTypes.d.ts

@@ -1,252 +0,0 @@
-/**
- * Explanation Types
- *
- * Type definitions for workflow execution explanations.
- * These structures represent a complete analysis of what the engine will do.
- *
- * @module explanation
- */
-/**
- * Explained step - A single step in the execution plan with all resolved configuration
- */
-export interface ExplainedStep {
-    /** Step ID */
-    id: string;
-    /** Step name (human-readable) */
-    name?: string;
-    /** Adapter being used (e.g., "shell", "http", "mediaproc") */
-    adapter: string;
-    /** Action to execute (e.g., "shell.exec", "http.request") */
-    uses: string;
-    /** Dependencies - which steps must complete before this one */
-    needs: string[];
-    /** Execution condition (if any) */
-    when?: string;
-    /** Timeout configuration */
-    timeout?: string | number;
-    /** Retry configuration */
-    retry?: {
-        max?: number;
-        backoff?: 'linear' | 'exponential';
-        delay?: number;
-        count?: number;
-    };
-    /** Whether to continue workflow if this step fails */
-    continueOnError?: boolean;
-    /** Input parameters */
-    with?: Record<string, any>;
-    /** Environment variables */
-    env?: Record<string, any>;
-    /** Expected outputs */
-    outputs?: Record<string, any>;
-    /** Secrets used by this step */
-    secretsUsed?: string[];
-    /** Workflow inputs referenced in this step */
-    inputsReferenced?: string[];
-}
-/**
- * Execution explanation - Complete plan of what the engine will do
- */
-export interface ExecutionExplanation {
-    /** Workflow name */
-    workflowName?: string;
-    /** Workflow description */
-    description?: string;
-    /** Workflow version */
-    version: string;
-    /** Workflow kind */
-    kind: string;
-    /** Total number of steps */
-    stepCount: number;
-    /** Execution strategy (sequential or parallel) */
-    executionStrategy: 'sequential' | 'parallel' | 'mixed';
-    /** All steps in execution order */
-    steps: ExplainedStep[];
-    /** Whether the workflow has circular dependencies */
-    hasCycles: boolean;
-    /** Cycle details (if any) */
-    cycles?: string[][];
-    /** Total estimated phases (for parallel execution) */
-    phases?: number;
-    /** Dependency graph in adjacency list format */
-    dependencyGraph?: Record<string, string[]>;
-    /** Workflow inputs (parameters the workflow accepts) */
-    inputs?: Record<string, any>;
-    /** Secrets being used (keys only, no values) */
-    secrets?: {
-        vault?: string;
-        keys?: string[];
-    };
-    /** Context variables (environment) */
-    context?: Record<string, any>;
-    /** Workflow outputs */
-    outputs?: Record<string, string>;
-    /** Default configurations */
-    defaults?: {
-        timeout?: string;
-        adapter?: string;
-    };
-    /** Execution policies */
-    policies?: {
-        failure?: 'stop' | 'continue' | 'isolate';
-        concurrency?: number;
-        sandbox?: 'none' | 'basic' | 'strict';
-    };
-    /** Unique adapters used in this workflow */
-    adaptersUsed: string[];
-    /** Adapter actions breakdown (e.g., { "shell": ["exec"], "http": ["request"] }) */
-    adapterActions?: Record<string, string[]>;
-    /** Required workflow inputs */
-    requiredInputs?: string[];
-    /** Optional workflow inputs with defaults */
-    optionalInputs?: Record<string, any>;
-    /** Annotations (AI/UI hints) */
-    annotations?: Record<string, any>;
-    /** Tags */
-    tags?: string[];
-    /** Owner */
-    owner?: string;
-    /** Metadata about workflow complexity */
-    complexity?: {
-        totalSteps: number;
-        maxDepth: number;
-        parallelizableSteps: number;
-        sequentialSteps: number;
-    };
-    /** Data flow prediction - how data moves through the workflow */
-    dataFlow?: DataFlowPrediction[];
-    /** Conditional path analysis - all possible execution paths */
-    conditionalPaths?: ConditionalPathAnalysis;
-    /** Execution time estimation - predicted duration */
-    timeEstimation?: ExecutionTimeEstimation;
-}
-/**
- * Data flow prediction for a step
- * Shows what data flows in and out of each step
- */
-export interface DataFlowPrediction {
-    /** Step ID */
-    step: string;
-    /** Step name */
-    stepName?: string;
-    /** Input data sources */
-    inputs: {
-        /** Source of the data */
-        source: 'workflow.inputs' | 'step.output' | 'context' | 'secrets' | 'env' | 'static';
-        /** Variable/field key */
-        key: string;
-        /** Source step ID (if from step.output) */
-        sourceStep?: string;
-        /** Inferred type */
-        type?: string;
-        /** Sample value (for static/default values) */
-        example?: any;
-    }[];
-    /** Output data */
-    outputs: {
-        /** Output key */
-        key: string;
-        /** Inferred type */
-        type?: string;
-        /** Steps that consume this output */
-        usedBy: string[];
-    }[];
-    /** Whether this step has unresolved dependencies */
-    hasUnresolvedDependencies: boolean;
-}
-/**
- * Conditional path analysis
- * Analyzes all possible execution paths based on conditions
- */
-export interface ConditionalPathAnalysis {
-    /** Total number of possible paths */
-    totalPaths: number;
-    /** All execution paths */
-    paths: {
-        /** Path description */
-        description: string;
-        /** Conditions that must be true for this path */
-        conditions: string[];
-        /** Steps executed in this path */
-        stepsExecuted: string[];
-        /** Steps skipped in this path */
-        stepsSkipped: string[];
-        /** Likelihood of this path */
-        likelihood: 'always' | 'likely' | 'possible' | 'unlikely' | 'never';
-    }[];
-    /** Steps with conditions */
-    conditionalSteps: {
-        step: string;
-        condition: string;
-        canBeSkipped: boolean;
-    }[];
-    /** Steps that are never reachable */
-    unreachableSteps: string[];
-    /** Steps that always execute */
-    alwaysExecutes: string[];
-}
-/**
- * Execution time estimation
- * Predicts how long the workflow will take
- */
-export interface ExecutionTimeEstimation {
-    /** Total estimated time */
-    total: {
-        /** Best case scenario (ms) */
-        min: number;
-        /** Average expected time (ms) */
-        avg: number;
-        /** Worst case scenario (ms) */
-        max: number;
-    };
-    /** Estimated time by execution phase */
-    byPhase: {
-        /** Phase number */
-        phase: number;
-        /** Steps in this phase */
-        steps: string[];
-        /** Duration estimate (ms) */
-        duration: {
-            min: number;
-            avg: number;
-            max: number;
-        };
-    }[];
-    /** Critical path - longest dependency chain */
-    criticalPath: {
-        /** Steps in the critical path */
-        steps: string[];
-        /** Total duration of critical path (ms) */
-        duration: number;
-    };
-    /** Performance bottlenecks */
-    bottlenecks: {
-        /** Step ID */
-        step: string;
-        /** Reason it's a bottleneck */
-        reason: string;
-        /** Estimated impact if optimized (ms saved) */
-        impact: number;
-    }[];
-    /** Time estimates per step */
-    byStep: {
-        step: string;
-        min: number;
-        avg: number;
-        max: number;
-        /** Whether this step is on the critical path */
-        onCriticalPath: boolean;
-    }[];
-}
-/**
- * Explanation event - Logged to EngineLogger
- */
-export interface ExplanationEvent {
-    /** Event type */
-    type: 'explanation';
-    /** Explanation timestamp */
-    timestamp: Date;
-    /** Full explanation */
-    explanation: ExecutionExplanation;
-}
-//# sourceMappingURL=ExplanationTypes.d.ts.map

package/dist/explanation/ExplanationTypes.d.ts.map

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

package/dist/explanation/ExplanationTypes.js

@@ -1,10 +0,0 @@
-/**
- * Explanation Types
- *
- * Type definitions for workflow execution explanations.
- * These structures represent a complete analysis of what the engine will do.
- *
- * @module explanation
- */
-export {};
-//# sourceMappingURL=ExplanationTypes.js.map

package/dist/explanation/ExplanationTypes.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"ExplanationTypes.js","sourceRoot":"","sources":["../../src/explanation/ExplanationTypes.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG"}