@orbytautomation/engine 0.1.0

package/dist/errors/ErrorFormatter.js

@@ -0,0 +1,140 @@
+/**
+ * Error Formatter
+ *
+ * Formats Orbyt errors for CLI display with colors and helpful formatting.
+ * Provides human-readable error output for developers.
+ *
+ * @module errors
+ */
+import { ErrorSeverity } from './ErrorCodes.js';
+/**
+ * ANSI color codes for terminal output
+ */
+const colors = {
+    reset: '\x1b[0m',
+    bold: '\x1b[1m',
+    dim: '\x1b[2m',
+    red: '\x1b[31m',
+    yellow: '\x1b[33m',
+    blue: '\x1b[34m',
+    cyan: '\x1b[36m',
+    gray: '\x1b[90m',
+};
+/**
+ * Format error for CLI display
+ *
+ * @param error - Orbyt error to format
+ * @param useColors - Whether to use ANSI colors (default: true)
+ * @returns Formatted error string
+ */
+export function formatError(error, useColors = true) {
+    const c = useColors ? colors : {
+        reset: '',
+        bold: '',
+        dim: '',
+        red: '',
+        yellow: '',
+        blue: '',
+        cyan: '',
+        gray: '',
+    };
+    const lines = [];
+    // Error header with icon
+    const icon = getSeverityIcon(error.severity);
+    const color = getSeverityColor(error.severity, c);
+    lines.push(`${color}${icon} ${error.name}${c.reset} ${c.gray}[${error.code}]${c.reset}`);
+    // Path (if available)
+    if (error.path) {
+        lines.push(`${c.dim}at ${c.cyan}${error.path}${c.reset}`);
+    }
+    // Empty line
+    lines.push('');
+    // Main error message
+    lines.push(`${c.bold}${error.message}${c.reset}`);
+    // Hint (if available)
+    if (error.hint) {
+        lines.push('');
+        lines.push(`${c.blue}\u2192 Hint:${c.reset} ${error.hint}`);
+    }
+    return lines.join('\n');
+}
+/**
+ * Format multiple errors for CLI display
+ *
+ * @param errors - Array of Orbyt errors
+ * @param useColors - Whether to use ANSI colors
+ * @returns Formatted errors string
+ */
+export function formatErrors(errors, useColors = true) {
+    const c = useColors ? colors : {
+        reset: '',
+        bold: '',
+        dim: '',
+        red: '',
+        yellow: '',
+        blue: '',
+        cyan: '',
+        gray: '',
+    };
+    const lines = [];
+    // Header
+    lines.push(`${c.red}${c.bold}Found ${errors.length} error(s):${c.reset}`);
+    lines.push('');
+    // Format each error
+    errors.forEach((error, index) => {
+        if (index > 0) {
+            lines.push('');
+            lines.push(c.dim + '\u2500'.repeat(50) + c.reset);
+            lines.push('');
+        }
+        lines.push(formatError(error, useColors));
+    });
+    return lines.join('\n');
+}
+/**
+ * Get icon for error severity
+ */
+function getSeverityIcon(severity) {
+    switch (severity) {
+        case ErrorSeverity.ERROR:
+            return '\u2717'; // ✗
+        case ErrorSeverity.WARNING:
+            return '\u26A0'; // ⚠
+        case ErrorSeverity.INFO:
+            return '\u2139'; // ℹ
+        default:
+            return '\u2022'; // •
+    }
+}
+/**
+ * Get color for error severity
+ */
+function getSeverityColor(severity, c) {
+    switch (severity) {
+        case ErrorSeverity.ERROR:
+            return c.red;
+        case ErrorSeverity.WARNING:
+            return c.yellow;
+        case ErrorSeverity.INFO:
+            return c.blue;
+        default:
+            return c.reset;
+    }
+}
+/**
+ * Create a simple box around text (for emphasis)
+ *
+ * @param text - Text to box
+ * @param useColors - Whether to use colors
+ * @returns Boxed text string
+ */
+export function createBox(text, useColors = true) {
+    const c = useColors ? colors : { reset: '', dim: '', cyan: '' };
+    const lines = text.split('\n');
+    const maxLength = Math.max(...lines.map(l => l.length));
+    const top = c.dim + '\u250C' + '\u2500'.repeat(maxLength + 2) + '\u2510' + c.reset;
+    const bottom = c.dim + '\u2514' + '\u2500'.repeat(maxLength + 2) + '\u2518' + c.reset;
+    const boxedLines = lines.map(line => `${c.dim}\u2502${c.reset} ${line.padEnd(maxLength)} ${c.dim}\u2502${c.reset}`);
+    return [top, ...boxedLines, bottom].join('\n');
+}
+//# sourceMappingURL=ErrorFormatter.js.map

