@lostgradient/weft 0.24.0 → 0.24.2

package/dist/storage/index.d.ts

@@ -82,68 +82,6 @@ declare const exportedCopyTextKeyValueRowsToStorage: typeof copyTextKeyValueRows
  * ```
  */
 declare const exportedKeys: {
-    readonly budget: (namespace: string, period: string, date: string) => string;
-    readonly review: (workflowId: string, reviewId: string) => string;
-    readonly workflowHeaders: (workflowId: string) => string;
-    readonly childCancellationPrefix: (workflowId: string) => string;
-    readonly childCancellation: (workflowId: string, childWorkflowId: string) => string;
-    readonly childWorkflowByParentPrefix: (parentWorkflowId: string, parentWorkflowExecutionToken?: string) => string;
-    readonly childWorkflowByParent: (parentWorkflowId: string, parentWorkflowExecutionToken: string | undefined, childWorkflowId: string) => string;
-    readonly terminalCleanupNeeded: (workflowId: string) => string;
-    readonly workflowConcurrency: (workflowType: string, partitionKey: string) => string;
-    readonly workflowConcurrencyHolder: (workflowId: string) => string;
-    readonly workflowHasServices: (workflowId: string) => string;
-    readonly finalizerState: (workflowId: string) => string;
-    readonly teardownOwed: (workflowId: string) => string;
-    readonly teardownSucceeded: (workflowId: string) => string;
-    readonly teardownDeadLetter: (workflowId: string) => string;
-    readonly offload: (workflowId: string, key: string) => string;
-    readonly archive: (workflowId: string, key: string) => string;
-    readonly stateExecution: (ownerWorkflowId: string, key: string) => string;
-    readonly stateWorkflow: (workflowType: string, key: string) => string;
-    readonly streamChunkPrefix: (workflowId: string, key: string) => string;
-    readonly streamChunk: (workflowId: string, key: string, chunkIndex: number) => string;
-    readonly streamTail: (workflowId: string, key: string) => string;
-    readonly streamMetadata: (workflowId: string, key: string) => string;
-    readonly budgetCharged: (operationId: string) => string;
-    readonly toolEffect: (workflowId: string, agentId: string, semanticHash: string) => string;
-    readonly workflowVisibilityStatus: (status: string, workflowId: string) => string;
-    readonly workflowVisibilityType: (type: string, workflowId: string) => string;
-    readonly workflowVisibilityCreated: (createdAt: number, workflowId: string) => string;
-    readonly workflowVisibilityUpdated: (updatedAt: number, workflowId: string) => string;
-    readonly workflowVisibilityDeadline: (deadline: number, workflowId: string) => string;
-    readonly workflowVisibilityManifest: (workflowId: string) => string;
-    readonly workflowVisibilityMetaVersion: () => string;
-    readonly workflowVisibilityMetaBuiltAt: () => string;
-    readonly workflowVisibilityMetaCursor: () => string;
-    readonly catalogEntry: (name: string, revision: string) => string;
-    readonly catalogEntryPrefix: (name: string) => string;
-    readonly catalogActive: (name: string) => string;
-    readonly workflowOwnerEpoch: (workflowId: string) => string;
-    readonly workflowOwnerHolder: (workflowId: string) => string;
-    readonly ownershipModeMarker: () => string;
-    readonly applicationOutbox: (namespace: string, ownerId: string) => string;
-    readonly applicationOutboxSinkProbe: (namespace: string, ownerId: string, nonce: string) => string;
-    readonly applicationDeliveryPrefix: (namespace: string, ownerId: string) => string;
-    readonly applicationDelivery: (namespace: string, ownerId: string, deliveryId: string) => string;
-    readonly applicationDeliveryDuePrefix: (namespace: string, ownerId: string) => string;
-    readonly applicationDeliveryDue: (namespace: string, ownerId: string, availableAt: number, deliveryId: string) => string;
-    readonly applicationDeliveryIdempotency: (namespace: string, ownerId: string, key: string) => string;
-    readonly applicationDeliveryBySequencePrefix: (namespace: string, ownerId: string) => string;
-    readonly applicationDeliveryBySequence: (namespace: string, ownerId: string, sequence: number) => string;
-    readonly applicationDeliveryTerminalPrefix: (namespace: string, ownerId: string) => string;
-    readonly applicationDeliveryTerminal: (namespace: string, ownerId: string, terminalAt: number, deliveryId: string) => string;
-    readonly applicationMailbox: (namespace: string, resourceId: string) => string;
-    readonly applicationMailboxSinkProbe: (namespace: string, resourceId: string, nonce: string) => string;
-    readonly applicationCommandPrefix: (namespace: string, resourceId: string) => string;
-    readonly applicationCommand: (namespace: string, resourceId: string, commandId: string) => string;
-    readonly applicationCommandReadyPrefix: (namespace: string, resourceId: string) => string;
-    readonly applicationCommandReady: (namespace: string, resourceId: string, sequence: number) => string;
-    readonly applicationCommandIdempotency: (namespace: string, resourceId: string, key: string) => string;
-    readonly applicationCommandBySequencePrefix: (namespace: string, resourceId: string) => string;
-    readonly applicationCommandBySequence: (namespace: string, resourceId: string, sequence: number) => string;
-    readonly applicationCommandTerminalPrefix: (namespace: string, resourceId: string) => string;
-    readonly applicationCommandTerminal: (namespace: string, resourceId: string, terminalAt: number, commandId: string) => string;
     readonly workflow: (id: string) => string;
     readonly checkpoint: (id: string) => string;
     readonly checkpointHistory: (id: string, step: number) => string;
@@ -177,17 +115,20 @@ declare const exportedKeys: {
     readonly fleetEventWatermark: () => string;
     readonly fleetEventByWorkflowPrefix: (workflowId: string) => string;
     readonly fleetEventByWorkflow: (workflowId: string, sequence: number) => string;
+} & {
     readonly signal: (workflowId: string, name: string, id: string) => string;
     readonly startSignal: (workflowId: string, name: string, id: string) => string;
     readonly signalSequence: (workflowId: string) => string;
     readonly signalAcceptedResponsePrefix: (workflowId: string) => string;
     readonly signalAcceptedResponse: (workflowId: string, name: string, signalId: string) => string;
+} & {
     readonly deadline: (deadline: number, workflowId: string) => string;
     readonly terminalCleanup: (fireAt: number, timerId: string) => string;
     readonly teardownTimer: (fireAt: number, timerId: string) => string;
     readonly delayedStart: (startAt: number, workflowId: string) => string;
     readonly terminalWorkflowPrefix: () => string;
     readonly terminalWorkflow: (updatedAt: number, workflowId: string) => string;
+} & {
     readonly attribute: (workflowId: string) => string;
     readonly attributeIndex: (attributeName: string, encodedValue: string, workflowId: string) => string;
     readonly tagIndex: (tag: string, workflowId: string) => string;
@@ -197,11 +138,83 @@ declare const exportedKeys: {
     readonly updateIdempotency: (workflowId: string, key: string) => string;
     readonly startIdempotency: (key: string) => string;
     readonly startIdempotencySignalId: (key: string) => string;
+} & {
     readonly livenessPrefix: () => string;
     readonly liveness: (instanceId: string) => string;
     readonly leasePrefix: () => string;
     readonly leaseEpoch: () => string;
     readonly leaseHolder: () => string;
+} & {
+    readonly applicationMailbox: (namespace: string, resourceId: string) => string;
+    readonly applicationMailboxSinkProbe: (namespace: string, resourceId: string, nonce: string) => string;
+    readonly applicationCommandPrefix: (namespace: string, resourceId: string) => string;
+    readonly applicationCommand: (namespace: string, resourceId: string, commandId: string) => string;
+    readonly applicationCommandReadyPrefix: (namespace: string, resourceId: string) => string;
+    readonly applicationCommandReady: (namespace: string, resourceId: string, sequence: number) => string;
+    readonly applicationCommandIdempotency: (namespace: string, resourceId: string, key: string) => string;
+    readonly applicationCommandBySequencePrefix: (namespace: string, resourceId: string) => string;
+    readonly applicationCommandBySequence: (namespace: string, resourceId: string, sequence: number) => string;
+    readonly applicationCommandTerminalPrefix: (namespace: string, resourceId: string) => string;
+    readonly applicationCommandTerminal: (namespace: string, resourceId: string, terminalAt: number, commandId: string) => string;
+} & {
+    readonly applicationOutbox: (namespace: string, ownerId: string) => string;
+    readonly applicationOutboxSinkProbe: (namespace: string, ownerId: string, nonce: string) => string;
+    readonly applicationDeliveryPrefix: (namespace: string, ownerId: string) => string;
+    readonly applicationDelivery: (namespace: string, ownerId: string, deliveryId: string) => string;
+    readonly applicationDeliveryDuePrefix: (namespace: string, ownerId: string) => string;
+    readonly applicationDeliveryDue: (namespace: string, ownerId: string, availableAt: number, deliveryId: string) => string;
+    readonly applicationDeliveryIdempotency: (namespace: string, ownerId: string, key: string) => string;
+    readonly applicationDeliveryBySequencePrefix: (namespace: string, ownerId: string) => string;
+    readonly applicationDeliveryBySequence: (namespace: string, ownerId: string, sequence: number) => string;
+    readonly applicationDeliveryTerminalPrefix: (namespace: string, ownerId: string) => string;
+    readonly applicationDeliveryTerminal: (namespace: string, ownerId: string, terminalAt: number, deliveryId: string) => string;
+} & {
+    readonly workflowOwnerEpoch: (workflowId: string) => string;
+    readonly workflowOwnerHolder: (workflowId: string) => string;
+    readonly ownershipModeMarker: () => string;
+} & {
+    readonly catalogEntry: (name: string, revision: string) => string;
+    readonly catalogEntryPrefix: (name: string) => string;
+    readonly catalogActive: (name: string) => string;
+    readonly catalogTombstone: (name: string, revision: string) => string;
+    readonly catalogTombstonePrefix: () => string;
+} & {
+    readonly workflowGeneration: (workflowId: string) => string;
+} & {
+    readonly budget: (namespace: string, period: string, date: string) => string;
+    readonly review: (workflowId: string, reviewId: string) => string;
+    readonly workflowHeaders: (workflowId: string) => string;
+    readonly childCancellationPrefix: (workflowId: string) => string;
+    readonly childCancellation: (workflowId: string, childWorkflowId: string) => string;
+    readonly childWorkflowByParentPrefix: (parentWorkflowId: string, parentWorkflowExecutionToken?: string) => string;
+    readonly childWorkflowByParent: (parentWorkflowId: string, parentWorkflowExecutionToken: string | undefined, childWorkflowId: string) => string;
+    readonly terminalCleanupNeeded: (workflowId: string) => string;
+    readonly workflowConcurrency: (workflowType: string, partitionKey: string) => string;
+    readonly workflowConcurrencyHolder: (workflowId: string) => string;
+    readonly workflowHasServices: (workflowId: string) => string;
+    readonly finalizerState: (workflowId: string) => string;
+    readonly teardownOwed: (workflowId: string) => string;
+    readonly teardownSucceeded: (workflowId: string) => string;
+    readonly teardownDeadLetter: (workflowId: string) => string;
+    readonly offload: (workflowId: string, key: string) => string;
+    readonly archive: (workflowId: string, key: string) => string;
+    readonly stateExecution: (ownerWorkflowId: string, key: string) => string;
+    readonly stateWorkflow: (workflowType: string, key: string) => string;
+    readonly streamChunkPrefix: (workflowId: string, key: string) => string;
+    readonly streamChunk: (workflowId: string, key: string, chunkIndex: number) => string;
+    readonly streamTail: (workflowId: string, key: string) => string;
+    readonly streamMetadata: (workflowId: string, key: string) => string;
+    readonly budgetCharged: (operationId: string) => string;
+    readonly toolEffect: (workflowId: string, agentId: string, semanticHash: string) => string;
+    readonly workflowVisibilityStatus: (status: string, workflowId: string) => string;
+    readonly workflowVisibilityType: (type: string, workflowId: string) => string;
+    readonly workflowVisibilityCreated: (createdAt: number, workflowId: string) => string;
+    readonly workflowVisibilityUpdated: (updatedAt: number, workflowId: string) => string;
+    readonly workflowVisibilityDeadline: (deadline: number, workflowId: string) => string;
+    readonly workflowVisibilityManifest: (workflowId: string) => string;
+    readonly workflowVisibilityMetaVersion: () => string;
+    readonly workflowVisibilityMetaBuiltAt: () => string;
+    readonly workflowVisibilityMetaCursor: () => string;
 };
 /**
  * Re-exported {@link MAX_BATCH_OPERATIONS}. See the original declaration for full docs.
@@ -382,7 +395,7 @@ declare const exportedTextValueStore: typeof textValueStore;
  * void isWeftKey;
  * ```
  */
