@tanstack/workflow-runtime 0.0.1

package/dist/run-store-adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-store-adapter.js","names":[],"sources":["../src/run-store-adapter.ts"],"sourcesContent":["import type {\n  DeleteReason,\n  RunState,\n  WorkflowEvent,\n} from '@tanstack/workflow-core'\nimport type {\n  WorkflowRunStoreAdapter,\n  WorkflowRunStoreAdapterStore,\n} from './types'\n\nexport function createRunStoreAdapter(\n  store: WorkflowRunStoreAdapterStore,\n): WorkflowRunStoreAdapter {\n  return {\n    getRunState(runId) {\n      return store.loadRunState(runId)\n    },\n\n    setRunState(_runId: string, state: RunState) {\n      return store.saveRunState({ state })\n    },\n\n    deleteRun(runId: string, reason: DeleteReason) {\n      return store.deleteRun(runId, reason)\n    },\n\n    async appendEvent(\n      runId: string,\n      expectedNextIndex: number,\n      event: WorkflowEvent,\n    ) {\n      await store.appendEvents({\n        runId,\n        expectedNextIndex,\n        events: [event],\n      })\n    },\n\n    async getEvents(runId: string) {\n      const events = await store.readEvents({ runId })\n      return events.map((event) => event.event)\n    },\n\n    subscribe: store.subscribeEvents\n      ? (runId, fromIndex, onEvent) =>\n          store.subscribeEvents!(runId, fromIndex, onEvent)\n      : undefined,\n  }\n}\n"],"mappings":";AAUA,SAAgB,sBACd,OACyB;AACzB,QAAO;EACL,YAAY,OAAO;AACjB,UAAO,MAAM,aAAa,MAAM;;EAGlC,YAAY,QAAgB,OAAiB;AAC3C,UAAO,MAAM,aAAa,EAAE,OAAO,CAAC;;EAGtC,UAAU,OAAe,QAAsB;AAC7C,UAAO,MAAM,UAAU,OAAO,OAAO;;EAGvC,MAAM,YACJ,OACA,mBACA,OACA;AACA,SAAM,MAAM,aAAa;IACvB;IACA;IACA,QAAQ,CAAC,MAAM;IAChB,CAAC;;EAGJ,MAAM,UAAU,OAAe;AAE7B,WAAO,MADc,MAAM,WAAW,EAAE,OAAO,CAAC,EAClC,KAAK,UAAU,MAAM,MAAM;;EAG3C,WAAW,MAAM,mBACZ,OAAO,WAAW,YACjB,MAAM,gBAAiB,OAAO,WAAW,QAAQ,GACnD;EACL"}

package/dist/runtime-driver.cjs

