@orbytautomation/engine 0.3.0 → 0.4.1

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

@@ -7,100 +7,7 @@
  * @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>;
-}
+import { DriverContext, DriverStep, ExecutionDriver } from '../../types/core-types.js';
 /**
  * Base driver implementation with common logic
  */

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

@@ -1 +1 @@
-{"version":3,"file":"ExecutionDriver.d.ts","sourceRoot":"","sources":["../../../src/execution/drivers/ExecutionDriver.ts"],"names":[],"mappings":"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"}
+{"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;AACzD,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAEvF;;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.map

@@ -1 +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"}
+{"version":3,"file":"ExecutionDriver.js","sourceRoot":"","sources":["../../../src/execution/drivers/ExecutionDriver.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAKH;;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/explanation/ExplanationGenerator.d.ts

@@ -0,0 +1,104 @@
+/**
+ * Explanation Generator
+ *
+ * Generates comprehensive execution explanations for workflows.
+ * This module is ALWAYS invoked before workflow execution to provide
+ * full transparency into what the engine will do.
+ *
+ * @module explanation
+ */
+import { ExecutionExplanation, ParsedWorkflow } from "../types/core-types.js";
+/**
+ * Explanation Generator
+ *
+ * Always generates explanations before workflow execution.
+ * Integrates with EngineLogger to provide full transparency.
+ */
+export declare class ExplanationGenerator {
+    /**
+     * Generate a complete execution explanation
+     *
+     * This method analyzes the workflow and generates a comprehensive
+     * explanation of what will happen during execution. This is always
+     * called before workflow execution begins.
+     *
+     * @param workflow - Parsed workflow to explain
+     * @returns Complete execution explanation
+     */
+    static generate(workflow: ParsedWorkflow): ExecutionExplanation;
+    /**
+     * Build an explained step from a parsed step
+     *
+     * @param step - Parsed step
+     * @param _workflow - Full workflow (reserved for future cross-step reference analysis)
+     * @returns Explained step
+     */
+    private static buildExplainedStep;
+    /**
+     * Detect circular dependencies in workflow steps
+     */
+    private static detectCycles;
+    /**
+     * Calculate maximum dependency depth in the workflow
+     */
+    private static calculateMaxDepth;
+    /**
+     * Extract variable references from an object
+     */
+    private static extractVariableReferences;
+    /**
+     * Filter out internal fields (those starting with _)
+     */
+    private static filterInternalFields;
+    /**
+     * Analyze data flow throughout the workflow
+     * HIGH PRIORITY: Runtime Data Prediction
+     *
+     * Predicts what data flows through each step by analyzing:
+     * - Workflow inputs referenced
+     * - Step outputs consumed by other steps
+     * - Context and environment variables
+     * - Secrets usage
+     */
+    private static analyzeDataFlow;
+    /**
+     * Analyze all possible conditional execution paths
+     * HIGH PRIORITY: Conditional Path Analysis
+     *
+     * Analyzes workflow to determine:
+     * - All possible execution paths based on conditions
+     * - Steps that may be skipped
+     * - Unreachable code
+     */
+    private static analyzeConditionalPaths;
+    /**
+     * Estimate execution time for the workflow
+     * HIGH PRIORITY: Execution Time Estimation
+     *
+     * Predicts workflow execution duration by:
+     * - Analyzing dependency chains
+     * - Finding critical path
+     * - Estimating per-step execution time
+     * - Identifying bottlenecks
+     */
+    private static estimateExecutionTime;
+    /**
+     * Infer type from workflow value definition
+     */
+    private static inferType;
+    /**
+     * Generate human-readable sentences from structured logs
+     *
+     * This method converts the JSON-formatted explanation logs into
+     * natural language sentences that describe the workflow execution plan.
+     *
+     * @param explanation - The execution explanation to convert
+     * @returns Array of human-readable sentences
+     */
+    static generateSentencesFromLogs(explanation: ExecutionExplanation): string[];
+    /**
+     * Infer workflow type from explanation
+     */
+    private static inferWorkflowType;
+}
+//# sourceMappingURL=ExplanationGenerator.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ExplanationGenerator.d.ts","sourceRoot":"","sources":["../../src/explanation/ExplanationGenerator.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAA+C,oBAAoB,EAAsD,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAI/K;;;;;GAKG;AACH,qBAAa,oBAAoB;IAC7B;;;;;;;;;OASG;IACH,MAAM,CAAC,QAAQ,CAAC,QAAQ,EAAE,cAAc,GAAG,oBAAoB;IAiK/D;;;;;;OAMG;IACH,OAAO,CAAC,MAAM,CAAC,kBAAkB;IA0DjC;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,YAAY;IAsD3B;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,iBAAiB;IA6ChC;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,yBAAyB;IAuBxC;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,oBAAoB;IAWnC;;;;;;;;;OASG;IACH,OAAO,CAAC,MAAM,CAAC,eAAe;IA4I9B;;;;;;;;OAQG;IACH,OAAO,CAAC,MAAM,CAAC,uBAAuB;IA0EtC;;;;;;;;;OASG;IACH,OAAO,CAAC,MAAM,CAAC,qBAAqB;IAiKpC;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,SAAS;IAQxB;;;;;;;;OAQG;IACH,MAAM,CAAC,yBAAyB,CAAC,WAAW,EAAE,oBAAoB,GAAG,MAAM,EAAE;IAmI7E;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,iBAAiB;CAqCnC"}