ts-workflow-engine-lite 2.1.0

package/dist/src/engine/SubworkflowExecutor.js

@@ -0,0 +1,157 @@
+import { hookManager } from "../event/HookManager.js";
+import { parseEnvInt } from "../utils/env.js";
+import { Logger } from "../utils/Logger.js";
+import { getNestedValue } from "./ExpressionEvaluator.js";
+function getMaxSubworkflowDepth() {
+    return parseEnvInt(process.env.MAX_SUBWORKFLOW_DEPTH, 10, { min: 1 });
+}
+export class SubworkflowExecutor {
+    startWorkflow;
+    getInstanceStatus;
+    constructor(startWorkflow, getInstanceStatus) {
+        this.startWorkflow = startWorkflow;
+        this.getInstanceStatus = getInstanceStatus;
+    }
+    async execute(node, parentInstance) {
+        if (!node.subworkflowId) {
+            throw new Error("Subworkflow node missing subworkflowId");
+        }
+        const subworkflowContext = this.buildSubworkflowContext(node.subworkflowInput || {}, parentInstance.context);
+        subworkflowContext.__parentInstanceId = parentInstance.instanceId;
+        subworkflowContext.__parentWorkflowId = parentInstance.workflowId;
+        const parentDepth = typeof parentInstance.context?.__subworkflowDepth === "number"
+            ? parentInstance.context.__subworkflowDepth
+            : 0;
+        const depth = parentDepth + 1;
+        const maxDepth = getMaxSubworkflowDepth();
+        if (depth > maxDepth) {
+            Logger.error(parentInstance.instanceId, node.id, `Subworkflow depth limit exceeded (${maxDepth}) for ${node.subworkflowId} at depth ${depth}`);
+            throw new Error(`Subworkflow depth limit exceeded (${maxDepth}) at node ${node.id}; ` +
+                `check for a self-referencing or cyclic subworkflow chain`);
+        }
+        subworkflowContext.__subworkflowDepth = depth;
+        Logger.info(parentInstance.instanceId, node.id, `Starting subworkflow: ${node.subworkflowId}`, {
+            subworkflowId: node.subworkflowId,
+            waitForCompletion: node.waitForCompletion,
+        });
+        const subInstanceId = await this.startWorkflow(node.subworkflowId, subworkflowContext, parentInstance.instanceId);
+        if (!node.waitForCompletion) {
+            Logger.debug(parentInstance.instanceId, node.id, `Subworkflow started (fire-and-forget): ${subInstanceId}`);
+            const fireAndForgetResult = {
+                instanceId: subInstanceId,
+                status: "running",
+            };
+            this.writeParentState(parentInstance, node.id, fireAndForgetResult);
+            return fireAndForgetResult;
+        }
+        const result = await this.waitForCompletion(subInstanceId, parentInstance.instanceId, node.id, node.timeout);
+        this.writeParentState(parentInstance, node.id, result);
+        return result;
+    }
+    buildSubworkflowContext(inputMapping, parentContext) {
+        const context = {};
+        for (const [targetKey, sourcePath] of Object.entries(inputMapping)) {
+            if (sourcePath.startsWith("$")) {
+                const value = sourcePath.substring(1);
+                if (value.startsWith("literal:")) {
+                    context[targetKey] = value.substring(8);
+                }
+                else {
+                    context[targetKey] = value;
+                }
+            }
+            else {
+                const resolvedPath = sourcePath.startsWith("parent.")
+                    ? sourcePath.substring(7)
+                    : sourcePath;
+                context[targetKey] = getNestedValue(parentContext, resolvedPath);
+            }
+        }
+        return context;
+    }
+    async waitForCompletion(subInstanceId, parentInstanceId, nodeId, timeoutMs = 5000) {
+        const earlyCheck = this.getInstanceStatus(subInstanceId);
+        if (!earlyCheck) {
+            Logger.warn(parentInstanceId, nodeId, `Subworkflow instance not found: ${subInstanceId}`);
+            return {
+                instanceId: subInstanceId,
+                status: "failed",
+                error: "Subworkflow instance not found",
+            };
+        }
+        if (earlyCheck.status === "completed") {
+            Logger.info(parentInstanceId, nodeId, `Subworkflow completed: ${subInstanceId}`);
+            return {
+                instanceId: subInstanceId,
+                status: "completed",
+                output: earlyCheck.context,
+            };
+        }
+        if (earlyCheck.status === "failed" || earlyCheck.status === "cancelled") {
+            Logger.warn(parentInstanceId, nodeId, `Subworkflow failed: ${subInstanceId}`, { status: earlyCheck.status });
+            return {
+                instanceId: subInstanceId,
+                status: "failed",
+                error: `Subworkflow ended with status: ${earlyCheck.status}`,
+            };
+        }
+        return new Promise((resolve) => {
+            let settled = false;
+            let timer;
+            const cleanup = () => {
+                if (!settled) {
+                    settled = true;
+                    clearTimeout(timer);
+                    offCompleted();
+                    offFailed();
+                }
+            };
+            const offCompleted = hookManager.on("workflow.completed", (payload) => {
+                if (settled || payload.instanceId !== subInstanceId)
+                    return;
+                cleanup();
+                const instance = this.getInstanceStatus(subInstanceId);
+                Logger.info(parentInstanceId, nodeId, `Subworkflow completed: ${subInstanceId}`);
+                resolve({
+                    instanceId: subInstanceId,
+                    status: "completed",
+                    output: instance?.context,
+                });
+            });
+            const offFailed = hookManager.on("workflow.failed", (payload) => {
+                if (settled || payload.instanceId !== subInstanceId)
+                    return;
+                cleanup();
+                Logger.warn(parentInstanceId, nodeId, `Subworkflow failed: ${subInstanceId}`);
+                resolve({
+                    instanceId: subInstanceId,
+                    status: "failed",
+                    error: payload.data && typeof payload.data.error === "string"
+                        ? payload.data.error
+                        : "Subworkflow failed",
+                });
+            });
+            timer = setTimeout(() => {
+                if (settled)
+                    return;
+                cleanup();
+                Logger.error(parentInstanceId, nodeId, `Subworkflow timeout: ${subInstanceId}`);
+                resolve({
+                    instanceId: subInstanceId,
+                    status: "failed",
+                    error: `Subworkflow timeout after ${timeoutMs}ms`,
+                });
+            }, timeoutMs);
+        });
+    }
+    writeParentState(parentInstance, nodeId, result) {
+        if (!parentInstance.state) {
+            parentInstance.state = { nodes: {} };
+        }
+        if (!parentInstance.state.nodes) {
+            parentInstance.state.nodes = {};
+        }
+        parentInstance.state.nodes[nodeId] = { output: result };
+    }
+}
+//# sourceMappingURL=SubworkflowExecutor.js.map