@@ -0,0 +1,334 @@
+const require_run_store_adapter = require('./run-store-adapter.cjs');
+let _tanstack_workflow_core = require("@tanstack/workflow-core");
+
+//#region src/runtime-driver.ts
+const DEFAULT_LEASE_MS = 3e4;
+const DEFAULT_SWEEP_LIMIT = 25;
+function createRuntimeDriver(config) {
+	return {
+		startRun(args) {
+			return startRun(config, args);
+		},
+		deliverSignal(args) {
+			return deliverSignal(config, args);
+		},
+		deliverApproval(args) {
+			return deliverApproval(config, args);
+		},
+		sweep(args = {}) {
+			return sweep(config, args);
+		}
+	};
+}
+async function startRun(config, args) {
+	const now = args.now ?? Date.now();
+	const workflow = await loadWorkflow(config, args.workflowId);
+	const workflowVersion = workflow.version;
+	await config.store.createRun({
+		runId: args.runId,
+		workflowId: args.workflowId,
+		workflowVersion,
+		input: args.input,
+		now
+	});
+	return driveClaimedRun(config, {
+		workflow,
+		workflowId: args.workflowId,
+		runId: args.runId,
+		input: args.input,
+		now,
+		leaseOwner: args.leaseOwner,
+		leaseMs: args.leaseMs,
+		threadId: args.threadId,
+		includeEvents: args.includeEvents,
+		maxEvents: args.maxEvents
+	});
+}
+async function deliverSignal(config, args) {
+	const now = args.now ?? Date.now();
+	const delivery = {
+		signalId: args.signalId,
+		name: args.name,
+		payload: args.payload
+	};
+	const delivered = await config.store.deliverSignal({
+		runId: args.runId,
+		delivery,
+		now
+	});
+	if (delivered.kind !== "delivered") return resultFromSignalDelivery(args.runId, delivered);
+	return driveClaimedRun(config, {
+		workflow: await loadWorkflow(config, delivered.run.workflowId),
+		workflowId: delivered.run.workflowId,
+		runId: args.runId,
+		signalDelivery: delivery,
+		now,
+		leaseOwner: args.leaseOwner,
+		leaseMs: args.leaseMs,
+		threadId: args.threadId,
+		includeEvents: args.includeEvents,
+		maxEvents: args.maxEvents
+	});
+}
+async function deliverApproval(config, args) {
+	const now = args.now ?? Date.now();
+	const delivered = await config.store.deliverApproval({
+		runId: args.runId,
+		approval: args.approval,
+		now
+	});
+	if (delivered.kind !== "delivered") return resultFromApprovalDelivery(args.runId, delivered);
+	return driveClaimedRun(config, {
+		workflow: await loadWorkflow(config, delivered.run.workflowId),
+		workflowId: delivered.run.workflowId,
+		runId: args.runId,
+		approval: args.approval,
+		now,
+		leaseOwner: args.leaseOwner,
+		leaseMs: args.leaseMs,
+		threadId: args.threadId,
+		includeEvents: args.includeEvents,
+		maxEvents: args.maxEvents
+	});
+}
+async function sweep(config, args) {
+	const now = args.now ?? Date.now();
+	const startedAt = Date.now();
+	const maxScheduledRuns = normalizeSweepLimit(args.maxScheduledRuns ?? args.limit, DEFAULT_SWEEP_LIMIT, "maxScheduledRuns");
+	const maxTimers = normalizeSweepLimit(args.maxTimers ?? args.limit, DEFAULT_SWEEP_LIMIT, "maxTimers");
+	const leaseOwner = args.leaseOwner ?? `sweep:${now}`;
+	const leaseMs = args.leaseMs ?? config.defaultLeaseMs ?? DEFAULT_LEASE_MS;
+	const scheduled = [];
+	const timers = [];
+	let deadlineReached = false;
+	while (scheduled.length < maxScheduledRuns) {
+		if (isPastSweepDeadline(startedAt, args.maxDurationMs)) {
+			deadlineReached = true;
+			break;
+		}
+		const bucket = (await config.store.claimDueScheduleBuckets({
+			now,
+			limit: 1,
+			leaseOwner,
+			leaseMs
+		}))[0];
+		if (!bucket) break;
+		const result = await startRun(config, {
+			workflowId: bucket.workflowId,
+			runId: bucket.runId,
+			input: bucket.input,
+			now,
+			leaseOwner,
+			leaseMs,
+			includeEvents: args.includeEvents,
+			maxEvents: args.maxEvents
+		});
+		if (result.kind !== "not-claimable" && result.kind !== "not-found") await config.store.markScheduleBucketStarted({
+			scheduleId: bucket.scheduleId,
+			bucketId: bucket.bucketId,
+			runId: bucket.runId,
+			now
+		});
+		scheduled.push(result);
+	}
+	while (timers.length < maxTimers) {
+		if (isPastSweepDeadline(startedAt, args.maxDurationMs)) {
+			deadlineReached = true;
+			break;
+		}
+		const timer = (await config.store.claimDueTimers({
+			now,
+			limit: 1,
+			leaseOwner,
+			leaseMs
+		}))[0];
+		if (!timer) break;
+		timers.push(await deliverTimer(config, {
+			timer,
+			now,
+			leaseOwner,
+			leaseMs,
+			includeEvents: args.includeEvents,
+			maxEvents: args.maxEvents
+		}));
+	}
+	return {
+		scheduled,
+		timers,
+		summary: summarizeSweep(scheduled, timers),
+		deadlineReached,
+		remainingMayExist: deadlineReached || scheduled.length >= maxScheduledRuns || timers.length >= maxTimers
+	};
+}
+async function deliverTimer(config, args) {
+	return deliverSignal(config, {
+		runId: args.timer.runId,
+		signalId: args.timer.signalId,
+		name: "__timer",
+		payload: void 0,
+		now: args.now,
+		leaseOwner: args.leaseOwner,
+		leaseMs: args.leaseMs,
+		includeEvents: args.includeEvents,
+		maxEvents: args.maxEvents
+	});
+}
+async function driveClaimedRun(config, args) {
+	const leaseOwner = args.leaseOwner ?? `runtime:${args.runId}`;
+	const leaseMs = args.leaseMs ?? config.defaultLeaseMs ?? DEFAULT_LEASE_MS;
+	const claim = await config.store.claimRun({
+		runId: args.runId,
+		leaseOwner,
+		leaseMs,
+		now: args.now
+	});
+	if (claim.kind === "not-found") return {
+		kind: "not-found",
+		runId: args.runId,
+		workflowId: args.workflowId,
+		eventCount: 0,
+		events: []
+	};
+	if (claim.kind === "not-claimable") return {
+		kind: "not-claimable",
+		runId: args.runId,
+		workflowId: args.workflowId,
+		run: claim.run,
+		eventCount: 0,
+		events: []
+	};
+	const runStore = require_run_store_adapter.createRunStoreAdapter(config.store);
+	const collected = await collectWorkflowEvents((0, _tanstack_workflow_core.runWorkflow)({
+		workflow: args.workflow,
+		runStore,
+		runId: args.runId,
+		input: args.input,
+		signalDelivery: args.signalDelivery,
+		approval: args.approval,
+		threadId: args.threadId
+	}), {
+		includeEvents: args.includeEvents ?? true,
+		maxEvents: args.maxEvents
+	});
+	await syncTimerFromRunState(config, args.runId, args.workflowId, args.now);
+	await config.store.releaseRunLease({
+		runId: args.runId,
+		leaseOwner
+	});
+	const run = await config.store.loadRun(args.runId);
+	return {
+		kind: classifyRun(run, collected.eventCount),
+		runId: args.runId,
+		workflowId: args.workflowId,
+		run,
+		events: collected.events,
+		eventCount: collected.eventCount,
+		eventsTruncated: collected.eventsTruncated || void 0
+	};
+}
+async function syncTimerFromRunState(config, runId, workflowId, now) {
+	const state = await config.store.loadRunState(runId);
+	const deadline = state?.waitingFor?.deadline;
+	if (state?.waitingFor?.signalName !== "__timer" || deadline === void 0) return;
+	await config.store.scheduleTimer({
+		runId,
+		workflowId,
+		workflowVersion: state.workflowVersion,
+		wakeAt: deadline,
+		signalId: `timer:${runId}:${deadline}`,
+		now
+	});
+}
+async function loadWorkflow(config, workflowId) {
+	const registration = config.workflows[workflowId];
+	if (!registration) throw new Error(`Workflow "${workflowId}" is not registered.`);
+	const workflow = normalizeWorkflowLoaderResult(await registration.load());
+	const previousVersions = [];
+	for (const loadPrevious of Object.values(registration.previousVersions ?? {})) previousVersions.push(normalizeWorkflowLoaderResult(await loadPrevious()));
+	if (registration.version || previousVersions.length > 0) return {
+		...workflow,
+		version: registration.version ?? workflow.version,
+		previousVersions: [...workflow.previousVersions ?? [], ...previousVersions]
+	};
+	return workflow;
+}
+function normalizeWorkflowLoaderResult(result) {
+	if ("__kind" in result) return result;
+	if ("default" in result) return result.default;
+	return result.workflow;
+}
+function resultFromSignalDelivery(runId, result) {
+	return {
+		kind: result.kind,
+		runId,
+		run: "run" in result ? result.run : void 0,
+		workflowId: "run" in result ? result.run.workflowId : void 0,
+		events: [],
+		eventCount: 0
+	};
+}
+function resultFromApprovalDelivery(runId, result) {
+	return {
+		kind: result.kind,
+		runId,
+		run: "run" in result ? result.run : void 0,
+		workflowId: "run" in result ? result.run.workflowId : void 0,
+		events: [],
+		eventCount: 0
+	};
+}
+function classifyRun(run, eventCount) {
+	if (run?.status === "finished") return "completed";
+	if (run?.status === "paused") return "paused";
+	if (run?.status === "errored" || run?.status === "aborted") return "errored";
+	if (run?.status === "running" || run?.status === "queued") return "running";
+	return eventCount > 0 ? "running" : "not-found";
+}
+function normalizeSweepLimit(value, fallback, label) {
+	const limit = value ?? fallback;
+	if (!Number.isInteger(limit) || limit < 0) throw new Error(`Workflow sweep ${label} must be a non-negative integer.`);
+	return limit;
+}
+function isPastSweepDeadline(startedAt, maxDurationMs) {
+	return maxDurationMs !== void 0 && Date.now() - startedAt >= maxDurationMs;
+}
+function summarizeSweep(scheduled, timers) {
+	return {
+		scheduled: countRunKinds(scheduled),
+		timers: countRunKinds(timers),
+		eventCount: sumEventCounts(scheduled) + sumEventCounts(timers),
+		returnedEventCount: sumReturnedEventCounts(scheduled) + sumReturnedEventCounts(timers)
+	};
+}
+function countRunKinds(runs) {
+	const counts = {};
+	for (const run of runs) counts[run.kind] = (counts[run.kind] ?? 0) + 1;
+	return counts;
+}
+function sumEventCounts(runs) {
+	return runs.reduce((sum, run) => sum + run.eventCount, 0);
+}
+function sumReturnedEventCounts(runs) {
+	return runs.reduce((sum, run) => sum + run.events.length, 0);
+}
+async function collectWorkflowEvents(iterable, options) {
+	if (options.maxEvents !== void 0 && (!Number.isInteger(options.maxEvents) || options.maxEvents < 0)) throw new Error("Workflow event collection maxEvents must be a non-negative integer.");
+	const events = [];
+	let eventCount = 0;
+	let eventsTruncated = false;
+	for await (const event of iterable) {
+		eventCount++;
+		if (!options.includeEvents) continue;
+		if (options.maxEvents === void 0 || events.length < options.maxEvents) events.push(event);
+		else eventsTruncated = true;
+	}
+	return {
+		events,
+		eventCount,
+		eventsTruncated
+	};
+}
+
+//#endregion
+exports.createRuntimeDriver = createRuntimeDriver;
+//# sourceMappingURL=runtime-driver.cjs.map

