@orbytautomation/engine 0.2.4 → 0.4.0

package/dist/explanation/ExplanationTypes.d.ts

@@ -0,0 +1,252 @@
+/**
+ * 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

@@ -0,0 +1 @@
+{"version":3,"file":"ExplanationTypes.d.ts","sourceRoot":"","sources":["../../src/explanation/ExplanationTypes.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;GAEG;AACH,MAAM,WAAW,aAAa;IAC1B,cAAc;IACd,EAAE,EAAE,MAAM,CAAC;IAEX,iCAAiC;IACjC,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd,8DAA8D;IAC9D,OAAO,EAAE,MAAM,CAAC;IAEhB,6DAA6D;IAC7D,IAAI,EAAE,MAAM,CAAC;IAEb,+DAA+D;IAC/D,KAAK,EAAE,MAAM,EAAE,CAAC;IAEhB,mCAAmC;IACnC,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd,4BAA4B;IAC5B,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAE1B,0BAA0B;IAC1B,KAAK,CAAC,EAAE;QACJ,GAAG,CAAC,EAAE,MAAM,CAAC;QACb,OAAO,CAAC,EAAE,QAAQ,GAAG,aAAa,CAAC;QACnC,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,KAAK,CAAC,EAAE,MAAM,CAAC;KAClB,CAAC;IAEF,sDAAsD;IACtD,eAAe,CAAC,EAAE,OAAO,CAAC;IAE1B,uBAAuB;IACvB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAE3B,4BAA4B;IAC5B,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAE1B,uBAAuB;IACvB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAE9B,gCAAgC;IAChC,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IAEvB,8CAA8C;IAC9C,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;CAC/B;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACjC,oBAAoB;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB,2BAA2B;IAC3B,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,uBAAuB;IACvB,OAAO,EAAE,MAAM,CAAC;IAEhB,oBAAoB;IACpB,IAAI,EAAE,MAAM,CAAC;IAEb,4BAA4B;IAC5B,SAAS,EAAE,MAAM,CAAC;IAElB,kDAAkD;IAClD,iBAAiB,EAAE,YAAY,GAAG,UAAU,GAAG,OAAO,CAAC;IAEvD,mCAAmC;IACnC,KAAK,EAAE,aAAa,EAAE,CAAC;IAEvB,qDAAqD;IACrD,SAAS,EAAE,OAAO,CAAC;IAEnB,6BAA6B;IAC7B,MAAM,CAAC,EAAE,MAAM,EAAE,EAAE,CAAC;IAEpB,sDAAsD;IACtD,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB,gDAAgD;IAChD,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IAE3C,wDAAwD;IACxD,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAE7B,gDAAgD;IAChD,OAAO,CAAC,EAAE;QACN,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;KACnB,CAAC;IAEF,sCAAsC;IACtC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAE9B,uBAAuB;IACvB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAEjC,6BAA6B;IAC7B,QAAQ,CAAC,EAAE;QACP,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,OAAO,CAAC,EAAE,MAAM,CAAC;KACpB,CAAC;IAEF,yBAAyB;IACzB,QAAQ,CAAC,EAAE;QACP,OAAO,CAAC,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS,CAAC;QAC1C,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,QAAQ,CAAC;KACzC,CAAC;IAEF,4CAA4C;IAC5C,YAAY,EAAE,MAAM,EAAE,CAAC;IAEvB,mFAAmF;IACnF,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IAE1C,+BAA+B;IAC/B,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAE1B,6CAA6C;IAC7C,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAErC,gCAAgC;IAChC,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAElC,WAAW;IACX,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAEhB,YAAY;IACZ,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,yCAAyC;IACzC,UAAU,CAAC,EAAE;QACT,UAAU,EAAE,MAAM,CAAC;QACnB,QAAQ,EAAE,MAAM,CAAC;QACjB,mBAAmB,EAAE,MAAM,CAAC;QAC5B,eAAe,EAAE,MAAM,CAAC;KAC3B,CAAC;IAEF,iEAAiE;IACjE,QAAQ,CAAC,EAAE,kBAAkB,EAAE,CAAC;IAEhC,+DAA+D;IAC/D,gBAAgB,CAAC,EAAE,uBAAuB,CAAC;IAE3C,qDAAqD;IACrD,cAAc,CAAC,EAAE,uBAAuB,CAAC;CAC5C;AAED;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IAC/B,cAAc;IACd,IAAI,EAAE,MAAM,CAAC;IAEb,gBAAgB;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB,yBAAyB;IACzB,MAAM,EAAE;QACJ,yBAAyB;QACzB,MAAM,EAAE,iBAAiB,GAAG,aAAa,GAAG,SAAS,GAAG,SAAS,GAAG,KAAK,GAAG,QAAQ,CAAC;QACrF,yBAAyB;QACzB,GAAG,EAAE,MAAM,CAAC;QACZ,2CAA2C;QAC3C,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,oBAAoB;QACpB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,+CAA+C;QAC/C,OAAO,CAAC,EAAE,GAAG,CAAC;KACjB,EAAE,CAAC;IAEJ,kBAAkB;IAClB,OAAO,EAAE;QACL,iBAAiB;QACjB,GAAG,EAAE,MAAM,CAAC;QACZ,oBAAoB;QACpB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,qCAAqC;QACrC,MAAM,EAAE,MAAM,EAAE,CAAC;KACpB,EAAE,CAAC;IAEJ,oDAAoD;IACpD,yBAAyB,EAAE,OAAO,CAAC;CACtC;AAED;;;GAGG;AACH,MAAM,WAAW,uBAAuB;IACpC,qCAAqC;IACrC,UAAU,EAAE,MAAM,CAAC;IAEnB,0BAA0B;IAC1B,KAAK,EAAE;QACH,uBAAuB;QACvB,WAAW,EAAE,MAAM,CAAC;QACpB,iDAAiD;QACjD,UAAU,EAAE,MAAM,EAAE,CAAC;QACrB,kCAAkC;QAClC,aAAa,EAAE,MAAM,EAAE,CAAC;QACxB,iCAAiC;QACjC,YAAY,EAAE,MAAM,EAAE,CAAC;QACvB,8BAA8B;QAC9B,UAAU,EAAE,QAAQ,GAAG,QAAQ,GAAG,UAAU,GAAG,UAAU,GAAG,OAAO,CAAC;KACvE,EAAE,CAAC;IAEJ,4BAA4B;IAC5B,gBAAgB,EAAE;QACd,IAAI,EAAE,MAAM,CAAC;QACb,SAAS,EAAE,MAAM,CAAC;QAClB,YAAY,EAAE,OAAO,CAAC;KACzB,EAAE,CAAC;IAEJ,qCAAqC;IACrC,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAE3B,gCAAgC;IAChC,cAAc,EAAE,MAAM,EAAE,CAAC;CAC5B;AAED;;;GAGG;AACH,MAAM,WAAW,uBAAuB;IACpC,2BAA2B;IAC3B,KAAK,EAAE;QACH,8BAA8B;QAC9B,GAAG,EAAE,MAAM,CAAC;QACZ,iCAAiC;QACjC,GAAG,EAAE,MAAM,CAAC;QACZ,+BAA+B;QAC/B,GAAG,EAAE,MAAM,CAAC;KACf,CAAC;IAEF,wCAAwC;IACxC,OAAO,EAAE;QACL,mBAAmB;QACnB,KAAK,EAAE,MAAM,CAAC;QACd,0BAA0B;QAC1B,KAAK,EAAE,MAAM,EAAE,CAAC;QAChB,6BAA6B;QAC7B,QAAQ,EAAE;YACN,GAAG,EAAE,MAAM,CAAC;YACZ,GAAG,EAAE,MAAM,CAAC;YACZ,GAAG,EAAE,MAAM,CAAC;SACf,CAAC;KACL,EAAE,CAAC;IAEJ,+CAA+C;IAC/C,YAAY,EAAE;QACV,iCAAiC;QACjC,KAAK,EAAE,MAAM,EAAE,CAAC;QAChB,2CAA2C;QAC3C,QAAQ,EAAE,MAAM,CAAC;KACpB,CAAC;IAEF,8BAA8B;IAC9B,WAAW,EAAE;QACT,cAAc;QACd,IAAI,EAAE,MAAM,CAAC;QACb,+BAA+B;QAC/B,MAAM,EAAE,MAAM,CAAC;QACf,+CAA+C;QAC/C,MAAM,EAAE,MAAM,CAAC;KAClB,EAAE,CAAC;IAEJ,8BAA8B;IAC9B,MAAM,EAAE;QACJ,IAAI,EAAE,MAAM,CAAC;QACb,GAAG,EAAE,MAAM,CAAC;QACZ,GAAG,EAAE,MAAM,CAAC;QACZ,GAAG,EAAE,MAAM,CAAC;QACZ,gDAAgD;QAChD,cAAc,EAAE,OAAO,CAAC;KAC3B,EAAE,CAAC;CACP;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC7B,iBAAiB;IACjB,IAAI,EAAE,aAAa,CAAC;IAEpB,4BAA4B;IAC5B,SAAS,EAAE,IAAI,CAAC;IAEhB,uBAAuB;IACvB,WAAW,EAAE,oBAAoB,CAAC;CACrC"}

package/dist/explanation/ExplanationTypes.js

@@ -0,0 +1,10 @@
+/**
+ * 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

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

package/dist/explanation/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Explanation Module
+ *
+ * Provides comprehensive workflow execution explanations.
+ * Always generates explanations before execution to ensure full transparency.
+ *
+ * @module explanation
+ */
+export { ExplanationGenerator } from './ExplanationGenerator.js';
+export { ExplanationLogger } from './ExplanationLogger.js';
+export type { ExplainedStep, ExecutionExplanation, ExplanationEvent, } from './ExplanationTypes.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/explanation/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AACjE,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,YAAY,EACR,aAAa,EACb,oBAAoB,EACpB,gBAAgB,GACnB,MAAM,uBAAuB,CAAC"}

