@workflow/world-testing 5.0.0-beta.54 → 5.0.0-beta.56

package/dist/.well-known/workflow/v1/__step_registrations.mjs

@@ -412,7 +412,7 @@ function buildFramedDetails(hint2, slug) {
   });
   return out;
 }
-var BASE_URL, ERROR_SLUGS, WorkflowError, WorkflowWorldError, WorkflowRunFailedError, WorkflowRunNotCompletedError, WorkflowRuntimeError, RuntimeDecryptionError, SerializationError, StepNotRegisteredError, WorkflowNotRegisteredError, WorkflowRunNotFoundError, HookConflictError, HookNotFoundError, EntityConflictError, RunExpiredError, StreamError, StreamExpiredError, ThrottleError, WorkflowRunCancelledError, FatalError, RetryableError, FATAL_ERROR_KEY, RETRYABLE_ERROR_KEY, HOOK_CONFLICT_ERROR_KEY, RUNTIME_DECRYPTION_ERROR_KEY, STREAM_ERROR_KEY;
+var BASE_URL, ERROR_SLUGS, WorkflowError, WorkflowWorldError, WorkflowRunFailedError, WorkflowRunNotCompletedError, WorkflowRuntimeError, RuntimeDecryptionError, SerializationError, StepNotRegisteredError, WorkflowNotRegisteredError, WorkflowRunNotFoundError, HookConflictError, HookForceClaimedError, HookNotFoundError, EntityConflictError, RunExpiredError, StreamError, StreamExpiredError, ThrottleError, WorkflowRunCancelledError, FatalError, RetryableError, FATAL_ERROR_KEY, RETRYABLE_ERROR_KEY, HOOK_CONFLICT_ERROR_KEY, HOOK_FORCE_CLAIMED_ERROR_KEY, RUNTIME_DECRYPTION_ERROR_KEY, STREAM_ERROR_KEY;
 var init_dist2 = __esm({
   "../errors/dist/index.js"() {
     "use strict";
@@ -432,6 +432,7 @@ var init_dist2 = __esm({
       FETCH_IN_WORKFLOW_FUNCTION: "fetch-in-workflow",
       TIMEOUT_FUNCTIONS_IN_WORKFLOW: "timeout-in-workflow",
       HOOK_CONFLICT: "hook-conflict",
+      HOOK_FORCE_CLAIMED: "hook-force-claimed",
       CORRUPTED_EVENT_LOG: "corrupted-event-log",
       REPLAY_DIVERGENCE: "replay-divergence",
       STEP_NOT_REGISTERED: "step-not-registered",
@@ -658,6 +659,30 @@ Caused by: ${options.cause.stack}`;
         return isError(value) && value.name === "HookConflictError";
       }
     };
+    HookForceClaimedError = class extends WorkflowError {
+      static {
+        __name(this, "HookForceClaimedError");
+      }
+      token;
+      /** The run that took the token. */
+      claimedByRunId;
+      /** The hook (in `claimedByRunId`) the token now belongs to. */
+      claimedByHookId;
+      constructor(token, claimedByRunId, claimedByHookId) {
+        super(`Hook token "${token}" was force-claimed by another workflow (run "${claimedByRunId}")`, {
+          slug: ERROR_SLUGS.HOOK_FORCE_CLAIMED
+        });
+        this.name = "HookForceClaimedError";
+        this.token = token;
+        this.claimedByRunId = claimedByRunId;
+        if (claimedByHookId !== void 0) {
+          this.claimedByHookId = claimedByHookId;
+        }
+      }
+      static is(value) {
+        return isError(value) && value.name === "HookForceClaimedError";
+      }
+    };
     HookNotFoundError = class extends WorkflowError {
       static {
         __name(this, "HookNotFoundError");
@@ -810,6 +835,7 @@ Caused by: ${options.cause.stack}`;
     FATAL_ERROR_KEY = /* @__PURE__ */ Symbol.for("@workflow/errors//FatalError");
     RETRYABLE_ERROR_KEY = /* @__PURE__ */ Symbol.for("@workflow/errors//RetryableError");
     HOOK_CONFLICT_ERROR_KEY = /* @__PURE__ */ Symbol.for("@workflow/errors//HookConflictError");
+    HOOK_FORCE_CLAIMED_ERROR_KEY = /* @__PURE__ */ Symbol.for("@workflow/errors//HookForceClaimedError");
     RUNTIME_DECRYPTION_ERROR_KEY = /* @__PURE__ */ Symbol.for("@workflow/errors//RuntimeDecryptionError");
     STREAM_ERROR_KEY = /* @__PURE__ */ Symbol.for("@workflow/errors//StreamError");
     if (typeof globalThis !== "undefined") {
@@ -837,6 +863,14 @@ Caused by: ${options.cause.stack}`;
           configurable: false
         });
       }
+      if (!Object.hasOwn(globalThis, HOOK_FORCE_CLAIMED_ERROR_KEY)) {
+        Object.defineProperty(globalThis, HOOK_FORCE_CLAIMED_ERROR_KEY, {
+          value: HookForceClaimedError,
+          writable: false,
+          enumerable: false,
+          configurable: false
+        });
+      }
       if (!Object.hasOwn(globalThis, RUNTIME_DECRYPTION_ERROR_KEY)) {
         Object.defineProperty(globalThis, RUNTIME_DECRYPTION_ERROR_KEY, {
           value: RuntimeDecryptionError,
@@ -908,7 +942,7 @@ var init_env_config = __esm({
 function isLegacySpecVersion(v) {
   return v === void 0 || v === null || v <= SPEC_VERSION_LEGACY;
 }
-var SPEC_VERSION_LEGACY, SPEC_VERSION_SUPPORTS_CBOR_QUEUE_TRANSPORT, SPEC_VERSION_SUPPORTS_ATTRIBUTES, SPEC_VERSION_SUPPORTS_COMPRESSION, SPEC_VERSION_SUPPORTS_SLOT_IDENTITY, SPEC_VERSION_SUPPORTS_SEALED_LOG, SPEC_VERSION_CURRENT, SPEC_VERSION_MAX_SUPPORTED;
+var SPEC_VERSION_LEGACY, SPEC_VERSION_SUPPORTS_CBOR_QUEUE_TRANSPORT, SPEC_VERSION_SUPPORTS_ATTRIBUTES, SPEC_VERSION_SUPPORTS_COMPRESSION, SPEC_VERSION_SUPPORTS_SLOT_IDENTITY, SPEC_VERSION_SUPPORTS_HOOK_FORCE_CLAIM, SPEC_VERSION_CURRENT, SPEC_VERSION_MAX_SUPPORTED;
 var init_spec_version = __esm({
   "../world/dist/spec-version.js"() {
     "use strict";
@@ -918,9 +952,9 @@ var init_spec_version = __esm({
     SPEC_VERSION_SUPPORTS_ATTRIBUTES = 4;
     SPEC_VERSION_SUPPORTS_COMPRESSION = 5;
     SPEC_VERSION_SUPPORTS_SLOT_IDENTITY = 6;
-    SPEC_VERSION_SUPPORTS_SEALED_LOG = 7;
-    SPEC_VERSION_CURRENT = SPEC_VERSION_SUPPORTS_SEALED_LOG;
-    SPEC_VERSION_MAX_SUPPORTED = SPEC_VERSION_SUPPORTS_SEALED_LOG;
+    SPEC_VERSION_SUPPORTS_HOOK_FORCE_CLAIM = 8;
+    SPEC_VERSION_CURRENT = SPEC_VERSION_SUPPORTS_HOOK_FORCE_CLAIM;
+    SPEC_VERSION_MAX_SUPPORTED = SPEC_VERSION_SUPPORTS_HOOK_FORCE_CLAIM;
     __name(isLegacySpecVersion, "isLegacySpecVersion");
   }
 });
@@ -24904,7 +24938,30 @@ var init_events = __esm({
         tokenRetentionUntil: external_exports.coerce.date().optional(),
         metadata: SerializedDataSchema.optional(),
         isWebhook: external_exports.boolean().optional(),
-        isSystem: external_exports.boolean().optional()
+        isSystem: external_exports.boolean().optional(),
+        /**
+         * `createHook({ experimental_force: true })`: when the token belongs to
+         * another live run, the World takes it over — journaling
+         * `hook_disposed{forceClaimedBy}` in that run's log and re-pointing the
+         * token — instead of answering `hook_conflict`. Requires the
+         * `hookForceClaim` capability.
+         */
+        force: external_exports.boolean().optional(),
+        /**
+         * World-written on a forced creation that did take a token over: the
+         * run and hook it was taken from, plus what a queue message to that run
+         * needs (`workflowName`, `deploymentId`, `runSpecVersion`). Absent when
+         * the token was free. The wake-targeting fields are in the LOG, not only
+         * on the hook entity, so a replay can republish the victim's wake from
+         * the row alone; see `publishForceClaimVictimWake` in @workflow/core.
+         */
+        forceClaimedFrom: external_exports.object({
+          runId: external_exports.string(),
+          hookId: external_exports.string(),
+          workflowName: external_exports.string().optional(),
+          deploymentId: external_exports.string().optional(),
+          runSpecVersion: external_exports.number().optional()
+        }).optional()
       })
     }));
     HookReceivedEventSchema = external_exports.compile(BaseEventSchema.extend({
@@ -24919,7 +24976,17 @@ var init_events = __esm({
       eventType: external_exports.literal("hook_disposed"),
       correlationId: external_exports.string(),
       eventData: external_exports.object({
-        token: external_exports.string().optional()
+        token: external_exports.string().optional(),
+        /**
+         * World-written: this disposal was not the run's own. Another run
+         * took the hook's token with `experimental_force`, and this names
+         * it. The hook consumer rejects the hook's awaiters with
+         * `HookForceClaimedError` when it reads this row.
+         */
+        forceClaimedBy: external_exports.object({
+          runId: external_exports.string(),
+          hookId: external_exports.string()
+        }).optional()
       }).optional()
     }));
     HookConflictEventSchema = external_exports.compile(BaseEventSchema.extend({
@@ -24929,7 +24996,18 @@ var init_events = __esm({
         token: external_exports.string(),
         // TODO: Make this required once all persisted hook_conflict events and
         // remote World implementations always include the active hook owner's run ID.
-        conflictingRunId: external_exports.string().optional()
+        conflictingRunId: external_exports.string().optional(),
+        /**
+         * Set when the creation asked for `force` and the World declined to take
+         * the token over. `victim-spec-version`: the run holding the token was
+         * started at a spec version below
+         * `SPEC_VERSION_SUPPORTS_HOOK_FORCE_CLAIM`, so its runtime would not
+         * understand the involuntary disposal — the forced hook gets the
+         * ordinary `HookConflictError` it opted out of instead of stranding
+         * that run. Absent on a conflict answered by a World that does not
+         * implement forcing at all.
+         */
+        forceRefusedReason: external_exports.literal("victim-spec-version").optional()
       })
     }));
     NoopEventSchema = external_exports.compile(BaseEventSchema.extend({
@@ -25790,7 +25868,7 @@ var init_queue = __esm({
 });
 
 // ../world/dist/hooks.js
-var HookResumeContextSchema, HOOK_RESUME_INPUT_VERSION, HOOK_RESUME_DEDUP_VERSION, HookResumeCapabilitiesSchema, HookSchema;
+var HookResumeContextSchema, HOOK_RESUME_INPUT_VERSION, HOOK_RESUME_DEDUP_VERSION, HookResumeCapabilitiesSchema, HookClaimedFromSchema, HookSchema;
 var init_hooks = __esm({
   "../world/dist/hooks.js"() {
     "use strict";
@@ -25831,6 +25909,13 @@ var init_hooks = __esm({
       // is engaged.
       hookResumeDedupVersion: external_exports.number()
     }));
+    HookClaimedFromSchema = external_exports.compile(external_exports.object({
+      runId: external_exports.string(),
+      hookId: external_exports.string(),
+      workflowName: external_exports.string().optional(),
+      deploymentId: external_exports.string().optional(),
+      runSpecVersion: external_exports.number().optional()
+    }));
     HookSchema = external_exports.compile(external_exports.object({
       runId: external_exports.string(),
       hookId: external_exports.string(),
@@ -25858,7 +25943,12 @@ var init_hooks = __esm({
       // `resumeHook()` gates its lazy path on this being present and
       // current. Absent against an older/rolled-back server or when the kill switch
       // is active.
-      resumeCapabilities: HookResumeCapabilitiesSchema.optional()
+      resumeCapabilities: HookResumeCapabilitiesSchema.optional(),
+      // Set when this hook took its token from another run
+      // (`experimental_force`). The wake-targeting fields are the victim run's,
+      // so the claimer's runtime can publish the victim's wake without reading
+      // a run it may not be able to reach; see `HookClaimedFromSchema`.
+      claimedFrom: HookClaimedFromSchema.optional()
     }));
   }
 });
@@ -26549,6 +26639,20 @@ function getCommonReducers(_global = globalThis) {
       }
       return reduced;
     }, "HookConflictError"),
+    HookForceClaimedError: /* @__PURE__ */ __name((value) => {
+      const base = reduceNamedErrorSubclassBase("HookForceClaimedError", value);
+      if (!base) return false;
+      const reduced = {
+        ...base,
+        token: readProperty(value, "token"),
+        claimedByRunId: readProperty(value, "claimedByRunId")
+      };
+      const claimedByHookId = readProperty(value, "claimedByHookId");
+      if (claimedByHookId !== void 0) {
+        reduced.claimedByHookId = claimedByHookId;
+      }
+      return reduced;
+    }, "HookForceClaimedError"),
     RangeError: makeErrorSubclassReducer("RangeError"),
     ReferenceError: makeErrorSubclassReducer("ReferenceError"),
     // RetryableError carries an extra `retryAfter` Date that we serialize as
@@ -26723,6 +26827,15 @@ function getCommonRevivers(global2 = globalThis) {
       }
       return error61;
     }, "HookConflictError"),
+    HookForceClaimedError: /* @__PURE__ */ __name((value) => {
+      const Ctor = global2[/* @__PURE__ */ Symbol.for("@workflow/errors//HookForceClaimedError")] ?? HookForceClaimedError;
+      const error61 = new Ctor(value.token, value.claimedByRunId, value.claimedByHookId);
+      if (value.stack !== void 0) error61.stack = value.stack;
+      if ("cause" in value) {
+        error61.cause = value.cause;
+      }
+      return error61;
+    }, "HookForceClaimedError"),
     RangeError: makeErrorSubclassReviver(global2, "RangeError"),
     ReferenceError: makeErrorSubclassReviver(global2, "ReferenceError"),
     RetryableError: /* @__PURE__ */ __name((value) => {
@@ -32182,7 +32295,7 @@ var version2;
 var init_version = __esm({
   "../core/dist/version.js"() {
     "use strict";
-    version2 = "5.0.0-beta.54";
+    version2 = "5.0.0-beta.56";
   }
 });
 
@@ -32361,6 +32474,56 @@ var init_helpers = __esm({
   }
 });
 
+// ../core/dist/runtime/hook-wake.js
+function isRetryableWakeError(error61, isDeploymentUnavailableError) {
+  if (isDeploymentUnavailableError?.(error61)) return false;
+  const status = error61 ?? {};
+  const code2 = status.status ?? status.statusCode;
+  if (typeof code2 === "number") {
+    return code2 >= 500 || code2 === 408 || code2 === 429;
+  }
+  const name = error61?.name;
+  return name !== "BadRequestError" && name !== "UnauthorizedError" && name !== "ForbiddenError";
+}
+async function publishHookWakeWithRetry(publish, isDeploymentUnavailableError) {
+  let lastError;
+  for (let attempt = 0; attempt <= HOOK_WAKE_RETRY_DELAYS_MS.length; attempt++) {
+    try {
+      await publish();
+      return;
+    } catch (error61) {
+      lastError = error61;
+      if (!isRetryableWakeError(error61, isDeploymentUnavailableError)) break;
+      const delayMs = HOOK_WAKE_RETRY_DELAYS_MS[attempt];
+      if (delayMs !== void 0) {
+        await new Promise((resolve) => setTimeout(resolve, delayMs));
+      }
+    }
+  }
+  if (HookNotFoundError.is(lastError)) {
+    throw new WorkflowRuntimeError("The hook resume was committed, but its workflow wake could not be published", {
+      cause: lastError
+    });
+  }
+  throw lastError;
+}
+var HOOK_WAKE_RETRY_DELAYS_MS;
+var init_hook_wake = __esm({
+  "../core/dist/runtime/hook-wake.js"() {
+    "use strict";
+    init_dist2();
+    init_dist4();
+    init_logger();
+    init_helpers();
+    HOOK_WAKE_RETRY_DELAYS_MS = [
+      25,
+      100
+    ];
+    __name(isRetryableWakeError, "isRetryableWakeError");
+    __name(publishHookWakeWithRetry, "publishHookWakeWithRetry");
+  }
+});
+
 // ../core/dist/runtime/invocations.js
 var HookInvocationSchema, HookInvocationResultSchema;
 var init_invocations = __esm({
@@ -37356,38 +37519,6 @@ async function computeResumePayloadDigest(bytes) {
   }
   return hex3;
 }
-function isRetryableWakeError(error61, isDeploymentUnavailableError) {
-  if (isDeploymentUnavailableError?.(error61)) return false;
-  const status = error61 ?? {};
-  const code2 = status.status ?? status.statusCode;
-  if (typeof code2 === "number") {
-    return code2 >= 500 || code2 === 408 || code2 === 429;
-  }
-  const name = error61?.name;
-  return name !== "BadRequestError" && name !== "UnauthorizedError" && name !== "ForbiddenError";
-}
-async function publishHookWakeWithRetry(publish, isDeploymentUnavailableError) {
-  let lastError;
-  for (let attempt = 0; attempt <= HOOK_WAKE_RETRY_DELAYS_MS.length; attempt++) {
-    try {
-      await publish();
-      return;
-    } catch (error61) {
-      lastError = error61;
-      if (!isRetryableWakeError(error61, isDeploymentUnavailableError)) break;
-      const delayMs = HOOK_WAKE_RETRY_DELAYS_MS[attempt];
-      if (delayMs !== void 0) {
-        await new Promise((resolve) => setTimeout(resolve, delayMs));
-      }
-    }
-  }
-  if (HookNotFoundError.is(lastError)) {
-    throw new WorkflowRuntimeError("The hook resume was committed, but its workflow wake could not be published", {
-      cause: lastError
-    });
-  }
-  throw lastError;
-}
 function resumeContextFromRun(run2) {
   const coreVersion = run2.executionContext?.workflowCoreVersion;
   const traceCarrier = run2.executionContext?.traceCarrier;
@@ -37469,163 +37600,267 @@ async function getHookByToken(token) {
 async function resumeHook(tokenOrHook, payload, encryptionKeyOverride) {
   return resumeHookImpl(tokenOrHook, payload, encryptionKeyOverride, false, Date.now());
 }
-async function resumeHookImpl(tokenOrHook, payload, encryptionKeyOverride, hookFreshlyLookedUp, resumeRequestedAtMs) {
+async function resumeHookImpl(tokenOrHook, payload, encryptionKeyOverride, hookFreshlyLookedUp, resumeRequestedAtMs, webhookOnly = false) {
   return await waitedUntil(() => {
     return trace("hook.resume", async (span) => {
       const world = await getWorldLazy();
-      try {
-        const suppliedToken = typeof tokenOrHook === "string";
-        const hook = suppliedToken ? await world.hooks.getByToken(tokenOrHook) : tokenOrHook;
-        const hookResumeCapabilitiesAreFresh = suppliedToken || hookFreshlyLookedUp;
-        const info = await resolveHookResumeInfo(hook);
-        const { resumeContext } = info;
-        span?.setAttributes({
-          ...HookToken(hook.token),
-          ...HookId(hook.hookId),
-          ...WorkflowRunId(hook.runId),
-          "workflow.hook.resume_context_source": info.source
-        });
-        if (info.run && isTerminalWorkflowRunStatus(info.run.status)) {
-          throw new HookNotFoundError(hook.token);
-        }
-        const capabilities = getRunCapabilities(resumeContext.workflowCoreVersion);
-        let payloadKey;
-        const runPublicKey = encryptionKeyOverride ? (
-          // hydrate hook metadata), so sealing would add an ECDH for no
-          // saved round trip. Reuse what it resolved.
-          void 0
-        ) : decodeRunPublicKey(resumeContext.encryptionPublicKey);
-        if (runPublicKey) {
-          payloadKey = sealTo(runPublicKey);
-        } else {
-          let encryptionKey = encryptionKeyOverride ?? await resolveHookEncryptionKey(hook, info);
-          if (!capabilities.supportedFormats.has(SerializationFormat.ENCRYPTED)) {
-            encryptionKey = void 0;
-          }
-          payloadKey = encryptionKey;
-        }
-        const compression = (resumeContext.runSpecVersion ?? 0) >= SPEC_VERSION_SUPPORTS_COMPRESSION && capabilities.supportedFormats.has(SerializationFormat.GZIP);
-        const ops = [];
-        const readbackOps = [];
-        const v1Compat = isLegacySpecVersion(hook.specVersion);
-        const dehydratedPayload = await dehydrateStepReturnValue(payload, hook.runId, payloadKey, ops, globalThis, v1Compat, capabilities.framedByteStreams, compression, void 0, readbackOps);
-        await Promise.all(ops.map((op) => op.catch((error61) => {
-          if (error61 !== void 0) throw error61;
-        })));
-        safeWaitUntil(Promise.all(readbackOps), (err) => {
-          if (err === void 0) return;
-          runtimeLogger.warn("Background readback of hook payload failed", {
-            workflowRunId: hook.runId,
-            hookId: hook.hookId,
-            error: err instanceof Error ? err.message : String(err)
-          });
-        });
-        span?.setAttributes({
-          ...WorkflowName(resumeContext.workflowName)
-        });
-        const originLink = await linkToTraceCarrier(resumeContext.traceCarrier);
-        if (originLink) {
-          span?.addLink?.(originLink);
-        }
-        if (world.capabilities?.invoke === true && !v1Compat && dehydratedPayload instanceof Uint8Array) {
-          if (!world.invoke) {
-            throw new WorkflowRuntimeError("World advertises invoke without implementing it");
-          }
+      const token = typeof tokenOrHook === "string" ? tokenOrHook : tokenOrHook.token;
+      let target = tokenOrHook;
+      let fresh = hookFreshlyLookedUp;
+      let keyOverride = encryptionKeyOverride;
+      let redirects = 0;
+      let lookupsAfterRedirect = 0;
+      const MAX_LOOKUPS_AFTER_REDIRECT = 5;
+      const resumeId = generateResumeId();
+      const assertResendable = /* @__PURE__ */ __name((cause) => {
+        if (payload instanceof Request && payload.body !== null && payload.bodyUsed) {
           span?.setAttributes({
-            "workflow.hook.resume_strategy": "invoke"
+            "workflow.hook.resume_redirect_unresendable": true
           });
-          const result = HookInvocationResultSchema.parse(await world.invoke(hook.runId, {
-            type: "hook_resume",
-            version: 1,
-            hookId: hook.hookId,
-            token: hook.token,
-            payload: dehydratedPayload
-          }, {
-            idempotencyKey: generateResumeId()
-          }));
-          if (result.status === "rejected") {
-            if (result.code === "HOOK_NOT_FOUND") throw new HookNotFoundError(hook.token);
-            throw new WorkflowRuntimeError("Executor rejected the hook invocation input");
-          }
-          span?.setAttributes(HookResumeCommitted(true));
-          return asLazyMetadataHook(hook);
-        }
-        const queueName = getWorkflowQueueName(resumeContext.workflowName);
-        const queueOptions = {
-          deploymentId: resumeContext.deploymentId,
-          specVersion: resumeContext.runSpecVersion ?? SPEC_VERSION_LEGACY
-        };
-        const backendDedupSupported = (hookResumeCapabilitiesAreFresh ? hook.resumeCapabilities?.hookResumeDedupVersion ?? 0 : 0) >= HOOK_RESUME_DEDUP_VERSION || world.capabilities?.hookResumeDedup === true;
-        const canClaimResume = backendDedupSupported && !v1Compat && dehydratedPayload instanceof Uint8Array;
-        span?.setAttributes({
-          "workflow.hook.resume_strategy": "sequential"
-        });
-        const resumeId = canClaimResume ? generateResumeId() : void 0;
-        const payloadDigest = canClaimResume ? await computeResumePayloadDigest(dehydratedPayload) : void 0;
-        if (resumeId) {
-          span?.setAttributes({
-            "workflow.hook.resume_id": resumeId
+          throw new WorkflowRuntimeError(`Hook token "${token}" changed owner while this webhook request was being delivered; a request body can be sent only once and it was not delivered anywhere \u2014 retry the request, which will reach the token's new owner`, {
+            cause
           });
         }
-        const isHookGoneError = /* @__PURE__ */ __name((err) => HookNotFoundError.is(err) || RunExpiredError.is(err), "isHookGoneError");
+      }, "assertResendable");
+      for (; ; ) {
         try {
-          await world.events.create(hook.runId, {
-            eventType: "hook_received",
-            specVersion: SPEC_VERSION_CURRENT,
-            correlationId: hook.hookId,
-            eventData: {
-              ...v1Compat ? {} : {
-                token: hook.token
-              },
-              payload: dehydratedPayload
-            }
-          }, {
-            v1Compat,
-            ...resumeId && payloadDigest ? {
-              resumeId,
-              resumePayloadDigest: payloadDigest
-            } : {}
-          });
+          return await resumeHookAttempt(world, span, target, payload, keyOverride, fresh, resumeRequestedAtMs, resumeId, webhookOnly);
         } catch (err) {
-          if (isHookGoneError(err)) {
-            throw new HookNotFoundError(hook.token);
+          if (err !== null && typeof err === "object" && notFoundReasons.get(err) === "not-webhook") {
+            throw err;
+          }
+          if (redirects >= MAX_FORCE_CLAIM_REDIRECTS) {
+            if (HookForceClaimedError.is(err)) {
+              span?.setAttributes({
+                "workflow.hook.resume_redirects_exhausted": true
+              });
+              throw new WorkflowRuntimeError(`Hook token "${token}" changed owner ${redirects} times while this resume was in flight; nothing was delivered \u2014 retry the resume`, {
+                cause: err
+              });
+            }
+            throw err;
+          }
+          if (HookForceClaimedError.is(err)) {
+            assertResendable(err);
+            redirects++;
+            span?.setAttributes({
+              "workflow.hook.resume_redirects": redirects,
+              "workflow.hook.resume_redirect_to_run": err.claimedByRunId
+            });
+            target = token;
+            fresh = true;
+            keyOverride = void 0;
+            lookupsAfterRedirect = 0;
+            continue;
+          }
+          if (HookNotFoundError.is(err) && redirects > 0 && typeof target === "string" && lookupsAfterRedirect < MAX_LOOKUPS_AFTER_REDIRECT) {
+            assertResendable(err);
+            lookupsAfterRedirect++;
+            await new Promise((resolve) => setTimeout(resolve, 50));
+            continue;
+          }
+          if (HookNotFoundError.is(err) && notFoundReasons.get(err) !== "lookup") {
+            const attemptedHookId = typeof target === "string" ? void 0 : target.hookId;
+            let relocated;
+            try {
+              relocated = await world.hooks.getByToken(token);
+            } catch (lookupError) {
+              if (!HookNotFoundError.is(lookupError)) {
+                runtimeLogger.warn("Hook resume: re-resolving the token after a not-found failed; surfacing the original error", {
+                  token,
+                  error: lookupError instanceof Error ? lookupError.message : String(lookupError)
+                });
+              }
+            }
+            if (relocated?.claimedFrom !== void 0 && relocated.hookId !== attemptedHookId && (attemptedHookId === void 0 || relocated.claimedFrom.hookId === attemptedHookId) && !(webhookOnly && relocated.isWebhook === false)) {
+              assertResendable(err);
+              redirects++;
+              span?.setAttributes({
+                "workflow.hook.resume_redirects": redirects,
+                "workflow.hook.resume_redirect_to_run": relocated.runId
+              });
+              target = relocated;
+              fresh = true;
+              keyOverride = void 0;
+              continue;
+            }
           }
           throw err;
         }
-        span?.setAttributes(HookResumeCommitted(true));
-        const queuePublishRequestedAtMs = Date.now();
-        await publishHookWakeWithRetry(() => world.queue(queueName, {
-          runId: hook.runId,
-          traceCarrier: resumeContext.traceCarrier ?? void 0,
-          hookResumeTiming: {
-            resumeRequestedAtMs,
-            queuePublishRequestedAtMs,
-            strategy: "sequential"
-          }
-        }, {
-          ...queueOptions,
-          // Dedup retried publishes whose response was lost: a
-          // duplicate wake is harmless for correctness (deterministic
-          // replay) but costs a full replay of the run, and the queue
-          // accepts a repeated idempotency key by delivering only one
-          // of the messages. Claim-less writes have no resumeId and
-          // keep the previous behavior.
-          ...resumeId ? {
-            idempotencyKey: `hook-${resumeId}`
-          } : {}
-        }), world.isDeploymentUnavailableError?.bind(world));
-        span?.setAttributes(HookWakePublished(true));
-        return asLazyMetadataHook(hook);
-      } catch (err) {
-        span?.setAttributes({
-          ...HookToken(typeof tokenOrHook === "string" ? tokenOrHook : tokenOrHook.token),
-          ...HookFound(false)
-        });
-        throw err;
       }
     });
   });
 }