package/dist/runtime-driver.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-driver.cjs","names":["createRunStoreAdapter"],"sources":["../src/runtime-driver.ts"],"sourcesContent":["import { runWorkflow } from '@tanstack/workflow-core'\nimport { createRunStoreAdapter } from './run-store-adapter'\nimport type {\n  AnyWorkflowDefinition,\n  WorkflowEvent,\n} from '@tanstack/workflow-core'\nimport type {\n  DeliverApprovalResult,\n  DeliverSignalResult,\n  TimerWakeup,\n  WorkflowExecution,\n  WorkflowRegistration,\n  WorkflowRuntimeConfig,\n  WorkflowRuntimeDeliverApprovalArgs,\n  WorkflowRuntimeDeliverSignalArgs,\n  WorkflowRuntimeRunResult,\n  WorkflowRuntimeRunResultKind,\n  WorkflowRuntimeStartRunArgs,\n  WorkflowRuntimeSweepArgs,\n  WorkflowRuntimeSweepResult,\n} from './types'\n\nconst DEFAULT_LEASE_MS = 30_000\nconst DEFAULT_SWEEP_LIMIT = 25\n\nexport function createRuntimeDriver<\n  TWorkflows extends Record<string, WorkflowRegistration>,\n>(config: WorkflowRuntimeConfig<TWorkflows>) {\n  return {\n    startRun(args: WorkflowRuntimeStartRunArgs) {\n      return startRun(config, args)\n    },\n    deliverSignal<TPayload = unknown>(\n      args: WorkflowRuntimeDeliverSignalArgs<TPayload>,\n    ) {\n      return deliverSignal(config, args)\n    },\n    deliverApproval(args: WorkflowRuntimeDeliverApprovalArgs) {\n      return deliverApproval(config, args)\n    },\n    sweep(args: WorkflowRuntimeSweepArgs = {}) {\n      return sweep(config, args)\n    },\n  }\n}\n\nasync function startRun<\n  TWorkflows extends Record<string, WorkflowRegistration>,\n>(\n  config: WorkflowRuntimeConfig<TWorkflows>,\n  args: WorkflowRuntimeStartRunArgs,\n): Promise<WorkflowRuntimeRunResult> {\n  const now = args.now ?? Date.now()\n  const workflow = await loadWorkflow(config, args.workflowId)\n  const workflowVersion = workflow.version\n  await config.store.createRun({\n    runId: args.runId,\n    workflowId: args.workflowId,\n    workflowVersion,\n    input: args.input,\n    now,\n  })\n\n  return driveClaimedRun(config, {\n    workflow,\n    workflowId: args.workflowId,\n    runId: args.runId,\n    input: args.input,\n    now,\n    leaseOwner: args.leaseOwner,\n    leaseMs: args.leaseMs,\n    threadId: args.threadId,\n    includeEvents: args.includeEvents,\n    maxEvents: args.maxEvents,\n  })\n}\n\nasync function deliverSignal<\n  TWorkflows extends Record<string, WorkflowRegistration>,\n  TPayload,\n>(\n  config: WorkflowRuntimeConfig<TWorkflows>,\n  args: WorkflowRuntimeDeliverSignalArgs<TPayload>,\n): Promise<WorkflowRuntimeRunResult> {\n  const now = args.now ?? Date.now()\n  const delivery = {\n    signalId: args.signalId,\n    name: args.name,\n    payload: args.payload,\n  }\n  const delivered = await config.store.deliverSignal({\n    runId: args.runId,\n    delivery,\n    now,\n  })\n  if (delivered.kind !== 'delivered') {\n    return resultFromSignalDelivery(args.runId, delivered)\n  }\n\n  const workflow = await loadWorkflow(config, delivered.run.workflowId)\n  return driveClaimedRun(config, {\n    workflow,\n    workflowId: delivered.run.workflowId,\n    runId: args.runId,\n    signalDelivery: delivery,\n    now,\n    leaseOwner: args.leaseOwner,\n    leaseMs: args.leaseMs,\n    threadId: args.threadId,\n    includeEvents: args.includeEvents,\n    maxEvents: args.maxEvents,\n  })\n}\n\nasync function deliverApproval<\n  TWorkflows extends Record<string, WorkflowRegistration>,\n>(\n  config: WorkflowRuntimeConfig<TWorkflows>,\n  args: WorkflowRuntimeDeliverApprovalArgs,\n): Promise<WorkflowRuntimeRunResult> {\n  const now = args.now ?? Date.now()\n  const delivered = await config.store.deliverApproval({\n    runId: args.runId,\n    approval: args.approval,\n    now,\n  })\n  if (delivered.kind !== 'delivered') {\n    return resultFromApprovalDelivery(args.runId, delivered)\n  }\n\n  const workflow = await loadWorkflow(config, delivered.run.workflowId)\n  return driveClaimedRun(config, {\n    workflow,\n    workflowId: delivered.run.workflowId,\n    runId: args.runId,\n    approval: args.approval,\n    now,\n    leaseOwner: args.leaseOwner,\n    leaseMs: args.leaseMs,\n    threadId: args.threadId,\n    includeEvents: args.includeEvents,\n    maxEvents: args.maxEvents,\n  })\n}\n\nasync function sweep<TWorkflows extends Record<string, WorkflowRegistration>>(\n  config: WorkflowRuntimeConfig<TWorkflows>,\n  args: WorkflowRuntimeSweepArgs,\n): Promise<WorkflowRuntimeSweepResult> {\n  const now = args.now ?? Date.now()\n  const startedAt = Date.now()\n  const maxScheduledRuns = normalizeSweepLimit(\n    args.maxScheduledRuns ?? args.limit,\n    DEFAULT_SWEEP_LIMIT,\n    'maxScheduledRuns',\n  )\n  const maxTimers = normalizeSweepLimit(\n    args.maxTimers ?? args.limit,\n    DEFAULT_SWEEP_LIMIT,\n    'maxTimers',\n  )\n  const leaseOwner = args.leaseOwner ?? `sweep:${now}`\n  const leaseMs = args.leaseMs ?? config.defaultLeaseMs ?? DEFAULT_LEASE_MS\n  const scheduled: Array<WorkflowRuntimeRunResult> = []\n  const timers: Array<WorkflowRuntimeRunResult> = []\n  let deadlineReached = false\n\n  while (scheduled.length < maxScheduledRuns) {\n    if (isPastSweepDeadline(startedAt, args.maxDurationMs)) {\n      deadlineReached = true\n      break\n    }\n\n    const buckets = await config.store.claimDueScheduleBuckets({\n      now,\n      limit: 1,\n      leaseOwner,\n      leaseMs,\n    })\n    const bucket = buckets[0]\n    if (!bucket) break\n\n    const result = await startRun(config, {\n      workflowId: bucket.workflowId,\n      runId: bucket.runId,\n      input: bucket.input,\n      now,\n      leaseOwner,\n      leaseMs,\n      includeEvents: args.includeEvents,\n      maxEvents: args.maxEvents,\n    })\n    if (result.kind !== 'not-claimable' && result.kind !== 'not-found') {\n      await config.store.markScheduleBucketStarted({\n        scheduleId: bucket.scheduleId,\n        bucketId: bucket.bucketId,\n        runId: bucket.runId,\n        now,\n      })\n    }\n    scheduled.push(result)\n  }\n\n  while (timers.length < maxTimers) {\n    if (isPastSweepDeadline(startedAt, args.maxDurationMs)) {\n      deadlineReached = true\n      break\n    }\n\n    const dueTimers = await config.store.claimDueTimers({\n      now,\n      limit: 1,\n      leaseOwner,\n      leaseMs,\n    })\n    const timer = dueTimers[0]\n    if (!timer) break\n\n    timers.push(\n      await deliverTimer(config, {\n        timer,\n        now,\n        leaseOwner,\n        leaseMs,\n        includeEvents: args.includeEvents,\n        maxEvents: args.maxEvents,\n      }),\n    )\n  }\n\n  return {\n    scheduled,\n    timers,\n    summary: summarizeSweep(scheduled, timers),\n    deadlineReached,\n    remainingMayExist:\n      deadlineReached ||\n      scheduled.length >= maxScheduledRuns ||\n      timers.length >= maxTimers,\n  }\n}\n\nasync function deliverTimer<\n  TWorkflows extends Record<string, WorkflowRegistration>,\n>(\n  config: WorkflowRuntimeConfig<TWorkflows>,\n  args: {\n    timer: TimerWakeup\n    now: number\n    leaseOwner: string\n    leaseMs: number\n    includeEvents?: boolean\n    maxEvents?: number\n  },\n) {\n  return deliverSignal(config, {\n    runId: args.timer.runId,\n    signalId: args.timer.signalId,\n    name: '__timer',\n    payload: undefined,\n    now: args.now,\n    leaseOwner: args.leaseOwner,\n    leaseMs: args.leaseMs,\n    includeEvents: args.includeEvents,\n    maxEvents: args.maxEvents,\n  })\n}\n\nasync function driveClaimedRun<\n  TWorkflows extends Record<string, WorkflowRegistration>,\n>(\n  config: WorkflowRuntimeConfig<TWorkflows>,\n  args: {\n    workflow: AnyWorkflowDefinition\n    workflowId: string\n    runId: string\n    input?: unknown\n    signalDelivery?: Parameters<typeof runWorkflow>[0]['signalDelivery']\n    approval?: Parameters<typeof runWorkflow>[0]['approval']\n    now: number\n    leaseOwner?: string\n    leaseMs?: number\n    threadId?: string\n    includeEvents?: boolean\n    maxEvents?: number\n  },\n): Promise<WorkflowRuntimeRunResult> {\n  const leaseOwner = args.leaseOwner ?? `runtime:${args.runId}`\n  const leaseMs = args.leaseMs ?? config.defaultLeaseMs ?? DEFAULT_LEASE_MS\n  const claim = await config.store.claimRun({\n    runId: args.runId,\n    leaseOwner,\n    leaseMs,\n    now: args.now,\n  })\n\n  if (claim.kind === 'not-found') {\n    return {\n      kind: 'not-found',\n      runId: args.runId,\n      workflowId: args.workflowId,\n      eventCount: 0,\n      events: [],\n    }\n  }\n  if (claim.kind === 'not-claimable') {\n    return {\n      kind: 'not-claimable',\n      runId: args.runId,\n      workflowId: args.workflowId,\n      run: claim.run,\n      eventCount: 0,\n      events: [],\n    }\n  }\n\n  const runStore = createRunStoreAdapter(config.store)\n  const collected = await collectWorkflowEvents(\n    runWorkflow({\n      workflow: args.workflow,\n      runStore,\n      runId: args.runId,\n      input: args.input,\n      signalDelivery: args.signalDelivery,\n      approval: args.approval,\n      threadId: args.threadId,\n    }),\n    {\n      includeEvents: args.includeEvents ?? true,\n      maxEvents: args.maxEvents,\n    },\n  )\n\n  await syncTimerFromRunState(config, args.runId, args.workflowId, args.now)\n  await config.store.releaseRunLease({ runId: args.runId, leaseOwner })\n\n  const run = await config.store.loadRun(args.runId)\n  return {\n    kind: classifyRun(run, collected.eventCount),\n    runId: args.runId,\n    workflowId: args.workflowId,\n    run,\n    events: collected.events,\n    eventCount: collected.eventCount,\n    eventsTruncated: collected.eventsTruncated || undefined,\n  }\n}\n\nasync function syncTimerFromRunState<\n  TWorkflows extends Record<string, WorkflowRegistration>,\n>(\n  config: WorkflowRuntimeConfig<TWorkflows>,\n  runId: string,\n  workflowId: string,\n  now: number,\n) {\n  const state = await config.store.loadRunState(runId)\n  const deadline = state?.waitingFor?.deadline\n  if (state?.waitingFor?.signalName !== '__timer' || deadline === undefined) {\n    return\n  }\n\n  await config.store.scheduleTimer({\n    runId,\n    workflowId,\n    workflowVersion: state.workflowVersion,\n    wakeAt: deadline,\n    signalId: `timer:${runId}:${deadline}`,\n    now,\n  })\n}\n\nasync function loadWorkflow<\n  TWorkflows extends Record<string, WorkflowRegistration>,\n>(\n  config: WorkflowRuntimeConfig<TWorkflows>,\n  workflowId: string,\n): Promise<AnyWorkflowDefinition> {\n  const registration = config.workflows[workflowId]\n  if (!registration) {\n    throw new Error(`Workflow \"${workflowId}\" is not registered.`)\n  }\n\n  const workflow = normalizeWorkflowLoaderResult(await registration.load())\n  const previousVersions = []\n  for (const loadPrevious of Object.values(\n    registration.previousVersions ?? {},\n  )) {\n    previousVersions.push(normalizeWorkflowLoaderResult(await loadPrevious()))\n  }\n\n  if (registration.version || previousVersions.length > 0) {\n    return {\n      ...workflow,\n      version: registration.version ?? workflow.version,\n      previousVersions: [\n        ...(workflow.previousVersions ?? []),\n        ...previousVersions,\n      ],\n    }\n  }\n\n  return workflow\n}\n\nfunction normalizeWorkflowLoaderResult(\n  result: Awaited<ReturnType<WorkflowRegistration['load']>>,\n): AnyWorkflowDefinition {\n  if ('__kind' in result) return result\n  if ('default' in result) return result.default\n  return result.workflow\n}\n\nfunction resultFromSignalDelivery(\n  runId: string,\n  result: Exclude<DeliverSignalResult, { kind: 'delivered' }>,\n): WorkflowRuntimeRunResult {\n  return {\n    kind: result.kind,\n    runId,\n    run: 'run' in result ? result.run : undefined,\n    workflowId: 'run' in result ? result.run.workflowId : undefined,\n    events: [],\n    eventCount: 0,\n  }\n}\n\nfunction resultFromApprovalDelivery(\n  runId: string,\n  result: Exclude<DeliverApprovalResult, { kind: 'delivered' }>,\n): WorkflowRuntimeRunResult {\n  return {\n    kind: result.kind,\n    runId,\n    run: 'run' in result ? result.run : undefined,\n    workflowId: 'run' in result ? result.run.workflowId : undefined,\n    events: [],\n    eventCount: 0,\n  }\n}\n\nfunction classifyRun(\n  run: WorkflowExecution | undefined,\n  eventCount: number,\n): WorkflowRuntimeRunResult['kind'] {\n  if (run?.status === 'finished') return 'completed'\n  if (run?.status === 'paused') return 'paused'\n  if (run?.status === 'errored' || run?.status === 'aborted') return 'errored'\n  if (run?.status === 'running' || run?.status === 'queued') return 'running'\n  return eventCount > 0 ? 'running' : 'not-found'\n}\n\nfunction normalizeSweepLimit(\n  value: number | undefined,\n  fallback: number,\n  label: string,\n) {\n  const limit = value ?? fallback\n  if (!Number.isInteger(limit) || limit < 0) {\n    throw new Error(`Workflow sweep ${label} must be a non-negative integer.`)\n  }\n  return limit\n}\n\nfunction isPastSweepDeadline(\n  startedAt: number,\n  maxDurationMs: number | undefined,\n) {\n  return maxDurationMs !== undefined && Date.now() - startedAt >= maxDurationMs\n}\n\nfunction summarizeSweep(\n  scheduled: ReadonlyArray<WorkflowRuntimeRunResult>,\n  timers: ReadonlyArray<WorkflowRuntimeRunResult>,\n): WorkflowRuntimeSweepResult['summary'] {\n  return {\n    scheduled: countRunKinds(scheduled),\n    timers: countRunKinds(timers),\n    eventCount: sumEventCounts(scheduled) + sumEventCounts(timers),\n    returnedEventCount:\n      sumReturnedEventCounts(scheduled) + sumReturnedEventCounts(timers),\n  }\n}\n\nfunction countRunKinds(runs: ReadonlyArray<WorkflowRuntimeRunResult>) {\n  const counts: Partial<Record<WorkflowRuntimeRunResultKind, number>> = {}\n  for (const run of runs) {\n    counts[run.kind] = (counts[run.kind] ?? 0) + 1\n  }\n  return counts\n}\n\nfunction sumEventCounts(runs: ReadonlyArray<WorkflowRuntimeRunResult>) {\n  return runs.reduce((sum, run) => sum + run.eventCount, 0)\n}\n\nfunction sumReturnedEventCounts(runs: ReadonlyArray<WorkflowRuntimeRunResult>) {\n  return runs.reduce((sum, run) => sum + run.events.length, 0)\n}\n\nasync function collectWorkflowEvents(\n  iterable: AsyncIterable<WorkflowEvent>,\n  options: {\n    includeEvents: boolean\n    maxEvents?: number\n  },\n) {\n  if (\n    options.maxEvents !== undefined &&\n    (!Number.isInteger(options.maxEvents) || options.maxEvents < 0)\n  ) {\n    throw new Error(\n      'Workflow event collection maxEvents must be a non-negative integer.',\n    )\n  }\n\n  const events: Array<WorkflowEvent> = []\n  let eventCount = 0\n  let eventsTruncated = false\n\n  for await (const event of iterable) {\n    eventCount++\n    if (!options.includeEvents) continue\n    if (options.maxEvents === undefined || events.length < options.maxEvents) {\n      events.push(event)\n    } else {\n      eventsTruncated = true\n    }\n  }\n\n  return {\n    events,\n    eventCount,\n    eventsTruncated,\n  }\n}\n"],"mappings":"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"}

