@tanstack/workflow-runtime 0.0.1

package/dist/schedule-materializer.js

@@ -0,0 +1,155 @@
+//#region src/schedule-materializer.ts
+const DEFAULT_CRON_LOOKBACK_MS = 768 * 60 * 60 * 1e3;
+async function materializeWorkflowSchedules(runtime, options = {}) {
+	const now = options.now ?? Date.now();
+	const cronLookbackMs = options.cronLookbackMs ?? DEFAULT_CRON_LOOKBACK_MS;
+	const materialized = [];
+	if (!Number.isFinite(cronLookbackMs) || cronLookbackMs < 0) throw new Error("Workflow cron lookback must be a non-negative number.");
+	for (const [workflowId, registration] of Object.entries(runtime.workflows)) {
+		const schedules = registration.schedules ?? [];
+		for (let index = 0; index < schedules.length; index++) {
+			const definition = schedules[index];
+			const scheduleId = getScheduleId(workflowId, definition, index);
+			if (definition.enabled === false) {
+				await runtime.store.upsertSchedule({
+					scheduleId,
+					workflowId,
+					workflowVersion: registration.version,
+					schedule: definition.schedule,
+					overlapPolicy: definition.overlapPolicy ?? "skip",
+					input: void 0,
+					nextFireAt: void 0,
+					enabled: false,
+					now
+				});
+				materialized.push({
+					kind: "disabled",
+					workflowId,
+					scheduleId,
+					schedule: definition.schedule
+				});
+				continue;
+			}
+			const fireAt = getDueFireAt(definition.schedule, now, cronLookbackMs);
+			if (fireAt === void 0) {
+				materialized.push({
+					kind: "not-due",
+					workflowId,
+					scheduleId,
+					schedule: definition.schedule
+				});
+				continue;
+			}
+			await runtime.store.upsertSchedule({
+				scheduleId,
+				workflowId,
+				workflowVersion: registration.version,
+				schedule: definition.schedule,
+				overlapPolicy: definition.overlapPolicy ?? "skip",
+				input: await resolveScheduleInput(definition.input),
+				nextFireAt: fireAt,
+				enabled: true,
+				now
+			});
+			materialized.push({
+				kind: "materialized",
+				workflowId,
+				scheduleId,
+				fireAt,
+				schedule: definition.schedule
+			});
+		}
+	}
+	return materialized;
+}
+function getScheduleId(workflowId, definition, index) {
+	return definition.id ?? `${workflowId}:${index}`;
+}
+async function resolveScheduleInput(input) {
+	return typeof input === "function" ? await input() : input;
+}
+function getDueFireAt(schedule, now, cronLookbackMs) {
+	if (schedule.kind === "interval") {
+		if (!Number.isFinite(schedule.everyMs) || schedule.everyMs <= 0) throw new Error("Interval workflow schedules must use a positive everyMs.");
+		return Math.floor(now / schedule.everyMs) * schedule.everyMs;
+	}
+	return getPreviousCronFireAt(schedule, now, cronLookbackMs);
+}
+function getPreviousCronFireAt(schedule, now, lookbackMs) {
+	if (schedule.timezone && schedule.timezone !== "UTC") throw new Error(`Workflow cron schedules are materialized in UTC. Received timezone "${schedule.timezone}".`);
+	const cron = parseCronExpression(schedule.expression);
+	const start = floorToMinute(now);
+	const end = start - lookbackMs;
+	for (let timestamp = start; timestamp >= end; timestamp -= 6e4) if (matchesCron(cron, new Date(timestamp))) return timestamp;
+}
+function parseCronExpression(expression) {
+	const fields = expression.trim().split(/\s+/);
+	if (fields.length !== 5) throw new Error(`Workflow cron schedules must use five fields. Received "${expression}".`);
+	return {
+		minute: parseCronField(fields[0], 0, 59),
+		hour: parseCronField(fields[1], 0, 23),
+		dayOfMonth: parseCronField(fields[2], 1, 31),
+		month: parseCronField(fields[3], 1, 12),
+		dayOfWeek: parseCronField(fields[4], 0, 7, normalizeDayOfWeek)
+	};
+}
+function parseCronField(field, min, max, normalize = (value) => value) {
+	const values = /* @__PURE__ */ new Set();
+	const parts = field.split(",");
+	for (const part of parts) {
+		const [rangePart, stepPart] = part.split("/");
+		const step = stepPart === void 0 ? 1 : Number(stepPart);
+		if (!Number.isInteger(step) || step <= 0) throw new Error(`Invalid cron step "${part}".`);
+		const range = parseCronRange(rangePart, min, max);
+		for (let value = range.start; value <= range.end; value += step) values.add(normalize(value));
+	}
+	return {
+		wildcard: field === "*",
+		values
+	};
+}
+function parseCronRange(range, min, max) {
+	if (range === "*") return {
+		start: min,
+		end: max
+	};
+	const bounds = range.split("-");
+	if (bounds.length === 1) {
+		const value = parseCronNumber(bounds[0], min, max);
+		return {
+			start: value,
+			end: value
+		};
+	}
+	if (bounds.length === 2) {
+		const start = parseCronNumber(bounds[0], min, max);
+		const end = parseCronNumber(bounds[1], min, max);
+		if (end < start) throw new Error(`Invalid cron range "${range}".`);
+		return {
+			start,
+			end
+		};
+	}
+	throw new Error(`Invalid cron range "${range}".`);
+}
+function parseCronNumber(value, min, max) {
+	const parsed = Number(value);
+	if (!Number.isInteger(parsed) || parsed < min || parsed > max) throw new Error(`Invalid cron value "${value}".`);
+	return parsed;
+}
+function normalizeDayOfWeek(value) {
+	return value === 7 ? 0 : value;
+}
+function matchesCron(cron, date) {
+	const dayOfMonthMatches = cron.dayOfMonth.values.has(date.getUTCDate());
+	const dayOfWeekMatches = cron.dayOfWeek.values.has(date.getUTCDay());
+	const dayMatches = !cron.dayOfMonth.wildcard && !cron.dayOfWeek.wildcard ? dayOfMonthMatches || dayOfWeekMatches : dayOfMonthMatches && dayOfWeekMatches;
+	return cron.minute.values.has(date.getUTCMinutes()) && cron.hour.values.has(date.getUTCHours()) && dayMatches && cron.month.values.has(date.getUTCMonth() + 1);
+}
+function floorToMinute(timestamp) {
+	return Math.floor(timestamp / 6e4) * 6e4;
+}
+
+//#endregion
+export { materializeWorkflowSchedules };
+//# sourceMappingURL=schedule-materializer.js.map

