@orbytautomation/engine 0.1.0

package/dist/security/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Security Module
+ *
+ * Permission policies, sandboxing, and security enforcement.
+ *
+ * @status stub - will be fully implemented when core engine is stable
+ */
+export * from './PermissionPolicy.js';
+export * from './SandboxManager.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/security/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,cAAc,uBAAuB,CAAC;AACtC,cAAc,qBAAqB,CAAC"}

package/dist/security/index.js

@@ -0,0 +1,10 @@
+/**
+ * Security Module
+ *
+ * Permission policies, sandboxing, and security enforcement.
+ *
+ * @status stub - will be fully implemented when core engine is stable
+ */
+export * from './PermissionPolicy.js';
+export * from './SandboxManager.js';
+//# sourceMappingURL=index.js.map

package/dist/security/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/security/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,cAAc,uBAAuB,CAAC;AACtC,cAAc,qBAAqB,CAAC"}

package/dist/state/ExecutionState.d.ts

@@ -0,0 +1,211 @@
+/**
+ * Execution State
+ *
+ * Tracks workflow and step execution state for observability,
+ * recovery, and resume capabilities.
+ *
+ * @module state
+ */
+/**
+ * Step execution status
+ *
+ * Lifecycle:
+ * PENDING → RUNNING → SUCCESS → COMPLETED
+ * OR
+ * PENDING → RUNNING → FAILED → RETRYING → RUNNING → SUCCESS → COMPLETED
+ * OR
+ * PENDING → SKIPPED
+ */
+export declare enum StepStatus {
+    /** Step is queued, not yet started */
+    PENDING = "PENDING",
+    /** Step is currently executing */
+    RUNNING = "RUNNING",
+    /** Step completed successfully */
+    SUCCESS = "SUCCESS",
+    /** Step failed */
+    FAILED = "FAILED",
+    /** Step is retrying after failure */
+    RETRYING = "RETRYING",
+    /** Step was skipped (conditional execution) */
+    SKIPPED = "SKIPPED",
+    /** Step timed out */
+    TIMEOUT = "TIMEOUT",
+    /** Step was cancelled */
+    CANCELLED = "CANCELLED"
+}
+/**
+ * Workflow execution status
+ */
+export declare enum WorkflowStatus {
+    /** Workflow is queued, not yet started */
+    QUEUED = "QUEUED",
+    /** Workflow is currently executing */
+    RUNNING = "RUNNING",
+    /** Workflow completed successfully (all steps success) */
+    COMPLETED = "COMPLETED",
+    /** Workflow failed (one or more steps failed) */
+    FAILED = "FAILED",
+    /** Workflow partially completed (some steps failed but continueOnError=true) */
+    PARTIAL = "PARTIAL",
+    /** Workflow timed out */
+    TIMEOUT = "TIMEOUT",
+    /** Workflow was cancelled */
+    CANCELLED = "CANCELLED",
+    /** Workflow is paused (future feature) */
+    PAUSED = "PAUSED"
+}
+/**
+ * Step execution state
+ */
+export interface StepExecutionState {
+    /** Unique step ID */
+    stepId: string;
+    /** Current status */
+    status: StepStatus;
+    /** Number of execution attempts */
+    attempts: number;
+    /** Start timestamp (ms since epoch) */
+    startTime?: number;
+    /** End timestamp (ms since epoch) */
+    endTime?: number;
+    /** Error information if failed */
+    error?: {
+        message: string;
+        code?: string;
+        stack?: string;
+    };
+    /** Step output data (if successful) */
+    output?: any;
+    /** Execution duration in milliseconds */
+    duration?: number;
+    /** Last updated timestamp */
+    updatedAt: number;
+}
+/**
+ * Workflow execution state
+ */
+export interface WorkflowExecutionState {
+    /** Unique workflow execution ID */
+    executionId: string;
+    /** Workflow name/ID */
+    workflowId: string;
+    /** Current workflow status */
+    status: WorkflowStatus;
+    /** State of all steps (keyed by step ID) */
+    steps: Record<string, StepExecutionState>;
+    /** Workflow start timestamp (ms since epoch) */
+    startedAt?: number;
+    /** Workflow completion timestamp (ms since epoch) */
+    finishedAt?: number;
+    /** Total workflow duration in milliseconds */
+    duration?: number;
+    /** Workflow-level error (if failed) */
+    error?: {
+        message: string;
+        stepId?: string;
+        code?: string;
+    };
+    /** Execution metadata */
+    metadata: {
+        /** Total number of steps */
+        totalSteps: number;
+        /** Number of completed steps */
+        completedSteps: number;
+        /** Number of failed steps */
+        failedSteps: number;
+        /** Number of skipped steps */
+        skippedSteps: number;
+        /** Current phase being executed */
+        currentPhase?: number;
+        /** Total number of phases */
+        totalPhases?: number;
+    };
+    /** Last state update timestamp */
+    updatedAt: number;
+    /** Execution context snapshot */
+    context?: {
+        env?: Record<string, any>;
+        inputs?: Record<string, any>;
+    };
+}
+/**
+ * Execution State Manager
+ *
+ * Manages workflow and step state with thread-safe updates.
+ */
+export declare class ExecutionStateManager {
+    private states;
+    /**
+     * Initialize a new workflow execution state
+     */
+    initializeWorkflow(executionId: string, workflowId: string, stepIds: string[], context?: {
+        env?: Record<string, any>;
+        inputs?: Record<string, any>;
+    }): WorkflowExecutionState;
+    /**
+     * Get workflow execution state
+     */
+    getState(executionId: string): WorkflowExecutionState | undefined;
+    /**
+     * Update workflow status
+     */
+    updateWorkflowStatus(executionId: string, status: WorkflowStatus, error?: {
+        message: string;
+        stepId?: string;
+        code?: string;
+    }): void;
+    /**
+     * Update step status
+     */
+    updateStepStatus(executionId: string, stepId: string, status: StepStatus, data?: {
+        error?: {
+            message: string;
+            code?: string;
+            stack?: string;
+        };
+        output?: any;
+        attempts?: number;
+    }): void;
+    /**
+     * Get step state
+     */
+    getStepState(executionId: string, stepId: string): StepExecutionState | undefined;
+    /**
+     * Check if step has completed (success or terminal failure)
+     */
+    isStepCompleted(executionId: string, stepId: string): boolean;
+    /**
+     * Check if step succeeded
+     */
+    isStepSuccessful(executionId: string, stepId: string): boolean;
+    /**
+     * Get all failed steps
+     */
+    getFailedSteps(executionId: string): StepExecutionState[];
+    /**
+     * Get all completed steps
+     */
+    getCompletedSteps(executionId: string): StepExecutionState[];
+    /**
+     * Clear execution state (cleanup)
+     */
+    clearState(executionId: string): boolean;
+    /**
+     * Get all execution IDs
+     */
+    getAllExecutionIds(): string[];
+    /**
+     * Check if status is terminal (workflow)
+     */
+    private isTerminalStatus;
+    /**
+     * Check if status is terminal (step)
+     */
+    private isTerminalStepStatus;
+    /**
+     * Update workflow metadata counts based on step states
+     */
+    private updateWorkflowMetadata;
+}
+//# sourceMappingURL=ExecutionState.d.ts.map

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

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