-declare const exportedWeftReservedKeyPrefixes: readonly ["actrec:", "appcmd:", "appdidem:", "appdlv:", "appdseq:", "appdterm:", "appdue:", "appidem:", "appmbx:", "appobx:", "appprobe:", "appready:", "appseq:", "appterm:", "archive:", "async-act:", "attr:", "audit:bulk:", "blob:", "budget:", "budget-charged:", "catalog-active:", "catalog-entry:", "child-by-parent:", "ev:", "fleet-event-by-workflow:", "fleet-event:", "fleet-event-tail", "fleet-event-watermark", "idx:", "lease:", "liveness:", "offload:", "ownership-mode-marker", "op:", "review:", "schedule:", "schedule-due:", "schedule-run-by-schedule:", "schedule-run-link:", "schedule-run:", "sig:", "sigres:", "sigseq:", "start-idem:", "state:", "tag:", "tool-effect:", "upd:", "upk:", "upr:", "wf:", "wf-cleanup:", "wf-cleanup-needed:", "wf-concurrency:", "wf-concurrency-holder:", "wf-deadline:", "wf-delayed:", "wf-finalizer-state:", "wf-has-services:", "wf-headers:", "wf-idx-", "wf-owner-epoch:", "wf-owner-holder:", "wf-teardown:", "wf-teardown-deadletter:", "wf-teardown-needed:", "wf-teardown-succeeded:", "wf-terminal:"];
+declare const exportedWeftReservedKeyPrefixes: readonly ["actrec:", "appcmd:", "appdidem:", "appdlv:", "appdseq:", "appdterm:", "appdue:", "appidem:", "appmbx:", "appobx:", "appprobe:", "appready:", "appseq:", "appterm:", "archive:", "async-act:", "attr:", "audit:bulk:", "blob:", "budget:", "budget-charged:", "catalog-active:", "catalog-entry:", "catalog-tombstone:", "child-by-parent:", "ev:", "fleet-event-by-workflow:", "fleet-event:", "fleet-event-tail", "fleet-event-watermark", "idx:", "lease:", "liveness:", "offload:", "ownership-mode-marker", "op:", "review:", "schedule:", "schedule-due:", "schedule-run-by-schedule:", "schedule-run-link:", "schedule-run:", "sig:", "sigres:", "sigseq:", "start-idem:", "state:", "tag:", "tool-effect:", "upd:", "upk:", "upr:", "wf:", "wf-cleanup:", "wf-cleanup-needed:", "wf-concurrency:", "wf-concurrency-holder:", "wf-deadline:", "wf-delayed:", "wf-finalizer-state:", "wf-gen:", "wf-has-services:", "wf-headers:", "wf-idx-", "wf-owner-epoch:", "wf-owner-holder:", "wf-teardown:", "wf-teardown-deadletter:", "wf-teardown-needed:", "wf-teardown-succeeded:", "wf-terminal:"];
 /**
  * Re-exported {@link withCodec}. See the original declaration for full docs.
  *

package/dist/storage/interface.d.ts

@@ -1,5 +1,14 @@
 import { type StorageCapabilities } from './capabilities.ts';
+import { WORKFLOW_CATALOG_KEYS } from './catalog-keys.ts';
 import type { DeleteRangeOptions } from './delete-range.ts';
+import { GENERATION_KEYS } from './generation-keys.ts';
+import { LEASE_KEYS } from './lease-keys.ts';
+import { MAILBOX_KEYS } from './mailbox-keys.ts';
+import { OUTBOX_KEYS } from './outbox-keys.ts';
+import { OWNERSHIP_CLAIM_KEYS } from './ownership-keys.ts';
+import { SIGNAL_KEYS } from './signal-keys.ts';
+import { WORKFLOW_LIFECYCLE_KEYS_CORE, WORKFLOW_LIFECYCLE_KEYS_EXTENDED } from './workflow-lifecycle-keys.ts';
+import { WORKFLOW_RECORD_KEYS_CORE, WORKFLOW_RECORD_KEYS_EXTENDED } from './workflow-record-keys.ts';
 export { assertDurableStorageForRecovery, requireStorageCapability } from './capabilities.ts';
 export type { GatedStorageCapabilityKey, StorageCapabilities } from './capabilities.ts';
 export { DEFAULT_SCOPE } from './default-scope.ts';
@@ -303,11 +312,20 @@ export { decodeStorageKeyComponent, encodeStorageKeyComponent, formatSortableSto
  * Key layout constants for hierarchical key encoding. Timestamps are
  * zero-padded to 16 digits for lexicographic ordering.
  *
- * This registry grows as storage features are added, which is why this file
- * carries a `max-lines` override in `.oxlintrc.json` above the repository
- * default of 500. Extracting `KEYS` into its own module — and dropping the
- * override — is tracked in WFT-90. Prefer adding new key families as a separate
- * module spread into `KEYS` (see `ownership-keys.ts`) over growing this file.
+ * The registry itself is assembled from feature-specific modules — `KEYS` is
+ * the spread merge of the workflow record, lifecycle, signal, lease, mailbox,
+ * outbox, ownership, and catalog key modules — so this file stays under the
+ * repository's default 500-line ceiling (WFT-90). Prefer adding a new key
+ * family as its own module spread into `KEYS` (see `ownership-keys.ts`) over
+ * growing this file directly.
+ *
+ * `KEYS` is typed as an explicit intersection of each source module's own
+ * `typeof` type rather than left to plain spread inference: TypeScript's
+ * declaration emit does not propagate per-member JSDoc through an inferred
+ * spread type, so hovering `KEYS.scheduleRunLink` would otherwise lose the
+ * documentation on `scheduleRunLink` itself. The intersection keeps each
+ * module's per-member docs as the single source of truth while still
+ * surfacing them through `KEYS`.
  *
  * @example
  * ```ts
@@ -315,228 +333,4 @@ export { decodeStorageKeyComponent, encodeStorageKeyComponent, formatSortableSto
  * KEYS.workflow('workflow-id');
  * ```
  */
