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

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

@@ -496,6 +496,17 @@ Caused by: ${options.cause.stack}`;
       static {
         __name(this, "WorkflowRunFailedError");
       }
+      /**
+       * `failed` is terminal, and a run's terminal state is immutable. This error
+       * is only ever thrown after a *successful* read of such a run, so re-running
+       * the read returns the same record and throws the same error. Marking it
+       * non-retryable is what stops the step executor from spending a retry budget
+       * on that when the read happens inside a step — a parent awaiting a child's
+       * `returnValue` — and then replacing this error with its retry-exhaustion
+       * wrapper. A read that *fails* throws something else and stays retryable.
+       * See `FatalError.is()`.
+       */
+      fatal = true;
       runId;
       /**
        * The high-level error category (e.g. USER_ERROR, RUNTIME_ERROR) for the
@@ -786,6 +797,8 @@ Caused by: ${options.cause.stack}`;
       static {
         __name(this, "WorkflowRunCancelledError");
       }
+      /** Terminal and immutable, for the same reason as {@link WorkflowRunFailedError.fatal}. */
+      fatal = true;
       runId;
       constructor(runId) {
         super(`Workflow run "${runId}" cancelled`, {});
@@ -938,27 +951,6 @@ var init_env_config = __esm({
   }
 });
 
-// ../world/dist/spec-version.js
-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_HOOK_FORCE_CLAIM, SPEC_VERSION_CURRENT, SPEC_VERSION_MAX_SUPPORTED;
-var init_spec_version = __esm({
-  "../world/dist/spec-version.js"() {
-    "use strict";
-    init_env_config();
-    SPEC_VERSION_LEGACY = 1;
-    SPEC_VERSION_SUPPORTS_CBOR_QUEUE_TRANSPORT = 3;
-    SPEC_VERSION_SUPPORTS_ATTRIBUTES = 4;
-    SPEC_VERSION_SUPPORTS_COMPRESSION = 5;
-    SPEC_VERSION_SUPPORTS_SLOT_IDENTITY = 6;
-    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");
-  }
-});
-
 // ../core/dist/encryption.js
 async function importKey(raw, usages = [
   "encrypt",
@@ -26009,6 +26001,28 @@ var init_slot_identity = __esm({
   }
 });
 
+// ../world/dist/spec-version.js
+function isLegacySpecVersion(v) {
+  return v === void 0 || v === null || v <= SPEC_VERSION_LEGACY;
+}
+var SPEC_VERSION_LEGACY, SPEC_VERSION_SUPPORTS_EVENT_SOURCING, 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";
+    init_env_config();
+    SPEC_VERSION_LEGACY = 1;
+    SPEC_VERSION_SUPPORTS_EVENT_SOURCING = 2;
+    SPEC_VERSION_SUPPORTS_CBOR_QUEUE_TRANSPORT = 3;
+    SPEC_VERSION_SUPPORTS_ATTRIBUTES = 4;
+    SPEC_VERSION_SUPPORTS_COMPRESSION = 5;
+    SPEC_VERSION_SUPPORTS_SLOT_IDENTITY = 6;
+    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");
+  }
+});
+
 // ../world/dist/ulid.js
 var UlidSchema, workflowRunIdSchema, DEFAULT_TIMESTAMP_THRESHOLD_PAST_MS, DEFAULT_TIMESTAMP_THRESHOLD_FUTURE_MS;
 var init_ulid = __esm({
@@ -27540,7 +27554,7 @@ function SemanticConvention(...names) {
     value
   ]));
 }
