eve 0.63.0 → 0.64.1

package/dist/src/compiled/@workflow/core/events-consumer.d.ts

@@ -32,9 +32,12 @@ export declare enum EventConsumerResult {
 type EventConsumerCallback = (event: Event | null) => EventConsumerResult;
 export interface EventsConsumerOptions {
     /**
-     * Callback invoked after an event has been consumed. Consumers such as the
-     * deterministic workflow clock must not observe events that are merely
-     * inspected while waiting for user code to subscribe to the next operation.
+     * Observation callback invoked after an event has been consumed (not for one
+     * the walk merely inspected, parked, or skipped). Diagnostics and tests read
+     * it. Do NOT anchor the workflow's deterministic clock here: consumption runs
+     * ahead of delivery, so a later event's time would leak into an earlier
+     * delivery's cascade; the clock advances from `registerDeliveryBarrier`
+     * when a delivery is handed to the workflow.
      */
     onConsumedEvent?: (event: Event) => void;
     /**

package/dist/src/compiled/@workflow/core/index.js

@@ -1,2 +1,2 @@
-import"../../_chunks/workflow/dist-D38gP7YF.js";import{An as e,Kn as t,Vn as n}from"../../_chunks/workflow/logger-NN5YHpYy.js";import{i as r,u as i}from"../../_chunks/workflow/dist-xTushGCp.js";import{G as a,W as o,b as s,ct as c,i as l,it as u,lt as d,nt as f,rt as p,st as m,tt as h,ut as g,w as _}from"../../_chunks/workflow/serialization-C5KgPESk.js";import{a as v,i as y,r as b,t as x}from"../../_chunks/workflow/attribute-changes-A6HfMNG3.js";import{n as S}from"../../_chunks/workflow/resume-hook-CAqlhwic.js";import{t as C}from"../../_chunks/workflow/sleep-CbUwdv6O.js";function w(e){y(`createHook()`,`https://workflow-sdk.dev/docs/api-reference/workflow/create-hook`,w)}function T(e){y(`createWebhook()`,`https://workflow-sdk.dev/docs/api-reference/workflow/create-webhook`,T)}function E({schema:e}={}){function t(e){y(`defineHook().create()`,`https://workflow-sdk.dev/docs/api-reference/workflow/define-hook`,t)}return{create:t,async resume(t,n){if(!e?.[`~standard`])return await S(t,n);let r=e[`~standard`].validate(n);if(r instanceof Promise&&(r=await r),r.issues){let e=r.issues.map(e=>{let t=e.path?.map(e=>String(typeof e==`object`&&e?e.key:e)).join(`.`);return t?`  at "${t}": ${e.message}`:`  ${e.message}`});throw Error(`Hook payload did not match the defined schema:\n${e.join(`
-`)}`)}return await S(t,r.value)}}}async function D(e,n={}){let i=a.getStore(),o=i?.workflowMetadata?.workflowRunId;if(!o)throw new r(`setAttributes() must be called from a 'use workflow' or 'use step' function. Calling it from plain host code is not supported.`);let s=x(e,n);if(s.length!==0){if(i.runReadyBarrier)try{await i.runReadyBarrier}catch{}await(await t()).events.create(o,{eventType:`attr_set`,specVersion:7,eventData:{changes:s,writer:{type:`step`,stepId:i.stepMetadata.stepId,attempt:i.stepMetadata.attempt},...n.allowReservedAttributes===!0?{allowReservedAttributes:!0}:{}}})}}function O(){let e=a.getStore();return e||b(`getStepMetadata()`,`https://workflow-sdk.dev/docs/api-reference/workflow/get-step-metadata`,O),e.stepMetadata}function k(){let e=a.getStore();return e||v(`getWorkflowMetadata()`,`https://workflow-sdk.dev/docs/api-reference/workflow/get-workflow-metadata`,k),e.workflowMetadata}function A(t={}){let r=a.getStore();r||v(`getWritable()`,`https://workflow-sdk.dev/docs/api-reference/workflow/get-writable`,A);let{namespace:i}=t,y=r.workflowMetadata.workflowRunId,b=o(y,i);r.writables??=new Map;let x=r.writables,S=x.get(b);if(S)return S.writable;let C=h();C.deferReleaseSettlement=r.streamStates!==void 0;let w=_(s(globalThis,r.ops,y,r.encryptionKey,!0,r.runReadyBarrier),r.encryptionKey),T=new l(y,b,r.runReadyBarrier);r.streamStates??=[],r.streamStates.push(C),r.ops.push(C.promise),f(w.readable,T,C).catch(()=>{});let E=u(w.writable,C);return p(E,C),Object.defineProperty(E,m,{value:b,writable:!1}),Object.defineProperty(E,g,{value:y,writable:!1}),r.workflowDeploymentId&&Object.defineProperty(E,c,{value:r.workflowDeploymentId,writable:!1}),e(r.encryptionKey)&&Object.defineProperty(E,d,{value:n(r.encryptionKey.keyPair.publicKey),writable:!1}),x.set(b,{writable:E,state:C}),E}export{r as FatalError,i as RetryableError,w as createHook,T as createWebhook,E as defineHook,O as getStepMetadata,k as getWorkflowMetadata,A as getWritable,D as setAttributes,C as sleep};
+import"../../_chunks/workflow/dist-DjECvUyK.js";import{An as e,Kn as t,Vn as n}from"../../_chunks/workflow/logger-DFNCa8Nl.js";import{i as r,u as i}from"../../_chunks/workflow/dist-xTushGCp.js";import{G as a,W as o,b as s,ct as c,i as l,it as u,lt as d,nt as f,rt as p,st as m,tt as h,ut as g,w as _}from"../../_chunks/workflow/serialization-Cl0SYU0I.js";import{a as v,i as y,r as b,t as x}from"../../_chunks/workflow/attribute-changes-DFx4eluc.js";import{n as S}from"../../_chunks/workflow/resume-hook-BhA_nDEV.js";import{t as C}from"../../_chunks/workflow/sleep-DB4AH9-A.js";function w(e){y(`createHook()`,`https://workflow-sdk.dev/docs/api-reference/workflow/create-hook`,w)}function T(e){y(`createWebhook()`,`https://workflow-sdk.dev/docs/api-reference/workflow/create-webhook`,T)}function E({schema:e}={}){function t(e){y(`defineHook().create()`,`https://workflow-sdk.dev/docs/api-reference/workflow/define-hook`,t)}return{create:t,async resume(t,n){if(!e?.[`~standard`])return await S(t,n);let r=e[`~standard`].validate(n);if(r instanceof Promise&&(r=await r),r.issues){let e=r.issues.map(e=>{let t=e.path?.map(e=>String(typeof e==`object`&&e?e.key:e)).join(`.`);return t?`  at "${t}": ${e.message}`:`  ${e.message}`});throw Error(`Hook payload did not match the defined schema:\n${e.join(`
+`)}`)}return await S(t,r.value)}}}async function D(e,n={}){let i=a.getStore(),o=i?.workflowMetadata?.workflowRunId;if(!o)throw new r(`setAttributes() must be called from a 'use workflow' or 'use step' function. Calling it from plain host code is not supported.`);let s={type:`step`,stepId:i.stepMetadata.stepId,attempt:i.stepMetadata.attempt},c=x(e,n,s);if(c.length!==0){if(i.runReadyBarrier)try{await i.runReadyBarrier}catch{}await(await t()).events.create(o,{eventType:`attr_set`,specVersion:7,eventData:{changes:c,writer:s,...n.allowReservedAttributes===!0?{allowReservedAttributes:!0}:{}}})}}function O(){let e=a.getStore();return e||b(`getStepMetadata()`,`https://workflow-sdk.dev/docs/api-reference/workflow/get-step-metadata`,O),e.stepMetadata}function k(){let e=a.getStore();return e||v(`getWorkflowMetadata()`,`https://workflow-sdk.dev/docs/api-reference/workflow/get-workflow-metadata`,k),e.workflowMetadata}function A(t={}){let r=a.getStore();r||v(`getWritable()`,`https://workflow-sdk.dev/docs/api-reference/workflow/get-writable`,A);let{namespace:i}=t,y=r.workflowMetadata.workflowRunId,b=o(y,i);r.writables??=new Map;let x=r.writables,S=x.get(b);if(S)return S.writable;let C=h();C.deferReleaseSettlement=r.streamStates!==void 0;let w=_(s(globalThis,r.ops,y,r.encryptionKey,!0,r.runReadyBarrier),r.encryptionKey),T=new l(y,b,r.runReadyBarrier);r.streamStates??=[],r.streamStates.push(C),r.ops.push(C.promise),f(w.readable,T,C).catch(()=>{});let E=u(w.writable,C);return p(E,C),Object.defineProperty(E,m,{value:b,writable:!1}),Object.defineProperty(E,g,{value:y,writable:!1}),r.workflowDeploymentId&&Object.defineProperty(E,c,{value:r.workflowDeploymentId,writable:!1}),e(r.encryptionKey)&&Object.defineProperty(E,d,{value:n(r.encryptionKey.keyPair.publicKey),writable:!1}),x.set(b,{writable:E,state:C}),E}export{r as FatalError,i as RetryableError,w as createHook,T as createWebhook,E as defineHook,O as getStepMetadata,k as getWorkflowMetadata,A as getWritable,D as setAttributes,C as sleep};

package/dist/src/compiled/@workflow/core/private.d.ts

@@ -79,10 +79,10 @@ export interface WorkflowOrchestratorContext {
     /**
      * Ordered registry of in-flight "branch-deciding" deliveries: the
      * resolutions a workflow typically `Promise.race`s on, or awaits from
-     * independent concurrent branches: hook payloads (`hook_received`), wait
-     * completions (`wait_completed`), and step results (`step_completed` /
-     * `step_failed`). Keyed by the delivery's position (index) in the consumed
-     * event log.
+     * independent concurrent branches: hook payloads (`hook_received`), hook
+     * registration outcomes (`hook_created` / `hook_conflict`), wait completions
+     * (`wait_completed`), and step results (`step_completed` / `step_failed`).
+     * Keyed by the delivery's position (index) in the consumed event log.
      *
      * The problem: each of these resolutions reaches workflow code after a
      * different, workload-dependent number of microtask hops. A buffered hook
@@ -114,6 +114,29 @@ export interface WorkflowOrchestratorContext {
      * that do not initialize it degrade gracefully to the previous behavior.
      */
     pendingDeliveryBarriers?: Map<number, DeliveryBarrierEntry>;
+    /**
+     * Advance the workflow's deterministic clock (`Date.now()` inside the VM)
+     * to `at`, never backwards. Called by {@link registerDeliveryBarrier} when a
+     * branch-deciding delivery is handed to the workflow, so the clock a
+     * cascade observes is the timestamp of the delivery that woke it.
+     *
+     * The clock is NOT advanced when an event is merely consumed. The
+     * `EventsConsumer` walks ahead of delivery: within one drain window it
+     * consumes every event whose consumer exists, so a `hook_received` for a
+     * hook the workflow has not read, or a `wait_completed` the body is still
+     * hops away from observing, is consumed while an earlier delivery is
+     * still parked on its barrier. Advancing the clock at consumption let those
+     * later timestamps leak into the earlier delivery's cascade, and the value
+     * `Date.now()` returned at a body position then depended on how much log
+     * the replay had loaded: the execution that wrote the log saw the
+     * heartbeat's time, a later replay holding one more payload saw the
+     * payload's. A workflow whose control flow reads the clock (an idle loop
+     * budgeted by `Date.now()`, a deadline) then drew different ordinals in
+     * different replays and died `CORRUPTED_EVENT_LOG`.
+     *
+     * Optional so older/out-of-tree contexts degrade gracefully.
+     */
+    advanceClock?: (at: number) => void;
     /**
      * Invocation-scoped cache of prepared serialized payloads and immutable final
      * values. Prepared bytes survive fresh replay VMs; object graphs do not.
@@ -189,8 +212,17 @@ export interface DeliveryBarrier {
  * unconditional chain would livelock every idle check in the run, including
  * its own retirement.
  */
-export declare function registerDeliveryBarrier(ctx: WorkflowOrchestratorContext, eventIndex: number | undefined, kind: DeliveryKind, options?: {
+export declare function registerDeliveryBarrier(ctx: WorkflowOrchestratorContext, eventIndex: number | undefined, kind: DeliveryKind, options: {
     armed?: boolean;
+    /**
+     * The delivered event's `createdAt`. On `markDelivered` the workflow
+     * clock advances to it (see {@link WorkflowOrchestratorContext.advanceClock}),
+     * so `Date.now()` in the cascade this delivery wakes reads the delivery's
+     * own time, whatever the consumer walk has read ahead of it. Required so
+     * that a new delivery site cannot forget the clock: a delivery that does
+     * not move it leaves the cascade it wakes reading a stale time.
+     */
+    deliveredAt: number;
 }): DeliveryBarrier;
 /**
  * Whether some registered branch-deciding delivery is going to reach the

package/dist/src/compiled/@workflow/core/private.js

@@ -1 +1 @@
-import{k as e}from"../../_chunks/workflow/dist-xTushGCp.js";import{i as t,n}from"../../_chunks/workflow/global-DFW-hO6M.js";const r=Symbol.for(`@workflow/core//registeredSteps`),i=globalThis,a=i[r]??=new Map,o=new Set([`__builtin_response_array_buffer`,`__builtin_response_json`,`__builtin_response_text`]);function s(e){let t=e.split(`//`);if(t.length!==3||t[0]!==`step`)return[];let n=t[1],r=t[2],i=new Set,a=e=>{e!==n&&i.add(e)};if(n.startsWith(`./workflows/`)){let e=n.slice(2);a(`./example/${e}`),a(`./src/${e}`)}else if(n.startsWith(`./example/workflows/`)){let e=n.slice(10);a(`./${e}`),a(`./src/${e}`)}else if(n.startsWith(`./src/workflows/`)){let e=n.slice(6);a(`./${e}`),a(`./example/${e}`)}return Array.from(i,e=>`step//${e}//${r}`)}function c(e){if(o.has(e)){for(let[t,n]of a.entries())if(t.endsWith(`//${e}`))return n}}function l(e,t){a.set(e,t),t.stepId=e}function u(e){let t=a.get(e);if(t)return t;for(let t of s(e)){let e=a.get(t);if(e)return e}let n=c(e);if(n)return n}const d={hook:[`hook`,`wait`,`step`],wait:[`hook`,`step`],step:[`wait`,`hook`,`step`]};function f(e,t,n,r){return n>=t||!d[e].includes(r.kind)?!1:!(e===`step`&&!r.armed)}function p(e,t,n,r){let i=r.get(t);if(i!==void 0)return i;let a=m(e,t,n,r);return r.set(t,a),a}function m(e,t,n,r){if(!n.armed)return!1;for(let[i,a]of e)if(f(n.kind,t,i,a)&&!p(e,i,a,r))return!1;return!0}function h(){return process.env.WORKFLOW_LOG_ORDER_DRAWS!==`0`}function g(e){return e===0&&typeof setImmediate==`function`?new Promise(e=>setImmediate(e)):new Promise(t=>setTimeout(t,e))}async function _(e,t){for(;;){let n=e.mintCount??0,r=e.pendingDeliveries;if(await g(await e.promiseQueue.then(()=>!1,()=>!0)?50:0),(e.mintCount??0)!==n||r!==0||e.pendingDeliveries!==0)continue;let i=!1;for(let[n,r]of e.pendingDeliveryBarriers??[])if(n<t&&r.armed){i=!0;break}if(!i)return}}async function v(e,t,n){if(t===void 0||!e.pendingDeliveryBarriers)return;let r=e.pendingDeliveryBarriers,i=[];for(let[e,a]of r)f(n,t,e,a)&&i.push(a.released);if(i.length>0&&await Promise.all(i),h()){await _(e,t);return}i.length>0&&await new Promise(e=>setTimeout(e,0))}function y(n,r,i,a={}){let o=n.pendingDeliveryBarriers;if(!o||r===void 0)return{markDelivered:()=>{},arm:()=>{}};let s=a=>{if(o.has(r))throw new e(`Delivery barrier already registered at event index ${r}`);let{promise:s,resolve:c}=t(),l={kind:i,released:s,armed:a,retired:!1,retire:()=>{l.retired||(l.retired=!0,o.get(r)===l&&o.delete(r),c())}};return o.set(r,l),x(n),l},c=s(a.armed??!0),l=!1;return{markDelivered:()=>{l||(l=!0,c.retire())},arm:()=>{if(!l){if(c.retired){c=s(!0);return}if(o.get(r)!==c)throw new e(`Delivery barrier lost ownership of event index ${r}`);c.armed=!0}}}}const b=new WeakSet;function x(e){let t=e.pendingDeliveryBarriers;if(!t||b.has(e))return;b.add(e);let n=()=>{setTimeout(i,0)},r=()=>{setTimeout(i,50)},i=()=>{if(t.size===0){b.delete(e);return}if(!S(e)){e.promiseQueue.then(n,r);return}for(;t.size>0&&S(e);){let e,n;for(let[r,i]of t)(e===void 0||r<e)&&(e=r,n=i);n?.retire()}setTimeout(i,0)};setTimeout(i,0)}function S(e){return e.pendingDeliveries===0&&!C(e)}function C(e){let t=e.pendingDeliveryBarriers;if(!t||t.size===0)return!1;let n=new Map;for(let[e,r]of t)if(p(t,e,r,n))return!0;return!1}function w(e){return e.pendingDeliveries===0&&(!e.pendingDeliveryBarriers||e.pendingDeliveryBarriers.size===0)}function T(e,t){let n=()=>{w(e)?t():e.promiseQueue.then(()=>{setTimeout(n,0)})};setTimeout(n,0)}function E(e){let t=e.suspensionGeneration;T(e,()=>{t===e.suspensionGeneration&&e.onWorkflowError(new n(e.invocationsQueue,e.globalThis))})}export{v as awaitEarlierDeliveries,u as getStepFunction,C as hasParkedCommittedDelivery,w as isDeliveryIdle,y as registerDeliveryBarrier,l as registerStepFunction,T as scheduleWhenIdle,E as scheduleWorkflowSuspension};
+import{k as e}from"../../_chunks/workflow/dist-xTushGCp.js";import{i as t,n}from"../../_chunks/workflow/global-DFW-hO6M.js";const r=Symbol.for(`@workflow/core//registeredSteps`),i=globalThis,a=i[r]??=new Map,o=new Set([`__builtin_response_array_buffer`,`__builtin_response_json`,`__builtin_response_text`]);function s(e){let t=e.split(`//`);if(t.length!==3||t[0]!==`step`)return[];let n=t[1],r=t[2],i=new Set,a=e=>{e!==n&&i.add(e)};if(n.startsWith(`./workflows/`)){let e=n.slice(2);a(`./example/${e}`),a(`./src/${e}`)}else if(n.startsWith(`./example/workflows/`)){let e=n.slice(10);a(`./${e}`),a(`./src/${e}`)}else if(n.startsWith(`./src/workflows/`)){let e=n.slice(6);a(`./${e}`),a(`./example/${e}`)}return Array.from(i,e=>`step//${e}//${r}`)}function c(e){if(o.has(e)){for(let[t,n]of a.entries())if(t.endsWith(`//${e}`))return n}}function l(e,t){a.set(e,t),t.stepId=e}function u(e){let t=a.get(e);if(t)return t;for(let t of s(e)){let e=a.get(t);if(e)return e}let n=c(e);if(n)return n}const d={hook:[`hook`,`wait`,`step`],wait:[`hook`,`step`],step:[`wait`,`hook`,`step`]};function f(e,t,n,r){return n>=t||!d[e].includes(r.kind)?!1:!(e===`step`&&!r.armed)}function p(e,t,n,r){let i=r.get(t);if(i!==void 0)return i;let a=m(e,t,n,r);return r.set(t,a),a}function m(e,t,n,r){if(!n.armed)return!1;for(let[i,a]of e)if(f(n.kind,t,i,a)&&!p(e,i,a,r))return!1;return!0}function h(){return process.env.WORKFLOW_LOG_ORDER_DRAWS!==`0`}function g(e){return e===0&&typeof setImmediate==`function`?new Promise(e=>setImmediate(e)):new Promise(t=>setTimeout(t,e))}async function _(e,t){for(;;){let n=e.mintCount??0,r=e.pendingDeliveries;if(await g(await e.promiseQueue.then(()=>!1,()=>!0)?50:0),(e.mintCount??0)!==n||r!==0||e.pendingDeliveries!==0)continue;let i=!1;for(let[n,r]of e.pendingDeliveryBarriers??[])if(n<t&&r.armed){i=!0;break}if(!i)return}}async function v(e,t,n){if(t===void 0||!e.pendingDeliveryBarriers)return;let r=e.pendingDeliveryBarriers,i=[];for(let[e,a]of r)f(n,t,e,a)&&i.push(a.released);if(i.length>0&&await Promise.all(i),h()){await _(e,t);return}i.length>0&&await new Promise(e=>setTimeout(e,0))}function y(n,r,i,a){let o=!1,s=()=>!o&&(o=!0,n.advanceClock?.(a.deliveredAt),!0),c=n.pendingDeliveryBarriers;if(!c||r===void 0)return{markDelivered:()=>{s()},arm:()=>{}};let l=a=>{if(c.has(r))throw new e(`Delivery barrier already registered at event index ${r}`);let{promise:o,resolve:s}=t(),l={kind:i,released:o,armed:a,retired:!1,retire:()=>{l.retired||(l.retired=!0,c.get(r)===l&&c.delete(r),s())}};return c.set(r,l),x(n),l},u=l(a.armed??!0);return{markDelivered:()=>{s()&&u.retire()},arm:()=>{if(!o){if(u.retired){u=l(!0);return}if(c.get(r)!==u)throw new e(`Delivery barrier lost ownership of event index ${r}`);u.armed=!0}}}}const b=new WeakSet;function x(e){let t=e.pendingDeliveryBarriers;if(!t||b.has(e))return;b.add(e);let n=()=>{setTimeout(i,0)},r=()=>{setTimeout(i,50)},i=()=>{if(t.size===0){b.delete(e);return}if(!S(e)){e.promiseQueue.then(n,r);return}for(;t.size>0&&S(e);){let e,n;for(let[r,i]of t)(e===void 0||r<e)&&(e=r,n=i);n?.retire()}setTimeout(i,0)};setTimeout(i,0)}function S(e){return e.pendingDeliveries===0&&!C(e)}function C(e){let t=e.pendingDeliveryBarriers;if(!t||t.size===0)return!1;let n=new Map;for(let[e,r]of t)if(p(t,e,r,n))return!0;return!1}function w(e){return e.pendingDeliveries===0&&(!e.pendingDeliveryBarriers||e.pendingDeliveryBarriers.size===0)}function T(e,t){let n=()=>{w(e)?t():e.promiseQueue.then(()=>{setTimeout(n,0)})};setTimeout(n,0)}function E(e){let t=e.suspensionGeneration;T(e,()=>{t===e.suspensionGeneration&&e.onWorkflowError(new n(e.invocationsQueue,e.globalThis))})}export{v as awaitEarlierDeliveries,u as getStepFunction,C as hasParkedCommittedDelivery,w as isDeliveryIdle,y as registerDeliveryBarrier,l as registerStepFunction,T as scheduleWhenIdle,E as scheduleWorkflowSuspension};

package/dist/src/compiled/@workflow/core/runtime/deployment-guard.d.ts

@@ -70,9 +70,10 @@ export interface ReenqueueArgs {
  * holds only deployment ids, nothing sensitive), and the plaintext `errorCode`
  * is the signal observability and the UI key off.
  */
-export declare function guardDeploymentAffinity({ world, run, requestId, retryCount, reenqueue, isDeploymentUnavailableError, beforeStop, }: {
+export declare function guardDeploymentAffinity({ world, run, workflowName, requestId, retryCount, reenqueue, isDeploymentUnavailableError, beforeStop, }: {
     world: World;
     run: Pick<WorkflowRun, 'runId' | 'deploymentId' | 'specVersion'>;
+    workflowName: string;
     requestId?: string;
     /** `deploymentMismatchRetryCount` from the incoming message, if any. */
     retryCount?: number;

package/dist/src/compiled/@workflow/core/runtime/helpers.js

@@ -1 +1 @@
-import{C as e,E as t,S as n,T as r,_ as i,a,b as o,c as s,d as c,f as l,g as u,h as d,i as f,l as p,m,n as h,o as g,p as _,r as v,s as y,t as b,u as x,v as S,w as C,x as w,y as T}from"../../../_chunks/workflow/helpers-6kObVbfS.js";export{b as SLOT_GAP_RECHECK_ATTEMPTS,h as absorbSkippedSlotReport,v as appendEventLog,f as appendUniqueEvents,a as findEventSlotGap,g as getQueueOverhead,y as getWorkflowQueueName,s as handleHealthCheckMessage,p as healthCheck,x as insertEventByEventId,c as isSlotGapCheckEnabled,l as loadWorkflowRunEvents,_ as maxEventSlot,m as memoizeEncryptionKey,d as mergeReportedEvents,u as parseHealthCheckPayload,i as preconditionEventDelta,S as queueMessage,T as queueMessages,o as resolveRunEncryptionKey,w as rootRunIdFrom,n as runDispatchContext,e as settleEventSlotGap,C as slotSnapshotParams,r as stepDispatchIdempotencyKey,t as withHealthCheck};
+import{C as e,E as t,S as n,T as r,_ as i,a,b as o,c as s,d as c,f as l,g as u,h as d,i as f,l as p,m,n as h,o as g,p as _,r as v,s as y,t as b,u as x,v as S,w as C,x as w,y as T}from"../../../_chunks/workflow/helpers-Bw52uyzw.js";export{b as SLOT_GAP_RECHECK_ATTEMPTS,h as absorbSkippedSlotReport,v as appendEventLog,f as appendUniqueEvents,a as findEventSlotGap,g as getQueueOverhead,y as getWorkflowQueueName,s as handleHealthCheckMessage,p as healthCheck,x as insertEventByEventId,c as isSlotGapCheckEnabled,l as loadWorkflowRunEvents,_ as maxEventSlot,m as memoizeEncryptionKey,d as mergeReportedEvents,u as parseHealthCheckPayload,i as preconditionEventDelta,S as queueMessage,T as queueMessages,o as resolveRunEncryptionKey,w as rootRunIdFrom,n as runDispatchContext,e as settleEventSlotGap,C as slotSnapshotParams,r as stepDispatchIdempotencyKey,t as withHealthCheck};

package/dist/src/compiled/@workflow/core/runtime/invocations.d.ts

@@ -0,0 +1,35 @@
+import { type Queue, type World } from '#compiled/@workflow/world/index.js';
+import { z } from '#compiled/zod/index.js';
+/** Runner protocol, not a hook-specific World operation. */
+export declare const HookInvocationSchema: z.ZodObject<{
+    type: z.ZodLiteral<"hook_resume">;
+    version: z.ZodLiteral<1>;
+    hookId: z.ZodString;
+    token: z.ZodString;
+    payload: z.ZodCustom<Uint8Array<ArrayBuffer>, Uint8Array<ArrayBuffer>>;
+}, z.core.$strip>;
+export declare const HookInvocationResultSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    status: z.ZodLiteral<"accepted">;
+}, z.core.$strip>, z.ZodObject<{
+    status: z.ZodLiteral<"rejected">;
+    code: z.ZodEnum<{
+        HOOK_NOT_FOUND: "HOOK_NOT_FOUND";
+        INVALID_INPUT: "INVALID_INPUT";
+    }>;
+}, z.core.$strip>], "status">;
+type HookInvocationResult = z.infer<typeof HookInvocationResultSchema>;
+/** Validate a hook input and persist its event. World delivers the returned result. */
+export declare function handleInvocation(world: World, runId: string, requestId: string, payload: unknown): Promise<HookInvocationResult>;
+/** Track processed inputs and notify workflow execution when a run has new activity. */
+export declare class RunInputActivity {
+    revision: number;
+    private listeners;
+    notify(): void;
+    waitForActivity(since: number, timeoutMs?: number): Promise<boolean>;
+}
+type Handler = Parameters<Queue['createQueueHandler']>[1];
+type RunHandler = (...args: [...Parameters<Handler>, RunInputActivity?]) => ReturnType<Handler>;
+/** Serialize a run's input processing and share its active execution within this handler. */
+export declare function withRunInputs(world: World): (handler: RunHandler) => Handler;
+export {};
+//# sourceMappingURL=invocations.d.ts.map

package/dist/src/compiled/@workflow/core/runtime/lifecycle-hooks.d.ts

@@ -0,0 +1,90 @@
+import { WorkflowRunFailedError } from '#compiled/@workflow/errors/index.js';
+import type { PayloadKey } from '../serialization/encryption.js';
+import { Run } from './run.js';
+/**
+ * Parameters passed to an {@link WorkflowLifecycleHooks.onRunCompleted}
+ * handler.
+ */
+export interface RunCompletedHookParams {
+    /** The workflow name, available without fetching the run. */
+    workflowName: string;
+    /**
+     * The completed run. The instance hydrates lazily, so reading
+     * `run.returnValue` (or any other accessor) fetches from the backend only
+     * when the handler actually uses it.
+     */
+    run: Run<unknown>;
+}
+/**
+ * Parameters passed to an {@link WorkflowLifecycleHooks.onRunFailed}
+ * handler.
+ */
+export interface RunFailedHookParams {
+    /** The workflow name, available without fetching the run. */
+    workflowName: string;
+    /**
+     * The failed run. The instance hydrates lazily, so accessors fetch from
+     * the backend only when the handler actually uses them.
+     */
+    run: Run<unknown>;
+    /**
+     * The failure, in the same shape `run.returnValue` rejects with: a
+     * `WorkflowRunFailedError` whose `errorCode` carries the failure
+     * classification (e.g. `USER_ERROR`, `RUNTIME_ERROR`) and whose `cause` is
+     * the hydrated persisted value (registered Error subclass identity preserved).
+     * Streams are read only when consumed; abort signals reflect their persisted
+     * state without live subscriptions. If hydration fails, `cause` is a generic
+     * Error, matching `run.returnValue`'s fallback.
+     */
+    error: WorkflowRunFailedError;
+}
+/**
+ * Global handlers observing workflow run lifecycle transitions. Register via
+ * {@link registerLifecycleHooks}.
+ */
+export interface WorkflowLifecycleHooks {
+    /** Invoked when a workflow run completes successfully. */
+    onRunCompleted?: (params: RunCompletedHookParams) => void | Promise<void>;
+    /** Invoked when a workflow run fails terminally (after any retries). */
+    onRunFailed?: (params: RunFailedHookParams) => void | Promise<void>;
+}
+/**
+ * Registers global workflow lifecycle handlers, invoked by the runtime on
+ * the compute that records a run's terminal transition. Useful for
+ * centralized reporting (e.g. forwarding failed runs to Sentry) without
+ * wrapping every workflow body.
+ *
+ * Register early in the process lifecycle so handlers exist before the first
+ * run finishes: in Next.js, `instrumentation.ts` is the natural place; in any
+ * other app, any module that loads at startup works.
+ *
+ * Semantics:
+ * - Handlers run on the host (full Node.js), never inside the workflow VM.
+ * - Handlers fire only on the invocation that actually wrote the terminal
+ *   event. Transitions recorded elsewhere (e.g. a run cancelled from the
+ *   CLI or dashboard) do not fire handlers in the app.
+ * - Handlers are fire-and-forget: they cannot delay or change the run's
+ *   outcome, and a throwing handler is logged and swallowed. On Vercel,
+ *   `waitUntil` keeps the invocation alive. On other hosts handlers run
+ *   detached, and freezing serverless hosts may not let them finish.
+ * - Reporting is best effort: callbacks are not retried if the invocation
+ *   dies before they finish. Use the event log as the system of record.
+ * - Multiple registrations are allowed; handlers run in registration order.
+ *
+ * @returns A function that unregisters these hooks.
+ */
+export declare function registerLifecycleHooks(hooks: WorkflowLifecycleHooks): () => void;
+/**
+ * Called by the runtime after it successfully wrote a `run_completed` event.
+ * Never throws.
+ */
+export declare function dispatchRunCompletedHooks(runId: string, workflowName: string): void;
+/**
+ * Called by the runtime after it successfully wrote a `run_failed` event.
+ * Never throws.
+ *
+ * @param error - The serialized error payload stored by the terminal write.
+ * @param errorCode - The classification written to the event's `errorCode`.
+ */
+export declare function dispatchRunFailedHooks(runId: string, workflowName: string, error: unknown, encryptionKey: PayloadKey | undefined, errorCode: string): void;
+//# sourceMappingURL=lifecycle-hooks.d.ts.map

package/dist/src/compiled/@workflow/core/runtime/quickjs-runtime.d.ts

@@ -30,6 +30,7 @@
  */
 import { SerializationError } from '#compiled/@workflow/errors/index.js';
 import { type Event, type RunInput, type WorkflowRun, type WorldCapabilities } from '#compiled/@workflow/world/index.js';
+import { type AttributeChange } from '#compiled/@workflow/world/index.js';
 import { type Snapshot } from '../_quickjs-wasi.js';
 import type { DecryptionKey } from '../serialization/encryption.js';
 export interface PendingStep {
@@ -99,7 +100,7 @@ export interface PendingAttribute {
     type: 'attribute';
     correlationId: string;
     /** Normalized attribute changes (plain JSON-able objects) */
-    changes: unknown[];
+    changes: AttributeChange[];
     allowReservedAttributes?: boolean;
     /** Whether an attr_set event already exists for this write */
     hasCreatedEvent: boolean;

package/dist/src/compiled/@workflow/core/runtime/resume-hook.d.ts

@@ -80,12 +80,14 @@ export type ResumedHook = Hook & {
  * This function is called externally (e.g., from an API route or server action)
  * to send data to a hook and resume the associated workflow run.
  *
- * Resolving means BOTH that the `hook_received` event is durably recorded in
- * the run's event log and that the workflow wake was accepted by the queue, in
- * that order. A {@link HookNotFoundError} means this invocation committed no
- * event. Any other error after the write is ambiguous only in dispatch, never
- * in durability: the event may already be committed, and a later wake of the
- * run (from any source) will deliver it.
+ * On an invoke-capable World, the serialized input is delivered to the run's
+ * executor, which inspects it, writes `hook_received`, then responds. Resolving
+ * means the executor accepted and persisted it, not that user code consumed it.
+ * Other Worlds write the event here and then await queue acceptance of its wake.
+ * On the existing path, a failure after the event write may leave a committed
+ * event whose wake was not accepted. On the invoke path, a transport failure
+ * leaves the executor's outcome unknown; do not retry by directly writing an
+ * event. Event and response persistence may be separate backend operations.
  *
  * Prefer passing the token string over a cached {@link Hook} object. A token
  * is looked up fresh, so the live backend can attest its atomic resume claim

package/dist/src/compiled/@workflow/core/runtime/step-single-flight.d.ts

@@ -8,5 +8,5 @@ import type { StepExecutionResult } from './step-executor.js';
  * queue message redelivers and drives the retry, so exactly one message
  * keeps owning the outcome.
  */
-export declare function runStepSingleFlight(runId: string, correlationId: string, execute: () => Promise<StepExecutionResult>): Promise<StepExecutionResult>;
+export declare function runStepSingleFlight(runId: string, correlationId: string, execute: () => Promise<StepExecutionResult>, logLevel?: 'debug' | 'warn'): Promise<StepExecutionResult>;
 //# sourceMappingURL=step-single-flight.d.ts.map