@workflow/world-testing 5.0.0-beta.24 → 5.0.0-beta.26

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

@@ -333,9 +333,26 @@ var init_dist = __esm({
 });
 
 // ../errors/dist/error-codes.js
+var RUN_ERROR_CODES;
 var init_error_codes = __esm({
   "../errors/dist/error-codes.js"() {
     "use strict";
+    RUN_ERROR_CODES = {
+      /** Error thrown in user workflow or step code */
+      USER_ERROR: "USER_ERROR",
+      /** Internal runtime error (missing timestamps, runtime invariant failures) */
+      RUNTIME_ERROR: "RUNTIME_ERROR",
+      /** Event log contains orphaned or mismatched events and cannot be replayed */
+      CORRUPTED_EVENT_LOG: "CORRUPTED_EVENT_LOG",
+      /** One replay could not consume the event log deterministically; retryable */
+      REPLAY_DIVERGENCE: "REPLAY_DIVERGENCE",
+      /** Run exceeded the maximum number of queue deliveries */
+      MAX_DELIVERIES_EXCEEDED: "MAX_DELIVERIES_EXCEEDED",
+      /** Workflow replay exceeded the maximum allowed duration */
+      REPLAY_TIMEOUT: "REPLAY_TIMEOUT",
+      /** World response violated the SDK contract and cannot be retried safely */
+      WORLD_CONTRACT_ERROR: "WORLD_CONTRACT_ERROR"
+    };
   }
 });
 
@@ -369,7 +386,7 @@ function buildFramedDetails(hint2, slug) {
   });
   return out;
 }
