@marktoflow/core 2.0.0-alpha.12

package/dist/engine.d.ts

@@ -0,0 +1,243 @@
+/**
+ * Workflow Execution Engine for marktoflow v2.0
+ *
+ * Executes workflow steps with retry logic, variable resolution,
+ * and SDK invocation.
+ */
+import { Workflow, WorkflowStep, ExecutionContext, StepResult, WorkflowResult } from './models.js';
+import { type EffectivePermissions, type SecurityPolicy } from './permissions.js';
+import { StateStore } from './state.js';
+import { AgentHealthTracker, type FailoverConfig, type FailoverEvent } from './failover.js';
+import { RollbackRegistry } from './rollback.js';
+export interface EngineConfig {
+    /** Default timeout for steps in milliseconds */
+    defaultTimeout?: number;
+    /** Maximum retries for failed steps */
+    maxRetries?: number;
+    /** Base delay for retry backoff in milliseconds */
+    retryBaseDelay?: number;
+    /** Maximum delay for retry backoff in milliseconds */
+    retryMaxDelay?: number;
+    /** Optional rollback registry for rollback error handling */
+    rollbackRegistry?: RollbackRegistry;
+    /** Failover configuration for step execution */
+    failoverConfig?: Partial<FailoverConfig>;
+    /** Optional agent health tracker */
+    healthTracker?: AgentHealthTracker;
+    /** Default agent for AI steps */
+    defaultAgent?: string;
+    /** Default model for AI steps */
+    defaultModel?: string;
+}
+export interface SDKRegistryLike {
+    /** Load an SDK by name */
+    load(sdkName: string): Promise<unknown>;
+    /** Check if SDK is available */
+    has(sdkName: string): boolean;
+}
+export interface StepExecutorContext {
+    /** Effective model for this step (from step override or workflow default) */
+    model: string | undefined;
+    /** Effective agent for this step (from step override or workflow default) */
+    agent: string | undefined;
+    /** Effective permissions for this step */
+    permissions: EffectivePermissions | undefined;
+    /** Security policy derived from permissions */
+    securityPolicy: SecurityPolicy | undefined;
+    /** Base path for resolving relative paths */
+    basePath: string | undefined;
+}
+export type StepExecutor = (step: WorkflowStep, context: ExecutionContext, sdkRegistry: SDKRegistryLike, executorContext?: StepExecutorContext) => Promise<unknown>;
+export interface EngineEvents {
+    onStepStart?: (step: WorkflowStep, context: ExecutionContext) => void;
+    onStepComplete?: (step: WorkflowStep, result: StepResult) => void;
+    onStepError?: (step: WorkflowStep, error: Error, retryCount: number) => void;
+    onWorkflowStart?: (workflow: Workflow, context: ExecutionContext) => void;
+    onWorkflowComplete?: (workflow: Workflow, result: WorkflowResult) => void;
+}
+export declare class RetryPolicy {
+    readonly maxRetries: number;
+    readonly baseDelay: number;
+    readonly maxDelay: number;
+    readonly exponentialBase: number;
+    readonly jitter: number;
+    constructor(maxRetries?: number, baseDelay?: number, maxDelay?: number, exponentialBase?: number, jitter?: number);
+    /**
+     * Calculate delay for a given retry attempt.
+     */
+    getDelay(attempt: number): number;
+}
+export type CircuitState = 'CLOSED' | 'OPEN' | 'HALF_OPEN';
+export declare class CircuitBreaker {
+    readonly failureThreshold: number;
+    readonly recoveryTimeout: number;
+    readonly halfOpenMaxCalls: number;
+    private state;
+    private failures;
+    private lastFailureTime;
+    private halfOpenCalls;
+    constructor(failureThreshold?: number, recoveryTimeout?: number, halfOpenMaxCalls?: number);
+    canExecute(): boolean;
+    recordSuccess(): void;
+    recordFailure(): void;
+    getState(): CircuitState;
+    reset(): void;
+}
+/**
+ * Resolve template variables in a value.
+ * Supports {{variable}} and {{inputs.name}} syntax.
+ */
+export declare function resolveTemplates(value: unknown, context: ExecutionContext): unknown;
+/**
+ * Resolve a variable path from context.
+ * First checks inputs.*, then variables, then stepMetadata, then direct context properties.
+ * Exported to allow access from condition evaluation.
+ */
+export declare function resolveVariablePath(path: string, context: ExecutionContext): unknown;
+export declare class WorkflowEngine {
+    private config;
+    private retryPolicy;
+    private circuitBreakers;
+    private events;
+    private stateStore?;
+    private rollbackRegistry?;
+    private failoverConfig;
+    private healthTracker;
+    private failoverEvents;
+    private workflowPath?;
+    private workflowPermissions?;
+    private promptCache;
+    constructor(config?: EngineConfig, events?: EngineEvents, stateStore?: StateStore);
+    /**
+     * Execute a single step - dispatcher to specialized execution methods.
+     */
+    private executeStep;
+    /**
+     * Execute a workflow.
+     */
+    execute(workflow: Workflow, inputs: Record<string, unknown> | undefined, sdkRegistry: SDKRegistryLike, stepExecutor: StepExecutor): Promise<WorkflowResult>;
+    /**
+     * Execute a workflow from a file.
+     * This method automatically sets the workflow path for resolving sub-workflows.
+     */
+    executeFile(workflowPath: string, inputs: Record<string, unknown> | undefined, sdkRegistry: SDKRegistryLike, stepExecutor: StepExecutor): Promise<WorkflowResult>;
+    getFailoverHistory(): FailoverEvent[];
+    /**
+     * Execute a sub-workflow.
+     */
+    private executeSubWorkflow;
+    /**
+     * Execute a sub-workflow using an AI sub-agent.
+     * The agent interprets the workflow and executes it autonomously.
+     */
+    private executeSubWorkflowWithAgent;
+    /**
+     * Build the default system prompt for sub-agent execution.
+     */
+    private buildDefaultSubagentSystemPrompt;
+    /**
+     * Build the prompt for sub-agent workflow execution.
+     */
+    private buildSubagentPrompt;
+    /**
+     * Parse the sub-agent's response to extract completion status and output.
+     */
+    private parseSubagentResponse;
+    /**
+     * Build the step executor context with effective model/agent/permissions.
+     */
+    private buildStepExecutorContext;
+    /**
+     * Load and resolve an external prompt file for a step.
+     */
+    private loadAndResolvePrompt;
+    /**
+     * Execute a step with retry logic.
+     */
+    private executeStepWithRetry;
+    /**
+     * Execute a step with retry + failover support.
+     */
+    private executeStepWithFailover;
+    /**
+     * Execute a function with a timeout.
+     */
+    private executeWithTimeout;
+    /**
+     * Evaluate step conditions.
+     */
+    private evaluateConditions;
+    /**
+     * Evaluate a single condition.
+     * Supports: ==, !=, >, <, >=, <=
+     * Also supports nested property access (e.g., check_result.success)
+     * and step status checks (e.g., step_id.status == 'failed')
+     */
+    private evaluateCondition;
+    /**
+     * Resolve a condition value with support for nested properties.
+     * Handles direct variable references and nested paths.
+     */
+    private resolveConditionValue;
+    /**
+     * Parse a value from a condition string.
+     */
+    private parseValue;
+    /**
+     * Build the final workflow result.
+     */
+    private buildWorkflowResult;
+    /**
+     * Reset all circuit breakers.
+     */
+    resetCircuitBreakers(): void;
+    /**
+     * Execute an if/else conditional step.
+     */
+    private executeIfStep;
+    /**
+     * Execute a switch/case step.
+     */
+    private executeSwitchStep;
+    /**
+     * Execute a for-each loop step.
+     */
+    private executeForEachStep;
+    /**
+     * Execute a while loop step.
+     */
+    private executeWhileStep;
+    /**
+     * Execute a map transformation step.
+     */
+    private executeMapStep;
+    /**
+     * Execute a filter step.
+     */
+    private executeFilterStep;
+    /**
+     * Execute a reduce/aggregate step.
+     */
+    private executeReduceStep;
+    /**
+     * Execute parallel branches.
+     */
+    private executeParallelStep;
+    /**
+     * Execute try/catch/finally step.
+     */
+    private executeTryStep;
+    /**
+     * Clone execution context for parallel branches.
+     */
+    private cloneContext;
+    /**
+     * Merge branch context back into main context.
+     */
+    private mergeContexts;
+    /**
+     * Execute promises with concurrency limit.
+     */
+    private executeConcurrentlyWithLimit;
+}
+//# sourceMappingURL=engine.d.ts.map

package/dist/engine.d.ts.map

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