@voltro/workflow 0.33.0 → 0.35.0

package/dist/index.js

@@ -1,3 +1,3 @@
-import { A as e, C as t, D as n, E as r, F as i, M as a, N as o, O as s, P as c, S as l, _ as u, a as d, b as f, c as p, d as m, f as h, g, h as _, i as v, j as y, k as b, l as x, m as S, n as C, o as w, p as T, r as E, s as D, t as O, u as k, v as A, w as j, x as M, y as N } from "./primitives-Bp98_F5L.js";
-import { $ as P, A as F, B as I, C as L, D as R, E as z, F as B, G as V, H, I as U, J as W, K as G, L as K, M as q, N as J, O as Y, P as X, Q as Z, R as Q, S as $, T as ee, U as te, V as ne, W as re, X as ie, Y as ae, Z as oe, _ as se, a as ce, at as le, b as ue, c as de, ct as fe, d as pe, dt as me, et as he, f as ge, ft as _e, g as ve, h as ye, i as be, it as xe, j as Se, k as Ce, l as we, lt as Te, m as Ee, mt as De, n as Oe, nt as ke, o as Ae, ot as je, p as Me, pt as Ne, q as Pe, r as Fe, rt as Ie, s as Le, st as Re, t as ze, tt as Be, u as Ve, ut as He, v as Ue, w as We, x as Ge, y as Ke, z as qe } from "./src-CP61KZ9V.js";
-export { J as ADMISSIONS_TABLE, ue as CANCEL_ON_WATERMARK, t as CurrentWorkflowExecutionId, j as CurrentWorkflowRunId, Ge as DEFAULT_COLD_LOOKBACK_MS, Ue as DEFAULT_DRAIN_BATCH, $ as DEFAULT_EVENT_BATCH, X as DEFAULT_LEASE_MS, e as DEFERRING_CONTROLS, L as EVENTS_TABLE, P as FlowControlKeyError, B as PAUSES_TABLE, U as PENDING_TABLE, We as WATERMARKS_TABLE, O as WorkflowFlowControlProperty, C as WorkflowMessagesProperty, r as WorkflowRunRecorder, n as WorkflowStepInterceptorTag, E as WorkflowVersionTypeId, v as WorkflowWorkerLayerTypeId, Re as _voltroWorkflowAdmissionsTable, fe as _voltroWorkflowPausesTable, Te as _voltroWorkflowPendingTable, me as _voltroWorkflowRunEventsTable, _e as _voltroWorkflowRunStepsTable, Ne as _voltroWorkflowRunsTable, He as _voltroWorkflowStartContextsTable, F as _voltroWorkflowWatermarksTable, Se as admitStart, K as allIntents, y as assertConsistentPools, ve as awaitEvent, se as awaitSignal, we as awaitSignalSuspending, de as awaitUpdate, Fe as closeWorkflowChildrenForParent, he as comparePendingOrder, Ve as completeSuspendingSignal, Be as decideAdmission, a as deferringControlsOf, Q as deleteIntent, qe as discardIntent, Ke as drainTick, I as dueIntents, d as durableClock, w as durableQueue, D as durableQueueModule, p as durableRateLimiterModule, ne as evaluateAdmission, s as getCurrentWorkflowExecutionId, b as getCurrentWorkflowRunId, x as getWorkflowFlowControl, k as getWorkflowVersionMetadata, o as hasCancelOn, c as hasFlowControl, De as inMemoryWorkflowEngineLayer, Oe as inspectWorkflow, ke as isFinishExpired, Ie as isStartExpired, m as isWorkflowWorkerLayer, q as linkExecution, ze as makeInMemoryRecorder, be as makeWorkflowRunRecorder, ge as makeWorkflowUpdateId, Y as newestEventAt, xe as nextSlotAt, H as noteIntentAttempt, te as pauseWorkflow, re as pendingSlotId, V as pendingWindow, G as persistDefer, Ce as planCancellations, le as pooledConcurrencyKey, h as processQueue, Pe as pruneAdmissions, T as queueWorker, S as rateLimit, W as readAdmissionState, ae as readPausedWorkflows, ee as readWatermark, ie as recordAdmission, oe as releaseLease, je as resolveAdmissionKeys, Me as resolveWorkflowMessageRun, Z as resumeWorkflow, Ee as sendWorkflowSignal, ye as sendWorkflowUpdate, ce as serialiseWorkflowRowForWire, _ as sleep, g as sleepUntil, u as step, A as stepIdempotencyKey, N as stepModule, pe as suspendingSignalDeferredName, z as sweepCancelOn, Ae as truncateWorkflowValue, i as validateFlowControl, f as withCompensation, M as workflow, l as workflowModule, Le as wrapWorkflowExecuteWithRunRecording, R as writeWatermark };
+import { A as e, B as t, C as n, D as r, E as i, G as a, H as o, I as s, L as c, M as l, N as u, O as d, P as f, R as p, S as m, T as h, U as g, V as _, W as v, _ as y, a as b, b as x, c as S, d as C, f as w, g as T, h as E, i as D, j as O, k, l as A, m as j, n as M, o as N, p as P, r as F, s as I, t as L, u as R, v as z, w as B, x as V, y as H, z as U } from "./primitives-CyQZeT1t.js";
+import { $ as W, A as G, At as K, B as q, C as J, Ct as Y, D as X, Dt as Z, E as Q, Et as $, F as ee, Ft as te, G as ne, H as re, I as ie, It as ae, J as oe, K as se, L as ce, Lt as le, M as ue, Mt as de, N as fe, Nt as pe, O as me, Ot as he, P as ge, Pt as _e, Q as ve, R as ye, Rt as be, S as xe, St as Se, T as Ce, Tt as we, U as Te, V as Ee, W as De, X as Oe, Y as ke, Z as Ae, _ as je, _t as Me, a as Ne, at as Pe, b as Fe, bt as Ie, c as Le, ct as Re, d as ze, dt as Be, et as Ve, f as He, ft as Ue, g as We, gt as Ge, h as Ke, ht as qe, i as Je, it as Ye, j as Xe, jt as Ze, k as Qe, kt as $e, l as et, lt as tt, m as nt, mt as rt, n as it, nt as at, o as ot, ot as st, p as ct, pt as lt, q as ut, r as dt, rt as ft, s as pt, st as mt, t as ht, tt as gt, u as _t, ut as vt, v as yt, vt as bt, w as xt, wt as St, x as Ct, xt as wt, y as Tt, yt as Et, z as Dt, zt as Ot } from "./src-DPkbBZDD.js";
+export { ft as ADMISSIONS_TABLE, ct as BUDGET_HOLDS_TABLE, nt as BudgetHoldExpired, De as CANCEL_ON_WATERMARK, l as CurrentWorkflowExecutionId, u as CurrentWorkflowPatches, B as CurrentWorkflowReplayShape, f as CurrentWorkflowRunId, Ke as DEFAULT_BUDGET_HOLD_TIMEOUT_MS, ne as DEFAULT_COLD_LOOKBACK_MS, ye as DEFAULT_DRAIN_BATCH, se as DEFAULT_EVENT_BATCH, Ye as DEFAULT_LEASE_MS, Je as DEFAULT_MAX_RUN_RECLAIMS, Ne as DEFAULT_REPLAY_SHAPE_LIMIT, q as DEFAULT_STALL_AFTER_MS, Ee as DEFAULT_STALL_EVENT_LOOKBACK, re as DEFAULT_STALL_RUN_PAGE, fe as DEFAULT_SUSPEND_HINT_MS, d as DEFAULT_WORKFLOW_SCHEDULE_MAX_RUNTIME_MS, t as DEFERRING_CONTROLS, ut as EVENTS_TABLE, St as FlowControlKeyError, Pe as PAUSES_TABLE, st as PENDING_TABLE, oe as WATERMARKS_TABLE, L as WorkflowFlowControlProperty, M as WorkflowMessagesProperty, s as WorkflowRunRecorder, k as WorkflowScheduleProperty, c as WorkflowStepInterceptorTag, F as WorkflowVersionTypeId, D as WorkflowWorkerLayerTypeId, We as _voltroBudgetHoldsTable, de as _voltroWorkflowAdmissionsTable, pe as _voltroWorkflowPausesTable, _e as _voltroWorkflowPendingTable, ae as _voltroWorkflowRunEventsTable, le as _voltroWorkflowRunStepsTable, be as _voltroWorkflowRunsTable, te as _voltroWorkflowStartContextsTable, Ve as _voltroWorkflowWatermarksTable, gt as admitStart, mt as allIntents, _ as assertConsistentPools, Xe as awaitEvent, ue as awaitSignal, xt as awaitSignalSuspending, He as awaitUpdate, je as budgetHoldGeneration, yt as budgetHoldKey, Tt as budgetHoldSignalName, dt as closeWorkflowChildrenForParent, we as comparePendingOrder, Ce as completeSuspendingSignal, $ as decideAdmission, o as deferringControlsOf, Re as deleteIntent, tt as discardIntent, Dt as drainTick, vt as dueIntents, b as durableClock, N as durableQueue, I as durableQueueModule, S as durableRateLimiterModule, Be as evaluateAdmission, p as getCurrentWorkflowExecutionId, U as getCurrentWorkflowRunId, A as getWorkflowFlowControl, e as getWorkflowSchedule, R as getWorkflowVersionMetadata, g as hasCancelOn, v as hasFlowControl, Fe as heldBudgets, Ot as inMemoryWorkflowEngineLayer, it as inspectWorkflow, Z as isFinishExpired, he as isStartExpired, C as isWorkflowWorkerLayer, at as linkExecution, ht as makeInMemoryRecorder, h as makeReplayShapeTracker, ot as makeWorkflowRunRecorder, X as makeWorkflowUpdateId, ge as maybeHintSuspendingSignal, ve as newestEventAt, $e as nextSlotAt, i as nondeterminismEventPayload, pt as normaliseWorkflowPatches, Ue as noteIntentAttempt, lt as parkDelayedStart, w as patch, rt as pauseWorkflow, Ct as pendingBudgetHolds, qe as pendingSlotId, Ge as pendingWindow, Me as persistDefer, W as planCancellations, K as pooledConcurrencyKey, P as processQueue, bt as pruneAdmissions, j as queueWorker, E as rateLimit, Et as readAdmissionState, Ie as readPausedWorkflows, ke as readWatermark, wt as recordAdmission, xe as releaseBudgetHolds, Se as releaseLease, r as reportNondeterminism, ee as resetSuspendHintsForTest, Ze as resolveAdmissionKeys, Le as resolveRunGuardTuning, ie as resolveSuspendHintMs, me as resolveWorkflowMessageRun, Y as resumeWorkflow, Qe as sendWorkflowSignal, G as sendWorkflowUpdate, et as serialiseWorkflowRowForWire, ce as setSuspendSignalHintMs, T as sleep, y as sleepUntil, z as step, H as stepIdempotencyKey, x as stepModule, J as suspendForBudget, Q as suspendingSignalDeferredName, Oe as sweepCancelOn, Te as sweepStalledRuns, _t as truncateWorkflowValue, a as validateFlowControl, O as validateWorkflowSchedule, V as withCompensation, m as workflow, n as workflowModule, ze as wrapWorkflowExecuteWithRunRecording, Ae as writeWatermark };