+async function resumeHookAttempt(world, span, tokenOrHook, payload, encryptionKeyOverride, hookFreshlyLookedUp, resumeRequestedAtMs, logicalResumeId, webhookOnly) {
+  try {
+    const suppliedToken = typeof tokenOrHook === "string";
+    let hook;
+    if (suppliedToken) {
+      try {
+        hook = await world.hooks.getByToken(tokenOrHook);
+      } catch (lookupError) {
+        if (HookNotFoundError.is(lookupError)) {
+          notFoundReasons.set(lookupError, "lookup");
+        }
+        throw lookupError;
+      }
+    } else {
+      hook = tokenOrHook;
+    }
+    if (webhookOnly && hook.isWebhook === false) {
+      const notWebhook = new HookNotFoundError(hook.token);
+      notFoundReasons.set(notWebhook, "not-webhook");
+      throw notWebhook;
+    }
+    const hookResumeCapabilitiesAreFresh = suppliedToken || hookFreshlyLookedUp;
+    const info = await resolveHookResumeInfo(hook);
+    const { resumeContext } = info;
+    span?.setAttributes({
+      ...HookToken(hook.token),
+      ...HookId(hook.hookId),
+      ...WorkflowRunId(hook.runId),
+      "workflow.hook.resume_context_source": info.source
+    });
+    if (info.run && isTerminalWorkflowRunStatus(info.run.status)) {
+      throw new HookNotFoundError(hook.token);
+    }
+    const capabilities = getRunCapabilities(resumeContext.workflowCoreVersion);
+    let payloadKey;
+    const runPublicKey = encryptionKeyOverride ? (
+      // hydrate hook metadata), so sealing would add an ECDH for no
+      // saved round trip. Reuse what it resolved.
+      void 0
+    ) : decodeRunPublicKey(resumeContext.encryptionPublicKey);
+    if (runPublicKey) {
+      payloadKey = sealTo(runPublicKey);
+    } else {
+      let encryptionKey = encryptionKeyOverride ?? await resolveHookEncryptionKey(hook, info);
+      if (!capabilities.supportedFormats.has(SerializationFormat.ENCRYPTED)) {
+        encryptionKey = void 0;
+      }
+      payloadKey = encryptionKey;
+    }
+    const compression = (resumeContext.runSpecVersion ?? 0) >= SPEC_VERSION_SUPPORTS_COMPRESSION && capabilities.supportedFormats.has(SerializationFormat.GZIP);
+    const ops = [];
+    const readbackOps = [];
+    const v1Compat = isLegacySpecVersion(hook.specVersion);
+    const dehydratedPayload = await dehydrateStepReturnValue(payload, hook.runId, payloadKey, ops, globalThis, v1Compat, capabilities.framedByteStreams, compression, void 0, readbackOps);
+    await Promise.all(ops.map((op) => op.catch((error61) => {
+      if (error61 !== void 0) throw error61;
+    })));
+    safeWaitUntil(Promise.all(readbackOps), (err) => {
+      if (err === void 0) return;
+      runtimeLogger.warn("Background readback of hook payload failed", {
+        workflowRunId: hook.runId,
+        hookId: hook.hookId,
+        error: err instanceof Error ? err.message : String(err)
+      });
+    });
+    if (world.capabilities?.invoke === true && !v1Compat && dehydratedPayload instanceof Uint8Array) {
+      if (!world.invoke) {
+        throw new WorkflowRuntimeError("World advertises invoke without implementing it");
+      }
+      span?.setAttributes({
+        "workflow.hook.resume_strategy": "invoke"
+      });
+      const result = HookInvocationResultSchema.parse(await world.invoke(hook.runId, {
+        type: "hook_resume",
+        version: 1,
+        hookId: hook.hookId,
+        token: hook.token,
+        payload: dehydratedPayload
+      }, {
+        idempotencyKey: logicalResumeId
+      }));
+      if (result.status === "rejected") {
+        if (result.code === "HOOK_NOT_FOUND") throw new HookNotFoundError(hook.token);
+        throw new WorkflowRuntimeError("Executor rejected the hook invocation input");
+      }
+      span?.setAttributes(HookResumeCommitted(true));
+      return asLazyMetadataHook(hook);
+    }
+    span?.setAttributes({
+      ...WorkflowName(resumeContext.workflowName)
+    });
+    const originLink = await linkToTraceCarrier(resumeContext.traceCarrier);
+    if (originLink) {
+      span?.addLink?.(originLink);
+    }
+    const queueName = getWorkflowQueueName(resumeContext.workflowName);
+    const queueOptions = {
+      deploymentId: resumeContext.deploymentId,
+      specVersion: resumeContext.runSpecVersion ?? SPEC_VERSION_LEGACY
+    };
+    const backendDedupSupported = (hookResumeCapabilitiesAreFresh ? hook.resumeCapabilities?.hookResumeDedupVersion ?? 0 : 0) >= HOOK_RESUME_DEDUP_VERSION || world.capabilities?.hookResumeDedup === true;
+    const canClaimResume = backendDedupSupported && !v1Compat && dehydratedPayload instanceof Uint8Array;
+    span?.setAttributes({
+      "workflow.hook.resume_strategy": "sequential"
+    });
+    const resumeId = canClaimResume ? logicalResumeId : void 0;
+    const payloadDigest = canClaimResume ? await computeResumePayloadDigest(dehydratedPayload) : void 0;
+    if (resumeId) {
+      span?.setAttributes({
+        "workflow.hook.resume_id": resumeId
+      });
+    }
+    const isHookGoneError = /* @__PURE__ */ __name((err) => HookNotFoundError.is(err) || RunExpiredError.is(err), "isHookGoneError");
+    try {
+      await world.events.create(hook.runId, {
+        eventType: "hook_received",
+        specVersion: SPEC_VERSION_CURRENT,
+        correlationId: hook.hookId,
+        eventData: {
+          ...v1Compat ? {} : {
+            token: hook.token
+          },
+          payload: dehydratedPayload
+        }
+      }, {
+        v1Compat,
+        ...resumeId && payloadDigest ? {
+          resumeId,
+          resumePayloadDigest: payloadDigest
+        } : {}
+      });
+    } catch (err) {
+      if (HookForceClaimedError.is(err)) throw err;
+      if (isHookGoneError(err)) {
+        throw new HookNotFoundError(hook.token);
+      }
+      throw err;
+    }
+    span?.setAttributes(HookResumeCommitted(true));
+    const queuePublishRequestedAtMs = Date.now();
+    await publishHookWakeWithRetry(() => world.queue(queueName, {
+      runId: hook.runId,
+      traceCarrier: resumeContext.traceCarrier ?? void 0,
+      hookResumeTiming: {
+        resumeRequestedAtMs,
+        queuePublishRequestedAtMs,
+        strategy: "sequential"
+      }
+    }, {
+      ...queueOptions,
+      // Dedup retried publishes whose response was lost: a
+      // duplicate wake is harmless for correctness (deterministic
+      // replay) but costs a full replay of the run, and the queue
+      // accepts a repeated idempotency key by delivering only one
+      // of the messages. Claim-less writes have no resumeId and
+      // keep the previous behavior.
+      ...resumeId ? {
+        idempotencyKey: `hook-${resumeId}`
+      } : {}
+    }), world.isDeploymentUnavailableError?.bind(world));
+    span?.setAttributes(HookWakePublished(true));
+    return asLazyMetadataHook(hook);
+  } catch (err) {
+    span?.setAttributes({
+      ...HookToken(typeof tokenOrHook === "string" ? tokenOrHook : tokenOrHook.token),
+      ...HookFound(false)
+    });
+    throw err;
+  }
+}
 async function resumeWebhook(token, request) {
   const resumeRequestedAtMs = Date.now();
   const world = await getWorldLazy();
@@ -37653,7 +37888,7 @@ async function resumeWebhook(token, request) {
       status: 202
     });
   }
