ts-workflow-engine-lite 2.1.0

package/dist/src/engine/WorkflowInstanceControl.js

@@ -0,0 +1,306 @@
+import { createHookPayload, hookManager } from "../event/HookManager.js";
+import { recordNodeRetry } from "../metrics/index.js";
+import { appendHistory } from "../model/Instance.js";
+import { Logger } from "../utils/Logger.js";
+export class WorkflowInstanceControl {
+    instanceManager;
+    workflowRegistry;
+    executeInstance;
+    constructor(instanceManager, workflowRegistry, executeInstance) {
+        this.instanceManager = instanceManager;
+        this.workflowRegistry = workflowRegistry;
+        this.executeInstance = executeInstance;
+    }
+    async retryNode(instanceId, nodeId) {
+        const instance = await this.loadLatestInstance(instanceId);
+        this.requireWorkflowNode(instance.workflowId, nodeId);
+        const nodeHistory = instance.history.filter((log) => log.nodeId === nodeId);
+        const lastExecution = nodeHistory[nodeHistory.length - 1];
+        if (!lastExecution || lastExecution.status !== "failed") {
+            throw new Error(`Node ${nodeId} is not in a failed state and cannot be retried`);
+        }
+        instance.retries ??= {};
+        instance.retries[nodeId] = (instance.retries[nodeId] ?? 0) + 1;
+        void hookManager.emit(createHookPayload({
+            event: "node.retry",
+            workflowId: instance.workflowId,
+            instanceId,
+            nodeId,
+            status: "retrying",
+            traceId: instance.traceId,
+            data: { retryCount: instance.retries[nodeId], manual: true },
+        }));
+        recordNodeRetry(instance.workflowId, nodeId);
+        Logger.log(instanceId, nodeId, `Retrying node (attempt ${instance.retries[nodeId]})`, { originalInput: lastExecution.data });
+        instance.currentNodes = [nodeId];
+        instance.status = "running";
+        instance.updatedAt = new Date();
+        const updated = await this.persistControlUpdate(instance, (current) => {
+            current.currentNodes = [nodeId];
+            current.status = "running";
+            current.updatedAt = new Date();
+        });
+        await this.executeInstance(updated);
+    }
+    async skipNode(instanceId, nodeId, defaultOutput) {
+        const instance = await this.loadLatestInstance(instanceId);
+        const node = this.requireWorkflowNode(instance.workflowId, nodeId);
+        const nodeHistory = instance.history.filter((log) => log.nodeId === nodeId);
+        const lastExecution = nodeHistory[nodeHistory.length - 1];
+        if (lastExecution?.status === "success") {
+            throw new Error(`Node ${nodeId} has already completed successfully and cannot be skipped`);
+        }
+        Logger.log(instanceId, nodeId, "Skipping node", { defaultOutput });
+        void hookManager.emit(createHookPayload({
+            event: "node.skipped",
+            workflowId: instance.workflowId,
+            instanceId,
+            nodeId,
+            status: "skipped",
+            traceId: instance.traceId,
+            data: { defaultOutput },
+        }));
+        appendHistory(instance, {
+            nodeId,
+            timestamp: new Date(),
+            status: "skipped",
+            data: defaultOutput ?? null,
+        });
+        instance.state ??= { nodes: {} };
+        instance.state.nodes ??= {};
+        instance.state.nodes[nodeId] = { output: defaultOutput ?? null };
+        instance.currentNodes = node.next || [];
+        instance.status = "running";
+        instance.updatedAt = new Date();
+        const updated = await this.persistControlUpdate(instance, (current) => {
+            current.history = instance.history;
+            current.state = instance.state;
+            current.currentNodes = node.next || [];
+            current.status = "running";
+            current.updatedAt = new Date();
+        });
+        if (updated.currentNodes.length > 0) {
+            await this.executeInstance(updated);
+            return;
+        }
+        updated.status = "completed";
+        updated.updatedAt = new Date();
+        await this.instanceManager.updateInstance(updated);
+        void hookManager.emit(createHookPayload({
+            event: "workflow.completed",
+            workflowId: updated.workflowId,
+            instanceId,
+            status: updated.status,
+            traceId: updated.traceId,
+            data: { lastNodeId: nodeId },
+        }));
+        Logger.log(instanceId, nodeId, "Workflow completed after skip");
+    }
+    async compensate(instanceId, reason) {
+        const instance = await this.loadLatestInstance(instanceId);
+        const workflow = this.requireWorkflow(instance.workflowId);
+        Logger.log(instanceId, "system", "Starting compensation", { reason });
+        const completedNodes = instance.history
+            .filter((log) => log.status === "success")
+            .map((log) => log.nodeId);
+        const uniqueCompletedNodes = Array.from(new Set(completedNodes)).reverse();
+        const rollbackNodes = [];
+        for (const nodeId of uniqueCompletedNodes) {
+            const node = workflow.nodes[nodeId];
+            if (!node?.rollbackTo)
+                continue;
+            const rollbackNode = workflow.nodes[node.rollbackTo];
+            if (rollbackNode?.type === "rollback") {
+                rollbackNodes.push(node.rollbackTo);
+            }
+        }
+        if (rollbackNodes.length === 0) {
+            Logger.log(instanceId, "system", "No rollback nodes found for compensation");
+            return;
+        }
+        Logger.log(instanceId, "system", `Executing ${rollbackNodes.length} rollback nodes in reverse order`, { rollbackNodes });
+        for (const rollbackNodeId of rollbackNodes) {
+            const rollbackNode = workflow.nodes[rollbackNodeId];
+            if (!rollbackNode)
+                continue;
+            Logger.log(instanceId, rollbackNodeId, "Executing compensation node");
+            try {
+                if (rollbackNode.action) {
+                    const startTime = Date.now();
+                    await rollbackNode.action(instance);
+                    appendHistory(instance, {
+                        nodeId: rollbackNodeId,
+                        timestamp: new Date(),
+                        status: "rollback",
+                        duration: Date.now() - startTime,
+                    });
+                }
+            }
+            catch (error) {
+                const err = error instanceof Error ? error : new Error(String(error));
+                Logger.error(instanceId, rollbackNodeId, "Compensation node failed", err.stack);
+                appendHistory(instance, {
+                    nodeId: rollbackNodeId,
+                    timestamp: new Date(),
+                    status: "failed",
+                    error: err.message,
+                    stack: err.stack,
+                });
+            }
+        }
+        instance.status = "rollback";
+        instance.updatedAt = new Date();
+        await this.persistControlUpdate(instance, (current) => {
+            current.history = instance.history;
+            current.status = "rollback";
+            current.updatedAt = new Date();
+        });
+        Logger.log(instanceId, "system", "Compensation completed");
+    }
+    async pauseInstance(instanceId) {
+        const instance = await this.loadLatestInstance(instanceId);
+        if (instance.status !== "running") {
+            throw new Error(`Instance ${instanceId} is not running and cannot be paused (status: ${instance.status})`);
+        }
+        Logger.log(instanceId, "system", "Pausing instance");
+        await this.persistControlUpdate(instance, (current) => {
+            current.status = "paused";
+            current.updatedAt = new Date();
+        });
+        void hookManager.emit(createHookPayload({
+            event: "workflow.paused",
+            workflowId: instance.workflowId,
+            instanceId,
+            status: "paused",
+            traceId: instance.traceId,
+        }));
+        return true;
+    }
+    async resumeInstance(instanceId) {
+        const instance = await this.loadLatestInstance(instanceId);
+        if (instance.status !== "paused") {
+            throw new Error(`Instance ${instanceId} is not paused and cannot be resumed (status: ${instance.status})`);
+        }
+        Logger.log(instanceId, "system", "Resuming instance");
+        const updated = await this.persistControlUpdate(instance, (current) => {
+            current.status = "running";
+            current.updatedAt = new Date();
+        });
+        void hookManager.emit(createHookPayload({
+            event: "workflow.resumed",
+            workflowId: instance.workflowId,
+            instanceId,
+            status: "running",
+            traceId: instance.traceId,
+        }));
+        await this.executeInstance(updated);
+        return true;
+    }
+    async cancelInstance(instanceId) {
+        const instance = await this.loadLatestInstance(instanceId);
+        if (instance.status === "completed" || instance.status === "cancelled") {
+            throw new Error(`Instance ${instanceId} is already in a terminal state (status: ${instance.status})`);
+        }
+        Logger.log(instanceId, "system", "Cancelling instance");
+        await this.persistControlUpdate(instance, (current) => {
+            current.status = "cancelled";
+            current.currentNodes = [];
+            current.updatedAt = new Date();
+        });
+        void hookManager.emit(createHookPayload({
+            event: "workflow.cancelled",
+            workflowId: instance.workflowId,
+            instanceId,
+            status: "cancelled",
+            traceId: instance.traceId,
+        }));
+        return true;
+    }
+    async terminateInstance(instanceId) {
+        const instance = await this.loadLatestInstance(instanceId);
+        if (instance.status === "completed" || instance.status === "cancelled") {
+            return false;
+        }
+        Logger.log(instanceId, "system", "Terminating instance");
+        await this.persistControlUpdate(instance, (current) => {
+            current.status = "cancelled";
+            current.currentNodes = [];
+            current.updatedAt = new Date();
+        });
+        void hookManager.emit(createHookPayload({
+            event: "workflow.cancelled",
+            workflowId: instance.workflowId,
+            instanceId,
+            status: "cancelled",
+            traceId: instance.traceId,
+            data: { terminated: true },
+        }));
+        return true;
+    }
+    requireInstance(instanceId) {
+        const instance = this.instanceManager.getInstance(instanceId);
+        if (!instance) {
+            throw new Error(`Instance ${instanceId} not found`);
+        }
+        return instance;
+    }
+    async loadLatestInstance(instanceId) {
+        const inMemory = this.requireInstance(instanceId);
+        const storage = this.instanceManager.storageProvider;
+        if (!storage) {
+            return inMemory;
+        }
+        const fresh = await storage.loadInstance(instanceId);
+        if (!fresh) {
+            return inMemory;
+        }
+        this.instanceManager.getInstancesMap().set(instanceId, fresh);
+        return fresh;
+    }
+    async persistControlUpdate(instance, mutate) {
+        let current = instance;
+        for (let attempt = 0; attempt < 5; attempt++) {
+            mutate(current);
+            const storage = this.instanceManager.storageProvider;
+            if (storage) {
+                const persisted = await storage.loadInstance(current.instanceId);
+                if (!persisted) {
+                    current.version = 1;
+                    await storage.saveInstance(current);
+                    this.instanceManager
+                        .getInstancesMap()
+                        .set(current.instanceId, current);
+                    return current;
+                }
+            }
+            try {
+                await this.instanceManager.updateInstance(current);
+                return current;
+            }
+            catch (error) {
+                current = await this.loadLatestInstance(instance.instanceId);
+                if (attempt === 4) {
+                    throw error;
+                }
+                await new Promise((resolve) => setTimeout(resolve, 25));
+            }
+        }
+        return current;
+    }
+    requireWorkflow(workflowId) {
+        const workflow = this.workflowRegistry.getWorkflow(workflowId);
+        if (!workflow) {
+            throw new Error(`Workflow ${workflowId} not found`);
+        }
+        return workflow;
+    }
+    requireWorkflowNode(workflowId, nodeId) {
+        const workflow = this.requireWorkflow(workflowId);
+        const node = workflow.nodes[nodeId];
+        if (!node) {
+            throw new Error(`Node ${nodeId} not found in workflow ${workflowId}`);
+        }
+        return node;
+    }
+}
+//# sourceMappingURL=WorkflowInstanceControl.js.map

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

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

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

