@orbytautomation/engine 0.1.0

package/dist/automation/runtime/index.js.map

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

package/dist/context/ContextStore.d.ts

@@ -0,0 +1,185 @@
+/**
+ * Context Store
+ *
+ * Manages execution context state during workflow runtime.
+ * Stores variables, step outputs, and execution metadata.
+ *
+ * @module context
+ */
+import type { ResolutionContext } from './VariableResolver.js';
+/**
+ * Execution context configuration
+ */
+export interface ContextConfig {
+    /** Execution ID */
+    executionId: string;
+    /** Workflow ID */
+    workflowId: string;
+    /** Workflow name */
+    workflowName: string;
+    /** Workflow version */
+    version?: string;
+    /** Workflow description */
+    description?: string;
+    /** Workflow tags */
+    tags?: string[];
+    /** Workflow owner */
+    owner?: string;
+    /** Runtime inputs */
+    inputs?: Record<string, any>;
+    /** Resolved secrets */
+    secrets?: Record<string, any>;
+    /** Environment variables */
+    env?: Record<string, any>;
+    /** Workflow metadata */
+    metadata?: {
+        createdAt?: string;
+        updatedAt?: string;
+        annotations?: Record<string, any>;
+    };
+    /** Additional context */
+    context?: Record<string, any>;
+    /** Triggered by (user, system, schedule) */
+    triggeredBy?: string;
+}
+/**
+ * Context Store
+ * Thread-safe context management for workflow execution
+ */
+export declare class ContextStore {
+    private executionId;
+    private workflowId;
+    private workflowName;
+    private version?;
+    private description?;
+    private tags?;
+    private owner?;
+    private env;
+    private inputs;
+    private secrets;
+    private stepOutputs;
+    private customContext;
+    private metadata?;
+    private attempt;
+    private startTime;
+    private triggeredBy?;
+    constructor(config: ContextConfig);
+    /**
+     * Get resolution context for variable resolver
+     */
+    getResolutionContext(): ResolutionContext;
+    /**
+     * Store step output
+     */
+    setStepOutput(stepId: string, output: any): void;
+    /**
+     * Get step output by ID
+     */
+    getStepOutput(stepId: string): any;
+    /**
+     * Get all step outputs
+     */
+    getAllStepOutputs(): Map<string, any>;
+    /**
+     * Set input  variable
+     */
+    setInput(key: string, value: any): void;
+    /**
+     * Get input variable
+     */
+    getInput(key: string): any;
+    /**
+     * Get all inputs
+     */
+    getAllInputs(): Record<string, any>;
+    /**
+     * Set secret value
+     */
+    setSecret(key: string, value: any): void;
+    /**
+     * Get secret value
+     */
+    getSecret(key: string): any;
+    /**
+     * Set environment variable
+     */
+    setEnv(key: string, value: any): void;
+    /**
+     * Get environment variable
+     */
+    getEnv(key: string): any;
+    /**
+     * Set custom context data
+     */
+    setContext(key: string, value: any): void;
+    /**
+     * Get custom context data
+     */
+    getContext(key: string): any;
+    /**
+     * Increment retry attempt counter
+     */
+    incrementAttempt(): void;
+    /**
+     * Get current attempt number
+     */
+    getAttempt(): number;
+    /**
+     * Get execution metadata
+     */
+    getMetadata(): {
+        executionId: string;
+        workflowId: string;
+        workflowName: string;
+        version: string | undefined;
+        description: string | undefined;
+        tags: string[] | undefined;
+        owner: string | undefined;
+        attempt: number;
+        startTime: Date;
+        elapsedMs: number;
+        triggeredBy: string | undefined;
+    };
+    /**
+     * Clear all step outputs (useful for retry scenarios)
+     */
+    clearStepOutputs(): void;
+    /**
+     * Create a snapshot of current context state
+     */
+    snapshot(): {
+        executionId: string;
+        workflowId: string;
+        workflowName: string;
+        version: string | undefined;
+        description: string | undefined;
+        tags: string[] | undefined;
+        owner: string | undefined;
+        env: {
+            [x: string]: any;
+        };
+        inputs: {
+            [x: string]: any;
+        };
+        secrets: {
+            [x: string]: any;
+        };
+        stepOutputs: Map<string, any>;
+        customContext: {
+            [x: string]: any;
+        };
+        metadata: {
+            createdAt?: string;
+            updatedAt?: string;
+            annotations?: Record<string, any>;
+        } | undefined;
+        attempt: number;
+        startTime: Date;
+        triggeredBy: string | undefined;
+    };
+    /**
+     * Restore context from snapshot
+     */
+    restore(snapshot: ReturnType<ContextStore['snapshot']>): void;
+}
+//# sourceMappingURL=ContextStore.d.ts.map

