@orbytautomation/engine 0.1.0

package/dist/core/OrbytEngine.js

@@ -0,0 +1,421 @@
+/**
+ * Orbyt Engine - Main Public API
+ *
+ * User-facing engine class that provides a clean, intuitive API for running workflows.
+ * Wraps the internal ExecutionEngine with a simpler interface.
+ *
+ * @module core
+ */
+import { readFile } from 'fs/promises';
+import YAML from 'yaml';
+import { applyConfigDefaults, validateConfig } from './EngineConfig.js';
+import { createEngineContext } from './EngineContext.js';
+import { ExecutionEngine } from '../execution/ExecutionEngine.js';
+import { StepExecutor } from '../execution/StepExecutor.js';
+import { WorkflowExecutor } from '../execution/WorkflowExecutor.js';
+import { WorkflowParser } from '../parser/WorkflowParser.js';
+import { EventBus } from '../events/EventBus.js';
+import { HookManager } from '../hooks/HookManager.js';
+import { AdapterRegistry } from '../adapters/AdapterRegistry.js';
+import { EngineEventType, createEvent } from '../events/EngineEvents.js';
+import { CLIAdapter, ShellAdapter, HTTPAdapter, FSAdapter } from '../adapters/builtins/index.js';
+/**
+ * OrbytEngine - Main public API
+ *
+ * This is the primary interface for working with Orbyt workflows.
+ * Provides a clean, user-friendly API that abstracts internal complexity.
+ *
+ * @example
+ * ```ts
+ * // Basic usage
+ * const engine = new OrbytEngine();
+ * const result = await engine.run('./workflow.yaml');
+ *
+ * // With configuration
+ * const engine = new OrbytEngine({
+ *   logLevel: 'debug',
+ *   maxConcurrentWorkflows: 5,
+ *   adapters: [httpAdapter, shellAdapter],
+ *   hooks: [loggingHook]
+ * });
+ *
+ * // With options
+ * const result = await engine.run('./workflow.yaml', {
+ *   variables: { inputFile: './data.json' },
+ *   timeout: 60000,
+ *   dryRun: false
+ * });
+ * ```
+ */
+export class OrbytEngine {
+    config;
+    executionEngine;
+    stepExecutor;
+    workflowExecutor;
+    eventBus;
+    hookManager;
+    adapterRegistry;
+    context;
+    isStarted = false;
+    constructor(config = {}) {
+        // Validate and apply defaults
+        validateConfig(config);
+        this.config = applyConfigDefaults(config);
+        // Initialize event system
+        this.eventBus = new EventBus();
+        this.hookManager = new HookManager();
+        this.adapterRegistry = new AdapterRegistry();
+        // Initialize executors
+        this.stepExecutor = new StepExecutor();
+        this.workflowExecutor = new WorkflowExecutor(this.stepExecutor);
+        // Initialize execution engine
+        this.executionEngine = new ExecutionEngine({
+            maxConcurrentExecutions: this.config.maxConcurrentWorkflows,
+            defaultTimeout: this.config.defaultTimeout,
+            enableScheduler: this.config.enableScheduler,
+            queue: this.config.queue,
+            retryPolicy: this.config.retryPolicy,
+            timeoutManager: this.config.timeoutManager,
+        });
+        // Wire components together
+        this.setupComponents();
+        // Register built-in adapters
+        this.registerBuiltinAdapters();
+        // Create engine context
+        this.context = createEngineContext({
+            config: this.config,
+            eventBus: this.eventBus,
+            hookManager: this.hookManager,
+            adapterRegistry: this.adapterRegistry,
+            executionEngine: this.executionEngine,
+            stepExecutor: this.stepExecutor,
+            workflowExecutor: this.workflowExecutor,
+            workingDirectory: this.config.workingDirectory,
+            metadata: this.config.metadata,
+        });
+        // Register user-provided adapters
+        if (this.config.adapters) {
+            for (const adapter of this.config.adapters) {
+                this.registerAdapter(adapter);
+            }
+        }
+        // Register user-provided hooks
+        if (this.config.hooks) {
+            for (const hook of this.config.hooks) {
+                this.registerHook(hook);
+            }
+        }
+    }
+    /**
+     * Wire engine components together
+     */
+    setupComponents() {
+        // Pass event bus and hook manager to executors
+        this.stepExecutor.setEventBus(this.eventBus);
+        this.stepExecutor.setHookManager(this.hookManager);
+        this.workflowExecutor.setEventBus(this.eventBus);
+        this.workflowExecutor.setHookManager(this.hookManager);
+        // Set automation policies
+        if (this.config.retryPolicy) {
+            this.stepExecutor.setRetryPolicy(this.config.retryPolicy);
+        }
+        if (this.config.timeoutManager) {
+            this.stepExecutor.setTimeoutManager(this.config.timeoutManager);
+        }
+    }
+    /**
+     * Register built-in adapters
+     * These are the core adapters shipped with Orbyt
+     */
+    registerBuiltinAdapters() {
+        // Core adapters
+        this.registerAdapter(new CLIAdapter());
+        this.registerAdapter(new ShellAdapter());
+        this.registerAdapter(new HTTPAdapter());
+        this.registerAdapter(new FSAdapter());
+        this.log('debug', 'Registered built-in adapters: cli, shell, http, fs');
+    }
+    /**
+     * Start the engine
+     * Must be called before running workflows if scheduler is enabled
+     */
+    async start() {
+        if (this.isStarted) {
+            return;
+        }
+        // Emit engine.started event
+        await this.eventBus.emit(createEvent(EngineEventType.ENGINE_STARTED, { timestamp: Date.now(), config: this.config }, {}));
+        await this.executionEngine.start();
+        this.isStarted = true;
+        this.log('info', 'Orbyt Engine started');
+    }
+    /**
+     * Stop the engine
+     * Waits for running workflows to complete
+     */
+    async stop() {
+        if (!this.isStarted) {
+            return;
+        }
+        await this.executionEngine.stop();
+        this.isStarted = false;
+        // Emit engine.stopped event
+        await this.eventBus.emit(createEvent(EngineEventType.ENGINE_STOPPED, { timestamp: Date.now() }, {}));
+        this.log('info', 'Orbyt Engine stopped');
+    }
+    /**
+     * Run a workflow
+     *
+     * Main method for executing workflows. Accepts either a file path or
+     * a parsed workflow object.
+     *
+     * @param workflow - Workflow file path, YAML string, or parsed workflow
+     * @param options - Execution options
+     * @returns Workflow execution result
+     *
+     * @example
+     * ```ts
+     * // Run from file
+     * const result = await engine.run('./workflow.yaml');
+     *
+     * // Run with options
+     * const result = await engine.run('./workflow.yaml', {
+     *   variables: { input: 'data.json' },
+     *   timeout: 30000
+     * });
+     *
+     * // Run from string
+     * const yaml = `
+     * name: my-workflow
+     * steps:
+     *   - id: step1
+     *     uses: shell.exec
+     *     with:
+     *       command: echo "Hello"
+     * `;
+     * const result = await engine.run(yaml);
+     * ```
+     */
+    async run(workflow, options = {}) {
+        // Ensure engine is started
+        if (!this.isStarted && this.config.enableScheduler) {
+            await this.start();
+        }
+        // Load/parse workflow if needed
+        let parsedWorkflow;
+        if (typeof workflow === 'string') {
+            // Check if it's a file path or YAML string
+            if (workflow.endsWith('.yaml') || workflow.endsWith('.yml')) {
+                parsedWorkflow = await this.loadWorkflow(workflow);
+            }
+            else {
+                parsedWorkflow = this.parseWorkflow(workflow);
+            }
+        }
+        else {
+            parsedWorkflow = workflow;
+        }
+        // Handle dry-run mode
+        if (options.dryRun || this.config.mode === 'dry-run') {
+            return this.dryRun(parsedWorkflow, options);
+        }
+        // Build execution options
+        const execOptions = {
+            timeout: options.timeout || this.config.defaultTimeout,
+            env: options.env,
+            inputs: options.variables,
+            secrets: options.secrets,
+            context: options.context,
+            continueOnError: options.continueOnError,
+            triggeredBy: options.triggeredBy || 'manual',
+        };
+        this.log('info', `Running workflow: ${parsedWorkflow.name || 'unnamed'}`);
+        // Execute workflow
+        const result = await this.workflowExecutor.execute(parsedWorkflow, execOptions);
+        this.log('info', `Workflow completed: ${result.status}`, {
+            duration: result.duration,
+            steps: result.metadata.totalSteps,
+        });
+        return result;
+    }
+    /**
+     * Load a workflow from file
+     *
+     * @param filePath - Path to workflow file
+     * @param options - Load options
+     * @returns Parsed workflow
+     */
+    async loadWorkflow(filePath, options = {}) {
+        this.log('debug', `Loading workflow from: ${filePath}`);
+        // Read file content
+        const content = await readFile(filePath, 'utf-8');
+        // Parse workflow
+        const parsed = this.parseWorkflow(content);
+        // Apply variables from options if provided
+        if (options.variables && parsed.inputs) {
+            // Merge provided variables with workflow inputs
+            parsed.inputs = { ...parsed.inputs, ...options.variables };
+        }
+        return parsed;
+    }
+    /**
+     * Parse a workflow from YAML string
+     *
+     * @param yaml - YAML workflow definition
+     * @returns Parsed workflow
+     */
+    parseWorkflow(yaml) {
+        this.log('debug', 'Parsing workflow');
+        // Validate YAML syntax first for better error messages
+        try {
+            YAML.parse(yaml);
+        }
+        catch (error) {
+            throw new Error(`Invalid YAML syntax: ${error instanceof Error ? error.message : String(error)}`);
+        }
+        // Use WorkflowParser for full validation and parsing
+        return WorkflowParser.parse(yaml);
+    }
+    /**
+     * Validate a workflow without executing it
+     *
+     * @param workflow - Workflow to validate
+     * @returns True if valid, throws if invalid
+     */
+    async validate(workflow) {
+        let parsedWorkflow;
+        if (typeof workflow === 'string') {
+            if (workflow.endsWith('.yaml') || workflow.endsWith('.yml')) {
+                parsedWorkflow = await this.loadWorkflow(workflow);
+            }
+            else {
+                parsedWorkflow = this.parseWorkflow(workflow);
+            }
+        }
+        else {
+            parsedWorkflow = workflow;
+        }
+        // Parsing itself validates schema
+        // Additional validation could be added here
+        this.log('info', `Workflow validated: ${parsedWorkflow.name || 'unnamed'}`);
+        return true;
+    }
+    /**
+     * Perform a dry run of a workflow
+     * Validates and plans execution without running steps
+     */
+    async dryRun(workflow, options) {
+        this.log('info', `Dry run: ${workflow.name || 'unnamed'}`);
+        // Show what would be executed
+        if (options.variables) {
+            this.log('debug', 'Variables that would be used:', options.variables);
+        }
+        if (options.env) {
+            this.log('debug', 'Environment that would be set:', options.env);
+        }
+        // Log execution plan
+        this.log('info', `Would execute ${workflow.steps.length} steps:`);
+        for (const step of workflow.steps) {
+            this.log('info', `  - ${step.id}: ${step.adapter}.${step.action}`);
+        }
+        // Return mock result showing what would happen
+        return {
+            workflowName: workflow.name || 'unnamed',
+            status: 'success',
+            stepResults: new Map(),
+            duration: 0,
+            startedAt: new Date(),
+            completedAt: new Date(),
+            metadata: {
+                totalSteps: workflow.steps.length,
+                successfulSteps: 0,
+                failedSteps: 0,
+                skippedSteps: workflow.steps.length,
+                phases: 0,
+            },
+        };
+    }
+    /**
+     * Register an adapter
+     *
+     * @param adapter - Adapter to register
+     */
+    registerAdapter(adapter) {
+        this.adapterRegistry.register(adapter);
+        this.stepExecutor.registerModernAdapter(adapter);
+        this.log('debug', `Registered adapter: ${adapter.name}`);
+    }
+    /**
+     * Register multiple adapters
+     *
+     * @param adapters - Array of adapters
+     */
+    registerAdapters(adapters) {
+        for (const adapter of adapters) {
+            this.registerAdapter(adapter);
+        }
+    }
+    /**
+     * Register a lifecycle hook
+     *
+     * @param hook - Hook to register
+     */
+    registerHook(hook) {
+        this.hookManager.register(hook);
+        this.log('debug', 'Registered lifecycle hook');
+    }
+    /**
+     * Register multiple hooks
+     *
+     * @param hooks - Array of hooks
+     */
+    registerHooks(hooks) {
+        this.hookManager.registerMany(hooks);
+        this.log('debug', `Registered ${hooks.length} lifecycle hooks`);
+    }
+    /**
+     * Get the event bus for listening to engine events
+     *
+     * @returns Event bus instance
+     */
+    getEventBus() {
+        return this.eventBus;
+    }
+    /**
+     * Get the engine context
+     *
+     * @returns Engine context
+     */
+    getContext() {
+        return this.context;
+    }
+    /**
+     * Get engine configuration
+     *
+     * @returns Engine configuration
+     */
+    getConfig() {
+        return this.config;
+    }
+    /**
+     * Internal logging method
+     */
+    log(level, message, meta) {
+        if (this.config.logLevel === 'silent') {
+            return;
+        }
+        const levels = ['debug', 'info', 'warn', 'error', 'silent'];
+        const currentLevel = levels.indexOf(this.config.logLevel);
+        const messageLevel = levels.indexOf(level);
+        if (messageLevel >= currentLevel) {
+            const prefix = `[Orbyt:${level.toUpperCase()}]`;
+            if (meta) {
+                console.log(prefix, message, meta);
+            }
+            else {
+                console.log(prefix, message);
+            }
+        }
+    }
+}
+//# sourceMappingURL=OrbytEngine.js.map