-  await resumeHookImpl(hook, request, metadataEncryptionKey(), true, resumeRequestedAtMs);
+  await resumeHookImpl(hook, request, metadataEncryptionKey(), true, resumeRequestedAtMs, true);
   if (responseReadable) {
     const reader = responseReadable.getReader();
     const chunk = await reader.read();
@@ -37669,7 +37904,7 @@ async function resumeWebhook(token, request) {
   }
   return response;
 }
-var generateResumeId, HOOK_WAKE_RETRY_DELAYS_MS;
+var generateResumeId, MAX_FORCE_CLAIM_REDIRECTS, notFoundReasons;
 var init_resume_hook = __esm({
   "../core/dist/runtime/resume-hook.js"() {
     "use strict";
@@ -37687,16 +37922,11 @@ var init_resume_hook = __esm({
     init_telemetry();
     init_get_world_lazy();
     init_helpers();
+    init_hook_wake();
     init_invocations();
     init_wait_until();
     generateResumeId = monotonicFactory();
     __name(computeResumePayloadDigest, "computeResumePayloadDigest");
-    HOOK_WAKE_RETRY_DELAYS_MS = [
-      25,
-      100
-    ];
-    __name(isRetryableWakeError, "isRetryableWakeError");
-    __name(publishHookWakeWithRetry, "publishHookWakeWithRetry");
     __name(resumeContextFromRun, "resumeContextFromRun");
     __name(resolveHookResumeInfo, "resolveHookResumeInfo");
     __name(resolveHookEncryptionKey, "resolveHookEncryptionKey");
@@ -37705,7 +37935,10 @@ var init_resume_hook = __esm({
     __name(asLazyMetadataHook, "asLazyMetadataHook");
     __name(getHookByToken, "getHookByToken");
     __name(resumeHook, "resumeHook");
+    MAX_FORCE_CLAIM_REDIRECTS = 3;
+    notFoundReasons = /* @__PURE__ */ new WeakMap();
     __name(resumeHookImpl, "resumeHookImpl");
+    __name(resumeHookAttempt, "resumeHookAttempt");
     __name(resumeWebhook, "resumeWebhook");
   }
 });
@@ -40086,7 +40319,7 @@ __name(start, "start");
     value: "start",
     configurable: true
   });
-})(start, "step//@workflow/core/runtime/start@5.0.0-beta.54//start");
+})(start, "step//@workflow/core/runtime/start@5.0.0-beta.56//start");
 
 // ../core/dist/runtime/runs.js
 async function wakeUpRun(world, runId, options) {
@@ -40557,7 +40790,7 @@ var Run = class _Run {
     value: "wakeUp",
     configurable: true
   });
