@voyantjs/workflows-orchestrator-node 0.30.3 → 0.30.5

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

@@ -49,6 +49,10 @@ export interface NodeStandaloneDriverOptions {
      * cadence. Defaults to `false` (poller starts immediately).
      */
     disableTimeWheel?: boolean;
+    /** Schedule runner tick interval. Defaults to 1_000 ms. */
+    schedulePollIntervalMs?: number;
+    /** Disable automatic firing for schedules registered through manifests. */
+    disableScheduleRunner?: boolean;
 }
 /**
  * Build the Mode 2 driver factory. The factory closes over its options

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

@@ -1 +1 @@
-{"version":3,"file":"node-standalone-driver.d.ts","sourceRoot":"","sources":["../src/node-standalone-driver.ts"],"names":[],"mappings":"AA0BA,OAAO,KAAK,EACV,aAAa,EAOd,MAAM,4BAA4B,CAAA;AAInC,OAAO,EAGL,KAAK,SAAS,EAEd,KAAK,WAAW,EACjB,MAAM,kCAAkC,CAAA;AACzC,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,2BAA2B,CAAA;AAWxD,KAAK,EAAE,GAAG,UAAU,CAAC,OAAO,OAAO,CAAC,CAAA;AAIpC,MAAM,WAAW,2BAA2B;IAC1C,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;CAC3B;AAUD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,2BAA2B,GAAG,aAAa,CA+R3F"}
+{"version":3,"file":"node-standalone-driver.d.ts","sourceRoot":"","sources":["../src/node-standalone-driver.ts"],"names":[],"mappings":"AA0BA,OAAO,KAAK,EACV,aAAa,EAOd,MAAM,4BAA4B,CAAA;AAInC,OAAO,EAML,KAAK,SAAS,EAId,KAAK,WAAW,EAEjB,MAAM,kCAAkC,CAAA;AACzC,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,2BAA2B,CAAA;AAWxD,KAAK,EAAE,GAAG,UAAU,CAAC,OAAO,OAAO,CAAC,CAAA;AAIpC,MAAM,WAAW,2BAA2B;IAC1C,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;AAUD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,2BAA2B,GAAG,aAAa,CAuX3F"}

package/dist/node-standalone-driver.js

@@ -18,7 +18,7 @@
 // See architecture doc §7 for the full Mode 2 design.
 import { deriveStableEventId } from "@voyantjs/workflows/events";
 import { handleStepRequest } from "@voyantjs/workflows/handler";
-import { cancel as orchestratorCancel, trigger as orchestratorTrigger, routeEvent, } from "@voyantjs/workflows-orchestrator";
+import { createInProcessConcurrencyCoordinator, createScheduler, manifestScheduleSources, cancel as orchestratorCancel, trigger as orchestratorTrigger, routeEvent, } from "@voyantjs/workflows-orchestrator";
 import { createPersistentWakeupManager, } from "./persistent-wakeup-manager.js";
 import { createPostgresManifestStore } from "./postgres-manifest-store.js";
 import { createPostgresRunRecordStore } from "./postgres-run-record-store.js";
@@ -98,7 +98,16 @@ export function createNodeStandaloneDriver(opts) {
             // via `manager.poll()`).
             wakeupManager.start();
         }
+        const scheduleRunners = new Map();
         let shuttingDown = false;
+        const concurrency = createInProcessConcurrencyCoordinator({
+            async cancelRun(runId, reason) {
+                const out = await orchestratorCancel({ runId, reason }, { store: runStore, handler, now });
+                if (out.ok && isTerminal(out.record.status)) {
+                    concurrency.releaseRun(out.record);
+                }
+            },
+        });
         // ---- WorkflowDriver implementation ----
         async function registerManifest(args) {
             assertNotShutdown(shuttingDown);
@@ -117,6 +126,7 @@ export function createNodeStandaloneDriver(opts) {
                     error: err instanceof Error ? err.message : String(err),
                 });
             }
+            startScheduleRunner(args.environment, args.manifest);
             return result;
         }
         async function getManifest(args) {
@@ -129,7 +139,8 @@ export function createNodeStandaloneDriver(opts) {
             assertNotShutdown(shuttingDown);
             const workflowId = typeof workflow === "string" ? workflow : workflow.id;
             const env = triggerOpts?.environment ?? defaultEnv;
-            const record = await orchestratorTrigger({
+            const policy = await resolveConcurrencyPolicy(workflow, workflowId, env, getManifest);
+            const record = await triggerRecord({
                 workflowId,
                 workflowVersion: triggerOpts?.lockToVersion ?? "v1",
                 input: input,
@@ -139,7 +150,7 @@ export function createNodeStandaloneDriver(opts) {
                 idempotencyKey: triggerOpts?.idempotencyKey,
                 delay: triggerOpts?.delay,
                 priority: triggerOpts?.priority,
-            }, { store: runStore, handler, now });
+            }, policy);
             // Sync wakeup row so the time-wheel can resume DATETIME-parked runs.
             // No-op if the run completed inline (status !== "waiting").
             await syncWakeupFromRecord(wakeupStore, record);
@@ -177,7 +188,7 @@ export function createNodeStandaloneDriver(opts) {
                     continue;
                 }
                 try {
-                    const record = await orchestratorTrigger({
+                    const record = await triggerRecord({
                         workflowId: entry.targetWorkflowId,
                         workflowVersion: "v1",
                         input: entry.input,
@@ -190,7 +201,7 @@ export function createNodeStandaloneDriver(opts) {
                             eventType: args.envelope.name,
                             filterId: entry.filterId,
                         },
-                    }, { store: runStore, handler, now });
+                    }, await resolveConcurrencyPolicy(entry.targetWorkflowId, entry.targetWorkflowId, args.environment, getManifest));
                     await syncWakeupFromRecord(wakeupStore, record);
                     matches.push({
                         filterId: entry.filterId,
@@ -226,6 +237,55 @@ export function createNodeStandaloneDriver(opts) {
             // Idempotent — calling stop() on an already-stopped manager is a
             // no-op.
             wakeupManager.stop();
+            for (const runner of scheduleRunners.values()) {
+                runner.stop();
+            }
+            scheduleRunners.clear();
+        }
+        function startScheduleRunner(environment, manifest) {
+            const existing = scheduleRunners.get(environment);
+            existing?.stop();
+            scheduleRunners.delete(environment);
+            if (opts.disableScheduleRunner)
+                return;
+            const sources = manifestScheduleSources(manifest);
+            if (sources.length === 0)
+                return;
+            const runner = createScheduler({
+                sources,
+                environment,
+                now,
+                tickMs: opts.schedulePollIntervalMs,
+                onFire: async ({ workflowId, input, scheduleId, fireAt }) => {
+                    assertNotShutdown(shuttingDown);
+                    const record = await triggerRecord({
+                        workflowId,
+                        workflowVersion: "v1",
+                        input,
+                        tenantMeta,
+                        environment,
+                        idempotencyKey: `${scheduleId}:${fireAt}`,
+                        triggeredBy: { kind: "schedule", scheduleId },
+                    }, await resolveConcurrencyPolicy(workflowId, workflowId, environment, getManifest));
+                    await syncWakeupFromRecord(wakeupStore, record);
+                },
+                logger: (level, msg, data) => deps.logger(level, msg, data),
+            });
+            if (runner.sourceCount() === 0)
+                return;
+            runner.start();
+            scheduleRunners.set(environment, runner);
+        }
+        async function triggerRecord(args, policy) {
+            return concurrency.run({
+                workflowId: args.workflowId,
+                input: args.input,
+                policy,
+                holderId: concurrencyHolderId(args),
+            }, (hooks) => orchestratorTrigger({
+                ...args,
+                onRunRecordCreated: hooks.onRunRecordCreated,
+            }, { store: runStore, handler, now }));
         }
         // ---- WorkflowAdmin (full; Mode 2 has Postgres-native query support) ----
         const admin = {
@@ -272,7 +332,10 @@ export function createNodeStandaloneDriver(opts) {
                 // default (architecture doc §21.21). The `compensate` flag is
                 // accepted but no-ops in v1.
                 void cancelOpts?.compensate;
-                await orchestratorCancel({ runId, reason: cancelOpts?.reason }, { store: runStore, handler, now });
+                const out = await orchestratorCancel({ runId, reason: cancelOpts?.reason }, { store: runStore, handler, now });
+                if (out.ok && isTerminal(out.record.status)) {
+                    concurrency.releaseRun(out.record);
+                }
             },
             streamRun(runId) {
                 // Live journal-event streaming is a follow-up — needs LISTEN/NOTIFY
@@ -306,6 +369,27 @@ function assertNotShutdown(shuttingDown) {
         throw new Error("NodeStandaloneDriver: shutdown() has been called; new operations are refused.");
     }
 }
+async function resolveConcurrencyPolicy(workflow, workflowId, environment, getManifest) {
+    if (typeof workflow !== "string" && workflow.config?.concurrency) {
+        return workflow.config.concurrency;
+    }
+    const manifest = await getManifest({ environment });
+    return manifest?.workflows.find((entry) => entry.id === workflowId)?.concurrency;
+}
+function isTerminal(status) {
+    return (status === "completed" ||
+        status === "failed" ||
+        status === "cancelled" ||
+        status === "compensated" ||
+        status === "compensation_failed");
+}
+function concurrencyHolderId(args) {
+    if (args.runId !== undefined)
+        return args.runId;
+    if (args.idempotencyKey !== undefined)
+        return `idem-${args.workflowId}-${args.idempotencyKey}`;
+    return undefined;
+}
 function randomToken() {
     return Math.floor(Math.random() * 1_000_000_000)
         .toString(36)

package/dist/scheduler.d.ts

@@ -1,34 +1,2 @@
-import type { EnvironmentName, ScheduleDeclaration } from "@voyantjs/workflows";
-export { type CronSpec, computeNextFire, nextCronFire, parseCron, toMs, } from "@voyantjs/workflows-orchestrator";
-export interface ScheduleSource {
-    workflowId: string;
-    decl: ScheduleDeclaration;
-}
-export interface SchedulerDeps {
-    sources: readonly ScheduleSource[];
-    onFire: (args: {
-        workflowId: string;
-        input: unknown;
-        scheduleName?: string;
-    }) => Promise<void>;
-    now?: () => number;
-    environment?: EnvironmentName;
-    tickMs?: number;
-    setInterval?: typeof setInterval;
-    clearInterval?: typeof clearInterval;
-    logger?: (level: "info" | "warn" | "error", msg: string, data?: object) => void;
-}
-export interface SchedulerHandle {
-    start: () => void;
-    stop: () => void;
-    tick: () => Promise<void>;
-    nextFirings: () => {
-        workflowId: string;
-        name?: string;
-        nextAt: number;
-        done: boolean;
-    }[];
-    sourceCount: () => number;
-}
-export declare function createScheduler(deps: SchedulerDeps): SchedulerHandle;
+export { type CronSpec, computeNextFire, createScheduler, manifestScheduleSources, nextCronFire, parseCron, type SchedulableDeclaration, type SchedulerDeps, type SchedulerHandle, type ScheduleSource, toMs, } from "@voyantjs/workflows-orchestrator";
 //# sourceMappingURL=scheduler.d.ts.map

package/dist/scheduler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"scheduler.d.ts","sourceRoot":"","sources":["../src/scheduler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAA;AAG/E,OAAO,EACL,KAAK,QAAQ,EACb,eAAe,EACf,YAAY,EACZ,SAAS,EACT,IAAI,GACL,MAAM,kCAAkC,CAAA;AAEzC,MAAM,WAAW,cAAc;IAC7B,UAAU,EAAE,MAAM,CAAA;IAClB,IAAI,EAAE,mBAAmB,CAAA;CAC1B;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,SAAS,cAAc,EAAE,CAAA;IAClC,MAAM,EAAE,CAAC,IAAI,EAAE;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,OAAO,CAAC;QAAC,YAAY,CAAC,EAAE,MAAM,CAAA;KAAE,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IAC9F,GAAG,CAAC,EAAE,MAAM,MAAM,CAAA;IAClB,WAAW,CAAC,EAAE,eAAe,CAAA;IAC7B,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,WAAW,CAAC,EAAE,OAAO,WAAW,CAAA;IAChC,aAAa,CAAC,EAAE,OAAO,aAAa,CAAA;IACpC,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,KAAK,IAAI,CAAA;CAChF;AAED,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,IAAI,CAAA;IACjB,IAAI,EAAE,MAAM,IAAI,CAAA;IAChB,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;IACzB,WAAW,EAAE,MAAM;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,OAAO,CAAA;KAAE,EAAE,CAAA;IACzF,WAAW,EAAE,MAAM,MAAM,CAAA;CAC1B;AASD,wBAAgB,eAAe,CAAC,IAAI,EAAE,aAAa,GAAG,eAAe,CAsGpE"}
+{"version":3,"file":"scheduler.d.ts","sourceRoot":"","sources":["../src/scheduler.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,QAAQ,EACb,eAAe,EACf,eAAe,EACf,uBAAuB,EACvB,YAAY,EACZ,SAAS,EACT,KAAK,sBAAsB,EAC3B,KAAK,aAAa,EAClB,KAAK,eAAe,EACpB,KAAK,cAAc,EACnB,IAAI,GACL,MAAM,kCAAkC,CAAA"}

package/dist/scheduler.js

@@ -1,111 +1 @@
-import { computeNextFire } from "@voyantjs/workflows-orchestrator";
-export { computeNextFire, nextCronFire, parseCron, toMs, } from "@voyantjs/workflows-orchestrator";
-export function createScheduler(deps) {
-    const now = deps.now ?? (() => Date.now());
-    const tickMs = deps.tickMs ?? 1_000;
-    const setInt = deps.setInterval ?? setInterval;
-    const clearInt = deps.clearInterval ?? clearInterval;
-    const env = deps.environment ?? "development";
-    const log = deps.logger ?? (() => { });
-    const states = [];
-    for (const source of deps.sources) {
-        if (source.decl.enabled === false)
-            continue;
-        if (source.decl.environments && !source.decl.environments.includes(env))
-            continue;
-        let firstAt;
-        try {
-            firstAt = computeNextFire(source.decl, now());
-        }
-        catch (err) {
-            log("warn", `scheduler: skipping source for workflow "${source.workflowId}": ${String(err)}`);
-            continue;
-        }
-        states.push({ source, nextAt: firstAt, done: false, inFlight: false });
-    }
-    let timer;
-    const advanceAfterFire = (state, firedAt) => {
-        if ("at" in state.source.decl) {
-            state.done = true;
-            return;
-        }
-        try {
-            state.nextAt = computeNextFire(state.source.decl, firedAt);
-        }
-        catch (err) {
-            log("error", `scheduler: cannot compute next fire for "${state.source.workflowId}": ${String(err)}`);
-            state.done = true;
-        }
-    };
-    const doTick = async () => {
-        const t = now();
-        const ready = states.filter((state) => !state.done && state.nextAt <= t);
-        for (const state of ready) {
-            const overlap = state.source.decl.overlap ?? "skip";
-            if (state.inFlight && overlap === "skip")
-                continue;
-            let input;
-            try {
-                input = await resolveInput(state.source.decl.input);
-            }
-            catch (err) {
-                log("error", `scheduler: failed to resolve input for "${state.source.workflowId}": ${String(err)}`);
-                advanceAfterFire(state, t);
-                continue;
-            }
-            state.inFlight = true;
-            const firePromise = (async () => {
-                try {
-                    await deps.onFire({
-                        workflowId: state.source.workflowId,
-                        input,
-                        scheduleName: state.source.decl.name,
-                    });
-                }
-                catch (err) {
-                    log("error", `scheduler: onFire threw for "${state.source.workflowId}": ${String(err)}`);
-                }
-                finally {
-                    state.inFlight = false;
-                }
-            })();
-            advanceAfterFire(state, t);
-            if (overlap === "skip")
-                await firePromise;
-        }
-    };
-    return {
-        start() {
-            if (timer)
-                return;
-            timer = setInt(() => {
-                doTick().catch(() => { });
-            }, tickMs);
-            timer.unref?.();
-        },
-        stop() {
-            if (!timer)
-                return;
-            clearInt(timer);
-            timer = undefined;
-        },
-        tick: doTick,
-        nextFirings() {
-            return states.map((state) => ({
-                workflowId: state.source.workflowId,
-                name: state.source.decl.name,
-                nextAt: state.nextAt,
-                done: state.done,
-            }));
-        },
-        sourceCount() {
-            return states.length;
-        },
-    };
-}
-async function resolveInput(input) {
-    if (typeof input === "function") {
-        return await input();
-    }
-    return input;
-}
+export { computeNextFire, createScheduler, manifestScheduleSources, nextCronFire, parseCron, toMs, } from "@voyantjs/workflows-orchestrator";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@voyantjs/workflows-orchestrator-node",
-  "version": "0.30.3",
+  "version": "0.30.5",
   "description": "Node/Docker runtime primitives for @voyantjs/workflows-orchestrator, including a file-backed run store and local scheduler.",
   "license": "Apache-2.0",
   "repository": {
@@ -29,8 +29,8 @@
   "dependencies": {
     "drizzle-orm": "^0.45.2",
     "pg": "^8.20.0",
-    "@voyantjs/workflows-orchestrator": "0.30.3",
-    "@voyantjs/workflows": "0.30.3"
+    "@voyantjs/workflows-orchestrator": "0.30.5",
+    "@voyantjs/workflows": "0.30.5"
   },
   "devDependencies": {
     "@types/node": "^20.12.0",

package/src/node-standalone-driver.ts

@@ -37,11 +37,17 @@ import { deriveStableEventId } from "@voyantjs/workflows/events"
 import { handleStepRequest, type WorkflowStepRequest } from "@voyantjs/workflows/handler"
 import type { WorkflowManifest } from "@voyantjs/workflows/protocol"
 import {
+  createInProcessConcurrencyCoordinator,
+  createScheduler,
+  manifestScheduleSources,
   cancel as orchestratorCancel,
   trigger as orchestratorTrigger,
   type RunRecord,
+  type RuntimeConcurrencyPolicy,
   routeEvent,
+  type SchedulerHandle,
   type StepHandler,
+  type TriggerArgs,
 } from "@voyantjs/workflows-orchestrator"
 import type { drizzle } from "drizzle-orm/node-postgres"
 
@@ -105,6 +111,10 @@ export interface NodeStandaloneDriverOptions {
    * cadence. Defaults to `false` (poller starts immediately).
    */
   disableTimeWheel?: boolean
