@orbytautomation/engine 0.2.4 → 0.4.0

package/dist/errors/ErrorHandler.js

@@ -0,0 +1,378 @@
+/**
+ * Error Handler (Automatic Error Management)
+ *
+ * Central error handling system that orchestrates detection, logging, and execution control.
+ * Designed to work automatically without manual error handling in engine.
+ *
+ * ARCHITECTURE:
+ * =============
+ * - AUTOMATIC in Engine: Errors are auto-detected and classified
+ * - MANUAL in CLI/API/SDK: Use ErrorHandler explicitly for custom handling
+ * - INTEGRATED with WorkflowLoader: Validates and detects errors on load
+ *
+ * EXECUTION CONTROL:
+ * ==================
+ * Based on severity, automatically determines what to do:
+ * - CRITICAL/FATAL → Stop entire workflow immediately
+ * - ERROR → Stop entire workflow
+ * - MEDIUM → Stop current step, try next step
+ * - LOW/WARNING/INFO → Log and continue
+ *
+ * USAGE:
+ * ======
+ * ```typescript
+ * // In Engine (automatic):
+ * try {
+ *   await executeStep(step);
+ * } catch (error) {
+ *   const result = await ErrorHandler.handle(error, {
+ *     location: `steps[${index}]`,
+ *     stepId: step.id
+ *   });
+ *
+ *   if (result.shouldStopWorkflow) {
+ *     throw result.error;
+ *   }
+ *   if (result.shouldStopStep) {
+ *     continue; // Skip to next step
+ *   }
+ *   // Continue current step
+ * }
+ *
+ * // In CLI/API (manual):
+ * try {
+ *   const workflow = await WorkflowLoader.fromFile(path);
+ * } catch (error) {
+ *   const result = await ErrorHandler.handle(error, { location: path });
+ *   console.error(result.debug?.formatted);
+ *   process.exit(result.error.exitCode);
+ * }
+ * ```
+ *
+ * @module errors/handler
+ */
+import { OrbytError } from './OrbytError.js';
+import { ErrorDetector } from './ErrorDetector.js';
+import { ErrorDebugger } from './ErrorDebugger.js';
+import { formatDetailedError } from './ErrorFormatter.js';
+import { ErrorSeverity, ExecutionControl, getExecutionControl, shouldStopWorkflow, shouldStopStep, } from './ErrorCodes.js';
+/**
+ * Error Handler
+ *
+ * Unified error handling system for Orbyt engine.
+ * Automatically detects, classifies, logs, and controls execution based on errors.
+ */
+export class ErrorHandler {
+    /**
+     * Handle any error - the main entry point
+     *
+     * Automatically:
+     * 1. Detects and classifies error type
+     * 2. Determines severity level
+     * 3. Logs appropriately
+     * 4. Generates debug info (if enabled)
+     * 5. Returns execution control decision
+     *
+     * @param error - Any error (OrbytError, Error, string, or error context)
+     * @param errorContext - Context about where error occurred
+     * @param options - Configuration options
+     * @returns Complete error handling result with execution decisions
+     *
+     * @example
+     * ```typescript
+     * // Automatic handling in engine
+     * const result = await ErrorHandler.handle(error, {
+     *   location: 'workflow.steps[2]',
+     *   stepId: 'fetch-data'
+     * });
+     *
+     * if (result.shouldStopWorkflow) {
+     *   throw result.error; // Stop execution
+     * }
+     * ```
+     */
+    static async handle(error, errorContext, options = {}) {
+        const { enableLogging = true, enableDebug = false, useColors = true, logger = console, context = {}, } = options;
+        // STEP 1: Detect and classify error → OrbytError
+        const orbytError = this.detectError(error, errorContext);
+        // STEP 2: Determine execution control based on severity
+        const control = getExecutionControl(orbytError.severity);
+        const stopWorkflow = shouldStopWorkflow(orbytError.severity);
+        const stopStep = shouldStopStep(orbytError.severity);
+        const continueExecution = control === ExecutionControl.CONTINUE;
+        // STEP 3: Log error if logging is enabled
+        let logEntry;
+        if (enableLogging) {
+            logEntry = this.logError(orbytError, logger, context);
+        }
+        // STEP 4: Generate debug information if enabled
+        let debug;
+        if (enableDebug) {
+            debug = this.generateDebugInfo(orbytError, useColors);
+        }
+        // STEP 5: Return complete result
+        return {
+            error: orbytError,
+            control,
+            shouldStopWorkflow: stopWorkflow,
+            shouldStopStep: stopStep,
+            shouldContinue: continueExecution,
+            debug,
+            logEntry,
+        };
+    }
+    /**
+     * Handle error from WorkflowLoader
+     * Special handling for load-time errors with file path context
+     *
+     * @param error - Error from loader
+     * @param filePath - Path to workflow file being loaded
+     * @param options - Handler options
+     * @returns Error handling result
+     */
+    static async handleLoaderError(error, filePath, options = {}) {
+        return this.handle(error, {
+            location: filePath,
+            type: this.detectLoaderErrorType(error),
+        }, {
+            ...options,
+            enableDebug: true, // Always enable debug for loader errors
+        });
+    }
+    /**
+     * Handle error from context object
+     * When you already know the error type and have context
+     *
+     * @param context - Error context with type and data
+     * @param options - Handler options
+     * @returns Error handling result
+     *
+     * @example
+     * ```typescript
+     * const result = await ErrorHandler.handleContext({
+     *   type: 'missing_field',
+     *   field: 'version',
+     *   location: 'workflow'
+     * });
+     * ```
+     */
+    static async handleContext(context, options = {}) {
+        const error = ErrorDetector.detect(context);
+        return this.handle(error, context, options);
+    }
+    /**
+     * Quick handle - simplified for common use cases
+     * Returns just a boolean: should stop execution?
+     *
+     * @param error - Error to handle
+     * @param location - Where error occurred
+     * @returns True if should stop execution, false if can continue
+     *
+     * @example
+     * ```typescript
+     * if (await ErrorHandler.shouldStop(error, 'workflow.steps[2]')) {
+     *   throw error; // Stop execution
+     * }
+     * // Continue execution
+     * ```
+     */
+    static async shouldStop(error, location) {
+        const result = await this.handle(error, { location }, {
+            enableLogging: true,
+            enableDebug: false
+        });
+        return result.shouldStopWorkflow;
+    }
+    /**
+     * Batch handle multiple errors
+     * Useful for validation that collects multiple errors
+     *
+     * @param errors - Array of errors
+     * @param options - Handler options
+     * @returns Array of handling results
+     */
+    static async handleBatch(errors, options = {}) {
+        const results = await Promise.all(errors.map(error => this.handle(error, undefined, options)));
+        return results;
+    }
+    /**
+     * Get most severe error from batch
+     * Returns the error that should take precedence
+     *
+     * @param results - Array of error handling results
+     * @returns Most severe error result
+     */
+    static getMostSevere(results) {
+        if (results.length === 0)
+            return undefined;
+        const severityOrder = [
+            ErrorSeverity.CRITICAL,
+            ErrorSeverity.FATAL,
+            ErrorSeverity.ERROR,
+            ErrorSeverity.MEDIUM,
+            ErrorSeverity.LOW,
+            ErrorSeverity.WARNING,
+            ErrorSeverity.INFO,
+        ];
+        return results.reduce((mostSevere, current) => {
+            const currentIndex = severityOrder.indexOf(current.error.severity);
+            const mostSevereIndex = severityOrder.indexOf(mostSevere.error.severity);
+            return currentIndex < mostSevereIndex ? current : mostSevere;
+        });
+    }
+    /**
+     * Check if any errors in batch should stop workflow
+     *
+     * @param results - Array of error handling results
+     * @returns True if any error should stop workflow
+     */
+    static shouldStopWorkflowForBatch(results) {
+        return results.some(result => result.shouldStopWorkflow);
+    }
+    // ==================== PRIVATE HELPERS ====================
+    /**
+     * Detect and classify error into OrbytError
+     */
+    static detectError(error, context) {
+        // Already an OrbytError - return as-is
+        if (error instanceof OrbytError) {
+            return error;
+        }
+        // Standard Error - try to classify
+        if (error instanceof Error) {
+            return ErrorDetector.detectFromException(error, context?.location);
+        }
+        // Error context object - detect from context
+        if (typeof error === 'object' && error !== null && 'type' in error) {
+            return ErrorDetector.detect(error);
+        }
+        // String error message - create generic error
+        if (typeof error === 'string') {
+            return ErrorDetector.detect({
+                type: 'unknown',
+                rawMessage: error,
+                location: context?.location,
+            });
+        }
+        // Unknown error type - create generic error
+        return ErrorDetector.detect({
+            type: 'unknown',
+            rawMessage: String(error),
+            location: context?.location,
+        });
+    }
+    /**
+     * Detect error type from WorkflowLoader errors
+     */
+    static detectLoaderErrorType(error) {
+        if (!(error instanceof Error))
+            return 'unknown';
+        const message = error.message.toLowerCase();
+        if (message.includes('file not found') || message.includes('enoent')) {
+            return 'unknown'; // Will be classified as RUNTIME_FILE_NOT_FOUND
+        }
+        if (message.includes('yaml') || message.includes('syntax')) {
+            return 'parse_error';
+        }
+        if (message.includes('json')) {
+            return 'parse_error';
+        }
+        if (message.includes('reserved field')) {
+            return 'reserved_field';
+        }
+        if (message.includes('unknown field')) {
+            return 'unknown_field';
+        }
+        if (message.includes('missing') || message.includes('required')) {
+            return 'missing_field';
+        }
+        return 'unknown';
+    }
+    /**
+     * Log error with appropriate level
+     */
+    static logError(error, logger, context) {
+        const metadata = {
+            code: error.code,
+            exitCode: error.exitCode,
+            severity: error.severity,
+            path: error.path,
+            category: error.category,
+            isUserError: error.isUserError,
+            isRetryable: error.isRetryable,
+            hint: error.hint,
+            context: error.diagnostic.context,
+            ...context,
+        };
+        const message = `[${error.code}] ${error.message}`;
+        const timestamp = new Date();
+        // Log based on severity
+        switch (error.severity) {
+            case ErrorSeverity.CRITICAL:
+            case ErrorSeverity.FATAL:
+            case ErrorSeverity.ERROR:
+                logger?.error?.(message, metadata);
+                return { level: 'error', message, metadata, timestamp };
+            case ErrorSeverity.MEDIUM:
+            case ErrorSeverity.LOW:
+            case ErrorSeverity.WARNING:
+                logger?.warn?.(message, metadata);
+                return { level: 'warn', message, metadata, timestamp };
+            case ErrorSeverity.INFO:
+                logger?.info?.(message, metadata);
+                return { level: 'info', message, metadata, timestamp };
+            default:
+                logger?.error?.(message, metadata);
+                return { level: 'error', message, metadata, timestamp };
+        }
+    }
+    /**
+     * Generate complete debug information
+     */
+    static generateDebugInfo(error, useColors) {
+        const debugInfo = ErrorDebugger.analyze(error);
+        const formatted = ErrorDebugger.format(error, useColors);
+        const detailed = formatDetailedError(error, useColors);
+        const quickFix = ErrorDebugger.quickDebug(error);
+        return {
+            explanation: debugInfo.explanation,
+            cause: debugInfo.cause,
+            fixSteps: debugInfo.fixSteps,
+            quickFix,
+            formatted,
+            detailed,
+            commonMistakes: debugInfo.commonMistakes,
+            estimatedFixTime: debugInfo.estimatedFixTime,
+        };
+    }
+}
+/**
+ * Global error handler instance for convenience
+ * Can be used for setting default options
+ */
+export class GlobalErrorHandler {
+    static defaultOptions = {
+        enableLogging: true,
+        enableDebug: false,
+        useColors: true,
+    };
+    /**
+     * Configure default options for all error handling
+     */
+    static configure(options) {
+        this.defaultOptions = { ...this.defaultOptions, ...options };
+    }
+    /**
+     * Handle error with default options
+     */
+    static async handle(error, context) {
+        return ErrorHandler.handle(error, context, this.defaultOptions);
+    }
+    /**
+     * Get current default options
+     */
+    static getOptions() {
+        return { ...this.defaultOptions };
+    }
+}
+//# sourceMappingURL=ErrorHandler.js.map

