@workflow/world-testing 5.0.0-beta.34 → 5.0.0-beta.36

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

@@ -356,6 +356,8 @@ var init_error_codes = __esm({
       REPLAY_DIVERGENCE: "REPLAY_DIVERGENCE",
       /** Run exceeded the maximum number of queue deliveries */
       MAX_DELIVERIES_EXCEEDED: "MAX_DELIVERIES_EXCEEDED",
+      /** Run exceeded the maximum number of events per run */
+      MAX_EVENTS_EXCEEDED: "MAX_EVENTS_EXCEEDED",
       /** Workflow replay exceeded the maximum allowed duration */
       REPLAY_TIMEOUT: "REPLAY_TIMEOUT",
       /** World response violated the SDK contract and cannot be retried safely */
@@ -16451,12 +16453,14 @@ function validateAttributeChanges(changes, context = {}) {
     throw new AttributeValidationError(`Run attribute count would exceed limit ${ATTRIBUTE_MAX_PER_RUN} (post-merge ${postMerge})`);
   }
 }
-var RESERVED_ATTRIBUTE_KEY_PREFIX, ATTRIBUTE_KEY_MAX_LENGTH, ATTRIBUTE_VALUE_MAX_BYTES, ATTRIBUTE_MAX_PER_RUN, AttributeChangeSchema, AttributeChangesSchema, AttributeValidationError, valueByteLength;
+var RESERVED_ATTRIBUTE_KEY_PREFIX, ROOT_RUN_ID_ATTRIBUTE, PARENT_RUN_ID_ATTRIBUTE, ATTRIBUTE_KEY_MAX_LENGTH, ATTRIBUTE_VALUE_MAX_BYTES, ATTRIBUTE_MAX_PER_RUN, AttributeChangeSchema, AttributeChangesSchema, AttributeValidationError, valueByteLength;
 var init_attributes = __esm({
   "../world/dist/attributes.js"() {
     "use strict";
     init_zod();
     RESERVED_ATTRIBUTE_KEY_PREFIX = "$";
+    ROOT_RUN_ID_ATTRIBUTE = `${RESERVED_ATTRIBUTE_KEY_PREFIX}rootRunId`;
+    PARENT_RUN_ID_ATTRIBUTE = `${RESERVED_ATTRIBUTE_KEY_PREFIX}parentRunId`;
     ATTRIBUTE_KEY_MAX_LENGTH = 256;
     ATTRIBUTE_VALUE_MAX_BYTES = 256;
     ATTRIBUTE_MAX_PER_RUN = 64;
@@ -16619,6 +16623,17 @@ var init_events = __esm({
       // stso.
       stepCount: external_exports.number().int().positive().optional(),
       eventCount: external_exports.number().int().positive().optional(),
+      // Run-started-to-first-step: milliseconds from the `run_started` response
+      // landing (or, under turbo, the local run synthesis instant) until this
+      // step's start POST was issued. A sub-window of ttfs. Only reported
+      // alongside the same eligibility as ttfs.
+      rsfs: external_exports.number().optional(),
+      // Synchronous workflow-function replay duration of only the FINAL replay
+      // pass within the rsfs window (the pass that scheduled the first step),
+      // excluding awaited network I/O — not accumulated across earlier
+      // pre-first-step passes, so it is not "the replay portion of rsfs". Only
+      // present alongside rsfs, and only for the run's first step.
+      finalSchedulingReplay: external_exports.number().optional(),
       // Names of the runtime's optional startup-latency optimizations that were
       // active for this measurement (e.g. 'turbo', 'lazyStepStart',
       // 'optimisticStart'), so latency metrics can be segmented by them.
@@ -16700,6 +16715,7 @@ var init_events = __esm({
       correlationId: external_exports.string(),
       eventData: external_exports.object({
         token: external_exports.string(),
+        tokenRetentionUntil: external_exports.coerce.date().optional(),
         metadata: SerializedDataSchema.optional(),
         isWebhook: external_exports.boolean().optional(),
         isSystem: external_exports.boolean().optional()
@@ -16869,6 +16885,9 @@ var init_events = __esm({
 });
 
 // ../world/dist/runs.js
+function isTerminalWorkflowRunStatus(status) {
+  return TERMINAL_WORKFLOW_RUN_STATUSES.includes(status);
+}
 var WorkflowRunStatusSchema, TerminalWorkflowRunStatusSchema, TERMINAL_WORKFLOW_RUN_STATUSES, WorkflowRunBaseSchema, WorkflowRunSchema;
 var init_runs = __esm({
   "../world/dist/runs.js"() {
@@ -16888,6 +16907,7 @@ var init_runs = __esm({
       "cancelled"
     ]);
     TERMINAL_WORKFLOW_RUN_STATUSES = TerminalWorkflowRunStatusSchema.options;
+    __name(isTerminalWorkflowRunStatus, "isTerminalWorkflowRunStatus");
     WorkflowRunBaseSchema = external_exports.object({
       runId: external_exports.string(),
       status: WorkflowRunStatusSchema,
@@ -18310,6 +18330,28 @@ var init_devalue = __esm({
   }
 });
 
+// ../core/dist/symbols.js
+var STABLE_ULID, STREAM_NAME_SYMBOL, STREAM_TYPE_SYMBOL, STREAM_FRAMING_SYMBOL, STREAM_SERVER_RUN_ID_SYMBOL, STREAM_SERVER_DEPLOYMENT_ID_SYMBOL, STREAM_WRITE_BATCH_SYMBOL, BODY_INIT_SYMBOL, WEBHOOK_RESPONSE_WRITABLE, WORKFLOW_CLASS_REGISTRY, ABORT_STREAM_NAME, ABORT_HOOK_TOKEN, ABORT_LISTENER_ATTACHED, ABORT_READER_CANCEL;
+var init_symbols = __esm({
+  "../core/dist/symbols.js"() {
+    "use strict";
+    STABLE_ULID = /* @__PURE__ */ Symbol.for("WORKFLOW_STABLE_ULID");
+    STREAM_NAME_SYMBOL = /* @__PURE__ */ Symbol.for("WORKFLOW_STREAM_NAME");
+    STREAM_TYPE_SYMBOL = /* @__PURE__ */ Symbol.for("WORKFLOW_STREAM_TYPE");
+    STREAM_FRAMING_SYMBOL = /* @__PURE__ */ Symbol.for("WORKFLOW_STREAM_FRAMING");
+    STREAM_SERVER_RUN_ID_SYMBOL = /* @__PURE__ */ Symbol.for("WORKFLOW_STREAM_SERVER_RUN_ID");
+    STREAM_SERVER_DEPLOYMENT_ID_SYMBOL = /* @__PURE__ */ Symbol.for("WORKFLOW_STREAM_SERVER_DEPLOYMENT_ID");
+    STREAM_WRITE_BATCH_SYMBOL = /* @__PURE__ */ Symbol.for("WORKFLOW_STREAM_WRITE_BATCH");
+    BODY_INIT_SYMBOL = /* @__PURE__ */ Symbol.for("BODY_INIT");
+    WEBHOOK_RESPONSE_WRITABLE = /* @__PURE__ */ Symbol.for("WEBHOOK_RESPONSE_WRITABLE");
+    WORKFLOW_CLASS_REGISTRY = /* @__PURE__ */ Symbol.for("workflow-class-registry");
+    ABORT_STREAM_NAME = /* @__PURE__ */ Symbol.for("WORKFLOW_ABORT_STREAM_NAME");
+    ABORT_HOOK_TOKEN = /* @__PURE__ */ Symbol.for("WORKFLOW_ABORT_HOOK_TOKEN");
+    ABORT_LISTENER_ATTACHED = /* @__PURE__ */ Symbol.for("WORKFLOW_ABORT_LISTENER_ATTACHED");
+    ABORT_READER_CANCEL = /* @__PURE__ */ Symbol.for("WORKFLOW_ABORT_READER_CANCEL");
+  }
+});
+
 // ../core/dist/flushable-stream.js
 function createFlushableState() {
   const state = {
@@ -18390,7 +18432,11 @@ function pollReadableLock(readable, state) {
   }, getLockPollIntervalMs());
   state.readablePollingInterval = intervalId;
 }
-async function flushablePipe(source, sink, state) {
+function flushablePipe(source, sink, state) {
+  const batchWrite = sink[STREAM_WRITE_BATCH_SYMBOL];
+  return typeof batchWrite === "function" ? flushablePipeCoalescing(source, sink, state, batchWrite) : flushablePipePerChunk(source, sink, state);
+}
+async function flushablePipePerChunk(source, sink, state) {
   const reader = source.getReader();
   const writer = sink.getWriter();
   let cancelReason;
@@ -18439,13 +18485,142 @@ async function flushablePipe(source, sink, state) {
     writer.releaseLock();
   }
 }
-var LOCK_POLL_INTERVAL_MS, getLockPollIntervalMs;
+function wake(ctx, which) {
+  const resolve = ctx[which];
+  if (resolve) {
+    ctx[which] = null;
+    resolve();
+  }
+}
+function nextBatchSize(ctx) {
+  let count2 = 0;
+  let bytes = 0;
+  for (const chunk of ctx.queue) {
+    if (count2 >= ctx.maxChunksPerBatch) break;
+    if (count2 > 0 && bytes + chunk.byteLength > ctx.maxBytesPerBatch) break;
+    count2++;
+    bytes += chunk.byteLength;
+  }
+  return count2;
+}
+async function drainBatches(ctx) {
+  while (true) {
+    if (ctx.queue.length === 0) {
+      if (ctx.sourceDone) return;
+      await new Promise((resolve) => {
+        ctx.wakeConsumer = resolve;
+      });
+      continue;
+    }
+    const count2 = nextBatchSize(ctx);
+    const batch = ctx.queue.slice(0, count2);
+    ctx.queue = ctx.queue.slice(count2);
+    await ctx.batchWrite(batch);
+    ctx.state.pendingOps -= batch.length;
+    wake(ctx, "wakeProducer");
+  }
+}
+function readNextChunk(reader, writer, consumer) {
+  return Promise.race([
+    reader.read(),
+    writer.closed.then(() => {
+      throw new WorkflowRuntimeError("Writable stream closed prematurely");
+    }),
+    consumer.then(() => {
+      throw new WorkflowRuntimeError("Stream consumer ended prematurely");
+    }, (err) => {
+      throw err;
+    })
+  ]);
+}
+async function awaitBackpressureRelief(ctx, consumer, maxInflight) {
+  if (ctx.state.pendingOps < maxInflight) return;
+  await Promise.race([
+    new Promise((resolve) => {
+      ctx.wakeProducer = resolve;
+    }),
+    consumer.then(() => void 0, () => void 0)
+  ]);
+}
+async function flushablePipeCoalescing(source, sink, state, batchWrite) {
+  const reader = source.getReader();
+  const writer = sink.getWriter();
+  const maxInflight = getMaxInflightChunks();
+  let cancelReason;
+  const ctx = {
+    state,
+    batchWrite,
+    queue: [],
+    sourceDone: false,
+    wakeConsumer: null,
+    wakeProducer: null,
+    maxChunksPerBatch: getMaxChunksPerBatch(),
+    maxBytesPerBatch: getMaxBytesPerBatch()
+  };
+  const consumer = drainBatches(ctx);
+  try {
+    while (!state.streamEnded) {
+      const readResult = await readNextChunk(reader, writer, consumer);
+      if (state.streamEnded) return;
+      if (readResult.done) {
+        ctx.sourceDone = true;
+        wake(ctx, "wakeConsumer");
+        await consumer;
+        state.streamEnded = true;
+        await writer.close();
+        if (!state.doneResolved) {
+          state.doneResolved = true;
+          state.resolve();
+        }
+        return;
+      }
+      ctx.queue.push(readResult.value);
+      state.pendingOps++;
+      wake(ctx, "wakeConsumer");
+      await awaitBackpressureRelief(ctx, consumer, maxInflight);
+    }
+  } catch (err) {
+    state.streamEnded = true;
+    cancelReason = err;
+    ctx.sourceDone = true;
+    wake(ctx, "wakeConsumer");
+    await consumer.catch(() => {
+    });
+    if (!state.doneResolved) {
+      state.doneResolved = true;
+      state.reject(err);
+    }
+    throw err;
+  } finally {
+    reader.cancel(cancelReason).catch(() => {
+    });
+    reader.releaseLock();
+    writer.releaseLock();
+  }
+}
+var MAX_INFLIGHT_CHUNKS, getMaxInflightChunks, MAX_CHUNKS_PER_BATCH, getMaxChunksPerBatch, MAX_BYTES_PER_BATCH, getMaxBytesPerBatch, LOCK_POLL_INTERVAL_MS, getLockPollIntervalMs;
 var init_flushable_stream = __esm({
   "../core/dist/flushable-stream.js"() {
     "use strict";
     init_dist2();
     init_dist();
     init_dist4();
+    init_symbols();
+    MAX_INFLIGHT_CHUNKS = 1e3;
+    getMaxInflightChunks = /* @__PURE__ */ __name(() => envNumber("WORKFLOW_STREAM_MAX_INFLIGHT_CHUNKS", MAX_INFLIGHT_CHUNKS, {
+      integer: true,
+      min: 1
+    }), "getMaxInflightChunks");
+    MAX_CHUNKS_PER_BATCH = 1e3;
+    getMaxChunksPerBatch = /* @__PURE__ */ __name(() => envNumber("WORKFLOW_STREAM_MAX_CHUNKS_PER_BATCH", MAX_CHUNKS_PER_BATCH, {
+      integer: true,
+      min: 1
+    }), "getMaxChunksPerBatch");
+    MAX_BYTES_PER_BATCH = 1024 * 1024;
+    getMaxBytesPerBatch = /* @__PURE__ */ __name(() => envNumber("WORKFLOW_STREAM_MAX_BYTES_PER_BATCH", MAX_BYTES_PER_BATCH, {
+      integer: true,
+      min: 1
+    }), "getMaxBytesPerBatch");
     LOCK_POLL_INTERVAL_MS = 10;
     getLockPollIntervalMs = /* @__PURE__ */ __name(() => envNumber("WORKFLOW_LOCK_POLL_INTERVAL_MS", LOCK_POLL_INTERVAL_MS, {
       integer: true,
@@ -18457,6 +18632,13 @@ var init_flushable_stream = __esm({
     __name(pollWritableLock, "pollWritableLock");
     __name(pollReadableLock, "pollReadableLock");
     __name(flushablePipe, "flushablePipe");
+    __name(flushablePipePerChunk, "flushablePipePerChunk");
+    __name(wake, "wake");
+    __name(nextBatchSize, "nextBatchSize");
+    __name(drainBatches, "drainBatches");
+    __name(readNextChunk, "readNextChunk");
+    __name(awaitBackpressureRelief, "awaitBackpressureRelief");
+    __name(flushablePipeCoalescing, "flushablePipeCoalescing");
   }
 });
 
@@ -18585,27 +18767,6 @@ var init_get_world_lazy = __esm({
   }
 });
 
-// ../core/dist/symbols.js
-var STABLE_ULID, STREAM_NAME_SYMBOL, STREAM_TYPE_SYMBOL, STREAM_FRAMING_SYMBOL, STREAM_SERVER_RUN_ID_SYMBOL, STREAM_SERVER_DEPLOYMENT_ID_SYMBOL, BODY_INIT_SYMBOL, WEBHOOK_RESPONSE_WRITABLE, WORKFLOW_CLASS_REGISTRY, ABORT_STREAM_NAME, ABORT_HOOK_TOKEN, ABORT_LISTENER_ATTACHED, ABORT_READER_CANCEL;
-var init_symbols = __esm({
-  "../core/dist/symbols.js"() {
-    "use strict";
-    STABLE_ULID = /* @__PURE__ */ Symbol.for("WORKFLOW_STABLE_ULID");
-    STREAM_NAME_SYMBOL = /* @__PURE__ */ Symbol.for("WORKFLOW_STREAM_NAME");
-    STREAM_TYPE_SYMBOL = /* @__PURE__ */ Symbol.for("WORKFLOW_STREAM_TYPE");
-    STREAM_FRAMING_SYMBOL = /* @__PURE__ */ Symbol.for("WORKFLOW_STREAM_FRAMING");
-    STREAM_SERVER_RUN_ID_SYMBOL = /* @__PURE__ */ Symbol.for("WORKFLOW_STREAM_SERVER_RUN_ID");
-    STREAM_SERVER_DEPLOYMENT_ID_SYMBOL = /* @__PURE__ */ Symbol.for("WORKFLOW_STREAM_SERVER_DEPLOYMENT_ID");
-    BODY_INIT_SYMBOL = /* @__PURE__ */ Symbol.for("BODY_INIT");
-    WEBHOOK_RESPONSE_WRITABLE = /* @__PURE__ */ Symbol.for("WEBHOOK_RESPONSE_WRITABLE");
-    WORKFLOW_CLASS_REGISTRY = /* @__PURE__ */ Symbol.for("workflow-class-registry");
-    ABORT_STREAM_NAME = /* @__PURE__ */ Symbol.for("WORKFLOW_ABORT_STREAM_NAME");
-    ABORT_HOOK_TOKEN = /* @__PURE__ */ Symbol.for("WORKFLOW_ABORT_HOOK_TOKEN");
-    ABORT_LISTENER_ATTACHED = /* @__PURE__ */ Symbol.for("WORKFLOW_ABORT_LISTENER_ATTACHED");
-    ABORT_READER_CANCEL = /* @__PURE__ */ Symbol.for("WORKFLOW_ABORT_READER_CANCEL");
-  }
-});
-
 // ../core/dist/class-serialization.js
 function getRegistry(global2 = globalThis) {
   const g = global2;
@@ -19808,7 +19969,7 @@ function SemanticConvention(...names) {
     value
   ]));
 }
-var WorkflowName, WorkflowOperation, WorkflowRunId, WorkflowRunStatus, WorkflowStartedAt, WorkflowEventsCount, WorkflowArgumentsCount, WorkflowResultType, WorkflowTracePropagated, WorkflowTraceMode, WorkflowTurbo, WorkflowErrorName, WorkflowErrorMessage, WorkflowErrorCode, WorkflowStepsCreated, WorkflowHooksCreated, WorkflowWaitsCreated, WorkflowOwnedRecoverySteps, WorkflowBackstopWakesArmed, WorkflowRouteType, WorkflowRouteHandlerCached, WorkflowRouteInvocationCount, WorkflowRouteEntrypointAgeMs, WorkflowRouteModuleBodyInitMs, StepName, StepId, StepAttempt, StepStatus, StepMaxRetries, StepTracePropagated, StepTtfsMs, StepStsoMs, StepLatencyOptimizations, StepSkipped, StepSkipReason, StepArgumentsCount, StepResultType, StepErrorName, StepErrorMessage, StepFatalError, StepRetryExhausted, StepRetryTimeoutSeconds, StepRetryWillRetry, MessagingSystem, MessagingDestinationName, MessagingMessageId, MessagingOperationType, QueueOverheadMs, DeploymentId, HookToken, HookId, HookFound, WebhookHandlersTriggered, WorkflowSuspensionState, WorkflowSuspensionHookCount, WorkflowSuspensionStepCount, WorkflowSuspensionWaitCount, HttpRequestMethod, HttpRoute, UrlFull, ServerAddress, ServerPort, HttpResponseStatusCode, ErrorType, WorldParseFormat, WorkflowEventsPagesLoaded, QueueDeserializeTimeMs, QueueExecutionTimeMs, QueueSerializeTimeMs, SerializationOperation, SerializationCompressed, SerializationCodec, SerializationUncompressedBytes, SerializationStoredBytes, SerializationCompressionRatio, PeerService, RpcSystem, RpcService, RpcMethod, ErrorRetryable, ErrorCategory;
+var WorkflowName, WorkflowOperation, WorkflowRunId, WorkflowRunStatus, WorkflowStartedAt, WorkflowEventsCount, WorkflowArgumentsCount, WorkflowResultType, WorkflowTracePropagated, WorkflowTraceMode, WorkflowTurbo, WorkflowErrorName, WorkflowErrorMessage, WorkflowErrorCode, WorkflowStepsCreated, WorkflowHooksCreated, WorkflowWaitsCreated, WorkflowOwnedRecoverySteps, WorkflowBackstopWakesArmed, WorkflowRouteType, WorkflowRouteHandlerCached, WorkflowRouteInvocationCount, WorkflowRouteEntrypointAgeMs, WorkflowRouteModuleBodyInitMs, StepName, StepId, StepAttempt, StepStatus, StepMaxRetries, StepTracePropagated, StepTtfsMs, StepStsoMs, StepRsfsMs, StepFinalSchedulingReplayMs, StepLatencyOptimizations, StepSkipped, StepSkipReason, StepArgumentsCount, StepResultType, StepErrorName, StepErrorMessage, StepFatalError, StepRetryExhausted, StepRetryTimeoutSeconds, StepRetryWillRetry, MessagingSystem, MessagingDestinationName, MessagingMessageId, MessagingOperationType, QueueOverheadMs, DeploymentId, HookToken, HookId, HookFound, WebhookHandlersTriggered, WorkflowSuspensionState, WorkflowSuspensionHookCount, WorkflowSuspensionStepCount, WorkflowSuspensionWaitCount, HttpRequestMethod, HttpRoute, UrlFull, ServerAddress, ServerPort, HttpResponseStatusCode, ErrorType, WorldParseFormat, WorkflowEventsPagesLoaded, QueueDeserializeTimeMs, QueueExecutionTimeMs, QueueSerializeTimeMs, SerializationOperation, SerializationCompressed, SerializationCodec, SerializationUncompressedBytes, SerializationStoredBytes, SerializationCompressionRatio, PeerService, RpcSystem, RpcService, RpcMethod, ErrorRetryable, ErrorCategory;
 var init_semantic_conventions = __esm({
   "../core/dist/telemetry/semantic-conventions.js"() {
     "use strict";
@@ -19845,6 +20006,8 @@ var init_semantic_conventions = __esm({
     StepTracePropagated = SemanticConvention("step.trace.propagated");
     StepTtfsMs = SemanticConvention("step.ttfs_ms");
     StepStsoMs = SemanticConvention("step.stso_ms");
+    StepRsfsMs = SemanticConvention("step.rsfs_ms");
+    StepFinalSchedulingReplayMs = SemanticConvention("step.final_scheduling_replay_ms");
     StepLatencyOptimizations = SemanticConvention("step.latency_optimizations");
     StepSkipped = SemanticConvention("step.skipped");
     StepSkipReason = SemanticConvention("step.skip_reason");
@@ -24477,7 +24640,7 @@ var version2;
 var init_version = __esm({
   "../core/dist/version.js"() {
     "use strict";
-    version2 = "5.0.0-beta.34";
+    version2 = "5.0.0-beta.36";
   }
 });
 
@@ -25818,18 +25981,24 @@ __export(resume_hook_exports, {
   resumeHook: () => resumeHook,
   resumeWebhook: () => resumeWebhook
 });
-async function getHookByTokenWithKey(token) {
+async function getHookAndRun(token) {
   const world = await getWorldLazy();
   const hook = await world.hooks.getByToken(token);
   const run2 = await world.runs.get(hook.runId);
-  const rawKey = await world.getEncryptionKeyForRun?.(run2);
+  return {
+    hook,
+    run: run2
+  };
+}
+async function getHookByTokenWithKey(token) {
+  const { hook, run: run2 } = await getHookAndRun(token);
+  const rawKey = await (await getWorldLazy()).getEncryptionKeyForRun?.(run2);
   const encryptionKey = rawKey ? await importKey(rawKey) : void 0;
   if (typeof hook.metadata !== "undefined") {
     hook.metadata = await hydrateStepArguments(hook.metadata, hook.runId, encryptionKey);
   }
   return {
     hook,
-    run: run2,
     encryptionKey
   };
 }
@@ -25844,27 +26013,27 @@ async function resumeHook(tokenOrHook, payload, encryptionKeyOverride) {
       try {
         let hook;
         let workflowRun;
-        let encryptionKey;
         if (typeof tokenOrHook === "string") {
-          const result = await getHookByTokenWithKey(tokenOrHook);
+          const result = await getHookAndRun(tokenOrHook);
           hook = result.hook;
           workflowRun = result.run;
-          encryptionKey = encryptionKeyOverride ?? result.encryptionKey;
         } else {
           hook = tokenOrHook;
           workflowRun = await world.runs.get(hook.runId);
-          if (encryptionKeyOverride) {
-            encryptionKey = encryptionKeyOverride;
-          } else {
-            const rawKey = await world.getEncryptionKeyForRun?.(workflowRun);
-            encryptionKey = rawKey ? await importKey(rawKey) : void 0;
-          }
         }
         span?.setAttributes({
           ...HookToken(hook.token),
           ...HookId(hook.hookId),
           ...WorkflowRunId(hook.runId)
         });
+        if (isTerminalWorkflowRunStatus(workflowRun.status)) {
+          throw new HookNotFoundError(hook.token);
+        }
+        let encryptionKey = encryptionKeyOverride;
+        if (!encryptionKey) {
+          const rawKey = await world.getEncryptionKeyForRun?.(workflowRun);
+          encryptionKey = rawKey ? await importKey(rawKey) : void 0;
+        }
         const rawVersion = workflowRun.executionContext?.workflowCoreVersion;
         const capabilities = getRunCapabilities(typeof rawVersion === "string" ? rawVersion : void 0);
         if (!capabilities.supportedFormats.has(SerializationFormat.ENCRYPTED)) {
@@ -25976,6 +26145,7 @@ var init_resume_hook = __esm({
     init_get_world_lazy();
     init_helpers();
     init_wait_until();
+    __name(getHookAndRun, "getHookAndRun");
     __name(getHookByTokenWithKey, "getHookByTokenWithKey");
     __name(getHookByToken, "getHookByToken");
     __name(resumeHook, "resumeHook");
@@ -27078,9 +27248,6 @@ function getStepRevivers(global2 = globalThis, ops, runId, cryptoKey, deployment
     AbortSignal: /* @__PURE__ */ __name((value) => reviveAbortSignal(value, ops, runId), "AbortSignal")
   };
 }
-async function maybeDecrypt(data, key) {
-  return decrypt2(data, key);
-}
 async function dehydrateWorkflowArguments(value, runId, key, ops = [], global2 = globalThis, v1Compat = false, framedByteStreams = false, compression = false) {
   if (v1Compat) {
     const str = stringify(value, getExternalReducers(global2, ops, runId, key, framedByteStreams));
@@ -27181,7 +27348,7 @@ async function dehydrateStepReturnValue(value, runId, key, ops = [], global2 = g
 }
 async function hydrateRunError(value, runId, key, ops = [], global2 = globalThis, extraRevivers = {}) {
   const compressionStats = {};
-  const decrypted = await decompress(await maybeDecrypt(value, key), compressionStats);
+  const decrypted = await decompress(await decrypt2(value, key), compressionStats);
   await recordCompression(compressionStats, "deserialize");
   if (!(decrypted instanceof Uint8Array)) {
     return unflatten(decrypted, {
@@ -27458,6 +27625,16 @@ var init_serialization2 = __esm({
             for (const w of waiters) w.reject(abortError);
           }
         });
+        Object.defineProperty(this, STREAM_WRITE_BATCH_SYMBOL, {
+          value: /* @__PURE__ */ __name(async (chunks) => {
+            if (chunks.length === 0) return;
+            if (batchStartAt === void 0) batchStartAt = Date.now();
+            for (const chunk of chunks) buffer2.push(chunk);
+            await flush();
+          }, "value"),
+          enumerable: false,
+          writable: false
+        });
       }
     };
     __name(getAllBaseReducers, "getAllBaseReducers");
@@ -27476,7 +27653,6 @@ var init_serialization2 = __esm({
     __name(getForwardedWritableEncryptionKey, "getForwardedWritableEncryptionKey");
     __name(getExternalRevivers, "getExternalRevivers");
     __name(getStepRevivers, "getStepRevivers");
-    __name(maybeDecrypt, "maybeDecrypt");
     __name(dehydrateWorkflowArguments, "dehydrateWorkflowArguments");
     __name(hydrateWorkflowReturnValue, "hydrateWorkflowReturnValue");
     __name(dehydrateStepArguments, "dehydrateStepArguments");
@@ -27681,6 +27857,7 @@ __name(isRetryableWorldError, "isRetryableWorldError");
 init_encryption();
 init_logger();
 init_serialization2();
+init_context_storage();
 init_semantic_conventions();
 init_telemetry();
 init_version();
@@ -27690,6 +27867,16 @@ init_wait_until();
 init_world_compatibility();
 var CROSS_DEPLOYMENT_CAPABILITY_PROBE_TIMEOUT_MS = 2e3;
 var ulid3 = monotonicFactory();
+function resolveLineageAttributes() {
+  const store = contextStorage.getStore();
+  const parentRunId = store?.workflowMetadata?.workflowRunId;
+  if (!parentRunId) return void 0;
+  return {
+    [ROOT_RUN_ID_ATTRIBUTE]: store.rootRunId ?? parentRunId,
+    [PARENT_RUN_ID_ATTRIBUTE]: parentRunId
+  };
+}
+__name(resolveLineageAttributes, "resolveLineageAttributes");
 var hasWarnedLatestNoOp = false;
 async function start(workflow, argsOrOptions, options) {
   return await waitedUntil(() => {
@@ -27774,9 +27961,14 @@ async function start(workflow, argsOrOptions, options) {
           value
         ]));
       }
-      const attributeSeed = attributes ? {
-        attributes,
-        ...allowReservedAttributes ? {
+      const lineage = specVersion >= SPEC_VERSION_SUPPORTS_ATTRIBUTES ? resolveLineageAttributes() : void 0;
+      const runAttributes = lineage ? {
+        ...lineage,
+        ...attributes
+      } : attributes;
+      const attributeSeed = runAttributes ? {
+        attributes: runAttributes,
+        ...allowReservedAttributes || lineage != null ? {
           allowReservedAttributes: true
         } : {}
       } : {};
@@ -27890,7 +28082,7 @@ __name(start, "start");
     value: "start",
     configurable: true
   });
-})(start, "step//@workflow/core/runtime/start@5.0.0-beta.34//start");
+})(start, "step//@workflow/core/runtime/start@5.0.0-beta.36//start");
 
 // ../core/dist/runtime/runs.js
 async function wakeUpRun(world, runId, options) {
@@ -28226,7 +28418,7 @@ var Run = class _Run {
     value: "wakeUp",
     configurable: true
   });
-})(Run.prototype["wakeUp"], "step//@workflow/core/runtime/run@5.0.0-beta.34//Run#wakeUp");
+})(Run.prototype["wakeUp"], "step//@workflow/core/runtime/run@5.0.0-beta.36//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);
@@ -28235,7 +28427,7 @@ var Run = class _Run {
     value: "cancel",
     configurable: true
   });
-})(Run.prototype["cancel"], "step//@workflow/core/runtime/run@5.0.0-beta.34//Run#cancel");
+})(Run.prototype["cancel"], "step//@workflow/core/runtime/run@5.0.0-beta.36//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);
@@ -28244,7 +28436,7 @@ var Run = class _Run {
     value: "getReadable",
     configurable: true
   });
-})(Run.prototype["getReadable"], "step//@workflow/core/runtime/run@5.0.0-beta.34//Run#getReadable");
+})(Run.prototype["getReadable"], "step//@workflow/core/runtime/run@5.0.0-beta.36//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);
@@ -28253,7 +28445,7 @@ var Run = class _Run {
     value: "exists",
     configurable: true
   });
-})(Object.getOwnPropertyDescriptor(Run.prototype, "exists").get, "step//@workflow/core/runtime/run@5.0.0-beta.34//Run#exists");
+})(Object.getOwnPropertyDescriptor(Run.prototype, "exists").get, "step//@workflow/core/runtime/run@5.0.0-beta.36//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);
@@ -28262,7 +28454,7 @@ var Run = class _Run {
     value: "status",
     configurable: true
   });
-})(Object.getOwnPropertyDescriptor(Run.prototype, "status").get, "step//@workflow/core/runtime/run@5.0.0-beta.34//Run#status");
+})(Object.getOwnPropertyDescriptor(Run.prototype, "status").get, "step//@workflow/core/runtime/run@5.0.0-beta.36//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);
@@ -28271,7 +28463,7 @@ var Run = class _Run {
     value: "returnValue",
     configurable: true
   });
-})(Object.getOwnPropertyDescriptor(Run.prototype, "returnValue").get, "step//@workflow/core/runtime/run@5.0.0-beta.34//Run#returnValue");
+})(Object.getOwnPropertyDescriptor(Run.prototype, "returnValue").get, "step//@workflow/core/runtime/run@5.0.0-beta.36//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);
@@ -28280,7 +28472,7 @@ var Run = class _Run {
     value: "workflowName",
     configurable: true
   });
-})(Object.getOwnPropertyDescriptor(Run.prototype, "workflowName").get, "step//@workflow/core/runtime/run@5.0.0-beta.34//Run#workflowName");
+})(Object.getOwnPropertyDescriptor(Run.prototype, "workflowName").get, "step//@workflow/core/runtime/run@5.0.0-beta.36//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);
@@ -28289,7 +28481,7 @@ var Run = class _Run {
     value: "createdAt",
     configurable: true
   });