-export declare const KEYS: {
-    readonly budget: (namespace: string, period: string, date: string) => string;
-    readonly review: (workflowId: string, reviewId: string) => string;
-    readonly workflowHeaders: (workflowId: string) => string;
-    readonly childCancellationPrefix: (workflowId: string) => string;
-    readonly childCancellation: (workflowId: string, childWorkflowId: string) => string;
-    readonly childWorkflowByParentPrefix: (parentWorkflowId: string, parentWorkflowExecutionToken?: string) => string;
-    readonly childWorkflowByParent: (parentWorkflowId: string, parentWorkflowExecutionToken: string | undefined, childWorkflowId: string) => string;
-    readonly terminalCleanupNeeded: (workflowId: string) => string;
-    readonly workflowConcurrency: (workflowType: string, partitionKey: string) => string;
-    readonly workflowConcurrencyHolder: (workflowId: string) => string;
-    /**
-     * Presence-only marker written at start only when a run is launched with a
-     * non-serialized `services` value (see `start-batch.ts`). It lets a
-     * fresh-process recovery tell a run whose services were lost on crash apart
-     * from one that never had any — the services value itself is never persisted,
-     * so this bit is the only durable trace. Cleared on terminal cleanup.
-     */
-    readonly workflowHasServices: (workflowId: string) => string;
-    /**
-     * Last-write-wins payload that `ctx.setFinalizerState(value)` records for a
-     * workflow's definition-level `finalizer` activity (issue #446). Staged as a
-     * pending atomic side-effect so it commits with the next checkpoint or the
-     * terminal batch, and swept on terminal cleanup.
-     *
-     * **Current behavior (this release): recorded only.** Nothing reads this value
-     * yet. **Planned behavior (future release):** the engine will pass the decoded
-     * value as the finalizer's input when driving teardown after a
-     * `cancelled`/`timed-out` terminal, where presence means "a resource was
-     * recorded" and absence means the finalizer is skipped.
-     */
-    readonly finalizerState: (workflowId: string) => string;
-    /**
-     * Durable execution-claim + attempt marker for a workflow that owes a finalizer
-     * run after a `cancelled`/`timed-out` terminal (issue #446 Phase 2). Mirrors the
-     * `wf-cleanup-needed:` lifecycle. The value is the encoded claim record
-     * `{ status: 'owed' | 'running'; attempts: number; token: string; claimedAt?: number }`:
-     * the engine fenced-CAS's `owed → running` (stamping `claimedAt`) before invoking the
-     * finalizer, and settle-CAS's the exact `running` bytes it wrote when clearing or
-     * rescheduling. Liveness is decided purely by TIME: a `running` claim is reclaimable
-     * once `claimedAt` is older than the finalizer's per-attempt timeout plus a margin
-     * (see `teardownStaleThresholdMs`), so crash recovery is an ordinary stale-claim retry
-     * driven by the timer that survived the terminal batch — there is no in-memory liveness
-     * set and no epoch in the record. The cost is that a finalizer running past the stale
-     * threshold may be re-driven concurrently, which is why workflow finalizers must be
-     * idempotent. Present while teardown is outstanding; deleted by the finalizer on
-     * success or when it dead-letters, which is what unblocks purge.
-     */
-    readonly teardownOwed: (workflowId: string) => string;
-    /** Durable successful finalizer outcome, retained until workflow purge or retention. */
-    readonly teardownSucceeded: (workflowId: string) => string;
-    /**
-     * Durable audit record written when a workflow's finalizer permanently fails — the
-     * retry horizon is reached, or the recorded resource state vanished so the finalizer
-     * can never run (issue #446 Phase 2). Holds the `TeardownDeadLetterRecord` shape
-     * `{ type, lastError, attempts, deadLetteredAt, workflowExecutionToken?, finalizerInput? }`.
-     * **Excluded from the workflow purge delete-set** so it survives as the operator's
-     * evidence of a leaked external resource and remains queryable through the durable
-     * finalizer-status API after purge.
-     */
-    readonly teardownDeadLetter: (workflowId: string) => string;
-    readonly offload: (workflowId: string, key: string) => string;
-    readonly archive: (workflowId: string, key: string) => string;
-    readonly stateExecution: (ownerWorkflowId: string, key: string) => string;
-    readonly stateWorkflow: (workflowType: string, key: string) => string;
-    readonly streamChunkPrefix: (workflowId: string, key: string) => string;
-    readonly streamChunk: (workflowId: string, key: string, chunkIndex: number) => string;
-    readonly streamTail: (workflowId: string, key: string) => string;
-    readonly streamMetadata: (workflowId: string, key: string) => string;
-    readonly budgetCharged: (operationId: string) => string;
-    readonly toolEffect: (workflowId: string, agentId: string, semanticHash: string) => string;
-    readonly workflowVisibilityStatus: (status: string, workflowId: string) => string;
-    readonly workflowVisibilityType: (type: string, workflowId: string) => string;
-    readonly workflowVisibilityCreated: (createdAt: number, workflowId: string) => string;
-    readonly workflowVisibilityUpdated: (updatedAt: number, workflowId: string) => string;
-    readonly workflowVisibilityDeadline: (deadline: number, workflowId: string) => string;
-    readonly workflowVisibilityManifest: (workflowId: string) => string;
-    readonly workflowVisibilityMetaVersion: () => string;
-    readonly workflowVisibilityMetaBuiltAt: () => string;
-    readonly workflowVisibilityMetaCursor: () => string;
-    readonly catalogEntry: (name: string, revision: string) => string;
-    readonly catalogEntryPrefix: (name: string) => string;
-    readonly catalogActive: (name: string) => string;
-    readonly workflowOwnerEpoch: (workflowId: string) => string;
-    readonly workflowOwnerHolder: (workflowId: string) => string;
-    readonly ownershipModeMarker: () => string;
-    readonly applicationOutbox: (namespace: string, ownerId: string) => string;
-    readonly applicationOutboxSinkProbe: (namespace: string, ownerId: string, nonce: string) => string;
-    readonly applicationDeliveryPrefix: (namespace: string, ownerId: string) => string;
-    readonly applicationDelivery: (namespace: string, ownerId: string, deliveryId: string) => string;
-    readonly applicationDeliveryDuePrefix: (namespace: string, ownerId: string) => string;
-    readonly applicationDeliveryDue: (namespace: string, ownerId: string, availableAt: number, deliveryId: string) => string;
-    readonly applicationDeliveryIdempotency: (namespace: string, ownerId: string, key: string) => string;
-    readonly applicationDeliveryBySequencePrefix: (namespace: string, ownerId: string) => string;
-    readonly applicationDeliveryBySequence: (namespace: string, ownerId: string, sequence: number) => string;
-    readonly applicationDeliveryTerminalPrefix: (namespace: string, ownerId: string) => string;
-    readonly applicationDeliveryTerminal: (namespace: string, ownerId: string, terminalAt: number, deliveryId: string) => string;
-    readonly applicationMailbox: (namespace: string, resourceId: string) => string;
-    readonly applicationMailboxSinkProbe: (namespace: string, resourceId: string, nonce: string) => string;
-    readonly applicationCommandPrefix: (namespace: string, resourceId: string) => string;
-    readonly applicationCommand: (namespace: string, resourceId: string, commandId: string) => string;
-    readonly applicationCommandReadyPrefix: (namespace: string, resourceId: string) => string;
-    readonly applicationCommandReady: (namespace: string, resourceId: string, sequence: number) => string;
-    readonly applicationCommandIdempotency: (namespace: string, resourceId: string, key: string) => string;
-    readonly applicationCommandBySequencePrefix: (namespace: string, resourceId: string) => string;
-    readonly applicationCommandBySequence: (namespace: string, resourceId: string, sequence: number) => string;
-    readonly applicationCommandTerminalPrefix: (namespace: string, resourceId: string) => string;
-    readonly applicationCommandTerminal: (namespace: string, resourceId: string, terminalAt: number, commandId: string) => string;
-    readonly workflow: (id: string) => string;
-    readonly checkpoint: (id: string) => string;
-    readonly checkpointHistory: (id: string, step: number) => string;
-    readonly timelinePrefix: (id: string) => string;
-    readonly timeline: (id: string, step: number) => string;
-    readonly schedule: (id: string) => string;
-    readonly scheduleTick: (fireAt: number, id: string) => string;
-    readonly scheduleRun: (workflowId: string) => string;
-    /**
-     * Durable per-workflow manifest for the schedule that launched a run. Unlike
-     * `scheduleRun`, this link survives terminal cleanup so schedule history can
-     * be queried until the workflow itself is purged.
-     */
-    readonly scheduleRunLink: (workflowId: string) => string;
-    readonly scheduleRunBySchedulePrefix: (scheduleId: string) => string;
-    readonly scheduleRunBySchedule: (scheduleId: string, workflowId: string) => string;
-    readonly operation: (queue: string, scheduledAt: number, id: string) => string;
-    readonly operationInflight: (id: string) => string;
-    readonly operationQueued: (id: string) => string;
-    readonly operationResolved: (id: string) => string;
-    readonly bulkOperationAuditPrefix: () => string;
-    readonly bulkOperationAudit: (timestamp: number, requestId: string, confirmationToken: string) => string;
-    readonly operationResolvedByTimePrefix: () => string;
-    readonly operationResolvedByTime: (resolvedAt: number, id: string) => string;
-    readonly asyncActivity: (workflowId: string, token: string) => string;
-    readonly asyncActivityResolution: (workflowId: string, token: string) => string;
-    readonly activityReconciliationPrefix: (workflowId: string) => string;
-    readonly activityReconciliation: (workflowId: string, activityName: string, idempotencyKeyDigest: string) => string;
-    readonly eventPrefix: (workflowId: string) => string;
-    readonly event: (workflowId: string, sequence: number) => string;
-    readonly eventHead: (workflowId: string) => string;
-    readonly eventWatermark: (workflowId: string) => string;
-    readonly fleetEventPrefix: () => string;
-    readonly fleetEvent: (sequence: number) => string;
-    readonly fleetEventTail: () => string;
-    readonly fleetEventWatermark: () => string;
-    readonly fleetEventByWorkflowPrefix: (workflowId: string) => string;
-    readonly fleetEventByWorkflow: (workflowId: string, sequence: number) => string;
-    readonly signal: (workflowId: string, name: string, id: string) => string;
-    readonly startSignal: (workflowId: string, name: string, id: string) => string;
-    readonly signalSequence: (workflowId: string) => string;
-    readonly signalAcceptedResponsePrefix: (workflowId: string) => string;
-    readonly signalAcceptedResponse: (workflowId: string, name: string, signalId: string) => string;
-    readonly deadline: (deadline: number, workflowId: string) => string;
-    readonly terminalCleanup: (fireAt: number, timerId: string) => string;
-    /**
-     * Durable timer that drives a workflow's finalizer after a `cancelled`/`timed-out`
-     * terminal (issue #446 Phase 2). Sortable by `fireAt` and scanned by its own
-     * source (`wf-teardown:`) so it dispatches as the `teardown` timer kind rather
-     * than `terminal-cleanup`. Re-armed with exponential backoff on a failed finalizer
-     * attempt; the scheduler deletes the fired entry after the drive returns without
-     * throwing, so a backoff reschedule is a write of a new entry at the later `fireAt`.
-     */
-    readonly teardownTimer: (fireAt: number, timerId: string) => string;
-    readonly delayedStart: (startAt: number, workflowId: string) => string;
-    readonly terminalWorkflowPrefix: () => string;
-    readonly terminalWorkflow: (updatedAt: number, workflowId: string) => string;
-    readonly attribute: (workflowId: string) => string;
-    readonly attributeIndex: (attributeName: string, encodedValue: string, workflowId: string) => string;
-    readonly tagIndex: (tag: string, workflowId: string) => string;
-    readonly updatePrefix: (workflowId: string) => string;
-    readonly update: (workflowId: string, updateId: string) => string;
-    readonly updateResponse: (updateId: string) => string;
-    readonly updateIdempotency: (workflowId: string, key: string) => string;
-    /**
-     * Maps a start `idempotencyKey` to the workflow id created for it. Written
-     * atomically with the workflow record under a `conditionalBatch` gated on this
-     * key being absent, so concurrent same-key starts converge on one workflow.
-     * Unlike `updateIdempotency`, it is keyed by the idempotency key alone (no
-     * workflow id) because the workflow id is the value it resolves to. It is
-     * intentionally NOT swept on terminal cleanup: it must outlive the run so a
-     * post-completion `startOrSignal` sees a terminal workflow (and conflicts)
-     * rather than missing the mapping and creating a fresh run.
-     */
-    readonly startIdempotency: (key: string) => string;
-    /**
-     * The convergence signal id that `startOrSignal` derives from an idempotency
-     * key so independent same-key callers deliver ONE signal. Deliberately uses the
-     * RAW key (not `encodeStorageKeyComponent`): unlike `startIdempotency` this is a
-     * signal id, not a storage key, and `validateSignalId` is character-agnostic, so
-     * the raw key is always a valid id as long as it fits the byte cap (enforced as
-     * ≤117 bytes so `"start-idem:"` + key stays within the 128-byte signal-id
-     * ceiling). The two derivations are independent namespaces; both are individually
-     * correct, so the raw-vs-encoded difference is harmless.
-     */
-    readonly startIdempotencySignalId: (key: string) => string;
-    /** Scan prefix for engine liveness heartbeats (best-effort second-instance detection). */
-    readonly livenessPrefix: () => string;
-    /** Per-engine liveness heartbeat key. One key per engine instance under the shared store. */
-    readonly liveness: (instanceId: string) => string;
-    /**
-     * Scan/match prefix for the lease-fenced single-writer ownership keys
-     * ({@link KEYS.leaseEpoch} and {@link KEYS.leaseHolder}). Reserved so a
-     * caller can recognize lease-owned keys; the lease itself uses the two exact
-     * keys below, not a scan.
-     */
-    readonly leasePrefix: () => string;
-    /**
-     * The fencing epoch for lease-fenced ownership. A single shared key (one lease
-     * per durable store) holding an 8-byte big-endian uint64. It changes ONLY on
-     * ownership transfer (initial acquire or a steal after expiry), never on a
-     * renewal — so a holder's cached epoch stays stable across heartbeats and can
-     * be used unchanged as a `conditionalBatch` fencing condition. Kept separate
-     * from {@link KEYS.leaseHolder} precisely because `conditionalBatch` compares
-     * the whole stored value as bytes: folding the churning holder fields into the
-     * fencing token would make every renewal invalidate the fence.
-     */
-    readonly leaseEpoch: () => string;
-    /**
-     * The current lease holder record for lease-fenced ownership. A single shared
-     * key (one lease per durable store) holding a JSON `{ holderId, expiresAt,
-     * epoch }`. Renewed every heartbeat tick (the `expiresAt` field advances), so
-     * its bytes churn and it must NOT be used as the fencing token — see
-     * {@link KEYS.leaseEpoch}.
-     */
-    readonly leaseHolder: () => string;
-};
+export declare const KEYS: typeof WORKFLOW_RECORD_KEYS_CORE & typeof SIGNAL_KEYS & typeof WORKFLOW_LIFECYCLE_KEYS_CORE & typeof WORKFLOW_RECORD_KEYS_EXTENDED & typeof LEASE_KEYS & typeof MAILBOX_KEYS & typeof OUTBOX_KEYS & typeof OWNERSHIP_CLAIM_KEYS & typeof WORKFLOW_CATALOG_KEYS & typeof GENERATION_KEYS & typeof WORKFLOW_LIFECYCLE_KEYS_EXTENDED;