package/dist/state/ExecutionState.js

@@ -0,0 +1,256 @@
+/**
+ * Execution State
+ *
+ * Tracks workflow and step execution state for observability,
+ * recovery, and resume capabilities.
+ *
+ * @module state
+ */
+/**
+ * Step execution status
+ *
+ * Lifecycle:
+ * PENDING → RUNNING → SUCCESS → COMPLETED
+ * OR
+ * PENDING → RUNNING → FAILED → RETRYING → RUNNING → SUCCESS → COMPLETED
+ * OR
+ * PENDING → SKIPPED
+ */
+export var StepStatus;
+(function (StepStatus) {
+    /** Step is queued, not yet started */
+    StepStatus["PENDING"] = "PENDING";
+    /** Step is currently executing */
+    StepStatus["RUNNING"] = "RUNNING";
+    /** Step completed successfully */
+    StepStatus["SUCCESS"] = "SUCCESS";
+    /** Step failed */
+    StepStatus["FAILED"] = "FAILED";
+    /** Step is retrying after failure */
+    StepStatus["RETRYING"] = "RETRYING";
+    /** Step was skipped (conditional execution) */
+    StepStatus["SKIPPED"] = "SKIPPED";
+    /** Step timed out */
+    StepStatus["TIMEOUT"] = "TIMEOUT";
+    /** Step was cancelled */
+    StepStatus["CANCELLED"] = "CANCELLED";
+})(StepStatus || (StepStatus = {}));
+/**
+ * Workflow execution status
+ */
+export var WorkflowStatus;
+(function (WorkflowStatus) {
+    /** Workflow is queued, not yet started */
+    WorkflowStatus["QUEUED"] = "QUEUED";
+    /** Workflow is currently executing */
+    WorkflowStatus["RUNNING"] = "RUNNING";
+    /** Workflow completed successfully (all steps success) */
+    WorkflowStatus["COMPLETED"] = "COMPLETED";
+    /** Workflow failed (one or more steps failed) */
+    WorkflowStatus["FAILED"] = "FAILED";
+    /** Workflow partially completed (some steps failed but continueOnError=true) */
+    WorkflowStatus["PARTIAL"] = "PARTIAL";
+    /** Workflow timed out */
+    WorkflowStatus["TIMEOUT"] = "TIMEOUT";
+    /** Workflow was cancelled */
+    WorkflowStatus["CANCELLED"] = "CANCELLED";
+    /** Workflow is paused (future feature) */
+    WorkflowStatus["PAUSED"] = "PAUSED";
+})(WorkflowStatus || (WorkflowStatus = {}));
+/**
+ * Execution State Manager
+ *
+ * Manages workflow and step state with thread-safe updates.
+ */
+export class ExecutionStateManager {
+    states = new Map();
+    /**
+     * Initialize a new workflow execution state
+     */
+    initializeWorkflow(executionId, workflowId, stepIds, context) {
+        const now = Date.now();
+        const steps = {};
+        for (const stepId of stepIds) {
+            steps[stepId] = {
+                stepId,
+                status: StepStatus.PENDING,
+                attempts: 0,
+                updatedAt: now,
+            };
+        }
+        const state = {
+            executionId,
+            workflowId,
+            status: WorkflowStatus.QUEUED,
+            steps,
+            metadata: {
+                totalSteps: stepIds.length,
+                completedSteps: 0,
+                failedSteps: 0,
+                skippedSteps: 0,
+            },
+            updatedAt: now,
+            context,
+        };
+        this.states.set(executionId, state);
+        return state;
+    }
+    /**
+     * Get workflow execution state
+     */
+    getState(executionId) {
+        return this.states.get(executionId);
+    }
+    /**
+     * Update workflow status
+     */
+    updateWorkflowStatus(executionId, status, error) {
+        const state = this.states.get(executionId);
+        if (!state) {
+            throw new Error(`Workflow execution ${executionId} not found`);
+        }
+        const now = Date.now();
+        state.status = status;
+        state.updatedAt = now;
+        if (status === WorkflowStatus.RUNNING && !state.startedAt) {
+            state.startedAt = now;
+        }
+        if (this.isTerminalStatus(status) && !state.finishedAt) {
+            state.finishedAt = now;
+            if (state.startedAt) {
+                state.duration = state.finishedAt - state.startedAt;
+            }
+        }
+        if (error) {
+            state.error = error;
+        }
+    }
+    /**
+     * Update step status
+     */
+    updateStepStatus(executionId, stepId, status, data) {
+        const state = this.states.get(executionId);
+        if (!state) {
+            throw new Error(`Workflow execution ${executionId} not found`);
+        }
+        const stepState = state.steps[stepId];
+        if (!stepState) {
+            throw new Error(`Step ${stepId} not found in execution ${executionId}`);
+        }
+        const now = Date.now();
+        stepState.status = status;
+        stepState.updatedAt = now;
+        // Track start time
+        if (status === StepStatus.RUNNING && !stepState.startTime) {
+            stepState.startTime = now;
+        }
+        // Track end time and duration
+        if (this.isTerminalStepStatus(status) && !stepState.endTime) {
+            stepState.endTime = now;
+            if (stepState.startTime) {
+                stepState.duration = stepState.endTime - stepState.startTime;
+            }
+        }
+        // Update attempts
+        if (data?.attempts !== undefined) {
+            stepState.attempts = data.attempts;
+        }
+        // Store error
+        if (data?.error) {
+            stepState.error = data.error;
+        }
+        // Store output
+        if (data?.output !== undefined) {
+            stepState.output = data.output;
+        }
+        // Update workflow metadata counts
+        this.updateWorkflowMetadata(state);
+    }
+    /**
+     * Get step state
+     */
+    getStepState(executionId, stepId) {
+        const state = this.states.get(executionId);
+        return state?.steps[stepId];
+    }
+    /**
+     * Check if step has completed (success or terminal failure)
+     */
+    isStepCompleted(executionId, stepId) {
+        const stepState = this.getStepState(executionId, stepId);
+        if (!stepState)
+            return false;
+        return this.isTerminalStepStatus(stepState.status);
+    }
+    /**
+     * Check if step succeeded
+     */
+    isStepSuccessful(executionId, stepId) {
+        const stepState = this.getStepState(executionId, stepId);
+        return stepState?.status === StepStatus.SUCCESS;
+    }
+    /**
+     * Get all failed steps
+     */
+    getFailedSteps(executionId) {
+        const state = this.states.get(executionId);
+        if (!state)
+            return [];
+        return Object.values(state.steps).filter(step => step.status === StepStatus.FAILED || step.status === StepStatus.TIMEOUT);
+    }
+    /**
+     * Get all completed steps
+     */
+    getCompletedSteps(executionId) {
+        const state = this.states.get(executionId);
+        if (!state)
+            return [];
+        return Object.values(state.steps).filter(step => this.isTerminalStepStatus(step.status));
+    }
+    /**
+     * Clear execution state (cleanup)
+     */
+    clearState(executionId) {
+        return this.states.delete(executionId);
+    }
+    /**
+     * Get all execution IDs
+     */
+    getAllExecutionIds() {
+        return Array.from(this.states.keys());
+    }
+    /**
+     * Check if status is terminal (workflow)
+     */
+    isTerminalStatus(status) {
+        return [
+            WorkflowStatus.COMPLETED,
+            WorkflowStatus.FAILED,
+            WorkflowStatus.PARTIAL,
+            WorkflowStatus.TIMEOUT,
+            WorkflowStatus.CANCELLED,
+        ].includes(status);
+    }
+    /**
+     * Check if status is terminal (step)
+     */
+    isTerminalStepStatus(status) {
+        return [
+            StepStatus.SUCCESS,
+            StepStatus.FAILED,
+            StepStatus.TIMEOUT,
+            StepStatus.CANCELLED,
+            StepStatus.SKIPPED,
+        ].includes(status);
+    }
+    /**
+     * Update workflow metadata counts based on step states
+     */
+    updateWorkflowMetadata(state) {
+        const steps = Object.values(state.steps);
+        state.metadata.completedSteps = steps.filter(s => s.status === StepStatus.SUCCESS).length;
+        state.metadata.failedSteps = steps.filter(s => s.status === StepStatus.FAILED || s.status === StepStatus.TIMEOUT).length;
+        state.metadata.skippedSteps = steps.filter(s => s.status === StepStatus.SKIPPED).length;
+    }
+}
+//# sourceMappingURL=ExecutionState.js.map