package/dist/core/OrbytEngine.js.map

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

package/dist/core/index.d.ts

@@ -0,0 +1,4 @@
+export * from './EngineConfig.js';
+export * from './EngineContext.js';
+export * from './OrbytEngine.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC"}

package/dist/core/index.js

@@ -0,0 +1,4 @@
+export * from './EngineConfig.js';
+export * from './EngineContext.js';
+export * from './OrbytEngine.js';
+//# sourceMappingURL=index.js.map

package/dist/core/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC"}

package/dist/errors/ErrorCodes.d.ts

@@ -0,0 +1,71 @@
+/**
+ * Orbyt Error Codes
+ *
+ * Stable error codes for reliable error handling and documentation.
+ * Format: ORB-[Category]-[Number]
+ *
+ * Categories:
+ * - S: Schema/Structure errors
+ * - V: Validation/Logic errors
+ * - E: Execution errors
+ * - R: Runtime errors
+ *
+ * @module errors
+ */
+export declare enum OrbytErrorCode {
+    /** Unknown field in workflow definition */
+    SCHEMA_UNKNOWN_FIELD = "ORB-S-001",
+    /** Invalid field type */
+    SCHEMA_INVALID_TYPE = "ORB-S-002",
+    /** Missing required field */
+    SCHEMA_MISSING_FIELD = "ORB-S-003",
+    /** Invalid enum value */
+    SCHEMA_INVALID_ENUM = "ORB-S-004",
+    /** Malformed YAML/JSON syntax */
+    SCHEMA_PARSE_ERROR = "ORB-S-005",
+    /** Invalid field format/pattern */
+    SCHEMA_INVALID_FORMAT = "ORB-S-006",
+    /** Duplicate step ID */
+    VALIDATION_DUPLICATE_ID = "ORB-V-001",
+    /** Reference to non-existent step */
+    VALIDATION_UNKNOWN_STEP = "ORB-V-002",
+    /** Circular dependency detected */
+    VALIDATION_CIRCULAR_DEPENDENCY = "ORB-V-003",
+    /** Invalid step order */
+    VALIDATION_INVALID_ORDER = "ORB-V-004",
+    /** Referenced step not yet executed */
+    VALIDATION_FORWARD_REFERENCE = "ORB-V-005",
+    /** Invalid variable reference */
+    VALIDATION_INVALID_VARIABLE = "ORB-V-006",
+    /** Missing required input */
+    VALIDATION_MISSING_INPUT = "ORB-V-007",
+    /** Invalid adapter/action */
+    VALIDATION_UNKNOWN_ADAPTER = "ORB-V-008",
+    /** Step execution failed */
+    EXECUTION_STEP_FAILED = "ORB-E-001",
+    /** Timeout exceeded */
+    EXECUTION_TIMEOUT = "ORB-E-002",
+    /** Adapter error */
+    EXECUTION_ADAPTER_ERROR = "ORB-E-003",
+    /** Workflow cancelled */
+    EXECUTION_CANCELLED = "ORB-E-004",
+    /** File not found */
+    RUNTIME_FILE_NOT_FOUND = "ORB-R-001",
+    /** Permission denied */
+    RUNTIME_PERMISSION_DENIED = "ORB-R-002",
+    /** Internal engine error */
+    RUNTIME_INTERNAL_ERROR = "ORB-R-003"
+}
+/**
+ * Error severity levels
+ */
+export declare enum ErrorSeverity {
+    ERROR = "error",
+    WARNING = "warning",
+    INFO = "info"
+}
+/**
+ * Get human-readable category name from error code
+ */
+export declare function getErrorCategory(code: OrbytErrorCode): string;
+//# sourceMappingURL=ErrorCodes.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ErrorCodes.d.ts","sourceRoot":"","sources":["../../src/errors/ErrorCodes.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,oBAAY,cAAc;IAKxB,2CAA2C;IAC3C,oBAAoB,cAAc;IAElC,yBAAyB;IACzB,mBAAmB,cAAc;IAEjC,6BAA6B;IAC7B,oBAAoB,cAAc;IAElC,yBAAyB;IACzB,mBAAmB,cAAc;IAEjC,iCAAiC;IACjC,kBAAkB,cAAc;IAEhC,mCAAmC;IACnC,qBAAqB,cAAc;IAMnC,wBAAwB;IACxB,uBAAuB,cAAc;IAErC,qCAAqC;IACrC,uBAAuB,cAAc;IAErC,mCAAmC;IACnC,8BAA8B,cAAc;IAE5C,yBAAyB;IACzB,wBAAwB,cAAc;IAEtC,uCAAuC;IACvC,4BAA4B,cAAc;IAE1C,iCAAiC;IACjC,2BAA2B,cAAc;IAEzC,6BAA6B;IAC7B,wBAAwB,cAAc;IAEtC,6BAA6B;IAC7B,0BAA0B,cAAc;IAMxC,4BAA4B;IAC5B,qBAAqB,cAAc;IAEnC,uBAAuB;IACvB,iBAAiB,cAAc;IAE/B,oBAAoB;IACpB,uBAAuB,cAAc;IAErC,yBAAyB;IACzB,mBAAmB,cAAc;IAMjC,qBAAqB;IACrB,sBAAsB,cAAc;IAEpC,wBAAwB;IACxB,yBAAyB,cAAc;IAEvC,4BAA4B;IAC5B,sBAAsB,cAAc;CACrC;AAED;;GAEG;AACH,oBAAY,aAAa;IACvB,KAAK,UAAU;IACf,OAAO,YAAY;IACnB,IAAI,SAAS;CACd;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,cAAc,GAAG,MAAM,CAM7D"}