package/dist/storage/interface.js

@@ -1,2 +1,2 @@
 // @bun
-var E=import.meta.require;function l(e,t,n){if(!e.capabilities()[t])throw Error(`Feature "${n}" requires storage capability "${t}", but this storage backend does not provide it.`)}function x(e){let t=e.capabilities(),n=[];if(t.persistence!=="local"&&t.persistence!=="remote")n.push(`persistence must be "local" or "remote" (got "${t.persistence}")`);if(t.readAfterWrite!=="linearizable")n.push(`readAfterWrite must be "linearizable" (got "${t.readAfterWrite}")`);if(t.scanConsistency!=="snapshot")n.push(`scanConsistency must be "snapshot" (got "${t.scanConsistency}")`);if(!t.atomicBatch)n.push("atomicBatch must be true");if(!t.conditionalBatch)n.push("conditionalBatch must be true");if(n.length>0)throw Error(`Storage is not durable enough for recovery: ${n.join("; ")}.`)}function r(e){return encodeURIComponent(e)}function C(e){return decodeURIComponent(e)}function k(e){try{return decodeURIComponent(e)}catch{return null}}function o(e){return String(e).padStart(16,"0")}var d={catalogEntry:(e,t)=>`catalog-entry:${r(e)}:${r(t)}`,catalogEntryPrefix:(e)=>`catalog-entry:${r(e)}:`,catalogActive:(e)=>`catalog-active:${r(e)}`};var g="default";async function u(e,t){return await e.get(t)!==null}async function*s(e,t,n){for await(let[i]of e.scan(t,n))yield i}async function f(e,t){let n=0;for await(let i of s(e,t))n++;return n}async function m(e,t){let n=[];for await(let i of s(e,t))n.push({type:"delete",key:i});if(n.length===0)return 0;return await e.batch(n),n.length}async function I(e,t,n){let i=[];for await(let v of s(e,t,n))i.push({type:"delete",key:v});if(i.length===0)return 0;return await e.batch(i),i.length}var y={applicationMailbox:(e,t)=>`appmbx:v1:${r(e)}:${r(t)}`,applicationMailboxSinkProbe:(e,t,n)=>`appprobe:v1:${r(e)}:${r(t)}:${r(n)}`,applicationCommandPrefix:(e,t)=>`appcmd:v1:${r(e)}:${r(t)}:`,applicationCommand:(e,t,n)=>`appcmd:v1:${r(e)}:${r(t)}:${r(n)}`,applicationCommandReadyPrefix:(e,t)=>`appready:v1:${r(e)}:${r(t)}:`,applicationCommandReady:(e,t,n)=>`appready:v1:${r(e)}:${r(t)}:${o(n)}`,applicationCommandIdempotency:(e,t,n)=>`appidem:v1:${r(e)}:${r(t)}:${r(n)}`,applicationCommandBySequencePrefix:(e,t)=>`appseq:v1:${r(e)}:${r(t)}:`,applicationCommandBySequence:(e,t,n)=>`appseq:v1:${r(e)}:${r(t)}:${o(n)}`,applicationCommandTerminalPrefix:(e,t)=>`appterm:v1:${r(e)}:${r(t)}:`,applicationCommandTerminal:(e,t,n,i)=>`appterm:v1:${r(e)}:${r(t)}:${o(n)}:${r(i)}`};var b={applicationOutbox:(e,t)=>`appobx:v1:${r(e)}:${r(t)}`,applicationOutboxSinkProbe:(e,t,n)=>`appprobe:v1:outbox:${r(e)}:${r(t)}:${r(n)}`,applicationDeliveryPrefix:(e,t)=>`appdlv:v1:${r(e)}:${r(t)}:`,applicationDelivery:(e,t,n)=>`appdlv:v1:${r(e)}:${r(t)}:${r(n)}`,applicationDeliveryDuePrefix:(e,t)=>`appdue:v1:${r(e)}:${r(t)}:`,applicationDeliveryDue:(e,t,n,i)=>`appdue:v1:${r(e)}:${r(t)}:${o(n)}:${r(i)}`,applicationDeliveryIdempotency:(e,t,n)=>`appdidem:v1:${r(e)}:${r(t)}:${r(n)}`,applicationDeliveryBySequencePrefix:(e,t)=>`appdseq:v1:${r(e)}:${r(t)}:`,applicationDeliveryBySequence:(e,t,n)=>`appdseq:v1:${r(e)}:${r(t)}:${o(n)}`,applicationDeliveryTerminalPrefix:(e,t)=>`appdterm:v1:${r(e)}:${r(t)}:`,applicationDeliveryTerminal:(e,t,n,i)=>`appdterm:v1:${r(e)}:${r(t)}:${o(n)}:${r(i)}`};var h={workflowOwnerEpoch:(e)=>`wf-owner-epoch:${r(e)}`,workflowOwnerHolder:(e)=>`wf-owner-holder:${r(e)}`,ownershipModeMarker:()=>"ownership-mode-marker"};var P=["actrec:","appcmd:","appdidem:","appdlv:","appdseq:","appdterm:","appdue:","appidem:","appmbx:","appobx:","appprobe:","appready:","appseq:","appterm:","archive:","async-act:","attr:","audit:bulk:","blob:","budget:","budget-charged:","catalog-active:","catalog-entry:","child-by-parent:","ev:","fleet-event-by-workflow:","fleet-event:","fleet-event-tail","fleet-event-watermark","idx:","lease:","liveness:","offload:","ownership-mode-marker","op:","review:","schedule:","schedule-due:","schedule-run-by-schedule:","schedule-run-link:","schedule-run:","sig:","sigres:","sigseq:","start-idem:","state:","tag:","tool-effect:","upd:","upk:","upr:","wf:","wf-cleanup:","wf-cleanup-needed:","wf-concurrency:","wf-concurrency-holder:","wf-deadline:","wf-delayed:","wf-finalizer-state:","wf-has-services:","wf-headers:","wf-idx-","wf-owner-epoch:","wf-owner-holder:","wf-teardown:","wf-teardown-deadletter:","wf-teardown-needed:","wf-teardown-succeeded:","wf-terminal:"];var c=1e4,Z=1e4;class S extends Error{code="StorageBatchOperationLimitExceededError";cap=c;count;target;constructor(e,t){super(`${e} count ${t} exceeds MAX_BATCH_OPERATIONS (${c}).`);this.name="StorageBatchOperationLimitExceededError",this.target=e,this.count=t}}function p(e,t){if(t>c)throw new S(e,t)}function ee(e){return e.length>0?e.slice(0,-1)+String.fromCharCode(e.charCodeAt(e.length-1)+1):"\xFF"}function te(e,t={}){if(t.gt!==void 0&&e<=t.gt)return!1;if(t.gte!==void 0&&e<t.gte)return!1;if(t.lt!==void 0&&e>=t.lt)return!1;if(t.lte!==void 0&&e>t.lte)return!1;return!0}function re(e,t){if(e===null||t===null)return e===t;if(e.byteLength!==t.byteLength)return!1;for(let n=0;n<e.byteLength;n++)if(e[n]!==t[n])return!1;return!0}async function ne(e,t){if(e.has)return e.has(t);return u(e,t)}function ie(e,t,n){if(e.keys)return e.keys(t,n);return s(e,t,n)}async function oe(e,t){if(e.count)return e.count(t);return f(e,t)}async function ae(e,t){if(e.deletePrefix)return e.deletePrefix(t);return m(e,t)}async function se(e,t){p("batch operations",t.length),await e.batch(t)}async function le(e,t,n){if(p("conditionalBatch conditions",t.length),p("conditionalBatch operations",n.length),l(e,"conditionalBatch","storageConditionalBatch"),!e.conditionalBatch)throw Error("This storage backend reports conditionalBatch capability but does not implement the conditionalBatch() method.");return e.conditionalBatch(t,n)}var a=o,O="0",B="1",w=(e,t,n,i)=>`sig:${r(e)}:${r(t)}:${i}:${r(n)}`,ge={workflow:(e)=>`wf:${r(e)}`,checkpoint:(e)=>`wf:${r(e)}:ckpt`,checkpointHistory:(e,t)=>`wf:${r(e)}:ckpt:${String(t).padStart(10,"0")}`,timelinePrefix:(e)=>`wf:${r(e)}:timeline:`,timeline:(e,t)=>`wf:${r(e)}:timeline:${String(t).padStart(10,"0")}`,schedule:(e)=>`schedule:${r(e)}`,scheduleTick:(e,t)=>`schedule-due:${String(e).padStart(16,"0")}:${r(t)}`,scheduleRun:(e)=>`schedule-run:${r(e)}`,scheduleRunLink:(e)=>`schedule-run-link:${r(e)}`,scheduleRunBySchedulePrefix:(e)=>`schedule-run-by-schedule:${r(e)}:`,scheduleRunBySchedule:(e,t)=>`schedule-run-by-schedule:${r(e)}:${r(t)}`,operation:(e,t,n)=>`op:${e}:${a(t)}:${n}`,operationInflight:(e)=>`op:inflight:${e}`,operationQueued:(e)=>`op:queued:${e}`,operationResolved:(e)=>`op:resolved:${e}`,bulkOperationAuditPrefix:()=>"audit:bulk:",bulkOperationAudit:(e,t,n)=>`audit:bulk:${a(e)}:${r(t)}:${r(n)}`,operationResolvedByTimePrefix:()=>"op:resolved-by-time:",operationResolvedByTime:(e,t)=>`op:resolved-by-time:${a(e)}:${r(t)}`,asyncActivity:(e,t)=>`async-act:v1:${r(e)}:${r(t)}`,asyncActivityResolution:(e,t)=>`async-act:v1:${r(e)}:${r(t)}:resolution`,activityReconciliationPrefix:(e)=>`actrec:v1:${r(e)}:`,activityReconciliation:(e,t,n)=>`actrec:v1:${r(e)}:${r(t)}:${n}`,eventPrefix:(e)=>`ev:${r(e)}:`,event:(e,t)=>`ev:${r(e)}:${String(t).padStart(10,"0")}`,eventHead:(e)=>`ev:${r(e)}:head`,eventWatermark:(e)=>`ev:${r(e)}:watermark`,fleetEventPrefix:()=>"fleet-event:",fleetEvent:(e)=>`fleet-event:${String(e).padStart(10,"0")}`,fleetEventTail:()=>"fleet-event-tail",fleetEventWatermark:()=>"fleet-event-watermark",fleetEventByWorkflowPrefix:(e)=>`fleet-event-by-workflow:${r(e)}:`,fleetEventByWorkflow:(e,t)=>`fleet-event-by-workflow:${r(e)}:${String(t).padStart(10,"0")}`,signal:(e,t,n)=>w(e,t,n,B),startSignal:(e,t,n)=>w(e,t,n,O),signalSequence:(e)=>`sigseq:v1:${r(e)}`,signalAcceptedResponsePrefix:(e)=>`sigres:v1:${r(e)}:`,signalAcceptedResponse:(e,t,n)=>`sigres:v1:${r(e)}:${r(t)}:${r(n)}`,deadline:(e,t)=>`wf-deadline:${a(e)}:${r(t)}`,terminalCleanup:(e,t)=>`wf-cleanup:${a(e)}:${r(t)}`,teardownTimer:(e,t)=>`wf-teardown:${a(e)}:${r(t)}`,delayedStart:(e,t)=>`wf-delayed:${a(e)}:${r(t)}`,terminalWorkflowPrefix:()=>"wf-terminal:",terminalWorkflow:(e,t)=>`wf-terminal:${a(e)}:${r(t)}`,attribute:(e)=>`attr:${r(e)}`,attributeIndex:(e,t,n)=>`idx:${e}:${t}:${r(n)}`,tagIndex:(e,t)=>`tag:${r(e)}:${r(t)}`,updatePrefix:(e)=>`upd:${r(e)}:`,update:(e,t)=>`upd:${r(e)}:${t}`,updateResponse:(e)=>`upr:${e}`,updateIdempotency:(e,t)=>`upk:${r(e)}:${t}`,startIdempotency:(e)=>`start-idem:${r(e)}`,startIdempotencySignalId:(e)=>`start-idem:${e}`,livenessPrefix:()=>"liveness:",liveness:(e)=>`liveness:${r(e)}`,leasePrefix:()=>"lease:",leaseEpoch:()=>"lease:epoch",leaseHolder:()=>"lease:holder",...y,...b,...h,...d,budget:(e,t,n)=>`budget:${e}:${t}:${n}`,review:(e,t)=>`review:${r(e)}:${t}`,workflowHeaders:(e)=>`wf-headers:${r(e)}`,childCancellationPrefix:(e)=>`child-cancel:${r(e)}:`,childCancellation:(e,t)=>`child-cancel:${r(e)}:${r(t)}`,childWorkflowByParentPrefix:(e,t)=>`child-by-parent:${r(e)}:${t===void 0?"":`${r(t)}:`}`,childWorkflowByParent:(e,t,n)=>`child-by-parent:${r(e)}:${t===void 0?"":`${r(t)}:`}${r(n)}`,terminalCleanupNeeded:(e)=>`wf-cleanup-needed:${r(e)}`,workflowConcurrency:(e,t)=>`wf-concurrency:${r(e)}:${r(t)}`,workflowConcurrencyHolder:(e)=>`wf-concurrency-holder:${r(e)}`,workflowHasServices:(e)=>`wf-has-services:${r(e)}`,finalizerState:(e)=>`wf-finalizer-state:${r(e)}`,teardownOwed:(e)=>`wf-teardown-needed:${r(e)}`,teardownSucceeded:(e)=>`wf-teardown-succeeded:${r(e)}`,teardownDeadLetter:(e)=>`wf-teardown-deadletter:${r(e)}`,offload:(e,t)=>`offload:${r(e)}:${t}`,archive:(e,t)=>`archive:${r(e)}:${t}`,stateExecution:(e,t)=>`state:execution:${r(e)}:${r(t)}`,stateWorkflow:(e,t)=>`state:workflow-scope:${g}:${r(e)}:${r(t)}`,streamChunkPrefix:(e,t)=>`blob:${r(e)}:${t}:chunk:`,streamChunk:(e,t,n)=>`blob:${r(e)}:${t}:chunk:${String(n).padStart(10,"0")}`,streamTail:(e,t)=>`blob:${r(e)}:${t}:tail`,streamMetadata:(e,t)=>`blob:${r(e)}:${t}:meta`,budgetCharged:(e)=>`budget-charged:${e}`,toolEffect:(e,t,n)=>`tool-effect:${r(e)}:${t}:${n}`,workflowVisibilityStatus:(e,t)=>`wf-idx-status:${r(e)}:${r(t)}`,workflowVisibilityType:(e,t)=>`wf-idx-type:${r(e)}:${r(t)}`,workflowVisibilityCreated:(e,t)=>`wf-idx-created:${a(e)}:${r(t)}`,workflowVisibilityUpdated:(e,t)=>`wf-idx-updated:${a(e)}:${r(t)}`,workflowVisibilityDeadline:(e,t)=>`wf-idx-deadline:${a(e)}:${r(t)}`,workflowVisibilityManifest:(e)=>`wf-idx-manifest:${r(e)}`,workflowVisibilityMetaVersion:()=>"wf-idx-meta:version",workflowVisibilityMetaBuiltAt:()=>"wf-idx-meta:built-at",workflowVisibilityMetaCursor:()=>"wf-idx-meta:cursor"};export{g as DEFAULT_SCOPE,ge as KEYS,c as MAX_BATCH_OPERATIONS,Z as MAX_SCAN_LIMIT,S as StorageBatchOperationLimitExceededError,P as WEFT_RESERVED_KEY_PREFIXES,x as assertDurableStorageForRecovery,p as assertStorageBatchOperationCount,C as decodeStorageKeyComponent,r as encodeStorageKeyComponent,o as formatSortableStorageTimestamp,te as matchesScanOptions,l as requireStorageCapability,ee as resolvePrefixRangeEnd,se as storageBatch,le as storageConditionalBatch,oe as storageCount,ae as storageDeletePrefix,ne as storageHas,ie as storageKeys,re as storageValuesEqual,k as tryDecodeStorageKeyComponent};
+var W=import.meta.require;function g(e,t,n){if(!e.capabilities()[t])throw Error(`Feature "${n}" requires storage capability "${t}", but this storage backend does not provide it.`)}function k(e){let t=e.capabilities(),n=[];if(t.persistence!=="local"&&t.persistence!=="remote")n.push(`persistence must be "local" or "remote" (got "${t.persistence}")`);if(t.readAfterWrite!=="linearizable")n.push(`readAfterWrite must be "linearizable" (got "${t.readAfterWrite}")`);if(t.scanConsistency!=="snapshot")n.push(`scanConsistency must be "snapshot" (got "${t.scanConsistency}")`);if(!t.atomicBatch)n.push("atomicBatch must be true");if(!t.conditionalBatch)n.push("conditionalBatch must be true");if(n.length>0)throw Error(`Storage is not durable enough for recovery: ${n.join("; ")}.`)}function r(e){return encodeURIComponent(e)}function A(e){return decodeURIComponent(e)}function L(e){try{return decodeURIComponent(e)}catch{return null}}function o(e){return String(e).padStart(16,"0")}var f={catalogEntry:(e,t)=>`catalog-entry:${r(e)}:${r(t)}`,catalogEntryPrefix:(e)=>`catalog-entry:${r(e)}:`,catalogActive:(e)=>`catalog-active:${r(e)}`,catalogTombstone:(e,t)=>`catalog-tombstone:${r(e)}:${r(t)}`,catalogTombstonePrefix:()=>"catalog-tombstone:"};async function m(e,t){return await e.get(t)!==null}async function*s(e,t,n){for await(let[i]of e.scan(t,n))yield i}async function u(e,t){let n=0;for await(let i of s(e,t))n++;return n}async function y(e,t){let n=[];for await(let i of s(e,t))n.push({type:"delete",key:i});if(n.length===0)return 0;return await e.batch(n),n.length}async function M(e,t,n){let i=[];for await(let P of s(e,t,n))i.push({type:"delete",key:P});if(i.length===0)return 0;return await e.batch(i),i.length}var S={workflowGeneration:(e)=>`wf-gen:${r(e)}`};var b={livenessPrefix:()=>"liveness:",liveness:(e)=>`liveness:${r(e)}`,leasePrefix:()=>"lease:",leaseEpoch:()=>"lease:epoch",leaseHolder:()=>"lease:holder"};var h={applicationMailbox:(e,t)=>`appmbx:v1:${r(e)}:${r(t)}`,applicationMailboxSinkProbe:(e,t,n)=>`appprobe:v1:${r(e)}:${r(t)}:${r(n)}`,applicationCommandPrefix:(e,t)=>`appcmd:v1:${r(e)}:${r(t)}:`,applicationCommand:(e,t,n)=>`appcmd:v1:${r(e)}:${r(t)}:${r(n)}`,applicationCommandReadyPrefix:(e,t)=>`appready:v1:${r(e)}:${r(t)}:`,applicationCommandReady:(e,t,n)=>`appready:v1:${r(e)}:${r(t)}:${o(n)}`,applicationCommandIdempotency:(e,t,n)=>`appidem:v1:${r(e)}:${r(t)}:${r(n)}`,applicationCommandBySequencePrefix:(e,t)=>`appseq:v1:${r(e)}:${r(t)}:`,applicationCommandBySequence:(e,t,n)=>`appseq:v1:${r(e)}:${r(t)}:${o(n)}`,applicationCommandTerminalPrefix:(e,t)=>`appterm:v1:${r(e)}:${r(t)}:`,applicationCommandTerminal:(e,t,n,i)=>`appterm:v1:${r(e)}:${r(t)}:${o(n)}:${r(i)}`};var w={applicationOutbox:(e,t)=>`appobx:v1:${r(e)}:${r(t)}`,applicationOutboxSinkProbe:(e,t,n)=>`appprobe:v1:outbox:${r(e)}:${r(t)}:${r(n)}`,applicationDeliveryPrefix:(e,t)=>`appdlv:v1:${r(e)}:${r(t)}:`,applicationDelivery:(e,t,n)=>`appdlv:v1:${r(e)}:${r(t)}:${r(n)}`,applicationDeliveryDuePrefix:(e,t)=>`appdue:v1:${r(e)}:${r(t)}:`,applicationDeliveryDue:(e,t,n,i)=>`appdue:v1:${r(e)}:${r(t)}:${o(n)}:${r(i)}`,applicationDeliveryIdempotency:(e,t,n)=>`appdidem:v1:${r(e)}:${r(t)}:${r(n)}`,applicationDeliveryBySequencePrefix:(e,t)=>`appdseq:v1:${r(e)}:${r(t)}:`,applicationDeliveryBySequence:(e,t,n)=>`appdseq:v1:${r(e)}:${r(t)}:${o(n)}`,applicationDeliveryTerminalPrefix:(e,t)=>`appdterm:v1:${r(e)}:${r(t)}:`,applicationDeliveryTerminal:(e,t,n,i)=>`appdterm:v1:${r(e)}:${r(t)}:${o(n)}:${r(i)}`};var E={workflowOwnerEpoch:(e)=>`wf-owner-epoch:${r(e)}`,workflowOwnerHolder:(e)=>`wf-owner-holder:${r(e)}`,ownershipModeMarker:()=>"ownership-mode-marker"};var B="0",T="1",x=(e,t,n,i)=>`sig:${r(e)}:${r(t)}:${i}:${r(n)}`,C={signal:(e,t,n)=>x(e,t,n,T),startSignal:(e,t,n)=>x(e,t,n,B),signalSequence:(e)=>`sigseq:v1:${r(e)}`,signalAcceptedResponsePrefix:(e)=>`sigres:v1:${r(e)}:`,signalAcceptedResponse:(e,t,n)=>`sigres:v1:${r(e)}:${r(t)}:${r(n)}`};var c="default";var a=o,v={deadline:(e,t)=>`wf-deadline:${a(e)}:${r(t)}`,terminalCleanup:(e,t)=>`wf-cleanup:${a(e)}:${r(t)}`,teardownTimer:(e,t)=>`wf-teardown:${a(e)}:${r(t)}`,delayedStart:(e,t)=>`wf-delayed:${a(e)}:${r(t)}`,terminalWorkflowPrefix:()=>"wf-terminal:",terminalWorkflow:(e,t)=>`wf-terminal:${a(e)}:${r(t)}`},O={budget:(e,t,n)=>`budget:${e}:${t}:${n}`,review:(e,t)=>`review:${r(e)}:${t}`,workflowHeaders:(e)=>`wf-headers:${r(e)}`,childCancellationPrefix:(e)=>`child-cancel:${r(e)}:`,childCancellation:(e,t)=>`child-cancel:${r(e)}:${r(t)}`,childWorkflowByParentPrefix:(e,t)=>`child-by-parent:${r(e)}:${t===void 0?"":`${r(t)}:`}`,childWorkflowByParent:(e,t,n)=>`child-by-parent:${r(e)}:${t===void 0?"":`${r(t)}:`}${r(n)}`,terminalCleanupNeeded:(e)=>`wf-cleanup-needed:${r(e)}`,workflowConcurrency:(e,t)=>`wf-concurrency:${r(e)}:${r(t)}`,workflowConcurrencyHolder:(e)=>`wf-concurrency-holder:${r(e)}`,workflowHasServices:(e)=>`wf-has-services:${r(e)}`,finalizerState:(e)=>`wf-finalizer-state:${r(e)}`,teardownOwed:(e)=>`wf-teardown-needed:${r(e)}`,teardownSucceeded:(e)=>`wf-teardown-succeeded:${r(e)}`,teardownDeadLetter:(e)=>`wf-teardown-deadletter:${r(e)}`,offload:(e,t)=>`offload:${r(e)}:${t}`,archive:(e,t)=>`archive:${r(e)}:${t}`,stateExecution:(e,t)=>`state:execution:${r(e)}:${r(t)}`,stateWorkflow:(e,t)=>`state:workflow-scope:${c}:${r(e)}:${r(t)}`,streamChunkPrefix:(e,t)=>`blob:${r(e)}:${t}:chunk:`,streamChunk:(e,t,n)=>`blob:${r(e)}:${t}:chunk:${String(n).padStart(10,"0")}`,streamTail:(e,t)=>`blob:${r(e)}:${t}:tail`,streamMetadata:(e,t)=>`blob:${r(e)}:${t}:meta`,budgetCharged:(e)=>`budget-charged:${e}`,toolEffect:(e,t,n)=>`tool-effect:${r(e)}:${t}:${n}`,workflowVisibilityStatus:(e,t)=>`wf-idx-status:${r(e)}:${r(t)}`,workflowVisibilityType:(e,t)=>`wf-idx-type:${r(e)}:${r(t)}`,workflowVisibilityCreated:(e,t)=>`wf-idx-created:${a(e)}:${r(t)}`,workflowVisibilityUpdated:(e,t)=>`wf-idx-updated:${a(e)}:${r(t)}`,workflowVisibilityDeadline:(e,t)=>`wf-idx-deadline:${a(e)}:${r(t)}`,workflowVisibilityManifest:(e)=>`wf-idx-manifest:${r(e)}`,workflowVisibilityMetaVersion:()=>"wf-idx-meta:version",workflowVisibilityMetaBuiltAt:()=>"wf-idx-meta:built-at",workflowVisibilityMetaCursor:()=>"wf-idx-meta:cursor"};var l=o,_={workflow:(e)=>`wf:${r(e)}`,checkpoint:(e)=>`wf:${r(e)}:ckpt`,checkpointHistory:(e,t)=>`wf:${r(e)}:ckpt:${String(t).padStart(10,"0")}`,timelinePrefix:(e)=>`wf:${r(e)}:timeline:`,timeline:(e,t)=>`wf:${r(e)}:timeline:${String(t).padStart(10,"0")}`,schedule:(e)=>`schedule:${r(e)}`,scheduleTick:(e,t)=>`schedule-due:${String(e).padStart(16,"0")}:${r(t)}`,scheduleRun:(e)=>`schedule-run:${r(e)}`,scheduleRunLink:(e)=>`schedule-run-link:${r(e)}`,scheduleRunBySchedulePrefix:(e)=>`schedule-run-by-schedule:${r(e)}:`,scheduleRunBySchedule:(e,t)=>`schedule-run-by-schedule:${r(e)}:${r(t)}`,operation:(e,t,n)=>`op:${e}:${l(t)}:${n}`,operationInflight:(e)=>`op:inflight:${e}`,operationQueued:(e)=>`op:queued:${e}`,operationResolved:(e)=>`op:resolved:${e}`,bulkOperationAuditPrefix:()=>"audit:bulk:",bulkOperationAudit:(e,t,n)=>`audit:bulk:${l(e)}:${r(t)}:${r(n)}`,operationResolvedByTimePrefix:()=>"op:resolved-by-time:",operationResolvedByTime:(e,t)=>`op:resolved-by-time:${l(e)}:${r(t)}`,asyncActivity:(e,t)=>`async-act:v1:${r(e)}:${r(t)}`,asyncActivityResolution:(e,t)=>`async-act:v1:${r(e)}:${r(t)}:resolution`,activityReconciliationPrefix:(e)=>`actrec:v1:${r(e)}:`,activityReconciliation:(e,t,n)=>`actrec:v1:${r(e)}:${r(t)}:${n}`,eventPrefix:(e)=>`ev:${r(e)}:`,event:(e,t)=>`ev:${r(e)}:${String(t).padStart(10,"0")}`,eventHead:(e)=>`ev:${r(e)}:head`,eventWatermark:(e)=>`ev:${r(e)}:watermark`,fleetEventPrefix:()=>"fleet-event:",fleetEvent:(e)=>`fleet-event:${String(e).padStart(10,"0")}`,fleetEventTail:()=>"fleet-event-tail",fleetEventWatermark:()=>"fleet-event-watermark",fleetEventByWorkflowPrefix:(e)=>`fleet-event-by-workflow:${r(e)}:`,fleetEventByWorkflow:(e,t)=>`fleet-event-by-workflow:${r(e)}:${String(t).padStart(10,"0")}`},R={attribute:(e)=>`attr:${r(e)}`,attributeIndex:(e,t,n)=>`idx:${e}:${t}:${r(n)}`,tagIndex:(e,t)=>`tag:${r(e)}:${r(t)}`,updatePrefix:(e)=>`upd:${r(e)}:`,update:(e,t)=>`upd:${r(e)}:${t}`,updateResponse:(e)=>`upr:${e}`,updateIdempotency:(e,t)=>`upk:${r(e)}:${t}`,startIdempotency:(e)=>`start-idem:${r(e)}`,startIdempotencySignalId:(e)=>`start-idem:${e}`};var D=["actrec:","appcmd:","appdidem:","appdlv:","appdseq:","appdterm:","appdue:","appidem:","appmbx:","appobx:","appprobe:","appready:","appseq:","appterm:","archive:","async-act:","attr:","audit:bulk:","blob:","budget:","budget-charged:","catalog-active:","catalog-entry:","catalog-tombstone:","child-by-parent:","ev:","fleet-event-by-workflow:","fleet-event:","fleet-event-tail","fleet-event-watermark","idx:","lease:","liveness:","offload:","ownership-mode-marker","op:","review:","schedule:","schedule-due:","schedule-run-by-schedule:","schedule-run-link:","schedule-run:","sig:","sigres:","sigseq:","start-idem:","state:","tag:","tool-effect:","upd:","upk:","upr:","wf:","wf-cleanup:","wf-cleanup-needed:","wf-concurrency:","wf-concurrency-holder:","wf-deadline:","wf-delayed:","wf-finalizer-state:","wf-gen:","wf-has-services:","wf-headers:","wf-idx-","wf-owner-epoch:","wf-owner-holder:","wf-teardown:","wf-teardown-deadletter:","wf-teardown-needed:","wf-teardown-succeeded:","wf-terminal:"];var p=1e4,we=1e4;class K extends Error{code="StorageBatchOperationLimitExceededError";cap=p;count;target;constructor(e,t){super(`${e} count ${t} exceeds MAX_BATCH_OPERATIONS (${p}).`);this.name="StorageBatchOperationLimitExceededError",this.target=e,this.count=t}}function d(e,t){if(t>p)throw new K(e,t)}function Ee(e){return e.length>0?e.slice(0,-1)+String.fromCharCode(e.charCodeAt(e.length-1)+1):"\xFF"}function xe(e,t={}){if(t.gt!==void 0&&e<=t.gt)return!1;if(t.gte!==void 0&&e<t.gte)return!1;if(t.lt!==void 0&&e>=t.lt)return!1;if(t.lte!==void 0&&e>t.lte)return!1;return!0}function Ce(e,t){if(e===null||t===null)return e===t;if(e.byteLength!==t.byteLength)return!1;for(let n=0;n<e.byteLength;n++)if(e[n]!==t[n])return!1;return!0}async function ve(e,t){if(e.has)return e.has(t);return m(e,t)}function Oe(e,t,n){if(e.keys)return e.keys(t,n);return s(e,t,n)}async function _e(e,t){if(e.count)return e.count(t);return u(e,t)}async function Re(e,t){if(e.deletePrefix)return e.deletePrefix(t);return y(e,t)}async function Ke(e,t){d("batch operations",t.length),await e.batch(t)}async function Pe(e,t,n){if(d("conditionalBatch conditions",t.length),d("conditionalBatch operations",n.length),g(e,"conditionalBatch","storageConditionalBatch"),!e.conditionalBatch)throw Error("This storage backend reports conditionalBatch capability but does not implement the conditionalBatch() method.");return e.conditionalBatch(t,n)}var ke={..._,...C,...v,...R,...b,...h,...w,...E,...f,...S,...O};export{c as DEFAULT_SCOPE,ke as KEYS,p as MAX_BATCH_OPERATIONS,we as MAX_SCAN_LIMIT,K as StorageBatchOperationLimitExceededError,D as WEFT_RESERVED_KEY_PREFIXES,k as assertDurableStorageForRecovery,d as assertStorageBatchOperationCount,A as decodeStorageKeyComponent,r as encodeStorageKeyComponent,o as formatSortableStorageTimestamp,xe as matchesScanOptions,g as requireStorageCapability,Ee as resolvePrefixRangeEnd,Ke as storageBatch,Pe as storageConditionalBatch,_e as storageCount,Re as storageDeletePrefix,ve as storageHas,Oe as storageKeys,Ce as storageValuesEqual,L as tryDecodeStorageKeyComponent};