-var BASE_URL, ERROR_SLUGS, WorkflowError, WorkflowWorldError, WorkflowRunFailedError, WorkflowRunNotCompletedError, WorkflowRuntimeError, RuntimeDecryptionError, SerializationError, WorkflowRunNotFoundError, HookConflictError, HookNotFoundError, EntityConflictError, ThrottleError, WorkflowRunCancelledError, FatalError, RetryableError, FATAL_ERROR_KEY, RETRYABLE_ERROR_KEY, HOOK_CONFLICT_ERROR_KEY, RUNTIME_DECRYPTION_ERROR_KEY;
+var BASE_URL, ERROR_SLUGS, WorkflowError, WorkflowWorldError, WorkflowRunFailedError, WorkflowRunNotCompletedError, WorkflowRuntimeError, RuntimeDecryptionError, SerializationError, StepNotRegisteredError, WorkflowNotRegisteredError, WorkflowRunNotFoundError, HookConflictError, HookNotFoundError, EntityConflictError, ThrottleError, WorkflowRunCancelledError, FatalError, RetryableError, FATAL_ERROR_KEY, RETRYABLE_ERROR_KEY, HOOK_CONFLICT_ERROR_KEY, RUNTIME_DECRYPTION_ERROR_KEY;
 var init_dist2 = __esm({
   "../errors/dist/index.js"() {
     "use strict";
@@ -540,6 +557,38 @@ Caused by: ${options.cause.stack}`;
         return isError(value) && value.name === "SerializationError";
       }
     };
+    StepNotRegisteredError = class extends WorkflowRuntimeError {
+      static {
+        __name(this, "StepNotRegisteredError");
+      }
+      stepName;
+      constructor(stepName) {
+        super(`Step "${stepName}" is not registered in the current deployment. This usually indicates a build or bundling issue that caused the step to not be included in the deployment.`, {
+          slug: ERROR_SLUGS.STEP_NOT_REGISTERED
+        });
+        this.name = "StepNotRegisteredError";
+        this.stepName = stepName;
+      }
+      static is(value) {
+        return isError(value) && value.name === "StepNotRegisteredError";
+      }
+    };
+    WorkflowNotRegisteredError = class extends WorkflowRuntimeError {
+      static {
+        __name(this, "WorkflowNotRegisteredError");
+      }
+      workflowName;
+      constructor(workflowName) {
+        super(`Workflow "${workflowName}" is not registered in the current deployment. This usually means a run was started against a deployment that does not have this workflow, or there was a build/bundling issue.`, {
+          slug: ERROR_SLUGS.WORKFLOW_NOT_REGISTERED
+        });
+        this.name = "WorkflowNotRegisteredError";
+        this.workflowName = workflowName;
+      }
+      static is(value) {
+        return isError(value) && value.name === "WorkflowNotRegisteredError";
+      }
+    };
     WorkflowRunNotFoundError = class extends WorkflowError {
       static {
         __name(this, "WorkflowRunNotFoundError");
@@ -24007,7 +24056,7 @@ var version2;
 var init_version = __esm({
   "../core/dist/version.js"() {
     "use strict";
-    version2 = "5.0.0-beta.24";
+    version2 = "5.0.0-beta.26";
   }
 });
 
@@ -25921,7 +25970,7 @@ function attachAbortListenerOnce(signal, streamName, runId, cryptoKey, ops) {
     once: true
   });
 }
-function getExternalReducers(global2 = globalThis, ops, runId, cryptoKey, framedByteStreams = false) {
+function getExternalReducers(global2 = globalThis, ops, runId, cryptoKey, framedByteStreams = false, runReadyBarrier) {
   return {
     ...getAllBaseReducers(global2),
     ReadableStream: /* @__PURE__ */ __name((value) => {
@@ -25934,7 +25983,7 @@ function getExternalReducers(global2 = globalThis, ops, runId, cryptoKey, framed
       const streamId = (global2[STABLE_ULID] || defaultUlid)();
       const name = `strm_${streamId}`;
       const type = getStreamType(value);
-      const writable = new WorkflowServerWritableStream(runId, name);
+      const writable = new WorkflowServerWritableStream(runId, name, runReadyBarrier);
       if (type === "bytes") {
         if (framedByteStreams) {
           ops.push(value.pipeThrough(getByteFramingStream()).pipeTo(writable));
@@ -25942,7 +25991,7 @@ function getExternalReducers(global2 = globalThis, ops, runId, cryptoKey, framed
           ops.push(value.pipeTo(writable));
         }
       } else {
-        ops.push(value.pipeThrough(getSerializeStream(getExternalReducers(global2, ops, runId, cryptoKey, framedByteStreams), cryptoKey)).pipeTo(writable));
+        ops.push(value.pipeThrough(getSerializeStream(getExternalReducers(global2, ops, runId, cryptoKey, framedByteStreams, runReadyBarrier), cryptoKey)).pipeTo(writable));
       }
       const s = {
         name
@@ -26048,7 +26097,7 @@ function getWorkflowReducers(global2 = globalThis) {
     }, "AbortSignal")
   };
 }
-function getStepReducers(global2 = globalThis, ops, runId, cryptoKey, framedByteStreams = false) {
+function getStepReducers(global2 = globalThis, ops, runId, cryptoKey, framedByteStreams = false, runReadyBarrier) {
   return {
     ...getAllBaseReducers(global2),
     ReadableStream: /* @__PURE__ */ __name((value) => {
@@ -26066,7 +26115,7 @@ function getStepReducers(global2 = globalThis, ops, runId, cryptoKey, framedByte
         name = `strm_${streamId}`;
         type = getStreamType(value);
         framing = type === "bytes" && framedByteStreams ? "framed-v1" : framing;
-        const writable = new WorkflowServerWritableStream(runId, name);
+        const writable = new WorkflowServerWritableStream(runId, name, runReadyBarrier);
         if (type === "bytes") {
           if (framing === "framed-v1") {
             ops.push(value.pipeThrough(getByteFramingStream()).pipeTo(writable));
@@ -26074,7 +26123,7 @@ function getStepReducers(global2 = globalThis, ops, runId, cryptoKey, framedByte
             ops.push(value.pipeTo(writable));
           }
         } else {
-          ops.push(value.pipeThrough(getSerializeStream(getStepReducers(global2, ops, runId, cryptoKey, framedByteStreams), cryptoKey)).pipeTo(writable));
+          ops.push(value.pipeThrough(getSerializeStream(getStepReducers(global2, ops, runId, cryptoKey, framedByteStreams, runReadyBarrier), cryptoKey)).pipeTo(writable));
         }
       }
       const s = {
@@ -26580,16 +26629,16 @@ async function hydrateStepArguments(value, runId, key, ops = [], global2 = globa
   await recordCompression(compressionStats, "deserialize");
   return result;
 }
-async function dehydrateStepReturnValue(value, runId, key, ops = [], global2 = globalThis, v1Compat = false, framedByteStreams = false, compression = false) {
+async function dehydrateStepReturnValue(value, runId, key, ops = [], global2 = globalThis, v1Compat = false, framedByteStreams = false, compression = false, runReadyBarrier) {
   if (v1Compat) {
-    const str = stringify(value, getStepReducers(global2, ops, runId, key, framedByteStreams));
+    const str = stringify(value, getStepReducers(global2, ops, runId, key, framedByteStreams, runReadyBarrier));
     return revive(str);
   }
   try {
     const compressionStats = {};
     const result = await serialize2(value, key, {
       global: global2,
-      extraReducers: getStreamAndRequestReducers(getStepReducers(global2, ops, runId, key, framedByteStreams)),
+      extraReducers: getStreamAndRequestReducers(getStepReducers(global2, ops, runId, key, framedByteStreams, runReadyBarrier)),
       compression,
       compressionStats
     });
@@ -26729,7 +26778,16 @@ var init_serialization2 = __esm({
       static {
         __name(this, "WorkflowServerWritableStream");
       }
-      constructor(runId, name) {
+      /**
+       * @param runReadyBarrier Turbo mode only: a promise that resolves once the
+       * backgrounded `run_started` has landed. When the step body runs
+       * optimistically (before `run_started` is durable), the first chunk write to
+       * a brand-new stream would otherwise reach the World before the run exists
+       * and be rejected as run-not-found. Awaiting this once before the first
+       * flush/close orders the write after the run's creation. `undefined` outside
+       * turbo and on the await path, where the run was already durable.
+       */
+      constructor(runId, name, runReadyBarrier) {
         if (typeof runId !== "string") {
           throw new WorkflowRuntimeError(`"runId" must be a string, got "${typeof runId}"`);
         }
@@ -26737,6 +26795,16 @@ var init_serialization2 = __esm({
           throw new WorkflowRuntimeError(`"name" is required, got "${name}"`);
         }
         const worldPromise = getWorldLazy();
+        let pendingRunReady = runReadyBarrier;
+        const ensureRunReady = /* @__PURE__ */ __name(async () => {
+          if (pendingRunReady) {
+            try {
+              await pendingRunReady;
+            } catch {
+            }
+            pendingRunReady = void 0;
+          }
+        }, "ensureRunReady");
         let buffer2 = [];
         let flushTimer = null;
         let flushPromise = null;
@@ -26747,6 +26815,7 @@ var init_serialization2 = __esm({
             flushTimer = null;
           }
           if (buffer2.length === 0) return;
+          await ensureRunReady();
           const chunksToFlush = buffer2.slice();
           const world = await worldPromise;
           if (resolvedFlushIntervalMs === void 0) {
@@ -26796,6 +26865,7 @@ var init_serialization2 = __esm({
               flushPromise = null;
             }
             await flush();
+            await ensureRunReady();
             const world = await worldPromise;
             await world.streams.close(runId, name);
           },
@@ -26994,6 +27064,43 @@ __name(normalizeAttributeChanges, "normalizeAttributeChanges");
 
 // ../core/dist/runtime/start.js
 init_capabilities();
+
+// ../core/dist/classify-error.js
+init_dist2();
+var WORLD_CONTRACT_ERROR_CODES = /* @__PURE__ */ new Set([
+  "PARSE_ERROR",
+  "SCHEMA_VALIDATION",
+  RUN_ERROR_CODES.WORLD_CONTRACT_ERROR
+]);
+var RETRYABLE_WORLD_ERROR_CODES = /* @__PURE__ */ new Set([
+  "TRANSPORT",
+  "TIMEOUT"
+]);
+var RUNTIME_ERROR_CHECKS = [
+  WorkflowRuntimeError.is,
+  StepNotRegisteredError.is,
+  WorkflowNotRegisteredError.is,
+  // SDK-level encryption failures (most notably AES-GCM auth-tag
+  // mismatches surfacing as a native `OperationError` from
+  // `AESCipherJob.onDone`) are wrapped in `RuntimeDecryptionError` at
+  // the encryption module boundary.
+  RuntimeDecryptionError.is
+];
+function isRetryableWorldError(err) {
+  if (ThrottleError.is(err)) {
+    return true;
+  }
+  if (!WorkflowWorldError.is(err)) {
+    return false;
+  }
+  if (err.status !== void 0 && err.status >= 500) {
+    return true;
+  }
+  return err.code !== void 0 && RETRYABLE_WORLD_ERROR_CODES.has(err.code);
+}
+__name(isRetryableWorldError, "isRetryableWorldError");
+
+// ../core/dist/runtime/start.js
 init_encryption();
 init_logger();
 init_serialization2();
@@ -27146,7 +27253,7 @@ async function start(workflow, argsOrOptions, options) {
       if (runCreatedResult.status === "rejected") {
         const err = runCreatedResult.reason;
         if (EntityConflictError.is(err)) {
-        } else if (isRetryableStartError(err)) {
+        } else if (isRetryableWorldError(err)) {
           resilientStart = true;
           runtimeLogger.warn("Run creation event failed, but the run was accepted via the queue. The run_created event will be re-tried async by the runtime.", {
             workflowRunId: runId,
@@ -27190,13 +27297,7 @@ __name(start, "start");
     value: "start",
     configurable: true
   });
-})(start, "step//@workflow/core/runtime/start@5.0.0-beta.24//start");
-function isRetryableStartError(err) {
-  if (ThrottleError.is(err)) return true;
-  if (WorkflowWorldError.is(err) && err.status && err.status >= 500) return true;
-  return false;
-}
-__name(isRetryableStartError, "isRetryableStartError");
+})(start, "step//@workflow/core/runtime/start@5.0.0-beta.26//start");
 
 // ../core/dist/runtime/runs.js
 async function wakeUpRun(world, runId, options) {
@@ -27523,7 +27624,7 @@ var Run = class _Run {
     value: "wakeUp",
     configurable: true
   });
-})(Run.prototype["wakeUp"], "step//@workflow/core/runtime/run@5.0.0-beta.24//Run#wakeUp");
+})(Run.prototype["wakeUp"], "step//@workflow/core/runtime/run@5.0.0-beta.26//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);
@@ -27532,7 +27633,7 @@ var Run = class _Run {
     value: "cancel",
     configurable: true
   });
-})(Run.prototype["cancel"], "step//@workflow/core/runtime/run@5.0.0-beta.24//Run#cancel");
+})(Run.prototype["cancel"], "step//@workflow/core/runtime/run@5.0.0-beta.26//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);
@@ -27541,7 +27642,7 @@ var Run = class _Run {
     value: "getReadable",
     configurable: true
   });
-})(Run.prototype["getReadable"], "step//@workflow/core/runtime/run@5.0.0-beta.24//Run#getReadable");
+})(Run.prototype["getReadable"], "step//@workflow/core/runtime/run@5.0.0-beta.26//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);
@@ -27550,7 +27651,7 @@ var Run = class _Run {
     value: "exists",
     configurable: true
   });
-})(Object.getOwnPropertyDescriptor(Run.prototype, "exists").get, "step//@workflow/core/runtime/run@5.0.0-beta.24//Run#exists");
+})(Object.getOwnPropertyDescriptor(Run.prototype, "exists").get, "step//@workflow/core/runtime/run@5.0.0-beta.26//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);
@@ -27559,7 +27660,7 @@ var Run = class _Run {
     value: "status",
     configurable: true
   });
-})(Object.getOwnPropertyDescriptor(Run.prototype, "status").get, "step//@workflow/core/runtime/run@5.0.0-beta.24//Run#status");
+})(Object.getOwnPropertyDescriptor(Run.prototype, "status").get, "step//@workflow/core/runtime/run@5.0.0-beta.26//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);
@@ -27568,7 +27669,7 @@ var Run = class _Run {
     value: "returnValue",
     configurable: true
   });
-})(Object.getOwnPropertyDescriptor(Run.prototype, "returnValue").get, "step//@workflow/core/runtime/run@5.0.0-beta.24//Run#returnValue");
+})(Object.getOwnPropertyDescriptor(Run.prototype, "returnValue").get, "step//@workflow/core/runtime/run@5.0.0-beta.26//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);
@@ -27577,7 +27678,7 @@ var Run = class _Run {
     value: "workflowName",
     configurable: true
   });
-})(Object.getOwnPropertyDescriptor(Run.prototype, "workflowName").get, "step//@workflow/core/runtime/run@5.0.0-beta.24//Run#workflowName");
+})(Object.getOwnPropertyDescriptor(Run.prototype, "workflowName").get, "step//@workflow/core/runtime/run@5.0.0-beta.26//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);
@@ -27586,7 +27687,7 @@ var Run = class _Run {
     value: "createdAt",
     configurable: true
   });
-})(Object.getOwnPropertyDescriptor(Run.prototype, "createdAt").get, "step//@workflow/core/runtime/run@5.0.0-beta.24//Run#createdAt");
+})(Object.getOwnPropertyDescriptor(Run.prototype, "createdAt").get, "step//@workflow/core/runtime/run@5.0.0-beta.26//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);
@@ -27595,7 +27696,7 @@ var Run = class _Run {
     value: "startedAt",
     configurable: true
   });
-})(Object.getOwnPropertyDescriptor(Run.prototype, "startedAt").get, "step//@workflow/core/runtime/run@5.0.0-beta.24//Run#startedAt");
+})(Object.getOwnPropertyDescriptor(Run.prototype, "startedAt").get, "step//@workflow/core/runtime/run@5.0.0-beta.26//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);
@@ -27604,7 +27705,7 @@ var Run = class _Run {
     value: "completedAt",
     configurable: true
   });
-})(Object.getOwnPropertyDescriptor(Run.prototype, "completedAt").get, "step//@workflow/core/runtime/run@5.0.0-beta.24//Run#completedAt");
+})(Object.getOwnPropertyDescriptor(Run.prototype, "completedAt").get, "step//@workflow/core/runtime/run@5.0.0-beta.26//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);
@@ -27614,7 +27715,7 @@ var Run = class _Run {
     enumerable: false,
     configurable: false
   });
-})(Run, "class//@workflow/core/runtime/run@5.0.0-beta.24//Run");
+})(Run, "class//@workflow/core/runtime/run@5.0.0-beta.26//Run");
 
 // ../workflow/dist/stdlib.js
 async function fetch2(...args) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@workflow/world-testing",
-  "version": "5.0.0-beta.24",
+  "version": "5.0.0-beta.26",
   "description": "Testing utilities and World implementation for Workflow SDK",
   "main": "dist/src/index.mjs",
   "files": [
@@ -20,11 +20,11 @@
     "chalk": "5.6.2",
     "hono": "4.12.25",
     "jsonlines": "0.1.1",
-    "zod": "4.3.6",
-    "@workflow/cli": "5.0.0-beta.24",
-    "@workflow/core": "5.0.0-beta.24",
-    "@workflow/world": "5.0.0-beta.13",
-    "workflow": "5.0.0-beta.24"
+    "zod": "~4.3.6",
+    "@workflow/cli": "5.0.0-beta.26",
+    "@workflow/core": "5.0.0-beta.26",
+    "@workflow/world": "5.0.0-beta.14",
+    "workflow": "5.0.0-beta.26"
   },
   "devDependencies": {
     "@types/jsonlines": "0.1.5",