-var WorkflowName, WorkflowOperation, WorkflowRunId, WorkflowRunStatus, WorkflowStartedAt, WorkflowEventsCount, WorkflowExecutionMode, WorkflowBundleCompileCacheHit, WorkflowReplayLoadSource, WorkflowParkedEventsCount, WorkflowParkedEventId, WorkflowParkedEventType, WorkflowArgumentsCount, WorkflowResultType, WorkflowTracePropagated, WorkflowVm, QuickJSOutcome, QuickJSEventsPreloaded, QuickJSEventsFetchedCount, QuickJSEventsFetchedPages, QuickJSPendingOpsCount, QuickJSInlineSteps, WorkflowTraceMode, WorkflowTurbo, WorkflowErrorName, WorkflowErrorMessage, WorkflowErrorCode, WorkflowStepsCreated, WorkflowHooksCreated, WorkflowWaitsCreated, WorkflowStepsFailedSerialization, WorkflowOwnedRecoverySteps, WorkflowBackstopWakesArmed, WorkflowDispatchRepublishSkipped, WorkflowRouteType, WorkflowRouteHandlerCached, WorkflowRouteInvocationCount, WorkflowRouteEntrypointAgeMs, WorkflowRouteModuleBodyInitMs, FaasInstance, StepName, StepId, StepAttempt, StepStatus, StepMaxRetries, StepTracePropagated, StepTtfsMs, StepStsoMs, StepRsfsMs, StepFinalSchedulingReplayMs, StepLatencyOptimizations, StepStartStrategy, StepSkipped, StepSkipReason, StepArgumentsCount, StepResultType, StepErrorName, StepErrorMessage, StepFatalError, StepRetryExhausted, StepRetryTimeoutSeconds, StepRetryWillRetry, MessagingSystem, MessagingDestinationName, MessagingMessageId, MessagingOperationType, MessagingBatchMessageCount, QueueOverheadMs, DeploymentId, WorkflowRunPinnedDeploymentId, WorkflowDeploymentMismatchRetryCount, WorkflowDeploymentMismatchRecovered, HookToken, HookId, HookFound, HookResilientResume, HookResumeCommitted, HookWakePublished, HookResilientResumeMaterialized, HookResumeSetupSource, StepResilientDispatchRecovered, StepResilientDispatchMaterialized, StepDispatchPrologue, ResumeTotalMs, ResumeProducerPrepMs, ResumeQueueDeliveryMs, ResumeSetupMs, ResumeReplayMs, ResumeStepDispatchMs, ResumeStepClaimMs, ResumeStepPrepareMs, ResumeTrigger, ResumeStrategy, ResumeSetupSource, ResumeStepExecution, WebhookHandlersTriggered, WorkflowSuspensionState, WorkflowSuspensionHookCount, WorkflowSuspensionStepCount, WorkflowSuspensionWaitCount, HttpRequestMethod, HttpRoute, UrlFull, ServerAddress, ServerPort, HttpResponseStatusCode, ErrorType, WorldParseFormat, WorkflowEventsPagesLoaded, QueueDeserializeTimeMs, QueueExecutionTimeMs, QueueSerializeTimeMs, SerializationOperation, SerializationCompressed, SerializationCodec, SerializationUncompressedBytes, SerializationStoredBytes, SerializationCompressionRatio, SerializationGuestCodeExecutions, SerializationGuestCodeDetails, PeerService, RpcSystem, RpcService, RpcMethod, ErrorRetryable, ErrorCategory;
+var WorkflowName, WorkflowOperation, WorkflowRunId, WorkflowRunStatus, WorkflowStartedAt, WorkflowEventsCount, WorkflowExecutionMode, WorkflowBundleCompileCacheHit, WorkflowReplayLoadSource, WorkflowParkedEventsCount, WorkflowParkedEventId, WorkflowParkedEventType, WorkflowArgumentsCount, WorkflowResultType, WorkflowTracePropagated, WorkflowVm, QuickJSOutcome, QuickJSEventsPreloaded, QuickJSEventsFetchedCount, QuickJSEventsFetchedPages, QuickJSPendingOpsCount, QuickJSInlineSteps, WorkflowTraceMode, WorkflowTurbo, WorkflowErrorName, WorkflowErrorMessage, WorkflowErrorCode, WorkflowStepsCreated, WorkflowHooksCreated, WorkflowWaitsCreated, WorkflowStepsFailedSerialization, WorkflowOwnedRecoverySteps, WorkflowBackstopWakesArmed, WorkflowDispatchRepublishSkipped, WorkflowRouteType, WorkflowRouteHandlerCached, WorkflowRouteInvocationCount, WorkflowRouteEntrypointAgeMs, WorkflowRouteModuleBodyInitMs, FaasInstance, StepName, StepId, StepAttempt, StepStatus, StepMaxRetries, StepTracePropagated, StepTtfsMs, StepStsoMs, StepRsfsMs, StepFinalSchedulingReplayMs, StepLatencyOptimizations, StepStartStrategy, StepSkipped, StepSkipReason, StepArgumentsCount, StepResultType, StepErrorName, StepErrorMessage, StepFatalError, StepRetryExhausted, StepRetryTimeoutSeconds, StepRetryWillRetry, MessagingSystem, MessagingDestinationName, MessagingMessageId, MessagingOperationType, MessagingBatchMessageCount, QueueOverheadMs, DeploymentId, WorkflowRunPinnedDeploymentId, WorkflowDeploymentMismatchRetryCount, WorkflowDeploymentMismatchRecovered, WorkflowRunSpecVersion, WorkflowRunSpecVersionSource, WorkflowCapabilityProbeLatencyMs, WorkflowCapabilityProbeCached, WorkflowCapabilityProbeError, HookToken, HookId, HookFound, HookResilientResume, HookResumeCommitted, HookWakePublished, HookResilientResumeMaterialized, HookResumeSetupSource, StepResilientDispatchRecovered, StepResilientDispatchMaterialized, StepDispatchPrologue, ResumeTotalMs, ResumeProducerPrepMs, ResumeQueueDeliveryMs, ResumeSetupMs, ResumeReplayMs, ResumeStepDispatchMs, ResumeStepClaimMs, ResumeStepPrepareMs, ResumeTrigger, ResumeStrategy, ResumeSetupSource, ResumeStepExecution, WebhookHandlersTriggered, WorkflowSuspensionState, WorkflowSuspensionHookCount, WorkflowSuspensionStepCount, WorkflowSuspensionWaitCount, HttpRequestMethod, HttpRoute, UrlFull, ServerAddress, ServerPort, HttpResponseStatusCode, ErrorType, WorldParseFormat, WorkflowEventsPagesLoaded, QueueDeserializeTimeMs, QueueExecutionTimeMs, QueueSerializeTimeMs, SerializationOperation, SerializationCompressed, SerializationCodec, SerializationUncompressedBytes, SerializationStoredBytes, SerializationCompressionRatio, SerializationGuestCodeExecutions, SerializationGuestCodeDetails, PeerService, RpcSystem, RpcService, RpcMethod, ErrorRetryable, ErrorCategory;
 var init_semantic_conventions = __esm({
   "../core/dist/telemetry/semantic-conventions.js"() {
     "use strict";
@@ -27617,6 +27631,11 @@ var init_semantic_conventions = __esm({
     WorkflowRunPinnedDeploymentId = SemanticConvention("workflow.deployment.pinned_id");
     WorkflowDeploymentMismatchRetryCount = SemanticConvention("workflow.deployment_mismatch.retry_count");
     WorkflowDeploymentMismatchRecovered = SemanticConvention("workflow.deployment_mismatch.recovered");
+    WorkflowRunSpecVersion = SemanticConvention("workflow.run.spec_version");
+    WorkflowRunSpecVersionSource = SemanticConvention("workflow.run.spec_version_source");
+    WorkflowCapabilityProbeLatencyMs = SemanticConvention("workflow.capability_probe.latency_ms");
+    WorkflowCapabilityProbeCached = SemanticConvention("workflow.capability_probe.cached");
+    WorkflowCapabilityProbeError = SemanticConvention("workflow.capability_probe.error");
     HookToken = SemanticConvention("workflow.hook.token");
     HookId = SemanticConvention("workflow.hook.id");
     HookFound = SemanticConvention("workflow.hook.found");
@@ -32295,7 +32314,7 @@ var version2;
 var init_version = __esm({
   "../core/dist/version.js"() {
     "use strict";
-    version2 = "5.0.0-beta.56";
+    version2 = "5.0.0-beta.57";
   }
 });
 
@@ -32363,7 +32382,8 @@ function parseHealthCheckResponse(chunks) {
   } catch {
     if (responseText.length > 0) {
       return {
-        healthy: true
+        healthy: true,
+        format: "text"
       };
     }
     return null;
@@ -32373,7 +32393,8 @@ function parseHealthCheckResponse(chunks) {
   }
   const r = response;
   const parsed = {
-    healthy: r.healthy
+    healthy: r.healthy,
+    format: "json"
   };
   if (typeof r.specVersion === "number") {
     parsed.specVersion = r.specVersion;
@@ -32507,7 +32528,7 @@ async function publishHookWakeWithRetry(publish, isDeploymentUnavailableError) {
   }
   throw lastError;
 }
-var HOOK_WAKE_RETRY_DELAYS_MS;
+var HOOK_WAKE_RETRY_DELAYS_MS, FORCE_CLAIM_WAKE_REPUBLISH_WINDOW_MS;
 var init_hook_wake = __esm({
   "../core/dist/runtime/hook-wake.js"() {
     "use strict";
@@ -32521,6 +32542,7 @@ var init_hook_wake = __esm({
     ];
     __name(isRetryableWakeError, "isRetryableWakeError");
     __name(publishHookWakeWithRetry, "publishHookWakeWithRetry");
+    FORCE_CLAIM_WAKE_REPUBLISH_WINDOW_MS = 24 * 60 * 60 * 1e3;
   }
 });
 
@@ -32556,6 +32578,18 @@ var init_invocations = __esm({
   }
 });
 
+// ../core/dist/runtime/run-spec-version.js
+function specVersionForRunWrite(runSpecVersion, whenUnknown = SPEC_VERSION_CURRENT) {
+  return Math.min(SPEC_VERSION_CURRENT, runSpecVersion ?? whenUnknown);
+}
+var init_run_spec_version = __esm({
+  "../core/dist/runtime/run-spec-version.js"() {
+    "use strict";
+    init_spec_version();
+    __name(specVersionForRunWrite, "specVersionForRunWrite");
+  }
+});
+
 // ../../node_modules/.pnpm/@vercel+functions@3.8.0_@aws-sdk+credential-provider-web-identity@3.972.49_ws@8.20.0/node_modules/@vercel/functions/headers.js
 var require_headers = __commonJS({
   "../../node_modules/.pnpm/@vercel+functions@3.8.0_@aws-sdk+credential-provider-web-identity@3.972.49_ws@8.20.0/node_modules/@vercel/functions/headers.js"(exports, module) {
@@ -37807,7 +37841,8 @@ async function resumeHookAttempt(world, span, tokenOrHook, payload, encryptionKe
     try {
       await world.events.create(hook.runId, {
         eventType: "hook_received",
-        specVersion: SPEC_VERSION_CURRENT,
+        // The payload is already encoded for the run (see `compression`).
+        specVersion: specVersionForRunWrite(resumeContext.runSpecVersion),
         correlationId: hook.hookId,
         eventData: {
           ...v1Compat ? {} : {
@@ -37924,6 +37959,7 @@ var init_resume_hook = __esm({
     init_helpers();
     init_hook_wake();
     init_invocations();
+    init_run_spec_version();
     init_wait_until();
     generateResumeId = monotonicFactory();
     __name(computeResumePayloadDigest, "computeResumePayloadDigest");
@@ -39378,13 +39414,13 @@ async function dehydrateStepReturnValue(value, runId, key, ops = [], global2 = g
     });
   }
 }
-async function hydrateRunError(value, runId, key, ops = [], global2 = globalThis, extraRevivers = {}) {
+async function hydrateRunError(value, runId, key, ops = [], global2 = globalThis, extraRevivers = {}, options) {
   const compressionStats = {};
   const decrypted = await decompress(await decrypt2(value, key), compressionStats);
   await recordCompression(compressionStats, "deserialize");
   if (!(decrypted instanceof Uint8Array)) {
     return unflatten(decrypted, {
-      ...getExternalRevivers(global2, ops, runId, key),
+      ...getExternalRevivers(global2, ops, runId, key, options),
       ...extraRevivers
     });
   }
@@ -39392,7 +39428,7 @@ async function hydrateRunError(value, runId, key, ops = [], global2 = globalThis
   if (format === SerializationFormat.DEVALUE_V1) {
     const str = new TextDecoder().decode(payload);
     return parse(str, {
-      ...getExternalRevivers(global2, ops, runId, key),
+      ...getExternalRevivers(global2, ops, runId, key, options),
       ...extraRevivers
     });
   }
@@ -39918,11 +39954,11 @@ __builtin_set_attributes.maxRetries = INTERNAL_ATTRIBUTES_MAX_ATTEMPTS - 1;
 init_dist2();
 init_dist3();
 init_env_config();
-init_spec_version();
 init_encryption2();
 init_serialization2();
 init_util2();
 init_get_world_lazy();
+init_run_spec_version();
 
 // ../core/dist/runtime/runs.js
 init_dist2();
@@ -39930,6 +39966,7 @@ init_dist4();
 init_encryption2();
 init_serialization2();
 init_helpers();
+init_run_spec_version();
 
 // ../core/dist/runtime/start.js
 init_dist2();
@@ -40047,8 +40084,34 @@ __name(getWorkflowVmFromEnv, "getWorkflowVmFromEnv");
 // ../core/dist/runtime/start.js
 init_wait_until();
 init_world_compatibility();
-var CROSS_DEPLOYMENT_CAPABILITY_PROBE_TIMEOUT_MS = 2e3;
+var CROSS_DEPLOYMENT_CAPABILITY_PROBE_TIMEOUT_MS = 1e4;
+var CROSS_DEPLOYMENT_PROBE_RETRY_TIMEOUT_MS = 2e3;
+var CROSS_DEPLOYMENT_PROBE_CACHE_TTL_MS = 10 * 6e4;
+var CROSS_DEPLOYMENT_PROBE_MISS_TTL_MS = 6e4;
+var CROSS_DEPLOYMENT_PROBE_CACHE_MAX_ENTRIES = 256;
 var RETENTION_ZERO_ATTRIBUTE_VALUE = "0";
+function resolveCrossDeploymentSpecVersion(probe, callerSpecVersion) {
+  let target;
+  let source;
+  if (typeof probe?.specVersion === "number" && Number.isInteger(probe.specVersion) && probe.specVersion >= 1) {
+    target = probe.specVersion;
+    source = "probe";
+  } else if (probe?.format === "json") {
+    target = SPEC_VERSION_SUPPORTS_CBOR_QUEUE_TRANSPORT;
+    source = "probe-malformed";
+  } else if (probe?.healthy) {
+    target = SPEC_VERSION_SUPPORTS_EVENT_SOURCING;
+    source = "probe-unversioned";
+  } else {
+    target = SPEC_VERSION_SUPPORTS_SLOT_IDENTITY;
+    source = probe ? "probe-miss" : "no-probe-channel";
+  }
+  return {
+    specVersion: Math.min(target, callerSpecVersion),
+    source
+  };
+}
+__name(resolveCrossDeploymentSpecVersion, "resolveCrossDeploymentSpecVersion");
 var ulid3 = monotonicFactory();
 function resolveLineageAttributes() {
   const store = contextStorage.getStore();
@@ -40063,6 +40126,54 @@ __name(resolveLineageAttributes, "resolveLineageAttributes");
 var latestNoOpWarning = globalSingleton("@workflow/core//latestNoOpWarning", 1, () => ({
   warned: false
 }));
+var probeMissWarning = globalSingleton("@workflow/core//crossDeploymentProbeMissWarning", 1, () => ({
+  warned: false
+}));
+var crossDeploymentProbeCache = globalSingleton("@workflow/core//crossDeploymentProbeCache", 1, () => /* @__PURE__ */ new WeakMap());
+async function probeCrossDeployment(world, options) {
+  let byDeployment = crossDeploymentProbeCache.get(world);
+  if (!byDeployment) {
+    byDeployment = /* @__PURE__ */ new Map();
+    crossDeploymentProbeCache.set(world, byDeployment);
+  }
+  const key = `${options.namespace ?? ""}\0${options.deploymentId}`;
+  const now = Date.now();
+  const entry = byDeployment.get(key);
+  if (entry?.probe !== void 0 && now - entry.at < CROSS_DEPLOYMENT_PROBE_CACHE_TTL_MS) {
+    return {
+      probe: entry.probe,
+      cached: true
+    };
+  }
+  const recentMiss = entry !== void 0 && entry.probe === void 0 && now - entry.at < CROSS_DEPLOYMENT_PROBE_MISS_TTL_MS;
+  const probe = await healthCheck(world, {
+    deploymentId: options.deploymentId,
+    runId: options.runId,
+    timeout: recentMiss ? CROSS_DEPLOYMENT_PROBE_RETRY_TIMEOUT_MS : CROSS_DEPLOYMENT_CAPABILITY_PROBE_TIMEOUT_MS,
+    namespace: options.namespace
+  }).catch(() => void 0);
+  const answered = probe?.format !== void 0;
+  byDeployment.delete(key);
+  byDeployment.set(key, {
+    // A repeated miss keeps the first miss's time, so the short budget ends
+    // `CROSS_DEPLOYMENT_PROBE_MISS_TTL_MS` after it.
+    at: !answered && recentMiss ? entry.at : Date.now(),
+    // The run public key is per run, so it is never reused.
+    probe: answered ? {
+      ...probe,
+      encryptionPublicKey: void 0
+    } : void 0
+  });
+  if (byDeployment.size > CROSS_DEPLOYMENT_PROBE_CACHE_MAX_ENTRIES) {
+    const oldest = byDeployment.keys().next().value;
+    if (oldest !== void 0) byDeployment.delete(oldest);
+  }
+  return {
+    probe,
+    cached: false
+  };
+}
+__name(probeCrossDeployment, "probeCrossDeployment");
 async function start(workflow, argsOrOptions, options) {
   return await waitedUntil(() => {
     const workflowName = workflow?.workflowId;
@@ -40089,19 +40200,34 @@ async function start(workflow, argsOrOptions, options) {
       });
       const world = opts.world ?? await getWorldLazy();
       assertWorldSupportsRuntimeProtocol(world);
-      const currentDeploymentId = await world.getDeploymentId();
-      let deploymentId = opts.deploymentId ?? currentDeploymentId;
-      if (deploymentId === "latest") {
-        if (world.resolveLatestDeploymentId) {
-          deploymentId = await world.resolveLatestDeploymentId();
-        } else {
-          if (!latestNoOpWarning.warned) {
-            latestNoOpWarning.warned = true;
-            runtimeLogger.warn("deploymentId: 'latest' has no effect in this world and was ignored. It is only supported by worlds with atomic deployments, such as Vercel. The run will target the current deployment.", {
-              currentDeploymentId
-            });
+      let currentDeploymentId;
+      let deploymentId;
+      if (opts.deploymentId === void 0 || opts.deploymentId === "latest") {
+        const current = await world.getDeploymentId();
+        currentDeploymentId = current;
+        deploymentId = opts.deploymentId ?? current;
+        if (deploymentId === "latest") {
+          if (world.resolveLatestDeploymentId) {
+            deploymentId = await world.resolveLatestDeploymentId();
+          } else {
+            if (!latestNoOpWarning.warned) {
+              latestNoOpWarning.warned = true;
+              runtimeLogger.warn("deploymentId: 'latest' has no effect in this world and was ignored. It is only supported by worlds with atomic deployments, such as Vercel. The run will target the current deployment.", {
+                currentDeploymentId
+              });
+            }
+            deploymentId = current;
           }
-          deploymentId = currentDeploymentId;
+        }
+      } else {
+        deploymentId = opts.deploymentId;
+        try {
+          currentDeploymentId = await world.getDeploymentId();
+        } catch (err) {
+          runtimeLogger.debug("Current deployment is unavailable; starting as a cross-deployment run", {
+            deploymentId,
+            error: String(err)
+          });
         }
       }
       const runId = `wrun_${world.createRunId ? world.createRunId(opts) : ulid3()}`;
@@ -40109,36 +40235,61 @@ async function start(workflow, argsOrOptions, options) {
       let targetSupportsCompression;
       let targetHookResumeInputVersion;
       let probedRunPublicKey;
-      if (deploymentId === currentDeploymentId) {
+      let targetSpecVersion;
+      let specVersionSource;
+      const crossDeployment = deploymentId !== currentDeploymentId;
+      if (!crossDeployment) {
         framedByteStreams = true;
         targetSupportsCompression = true;
         targetHookResumeInputVersion = HOOK_RESUME_INPUT_VERSION;
+        targetSpecVersion = world.specVersion;
+        specVersionSource = "same-deployment";
       } else if (typeof world.streams?.get !== "function") {
         framedByteStreams = false;
         targetSupportsCompression = false;
         targetHookResumeInputVersion = void 0;
+        ({ specVersion: targetSpecVersion, source: specVersionSource } = resolveCrossDeploymentSpecVersion(void 0, world.specVersion));
       } else {
-        const probe = await healthCheck(world, {
+        const { probe, cached: cached2 } = await probeCrossDeployment(world, {
           deploymentId,
           runId,
-          timeout: CROSS_DEPLOYMENT_CAPABILITY_PROBE_TIMEOUT_MS,
           namespace: opts.namespace
-        }).catch(() => void 0);
+        });
         probedRunPublicKey = probe?.encryptionPublicKey;
         const capabilities = getRunCapabilities(probe?.workflowCoreVersion);
         framedByteStreams = capabilities.framedByteStreams;
         targetSupportsCompression = capabilities.supportedFormats.has(SerializationFormat.GZIP);
         targetHookResumeInputVersion = probe?.hookResumeInputVersion;
+        ({ specVersion: targetSpecVersion, source: specVersionSource } = resolveCrossDeploymentSpecVersion(probe, world.specVersion));
+        span?.setAttributes({
+          ...WorkflowCapabilityProbeCached(cached2),
+          ...!cached2 && probe?.latencyMs !== void 0 ? WorkflowCapabilityProbeLatencyMs(probe.latencyMs) : {},
+          ...!cached2 && probe?.error ? WorkflowCapabilityProbeError(probe.error) : {}
+        });
+        if (specVersionSource === "probe-miss" && opts.specVersion === void 0 && !probeMissWarning.warned) {
+          probeMissWarning.warned = true;
+          runtimeLogger.warn("The target deployment did not answer the capability probe, so the run was stamped with a fallback spec version instead of the target's own. A target on an older major version may not be able to execute it.", {
+            deploymentId,
+            specVersion: targetSpecVersion,
+            error: probe?.error
+          });
+        }
       }
       const ops = [];
       const traceCarrier = await serializeTraceCarrier();
-      const specVersion = opts.specVersion ?? world.specVersion;
+      const specVersion = opts.specVersion ?? targetSpecVersion;
+      if (opts.specVersion !== void 0) specVersionSource = "explicit";
+      span?.setAttributes({
+        ...WorkflowRunSpecVersion(specVersion),
+        ...WorkflowRunSpecVersionSource(specVersionSource)
+      });
+      const specGateError = /* @__PURE__ */ __name((featureRequires) => new WorkflowRuntimeError(crossDeployment && opts.specVersion === void 0 ? `${featureRequires} spec version ${SPEC_VERSION_SUPPORTS_ATTRIBUTES} or later, but the target deployment (${deploymentId}) runs spec version ${specVersion}.` : `${featureRequires} a World that supports spec version ${SPEC_VERSION_SUPPORTS_ATTRIBUTES} or later.`), "specGateError");
       const v1Compat = isLegacySpecVersion(specVersion);
       const allowReservedAttributes = opts.allowReservedAttributes === true;
       let attributes;
       if (opts.attributes && Object.keys(opts.attributes).length > 0) {
         if (specVersion < SPEC_VERSION_SUPPORTS_ATTRIBUTES) {
-          throw new WorkflowRuntimeError("Initial workflow attributes require a World that supports spec version 4 or later.");
+          throw specGateError("Initial workflow attributes require");
         }
         for (const [key, value] of Object.entries(opts.attributes)) {
           if (typeof value !== "string") {
@@ -40159,7 +40310,7 @@ async function start(workflow, argsOrOptions, options) {
           throw new WorkflowRuntimeError(`start({ experimental_retention }) must be 0 or 'default'; received ${JSON.stringify(opts.experimental_retention)}.`);
         }
         if (specVersion < SPEC_VERSION_SUPPORTS_ATTRIBUTES) {
-          throw new WorkflowRuntimeError("start({ experimental_retention }) requires a World that supports spec version 4 or later.");
+          throw specGateError("start({ experimental_retention }) requires");
         }
         retentionAttribute = {
           [RETENTION_ATTRIBUTE]: RETENTION_ZERO_ATTRIBUTE_VALUE
@@ -40319,7 +40470,7 @@ __name(start, "start");
     value: "start",
     configurable: true
   });
-})(start, "step//@workflow/core/runtime/start@5.0.0-beta.56//start");
+})(start, "step//@workflow/core/runtime/start@5.0.0-beta.57//start");
 
 // ../core/dist/runtime/runs.js
 async function wakeUpRun(world, runId, options) {
@@ -40361,7 +40512,7 @@ async function wakeUpRun(world, runId, options) {
       } : {
         eventType: "wait_completed",
         correlationId: waitEvent.correlationId,
-        specVersion: run2.specVersion,
+        specVersion: specVersionForRunWrite(run2.specVersion),
         eventData: {
           resumeAt: waitEvent.eventData.resumeAt
         }
@@ -40384,7 +40535,7 @@ async function wakeUpRun(world, runId, options) {
         runId
       }, {
         deploymentId: run2.deploymentId,
-        specVersion: run2.specVersion ?? SPEC_VERSION_LEGACY
+        specVersion: specVersionForRunWrite(run2.specVersion, SPEC_VERSION_LEGACY)
       });
     }
     if (errors.length > 0) {
@@ -40535,9 +40686,12 @@ var Run = class _Run {
    */
   async cancel(options) {
     const world = await this.#lazyWorldPromise;
+    const run2 = await world.runs.get(this.runId, {
+      resolveData: "none"
+    });
     await world.events.create(this.runId, {
       eventType: "run_cancelled",
-      specVersion: SPEC_VERSION_CURRENT,
+      specVersion: specVersionForRunWrite(run2.specVersion),
       ...options?.cancelReason !== void 0 ? {
         eventData: {
           cancelReason: options.cancelReason
@@ -40790,7 +40944,7 @@ var Run = class _Run {
     value: "wakeUp",
     configurable: true
   });
-})(Run.prototype["wakeUp"], "step//@workflow/core/runtime/run@5.0.0-beta.56//Run#wakeUp");
+})(Run.prototype["wakeUp"], "step//@workflow/core/runtime/run@5.0.0-beta.57//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);
@@ -40799,7 +40953,7 @@ var Run = class _Run {
     value: "cancel",
     configurable: true
   });
-})(Run.prototype["cancel"], "step//@workflow/core/runtime/run@5.0.0-beta.56//Run#cancel");
+})(Run.prototype["cancel"], "step//@workflow/core/runtime/run@5.0.0-beta.57//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);
@@ -40808,7 +40962,7 @@ var Run = class _Run {
     value: "getReadable",
     configurable: true
   });
-})(Run.prototype["getReadable"], "step//@workflow/core/runtime/run@5.0.0-beta.56//Run#getReadable");
+})(Run.prototype["getReadable"], "step//@workflow/core/runtime/run@5.0.0-beta.57//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);
@@ -40817,7 +40971,7 @@ var Run = class _Run {
     value: "getWritable",
     configurable: true
   });
-})(Run.prototype["getWritable"], "step//@workflow/core/runtime/run@5.0.0-beta.56//Run#getWritable");
+})(Run.prototype["getWritable"], "step//@workflow/core/runtime/run@5.0.0-beta.57//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);
@@ -40826,7 +40980,7 @@ var Run = class _Run {
     value: "exists",
     configurable: true
   });
-})(Object.getOwnPropertyDescriptor(Run.prototype, "exists").get, "step//@workflow/core/runtime/run@5.0.0-beta.56//Run#exists");
+})(Object.getOwnPropertyDescriptor(Run.prototype, "exists").get, "step//@workflow/core/runtime/run@5.0.0-beta.57//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);
@@ -40835,7 +40989,7 @@ var Run = class _Run {
     value: "status",
     configurable: true
   });
-})(Object.getOwnPropertyDescriptor(Run.prototype, "status").get, "step//@workflow/core/runtime/run@5.0.0-beta.56//Run#status");
+})(Object.getOwnPropertyDescriptor(Run.prototype, "status").get, "step//@workflow/core/runtime/run@5.0.0-beta.57//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);
@@ -40844,7 +40998,7 @@ var Run = class _Run {
     value: "returnValue",
     configurable: true
   });
-})(Object.getOwnPropertyDescriptor(Run.prototype, "returnValue").get, "step//@workflow/core/runtime/run@5.0.0-beta.56//Run#returnValue");
+})(Object.getOwnPropertyDescriptor(Run.prototype, "returnValue").get, "step//@workflow/core/runtime/run@5.0.0-beta.57//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);
@@ -40853,7 +41007,7 @@ var Run = class _Run {
     value: "workflowName",
     configurable: true
   });
-})(Object.getOwnPropertyDescriptor(Run.prototype, "workflowName").get, "step//@workflow/core/runtime/run@5.0.0-beta.56//Run#workflowName");
+})(Object.getOwnPropertyDescriptor(Run.prototype, "workflowName").get, "step//@workflow/core/runtime/run@5.0.0-beta.57//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);
@@ -40862,7 +41016,7 @@ var Run = class _Run {
     value: "createdAt",
     configurable: true
   });