package/dist/explanation/index.js

@@ -0,0 +1,11 @@
+/**
+ * Explanation Module
+ *
+ * Provides comprehensive workflow execution explanations.
+ * Always generates explanations before execution to ensure full transparency.
+ *
+ * @module explanation
+ */
+export { ExplanationGenerator } from './ExplanationGenerator.js';
+export { ExplanationLogger } from './ExplanationLogger.js';
+//# sourceMappingURL=index.js.map

package/dist/explanation/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/explanation/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AACjE,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC"}

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

@@ -1 +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"}
+{"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;AAG7B;;;;;;;;;;;;;;;;;;;;;;;;;;;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;IAOnC;;;;OAIG;IACH,YAAY,CAAC,KAAK,EAAE,aAAa,EAAE,GAAG,IAAI;IAQ1C;;;;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"}

package/dist/hooks/HookManager.js

@@ -1,3 +1,4 @@
+import { LoggerManager } from '../logging/LoggerManager.js';
 /**
  * HookManager - Manages and executes lifecycle hooks
  *
@@ -39,6 +40,9 @@ export class HookManager {
      */
     register(hook) {
         this.hooks.push(hook);
+        LoggerManager.getLogger().debug('Lifecycle hook registered', {
+            hookCount: this.hooks.length,
+        });
     }
     /**
      * Register multiple hooks at once
@@ -47,6 +51,10 @@ export class HookManager {
      */
     registerMany(hooks) {
         this.hooks.push(...hooks);
+        LoggerManager.getLogger().debug('Multiple lifecycle hooks registered', {
+            count: hooks.length,
+            totalHooks: this.hooks.length,
+        });
     }
     /**
      * Remove a specific hook

package/dist/hooks/HookManager.js.map

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

package/dist/index.d.ts

@@ -16,6 +16,7 @@ export * from './events/index.js';
 export * from './hooks/index.js';
 export type * from './execution/index.js';
 export * from './execution/index.js';
+export type { ExecutionExplanation, ExplainedStep } from './explanation/index.js';
 export * from './parser/index.js';
 export * from './state/index.js';
 export * from './context/index.js';
@@ -25,4 +26,6 @@ export * from './scheduling/index.js';
 export * from './errors/index.js';
 export * from './security/index.js';
 export * from './loader/index.js';
+export * from './explanation/index.js';
+export * from './logging/index.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA;;;;;;;;;;GAUG;AAMH,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAMpD,cAAc,iBAAiB,CAAA;AAO/B,cAAc,qBAAqB,CAAC;AAGpC,cAAc,mBAAmB,CAAC;AAGlC,cAAc,kBAAkB,CAAC;AAGjC,mBAAmB,sBAAsB,CAAC;AAC1C,cAAc,sBAAsB,CAAC;AAGrC,cAAc,mBAAmB,CAAC;AAGlC,cAAc,kBAAkB,CAAC;AAGjC,cAAc,oBAAoB,CAAC;AAGnC,cAAc,uBAAuB,CAAC;AAGtC,cAAc,kBAAkB,CAAC;AACjC,cAAc,uBAAuB,CAAC;AAGtC,cAAc,mBAAmB,CAAC;AAGlC,cAAc,qBAAqB,CAAC;AAGpC,cAAc,mBAAmB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA;;;;;;;;;;GAUG;AAMH,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAMpD,cAAc,iBAAiB,CAAA;AAO/B,cAAc,qBAAqB,CAAC;AAGpC,cAAc,mBAAmB,CAAC;AAGlC,cAAc,kBAAkB,CAAC;AAGjC,mBAAmB,sBAAsB,CAAC;AAC1C,cAAc,sBAAsB,CAAC;AAGrC,YAAY,EAAE,oBAAoB,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAGlF,cAAc,mBAAmB,CAAC;AAGlC,cAAc,kBAAkB,CAAC;AAGjC,cAAc,oBAAoB,CAAC;AAGnC,cAAc,uBAAuB,CAAC;AAGtC,cAAc,kBAAkB,CAAC;AACjC,cAAc,uBAAuB,CAAC;AAGtC,cAAc,mBAAmB,CAAC;AAGlC,cAAc,qBAAqB,CAAC;AAGpC,cAAc,mBAAmB,CAAC;AAElC,cAAc,wBAAwB,CAAC;AAEvC,cAAc,oBAAoB,CAAC"}

package/dist/index.js

@@ -44,4 +44,6 @@ export * from './errors/index.js';
 export * from './security/index.js';
 // export * from './workflow/index.js';
 export * from './loader/index.js';
+export * from './explanation/index.js';
+export * from './logging/index.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA;;;;;;;;;;GAUG;AAEH,+EAA+E;AAC/E,+BAA+B;AAC/B,+EAA+E;AAE/E,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAEpD,+EAA+E;AAC/E,sDAAsD;AACtD,+EAA+E;AAE/E,cAAc,iBAAiB,CAAA;AAE/B,+EAA+E;AAC/E,oDAAoD;AACpD,+EAA+E;AAE/E,WAAW;AACX,cAAc,qBAAqB,CAAC;AAEpC,SAAS;AACT,cAAc,mBAAmB,CAAC;AAElC,QAAQ;AACR,cAAc,kBAAkB,CAAC;AAIjC,cAAc,sBAAsB,CAAC;AAErC,6CAA6C;AAC7C,cAAc,mBAAmB,CAAC;AAElC,mBAAmB;AACnB,cAAc,kBAAkB,CAAC;AAEjC,oBAAoB;AACpB,cAAc,oBAAoB,CAAC;AAEnC,sBAAsB;AACtB,cAAc,uBAAuB,CAAC;AAEtC,gDAAgD;AAChD,cAAc,kBAAkB,CAAC;AACjC,cAAc,uBAAuB,CAAC;AAEtC,8BAA8B;AAC9B,cAAc,mBAAmB,CAAC;AAElC,2DAA2D;AAC3D,cAAc,qBAAqB,CAAC;AAEpC,uCAAuC;AACvC,cAAc,mBAAmB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA;;;;;;;;;;GAUG;AAEH,+EAA+E;AAC/E,+BAA+B;AAC/B,+EAA+E;AAE/E,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAEpD,+EAA+E;AAC/E,sDAAsD;AACtD,+EAA+E;AAE/E,cAAc,iBAAiB,CAAA;AAE/B,+EAA+E;AAC/E,oDAAoD;AACpD,+EAA+E;AAE/E,WAAW;AACX,cAAc,qBAAqB,CAAC;AAEpC,SAAS;AACT,cAAc,mBAAmB,CAAC;AAElC,QAAQ;AACR,cAAc,kBAAkB,CAAC;AAIjC,cAAc,sBAAsB,CAAC;AAKrC,6CAA6C;AAC7C,cAAc,mBAAmB,CAAC;AAElC,mBAAmB;AACnB,cAAc,kBAAkB,CAAC;AAEjC,oBAAoB;AACpB,cAAc,oBAAoB,CAAC;AAEnC,sBAAsB;AACtB,cAAc,uBAAuB,CAAC;AAEtC,gDAAgD;AAChD,cAAc,kBAAkB,CAAC;AACjC,cAAc,uBAAuB,CAAC;AAEtC,8BAA8B;AAC9B,cAAc,mBAAmB,CAAC;AAElC,2DAA2D;AAC3D,cAAc,qBAAqB,CAAC;AAEpC,uCAAuC;AACvC,cAAc,mBAAmB,CAAC;AAElC,cAAc,wBAAwB,CAAC;AAEvC,cAAc,oBAAoB,CAAC"}

package/dist/lifecycle/ShutdownManager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ShutdownManager.d.ts","sourceRoot":"","sources":["../../src/lifecycle/ShutdownManager.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;AAEzD;;GAEG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAyD;IACzE,OAAO,CAAC,kBAAkB,CAAS;IAEnC;;;;;;;OAOG;IACH,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,eAAe,GAAG,IAAI;IAI7D;;;;OAIG;IACG,eAAe,CAAC,SAAS,GAAE,MAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAgC/D;;;;OAIG;IACH,MAAM,CAAC,mBAAmB,CAAC,UAAU,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI;IA2CjE;;OAEG;IACH,cAAc,IAAI,OAAO;CAG1B"}
+{"version":3,"file":"ShutdownManager.d.ts","sourceRoot":"","sources":["../../src/lifecycle/ShutdownManager.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;AAEzD;;GAEG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAyD;IACzE,OAAO,CAAC,kBAAkB,CAAS;IAEnC;;;;;;;OAOG;IACH,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,eAAe,GAAG,IAAI;IAQ7D;;;;OAIG;IACG,eAAe,CAAC,SAAS,GAAE,MAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAoC/D;;;;OAIG;IACH,MAAM,CAAC,mBAAmB,CAAC,UAAU,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI;IA8CjE;;OAEG;IACH,cAAc,IAAI,OAAO;CAG1B"}

package/dist/lifecycle/ShutdownManager.js

@@ -5,6 +5,7 @@
  *
  * @module lifecycle
  */