package/dist/errors/ErrorHandler.js.map

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

package/dist/errors/FieldRegistry.d.ts

@@ -11,10 +11,13 @@
 /**
  * Valid fields at workflow root level
  * MUST stay in sync with OrbytWorkflowSchema in @dev-ecosystem/core
+ * Last synced: 2026-02-15
  */
 export declare const ROOT_FIELDS: readonly ["version", "kind", "workflow", "metadata", "annotations", "triggers", "secrets", "inputs", "context", "defaults", "policies", "permissions", "resources", "outputs", "on", "usage", "strategy", "profiles", "compliance", "provenance", "execution", "outputsSchema", "telemetry", "accounting", "compatibility", "failurePolicy", "rollback", "governance"];
 /**
  * Valid fields in metadata object
+ * MUST stay in sync with MetadataSchema in @dev-ecosystem/core
+ * Last synced: 2026-02-15
  */
 export declare const METADATA_FIELDS: readonly ["name", "description", "tags", "owner", "version", "createdAt", "updatedAt", "v1", "future"];
 /**
@@ -24,22 +27,31 @@ export declare const WORKFLOW_FIELDS: readonly ["steps"];
 /**
  * Valid fields in step definition
  * MUST stay in sync with StepSchema in @dev-ecosystem/core
+ * Last synced: 2026-02-15
  */
 export declare const STEP_FIELDS: readonly ["id", "uses", "name", "with", "when", "needs", "retry", "timeout", "continueOnError", "outputs", "env", "usage", "ref", "requires", "hints", "contracts", "profiles", "onFailure", "telemetry", "rollback"];
 /**
  * Valid fields in secrets config
+ * MUST stay in sync with SecretsSchema in @dev-ecosystem/core
+ * Last synced: 2026-02-15
  */
 export declare const SECRETS_FIELDS: readonly ["vault", "keys"];
 /**
  * Valid fields in context config
+ * MUST stay in sync with ContextSchema in @dev-ecosystem/core
+ * Last synced: 2026-02-15
  */
 export declare const CONTEXT_FIELDS: readonly ["env", "platform", "workspace"];
 /**
  * Valid fields in defaults config
+ * MUST stay in sync with DefaultsSchema in @dev-ecosystem/core
+ * Last synced: 2026-02-15
  */
 export declare const DEFAULTS_FIELDS: readonly ["retry", "timeout", "adapter"];
 /**
  * Valid fields in policies config
+ * MUST stay in sync with PoliciesSchema in @dev-ecosystem/core
+ * Last synced: 2026-02-15
  */
 export declare const POLICIES_FIELDS: readonly ["failure", "concurrency", "sandbox"];
 /**
@@ -48,6 +60,8 @@ export declare const POLICIES_FIELDS: readonly ["failure", "concurrency", "sandb
 export declare const PERMISSIONS_FIELDS: readonly ["fs", "network"];
 /**
  * Valid fields in retry config
+ * MUST stay in sync with RetryConfigSchema in @dev-ecosystem/core
+ * Last synced: 2026-02-15
  */
 export declare const RETRY_FIELDS: readonly ["max", "backoff", "delay"];
 /**
@@ -61,6 +75,31 @@ export declare const USAGE_FIELDS: readonly ["track", "scope", "category", "bill
  * Note: costHint is NOT included - use hints.cost instead (no duplicates)
  */
 export declare const STEP_USAGE_FIELDS: readonly ["billable", "unit", "weight"];