package/dist/errors/ErrorFormatter.js.map

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

package/dist/errors/FieldRegistry.d.ts

@@ -0,0 +1,83 @@
+/**
+ * Workflow Field Registry
+ *
+ * Central registry of all valid fields in the Orbyt workflow schema.
+ * Used for typo detection and validation.
+ *
+ * IMPORTANT: This registry must stay in sync with the schema in @dev-ecosystem/core
+ *
+ * @module errors
+ */
+/**
+ * Valid fields at workflow root level
+ * MUST stay in sync with OrbytWorkflowSchema in @dev-ecosystem/core
+ */
+export declare const ROOT_FIELDS: readonly ["version", "kind", "workflow", "metadata", "annotations", "triggers", "secrets", "inputs", "context", "defaults", "policies", "permissions", "resources", "outputs", "on", "usage", "strategy", "profiles", "compliance", "provenance", "execution", "outputsSchema", "telemetry", "accounting", "compatibility", "failurePolicy", "rollback", "governance"];
+/**
+ * Valid fields in metadata object
+ */
+export declare const METADATA_FIELDS: readonly ["name", "description", "tags", "owner", "version", "createdAt", "updatedAt", "v1", "future"];
+/**
+ * Valid fields in workflow body
+ */
+export declare const WORKFLOW_FIELDS: readonly ["steps"];
+/**
+ * Valid fields in step definition
+ * MUST stay in sync with StepSchema in @dev-ecosystem/core
+ */
+export declare const STEP_FIELDS: readonly ["id", "uses", "name", "with", "when", "needs", "retry", "timeout", "continueOnError", "outputs", "env", "usage", "ref", "requires", "hints", "contracts", "profiles", "onFailure", "telemetry", "rollback"];
+/**
+ * Valid fields in secrets config
+ */
+export declare const SECRETS_FIELDS: readonly ["vault", "keys"];
+/**
+ * Valid fields in context config
+ */
+export declare const CONTEXT_FIELDS: readonly ["env", "platform", "workspace"];
+/**
+ * Valid fields in defaults config
+ */
+export declare const DEFAULTS_FIELDS: readonly ["retry", "timeout", "adapter"];
+/**
+ * Valid fields in policies config
+ */
+export declare const POLICIES_FIELDS: readonly ["failure", "concurrency", "sandbox"];
+/**
+ * Valid fields in permissions config
+ */
+export declare const PERMISSIONS_FIELDS: readonly ["fs", "network"];
+/**
+ * Valid fields in retry config
+ */
+export declare const RETRY_FIELDS: readonly ["max", "backoff", "delay"];
+/**
+ * Valid fields in usage tracking config
+ */
+export declare const USAGE_FIELDS: readonly ["track", "scope", "category", "billable", "product", "tags"];
+/**
+ * Valid fields in step usage config
+ * MUST stay in sync with StepUsageSchema in @dev-ecosystem/core
+ *
+ * Note: costHint is NOT included - use hints.cost instead (no duplicates)
+ */
+export declare const STEP_USAGE_FIELDS: readonly ["billable", "unit", "weight"];
+/**
+ * Field registry map - maps path prefixes to valid fields
+ */
+export declare const FIELD_REGISTRY: Record<string, readonly string[]>;
+/**
+ * Get valid fields for a given path
+ *
+ * @param path - Field path (e.g., 'metadata', 'workflow.steps')
+ * @returns Array of valid field names
+ */
+export declare function getValidFields(path: string): readonly string[];
+/**
+ * Check if a field is valid for a given path
+ *
+ * @param field - Field name to check
+ * @param path - Path context (e.g., 'metadata')
+ * @returns True if field is valid in this context
+ */
+export declare function isValidField(field: string, path: string): boolean;
+//# sourceMappingURL=FieldRegistry.d.ts.map

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

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