package/dist/errors/ErrorCodes.js

@@ -0,0 +1,95 @@
+/**
+ * Orbyt Error Codes
+ *
+ * Stable error codes for reliable error handling and documentation.
+ * Format: ORB-[Category]-[Number]
+ *
+ * Categories:
+ * - S: Schema/Structure errors
+ * - V: Validation/Logic errors
+ * - E: Execution errors
+ * - R: Runtime errors
+ *
+ * @module errors
+ */
+export var OrbytErrorCode;
+(function (OrbytErrorCode) {
+    // ============================================================================
+    // SCHEMA ERRORS (S) - Structure problems
+    // ============================================================================
+    /** Unknown field in workflow definition */
+    OrbytErrorCode["SCHEMA_UNKNOWN_FIELD"] = "ORB-S-001";
+    /** Invalid field type */
+    OrbytErrorCode["SCHEMA_INVALID_TYPE"] = "ORB-S-002";
+    /** Missing required field */
+    OrbytErrorCode["SCHEMA_MISSING_FIELD"] = "ORB-S-003";
+    /** Invalid enum value */
+    OrbytErrorCode["SCHEMA_INVALID_ENUM"] = "ORB-S-004";
+    /** Malformed YAML/JSON syntax */
+    OrbytErrorCode["SCHEMA_PARSE_ERROR"] = "ORB-S-005";
+    /** Invalid field format/pattern */
+    OrbytErrorCode["SCHEMA_INVALID_FORMAT"] = "ORB-S-006";
+    // ============================================================================
+    // VALIDATION ERRORS (V) - Logic problems
+    // ============================================================================
+    /** Duplicate step ID */
+    OrbytErrorCode["VALIDATION_DUPLICATE_ID"] = "ORB-V-001";
+    /** Reference to non-existent step */
+    OrbytErrorCode["VALIDATION_UNKNOWN_STEP"] = "ORB-V-002";
+    /** Circular dependency detected */
+    OrbytErrorCode["VALIDATION_CIRCULAR_DEPENDENCY"] = "ORB-V-003";
+    /** Invalid step order */
+    OrbytErrorCode["VALIDATION_INVALID_ORDER"] = "ORB-V-004";
+    /** Referenced step not yet executed */
+    OrbytErrorCode["VALIDATION_FORWARD_REFERENCE"] = "ORB-V-005";
+    /** Invalid variable reference */
+    OrbytErrorCode["VALIDATION_INVALID_VARIABLE"] = "ORB-V-006";
+    /** Missing required input */
+    OrbytErrorCode["VALIDATION_MISSING_INPUT"] = "ORB-V-007";
+    /** Invalid adapter/action */
+    OrbytErrorCode["VALIDATION_UNKNOWN_ADAPTER"] = "ORB-V-008";
+    // ============================================================================
+    // EXECUTION ERRORS (E) - Runtime failures
+    // ============================================================================
+    /** Step execution failed */
+    OrbytErrorCode["EXECUTION_STEP_FAILED"] = "ORB-E-001";
+    /** Timeout exceeded */
+    OrbytErrorCode["EXECUTION_TIMEOUT"] = "ORB-E-002";
+    /** Adapter error */
+    OrbytErrorCode["EXECUTION_ADAPTER_ERROR"] = "ORB-E-003";
+    /** Workflow cancelled */
+    OrbytErrorCode["EXECUTION_CANCELLED"] = "ORB-E-004";
+    // ============================================================================
+    // RUNTIME ERRORS (R) - System/Infrastructure
+    // ============================================================================
+    /** File not found */
+    OrbytErrorCode["RUNTIME_FILE_NOT_FOUND"] = "ORB-R-001";
+    /** Permission denied */
+    OrbytErrorCode["RUNTIME_PERMISSION_DENIED"] = "ORB-R-002";
+    /** Internal engine error */
+    OrbytErrorCode["RUNTIME_INTERNAL_ERROR"] = "ORB-R-003";
+})(OrbytErrorCode || (OrbytErrorCode = {}));
+/**
+ * Error severity levels
+ */
+export var ErrorSeverity;
+(function (ErrorSeverity) {
+    ErrorSeverity["ERROR"] = "error";
+    ErrorSeverity["WARNING"] = "warning";
+    ErrorSeverity["INFO"] = "info";
+})(ErrorSeverity || (ErrorSeverity = {}));
+/**
+ * Get human-readable category name from error code
+ */
+export function getErrorCategory(code) {
+    if (code.startsWith('ORB-S-'))
+        return 'Schema Error';
+    if (code.startsWith('ORB-V-'))
+        return 'Validation Error';
+    if (code.startsWith('ORB-E-'))
+        return 'Execution Error';
+    if (code.startsWith('ORB-R-'))
+        return 'Runtime Error';
+    return 'Unknown Error';
+}
+//# sourceMappingURL=ErrorCodes.js.map