+/**
+ * Reserved workflow-level fields (engine-controlled, NEVER user-set)
+ * These fields would trigger SecurityError if found in user YAML
+ * MUST stay in sync with RESERVED_WORKFLOW_FIELDS in security/ReservedFields.ts
+ * Last synced: 2026-02-15
+ */
+export declare const RESERVED_WORKFLOW_FIELDS: readonly ["_internal", "_identity", "_ownership", "_billing", "_usage", "_audit", "_system", "_engine", "_execution", "_runtime", "_security", "_metadata"];
+/**
+ * Reserved context fields (engine-controlled, users cannot set in context)
+ * MUST stay in sync with RESERVED_CONTEXT_FIELDS in security/ReservedFields.ts
+ * Last synced: 2026-02-15
+ */
+export declare const RESERVED_CONTEXT_FIELDS: readonly ["_internal", "_identity", "_ownership", "_billing", "_usage", "_audit", "_system", "_engine", "_security", "executionId", "runId", "traceId", "userId", "workspaceId", "subscriptionId", "subscriptionTier", "billingId", "billingMode", "pricingTier", "pricingModel", "billingSnapshot"];
+/**
+ * Reserved step fields (engine-controlled, users cannot set in steps)
+ * MUST stay in sync with RESERVED_STEP_FIELDS in security/ReservedFields.ts
+ * Last synced: 2026-02-15
+ */
+export declare const RESERVED_STEP_FIELDS: readonly ["_internal", "_billing", "_usage", "_audit", "executionId", "runId", "stepExecutionId"];
+/**
+ * Reserved annotation prefixes (engine-controlled namespaces)
+ * MUST stay in sync with RESERVED_ANNOTATION_PREFIXES in security/ReservedFields.ts
+ * Last synced: 2026-02-15
+ */
+export declare const RESERVED_ANNOTATION_PREFIXES: readonly ["engine.", "system.", "internal.", "billing.", "audit.", "security."];
 /**
  * Field registry map - maps path prefixes to valid fields
  */

