@orbytautomation/engine 0.1.0

package/dist/errors/TypoDetector.js

@@ -0,0 +1,109 @@
+/**
+ * Typo Detection Utility
+ *
+ * Provides string similarity matching for suggesting corrections
+ * when unknown fields are encountered in workflow definitions.
+ *
+ * @module errors
+ */
+/**
+ * Calculate Levenshtein distance between two strings
+ * (minimum number of single-character edits needed to change one string into another)
+ *
+ * @param a - First string
+ * @param b - Second string
+ * @returns Edit distance
+ */
+function levenshteinDistance(a, b) {
+    const matrix = [];
+    // Initialize matrix
+    for (let i = 0; i <= b.length; i++) {
+        matrix[i] = [i];
+    }
+    for (let j = 0; j <= a.length; j++) {
+        matrix[0][j] = j;
+    }
+    // Fill matrix
+    for (let i = 1; i <= b.length; i++) {
+        for (let j = 1; j <= a.length; j++) {
+            if (b.charAt(i - 1) === a.charAt(j - 1)) {
+                matrix[i][j] = matrix[i - 1][j - 1];
+            }
+            else {
+                matrix[i][j] = Math.min(matrix[i - 1][j - 1] + 1, // substitution
+                matrix[i][j - 1] + 1, // insertion
+                matrix[i - 1][j] + 1 // deletion
+                );
+            }
+        }
+    }
+    return matrix[b.length][a.length];
+}
+/**
+ * Calculate similarity score between two strings (0-1, higher is more similar)
+ *
+ * @param a - First string
+ * @param b - Second string
+ * @returns Similarity score (0 = completely different, 1 = identical)
+ */
+function similarityScore(a, b) {
+    const maxLength = Math.max(a.length, b.length);
+    if (maxLength === 0)
+        return 1;
+    const distance = levenshteinDistance(a.toLowerCase(), b.toLowerCase());
+    return 1 - distance / maxLength;
+}
+/**
+ * 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 function findClosestMatch(input, candidates, threshold = 0.6) {
+    let bestMatch;
+    let bestScore = threshold;
+    for (const candidate of candidates) {
+        const score = similarityScore(input, candidate);
+        if (score > bestScore) {
+            bestScore = score;
+            bestMatch = candidate;
+        }
+    }
+    return bestMatch;
+}
+/**
+ * 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 function findMatches(input, candidates, maxResults = 3, threshold = 0.5) {
+    const matches = [];
+    for (const candidate of candidates) {
+        const score = similarityScore(input, candidate);
+        if (score >= threshold) {
+            matches.push({ candidate, score });
+        }
+    }
+    // Sort by score (descending) and return top N candidates
+    return matches
+        .sort((a, b) => b.score - a.score)
+        .slice(0, maxResults)
+        .map(m => m.candidate);
+}
+/**
+ * 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 function isLikelyTypo(input, target) {
+    return similarityScore(input, target) >= 0.7;
+}
+//# sourceMappingURL=TypoDetector.js.map

package/dist/errors/TypoDetector.js.map

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

package/dist/errors/WorkflowError.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Workflow Schema and Validation Errors
+ *
+ * Specific error types for workflow parsing and validation.
+ * Includes helpers for creating diagnostic-rich errors.
+ *
+ * @module errors
+ */
+import { OrbytError, type OrbytErrorDiagnostic } from './OrbytError.js';
+/**
+ * Schema validation error (structure problems)
+ */
+export declare class SchemaError extends OrbytError {
+    constructor(diagnostic: OrbytErrorDiagnostic);
+    /**
+     * Create unknown field error with suggestion
+     */
+    static unknownField(field: string, path: string, suggestion?: string): SchemaError;
+    /**
+     * Create invalid type error
+     */
+    static invalidType(field: string, expected: string, received: string, path: string): SchemaError;
+    /**
+     * Create missing required field error
+     */
+    static missingField(field: string, path: string): SchemaError;
+    /**
+     * Create invalid enum value error
+     */
+    static invalidEnum(field: string, value: string, validValues: string[], path: string): SchemaError;
+}
+/**
+ * Semantic validation error (logic problems)
+ */
+export declare class ValidationError extends OrbytError {
+    constructor(diagnostic: OrbytErrorDiagnostic);
+    /**
+     * Create duplicate ID error
+     */
+    static duplicateId(stepId: string, path: string): ValidationError;
+    /**
+     * Create unknown step reference error
+     */
+    static unknownStep(stepId: string, path: string, availableSteps?: string[]): ValidationError;
+    /**
+     * Create circular dependency error
+     */
+    static circularDependency(cycle: string[], path: string): ValidationError;
+    /**
+     * Create forward reference error
+     */
+    static forwardReference(stepId: string, referencedStep: string, path: string): ValidationError;
+}
+//# sourceMappingURL=WorkflowError.d.ts.map

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

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