+  /** Schedule runner tick interval. Defaults to 1_000 ms. */
+  schedulePollIntervalMs?: number
+  /** Disable automatic firing for schedules registered through manifests. */
+  disableScheduleRunner?: boolean
 }
 
 const DEFAULT_TENANT_META: RunRecord["tenantMeta"] = {
@@ -189,7 +199,16 @@ export function createNodeStandaloneDriver(opts: NodeStandaloneDriverOptions): D
       wakeupManager.start()
     }
 
+    const scheduleRunners = new Map<string, SchedulerHandle>()
     let shuttingDown = false
+    const concurrency = createInProcessConcurrencyCoordinator({
+      async cancelRun(runId, reason) {
+        const out = await orchestratorCancel({ runId, reason }, { store: runStore, handler, now })
+        if (out.ok && isTerminal(out.record.status)) {
+          concurrency.releaseRun(out.record)
+        }
+      },
+    })
 
     // ---- WorkflowDriver implementation ----
 
@@ -216,6 +235,10 @@ export function createNodeStandaloneDriver(opts: NodeStandaloneDriverOptions): D
           error: err instanceof Error ? err.message : String(err),
         })
       }
+      startScheduleRunner(
+        args.environment as "production" | "preview" | "development",
+        args.manifest,
+      )
       return result
     }
 