+import { LoggerManager } from '../logging/LoggerManager.js';
 /**
  * Shutdown manager for graceful engine shutdown
  */
@@ -21,6 +22,10 @@ export class ShutdownManager {
      */
     registerHandler(name, handler) {
         this.handlers.push({ name, handler });
+        LoggerManager.getLogger().debug('Shutdown handler registered', {
+            handlerName: name,
+            totalHandlers: this.handlers.length,
+        });
     }
     /**
      * Execute all shutdown handlers
@@ -28,12 +33,16 @@ export class ShutdownManager {
      * @param timeoutMs - Maximum time per handler
      */
     async executeHandlers(timeoutMs = 10000) {
+        const logger = LoggerManager.getLogger();
         if (this.shutdownInProgress) {
-            console.log('⚠️  Shutdown already in progress');
+            logger.warn('Shutdown already in progress');
             return;
         }
         this.shutdownInProgress = true;
-        console.log('🛑 Executing shutdown handlers...\n');
+        logger.info('🛑 Executing shutdown handlers', {
+            handlerCount: this.handlers.length,
+            timeoutMs,
+        });
         for (const { name, handler } of this.handlers) {
             try {
                 const handlerPromise = handler();
@@ -43,14 +52,15 @@ export class ShutdownManager {
                     }, timeoutMs);
                 });
                 await Promise.race([handlerPromise, timeoutPromise]);
-                console.log(`  ✓ ${name}`);
+                logger.info(`  ✓ ${name}`);
             }
             catch (error) {
-                console.log(`  ✗ ${name}: ${error instanceof Error ? error.message : error}`);
+                const message = error instanceof Error ? error.message : String(error);
+                logger.error(`  ✗ ${name}: ${message}`);
                 // Continue with other handlers even if one fails
             }
         }