package/dist/context/ContextStore.d.ts.map

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

package/dist/context/ContextStore.js

@@ -0,0 +1,228 @@
+/**
+ * Context Store
+ *
+ * Manages execution context state during workflow runtime.
+ * Stores variables, step outputs, and execution metadata.
+ *
+ * @module context
+ */
+/**
+ * Context Store
+ * Thread-safe context management for workflow execution
+ */
+export class ContextStore {
+    executionId;
+    workflowId;
+    workflowName;
+    version;
+    description;
+    tags;
+    owner;
+    env;
+    inputs;
+    secrets;
+    stepOutputs = new Map();
+    customContext;
+    metadata;
+    attempt;
+    startTime;
+    triggeredBy;
+    constructor(config) {
+        this.executionId = config.executionId;
+        this.workflowId = config.workflowId;
+        this.workflowName = config.workflowName;
+        this.version = config.version;
+        this.description = config.description;
+        this.tags = config.tags;
+        this.owner = config.owner;
+        this.env = config.env || {};
+        this.inputs = config.inputs || {};
+        this.secrets = config.secrets || {};
+        this.customContext = config.context || {};
+        this.metadata = config.metadata;
+        this.attempt = 1;
+        this.startTime = new Date();
+        this.triggeredBy = config.triggeredBy;
+    }
+    /**
+     * Get resolution context for variable resolver
+     */
+    getResolutionContext() {
+        return {
+            env: this.env,
+            steps: this.stepOutputs,
+            workflow: {
+                id: this.workflowId,
+                name: this.workflowName,
+                version: this.version,
+                description: this.description,
+                tags: this.tags,
+                owner: this.owner,
+            },
+            run: {
+                id: this.executionId,
+                timestamp: this.startTime,
+                attempt: this.attempt,
+                startedAt: this.startTime,
+                triggeredBy: this.triggeredBy,
+            },
+            inputs: this.inputs,
+            secrets: this.secrets,
+            context: this.customContext,
+            metadata: this.metadata,
+        };
+    }
+    /**
+     * Store step output
+     */
+    setStepOutput(stepId, output) {
+        this.stepOutputs.set(stepId, output);
+    }
+    /**
+     * Get step output by ID
+     */
+    getStepOutput(stepId) {
+        return this.stepOutputs.get(stepId);
+    }
+    /**
+     * Get all step outputs
+     */
+    getAllStepOutputs() {
+        return new Map(this.stepOutputs);
+    }
+    /**
+     * Set input  variable
+     */
+    setInput(key, value) {
+        this.inputs[key] = value;
+    }
+    /**
+     * Get input variable
+     */
+    getInput(key) {
+        return this.inputs[key];
+    }
+    /**
+     * Get all inputs
+     */
+    getAllInputs() {
+        return { ...this.inputs };
+    }
+    /**
+     * Set secret value
+     */
+    setSecret(key, value) {
+        this.secrets[key] = value;
+    }
+    /**
+     * Get secret value
+     */
+    getSecret(key) {
+        return this.secrets[key];
+    }
+    /**
+     * Set environment variable
+     */
+    setEnv(key, value) {
+        this.env[key] = value;
+    }
+    /**
+     * Get environment variable
+     */
+    getEnv(key) {
+        return this.env[key];
+    }
+    /**
+     * Set custom context data
+     */
+    setContext(key, value) {
+        this.customContext[key] = value;
+    }
+    /**
+     * Get custom context data
+     */
+    getContext(key) {
+        return this.customContext[key];
+    }
+    /**
+     * Increment retry attempt counter
+     */
+    incrementAttempt() {
+        this.attempt++;
+    }
+    /**
+     * Get current attempt number
+     */
+    getAttempt() {
+        return this.attempt;
+    }
+    /**
+     * Get execution metadata
+     */
+    getMetadata() {
+        return {
+            executionId: this.executionId,
+            workflowId: this.workflowId,
+            workflowName: this.workflowName,
+            version: this.version,
+            description: this.description,
+            tags: this.tags,
+            owner: this.owner,
+            attempt: this.attempt,
+            startTime: this.startTime,
+            elapsedMs: Date.now() - this.startTime.getTime(),
+            triggeredBy: this.triggeredBy,
+        };
+    }
+    /**
+     * Clear all step outputs (useful for retry scenarios)
+     */
+    clearStepOutputs() {
+        this.stepOutputs.clear();
+    }
+    /**
+     * Create a snapshot of current context state
+     */
+    snapshot() {
+        return {
+            executionId: this.executionId,
+            workflowId: this.workflowId,
+            workflowName: this.workflowName,
+            version: this.version,
+            description: this.description,
+            tags: this.tags ? [...this.tags] : undefined,
+            owner: this.owner,
+            env: { ...this.env },
+            inputs: { ...this.inputs },
+            secrets: { ...this.secrets },
+            stepOutputs: new Map(this.stepOutputs),
+            customContext: { ...this.customContext },
+            metadata: this.metadata ? { ...this.metadata } : undefined,
+            attempt: this.attempt,
+            startTime: new Date(this.startTime),
+            triggeredBy: this.triggeredBy,
+        };
+    }
+    /**
+     * Restore context from snapshot
+     */
+    restore(snapshot) {
+        this.executionId = snapshot.executionId;
+        this.workflowId = snapshot.workflowId;
+        this.workflowName = snapshot.workflowName;
+        this.version = snapshot.version;
+        this.description = snapshot.description;
+        this.tags = snapshot.tags ? [...snapshot.tags] : undefined;
+        this.owner = snapshot.owner;
+        this.env = { ...snapshot.env };
+        this.inputs = { ...snapshot.inputs };
+        this.secrets = { ...snapshot.secrets };
+        this.stepOutputs = new Map(snapshot.stepOutputs);
+        this.customContext = { ...snapshot.customContext };
+        this.metadata = snapshot.metadata ? { ...snapshot.metadata } : undefined;
+        this.attempt = snapshot.attempt;
+        this.startTime = new Date(snapshot.startTime);
+        this.triggeredBy = snapshot.triggeredBy;
+    }
+}
+//# sourceMappingURL=ContextStore.js.map

