@voyant-travel/workflows-orchestrator 0.113.0 → 0.114.0

package/dist/driver-inmemory.d.ts

@@ -1,5 +1,6 @@
 import type { EnvironmentName } from "@voyant-travel/workflows";
 import { type DriverFactory } from "@voyant-travel/workflows/driver";
+import { type WorkflowResolver } from "@voyant-travel/workflows/handler";
 import type { RunRecord, StepHandler } from "./types.js";
 export interface InMemoryDriverOptions {
     /** Default environment for `trigger()` calls that don't specify one. */
@@ -8,6 +9,13 @@ export interface InMemoryDriverOptions {
     tenantMeta?: RunRecord["tenantMeta"];
     /** Injectable clock; defaults to `Date.now`. */
     now?: () => number;
+    /**
+     * Executable workflow lookup for this driver instance.
+     *
+     * Omitting this dependency is deprecated and falls back to the process-global
+     * authoring registry for backward compatibility with existing consumers.
+     */
+    workflowResolver?: WorkflowResolver;
     /** Step handler override — defaults to in-process `handleStepRequest`. */
     handler?: StepHandler;
     /** Schedule runner tick interval. Defaults to 1_000 ms. */

package/dist/driver-inmemory.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"driver-inmemory.d.ts","sourceRoot":"","sources":["../src/driver-inmemory.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EACV,eAAe,EAMhB,MAAM,0BAA0B,CAAA;AACjC,OAAO,EACL,KAAK,aAAa,EAQnB,MAAM,iCAAiC,CAAA;AAkBxC,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AAIxD,MAAM,WAAW,qBAAqB;IACpC,wEAAwE;IACxE,kBAAkB,CAAC,EAAE,eAAe,CAAA;IACpC,wDAAwD;IACxD,UAAU,CAAC,EAAE,SAAS,CAAC,YAAY,CAAC,CAAA;IACpC,gDAAgD;IAChD,GAAG,CAAC,EAAE,MAAM,MAAM,CAAA;IAClB,0EAA0E;IAC1E,OAAO,CAAC,EAAE,WAAW,CAAA;IACrB,2DAA2D;IAC3D,sBAAsB,CAAC,EAAE,MAAM,CAAA;IAC/B,2EAA2E;IAC3E,qBAAqB,CAAC,EAAE,OAAO,CAAA;CAChC;AAQD;;;;;;;;;;GAUG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,GAAE,qBAA0B,GAAG,aAAa,CA+TpF"}
+{"version":3,"file":"driver-inmemory.d.ts","sourceRoot":"","sources":["../src/driver-inmemory.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EACV,eAAe,EAMhB,MAAM,0BAA0B,CAAA;AAEjC,OAAO,EACL,KAAK,aAAa,EAQnB,MAAM,iCAAiC,CAAA;AAExC,OAAO,EAEL,KAAK,gBAAgB,EAEtB,MAAM,kCAAkC,CAAA;AAgBzC,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AAIxD,MAAM,WAAW,qBAAqB;IACpC,wEAAwE;IACxE,kBAAkB,CAAC,EAAE,eAAe,CAAA;IACpC,wDAAwD;IACxD,UAAU,CAAC,EAAE,SAAS,CAAC,YAAY,CAAC,CAAA;IACpC,gDAAgD;IAChD,GAAG,CAAC,EAAE,MAAM,MAAM,CAAA;IAClB;;;;;OAKG;IACH,gBAAgB,CAAC,EAAE,gBAAgB,CAAA;IACnC,0EAA0E;IAC1E,OAAO,CAAC,EAAE,WAAW,CAAA;IACrB,2DAA2D;IAC3D,sBAAsB,CAAC,EAAE,MAAM,CAAA;IAC/B,2EAA2E;IAC3E,qBAAqB,CAAC,EAAE,OAAO,CAAA;CAChC;AAYD;;;;;;;;;;GAUG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,GAAE,qBAA0B,GAAG,aAAa,CAgUpF"}

package/dist/driver-inmemory.js

@@ -11,9 +11,10 @@
 // call to the factory yields a fresh, isolated driver. No global state.
 //
 // Authoritative architecture: docs/architecture/workflows-runtime-architecture.md §6.
+import { getWorkflow } from "@voyant-travel/workflows";
 import { ManifestNotRegisteredError, } from "@voyant-travel/workflows/driver";
 import { deriveStableEventId } from "@voyant-travel/workflows/events";
-import { handleStepRequest } from "@voyant-travel/workflows/handler";
+import { handleStepRequest, } from "@voyant-travel/workflows/handler";
 import { createInProcessConcurrencyCoordinator, } from "./concurrency.js";
 import { routeEvent } from "./event-router.js";
 import { createInMemoryRunStore } from "./in-memory-store.js";
@@ -24,6 +25,9 @@ const DEFAULT_TENANT_META = {
     projectId: "default",
     organizationId: "default",
 };
+const legacyWorkflowResolver = {
+    resolve: getWorkflow,
+};
 /**
  * Build an in-memory driver factory. The factory closes over its
  * options and returns a fresh `WorkflowDriver` when `createApp()`
@@ -43,11 +47,12 @@ export function createInMemoryDriver(opts = {}) {
         const now = opts.now ?? deps.now ?? (() => Date.now());
         const tenantMeta = opts.tenantMeta ?? DEFAULT_TENANT_META;
         const defaultEnv = opts.defaultEnvironment ?? "development";
+        const workflowResolver = opts.workflowResolver ?? legacyWorkflowResolver;
         // Wire the framework-supplied service container through to step bodies.
         // The handler closes over `deps.services` so every step invocation
         // surfaces it as `ctx.services` inside the workflow body.
         const handler = opts.handler ??
-            (async (req, stepOpts) => handleStepRequest(req, { services: deps.services }, stepOpts));
+            (async (req, stepOpts) => handleStepRequest(req, { workflowResolver, services: deps.services }, stepOpts));
         let shuttingDown = false;
         const concurrency = createInProcessConcurrencyCoordinator({
             async cancelRun(runId, reason) {

package/dist/node/node-selfhost-deps.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"node-selfhost-deps.d.ts","sourceRoot":"","sources":["../../src/node/node-selfhost-deps.ts"],"names":[],"mappings":"AAoBA,OAAO,KAAK,EAEV,qBAAqB,EACrB,SAAS,EACT,WAAW,EACZ,MAAM,sBAAsB,CAAA;AAwB7B,wBAAsB,mBAAmB,CAAC,IAAI,EAAE,qBAAqB,GAAG,OAAO,CAAC,WAAW,CAAC,CAS3F;AAED,wBAAsB,kBAAkB,CACtC,IAAI,EAAE,IAAI,CACR,qBAAqB,EACnB,WAAW,GACX,WAAW,GACX,gBAAgB,GAChB,UAAU,GACV,OAAO,GACP,aAAa,GACb,sBAAsB,GACtB,eAAe,GACf,kBAAkB,CACrB,GACA,OAAO,CAAC,SAAS,CAAC,CAkapB"}
+{"version":3,"file":"node-selfhost-deps.d.ts","sourceRoot":"","sources":["../../src/node/node-selfhost-deps.ts"],"names":[],"mappings":"AAoBA,OAAO,KAAK,EAEV,qBAAqB,EACrB,SAAS,EACT,WAAW,EACZ,MAAM,sBAAsB,CAAA;AAwB7B,wBAAsB,mBAAmB,CAAC,IAAI,EAAE,qBAAqB,GAAG,OAAO,CAAC,WAAW,CAAC,CAS3F;AAED,wBAAsB,kBAAkB,CACtC,IAAI,EAAE,IAAI,CACR,qBAAqB,EACnB,WAAW,GACX,WAAW,GACX,gBAAgB,GAChB,UAAU,GACV,OAAO,GACP,aAAa,GACb,sBAAsB,GACtB,eAAe,GACf,kBAAkB,CACrB,GACA,OAAO,CAAC,SAAS,CAAC,CAuapB"}

package/dist/node/node-selfhost-deps.js

@@ -47,12 +47,17 @@ export async function createSelfHostDeps(opts) {
     await assertReadableFile(entryAbs, "workflow entry");
     await loadEntryFile(entryAbs, { cacheBust: opts.cacheBustEntry });
     const _handlerMod = await import("@voyant-travel/workflows/handler");
+    const workflowDefinitions = wfMod.__listRegisteredWorkflows();
+    const workflowsById = new Map(workflowDefinitions.map((workflow) => [workflow.id, workflow]));
+    const workflowResolver = {
+        resolve: (workflowId) => workflowsById.get(workflowId),
+    };
     const rateLimiter = createInMemoryRateLimiter();
     const chunkBus = createChunkBus();
-    const stepHandler = async (req, stepOpts) => handleStepRequest(req, { rateLimiter, services: opts.services }, stepOpts);
+    const stepHandler = async (req, stepOpts) => handleStepRequest(req, { workflowResolver, rateLimiter, services: opts.services }, stepOpts);
     const wakeupStore = pg ? createPostgresWakeupStore({ db: pg.db }) : createFsWakeupStore();
     const leaseOwner = opts.wakeupLeaseOwner ?? createDefaultWakeupLeaseOwner();
-    const listWorkflows = () => wfMod.__listRegisteredWorkflows().map((workflow) => ({
+    const listWorkflows = () => workflowDefinitions.map((workflow) => ({
         id: workflow.id,
         description: workflow.config.description,
     }));
@@ -162,7 +167,7 @@ export async function createSelfHostDeps(opts) {
         return { ok: true, saved };
     };
     const triggerRun = async ({ workflowId, input, runId, tags, triggeredByUserId, }) => {
-        const workflow = wfMod.__listRegisteredWorkflows().find((entry) => entry.id === workflowId);
+        const workflow = workflowResolver.resolve(workflowId);
         if (!workflow) {
             return {
                 ok: false,
@@ -231,7 +236,7 @@ export async function createSelfHostDeps(opts) {
             };
         }
         const workflowId = parent?.workflowId ?? requestedWorkflowId;
-        const workflow = wfMod.__listRegisteredWorkflows().find((entry) => entry.id === workflowId);
+        const workflow = workflowResolver.resolve(workflowId);
         if (!workflow) {
             return {
                 ok: false,

package/dist/node/node-standalone-driver.d.ts

@@ -1,4 +1,5 @@
 import type { DriverFactory } from "@voyant-travel/workflows/driver";
+import { type WorkflowResolver } from "@voyant-travel/workflows/handler";
 import type { drizzle } from "drizzle-orm/node-postgres";
 import { type RunRecord, type StepHandler } from "./core.js";
 type Db = ReturnType<typeof drizzle>;
@@ -11,6 +12,13 @@ export interface StandaloneDriverOptions {
     tenantMeta?: RunRecord["tenantMeta"];
     /** Injectable clock; defaults to `Date.now`. */
     now?: () => number;
+    /**
+     * Executable workflow lookup for this driver instance.
+     *
+     * Omitting this dependency is deprecated and falls back to the process-global
+     * authoring registry for backward compatibility with existing consumers.
+     */
+    workflowResolver?: WorkflowResolver;
     /**
      * Step handler override. Defaults to in-process `handleStepRequest`
      * with the framework-supplied `services` container plumbed through

package/dist/node/node-standalone-driver.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"node-standalone-driver.d.ts","sourceRoot":"","sources":["../../src/node/node-standalone-driver.ts"],"names":[],"mappings":"AA2BA,OAAO,KAAK,EACV,aAAa,EAOd,MAAM,iCAAiC,CAAA;AAIxC,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,2BAA2B,CAAA;AACxD,OAAO,EAML,KAAK,SAAS,EAId,KAAK,WAAW,EAEjB,MAAM,WAAW,CAAA;AAWlB,KAAK,EAAE,GAAG,UAAU,CAAC,OAAO,OAAO,CAAC,CAAA;AAIpC,MAAM,WAAW,uBAAuB;IACtC,4EAA4E;IAC5E,EAAE,EAAE,EAAE,CAAA;IACN,wEAAwE;IACxE,kBAAkB,CAAC,EAAE,YAAY,GAAG,SAAS,GAAG,aAAa,CAAA;IAC7D,wDAAwD;IACxD,UAAU,CAAC,EAAE,SAAS,CAAC,YAAY,CAAC,CAAA;IACpC,gDAAgD;IAChD,GAAG,CAAC,EAAE,MAAM,MAAM,CAAA;IAClB;;;;OAIG;IACH,OAAO,CAAC,EAAE,WAAW,CAAA;IACrB;;;;OAIG;IACH,sBAAsB,CAAC,EAAE,MAAM,CAAA;IAC/B;;;;;OAKG;IACH,oBAAoB,CAAC,EAAE,MAAM,CAAA;IAC7B;;;;;OAKG;IACH,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB;;;OAGG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB;;;;;OAKG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAA;IAC1B,2DAA2D;IAC3D,sBAAsB,CAAC,EAAE,MAAM,CAAA;IAC/B,2EAA2E;IAC3E,qBAAqB,CAAC,EAAE,OAAO,CAAA;CAChC;AA+FD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,uBAAuB,GAAG,aAAa,CAuXnF"}
+{"version":3,"file":"node-standalone-driver.d.ts","sourceRoot":"","sources":["../../src/node/node-standalone-driver.ts"],"names":[],"mappings":"AA4BA,OAAO,KAAK,EACV,aAAa,EAOd,MAAM,iCAAiC,CAAA;AAExC,OAAO,EAEL,KAAK,gBAAgB,EAEtB,MAAM,kCAAkC,CAAA;AAEzC,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,2BAA2B,CAAA;AACxD,OAAO,EAML,KAAK,SAAS,EAId,KAAK,WAAW,EAEjB,MAAM,WAAW,CAAA;AAWlB,KAAK,EAAE,GAAG,UAAU,CAAC,OAAO,OAAO,CAAC,CAAA;AAIpC,MAAM,WAAW,uBAAuB;IACtC,4EAA4E;IAC5E,EAAE,EAAE,EAAE,CAAA;IACN,wEAAwE;IACxE,kBAAkB,CAAC,EAAE,YAAY,GAAG,SAAS,GAAG,aAAa,CAAA;IAC7D,wDAAwD;IACxD,UAAU,CAAC,EAAE,SAAS,CAAC,YAAY,CAAC,CAAA;IACpC,gDAAgD;IAChD,GAAG,CAAC,EAAE,MAAM,MAAM,CAAA;IAClB;;;;;OAKG;IACH,gBAAgB,CAAC,EAAE,gBAAgB,CAAA;IACnC;;;;OAIG;IACH,OAAO,CAAC,EAAE,WAAW,CAAA;IACrB;;;;OAIG;IACH,sBAAsB,CAAC,EAAE,MAAM,CAAA;IAC/B;;;;;OAKG;IACH,oBAAoB,CAAC,EAAE,MAAM,CAAA;IAC7B;;;;;OAKG;IACH,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB;;;OAGG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB;;;;;OAKG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAA;IAC1B,2DAA2D;IAC3D,sBAAsB,CAAC,EAAE,MAAM,CAAA;IAC/B,2EAA2E;IAC3E,qBAAqB,CAAC,EAAE,OAAO,CAAA;CAChC;AAmGD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,uBAAuB,GAAG,aAAa,CAwXnF"}

package/dist/node/node-standalone-driver.js

@@ -17,8 +17,9 @@
 // `createApp()` — by the framework's bootstrap.
 //
 // See docs/architecture/workflows-runtime-architecture.md.
+import { getWorkflow } from "@voyant-travel/workflows";
 import { deriveStableEventId } from "@voyant-travel/workflows/events";
-import { handleStepRequest } from "@voyant-travel/workflows/handler";
+import { handleStepRequest, } from "@voyant-travel/workflows/handler";
 import { createInProcessConcurrencyCoordinator, createScheduler, manifestScheduleSources, cancel as orchestratorCancel, trigger as orchestratorTrigger, routeEvent, } from "./core.js";
 import { createPersistentWakeupManager, } from "./persistent-wakeup-manager.js";
 import { createPostgresManifestStore } from "./postgres-manifest-store.js";
@@ -31,6 +32,9 @@ const DEFAULT_TENANT_META = {
     organizationId: "default",
 };
 const DEFAULT_MANIFEST_KEEP = 3;
+const legacyWorkflowResolver = {
+    resolve: getWorkflow,
+};
 function serializeWorkflowManifest(manifest) {
     return { ...manifest };
 }
@@ -121,11 +125,12 @@ export function createStandaloneDriver(opts) {
         const defaultEnv = opts.defaultEnvironment ?? "development";
         const keep = opts.manifestVersionsToKeep ?? DEFAULT_MANIFEST_KEEP;
         const leaseOwner = opts.wakeupLeaseOwner ?? `selfhost-standalone-${randomToken()}`;
+        const workflowResolver = opts.workflowResolver ?? legacyWorkflowResolver;
         // Wire the framework-supplied service container through to step bodies.
         // The handler closes over `deps.services` so every step invocation
         // surfaces it as `ctx.services` inside the workflow body.
         const handler = opts.handler ??
-            (async (req, stepOpts) => handleStepRequest(req, { services: deps.services }, stepOpts));
+            (async (req, stepOpts) => handleStepRequest(req, { workflowResolver, services: deps.services }, stepOpts));
         // Persistent wakeup manager — polls `voyant_wakeups` for runs
         // parked on DATETIME waitpoints and resumes them via the orchestrator's
         // `resumeDueAlarms`. This is what makes `ctx.sleep(...)` actually

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@voyant-travel/workflows-orchestrator",
-  "version": "0.113.0",
+  "version": "0.114.0",
   "description": "Postgres self-host orchestrator runtime for Voyant Workflows — drives runs through the tenant step handler over the v1 wire protocol.",
   "license": "Apache-2.0",
   "repository": {
@@ -49,7 +49,7 @@
   "dependencies": {
     "drizzle-orm": "^0.45.2",
     "pg": "^8.22.0",
-    "@voyant-travel/workflows": "^0.113.0"
+    "@voyant-travel/workflows": "^0.114.0"
   },
   "devDependencies": {
     "@types/node": "^25.5.2",

package/src/__tests__/orchestrator-test-support.ts

@@ -1,10 +1,18 @@
-import { __resetRegistry } from "@voyant-travel/workflows"
-import { handleStepRequest, type WorkflowStepRequest } from "@voyant-travel/workflows/handler"
+import { __resetRegistry, getWorkflow } from "@voyant-travel/workflows"
+import {
+  handleStepRequest,
+  type WorkflowResolver,
+  type WorkflowStepRequest,
+} from "@voyant-travel/workflows/handler"
 import { beforeEach } from "vitest"
 import type { StepHandler } from "../index.js"
 
+export const workflowResolver: WorkflowResolver = {
+  resolve: (workflowId) => getWorkflow(workflowId),
+}
+
 export const handler: StepHandler = async (req: WorkflowStepRequest, opts) => {
-  return await handleStepRequest(req, {}, opts)
+  return await handleStepRequest(req, { workflowResolver }, opts)
 }
 
 export const tenantMeta = {

package/src/driver-inmemory.ts

@@ -20,6 +20,7 @@ import type {
   RunSummary,
   TriggerOptions,
 } from "@voyant-travel/workflows"
+import { getWorkflow } from "@voyant-travel/workflows"
 import {
   type DriverFactory,
   type DriverFactoryDeps,
@@ -31,7 +32,11 @@ import {
   type WorkflowDriver,
 } from "@voyant-travel/workflows/driver"
 import { deriveStableEventId } from "@voyant-travel/workflows/events"
-import { handleStepRequest, type WorkflowStepRequest } from "@voyant-travel/workflows/handler"
+import {
+  handleStepRequest,
+  type WorkflowResolver,
+  type WorkflowStepRequest,
+} from "@voyant-travel/workflows/handler"
 import type { WorkflowManifest } from "@voyant-travel/workflows/protocol"
 
 import {
@@ -58,6 +63,13 @@ export interface InMemoryDriverOptions {
   tenantMeta?: RunRecord["tenantMeta"]
   /** Injectable clock; defaults to `Date.now`. */
   now?: () => number
+  /**
+   * Executable workflow lookup for this driver instance.
+   *
+   * Omitting this dependency is deprecated and falls back to the process-global
+   * authoring registry for backward compatibility with existing consumers.
+   */
+  workflowResolver?: WorkflowResolver
   /** Step handler override — defaults to in-process `handleStepRequest`. */
   handler?: StepHandler
   /** Schedule runner tick interval. Defaults to 1_000 ms. */
@@ -72,6 +84,10 @@ const DEFAULT_TENANT_META: RunRecord["tenantMeta"] = {
   organizationId: "default",
 }
 
+const legacyWorkflowResolver: WorkflowResolver = {
+  resolve: getWorkflow,
+}
+
 /**
  * Build an in-memory driver factory. The factory closes over its
  * options and returns a fresh `WorkflowDriver` when `createApp()`
@@ -91,13 +107,14 @@ export function createInMemoryDriver(opts: InMemoryDriverOptions = {}): DriverFa
     const now = opts.now ?? deps.now ?? (() => Date.now())
     const tenantMeta = opts.tenantMeta ?? DEFAULT_TENANT_META
     const defaultEnv: EnvironmentName = opts.defaultEnvironment ?? "development"
+    const workflowResolver = opts.workflowResolver ?? legacyWorkflowResolver
     // Wire the framework-supplied service container through to step bodies.
     // The handler closes over `deps.services` so every step invocation
     // surfaces it as `ctx.services` inside the workflow body.
     const handler: StepHandler =
       opts.handler ??
       (async (req: WorkflowStepRequest, stepOpts) =>
-        handleStepRequest(req, { services: deps.services }, stepOpts))
+        handleStepRequest(req, { workflowResolver, services: deps.services }, stepOpts))
 
     let shuttingDown = false
     const concurrency = createInProcessConcurrencyCoordinator({

package/src/node/node-selfhost-deps.ts

@@ -1,6 +1,6 @@
 import { createServer } from "node:http"
 import { resolve as resolvePath } from "node:path"
-import { handleStepRequest } from "@voyant-travel/workflows/handler"
+import { handleStepRequest, type WorkflowResolver } from "@voyant-travel/workflows/handler"
 import { createInMemoryRateLimiter } from "@voyant-travel/workflows/rate-limit"
 import {
   createInMemoryRunStore,
@@ -94,17 +94,22 @@ export async function createSelfHostDeps(
   await loadEntryFile(entryAbs, { cacheBust: opts.cacheBustEntry })
 
   const _handlerMod = await import("@voyant-travel/workflows/handler")
+  const workflowDefinitions = wfMod.__listRegisteredWorkflows()
+  const workflowsById = new Map(workflowDefinitions.map((workflow) => [workflow.id, workflow]))
+  const workflowResolver: WorkflowResolver = {
+    resolve: (workflowId) => workflowsById.get(workflowId),
+  }
   const rateLimiter = createInMemoryRateLimiter()
   const chunkBus = createChunkBus()
 
   const stepHandler: StepHandler = async (req, stepOpts) =>
-    handleStepRequest(req, { rateLimiter, services: opts.services }, stepOpts)
+    handleStepRequest(req, { workflowResolver, rateLimiter, services: opts.services }, stepOpts)
 
   const wakeupStore = pg ? createPostgresWakeupStore({ db: pg.db }) : createFsWakeupStore()
   const leaseOwner = opts.wakeupLeaseOwner ?? createDefaultWakeupLeaseOwner()
 
   const listWorkflows = () =>
-    wfMod.__listRegisteredWorkflows().map((workflow) => ({
+    workflowDefinitions.map((workflow) => ({
       id: workflow.id,
       description: workflow.config.description,
     }))
@@ -227,7 +232,7 @@ export async function createSelfHostDeps(
     tags,
     triggeredByUserId,
   }) => {
-    const workflow = wfMod.__listRegisteredWorkflows().find((entry) => entry.id === workflowId)
+    const workflow = workflowResolver.resolve(workflowId)
     if (!workflow) {
       return {
         ok: false,
@@ -309,7 +314,7 @@ export async function createSelfHostDeps(
     }
 
     const workflowId = parent?.workflowId ?? requestedWorkflowId!
-    const workflow = wfMod.__listRegisteredWorkflows().find((entry) => entry.id === workflowId)
+    const workflow = workflowResolver.resolve(workflowId)
     if (!workflow) {
       return {
         ok: false,

package/src/node/node-standalone-driver.ts

@@ -25,6 +25,7 @@ import type {
   RunSummary,
   TriggerOptions,
 } from "@voyant-travel/workflows"
+import { getWorkflow } from "@voyant-travel/workflows"
 import type {
   DriverFactory,
   DriverFactoryDeps,
@@ -35,7 +36,11 @@ import type {
   WorkflowDriver,
 } from "@voyant-travel/workflows/driver"
 import { deriveStableEventId } from "@voyant-travel/workflows/events"
-import { handleStepRequest, type WorkflowStepRequest } from "@voyant-travel/workflows/handler"
+import {
+  handleStepRequest,
+  type WorkflowResolver,
+  type WorkflowStepRequest,
+} from "@voyant-travel/workflows/handler"
 import type { WorkflowManifest } from "@voyant-travel/workflows/protocol"
 import type { drizzle } from "drizzle-orm/node-postgres"
 import {
@@ -74,6 +79,13 @@ export interface StandaloneDriverOptions {
   tenantMeta?: RunRecord["tenantMeta"]
   /** Injectable clock; defaults to `Date.now`. */
   now?: () => number
+  /**
+   * Executable workflow lookup for this driver instance.
+   *
+   * Omitting this dependency is deprecated and falls back to the process-global
+   * authoring registry for backward compatibility with existing consumers.
+   */
+  workflowResolver?: WorkflowResolver
   /**
    * Step handler override. Defaults to in-process `handleStepRequest`
    * with the framework-supplied `services` container plumbed through
@@ -126,6 +138,10 @@ const DEFAULT_TENANT_META: RunRecord["tenantMeta"] = {
 
 const DEFAULT_MANIFEST_KEEP = 3
 
+const legacyWorkflowResolver: WorkflowResolver = {
+  resolve: getWorkflow,
+}
+
 function serializeWorkflowManifest(manifest: WorkflowManifest): Record<string, unknown> {
   return { ...manifest }
 }
@@ -238,6 +254,7 @@ export function createStandaloneDriver(opts: StandaloneDriverOptions): DriverFac
     const defaultEnv = opts.defaultEnvironment ?? "development"
     const keep = opts.manifestVersionsToKeep ?? DEFAULT_MANIFEST_KEEP
     const leaseOwner = opts.wakeupLeaseOwner ?? `selfhost-standalone-${randomToken()}`
+    const workflowResolver = opts.workflowResolver ?? legacyWorkflowResolver
 
     // Wire the framework-supplied service container through to step bodies.
     // The handler closes over `deps.services` so every step invocation
@@ -245,7 +262,7 @@ export function createStandaloneDriver(opts: StandaloneDriverOptions): DriverFac
     const handler: StepHandler =
       opts.handler ??
       (async (req: WorkflowStepRequest, stepOpts) =>
-        handleStepRequest(req, { services: deps.services }, stepOpts))
+        handleStepRequest(req, { workflowResolver, services: deps.services }, stepOpts))
 
     // Persistent wakeup manager — polls `voyant_wakeups` for runs
     // parked on DATETIME waitpoints and resumes them via the orchestrator's