package/dist/errors/WorkflowError.js

@@ -0,0 +1,129 @@
+/**
+ * Workflow Schema and Validation Errors
+ *
+ * Specific error types for workflow parsing and validation.
+ * Includes helpers for creating diagnostic-rich errors.
+ *
+ * @module errors
+ */
+import { OrbytError } from './OrbytError.js';
+import { OrbytErrorCode, ErrorSeverity } from './ErrorCodes.js';
+/**
+ * Schema validation error (structure problems)
+ */
+export class SchemaError extends OrbytError {
+    constructor(diagnostic) {
+        super({ ...diagnostic, severity: ErrorSeverity.ERROR });
+    }
+    /**
+     * Create unknown field error with suggestion
+     */
+    static unknownField(field, path, suggestion) {
+        const hint = suggestion
+            ? `Did you mean "${suggestion}"?`
+            : 'Check the workflow schema documentation.';
+        return new SchemaError({
+            code: OrbytErrorCode.SCHEMA_UNKNOWN_FIELD,
+            message: `Unknown field "${field}"`,
+            path,
+            hint,
+            severity: ErrorSeverity.ERROR,
+        });
+    }
+    /**
+     * Create invalid type error
+     */
+    static invalidType(field, expected, received, path) {
+        return new SchemaError({
+            code: OrbytErrorCode.SCHEMA_INVALID_TYPE,
+            message: `Field "${field}" expects ${expected}, got ${received}`,
+            path,
+            hint: `The field "${field}" must be a ${expected}.`,
+            severity: ErrorSeverity.ERROR,
+        });
+    }
+    /**
+     * Create missing required field error
+     */
+    static missingField(field, path) {
+        return new SchemaError({
+            code: OrbytErrorCode.SCHEMA_MISSING_FIELD,
+            message: `Missing required field "${field}"`,
+            path,
+            hint: `Add the "${field}" field to your workflow.`,
+            severity: ErrorSeverity.ERROR,
+        });
+    }
+    /**
+     * Create invalid enum value error
+     */
+    static invalidEnum(field, value, validValues, path) {
+        return new SchemaError({
+            code: OrbytErrorCode.SCHEMA_INVALID_ENUM,
+            message: `Invalid value "${value}" for field "${field}"`,
+            path,
+            hint: `Valid values are: ${validValues.join(', ')}`,
+            severity: ErrorSeverity.ERROR,
+        });
+    }
+}
+/**
+ * Semantic validation error (logic problems)
+ */
+export class ValidationError extends OrbytError {
+    constructor(diagnostic) {
+        super({ ...diagnostic, severity: ErrorSeverity.ERROR });
+    }
+    /**
+     * Create duplicate ID error
+     */
+    static duplicateId(stepId, path) {
+        return new ValidationError({
+            code: OrbytErrorCode.VALIDATION_DUPLICATE_ID,
+            message: `Duplicate step ID "${stepId}"`,
+            path,
+            hint: 'Step IDs must be unique across the workflow.',
+            severity: ErrorSeverity.ERROR,
+        });
+    }
+    /**
+     * Create unknown step reference error
+     */
+    static unknownStep(stepId, path, availableSteps) {
+        const hint = availableSteps && availableSteps.length > 0
+            ? `Available steps: ${availableSteps.join(', ')}`
+            : 'Ensure the step ID is defined before referencing it.';
+        return new ValidationError({
+            code: OrbytErrorCode.VALIDATION_UNKNOWN_STEP,
+            message: `Unknown step "${stepId}"`,
+            path,
+            hint,
+            severity: ErrorSeverity.ERROR,
+        });
+    }
+    /**
+     * Create circular dependency error
+     */
+    static circularDependency(cycle, path) {
+        return new ValidationError({
+            code: OrbytErrorCode.VALIDATION_CIRCULAR_DEPENDENCY,
+            message: `Circular dependency detected: ${cycle.join(' → ')}`,
+            path,
+            hint: 'Remove circular dependencies between steps.',
+            severity: ErrorSeverity.ERROR,
+        });
+    }
+    /**
+     * Create forward reference error
+     */
+    static forwardReference(stepId, referencedStep, path) {
+        return new ValidationError({
+            code: OrbytErrorCode.VALIDATION_FORWARD_REFERENCE,
+            message: `Step "${stepId}" references "${referencedStep}" which hasn't been defined yet`,
+            path,
+            hint: 'Steps must be defined before they are referenced.',
+            severity: ErrorSeverity.ERROR,
+        });
+    }
+}
+//# sourceMappingURL=WorkflowError.js.map

