@orbytautomation/engine 0.1.0

package/dist/state/StateMachine.js

@@ -0,0 +1,230 @@
+/**
+ * State Machine
+ *
+ * Enforces valid state transitions for workflow and step execution.
+ * This ensures state integrity and prevents invalid state combinations.
+ *
+ * Purpose:
+ * - Define valid state transition rules
+ * - Validate transitions before they occur
+ * - Provide type-safe transition methods
+ * - Track transition history for debugging
+ *
+ * This is about RULES, not execution. It answers:
+ * - Can this state transition happen?
+ * - What are the valid next states?
+ * - Is this state terminal (no further transitions)?
+ *
+ * @module state
+ */
+import { StepStatus, WorkflowStatus } from './ExecutionState.js';
+/**
+ * Generic state machine for enforcing valid transitions
+ */
+export class StateMachine {
+    currentState;
+    config;
+    history = [];
+    constructor(config) {
+        this.config = config;
+        this.currentState = config.initialState;
+    }
+    /**
+     * Get current state
+     */
+    getState() {
+        return this.currentState;
+    }
+    /**
+     * Check if transition is valid
+     */
+    canTransition(to) {
+        // Terminal states cannot transition
+        if (this.config.terminalStates.has(this.currentState)) {
+            return false;
+        }
+        const allowedTransitions = this.config.transitions.get(this.currentState);
+        if (!allowedTransitions) {
+            return false;
+        }
+        return allowedTransitions.includes(to);
+    }
+    /**
+     * Perform state transition
+     *
+     * @param to - Target state
+     * @param reason - Optional reason for transition
+     * @throws Error if transition is invalid
+     */
+    transition(to, reason) {
+        if (!this.canTransition(to)) {
+            throw new Error(`Invalid state transition: ${String(this.currentState)} → ${String(to)}`);
+        }
+        const from = this.currentState;
+        this.currentState = to;
+        // Record transition
+        this.history.push({
+            from,
+            to,
+            timestamp: Date.now(),
+            reason,
+        });
+    }
+    /**
+     * Check if current state is terminal
+     */
+    isTerminal() {
+        return this.config.terminalStates.has(this.currentState);
+    }
+    /**
+     * Get allowed transitions from current state
+     */
+    getAllowedTransitions() {
+        return this.config.transitions.get(this.currentState) || [];
+    }
+    /**
+     * Get transition history
+     */
+    getHistory() {
+        return [...this.history];
+    }
+    /**
+     * Reset to initial state (for testing/recovery)
+     */
+    reset() {
+        this.currentState = this.config.initialState;
+        this.history.length = 0;
+    }
+}
+/**
+ * Step state machine configuration
+ *
+ * Valid transitions:
+ * PENDING → RUNNING → SUCCESS (happy path)
+ * PENDING → SKIPPED (conditional)
+ * RUNNING → FAILED → RETRYING → RUNNING (retry path)
+ * RUNNING → TIMEOUT (timeout)
+ * RUNNING → CANCELLED (cancellation)
+ * any → CANCELLED (force cancel)
+ */
+const STEP_TRANSITIONS = new Map([
+    [StepStatus.PENDING, [StepStatus.RUNNING, StepStatus.SKIPPED, StepStatus.CANCELLED]],
+    [StepStatus.RUNNING, [StepStatus.SUCCESS, StepStatus.FAILED, StepStatus.TIMEOUT, StepStatus.CANCELLED]],
+    [StepStatus.FAILED, [StepStatus.RETRYING, StepStatus.CANCELLED]],
+    [StepStatus.RETRYING, [StepStatus.RUNNING, StepStatus.CANCELLED]],
+    [StepStatus.SKIPPED, []], // Terminal
+    [StepStatus.SUCCESS, []], // Terminal
+    [StepStatus.TIMEOUT, []], // Terminal
+    [StepStatus.CANCELLED, []], // Terminal
+]);
+const STEP_TERMINAL_STATES = new Set([
+    StepStatus.SUCCESS,
+    StepStatus.SKIPPED,
+    StepStatus.TIMEOUT,
+    StepStatus.CANCELLED,
+]);
+/**
+ * Workflow state machine configuration
+ *
+ * Valid transitions:
+ * QUEUED → RUNNING (start)
+ * RUNNING → COMPLETED (all steps success)
+ * RUNNING → FAILED (step failed, no continueOnError)
+ * RUNNING → PARTIAL (some steps failed, continueOnError)
+ * RUNNING → TIMEOUT (workflow timeout)
+ * RUNNING → CANCELLED (user cancelled)
+ * RUNNING → PAUSED (pause feature - future)
+ * PAUSED → RUNNING (resume - future)
+ * PAUSED → CANCELLED (cancel while paused)
+ */
+const WORKFLOW_TRANSITIONS = new Map([
+    [WorkflowStatus.QUEUED, [WorkflowStatus.RUNNING, WorkflowStatus.CANCELLED]],
+    [WorkflowStatus.RUNNING, [
+            WorkflowStatus.COMPLETED,
+            WorkflowStatus.FAILED,
+            WorkflowStatus.PARTIAL,
+            WorkflowStatus.TIMEOUT,
+            WorkflowStatus.CANCELLED,
+            WorkflowStatus.PAUSED,
+        ]],
+    [WorkflowStatus.PAUSED, [WorkflowStatus.RUNNING, WorkflowStatus.CANCELLED]],
+    [WorkflowStatus.COMPLETED, []], // Terminal
+    [WorkflowStatus.FAILED, []], // Terminal
+    [WorkflowStatus.PARTIAL, []], // Terminal
+    [WorkflowStatus.TIMEOUT, []], // Terminal
+    [WorkflowStatus.CANCELLED, []], // Terminal
+]);
+const WORKFLOW_TERMINAL_STATES = new Set([
+    WorkflowStatus.COMPLETED,
+    WorkflowStatus.FAILED,
+    WorkflowStatus.PARTIAL,
+    WorkflowStatus.TIMEOUT,
+    WorkflowStatus.CANCELLED,
+]);
+/**
+ * Create step state machine
+ */
+export function createStepStateMachine() {
+    return new StateMachine({
+        initialState: StepStatus.PENDING,
+        transitions: STEP_TRANSITIONS,
+        terminalStates: STEP_TERMINAL_STATES,
+    });
+}
+/**
+ * Create workflow state machine
+ */
+export function createWorkflowStateMachine() {
+    return new StateMachine({
+        initialState: WorkflowStatus.QUEUED,
+        transitions: WORKFLOW_TRANSITIONS,
+        terminalStates: WORKFLOW_TERMINAL_STATES,
+    });
+}
+/**
+ * Validate step state transition
+ * Throws if invalid
+ */
+export function validateStepTransition(from, to) {
+    const allowed = STEP_TRANSITIONS.get(from) || [];
+    if (!allowed.includes(to)) {
+        throw new Error(`Invalid step state transition: ${from} → ${to}. ` +
+            `Allowed: ${allowed.join(', ') || 'none (terminal state)'}`);
+    }
+}
+/**
+ * Validate workflow state transition
+ * Throws if invalid
+ */
+export function validateWorkflowTransition(from, to) {
+    const allowed = WORKFLOW_TRANSITIONS.get(from) || [];
+    if (!allowed.includes(to)) {
+        throw new Error(`Invalid workflow state transition: ${from} → ${to}. ` +
+            `Allowed: ${allowed.join(', ') || 'none (terminal state)'}`);
+    }
+}
+/**
+ * Check if step status is terminal
+ */
+export function isStepTerminal(status) {
+    return STEP_TERMINAL_STATES.has(status);
+}
+/**
+ * Check if workflow status is terminal
+ */
+export function isWorkflowTerminal(status) {
+    return WORKFLOW_TERMINAL_STATES.has(status);
+}
+/**
+ * Get allowed transitions from a step state
+ */
+export function getStepTransitions(from) {
+    return STEP_TRANSITIONS.get(from) || [];
+}
+/**
+ * Get allowed transitions from a workflow state
+ */
+export function getWorkflowTransitions(from) {
+    return WORKFLOW_TRANSITIONS.get(from) || [];
+}
+//# sourceMappingURL=StateMachine.js.map