package/dist/runtime-driver.d.cts

@@ -0,0 +1,12 @@
+import { WorkflowRegistration, WorkflowRuntimeConfig, WorkflowRuntimeDeliverApprovalArgs, WorkflowRuntimeDeliverSignalArgs, WorkflowRuntimeRunResult, WorkflowRuntimeStartRunArgs, WorkflowRuntimeSweepArgs, WorkflowRuntimeSweepResult } from "./types.cjs";
+
+//#region src/runtime-driver.d.ts
+declare function createRuntimeDriver<TWorkflows extends Record<string, WorkflowRegistration>>(config: WorkflowRuntimeConfig<TWorkflows>): {
+  startRun(args: WorkflowRuntimeStartRunArgs): Promise<WorkflowRuntimeRunResult>;
+  deliverSignal<TPayload = unknown>(args: WorkflowRuntimeDeliverSignalArgs<TPayload>): Promise<WorkflowRuntimeRunResult>;
+  deliverApproval(args: WorkflowRuntimeDeliverApprovalArgs): Promise<WorkflowRuntimeRunResult>;
+  sweep(args?: WorkflowRuntimeSweepArgs): Promise<WorkflowRuntimeSweepResult>;
+};
+//#endregion
+export { createRuntimeDriver };
+//# sourceMappingURL=runtime-driver.d.cts.map