package/dist/errors/FieldRegistry.js

@@ -0,0 +1,217 @@
+/**
+ * Workflow Field Registry
+ *
+ * Central registry of all valid fields in the Orbyt workflow schema.
+ * Used for typo detection and validation.
+ *
+ * IMPORTANT: This registry must stay in sync with the schema in @dev-ecosystem/core
+ *
+ * @module errors
+ */
+/**
+ * Valid fields at workflow root level
+ * MUST stay in sync with OrbytWorkflowSchema in @dev-ecosystem/core
+ */
+export const ROOT_FIELDS = [
+    // Core required fields
+    'version',
+    'kind',
+    'workflow',
+    // Configuration fields
+    'metadata',
+    'annotations',
+    'triggers',
+    'secrets',
+    'inputs',
+    'context',
+    'defaults',
+    'policies',
+    'permissions',
+    'resources',
+    'outputs',
+    'on',
+    'usage',
+    // Production-ready universal fields
+    'strategy',
+    'profiles',
+    'compliance',
+    'provenance',
+    'execution',
+    'outputsSchema',
+    'telemetry',
+    'accounting',
+    'compatibility',
+    'failurePolicy',
+    'rollback',
+    'governance',
+];
+/**
+ * Valid fields in metadata object
+ */
+export const METADATA_FIELDS = [
+    'name',
+    'description',
+    'tags',
+    'owner',
+    'version',
+    'createdAt',
+    'updatedAt',
+    'v1',
+    'future',
+];
+/**
+ * Valid fields in workflow body
+ */
+export const WORKFLOW_FIELDS = [
+    'steps',
+];
+/**
+ * Valid fields in step definition
+ * MUST stay in sync with StepSchema in @dev-ecosystem/core
+ */
+export const STEP_FIELDS = [
+    // Core required fields
+    'id',
+    'uses',
+    // Common fields
+    'name',
+    'with',
+    'when',
+    'needs',
+    'retry',
+    'timeout',
+    'continueOnError',
+    'outputs',
+    'env',
+    'usage',
+    // Production-ready universal fields
+    'ref',
+    'requires',
+    'hints',
+    'contracts',
+    'profiles',
+    'onFailure',
+    'telemetry',
+    'rollback',
+];
+/**
+ * Valid fields in secrets config
+ */
+export const SECRETS_FIELDS = [
+    'vault',
+    'keys',
+];
+/**
+ * Valid fields in context config
+ */
+export const CONTEXT_FIELDS = [
+    'env',
+    'platform',
+    'workspace',
+];
+/**
+ * Valid fields in defaults config
+ */
+export const DEFAULTS_FIELDS = [
+    'retry',
+    'timeout',
+    'adapter',
+];
+/**
+ * Valid fields in policies config
+ */
+export const POLICIES_FIELDS = [
+    'failure',
+    'concurrency',
+    'sandbox',
+];
+/**
+ * Valid fields in permissions config
+ */
+export const PERMISSIONS_FIELDS = [
+    'fs',
+    'network',
+];
+/**
+ * Valid fields in retry config
+ */
+export const RETRY_FIELDS = [
+    'max',
+    'backoff',
+    'delay',
+];
+/**
+ * Valid fields in usage tracking config
+ */
+export const USAGE_FIELDS = [
+    'track',
+    'scope',
+    'category',
+    'billable',
+    'product',
+    'tags',
+];
+/**
+ * Valid fields in step usage config
+ * MUST stay in sync with StepUsageSchema in @dev-ecosystem/core
+ *
+ * Note: costHint is NOT included - use hints.cost instead (no duplicates)
+ */
+export const STEP_USAGE_FIELDS = [
+    'billable',
+    'unit',
+    'weight',
+];
+/**
+ * Field registry map - maps path prefixes to valid fields
+ */
+export const FIELD_REGISTRY = {
+    'root': ROOT_FIELDS,
+    'metadata': METADATA_FIELDS,
+    'workflow': WORKFLOW_FIELDS,
+    'workflow.steps': STEP_FIELDS,
+    'secrets': SECRETS_FIELDS,
+    'context': CONTEXT_FIELDS,
+    'defaults': DEFAULTS_FIELDS,
+    'policies': POLICIES_FIELDS,
+    'permissions': PERMISSIONS_FIELDS,
+    'retry': RETRY_FIELDS,
+    'usage': USAGE_FIELDS,
+    'step.usage': STEP_USAGE_FIELDS,
+};
+/**
+ * Get valid fields for a given path
+ *
+ * @param path - Field path (e.g., 'metadata', 'workflow.steps')
+ * @returns Array of valid field names
+ */
+export function getValidFields(path) {
+    // Check exact match first
+    if (path in FIELD_REGISTRY) {
+        return FIELD_REGISTRY[path];
+    }
+    // Check if it's a step path (workflow.steps[N])
+    if (path.match(/^workflow\.steps\[\d+\]$/)) {
+        return STEP_FIELDS;
+    }
+    // Check if it's nested under a known path
+    for (const [key, fields] of Object.entries(FIELD_REGISTRY)) {
+        if (path.startsWith(key + '.')) {
+            return fields;
+        }
+    }
+    // Default to root fields if path is unknown
+    return ROOT_FIELDS;
+}
+/**
+ * Check if a field is valid for a given path
+ *
+ * @param field - Field name to check
+ * @param path - Path context (e.g., 'metadata')
+ * @returns True if field is valid in this context
+ */
+export function isValidField(field, path) {
+    const validFields = getValidFields(path);
+    return validFields.includes(field);
+}
+//# sourceMappingURL=FieldRegistry.js.map