package/dist/state/StateMachine.js.map

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

package/dist/state/index.d.ts

@@ -0,0 +1,16 @@
+/**
+ * State Management
+ *
+ * Provides state tracking and state machine for workflow execution:
+ * - ExecutionState: State interfaces and enums for tracking execution
+ * - StateMachine: Enforces valid state transitions with validation
+ *
+ * This enables:
+ * - Real-time execution tracking
+ * - Resume/recovery capabilities
+ * - Audit trails
+ * - State integrity validation
+ */
+export * from './ExecutionState.js';
+export * from './StateMachine.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/state/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,cAAc,qBAAqB,CAAC;AACpC,cAAc,mBAAmB,CAAC"}

package/dist/state/index.js

@@ -0,0 +1,16 @@
+/**
+ * State Management
+ *
+ * Provides state tracking and state machine for workflow execution:
+ * - ExecutionState: State interfaces and enums for tracking execution
+ * - StateMachine: Enforces valid state transitions with validation
+ *
+ * This enables:
+ * - Real-time execution tracking
+ * - Resume/recovery capabilities
+ * - Audit trails
+ * - State integrity validation
+ */
+export * from './ExecutionState.js';
+export * from './StateMachine.js';
+//# sourceMappingURL=index.js.map

package/dist/state/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/state/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,cAAc,qBAAqB,CAAC;AACpC,cAAc,mBAAmB,CAAC"}