package/dist/state/ExecutionState.js.map

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

package/dist/state/StateMachine.d.ts

@@ -0,0 +1,120 @@
+/**
+ * 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';
+/**
+ * State transition record for audit trail
+ */
+export interface StateTransition<T> {
+    /** State before transition */
+    readonly from: T;
+    /** State after transition */
+    readonly to: T;
+    /** Timestamp of transition (ms since epoch) */
+    readonly timestamp: number;
+    /** Optional reason for transition */
+    readonly reason?: string;
+}
+/**
+ * State machine configuration
+ */
+export interface StateMachineConfig<T> {
+    /** Initial state */
+    readonly initialState: T;
+    /** Valid transitions map: from → allowed to states */
+    readonly transitions: ReadonlyMap<T, readonly T[]>;
+    /** Terminal states (no further transitions allowed) */
+    readonly terminalStates: ReadonlySet<T>;
+}
+/**
+ * Generic state machine for enforcing valid transitions
+ */
+export declare class StateMachine<T> {
+    private currentState;
+    private readonly config;
+    private readonly history;
+    constructor(config: StateMachineConfig<T>);
+    /**
+     * Get current state
+     */
+    getState(): T;
+    /**
+     * Check if transition is valid
+     */
+    canTransition(to: T): boolean;
+    /**
+     * Perform state transition
+     *
+     * @param to - Target state
+     * @param reason - Optional reason for transition
+     * @throws Error if transition is invalid
+     */
+    transition(to: T, reason?: string): void;
+    /**
+     * Check if current state is terminal
+     */
+    isTerminal(): boolean;
+    /**
+     * Get allowed transitions from current state
+     */
+    getAllowedTransitions(): readonly T[];
+    /**
+     * Get transition history
+     */
+    getHistory(): readonly StateTransition<T>[];
+    /**
+     * Reset to initial state (for testing/recovery)
+     */
+    reset(): void;
+}
+/**
+ * Create step state machine
+ */
+export declare function createStepStateMachine(): StateMachine<StepStatus>;
+/**
+ * Create workflow state machine
+ */
+export declare function createWorkflowStateMachine(): StateMachine<WorkflowStatus>;
+/**
+ * Validate step state transition
+ * Throws if invalid
+ */
+export declare function validateStepTransition(from: StepStatus, to: StepStatus): void;
+/**
+ * Validate workflow state transition
+ * Throws if invalid
+ */
+export declare function validateWorkflowTransition(from: WorkflowStatus, to: WorkflowStatus): void;
+/**
+ * Check if step status is terminal
+ */
+export declare function isStepTerminal(status: StepStatus): boolean;
+/**
+ * Check if workflow status is terminal
+ */
+export declare function isWorkflowTerminal(status: WorkflowStatus): boolean;
+/**
+ * Get allowed transitions from a step state
+ */
+export declare function getStepTransitions(from: StepStatus): readonly StepStatus[];
+/**
+ * Get allowed transitions from a workflow state
+ */
+export declare function getWorkflowTransitions(from: WorkflowStatus): readonly WorkflowStatus[];
+//# sourceMappingURL=StateMachine.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"StateMachine.d.ts","sourceRoot":"","sources":["../../src/state/StateMachine.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAEjE;;GAEG;AACH,MAAM,WAAW,eAAe,CAAC,CAAC;IAChC,8BAA8B;IAC9B,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC;IACjB,6BAA6B;IAC7B,QAAQ,CAAC,EAAE,EAAE,CAAC,CAAC;IACf,+CAA+C;IAC/C,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,qCAAqC;IACrC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB,CAAC,CAAC;IACnC,oBAAoB;IACpB,QAAQ,CAAC,YAAY,EAAE,CAAC,CAAC;IACzB,sDAAsD;IACtD,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAC,CAAC,EAAE,SAAS,CAAC,EAAE,CAAC,CAAC;IACnD,uDAAuD;IACvD,QAAQ,CAAC,cAAc,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC;CACzC;AAED;;GAEG;AACH,qBAAa,YAAY,CAAC,CAAC;IACzB,OAAO,CAAC,YAAY,CAAI;IACxB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAwB;IAC/C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA4B;gBAExC,MAAM,EAAE,kBAAkB,CAAC,CAAC,CAAC;IAKzC;;OAEG;IACH,QAAQ,IAAI,CAAC;IAIb;;OAEG;IACH,aAAa,CAAC,EAAE,EAAE,CAAC,GAAG,OAAO;IAc7B;;;;;;OAMG;IACH,UAAU,CAAC,EAAE,EAAE,CAAC,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI;IAmBxC;;OAEG;IACH,UAAU,IAAI,OAAO;IAIrB;;OAEG;IACH,qBAAqB,IAAI,SAAS,CAAC,EAAE;IAIrC;;OAEG;IACH,UAAU,IAAI,SAAS,eAAe,CAAC,CAAC,CAAC,EAAE;IAI3C;;OAEG;IACH,KAAK,IAAI,IAAI;CAId;AAuED;;GAEG;AACH,wBAAgB,sBAAsB,IAAI,YAAY,CAAC,UAAU,CAAC,CAMjE;AAED;;GAEG;AACH,wBAAgB,0BAA0B,IAAI,YAAY,CAAC,cAAc,CAAC,CAMzE;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,UAAU,EAChB,EAAE,EAAE,UAAU,GACb,IAAI,CAQN;AAED;;;GAGG;AACH,wBAAgB,0BAA0B,CACxC,IAAI,EAAE,cAAc,EACpB,EAAE,EAAE,cAAc,GACjB,IAAI,CAQN;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAE1D;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAElE;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,UAAU,GAAG,SAAS,UAAU,EAAE,CAE1E;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,cAAc,GAAG,SAAS,cAAc,EAAE,CAEtF"}