-})(Object.getOwnPropertyDescriptor(Run.prototype, "createdAt").get, "step//@workflow/core/runtime/run@5.0.0-beta.34//Run#createdAt");
+})(Object.getOwnPropertyDescriptor(Run.prototype, "createdAt").get, "step//@workflow/core/runtime/run@5.0.0-beta.36//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);
@@ -28298,7 +28490,7 @@ var Run = class _Run {
     value: "startedAt",
     configurable: true
   });
-})(Object.getOwnPropertyDescriptor(Run.prototype, "startedAt").get, "step//@workflow/core/runtime/run@5.0.0-beta.34//Run#startedAt");
+})(Object.getOwnPropertyDescriptor(Run.prototype, "startedAt").get, "step//@workflow/core/runtime/run@5.0.0-beta.36//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);
@@ -28307,7 +28499,7 @@ var Run = class _Run {
     value: "completedAt",
     configurable: true
   });
-})(Object.getOwnPropertyDescriptor(Run.prototype, "completedAt").get, "step//@workflow/core/runtime/run@5.0.0-beta.34//Run#completedAt");
+})(Object.getOwnPropertyDescriptor(Run.prototype, "completedAt").get, "step//@workflow/core/runtime/run@5.0.0-beta.36//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);
@@ -28317,7 +28509,7 @@ var Run = class _Run {
     enumerable: false,
     configurable: false
   });