package/dist/src/engine/SubworkflowExecutor.js.map

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

package/dist/src/engine/TaskExecutor.d.ts

@@ -0,0 +1,12 @@
+import type { WorkflowInstance } from "../model/Instance.js";
+import type { TaskNode } from "../model/Workflow.js";
+import type { StorageProvider } from "../storage/StorageProvider.js";
+import type { HeartbeatManager } from "./HeartbeatManager.js";
+import { getWorkerPool, initWorkerPool, shutdownWorkerPool } from "./nodeDispatch/helpers.js";
+import type { WorkerPoolConfig } from "./worker/WorkerPool.js";
+export { initWorkerPool, getWorkerPool, shutdownWorkerPool };
+export type { WorkerPoolConfig };
+export declare function execute(node: TaskNode, instance: WorkflowInstance, onComplete: (nextNodes: string[]) => void, onError: (error: Error) => void, storage?: StorageProvider, heartbeatManager?: HeartbeatManager): Promise<void>;
+export declare const TaskExecutor: {
+    execute: typeof execute;
+};

package/dist/src/engine/TaskExecutor.js

@@ -0,0 +1,124 @@
+import { workflowDebugger } from "../debug/WorkflowDebugger.js";
+import { recordNodeExecution } from "../metrics/index.js";
+import { appendHistory } from "../model/Instance.js";
+import { Logger } from "../utils/Logger.js";
+import { dispatchControlNode } from "./nodeDispatch/controlNodes.js";
+import { getWorkerPool, initWorkerPool, shutdownWorkerPool, } from "./nodeDispatch/helpers.js";
+import { dispatchIoNode } from "./nodeDispatch/ioNodes.js";
+import { dispatchWorkflowNode } from "./nodeDispatch/workflowNodes.js";
+export { initWorkerPool, getWorkerPool, shutdownWorkerPool };
+export async function execute(node, instance, onComplete, onError, storage, heartbeatManager) {
+    const logEntry = {
+        nodeId: node.id,
+        timestamp: new Date(),
+        status: "started",
+    };
+    appendHistory(instance, logEntry);
+    Logger.log(instance.instanceId, node.id, "Task started", undefined, "action");
+    workflowDebugger.onNodeEnter(instance.instanceId, node.id, {
+        ...instance.context,
+        state: instance.state ?? {},
+    });
+    const startTime = Date.now();
+    if (storage) {
+        try {
+            await storage.updateNodeMetrics(instance.instanceId, node.id, {
+                nodeId: node.id,
+                nodeType: node.type,
+                startTime,
+                status: "running",
+                retryCount: instance.retries?.[node.id] || 0,
+                retryTimestamps: [],
+            });
+        }
+        catch (error) {
+            Logger.error(instance.instanceId, node.id, "Failed to record start metrics", error?.stack);
+        }
+    }
+    const ctx = {
+        node,
+        instance,
+        logEntry,
+        startTime,
+        onComplete,
+        storage,
+        heartbeatManager,
+    };
+    try {
+        let handled = await dispatchIoNode(ctx);
+        if (handled !== undefined)
+            return;
+        handled = await dispatchControlNode(ctx);
+        if (handled !== undefined)
+            return;
+        handled = await dispatchWorkflowNode(ctx);
+        if (handled !== undefined)
+            return;
+        const errorMsg = `Unsupported task type: ${node.type}`;
+        logEntry.status = "failed";
+        logEntry.error = errorMsg;
+        Logger.error(instance.instanceId, node.id, errorMsg);
+        if (storage) {
+            try {
+                await storage.updateNodeMetrics(instance.instanceId, node.id, {
+                    nodeId: node.id,
+                    nodeType: node.type,
+                    startTime,
+                    endTime: Date.now(),
+                    duration: Date.now() - startTime,
+                    status: "failed",
+                    retryCount: instance.retries?.[node.id] || 0,
+                    error: {
+                        message: errorMsg,
+                        timestamp: Date.now(),
+                    },
+                });
+            }
+            catch (error) {
+                Logger.error(instance.instanceId, node.id, "Failed to record error metrics", error?.stack);
+            }
+        }
+        throw new Error(errorMsg);
+    }
+    catch (err) {
+        const endTime = Date.now();
+        const duration = endTime - startTime;
+        logEntry.status = "failed";
+        logEntry.error =
+            (err instanceof Error ? err.message : String(err)) || String(err);
+        logEntry.stack = err instanceof Error ? err.stack : undefined;
+        logEntry.duration = duration;
+        Logger.error(instance.instanceId, node.id, "Task failed", err instanceof Error ? err.message : String(err), "action");
+        recordNodeExecution(instance.workflowId, node.id, node.type, "failed", duration / 1000);
+        if (storage) {
+            try {
+                await storage.updateNodeMetrics(instance.instanceId, node.id, {
+                    nodeId: node.id,
+                    nodeType: node.type,
+                    startTime,
+                    endTime,
+                    duration,
+                    status: "failed",
+                    retryCount: instance.retries?.[node.id] || 0,
+                    error: {
+                        message: (err instanceof Error ? err.message : String(err)) || String(err),
+                        stack: err instanceof Error ? err.stack : undefined,
+                        timestamp: endTime,
+                    },
+                });
+            }
+            catch (error) {
+                Logger.error(instance.instanceId, node.id, "Failed to record error metrics", error?.stack);
+            }
+        }
+        const error = err instanceof Error ? err : new Error(String(err));
+        onError(error);
+    }
+    finally {
+        workflowDebugger.onNodeExit(instance.instanceId, node.id);
+    }
+}
+export const TaskExecutor = {
+    execute,
+};
+//# sourceMappingURL=TaskExecutor.js.map