@@ -233,8 +256,9 @@ export function createNodeStandaloneDriver(opts: NodeStandaloneDriverOptions): D
       assertNotShutdown(shuttingDown)
       const workflowId = typeof workflow === "string" ? workflow : workflow.id
       const env = triggerOpts?.environment ?? defaultEnv
+      const policy = await resolveConcurrencyPolicy(workflow, workflowId, env, getManifest)
 
-      const record = await orchestratorTrigger(
+      const record = await triggerRecord(
         {
           workflowId,
           workflowVersion: triggerOpts?.lockToVersion ?? "v1",
@@ -246,7 +270,7 @@ export function createNodeStandaloneDriver(opts: NodeStandaloneDriverOptions): D
           delay: triggerOpts?.delay,
           priority: triggerOpts?.priority,
         },
-        { store: runStore, handler, now },
+        policy,
       )
       // Sync wakeup row so the time-wheel can resume DATETIME-parked runs.
       // No-op if the run completed inline (status !== "waiting").
@@ -287,7 +311,7 @@ export function createNodeStandaloneDriver(opts: NodeStandaloneDriverOptions): D
           continue
         }
         try {
-          const record = await orchestratorTrigger(
+          const record = await triggerRecord(
             {
               workflowId: entry.targetWorkflowId,
               workflowVersion: "v1",
@@ -302,7 +326,12 @@ export function createNodeStandaloneDriver(opts: NodeStandaloneDriverOptions): D
                 filterId: entry.filterId,
               },
             },
-            { store: runStore, handler, now },
+            await resolveConcurrencyPolicy(
+              entry.targetWorkflowId,
+              entry.targetWorkflowId,
+              args.environment,
+              getManifest,
+            ),
           )
           await syncWakeupFromRecord(wakeupStore, record)
           matches.push({
@@ -340,6 +369,72 @@ export function createNodeStandaloneDriver(opts: NodeStandaloneDriverOptions): D
       // Idempotent — calling stop() on an already-stopped manager is a
       // no-op.
       wakeupManager.stop()
+      for (const runner of scheduleRunners.values()) {
+        runner.stop()
+      }
+      scheduleRunners.clear()
+    }
+
+    function startScheduleRunner(
+      environment: "production" | "preview" | "development",
+      manifest: WorkflowManifest,
+    ): void {
+      const existing = scheduleRunners.get(environment)
+      existing?.stop()
+      scheduleRunners.delete(environment)
+      if (opts.disableScheduleRunner) return
+
+      const sources = manifestScheduleSources(manifest)
+      if (sources.length === 0) return
+
+      const runner = createScheduler({
+        sources,
+        environment,
+        now,
+        tickMs: opts.schedulePollIntervalMs,
+        onFire: async ({ workflowId, input, scheduleId, fireAt }) => {
+          assertNotShutdown(shuttingDown)
+          const record = await triggerRecord(
+            {
+              workflowId,
+              workflowVersion: "v1",
+              input,
+              tenantMeta,
+              environment,
+              idempotencyKey: `${scheduleId}:${fireAt}`,
+              triggeredBy: { kind: "schedule", scheduleId },
+            },
+            await resolveConcurrencyPolicy(workflowId, workflowId, environment, getManifest),
+          )
+          await syncWakeupFromRecord(wakeupStore, record)
+        },
+        logger: (level, msg, data) => deps.logger(level, msg, data),
+      })
+      if (runner.sourceCount() === 0) return
+      runner.start()
+      scheduleRunners.set(environment, runner)
+    }
+
+    async function triggerRecord(
+      args: TriggerArgs,
+      policy: RuntimeConcurrencyPolicy | undefined,
+    ): Promise<RunRecord> {
+      return concurrency.run(
+        {
+          workflowId: args.workflowId,
+          input: args.input,
+          policy,
+          holderId: concurrencyHolderId(args),
+        },
+        (hooks) =>
+          orchestratorTrigger(
+            {
+              ...args,
+              onRunRecordCreated: hooks.onRunRecordCreated,
+            },
+            { store: runStore, handler, now },
+          ),
+      )
     }
 
     // ---- WorkflowAdmin (full; Mode 2 has Postgres-native query support) ----
@@ -387,10 +482,13 @@ export function createNodeStandaloneDriver(opts: NodeStandaloneDriverOptions): D
         // default (architecture doc §21.21). The `compensate` flag is
         // accepted but no-ops in v1.
         void cancelOpts?.compensate
-        await orchestratorCancel(
+        const out = await orchestratorCancel(
           { runId, reason: cancelOpts?.reason },
           { store: runStore, handler, now },
         )
+        if (out.ok && isTerminal(out.record.status)) {
+          concurrency.releaseRun(out.record)
+        }
       },
 
       streamRun(runId: string): AsyncIterable<never> {
@@ -429,6 +527,35 @@ function assertNotShutdown(shuttingDown: boolean): void {
   }
 }
 
+async function resolveConcurrencyPolicy(
+  workflow: { id: string; config?: { concurrency?: RuntimeConcurrencyPolicy } } | string,
+  workflowId: string,
+  environment: "production" | "preview" | "development",
+  getManifest: (args: { environment: string }) => Promise<WorkflowManifest | null>,
+): Promise<RuntimeConcurrencyPolicy | undefined> {
+  if (typeof workflow !== "string" && workflow.config?.concurrency) {
+    return workflow.config.concurrency
+  }
+  const manifest = await getManifest({ environment })
+  return manifest?.workflows.find((entry) => entry.id === workflowId)?.concurrency
+}
+
+function isTerminal(status: RunRecord["status"]): boolean {
+  return (
+    status === "completed" ||
+    status === "failed" ||
+    status === "cancelled" ||
+    status === "compensated" ||
+    status === "compensation_failed"
+  )
+}
+
+function concurrencyHolderId(args: TriggerArgs): string | undefined {
+  if (args.runId !== undefined) return args.runId
+  if (args.idempotencyKey !== undefined) return `idem-${args.workflowId}-${args.idempotencyKey}`
+  return undefined
+}
+
 function randomToken(): string {
   return Math.floor(Math.random() * 1_000_000_000)
     .toString(36)

package/src/scheduler.ts

@@ -1,154 +1,13 @@
-import type { EnvironmentName, ScheduleDeclaration } from "@voyantjs/workflows"
-import { computeNextFire } from "@voyantjs/workflows-orchestrator"
-
 export {
   type CronSpec,
   computeNextFire,
+  createScheduler,
+  manifestScheduleSources,
   nextCronFire,
   parseCron,
+  type SchedulableDeclaration,
+  type SchedulerDeps,
+  type SchedulerHandle,
+  type ScheduleSource,
   toMs,
 } from "@voyantjs/workflows-orchestrator"
-
-export interface ScheduleSource {
-  workflowId: string
-  decl: ScheduleDeclaration
-}
-
-export interface SchedulerDeps {
-  sources: readonly ScheduleSource[]
-  onFire: (args: { workflowId: string; input: unknown; scheduleName?: string }) => Promise<void>
-  now?: () => number
-  environment?: EnvironmentName
-  tickMs?: number
-  setInterval?: typeof setInterval
-  clearInterval?: typeof clearInterval
-  logger?: (level: "info" | "warn" | "error", msg: string, data?: object) => void
-}
-
-export interface SchedulerHandle {
-  start: () => void
-  stop: () => void
-  tick: () => Promise<void>
-  nextFirings: () => { workflowId: string; name?: string; nextAt: number; done: boolean }[]
-  sourceCount: () => number
-}
-
-interface SourceState {
-  source: ScheduleSource
-  nextAt: number
-  done: boolean
-  inFlight: boolean
-}
-
-export function createScheduler(deps: SchedulerDeps): SchedulerHandle {
-  const now = deps.now ?? (() => Date.now())
-  const tickMs = deps.tickMs ?? 1_000
-  const setInt = deps.setInterval ?? setInterval
-  const clearInt = deps.clearInterval ?? clearInterval
-  const env = deps.environment ?? "development"
-  const log = deps.logger ?? (() => {})
-
-  const states: SourceState[] = []
-  for (const source of deps.sources) {
-    if (source.decl.enabled === false) continue
-    if (source.decl.environments && !source.decl.environments.includes(env)) continue
-    let firstAt: number
-    try {
-      firstAt = computeNextFire(source.decl, now())
-    } catch (err) {
-      log("warn", `scheduler: skipping source for workflow "${source.workflowId}": ${String(err)}`)
-      continue
-    }
-    states.push({ source, nextAt: firstAt, done: false, inFlight: false })
-  }
-
-  let timer: ReturnType<typeof setInterval> | undefined
-
-  const advanceAfterFire = (state: SourceState, firedAt: number): void => {
-    if ("at" in state.source.decl) {
-      state.done = true
-      return
-    }
-    try {
-      state.nextAt = computeNextFire(state.source.decl, firedAt)
-    } catch (err) {
-      log(
-        "error",
-        `scheduler: cannot compute next fire for "${state.source.workflowId}": ${String(err)}`,
-      )
-      state.done = true
-    }
-  }
-
-  const doTick = async (): Promise<void> => {
-    const t = now()
-    const ready = states.filter((state) => !state.done && state.nextAt <= t)
-    for (const state of ready) {
-      const overlap = state.source.decl.overlap ?? "skip"
-      if (state.inFlight && overlap === "skip") continue
-      let input: unknown
-      try {
-        input = await resolveInput(state.source.decl.input)
-      } catch (err) {
-        log(
-          "error",
-          `scheduler: failed to resolve input for "${state.source.workflowId}": ${String(err)}`,
-        )
-        advanceAfterFire(state, t)
-        continue
-      }
-      state.inFlight = true
-      const firePromise = (async () => {
-        try {
-          await deps.onFire({
-            workflowId: state.source.workflowId,
-            input,
-            scheduleName: state.source.decl.name,
-          })
-        } catch (err) {
-          log("error", `scheduler: onFire threw for "${state.source.workflowId}": ${String(err)}`)
-        } finally {
-          state.inFlight = false
-        }
-      })()
-      advanceAfterFire(state, t)
-      if (overlap === "skip") await firePromise
-    }
-  }
-
-  return {
-    start() {
-      if (timer) return
-      timer = setInt(() => {
-        doTick().catch(() => {})
-      }, tickMs)
-      ;(timer as unknown as { unref?: () => void }).unref?.()
-    },
-    stop() {
-      if (!timer) return
-      clearInt(timer)
-      timer = undefined
-    },
-    tick: doTick,
-    nextFirings() {
-      return states.map((state) => ({
-        workflowId: state.source.workflowId,
-        name: state.source.decl.name,
-        nextAt: state.nextAt,
-        done: state.done,
-      }))
-    },
-    sourceCount() {
-      return states.length
-    },
-  }
-}
-
-async function resolveInput(
-  input: unknown | (() => unknown | Promise<unknown>) | undefined,
-): Promise<unknown> {
-  if (typeof input === "function") {
-    return await (input as () => unknown | Promise<unknown>)()
-  }
-  return input
-}