package/dist/storage/ExecutionStore.d.ts

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

package/dist/storage/ExecutionStore.d.ts.map

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

package/dist/storage/ExecutionStore.js

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

package/dist/storage/ExecutionStore.js.map

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

package/dist/storage/ScheduleStore.d.ts

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

package/dist/storage/ScheduleStore.d.ts.map

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

package/dist/storage/ScheduleStore.js

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

package/dist/storage/ScheduleStore.js.map

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

package/dist/storage/WorkflowStore.d.ts

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

package/dist/storage/WorkflowStore.d.ts.map

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

package/dist/storage/WorkflowStore.js

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

package/dist/storage/WorkflowStore.js.map

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

package/dist/storage/index.d.ts

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

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

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

package/dist/storage/index.js

@@ -0,0 +1,5 @@
+export {};
+// export * from './ExecutionStore.js';
+// export * from './ScheduleStore.js';
+// export * from './WorkflowStore.js';
+//# sourceMappingURL=index.js.map

package/dist/storage/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/storage/index.ts"],"names":[],"mappings":";AAAA,uCAAuC;AACvC,sCAAsC;AACtC,sCAAsC"}

package/dist/testing/EngineTestHarness.d.ts

@@ -0,0 +1,117 @@
+/**
+ * Engine Test Harness
+ *
+ * Testing framework for Orbyt engine.
+ * Provides utilities to test workflows without real execution.
+ *
+ * @module testing
+ * @status stub - will be enhanced when testing framework is needed
+ */
+import type { ParsedWorkflow } from '../parser/WorkflowParser.js';
+import type { Adapter } from '@dev-ecosystem/core';
+/**
+ * Test harness configuration
+ */
+export interface TestHarnessConfig {
+    /** Mock adapters registry */
+    adapters?: Map<string, Adapter>;
+    /** Capture execution logs */
+    captureLogs?: boolean;
+    /** Execution timeout */
+    timeout?: number;
+}
+/**
+ * Test execution result
+ */
+export interface TestExecutionResult {
+    /** Workflow ID */
+    workflowId: string;
+    /** Execution status */
+    status: 'success' | 'failed' | 'timeout';
+    /** Step results */
+    steps: Array<{
+        stepId: string;
+        status: string;
+        output?: any;
+        error?: Error;
+    }>;
+    /** Execution duration */
+    duration: number;
+    /** Captured logs */
+    logs?: string[];
+}
+/**
+ * Engine Test Harness
+ *
+ * Provides testing utilities for workflows
+ */
+export declare class EngineTestHarness {
+    private adapters;
+    private logs;
+    private config;
+    constructor(config?: TestHarnessConfig);
+    /**
+     * Register a mock adapter
+     *
+     * @param name - Adapter name
+     * @param adapter - Adapter instance
+     */
+    registerAdapter(name: string, adapter: Adapter): void;
+    /**
+     * Register a mock adapter with simple success response
+     *
+     * @param name - Adapter name
+     * @param response - Mock response
+     */
+    registerMockSuccess(name: string, response?: any): void;
+    /**
+     * Register a mock adapter that fails
+     *
+     * @param name - Adapter name
+     * @param error - Error to throw
+     */
+    registerMockFailure(name: string, error?: Error): void;
+    /**
+     * Execute workflow in test mode
+     *
+     * @param workflow - Parsed workflow
+     * @param context - Initial context
+     * @returns Test execution result
+     */
+    executeWorkflow(workflow: ParsedWorkflow, _context?: Record<string, any>): Promise<TestExecutionResult>;
+    /**
+     * Assert workflow execution succeeds
+     *
+     * @param workflow - Workflow to test
+     * @param context - Execution context
+     */
+    assertSuccess(workflow: ParsedWorkflow, context?: Record<string, any>): Promise<void>;
+    /**
+     * Assert workflow execution fails
+     *
+     * @param workflow - Workflow to test
+     * @param context - Execution context
+     */
+    assertFailure(workflow: ParsedWorkflow, context?: Record<string, any>): Promise<void>;
+    /**
+     * Get adapter by name
+     */
+    getAdapter(name: string): Adapter | undefined;
+    /**
+     * Clear all adapters
+     */
+    clearAdapters(): void;
+    /**
+     * Get captured logs
+     */
+    getLogs(): string[];
+    /**
+     * Clear logs
+     */
+    clearLogs(): void;
+    /**
+     * Log message (if capture enabled)
+     */
+    private log;
+}
+//# sourceMappingURL=EngineTestHarness.d.ts.map