package/dist/src/engine/TaskExecutor.js.map

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

package/dist/src/engine/TaskQueueManager.d.ts

@@ -0,0 +1,42 @@
+export type TaskQueueType = "workflow" | "activity";
+export interface TaskQueueOptions {
+    name: string;
+    type: TaskQueueType;
+    routing?: (task: unknown) => string;
+    maxConcurrent?: number;
+    rateLimit?: number;
+}
+export interface Task<T = unknown> {
+    id: string;
+    queueName: string;
+    payload: T;
+    correlationId?: string;
+    timestamp: Date;
+    priority?: number;
+}
+export type TaskHandler = (task: Task) => Promise<unknown>;
+export declare class TaskQueueManager {
+    private queues;
+    private pendingTasks;
+    private workers;
+    private taskRouting;
+    private settlements;
+    createQueue(options: TaskQueueOptions): void;
+    getQueue(name: string): TaskQueueOptions | undefined;
+    listQueues(): TaskQueueOptions[];
+    deleteQueue(name: string): void;
+    enqueue<T = unknown>(queueName: string, payload: T, correlationId?: string, beforeDispatch?: (taskId: string) => void): Task<T>;
+    hasWorkerFor(queueName: string): boolean;
+    submit<TResult = unknown, T = unknown>(queueName: string, payload: T, correlationId?: string): Promise<TResult>;
+    private dispatchTask;
+    registerWorker(workerId: string, queueNames: string[], callback: TaskHandler, options?: {
+        maxConcurrent?: number;
+    }): void;
+    unregisterWorker(workerId: string): void;
+    getPendingCount(queueName: string): number;
+    getWorkerStatus(workerId: string): {
+        active: number;
+        max: number;
+    } | undefined;
+}
+export declare const taskQueueManager: TaskQueueManager;

