@workflow/core 5.0.0-beta.35 → 5.0.0-beta.36

package/docs/api-reference/fetch.mdx

@@ -93,7 +93,7 @@ This API is provided as a convenience to easily use `fetch` in workflow, but oft
 
 ### Customizing Fetch Behavior
 
-Here's an example of a custom fetch wrapper that provides more sophisticated error handling with custom retry logic:
+Here's an example of a custom fetch wrapper that provides more sophisticated error handling with custom retry logic. Call `globalThis.fetch` inside your own `"use step"` function — calling the workflow `fetch` imported from `workflow` would nest a step inside a step:
 
 ```typescript lineNumbers
 import { FatalError, RetryableError } from "workflow"
@@ -104,7 +104,7 @@ export async function customFetch(
 ) {
     "use step"
 
-    const response = await fetch(url, init)
+    const response = await globalThis.fetch(url, init)
 
     // Handle client errors (4xx) - don't retry
     if (response.status >= 400 && response.status < 500) {
@@ -145,7 +145,6 @@ export async function customFetch(
 
 This example demonstrates:
 
-- Setting custom `maxRetries` to 5 retries (6 total attempts including the initial attempt).
 - Throwing [`FatalError`](/docs/api-reference/workflow/fatal-error) for client errors (400-499) to prevent retries.
 - Handling 429 rate limiting by reading the `Retry-After` header and using [`RetryableError`](/docs/api-reference/workflow/retryable-error).
-- Allowing automatic retries for server errors (5xx).
+- Allowing automatic retries for server errors (5xx) by throwing a plain `Error`.

package/docs/api-reference/sleep.mdx

@@ -14,7 +14,7 @@ Suspends a workflow for a specified duration or until an end date without consum
 This is useful when you want to resume a workflow after some duration or date.
 
 <Callout>
-`sleep` is a *special* type of step function and should be called directly inside workflow functions.
+`sleep` is a built-in workflow runtime function (backed by a timer event in the event log, not a step) and should be called directly inside workflow functions.
 </Callout>
 
 ```typescript lineNumbers

package/docs/foundations/hooks.mdx

@@ -112,7 +112,7 @@ export async function orderWorkflow(orderId: string) {
 }
 ```
 
-Calling `createHook()` on its own does not register the hook — registration is only committed when the workflow suspends. Awaiting `hook.getConflict()` suspends the workflow to commit the hook registration, then resolves with `null` once the hook is registered and ready to receive payloads, or with a `Run` handle for the run that owns the token if another active hook already claimed it (see [`HookConflictError`](/docs/errors/hook-conflict)). For `hook_conflict` events persisted by older worlds that did not record the owning run's ID, `getConflict()` rejects with `HookConflictError` instead of resolving with an incomplete handle. The conflicting run's accessors are durable steps, so the workflow can inspect `await conflict.status`, wait on `await conflict.returnValue`, or cancel the owner with `await conflict.cancel()` — see [Run idempotency](/docs/foundations/idempotency#run-idempotency) for these strategies.
+Calling `createHook()` on its own does not register the hook — registration is only committed when the workflow suspends. Awaiting `hook.getConflict()` suspends the workflow to commit the hook registration, then resolves with `null` once the hook is registered and ready to receive payloads, or with a `Run` handle for the run that owns the token (see [`HookConflictError`](/docs/errors/hook-conflict)). For `hook_conflict` events persisted by older worlds that did not record the owning run's ID, `getConflict()` rejects with `HookConflictError` instead of resolving with an incomplete handle. The conflicting run's accessors are durable steps, so the workflow can inspect `await conflict.status`, wait on `await conflict.returnValue`, or cancel the owner with `await conflict.cancel()` — see [Run idempotency](/docs/foundations/idempotency#run-idempotency) for these strategies.
 
 ### Custom Tokens for Deterministic Hooks
 

package/docs/foundations/idempotency.mdx

@@ -96,7 +96,7 @@ export async function processOrder(orderId: string): Promise<OrderResult> {
 }
 ```
 