package/dist/testing/EngineTestHarness.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EngineTestHarness.d.ts","sourceRoot":"","sources":["../../src/testing/EngineTestHarness.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAElE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAEnD;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,6BAA6B;IAC7B,QAAQ,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAEhC,6BAA6B;IAC7B,WAAW,CAAC,EAAE,OAAO,CAAC;IAEtB,wBAAwB;IACxB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,kBAAkB;IAClB,UAAU,EAAE,MAAM,CAAC;IAEnB,uBAAuB;IACvB,MAAM,EAAE,SAAS,GAAG,QAAQ,GAAG,SAAS,CAAC;IAEzC,mBAAmB;IACnB,KAAK,EAAE,KAAK,CAAC;QACX,MAAM,EAAE,MAAM,CAAC;QACf,MAAM,EAAE,MAAM,CAAC;QACf,MAAM,CAAC,EAAE,GAAG,CAAC;QACb,KAAK,CAAC,EAAE,KAAK,CAAC;KACf,CAAC,CAAC;IAEH,yBAAyB;IACzB,QAAQ,EAAE,MAAM,CAAC;IAEjB,oBAAoB;IACpB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACjB;AAED;;;;GAIG;AACH,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,QAAQ,CAA8B;IAC9C,OAAO,CAAC,IAAI,CAAgB;IAC5B,OAAO,CAAC,MAAM,CAAoB;gBAEtB,MAAM,GAAE,iBAAsB;IAQ1C;;;;;OAKG;IACH,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI;IAIrD;;;;;OAKG;IACH,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,GAAG,GAAG,IAAI;IAIvD;;;;;OAKG;IACH,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,KAAK,GAAG,IAAI;IAItD;;;;;;OAMG;IACG,eAAe,CACnB,QAAQ,EAAE,cAAc,EACxB,QAAQ,GAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAM,GACjC,OAAO,CAAC,mBAAmB,CAAC;IAqB/B;;;;;OAKG;IACG,aAAa,CAAC,QAAQ,EAAE,cAAc,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAQ3F;;;;;OAKG;IACG,aAAa,CAAC,QAAQ,EAAE,cAAc,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAQ3F;;OAEG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS;IAI7C;;OAEG;IACH,aAAa,IAAI,IAAI;IAIrB;;OAEG;IACH,OAAO,IAAI,MAAM,EAAE;IAInB;;OAEG;IACH,SAAS,IAAI,IAAI;IAIjB;;OAEG;IACH,OAAO,CAAC,GAAG;CAKZ"}