package/dist/errors/ErrorCodes.js.map

@@ -0,0 +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"}

package/dist/errors/ErrorFormatter.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Error Formatter
+ *
+ * Formats Orbyt errors for CLI display with colors and helpful formatting.
+ * Provides human-readable error output for developers.
+ *
+ * @module errors
+ */
+import { OrbytError } from './OrbytError.js';
+/**
+ * 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 declare function formatError(error: OrbytError, useColors?: boolean): string;
+/**
+ * Format multiple errors for CLI display
+ *
+ * @param errors - Array of Orbyt errors
+ * @param useColors - Whether to use ANSI colors
+ * @returns Formatted errors string
+ */
+export declare function formatErrors(errors: OrbytError[], useColors?: boolean): string;
+/**
+ * Create a simple box around text (for emphasis)
+ *
+ * @param text - Text to box
+ * @param useColors - Whether to use colors
+ * @returns Boxed text string
+ */
+export declare function createBox(text: string, useColors?: boolean): string;
+//# sourceMappingURL=ErrorFormatter.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ErrorFormatter.d.ts","sourceRoot":"","sources":["../../src/errors/ErrorFormatter.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAkB7C;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,UAAU,EAAE,SAAS,GAAE,OAAc,GAAG,MAAM,CAwChF;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,UAAU,EAAE,EAAE,SAAS,GAAE,OAAc,GAAG,MAAM,CA6BpF;AAqCD;;;;;;GAMG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,GAAE,OAAc,GAAG,MAAM,CAazE"}