package/dist/src/engine/TaskQueueManager.js

@@ -0,0 +1,175 @@
+import { Logger } from "../utils/Logger.js";
+export class TaskQueueManager {
+    queues = new Map();
+    pendingTasks = new Map();
+    workers = new Map();
+    taskRouting = new Map();
+    settlements = new Map();
+    createQueue(options) {
+        this.queues.set(options.name, options);
+        this.pendingTasks.set(options.name, []);
+        if (options.routing) {
+            this.taskRouting.set(options.name, options.routing);
+        }
+        Logger.info("system", "task-queue", `Queue created: ${options.name}`, {
+            type: options.type,
+        });
+    }
+    getQueue(name) {
+        return this.queues.get(name);
+    }
+    listQueues() {
+        return Array.from(this.queues.values());
+    }
+    deleteQueue(name) {
+        const queue = this.queues.get(name);
+        if (!queue) {
+            return;
+        }
+        const pending = this.pendingTasks.get(name) ?? [];
+        if (pending.length > 0) {
+            Logger.warn("system", "task-queue", `Deleting queue with pending tasks: ${name}`, {
+                pendingCount: pending.length,
+            });
+            const deleted = new Error(`Queue deleted while task pending: ${name}`);
+            for (const task of pending) {
+                const settlement = this.settlements.get(task.id);
+                if (settlement) {
+                    this.settlements.delete(task.id);
+                    settlement.reject(deleted);
+                }
+            }
+        }
+        this.queues.delete(name);
+        this.pendingTasks.delete(name);
+        this.taskRouting.delete(name);
+        Logger.info("system", "task-queue", `Queue deleted: ${name}`);
+    }
+    enqueue(queueName, payload, correlationId, beforeDispatch) {
+        const queue = this.queues.get(queueName);
+        if (!queue) {
+            throw new Error(`Queue not found: ${queueName}`);
+        }
+        let targetQueue = queueName;
+        const routing = this.taskRouting.get(queueName);
+        if (routing) {
+            targetQueue = routing(payload);
+        }
+        const task = {
+            id: `${targetQueue}:${Date.now()}:${Math.random().toString(36).substring(2, 9)}`,
+            queueName: targetQueue,
+            payload,
+            correlationId,
+            timestamp: new Date(),
+        };
+        const queueTasks = this.pendingTasks.get(targetQueue) ?? [];
+        queueTasks.push(task);
+        this.pendingTasks.set(targetQueue, queueTasks);
+        Logger.debug("system", "task-queue", `Task enqueued: ${task.id}`, {
+            queue: targetQueue,
+        });
+        beforeDispatch?.(task.id);
+        this.dispatchTask(targetQueue);
+        return task;
+    }
+    hasWorkerFor(queueName) {
+        for (const worker of this.workers.values()) {
+            if (worker.queueNames.includes(queueName)) {
+                return true;
+            }
+        }
+        return false;
+    }
+    submit(queueName, payload, correlationId) {
+        return new Promise((resolve, reject) => {
+            let task;
+            try {
+                task = this.enqueue(queueName, payload, correlationId, (id) => {
+                    this.settlements.set(id, {
+                        resolve: resolve,
+                        reject,
+                    });
+                });
+            }
+            catch (error) {
+                reject(error);
+                return;
+            }
+            if (!this.settlements.has(task.id)) {
+                reject(new Error(`Task ${task.id} was not registered for settlement`));
+            }
+        });
+    }
+    async dispatchTask(queueName) {
+        const queue = this.queues.get(queueName);
+        if (!queue)
+            return;
+        const queueTasks = this.pendingTasks.get(queueName) ?? [];
+        if (queueTasks.length === 0)
+            return;
+        const availableWorkers = Array.from(this.workers.values()).filter((w) => w.queueNames.includes(queueName) && w.activeCount < w.maxConcurrent);
+        if (availableWorkers.length === 0)
+            return;
+        const worker = availableWorkers[0];
+        const task = queueTasks.shift();
+        worker.activeCount++;
+        const settlement = this.settlements.get(task.id);
+        try {
+            const result = await worker.callback(task);
+            if (settlement) {
+                this.settlements.delete(task.id);
+                settlement.resolve(result);
+            }
+        }
+        catch (error) {
+            Logger.error("system", "task-queue", `Task execution error: ${task.id}`, error instanceof Error ? error.stack : String(error));
+            if (settlement) {
+                this.settlements.delete(task.id);
+                settlement.reject(error);
+            }
+            else {
+                queueTasks.unshift(task);
+            }
+        }
+        finally {
+            worker.activeCount--;
+        }
+        this.dispatchTask(queueName);
+    }
+    registerWorker(workerId, queueNames, callback, options) {
+        const worker = {
+            workerId,
+            queueNames,
+            callback,
+            maxConcurrent: options?.maxConcurrent ?? 10,
+            activeCount: 0,
+        };
+        this.workers.set(workerId, worker);
+        for (const queueName of queueNames) {
+            if (!this.queues.has(queueName)) {
+                this.createQueue({ name: queueName, type: "activity" });
+            }
+        }
+        Logger.info("system", "task-queue", `Worker registered: ${workerId}`, {
+            queues: queueNames,
+        });
+    }
+    unregisterWorker(workerId) {
+        const worker = this.workers.get(workerId);
+        if (!worker)
+            return;
+        this.workers.delete(workerId);
+        Logger.info("system", "task-queue", `Worker unregistered: ${workerId}`);
+    }
+    getPendingCount(queueName) {
+        return (this.pendingTasks.get(queueName) ?? []).length;
+    }
+    getWorkerStatus(workerId) {
+        const worker = this.workers.get(workerId);
+        if (!worker)
+            return undefined;
+        return { active: worker.activeCount, max: worker.maxConcurrent };
+    }
+}
+export const taskQueueManager = new TaskQueueManager();
+//# sourceMappingURL=TaskQueueManager.js.map

