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

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

@@ -515,8 +515,6 @@ Caused by: ${options.cause.stack}`;
       static {
         __name(this, "RuntimeDecryptionError");
       }
-      /** Optional structured context about the failed encrypt/decrypt call. */
-      context;
       constructor(message, options) {
         super(message, {
           cause: options?.cause,
@@ -16494,7 +16492,7 @@ var init_serialization = __esm({
 });
 
 // ../world/dist/events.js
-var EventTypeSchema, BaseEventSchema, StepCompletedEventSchema, StepFailedEventSchema, StepRetryingEventSchema, StepStartedEventSchema, StepCreatedEventSchema, HookCreatedEventSchema, HookReceivedEventSchema, HookDisposedEventSchema, HookConflictEventSchema, WaitCreatedEventSchema, WaitCompletedEventSchema, AttributeWriterSchema, AttrSetEventSchema, RunCreatedEventSchema, RunStartedEventSchema, RunCompletedEventSchema, RunFailedEventSchema, RunCancelledEventSchema, CreateEventSchema, AllEventsSchema, EventSchema;
+var EventTypeSchema, TerminalRunEventTypeSchema, TERMINAL_RUN_EVENT_TYPES, BaseEventSchema, StepCompletedEventSchema, StepFailedEventSchema, StepRetryingEventSchema, StepStartedEventSchema, StepCreatedEventSchema, HookCreatedEventSchema, HookReceivedEventSchema, HookDisposedEventSchema, HookConflictEventSchema, WaitCreatedEventSchema, WaitCompletedEventSchema, AttributeWriterSchema, AttrSetEventSchema, RunCreatedEventSchema, RunStartedEventSchema, RunCompletedEventSchema, RunFailedEventSchema, RunCancelledEventSchema, CreateEventSchema, AllEventsSchema, EventSchema;
 var init_events = __esm({
   "../world/dist/events.js"() {
     "use strict";
@@ -16525,6 +16523,12 @@ var init_events = __esm({
       "wait_created",
       "wait_completed"
     ]);
+    TerminalRunEventTypeSchema = EventTypeSchema.extract([
+      "run_completed",
+      "run_failed",
+      "run_cancelled"
+    ]);
+    TERMINAL_RUN_EVENT_TYPES = TerminalRunEventTypeSchema.options;
     BaseEventSchema = external_exports.object({
       eventType: EventTypeSchema,
       correlationId: external_exports.string().optional(),
@@ -16753,134 +16757,8 @@ var init_events = __esm({
   }
 });
 
-// ../world/dist/hooks.js
-var HookSchema;
-var init_hooks = __esm({
-  "../world/dist/hooks.js"() {
-    "use strict";
-    init_zod();
-    init_serialization();
-    HookSchema = external_exports.object({
-      runId: external_exports.string(),
-      hookId: external_exports.string(),
-      token: external_exports.string(),
-      ownerId: external_exports.string(),
-      projectId: external_exports.string(),
-      environment: external_exports.string(),
-      metadata: SerializedDataSchema.optional(),
-      createdAt: external_exports.coerce.date(),
-      // Optional in database for backwards compatibility, defaults to 1 (legacy) when reading
-      specVersion: external_exports.number().optional(),
-      isWebhook: external_exports.boolean().optional(),
-      isSystem: external_exports.boolean().optional()
-    });
-  }
-});
-
-// ../../node_modules/.pnpm/zod@4.3.6/node_modules/zod/v4/classic/index.js
-var init_classic = __esm({
-  "../../node_modules/.pnpm/zod@4.3.6/node_modules/zod/v4/classic/index.js"() {
-    "use strict";
-    init_external();
-    init_external();
-  }
-});
-
-// ../../node_modules/.pnpm/zod@4.3.6/node_modules/zod/v4/index.js
-var init_v4 = __esm({
-  "../../node_modules/.pnpm/zod@4.3.6/node_modules/zod/v4/index.js"() {
-    "use strict";
-    init_classic();
-    init_classic();
-  }
-});
-
-// ../world/dist/queue.js
-function resolveQueueNamespace(namespace) {
-  return namespace ?? process.env.WORKFLOW_QUEUE_NAMESPACE ?? void 0;
-}
-function getQueueTopicPrefix(kind, namespace) {
-  if (namespace !== void 0) {
-    QueueNamespace.parse(namespace);
-    return `__${namespace}_wkf_${kind}_`;
-  }
-  return `__wkf_${kind}_`;
-}
-var QueuePrefix, ValidQueueName, QueueNamespace, MessageId, TraceCarrierSchema, RunInputSchema, WorkflowInvokePayloadSchema, StepInvokePayloadSchema, HealthCheckPayloadSchema, QueuePayloadSchema;
-var init_queue = __esm({
-  "../world/dist/queue.js"() {
-    "use strict";
-    init_v4();
-    QueuePrefix = external_exports.string().regex(/^__(?:[a-z][a-z0-9]*_)?wkf_(?:workflow|step)_$/, "Must match __wkf_{workflow|step}_ or __{namespace}_wkf_{workflow|step}_");
-    ValidQueueName = external_exports.string().regex(/^__(?:[a-z][a-z0-9]*_)?wkf_(?:workflow|step)_.+$/, "Must be a valid queue name with a recognized prefix");
-    QueueNamespace = external_exports.string().regex(/^[a-z][a-z0-9]*$/, "Must be lowercase alphanumeric, starting with a letter");
-    __name(resolveQueueNamespace, "resolveQueueNamespace");
-    __name(getQueueTopicPrefix, "getQueueTopicPrefix");
-    MessageId = external_exports.string().brand().describe("A stored queue message ID");
-    TraceCarrierSchema = external_exports.record(external_exports.string(), external_exports.string());
-    RunInputSchema = external_exports.object({
-      input: external_exports.unknown(),
-      deploymentId: external_exports.string(),
-      workflowName: external_exports.string(),
-      specVersion: external_exports.number(),
-      executionContext: external_exports.record(external_exports.string(), external_exports.any()).optional(),
-      /** Initial plaintext run attributes, for resilient run creation. */
-      attributes: external_exports.record(external_exports.string(), external_exports.string()).optional(),
-      /**
-       * Permits reserved `$`-prefixed keys in `attributes`, mirrored from the
-       * `start()` option so resilient run creation validates the same way as
-       * the original `run_created` attempt.
-       */
-      allowReservedAttributes: external_exports.literal(true).optional()
-    });
-    WorkflowInvokePayloadSchema = external_exports.object({
-      runId: external_exports.string(),
-      traceCarrier: TraceCarrierSchema.optional(),
-      requestedAt: external_exports.coerce.date().optional(),
-      /** Consecutive replay divergences in this recovery chain and latest position. */
-      replayDivergence: external_exports.object({
-        eventId: external_exports.string(),
-        count: external_exports.number().int().positive()
-      }).optional(),
-      /** Number of times this message has been re-enqueued due to server errors (5xx) */
-      serverErrorRetryCount: external_exports.number().int().optional(),
-      /** Step ID for inline step execution in combined handler. If provided, the flow execution
-       * will jump directly to execute the step with the given ID before doing an event replay. */
-      stepId: external_exports.string().optional(),
-      /** Step name, sent alongside stepId to avoid loading the event log just to resolve the name. */
-      stepName: external_exports.string().optional(),
-      /** Run creation data, only present on the first queue delivery from start() */
-      runInput: RunInputSchema.optional()
-    });
-    StepInvokePayloadSchema = external_exports.object({
-      workflowName: external_exports.string(),
-      workflowRunId: external_exports.string(),
-      workflowStartedAt: external_exports.number(),
-      stepId: external_exports.string(),
-      traceCarrier: TraceCarrierSchema.optional(),
-      requestedAt: external_exports.coerce.date().optional()
-    });
-    HealthCheckPayloadSchema = external_exports.object({
-      __healthCheck: external_exports.literal(true),
-      correlationId: external_exports.string()
-    });
-    QueuePayloadSchema = external_exports.union([
-      WorkflowInvokePayloadSchema,
-      StepInvokePayloadSchema,
-      HealthCheckPayloadSchema
-    ]);
-  }
-});
-
-// ../world/dist/recovery.js
-var init_recovery = __esm({
-  "../world/dist/recovery.js"() {
-    "use strict";
-  }
-});
-
 // ../world/dist/runs.js
-var WorkflowRunStatusSchema, WorkflowRunBaseSchema, WorkflowRunSchema;
+var WorkflowRunStatusSchema, TerminalWorkflowRunStatusSchema, TERMINAL_WORKFLOW_RUN_STATUSES, WorkflowRunBaseSchema, WorkflowRunSchema;
 var init_runs = __esm({
   "../world/dist/runs.js"() {
     "use strict";
@@ -16893,6 +16771,12 @@ var init_runs = __esm({
       "failed",
       "cancelled"
     ]);
+    TerminalWorkflowRunStatusSchema = WorkflowRunStatusSchema.extract([
+      "completed",
+      "failed",
+      "cancelled"
+    ]);
+    TERMINAL_WORKFLOW_RUN_STATUSES = TerminalWorkflowRunStatusSchema.options;
     WorkflowRunBaseSchema = external_exports.object({
       runId: external_exports.string(),
       status: WorkflowRunStatusSchema,
@@ -16997,50 +16881,8 @@ var init_runs = __esm({
   }
 });
 
-// ../world/dist/shared.js
-var zodJsonSchema, StructuredErrorSchema;
-var init_shared = __esm({
-  "../world/dist/shared.js"() {
-    "use strict";
-    init_zod();
-    zodJsonSchema = external_exports.lazy(() => {
-      return external_exports.union([
-        external_exports.string(),
-        external_exports.number(),
-        external_exports.boolean(),
-        external_exports.null(),
-        external_exports.array(zodJsonSchema),
-        external_exports.record(external_exports.string(), zodJsonSchema)
-      ]);
-    });
-    StructuredErrorSchema = external_exports.object({
-      message: external_exports.string(),
-      stack: external_exports.string().optional(),
-      code: external_exports.string().optional()
-    });
-  }
-});
-
-// ../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_CURRENT;
-var init_spec_version = __esm({
-  "../world/dist/spec-version.js"() {
-    "use strict";
-    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_CURRENT = SPEC_VERSION_SUPPORTS_COMPRESSION;
-    __name(isLegacySpecVersion, "isLegacySpecVersion");
-  }
-});
-
 // ../world/dist/steps.js
-var StepStatusSchema, StepSchema;
+var StepStatusSchema, StepSchema, TerminalStepStatusSchema, TERMINAL_STEP_STATUSES;
 var init_steps = __esm({
   "../world/dist/steps.js"() {
     "use strict";
@@ -17104,6 +16946,342 @@ var init_steps = __esm({
       // Optional in database for backwards compatibility, defaults to 1 (legacy) when reading
       specVersion: external_exports.number().optional()
     });
+    TerminalStepStatusSchema = StepStatusSchema.extract([
+      "completed",
+      "failed",
+      "cancelled"
+    ]);
+    TERMINAL_STEP_STATUSES = TerminalStepStatusSchema.options;
+  }
+});
+
+// ../world/dist/waits.js
+var WaitStatusSchema, WaitSchema;
+var init_waits = __esm({
+  "../world/dist/waits.js"() {
+    "use strict";
+    init_zod();
+    WaitStatusSchema = external_exports.enum([
+      "waiting",
+      "completed"
+    ]);
+    WaitSchema = external_exports.object({
+      waitId: external_exports.string(),
+      runId: external_exports.string(),
+      status: WaitStatusSchema,
+      resumeAt: external_exports.coerce.date().optional(),
+      completedAt: external_exports.coerce.date().optional(),
+      createdAt: external_exports.coerce.date(),
+      updatedAt: external_exports.coerce.date(),
+      specVersion: external_exports.number().optional()
+    });
+  }
+});
+
+// ../world/dist/analytics.js
+var NullableDateSchema, NullableStringSchema, NullableBooleanSchema, AnalyticsRunSchema, AnalyticsStepSchema, AnalyticsEventSchema, AnalyticsHookSchema, AnalyticsWaitSchema;
+var init_analytics = __esm({
+  "../world/dist/analytics.js"() {
+    "use strict";
+    init_zod();
+    init_events();
+    init_runs();
+    init_steps();
+    init_waits();
+    NullableDateSchema = external_exports.coerce.date().nullable().optional();
+    NullableStringSchema = external_exports.string().nullable().optional();
+    NullableBooleanSchema = external_exports.boolean().nullable().optional();
+    AnalyticsRunSchema = external_exports.object({
+      runId: external_exports.string(),
+      status: WorkflowRunStatusSchema,
+      deploymentId: external_exports.string(),
+      workflowName: external_exports.string(),
+      specVersion: external_exports.coerce.number().optional(),
+      attributes: external_exports.record(external_exports.string(), external_exports.string()).default({}),
+      createdAt: external_exports.coerce.date(),
+      updatedAt: external_exports.coerce.date(),
+      startedAt: NullableDateSchema,
+      completedAt: NullableDateSchema,
+      errorCode: NullableStringSchema,
+      workflowCoreVersion: NullableStringSchema,
+      workflowEncryptionEnabled: NullableBooleanSchema
+    });
+    AnalyticsStepSchema = external_exports.object({
+      runId: external_exports.string(),
+      stepId: external_exports.string(),
+      stepName: NullableStringSchema,
+      status: StepStatusSchema,
+      attempt: external_exports.number().optional(),
+      createdAt: external_exports.coerce.date(),
+      updatedAt: external_exports.coerce.date(),
+      startedAt: NullableDateSchema,
+      completedAt: NullableDateSchema,
+      retryAfter: NullableDateSchema,
+      errorCode: NullableStringSchema,
+      workflowCoreVersion: NullableStringSchema,
+      workflowEncryptionEnabled: NullableBooleanSchema
+    });
+    AnalyticsEventSchema = external_exports.object({
+      runId: external_exports.string(),
+      eventId: external_exports.string(),
+      eventType: EventTypeSchema,
+      correlationId: NullableStringSchema,
+      entityId: NullableStringSchema,
+      stepName: NullableStringSchema,
+      workflowName: external_exports.string(),
+      deploymentId: external_exports.string(),
+      specVersion: external_exports.coerce.number().optional(),
+      runCreatedAt: external_exports.coerce.date(),
+      createdAt: external_exports.coerce.date(),
+      region: NullableStringSchema,
+      vercelId: NullableStringSchema,
+      requestId: NullableStringSchema,
+      resumeAt: NullableDateSchema,
+      retryAfter: NullableDateSchema,
+      errorCode: NullableStringSchema,
+      workflowCoreVersion: NullableStringSchema,
+      isWebhook: NullableBooleanSchema,
+      isSystem: NullableBooleanSchema,
+      workflowEncryptionEnabled: NullableBooleanSchema
+    });
+    AnalyticsHookSchema = external_exports.object({
+      runId: external_exports.string(),
+      hookId: external_exports.string(),
+      status: external_exports.enum([
+        "created",
+        "received",
+        "disposed",
+        "conflict"
+      ]),
+      createdAt: external_exports.coerce.date(),
+      updatedAt: external_exports.coerce.date(),
+      receivedAt: NullableDateSchema,
+      disposedAt: NullableDateSchema,
+      isWebhook: NullableBooleanSchema,
+      isSystem: NullableBooleanSchema,
+      workflowCoreVersion: NullableStringSchema,
+      workflowEncryptionEnabled: NullableBooleanSchema
+    });
+    AnalyticsWaitSchema = external_exports.object({
+      runId: external_exports.string(),
+      waitId: external_exports.string(),
+      status: WaitStatusSchema,
+      resumeAt: NullableDateSchema,
+      createdAt: external_exports.coerce.date(),
+      updatedAt: external_exports.coerce.date(),
+      completedAt: NullableDateSchema,
+      workflowCoreVersion: NullableStringSchema,
+      workflowEncryptionEnabled: NullableBooleanSchema
+    });
+  }
+});
+
+// ../world/dist/env-config.js
+function warnOnce(key, message) {
+  if (warnedEnvValues.has(key)) return;
+  warnedEnvValues.add(key);
+  console.warn(`[workflow] ${message}`);
+}
+function envNumber(name, fallback, options = {}) {
+  const raw = process.env[name];
+  if (raw === void 0 || raw === "") return fallback;
+  const { min = 0, max, integer: integer2 = false } = options;
+  const parsed = Number(raw);
+  if (!Number.isFinite(parsed) || integer2 && !Number.isInteger(parsed)) {
+    warnOnce(`${name}=${raw}`, `Ignoring ${name}: not a ${integer2 ? "finite integer" : "finite number"}; using default ${fallback}`);
+    return fallback;
+  }
+  if (parsed < min) {
+    warnOnce(`${name}=${raw}`, `${name} below minimum ${min}; clamped`);
+    return min;
+  }
+  if (max !== void 0 && parsed > max) {
+    warnOnce(`${name}=${raw}`, `${name} above maximum ${max}; clamped`);
+    return max;
+  }
+  return parsed;
+}
+var warnedEnvValues;
+var init_env_config = __esm({
+  "../world/dist/env-config.js"() {
+    "use strict";
+    warnedEnvValues = /* @__PURE__ */ new Set();
+    __name(warnOnce, "warnOnce");
+    __name(envNumber, "envNumber");
+  }
+});
+
+// ../world/dist/hooks.js
+var HookSchema;
+var init_hooks = __esm({
+  "../world/dist/hooks.js"() {
+    "use strict";
+    init_zod();
+    init_serialization();
+    HookSchema = external_exports.object({
+      runId: external_exports.string(),
+      hookId: external_exports.string(),
+      token: external_exports.string(),
+      ownerId: external_exports.string(),
+      projectId: external_exports.string(),
+      environment: external_exports.string(),
+      metadata: SerializedDataSchema.optional(),
+      createdAt: external_exports.coerce.date(),
+      // Optional in database for backwards compatibility, defaults to 1 (legacy) when reading
+      specVersion: external_exports.number().optional(),
+      isWebhook: external_exports.boolean().optional(),
+      isSystem: external_exports.boolean().optional()
+    });
+  }
+});
+
+// ../../node_modules/.pnpm/zod@4.3.6/node_modules/zod/v4/classic/index.js
+var init_classic = __esm({
+  "../../node_modules/.pnpm/zod@4.3.6/node_modules/zod/v4/classic/index.js"() {
+    "use strict";
+    init_external();
+    init_external();
+  }
+});
+
+// ../../node_modules/.pnpm/zod@4.3.6/node_modules/zod/v4/index.js
+var init_v4 = __esm({
+  "../../node_modules/.pnpm/zod@4.3.6/node_modules/zod/v4/index.js"() {
+    "use strict";
+    init_classic();
+    init_classic();
+  }
+});
+
+// ../world/dist/queue.js
+function resolveQueueNamespace(namespace) {
+  return namespace ?? process.env.WORKFLOW_QUEUE_NAMESPACE ?? void 0;
+}
+function getQueueTopicPrefix(kind, namespace) {
+  if (namespace !== void 0) {
+    QueueNamespace.parse(namespace);
+    return `__${namespace}_wkf_${kind}_`;
+  }
+  return `__wkf_${kind}_`;
+}
+var QueuePrefix, ValidQueueName, QueueNamespace, MessageId, TraceCarrierSchema, RunInputSchema, WorkflowInvokePayloadSchema, StepInvokePayloadSchema, HealthCheckPayloadSchema, QueuePayloadSchema;
+var init_queue = __esm({
+  "../world/dist/queue.js"() {
+    "use strict";
+    init_v4();
+    QueuePrefix = external_exports.string().regex(/^__(?:[a-z][a-z0-9]*_)?wkf_(?:workflow|step)_$/, "Must match __wkf_{workflow|step}_ or __{namespace}_wkf_{workflow|step}_");
+    ValidQueueName = external_exports.string().regex(/^__(?:[a-z][a-z0-9]*_)?wkf_(?:workflow|step)_.+$/, "Must be a valid queue name with a recognized prefix");
+    QueueNamespace = external_exports.string().regex(/^[a-z][a-z0-9]*$/, "Must be lowercase alphanumeric, starting with a letter");
+    __name(resolveQueueNamespace, "resolveQueueNamespace");
+    __name(getQueueTopicPrefix, "getQueueTopicPrefix");
+    MessageId = external_exports.string().brand().describe("A stored queue message ID");
+    TraceCarrierSchema = external_exports.record(external_exports.string(), external_exports.string());
+    RunInputSchema = external_exports.object({
+      input: external_exports.unknown(),
+      deploymentId: external_exports.string(),
+      workflowName: external_exports.string(),
+      specVersion: external_exports.number(),
+      executionContext: external_exports.record(external_exports.string(), external_exports.any()).optional(),
+      /** Initial plaintext run attributes, for resilient run creation. */
+      attributes: external_exports.record(external_exports.string(), external_exports.string()).optional(),
+      /**
+       * Permits reserved `$`-prefixed keys in `attributes`, mirrored from the
+       * `start()` option so resilient run creation validates the same way as
+       * the original `run_created` attempt.
+       */
+      allowReservedAttributes: external_exports.literal(true).optional()
+    });
+    WorkflowInvokePayloadSchema = external_exports.object({
+      runId: external_exports.string(),
+      traceCarrier: TraceCarrierSchema.optional(),
+      requestedAt: external_exports.coerce.date().optional(),
+      /** Consecutive replay divergences in this recovery chain and latest position. */
+      replayDivergence: external_exports.object({
+        eventId: external_exports.string(),
+        count: external_exports.number().int().positive()
+      }).optional(),
+      /** Number of times this message has been re-enqueued due to server errors (5xx) */
+      serverErrorRetryCount: external_exports.number().int().optional(),
+      /** Step ID for inline step execution in combined handler. If provided, the flow execution
+       * will jump directly to execute the step with the given ID before doing an event replay. */
+      stepId: external_exports.string().optional(),
+      /** Step name, sent alongside stepId to avoid loading the event log just to resolve the name. */
+      stepName: external_exports.string().optional(),
+      /** Run creation data, only present on the first queue delivery from start() */
+      runInput: RunInputSchema.optional()
+    });
+    StepInvokePayloadSchema = external_exports.object({
+      workflowName: external_exports.string(),
+      workflowRunId: external_exports.string(),
+      workflowStartedAt: external_exports.number(),
+      stepId: external_exports.string(),
+      traceCarrier: TraceCarrierSchema.optional(),
+      requestedAt: external_exports.coerce.date().optional()
+    });
+    HealthCheckPayloadSchema = external_exports.object({
+      __healthCheck: external_exports.literal(true),
+      correlationId: external_exports.string()
+    });
+    QueuePayloadSchema = external_exports.union([
+      WorkflowInvokePayloadSchema,
+      StepInvokePayloadSchema,
+      HealthCheckPayloadSchema
+    ]);
+  }
+});
+
+// ../world/dist/recovery.js
+var init_recovery = __esm({
+  "../world/dist/recovery.js"() {
+    "use strict";
+  }
+});
+
+// ../world/dist/shared.js
+var zodJsonSchema, PageInfoSchema, StructuredErrorSchema;
+var init_shared = __esm({
+  "../world/dist/shared.js"() {
+    "use strict";
+    init_zod();
+    zodJsonSchema = external_exports.lazy(() => {
+      return external_exports.union([
+        external_exports.string(),
+        external_exports.number(),
+        external_exports.boolean(),
+        external_exports.null(),
+        external_exports.array(zodJsonSchema),
+        external_exports.record(external_exports.string(), zodJsonSchema)
+      ]);
+    });
+    PageInfoSchema = external_exports.object({
+      currentLookbackDays: external_exports.number(),
+      maxLookbackDays: external_exports.number(),
+      currentWindowStart: external_exports.coerce.date(),
+      maxWindowStart: external_exports.coerce.date(),
+      upgradeAvailable: external_exports.boolean()
+    });
+    StructuredErrorSchema = external_exports.object({
+      message: external_exports.string(),
+      stack: external_exports.string().optional(),
+      code: external_exports.string().optional()
+    });
+  }
+});
+
+// ../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_CURRENT;
+var init_spec_version = __esm({
+  "../world/dist/spec-version.js"() {
+    "use strict";
+    SPEC_VERSION_LEGACY = 1;
+    SPEC_VERSION_SUPPORTS_CBOR_QUEUE_TRANSPORT = 3;
+    SPEC_VERSION_SUPPORTS_ATTRIBUTES = 4;
+    SPEC_VERSION_SUPPORTS_COMPRESSION = 5;
+    SPEC_VERSION_CURRENT = SPEC_VERSION_SUPPORTS_COMPRESSION;
+    __name(isLegacySpecVersion, "isLegacySpecVersion");
   }
 });
 
@@ -17265,34 +17443,13 @@ var init_ulid = __esm({
   }
 });
 
-// ../world/dist/waits.js
-var WaitStatusSchema, WaitSchema;
-var init_waits = __esm({
-  "../world/dist/waits.js"() {
-    "use strict";
-    init_zod();
-    WaitStatusSchema = external_exports.enum([
-      "waiting",
-      "completed"
-    ]);
-    WaitSchema = external_exports.object({
-      waitId: external_exports.string(),
-      runId: external_exports.string(),
-      status: WaitStatusSchema,
-      resumeAt: external_exports.coerce.date().optional(),
-      completedAt: external_exports.coerce.date().optional(),
-      createdAt: external_exports.coerce.date(),
-      updatedAt: external_exports.coerce.date(),
-      specVersion: external_exports.number().optional()
-    });
-  }
-});
-
 // ../world/dist/index.js
 var init_dist4 = __esm({
   "../world/dist/index.js"() {
     "use strict";
+    init_analytics();
     init_attributes();
+    init_env_config();
     init_events();
     init_hooks();
     init_queue();
@@ -18082,7 +18239,7 @@ function pollWritableLock(writable, state) {
       clearInterval(intervalId);
       state.writablePollingInterval = void 0;
     }
-  }, LOCK_POLL_INTERVAL_MS);
+  }, getLockPollIntervalMs());
   state.writablePollingInterval = intervalId;
 }
 function pollReadableLock(readable, state) {
@@ -18101,7 +18258,7 @@ function pollReadableLock(readable, state) {
       clearInterval(intervalId);
       state.readablePollingInterval = void 0;
     }
-  }, LOCK_POLL_INTERVAL_MS);
+  }, getLockPollIntervalMs());
   state.readablePollingInterval = intervalId;
 }
 async function flushablePipe(source, sink, state) {
@@ -18153,13 +18310,18 @@ async function flushablePipe(source, sink, state) {
     writer.releaseLock();
   }
 }
-var LOCK_POLL_INTERVAL_MS;
+var LOCK_POLL_INTERVAL_MS, getLockPollIntervalMs;
 var init_flushable_stream = __esm({
   "../core/dist/flushable-stream.js"() {
     "use strict";
     init_dist2();
     init_dist();
+    init_dist4();
     LOCK_POLL_INTERVAL_MS = 10;
+    getLockPollIntervalMs = /* @__PURE__ */ __name(() => envNumber("WORKFLOW_LOCK_POLL_INTERVAL_MS", LOCK_POLL_INTERVAL_MS, {
+      integer: true,
+      min: 1
+    }), "getLockPollIntervalMs");
     __name(createFlushableState, "createFlushableState");
     __name(isWritableUnlockedNotClosed, "isWritableUnlockedNotClosed");
     __name(isReadableUnlockedNotClosed, "isReadableUnlockedNotClosed");
@@ -18245,16 +18407,41 @@ var init_private = __esm({
   }
 });
 
+// ../core/dist/runtime/world-compatibility.js
+function assertWorldSupportsRuntimeProtocol(world) {
+  if (world.specVersion === SPEC_VERSION_CURRENT) {
+    return;
+  }
+  const supportedVersion = world.specVersion ?? "none";
+  throw new WorkflowRuntimeError(`This Workflow runtime requires a World with matching spec version ${SPEC_VERSION_CURRENT}, but the configured World declares spec version ${supportedVersion}. Install a World package version compatible with the current Workflow runtime.`);
+}
+var init_world_compatibility = __esm({
+  "../core/dist/runtime/world-compatibility.js"() {
+    "use strict";
+    init_dist2();
+    init_dist4();
+    __name(assertWorldSupportsRuntimeProtocol, "assertWorldSupportsRuntimeProtocol");
+  }
+});
+
 // ../core/dist/runtime/get-world-lazy.js
 async function getWorldLazy() {
   const g = globalThis;
-  if (g[WorldCacheKey]) return g[WorldCacheKey];
+  if (g[WorldCacheKey]) {
+    assertWorldSupportsRuntimeProtocol(g[WorldCacheKey]);
+    return g[WorldCacheKey];
+  }
   if (g[WorldCachePromiseKey]) {
     g[WorldCacheKey] = await g[WorldCachePromiseKey];
+    assertWorldSupportsRuntimeProtocol(g[WorldCacheKey]);
     return g[WorldCacheKey];
   }
   const getWorldFn = g[GetWorldFnKey];
-  if (getWorldFn) return getWorldFn();
+  if (getWorldFn) {
+    const world = await getWorldFn();
+    assertWorldSupportsRuntimeProtocol(world);
+    return world;
+  }
   const worldPath = [
     "./world",
     "js"
@@ -18266,6 +18453,7 @@ var WorldCacheKey, WorldCachePromiseKey, GetWorldFnKey;
 var init_get_world_lazy = __esm({
   "../core/dist/runtime/get-world-lazy.js"() {
     "use strict";
+    init_world_compatibility();
     WorldCacheKey = /* @__PURE__ */ Symbol.for("@workflow/world//cache");
     WorldCachePromiseKey = /* @__PURE__ */ Symbol.for("@workflow/world//cachePromise");
     GetWorldFnKey = /* @__PURE__ */ Symbol.for("@workflow/world//getWorldFn");
@@ -21940,6 +22128,7 @@ var EventConsumerResult;
 var init_events_consumer = __esm({
   "../core/dist/events-consumer.js"() {
     "use strict";
+    init_dist4();
     init_logger();
     (function(EventConsumerResult2) {
       EventConsumerResult2[EventConsumerResult2["Consumed"] = 0] = "Consumed";
@@ -24056,7 +24245,7 @@ var version2;
 var init_version = __esm({
   "../core/dist/version.js"() {
     "use strict";
-    version2 = "5.0.0-beta.26";
+    version2 = "5.0.0-beta.27";
   }
 });
 
@@ -25791,14 +25980,16 @@ function createReconnectingFramedStream(runId, name, startIndex) {
     currentStartIndex += consumedFrames;
     consumedFrames = 0;
     buffer2 = new Uint8Array(0);
+    const maxReconnects = getFramedStreamMaxReconnects();
+    const maxTotalReconnects = getFramedStreamMaxTotalReconnects();
     for (; ; ) {
       reconnectCount++;
       totalReconnectCount++;
-      if (reconnectCount > FRAMED_STREAM_MAX_RECONNECTS) {
-        throw new Error(`Stream "${name}" exceeded maximum reconnection attempts (${FRAMED_STREAM_MAX_RECONNECTS})`);
+      if (reconnectCount > maxReconnects) {
+        throw new Error(`Stream "${name}" exceeded maximum reconnection attempts (${maxReconnects})`);
       }
-      if (totalReconnectCount > FRAMED_STREAM_MAX_TOTAL_RECONNECTS) {
-        throw new Error(`Stream "${name}" exceeded maximum total reconnection attempts (${FRAMED_STREAM_MAX_TOTAL_RECONNECTS})`);
+      if (totalReconnectCount > maxTotalReconnects) {
+        throw new Error(`Stream "${name}" exceeded maximum total reconnection attempts (${maxTotalReconnects})`);
       }
       try {
         await connect();
@@ -26691,11 +26882,12 @@ function getStreamAndRequestRevivers(allRevivers) {
   }
   return extra;
 }
-var defaultUlid, FRAME_HEADER_SIZE, MAX_FRAME_SIZE, WorkflowServerReadableStream, FRAMED_STREAM_MAX_RECONNECTS, FRAMED_STREAM_MAX_TOTAL_RECONNECTS, STREAM_FLUSH_INTERVAL_MS, WorkflowServerWritableStream, STREAM_AND_REQUEST_KEYS;
+var defaultUlid, FRAME_HEADER_SIZE, MAX_FRAME_SIZE, WorkflowServerReadableStream, FRAMED_STREAM_MAX_RECONNECTS, getFramedStreamMaxReconnects, FRAMED_STREAM_MAX_TOTAL_RECONNECTS, getFramedStreamMaxTotalReconnects, STREAM_FLUSH_INTERVAL_MS, getStreamFlushIntervalMs, WorkflowServerWritableStream, STREAM_AND_REQUEST_KEYS;
 var init_serialization2 = __esm({
   "../core/dist/serialization.js"() {
     "use strict";
     init_dist2();
+    init_dist4();
     init_devalue();
     init_node();
     init_encryption();
@@ -26771,9 +26963,20 @@ var init_serialization2 = __esm({
       }
     };
     FRAMED_STREAM_MAX_RECONNECTS = 50;
+    getFramedStreamMaxReconnects = /* @__PURE__ */ __name(() => envNumber("WORKFLOW_FRAMED_STREAM_MAX_RECONNECTS", FRAMED_STREAM_MAX_RECONNECTS, {
+      integer: true,
+      min: 1
+    }), "getFramedStreamMaxReconnects");
     FRAMED_STREAM_MAX_TOTAL_RECONNECTS = 1e3;
+    getFramedStreamMaxTotalReconnects = /* @__PURE__ */ __name(() => envNumber("WORKFLOW_FRAMED_STREAM_MAX_TOTAL_RECONNECTS", FRAMED_STREAM_MAX_TOTAL_RECONNECTS, {
+      integer: true,
+      min: 1
+    }), "getFramedStreamMaxTotalReconnects");
     __name(createReconnectingFramedStream, "createReconnectingFramedStream");
     STREAM_FLUSH_INTERVAL_MS = 10;
+    getStreamFlushIntervalMs = /* @__PURE__ */ __name(() => envNumber("WORKFLOW_STREAM_FLUSH_INTERVAL_MS", STREAM_FLUSH_INTERVAL_MS, {
+      integer: true
+    }), "getStreamFlushIntervalMs");
     WorkflowServerWritableStream = class extends WritableStream {
       static {
         __name(this, "WorkflowServerWritableStream");
@@ -26819,7 +27022,7 @@ var init_serialization2 = __esm({
           const chunksToFlush = buffer2.slice();
           const world = await worldPromise;
           if (resolvedFlushIntervalMs === void 0) {
-            resolvedFlushIntervalMs = world.streamFlushIntervalMs ?? STREAM_FLUSH_INTERVAL_MS;
+            resolvedFlushIntervalMs = world.streamFlushIntervalMs ?? getStreamFlushIntervalMs();
           }
           if (typeof world.streams.writeMulti === "function" && chunksToFlush.length > 1) {
             await world.streams.writeMulti(runId, name, chunksToFlush);
@@ -26842,7 +27045,7 @@ var init_serialization2 = __esm({
             }, (err) => {
               for (const w of currentWaiters) w.reject(err);
             });
-          }, resolvedFlushIntervalMs ?? STREAM_FLUSH_INTERVAL_MS);
+          }, resolvedFlushIntervalMs ?? getStreamFlushIntervalMs());
         }, "scheduleFlush");
         super({
           async write(chunk) {
@@ -27110,6 +27313,7 @@ init_version();
 init_get_world_lazy();
 init_helpers();
 init_wait_until();
+init_world_compatibility();
 var CROSS_DEPLOYMENT_CAPABILITY_PROBE_TIMEOUT_MS = 2e3;
 var ulid3 = monotonicFactory();
 var hasWarnedLatestNoOp = false;
@@ -27137,7 +27341,8 @@ async function start(workflow, argsOrOptions, options) {
       span?.setAttributes({
         ...WorkflowArgumentsCount(args.length)
       });
-      const world = opts?.world ?? await getWorldLazy();
+      const world = opts.world ?? await getWorldLazy();
+      assertWorldSupportsRuntimeProtocol(world);
       const currentDeploymentId = await world.getDeploymentId();
       let deploymentId = opts.deploymentId ?? currentDeploymentId;
       if (deploymentId === "latest") {
@@ -27173,7 +27378,7 @@ async function start(workflow, argsOrOptions, options) {
       const ops = [];
       const runId = `wrun_${ulid3()}`;
       const traceCarrier = await serializeTraceCarrier();
-      const specVersion = opts.specVersion ?? world.specVersion ?? SPEC_VERSION_SUPPORTS_EVENT_SOURCING;
+      const specVersion = opts.specVersion ?? world.specVersion;
       const v1Compat = isLegacySpecVersion(specVersion);
       const allowReservedAttributes = opts.allowReservedAttributes === true;
       let attributes;
@@ -27297,7 +27502,7 @@ __name(start, "start");
     value: "start",
     configurable: true
   });
-})(start, "step//@workflow/core/runtime/start@5.0.0-beta.26//start");
+})(start, "step//@workflow/core/runtime/start@5.0.0-beta.27//start");
 
 // ../core/dist/runtime/runs.js
 async function wakeUpRun(world, runId, options) {
@@ -27624,7 +27829,7 @@ var Run = class _Run {
     value: "wakeUp",
     configurable: true
   });
-})(Run.prototype["wakeUp"], "step//@workflow/core/runtime/run@5.0.0-beta.26//Run#wakeUp");
+})(Run.prototype["wakeUp"], "step//@workflow/core/runtime/run@5.0.0-beta.27//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);
@@ -27633,7 +27838,7 @@ var Run = class _Run {
     value: "cancel",
     configurable: true
   });
-})(Run.prototype["cancel"], "step//@workflow/core/runtime/run@5.0.0-beta.26//Run#cancel");
+})(Run.prototype["cancel"], "step//@workflow/core/runtime/run@5.0.0-beta.27//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);
@@ -27642,7 +27847,7 @@ var Run = class _Run {
     value: "getReadable",
     configurable: true
   });
-})(Run.prototype["getReadable"], "step//@workflow/core/runtime/run@5.0.0-beta.26//Run#getReadable");
+})(Run.prototype["getReadable"], "step//@workflow/core/runtime/run@5.0.0-beta.27//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);
@@ -27651,7 +27856,7 @@ var Run = class _Run {
     value: "exists",
     configurable: true
   });
-})(Object.getOwnPropertyDescriptor(Run.prototype, "exists").get, "step//@workflow/core/runtime/run@5.0.0-beta.26//Run#exists");
+})(Object.getOwnPropertyDescriptor(Run.prototype, "exists").get, "step//@workflow/core/runtime/run@5.0.0-beta.27//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);
@@ -27660,7 +27865,7 @@ var Run = class _Run {
     value: "status",
     configurable: true
   });
-})(Object.getOwnPropertyDescriptor(Run.prototype, "status").get, "step//@workflow/core/runtime/run@5.0.0-beta.26//Run#status");
+})(Object.getOwnPropertyDescriptor(Run.prototype, "status").get, "step//@workflow/core/runtime/run@5.0.0-beta.27//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);
@@ -27669,7 +27874,7 @@ var Run = class _Run {
     value: "returnValue",
     configurable: true
   });
-})(Object.getOwnPropertyDescriptor(Run.prototype, "returnValue").get, "step//@workflow/core/runtime/run@5.0.0-beta.26//Run#returnValue");
+})(Object.getOwnPropertyDescriptor(Run.prototype, "returnValue").get, "step//@workflow/core/runtime/run@5.0.0-beta.27//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);
@@ -27678,7 +27883,7 @@ var Run = class _Run {
     value: "workflowName",
     configurable: true
   });
-})(Object.getOwnPropertyDescriptor(Run.prototype, "workflowName").get, "step//@workflow/core/runtime/run@5.0.0-beta.26//Run#workflowName");
+})(Object.getOwnPropertyDescriptor(Run.prototype, "workflowName").get, "step//@workflow/core/runtime/run@5.0.0-beta.27//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);
@@ -27687,7 +27892,7 @@ var Run = class _Run {
     value: "createdAt",
     configurable: true
   });
-})(Object.getOwnPropertyDescriptor(Run.prototype, "createdAt").get, "step//@workflow/core/runtime/run@5.0.0-beta.26//Run#createdAt");
+})(Object.getOwnPropertyDescriptor(Run.prototype, "createdAt").get, "step//@workflow/core/runtime/run@5.0.0-beta.27//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);
@@ -27696,7 +27901,7 @@ var Run = class _Run {
     value: "startedAt",
     configurable: true
   });
-})(Object.getOwnPropertyDescriptor(Run.prototype, "startedAt").get, "step//@workflow/core/runtime/run@5.0.0-beta.26//Run#startedAt");
+})(Object.getOwnPropertyDescriptor(Run.prototype, "startedAt").get, "step//@workflow/core/runtime/run@5.0.0-beta.27//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);
@@ -27705,7 +27910,7 @@ var Run = class _Run {
     value: "completedAt",
     configurable: true
   });
-})(Object.getOwnPropertyDescriptor(Run.prototype, "completedAt").get, "step//@workflow/core/runtime/run@5.0.0-beta.26//Run#completedAt");
+})(Object.getOwnPropertyDescriptor(Run.prototype, "completedAt").get, "step//@workflow/core/runtime/run@5.0.0-beta.27//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);
@@ -27715,7 +27920,7 @@ var Run = class _Run {
     enumerable: false,
     configurable: false
   });
-})(Run, "class//@workflow/core/runtime/run@5.0.0-beta.26//Run");
+})(Run, "class//@workflow/core/runtime/run@5.0.0-beta.27//Run");
 
 // ../workflow/dist/stdlib.js
 async function fetch2(...args) {