@@ -0,0 +1,12 @@
+import type { WorkflowDefinition } from "../model/Workflow.js";
+import type { StorageProvider } from "../storage/StorageProvider.js";
+import type { WorkflowRegistry } from "./WorkflowRegistry.js";
+export declare class WorkflowPersistenceCoordinator {
+    private readonly storage;
+    private readonly workflowRegistry;
+    private readonly startWorkflow;
+    constructor(storage: StorageProvider, workflowRegistry: WorkflowRegistry, startWorkflow: (workflowId: string, context: Record<string, any>) => Promise<string>);
+    restorePersistedWorkflows(): Promise<void>;
+    hydrateWorkflowFromStorage(workflowId: string): Promise<void>;
+    persistWorkflowDefinition(workflow: WorkflowDefinition, explicitVersion?: string): Promise<void>;
+}

package/dist/src/engine/WorkflowPersistenceCoordinator.js

@@ -0,0 +1,93 @@
+export class WorkflowPersistenceCoordinator {
+    storage;
+    workflowRegistry;
+    startWorkflow;
+    constructor(storage, workflowRegistry, startWorkflow) {
+        this.storage = storage;
+        this.workflowRegistry = workflowRegistry;
+        this.startWorkflow = startWorkflow;
+    }
+    async restorePersistedWorkflows() {
+        if (!this.storage?.listWorkflowsWithMetadata) {
+            return;
+        }
+        const workflows = await this.storage.listWorkflowsWithMetadata();
+        for (const workflow of workflows) {
+            await this.workflowRegistry.register(workflow.definition, (workflowId, context) => this.startWorkflow(workflowId, context), {
+                version: workflow.version.toString(),
+                setActive: workflow.publishedVersion === undefined ||
+                    workflow.publishedVersion === workflow.version,
+            });
+            if (workflow.releasePolicy) {
+                if (workflow.releasePolicy.type === "canary") {
+                    this.workflowRegistry.setReleasePolicy(workflow.id, {
+                        type: "canary",
+                        baselineVersion: workflow.releasePolicy.baselineVersion.toString(),
+                        canaryVersion: workflow.releasePolicy.canaryVersion.toString(),
+                        canaryPercent: workflow.releasePolicy.canaryPercent,
+                    });
+                }
+                else {
+                    this.workflowRegistry.setReleasePolicy(workflow.id, {
+                        type: "stable",
+                    });
+                }
+            }
+            if (workflow.lockedVersion !== undefined) {
+                this.workflowRegistry.setLockedVersion(workflow.id, workflow.lockedVersion.toString());
+            }
+        }
+    }
+    async hydrateWorkflowFromStorage(workflowId) {
+        if (!this.storage?.loadWorkflowWithMetadata) {
+            return;
+        }
+        const storedWorkflow = await this.storage.loadWorkflowWithMetadata(workflowId);
+        if (!storedWorkflow) {
+            return;
+        }
+        await this.workflowRegistry.register(storedWorkflow.definition, (nextWorkflowId, context) => this.startWorkflow(nextWorkflowId, context), {
+            version: storedWorkflow.version.toString(),
+            setActive: storedWorkflow.publishedVersion === undefined ||
+                storedWorkflow.publishedVersion === storedWorkflow.version,
+        });
+    }
+    async persistWorkflowDefinition(workflow, explicitVersion) {
+        const existing = await this.storage.loadWorkflowWithMetadata(workflow.id);
+        const now = Date.now();
+        const requestedVersion = Number.parseInt(explicitVersion ?? workflow.version ?? "", 10);
+        const version = Number.isFinite(requestedVersion) && requestedVersion > 0
+            ? requestedVersion
+            : (existing?.version ?? 0) + 1;
+        if (existing?.version === version) {
+            return;
+        }
+        const storedWorkflow = {
+            id: workflow.id,
+            name: workflow.name,
+            description: workflow.description,
+            definition: workflow,
+            version,
+            createdAt: existing?.createdAt ?? now,
+            updatedAt: now,
+            tags: existing?.tags,
+            metadata: workflow.metadata,
+            publishedVersion: existing?.publishedVersion ?? version,
+            lockedVersion: existing?.lockedVersion,
+            releasePolicy: existing?.releasePolicy,
+        };
+        await this.storage.saveWorkflow(workflow);
+        await this.storage.saveWorkflowWithMetadata(storedWorkflow);
+        await this.storage.saveWorkflowVersion({
+            id: workflow.id,
+            name: workflow.name,
+            description: workflow.description,
+            definition: workflow,
+            version,
+            createdAt: now,
+            tags: existing?.tags,
+            metadata: workflow.metadata,
+        });
+    }
+}
+//# sourceMappingURL=WorkflowPersistenceCoordinator.js.map

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

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

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