package/dist/runtime-driver.d.ts

@@ -0,0 +1,12 @@
+import { WorkflowRegistration, WorkflowRuntimeConfig, WorkflowRuntimeDeliverApprovalArgs, WorkflowRuntimeDeliverSignalArgs, WorkflowRuntimeRunResult, WorkflowRuntimeStartRunArgs, WorkflowRuntimeSweepArgs, WorkflowRuntimeSweepResult } from "./types.js";
+
+//#region src/runtime-driver.d.ts
+declare function createRuntimeDriver<TWorkflows extends Record<string, WorkflowRegistration>>(config: WorkflowRuntimeConfig<TWorkflows>): {
+  startRun(args: WorkflowRuntimeStartRunArgs): Promise<WorkflowRuntimeRunResult>;
+  deliverSignal<TPayload = unknown>(args: WorkflowRuntimeDeliverSignalArgs<TPayload>): Promise<WorkflowRuntimeRunResult>;
+  deliverApproval(args: WorkflowRuntimeDeliverApprovalArgs): Promise<WorkflowRuntimeRunResult>;
+  sweep(args?: WorkflowRuntimeSweepArgs): Promise<WorkflowRuntimeSweepResult>;
+};
+//#endregion
+export { createRuntimeDriver };
+//# sourceMappingURL=runtime-driver.d.ts.map