package/dist/{primitives-Bp98_F5L.js → primitives-CyQZeT1t.js}

@@ -1,44 +1,44 @@
 import { Activity as e, Activity as t, DurableClock as n, DurableClock as r, DurableQueue as i, DurableQueue as a, DurableRateLimiter as o, DurableRateLimiter as s, Workflow as c, Workflow as l } from "@effect/workflow";
-import { Cause as u, Context as d, Duration as f, Effect as p, Exit as m, FiberRef as h, Option as g, Schedule as _, Schema as v } from "effect";
+import { Cause as u, Context as d, Cron as f, Duration as p, Effect as m, Either as h, Exit as ee, FiberRef as g, Option as te, Schedule as _, Schema as ne } from "effect";
 //#region src/flowControl.ts
-var y = (e) => e !== void 0 && (e.debounce !== void 0 || e.singleton !== void 0 || e.concurrency !== void 0 || e.throttle !== void 0 || e.rateLimit !== void 0 || e.batch !== void 0 || e.timeouts?.startMs !== void 0 || e.timeouts?.finishMs !== void 0), b = (e) => e?.cancelOn !== void 0 && e.cancelOn.length > 0, x = [
+var re = (e) => e !== void 0 && (e.debounce !== void 0 || e.singleton !== void 0 || e.concurrency !== void 0 || e.throttle !== void 0 || e.rateLimit !== void 0 || e.batch !== void 0 || e.timeouts?.startMs !== void 0 || e.timeouts?.finishMs !== void 0), v = (e) => e?.cancelOn !== void 0 && e.cancelOn.length > 0, y = [
 	"debounce",
 	"batch",
 	"throttle",
 	"concurrency"
-], S = (e) => {
+], b = (e) => {
 	if (e === void 0) return [];
 	let t = [];
 	return e.debounce !== void 0 && t.push("debounce"), e.batch !== void 0 && t.push("batch"), e.throttle !== void 0 && t.push("throttle"), e.concurrency !== void 0 && t.push("concurrency"), t;
-}, C = (e, t, n) => {
+}, x = (e, t, n) => {
 	let r;
 	try {
-		r = f.toMillis(f.decode(e));
+		r = p.toMillis(p.decode(e));
 	} catch {
 		throw Error(`workflow '${n}': ${t} is not a duration Effect can read (got ${JSON.stringify(e)}). Use a spelled-out unit ('15 minutes', '1 hour', '30 seconds'), a number of milliseconds, or a Duration — the abbreviated forms ('15m', '1h') are NOT accepted.`);
 	}
 	if (!Number.isFinite(r) || r <= 0) throw Error(`workflow '${n}': ${t} must be a positive finite duration, got ${String(e)}`);
 	return r;
-}, w = (e, t, n) => {
+}, S = (e, t, n) => {
 	if (!Number.isInteger(e) || e <= 0) throw Error(`workflow '${n}': ${t} must be a positive integer, got ${String(e)}`);
 	return e;
-}, T = (e, t, n) => {
+}, C = (e, t, n) => {
 	if (typeof e != "function") throw Error(`workflow '${n}': ${t} must be a function of the payload`);
 	return e;
-}, E = (e) => {
+}, w = (e) => {
 	let t = e?.ast?.propertySignatures;
 	if (!Array.isArray(t)) return !1;
 	let n = t.find((e) => e.name === "items");
 	return n !== void 0 && n.type?._tag === "TupleType";
-}, D = (e) => {
+}, T = (e) => {
 	let { workflowName: t, control: n } = e;
 	if (n === void 0) return;
 	let r = { workflowName: t };
 	if (n.debounce !== void 0) {
-		let e = n.debounce, i = C(e.period, "debounce.period", t), a = e.timeout === void 0 ? void 0 : C(e.timeout, "debounce.timeout", t);
+		let e = n.debounce, i = x(e.period, "debounce.period", t), a = e.timeout === void 0 ? void 0 : x(e.timeout, "debounce.timeout", t);
 		if (a !== void 0 && a < i) throw Error(`workflow '${t}': debounce.timeout (${a}ms) is shorter than debounce.period (${i}ms), so the burst can never be collapsed — the run would be admitted before the quiet period could ever elapse. Raise the timeout or lower the period.`);
 		r.debounce = {
-			key: T(e.key, "debounce.key", t),
+			key: C(e.key, "debounce.key", t),
 			periodMs: i,
 			...a === void 0 ? {} : { timeoutMs: a }
 		};
@@ -47,7 +47,7 @@ var y = (e) => e !== void 0 && (e.debounce !== void 0 || e.singleton !== void 0
 		let e = n.singleton;
 		if (e.mode !== "skip" && e.mode !== "cancel") throw Error(`workflow '${t}': singleton.mode must be 'skip' or 'cancel'. There is no default — 'skip' discards the incoming request and 'cancel' discards the running one, and choosing for you would silently throw away work either way.`);
 		r.singleton = {
-			key: T(e.key, "singleton.key", t),
+			key: C(e.key, "singleton.key", t),
 			mode: e.mode
 		};
 	}
@@ -55,34 +55,34 @@ var y = (e) => e !== void 0 && (e.debounce !== void 0 || e.singleton !== void 0
 		let e = n.concurrency;
 		if (e.pool !== void 0 && (typeof e.pool != "string" || e.pool.trim() === "")) throw Error(`workflow '${t}': concurrency.pool must be a non-empty name — it is the identity other workflows declare to share this budget, and an empty one would silently merge every empty-named pool in the deployment into one.`);
 		r.concurrency = {
-			limit: w(e.limit, "concurrency.limit", t),
-			...e.key === void 0 ? {} : { key: T(e.key, "concurrency.key", t) },
+			limit: S(e.limit, "concurrency.limit", t),
+			...e.key === void 0 ? {} : { key: C(e.key, "concurrency.key", t) },
 			...e.pool === void 0 ? {} : { pool: e.pool.trim() }
 		};
 	}
 	if (n.throttle !== void 0) {
 		let e = n.throttle;
 		r.throttle = {
-			limit: w(e.limit, "throttle.limit", t),
-			periodMs: C(e.period, "throttle.period", t),
-			...e.key === void 0 ? {} : { key: T(e.key, "throttle.key", t) }
+			limit: S(e.limit, "throttle.limit", t),
+			periodMs: x(e.period, "throttle.period", t),
+			...e.key === void 0 ? {} : { key: C(e.key, "throttle.key", t) }
 		};
 	}
 	if (n.rateLimit !== void 0) {
 		let e = n.rateLimit;
 		r.rateLimit = {
-			limit: w(e.limit, "rateLimit.limit", t),
-			periodMs: C(e.period, "rateLimit.period", t),
-			...e.key === void 0 ? {} : { key: T(e.key, "rateLimit.key", t) }
+			limit: S(e.limit, "rateLimit.limit", t),
+			periodMs: x(e.period, "rateLimit.period", t),
+			...e.key === void 0 ? {} : { key: C(e.key, "rateLimit.key", t) }
 		};
 	}
 	if (n.batch !== void 0) {
 		let i = n.batch;
-		if (e.payloadSchema !== void 0 && !E(e.payloadSchema)) throw Error(`workflow '${t}': batch is declared, so the workflow's own \`payload\` must be the BATCH shape — \`Schema.Struct({ items: Schema.Array(Item) })\` — while callers start it with a SINGLE item. Declare the item's schema as \`batch.item\`. Checked here rather than at admission because a decode failure on the batching replica is a failure nobody is watching.`);
+		if (e.payloadSchema !== void 0 && !w(e.payloadSchema)) throw Error(`workflow '${t}': batch is declared, so the workflow's own \`payload\` must be the BATCH shape — \`Schema.Struct({ items: Schema.Array(Item) })\` — while callers start it with a SINGLE item. Declare the item's schema as \`batch.item\`. Checked here rather than at admission because a decode failure on the batching replica is a failure nobody is watching.`);
 		r.batch = {
-			...i.key === void 0 ? {} : { key: T(i.key, "batch.key", t) },
-			maxSize: w(i.maxSize, "batch.maxSize", t),
-			timeoutMs: C(i.timeout, "batch.timeout", t),
+			...i.key === void 0 ? {} : { key: C(i.key, "batch.key", t) },
+			maxSize: S(i.maxSize, "batch.maxSize", t),
+			timeoutMs: x(i.timeout, "batch.timeout", t),
 			...i.item === void 0 ? {} : { item: i.item }
 		};
 	}
@@ -91,7 +91,7 @@ var y = (e) => e !== void 0 && (e.debounce !== void 0 || e.singleton !== void 0
 		r.priority = n.priority;
 	}
 	if (n.timeouts !== void 0) {
-		let e = n.timeouts, i = e.start === void 0 ? void 0 : C(e.start, "timeouts.start", t), a = e.finish === void 0 ? void 0 : C(e.finish, "timeouts.finish", t);
+		let e = n.timeouts, i = e.start === void 0 ? void 0 : x(e.start, "timeouts.start", t), a = e.finish === void 0 ? void 0 : x(e.finish, "timeouts.finish", t);
 		(i !== void 0 || a !== void 0) && (r.timeouts = {
 			...i === void 0 ? {} : { startMs: i },
 			...a === void 0 ? {} : { finishMs: a }
@@ -111,7 +111,7 @@ var y = (e) => e !== void 0 && (e.debounce !== void 0 || e.singleton !== void 0
 			if (typeof e?.event != "string" || e.event.length === 0) throw Error(`workflow '${t}': ${r}.event must be a non-empty event name, exactly as ctx.events.publish writes it.`);
 			if (e.schema === void 0 || typeof e.schema.ast != "object") throw Error(`workflow '${t}': ${r}.schema must be a Schema for the event payload. It is decoded before \`match\` runs, so the predicate reads the domain type rather than raw JSON.`);
 			if (typeof e.match != "function") throw Error(`workflow '${t}': ${r}.match is required. Omitting it would mean "cancel every live run of this workflow whenever '${e.event}' is published" — write \`match: () => true\` if that is what you mean, so it is visible in review.`);
-			let i = e.within === void 0 ? void 0 : C(e.within, `${r}.within`, t);
+			let i = e.within === void 0 ? void 0 : x(e.within, `${r}.within`, t);
 			return {
 				event: e.event,
 				schema: e.schema,
@@ -122,9 +122,9 @@ var y = (e) => e !== void 0 && (e.debounce !== void 0 || e.singleton !== void 0
 		});
 		e.length > 0 && (r.cancelOn = e);
 	}
-	if (r.timeouts?.startMs !== void 0 && S(r).length === 0) throw Error(`workflow '${t}': timeouts.start bounds how long a run may sit in the ADMISSION queue, but this workflow declares no control that can defer one (debounce, batch, throttle, concurrency). It would never fire. Use timeouts.finish to bound the run itself.`);
+	if (r.timeouts?.startMs !== void 0 && b(r).length === 0) throw Error(`workflow '${t}': timeouts.start bounds how long a run may sit in the ADMISSION queue, but this workflow declares no control that can defer one (debounce, batch, throttle, concurrency). It would never fire. Use timeouts.finish to bound the run itself.`);
 	return r;
-}, ee = (e) => {
+}, E = (e) => {
 	let t = /* @__PURE__ */ new Map();
 	for (let n of e) {
 		let e = n?.concurrency;
@@ -137,103 +137,191 @@ var y = (e) => e !== void 0 && (e.debounce !== void 0 || e.singleton !== void 0
 		else if (r.limit !== e.limit) throw Error(`concurrency pool '${e.pool}': '${n.workflowName}' declares limit ${e.limit}, but ${r.workflows.map((e) => `'${e}'`).join(", ")} declare${r.workflows.length === 1 ? "s" : ""} limit ${r.limit}. A pool is ONE budget — every member must declare the same number, or the enforced limit would depend on which workflow's start arrived first. Align the limits, or give the workflows different pool names if they were never meant to share.`);
 		else r.workflows.push(n.workflowName);
 	}
-}, O = class extends d.Tag("@voltro/WorkflowRunRecorder")() {}, k = h.unsafeMake(void 0), A = h.unsafeMake(void 0), j = h.unsafeMake(void 0), M = () => h.get(k), N = () => h.get(A), P = class extends d.Tag("@voltro/WorkflowStepInterceptor")() {}, F = (e) => {
+}, D = class extends d.Tag("@voltro/WorkflowRunRecorder")() {}, O = g.unsafeMake(void 0), k = g.unsafeMake(void 0), A = g.unsafeMake(void 0), j = g.unsafeMake([]), M = () => g.get(O), N = () => g.get(k), P = class extends d.Tag("@voltro/WorkflowStepInterceptor")() {}, F = 1440 * 6e4, ie = /* @__PURE__ */ new Set([
+	"skip",
+	"buffer",
+	"cancelOther"
+]), ae = /* @__PURE__ */ new Set([
+	"skip",
+	"latest",
+	"all"
+]), I = (e, t) => {
+	if (t === void 0) return;
+	if (typeof t.timezone != "string" || t.timezone.trim() === "") throw Error(`workflow '${e}': schedule.timezone is required (e.g. "UTC", "Europe/Berlin") — never server-local, which differs between your machine and the container.`);
+	let n = f.parse(t.cron, t.timezone);
+	if (h.isLeft(n)) throw Error(`workflow '${e}': schedule.cron "${t.cron}" (tz="${t.timezone}") is not a valid cron expression — ${String(n.left)}`);
+	let r = t.onOverlap ?? "skip";
+	if (!ie.has(r)) throw Error(`workflow '${e}': schedule.onOverlap must be 'skip' | 'buffer' | 'cancelOther', got ${JSON.stringify(r)}`);
+	let i = t.backfill ?? "skip";
+	if (!ae.has(i)) throw Error(`workflow '${e}': schedule.backfill must be 'skip' | 'latest' | 'all', got ${JSON.stringify(i)}`);
+	let a = F;
+	return t.maxRuntime !== void 0 && (a = L(t.maxRuntime, e)), {
+		cron: t.cron,
+		timezone: t.timezone,
+		...t.payload === void 0 ? {} : { payload: t.payload },
+		onOverlap: r,
+		backfill: i,
+		maxRuntimeMs: a
+	};
+}, L = (e, t) => {
+	let n;
+	try {
+		n = p.toMillis(p.decode(e));
+	} catch {
+		throw Error(`workflow '${t}': schedule.maxRuntime is not a duration Effect can read (got ${JSON.stringify(e)}). Use '2 hours', a number of milliseconds, or a Duration.`);
+	}
+	if (!Number.isFinite(n) || n <= 0) throw Error(`workflow '${t}': schedule.maxRuntime must be a positive finite duration`);
+	return n;
+}, R = "__voltroWorkflowSchedule", z = (e) => {
+	if (typeof e != "object" || !e) return;
+	let t = e[R];
+	return t === void 0 ? void 0 : t;
+}, B = (e) => {
+	let t = /* @__PURE__ */ new Map();
+	for (let n of e) t.set(n.stepName, (t.get(n.stepName) ?? 0) + 1);
+	let n = /* @__PURE__ */ new Map(), r = /* @__PURE__ */ new Set(), i = (e) => r.has(e) ? !1 : (r.add(e), !0);
+	return {
+		reach: (e) => {
+			let r = (n.get(e) ?? 0) + 1;
+			n.set(e, r);
+			let a = t.get(e) ?? 0;
+			if (a !== 0 && !(r <= a) && i(`extra:${e}`)) return {
+				kind: "extra-step-occurrence",
+				stepName: e,
+				recorded: a,
+				reached: r,
+				detail: `step '${e}' was reached ${r} time(s) on this attempt but this run only ever recorded ${a} — the body may have changed how often it runs this step (a loop bound), so the journal replays a result for an iteration the code no longer means.`
+			};
+		},
+		settle: () => {
+			let e = [];
+			for (let [r, a] of t) (n.get(r) ?? 0) > 0 || i(`unreached:${r}`) && e.push({
+				kind: "unreached-step",
+				stepName: r,
+				recorded: a,
+				reached: 0,
+				detail: `step '${r}' ran on an earlier attempt of this run but the current code never reaches it — the step was renamed, removed, or moved behind a branch, so its journaled result is orphaned and any step that replaced it executed fresh.`
+			});
+			return e;
+		}
+	};
+}, V = g.unsafeMake(void 0), H = (e) => ({
+	kind: e.kind,
+	stepName: e.stepName,
+	recorded: e.recorded,
+	reached: e.reached,
+	detail: e.detail
+}), U = (e) => m.gen(function* () {
+	if (e.length === 0) return;
+	let t = yield* g.get(O), n = yield* m.serviceOption(D);
+	if (t === void 0 || n._tag !== "Some") return;
+	let r = n.value;
+	for (let n of e) yield* m.promise(() => r.recordEvent({
+		runId: t,
+		eventType: "nondeterminism-suspected",
+		payload: H(n)
+	}).then(() => void 0).catch(() => void 0));
+}), W = (e) => {
 	if (typeof e != "object" || !e) return;
 	let t = e.retryAfterMillis;
-	if (typeof t == "number" && Number.isFinite(t) && t >= 0) return f.millis(t);
+	if (typeof t == "number" && Number.isFinite(t) && t >= 0) return p.millis(t);
 	let n = e.retryAfter;
-	if (typeof n == "number" && Number.isFinite(n) && n >= 0) return f.seconds(n);
-}, I = (e) => f.decode(e), L = (e) => typeof e == "object" && e && "_tag" in e ? String(e._tag) : void 0, R = (e) => e !== void 0 && (e.maxAttempts ?? 3) > 1, z = (e) => {
+	if (typeof n == "number" && Number.isFinite(n) && n >= 0) return p.seconds(n);
+}, G = (e) => p.decode(e), K = (e) => typeof e == "object" && e && "_tag" in e ? String(e._tag) : void 0, q = (e) => e !== void 0 && (e.maxAttempts ?? 3) > 1, J = (e) => {
 	if (e.retryable) return e.retryable;
 	if (e.retryableErrors && e.retryableErrors.length > 0) {
 		let t = new Set(e.retryableErrors);
 		return (e) => {
-			let n = L(e);
+			let n = K(e);
 			return n !== void 0 && t.has(n);
 		};
 	}
 	return () => !0;
-}, B = (e) => {
-	let t = e.baseDelay ?? "200 millis", n = e.strategy ?? "exponential", r = e.maxAttempts ?? 3, i = n === "linear" ? _.linear(I(e.step ?? t)) : n === "fixed" ? _.spaced(I(t)) : _.exponential(I(t), e.factor ?? 2);
+}, oe = (e) => {
+	let t = e.baseDelay ?? "200 millis", n = e.strategy ?? "exponential", r = e.maxAttempts ?? 3, i = n === "linear" ? _.linear(G(e.step ?? t)) : n === "fixed" ? _.spaced(G(t)) : _.exponential(G(t), e.factor ?? 2);
 	if (e.maxDelay !== void 0) {
-		let t = I(e.maxDelay);
-		i = _.modifyDelay(i, (e, n) => f.min(n, t));
+		let t = G(e.maxDelay);
+		i = _.modifyDelay(i, (e, n) => p.min(n, t));
 	}
 	(e.jitter ?? !0) === !0 && (i = _.jittered(i));
 	let a = _.intersect(i, _.recurs(Math.max(0, r - 1)));
-	return e.maxElapsed !== void 0 && (a = _.upTo(I(e.maxElapsed))(a)), a;
-}, V = (e, t) => {
-	let n = f.toMillis(I(e.baseDelay ?? "200 millis")), r = e.strategy ?? "exponential", i = r === "fixed" ? n : r === "linear" ? n + f.toMillis(I(e.step ?? e.baseDelay ?? "200 millis")) * (t - 1) : n * (e.factor ?? 2) ** (t - 1);
-	return e.maxDelay !== void 0 && (i = Math.min(i, f.toMillis(I(e.maxDelay)))), (e.jitter ?? !0) === !0 && (i *= Math.random()), i;
-}, H = (e, t, n, r) => p.gen(function* () {
-	let i = t.maxAttempts ?? 3, a = t.maxElapsed === void 0 ? Infinity : f.toMillis(I(t.maxElapsed)), o = yield* p.sync(() => Date.now()), s = 0;
+	return e.maxElapsed !== void 0 && (a = _.upTo(G(e.maxElapsed))(a)), a;
+}, se = (e, t) => {
+	let n = p.toMillis(G(e.baseDelay ?? "200 millis")), r = e.strategy ?? "exponential", i = r === "fixed" ? n : r === "linear" ? n + p.toMillis(G(e.step ?? e.baseDelay ?? "200 millis")) * (t - 1) : n * (e.factor ?? 2) ** (t - 1);
+	return e.maxDelay !== void 0 && (i = Math.min(i, p.toMillis(G(e.maxDelay)))), (e.jitter ?? !0) === !0 && (i *= Math.random()), i;
+}, ce = (e, t, n, r) => m.gen(function* () {
+	let i = t.maxAttempts ?? 3, a = t.maxElapsed === void 0 ? Infinity : p.toMillis(G(t.maxElapsed)), o = yield* m.sync(() => Date.now()), s = 0;
 	for (;;) {
-		let c = yield* p.exit(e);
-		if (m.isSuccess(c)) return c.value;
-		let l = c.cause, d = u.failureOption(l), h = g.isSome(d) ? d.value : u.squash(l);
+		let c = yield* m.exit(e);
+		if (ee.isSuccess(c)) return c.value;
+		let l = c.cause, d = u.failureOption(l), f = te.isSome(d) ? d.value : u.squash(l);
 		s += 1;
-		let _ = (yield* p.sync(() => Date.now())) - o;
-		if (s >= i || !n(h) || _ >= a) return yield* p.failCause(l);
-		r?.(h);
-		let v = F(h), y = v === void 0 ? V(t, s) : f.toMillis(v);
-		yield* p.sleep(f.millis(y));
+		let h = (yield* m.sync(() => Date.now())) - o;
+		if (s >= i || !n(f) || h >= a) return yield* m.failCause(l);
+		r?.(f);
+		let g = W(f), _ = g === void 0 ? se(t, s) : p.toMillis(g);
+		yield* m.sleep(p.millis(_));
 	}
-}), U = (e, t, n) => {
-	if (!R(t)) return e;
-	let r = z(t);
-	if (t.respectRetryAfter === !0) return H(e, t, r, n);
-	let i = B(t), a = n ? p.tapError(e, (e) => p.sync(() => {
+}), le = (e, t, n) => {
+	if (!q(t)) return e;
+	let r = J(t);
+	if (t.respectRetryAfter === !0) return ce(e, t, r, n);
+	let i = oe(t), a = n ? m.tapError(e, (e) => m.sync(() => {
 		r(e) && n(e);
 	})) : e;
-	return p.retry(a, {
+	return m.retry(a, {
 		schedule: i,
 		while: r
 	});
-}, W = Symbol.for("voltro.workflow.workerLayer"), G = Symbol.for("voltro.workflow.version"), K = "__voltroWorkflowMessages", q = "__voltroWorkflowFlowControl", J = (e) => typeof e == "object" && !!e && e[W] === !0, Y = (e) => typeof e == "object" && e && e[G] !== void 0 ? e[G] : {
+}, Y = Symbol.for("voltro.workflow.workerLayer"), X = Symbol.for("voltro.workflow.version"), Z = "__voltroWorkflowMessages", Q = "__voltroWorkflowFlowControl", ue = (e) => typeof e == "object" && !!e && e[Y] === !0, de = (e) => typeof e == "object" && e && e[X] !== void 0 ? e[X] : {
 	version: "1",
 	compatibleWith: ["1"],
 	patches: []
-}, X = ((e) => {
+}, fe = ((e) => {
 	let t = c.make(e), n = e.suspendOnFailure === !0 ? t.annotate(c.SuspendOnFailure, !0) : t, r = String(e.version ?? "1"), i = {
 		version: r,
 		compatibleWith: (e.compatibleWith ?? [r]).map(String),
 		patches: [...e.patches ?? []]
 	}, a = {
 		signals: { ...e.messages?.signals ?? {} },
-		updates: { ...e.messages?.updates ?? {} },
-		queries: { ...e.messages?.queries ?? {} }
+		updates: { ...e.messages?.updates ?? {} }
 	};
-	Object.defineProperty(n, G, {
+	Object.defineProperty(n, X, {
 		value: i,
 		enumerable: !1
-	}), Object.defineProperty(n, K, {
+	}), Object.defineProperty(n, Z, {
 		value: a,
 		enumerable: !1
 	});
-	let o = D({
+	let o = T({
 		workflowName: e.name,
 		payloadSchema: e.payload,
 		control: e
 	});
-	return o !== void 0 && Object.defineProperty(n, q, {
+	o !== void 0 && Object.defineProperty(n, Q, {
 		value: o,
 		enumerable: !1
+	});
+	let s = I(e.name, e.schedule);
+	return s !== void 0 && Object.defineProperty(n, R, {
+		value: s,
+		enumerable: !1
 	}), n;
-}), Z = (e) => {
+}), pe = (e) => {
 	if (typeof e != "object" || !e) return;
-	let t = e[q];
+	let t = e[Q];
 	return t === void 0 ? void 0 : t;
-}, Q = i.make, te = i.process, ne = ((...e) => {
+}, me = i.make, he = i.process, ge = ((...e) => {
 	let t = i.worker(...e);
-	return Object.defineProperty(t, W, {
+	return Object.defineProperty(t, Y, {
 		value: !0,
 		enumerable: !1
 	}), t;
-}), re = o.rateLimit, $ = (e) => p.gen(function* () {
-	let t = yield* k, r = yield* p.serviceOption(O), i = f.toMillis(f.decode(e.duration));
+}), _e = o.rateLimit, $ = (e) => m.gen(function* () {
+	let t = yield* O, r = yield* m.serviceOption(D), i = p.toMillis(p.decode(e.duration));
 	if (t !== void 0 && r._tag === "Some") {
-		let a = r.value, o = new Date(Date.now() + i).toISOString(), s = yield* j;
-		yield* p.promise(() => a.recordEvent({
+		let a = r.value, o = new Date(Date.now() + i).toISOString(), s = yield* A;
+		yield* m.promise(() => a.recordEvent({
 			runId: t,
 			eventType: "timer-set",
 			payload: {
@@ -244,7 +332,7 @@ var y = (e) => e !== void 0 && (e.debounce !== void 0 || e.singleton !== void 0
 			}
 		}).catch(() => {}));
 		let c = Date.now();
-		yield* n.sleep(e), yield* p.promise(() => a.recordEvent({
+		yield* n.sleep(e), yield* m.promise(() => a.recordEvent({
 			runId: t,
 			eventType: "timer-fired",
 			payload: {
@@ -256,18 +344,18 @@ var y = (e) => e !== void 0 && (e.debounce !== void 0 || e.singleton !== void 0
 		return;
 	}
 	yield* n.sleep(e);
-}), ie = (t) => p.gen(function* () {
+}), ve = (t) => m.gen(function* () {
 	let n = (yield* e.make({
 		name: `sleepUntil:${t.name}`,
-		success: v.Number,
-		execute: p.sync(() => t.until instanceof Date ? t.until.getTime() : t.until)
+		success: ne.Number,
+		execute: m.sync(() => t.until instanceof Date ? t.until.getTime() : t.until)
 	})) - Date.now();
 	n <= 0 || (yield* $({
 		name: t.name,
 		duration: `${n} millis`
 	}));
-}), ae = (t, n, r, i) => p.gen(function* () {
-	let a = yield* k, o = yield* e.CurrentAttempt, s = yield* p.serviceOption(O), c = yield* p.serviceOption(P), l = c._tag === "Some" ? c.value.interceptor(n, {
+}), ye = (t, n, r, i) => m.gen(function* () {
+	let a = yield* O, o = yield* e.CurrentAttempt, s = yield* m.serviceOption(D), c = yield* m.serviceOption(P), l = c._tag === "Some" ? c.value.interceptor(n, {
 		runId: a ?? "unrecorded",
 		stepName: t,
 		attempt: o
@@ -276,7 +364,7 @@ var y = (e) => e !== void 0 && (e.debounce !== void 0 || e.singleton !== void 0
 		f = s.value;
 		let e = i === void 0 ? void 0 : (({ retryable: e, ...t }) => t)(i);
 		try {
-			d = yield* p.promise(() => f.startStep({
+			d = yield* m.promise(() => f.startStep({
 				runId: a,
 				stepName: t,
 				attempt: o,
@@ -287,16 +375,16 @@ var y = (e) => e !== void 0 && (e.debounce !== void 0 || e.singleton !== void 0
 			d = void 0;
 		}
 	}
-	let m = Date.now();
-	return yield* U(l, i).pipe(p.tap((e) => d && f ? p.promise(async () => {
+	let p = Date.now();
+	return yield* le(l, i).pipe(m.tap((e) => d && f ? m.promise(async () => {
 		try {
 			await f.endStepSuccess({
 				stepRecordId: d,
 				output: e,
-				durationMs: Date.now() - m
+				durationMs: Date.now() - p
 			});
 		} catch {}
-	}) : p.void), p.tapErrorCause((e) => d && f && !u.isInterruptedOnly(e) ? p.promise(async () => {
+	}) : m.void), m.tapErrorCause((e) => d && f && !u.isInterruptedOnly(e) ? m.promise(async () => {
 		try {
 			let t = u.failureOption(e), n = Array.from(u.failures(e)), r = Array.from(u.defects(e)), i = t._tag === "Some" ? t.value : r[0] ?? u.squash(e), a = i?.message ?? String(i), o = i && typeof i == "object" && "_tag" in i ? String(i._tag) : null;
 			await f.endStepFailure({
@@ -308,16 +396,27 @@ var y = (e) => e !== void 0 && (e.debounce !== void 0 || e.singleton !== void 0
 					failures: n,
 					defects: r
 				},
-				durationMs: Date.now() - m
+				durationMs: Date.now() - p
 			});
 		} catch {}
-	}) : p.void));
-}), oe = (t) => {
+	}) : m.void));
+}), be = (e) => m.gen(function* () {
+	let t = yield* g.get(V);
+	if (t === void 0) return;
+	let n = t.reach(e);
+	n !== void 0 && (yield* U([n]));
+}), xe = (e, t) => {
+	let n = e;
+	return {
+		...e,
+		commit: () => m.zipRight(be(t), n)
+	};
+}, Se = (t) => {
 	let { input: n, retry: r, ...i } = t;
-	return e.make({
+	return xe(e.make({
 		...i,
-		execute: ae(i.name, i.execute, n, r)
-	});
-}, se = c.withCompensation, ce = e.idempotencyKey;
+		execute: ye(i.name, i.execute, n, r)
+	}), i.name);
+}, Ce = (e) => m.map(g.get(j), (t) => t.includes(e)), we = c.withCompensation, Te = e.idempotencyKey;
 //#endregion
-export { x as A, A as C, P as D, O as E, D as F, S as M, b as N, N as O, y as P, l as S, j as T, oe as _, r as a, se as b, s as c, J as d, te as f, ie as g, $ as h, W as i, ee as j, M as k, Z as l, re as m, K as n, Q as o, ne as p, G as r, a as s, q as t, Y as u, ce as v, k as w, X as x, t as y };
+export { z as A, y as B, l as C, U as D, H as E, A as F, T as G, b as H, D as I, P as L, k as M, j as N, F as O, O as P, N as R, fe as S, B as T, v as U, E as V, re as W, ve as _, r as a, t as b, s as c, ue as d, Ce as f, $ as g, _e as h, Y as i, I as j, R as k, pe as l, ge as m, Z as n, me as o, he as p, X as r, a as s, Q as t, de as u, Se as v, V as w, we as x, Te as y, M as z };