package/dist/errors/WorkflowError.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"WorkflowError.js","sourceRoot":"","sources":["../../src/errors/WorkflowError.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,UAAU,EAA6B,MAAM,iBAAiB,CAAC;AACxE,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAEhE;;GAEG;AACH,MAAM,OAAO,WAAY,SAAQ,UAAU;IACzC,YAAY,UAAgC;QAC1C,KAAK,CAAC,EAAE,GAAG,UAAU,EAAE,QAAQ,EAAE,aAAa,CAAC,KAAK,EAAE,CAAC,CAAC;IAC1D,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,YAAY,CACjB,KAAa,EACb,IAAY,EACZ,UAAmB;QAEnB,MAAM,IAAI,GAAG,UAAU;YACrB,CAAC,CAAC,iBAAiB,UAAU,IAAI;YACjC,CAAC,CAAC,0CAA0C,CAAC;QAE/C,OAAO,IAAI,WAAW,CAAC;YACrB,IAAI,EAAE,cAAc,CAAC,oBAAoB;YACzC,OAAO,EAAE,kBAAkB,KAAK,GAAG;YACnC,IAAI;YACJ,IAAI;YACJ,QAAQ,EAAE,aAAa,CAAC,KAAK;SAC9B,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,WAAW,CAChB,KAAa,EACb,QAAgB,EAChB,QAAgB,EAChB,IAAY;QAEZ,OAAO,IAAI,WAAW,CAAC;YACrB,IAAI,EAAE,cAAc,CAAC,mBAAmB;YACxC,OAAO,EAAE,UAAU,KAAK,aAAa,QAAQ,SAAS,QAAQ,EAAE;YAChE,IAAI;YACJ,IAAI,EAAE,cAAc,KAAK,eAAe,QAAQ,GAAG;YACnD,QAAQ,EAAE,aAAa,CAAC,KAAK;SAC9B,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,YAAY,CACjB,KAAa,EACb,IAAY;QAEZ,OAAO,IAAI,WAAW,CAAC;YACrB,IAAI,EAAE,cAAc,CAAC,oBAAoB;YACzC,OAAO,EAAE,2BAA2B,KAAK,GAAG;YAC5C,IAAI;YACJ,IAAI,EAAE,YAAY,KAAK,2BAA2B;YAClD,QAAQ,EAAE,aAAa,CAAC,KAAK;SAC9B,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,WAAW,CAChB,KAAa,EACb,KAAa,EACb,WAAqB,EACrB,IAAY;QAEZ,OAAO,IAAI,WAAW,CAAC;YACrB,IAAI,EAAE,cAAc,CAAC,mBAAmB;YACxC,OAAO,EAAE,kBAAkB,KAAK,gBAAgB,KAAK,GAAG;YACxD,IAAI;YACJ,IAAI,EAAE,qBAAqB,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;YACnD,QAAQ,EAAE,aAAa,CAAC,KAAK;SAC9B,CAAC,CAAC;IACL,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,eAAgB,SAAQ,UAAU;IAC7C,YAAY,UAAgC;QAC1C,KAAK,CAAC,EAAE,GAAG,UAAU,EAAE,QAAQ,EAAE,aAAa,CAAC,KAAK,EAAE,CAAC,CAAC;IAC1D,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,WAAW,CAChB,MAAc,EACd,IAAY;QAEZ,OAAO,IAAI,eAAe,CAAC;YACzB,IAAI,EAAE,cAAc,CAAC,uBAAuB;YAC5C,OAAO,EAAE,sBAAsB,MAAM,GAAG;YACxC,IAAI;YACJ,IAAI,EAAE,8CAA8C;YACpD,QAAQ,EAAE,aAAa,CAAC,KAAK;SAC9B,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,WAAW,CAChB,MAAc,EACd,IAAY,EACZ,cAAyB;QAEzB,MAAM,IAAI,GAAG,cAAc,IAAI,cAAc,CAAC,MAAM,GAAG,CAAC;YACtD,CAAC,CAAC,oBAAoB,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;YACjD,CAAC,CAAC,sDAAsD,CAAC;QAE3D,OAAO,IAAI,eAAe,CAAC;YACzB,IAAI,EAAE,cAAc,CAAC,uBAAuB;YAC5C,OAAO,EAAE,iBAAiB,MAAM,GAAG;YACnC,IAAI;YACJ,IAAI;YACJ,QAAQ,EAAE,aAAa,CAAC,KAAK;SAC9B,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,kBAAkB,CACvB,KAAe,EACf,IAAY;QAEZ,OAAO,IAAI,eAAe,CAAC;YACzB,IAAI,EAAE,cAAc,CAAC,8BAA8B;YACnD,OAAO,EAAE,iCAAiC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE;YAC7D,IAAI;YACJ,IAAI,EAAE,6CAA6C;YACnD,QAAQ,EAAE,aAAa,CAAC,KAAK;SAC9B,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,gBAAgB,CACrB,MAAc,EACd,cAAsB,EACtB,IAAY;QAEZ,OAAO,IAAI,eAAe,CAAC;YACzB,IAAI,EAAE,cAAc,CAAC,4BAA4B;YACjD,OAAO,EAAE,SAAS,MAAM,iBAAiB,cAAc,iCAAiC;YACxF,IAAI;YACJ,IAAI,EAAE,mDAAmD;YACzD,QAAQ,EAAE,aAAa,CAAC,KAAK;SAC9B,CAAC,CAAC;IACL,CAAC;CACF"}