package/dist/storage/key-prefixes.d.ts

@@ -16,4 +16,4 @@
  * console.log(isWeftKey); // true
  * ```
  */
-export declare const WEFT_RESERVED_KEY_PREFIXES: readonly ["actrec:", "appcmd:", "appdidem:", "appdlv:", "appdseq:", "appdterm:", "appdue:", "appidem:", "appmbx:", "appobx:", "appprobe:", "appready:", "appseq:", "appterm:", "archive:", "async-act:", "attr:", "audit:bulk:", "blob:", "budget:", "budget-charged:", "catalog-active:", "catalog-entry:", "child-by-parent:", "ev:", "fleet-event-by-workflow:", "fleet-event:", "fleet-event-tail", "fleet-event-watermark", "idx:", "lease:", "liveness:", "offload:", "ownership-mode-marker", "op:", "review:", "schedule:", "schedule-due:", "schedule-run-by-schedule:", "schedule-run-link:", "schedule-run:", "sig:", "sigres:", "sigseq:", "start-idem:", "state:", "tag:", "tool-effect:", "upd:", "upk:", "upr:", "wf:", "wf-cleanup:", "wf-cleanup-needed:", "wf-concurrency:", "wf-concurrency-holder:", "wf-deadline:", "wf-delayed:", "wf-finalizer-state:", "wf-has-services:", "wf-headers:", "wf-idx-", "wf-owner-epoch:", "wf-owner-holder:", "wf-teardown:", "wf-teardown-deadletter:", "wf-teardown-needed:", "wf-teardown-succeeded:", "wf-terminal:"];
+export declare const WEFT_RESERVED_KEY_PREFIXES: readonly ["actrec:", "appcmd:", "appdidem:", "appdlv:", "appdseq:", "appdterm:", "appdue:", "appidem:", "appmbx:", "appobx:", "appprobe:", "appready:", "appseq:", "appterm:", "archive:", "async-act:", "attr:", "audit:bulk:", "blob:", "budget:", "budget-charged:", "catalog-active:", "catalog-entry:", "catalog-tombstone:", "child-by-parent:", "ev:", "fleet-event-by-workflow:", "fleet-event:", "fleet-event-tail", "fleet-event-watermark", "idx:", "lease:", "liveness:", "offload:", "ownership-mode-marker", "op:", "review:", "schedule:", "schedule-due:", "schedule-run-by-schedule:", "schedule-run-link:", "schedule-run:", "sig:", "sigres:", "sigseq:", "start-idem:", "state:", "tag:", "tool-effect:", "upd:", "upk:", "upr:", "wf:", "wf-cleanup:", "wf-cleanup-needed:", "wf-concurrency:", "wf-concurrency-holder:", "wf-deadline:", "wf-delayed:", "wf-finalizer-state:", "wf-gen:", "wf-has-services:", "wf-headers:", "wf-idx-", "wf-owner-epoch:", "wf-owner-holder:", "wf-teardown:", "wf-teardown-deadletter:", "wf-teardown-needed:", "wf-teardown-succeeded:", "wf-terminal:"];

package/dist/storage/key-prefixes.js

@@ -22,6 +22,7 @@ export const WEFT_RESERVED_KEY_PREFIXES = [
   "budget-charged:",
   "catalog-active:",
   "catalog-entry:",
+  "catalog-tombstone:",
   "child-by-parent:",
   "ev:",
   "fleet-event-by-workflow:",
@@ -58,6 +59,7 @@ export const WEFT_RESERVED_KEY_PREFIXES = [
   "wf-deadline:",
   "wf-delayed:",
   "wf-finalizer-state:",
+  "wf-gen:",
   "wf-has-services:",
   "wf-headers:",
   "wf-idx-",

package/dist/storage/lease-keys.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Storage key builders for engine liveness heartbeats and the store-wide
+ * lease-fenced single-writer lock.
+ *
+ * These are spread into `KEYS` in `interface.ts` rather than declared there, so
+ * the liveness and lease keyspace can carry its full rationale without pushing
+ * that file's documented line ceiling. Callers still reach them through `KEYS`,
+ * which keeps one import contract for storage keys.
+ *
+ * @module storage/lease-keys
+ */
+/**
+ * Engine liveness heartbeat keys plus the lease-fenced single-writer ownership
+ * keys (`ownership: 'lease'`).
+ *
+ * Spread into `KEYS`; not intended to be imported directly by engine code.
+ */
+export declare const LEASE_KEYS: {
+    /** Scan prefix for engine liveness heartbeats (best-effort second-instance detection). */
+    readonly livenessPrefix: () => string;
+    /** Per-engine liveness heartbeat key. One key per engine instance under the shared store. */
+    readonly liveness: (instanceId: string) => string;
+    /**
+     * Scan/match prefix for the lease-fenced single-writer ownership keys
+     * (`leaseEpoch` and `leaseHolder`). Reserved so a caller can recognize
+     * lease-owned keys; the lease itself uses the two exact keys below, not a scan.
+     */
+    readonly leasePrefix: () => string;
+    /**
+     * The fencing epoch for lease-fenced ownership. A single shared key (one lease
+     * per durable store) holding an 8-byte big-endian uint64. It changes ONLY on
+     * ownership transfer (initial acquire or a steal after expiry), never on a
+     * renewal — so a holder's cached epoch stays stable across heartbeats and can
+     * be used unchanged as a `conditionalBatch` fencing condition. Kept separate
+     * from `leaseHolder` precisely because `conditionalBatch` compares the whole
+     * stored value as bytes: folding the churning holder fields into the fencing
+     * token would make every renewal invalidate the fence.
+     */
+    readonly leaseEpoch: () => string;
+    /**
+     * The current lease holder record for lease-fenced ownership. A single shared
+     * key (one lease per durable store) holding a JSON `{ holderId, expiresAt,
+     * epoch }`. Renewed every heartbeat tick (the `expiresAt` field advances), so
+     * its bytes churn and it must NOT be used as the fencing token — see
+     * `leaseEpoch`.
+     */
+    readonly leaseHolder: () => string;
+};

package/dist/storage/lease-keys.js

@@ -0,0 +1,8 @@
+import { encodeStorageKeyComponent } from "./key-encoding.js";
+export const LEASE_KEYS = {
+  livenessPrefix: () => "liveness:",
+  liveness: (instanceId) => `liveness:${encodeStorageKeyComponent(instanceId)}`,
+  leasePrefix: () => "lease:",
+  leaseEpoch: () => "lease:epoch",
+  leaseHolder: () => "lease:holder"
+};