package/dist/schedule-materializer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schedule-materializer.js","names":[],"sources":["../src/schedule-materializer.ts"],"sourcesContent":["import type {\n  ScheduleId,\n  WorkflowRegistrationMap,\n  WorkflowRuntimeDefinition,\n  WorkflowScheduleDefinition,\n  WorkflowScheduleSpec,\n} from './types'\n\nconst DEFAULT_CRON_LOOKBACK_MS = 32 * 24 * 60 * 60 * 1000\n\nexport interface MaterializeWorkflowSchedulesOptions {\n  now?: number\n  cronLookbackMs?: number\n}\n\nexport type MaterializedWorkflowSchedule =\n  | {\n      kind: 'materialized'\n      workflowId: string\n      scheduleId: ScheduleId\n      fireAt: number\n      schedule: WorkflowScheduleSpec\n    }\n  | {\n      kind: 'disabled'\n      workflowId: string\n      scheduleId: ScheduleId\n      schedule: WorkflowScheduleSpec\n    }\n  | {\n      kind: 'not-due'\n      workflowId: string\n      scheduleId: ScheduleId\n      schedule: WorkflowScheduleSpec\n    }\n\nexport async function materializeWorkflowSchedules<\n  TWorkflows extends WorkflowRegistrationMap,\n>(\n  runtime: WorkflowRuntimeDefinition<TWorkflows>,\n  options: MaterializeWorkflowSchedulesOptions = {},\n): Promise<Array<MaterializedWorkflowSchedule>> {\n  const now = options.now ?? Date.now()\n  const cronLookbackMs = options.cronLookbackMs ?? DEFAULT_CRON_LOOKBACK_MS\n  const materialized: Array<MaterializedWorkflowSchedule> = []\n\n  if (!Number.isFinite(cronLookbackMs) || cronLookbackMs < 0) {\n    throw new Error('Workflow cron lookback must be a non-negative number.')\n  }\n\n  for (const [workflowId, registration] of Object.entries(runtime.workflows)) {\n    const schedules = registration.schedules ?? []\n    for (let index = 0; index < schedules.length; index++) {\n      const definition = schedules[index]!\n      const scheduleId = getScheduleId(workflowId, definition, index)\n\n      if (definition.enabled === false) {\n        await runtime.store.upsertSchedule({\n          scheduleId,\n          workflowId,\n          workflowVersion: registration.version,\n          schedule: definition.schedule,\n          overlapPolicy: definition.overlapPolicy ?? 'skip',\n          input: undefined,\n          nextFireAt: undefined,\n          enabled: false,\n          now,\n        })\n        materialized.push({\n          kind: 'disabled',\n          workflowId,\n          scheduleId,\n          schedule: definition.schedule,\n        })\n        continue\n      }\n\n      const fireAt = getDueFireAt(definition.schedule, now, cronLookbackMs)\n      if (fireAt === undefined) {\n        materialized.push({\n          kind: 'not-due',\n          workflowId,\n          scheduleId,\n          schedule: definition.schedule,\n        })\n        continue\n      }\n\n      await runtime.store.upsertSchedule({\n        scheduleId,\n        workflowId,\n        workflowVersion: registration.version,\n        schedule: definition.schedule,\n        overlapPolicy: definition.overlapPolicy ?? 'skip',\n        input: await resolveScheduleInput(definition.input),\n        nextFireAt: fireAt,\n        enabled: true,\n        now,\n      })\n      materialized.push({\n        kind: 'materialized',\n        workflowId,\n        scheduleId,\n        fireAt,\n        schedule: definition.schedule,\n      })\n    }\n  }\n\n  return materialized\n}\n\nfunction getScheduleId(\n  workflowId: string,\n  definition: WorkflowScheduleDefinition,\n  index: number,\n): ScheduleId {\n  return definition.id ?? `${workflowId}:${index}`\n}\n\nasync function resolveScheduleInput(\n  input: WorkflowScheduleDefinition['input'],\n) {\n  return typeof input === 'function' ? await input() : input\n}\n\nfunction getDueFireAt(\n  schedule: WorkflowScheduleSpec,\n  now: number,\n  cronLookbackMs: number,\n) {\n  if (schedule.kind === 'interval') {\n    if (!Number.isFinite(schedule.everyMs) || schedule.everyMs <= 0) {\n      throw new Error(\n        'Interval workflow schedules must use a positive everyMs.',\n      )\n    }\n    return Math.floor(now / schedule.everyMs) * schedule.everyMs\n  }\n\n  return getPreviousCronFireAt(schedule, now, cronLookbackMs)\n}\n\nfunction getPreviousCronFireAt(\n  schedule: Extract<WorkflowScheduleSpec, { kind: 'cron' }>,\n  now: number,\n  lookbackMs: number,\n) {\n  if (schedule.timezone && schedule.timezone !== 'UTC') {\n    throw new Error(\n      `Workflow cron schedules are materialized in UTC. Received timezone \"${schedule.timezone}\".`,\n    )\n  }\n\n  const cron = parseCronExpression(schedule.expression)\n  const start = floorToMinute(now)\n  const end = start - lookbackMs\n\n  for (let timestamp = start; timestamp >= end; timestamp -= 60_000) {\n    if (matchesCron(cron, new Date(timestamp))) return timestamp\n  }\n\n  return undefined\n}\n\ninterface ParsedCronExpression {\n  minute: ParsedCronField\n  hour: ParsedCronField\n  dayOfMonth: ParsedCronField\n  month: ParsedCronField\n  dayOfWeek: ParsedCronField\n}\n\ninterface ParsedCronField {\n  wildcard: boolean\n  values: ReadonlySet<number>\n}\n\nfunction parseCronExpression(expression: string): ParsedCronExpression {\n  const fields = expression.trim().split(/\\s+/)\n  if (fields.length !== 5) {\n    throw new Error(\n      `Workflow cron schedules must use five fields. Received \"${expression}\".`,\n    )\n  }\n\n  return {\n    minute: parseCronField(fields[0]!, 0, 59),\n    hour: parseCronField(fields[1]!, 0, 23),\n    dayOfMonth: parseCronField(fields[2]!, 1, 31),\n    month: parseCronField(fields[3]!, 1, 12),\n    dayOfWeek: parseCronField(fields[4]!, 0, 7, normalizeDayOfWeek),\n  }\n}\n\nfunction parseCronField(\n  field: string,\n  min: number,\n  max: number,\n  normalize: (value: number) => number = (value) => value,\n): ParsedCronField {\n  const values = new Set<number>()\n  const parts = field.split(',')\n\n  for (const part of parts) {\n    const [rangePart, stepPart] = part.split('/')\n    const step = stepPart === undefined ? 1 : Number(stepPart)\n    if (!Number.isInteger(step) || step <= 0) {\n      throw new Error(`Invalid cron step \"${part}\".`)\n    }\n\n    const range = parseCronRange(rangePart!, min, max)\n    for (let value = range.start; value <= range.end; value += step) {\n      values.add(normalize(value))\n    }\n  }\n\n  return {\n    wildcard: field === '*',\n    values,\n  }\n}\n\nfunction parseCronRange(range: string, min: number, max: number) {\n  if (range === '*') return { start: min, end: max }\n\n  const bounds = range.split('-')\n  if (bounds.length === 1) {\n    const value = parseCronNumber(bounds[0]!, min, max)\n    return { start: value, end: value }\n  }\n  if (bounds.length === 2) {\n    const start = parseCronNumber(bounds[0]!, min, max)\n    const end = parseCronNumber(bounds[1]!, min, max)\n    if (end < start) throw new Error(`Invalid cron range \"${range}\".`)\n    return { start, end }\n  }\n\n  throw new Error(`Invalid cron range \"${range}\".`)\n}\n\nfunction parseCronNumber(value: string, min: number, max: number) {\n  const parsed = Number(value)\n  if (!Number.isInteger(parsed) || parsed < min || parsed > max) {\n    throw new Error(`Invalid cron value \"${value}\".`)\n  }\n  return parsed\n}\n\nfunction normalizeDayOfWeek(value: number) {\n  return value === 7 ? 0 : value\n}\n\nfunction matchesCron(cron: ParsedCronExpression, date: Date) {\n  const dayOfMonthMatches = cron.dayOfMonth.values.has(date.getUTCDate())\n  const dayOfWeekMatches = cron.dayOfWeek.values.has(date.getUTCDay())\n  const dayMatches =\n    !cron.dayOfMonth.wildcard && !cron.dayOfWeek.wildcard\n      ? dayOfMonthMatches || dayOfWeekMatches\n      : dayOfMonthMatches && dayOfWeekMatches\n\n  return (\n    cron.minute.values.has(date.getUTCMinutes()) &&\n    cron.hour.values.has(date.getUTCHours()) &&\n    dayMatches &&\n    cron.month.values.has(date.getUTCMonth() + 1)\n  )\n}\n\nfunction floorToMinute(timestamp: number) {\n  return Math.floor(timestamp / 60_000) * 60_000\n}\n"],"mappings":"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"}