-        console.log('');
+        logger.info('Shutdown handlers completed');
         this.shutdownInProgress = false;
     }
     /**
@@ -59,23 +69,26 @@ export class ShutdownManager {
      * @param onShutdown - Function to call on shutdown signal
      */
     static setupSignalHandlers(onShutdown) {
+        const logger = LoggerManager.getLogger();
         const signals = ['SIGINT', 'SIGTERM', 'SIGHUP'];
         for (const signal of signals) {
             process.on(signal, async () => {
-                console.log(`\n📡 Received ${signal} signal`);
+                logger.info(`📡 Received ${signal} signal`, { signal });
                 try {
                     await onShutdown();
                     process.exit(0);
                 }
                 catch (error) {
-                    console.error('❌ Shutdown error:', error);
+                    const message = error instanceof Error ? error.message : String(error);
+                    logger.error(`Shutdown error: ${message}`);
                     process.exit(1);
                 }
             });
         }
         // Handle uncaught errors
         process.on('uncaughtException', async (error) => {
-            console.error('❌ Uncaught exception:', error);
+            const message = error instanceof Error ? error.message : String(error);
+            logger.error(`Uncaught exception: ${message}`);
             try {
                 await onShutdown();
             }
@@ -85,7 +98,7 @@ export class ShutdownManager {
             process.exit(1);
         });
         process.on('unhandledRejection', async (reason) => {
-            console.error('❌ Unhandled rejection:', reason);
+            logger.error(`Unhandled rejection: ${String(reason)}`);
             try {
                 await onShutdown();
             }

package/dist/lifecycle/ShutdownManager.js.map

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

package/dist/lifecycle/StartupManager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"StartupManager.d.ts","sourceRoot":"","sources":["../../src/lifecycle/StartupManager.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,OAAO,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;AAEvD;;GAEG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,MAAM,CAAyC;IAEvD;;;;;OAKG;IACH,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,GAAG,IAAI;IAIzD;;;;;OAKG;IACG,SAAS,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC;IAgD1C;;OAEG;IACH,MAAM,CAAC,mBAAmB,IAAI,cAAc;CAuC7C"}
+{"version":3,"file":"StartupManager.d.ts","sourceRoot":"","sources":["../../src/lifecycle/StartupManager.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,OAAO,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;AAEvD;;GAEG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,MAAM,CAAyC;IAEvD;;;;;OAKG;IACH,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,GAAG,IAAI;IAQzD;;;;;OAKG;IACG,SAAS,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC;IAuD1C;;OAEG;IACH,MAAM,CAAC,mBAAmB,IAAI,cAAc;CAqC7C"}

package/dist/lifecycle/StartupManager.js

@@ -5,6 +5,7 @@
  *
  * @module lifecycle
  */
+import { LoggerManager } from '../logging/LoggerManager.js';
 /**
  * Startup manager for engine initialization
  */
@@ -18,6 +19,10 @@ export class StartupManager {
      */
     registerCheck(name, checkFn) {
         this.checks.set(name, checkFn);
+        LoggerManager.getLogger().debug('Startup check registered', {
+            checkName: name,
+            totalChecks: this.checks.size,
+        });
     }
     /**
      * Run all startup checks
@@ -27,7 +32,10 @@ export class StartupManager {
      */
     async runChecks() {
         const results = [];
-        console.log('🔍 Running startup checks...\n');
+        const logger = LoggerManager.getLogger();
+        logger.info('🔍 Running startup checks...', {
+            totalChecks: this.checks.size,
+        });
         for (const [name, checkFn] of this.checks.entries()) {
             const startTime = Date.now();
             try {
@@ -38,7 +46,7 @@ export class StartupManager {
                     passed: true,
                     duration,
                 });
-                console.log(`  ✓ ${name} (${duration}ms)`);
+                logger.info(`  ✓ ${name}`, { duration });
             }
             catch (error) {
                 const duration = Date.now() - startTime;
@@ -49,16 +57,20 @@ export class StartupManager {
                     message,
                     duration,
                 });
-                console.log(`  ✗ ${name}: ${message} (${duration}ms)`);
+                logger.error(`  ✗ ${name}: ${message} (${duration}ms)`);
             }
         }
-        console.log('');
         // Check if any failed
         const failed = results.filter(r => !r.passed);
         if (failed.length > 0) {
+            const failedList = failed.map(f => `${f.name}: ${f.message}`).join(', ');
+            logger.error(`Startup checks failed: ${failedList}`);
             throw new Error(`${failed.length} startup check(s) failed:\n` +
                 failed.map(f => `  - ${f.name}: ${f.message}`).join('\n'));
         }
+        logger.info('All startup checks passed', {
+            totalChecks: results.length,
+        });
         return results;
     }
     /**
@@ -66,7 +78,6 @@ export class StartupManager {
      */
     static createDefaultChecks() {
         const manager = new StartupManager();
-        // Check Node version
         manager.registerCheck('Node.js version', () => {
             const version = process.versions.node;
             const major = parseInt(version.split('.')[0], 10);

package/dist/lifecycle/StartupManager.js.map

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