-The runtime creates the hook atomically. At most one active hook can own `order:${orderId}`, so duplicate workflow runs converge on one active owner. A duplicate run observes `getConflict()` resolving with the owner's `Run` and returns before it reaches `chargeOrder()`. The conflicting run's accessors (`status`, `returnValue`, `cancel()`, …) are durable steps, so the duplicate run can do more than report the owner — see [conflict-handling strategies](#conflict-handling-strategies) below.
+The runtime creates the hook atomically. At most one hook can own `order:${orderId}`, so duplicate workflow runs converge on one owner. A duplicate run observes `getConflict()` resolving with the owner's `Run` and returns before it reaches `chargeOrder()`. The conflicting run's accessors (`status`, `returnValue`, `cancel()`, …) are durable steps, so the duplicate run can do more than report the owner — see [conflict-handling strategies](#conflict-handling-strategies) below.
 
 Outside the workflow, try to resume the hook first. If the hook is not registered yet, start the workflow and retry the resume until the new run creates the hook:
 
@@ -149,7 +149,7 @@ export async function POST(request: Request) {
 This avoids creating a new run only after the first run has registered its hook. Because `start()` returns before the run body executes and calls `createHook()`, two concurrent requests can both observe "no hook yet" and each call `start()`. The race is resolved inside the workflow body, where the losing run observes `getConflict()` resolving with the active owner and returns without doing duplicate-sensitive work — and the route detects it by comparing the resumed hook's `runId` against the run it just started, without waiting for either run to finish. A native API for atomically starting a run and registering a hook is in the works. Until then, model recovery inside the workflow by checking `hook.getConflict()`.
 </Callout>
 
-This is active-run coordination. When the workflow completes and disposes the hook, the token can be used again. If a duplicate request after completion must return the original result instead of starting fresh work, persist that completed result under the same domain key.
+This coordinates active runs by default: the token becomes available when its workflow ends. Set `experimental_minRetention` to keep it unavailable to late duplicates. After the workflow ends, the Hook can still be found with `getHookByToken()` until retention ends, but it cannot be resumed. See [`createHook()` minimum retention](/docs/api-reference/workflow/create-hook#keep-a-token-unavailable-after-the-run-ends) for examples and supported values.
 
 ### Conflict-handling strategies
 
@@ -182,7 +182,7 @@ export async function processOrder(orderId: string) {
 }
 ```
 
-**Inspect the owner before deciding.** Branch on the owner's live state:
+**Inspect the owner before deciding.** Reuse a completed owner's result, but reject other duplicates:
 
 ```typescript lineNumbers
 import { createHook } from "workflow";
@@ -200,17 +200,17 @@ export async function processOrder(orderId: string) {
   const conflict = await request.getConflict();
   if (conflict) {
     const status = await conflict.status; // [!code highlight]
-    if (status === "running") {
-      return { status: "duplicate" as const, runId: conflict.runId };
+    if (status === "completed") {
+      return await conflict.returnValue;
     }
-    // Owner already reached a terminal state; its hook will be released.
+    return { status: "duplicate" as const, runId: conflict.runId };
   }
 
   return await processOwnedOrder(orderId);
 }
 ```
 
-**Signal the owner instead of doing the work.** The duplicate run knows the token, so it can deliver this run's input to the owner's hook from a step:
+**Signal the owner instead of doing the work.** A conflict can refer to a finished run when `experimental_minRetention` is set, so check its status before sending data to its Hook:
 
 ```typescript lineNumbers
 import { createHook } from "workflow";
@@ -230,16 +230,19 @@ export async function processOrder(orderId: string, confirmed: boolean) {
   using request = createHook<OrderRequest>({ token });
 
   const conflict = await request.getConflict();
-  if (conflict) {
+  if (conflict && ["pending", "running"].includes(await conflict.status)) {
     await forwardToOwner(token, { confirmed }); // [!code highlight]
     return { status: "forwarded" as const, runId: conflict.runId };
   }
+  if (conflict) {
+    return { status: "duplicate" as const, runId: conflict.runId };
+  }
 
   // ... own the token and do the work
 }
 ```
 
-**Supersede the owner.** Newest-wins: cancel the active run, then claim the released token. Cancellation disposes the owner's hooks; the retry loop covers the window where that disposal has not propagated yet:
+**Supersede the owner.** Without minimum retention, cancel the active run, then claim the released token. The retry loop covers the window where cancellation cleanup has not propagated yet:
 
 ```typescript lineNumbers
 import { createHook } from "workflow";
@@ -272,6 +275,10 @@ export async function processOrderNewestWins(orderId: string) {
 }
 ```
 
+<Callout type="warn">
+This pattern does not work with `experimental_minRetention`: cancelling the old run does not make its token available early.
+</Callout>
+
 If duplicate requests should only reuse the active run without sending data, use [`getHookByToken()`](/docs/api-reference/workflow-api/get-hook-by-token) as an advisory pre-check before calling `start()`. The workflow should still check `hook.getConflict()`, because the lookup and `start()` are not atomic.
 
 Because this pattern uses hooks for idempotency, duplicate requests can also inject additional data and steer the existing run. The route example above uses `resumeHook()` for that: if the hook already exists, the duplicate request resumes the active workflow; if the hook is not registered yet, the route starts the workflow and retries `resumeHook()` so the payload is not dropped.

package/docs/how-it-works/encryption.mdx

@@ -7,7 +7,7 @@ prerequisites:
   - /docs/how-it-works/event-sourcing
 related:
   - /docs/observability
-  - /docs/deploying/world/vercel-world
+  - /worlds/vercel
 ---
 
 <Callout>
@@ -38,7 +38,7 @@ Metadata such as workflow names, step names, entity IDs, timestamps, and lifecyc
 
 Each workflow run is encrypted with its own unique key, provided by the `World` implementation via `getEncryptionKeyForRun()`. How the key is generated and stored is up to the `World`.
 
-For example, the [Vercel World](/docs/deploying/world/vercel-world) provides unique keys per run and execution environment, ensuring that a given run can only decrypt data from that run itself.
+For example, the [Vercel World](/worlds/vercel) provides unique keys per run and execution environment, ensuring that a given run can only decrypt data from that run itself.
 
 ### Encryption Algorithm
 
@@ -127,4 +127,4 @@ async function lookupRunKey(
 }
 ```
 
-The [Vercel World](/docs/deploying/world/vercel-world) implementation uses HKDF derivation from a deployment-scoped key, but any consistent key management scheme will work.
+The [Vercel World](/worlds/vercel) implementation uses HKDF derivation from a deployment-scoped key, but any consistent key management scheme will work.

package/docs/how-it-works/event-sourcing.mdx

@@ -121,15 +121,15 @@ flowchart TD
 
 **Hook states:**
 
-- `active`: Ready to receive payloads (hook exists in storage)
-- `disposed`: No longer accepting payloads (hook is deleted from storage)
+- `active`: Ready to receive payloads
+- `disposed`: No longer accepting payloads
 - `conflicted`: Hook creation failed because the token is already in use by another workflow
 
-Unlike other entities, hooks don't have a `status` field—the states above are conceptual. An "active" hook is one that exists in storage, while "disposed" means the hook has been deleted. When a `hook_disposed` event is created, the hook record is removed rather than updated.
+Unlike other entities, hooks don't have a `status` field—the states above are conceptual. When a `hook_disposed` event is created, the hook record is removed rather than updated.
 
-While a hook is active, its token is reserved and cannot be used by other workflows. If a workflow attempts to create a hook with a token that is already in use by another active hook, a `hook_conflict` event is recorded instead of `hook_created`. Current worlds include the token and the run ID that currently owns it, though older persisted events or world implementations may only include the token. This causes `hook.getConflict()` to resolve with the conflicting run and the hook's payload promise to reject with a `HookConflictError`, which you can detect with `HookConflictError.is(error)`. See the [hook-conflict error](/docs/errors/hook-conflict) documentation for more details.
+While a hook is active, its token is reserved and cannot be used by other workflows. If a workflow attempts to create a hook with a token reserved by another run — either by an active hook or by `experimental_minRetention` after its run ended — a `hook_conflict` event is recorded instead of `hook_created`. Current worlds include the token and the run ID that owns it, though older persisted events or world implementations may only include the token. This causes `hook.getConflict()` to resolve with the conflicting run and the hook's payload promise to reject with a `HookConflictError`, which you can detect with `HookConflictError.is(error)`. See the [hook-conflict error](/docs/errors/hook-conflict) documentation for more details.
 
-When a hook is disposed (either explicitly or when its workflow completes), the token is released and can be claimed by future workflows. Hooks are automatically disposed when a workflow reaches a terminal state (`completed`, `failed`, or `cancelled`). The `hook_disposed` event is only needed for explicit disposal before workflow completion.
+When a workflow ends, its Hooks can no longer be resumed. They are normally removed and their tokens become available again. With `experimental_minRetention`, a Hook remains readable and its token remains unavailable until retention ends. A `hook_disposed` event removes the Hook and makes its token available immediately.
 
 See [Hooks & Webhooks](/docs/foundations/hooks) for more on how hooks and webhooks work.
 
@@ -188,7 +188,7 @@ Events are categorized by the entity type they affect. Each event contains metad
 | Event | Description |
 |-------|-------------|
 | `hook_created` | Creates a new hook in `active` state. Contains the hook token and optional metadata. |
-| `hook_conflict` | Records that hook creation failed because the token is already in use by another active hook. Contains the token and, for current worlds, the active hook owner's run ID. The hook is not created: `hook.getConflict()` resolves with the conflicting run, and awaiting the hook payload rejects with a `HookConflictError`. |
+| `hook_conflict` | Records that hook creation failed because another run owns the token. Contains the token and, for current worlds, the owner's run ID. The hook is not created: `hook.getConflict()` resolves with the conflicting run, and awaiting the hook payload rejects with a `HookConflictError`. |
 | `hook_received` | Records that a payload was delivered to the hook. The hook remains `active` and can receive more payloads. |
 | `hook_disposed` | Deletes the hook from storage (conceptually transitioning to `disposed` state). The token is released for reuse by future workflows. |
 

package/docs/how-it-works/framework-integrations.mdx

@@ -6,7 +6,7 @@ summary: Build a custom framework integration using the Workflow SDK compiler an
 prerequisites:
   - /docs/foundations/workflows-and-steps
 related:
-  - /docs/deploying/building-a-world
+  - /worlds/building-a-world
 ---
 
 <Callout>
@@ -425,7 +425,7 @@ For self-hosted or non-Vercel deployments, you are responsible for securing the
 - **Network-level security** — Deploy handlers behind a VPC, private network, or firewall rules so only your queue infrastructure can reach them
 - **Rate limiting** — Add request validation and rate limiting to prevent abuse
 
-Learn more about [building custom Worlds](/docs/deploying/building-a-world).
+Learn more about [building custom Worlds](/worlds/building-a-world).
 
 ## Testing Your Integration
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@workflow/core",
-  "version": "5.0.0-beta.35",
+  "version": "5.0.0-beta.36",
   "description": "Core runtime and engine for Workflow SDK",
   "type": "module",
   "main": "dist/index.js",
@@ -98,12 +98,12 @@
     "semver": "7.7.4",
     "ulid": "~3.0.1",
     "zod": "~4.3.6",
-    "@workflow/errors": "5.0.0-beta.11",
+    "@workflow/errors": "5.0.0-beta.12",
     "@workflow/serde": "5.0.0-beta.2",
     "@workflow/utils": "5.0.0-beta.6",
-    "@workflow/world": "5.0.0-beta.21",
-    "@workflow/world-local": "5.0.0-beta.29",
-    "@workflow/world-vercel": "5.0.0-beta.31"
+    "@workflow/world": "5.0.0-beta.22",
+    "@workflow/world-local": "5.0.0-beta.30",
+    "@workflow/world-vercel": "5.0.0-beta.32"
   },
   "devDependencies": {
     "@opentelemetry/api": "1.9.0",

package/dist/step-hydration-cache.d.ts

@@ -1,148 +0,0 @@
-/**
- * Per-run memoization cache for hydrated step return values.
- *
- * ## Why
- *
- * The inline replay loop (`runtime.ts`) re-runs the workflow body from the top
- * on every iteration, re-consuming the full event log each time. For every
- * already-completed step, the step consumer (`step.ts`) re-runs
- * `hydrateStepReturnValue` — which AES-GCM-decrypts and devalue-parses the
- * serialized result — even though that exact result was already hydrated on
- * every prior replay. For a sequential workflow of N steps, replay K hydrates
- * K results, so the total work across a single invocation is O(N²)
- * decrypt+parse operations.
- *
- * This cache makes a completed step's hydrated result available in O(1) on
- * subsequent replays within the SAME invocation, turning the aggregate cost
- * into O(N).
- *
- * ## Scope / lifetime
- *
- * The cache is owned by the inline loop in `runtime.ts` (one per workflow run
- * invocation) and passed into `runWorkflow` so it survives across the loop's
- * iterations but never leaks across unrelated runs or process-level
- * invocations. A fresh `runWorkflow` / `WorkflowOrchestratorContext` is created
- * each iteration, so the cache must live OUTSIDE the per-iteration context.
- *
- * ## Keying
- *
- * Entries are keyed by the persisted event's `eventId` — a stable,
- * world-assigned identifier for the `step_completed` event whose serialized
- * `result` is being hydrated. The same event (same `eventId`) carries the same
- * immutable serialized bytes across every replay, so a hit is guaranteed to
- * correspond to the identical input.
- *
- * ## Identity safety (why primitives only)
- *
- * `hydrateStepReturnValue` (devalue.parse) produces a FRESH object graph on
- * every call, and each replay iteration runs in a FRESH workflow VM. The
- * current (uncached) behavior therefore hands the workflow a brand-new value
- * on every replay. If we cached and returned the SAME object reference across
- * replays, workflow code that mutates a step result (`const r = await step();
- * r.count++`) would observe the mutation from a previous replay on the next
- * replay — a non-deterministic divergence. Structured-cloning on each hit is
- * both lossy (revivers reconstruct stream handles, step-function proxies,
- * Request/Response, and AbortController/AbortSignal class instances that don't
- * survive a structured clone) and still O(size).
- *
- * So we only cache values for which returning the same reference on every
- * replay is provably indistinguishable from re-hydrating: JavaScript
- * primitives (string, number, boolean, bigint, symbol, null, undefined).
- * Primitives are immutable and compared by value, so sharing the reference is
- * byte-for-byte equivalent to re-parsing. Any non-primitive result falls
- * through to a full re-hydrate every replay, preserving current behavior
- * exactly. This trades some of the optimization away in the object-returning
- * case in exchange for keeping deterministic replay airtight.
- *
- * ## Memory characteristic
- *
- * Cached entries hold the decrypted/devalue-parsed *plaintext* of a step
- * result, which is retained for the rest of the invocation on top of the
- * serialized bytes already held in `cachedEvents`. So the residual cost is:
- *
- * - **Scoped to one workflow-run invocation.** A fresh `Map` is created per
- *   invocation (in `runtime.ts`) and is unreachable / GC'd when the invocation
- *   returns. Nothing accumulates across runs or across process-level
- *   invocations.
- * - **Bounded by the number of primitive-returning completed steps in that
- *   run** — at most one small entry per such step.
- * - **Primitives only, and additionally byte-bounded.** Most primitives
- *   (numbers, booleans, null/undefined, symbols, short ids/strings) are tiny
- *   and fixed-size. The only primitive that can be large is a string (or a
- *   pathologically long bigint), so to keep the doubled-residency worst case
- *   bounded we *do not* memoize string/bigint results whose character length
- *   exceeds {@link MAX_MEMOIZED_PRIMITIVE_LENGTH}. A large string is cheap to
- *   re-hydrate relative to its footprint, so letting it fall through to the
- *   existing per-replay re-hydrate path costs little and caps peak retained
- *   memory.
- *
- * (This is a much weaker concern than a *process-wide* cache: the dominant
- * residency — the full event log in `cachedEvents` — already exists for the
- * same lifetime, and everything here is freed together with it when the
- * invocation ends.)
- */
-/**
- * Upper bound, in characters, on a string/bigint primitive that may be
- * memoized. Beyond this, the value falls through to a fresh re-hydrate on every
- * replay so the cache never holds a large plaintext payload for the lifetime of
- * the invocation. 4 KiB comfortably covers ids, counts, flags, and typical
- * short string results while excluding the large-payload case the bound exists
- * to guard. Other primitive types (number, boolean, symbol, null, undefined)
- * are inherently small and are never length-checked.
- */
-export declare const MAX_MEMOIZED_PRIMITIVE_LENGTH = 4096;
-/**
- * Returns true for values that are safe to memoize and return by reference
- * across replays: JS primitives. Objects and functions are excluded because
- * sharing a mutable reference across replays could change observable behavior.
- *
- * Strings and bigints are additionally bounded by length: a value longer than
- * {@link MAX_MEMOIZED_PRIMITIVE_LENGTH} characters is treated as non-memoizable
- * so the cache never retains a large plaintext payload for the whole invocation
- * (see the module-level "Memory characteristic" docs). It re-hydrates fresh on
- * every replay instead — cheap relative to its footprint.
- *
- * Note: `typeof null === 'object'`, so it is handled explicitly. `undefined`,
- * `string`, `number`, `boolean`, `bigint`, and `symbol` are all primitives.
- */
-export declare function isMemoizablePrimitive(value: unknown): boolean;
-/**
- * Cache of hydrated step return values for a single workflow run invocation.
- *
- * Keyed by `step_completed` event id; the value is the already-hydrated
- * primitive result. Only successful, primitive hydrations are stored (see
- * {@link getOrHydrateStepReturnValue}), so a non-`undefined` `has(eventId)`
- * always means "this step completed with a memoizable primitive value".
- */
-export type StepHydrationCache = Map<string, unknown>;
-/**
- * Create an empty per-invocation step hydration cache.
- */
-export declare function createStepHydrationCache(): StepHydrationCache;
-/**
- * Return the hydrated step result for `eventId`, using `cache` as a per-run
- * memo. On a hit, the cached primitive is returned without re-running the
- * expensive decrypt + devalue-parse. On a miss, `hydrate()` runs and its
- * result is memoized only when it is a small primitive (see the module docs for
- * the identity-safety rationale and the length bound on string/bigint results).
- *
- * This always returns a `Promise` and `await`s `hydrate()` even on the miss
- * path, so the caller's `await` inside its serial `promiseQueue` slot keeps the
- * same scheduling on both hit and miss — a cache hit resolves through the exact
- * same promise-chain position a re-hydrate would have, preserving the
- * deterministic delivery order that `pendingDeliveries`, the delivery barriers,
- * and `Promise.race`/`Promise.all` replay all depend on.
- *
- * `has(eventId)` is used rather than `get(eventId) !== undefined` so that a
- * legitimately memoized `undefined` step result still registers as a hit.
- *
- * When `cache` or `eventId` is absent (lightweight test harnesses, or a context
- * that predates this plumbing), this degrades to calling `hydrate()` directly
- * with no memoization — identical to the previous behavior.
- *
- * Errors are intentionally never cached: a rejected hydrate propagates to the
- * caller (which rejects the step promise) and the next replay re-attempts it,
- * matching the uncached behavior and avoiding a parked rejected promise.
- */
-export declare function getOrHydrateStepReturnValue(cache: StepHydrationCache | undefined, eventId: string | undefined, hydrate: () => Promise<unknown>): Promise<unknown>;
-//# sourceMappingURL=step-hydration-cache.d.ts.map

package/dist/step-hydration-cache.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"step-hydration-cache.d.ts","sourceRoot":"","sources":["../src/step-hydration-cache.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkFG;AAEH;;;;;;;;GAQG;AACH,eAAO,MAAM,6BAA6B,OAAO,CAAC;AAElD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAY7D;AAED;;;;;;;GAOG;AACH,MAAM,MAAM,kBAAkB,GAAG,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAEtD;;GAEG;AACH,wBAAgB,wBAAwB,IAAI,kBAAkB,CAE7D;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAsB,2BAA2B,CAC/C,KAAK,EAAE,kBAAkB,GAAG,SAAS,EACrC,OAAO,EAAE,MAAM,GAAG,SAAS,EAC3B,OAAO,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,GAC9B,OAAO,CAAC,OAAO,CAAC,CAkBlB"}

package/dist/step-hydration-cache.js

@@ -1,171 +0,0 @@
-/**
- * Per-run memoization cache for hydrated step return values.
- *
- * ## Why
- *
- * The inline replay loop (`runtime.ts`) re-runs the workflow body from the top
- * on every iteration, re-consuming the full event log each time. For every
- * already-completed step, the step consumer (`step.ts`) re-runs
- * `hydrateStepReturnValue` — which AES-GCM-decrypts and devalue-parses the
- * serialized result — even though that exact result was already hydrated on
- * every prior replay. For a sequential workflow of N steps, replay K hydrates
- * K results, so the total work across a single invocation is O(N²)
- * decrypt+parse operations.
- *
- * This cache makes a completed step's hydrated result available in O(1) on
- * subsequent replays within the SAME invocation, turning the aggregate cost
- * into O(N).
- *
- * ## Scope / lifetime
- *
- * The cache is owned by the inline loop in `runtime.ts` (one per workflow run
- * invocation) and passed into `runWorkflow` so it survives across the loop's
- * iterations but never leaks across unrelated runs or process-level
- * invocations. A fresh `runWorkflow` / `WorkflowOrchestratorContext` is created
- * each iteration, so the cache must live OUTSIDE the per-iteration context.
- *
- * ## Keying
- *
- * Entries are keyed by the persisted event's `eventId` — a stable,
- * world-assigned identifier for the `step_completed` event whose serialized
- * `result` is being hydrated. The same event (same `eventId`) carries the same
- * immutable serialized bytes across every replay, so a hit is guaranteed to
- * correspond to the identical input.
- *
- * ## Identity safety (why primitives only)
- *
- * `hydrateStepReturnValue` (devalue.parse) produces a FRESH object graph on
- * every call, and each replay iteration runs in a FRESH workflow VM. The
- * current (uncached) behavior therefore hands the workflow a brand-new value
- * on every replay. If we cached and returned the SAME object reference across
- * replays, workflow code that mutates a step result (`const r = await step();
- * r.count++`) would observe the mutation from a previous replay on the next
- * replay — a non-deterministic divergence. Structured-cloning on each hit is
- * both lossy (revivers reconstruct stream handles, step-function proxies,
- * Request/Response, and AbortController/AbortSignal class instances that don't
- * survive a structured clone) and still O(size).
- *
- * So we only cache values for which returning the same reference on every
- * replay is provably indistinguishable from re-hydrating: JavaScript
- * primitives (string, number, boolean, bigint, symbol, null, undefined).
- * Primitives are immutable and compared by value, so sharing the reference is
- * byte-for-byte equivalent to re-parsing. Any non-primitive result falls
- * through to a full re-hydrate every replay, preserving current behavior
- * exactly. This trades some of the optimization away in the object-returning
- * case in exchange for keeping deterministic replay airtight.
- *
- * ## Memory characteristic
- *
- * Cached entries hold the decrypted/devalue-parsed *plaintext* of a step
- * result, which is retained for the rest of the invocation on top of the
- * serialized bytes already held in `cachedEvents`. So the residual cost is:
- *
- * - **Scoped to one workflow-run invocation.** A fresh `Map` is created per
- *   invocation (in `runtime.ts`) and is unreachable / GC'd when the invocation
- *   returns. Nothing accumulates across runs or across process-level
- *   invocations.
- * - **Bounded by the number of primitive-returning completed steps in that
- *   run** — at most one small entry per such step.
- * - **Primitives only, and additionally byte-bounded.** Most primitives
- *   (numbers, booleans, null/undefined, symbols, short ids/strings) are tiny
- *   and fixed-size. The only primitive that can be large is a string (or a
- *   pathologically long bigint), so to keep the doubled-residency worst case
- *   bounded we *do not* memoize string/bigint results whose character length
- *   exceeds {@link MAX_MEMOIZED_PRIMITIVE_LENGTH}. A large string is cheap to
- *   re-hydrate relative to its footprint, so letting it fall through to the
- *   existing per-replay re-hydrate path costs little and caps peak retained
- *   memory.
- *
- * (This is a much weaker concern than a *process-wide* cache: the dominant
- * residency — the full event log in `cachedEvents` — already exists for the
- * same lifetime, and everything here is freed together with it when the
- * invocation ends.)
- */
-/**
- * Upper bound, in characters, on a string/bigint primitive that may be
- * memoized. Beyond this, the value falls through to a fresh re-hydrate on every
- * replay so the cache never holds a large plaintext payload for the lifetime of
- * the invocation. 4 KiB comfortably covers ids, counts, flags, and typical
- * short string results while excluding the large-payload case the bound exists
- * to guard. Other primitive types (number, boolean, symbol, null, undefined)
- * are inherently small and are never length-checked.
- */
-export const MAX_MEMOIZED_PRIMITIVE_LENGTH = 4096;
-/**
- * Returns true for values that are safe to memoize and return by reference
- * across replays: JS primitives. Objects and functions are excluded because
- * sharing a mutable reference across replays could change observable behavior.
- *
- * Strings and bigints are additionally bounded by length: a value longer than
- * {@link MAX_MEMOIZED_PRIMITIVE_LENGTH} characters is treated as non-memoizable
- * so the cache never retains a large plaintext payload for the whole invocation
- * (see the module-level "Memory characteristic" docs). It re-hydrates fresh on
- * every replay instead — cheap relative to its footprint.
- *
- * Note: `typeof null === 'object'`, so it is handled explicitly. `undefined`,
- * `string`, `number`, `boolean`, `bigint`, and `symbol` are all primitives.
- */
-export function isMemoizablePrimitive(value) {
-    if (value === null)
-        return true;
-    const t = typeof value;
-    if (t === 'object' || t === 'function')
-        return false;
-    // Bound the only primitive types that can carry a large payload.
-    if (t === 'string') {
-        return value.length <= MAX_MEMOIZED_PRIMITIVE_LENGTH;
-    }
-    if (t === 'bigint') {
-        return value.toString().length <= MAX_MEMOIZED_PRIMITIVE_LENGTH;
-    }
-    return true;
-}
-/**
- * Create an empty per-invocation step hydration cache.
- */
-export function createStepHydrationCache() {
-    return new Map();
-}
-/**
- * Return the hydrated step result for `eventId`, using `cache` as a per-run
- * memo. On a hit, the cached primitive is returned without re-running the
- * expensive decrypt + devalue-parse. On a miss, `hydrate()` runs and its
- * result is memoized only when it is a small primitive (see the module docs for
- * the identity-safety rationale and the length bound on string/bigint results).
- *
- * This always returns a `Promise` and `await`s `hydrate()` even on the miss
- * path, so the caller's `await` inside its serial `promiseQueue` slot keeps the
- * same scheduling on both hit and miss — a cache hit resolves through the exact
- * same promise-chain position a re-hydrate would have, preserving the
- * deterministic delivery order that `pendingDeliveries`, the delivery barriers,
- * and `Promise.race`/`Promise.all` replay all depend on.
- *
- * `has(eventId)` is used rather than `get(eventId) !== undefined` so that a
- * legitimately memoized `undefined` step result still registers as a hit.
- *
- * When `cache` or `eventId` is absent (lightweight test harnesses, or a context
- * that predates this plumbing), this degrades to calling `hydrate()` directly
- * with no memoization — identical to the previous behavior.
- *
- * Errors are intentionally never cached: a rejected hydrate propagates to the
- * caller (which rejects the step promise) and the next replay re-attempts it,
- * matching the uncached behavior and avoiding a parked rejected promise.
- */
-export async function getOrHydrateStepReturnValue(cache, eventId, hydrate) {
-    if (!cache || eventId === undefined) {
-        return hydrate();
-    }
-    if (cache.has(eventId)) {
-        return cache.get(eventId);
-    }
-    const value = await hydrate();
-    // Only memoize values that are safe to return by reference across replays
-    // AND small enough to retain for the invocation. Non-primitives and
-    // oversized string/bigint values fall through and are re-hydrated fresh on
-    // every replay (see isMemoizablePrimitive / MAX_MEMOIZED_PRIMITIVE_LENGTH).
-    if (isMemoizablePrimitive(value)) {
-        cache.set(eventId, value);
-    }
-    return value;
-}
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoic3RlcC1oeWRyYXRpb24tY2FjaGUuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi9zcmMvc3RlcC1oeWRyYXRpb24tY2FjaGUudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUE7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7R0FrRkc7QUFFSDs7Ozs7Ozs7R0FRRztBQUNILE1BQU0sQ0FBQyxNQUFNLDZCQUE2QixHQUFHLElBQUksQ0FBQztBQUVsRDs7Ozs7Ozs7Ozs7OztHQWFHO0FBQ0gsTUFBTSxVQUFVLHFCQUFxQixDQUFDLEtBQWM7SUFDbEQsSUFBSSxLQUFLLEtBQUssSUFBSTtRQUFFLE9BQU8sSUFBSSxDQUFDO0lBQ2hDLE1BQU0sQ0FBQyxHQUFHLE9BQU8sS0FBSyxDQUFDO0lBQ3ZCLElBQUksQ0FBQyxLQUFLLFFBQVEsSUFBSSxDQUFDLEtBQUssVUFBVTtRQUFFLE9BQU8sS0FBSyxDQUFDO0lBQ3JELGlFQUFpRTtJQUNqRSxJQUFJLENBQUMsS0FBSyxRQUFRLEVBQUUsQ0FBQztRQUNuQixPQUFRLEtBQWdCLENBQUMsTUFBTSxJQUFJLDZCQUE2QixDQUFDO0lBQ25FLENBQUM7SUFDRCxJQUFJLENBQUMsS0FBSyxRQUFRLEVBQUUsQ0FBQztRQUNuQixPQUFRLEtBQWdCLENBQUMsUUFBUSxFQUFFLENBQUMsTUFBTSxJQUFJLDZCQUE2QixDQUFDO0lBQzlFLENBQUM7SUFDRCxPQUFPLElBQUksQ0FBQztBQUNkLENBQUM7QUFZRDs7R0FFRztBQUNILE1BQU0sVUFBVSx3QkFBd0I7SUFDdEMsT0FBTyxJQUFJLEdBQUcsRUFBRSxDQUFDO0FBQ25CLENBQUM7QUFFRDs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7O0dBd0JHO0FBQ0gsTUFBTSxDQUFDLEtBQUssVUFBVSwyQkFBMkIsQ0FDL0MsS0FBcUMsRUFDckMsT0FBMkIsRUFDM0IsT0FBK0I7SUFFL0IsSUFBSSxDQUFDLEtBQUssSUFBSSxPQUFPLEtBQUssU0FBUyxFQUFFLENBQUM7UUFDcEMsT0FBTyxPQUFPLEVBQUUsQ0FBQztJQUNuQixDQUFDO0lBRUQsSUFBSSxLQUFLLENBQUMsR0FBRyxDQUFDLE9BQU8sQ0FBQyxFQUFFLENBQUM7UUFDdkIsT0FBTyxLQUFLLENBQUMsR0FBRyxDQUFDLE9BQU8sQ0FBQyxDQUFDO0lBQzVCLENBQUM7SUFFRCxNQUFNLEtBQUssR0FBRyxNQUFNLE9BQU8sRUFBRSxDQUFDO0lBQzlCLDBFQUEwRTtJQUMxRSxvRUFBb0U7SUFDcEUsMkVBQTJFO0lBQzNFLDRFQUE0RTtJQUM1RSxJQUFJLHFCQUFxQixDQUFDLEtBQUssQ0FBQyxFQUFFLENBQUM7UUFDakMsS0FBSyxDQUFDLEdBQUcsQ0FBQyxPQUFPLEVBQUUsS0FBSyxDQUFDLENBQUM7SUFDNUIsQ0FBQztJQUNELE9BQU8sS0FBSyxDQUFDO0FBQ2YsQ0FBQyIsInNvdXJjZXNDb250ZW50IjpbIi8qKlxuICogUGVyLXJ1biBtZW1vaXphdGlvbiBjYWNoZSBmb3IgaHlkcmF0ZWQgc3RlcCByZXR1cm4gdmFsdWVzLlxuICpcbiAqICMjIFdoeVxuICpcbiAqIFRoZSBpbmxpbmUgcmVwbGF5IGxvb3AgKGBydW50aW1lLnRzYCkgcmUtcnVucyB0aGUgd29ya2Zsb3cgYm9keSBmcm9tIHRoZSB0b3BcbiAqIG9uIGV2ZXJ5IGl0ZXJhdGlvbiwgcmUtY29uc3VtaW5nIHRoZSBmdWxsIGV2ZW50IGxvZyBlYWNoIHRpbWUuIEZvciBldmVyeVxuICogYWxyZWFkeS1jb21wbGV0ZWQgc3RlcCwgdGhlIHN0ZXAgY29uc3VtZXIgKGBzdGVwLnRzYCkgcmUtcnVuc1xuICogYGh5ZHJhdGVTdGVwUmV0dXJuVmFsdWVgIOKAlCB3aGljaCBBRVMtR0NNLWRlY3J5cHRzIGFuZCBkZXZhbHVlLXBhcnNlcyB0aGVcbiAqIHNlcmlhbGl6ZWQgcmVzdWx0IOKAlCBldmVuIHRob3VnaCB0aGF0IGV4YWN0IHJlc3VsdCB3YXMgYWxyZWFkeSBoeWRyYXRlZCBvblxuICogZXZlcnkgcHJpb3IgcmVwbGF5LiBGb3IgYSBzZXF1ZW50aWFsIHdvcmtmbG93IG9mIE4gc3RlcHMsIHJlcGxheSBLIGh5ZHJhdGVzXG4gKiBLIHJlc3VsdHMsIHNvIHRoZSB0b3RhbCB3b3JrIGFjcm9zcyBhIHNpbmdsZSBpbnZvY2F0aW9uIGlzIE8oTsKyKVxuICogZGVjcnlwdCtwYXJzZSBvcGVyYXRpb25zLlxuICpcbiAqIFRoaXMgY2FjaGUgbWFrZXMgYSBjb21wbGV0ZWQgc3RlcCdzIGh5ZHJhdGVkIHJlc3VsdCBhdmFpbGFibGUgaW4gTygxKSBvblxuICogc3Vic2VxdWVudCByZXBsYXlzIHdpdGhpbiB0aGUgU0FNRSBpbnZvY2F0aW9uLCB0dXJuaW5nIHRoZSBhZ2dyZWdhdGUgY29zdFxuICogaW50byBPKE4pLlxuICpcbiAqICMjIFNjb3BlIC8gbGlmZXRpbWVcbiAqXG4gKiBUaGUgY2FjaGUgaXMgb3duZWQgYnkgdGhlIGlubGluZSBsb29wIGluIGBydW50aW1lLnRzYCAob25lIHBlciB3b3JrZmxvdyBydW5cbiAqIGludm9jYXRpb24pIGFuZCBwYXNzZWQgaW50byBgcnVuV29ya2Zsb3dgIHNvIGl0IHN1cnZpdmVzIGFjcm9zcyB0aGUgbG9vcCdzXG4gKiBpdGVyYXRpb25zIGJ1dCBuZXZlciBsZWFrcyBhY3Jvc3MgdW5yZWxhdGVkIHJ1bnMgb3IgcHJvY2Vzcy1sZXZlbFxuICogaW52b2NhdGlvbnMuIEEgZnJlc2ggYHJ1bldvcmtmbG93YCAvIGBXb3JrZmxvd09yY2hlc3RyYXRvckNvbnRleHRgIGlzIGNyZWF0ZWRcbiAqIGVhY2ggaXRlcmF0aW9uLCBzbyB0aGUgY2FjaGUgbXVzdCBsaXZlIE9VVFNJREUgdGhlIHBlci1pdGVyYXRpb24gY29udGV4dC5cbiAqXG4gKiAjIyBLZXlpbmdcbiAqXG4gKiBFbnRyaWVzIGFyZSBrZXllZCBieSB0aGUgcGVyc2lzdGVkIGV2ZW50J3MgYGV2ZW50SWRgIOKAlCBhIHN0YWJsZSxcbiAqIHdvcmxkLWFzc2lnbmVkIGlkZW50aWZpZXIgZm9yIHRoZSBgc3RlcF9jb21wbGV0ZWRgIGV2ZW50IHdob3NlIHNlcmlhbGl6ZWRcbiAqIGByZXN1bHRgIGlzIGJlaW5nIGh5ZHJhdGVkLiBUaGUgc2FtZSBldmVudCAoc2FtZSBgZXZlbnRJZGApIGNhcnJpZXMgdGhlIHNhbWVcbiAqIGltbXV0YWJsZSBzZXJpYWxpemVkIGJ5dGVzIGFjcm9zcyBldmVyeSByZXBsYXksIHNvIGEgaGl0IGlzIGd1YXJhbnRlZWQgdG9cbiAqIGNvcnJlc3BvbmQgdG8gdGhlIGlkZW50aWNhbCBpbnB1dC5cbiAqXG4gKiAjIyBJZGVudGl0eSBzYWZldHkgKHdoeSBwcmltaXRpdmVzIG9ubHkpXG4gKlxuICogYGh5ZHJhdGVTdGVwUmV0dXJuVmFsdWVgIChkZXZhbHVlLnBhcnNlKSBwcm9kdWNlcyBhIEZSRVNIIG9iamVjdCBncmFwaCBvblxuICogZXZlcnkgY2FsbCwgYW5kIGVhY2ggcmVwbGF5IGl0ZXJhdGlvbiBydW5zIGluIGEgRlJFU0ggd29ya2Zsb3cgVk0uIFRoZVxuICogY3VycmVudCAodW5jYWNoZWQpIGJlaGF2aW9yIHRoZXJlZm9yZSBoYW5kcyB0aGUgd29ya2Zsb3cgYSBicmFuZC1uZXcgdmFsdWVcbiAqIG9uIGV2ZXJ5IHJlcGxheS4gSWYgd2UgY2FjaGVkIGFuZCByZXR1cm5lZCB0aGUgU0FNRSBvYmplY3QgcmVmZXJlbmNlIGFjcm9zc1xuICogcmVwbGF5cywgd29ya2Zsb3cgY29kZSB0aGF0IG11dGF0ZXMgYSBzdGVwIHJlc3VsdCAoYGNvbnN0IHIgPSBhd2FpdCBzdGVwKCk7XG4gKiByLmNvdW50KytgKSB3b3VsZCBvYnNlcnZlIHRoZSBtdXRhdGlvbiBmcm9tIGEgcHJldmlvdXMgcmVwbGF5IG9uIHRoZSBuZXh0XG4gKiByZXBsYXkg4oCUIGEgbm9uLWRldGVybWluaXN0aWMgZGl2ZXJnZW5jZS4gU3RydWN0dXJlZC1jbG9uaW5nIG9uIGVhY2ggaGl0IGlzXG4gKiBib3RoIGxvc3N5IChyZXZpdmVycyByZWNvbnN0cnVjdCBzdHJlYW0gaGFuZGxlcywgc3RlcC1mdW5jdGlvbiBwcm94aWVzLFxuICogUmVxdWVzdC9SZXNwb25zZSwgYW5kIEFib3J0Q29udHJvbGxlci9BYm9ydFNpZ25hbCBjbGFzcyBpbnN0YW5jZXMgdGhhdCBkb24ndFxuICogc3Vydml2ZSBhIHN0cnVjdHVyZWQgY2xvbmUpIGFuZCBzdGlsbCBPKHNpemUpLlxuICpcbiAqIFNvIHdlIG9ubHkgY2FjaGUgdmFsdWVzIGZvciB3aGljaCByZXR1cm5pbmcgdGhlIHNhbWUgcmVmZXJlbmNlIG9uIGV2ZXJ5XG4gKiByZXBsYXkgaXMgcHJvdmFibHkgaW5kaXN0aW5ndWlzaGFibGUgZnJvbSByZS1oeWRyYXRpbmc6IEphdmFTY3JpcHRcbiAqIHByaW1pdGl2ZXMgKHN0cmluZywgbnVtYmVyLCBib29sZWFuLCBiaWdpbnQsIHN5bWJvbCwgbnVsbCwgdW5kZWZpbmVkKS5cbiAqIFByaW1pdGl2ZXMgYXJlIGltbXV0YWJsZSBhbmQgY29tcGFyZWQgYnkgdmFsdWUsIHNvIHNoYXJpbmcgdGhlIHJlZmVyZW5jZSBpc1xuICogYnl0ZS1mb3ItYnl0ZSBlcXVpdmFsZW50IHRvIHJlLXBhcnNpbmcuIEFueSBub24tcHJpbWl0aXZlIHJlc3VsdCBmYWxsc1xuICogdGhyb3VnaCB0byBhIGZ1bGwgcmUtaHlkcmF0ZSBldmVyeSByZXBsYXksIHByZXNlcnZpbmcgY3VycmVudCBiZWhhdmlvclxuICogZXhhY3RseS4gVGhpcyB0cmFkZXMgc29tZSBvZiB0aGUgb3B0aW1pemF0aW9uIGF3YXkgaW4gdGhlIG9iamVjdC1yZXR1cm5pbmdcbiAqIGNhc2UgaW4gZXhjaGFuZ2UgZm9yIGtlZXBpbmcgZGV0ZXJtaW5pc3RpYyByZXBsYXkgYWlydGlnaHQuXG4gKlxuICogIyMgTWVtb3J5IGNoYXJhY3RlcmlzdGljXG4gKlxuICogQ2FjaGVkIGVudHJpZXMgaG9sZCB0aGUgZGVjcnlwdGVkL2RldmFsdWUtcGFyc2VkICpwbGFpbnRleHQqIG9mIGEgc3RlcFxuICogcmVzdWx0LCB3aGljaCBpcyByZXRhaW5lZCBmb3IgdGhlIHJlc3Qgb2YgdGhlIGludm9jYXRpb24gb24gdG9wIG9mIHRoZVxuICogc2VyaWFsaXplZCBieXRlcyBhbHJlYWR5IGhlbGQgaW4gYGNhY2hlZEV2ZW50c2AuIFNvIHRoZSByZXNpZHVhbCBjb3N0IGlzOlxuICpcbiAqIC0gKipTY29wZWQgdG8gb25lIHdvcmtmbG93LXJ1biBpbnZvY2F0aW9uLioqIEEgZnJlc2ggYE1hcGAgaXMgY3JlYXRlZCBwZXJcbiAqICAgaW52b2NhdGlvbiAoaW4gYHJ1bnRpbWUudHNgKSBhbmQgaXMgdW5yZWFjaGFibGUgLyBHQydkIHdoZW4gdGhlIGludm9jYXRpb25cbiAqICAgcmV0dXJucy4gTm90aGluZyBhY2N1bXVsYXRlcyBhY3Jvc3MgcnVucyBvciBhY3Jvc3MgcHJvY2Vzcy1sZXZlbFxuICogICBpbnZvY2F0aW9ucy5cbiAqIC0gKipCb3VuZGVkIGJ5IHRoZSBudW1iZXIgb2YgcHJpbWl0aXZlLXJldHVybmluZyBjb21wbGV0ZWQgc3RlcHMgaW4gdGhhdFxuICogICBydW4qKiDigJQgYXQgbW9zdCBvbmUgc21hbGwgZW50cnkgcGVyIHN1Y2ggc3RlcC5cbiAqIC0gKipQcmltaXRpdmVzIG9ubHksIGFuZCBhZGRpdGlvbmFsbHkgYnl0ZS1ib3VuZGVkLioqIE1vc3QgcHJpbWl0aXZlc1xuICogICAobnVtYmVycywgYm9vbGVhbnMsIG51bGwvdW5kZWZpbmVkLCBzeW1ib2xzLCBzaG9ydCBpZHMvc3RyaW5ncykgYXJlIHRpbnlcbiAqICAgYW5kIGZpeGVkLXNpemUuIFRoZSBvbmx5IHByaW1pdGl2ZSB0aGF0IGNhbiBiZSBsYXJnZSBpcyBhIHN0cmluZyAob3IgYVxuICogICBwYXRob2xvZ2ljYWxseSBsb25nIGJpZ2ludCksIHNvIHRvIGtlZXAgdGhlIGRvdWJsZWQtcmVzaWRlbmN5IHdvcnN0IGNhc2VcbiAqICAgYm91bmRlZCB3ZSAqZG8gbm90KiBtZW1vaXplIHN0cmluZy9iaWdpbnQgcmVzdWx0cyB3aG9zZSBjaGFyYWN0ZXIgbGVuZ3RoXG4gKiAgIGV4Y2VlZHMge0BsaW5rIE1BWF9NRU1PSVpFRF9QUklNSVRJVkVfTEVOR1RIfS4gQSBsYXJnZSBzdHJpbmcgaXMgY2hlYXAgdG9cbiAqICAgcmUtaHlkcmF0ZSByZWxhdGl2ZSB0byBpdHMgZm9vdHByaW50LCBzbyBsZXR0aW5nIGl0IGZhbGwgdGhyb3VnaCB0byB0aGVcbiAqICAgZXhpc3RpbmcgcGVyLXJlcGxheSByZS1oeWRyYXRlIHBhdGggY29zdHMgbGl0dGxlIGFuZCBjYXBzIHBlYWsgcmV0YWluZWRcbiAqICAgbWVtb3J5LlxuICpcbiAqIChUaGlzIGlzIGEgbXVjaCB3ZWFrZXIgY29uY2VybiB0aGFuIGEgKnByb2Nlc3Mtd2lkZSogY2FjaGU6IHRoZSBkb21pbmFudFxuICogcmVzaWRlbmN5IOKAlCB0aGUgZnVsbCBldmVudCBsb2cgaW4gYGNhY2hlZEV2ZW50c2Ag4oCUIGFscmVhZHkgZXhpc3RzIGZvciB0aGVcbiAqIHNhbWUgbGlmZXRpbWUsIGFuZCBldmVyeXRoaW5nIGhlcmUgaXMgZnJlZWQgdG9nZXRoZXIgd2l0aCBpdCB3aGVuIHRoZVxuICogaW52b2NhdGlvbiBlbmRzLilcbiAqL1xuXG4vKipcbiAqIFVwcGVyIGJvdW5kLCBpbiBjaGFyYWN0ZXJzLCBvbiBhIHN0cmluZy9iaWdpbnQgcHJpbWl0aXZlIHRoYXQgbWF5IGJlXG4gKiBtZW1vaXplZC4gQmV5b25kIHRoaXMsIHRoZSB2YWx1ZSBmYWxscyB0aHJvdWdoIHRvIGEgZnJlc2ggcmUtaHlkcmF0ZSBvbiBldmVyeVxuICogcmVwbGF5IHNvIHRoZSBjYWNoZSBuZXZlciBob2xkcyBhIGxhcmdlIHBsYWludGV4dCBwYXlsb2FkIGZvciB0aGUgbGlmZXRpbWUgb2ZcbiAqIHRoZSBpbnZvY2F0aW9uLiA0IEtpQiBjb21mb3J0YWJseSBjb3ZlcnMgaWRzLCBjb3VudHMsIGZsYWdzLCBhbmQgdHlwaWNhbFxuICogc2hvcnQgc3RyaW5nIHJlc3VsdHMgd2hpbGUgZXhjbHVkaW5nIHRoZSBsYXJnZS1wYXlsb2FkIGNhc2UgdGhlIGJvdW5kIGV4aXN0c1xuICogdG8gZ3VhcmQuIE90aGVyIHByaW1pdGl2ZSB0eXBlcyAobnVtYmVyLCBib29sZWFuLCBzeW1ib2wsIG51bGwsIHVuZGVmaW5lZClcbiAqIGFyZSBpbmhlcmVudGx5IHNtYWxsIGFuZCBhcmUgbmV2ZXIgbGVuZ3RoLWNoZWNrZWQuXG4gKi9cbmV4cG9ydCBjb25zdCBNQVhfTUVNT0laRURfUFJJTUlUSVZFX0xFTkdUSCA9IDQwOTY7XG5cbi8qKlxuICogUmV0dXJucyB0cnVlIGZvciB2YWx1ZXMgdGhhdCBhcmUgc2FmZSB0byBtZW1vaXplIGFuZCByZXR1cm4gYnkgcmVmZXJlbmNlXG4gKiBhY3Jvc3MgcmVwbGF5czogSlMgcHJpbWl0aXZlcy4gT2JqZWN0cyBhbmQgZnVuY3Rpb25zIGFyZSBleGNsdWRlZCBiZWNhdXNlXG4gKiBzaGFyaW5nIGEgbXV0YWJsZSByZWZlcmVuY2UgYWNyb3NzIHJlcGxheXMgY291bGQgY2hhbmdlIG9ic2VydmFibGUgYmVoYXZpb3IuXG4gKlxuICogU3RyaW5ncyBhbmQgYmlnaW50cyBhcmUgYWRkaXRpb25hbGx5IGJvdW5kZWQgYnkgbGVuZ3RoOiBhIHZhbHVlIGxvbmdlciB0aGFuXG4gKiB7QGxpbmsgTUFYX01FTU9JWkVEX1BSSU1JVElWRV9MRU5HVEh9IGNoYXJhY3RlcnMgaXMgdHJlYXRlZCBhcyBub24tbWVtb2l6YWJsZVxuICogc28gdGhlIGNhY2hlIG5ldmVyIHJldGFpbnMgYSBsYXJnZSBwbGFpbnRleHQgcGF5bG9hZCBmb3IgdGhlIHdob2xlIGludm9jYXRpb25cbiAqIChzZWUgdGhlIG1vZHVsZS1sZXZlbCBcIk1lbW9yeSBjaGFyYWN0ZXJpc3RpY1wiIGRvY3MpLiBJdCByZS1oeWRyYXRlcyBmcmVzaCBvblxuICogZXZlcnkgcmVwbGF5IGluc3RlYWQg4oCUIGNoZWFwIHJlbGF0aXZlIHRvIGl0cyBmb290cHJpbnQuXG4gKlxuICogTm90ZTogYHR5cGVvZiBudWxsID09PSAnb2JqZWN0J2AsIHNvIGl0IGlzIGhhbmRsZWQgZXhwbGljaXRseS4gYHVuZGVmaW5lZGAsXG4gKiBgc3RyaW5nYCwgYG51bWJlcmAsIGBib29sZWFuYCwgYGJpZ2ludGAsIGFuZCBgc3ltYm9sYCBhcmUgYWxsIHByaW1pdGl2ZXMuXG4gKi9cbmV4cG9ydCBmdW5jdGlvbiBpc01lbW9pemFibGVQcmltaXRpdmUodmFsdWU6IHVua25vd24pOiBib29sZWFuIHtcbiAgaWYgKHZhbHVlID09PSBudWxsKSByZXR1cm4gdHJ1ZTtcbiAgY29uc3QgdCA9IHR5cGVvZiB2YWx1ZTtcbiAgaWYgKHQgPT09ICdvYmplY3QnIHx8IHQgPT09ICdmdW5jdGlvbicpIHJldHVybiBmYWxzZTtcbiAgLy8gQm91bmQgdGhlIG9ubHkgcHJpbWl0aXZlIHR5cGVzIHRoYXQgY2FuIGNhcnJ5IGEgbGFyZ2UgcGF5bG9hZC5cbiAgaWYgKHQgPT09ICdzdHJpbmcnKSB7XG4gICAgcmV0dXJuICh2YWx1ZSBhcyBzdHJpbmcpLmxlbmd0aCA8PSBNQVhfTUVNT0laRURfUFJJTUlUSVZFX0xFTkdUSDtcbiAgfVxuICBpZiAodCA9PT0gJ2JpZ2ludCcpIHtcbiAgICByZXR1cm4gKHZhbHVlIGFzIGJpZ2ludCkudG9TdHJpbmcoKS5sZW5ndGggPD0gTUFYX01FTU9JWkVEX1BSSU1JVElWRV9MRU5HVEg7XG4gIH1cbiAgcmV0dXJuIHRydWU7XG59XG5cbi8qKlxuICogQ2FjaGUgb2YgaHlkcmF0ZWQgc3RlcCByZXR1cm4gdmFsdWVzIGZvciBhIHNpbmdsZSB3b3JrZmxvdyBydW4gaW52b2NhdGlvbi5cbiAqXG4gKiBLZXllZCBieSBgc3RlcF9jb21wbGV0ZWRgIGV2ZW50IGlkOyB0aGUgdmFsdWUgaXMgdGhlIGFscmVhZHktaHlkcmF0ZWRcbiAqIHByaW1pdGl2ZSByZXN1bHQuIE9ubHkgc3VjY2Vzc2Z1bCwgcHJpbWl0aXZlIGh5ZHJhdGlvbnMgYXJlIHN0b3JlZCAoc2VlXG4gKiB7QGxpbmsgZ2V0T3JIeWRyYXRlU3RlcFJldHVyblZhbHVlfSksIHNvIGEgbm9uLWB1bmRlZmluZWRgIGBoYXMoZXZlbnRJZClgXG4gKiBhbHdheXMgbWVhbnMgXCJ0aGlzIHN0ZXAgY29tcGxldGVkIHdpdGggYSBtZW1vaXphYmxlIHByaW1pdGl2ZSB2YWx1ZVwiLlxuICovXG5leHBvcnQgdHlwZSBTdGVwSHlkcmF0aW9uQ2FjaGUgPSBNYXA8c3RyaW5nLCB1bmtub3duPjtcblxuLyoqXG4gKiBDcmVhdGUgYW4gZW1wdHkgcGVyLWludm9jYXRpb24gc3RlcCBoeWRyYXRpb24gY2FjaGUuXG4gKi9cbmV4cG9ydCBmdW5jdGlvbiBjcmVhdGVTdGVwSHlkcmF0aW9uQ2FjaGUoKTogU3RlcEh5ZHJhdGlvbkNhY2hlIHtcbiAgcmV0dXJuIG5ldyBNYXAoKTtcbn1cblxuLyoqXG4gKiBSZXR1cm4gdGhlIGh5ZHJhdGVkIHN0ZXAgcmVzdWx0IGZvciBgZXZlbnRJZGAsIHVzaW5nIGBjYWNoZWAgYXMgYSBwZXItcnVuXG4gKiBtZW1vLiBPbiBhIGhpdCwgdGhlIGNhY2hlZCBwcmltaXRpdmUgaXMgcmV0dXJuZWQgd2l0aG91dCByZS1ydW5uaW5nIHRoZVxuICogZXhwZW5zaXZlIGRlY3J5cHQgKyBkZXZhbHVlLXBhcnNlLiBPbiBhIG1pc3MsIGBoeWRyYXRlKClgIHJ1bnMgYW5kIGl0c1xuICogcmVzdWx0IGlzIG1lbW9pemVkIG9ubHkgd2hlbiBpdCBpcyBhIHNtYWxsIHByaW1pdGl2ZSAoc2VlIHRoZSBtb2R1bGUgZG9jcyBmb3JcbiAqIHRoZSBpZGVudGl0eS1zYWZldHkgcmF0aW9uYWxlIGFuZCB0aGUgbGVuZ3RoIGJvdW5kIG9uIHN0cmluZy9iaWdpbnQgcmVzdWx0cykuXG4gKlxuICogVGhpcyBhbHdheXMgcmV0dXJucyBhIGBQcm9taXNlYCBhbmQgYGF3YWl0YHMgYGh5ZHJhdGUoKWAgZXZlbiBvbiB0aGUgbWlzc1xuICogcGF0aCwgc28gdGhlIGNhbGxlcidzIGBhd2FpdGAgaW5zaWRlIGl0cyBzZXJpYWwgYHByb21pc2VRdWV1ZWAgc2xvdCBrZWVwcyB0aGVcbiAqIHNhbWUgc2NoZWR1bGluZyBvbiBib3RoIGhpdCBhbmQgbWlzcyDigJQgYSBjYWNoZSBoaXQgcmVzb2x2ZXMgdGhyb3VnaCB0aGUgZXhhY3RcbiAqIHNhbWUgcHJvbWlzZS1jaGFpbiBwb3NpdGlvbiBhIHJlLWh5ZHJhdGUgd291bGQgaGF2ZSwgcHJlc2VydmluZyB0aGVcbiAqIGRldGVybWluaXN0aWMgZGVsaXZlcnkgb3JkZXIgdGhhdCBgcGVuZGluZ0RlbGl2ZXJpZXNgLCB0aGUgZGVsaXZlcnkgYmFycmllcnMsXG4gKiBhbmQgYFByb21pc2UucmFjZWAvYFByb21pc2UuYWxsYCByZXBsYXkgYWxsIGRlcGVuZCBvbi5cbiAqXG4gKiBgaGFzKGV2ZW50SWQpYCBpcyB1c2VkIHJhdGhlciB0aGFuIGBnZXQoZXZlbnRJZCkgIT09IHVuZGVmaW5lZGAgc28gdGhhdCBhXG4gKiBsZWdpdGltYXRlbHkgbWVtb2l6ZWQgYHVuZGVmaW5lZGAgc3RlcCByZXN1bHQgc3RpbGwgcmVnaXN0ZXJzIGFzIGEgaGl0LlxuICpcbiAqIFdoZW4gYGNhY2hlYCBvciBgZXZlbnRJZGAgaXMgYWJzZW50IChsaWdodHdlaWdodCB0ZXN0IGhhcm5lc3Nlcywgb3IgYSBjb250ZXh0XG4gKiB0aGF0IHByZWRhdGVzIHRoaXMgcGx1bWJpbmcpLCB0aGlzIGRlZ3JhZGVzIHRvIGNhbGxpbmcgYGh5ZHJhdGUoKWAgZGlyZWN0bHlcbiAqIHdpdGggbm8gbWVtb2l6YXRpb24g4oCUIGlkZW50aWNhbCB0byB0aGUgcHJldmlvdXMgYmVoYXZpb3IuXG4gKlxuICogRXJyb3JzIGFyZSBpbnRlbnRpb25hbGx5IG5ldmVyIGNhY2hlZDogYSByZWplY3RlZCBoeWRyYXRlIHByb3BhZ2F0ZXMgdG8gdGhlXG4gKiBjYWxsZXIgKHdoaWNoIHJlamVjdHMgdGhlIHN0ZXAgcHJvbWlzZSkgYW5kIHRoZSBuZXh0IHJlcGxheSByZS1hdHRlbXB0cyBpdCxcbiAqIG1hdGNoaW5nIHRoZSB1bmNhY2hlZCBiZWhhdmlvciBhbmQgYXZvaWRpbmcgYSBwYXJrZWQgcmVqZWN0ZWQgcHJvbWlzZS5cbiAqL1xuZXhwb3J0IGFzeW5jIGZ1bmN0aW9uIGdldE9ySHlkcmF0ZVN0ZXBSZXR1cm5WYWx1ZShcbiAgY2FjaGU6IFN0ZXBIeWRyYXRpb25DYWNoZSB8IHVuZGVmaW5lZCxcbiAgZXZlbnRJZDogc3RyaW5nIHwgdW5kZWZpbmVkLFxuICBoeWRyYXRlOiAoKSA9PiBQcm9taXNlPHVua25vd24+XG4pOiBQcm9taXNlPHVua25vd24+IHtcbiAgaWYgKCFjYWNoZSB8fCBldmVudElkID09PSB1bmRlZmluZWQpIHtcbiAgICByZXR1cm4gaHlkcmF0ZSgpO1xuICB9XG5cbiAgaWYgKGNhY2hlLmhhcyhldmVudElkKSkge1xuICAgIHJldHVybiBjYWNoZS5nZXQoZXZlbnRJZCk7XG4gIH1cblxuICBjb25zdCB2YWx1ZSA9IGF3YWl0IGh5ZHJhdGUoKTtcbiAgLy8gT25seSBtZW1vaXplIHZhbHVlcyB0aGF0IGFyZSBzYWZlIHRvIHJldHVybiBieSByZWZlcmVuY2UgYWNyb3NzIHJlcGxheXNcbiAgLy8gQU5EIHNtYWxsIGVub3VnaCB0byByZXRhaW4gZm9yIHRoZSBpbnZvY2F0aW9uLiBOb24tcHJpbWl0aXZlcyBhbmRcbiAgLy8gb3ZlcnNpemVkIHN0cmluZy9iaWdpbnQgdmFsdWVzIGZhbGwgdGhyb3VnaCBhbmQgYXJlIHJlLWh5ZHJhdGVkIGZyZXNoIG9uXG4gIC8vIGV2ZXJ5IHJlcGxheSAoc2VlIGlzTWVtb2l6YWJsZVByaW1pdGl2ZSAvIE1BWF9NRU1PSVpFRF9QUklNSVRJVkVfTEVOR1RIKS5cbiAgaWYgKGlzTWVtb2l6YWJsZVByaW1pdGl2ZSh2YWx1ZSkpIHtcbiAgICBjYWNoZS5zZXQoZXZlbnRJZCwgdmFsdWUpO1xuICB9XG4gIHJldHVybiB2YWx1ZTtcbn1cbiJdfQ==