@@ -0,0 +1,38 @@
+import type { EventBus } from "../event/EventBus.js";
+import type { WorkflowDefinition } from "../model/Workflow.js";
+import type { CronScheduler } from "../scheduler/CronScheduler.js";
+export type ReleasePolicy = {
+    type: "stable";
+} | {
+    type: "canary";
+    baselineVersion: string;
+    canaryVersion: string;
+    canaryPercent: number;
+};
+export declare class WorkflowRegistry {
+    private scheduler?;
+    private eventBus?;
+    private workflows;
+    private activeVersions;
+    private lockedVersions;
+    private releasePolicies;
+    private registeredEvents;
+    private registeredCron;
+    constructor(scheduler?: CronScheduler | undefined, eventBus?: EventBus | undefined);
+    register(workflow: WorkflowDefinition, startWorkflow: (workflowId: string, context: Record<string, any>) => Promise<string>, options?: {
+        version?: string;
+        setActive?: boolean;
+    }): Promise<void>;
+    getWorkflow(workflowId: string, version?: string): WorkflowDefinition | undefined;
+    resolveVersion(workflowId: string, requestedVersion?: string): string | undefined;
+    listWorkflows(): string[];
+    listVersions(workflowId: string): string[];
+    setActiveVersion(workflowId: string, version: string): void;
+    getActiveVersion(workflowId: string): string | undefined;
+    setLockedVersion(workflowId: string, version: string): void;
+    clearLockedVersion(workflowId: string): void;
+    getLockedVersion(workflowId: string): string | undefined;
+    setReleasePolicy(workflowId: string, policy: ReleasePolicy): void;
+    getReleasePolicy(workflowId: string): ReleasePolicy | undefined;
+    hasWorkflow(workflowId: string): boolean;
+}