package/dist/errors/index.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Orbyt Error Infrastructure
+ *
+ * Comprehensive error handling with diagnostic capabilities.
+ *
+ * @module errors
+ */
+export * from './ErrorCodes.js';
+export * from './OrbytError.js';
+export * from './WorkflowError.js';
+export * from './TypoDetector.js';
+export * from './FieldRegistry.js';
+export * from './ErrorFormatter.js';
+//# sourceMappingURL=index.d.ts.map

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

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

package/dist/errors/index.js

@@ -0,0 +1,17 @@
+/**
+ * Orbyt Error Infrastructure
+ *
+ * Comprehensive error handling with diagnostic capabilities.
+ *
+ * @module errors
+ */
+export * from './ErrorCodes.js';
+export * from './OrbytError.js';
+export * from './WorkflowError.js';
+export * from './TypoDetector.js';
+export * from './FieldRegistry.js';
+export * from './ErrorFormatter.js';
+// Legacy exports (kept for compatibility)
+// export * from './SchedulerError.js';
+// export * from './StepError.js';
+//# sourceMappingURL=index.js.map

package/dist/errors/index.js.map

@@ -0,0 +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;AAEpC,0CAA0C;AAC1C,uCAAuC;AACvC,kCAAkC"}

package/dist/events/EngineEvents.d.ts

