@temelj/workflow 0.0.0-alpha.2 → 0.0.0-alpha.4

package/dist/types/step.d.mts

@@ -1,183 +1,172 @@
-import { RunId } from "./run-id.mjs";
-import { StepId } from "./step-id.mjs";
-import { WorkflowResolvedStepRetryConfig, WorkflowRetryConfig } from "./retry.mjs";
-import { WorkflowStartTarget } from "./definition.mjs";
 import { CreateHookOptions, CreateWebhookOptions, Hook, Webhook } from "./hook.mjs";
-import { LockRecord, WorkflowStepAcquireLockOptions, WorkflowStepReleaseLockOptions } from "./lock.mjs";
-import { MessageChannel, SendMessageChannelOptions, SendMessageOptions, WaitForMessageChannelOptions, WaitForMessageOptions } from "./message.mjs";
+import { ResolvedRetryConfig, RetryConfig } from "./retry.mjs";
+import { StartTarget } from "./definition.mjs";
+import { LockRecord, StepAcquireLockOptions, StepReleaseLockOptions } from "./lock.mjs";
+import { MessageChannel, MessageSender, WaitForMessageChannelOptions, WaitForMessageOptions } from "./message.mjs";
 import { CreateStreamOptions, Stream } from "./stream.mjs";
-import { WorkflowAttributePatch, WorkflowMaterializedStepType } from "./run.mjs";
-import { z } from "zod";
+import { AttributePatch, MaterializedStepType } from "./run.mjs";
 import { Schema, SchemaOutput } from "@temelj/standard-schema";
+import { StorageValue } from "@temelj/storage";
 import { Logger } from "@temelj/log";
 //#region src/types/step.d.ts