package/dist/src/engine/TaskQueueManager.js.map

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

package/dist/src/engine/WorkflowEngine.d.ts

@@ -0,0 +1,117 @@
+import type { DeadLetterQueue } from "../dlq/index.js";
+import type { EventBus } from "../event/EventBus.js";
+import { type MessageHandler, type SignalHandler } from "../event/MessageBus.js";
+import type { WorkflowInstance } from "../model/Instance.js";
+import type { WorkflowDefinition } from "../model/Workflow.js";
+import type { CronScheduler } from "../scheduler/CronScheduler.js";
+import type { PromotionRules, StorageProvider } from "../storage/StorageProvider.js";
+import { type CanaryStatus, type PromotionEvaluation } from "./CanaryReleaseManager.js";
+import { type ContinueAsNewOptions, type ContinueAsNewResult } from "./ContinueAsNewManager.js";
+import { type ReleasePolicy } from "./WorkflowRegistry.js";
+export interface WaitForCompletionOptions {
+    timeoutMs?: number;
+    pollIntervalMs?: number;
+    signal?: AbortSignal;
+}
+export declare class WorkflowEngine {
+    private storage;
+    private dlq;
+    private config;
+    private instanceManager;
+    private workflowRegistry;
+    private lifecycleManager;
+    private eventCoordinator;
+    private executionOrchestrator;
+    private leaseStore;
+    private heartbeatManager;
+    private canaryReleaseManager;
+    private dryRunExecutor;
+    private workflowPersistence;
+    private workflowControl;
+    private readonly leaseHolderId;
+    private readonly instanceLeaseTtlMs;
+    constructor(storage: StorageProvider, eventBus: EventBus, scheduler: CronScheduler, dlq: DeadLetterQueue, config: {
+        instanceTtlHours: number;
+        cleanupIntervalMs: number;
+        maxInstances: number;
+    });
+    initialize(options?: {
+        resumeRunningInstances?: boolean;
+    }): Promise<void>;
+    register(workflow: WorkflowDefinition, options?: {
+        version?: string;
+        setActive?: boolean;
+        persist?: boolean;
+    }): Promise<void>;
+    start(workflowId: string, context?: Record<string, any>, options?: {
+        version?: string;
+        searchAttributes?: Record<string, string | number | boolean>;
+        parentInstanceId?: string;
+        tenantId?: string;
+    }): Promise<string>;
+    protected execute(instance: WorkflowInstance): Promise<void>;
+    continueAsNew(instanceId: string, options?: ContinueAsNewOptions): ContinueAsNewResult;
+    private handleContinueAsNew;
+    private getInstanceLeaseKey;
+    private ensureInstanceLease;
+    private withInstanceLease;
+    resumeRunningInstancesFromStorage(): Promise<void>;
+    private restoreOrphanedWaitingStates;
+    private resumeRunningInstances;
+    getInstance(instanceId: string): WorkflowInstance | undefined;
+    waitForCompletion(instanceId: string, options?: WaitForCompletionOptions): Promise<WorkflowInstance>;
+    listInstances(): string[];
+    getWorkflow(workflowId: string, version?: string): WorkflowDefinition | undefined;
+    listWorkflows(): string[];
+    listWorkflowVersions(workflowId: string): string[];
+    getActiveWorkflowVersion(workflowId: string): string | undefined;
+    setActiveWorkflowVersion(workflowId: string, version: string): void;
+    getLockedWorkflowVersion(workflowId: string): string | undefined;
+    setLockedWorkflowVersion(workflowId: string, version: string): void;
+    clearLockedWorkflowVersion(workflowId: string): void;
+    setReleasePolicy(workflowId: string, policy: ReleasePolicy): void;
+    startCanaryRelease(workflowId: string, version: number, percent: number, rules?: PromotionRules): Promise<void>;
+    promoteCanary(workflowId: string): Promise<void>;
+    rollbackCanary(workflowId: string): Promise<void>;
+    getCanaryStatus(workflowId: string): Promise<CanaryStatus>;
+    evaluateCanaryPromotion(workflowId: string): Promise<PromotionEvaluation>;
+    getReleasePolicy(workflowId: string): ReleasePolicy | undefined;
+    destroy(): void;
+    retryNode(instanceId: string, nodeId: string): Promise<void>;
+    skipNode(instanceId: string, nodeId: string, defaultOutput?: any): Promise<void>;
+    compensate(instanceId: string, reason?: string): Promise<void>;
+    pauseInstance(instanceId: string): Promise<boolean>;
+    resumeInstance(instanceId: string): Promise<boolean>;
+    cancelInstance(instanceId: string): Promise<boolean>;
+    terminateInstance(instanceId: string): Promise<boolean>;
+    dryRun(workflowId: string, input?: Record<string, any>, options?: DryRunOptions): Promise<DryRunResult>;
+    signal(instanceId: string, signalName: string, payload?: unknown): Promise<void>;
+    registerSignal(name: string, handler: SignalHandler): void;
+    query<T = unknown>(instanceId: string, queryName: string, payload?: unknown): Promise<T>;
+    registerQuery(name: string, handler: MessageHandler): void;
+    update<T = unknown>(instanceId: string, updateName: string, payload?: unknown, correlationId?: string): Promise<T>;
+    registerUpdate(name: string, handler: MessageHandler): void;
+}
+export interface DryRunOptions {
+    mockOutputs?: Record<string, any>;
+    mockResponses?: Record<string, any>;
+    failAt?: string[];
+    skipNodes?: string[];
+    stopAfterNode?: string;
+    recordExpressions?: boolean;
+}
+export interface DryRunResult {
+    success: boolean;
+    valid: boolean;
+    executionPath: string[];
+    nodeResults?: Record<string, unknown>;
+    expressionTrace?: Array<unknown>;
+    warnings?: string[];
+    totalDuration?: number;
+    simulatedOutputs: Record<string, unknown>;
+    errors: Array<{
+        nodeId: string;
+        error: string;
+    }>;
+    duration: number;
+}