package/dist/errors/FieldRegistry.js.map

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

package/dist/errors/OrbytError.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Base Orbyt Error Class
+ *
+ * Foundation for all Orbyt errors with diagnostic capabilities.
+ * Provides structured error information for CLI, UI, and AI integrations.
+ *
+ * @module errors
+ */
+import { OrbytErrorCode, ErrorSeverity } from './ErrorCodes.js';
+/**
+ * Diagnostic error information
+ */
+export interface OrbytErrorDiagnostic {
+    /** Stable error code */
+    code: OrbytErrorCode;
+    /** Human-readable error message */
+    message: string;
+    /** Path to the error location (e.g., "workflow.steps[2].uses") */
+    path?: string;
+    /** Optional suggestion for fixing the error */
+    hint?: string;
+    /** Error severity */
+    severity: ErrorSeverity;
+    /** Additional context data */
+    context?: Record<string, any>;
+}
+/**
+ * Base error class for all Orbyt errors
+ */
+export declare class OrbytError extends Error {
+    /** Error diagnostic information */
+    readonly diagnostic: OrbytErrorDiagnostic;
+    constructor(diagnostic: OrbytErrorDiagnostic);
+    /**
+     * Get the error code
+     */
+    get code(): OrbytErrorCode;
+    /**
+     * Get the error path (where it occurred)
+     */
+    get path(): string | undefined;
+    /**
+     * Get the error hint/suggestion
+     */
+    get hint(): string | undefined;
+    /**
+     * Get error severity
+     */
+    get severity(): ErrorSeverity;
+    /**
+     * Format error as string for logging/display
+     */
+    toString(): string;
+    /**
+     * Convert to JSON for structured logging
+     */
+    toJSON(): object;
+}
+//# sourceMappingURL=OrbytError.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"OrbytError.d.ts","sourceRoot":"","sources":["../../src/errors/OrbytError.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,cAAc,EAAE,aAAa,EAAoB,MAAM,iBAAiB,CAAC;AAElF;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,wBAAwB;IACxB,IAAI,EAAE,cAAc,CAAC;IAErB,mCAAmC;IACnC,OAAO,EAAE,MAAM,CAAC;IAEhB,kEAAkE;IAClE,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd,+CAA+C;IAC/C,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd,qBAAqB;IACrB,QAAQ,EAAE,aAAa,CAAC;IAExB,8BAA8B;IAC9B,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAC/B;AAED;;GAEG;AACH,qBAAa,UAAW,SAAQ,KAAK;IACnC,mCAAmC;IACnC,SAAgB,UAAU,EAAE,oBAAoB,CAAC;gBAErC,UAAU,EAAE,oBAAoB;IAW5C;;OAEG;IACH,IAAI,IAAI,IAAI,cAAc,CAEzB;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,QAAQ,IAAI,MAAM;IAgBlB;;OAEG;IACH,MAAM,IAAI,MAAM;CAWjB"}