package/dist/types.d.cts

@@ -0,0 +1,375 @@
+import { AnyWorkflowDefinition, ApprovalResult, DeleteReason, RunState, RunStatus, RunStore, SerializedError, SignalDelivery, WorkflowEvent } from "@tanstack/workflow-core";
+
+//#region src/types.d.ts
+type WorkflowId = string;
+type WorkflowVersion = string;
+type RunId = string;
+type ScheduleId = string;
+type ScheduleBucketId = string;
+type LeaseOwner = string;
+type WorkflowExecutionStatus = RunStatus | 'queued';
+interface WorkflowLease {
+  owner: LeaseOwner;
+  expiresAt: number;
+}
+interface WorkflowExecution {
+  runId: RunId;
+  workflowId: WorkflowId;
+  workflowVersion?: WorkflowVersion;
+  status: WorkflowExecutionStatus;
+  input: unknown;
+  output?: unknown;
+  error?: SerializedError;
+  waitingFor?: RunState['waitingFor'];
+  pendingApproval?: RunState['pendingApproval'];
+  wakeAt?: number;
+  lease?: WorkflowLease;
+  createdAt: number;
+  updatedAt: number;
+}
+interface StoredWorkflowEvent {
+  runId: RunId;
+  eventIndex: number;
+  eventType: WorkflowEvent['type'];
+  stepId?: string;
+  event: WorkflowEvent;
+  createdAt: number;
+}
+interface LoadedExecution {
+  run: WorkflowExecution;
+  events: ReadonlyArray<StoredWorkflowEvent>;
+}
+interface CreateRunArgs {
+  runId: RunId;
+  workflowId: WorkflowId;
+  workflowVersion?: WorkflowVersion;
+  input: unknown;
+  now: number;
+}
+type CreateRunResult = {
+  kind: 'created';
+  run: WorkflowExecution;
+} | {
+  kind: 'existing';
+  run: WorkflowExecution;
+};
+interface ReadEventsArgs {
+  runId: RunId;
+  fromIndex?: number;
+}
+interface AppendEventsArgs {
+  runId: RunId;
+  expectedNextIndex: number;
+  events: ReadonlyArray<WorkflowEvent>;
+}
+interface AppendEventsResult {
+  nextIndex: number;
+}
+interface ClaimRunArgs {
+  runId: RunId;
+  leaseOwner: LeaseOwner;
+  leaseMs: number;
+  now: number;
+}
+type ClaimRunResult = {
+  kind: 'claimed';
+  run: WorkflowExecution;
+} | {
+  kind: 'not-found';
+} | {
+  kind: 'not-claimable';
+  run: WorkflowExecution;
+};
+interface HeartbeatRunLeaseArgs {
+  runId: RunId;
+  leaseOwner: LeaseOwner;
+  leaseMs: number;
+  now: number;
+}
+interface ReleaseRunLeaseArgs {
+  runId: RunId;
+  leaseOwner: LeaseOwner;
+}
+interface MarkRunPausedArgs {
+  runId: RunId;
+  waitingFor?: RunState['waitingFor'];
+  pendingApproval?: RunState['pendingApproval'];
+  wakeAt?: number;
+  now: number;
+}
+interface MarkRunFinishedArgs {
+  runId: RunId;
+  output: unknown;
+  now: number;
+}
+interface MarkRunErroredArgs {
+  runId: RunId;
+  error: SerializedError;
+  code: string;
+  now: number;
+}
+interface ScheduleTimerArgs {
+  runId: RunId;
+  workflowId: WorkflowId;
+  workflowVersion?: WorkflowVersion;
+  wakeAt: number;
+  signalId: string;
+  now: number;
+}
+interface ClaimDueTimersArgs {
+  now: number;
+  limit: number;
+  leaseOwner: LeaseOwner;
+  leaseMs: number;
+}
+interface TimerWakeup {
+  runId: RunId;
+  workflowId: WorkflowId;
+  workflowVersion?: WorkflowVersion;
+  wakeAt: number;
+  signalId: string;
+}
+interface DeliverSignalArgs<TPayload = unknown> {
+  runId: RunId;
+  delivery: SignalDelivery<TPayload>;
+  now: number;
+}
+type DeliverSignalResult = {
+  kind: 'delivered';
+  run: WorkflowExecution;
+} | {
+  kind: 'duplicate';
+  run: WorkflowExecution;
+} | {
+  kind: 'not-waiting';
+  run: WorkflowExecution;
+} | {
+  kind: 'not-found';
+};
+interface DeliverApprovalArgs {
+  runId: RunId;
+  approval: ApprovalResult;
+  now: number;
+}
+type DeliverApprovalResult = {
+  kind: 'delivered';
+  run: WorkflowExecution;
+} | {
+  kind: 'duplicate';
+  run: WorkflowExecution;
+} | {
+  kind: 'not-waiting';
+  run: WorkflowExecution;
+} | {
+  kind: 'not-found';
+};
+type WorkflowOverlapPolicy = 'skip' | 'allow' | 'buffer-one' | 'cancel-previous' | 'terminate-previous';
+type WorkflowScheduleSpec = {
+  kind: 'cron';
+  expression: string;
+  timezone?: string;
+} | {
+  kind: 'interval';
+  everyMs: number;
+  timezone?: string;
+};
+interface WorkflowScheduleDefinition {
+  id?: ScheduleId;
+  schedule: WorkflowScheduleSpec;
+  overlapPolicy?: WorkflowOverlapPolicy;
+  input?: unknown | (() => unknown | Promise<unknown>);
+  enabled?: boolean;
+}
+interface UpsertScheduleArgs {
+  scheduleId: ScheduleId;
+  workflowId: WorkflowId;
+  workflowVersion?: WorkflowVersion;
+  schedule: WorkflowScheduleSpec;
+  overlapPolicy: WorkflowOverlapPolicy;
+  input?: unknown;
+  nextFireAt?: number;
+  enabled: boolean;
+  now: number;
+}
+interface ClaimDueScheduleBucketsArgs {
+  now: number;
+  limit: number;
+  leaseOwner: LeaseOwner;
+  leaseMs: number;
+}
+interface ScheduleBucket {
+  scheduleId: ScheduleId;
+  bucketId: ScheduleBucketId;
+  workflowId: WorkflowId;
+  workflowVersion?: WorkflowVersion;
+  runId: RunId;
+  fireAt: number;
+  input: unknown;
+  overlapPolicy: WorkflowOverlapPolicy;
+}
+interface MarkScheduleBucketStartedArgs {
+  scheduleId: ScheduleId;
+  bucketId: ScheduleBucketId;
+  runId: RunId;
+  now: number;
+}
+interface ClaimStaleRunsArgs {
+  now: number;
+  limit: number;
+  leaseOwner: LeaseOwner;
+  leaseMs: number;
+}
+interface RunClaim {
+  run: WorkflowExecution;
+  lease: WorkflowLease;
+}
+interface ListRunsArgs {
+  workflowId?: WorkflowId;
+  status?: WorkflowExecutionStatus;
+  limit: number;
+  cursor?: string;
+}
+interface RunSummary {
+  runId: RunId;
+  workflowId: WorkflowId;
+  workflowVersion?: WorkflowVersion;
+  status: WorkflowExecutionStatus;
+  waitingFor?: RunState['waitingFor'];
+  pendingApproval?: RunState['pendingApproval'];
+  wakeAt?: number;
+  createdAt: number;
+  updatedAt: number;
+}
+interface RunTimeline {
+  run: WorkflowExecution;
+  events: ReadonlyArray<StoredWorkflowEvent>;
+}
+interface SaveRunStateArgs {
+  state: RunState;
+}
+interface WorkflowRunStoreAdapterStore {
+  loadRunState: (runId: RunId) => Promise<RunState | undefined>;
+  saveRunState: (args: SaveRunStateArgs) => Promise<void>;
+  deleteRun: (runId: RunId, reason: DeleteReason) => Promise<void>;
+  appendEvents: (args: AppendEventsArgs) => Promise<AppendEventsResult>;
+  readEvents: (args: ReadEventsArgs) => Promise<ReadonlyArray<StoredWorkflowEvent>>;
+  subscribeEvents?: (runId: RunId, fromIndex: number, onEvent: (event: WorkflowEvent, index: number) => void) => () => void;
+}
+type WorkflowRunStoreAdapter = RunStore;
+interface WorkflowExecutionStore extends WorkflowRunStoreAdapterStore {
+  createRun: (args: CreateRunArgs) => Promise<CreateRunResult>;
+  loadRun: (runId: RunId) => Promise<WorkflowExecution | undefined>;
+  loadExecution: (runId: RunId) => Promise<LoadedExecution | undefined>;
+  claimRun: (args: ClaimRunArgs) => Promise<ClaimRunResult>;
+  heartbeatRunLease: (args: HeartbeatRunLeaseArgs) => Promise<void>;
+  releaseRunLease: (args: ReleaseRunLeaseArgs) => Promise<void>;
+  markRunPaused: (args: MarkRunPausedArgs) => Promise<void>;
+  markRunFinished: (args: MarkRunFinishedArgs) => Promise<void>;
+  markRunErrored: (args: MarkRunErroredArgs) => Promise<void>;
+  scheduleTimer: (args: ScheduleTimerArgs) => Promise<void>;
+  claimDueTimers: (args: ClaimDueTimersArgs) => Promise<ReadonlyArray<TimerWakeup>>;
+  deliverSignal: <TPayload = unknown>(args: DeliverSignalArgs<TPayload>) => Promise<DeliverSignalResult>;
+  deliverApproval: (args: DeliverApprovalArgs) => Promise<DeliverApprovalResult>;
+  upsertSchedule: (args: UpsertScheduleArgs) => Promise<void>;
+  claimDueScheduleBuckets: (args: ClaimDueScheduleBucketsArgs) => Promise<ReadonlyArray<ScheduleBucket>>;
+  markScheduleBucketStarted: (args: MarkScheduleBucketStartedArgs) => Promise<void>;
+  claimStaleRuns: (args: ClaimStaleRunsArgs) => Promise<ReadonlyArray<RunClaim>>;
+  listRuns: (args: ListRunsArgs) => Promise<ReadonlyArray<RunSummary>>;
+  getRunTimeline: (runId: RunId) => Promise<RunTimeline | undefined>;
+}
+type WorkflowLoaderResult<TWorkflow extends AnyWorkflowDefinition = AnyWorkflowDefinition> = TWorkflow | {
+  default: TWorkflow;
+} | {
+  workflow: TWorkflow;
+};
+type WorkflowLoader<TWorkflow extends AnyWorkflowDefinition = AnyWorkflowDefinition> = () => Promise<WorkflowLoaderResult<TWorkflow>>;
+interface WorkflowRegistration<TWorkflow extends AnyWorkflowDefinition = AnyWorkflowDefinition> {
+  load: WorkflowLoader<TWorkflow>;
+  version?: WorkflowVersion;
+  previousVersions?: Record<WorkflowVersion, WorkflowLoader>;
+  schedules?: ReadonlyArray<WorkflowScheduleDefinition>;
+}
+type WorkflowRegistrationMap = Record<string, WorkflowRegistration>;
+interface WorkflowRuntimeConfig<TWorkflows extends WorkflowRegistrationMap = WorkflowRegistrationMap> {
+  workflows: TWorkflows;
+  store: WorkflowExecutionStore;
+  defaultLeaseMs?: number;
+}
+interface WorkflowRuntimeDefinition<TWorkflows extends WorkflowRegistrationMap = WorkflowRegistrationMap> extends WorkflowRuntimeConfig<TWorkflows> {
+  __kind: 'workflow-runtime';
+  startRun: (args: WorkflowRuntimeStartRunArgs) => Promise<WorkflowRuntimeRunResult>;
+  deliverSignal: <TPayload = unknown>(args: WorkflowRuntimeDeliverSignalArgs<TPayload>) => Promise<WorkflowRuntimeRunResult>;
+  deliverApproval: (args: WorkflowRuntimeDeliverApprovalArgs) => Promise<WorkflowRuntimeRunResult>;
+  sweep: (args?: WorkflowRuntimeSweepArgs) => Promise<WorkflowRuntimeSweepResult>;
+}
+interface WorkflowRuntimeStartRunArgs {
+  workflowId: WorkflowId;
+  runId: RunId;
+  input: unknown;
+  now?: number;
+  leaseOwner?: LeaseOwner;
+  leaseMs?: number;
+  threadId?: string;
+  includeEvents?: boolean;
+  maxEvents?: number;
+}
+interface WorkflowRuntimeDeliverSignalArgs<TPayload = unknown> {
+  runId: RunId;
+  signalId: string;
+  name: string;
+  payload: TPayload;
+  now?: number;
+  leaseOwner?: LeaseOwner;
+  leaseMs?: number;
+  threadId?: string;
+  includeEvents?: boolean;
+  maxEvents?: number;
+}
+interface WorkflowRuntimeDeliverApprovalArgs {
+  runId: RunId;
+  approval: ApprovalResult;
+  now?: number;
+  leaseOwner?: LeaseOwner;
+  leaseMs?: number;
+  threadId?: string;
+  includeEvents?: boolean;
+  maxEvents?: number;
+}
+type WorkflowRuntimeRunResultKind = 'completed' | 'paused' | 'errored' | 'running' | 'not-found' | 'not-claimable' | 'not-waiting' | 'duplicate';
+interface WorkflowRuntimeRunResult {
+  kind: WorkflowRuntimeRunResultKind;
+  runId: RunId;
+  workflowId?: WorkflowId;
+  run?: WorkflowExecution;
+  events: ReadonlyArray<WorkflowEvent>;
+  eventCount: number;
+  eventsTruncated?: boolean;
+}
+interface WorkflowRuntimeSweepArgs {
+  now?: number;
+  limit?: number;
+  maxScheduledRuns?: number;
+  maxTimers?: number;
+  maxDurationMs?: number;
+  leaseOwner?: LeaseOwner;
+  leaseMs?: number;
+  includeEvents?: boolean;
+  maxEvents?: number;
+}
+interface WorkflowRuntimeSweepResult {
+  scheduled: ReadonlyArray<WorkflowRuntimeRunResult>;
+  timers: ReadonlyArray<WorkflowRuntimeRunResult>;
+  summary: WorkflowRuntimeSweepSummary;
+  deadlineReached: boolean;
+  remainingMayExist: boolean;
+}
+type WorkflowRuntimeRunKindCounts = Partial<Record<WorkflowRuntimeRunResultKind, number>>;
+interface WorkflowRuntimeSweepSummary {
+  scheduled: WorkflowRuntimeRunKindCounts;
+  timers: WorkflowRuntimeRunKindCounts;
+  eventCount: number;
+  returnedEventCount: number;
+}
+//#endregion
+export { AppendEventsArgs, AppendEventsResult, ClaimDueScheduleBucketsArgs, ClaimDueTimersArgs, ClaimRunArgs, ClaimRunResult, ClaimStaleRunsArgs, CreateRunArgs, CreateRunResult, DeliverApprovalArgs, DeliverApprovalResult, DeliverSignalArgs, DeliverSignalResult, HeartbeatRunLeaseArgs, LeaseOwner, ListRunsArgs, LoadedExecution, MarkRunErroredArgs, MarkRunFinishedArgs, MarkRunPausedArgs, MarkScheduleBucketStartedArgs, ReadEventsArgs, ReleaseRunLeaseArgs, RunClaim, RunId, RunSummary, RunTimeline, SaveRunStateArgs, ScheduleBucket, ScheduleBucketId, ScheduleId, ScheduleTimerArgs, StoredWorkflowEvent, TimerWakeup, UpsertScheduleArgs, WorkflowExecution, WorkflowExecutionStatus, WorkflowExecutionStore, WorkflowId, WorkflowLease, WorkflowLoader, WorkflowLoaderResult, WorkflowOverlapPolicy, WorkflowRegistration, WorkflowRegistrationMap, WorkflowRunStoreAdapter, WorkflowRunStoreAdapterStore, WorkflowRuntimeConfig, WorkflowRuntimeDefinition, WorkflowRuntimeDeliverApprovalArgs, WorkflowRuntimeDeliverSignalArgs, WorkflowRuntimeRunKindCounts, WorkflowRuntimeRunResult, WorkflowRuntimeRunResultKind, WorkflowRuntimeStartRunArgs, WorkflowRuntimeSweepArgs, WorkflowRuntimeSweepResult, WorkflowRuntimeSweepSummary, WorkflowScheduleDefinition, WorkflowScheduleSpec, WorkflowVersion };
+//# sourceMappingURL=types.d.cts.map