@@ -0,0 +1,143 @@
+/**
+ * Event Types and Interfaces for Orbyt Engine
+ *
+ * The event system enables observability and extensibility by emitting
+ * events at critical lifecycle moments. These events can be consumed by:
+ * - Logging systems
+ * - Metrics collectors
+ * - Monitoring dashboards
+ * - External integrations
+ * - Workflow triggers (event-driven automation)
+ */
+/**
+ * Core event interface - all events must conform to this shape
+ */
+export interface OrbytEvent<T = any> {
+    /** Event type identifier */
+    type: string;
+    /** Unix timestamp in milliseconds */
+    timestamp: number;
+    /** ID of the workflow execution */
+    workflowId?: string;
+    /** ID of the step being executed */
+    stepId?: string;
+    /** ID of the specific execution run */
+    runId?: string;
+    /** Event-specific payload data */
+    payload?: T;
+}
+/**
+ * Engine-wide event types
+ * These cover all significant lifecycle moments in the execution flow
+ */
+export declare enum EngineEventType {
+    WORKFLOW_STARTED = "workflow.started",
+    WORKFLOW_COMPLETED = "workflow.completed",
+    WORKFLOW_FAILED = "workflow.failed",
+    WORKFLOW_PAUSED = "workflow.paused",
+    WORKFLOW_RESUMED = "workflow.resumed",
+    WORKFLOW_CANCELLED = "workflow.cancelled",
+    STEP_STARTED = "step.started",
+    STEP_COMPLETED = "step.completed",
+    STEP_FAILED = "step.failed",
+    STEP_SKIPPED = "step.skipped",
+    STEP_RETRYING = "step.retrying",
+    STEP_TIMEOUT = "step.timeout",
+    JOB_ENQUEUED = "job.enqueued",
+    JOB_DEQUEUED = "job.dequeued",
+    JOB_RETRY = "job.retry",
+    SCHEDULE_TRIGGERED = "schedule.triggered",
+    TRIGGER_FIRED = "trigger.fired",
+    STATE_CHANGED = "state.changed",
+    ENGINE_STARTED = "engine.started",
+    ENGINE_STOPPED = "engine.stopped",
+    WORKER_ONLINE = "worker.online",
+    WORKER_OFFLINE = "worker.offline"
+}
+/**
+ * Typed event payloads for better type safety
+ */
+export interface WorkflowStartedPayload {
+    workflowId: string;
+    workflowName: string;
+    runId: string;
+    triggeredBy?: string;
+    inputs?: Record<string, any>;
+}
+export interface WorkflowCompletedPayload {
+    workflowId: string;
+    workflowName: string;
+    runId: string;
+    durationMs: number;
+    stepCount: number;
+}
+export interface WorkflowFailedPayload {
+    workflowId: string;
+    workflowName: string;
+    runId: string;
+    error: string;
+    failedStep?: string;
+    durationMs: number;
+}
+export interface StepStartedPayload {
+    workflowId: string;
+    runId: string;
+    stepId: string;
+    stepName: string;
+    adapterType: string;
+}
+export interface StepCompletedPayload {
+    workflowId: string;
+    runId: string;
+    stepId: string;
+    stepName: string;
+    adapterType: string;
+    durationMs: number;
+    output?: any;
+}
+export interface StepFailedPayload {
+    workflowId: string;
+    runId: string;
+    stepId: string;
+    stepName: string;
+    adapterType: string;
+    error: string;
+    attempt: number;
+    willRetry: boolean;
+}
+export interface StepRetryingPayload {
+    workflowId: string;
+    runId: string;
+    stepId: string;
+    stepName: string;
+    attempt: number;
+    maxAttempts: number;
+    delayMs: number;
+}
+export interface JobEnqueuedPayload {
+    jobId: string;
+    workflowId: string;
+    priority: number;
+    queueDepth: number;
+}
+export interface ScheduleTriggeredPayload {
+    scheduleId: string;
+    workflowId: string;
+    triggerType: string;
+    nextRun?: Date;
+}
+export interface StateChangedPayload {
+    workflowId: string;
+    runId: string;
+    from: string;
+    to: string;
+}
+/**
+ * Helper to create well-formed events
+ */
+export declare function createEvent<T = any>(type: string | EngineEventType, payload?: T, context?: {
+    workflowId?: string;
+    stepId?: string;
+    runId?: string;
+}): OrbytEvent<T>;
+//# sourceMappingURL=EngineEvents.d.ts.map

package/dist/events/EngineEvents.d.ts.map

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

package/dist/events/EngineEvents.js