-})(Run.prototype["wakeUp"], "step//@workflow/core/runtime/run@5.0.0-beta.54//Run#wakeUp");
+})(Run.prototype["wakeUp"], "step//@workflow/core/runtime/run@5.0.0-beta.56//Run#wakeUp");
 (function(__wf_fn, __wf_id) {
   var __wf_sym = /* @__PURE__ */ Symbol.for("@workflow/core//registeredSteps"), __wf_reg = globalThis[__wf_sym] || (globalThis[__wf_sym] = /* @__PURE__ */ new Map());
   __wf_reg.set(__wf_id, __wf_fn);
@@ -40566,7 +40799,7 @@ var Run = class _Run {
     value: "cancel",
     configurable: true
   });
-})(Run.prototype["cancel"], "step//@workflow/core/runtime/run@5.0.0-beta.54//Run#cancel");
+})(Run.prototype["cancel"], "step//@workflow/core/runtime/run@5.0.0-beta.56//Run#cancel");
 (function(__wf_fn, __wf_id) {
   var __wf_sym = /* @__PURE__ */ Symbol.for("@workflow/core//registeredSteps"), __wf_reg = globalThis[__wf_sym] || (globalThis[__wf_sym] = /* @__PURE__ */ new Map());
   __wf_reg.set(__wf_id, __wf_fn);
@@ -40575,7 +40808,7 @@ var Run = class _Run {
     value: "getReadable",
     configurable: true
   });
-})(Run.prototype["getReadable"], "step//@workflow/core/runtime/run@5.0.0-beta.54//Run#getReadable");
+})(Run.prototype["getReadable"], "step//@workflow/core/runtime/run@5.0.0-beta.56//Run#getReadable");
 (function(__wf_fn, __wf_id) {
   var __wf_sym = /* @__PURE__ */ Symbol.for("@workflow/core//registeredSteps"), __wf_reg = globalThis[__wf_sym] || (globalThis[__wf_sym] = /* @__PURE__ */ new Map());
   __wf_reg.set(__wf_id, __wf_fn);
@@ -40584,7 +40817,7 @@ var Run = class _Run {
     value: "getWritable",
     configurable: true
   });
-})(Run.prototype["getWritable"], "step//@workflow/core/runtime/run@5.0.0-beta.54//Run#getWritable");
+})(Run.prototype["getWritable"], "step//@workflow/core/runtime/run@5.0.0-beta.56//Run#getWritable");
 (function(__wf_fn, __wf_id) {
   var __wf_sym = /* @__PURE__ */ Symbol.for("@workflow/core//registeredSteps"), __wf_reg = globalThis[__wf_sym] || (globalThis[__wf_sym] = /* @__PURE__ */ new Map());
   __wf_reg.set(__wf_id, __wf_fn);
@@ -40593,7 +40826,7 @@ var Run = class _Run {
     value: "exists",
     configurable: true
   });
-})(Object.getOwnPropertyDescriptor(Run.prototype, "exists").get, "step//@workflow/core/runtime/run@5.0.0-beta.54//Run#exists");
+})(Object.getOwnPropertyDescriptor(Run.prototype, "exists").get, "step//@workflow/core/runtime/run@5.0.0-beta.56//Run#exists");
 (function(__wf_fn, __wf_id) {
   var __wf_sym = /* @__PURE__ */ Symbol.for("@workflow/core//registeredSteps"), __wf_reg = globalThis[__wf_sym] || (globalThis[__wf_sym] = /* @__PURE__ */ new Map());
   __wf_reg.set(__wf_id, __wf_fn);
@@ -40602,7 +40835,7 @@ var Run = class _Run {
     value: "status",
     configurable: true
   });
-})(Object.getOwnPropertyDescriptor(Run.prototype, "status").get, "step//@workflow/core/runtime/run@5.0.0-beta.54//Run#status");
+})(Object.getOwnPropertyDescriptor(Run.prototype, "status").get, "step//@workflow/core/runtime/run@5.0.0-beta.56//Run#status");
 (function(__wf_fn, __wf_id) {
   var __wf_sym = /* @__PURE__ */ Symbol.for("@workflow/core//registeredSteps"), __wf_reg = globalThis[__wf_sym] || (globalThis[__wf_sym] = /* @__PURE__ */ new Map());
   __wf_reg.set(__wf_id, __wf_fn);
@@ -40611,7 +40844,7 @@ var Run = class _Run {
     value: "returnValue",
     configurable: true
   });
-})(Object.getOwnPropertyDescriptor(Run.prototype, "returnValue").get, "step//@workflow/core/runtime/run@5.0.0-beta.54//Run#returnValue");
+})(Object.getOwnPropertyDescriptor(Run.prototype, "returnValue").get, "step//@workflow/core/runtime/run@5.0.0-beta.56//Run#returnValue");
 (function(__wf_fn, __wf_id) {
   var __wf_sym = /* @__PURE__ */ Symbol.for("@workflow/core//registeredSteps"), __wf_reg = globalThis[__wf_sym] || (globalThis[__wf_sym] = /* @__PURE__ */ new Map());
   __wf_reg.set(__wf_id, __wf_fn);
@@ -40620,7 +40853,7 @@ var Run = class _Run {
     value: "workflowName",
     configurable: true
   });
-})(Object.getOwnPropertyDescriptor(Run.prototype, "workflowName").get, "step//@workflow/core/runtime/run@5.0.0-beta.54//Run#workflowName");
+})(Object.getOwnPropertyDescriptor(Run.prototype, "workflowName").get, "step//@workflow/core/runtime/run@5.0.0-beta.56//Run#workflowName");
 (function(__wf_fn, __wf_id) {
   var __wf_sym = /* @__PURE__ */ Symbol.for("@workflow/core//registeredSteps"), __wf_reg = globalThis[__wf_sym] || (globalThis[__wf_sym] = /* @__PURE__ */ new Map());
   __wf_reg.set(__wf_id, __wf_fn);
@@ -40629,7 +40862,7 @@ var Run = class _Run {
     value: "createdAt",
     configurable: true
   });
-})(Object.getOwnPropertyDescriptor(Run.prototype, "createdAt").get, "step//@workflow/core/runtime/run@5.0.0-beta.54//Run#createdAt");
+})(Object.getOwnPropertyDescriptor(Run.prototype, "createdAt").get, "step//@workflow/core/runtime/run@5.0.0-beta.56//Run#createdAt");
 (function(__wf_fn, __wf_id) {
   var __wf_sym = /* @__PURE__ */ Symbol.for("@workflow/core//registeredSteps"), __wf_reg = globalThis[__wf_sym] || (globalThis[__wf_sym] = /* @__PURE__ */ new Map());
   __wf_reg.set(__wf_id, __wf_fn);
@@ -40638,7 +40871,7 @@ var Run = class _Run {
     value: "startedAt",
     configurable: true
   });
-})(Object.getOwnPropertyDescriptor(Run.prototype, "startedAt").get, "step//@workflow/core/runtime/run@5.0.0-beta.54//Run#startedAt");
+})(Object.getOwnPropertyDescriptor(Run.prototype, "startedAt").get, "step//@workflow/core/runtime/run@5.0.0-beta.56//Run#startedAt");
 (function(__wf_fn, __wf_id) {
   var __wf_sym = /* @__PURE__ */ Symbol.for("@workflow/core//registeredSteps"), __wf_reg = globalThis[__wf_sym] || (globalThis[__wf_sym] = /* @__PURE__ */ new Map());
   __wf_reg.set(__wf_id, __wf_fn);
@@ -40647,7 +40880,7 @@ var Run = class _Run {
     value: "completedAt",
     configurable: true
   });
-})(Object.getOwnPropertyDescriptor(Run.prototype, "completedAt").get, "step//@workflow/core/runtime/run@5.0.0-beta.54//Run#completedAt");
+})(Object.getOwnPropertyDescriptor(Run.prototype, "completedAt").get, "step//@workflow/core/runtime/run@5.0.0-beta.56//Run#completedAt");
 (function(__wf_cls, __wf_id) {
   var __wf_sym = /* @__PURE__ */ Symbol.for("workflow-class-registry"), __wf_reg = globalThis[__wf_sym] || (globalThis[__wf_sym] = /* @__PURE__ */ new Map());
   __wf_reg.set(__wf_id, __wf_cls);
@@ -40657,7 +40890,7 @@ var Run = class _Run {
     enumerable: false,
     configurable: false
   });
-})(Run, "class//@workflow/core/runtime/run@5.0.0-beta.54//Run");
+})(Run, "class//@workflow/core/runtime/run@5.0.0-beta.56//Run");
 
 // ../workflow/dist/stdlib.js
 async function fetch2(...args) {