@orbytautomation/engine 0.2.3 → 0.3.0

package/dist/errors/ErrorCodes.js

@@ -1,21 +1,48 @@
 /**
  * Orbyt Error Codes
  *
- * Stable error codes for reliable error handling and documentation.
+ * Structured error codes for the Orbyt workflow execution engine.
+ * These codes are separate from ecosystem exit codes (process-level).
+ *
+ * ARCHITECTURE:
+ * ============
+ * - Error Codes (ORB-XX-NNN): Structured diagnostic codes for detailed error identification
+ * - Exit Codes (100-509): Process-level codes from @dev-ecosystem/core for shell scripts
+ *
+ * TWO-LAYER SYSTEM:
+ * ================
+ * 1. Exit Codes (@dev-ecosystem/core): Process termination codes for the whole ecosystem
+ *    - Used by CLI, API, SDK to determine process exit status
+ *    - Example: ExitCodes.INVALID_SCHEMA (103) for schema validation failures
+ *
+ * 2. Error Codes (This file): Detailed diagnostic codes specific to Orbyt
+ *    - Used internally by engine for precise error identification
+ *    - Maps to exit codes for process termination
+ *    - Example: ORB-S-001 (unknown field) → ExitCodes.INVALID_SCHEMA
+ *
  * Format: ORB-[Category]-[Number]
  *
  * Categories:
- * - S: Schema/Structure errors
- * - V: Validation/Logic errors
- * - E: Execution errors
- * - R: Runtime errors
+ * - S: Schema/Structure errors (YAML syntax, field validation)
+ * - V: Validation/Logic errors (duplicate IDs, circular deps)
+ * - E: Execution errors (step failures, timeouts)
+ * - R: Runtime errors (file not found, permissions)
+ *
+ * ADDING NEW ERRORS:
+ * =================
+ * 1. Add error code enum value below
+ * 2. Add description in getErrorDescription()
+ * 3. Add exit code mapping in getExitCodeForError()
+ * 4. Add to appropriate error class (WorkflowError, StepError, etc.)
  *
  * @module errors
  */