package/dist/src/engine/WorkflowRegistry.js

@@ -0,0 +1,130 @@
+import { Logger } from "../utils/Logger.js";
+export class WorkflowRegistry {
+    scheduler;
+    eventBus;
+    workflows = new Map();
+    activeVersions = new Map();
+    lockedVersions = new Map();
+    releasePolicies = new Map();
+    registeredEvents = new Map();
+    registeredCron = new Map();
+    constructor(scheduler, eventBus) {
+        this.scheduler = scheduler;
+        this.eventBus = eventBus;
+    }
+    async register(workflow, startWorkflow, options) {
+        const version = options?.version ?? workflow.version ?? "1";
+        const versions = this.workflows.get(workflow.id) || new Map();
+        versions.set(version, workflow);
+        this.workflows.set(workflow.id, versions);
+        if (!this.activeVersions.has(workflow.id) || options?.setActive) {
+            this.activeVersions.set(workflow.id, version);
+        }
+        Logger.info("system", "registry", `Workflow ${workflow.id} registered in memory`);
+        if (workflow.cron && this.scheduler) {
+            const existingCron = this.registeredCron.get(workflow.id);
+            if (existingCron !== workflow.cron) {
+                const cronEngine = { start: startWorkflow };
+                this.scheduler.scheduleJob(workflow.id, workflow.cron, cronEngine);
+                this.registeredCron.set(workflow.id, workflow.cron);
+            }
+        }
+        if (workflow.triggerEvents && this.eventBus) {
+            const eventBus = this.eventBus;
+            const registered = this.registeredEvents.get(workflow.id) || new Set();
+            workflow.triggerEvents.forEach((event) => {
+                if (registered.has(event))
+                    return;
+                const handler = (data) => {
+                    if (!data || !data.instanceId) {
+                        startWorkflow(workflow.id, data).catch((err) => Logger.error("system", "event", "Workflow start error", err instanceof Error ? err.stack : String(err)));
+                    }
+                };
+                eventBus.on(event, handler);
+                registered.add(event);
+            });
+            this.registeredEvents.set(workflow.id, registered);
+        }
+    }
+    getWorkflow(workflowId, version) {
+        const resolvedVersion = this.resolveVersion(workflowId, version);
+        if (!resolvedVersion)
+            return undefined;
+        const versions = this.workflows.get(workflowId);
+        return versions?.get(resolvedVersion);
+    }
+    resolveVersion(workflowId, requestedVersion) {
+        const versions = this.workflows.get(workflowId);
+        if (!versions || versions.size === 0)
+            return undefined;
+        const locked = this.lockedVersions.get(workflowId);
+        if (locked && versions.has(locked)) {
+            return locked;
+        }
+        if (requestedVersion && versions.has(requestedVersion)) {
+            return requestedVersion;
+        }
+        const policy = this.releasePolicies.get(workflowId);
+        if (policy?.type === "canary") {
+            const canary = policy.canaryVersion;
+            const baseline = policy.baselineVersion;
+            const percent = Math.max(0, Math.min(100, policy.canaryPercent));
+            const pickCanary = Math.random() * 100 < percent;
+            if (pickCanary && versions.has(canary)) {
+                return canary;
+            }
+            if (versions.has(baseline)) {
+                return baseline;
+            }
+        }
+        const active = this.activeVersions.get(workflowId);
+        if (active && versions.has(active)) {
+            return active;
+        }
+        const ordered = Array.from(versions.keys()).sort((a, b) => {
+            const numA = Number.parseFloat(a);
+            const numB = Number.parseFloat(b);
+            if (Number.isFinite(numA) && Number.isFinite(numB)) {
+                return numA - numB;
+            }
+            return a.localeCompare(b);
+        });
+        return ordered[ordered.length - 1];
+    }
+    listWorkflows() {
+        return Array.from(this.workflows.keys());
+    }
+    listVersions(workflowId) {
+        const versions = this.workflows.get(workflowId);
+        return versions ? Array.from(versions.keys()) : [];
+    }
+    setActiveVersion(workflowId, version) {
+        if (this.workflows.get(workflowId)?.has(version)) {
+            this.activeVersions.set(workflowId, version);
+        }
+    }
+    getActiveVersion(workflowId) {
+        return this.activeVersions.get(workflowId);
+    }
+    setLockedVersion(workflowId, version) {
+        if (this.workflows.get(workflowId)?.has(version)) {
+            this.lockedVersions.set(workflowId, version);
+        }
+    }
+    clearLockedVersion(workflowId) {
+        this.lockedVersions.delete(workflowId);
+    }
+    getLockedVersion(workflowId) {
+        return this.lockedVersions.get(workflowId);
+    }
+    setReleasePolicy(workflowId, policy) {
+        this.releasePolicies.set(workflowId, policy);
+    }
+    getReleasePolicy(workflowId) {
+        return this.releasePolicies.get(workflowId);
+    }
+    hasWorkflow(workflowId) {
+        return this.workflows.has(workflowId);
+    }
+}
+//# sourceMappingURL=WorkflowRegistry.js.map

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

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

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

@@ -0,0 +1,24 @@
+import type { WorkflowDefinition } from "../model/Workflow.js";
+export declare class WorkflowVersionManager {
+    private versions;
+    private latestVersions;
+    register(workflow: WorkflowDefinition): void;
+    get(workflowId: string, version?: string): WorkflowDefinition | undefined;
+    getVersions(workflowId: string): string[];
+    getLatestVersion(workflowId: string): string | undefined;
+    listWorkflows(): string[];
+    deleteVersion(workflowId: string, version: string): boolean;
+    deleteWorkflow(workflowId: string): boolean;
+    private compareVersions;
+    getStats(): {
+        totalWorkflows: number;
+        totalVersions: number;
+        workflows: Array<{
+            id: string;
+            versions: number;
+            latest: string;
+        }>;
+    };
+}
+export declare function getVersionManager(): WorkflowVersionManager;
+export declare function setVersionManager(manager: WorkflowVersionManager): void;