@orbytautomation/engine 0.2.4 → 0.4.0

package/dist/errors/ErrorFormatter.js

@@ -2,11 +2,36 @@
  * Error Formatter
  *
  * Formats Orbyt errors for CLI display with colors and helpful formatting.
- * Provides human-readable error output for developers.
+ * Provides human-readable error output for developers with:
+ * - Colored output for severity levels
+ * - Exit code information
+ * - Error category and retryability
+ * - Contextual debugging information
+ * - Integration with EngineLogger for proper log management
+ *
+ * USAGE:
+ * =====
+ * ```typescript
+ * // Format single error
+ * const formatted = formatError(error);
+ * console.error(formatted);
+ *
+ * // Format multiple errors
+ * const formatted = formatErrors(errors);
+ * console.error(formatted);
+ *
+ * // Detailed format with all diagnostics
+ * const detailed = formatDetailedError(error);
+ * console.error(detailed);
+ *
+ * // Log error using EngineLogger
+ * logErrorToEngine(error, logger);
+ * ```
  *
  * @module errors
  */
 import { ErrorSeverity } from './ErrorCodes.js';
+import { LogLevel } from '@dev-ecosystem/core';
 /**
  * ANSI color codes for terminal output
  */
@@ -25,9 +50,10 @@ const colors = {
  *
  * @param error - Orbyt error to format
  * @param useColors - Whether to use ANSI colors (default: true)
+ * @param verbose - Show additional diagnostic info (default: false)
  * @returns Formatted error string
  */
-export function formatError(error, useColors = true) {
+export function formatError(error, useColors = true, verbose = false) {
     const c = useColors ? colors : {
         reset: '',
         bold: '',
@@ -56,6 +82,26 @@ export function formatError(error, useColors = true) {
         lines.push('');
         lines.push(`${c.blue}\u2192 Hint:${c.reset} ${error.hint}`);
     }
+    // Verbose mode: show additional diagnostics
+    if (verbose) {
+        lines.push('');
+        lines.push(`${c.dim}Exit Code:${c.reset} ${error.exitCode} (${error.getExitCodeDescription()})`);
+        lines.push(`${c.dim}Category:${c.reset} ${error.category}`);
+        const flags = [];
+        if (error.isUserError)
+            flags.push('User-fixable');
+        if (error.isRetryable)
+            flags.push('Retryable');
+        if (flags.length > 0) {
+            lines.push(`${c.dim}Flags:${c.reset} ${flags.join(', ')}`);
+        }
+        // Show context if available
+        if (error.diagnostic.context && Object.keys(error.diagnostic.context).length > 0) {
+            lines.push('');
+            lines.push(`${c.dim}Context:${c.reset}`);
+            lines.push(c.gray + JSON.stringify(error.diagnostic.context, null, 2) + c.reset);
+        }
+    }
     return lines.join('\n');
 }
 /**
@@ -63,9 +109,10 @@ export function formatError(error, useColors = true) {
  *
  * @param errors - Array of Orbyt errors
  * @param useColors - Whether to use ANSI colors
+ * @param verbose - Show additional diagnostic info
  * @returns Formatted errors string
  */
-export function formatErrors(errors, useColors = true) {
+export function formatErrors(errors, useColors = true, verbose = false) {
     const c = useColors ? colors : {
         reset: '',
         bold: '',
@@ -87,10 +134,67 @@ export function formatErrors(errors, useColors = true) {
             lines.push(c.dim + '\u2500'.repeat(50) + c.reset);
             lines.push('');
         }
-        lines.push(formatError(error, useColors));
+        lines.push(formatError(error, useColors, verbose));
     });
     return lines.join('\n');
 }
+/**
+ * Format error with full diagnostic information
+ * Useful for debugging and detailed error analysis
+ *
+ * @param error - Orbyt error to format
+ * @param useColors - Whether to use ANSI colors
+ * @returns Detailed formatted error string
+ */
+export function formatDetailedError(error, useColors = true) {
+    const c = useColors ? colors : {
+        reset: '',
+        bold: '',
+        dim: '',
+        red: '',
+        yellow: '',
+        blue: '',
+        cyan: '',
+        gray: '',
+    };
+    // Use OrbytError's toDetailedString for comprehensive output
+    const detailed = error.toDetailedString();
+    // Colorize the output
+    if (useColors) {
+        return detailed
+            .replace(/\[ERROR\]/g, `${c.red}[ERROR]${c.reset}`)
+            .replace(/\[WARNING\]/g, `${c.yellow}[WARNING]${c.reset}`)
+            .replace(/\[INFO\]/g, `${c.blue}[INFO]${c.reset}`)
+            .replace(/Exit Code:/g, `${c.bold}Exit Code:${c.reset}`)
+            .replace(/Description:/g, `${c.bold}Description:${c.reset}`)
+            .replace(/Hint:/g, `${c.blue}Hint:${c.reset}`)
+            .replace(/Path:/g, `${c.cyan}Path:${c.reset}`)
+            .replace(/Context:/g, `${c.dim}Context:${c.reset}`);
+    }
+    return detailed;
+}
+/**
+ * Format error summary (one-line format)
+ * Useful for logging or compact display
+ *
+ * @param error - Orbyt error to format
+ * @param useColors - Whether to use ANSI colors
+ * @returns One-line error summary
+ */
+export function formatErrorSummary(error, useColors = true) {
+    const c = useColors ? colors : {
+        reset: '',
+        bold: '',
+        red: '',
+        yellow: '',
+        blue: '',
+        gray: '',
+    };
+    const color = getSeverityColor(error.severity, c);
+    const icon = getSeverityIcon(error.severity);
+    const path = error.path ? ` at ${error.path}` : '';
+    return `${color}${icon} ${error.code}${c.reset}${path}: ${c.bold}${error.message}${c.reset}`;
+}
 /**
  * Get icon for error severity
  */
@@ -137,4 +241,116 @@ export function createBox(text, useColors = true) {
     const boxedLines = lines.map(line => `${c.dim}\u2502${c.reset} ${line.padEnd(maxLength)} ${c.dim}\u2502${c.reset}`);
     return [top, ...boxedLines, bottom].join('\n');
 }
+/**
+ * Map ErrorSeverity to LogLevel
+ * Converts Orbyt's error severity to ecosystem-core's log level
+ *
+ * @param severity - Error severity
+ * @returns Corresponding log level
+ */
+export function errorSeverityToLogLevel(severity) {
+    switch (severity) {
+        case ErrorSeverity.CRITICAL:
+        case ErrorSeverity.FATAL:
+            return LogLevel.FATAL;
+        case ErrorSeverity.ERROR:
+            return LogLevel.ERROR;
+        case ErrorSeverity.MEDIUM:
+        case ErrorSeverity.LOW:
+        case ErrorSeverity.WARNING:
+            return LogLevel.WARN;
+        case ErrorSeverity.INFO:
+            return LogLevel.INFO;
+        default:
+            return LogLevel.ERROR;
+    }
+}
+/**
+ * Log an error to EngineLogger with proper formatting
+ *
+ * This is the primary way to log errors during workflow loading and execution.
+ * It maps Orbyt's ErrorSeverity to ecosystem-core's LogLevel and includes
+ * all relevant context.
+ *
+ * @param error - Orbyt error to log
+ * @param logger - EngineLogger instance
+ * @param includeDebugInfo - Whether to include full diagnostic info (default: true)
+ */
+export function logErrorToEngine(error, logger, includeDebugInfo = true) {
+    const logLevel = errorSeverityToLogLevel(error.severity);
+    // Build context with error details
+    const context = {
+        errorCode: error.code,
+        exitCode: error.exitCode,
+        category: error.category,
+        severity: error.severity,
+        userError: error.isUserError,
+        retryable: error.isRetryable,
+    };
+    // Add path if available
+    if (error.path) {
+        context.path = error.path;
+    }
+    // Add hint if available
+    if (error.hint) {
+        context.hint = error.hint;
+    }
+    // Add diagnostic context
+    if (includeDebugInfo && error.diagnostic.context) {
+        context.diagnostic = error.diagnostic.context;
+    }
+    // Log based on severity
+    switch (logLevel) {
+        case LogLevel.FATAL:
+            logger.fatal(error.message, error, context);
+            break;
+        case LogLevel.ERROR:
+            logger.error(error.message, error, context);
+            break;
+        case LogLevel.WARN:
+            logger.warn(error.message, context);
+            break;
+        case LogLevel.INFO:
+            logger.info(error.message, context);
+            break;
+        default:
+            logger.error(error.message, error, context);
+    }
+}
+/**
+ * Log multiple errors to EngineLogger
+ *
+ * @param errors - Array of Orbyt errors
+ * @param logger - EngineLogger instance
+ * @param includeDebugInfo - Whether to include full diagnostic info
+ */
+export function logErrorsToEngine(errors, logger, includeDebugInfo = true) {
+    // Log summary first
+    logger.error(`Found ${errors.length} error(s) during workflow processing`, undefined, {
+        errorCount: errors.length,
+        errorCodes: errors.map(e => e.code),
+    });
+    // Log each error
+    errors.forEach((error) => {
+        logErrorToEngine(error, logger, includeDebugInfo);
+    });
+}
+/**
+ * Format and log error (combined operation)
+ * Returns formatted string AND logs to EngineLogger if provided
+ *
+ * @param error - Orbyt error
+ * @param logger - Optional EngineLogger instance
+ * @param options - Formatting options
+ * @returns Formatted error string
+ */
+export function formatAndLogError(error, logger, options) {
+    const { useColors = true, verbose = false, includeDebugInfo = true } = options || {};
+    // Log to engine if logger provided
+    if (logger) {
+        logErrorToEngine(error, logger, includeDebugInfo);
+    }
+    // Return formatted string for console/CLI
+    return formatError(error, useColors, verbose);
+}
 //# sourceMappingURL=ErrorFormatter.js.map

package/dist/errors/ErrorFormatter.js.map

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

package/dist/errors/ErrorHandler.d.ts

@@ -0,0 +1,259 @@
+/**
+ * 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 { type ErrorContext } from './ErrorDetector.js';
+import { ExecutionControl } from './ErrorCodes.js';
+/**
+ * Error handling result
+ * Contains all information needed to make execution decisions
+ */
+export interface ErrorHandlingResult {
+    /** The detected and classified OrbytError */
+    error: OrbytError;
+    /** Execution control action (STOP_WORKFLOW, STOP_STEP, CONTINUE) */
+    control: ExecutionControl;
+    /** Should stop entire workflow execution? */
+    shouldStopWorkflow: boolean;
+    /** Should stop current step execution? */
+    shouldStopStep: boolean;
+    /** Can continue execution? */
+    shouldContinue: boolean;
+    /** Debug information with solutions */
+    debug?: {
+        /** Plain English explanation */
+        explanation: string;
+        /** Root cause analysis */
+        cause: string;
+        /** Step-by-step fix instructions */
+        fixSteps: string[];
+        /** Quick one-line fix */
+        quickFix: string;
+        /** Formatted output for CLI display */
+        formatted: string;
+        /** Detailed output with all diagnostics */
+        detailed: string;
+        /** Common mistakes that lead to this error */
+        commonMistakes?: string[];
+        /** Estimated time to fix */
+        estimatedFixTime?: string;
+    };
+    /** Log entry (what was logged to console/logger) */
+    logEntry?: {
+        level: 'error' | 'warn' | 'info';
+        message: string;
+        metadata: Record<string, any>;
+        timestamp: Date;
+    };
+}
+/**
+ * Error handler configuration options
+ */
+export interface ErrorHandlerOptions {
+    /** Enable automatic logging to console/logger (default: true) */
+    enableLogging?: boolean;
+    /** Enable debug info generation for troubleshooting (default: false in engine, true in CLI) */
+    enableDebug?: boolean;
+    /** Use colored output for terminal (default: true) */
+    useColors?: boolean;
+    /** Custom logger implementation (defaults to console) */
+    logger?: {
+        error: (message: string, meta?: any) => void;
+        warn: (message: string, meta?: any) => void;
+        info: (message: string, meta?: any) => void;
+    };
+    /** Additional context to include in logs */
+    context?: Record<string, any>;
+}
+/**
+ * Error Handler
+ *
+ * Unified error handling system for Orbyt engine.
+ * Automatically detects, classifies, logs, and controls execution based on errors.
+ */
+export declare 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 handle(error: unknown, errorContext?: Partial<ErrorContext>, options?: ErrorHandlerOptions): Promise<ErrorHandlingResult>;
+    /**
+     * 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 handleLoaderError(error: unknown, filePath: string, options?: ErrorHandlerOptions): Promise<ErrorHandlingResult>;
+    /**
+     * 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 handleContext(context: ErrorContext, options?: ErrorHandlerOptions): Promise<ErrorHandlingResult>;
+    /**
+     * 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 shouldStop(error: unknown, location?: string): Promise<boolean>;
+    /**
+     * 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 handleBatch(errors: unknown[], options?: ErrorHandlerOptions): Promise<ErrorHandlingResult[]>;
+    /**
+     * 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: ErrorHandlingResult[]): ErrorHandlingResult | undefined;
+    /**
+     * 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: ErrorHandlingResult[]): boolean;
+    /**
+     * Detect and classify error into OrbytError
+     */
+    private static detectError;
+    /**
+     * Detect error type from WorkflowLoader errors
+     */
+    private static detectLoaderErrorType;
+    /**
+     * Log error with appropriate level
+     */
+    private static logError;
+    /**
+     * Generate complete debug information
+     */
+    private static generateDebugInfo;
+}
+/**
+ * Global error handler instance for convenience
+ * Can be used for setting default options
+ */
+export declare class GlobalErrorHandler {
+    private static defaultOptions;
+    /**
+     * Configure default options for all error handling
+     */
+    static configure(options: Partial<ErrorHandlerOptions>): void;
+    /**
+     * Handle error with default options
+     */
+    static handle(error: unknown, context?: Partial<ErrorContext>): Promise<ErrorHandlingResult>;
+    /**
+     * Get current default options
+     */
+    static getOptions(): ErrorHandlerOptions;
+}
+//# sourceMappingURL=ErrorHandler.d.ts.map

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

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