@orbytautomation/engine 0.5.0 → 0.6.0

package/dist/errors/ErrorHandler.d.ts

@@ -55,8 +55,55 @@ 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
+ * 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);
+ * }
+ * ```
  */
 export interface ErrorHandlingResult {
     /** The detected and classified OrbytError */
@@ -155,6 +202,10 @@ export declare class ErrorHandler {
      * Handle error from WorkflowLoader
      * Special handling for load-time errors with file path context
      *
+     * @deprecated Use {@link handleLoaderErrorEnhanced} directly. This wrapper
+     * now delegates to it so behaviour is identical, but the enhanced variant
+     * is preferred for clarity in new call sites.
+     *
      * @param error - Error from loader
      * @param filePath - Path to workflow file being loaded
      * @param options - Handler options
@@ -224,18 +275,53 @@ export declare class ErrorHandler {
      * 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
+     * Generate complete debug information.
+     *
+     * Uses context-aware variants so fix steps and formatted output reference
+     * the actual workflow file path / field name when WorkflowContext is set
+     * on LoggerManager (populated automatically by WorkflowLoader after parsing).
+     * Falls back to generic output when no context is available.
      */
     private static generateDebugInfo;
+    /**
+     * Generate debug information enriched with workflow file context.
+     *
+     * Uses {@link ErrorDebugger.formatWithContext} so the "How to fix" section
+     * references the actual file path + line number when available.
+     * Uses {@link formatErrorWithLocation} for the `detailed` field so the
+     * location header (File / Line / Field) is present in verbose output.
+     *
+     * @param error     - Detected OrbytError
+     * @param useColors - Whether to use ANSI colors
+     * @returns Debug info with context-aware fix steps
+     * @since 0.5.0
+     */
+    private static generateDebugInfoWithContext;
+    /**
+     * Handle a WorkflowLoader error with full workflow-context enrichment.
+     *
+     * Enhancement of {@link handleLoaderError} that:
+     * - Uses {@link ErrorDetector.detectFromExceptionEnhanced} to extract
+     *   line/column numbers from YAML parse errors.
+     * - Generates debug info via {@link ErrorDebugger.analyzeWithContext} so
+     *   fix steps reference the actual file path and line number.
+     * - Formats detailed output with {@link formatErrorWithLocation} for a
+     *   File: / Line: / Field: location header.
+     *
+     * Debug is always enabled for loader errors — no option needed.
+     *
+     * @param error    - Error thrown by WorkflowLoader
+     * @param filePath - Path to the workflow file being loaded
+     * @param options  - Handler options
+     * @returns Error handling result with file-aware debug info
+     * @since 0.5.0
+     */
+    static handleLoaderErrorEnhanced(error: unknown, filePath: string, options?: ErrorHandlerOptions): Promise<ErrorHandlingResult>;
 }
 /**
  * Global error handler instance for convenience

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

@@ -1 +1 @@
-{"version":3,"file":"ErrorHandler.d.ts","sourceRoot":"","sources":["../../src/errors/ErrorHandler.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"ErrorHandler.d.ts","sourceRoot":"","sources":["../../src/errors/ErrorHandler.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoDG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAiB,KAAK,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAEtE,OAAO,EAEH,gBAAgB,EAInB,MAAM,iBAAiB,CAAC;AAEzB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkDG;AACH,MAAM,WAAW,mBAAmB;IAChC,6CAA6C;IAC7C,KAAK,EAAE,UAAU,CAAC;IAElB,oEAAoE;IACpE,OAAO,EAAE,gBAAgB,CAAC;IAE1B,6CAA6C;IAC7C,kBAAkB,EAAE,OAAO,CAAC;IAE5B,0CAA0C;IAC1C,cAAc,EAAE,OAAO,CAAC;IAExB,8BAA8B;IAC9B,cAAc,EAAE,OAAO,CAAC;IAExB,uCAAuC;IACvC,KAAK,CAAC,EAAE;QACJ,gCAAgC;QAChC,WAAW,EAAE,MAAM,CAAC;QACpB,0BAA0B;QAC1B,KAAK,EAAE,MAAM,CAAC;QACd,oCAAoC;QACpC,QAAQ,EAAE,MAAM,EAAE,CAAC;QACnB,yBAAyB;QACzB,QAAQ,EAAE,MAAM,CAAC;QACjB,uCAAuC;QACvC,SAAS,EAAE,MAAM,CAAC;QAClB,2CAA2C;QAC3C,QAAQ,EAAE,MAAM,CAAC;QACjB,8CAA8C;QAC9C,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;QAC1B,4BAA4B;QAC5B,gBAAgB,CAAC,EAAE,MAAM,CAAC;KAC7B,CAAC;IAEF,oDAAoD;IACpD,QAAQ,CAAC,EAAE;QACP,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,CAAC;QACjC,OAAO,EAAE,MAAM,CAAC;QAChB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;QAC9B,SAAS,EAAE,IAAI,CAAC;KACnB,CAAC;CACL;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAChC,iEAAiE;IACjE,aAAa,CAAC,EAAE,OAAO,CAAC;IAExB,+FAA+F;IAC/F,WAAW,CAAC,EAAE,OAAO,CAAC;IAEtB,sDAAsD;IACtD,SAAS,CAAC,EAAE,OAAO,CAAC;IAEpB,yDAAyD;IACzD,MAAM,CAAC,EAAE;QACL,KAAK,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG,KAAK,IAAI,CAAC;QAC7C,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG,KAAK,IAAI,CAAC;QAC5C,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG,KAAK,IAAI,CAAC;KAC/C,CAAC;IAEF,4CAA4C;IAC5C,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CACjC;AAED;;;;;GAKG;AACH,qBAAa,YAAY;IACrB;;;;;;;;;;;;;;;;;;;;;;;;;;;OA2BG;WACU,MAAM,CACf,KAAK,EAAE,OAAO,EACd,YAAY,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,EACpC,OAAO,GAAE,mBAAwB,GAClC,OAAO,CAAC,mBAAmB,CAAC;IA0C/B;;;;;;;;;;;;OAYG;WACU,iBAAiB,CAC1B,KAAK,EAAE,OAAO,EACd,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE,mBAAwB,GAClC,OAAO,CAAC,mBAAmB,CAAC;IAI/B;;;;;;;;;;;;;;;;OAgBG;WACU,aAAa,CACtB,OAAO,EAAE,YAAY,EACrB,OAAO,GAAE,mBAAwB,GAClC,OAAO,CAAC,mBAAmB,CAAC;IAK/B;;;;;;;;;;;;;;;OAeG;WACU,UAAU,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAQ5E;;;;;;;OAOG;WACU,WAAW,CACpB,MAAM,EAAE,OAAO,EAAE,EACjB,OAAO,GAAE,mBAAwB,GAClC,OAAO,CAAC,mBAAmB,EAAE,CAAC;IAOjC;;;;;;OAMG;IACH,MAAM,CAAC,aAAa,CAAC,OAAO,EAAE,mBAAmB,EAAE,GAAG,mBAAmB,GAAG,SAAS;IAoBrF;;;;;OAKG;IACH,MAAM,CAAC,0BAA0B,CAAC,OAAO,EAAE,mBAAmB,EAAE,GAAG,OAAO;IAM1E;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,WAAW;IAqC1B;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,QAAQ;IA6CvB;;;;;;;OAOG;IACH,OAAO,CAAC,MAAM,CAAC,iBAAiB;IAqBhC;;;;;;;;;;;;OAYG;IACH,OAAO,CAAC,MAAM,CAAC,4BAA4B;IAuB3C;;;;;;;;;;;;;;;;;;OAkBG;WACU,yBAAyB,CAClC,KAAK,EAAE,OAAO,EACd,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE,mBAAwB,GAClC,OAAO,CAAC,mBAAmB,CAAC;CA+BlC;AAED;;;GAGG;AACH,qBAAa,kBAAkB;IAC3B,OAAO,CAAC,MAAM,CAAC,cAAc,CAI3B;IAEF;;OAEG;IACH,MAAM,CAAC,SAAS,CAAC,OAAO,EAAE,OAAO,CAAC,mBAAmB,CAAC,GAAG,IAAI;IAI7D;;OAEG;WACU,MAAM,CACf,KAAK,EAAE,OAAO,EACd,OAAO,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,GAChC,OAAO,CAAC,mBAAmB,CAAC;IAI/B;;OAEG;IACH,MAAM,CAAC,UAAU,IAAI,mBAAmB;CAG3C"}

package/dist/errors/ErrorHandler.js

@@ -53,8 +53,7 @@
  */
 import { OrbytError } from './OrbytError.js';
 import { ErrorDetector } from './ErrorDetector.js';
-import { ErrorDebugger } from './ErrorDebugger.js';
-import { formatDetailedError } from './ErrorFormatter.js';
+import { formatDetailedError, formatErrorWithLocation } from './ErrorFormatter.js';
 import { ErrorSeverity, ExecutionControl, getExecutionControl, shouldStopWorkflow, shouldStopStep, } from './ErrorCodes.js';
 /**
  * Error Handler
@@ -125,19 +124,17 @@ export class ErrorHandler {
      * Handle error from WorkflowLoader
      * Special handling for load-time errors with file path context
      *
+     * @deprecated Use {@link handleLoaderErrorEnhanced} directly. This wrapper
+     * now delegates to it so behaviour is identical, but the enhanced variant
+     * is preferred for clarity in new call sites.
+     *
      * @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
-        });
+        return this.handleLoaderErrorEnhanced(error, filePath, options);
     }
     /**
      * Handle error from context object
@@ -238,9 +235,10 @@ export class ErrorHandler {
         if (error instanceof OrbytError) {
             return error;
         }
-        // Standard Error - try to classify
+        // Standard Error — use the enhanced variant so YAML parse errors carry
+        // line/column numbers in their diagnostic context and fix steps.
         if (error instanceof Error) {
-            return ErrorDetector.detectFromException(error, context?.location);
+            return ErrorDetector.detectFromExceptionEnhanced(error, context?.location);
         }
         // Error context object - detect from context
         if (typeof error === 'object' && error !== null && 'type' in error) {
@@ -261,33 +259,6 @@ export class ErrorHandler {
             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
      */
@@ -327,13 +298,49 @@ export class ErrorHandler {
         }
     }
     /**
-     * Generate complete debug information
+     * Generate complete debug information.
+     *
+     * Uses context-aware variants so fix steps and formatted output reference
+     * the actual workflow file path / field name when WorkflowContext is set
+     * on LoggerManager (populated automatically by WorkflowLoader after parsing).
+     * Falls back to generic output when no context is available.
      */
     static generateDebugInfo(error, useColors) {
-        const debugInfo = ErrorDebugger.analyze(error);
-        const formatted = ErrorDebugger.format(error, useColors);
+        const debugInfo = ErrorDetector.analyzeDebugInfo(error);
+        const formatted = ErrorDetector.formatDebugOutput(error, undefined, useColors);
         const detailed = formatDetailedError(error, useColors);
-        const quickFix = ErrorDebugger.quickDebug(error);
+        const quickFix = ErrorDetector.quickDebugSummary(error);
+        return {
+            explanation: debugInfo.explanation,
+            cause: debugInfo.cause,
+            fixSteps: debugInfo.fixSteps,
+            quickFix,
+            formatted,
+            detailed,
+            commonMistakes: debugInfo.commonMistakes,
+            estimatedFixTime: debugInfo.estimatedFixTime,
+        };
+    }
+    /**
+     * Generate debug information enriched with workflow file context.
+     *
+     * Uses {@link ErrorDebugger.formatWithContext} so the "How to fix" section
+     * references the actual file path + line number when available.
+     * Uses {@link formatErrorWithLocation} for the `detailed` field so the
+     * location header (File / Line / Field) is present in verbose output.
+     *
+     * @param error     - Detected OrbytError
+     * @param useColors - Whether to use ANSI colors
+     * @returns Debug info with context-aware fix steps
+     * @since 0.5.0
+     */
+    static generateDebugInfoWithContext(error, useColors) {
+        const debugInfo = ErrorDetector.analyzeDebugInfo(error);
+        // formatDebugOutput gives file-aware "How to fix" content
+        const formatted = ErrorDetector.formatDebugOutput(error, undefined, useColors);
+        // formatErrorWithLocation prepends File: / Line: / Field: header
+        const detailed = formatErrorWithLocation(error, undefined, useColors, true);
+        const quickFix = ErrorDetector.quickDebugSummary(error);
         return {
             explanation: debugInfo.explanation,
             cause: debugInfo.cause,
@@ -345,6 +352,48 @@ export class ErrorHandler {
             estimatedFixTime: debugInfo.estimatedFixTime,
         };
     }
+    /**
+     * Handle a WorkflowLoader error with full workflow-context enrichment.
+     *
+     * Enhancement of {@link handleLoaderError} that:
+     * - Uses {@link ErrorDetector.detectFromExceptionEnhanced} to extract
+     *   line/column numbers from YAML parse errors.
+     * - Generates debug info via {@link ErrorDebugger.analyzeWithContext} so
+     *   fix steps reference the actual file path and line number.
+     * - Formats detailed output with {@link formatErrorWithLocation} for a
+     *   File: / Line: / Field: location header.
+     *
+     * Debug is always enabled for loader errors — no option needed.
+     *
+     * @param error    - Error thrown by WorkflowLoader
+     * @param filePath - Path to the workflow file being loaded
+     * @param options  - Handler options
+     * @returns Error handling result with file-aware debug info
+     * @since 0.5.0
+     */
+    static async handleLoaderErrorEnhanced(error, filePath, options = {}) {
+        const { useColors = true, logger = console, context = {} } = options;
+        // Use enhanced detection so line/col are extracted from YAML errors
+        const orbytError = error instanceof OrbytError
+            ? error
+            : ErrorDetector.detectFromExceptionEnhanced(error instanceof Error ? error : new Error(String(error)), filePath);
+        const control = getExecutionControl(orbytError.severity);
+        const stopWorkflow = shouldStopWorkflow(orbytError.severity);
+        const stopStep = shouldStopStep(orbytError.severity);
+        // Always log loader errors
+        const logEntry = this.logError(orbytError, logger, { filePath, ...context });
+        // Always generate context-aware debug info for loader errors
+        const debug = this.generateDebugInfoWithContext(orbytError, useColors);
+        return {
+            error: orbytError,
+            control,
+            shouldStopWorkflow: stopWorkflow,
+            shouldStopStep: stopStep,
+            shouldContinue: control === ExecutionControl.CONTINUE,
+            debug,
+            logEntry,
+        };
+    }
 }
 /**
  * Global error handler instance for convenience

package/dist/errors/ErrorHandler.js.map

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

package/dist/errors/OrbytError.d.ts

@@ -15,6 +15,34 @@
 import { ExitCodes } from '@dev-ecosystem/core';
 import { OrbytErrorCode, ErrorSeverity } from './ErrorCodes.js';
 import { OrbytErrorDiagnostic } from '../types/core-types.js';
+/**
+ * Structured debug information produced by ErrorDebugger and stored on
+ * WorkflowError factory classes.
+ *
+ * Consumers should obtain instances via ErrorDetector (which calls
+ * ErrorDebugger internally) rather than building them manually.
+ */
+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 usage */
+    example?: {
+        description: string;
+        code: string;
+    };
+    /** Whether this requires immediate action */
+    urgent: boolean;
+    /** Estimated time to fix */
+    estimatedFixTime?: string;
+}
 /**
  * Base error class for all Orbyt errors
  *

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

@@ -1 +1 @@
-{"version":3,"file":"OrbytError.d.ts","sourceRoot":"","sources":["../../src/errors/OrbytError.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAChD,OAAO,EACL,cAAc,EACd,aAAa,EAOd,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAE9D;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,qBAAa,UAAW,SAAQ,KAAK;IACnC,mCAAmC;IACnC,SAAgB,UAAU,EAAE,oBAAoB,CAAC;IAEjD,oCAAoC;IACpC,SAAgB,SAAS,EAAE,IAAI,CAAC;gBAEpB,UAAU,EAAE,oBAAoB;IAkB5C;;OAEG;IACH,IAAI,IAAI,IAAI,cAAc,CAEzB;IAED;;OAEG;IACH,IAAI,QAAQ,IAAI,SAAS,CAExB;IAED;;OAEG;IACH,IAAI,IAAI,IAAI,MAAM,GAAG,SAAS,CAE7B;IAED;;OAEG;IACH,IAAI,IAAI,IAAI,MAAM,GAAG,SAAS,CAE7B;IAED;;OAEG;IACH,IAAI,QAAQ,IAAI,aAAa,CAE5B;IAED;;OAEG;IACH,IAAI,WAAW,IAAI,MAAM,CAExB;IAED;;;OAGG;IACH,IAAI,WAAW,IAAI,OAAO,CAEzB;IAED;;;OAGG;IACH,IAAI,WAAW,IAAI,OAAO,CAEzB;IAED;;OAEG;IACH,IAAI,QAAQ,IAAI,MAAM,CAErB;IAED;;;;;OAKG;IACH,QAAQ,IAAI,MAAM;IAoBlB;;;;;OAKG;IACH,gBAAgB,IAAI,MAAM;IAyC1B;;OAEG;IACH,sBAAsB,IAAI,MAAM;IAUhC;;;;;OAKG;IACH,MAAM,IAAI,MAAM;IAkBhB;;;;;OAKG;IACH,cAAc,IAAI;QAChB,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;QAChB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,IAAI,CAAC,EAAE,MAAM,CAAC;KACf;CAQF"}
+{"version":3,"file":"OrbytError.d.ts","sourceRoot":"","sources":["../../src/errors/OrbytError.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAChD,OAAO,EACL,cAAc,EACd,aAAa,EAOd,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAO9D;;;;;;GAMG;AACH,MAAM,WAAW,cAAc;IAC7B,mDAAmD;IACnD,WAAW,EAAE,MAAM,CAAC;IACpB,2CAA2C;IAC3C,KAAK,EAAE,MAAM,CAAC;IACd,oCAAoC;IACpC,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,8CAA8C;IAC9C,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,kCAAkC;IAClC,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,+BAA+B;IAC/B,OAAO,CAAC,EAAE;QACR,WAAW,EAAE,MAAM,CAAC;QACpB,IAAI,EAAE,MAAM,CAAC;KACd,CAAC;IACF,6CAA6C;IAC7C,MAAM,EAAE,OAAO,CAAC;IAChB,4BAA4B;IAC5B,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,qBAAa,UAAW,SAAQ,KAAK;IACnC,mCAAmC;IACnC,SAAgB,UAAU,EAAE,oBAAoB,CAAC;IAEjD,oCAAoC;IACpC,SAAgB,SAAS,EAAE,IAAI,CAAC;gBAEpB,UAAU,EAAE,oBAAoB;IAkB5C;;OAEG;IACH,IAAI,IAAI,IAAI,cAAc,CAEzB;IAED;;OAEG;IACH,IAAI,QAAQ,IAAI,SAAS,CAExB;IAED;;OAEG;IACH,IAAI,IAAI,IAAI,MAAM,GAAG,SAAS,CAE7B;IAED;;OAEG;IACH,IAAI,IAAI,IAAI,MAAM,GAAG,SAAS,CAE7B;IAED;;OAEG;IACH,IAAI,QAAQ,IAAI,aAAa,CAE5B;IAED;;OAEG;IACH,IAAI,WAAW,IAAI,MAAM,CAExB;IAED;;;OAGG;IACH,IAAI,WAAW,IAAI,OAAO,CAEzB;IAED;;;OAGG;IACH,IAAI,WAAW,IAAI,OAAO,CAEzB;IAED;;OAEG;IACH,IAAI,QAAQ,IAAI,MAAM,CAErB;IAED;;;;;OAKG;IACH,QAAQ,IAAI,MAAM;IAoBlB;;;;;OAKG;IACH,gBAAgB,IAAI,MAAM;IAyC1B;;OAEG;IACH,sBAAsB,IAAI,MAAM;IAUhC;;;;;OAKG;IACH,MAAM,IAAI,MAAM;IAkBhB;;;;;OAKG;IACH,cAAc,IAAI;QAChB,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;QAChB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,IAAI,CAAC,EAAE,MAAM,CAAC;KACf;CAQF"}

package/dist/errors/OrbytError.js.map

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

package/dist/errors/SecurityErrors.d.ts

@@ -31,7 +31,7 @@
 import { ExitCodes } from '@dev-ecosystem/core';
 import { OrbytError } from './OrbytError.js';
 import { OrbytErrorCode, ErrorSeverity } from './ErrorCodes.js';
-import { OrbytErrorDiagnostic, SecurityViolationDetails } from '../types/core-types.js';
+import { OrbytErrorDiagnostic } from '../types/core-types.js';
 /**
  * Security Error
  *
@@ -44,12 +44,7 @@ import { OrbytErrorDiagnostic, SecurityViolationDetails } from '../types/core-ty
  * - System security → Bypassing access controls
  */
 export declare class SecurityError extends OrbytError {
-    readonly violations?: SecurityViolationDetails[];
-    constructor(diagnostic: OrbytErrorDiagnostic | SecurityViolationDetails[]);
-    /**
-     * Format violations into a clear, actionable error message
-     */
-    private static formatViolations;
+    constructor(diagnostic: OrbytErrorDiagnostic);
     /**
      * Create reserved field override error
      *
@@ -96,26 +91,8 @@ export declare class SecurityError extends OrbytError {
         message: string;
         exitCode: ExitCodes;
         hint: string | undefined;
-        violations: SecurityViolationDetails[] | undefined;
         severity: ErrorSeverity;
         context: Record<string, any> | undefined;
     };
 }
-/**
- * Create a security error for reserved field violations
- *
- * @deprecated Use SecurityError.reservedFieldOverride() or other factory methods instead
- * @param violations - Array of security violation details
- * @returns SecurityError instance
- *
- * @example
- * ```typescript
- * // Old way (legacy):
- * const error = createSecurityError([{ field: '_internal', ... }]);
- *
- * // New way (preferred):
- * const error = SecurityError.reservedFieldOverride('_internal', 'workflow.context');
- * ```
- */
-export declare function createSecurityError(violations: SecurityViolationDetails[]): SecurityError;
 //# sourceMappingURL=SecurityErrors.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"SecurityErrors.d.ts","sourceRoot":"","sources":["../../src/errors/SecurityErrors.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAChD,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChE,OAAO,EAAE,oBAAoB,EAAE,wBAAwB,EAAE,MAAM,wBAAwB,CAAC;AAExF;;;;;;;;;;GAUG;AACH,qBAAa,aAAc,SAAQ,UAAU;IAC3C,SAAgB,UAAU,CAAC,EAAE,wBAAwB,EAAE,CAAC;gBAE5C,UAAU,EAAE,oBAAoB,GAAG,wBAAwB,EAAE;IAwBzE;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,gBAAgB;IA+E/B;;;;;;;OAOG;IACH,MAAM,CAAC,qBAAqB,CAC1B,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,EACZ,SAAS,GAAE,SAAS,GAAG,WAAW,GAAG,UAAU,GAAG,WAAW,GAAG,OAAO,GAAG,UAAuB,GAChG,aAAa;IAqBhB;;;;;;OAMG;IACH,MAAM,CAAC,kBAAkB,CACvB,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,MAAM,GACX,aAAa;IAYhB;;;;;;OAMG;IACH,MAAM,CAAC,yBAAyB,CAC9B,MAAM,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,EAChD,IAAI,EAAE,MAAM,GACX,aAAa;IAahB;;;;;;;OAOG;IACH,MAAM,CAAC,gBAAgB,CACrB,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,EACZ,kBAAkB,CAAC,EAAE,MAAM,GAC1B,aAAa;IAgBhB;;OAEG;IACH,MAAM;;;;;;;;;;CAYP;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,mBAAmB,CAAC,UAAU,EAAE,wBAAwB,EAAE,GAAG,aAAa,CAEzF"}
+{"version":3,"file":"SecurityErrors.d.ts","sourceRoot":"","sources":["../../src/errors/SecurityErrors.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAChD,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChE,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAE9D;;;;;;;;;;GAUG;AACH,qBAAa,aAAc,SAAQ,UAAU;gBAC/B,UAAU,EAAE,oBAAoB;IAU5C;;;;;;;OAOG;IACH,MAAM,CAAC,qBAAqB,CAC1B,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,EACZ,SAAS,GAAE,SAAS,GAAG,WAAW,GAAG,UAAU,GAAG,WAAW,GAAG,OAAO,GAAG,UAAuB,GAChG,aAAa;IAqBhB;;;;;;OAMG;IACH,MAAM,CAAC,kBAAkB,CACvB,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,MAAM,GACX,aAAa;IAYhB;;;;;;OAMG;IACH,MAAM,CAAC,yBAAyB,CAC9B,MAAM,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,EAChD,IAAI,EAAE,MAAM,GACX,aAAa;IAahB;;;;;;;OAOG;IACH,MAAM,CAAC,gBAAgB,CACrB,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,EACZ,kBAAkB,CAAC,EAAE,MAAM,GAC1B,aAAa;IAgBhB;;OAEG;IACH,MAAM;;;;;;;;;CAWP"}

package/dist/errors/SecurityErrors.js

@@ -43,106 +43,12 @@ import { OrbytErrorCode, ErrorSeverity } from './ErrorCodes.js';
  * - System security → Bypassing access controls
  */
 export class SecurityError extends OrbytError {
-    violations; // For backward compatibility
     constructor(diagnostic) {
-        // Support both new OrbytError format and legacy SecurityViolationDetails[] format
-        if (Array.isArray(diagnostic)) {
-            // Legacy format: convert to OrbytError diagnostic
-            const errorMessage = SecurityError.formatViolations(diagnostic);
-            super({
-                code: OrbytErrorCode.RUNTIME_PERMISSION_DENIED,
-                exitCode: ExitCodes.SECURITY_VIOLATION,
-                message: errorMessage,
-                hint: 'Remove all reserved fields from your workflow',
-                severity: ErrorSeverity.ERROR,
-                context: { violations: diagnostic },
-            });
-            this.violations = diagnostic;
-        }
-        else {
-            // New format: use OrbytError diagnostic
-            super({
-                ...diagnostic,
-                severity: ErrorSeverity.ERROR,
-                exitCode: diagnostic.exitCode || ExitCodes.SECURITY_VIOLATION,
-            });
-        }
-    }
-    /**
-     * Format violations into a clear, actionable error message
-     */
-    static formatViolations(violations) {
-        const lines = [
-            '━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━',
-            '❌ SECURITY VIOLATION: Engine-Controlled Fields Detected',
-            '━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━',
-            '',
-            '⚠️  Your workflow contains fields that are RESERVED for engine control.',
-            '   These fields are critical for:',
-            '   • Billing integrity and usage tracking',
-            '   • Security and audit compliance',
-            '   • Execution identity and ownership',
-            '',
-            '🚫 User workflows CANNOT set these fields. The engine injects them.',
-            '',
-        ];
-        if (violations.length === 1) {
-            const v = violations[0];
-            lines.push('VIOLATION DETAILS:');
-            lines.push('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━');
-            lines.push(`  Error Code:  ${v.code}`);
-            lines.push(`  Location:    ${v.location}`);
-            lines.push(`  Field:       "${v.field}"`);
-            lines.push(`  Reason:      ${v.reason}`);
-            lines.push('');
-            lines.push(`  💡 Solution: ${v.suggestion}`);
-        }
-        else {
-            lines.push(`FOUND ${violations.length} VIOLATIONS:`);
-            lines.push('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━');
-            violations.forEach((v, index) => {
-                lines.push('');
-                lines.push(`${index + 1}. ${v.code}`);
-                lines.push(`   Location: ${v.location}`);
-                lines.push(`   Field:    "${v.field}"`);
-                lines.push(`   Reason:   ${v.reason}`);
-                lines.push(`   Solution: ${v.suggestion}`);
-            });
-        }
-        lines.push('');
-        lines.push('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━');
-        lines.push('WHY THIS MATTERS:');
-        lines.push('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━');
-        lines.push('');
-        lines.push('  If users could set these fields:');
-        lines.push('  ❌ Billing could be manipulated');
-        lines.push('  ❌ Usage tracking would be unreliable');
-        lines.push('  ❌ Audit trails would be compromised');
-        lines.push('  ❌ Security boundaries would collapse');
-        lines.push('');
-        lines.push('  The engine protects these fields to ensure:');
-        lines.push('  ✅ Billing integrity');
-        lines.push('  ✅ Accurate usage tracking');
-        lines.push('  ✅ Complete audit trails');
-        lines.push('  ✅ Security compliance');
-        lines.push('');
-        lines.push('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━');
-        lines.push('WHAT TO DO:');
-        lines.push('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━');
-        lines.push('');
-        lines.push('  1. Remove all fields starting with "_" from your workflow');
-        lines.push('  2. Remove any billing, execution, or identity fields');
-        lines.push('  3. Use only your own custom field names');
-        lines.push('');
-        lines.push('  EXAMPLE:');
-        lines.push('    ❌ BAD:  _internal: { ... }');
-        lines.push('    ❌ BAD:  executionId: "xyz"');
-        lines.push('    ❌ BAD:  billingMode: "free"');
-        lines.push('    ✅ GOOD: myData: { ... }');
-        lines.push('    ✅ GOOD: customConfig: { ... }');
-        lines.push('');
-        lines.push('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━');
-        return lines.join('\n');
+        super({
+            ...diagnostic,
+            severity: ErrorSeverity.ERROR,
+            exitCode: diagnostic.exitCode || ExitCodes.SECURITY_VIOLATION,
+        });
     }
     // ==================== FACTORY METHODS ====================
     /**
@@ -241,29 +147,9 @@ export class SecurityError extends OrbytError {
             message: this.message,
             exitCode: this.exitCode,
             hint: this.hint,
-            violations: this.violations, // Legacy support
             severity: this.severity,
             context: this.diagnostic.context,
         };
     }
 }
-/**
- * Create a security error for reserved field violations
- *
- * @deprecated Use SecurityError.reservedFieldOverride() or other factory methods instead
- * @param violations - Array of security violation details
- * @returns SecurityError instance
- *
- * @example
- * ```typescript
- * // Old way (legacy):
- * const error = createSecurityError([{ field: '_internal', ... }]);
- *
- * // New way (preferred):
- * const error = SecurityError.reservedFieldOverride('_internal', 'workflow.context');
- * ```
- */
-export function createSecurityError(violations) {
-    return new SecurityError(violations);
-}
 //# sourceMappingURL=SecurityErrors.js.map