package/dist/errors/FieldRegistry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"FieldRegistry.d.ts","sourceRoot":"","sources":["../../src/errors/FieldRegistry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH;;;GAGG;AACH,eAAO,MAAM,WAAW,wWAkCd,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,eAAe,wGAUlB,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,eAAe,oBAElB,CAAC;AAEX;;;GAGG;AACH,eAAO,MAAM,WAAW,uNA0Bd,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,cAAc,4BAGjB,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,cAAc,2CAIjB,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,eAAe,0CAIlB,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,eAAe,gDAIlB,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,kBAAkB,4BAGrB,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,YAAY,sCAIf,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,YAAY,wEAOf,CAAC;AAEX;;;;;GAKG;AACH,eAAO,MAAM,iBAAiB,yCAIpB,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAa5D,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,CAoB9D;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAGjE"}
+{"version":3,"file":"FieldRegistry.d.ts","sourceRoot":"","sources":["../../src/errors/FieldRegistry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH;;;;GAIG;AACH,eAAO,MAAM,WAAW,wWA0Cd,CAAC;AAEX;;;;GAIG;AACH,eAAO,MAAM,eAAe,wGAYlB,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,eAAe,oBAElB,CAAC;AAEX;;;;GAIG;AACH,eAAO,MAAM,WAAW,uNA4Bd,CAAC;AAEX;;;;GAIG;AACH,eAAO,MAAM,cAAc,4BAGjB,CAAC;AAEX;;;;GAIG;AACH,eAAO,MAAM,cAAc,2CAIjB,CAAC;AAEX;;;;GAIG;AACH,eAAO,MAAM,eAAe,0CAIlB,CAAC;AAEX;;;;GAIG;AACH,eAAO,MAAM,eAAe,gDAIlB,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,kBAAkB,4BAGrB,CAAC;AAEX;;;;GAIG;AACH,eAAO,MAAM,YAAY,sCAIf,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,YAAY,wEAOf,CAAC;AAEX;;;;;GAKG;AACH,eAAO,MAAM,iBAAiB,yCAIpB,CAAC;AAMX;;;;;GAKG;AACH,eAAO,MAAM,wBAAwB,6JAa3B,CAAC;AAEX;;;;GAIG;AACH,eAAO,MAAM,uBAAuB,sSAsB1B,CAAC;AAEX;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,mGAQvB,CAAC;AAEX;;;;GAIG;AACH,eAAO,MAAM,4BAA4B,iFAO/B,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAa5D,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,CAoB9D;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAGjE"}