package/dist/errors/OrbytError.js

@@ -0,0 +1,78 @@
+/**
+ * Base Orbyt Error Class
+ *
+ * Foundation for all Orbyt errors with diagnostic capabilities.
+ * Provides structured error information for CLI, UI, and AI integrations.
+ *
+ * @module errors
+ */
+import { getErrorCategory } from './ErrorCodes.js';
+/**
+ * Base error class for all Orbyt errors
+ */
+export class OrbytError extends Error {
+    /** Error diagnostic information */
+    diagnostic;
+    constructor(diagnostic) {
+        super(diagnostic.message);
+        this.name = getErrorCategory(diagnostic.code);
+        this.diagnostic = diagnostic;
+        // Maintains proper stack trace for where error was thrown (V8 only)
+        if (Error.captureStackTrace) {
+            Error.captureStackTrace(this, this.constructor);
+        }
+    }
+    /**
+     * Get the error code
+     */
+    get code() {
+        return this.diagnostic.code;
+    }
+    /**
+     * Get the error path (where it occurred)
+     */
+    get path() {
+        return this.diagnostic.path;
+    }
+    /**
+     * Get the error hint/suggestion
+     */
+    get hint() {
+        return this.diagnostic.hint;
+    }
+    /**
+     * Get error severity
+     */
+    get severity() {
+        return this.diagnostic.severity;
+    }
+    /**
+     * Format error as string for logging/display
+     */
+    toString() {
+        let msg = `${this.name} [${this.code}]`;
+        if (this.path) {
+            msg += ` at ${this.path}`;
+        }
+        msg += `\n${this.message}`;
+        if (this.hint) {
+            msg += `\n→ Hint: ${this.hint}`;
+        }
+        return msg;
+    }
+    /**
+     * Convert to JSON for structured logging
+     */
+    toJSON() {
+        return {
+            name: this.name,
+            code: this.code,
+            message: this.message,
+            path: this.path,
+            hint: this.hint,
+            severity: this.severity,
+            context: this.diagnostic.context,
+        };
+    }
+}
+//# sourceMappingURL=OrbytError.js.map