+import { ExitCodes } from '@dev-ecosystem/core';
 export var OrbytErrorCode;
 (function (OrbytErrorCode) {
     // ============================================================================
     // SCHEMA ERRORS (S) - Structure problems
+    // Exit Code: ExitCodes.INVALID_SCHEMA (103)
     // ============================================================================
     /** Unknown field in workflow definition */
     OrbytErrorCode["SCHEMA_UNKNOWN_FIELD"] = "ORB-S-001";
@@ -29,8 +56,11 @@ export var OrbytErrorCode;
     OrbytErrorCode["SCHEMA_PARSE_ERROR"] = "ORB-S-005";
     /** Invalid field format/pattern */
     OrbytErrorCode["SCHEMA_INVALID_FORMAT"] = "ORB-S-006";
+    /** Reserved field detected (security) */
+    OrbytErrorCode["SCHEMA_RESERVED_FIELD"] = "ORB-S-007";
     // ============================================================================
     // VALIDATION ERRORS (V) - Logic problems
+    // Exit Code: ExitCodes.VALIDATION_FAILED (105)
     // ============================================================================
     /** Duplicate step ID */
     OrbytErrorCode["VALIDATION_DUPLICATE_ID"] = "ORB-V-001";
@@ -48,8 +78,13 @@ export var OrbytErrorCode;
     OrbytErrorCode["VALIDATION_MISSING_INPUT"] = "ORB-V-007";
     /** Invalid adapter/action */
     OrbytErrorCode["VALIDATION_UNKNOWN_ADAPTER"] = "ORB-V-008";
+    /** Workflow has no steps */
+    OrbytErrorCode["VALIDATION_EMPTY_WORKFLOW"] = "ORB-V-009";
+    /** Invalid condition expression syntax */
+    OrbytErrorCode["VALIDATION_INVALID_CONDITION"] = "ORB-V-010";
     // ============================================================================
     // EXECUTION ERRORS (E) - Runtime failures
+    // Exit Code: ExitCodes.WORKFLOW_FAILED (300), ExitCodes.STEP_FAILED (301)
     // ============================================================================
     /** Step execution failed */
     OrbytErrorCode["EXECUTION_STEP_FAILED"] = "ORB-E-001";
@@ -59,8 +94,13 @@ export var OrbytErrorCode;
     OrbytErrorCode["EXECUTION_ADAPTER_ERROR"] = "ORB-E-003";
     /** Workflow cancelled */
     OrbytErrorCode["EXECUTION_CANCELLED"] = "ORB-E-004";
+    /** Step dependency failed */
+    OrbytErrorCode["EXECUTION_DEPENDENCY_FAILED"] = "ORB-E-005";
+    /** Conditional check failed */
+    OrbytErrorCode["EXECUTION_CONDITION_FAILED"] = "ORB-E-006";
     // ============================================================================
     // RUNTIME ERRORS (R) - System/Infrastructure
+    // Exit Code: ExitCodes.INTERNAL_ERROR (500), ExitCodes.FILESYSTEM_ERROR (506)
     // ============================================================================
     /** File not found */
     OrbytErrorCode["RUNTIME_FILE_NOT_FOUND"] = "ORB-R-001";
@@ -68,18 +108,51 @@ export var OrbytErrorCode;
     OrbytErrorCode["RUNTIME_PERMISSION_DENIED"] = "ORB-R-002";
     /** Internal engine error */
     OrbytErrorCode["RUNTIME_INTERNAL_ERROR"] = "ORB-R-003";
+    /** Adapter not registered */
+    OrbytErrorCode["RUNTIME_ADAPTER_NOT_FOUND"] = "ORB-R-004";
+    /** Resource exhausted */
+    OrbytErrorCode["RUNTIME_RESOURCE_EXHAUSTED"] = "ORB-R-005";
 })(OrbytErrorCode || (OrbytErrorCode = {}));
 /**
  * Error severity levels
+ * Used for prioritizing and determining execution control
+ *
+ * EXECUTION CONTROL BEHAVIOR:
+ * - CRITICAL/FATAL: Stop entire workflow execution immediately
+ * - ERROR/HIGH: Stop entire workflow execution (default for errors)
+ * - MEDIUM: Stop current step, attempt to continue to next step
+ * - LOW: Log warning and continue current step
+ * - WARNING: Log warning message, continue execution
+ * - INFO: Log informational message, continue execution
  */
 export var ErrorSeverity;
 (function (ErrorSeverity) {
+    /** Critical error - stop entire workflow immediately (unrecoverable) */
+    ErrorSeverity["CRITICAL"] = "critical";
+    /** Fatal error - stop entire workflow (severe failure) */
+    ErrorSeverity["FATAL"] = "fatal";
+    /** High severity error - stop entire workflow */
     ErrorSeverity["ERROR"] = "error";
+    /** Medium severity - stop current step, try to continue workflow */
+    ErrorSeverity["MEDIUM"] = "medium";
+    /** Low severity - log and continue current step */
+    ErrorSeverity["LOW"] = "low";
+    /** Warning - log warning message, continue execution */
     ErrorSeverity["WARNING"] = "warning";
+    /** Informational message */
     ErrorSeverity["INFO"] = "info";
 })(ErrorSeverity || (ErrorSeverity = {}));
 /**
  * Get human-readable category name from error code
+ *
+ * @param code - Orbyt error code
+ * @returns Category name (e.g., "Schema Error")
+ *
+ * @example
+ * ```typescript
+ * const category = getErrorCategory(OrbytErrorCode.SCHEMA_UNKNOWN_FIELD);
+ * // Returns: "Schema Error"
+ * ```
  */
 export function getErrorCategory(code) {
     if (code.startsWith('ORB-S-'))
@@ -92,4 +165,324 @@ export function getErrorCategory(code) {
         return 'Runtime Error';
     return 'Unknown Error';
 }
+/**
+ * Get detailed description for an error code
+ * Helps users understand what went wrong
+ *
+ * @param code - Orbyt error code
+ * @returns Human-readable description
+ *
+ * @example
+ * ```typescript
+ * const desc = getErrorDescription(OrbytErrorCode.SCHEMA_UNKNOWN_FIELD);
+ * // Returns: "Workflow contains an unknown or misspelled field name"
+ * ```
+ */
+export function getErrorDescription(code) {
+    const descriptions = {
+        // Schema Errors
+        [OrbytErrorCode.SCHEMA_UNKNOWN_FIELD]: 'Workflow contains an unknown or misspelled field name. Check that all field names match the Orbyt schema.',
+        [OrbytErrorCode.SCHEMA_INVALID_TYPE]: 'Field has incorrect type (e.g., string instead of number). Review the expected type for this field.',
+        [OrbytErrorCode.SCHEMA_MISSING_FIELD]: 'Required field is missing from workflow definition. All required fields must be present.',
+        [OrbytErrorCode.SCHEMA_INVALID_ENUM]: 'Field value is not one of the allowed options. Check the valid values for this field.',
+        [OrbytErrorCode.SCHEMA_PARSE_ERROR]: 'YAML/JSON syntax error prevents parsing. Check for missing colons, incorrect indentation, or unmatched brackets.',
+        [OrbytErrorCode.SCHEMA_INVALID_FORMAT]: 'Field value does not match expected format or pattern (e.g., invalid ID format, malformed timeout).',
+        [OrbytErrorCode.SCHEMA_RESERVED_FIELD]: 'Workflow uses a reserved field that is controlled by the engine. Remove fields starting with "_" or other reserved names.',
+        // Validation Errors
+        [OrbytErrorCode.VALIDATION_DUPLICATE_ID]: 'Two or more steps have the same ID. Each step must have a unique identifier.',
+        [OrbytErrorCode.VALIDATION_UNKNOWN_STEP]: 'Step references another step that does not exist. Verify that all step references point to valid step IDs.',
+        [OrbytErrorCode.VALIDATION_CIRCULAR_DEPENDENCY]: 'Steps depend on each other in a circular way (A needs B, B needs A). Break the cycle.',
+        [OrbytErrorCode.VALIDATION_INVALID_ORDER]: 'Steps are not in valid execution order. Check the "needs" dependencies.',
+        [OrbytErrorCode.VALIDATION_FORWARD_REFERENCE]: 'Step references another step that executes later. Steps can only reference earlier steps.',
+        [OrbytErrorCode.VALIDATION_INVALID_VARIABLE]: 'Variable reference is invalid or undefined. Check variable syntax and availability.',
+        [OrbytErrorCode.VALIDATION_MISSING_INPUT]: 'Required input parameter is missing. Provide all required inputs.',
+        [OrbytErrorCode.VALIDATION_UNKNOWN_ADAPTER]: 'Adapter or action does not exist. Verify the "uses" field references a valid adapter.',
+        [OrbytErrorCode.VALIDATION_EMPTY_WORKFLOW]: 'Workflow has no steps defined. At least one step is required.',
+        [OrbytErrorCode.VALIDATION_INVALID_CONDITION]: 'Condition expression has invalid syntax. Check operators and variable references.',
+        // Execution Errors
+        [OrbytErrorCode.EXECUTION_STEP_FAILED]: 'Step execution failed during runtime. Check step configuration and adapter logs.',
+        [OrbytErrorCode.EXECUTION_TIMEOUT]: 'Step or workflow exceeded time limit. Consider increasing timeout or optimizing the step.',
+        [OrbytErrorCode.EXECUTION_ADAPTER_ERROR]: 'Adapter encountered an error during execution. Check adapter configuration and logs.',
+        [OrbytErrorCode.EXECUTION_CANCELLED]: 'Workflow was cancelled by user or system. Execution was interrupted intentionally.',
+        [OrbytErrorCode.EXECUTION_DEPENDENCY_FAILED]: 'Step could not run because a dependency failed. Fix the failing dependency first.',
+        [OrbytErrorCode.EXECUTION_CONDITION_FAILED]: 'Step condition evaluated to false. This is expected behavior when conditions are not met.',
+        // Runtime Errors
+        [OrbytErrorCode.RUNTIME_FILE_NOT_FOUND]: 'Required file or workflow does not exist at the specified path. Check file path and spelling.',
+        [OrbytErrorCode.RUNTIME_PERMISSION_DENIED]: 'Insufficient permissions to access resource. Check file permissions and user access rights.',
+        [OrbytErrorCode.RUNTIME_INTERNAL_ERROR]: 'Internal engine error occurred. This may indicate a bug - please report with details.',
+        [OrbytErrorCode.RUNTIME_ADAPTER_NOT_FOUND]: 'Adapter is not registered with the engine. Make sure the adapter is installed and loaded.',
+        [OrbytErrorCode.RUNTIME_RESOURCE_EXHAUSTED]: 'System resources exhausted (memory, CPU, disk). Reduce resource usage or increase limits.',
+    };
+    return descriptions[code] || 'Unknown error occurred';
+}
+/**
+ * Map Orbyt error code to ecosystem exit code
+ * Determines which process exit code should be used
+ *
+ * @param code - Orbyt error code
+ * @returns Exit code from @dev-ecosystem/core
+ *
+ * @example
+ * ```typescript
+ * const exitCode = getExitCodeForError(OrbytErrorCode.SCHEMA_UNKNOWN_FIELD);
+ * // Returns: ExitCodes.INVALID_SCHEMA (103)
+ * ```
+ */
+export function getExitCodeForError(code) {
+    // Schema errors → INVALID_SCHEMA
+    if (code.startsWith('ORB-S-')) {
+        if (code === OrbytErrorCode.SCHEMA_PARSE_ERROR) {
+            return ExitCodes.INVALID_FORMAT;
+        }
+        if (code === OrbytErrorCode.SCHEMA_RESERVED_FIELD) {
+            return ExitCodes.SECURITY_VIOLATION;
+        }
+        return ExitCodes.INVALID_SCHEMA;
+    }
+    // Validation errors → VALIDATION_FAILED
+    if (code.startsWith('ORB-V-')) {
+        if (code === OrbytErrorCode.VALIDATION_CIRCULAR_DEPENDENCY) {
+            return ExitCodes.CIRCULAR_DEPENDENCY;
+        }
+        if (code === OrbytErrorCode.VALIDATION_MISSING_INPUT) {
+            return ExitCodes.MISSING_REQUIRED_INPUT;
+        }
+        return ExitCodes.VALIDATION_FAILED;
+    }
+    // Execution errors → specific execution codes
+    if (code.startsWith('ORB-E-')) {
+        if (code === OrbytErrorCode.EXECUTION_TIMEOUT) {
+            return ExitCodes.TIMEOUT;
+        }
+        if (code === OrbytErrorCode.EXECUTION_STEP_FAILED) {
+            return ExitCodes.STEP_FAILED;
+        }
+        if (code === OrbytErrorCode.EXECUTION_ADAPTER_ERROR) {
+            return ExitCodes.ADAPTER_FAILED;
+        }
+        if (code === OrbytErrorCode.EXECUTION_DEPENDENCY_FAILED) {
+            return ExitCodes.DEPENDENCY_FAILED;
+        }
+        return ExitCodes.WORKFLOW_FAILED;
+    }
+    // Runtime errors → system-level codes
+    if (code.startsWith('ORB-R-')) {
+        if (code === OrbytErrorCode.RUNTIME_FILE_NOT_FOUND) {
+            return ExitCodes.INVALID_FILE;
+        }
+        if (code === OrbytErrorCode.RUNTIME_PERMISSION_DENIED) {
+            return ExitCodes.PERMISSION_DENIED;
+        }
+        if (code === OrbytErrorCode.RUNTIME_ADAPTER_NOT_FOUND) {
+            return ExitCodes.MISSING_DEPENDENCY;
+        }
+        return ExitCodes.INTERNAL_ERROR;
+    }
+    return ExitCodes.INTERNAL_ERROR;
+}
+/**
+ * Check if an error code represents a user error (fixable by changing workflow)
+ * vs system error (infrastructure, permissions, etc.)
+ *
+ * User errors are problems with the workflow definition that the user can fix.
+ * System errors are infrastructure/runtime issues outside user control.
+ *
+ * @param code - Orbyt error code
+ * @returns True if error is user-fixable
+ *
+ * @example
+ * ```typescript
+ * if (isUserError(error.code)) {
+ *   console.log('Fix your workflow definition');
+ * } else {
+ *   console.log('Contact system administrator');
+ * }
+ * ```
+ */
+export function isUserError(code) {
+    // Schema and validation errors are always user-fixable
+    return code.startsWith('ORB-S-') || code.startsWith('ORB-V-');
+}
+/**
+ * Check if an error code represents a retryable error
+ * Some errors (like timeouts, adapter failures) might succeed on retry.
+ * Others (like validation errors) will always fail.
+ *
+ * @param code - Orbyt error code
+ * @returns True if error might succeed on retry
+ *
+ * @example
+ * ```typescript
+ * if (isRetryable(error.code) && retryCount < maxRetries) {
+ *   console.log('Retrying...');
+ *   await retry();
+ * }
+ * ```
+ */
+export function isRetryable(code) {
+    // Only specific execution and runtime errors are retryable
+    const retryableErrors = [
+        OrbytErrorCode.EXECUTION_TIMEOUT,
+        OrbytErrorCode.EXECUTION_ADAPTER_ERROR,
+        OrbytErrorCode.RUNTIME_RESOURCE_EXHAUSTED,
+    ];
+    return retryableErrors.includes(code);
+}
+/**
+ * Get suggested action for an error code
+ * Provides actionable guidance for users
+ *
+ * @param code - Orbyt error code
+ * @returns Suggested action to fix the error
+ *
+ * @example
+ * ```typescript
+ * const action = getSuggestedAction(OrbytErrorCode.SCHEMA_UNKNOWN_FIELD);
+ * console.log(action); // "Check field names against schema documentation"
+ * ```
+ */
+export function getSuggestedAction(code) {
+    const actions = {
+        // Schema Errors
+        [OrbytErrorCode.SCHEMA_UNKNOWN_FIELD]: 'Check field names against schema documentation',
+        [OrbytErrorCode.SCHEMA_INVALID_TYPE]: 'Review field type requirements in schema',
+        [OrbytErrorCode.SCHEMA_MISSING_FIELD]: 'Add the missing required field',
+        [OrbytErrorCode.SCHEMA_INVALID_ENUM]: 'Use one of the allowed values',
+        [OrbytErrorCode.SCHEMA_PARSE_ERROR]: 'Fix YAML/JSON syntax errors',
+        [OrbytErrorCode.SCHEMA_INVALID_FORMAT]: 'Correct the field format (check regex patterns)',
+        [OrbytErrorCode.SCHEMA_RESERVED_FIELD]: 'Remove reserved fields (those starting with "_")',
+        // Validation Errors
+        [OrbytErrorCode.VALIDATION_DUPLICATE_ID]: 'Rename duplicate steps to have unique IDs',
+        [OrbytErrorCode.VALIDATION_UNKNOWN_STEP]: 'Fix step reference or add missing step',
+        [OrbytErrorCode.VALIDATION_CIRCULAR_DEPENDENCY]: 'Break the dependency cycle',
+        [OrbytErrorCode.VALIDATION_INVALID_ORDER]: 'Reorder steps or fix "needs" dependencies',
+        [OrbytErrorCode.VALIDATION_FORWARD_REFERENCE]: 'Ensure steps only reference earlier steps',
+        [OrbytErrorCode.VALIDATION_INVALID_VARIABLE]: 'Check variable name and availability',
+        [OrbytErrorCode.VALIDATION_MISSING_INPUT]: 'Provide the required input parameter',
+        [OrbytErrorCode.VALIDATION_UNKNOWN_ADAPTER]: 'Install adapter or fix "uses" field',
+        [OrbytErrorCode.VALIDATION_EMPTY_WORKFLOW]: 'Add at least one step to workflow',
+        [OrbytErrorCode.VALIDATION_INVALID_CONDITION]: 'Fix condition syntax or check variable references',
+        // Execution Errors
+        [OrbytErrorCode.EXECUTION_STEP_FAILED]: 'Check step configuration and logs',
+        [OrbytErrorCode.EXECUTION_TIMEOUT]: 'Increase timeout or optimize step',
+        [OrbytErrorCode.EXECUTION_ADAPTER_ERROR]: 'Check adapter configuration and logs',
+        [OrbytErrorCode.EXECUTION_CANCELLED]: 'Resume workflow or investigate cancellation',
+        [OrbytErrorCode.EXECUTION_DEPENDENCY_FAILED]: 'Fix the failing dependency step',
+        [OrbytErrorCode.EXECUTION_CONDITION_FAILED]: 'Review condition logic or accept skip',
+        // Runtime Errors
+        [OrbytErrorCode.RUNTIME_FILE_NOT_FOUND]: 'Check file path exists and is accessible',
+        [OrbytErrorCode.RUNTIME_PERMISSION_DENIED]: 'Check file permissions',
+        [OrbytErrorCode.RUNTIME_INTERNAL_ERROR]: 'Report bug with full error details',
+        [OrbytErrorCode.RUNTIME_ADAPTER_NOT_FOUND]: 'Install and register the adapter',
+        [OrbytErrorCode.RUNTIME_RESOURCE_EXHAUSTED]: 'Free up resources or increase limits',
+    };
+    return actions[code] || 'Review error details and check documentation';
+}
+/**
+ * Execution Control Actions
+ * Determines what action to take when error occurs
+ */
+export var ExecutionControl;
+(function (ExecutionControl) {
+    /** Stop entire workflow execution immediately */
+    ExecutionControl["STOP_WORKFLOW"] = "STOP_WORKFLOW";
+    /** Stop current step, try to continue to next step */
+    ExecutionControl["STOP_STEP"] = "STOP_STEP";
+    /** Continue execution, just log the issue */
+    ExecutionControl["CONTINUE"] = "CONTINUE";
+})(ExecutionControl || (ExecutionControl = {}));
+/**
+ * Get execution control action based on severity
+ * Determines whether to stop workflow, stop step, or continue
+ *
+ * @param severity - Error severity level
+ * @returns Execution control action
+ *
+ * @example
+ * ```typescript
+ * const action = getExecutionControl(ErrorSeverity.CRITICAL);
+ * // Returns: ExecutionControl.STOP_WORKFLOW
+ *
+ * const action2 = getExecutionControl(ErrorSeverity.MEDIUM);
+ * // Returns: ExecutionControl.STOP_STEP
+ * ```
+ */
+export function getExecutionControl(severity) {
+    switch (severity) {
+        case ErrorSeverity.CRITICAL:
+        case ErrorSeverity.FATAL:
+        case ErrorSeverity.ERROR:
+            return ExecutionControl.STOP_WORKFLOW;
+        case ErrorSeverity.MEDIUM:
+            return ExecutionControl.STOP_STEP;
+        case ErrorSeverity.LOW:
+        case ErrorSeverity.WARNING:
+        case ErrorSeverity.INFO:
+            return ExecutionControl.CONTINUE;
+        default:
+            return ExecutionControl.STOP_WORKFLOW; // Safe default
+    }
+}
+/**
+ * Check if severity should stop workflow execution
+ *
+ * @param severity - Error severity level
+ * @returns True if workflow should stop
+ */
+export function shouldStopWorkflow(severity) {
+    return getExecutionControl(severity) === ExecutionControl.STOP_WORKFLOW;
+}
+/**
+ * Check if severity should stop step execution
+ *
+ * @param severity - Error severity level
+ * @returns True if step should stop
+ */
+export function shouldStopStep(severity) {
+    const control = getExecutionControl(severity);
+    return control === ExecutionControl.STOP_WORKFLOW || control === ExecutionControl.STOP_STEP;
+}
+/**
+ * Get severity level from error code
+ * Auto-determines appropriate severity for error code
+ *
+ * @param code - Orbyt error code
+ * @returns Appropriate severity level
+ */
+export function getSeverityForErrorCode(code) {
+    // Critical errors (security violations, internal errors)
+    if (code === OrbytErrorCode.RUNTIME_INTERNAL_ERROR) {
+        return ErrorSeverity.CRITICAL;
+    }
+    if (code === OrbytErrorCode.RUNTIME_PERMISSION_DENIED) {
+        return ErrorSeverity.FATAL;
+    }
+    // Schema and validation errors are typically ERROR level
+    if (code.startsWith('ORB-S-') || code.startsWith('ORB-V-')) {
+        // But some validation errors are less severe
+        if (code === OrbytErrorCode.VALIDATION_FORWARD_REFERENCE) {
+            return ErrorSeverity.MEDIUM;
+        }
+        return ErrorSeverity.ERROR;
+    }
+    // Execution errors
+    if (code.startsWith('ORB-E-')) {
+        if (code === OrbytErrorCode.EXECUTION_TIMEOUT) {
+            return ErrorSeverity.ERROR;
+        }
+        if (code === OrbytErrorCode.EXECUTION_CONDITION_FAILED) {
+            return ErrorSeverity.LOW; // Conditions failing is often expected
+        }
+        return ErrorSeverity.MEDIUM; // Most execution errors can try next step
+    }
+    // Runtime errors
+    if (code.startsWith('ORB-R-')) {
+        if (code === OrbytErrorCode.RUNTIME_FILE_NOT_FOUND) {
+            return ErrorSeverity.MEDIUM;
+        }
+        return ErrorSeverity.ERROR;
+    }
+    // Default to ERROR for unknown codes
+    return ErrorSeverity.ERROR;
+}
 //# sourceMappingURL=ErrorCodes.js.map

package/dist/errors/ErrorCodes.js.map

@@ -1 +1 @@
-{"version":3,"file":"ErrorCodes.js","sourceRoot":"","sources":["../../src/errors/ErrorCodes.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,MAAM,CAAN,IAAY,cA+EX;AA/ED,WAAY,cAAc;IACxB,+EAA+E;IAC/E,yCAAyC;IACzC,+EAA+E;IAE/E,2CAA2C;IAC3C,oDAAkC,CAAA;IAElC,yBAAyB;IACzB,mDAAiC,CAAA;IAEjC,6BAA6B;IAC7B,oDAAkC,CAAA;IAElC,yBAAyB;IACzB,mDAAiC,CAAA;IAEjC,iCAAiC;IACjC,kDAAgC,CAAA;IAEhC,mCAAmC;IACnC,qDAAmC,CAAA;IAEnC,+EAA+E;IAC/E,yCAAyC;IACzC,+EAA+E;IAE/E,wBAAwB;IACxB,uDAAqC,CAAA;IAErC,qCAAqC;IACrC,uDAAqC,CAAA;IAErC,mCAAmC;IACnC,8DAA4C,CAAA;IAE5C,yBAAyB;IACzB,wDAAsC,CAAA;IAEtC,uCAAuC;IACvC,4DAA0C,CAAA;IAE1C,iCAAiC;IACjC,2DAAyC,CAAA;IAEzC,6BAA6B;IAC7B,wDAAsC,CAAA;IAEtC,6BAA6B;IAC7B,0DAAwC,CAAA;IAExC,+EAA+E;IAC/E,0CAA0C;IAC1C,+EAA+E;IAE/E,4BAA4B;IAC5B,qDAAmC,CAAA;IAEnC,uBAAuB;IACvB,iDAA+B,CAAA;IAE/B,oBAAoB;IACpB,uDAAqC,CAAA;IAErC,yBAAyB;IACzB,mDAAiC,CAAA;IAEjC,+EAA+E;IAC/E,6CAA6C;IAC7C,+EAA+E;IAE/E,qBAAqB;IACrB,sDAAoC,CAAA;IAEpC,wBAAwB;IACxB,yDAAuC,CAAA;IAEvC,4BAA4B;IAC5B,sDAAoC,CAAA;AACtC,CAAC,EA/EW,cAAc,KAAd,cAAc,QA+EzB;AAED;;GAEG;AACH,MAAM,CAAN,IAAY,aAIX;AAJD,WAAY,aAAa;IACvB,gCAAe,CAAA;IACf,oCAAmB,CAAA;IACnB,8BAAa,CAAA;AACf,CAAC,EAJW,aAAa,KAAb,aAAa,QAIxB;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,IAAoB;IACnD,IAAI,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC;QAAE,OAAO,cAAc,CAAC;IACrD,IAAI,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC;QAAE,OAAO,kBAAkB,CAAC;IACzD,IAAI,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC;QAAE,OAAO,iBAAiB,CAAC;IACxD,IAAI,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC;QAAE,OAAO,eAAe,CAAC;IACtD,OAAO,eAAe,CAAC;AACzB,CAAC"}
+{"version":3,"file":"ErrorCodes.js","sourceRoot":"","sources":["../../src/errors/ErrorCodes.ts"],"names":[],"mappings":"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"}

package/dist/errors/ErrorDebugger.d.ts

@@ -0,0 +1,98 @@
+/**
+ * Error Debugger (Smart Fix Suggestions)
+ *
+ * Analyzes errors and provides actionable fix suggestions.
+ * Makes debugging easy by suggesting concrete solutions.
+ *
+ * PHILOSOPHY:
+ * ==========
+ * Instead of just showing errors, guide users to fix them.
+ * Provide step-by-step solutions based on error context.
+ *
+ * USAGE:
+ * ======
+ * ```typescript
+ * // Get debug info for an error
+ * const debug = ErrorDebugger.analyze(error);
+ * console.log(debug.explanation);
+ * console.log(debug.fixSteps);
+ *
+ * // Get formatted debug output
+ * const output = ErrorDebugger.format(error);
+ * console.error(output);
+ * ```
+ *
+ * @module errors/debugger
+ */
+import { OrbytError } from './OrbytError.js';
+/**
+ * Debug information for an error
+ */
+export interface ErrorDebugInfo {
+    /** Plain English explanation of what went wrong */
+    explanation: string;
+    /** Why this error occurred (root cause) */
+    cause: string;
+    /** Step-by-step fix instructions */
+    fixSteps: string[];
+    /** Common mistakes that lead to this error */
+    commonMistakes?: string[];
+    /** Related documentation links */
+    docsLinks?: string[];
+    /** Example of correct implementation */
+    example?: {
+        description: string;
+        code: string;
+    };
+    /** Whether this requires immediate action */
+    urgent: boolean;
+    /** Estimated time to fix */
+    estimatedFixTime?: string;
+}
+/**
+ * Error Debugger
+ *
+ * Smart system that analyzes errors and provides fix suggestions.
+ */
+export declare class ErrorDebugger {
+    /**
+     * Analyze error and generate debug information
+     *
+     * @param error - OrbytError to analyze
+     * @returns Debug information with fix suggestions
+     *
+     * @example
+     * ```typescript
+     * const debug = ErrorDebugger.analyze(error);
+     * console.log(debug.explanation);
+     * debug.fixSteps.forEach((step, i) => {
+     *   console.log(`${i + 1}. ${step}`);
+     * });
+     * ```
+     */
+    static analyze(error: OrbytError): ErrorDebugInfo;
+    /**
+     * Format debug information for display
+     *
+     * @param error - Error to format
+     * @param useColors - Whether to use ANSI colors (default: true)
+     * @returns Formatted debug output
+     */
+    static format(error: OrbytError, useColors?: boolean): string;
+    /**
+     * Get base debug information for error code
+     */
+    private static getBaseDebugInfo;
+    /**
+     * Analyze error context for more specific information
+     */
+    private static analyzeContext;
+    /**
+     * Quick debug - one-line summary
+     *
+     * @param error - Error to summarize
+     * @returns One-line debug summary
+     */
+    static quickDebug(error: OrbytError): string;
+}
+//# sourceMappingURL=ErrorDebugger.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ErrorDebugger.d.ts","sourceRoot":"","sources":["../../src/errors/ErrorDebugger.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAG7C;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,mDAAmD;IACnD,WAAW,EAAE,MAAM,CAAC;IAEpB,2CAA2C;IAC3C,KAAK,EAAE,MAAM,CAAC;IAEd,oCAAoC;IACpC,QAAQ,EAAE,MAAM,EAAE,CAAC;IAEnB,8CAA8C;IAC9C,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAE1B,kCAAkC;IAClC,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IAErB,wCAAwC;IACxC,OAAO,CAAC,EAAE;QACR,WAAW,EAAE,MAAM,CAAC;QACpB,IAAI,EAAE,MAAM,CAAC;KACd,CAAC;IAEF,6CAA6C;IAC7C,MAAM,EAAE,OAAO,CAAC;IAEhB,4BAA4B;IAC5B,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED;;;;GAIG;AACH,qBAAa,aAAa;IACxB;;;;;;;;;;;;;;OAcG;IACH,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,UAAU,GAAG,cAAc;IAgBjD;;;;;;OAMG;IACH,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,UAAU,EAAE,SAAS,GAAE,OAAc,GAAG,MAAM;IAqEnE;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,gBAAgB;IA4H/B;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,cAAc;IA+B7B;;;;;OAKG;IACH,MAAM,CAAC,UAAU,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM;CAI7C"}