@orbytautomation/engine 0.2.4 → 0.3.0

package/dist/errors/WorkflowError.d.ts

@@ -2,53 +2,190 @@
  * Workflow Schema and Validation Errors
  *
  * Specific error types for workflow parsing and validation.
- * Includes helpers for creating diagnostic-rich errors.
+ * Includes factory methods for creating diagnostic-rich errors with:
+ * - Clear, actionable error messages
+ * - Fix suggestions (hints)
+ * - Exit codes from ecosystem-core
+ * - Field locations and context
+ *
+ * USAGE:
+ * =====
+ * Instead of creating generic errors, use factory methods:
+ *
+ * ```typescript
+ * // ❌ Bad: Generic error
+ * throw new Error('Unknown field: foo');
+ *
+ * // ✅ Good: Structured error with diagnostics
+ * throw SchemaError.unknownField('foo', 'workflow.steps[0]', 'name');
+ * ```
+ *
+ * ADDING NEW ERRORS:
+ * ==================
+ * 1. Add error code to OrbytErrorCode enum in ErrorCodes.ts
+ * 2. Add description in getErrorDescription()
+ * 3. Add factory method here
+ * 4. Use the factory method throughout engine
  *
  * @module errors
  */
 import { OrbytError, type OrbytErrorDiagnostic } from './OrbytError.js';
 /**
  * Schema validation error (structure problems)
+ *
+ * Used for:
+ * - Unknown/misspelled fields
+ * - Invalid field types
+ * - Missing required fields
+ * - Invalid enum values
+ * - YAML/JSON syntax errors
  */
 export declare class SchemaError extends OrbytError {
     constructor(diagnostic: OrbytErrorDiagnostic);
     /**
      * Create unknown field error with suggestion
+     *
+     * @param field - The unknown field name
+     * @param path - Path where field was found (e.g., "workflow.steps[0]")
+     * @param suggestion - Suggested correct field name
+     * @returns SchemaError with typo detection hint
      */
     static unknownField(field: string, path: string, suggestion?: string): SchemaError;
     /**
      * Create invalid type error
+     *
+     * @param field - Field name with wrong type
+     * @param expected - Expected type (e.g., "string", "number", "array")
+     * @param received - Actual type received
+     * @param path - Path to the field
+     * @returns SchemaError with type mismatch details
      */
     static invalidType(field: string, expected: string, received: string, path: string): SchemaError;
     /**
      * Create missing required field error
+     *
+     * @param field - Name of missing required field
+     * @param path - Path where field should be
+     * @returns SchemaError for missing field
      */
     static missingField(field: string, path: string): SchemaError;
     /**
      * Create invalid enum value error
+     *
+     * @param field - Field name with invalid value
+     * @param value - Invalid value provided
+     * @param validValues - List of valid values
+     * @param path - Path to the field
+     * @returns SchemaError with valid options
      */
     static invalidEnum(field: string, value: string, validValues: string[], path: string): SchemaError;
+    /**
+     * Create YAML/JSON parsing error
+     *
+     * @param filePath - Path to workflow file with syntax error
+     * @param line - Line number where error occurred (optional)
+     * @param column - Column number where error occurred (optional)
+     * @param details - Additional parsing error details (optional)
+     * @returns SchemaError with parse location
+     */
+    static parseError(filePath: string, line?: number, column?: number, details?: string): SchemaError;
+    /**
+     * Create reserved field error
+     *
+     * @param field - Reserved field name that was used
+     * @param path - Path where field was found
+     * @returns SchemaError for reserved field usage
+     */
+    static reservedField(field: string, path: string): SchemaError;
+    /**
+     * Create invalid adapter error
+     *
+     * @param adapter - Unknown adapter name
+     * @param path - Path to step using unknown adapter
+     * @param validAdapters - List of valid adapter names (optional)
+     * @returns SchemaError for unknown adapter
+     */
+    static invalidAdapter(adapter: string, path: string, validAdapters?: string[]): SchemaError;
 }
 /**
  * Semantic validation error (logic problems)
+ *
+ * Used for:
+ * - Duplicate step IDs
+ * - Unknown step references
+ * - Circular dependencies
+ * - Forward references
+ * - Invalid variable references
  */
 export declare class ValidationError extends OrbytError {
     constructor(diagnostic: OrbytErrorDiagnostic);
     /**
      * Create duplicate ID error
+     *
+     * @param stepId - The duplicated step ID
+     * @param path - Path to where duplicate was found
+     * @param firstOccurrence - Path to first occurrence (optional)
+     * @returns ValidationError for duplicate ID
      */
-    static duplicateId(stepId: string, path: string): ValidationError;
+    static duplicateId(stepId: string, path: string, firstOccurrence?: string): ValidationError;
     /**
      * Create unknown step reference error
+     *
+     * @param stepId - The referenced step ID that doesn't exist
+     * @param path - Path where the reference was made
+     * @param availableSteps - List of valid step IDs
+     * @returns ValidationError for unknown reference
      */
     static unknownStep(stepId: string, path: string, availableSteps?: string[]): ValidationError;
     /**
      * Create circular dependency error
+     *
+     * @param cycle - Array of step IDs forming the cycle
+     * @param path - Path where cycle was detected
+     * @returns ValidationError for circular dependency
      */
     static circularDependency(cycle: string[], path: string): ValidationError;
     /**
      * Create forward reference error
+     *
+     * @param stepId - Step making the forward reference
+     * @param referencedStep - Step being referenced that executes later
+     * @param path - Path where reference was made
+     * @returns ValidationError for forward reference
      */
     static forwardReference(stepId: string, referencedStep: string, path: string): ValidationError;
+    /**
+     * Create empty workflow error
+     *
+     * @param path - Path to workflow file
+     * @returns ValidationError for workflow with no steps
+     */
+    static emptyWorkflow(path: string): ValidationError;
+    /**
+     * Create missing input error
+     *
+     * @param inputName - Required input that is missing
+     * @param path - Path to step requiring the input
+     * @returns ValidationError for missing required input
+     */
+    static missingInput(inputName: string, path: string): ValidationError;
+    /**
+     * Create invalid condition error
+     *
+     * @param condition - The invalid condition expression
+     * @param path - Path to step with invalid condition
+     * @param reason - Why the condition is invalid (optional)
+     * @returns ValidationError for invalid condition
+     */
+    static invalidCondition(condition: string, path: string, reason?: string): ValidationError;
+    /**
+     * Create invalid variable reference error
+     *
+     * @param variable - The invalid variable name/reference
+     * @param path - Path where variable is referenced
+     * @param availableVars - List of available variable names (optional)
+     * @returns ValidationError for invalid variable
+     */
+    static invalidVariable(variable: string, path: string, availableVars?: string[]): ValidationError;
 }
 //# sourceMappingURL=WorkflowError.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"WorkflowError.d.ts","sourceRoot":"","sources":["../../src/errors/WorkflowError.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,UAAU,EAAE,KAAK,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAGxE;;GAEG;AACH,qBAAa,WAAY,SAAQ,UAAU;gBAC7B,UAAU,EAAE,oBAAoB;IAI5C;;OAEG;IACH,MAAM,CAAC,YAAY,CACjB,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,EACZ,UAAU,CAAC,EAAE,MAAM,GAClB,WAAW;IAcd;;OAEG;IACH,MAAM,CAAC,WAAW,CAChB,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,GACX,WAAW;IAUd;;OAEG;IACH,MAAM,CAAC,YAAY,CACjB,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,GACX,WAAW;IAUd;;OAEG;IACH,MAAM,CAAC,WAAW,CAChB,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,EACb,WAAW,EAAE,MAAM,EAAE,EACrB,IAAI,EAAE,MAAM,GACX,WAAW;CASf;AAED;;GAEG;AACH,qBAAa,eAAgB,SAAQ,UAAU;gBACjC,UAAU,EAAE,oBAAoB;IAI5C;;OAEG;IACH,MAAM,CAAC,WAAW,CAChB,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,GACX,eAAe;IAUlB;;OAEG;IACH,MAAM,CAAC,WAAW,CAChB,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,cAAc,CAAC,EAAE,MAAM,EAAE,GACxB,eAAe;IAclB;;OAEG;IACH,MAAM,CAAC,kBAAkB,CACvB,KAAK,EAAE,MAAM,EAAE,EACf,IAAI,EAAE,MAAM,GACX,eAAe;IAUlB;;OAEG;IACH,MAAM,CAAC,gBAAgB,CACrB,MAAM,EAAE,MAAM,EACd,cAAc,EAAE,MAAM,EACtB,IAAI,EAAE,MAAM,GACX,eAAe;CASnB"}