package/dist/errors/OrbytError.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"OrbytError.js","sourceRoot":"","sources":["../../src/errors/OrbytError.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAiC,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAyBlF;;GAEG;AACH,MAAM,OAAO,UAAW,SAAQ,KAAK;IACnC,mCAAmC;IACnB,UAAU,CAAuB;IAEjD,YAAY,UAAgC;QAC1C,KAAK,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;QAC1B,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;QAC9C,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAE7B,oEAAoE;QACpE,IAAI,KAAK,CAAC,iBAAiB,EAAE,CAAC;YAC5B,KAAK,CAAC,iBAAiB,CAAC,IAAI,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC;QAClD,CAAC;IACH,CAAC;IAED;;OAEG;IACH,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;IAC9B,CAAC;IAED;;OAEG;IACH,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;IAC9B,CAAC;IAED;;OAEG;IACH,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;IAC9B,CAAC;IAED;;OAEG;IACH,IAAI,QAAQ;QACV,OAAO,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC;IAClC,CAAC;IAED;;OAEG;IACH,QAAQ;QACN,IAAI,GAAG,GAAG,GAAG,IAAI,CAAC,IAAI,KAAK,IAAI,CAAC,IAAI,GAAG,CAAC;QAExC,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;YACd,GAAG,IAAI,OAAO,IAAI,CAAC,IAAI,EAAE,CAAC;QAC5B,CAAC;QAED,GAAG,IAAI,KAAK,IAAI,CAAC,OAAO,EAAE,CAAC;QAE3B,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;YACd,GAAG,IAAI,aAAa,IAAI,CAAC,IAAI,EAAE,CAAC;QAClC,CAAC;QAED,OAAO,GAAG,CAAC;IACb,CAAC;IAED;;OAEG;IACH,MAAM;QACJ,OAAO;YACL,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,OAAO,EAAE,IAAI,CAAC,UAAU,CAAC,OAAO;SACjC,CAAC;IACJ,CAAC;CACF"}

package/dist/errors/SchedulerError.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=SchedulerError.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"SchedulerError.d.ts","sourceRoot":"","sources":["../../src/errors/SchedulerError.ts"],"names":[],"mappings":""}

package/dist/errors/SchedulerError.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=SchedulerError.js.map

package/dist/errors/SchedulerError.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SchedulerError.js","sourceRoot":"","sources":["../../src/errors/SchedulerError.ts"],"names":[],"mappings":""}

package/dist/errors/StepError.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=StepError.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"StepError.d.ts","sourceRoot":"","sources":["../../src/errors/StepError.ts"],"names":[],"mappings":""}

package/dist/errors/StepError.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=StepError.js.map

package/dist/errors/StepError.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"StepError.js","sourceRoot":"","sources":["../../src/errors/StepError.ts"],"names":[],"mappings":""}

package/dist/errors/TypoDetector.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Typo Detection Utility
+ *
+ * Provides string similarity matching for suggesting corrections
+ * when unknown fields are encountered in workflow definitions.
+ *
+ * @module errors
+ */
+/**
+ * Find the best match for a string from a list of candidates
+ *
+ * @param input - Input string (potentially misspelled)
+ * @param candidates - List of valid strings to match against
+ * @param threshold - Minimum similarity score to consider (default: 0.6)
+ * @returns Best matching candidate or undefined if no good match found
+ */
+export declare function findClosestMatch(input: string, candidates: string[], threshold?: number): string | undefined;
+/**
+ * Find multiple potential matches (returns top N)
+ *
+ * @param input - Input string (potentially misspelled)
+ * @param candidates - List of valid strings to match against
+ * @param maxResults - Maximum number of results to return
+ * @param threshold - Minimum similarity score to consider
+ * @returns Array of matches sorted by similarity (best first)
+ */
+export declare function findMatches(input: string, candidates: string[], maxResults?: number, threshold?: number): string[];
+/**
+ * Check if a string is a likely typo of another (quick check)
+ *
+ * @param input - Input string
+ * @param target - Target string to check against
+ * @returns True if likely a typo of target
+ */
+export declare function isLikelyTypo(input: string, target: string): boolean;
+//# sourceMappingURL=TypoDetector.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"TypoDetector.d.ts","sourceRoot":"","sources":["../../src/errors/TypoDetector.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAsDH;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,MAAM,EACb,UAAU,EAAE,MAAM,EAAE,EACpB,SAAS,GAAE,MAAY,GACtB,MAAM,GAAG,SAAS,CAapB;AAED;;;;;;;;GAQG;AACH,wBAAgB,WAAW,CACzB,KAAK,EAAE,MAAM,EACb,UAAU,EAAE,MAAM,EAAE,EACpB,UAAU,GAAE,MAAU,EACtB,SAAS,GAAE,MAAY,GACtB,MAAM,EAAE,CAeV;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAEnE"}