package/dist/context/ContextStore.js.map

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

package/dist/context/VariableResolver.d.ts

@@ -0,0 +1,184 @@
+/**
+ * Variable Resolution Engine
+ *
+ * Resolves variables in workflow step inputs at runtime.
+ * Supports multiple variable sources aligned with workflow schema.
+ *
+ * Syntax: ${source.path.to.value}
+ *
+ * Supported sources:
+ * - env: Environment variables
+ * - steps: Step outputs
+ * - workflow: Workflow metadata
+ * - run: Execution metadata
+ * - context: Runtime context
+ * - inputs: Workflow inputs
+ * - secrets: Secret references (resolved externally)
+ * - metadata: Workflow metadata fields
+ *
+ * Future sources (placeholders):
+ * - telemetry: Telemetry data
+ * - resources: Resource information
+ * - compliance: Compliance metadata
+ *
+ * Advanced features:
+ * - Default values: ${env.token || "default"}
+ * - Built-in functions:
+ *   - Time: ${now()}, ${uuid()}, ${timestamp()}
+ *   - Context-aware: ${workflowId()}, ${workflowName()}, ${runId()}, ${attempt()}, ${triggeredBy()}
+ * - Type-aware: ${steps.count} returns number, not string
+ * - Math expressions: FUTURE (${steps.a + steps.b})
+ *
+ * @module context
+ */
+/**
+ * Runtime context for variable resolution
+ */
+export interface ResolutionContext {
+    /** Global environment variables */
+    env: Record<string, any>;
+    /** Step outputs (stepId -> output data) */
+    steps: Map<string, any>;
+    /** Workflow metadata */
+    workflow: {
+        id: string;
+        name: string;
+        version?: string;
+        description?: string;
+        tags?: string[];
+        owner?: string;
+    };
+    /** Current run information */
+    run: {
+        id: string;
+        timestamp: Date;
+        attempt: number;
+        startedAt?: Date;
+        triggeredBy?: string;
+    };
+    /** Workflow inputs (runtime parameters) */
+    inputs?: Record<string, any>;
+    /** Resolved secrets (name -> value) */
+    secrets?: Record<string, any>;
+    /** Additional runtime context */
+    context?: Record<string, any>;
+    /** Workflow metadata (extended) */
+    metadata?: {
+        createdAt?: string;
+        updatedAt?: string;
+        annotations?: Record<string, any>;
+    };
+    /** Telemetry data (future) */
+    telemetry?: Record<string, any>;
+    /** Resource information (future) */
+    resources?: Record<string, any>;
+    /** Compliance metadata (future) */
+    compliance?: Record<string, any>;
+}
+/**
+ * Variable resolver engine
+ */
+export declare class VariableResolver {
+    /** Maximum recursion depth to prevent infinite loops */
+    private readonly maxDepth;
+    /**
+     * Resolve all variables in the input value
+     *
+     * @param input - Input value (can be string, object, array, or primitive)
+     * @param ctx - Resolution context
+     * @param depth - Current recursion depth (internal)
+     * @returns Input with all variables resolved
+     */
+    resolve(input: any, ctx: ResolutionContext, depth?: number): any;
+    /**
+     * Resolve variables in a string
+     *
+     * Supports:
+     *   - Full replacement: "${env.apiKey}" -> actual value
+     *   - Inline replacement: "URL: ${env.baseUrl}/api" -> "URL: https://api.com/api"
+     *   - Default values: "${env.token || 'default'}" -> uses default if token undefined
+     *   - Built-in functions: "${now()}" -> current timestamp
+     *
+     * @param str - String potentially containing variables
+     * @param ctx - Resolution context
+     * @param depth - Current recursion depth
+     * @returns String with variables resolved
+     */
+    private resolveString;
+    /**
+     * Evaluate expression (supports default values and functions)
+     *
+     * Examples:
+     *   - env.apiKey -> lookup('env.apiKey')
+     *   - env.token || "default" -> lookup with fallback
+     *   - now() -> built-in function
+     *
+     * @param expression - Expression to evaluate
+     * @param ctx - Resolution context
+     * @param depth - Current recursion depth
+     * @returns Evaluated value
+     */
+    private evaluateExpression;
+    /**
+     * Call a built-in function
+     *
+     * Supported functions:
+     *   - now() -> current ISO timestamp
+     *   - uuid() -> random UUID v4
+     *   - timestamp() -> current Unix timestamp (milliseconds)
+     *   - workflowId() -> current workflow ID from context
+     *   - workflowName() -> current workflow name from context
+     *   - runId() -> current execution run ID from context
+     *   - attempt() -> current execution attempt number from context
+     *   - triggeredBy() -> who/what triggered the workflow from context
+     *
+     * @param funcName - Function name
+     * @param ctx - Resolution context for context-aware functions
+     * @returns Function result
+     */
+    private callBuiltInFunction;
+    /**
+     * Lookup variable value from context
+     *
+     * Supports:
+     *   - ${env.apiKey} -> ctx.env.apiKey
+     *   - ${steps.resize.output.url} -> ctx.steps.get('resize').output.url
+     *   - ${workflow.name} -> ctx.workflow.name
+     *   - ${run.id} -> ctx.run.id
+     *   - ${inputs.userId} -> ctx.inputs.userId
+     *   - ${secrets.apiKey} -> ctx.secrets.apiKey
+     *   - ${metadata.createdAt} -> ctx.metadata.createdAt
+     *   - ${context.customValue} -> ctx.context.customValue
+     *   - ${telemetry.*} -> Future placeholder
+     *   - ${resources.*} -> Future placeholder
+     *   - ${compliance.*} -> Future placeholder
+     *
+     * @param expression - Variable expression (without ${ })
+     * @param ctx - Resolution context
+     * @returns Resolved value or undefined
+     */
+    private lookup;
+    /**
+     * Check if a string contains variables
+     *
+     * @param str - String to check
+     * @returns True if string contains ${...} patterns
+     */
+    static hasVariables(str: string): boolean;
+    /**
+     * Extract all variable expressions from a string
+     *
+     * @param str - String to analyze
+     * @returns Array of variable expressions (without ${ })
+     */
+    static extractVariables(str: string): string[];
+    /**
+     * Validate that all referenced steps exist
+     *
+     * @param input - Input to validate
+     * @param availableSteps - Set of available step IDs
+     * @throws {Error} If referenced step doesn't exist
+     */
+    static validateStepReferences(input: any, availableSteps: Set<string>): void;
+}
+//# sourceMappingURL=VariableResolver.d.ts.map