-})(Object.getOwnPropertyDescriptor(Run.prototype, "createdAt").get, "step//@workflow/core/runtime/run@5.0.0-beta.56//Run#createdAt");
+})(Object.getOwnPropertyDescriptor(Run.prototype, "createdAt").get, "step//@workflow/core/runtime/run@5.0.0-beta.57//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);
@@ -40871,7 +41025,7 @@ var Run = class _Run {
     value: "startedAt",
     configurable: true
   });
-})(Object.getOwnPropertyDescriptor(Run.prototype, "startedAt").get, "step//@workflow/core/runtime/run@5.0.0-beta.56//Run#startedAt");
+})(Object.getOwnPropertyDescriptor(Run.prototype, "startedAt").get, "step//@workflow/core/runtime/run@5.0.0-beta.57//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);
@@ -40880,7 +41034,7 @@ var Run = class _Run {
     value: "completedAt",
     configurable: true
   });
-})(Object.getOwnPropertyDescriptor(Run.prototype, "completedAt").get, "step//@workflow/core/runtime/run@5.0.0-beta.56//Run#completedAt");
+})(Object.getOwnPropertyDescriptor(Run.prototype, "completedAt").get, "step//@workflow/core/runtime/run@5.0.0-beta.57//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);
@@ -40890,7 +41044,7 @@ var Run = class _Run {
     enumerable: false,
     configurable: false
   });
-})(Run, "class//@workflow/core/runtime/run@5.0.0-beta.56//Run");
+})(Run, "class//@workflow/core/runtime/run@5.0.0-beta.57//Run");
 
 // ../workflow/dist/stdlib.js
 async function fetch2(...args) {