-declare const workflowChildWorkflowCancellationPolicySchema: z.ZodEnum<{
-  cascade: "cascade";
-  detach: "detach";
-}>;
-/** Grouped durable commands available inside a workflow handler. */
-interface WorkflowStepApi {
+/** Durable commands available inside a workflow handler. */
+export interface StepApi extends StepTaskApi {
   /** Scoped operational logger for workflow orchestration code. */
   readonly log: Logger;
-  /** Durable task, reusable step, sleep, and sleep-until commands. */
-  readonly task: WorkflowStepTaskApi;
   /** Durable child-workflow start and run commands. */
-  readonly workflow: WorkflowStepWorkflowApi;
+  readonly workflow: StepWorkflowApi;
   /** Durable message send and wait commands. */
-  readonly message: WorkflowStepMessageApi;
+  readonly message: StepMessageApi;
   /** Durable lock acquire, release, and scoped lock commands. */
-  readonly lock: WorkflowStepLockApi;
+  readonly lock: StepLockApi;
   /** Commands that persist workflow run metadata and attributes. */
-  readonly runData: WorkflowStepRunDataApi;
+  readonly runData: StepRunDataApi;
   /** Replay-safe time, random, ID, and byte sources. */
-  readonly deterministic: WorkflowDeterministicApi;
+  readonly deterministic: DeterministicApi;
   /** Durable stream creation commands. */
-  readonly stream: WorkflowStepStreamApi;
+  readonly stream: StepStreamApi;
   /** External resume hook and webhook creation commands. */
-  readonly hook: WorkflowStepHookApi;
+  readonly hook: StepHookApi;
 }
-/** Durable task, reusable step, and sleep commands available inside a workflow handler. */
-interface WorkflowStepTaskApi {
+/** Inline tasks, reusable steps, and sleeps. */
+export interface StepTaskApi {
   /** Runs an inline durable task and records the callback result for replay. */
-  run<TOutput>(config: WorkflowStepRunConfig, callback: (context: WorkflowStepContext) => Promise<TOutput> | TOutput): Promise<TOutput>;
+  run<TOutput>(config: StepRunConfig, callback: (context: WorkflowStepContext) => Promise<TOutput> | TOutput): Promise<TOutput>;
   /** Calls a reusable step definition with typed arguments. */
-  call<const TArgs extends readonly unknown[], TOutput>(definition: WorkflowStepDefinition<TArgs, TOutput>, ...args: TArgs): Promise<TOutput>;
+  call<const TArgs extends readonly unknown[], TOutput>(definition: StepDefinition<TArgs, TOutput>, ...args: TArgs): Promise<TOutput>;
   /** Pauses workflow execution for a durable duration. */
   sleep(commandId: string, duration: Temporal.Duration): Promise<void>;
   /** Pauses workflow execution until a durable instant. */
   sleepUntil(commandId: string, timestamp: Temporal.Instant): Promise<void>;
 }
 /** Durable child-workflow commands available inside a workflow handler. */
-interface WorkflowStepWorkflowApi {
+export interface StepWorkflowApi {
   /** Starts a child workflow and waits for its result. */
-  run<TInput, TOutput, TRawInput = TInput>(workflow: WorkflowStartTarget<TInput, TOutput, TRawInput>, input: TRawInput, options?: WorkflowStepRunWorkflowOptions): Promise<TOutput>;
+  run<TInput, TOutput, TRawInput = TInput>(workflow: StartTarget<TInput, TOutput, TRawInput>, input: TRawInput, options?: StepRunWorkflowOptions): Promise<TOutput>;
   /** Starts a child workflow without waiting for it to finish and returns its run ID. */
-  start<TInput, TOutput, TRawInput = TInput>(workflow: WorkflowStartTarget<TInput, TOutput, TRawInput>, input: TRawInput, options?: WorkflowStepStartWorkflowOptions): Promise<string>;
+  start<TInput, TOutput, TRawInput = TInput>(workflow: StartTarget<TInput, TOutput, TRawInput>, input: TRawInput, options?: StepStartWorkflowOptions): Promise<string>;
 }
 /** Durable message send and wait commands available inside a workflow handler. */
-interface WorkflowStepMessageApi {
-  /** Sends a named message to another workflow run. */
-  send(runId: RunId, options: SendMessageOptions): Promise<void>;
-  /** Sends a message through a typed message channel to another workflow run. */
-  send<TPayload, TKey = void>(runId: RunId, channel: MessageChannel<TPayload, TKey>, options?: SendMessageChannelOptions<TPayload, TKey>): Promise<void>;
+export interface StepMessageApi extends MessageSender {
   /** Waits for a named message and returns its payload. */
-  wait<TPayload = unknown>(options: WaitForMessageOptions): Promise<TPayload>;
+  wait(options: WaitForMessageOptions): Promise<StorageValue | undefined>;
   /** Waits for a named message and validates its payload with the configured schema. */
-  wait<const TSchema extends Schema>(options: WaitForMessageOptions<TSchema>): Promise<SchemaOutput<TSchema>>;
+  wait<const TSchema extends Schema>(options: WaitForMessageOptions<TSchema> & {
+    readonly schema: TSchema;
+  }): Promise<SchemaOutput<TSchema>>;
   /** Waits for a message through a typed message channel. */
-  wait<TPayload, TKey = void>(channel: MessageChannel<TPayload, TKey>, options?: WaitForMessageChannelOptions<TKey>): Promise<TPayload>;
+  wait<TPayload>(channel: MessageChannel<TPayload, unknown>, options?: WaitForMessageChannelOptions): Promise<TPayload>;
 }
 /** Durable lock commands available inside a workflow handler. */
-interface WorkflowStepLockApi {
+export interface StepLockApi {
   /** Acquires a workflow lock and records the fencing token in history. */
-  acquire(commandId: string, key: string, options: WorkflowStepAcquireLockOptions): Promise<LockRecord>;
+  acquire(commandId: string, key: string, options: StepAcquireLockOptions): Promise<LockRecord>;
   /** Releases a workflow lock held by this workflow. */
-  release(commandId: string, key: string, options?: WorkflowStepReleaseLockOptions): Promise<LockRecord>;
+  release(commandId: string, key: string, options?: StepReleaseLockOptions): Promise<LockRecord>;
   /** Acquires a workflow lock, runs a callback, and releases the lock afterward. */
-  with<TOutput>(commandId: string, key: string, options: WorkflowStepAcquireLockOptions, callback: (lock: LockRecord) => Promise<TOutput> | TOutput): Promise<TOutput>;
+  with<TOutput>(commandId: string, key: string, options: StepAcquireLockOptions, callback: (lock: LockRecord) => Promise<TOutput> | TOutput): Promise<TOutput>;
 }
 /** Durable run metadata and attribute update commands available inside a workflow handler. */
-interface WorkflowStepRunDataApi {
-  /** Replaces the workflow run metadata value. */
-  setMetadata(commandId: string, metadata: unknown): Promise<void>;
+export interface StepRunDataApi {
+  setMetadata(commandId: string, metadata: StorageValue): Promise<void>;
   /** Applies a workflow run attribute patch. */
-  setAttributes(commandId: string, attributes: WorkflowAttributePatch): Promise<void>;
+  setAttributes(commandId: string, attributes: AttributePatch): Promise<void>;
 }
 /** Replay-safe sources for time, randomness, generated IDs, and bytes inside a workflow handler. */
-interface WorkflowDeterministicApi {
+export interface DeterministicApi {
   /** Returns the current instant, recording it once so replay sees the same value. */
   now(commandId?: string): Promise<Temporal.Instant>;
   /** Returns a random number in [0, 1), recording it once so replay sees the same value. */
   random(commandId?: string): Promise<number>;
   /** Returns an engine-generated recorded ID for the command. */
   recordedId(commandId?: string): Promise<string>;
-  /** Alias for recordedId. */
   id(commandId?: string): Promise<string>;
   /** Returns a random UUID, recording it once so replay sees the same value. */
   uuid(commandId?: string): Promise<string>;
   /** Returns recorded random bytes with the requested length. */
   bytes(commandId: string, length: number): Promise<Uint8Array>;
 }
-/** Compatibility alias for the deterministic API exposed on WorkflowStepApi. */
-type WorkflowStepDeterministicApi = WorkflowDeterministicApi;
 /** Durable stream creation commands available inside a workflow handler. */
-interface WorkflowStepStreamApi {
+export interface StepStreamApi {
   /** Creates a durable stream that can be read while the workflow is running. */
   create<TChunk = unknown>(commandId: string, options?: CreateStreamOptions): Stream<TChunk>;
 }
 /** External resume token commands available inside a workflow handler. */
-interface WorkflowStepHookApi {
+export interface StepHookApi {
   /** Creates a message-backed external resume hook. */
-  create<TPayload = unknown>(options: CreateHookOptions): Hook<TPayload>;
+  create(options: CreateHookOptions): Hook<StorageValue | undefined>;
   /** Creates a message-backed external resume hook with schema-validated payloads. */
-  create<const TSchema extends Schema>(options: CreateHookOptions<TSchema>): Hook<SchemaOutput<TSchema>>;
+  create<const TSchema extends Schema>(options: CreateHookOptions<TSchema> & {
+    readonly schema: TSchema;
+  }): Hook<SchemaOutput<TSchema>>;
   /** Creates a webhook-labeled external resume hook. */
-  createWebhook<TPayload = unknown>(options: CreateWebhookOptions): Webhook<TPayload>;
+  createWebhook(options: CreateWebhookOptions): Webhook<StorageValue | undefined>;
   /** Creates a webhook-labeled external resume hook with schema-validated payloads. */
-  createWebhook<const TSchema extends Schema>(options: CreateWebhookOptions<TSchema>): Webhook<SchemaOutput<TSchema>>;
+  createWebhook<const TSchema extends Schema>(options: CreateWebhookOptions<TSchema> & {
+    readonly schema: TSchema;
+  }): Webhook<SchemaOutput<TSchema>>;
 }
 /** Configuration for a single durable task command or reusable step definition. */
-interface WorkflowStepRunConfig {
+export interface StepRunConfig {
   readonly name?: string;
   readonly commandId?: string;
-  readonly retry?: WorkflowRetryConfig;
+  readonly retry?: RetryConfig;
   readonly timeout?: Temporal.Duration;
 }
 /** Handler signature for reusable durable step definitions. */
-type WorkflowStepDefinitionHandler<TArgs extends readonly unknown[], TOutput> = (...args: [...TArgs, WorkflowStepContext]) => Promise<TOutput> | TOutput;
+export type StepDefinitionHandler<TArgs extends readonly unknown[], TOutput> = (context: WorkflowStepContext, ...args: TArgs) => Promise<TOutput> | TOutput;
 /** Reusable named durable task that can be called from workflow handlers. */
-interface WorkflowStepDefinition<TArgs extends readonly unknown[] = readonly unknown[], TOutput = unknown> {
+export interface StepDefinition<TArgs extends readonly unknown[] = readonly unknown[], TOutput = unknown> {
   /** Runtime configuration used when the reusable step is called. */
-  readonly config: WorkflowStepRunConfig;
+  readonly config: StepRunConfig;
   /** Durable command name used as the step identity by default. */
   readonly name: string;
   /** Handler invoked when the step is first executed. */
-  readonly handler: WorkflowStepDefinitionHandler<TArgs, TOutput>;
+  readonly handler: StepDefinitionHandler<TArgs, TOutput>;
   /** Compile-time type markers for arguments and output. */
-  readonly types?: WorkflowStepDefinitionTypes<TArgs, TOutput>;
+  readonly types?: StepDefinitionTypes<TArgs, TOutput>;
 }
 /** Compile-time type markers carried by a reusable step definition. */
-interface WorkflowStepDefinitionTypes<TArgs extends readonly unknown[], TOutput> {
-  /** Argument tuple accepted by the step handler before the context parameter. */
+export interface StepDefinitionTypes<TArgs extends readonly unknown[], TOutput> {
+  /** Argument tuple accepted by the step handler after the context parameter. */
   readonly args: TArgs;
   /** Awaited output returned by the step handler. */
   readonly output: TOutput;
 }
 /** Options for running a child workflow and waiting for its result from a durable step. */
-interface WorkflowStepRunWorkflowOptions extends WorkflowStepStartWorkflowOptions {
+export interface StepRunWorkflowOptions extends StepStartWorkflowOptions {
   readonly timeout?: Temporal.Duration;
   readonly pollInterval?: Temporal.Duration;
-  readonly retry?: WorkflowRetryConfig;
+  readonly retry?: RetryConfig;
 }
 /** Options for starting a child workflow in the background from a durable step. */
-interface WorkflowStepStartWorkflowOptions {
+export interface StepStartWorkflowOptions {
   readonly commandId?: string;
   readonly name?: string;
   readonly id?: string;
   readonly idempotencyKey?: string;
-  readonly cancellation?: WorkflowChildWorkflowCancellationPolicy;
+  readonly cancellation?: ChildWorkflowCancellationPolicy;
 }
 /** Controls whether child workflow runs are canceled when their parent run is canceled. */
-type WorkflowChildWorkflowCancellationPolicy = "cascade" | "detach";
+export type ChildWorkflowCancellationPolicy = "cascade" | "detach";
 /** Context passed to a durable task attempt. */
-interface WorkflowStepContext {
+export interface WorkflowStepContext {
   /** Stable identity and encounter count for this durable command. */
-  readonly step: WorkflowStepMetadata;
+  readonly step: StepMetadata;
   /** Current attempt number for retryable durable work. */
   readonly attempt: number;
   /** Resolved retry configuration for this attempt. */
-  readonly config: WorkflowResolvedStepRetryConfig;
+  readonly config: ResolvedRetryConfig;
   /** Abort signal for cancellation or timeout of this attempt. */
   readonly signal: AbortSignal;
   /** Scoped operational logger for this durable task attempt. */
   readonly log: Logger;
 }
 /** Identity and encounter metadata for a durable task attempt. */
-interface WorkflowStepMetadata {
+export interface StepMetadata {
   readonly id: string;
   readonly name: string;
   readonly count: number;
-  readonly kind: WorkflowMaterializedStepType;
+  readonly kind: MaterializedStepType;
 }
-//#endregion
-export { type StepId, WorkflowChildWorkflowCancellationPolicy, WorkflowDeterministicApi, WorkflowStepApi, WorkflowStepContext, WorkflowStepDefinition, WorkflowStepDefinitionHandler, WorkflowStepDefinitionTypes, WorkflowStepDeterministicApi, WorkflowStepHookApi, WorkflowStepLockApi, WorkflowStepMessageApi, WorkflowStepMetadata, WorkflowStepRunConfig, WorkflowStepRunDataApi, WorkflowStepRunWorkflowOptions, WorkflowStepStartWorkflowOptions, WorkflowStepStreamApi, WorkflowStepTaskApi, WorkflowStepWorkflowApi, workflowChildWorkflowCancellationPolicySchema };
+//#endregion

package/dist/types/step.mjs

@@ -1,5 +1 @@
-import { z } from "zod";
-//#region src/types/step.ts
-const workflowChildWorkflowCancellationPolicySchema = z.enum(["cascade", "detach"]);
-//#endregion
-export { workflowChildWorkflowCancellationPolicySchema };
+export {};

package/dist/types/store.d.mts

@@ -1,208 +1,81 @@
-import { MessageId } from "./message-id.mjs";
-import { RunId } from "./run-id.mjs";
+import { MessageId, RunId } from "./ids.mjs";
 import { CleanupMarkerRecord, CleanupRunsOptions, CleanupRunsResult } from "./cleanup.mjs";
 import { PageOptions, WorkflowPage } from "./pagination.mjs";
 import { ListSchedulesOptions, ScheduleId, ScheduleRecord } from "./schedule.mjs";
 import { LockRecord } from "./lock.mjs";
-import { WorkflowListRunsOptions } from "./run-list.mjs";
-import { WorkflowListStepAttemptsOptions, WorkflowStepAttemptRecord } from "./step-attempts.mjs";
-import { WorkflowRunRecord } from "./run.mjs";
+import { ListRunsOptions } from "./run-list.mjs";
+import { ListStepAttemptsOptions, StepAttemptRecord } from "./step-attempts.mjs";
+import { RunRecord } from "./run.mjs";
 import { EventRecord } from "./events.mjs";
-import { WorkflowWorkerRunFilterOptions } from "./worker.mjs";
+import { WorkerRunFilterOptions } from "./worker.mjs";
 import { Storage, StorageValue, StoredValue } from "@temelj/storage";
 //#region src/types/store.d.ts
-/** Type used for workflow storage values. */
-type WorkflowStorage = Storage<Record<string, StorageValue>, StorageValue, StoredValue>;
-/** Storage value stored for cleanup index entries. */
-type WorkflowCleanupIndexValue = StorageValue;
+export type WorkflowStorage = Storage<Record<string, StorageValue>, StorageValue, StoredValue>;
 /** Storage index entry removed during workflow cleanup. */
-interface WorkflowCleanupIndexKey {
+export interface CleanupIndexKey {
   readonly key: string;
-  readonly value: WorkflowCleanupIndexValue;
+  readonly value: StorageValue;
 }
 /** Index entry used to detect duplicate messageId delivery idempotency keys. */
-interface WorkflowMessageIdempotencyIndex {
+export interface MessageIdempotencyIndex {
   readonly runId: RunId;
   readonly messageId: MessageId;
   readonly timestamp: Temporal.Instant;
 }
-/** Options for workflow creation store. */
-interface CreateWorkflowStoreOptions {
+export interface CreateWorkflowStoreOptions {
   readonly storage?: WorkflowStorage;
   readonly namespace?: string;
 }
-/** Exposes workflow store namespace identity. */
-interface WorkflowStoreNamespace {
-  /** Namespace prefix used to isolate workflow records in storage. */
+/** Durable records of one namespace: runs, events, step attempts, schedules, and locks. */
+export interface WorkflowStore {
+  /** Prefix that isolates this store's records in storage. */
   readonly namespace: string;
-}
-/** Exposes workflow store storage identity. */
-interface WorkflowStoreStorageContext extends WorkflowStoreNamespace {
-  /** Underlying key-value storage used by the workflow store. */
   readonly storage: WorkflowStorage;
-}
-/** Shared workflow store metadata needed by default repository implementations. */
-interface WorkflowStoreMetadata extends WorkflowStoreStorageContext, WorkflowStoreCapabilitiesSource {}
-/** Exposes workflow store capability flags. */
-interface WorkflowStoreCapabilitiesSource {
-  /** Store capability flags used by engine services to choose safe coordination code paths. */
-  readonly capabilities: WorkflowStoreCapabilities;
-}
-/** Creates workflow run records. */
-interface WorkflowRunCreationRepository {
-  /** Creates a workflow run record. */
-  createRun(run: WorkflowRunRecord): Promise<WorkflowRunRecord>;
-}
-/** Reads workflow run records. */
-interface WorkflowRunReaderRepository {
-  /** Returns a workflow run by ID, if it exists. */
-  getRun(runId: RunId): Promise<WorkflowRunRecord | undefined>;
-}
-/** Updates workflow run records conditionally. */
-interface WorkflowRunConditionalWriterRepository {
-  /** Replaces a workflow run only when the stored record still matches the current value. */
-  updateRunIfCurrent(current: WorkflowRunRecord, next: WorkflowRunRecord): Promise<WorkflowRunRecord | undefined>;
-}
-/** Updates workflow run records unconditionally. */
-interface WorkflowRunUnconditionalWriterRepository {
-  /** Replaces a workflow run record. */
-  updateRun(run: WorkflowRunRecord): Promise<WorkflowRunRecord>;
-}
-/** Updates workflow run records. */
-interface WorkflowRunWriterRepository extends WorkflowRunUnconditionalWriterRepository, WorkflowRunConditionalWriterRepository {}
-/** Lists workflow run records. */
-interface WorkflowRunListerRepository {
-  /** Lists workflow runs matching optional filters. */
-  listRuns(options?: WorkflowListRunsOptions): Promise<readonly WorkflowRunRecord[]>;
-}
-/** Queries workflow run records. */
-interface WorkflowRunQueryRepository extends WorkflowRunReaderRepository, WorkflowRunListerRepository {
-  /** Lists one page of workflow runs matching optional filters. */
-  listRunsPage(options?: WorkflowListRunsOptions & PageOptions): Promise<WorkflowPage<WorkflowRunRecord>>;
-  /** Counts workflow runs matching optional filters. */
-  countRuns(options?: WorkflowListRunsOptions): Promise<number>;
-}
-/** Coordinates workflow run worker leases. */
-interface WorkflowRunLeaseRepository {
+  /** What the storage guarantees, so the engine can pick safe coordination paths. */
+  readonly capabilities: StoreCapabilities;
+  createRun(run: RunRecord): Promise<RunRecord>;
+  getRun(runId: RunId): Promise<RunRecord | undefined>;
+  getRunByIdempotencyKey(options: IdempotencyKeyOptions): Promise<RunRecord | undefined>;
+  updateRun(run: RunRecord): Promise<RunRecord>;
+  /** Replaces a run only when the stored record still equals `current`. */
+  updateRunIfCurrent(current: RunRecord, next: RunRecord): Promise<RunRecord | undefined>;
+  listRuns(options?: ListRunsOptions): Promise<readonly RunRecord[]>;
+  listRunsPage(options?: ListRunsOptions & PageOptions): Promise<WorkflowPage<RunRecord>>;
+  countRuns(options?: ListRunsOptions): Promise<number>;
   /** Claims a pending or reclaimable run for a worker. */
-  claimRun(options: WorkflowClaimRunOptions): Promise<WorkflowRunRecord | undefined>;
-  /** Extends the lease for a run already claimed by a worker. */
-  extendRunLease(options: WorkflowExtendRunLeaseOptions): Promise<WorkflowRunRecord | undefined>;
-  /** Releases the lease for a run claimed by a worker. */
-  releaseRunLease(options: WorkflowReleaseRunLeaseOptions): Promise<WorkflowRunRecord | undefined>;
-}
-/** Stores workflow run records and run leases. */
-interface WorkflowRunRepository extends WorkflowRunCreationRepository, WorkflowRunReaderRepository, WorkflowRunUnconditionalWriterRepository, WorkflowRunConditionalWriterRepository, WorkflowRunWriterRepository, WorkflowRunListerRepository, WorkflowRunQueryRepository, WorkflowRunLeaseRepository {}
-/** Stores workflow-scoped idempotency indexes for run creation. */
-interface WorkflowIdempotencyIndex {
-  /** Returns a workflow run by its workflow-scoped idempotency key, if it exists. */
-  getRunByIdempotencyKey(options: WorkflowIdempotencyKeyOptions): Promise<WorkflowRunRecord | undefined>;
-}
-/** Repairs duplicate-delivery idempotency indexes for messages sent to workflow runs. */
-interface WorkflowMessageIdempotencyRepairModel {
-  /** Rebuilds message idempotency indexes for a run from its event history. */
-  repairMessageIdempotencyIndexes(runId: RunId): Promise<readonly WorkflowMessageIdempotencyIndex[]>;
-}
-/** Looks up duplicate-delivery idempotency indexes for messages sent to workflow runs. */
-interface WorkflowMessageIdempotencyIndexLookup {
-  /** Returns true when a message idempotency key is already claimed for a run. */
-  hasMessageIdempotencyKey(runId: RunId, idempotencyKey: string): Promise<boolean>;
-}
-/** Appends durable workflow events. */
-interface WorkflowEventAppender {
-  /** Appends one durable event to a run's history. */
+  claimRun(options: ClaimRunOptions): Promise<RunRecord | undefined>;
+  extendRunLease(options: ExtendRunLeaseOptions): Promise<RunRecord | undefined>;
+  releaseRunLease(options: ReleaseRunLeaseOptions): Promise<RunRecord | undefined>;
   appendEvent(runId: RunId, event: EventRecord): Promise<readonly EventRecord[]>;
-}
-/** Appends durable workflow events conditionally on the current run record. */
-interface WorkflowConditionalEventAppender {
-  /** Appends one durable event only when the stored run still matches the current value. */
-  appendEventIfRunCurrent(current: WorkflowRunRecord, event: EventRecord): Promise<readonly EventRecord[] | undefined>;
-}
-/** Reads durable workflow event history. */
-interface WorkflowEventReader {
-  /** Returns all durable events recorded for a run. */
+  /** Appends an event only when the stored run still equals `current`. */
+  appendEventIfRunCurrent(current: RunRecord, event: EventRecord): Promise<readonly EventRecord[] | undefined>;
   getEvents(runId: RunId): Promise<readonly EventRecord[]>;
-}
-/** Waits for durable workflow event history changes. */
-interface WorkflowEventHistoryWatcher {
-  /** Resolves after the durable event history for a run changes or the optional signal aborts. */
+  /** Resolves after the run's event history changes, or when `signal` aborts. */
   waitForEventHistoryChange(runId: RunId, options?: WorkflowEventHistoryChangeWaitOptions): Promise<void>;
-}
-/** Stores durable workflow event history. */
-interface WorkflowEventLog extends WorkflowEventAppender, WorkflowConditionalEventAppender, WorkflowEventReader, WorkflowEventHistoryWatcher {}
-/** Options for waiting for durable event history changes. */
-interface WorkflowEventHistoryChangeWaitOptions {
-  readonly signal?: AbortSignal;
-}
-/** Looks up materialized step-attempt read models for runtime coordination. */
-interface WorkflowStepAttemptLookup {
-  /** Lists materialized step attempts for a run. */
-  listStepAttempts(runId: RunId, options?: WorkflowListStepAttemptsOptions): Promise<readonly WorkflowStepAttemptRecord[]>;
-}
-/** Stores materialized step-attempt read models. */
-interface WorkflowStepAttemptReadModel extends WorkflowStepAttemptLookup {
-  /** Lists one page of materialized step attempts for a run. */
-  listStepAttemptsPage(runId: RunId, options?: WorkflowListStepAttemptsOptions & PageOptions): Promise<WorkflowPage<WorkflowStepAttemptRecord>>;
-  /** Counts materialized step attempts for a run. */
-  countStepAttempts(runId: RunId, options?: WorkflowListStepAttemptsOptions): Promise<number>;
-  /** Rebuilds materialized step attempts for a run from its event history. */
-  repairStepAttempts(runId: RunId): Promise<readonly WorkflowStepAttemptRecord[]>;
-}
-/** Stores workflow cleanup markers and terminal-run cleanup operations. */
-interface WorkflowCleanupRepository {
-  /** Deletes terminal run data according to cleanup options. */
+  hasMessageIdempotencyKey(runId: RunId, idempotencyKey: string): Promise<boolean>;
+  /** Rebuilds a run's message idempotency indexes from its event history. */
+  repairMessageIdempotencyIndexes(runId: RunId): Promise<readonly MessageIdempotencyIndex[]>;
+  listStepAttempts(runId: RunId, options?: ListStepAttemptsOptions): Promise<readonly StepAttemptRecord[]>;
+  listStepAttemptsPage(runId: RunId, options?: ListStepAttemptsOptions & PageOptions): Promise<WorkflowPage<StepAttemptRecord>>;
+  countStepAttempts(runId: RunId, options?: ListStepAttemptsOptions): Promise<number>;
+  /** Rebuilds a run's step attempts from its event history. */
+  repairStepAttempts(runId: RunId): Promise<readonly StepAttemptRecord[]>;
   cleanupRuns(options: CleanupRunsOptions): Promise<CleanupRunsResult>;
-  /** Lists cleanup marker records. */
   listCleanupMarkers(): Promise<readonly CleanupMarkerRecord[]>;
-}
-/** Creates workflow schedule records. */
-interface WorkflowScheduleCreationRepository {
-  /** Creates a workflow schedule record. */
-  createSchedule<TInput = StorageValue>(schedule: ScheduleRecord<TInput>): Promise<ScheduleRecord<TInput>>;
-}
-/** Reads workflow schedule records. */
-interface WorkflowScheduleReaderRepository {
-  /** Returns a workflow schedule by ID, if it exists. */
+  createSchedule(schedule: ScheduleRecord): Promise<ScheduleRecord>;
   getSchedule(scheduleId: ScheduleId): Promise<ScheduleRecord | undefined>;
-}
-/** Updates workflow schedule records conditionally. */
-interface WorkflowScheduleConditionalWriterRepository {
-  /** Replaces a schedule only when the stored record still matches the current value. */
-  updateScheduleIfCurrent<TInput = StorageValue>(current: ScheduleRecord, next: ScheduleRecord<TInput>): Promise<ScheduleRecord<TInput> | undefined>;
-}
-/** Lists workflow schedule records. */
-interface WorkflowScheduleListerRepository {
-  /** Lists workflow schedules matching optional filters. */
+  updateScheduleIfCurrent(current: ScheduleRecord, next: ScheduleRecord): Promise<ScheduleRecord | undefined>;
   listSchedules(options?: ListSchedulesOptions): Promise<readonly ScheduleRecord[]>;
-}
-/** Queries workflow schedule records. */
-interface WorkflowScheduleQueryRepository extends WorkflowScheduleListerRepository {
-  /** Lists one page of workflow schedules matching optional filters. */
   listSchedulesPage(options?: ListSchedulesOptions & PageOptions): Promise<WorkflowPage<ScheduleRecord>>;
-}
-/** Stores workflow schedules. */
-interface WorkflowScheduleRepository extends WorkflowScheduleCreationRepository, WorkflowScheduleReaderRepository, WorkflowScheduleConditionalWriterRepository, WorkflowScheduleQueryRepository {}
-/** Reads workflow lock records. */
-interface WorkflowLockReaderRepository {
-  /** Returns a workflow lock by key, if it exists. */
   getLock(key: string): Promise<LockRecord | undefined>;
-}
-/** Lists workflow lock records. */
-interface WorkflowLockListerRepository {
-  /** Lists workflow locks. */
   listLocks(): Promise<readonly LockRecord[]>;
-}
-/** Updates workflow lock records conditionally. */
-interface WorkflowLockConditionalWriterRepository {
-  /** Replaces or creates a lock only when the stored record still matches the current value. */
+  /** Creates or replaces a lock only when the stored record still equals `current`. */
   updateLockIfCurrent(current: LockRecord | undefined, next: LockRecord): Promise<LockRecord | undefined>;
 }
-/** Stores workflow lock records. */
-interface WorkflowLockRepository extends WorkflowLockReaderRepository, WorkflowLockListerRepository, WorkflowLockConditionalWriterRepository {}
-/** Describes the full workflow store contract implemented by the default store. */
-interface WorkflowStore extends WorkflowStoreMetadata, WorkflowRunRepository, WorkflowIdempotencyIndex, WorkflowMessageIdempotencyIndexLookup, WorkflowMessageIdempotencyRepairModel, WorkflowEventLog, WorkflowStepAttemptReadModel, WorkflowCleanupRepository, WorkflowScheduleRepository, WorkflowLockRepository {}
-/** Describes the workflow store capabilities contract. */
-interface WorkflowStoreCapabilities {
+export interface WorkflowEventHistoryChangeWaitOptions {
+  readonly signal?: AbortSignal;
+}
+export interface StoreCapabilities {
   readonly conditionalWrites: boolean;
   readonly conditionalRunClaims: boolean;
   readonly conditionalRunUpdates: boolean;
@@ -222,33 +95,28 @@ interface WorkflowStoreCapabilities {
   readonly rollsBackEventsOnMaterializationFailure: boolean;
   readonly reconcilesStepAttemptsFromEvents: boolean;
 }
-/** Options for workflow idempotency key. */
-interface WorkflowIdempotencyKeyOptions {
+export interface IdempotencyKeyOptions {
   readonly workflowName: string;
   readonly workflowVersion?: string;
   readonly idempotencyKey: string;
 }
-/** Options for workflow claim run. */
-interface WorkflowClaimRunOptions extends WorkflowWorkerRunFilterOptions {
+export interface ClaimRunOptions extends WorkerRunFilterOptions {
   readonly runId?: RunId;
   readonly workerId: string;
   readonly now: Temporal.Instant;
   readonly leaseDuration: Temporal.Duration;
 }
-/** Options for workflow extend run lease. */
-interface WorkflowExtendRunLeaseOptions {
+export interface ExtendRunLeaseOptions {
   readonly runId: RunId;
   readonly workerId: string;
   readonly attempts?: number;
   readonly now: Temporal.Instant;
   readonly leaseDuration: Temporal.Duration;
 }
-/** Options for workflow release run lease. */
-interface WorkflowReleaseRunLeaseOptions {
+export interface ReleaseRunLeaseOptions {
   readonly runId: RunId;
   readonly workerId: string;
   readonly attempts?: number;
   readonly now: Temporal.Instant;
 }
-//#endregion
-export { CreateWorkflowStoreOptions, WorkflowClaimRunOptions, WorkflowCleanupIndexKey, WorkflowCleanupIndexValue, WorkflowCleanupRepository, WorkflowConditionalEventAppender, WorkflowEventAppender, WorkflowEventHistoryChangeWaitOptions, WorkflowEventHistoryWatcher, WorkflowEventLog, WorkflowEventReader, WorkflowExtendRunLeaseOptions, WorkflowIdempotencyIndex, WorkflowIdempotencyKeyOptions, WorkflowLockConditionalWriterRepository, WorkflowLockListerRepository, WorkflowLockReaderRepository, WorkflowLockRepository, WorkflowMessageIdempotencyIndex, WorkflowMessageIdempotencyIndexLookup, WorkflowMessageIdempotencyRepairModel, WorkflowReleaseRunLeaseOptions, WorkflowRunConditionalWriterRepository, WorkflowRunCreationRepository, WorkflowRunLeaseRepository, WorkflowRunListerRepository, WorkflowRunQueryRepository, WorkflowRunReaderRepository, WorkflowRunRepository, WorkflowRunUnconditionalWriterRepository, WorkflowRunWriterRepository, WorkflowScheduleConditionalWriterRepository, WorkflowScheduleCreationRepository, WorkflowScheduleListerRepository, WorkflowScheduleQueryRepository, WorkflowScheduleReaderRepository, WorkflowScheduleRepository, WorkflowStepAttemptLookup, WorkflowStepAttemptReadModel, WorkflowStorage, WorkflowStore, WorkflowStoreCapabilities, WorkflowStoreCapabilitiesSource, WorkflowStoreMetadata, WorkflowStoreNamespace, WorkflowStoreStorageContext };
+//#endregion