package/dist/testing/EngineTestHarness.js

@@ -0,0 +1,132 @@
+/**
+ * Engine Test Harness
+ *
+ * Testing framework for Orbyt engine.
+ * Provides utilities to test workflows without real execution.
+ *
+ * @module testing
+ * @status stub - will be enhanced when testing framework is needed
+ */
+import { MockAdapter } from './MockAdapter.js';
+/**
+ * Engine Test Harness
+ *
+ * Provides testing utilities for workflows
+ */
+export class EngineTestHarness {
+    adapters = new Map();
+    logs = [];
+    config;
+    constructor(config = {}) {
+        this.config = config;
+        if (config.adapters) {
+            this.adapters = config.adapters;
+        }
+    }
+    /**
+     * Register a mock adapter
+     *
+     * @param name - Adapter name
+     * @param adapter - Adapter instance
+     */
+    registerAdapter(name, adapter) {
+        this.adapters.set(name, adapter);
+    }
+    /**
+     * Register a mock adapter with simple success response
+     *
+     * @param name - Adapter name
+     * @param response - Mock response
+     */
+    registerMockSuccess(name, response) {
+        this.adapters.set(name, MockAdapter.createSuccess(name, response));
+    }
+    /**
+     * Register a mock adapter that fails
+     *
+     * @param name - Adapter name
+     * @param error - Error to throw
+     */
+    registerMockFailure(name, error) {
+        this.adapters.set(name, MockAdapter.createFailure(name, error));
+    }
+    /**
+     * Execute workflow in test mode
+     *
+     * @param workflow - Parsed workflow
+     * @param context - Initial context
+     * @returns Test execution result
+     */
+    async executeWorkflow(workflow, _context = {}) {
+        const startTime = Date.now();
+        this.log(`Starting test execution for workflow: ${workflow.name || 'unnamed'}`);
+        // TODO: Implement actual workflow execution with mocks
+        // For now, just simulate
+        const result = {
+            workflowId: workflow.name || 'test-workflow',
+            status: 'success',
+            steps: [],
+            duration: Date.now() - startTime,
+            logs: this.config.captureLogs ? [...this.logs] : undefined,
+        };
+        this.log(`Test execution completed in ${result.duration}ms`);
+        return result;
+    }
+    /**
+     * Assert workflow execution succeeds
+     *
+     * @param workflow - Workflow to test
+     * @param context - Execution context
+     */
+    async assertSuccess(workflow, context) {
+        const result = await this.executeWorkflow(workflow, context);
+        if (result.status !== 'success') {
+            throw new Error(`Workflow execution failed: ${result.status}`);
+        }
+    }
+    /**
+     * Assert workflow execution fails
+     *
+     * @param workflow - Workflow to test
+     * @param context - Execution context
+     */
+    async assertFailure(workflow, context) {
+        const result = await this.executeWorkflow(workflow, context);
+        if (result.status === 'success') {
+            throw new Error('Expected workflow to fail, but it succeeded');
+        }
+    }
+    /**
+     * Get adapter by name
+     */
+    getAdapter(name) {
+        return this.adapters.get(name);
+    }
+    /**
+     * Clear all adapters
+     */
+    clearAdapters() {
+        this.adapters.clear();
+    }
+    /**
+     * Get captured logs
+     */
+    getLogs() {
+        return [...this.logs];
+    }
+    /**
+     * Clear logs
+     */
+    clearLogs() {
+        this.logs = [];
+    }
+    /**
+     * Log message (if capture enabled)
+     */
+    log(message) {
+        if (this.config.captureLogs) {
+            this.logs.push(`[${new Date().toISOString()}] ${message}`);
+        }
+    }
+}
+//# sourceMappingURL=EngineTestHarness.js.map

package/dist/testing/EngineTestHarness.js.map

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