-})(Run, "class//@workflow/core/runtime/run@5.0.0-beta.34//Run");
+})(Run, "class//@workflow/core/runtime/run@5.0.0-beta.36//Run");
 
 // ../workflow/dist/stdlib.js
 async function fetch2(...args) {
@@ -28359,6 +28551,26 @@ async function addTenWorkflow(input) {
 __name(addTenWorkflow, "addTenWorkflow");
 addTenWorkflow.workflowId = "workflow//./workflows/addition//addTenWorkflow";
 
+// workflows/event-limit.ts
+async function tick(i) {
+  return i;
+}
+__name(tick, "tick");
+(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);
+  __wf_fn.stepId = __wf_id;
+  Object.defineProperty(__wf_fn, "name", {
+    value: "tick",
+    configurable: true
+  });
+})(tick, "step//./workflows/event-limit//tick");
+async function runawayWorkflow() {
+  throw new Error("You attempted to execute workflow runawayWorkflow function directly. To start a workflow, use start(runawayWorkflow) from workflow/api");
+}
+__name(runawayWorkflow, "runawayWorkflow");
+runawayWorkflow.workflowId = "workflow//./workflows/event-limit//runawayWorkflow";
+
 // ../core/dist/index.js
 init_dist2();
 
@@ -28676,13 +28888,52 @@ async function hookWorkflow(token) {
 __name(hookWorkflow, "hookWorkflow");
 hookWorkflow.workflowId = "workflow//./workflows/inline-execution//hookWorkflow";
 
+// workflows/lineage.ts
+async function noop() {
+}
+__name(noop, "noop");
+(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);
+  __wf_fn.stepId = __wf_id;
+  Object.defineProperty(__wf_fn, "name", {
+    value: "noop",
+    configurable: true
+  });
+})(noop, "step//./workflows/lineage//noop");
+async function bodyStartsChild() {
+  throw new Error("You attempted to execute workflow bodyStartsChild function directly. To start a workflow, use start(bodyStartsChild) from workflow/api");
+}
+__name(bodyStartsChild, "bodyStartsChild");
+bodyStartsChild.workflowId = "workflow//./workflows/lineage//bodyStartsChild";
+async function spawnedChild() {
+  throw new Error("You attempted to execute workflow spawnedChild function directly. To start a workflow, use start(spawnedChild) from workflow/api");
+}
+__name(spawnedChild, "spawnedChild");
+spawnedChild.workflowId = "workflow//./workflows/lineage//spawnedChild";
+async function chainRoot() {
+  throw new Error("You attempted to execute workflow chainRoot function directly. To start a workflow, use start(chainRoot) from workflow/api");
+}
+__name(chainRoot, "chainRoot");
+chainRoot.workflowId = "workflow//./workflows/lineage//chainRoot";
+async function chainMiddle() {
+  throw new Error("You attempted to execute workflow chainMiddle function directly. To start a workflow, use start(chainMiddle) from workflow/api");
+}
+__name(chainMiddle, "chainMiddle");
+chainMiddle.workflowId = "workflow//./workflows/lineage//chainMiddle";
+async function chainLeaf() {
+  throw new Error("You attempted to execute workflow chainLeaf function directly. To start a workflow, use start(chainLeaf) from workflow/api");
+}
+__name(chainLeaf, "chainLeaf");
+chainLeaf.workflowId = "workflow//./workflows/lineage//chainLeaf";
+
 // workflows/noop.ts
 var count = 0;
-async function noop(_i) {
+async function noop2(_i) {
   count++;
   return count;
 }
-__name(noop, "noop");
+__name(noop2, "noop");
 (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);
@@ -28691,7 +28942,7 @@ __name(noop, "noop");
     value: "noop",
     configurable: true
   });
-})(noop, "step//./workflows/noop//noop");
+})(noop2, "step//./workflows/noop//noop");
 async function brokenWf() {
   throw new Error("You attempted to execute workflow brokenWf function directly. To start a workflow, use start(brokenWf) from workflow/api");
 }