@@ -0,0 +1,60 @@
+/**
+ * Event Types and Interfaces for Orbyt Engine
+ *
+ * The event system enables observability and extensibility by emitting
+ * events at critical lifecycle moments. These events can be consumed by:
+ * - Logging systems
+ * - Metrics collectors
+ * - Monitoring dashboards
+ * - External integrations
+ * - Workflow triggers (event-driven automation)
+ */
+/**
+ * Engine-wide event types
+ * These cover all significant lifecycle moments in the execution flow
+ */
+export var EngineEventType;
+(function (EngineEventType) {
+    // Workflow-level events
+    EngineEventType["WORKFLOW_STARTED"] = "workflow.started";
+    EngineEventType["WORKFLOW_COMPLETED"] = "workflow.completed";
+    EngineEventType["WORKFLOW_FAILED"] = "workflow.failed";
+    EngineEventType["WORKFLOW_PAUSED"] = "workflow.paused";
+    EngineEventType["WORKFLOW_RESUMED"] = "workflow.resumed";
+    EngineEventType["WORKFLOW_CANCELLED"] = "workflow.cancelled";
+    // Step-level events
+    EngineEventType["STEP_STARTED"] = "step.started";
+    EngineEventType["STEP_COMPLETED"] = "step.completed";
+    EngineEventType["STEP_FAILED"] = "step.failed";
+    EngineEventType["STEP_SKIPPED"] = "step.skipped";
+    EngineEventType["STEP_RETRYING"] = "step.retrying";
+    EngineEventType["STEP_TIMEOUT"] = "step.timeout";
+    // Job queue events
+    EngineEventType["JOB_ENQUEUED"] = "job.enqueued";
+    EngineEventType["JOB_DEQUEUED"] = "job.dequeued";
+    EngineEventType["JOB_RETRY"] = "job.retry";
+    // Scheduling events
+    EngineEventType["SCHEDULE_TRIGGERED"] = "schedule.triggered";
+    EngineEventType["TRIGGER_FIRED"] = "trigger.fired";
+    // State transitions
+    EngineEventType["STATE_CHANGED"] = "state.changed";
+    // System events
+    EngineEventType["ENGINE_STARTED"] = "engine.started";
+    EngineEventType["ENGINE_STOPPED"] = "engine.stopped";
+    EngineEventType["WORKER_ONLINE"] = "worker.online";
+    EngineEventType["WORKER_OFFLINE"] = "worker.offline";
+})(EngineEventType || (EngineEventType = {}));
+/**
+ * Helper to create well-formed events
+ */
+export function createEvent(type, payload, context) {
+    return {
+        type,
+        timestamp: Date.now(),
+        workflowId: context?.workflowId,
+        stepId: context?.stepId,
+        runId: context?.runId,
+        payload,
+    };
+}
+//# sourceMappingURL=EngineEvents.js.map

package/dist/events/EngineEvents.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"EngineEvents.js","sourceRoot":"","sources":["../../src/events/EngineEvents.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAyBH;;;GAGG;AACH,MAAM,CAAN,IAAY,eAkCX;AAlCD,WAAY,eAAe;IACzB,wBAAwB;IACxB,wDAAqC,CAAA;IACrC,4DAAyC,CAAA;IACzC,sDAAmC,CAAA;IACnC,sDAAmC,CAAA;IACnC,wDAAqC,CAAA;IACrC,4DAAyC,CAAA;IAEzC,oBAAoB;IACpB,gDAA6B,CAAA;IAC7B,oDAAiC,CAAA;IACjC,8CAA2B,CAAA;IAC3B,gDAA6B,CAAA;IAC7B,kDAA+B,CAAA;IAC/B,gDAA6B,CAAA;IAE7B,mBAAmB;IACnB,gDAA6B,CAAA;IAC7B,gDAA6B,CAAA;IAC7B,0CAAuB,CAAA;IAEvB,oBAAoB;IACpB,4DAAyC,CAAA;IACzC,kDAA+B,CAAA;IAE/B,oBAAoB;IACpB,kDAA+B,CAAA;IAE/B,gBAAgB;IAChB,oDAAiC,CAAA;IACjC,oDAAiC,CAAA;IACjC,kDAA+B,CAAA;IAC/B,oDAAiC,CAAA;AACnC,CAAC,EAlCW,eAAe,KAAf,eAAe,QAkC1B;AA2FD;;GAEG;AACH,MAAM,UAAU,WAAW,CACzB,IAA8B,EAC9B,OAAW,EACX,OAAkE;IAElE,OAAO;QACL,IAAI;QACJ,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;QACrB,UAAU,EAAE,OAAO,EAAE,UAAU;QAC/B,MAAM,EAAE,OAAO,EAAE,MAAM;QACvB,KAAK,EAAE,OAAO,EAAE,KAAK;QACrB,OAAO;KACR,CAAC;AACJ,CAAC"}