+{"version":3,"file":"WorkflowError.d.ts","sourceRoot":"","sources":["../../src/errors/WorkflowError.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAGH,OAAO,EAAE,UAAU,EAAE,KAAK,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAGxE;;;;;;;;;GASG;AACH,qBAAa,WAAY,SAAQ,UAAU;gBAC7B,UAAU,EAAE,oBAAoB;IAQ5C;;;;;;;OAOG;IACH,MAAM,CAAC,YAAY,CACjB,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,EACZ,UAAU,CAAC,EAAE,MAAM,GAClB,WAAW;IAgBd;;;;;;;;OAQG;IACH,MAAM,CAAC,WAAW,CAChB,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,GACX,WAAW;IAYd;;;;;;OAMG;IACH,MAAM,CAAC,YAAY,CACjB,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,GACX,WAAW;IAYd;;;;;;;;OAQG;IACH,MAAM,CAAC,WAAW,CAChB,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,EACb,WAAW,EAAE,MAAM,EAAE,EACrB,IAAI,EAAE,MAAM,GACX,WAAW;IAYd;;;;;;;;OAQG;IACH,MAAM,CAAC,UAAU,CACf,QAAQ,EAAE,MAAM,EAChB,IAAI,CAAC,EAAE,MAAM,EACb,MAAM,CAAC,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,MAAM,GACf,WAAW;IAad;;;;;;OAMG;IACH,MAAM,CAAC,aAAa,CAClB,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,GACX,WAAW;IAYd;;;;;;;OAOG;IACH,MAAM,CAAC,cAAc,CACnB,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EACZ,aAAa,CAAC,EAAE,MAAM,EAAE,GACvB,WAAW;CAef;AAED;;;;;;;;;GASG;AACH,qBAAa,eAAgB,SAAQ,UAAU;gBACjC,UAAU,EAAE,oBAAoB;IAQ5C;;;;;;;OAOG;IACH,MAAM,CAAC,WAAW,CAChB,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,eAAe,CAAC,EAAE,MAAM,GACvB,eAAe;IAgBlB;;;;;;;OAOG;IACH,MAAM,CAAC,WAAW,CAChB,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,cAAc,CAAC,EAAE,MAAM,EAAE,GACxB,eAAe;IAgBlB;;;;;;OAMG;IACH,MAAM,CAAC,kBAAkB,CACvB,KAAK,EAAE,MAAM,EAAE,EACf,IAAI,EAAE,MAAM,GACX,eAAe;IAYlB;;;;;;;OAOG;IACH,MAAM,CAAC,gBAAgB,CACrB,MAAM,EAAE,MAAM,EACd,cAAc,EAAE,MAAM,EACtB,IAAI,EAAE,MAAM,GACX,eAAe;IAYlB;;;;;OAKG;IACH,MAAM,CAAC,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,eAAe;IAYnD;;;;;;OAMG;IACH,MAAM,CAAC,YAAY,CACjB,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,MAAM,GACX,eAAe;IAYlB;;;;;;;OAOG;IACH,MAAM,CAAC,gBAAgB,CACrB,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,MAAM,EACZ,MAAM,CAAC,EAAE,MAAM,GACd,eAAe;IAYlB;;;;;;;OAOG;IACH,MAAM,CAAC,eAAe,CACpB,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,EACZ,aAAa,CAAC,EAAE,MAAM,EAAE,GACvB,eAAe;CAenB"}

package/dist/errors/WorkflowError.js

@@ -2,127 +2,369 @@
  * Workflow Schema and Validation Errors
  *
  * Specific error types for workflow parsing and validation.
- * Includes helpers for creating diagnostic-rich errors.
+ * Includes factory methods for creating diagnostic-rich errors with:
+ * - Clear, actionable error messages
+ * - Fix suggestions (hints)
+ * - Exit codes from ecosystem-core
+ * - Field locations and context
+ *
+ * USAGE:
+ * =====
+ * Instead of creating generic errors, use factory methods:
+ *
+ * ```typescript
+ * // ❌ Bad: Generic error
+ * throw new Error('Unknown field: foo');
+ *
+ * // ✅ Good: Structured error with diagnostics
+ * throw SchemaError.unknownField('foo', 'workflow.steps[0]', 'name');
+ * ```
+ *
+ * ADDING NEW ERRORS:
+ * ==================
+ * 1. Add error code to OrbytErrorCode enum in ErrorCodes.ts
+ * 2. Add description in getErrorDescription()
+ * 3. Add factory method here
+ * 4. Use the factory method throughout engine
  *
  * @module errors
  */
+import { ExitCodes } from '@dev-ecosystem/core';
 import { OrbytError } from './OrbytError.js';
 import { OrbytErrorCode, ErrorSeverity } from './ErrorCodes.js';
 /**
  * Schema validation error (structure problems)
+ *
+ * Used for:
+ * - Unknown/misspelled fields
+ * - Invalid field types
+ * - Missing required fields
+ * - Invalid enum values
+ * - YAML/JSON syntax errors
  */
 export class SchemaError extends OrbytError {
     constructor(diagnostic) {
-        super({ ...diagnostic, severity: ErrorSeverity.ERROR });
+        super({
+            ...diagnostic,
+            severity: ErrorSeverity.ERROR,
+            exitCode: diagnostic.exitCode || ExitCodes.INVALID_SCHEMA,
+        });
     }
     /**
      * Create unknown field error with suggestion
+     *
+     * @param field - The unknown field name
+     * @param path - Path where field was found (e.g., "workflow.steps[0]")
+     * @param suggestion - Suggested correct field name
+     * @returns SchemaError with typo detection hint
      */
     static unknownField(field, path, suggestion) {
         const hint = suggestion
-            ? `Did you mean "${suggestion}"?`
-            : 'Check the workflow schema documentation.';
+            ? `Did you mean "${suggestion}"? Check for typos in field names.`
+            : 'Check the Orbyt workflow schema documentation for valid fields.';
         return new SchemaError({
             code: OrbytErrorCode.SCHEMA_UNKNOWN_FIELD,
-            message: `Unknown field "${field}"`,
+            message: `Unknown field "${field}" in workflow definition`,
+            exitCode: ExitCodes.INVALID_SCHEMA,
             path,
             hint,
             severity: ErrorSeverity.ERROR,
+            context: { field, suggestion },
         });
     }
     /**
      * Create invalid type error
+     *
+     * @param field - Field name with wrong type
+     * @param expected - Expected type (e.g., "string", "number", "array")
+     * @param received - Actual type received
+     * @param path - Path to the field
+     * @returns SchemaError with type mismatch details
      */
     static invalidType(field, expected, received, path) {
         return new SchemaError({
             code: OrbytErrorCode.SCHEMA_INVALID_TYPE,
-            message: `Field "${field}" expects ${expected}, got ${received}`,
+            message: `Field "${field}" has incorrect type: expected ${expected}, received ${received}`,
+            exitCode: ExitCodes.INVALID_SCHEMA,
             path,
-            hint: `The field "${field}" must be a ${expected}.`,
+            hint: `Change the value of "${field}" to match the expected type: ${expected}`,
             severity: ErrorSeverity.ERROR,
+            context: { field, expected, received },
         });
     }
     /**
      * Create missing required field error
+     *
+     * @param field - Name of missing required field
+     * @param path - Path where field should be
+     * @returns SchemaError for missing field
      */
     static missingField(field, path) {
         return new SchemaError({
             code: OrbytErrorCode.SCHEMA_MISSING_FIELD,
-            message: `Missing required field "${field}"`,
+            message: `Missing required field "${field}" in workflow definition`,
+            exitCode: ExitCodes.INVALID_SCHEMA,
             path,
-            hint: `Add the "${field}" field to your workflow.`,
+            hint: `Add the required field "${field}" to your workflow at ${path}`,
             severity: ErrorSeverity.ERROR,
+            context: { field, path },
         });
     }
     /**
      * Create invalid enum value error
+     *
+     * @param field - Field name with invalid value
+     * @param value - Invalid value provided
+     * @param validValues - List of valid values
+     * @param path - Path to the field
+     * @returns SchemaError with valid options
      */
     static invalidEnum(field, value, validValues, path) {
         return new SchemaError({
             code: OrbytErrorCode.SCHEMA_INVALID_ENUM,
-            message: `Invalid value "${value}" for field "${field}"`,
+            message: `Invalid value "${value}" for field "${field}". Must be one of: ${validValues.join(', ')}`,
+            exitCode: ExitCodes.INVALID_SCHEMA,
             path,
-            hint: `Valid values are: ${validValues.join(', ')}`,
+            hint: `Change "${field}" to one of the valid values: ${validValues.join(', ')}`,
+            severity: ErrorSeverity.ERROR,
+            context: { field, value, validValues },
+        });
+    }
+    /**
+     * Create YAML/JSON parsing error
+     *
+     * @param filePath - Path to workflow file with syntax error
+     * @param line - Line number where error occurred (optional)
+     * @param column - Column number where error occurred (optional)
+     * @param details - Additional parsing error details (optional)
+     * @returns SchemaError with parse location
+     */
+    static parseError(filePath, line, column, details) {
+        const location = line ? ` at line ${line}${column ? `, column ${column}` : ''}` : '';
+        return new SchemaError({
+            code: OrbytErrorCode.SCHEMA_PARSE_ERROR,
+            message: `Failed to parse workflow file${location}`,
+            exitCode: ExitCodes.INVALID_SCHEMA,
+            path: filePath,
+            hint: details || 'Check YAML/JSON syntax - ensure proper indentation, quotes, and structure',
             severity: ErrorSeverity.ERROR,
+            context: { filePath, line, column, details },
+        });
+    }
+    /**
+     * Create reserved field error
+     *
+     * @param field - Reserved field name that was used
+     * @param path - Path where field was found
+     * @returns SchemaError for reserved field usage
+     */
+    static reservedField(field, path) {
+        return new SchemaError({
+            code: OrbytErrorCode.SCHEMA_RESERVED_FIELD,
+            message: `Reserved field "${field}" cannot be used in workflow definition`,
+            exitCode: ExitCodes.INVALID_SCHEMA,
+            path,
+            hint: `Field "${field}" is reserved by Orbyt engine. Use a different field name`,
+            severity: ErrorSeverity.ERROR,
+            context: { field },
+        });
+    }
+    /**
+     * Create invalid adapter error
+     *
+     * @param adapter - Unknown adapter name
+     * @param path - Path to step using unknown adapter
+     * @param validAdapters - List of valid adapter names (optional)
+     * @returns SchemaError for unknown adapter
+     */
+    static invalidAdapter(adapter, path, validAdapters) {
+        const hint = validAdapters
+            ? `Use one of the supported adapters: ${validAdapters.join(', ')}`
+            : `Adapter "${adapter}" is not registered. Check spelling or register the adapter`;
+        return new SchemaError({
+            code: OrbytErrorCode.SCHEMA_UNKNOWN_FIELD,
+            message: `Unknown adapter "${adapter}"`,
+            exitCode: ExitCodes.INVALID_SCHEMA,
+            path,
+            hint,
+            severity: ErrorSeverity.ERROR,
+            context: { adapter, validAdapters },
         });
     }
 }
 /**
  * Semantic validation error (logic problems)
+ *
+ * Used for:
+ * - Duplicate step IDs
+ * - Unknown step references
+ * - Circular dependencies
+ * - Forward references
+ * - Invalid variable references
  */
 export class ValidationError extends OrbytError {
     constructor(diagnostic) {
-        super({ ...diagnostic, severity: ErrorSeverity.ERROR });
+        super({
+            ...diagnostic,
+            severity: ErrorSeverity.ERROR,
+            exitCode: diagnostic.exitCode || ExitCodes.VALIDATION_FAILED,
+        });
     }
     /**
      * Create duplicate ID error
+     *
+     * @param stepId - The duplicated step ID
+     * @param path - Path to where duplicate was found
+     * @param firstOccurrence - Path to first occurrence (optional)
+     * @returns ValidationError for duplicate ID
      */
-    static duplicateId(stepId, path) {
+    static duplicateId(stepId, path, firstOccurrence) {
+        const hint = firstOccurrence
+            ? `Step ID "${stepId}" was first used at ${firstOccurrence}. Each step must have a unique ID.`
+            : `Rename one of the steps with ID "${stepId}" to make it unique.`;
         return new ValidationError({
             code: OrbytErrorCode.VALIDATION_DUPLICATE_ID,
-            message: `Duplicate step ID "${stepId}"`,
+            message: `Duplicate step ID "${stepId}" found in workflow`,
+            exitCode: ExitCodes.VALIDATION_FAILED,
             path,
-            hint: 'Step IDs must be unique across the workflow.',
+            hint,
             severity: ErrorSeverity.ERROR,
+            context: { stepId, firstOccurrence },
         });
     }
     /**
      * Create unknown step reference error
+     *
+     * @param stepId - The referenced step ID that doesn't exist
+     * @param path - Path where the reference was made
+     * @param availableSteps - List of valid step IDs
+     * @returns ValidationError for unknown reference
      */
     static unknownStep(stepId, path, availableSteps) {
         const hint = availableSteps && availableSteps.length > 0
-            ? `Available steps: ${availableSteps.join(', ')}`
-            : 'Ensure the step ID is defined before referencing it.';
+            ? `Available step IDs: ${availableSteps.join(', ')}. Check for typos in the step ID.`
+            : `Step "${stepId}" does not exist in this workflow. Check the step ID spelling.`;
         return new ValidationError({
             code: OrbytErrorCode.VALIDATION_UNKNOWN_STEP,
-            message: `Unknown step "${stepId}"`,
+            message: `Step "${stepId}" referenced but not defined in workflow`,
+            exitCode: ExitCodes.VALIDATION_FAILED,
             path,
             hint,
             severity: ErrorSeverity.ERROR,
+            context: { stepId, availableSteps },
         });
     }
     /**
      * Create circular dependency error
+     *
+     * @param cycle - Array of step IDs forming the cycle
+     * @param path - Path where cycle was detected
+     * @returns ValidationError for circular dependency
      */
     static circularDependency(cycle, path) {
         return new ValidationError({
             code: OrbytErrorCode.VALIDATION_CIRCULAR_DEPENDENCY,
-            message: `Circular dependency detected: ${cycle.join(' → ')}`,
+            message: `Circular dependency detected: ${cycle.join(' → ')} → ${cycle[0]}`,
+            exitCode: ExitCodes.CIRCULAR_DEPENDENCY,
             path,
-            hint: 'Remove circular dependencies between steps.',
+            hint: 'Remove one of the dependencies to break the cycle',
             severity: ErrorSeverity.ERROR,
+            context: { cycle },
         });
     }
     /**
      * Create forward reference error
+     *
+     * @param stepId - Step making the forward reference
+     * @param referencedStep - Step being referenced that executes later
+     * @param path - Path where reference was made
+     * @returns ValidationError for forward reference
      */
     static forwardReference(stepId, referencedStep, path) {
         return new ValidationError({
             code: OrbytErrorCode.VALIDATION_FORWARD_REFERENCE,
-            message: `Step "${stepId}" references "${referencedStep}" which hasn't been defined yet`,
+            message: `Step "${stepId}" references "${referencedStep}" which executes later`,
+            exitCode: ExitCodes.VALIDATION_FAILED,
+            path,
+            hint: 'Steps can only reference steps that execute before them',
+            severity: ErrorSeverity.ERROR,
+            context: { stepId, referencedStep },
+        });
+    }
+    /**
+     * Create empty workflow error
+     *
+     * @param path - Path to workflow file
+     * @returns ValidationError for workflow with no steps
+     */
+    static emptyWorkflow(path) {
+        return new ValidationError({
+            code: OrbytErrorCode.VALIDATION_EMPTY_WORKFLOW,
+            message: 'Workflow has no steps defined',
+            exitCode: ExitCodes.VALIDATION_FAILED,
+            path,
+            hint: 'Add at least one step to the workflow.steps array',
+            severity: ErrorSeverity.ERROR,
+            context: {},
+        });
+    }
+    /**
+     * Create missing input error
+     *
+     * @param inputName - Required input that is missing
+     * @param path - Path to step requiring the input
+     * @returns ValidationError for missing required input
+     */
+    static missingInput(inputName, path) {
+        return new ValidationError({
+            code: OrbytErrorCode.VALIDATION_MISSING_INPUT,
+            message: `Required input "${inputName}" is not provided`,
+            exitCode: ExitCodes.VALIDATION_FAILED,
             path,
-            hint: 'Steps must be defined before they are referenced.',
+            hint: `Add "${inputName}" to the workflow inputs or step inputs`,
+            severity: ErrorSeverity.ERROR,
+            context: { inputName },
+        });
+    }
+    /**
+     * Create invalid condition error
+     *
+     * @param condition - The invalid condition expression
+     * @param path - Path to step with invalid condition
+     * @param reason - Why the condition is invalid (optional)
+     * @returns ValidationError for invalid condition
+     */
+    static invalidCondition(condition, path, reason) {
+        return new ValidationError({
+            code: OrbytErrorCode.VALIDATION_INVALID_CONDITION,
+            message: `Invalid condition expression: ${condition}`,
+            exitCode: ExitCodes.VALIDATION_FAILED,
+            path,
+            hint: reason || 'Check the condition syntax - ensure proper operators and variable references',
+            severity: ErrorSeverity.ERROR,
+            context: { condition, reason },
+        });
+    }
+    /**
+     * Create invalid variable reference error
+     *
+     * @param variable - The invalid variable name/reference
+     * @param path - Path where variable is referenced
+     * @param availableVars - List of available variable names (optional)
+     * @returns ValidationError for invalid variable
+     */
+    static invalidVariable(variable, path, availableVars) {
+        const hint = availableVars && availableVars.length > 0
+            ? `Available variables: ${availableVars.join(', ')}`
+            : `Variable "${variable}" is not defined. Check spelling or define the variable`;
+        return new ValidationError({
+            code: OrbytErrorCode.VALIDATION_INVALID_VARIABLE,
+            message: `Invalid variable reference: ${variable}`,
+            exitCode: ExitCodes.VALIDATION_FAILED,
+            path,
+            hint,
             severity: ErrorSeverity.ERROR,
+            context: { variable, availableVars },
         });
     }
 }

package/dist/errors/WorkflowError.js.map

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

package/dist/errors/index.d.ts

@@ -9,7 +9,11 @@ export * from './ErrorCodes.js';
 export * from './OrbytError.js';
 export * from './WorkflowError.js';
 export * from './TypoDetector.js';
-export * from './FieldRegistry.js';
 export * from './ErrorFormatter.js';
 export * from './SecurityErrors.js';
+export * from './StepError.js';
+export * from './SchedulerError.js';
+export * from './ErrorDetector.js';
+export * from './ErrorDebugger.js';
+export * from './ErrorHandler.js';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/errors/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC;AAChC,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/errors/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC;AAChC,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAGlC,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC"}

package/dist/errors/index.js

@@ -9,10 +9,13 @@ export * from './ErrorCodes.js';
 export * from './OrbytError.js';
 export * from './WorkflowError.js';
 export * from './TypoDetector.js';
-export * from './FieldRegistry.js';
+// FieldRegistry is internal - not exported to prevent conflicts with security/ReservedFields
+// export * from './FieldRegistry.js';
 export * from './ErrorFormatter.js';
 export * from './SecurityErrors.js';
-// Legacy exports (kept for compatibility)
-// export * from './SchedulerError.js';
-// export * from './StepError.js';
+export * from './StepError.js';
+export * from './SchedulerError.js';
+export * from './ErrorDetector.js';
+export * from './ErrorDebugger.js';
+export * from './ErrorHandler.js';
 //# sourceMappingURL=index.js.map

package/dist/errors/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/errors/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC;AAChC,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AAEpC,0CAA0C;AAC1C,uCAAuC;AACvC,kCAAkC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/errors/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC;AAChC,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,6FAA6F;AAC7F,sCAAsC;AACtC,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC"}