package/dist/context/VariableResolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"VariableResolver.d.ts","sourceRoot":"","sources":["../../src/context/VariableResolver.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AAIH;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,mCAAmC;IACnC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAEzB,2CAA2C;IAC3C,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAExB,wBAAwB;IACxB,QAAQ,EAAE;QACR,EAAE,EAAE,MAAM,CAAC;QACX,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;QAChB,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,CAAC;IAEF,8BAA8B;IAC9B,GAAG,EAAE;QACH,EAAE,EAAE,MAAM,CAAC;QACX,SAAS,EAAE,IAAI,CAAC;QAChB,OAAO,EAAE,MAAM,CAAC;QAChB,SAAS,CAAC,EAAE,IAAI,CAAC;QACjB,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB,CAAC;IAEF,2CAA2C;IAC3C,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAE7B,uCAAuC;IACvC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAE9B,iCAAiC;IACjC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAE9B,mCAAmC;IACnC,QAAQ,CAAC,EAAE;QACT,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;KACnC,CAAC;IAGF,8BAA8B;IAC9B,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAEhC,oCAAoC;IACpC,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAEhC,mCAAmC;IACnC,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAClC;AAED;;GAEG;AACH,qBAAa,gBAAgB;IAC3B,wDAAwD;IACxD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAM;IAE/B;;;;;;;OAOG;IACH,OAAO,CAAC,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE,iBAAiB,EAAE,KAAK,GAAE,MAAU,GAAG,GAAG;IAoCnE;;;;;;;;;;;;;OAaG;IACH,OAAO,CAAC,aAAa;IAgBrB;;;;;;;;;;;;OAYG;IACH,OAAO,CAAC,kBAAkB;IAyC1B;;;;;;;;;;;;;;;;OAgBG;IACH,OAAO,CAAC,mBAAmB;IAyC3B;;;;;;;;;;;;;;;;;;;OAmBG;IACH,OAAO,CAAC,MAAM;IAyGd;;;;;OAKG;IACH,MAAM,CAAC,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAIzC;;;;;OAKG;IACH,MAAM,CAAC,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE;IAY9C;;;;;;OAMG;IACH,MAAM,CAAC,sBAAsB,CAC3B,KAAK,EAAE,GAAG,EACV,cAAc,EAAE,GAAG,CAAC,MAAM,CAAC,GAC1B,IAAI;CAyBR"}