package/dist/events/EventBus.d.ts

@@ -0,0 +1,112 @@
+import type { OrbytEvent } from './EngineEvents.js';
+/**
+ * Event handler function signature
+ */
+export type EventHandler<T = any> = (event: OrbytEvent<T>) => void | Promise<void>;
+/**
+ * EventBus - Central pub/sub system for Orbyt Engine
+ *
+ * Provides decoupled communication between engine components:
+ * - Executors emit events at lifecycle moments
+ * - Loggers, metrics, monitors subscribe to events
+ * - Plugins can hook into engine behavior
+ *
+ * Design Philosophy:
+ * - Simple: Map-based lookup, no complex routing
+ * - Async-safe: Handlers can be sync or async
+ * - Error-isolated: Handler failures don't affect other handlers
+ * - Wildcard support: Listen to all events with '*'
+ *
+ * @example
+ * ```ts
+ * const bus = new EventBus();
+ *
+ * // Subscribe to specific event
+ * bus.on('step.completed', (event) => {
+ *   console.log('Step done:', event.payload);
+ * });
+ *
+ * // Subscribe to all events
+ * bus.on('*', (event) => {
+ *   logger.log(event);
+ * });
+ *
+ * // Emit event
+ * bus.emit(createEvent('step.completed', { stepId: 'test' }));
+ * ```
+ */
+export declare class EventBus {
+    private listeners;
+    private wildcardListeners;
+    /**
+     * Subscribe to events of a specific type
+     *
+     * @param eventType - The event type to listen for, or '*' for all events
+     * @param handler - Function to call when event is emitted
+     * @returns Unsubscribe function
+     */
+    on(eventType: string, handler: EventHandler): () => void;
+    /**
+     * Subscribe to multiple event types with the same handler
+     *
+     * @param eventTypes - Array of event types to listen for
+     * @param handler - Function to call when any of the events is emitted
+     * @returns Unsubscribe function that removes all subscriptions
+     */
+    onMany(eventTypes: string[], handler: EventHandler): () => void;
+    /**
+     * Subscribe to an event, but only fire once then auto-unsubscribe
+     *
+     * @param eventType - The event type to listen for
+     * @param handler - Function to call when event is emitted
+     */
+    once(eventType: string, handler: EventHandler): void;
+    /**
+     * Emit an event to all subscribed handlers
+     *
+     * Handlers are called in registration order. Async handlers are awaited.
+     * If a handler throws, the error is caught and logged to prevent
+     * cascading failures.
+     *
+     * @param event - The event to emit
+     */
+    emit(event: OrbytEvent): Promise<void>;
+    /**
+     * Emit event synchronously without awaiting async handlers
+     * Use when you need fire-and-forget behavior
+     *
+     * @param event - The event to emit
+     */
+    emitSync(event: OrbytEvent): void;
+    /**
+     * Remove all handlers for a specific event type
+     *
+     * @param eventType - The event type to clear
+     */
+    off(eventType: string): void;
+    /**
+     * Remove all event handlers
+     */
+    clear(): void;
+    /**
+     * Get count of listeners for an event type (useful for debugging)
+     *
+     * @param eventType - The event type to count
+     * @returns Number of listeners
+     */
+    listenerCount(eventType: string): number;
+    /**
+     * Get all event types that have listeners
+     *
+     * @returns Array of event types
+     */
+    getEventTypes(): string[];
+    /**
+     * Check if an event type has any listeners
+     *
+     * @param eventType - The event type to check
+     * @returns True if there are listeners
+     */
+    hasListeners(eventType: string): boolean;
+}
+//# sourceMappingURL=EventBus.d.ts.map