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

package/dist/types/message.d.mts

@@ -1,69 +1,56 @@
-import { MessageId } from "./message-id.mjs";
-import { RunId } from "./run-id.mjs";
-import { WorkflowListRunsOptions } from "./run-list.mjs";
+import { MessageId, RunId } from "./ids.mjs";
+import { ListRunsOptions } from "./run-list.mjs";
 import { Schema } from "@temelj/standard-schema";
 //#region src/types/message.d.ts
-/** Typed message channel that maps optional keys to durable message ids. */
-interface MessageChannel<TPayload = unknown, TKey = void> {
+/** Schema-validated message channel bound to one durable message ID. */
+export interface MessageChannel<TPayload = unknown, TRawPayload = unknown> {
   readonly name: string;
-  readonly schema?: Schema;
-  readonly resolveMessageId: (...args: MessageChannelKeyArgs<TKey>) => MessageId;
-  readonly types?: MessageChannelTypes<TPayload, TKey>;
+  readonly schema: Schema<TRawPayload, TPayload>;
 }
-/** Compile-time payload and key markers carried by a message channel. */
-interface MessageChannelTypes<TPayload, TKey> {
-  readonly payload: TPayload;
-  readonly key: TKey;
-}
-/** Argument tuple required when deriving a message id from a channel key. */
-type MessageChannelKeyArgs<TKey> = [void] extends [TKey] ? [key?: TKey] : [key: TKey];
 /** Configuration for defining a typed message channel. */
-interface MessageChannelConfig<TKey = void, TSchema extends Schema | undefined = undefined> {
+export interface MessageChannelConfig<TPayload, TRawPayload = unknown> {
   readonly name: string;
-  readonly schema?: TSchema;
-  readonly resolveMessageId?: (...args: MessageChannelKeyArgs<TKey>) => MessageId;
+  readonly schema: Schema<TRawPayload, TPayload>;
 }
 /** Options for sending a concrete message id to a workflow run. */
-interface SendMessageOptions {
+export interface SendMessageOptions {
   readonly messageId: MessageId;
   readonly payload?: unknown;
   readonly idempotencyKey?: string;
 }
-/** Options for sending through a typed message channel. */
-interface SendMessageChannelOptions<TPayload = unknown, TKey = void> {
-  readonly key?: TKey;
+export interface SendMessageChannelOptions<TPayload = unknown> {
   readonly payload?: TPayload;
   readonly idempotencyKey?: string;
 }
 /** Object form for sending through a typed message channel. */
-interface SendMessageChannelObject<TPayload = unknown, TKey = void> extends SendMessageChannelOptions<TPayload, TKey> {
-  readonly channel: MessageChannel<TPayload, TKey>;
+export interface SendMessageChannelObject<TPayload = unknown, TRawPayload = TPayload> extends SendMessageChannelOptions<TRawPayload> {
+  readonly channel: MessageChannel<TPayload, TRawPayload>;
 }
 /** Accepted input forms for sending a message to one run. */
-type SendMessageInput = SendMessageOptions | SendMessageChannelObject;
+export type SendMessageInput = SendMessageOptions | SendMessageChannelObject;
 /** Options for broadcasting a concrete message id to matching runs. */
-interface BroadcastMessageOptions extends SendMessageOptions {
+export interface BroadcastMessageOptions extends SendMessageOptions {
   readonly payload?: unknown;
-  readonly target?: WorkflowListRunsOptions;
+  readonly target?: ListRunsOptions;
 }
 /** Options for broadcasting through a typed message channel to matching runs. */
-interface BroadcastMessageChannelOptions<TPayload = unknown, TKey = void> extends SendMessageChannelOptions<TPayload, TKey> {
-  readonly target?: WorkflowListRunsOptions;
+export interface BroadcastMessageChannelOptions<TPayload = unknown> extends SendMessageChannelOptions<TPayload> {
+  readonly target?: ListRunsOptions;
 }
 /** Object form for broadcasting through a typed message channel. */
-interface BroadcastMessageChannelObject<TPayload = unknown, TKey = void> extends BroadcastMessageChannelOptions<TPayload, TKey> {
-  readonly channel: MessageChannel<TPayload, TKey>;
+export interface BroadcastMessageChannelObject<TPayload = unknown, TRawPayload = TPayload> extends BroadcastMessageChannelOptions<TRawPayload> {
+  readonly channel: MessageChannel<TPayload, TRawPayload>;
 }
 /** Accepted input forms for broadcasting a message to matching runs. */
-type BroadcastMessageInput = BroadcastMessageOptions | BroadcastMessageChannelObject;
+export type BroadcastMessageInput = BroadcastMessageOptions | BroadcastMessageChannelObject;
 /** Summary returned after broadcasting a message to matching runs. */
-interface BroadcastMessageResult {
+export interface BroadcastMessageResult {
   readonly messageId: MessageId;
   readonly runIds: RunId[];
   readonly deliveredMessages: number;
 }
 /** Options for waiting on a concrete message id from workflow code. */
-interface WaitForMessageOptions<TSchema extends Schema | undefined = undefined> {
+export interface WaitForMessageOptions<TSchema extends Schema | undefined = undefined> {
   readonly commandId?: string;
   readonly name?: string;
   readonly messageId: MessageId;
@@ -71,17 +58,16 @@ interface WaitForMessageOptions<TSchema extends Schema | undefined = undefined>
   readonly schema?: TSchema;
 }
 /** Options for waiting through a typed message channel from workflow code. */
-interface WaitForMessageChannelOptions<TKey = void> {
+export interface WaitForMessageChannelOptions {
   readonly commandId?: string;
   readonly name?: string;
-  readonly key?: TKey;
   readonly timeout?: Temporal.Duration;
 }
-/** Object form for waiting through a typed message channel. */
-interface WaitForMessageChannelObject<TKey = void> extends WaitForMessageChannelOptions<TKey> {
-  readonly channel: MessageChannel<unknown, TKey>;
+/** Sends messages to workflow runs, by message ID or through a typed channel. */
+export interface MessageSender {
+  /** Sends a named message to a workflow run. */
+  send(runId: RunId, options: SendMessageInput): Promise<void>;
+  /** Sends a payload through a typed message channel to a workflow run. */
+  send<TPayload, TRawPayload = TPayload>(runId: RunId, channel: MessageChannel<TPayload, TRawPayload>, options?: SendMessageChannelOptions<TRawPayload>): Promise<void>;
 }
-/** Accepted input forms for waiting on a workflow message. */
-type WaitForMessageInput<TSchema extends Schema | undefined = undefined> = WaitForMessageOptions<TSchema> | WaitForMessageChannelObject;
-//#endregion
-export { BroadcastMessageChannelObject, BroadcastMessageChannelOptions, BroadcastMessageInput, BroadcastMessageOptions, BroadcastMessageResult, MessageChannel, MessageChannelConfig, MessageChannelKeyArgs, MessageChannelTypes, type MessageId, SendMessageChannelObject, SendMessageChannelOptions, SendMessageInput, SendMessageOptions, WaitForMessageChannelObject, WaitForMessageChannelOptions, WaitForMessageInput, WaitForMessageOptions };
+//#endregion

package/dist/types/observation.d.mts

@@ -1,46 +1,38 @@
-import { MessageId } from "./message-id.mjs";
-import { RunId } from "./run-id.mjs";
+import { MessageId, RunId, StreamId, WorkerId } from "./ids.mjs";
+import { WorkflowErrorRecord } from "./error.mjs";
 import { CleanupRunsResult } from "./cleanup.mjs";
+import { HookKind } from "./hook.mjs";
 import { ScheduleId, TickSchedulesResult } from "./schedule.mjs";
-import { StreamId } from "./stream-id.mjs";
-import { WorkflowStepAttemptRecord } from "./step-attempts.mjs";
-import { WorkerId } from "./worker-id.mjs";
+import { StepAttemptRecord } from "./step-attempts.mjs";
 import { TelemetryContext } from "./telemetry.mjs";
-import { WorkflowLifecycleEvent, WorkflowRunRecord } from "./run.mjs";
-import { ChildWorkflowStartedEvent, EventRecord, MessageSentEvent, StreamEventKind, StreamFailedError } from "./events.mjs";
+import { RunRecord, WorkflowLifecycleEvent } from "./run.mjs";
+import { ChildWorkflowStartedEvent, EventRecord, MessageSentEvent, StreamEventKind } from "./events.mjs";
 import { StorageValue } from "@temelj/storage";
-import { EventHandler, EventPattern, Unsubscribe } from "@temelj/event";
+import { EventHandler, EventPattern } from "@temelj/event";
 //#region src/types/observation.d.ts
-/** Describes the workflow run observation event contract. */
-type RunObservationEvent = WorkflowLifecycleEvent;
-/** Describes the workflow durable event observation event contract. */
-interface DurableEventObservationEvent {
+export interface DurableEventObservationEvent {
   readonly runId: RunId;
   readonly event: EventRecord;
   readonly events: readonly EventRecord[];
 }
-/** Describes the workflow step attempt observation event contract. */
-interface StepAttemptObservationEvent {
+export interface StepAttemptObservationEvent {
   readonly runId: RunId;
-  readonly attempt: WorkflowStepAttemptRecord;
+  readonly attempt: StepAttemptRecord;
 }
-/** Describes the workflow message observation event contract. */
-interface MessageObservationEvent {
+export interface MessageObservationEvent {
   readonly runId: RunId;
   readonly messageId: MessageId;
   readonly payload?: StorageValue;
   readonly timestamp?: Temporal.Instant;
   readonly traceContext?: TelemetryContext;
 }
-/** Describes the workflow resume observation event contract. */
-interface ResumeObservationEvent {
+export interface ResumeObservationEvent {
   readonly runId: RunId;
   readonly messageId: MessageId;
   readonly payload?: StorageValue;
   readonly traceContext?: TelemetryContext;
 }
-/** Describes the workflow stream observation event contract. */
-interface StreamObservationEvent {
+export interface StreamObservationEvent {
   readonly runId: RunId;
   readonly streamId: StreamId;
   readonly streamName?: string;
@@ -49,29 +41,27 @@ interface StreamObservationEvent {
   readonly stepId: string;
   readonly stepName: string;
   readonly index?: number;
-  readonly error?: StreamFailedError;
+  readonly error?: WorkflowErrorRecord;
 }
-/** Describes a child workflow start observation event. */
-interface ChildWorkflowStartedObservationEvent {
+export interface ChildWorkflowStartedObservationEvent {
   readonly runId: RunId;
   readonly event: ChildWorkflowStartedEvent;
 }
-/** Describes the workflow cleanup observation event contract. */
-interface CleanupObservationEvent {
+export interface CleanupObservationEvent {
   readonly result: CleanupRunsResult;
 }
 /** Describes worker-side operation observations that are not durable run transitions. */
-interface WorkerOperationObservationEvent {
+export interface WorkerOperationObservationEvent {
   readonly workerId: WorkerId;
   readonly runId?: RunId;
   readonly operation: "poll" | "claim" | "heartbeat" | "lease_extension" | "lease_release";
   readonly status: "success" | "failure" | "claimed" | "empty";
   readonly timestamp: Temporal.Instant;
-  readonly run?: WorkflowRunRecord;
+  readonly run?: RunRecord;
   readonly error?: unknown;
 }
 /** Describes one recurring schedule fire that created a workflow run. */
-interface ScheduleRunCreatedObservationEvent {
+export interface ScheduleRunCreatedObservationEvent {
   readonly scheduleId: ScheduleId;
   readonly runId: RunId;
   readonly workflowName: string;
@@ -80,25 +70,24 @@ interface ScheduleRunCreatedObservationEvent {
   readonly timestamp: Temporal.Instant;
 }
 /** Describes one recurring schedule tick operation. */
-interface ScheduleTickObservationEvent {
+export interface ScheduleTickObservationEvent {
   readonly result: TickSchedulesResult;
   readonly timestamp: Temporal.Instant;
 }
-/** Describes the workflow observation event map contract. */
-interface ObservationEventMap {
-  readonly "workflow:run-created": RunObservationEvent;
-  readonly "workflow:run-claimed": RunObservationEvent;
-  readonly "workflow:run-started": RunObservationEvent;
-  readonly "workflow:run-waiting": RunObservationEvent;
-  readonly "workflow:run-rescheduled": RunObservationEvent;
-  readonly "workflow:run-lease-released": RunObservationEvent;
-  readonly "workflow:run-manual-retry": RunObservationEvent;
-  readonly "workflow:run-permanently-failed": RunObservationEvent;
-  readonly "workflow:run-retrying": RunObservationEvent;
-  readonly "workflow:run-completed": RunObservationEvent;
-  readonly "workflow:run-failed": RunObservationEvent;
-  readonly "workflow:run-canceled": RunObservationEvent;
-  readonly "workflow:run-metadata-updated": RunObservationEvent;
+export interface ObservationEventMap {
+  readonly "workflow:run-created": WorkflowLifecycleEvent;
+  readonly "workflow:run-claimed": WorkflowLifecycleEvent;
+  readonly "workflow:run-started": WorkflowLifecycleEvent;
+  readonly "workflow:run-waiting": WorkflowLifecycleEvent;
+  readonly "workflow:run-rescheduled": WorkflowLifecycleEvent;
+  readonly "workflow:run-lease-released": WorkflowLifecycleEvent;
+  readonly "workflow:run-manual-retry": WorkflowLifecycleEvent;
+  readonly "workflow:run-permanently-failed": WorkflowLifecycleEvent;
+  readonly "workflow:run-retrying": WorkflowLifecycleEvent;
+  readonly "workflow:run-completed": WorkflowLifecycleEvent;
+  readonly "workflow:run-failed": WorkflowLifecycleEvent;
+  readonly "workflow:run-canceled": WorkflowLifecycleEvent;
+  readonly "workflow:run-metadata-updated": WorkflowLifecycleEvent;
   readonly "workflow:durable-event-appended": DurableEventObservationEvent;
   readonly "workflow:step-attempt-updated": StepAttemptObservationEvent;
   readonly "workflow:message-sent": MessageObservationEvent;
@@ -112,14 +101,12 @@ interface ObservationEventMap {
   readonly "workflow:schedule-ticked": ScheduleTickObservationEvent;
   readonly "workflow:schedule-run-created": ScheduleRunCreatedObservationEvent;
 }
-/** Type used for workflow observation event pattern values. */
-type ObservationEventPattern = EventPattern<ObservationEventMap>;
-/** Type used for workflow observation event handler values. */
-type ObservationEventHandler<Pattern extends ObservationEventPattern = ObservationEventPattern> = EventHandler<ObservationEventMap, Pattern>;
-/** Type used for workflow observation unsubscribe values. */
-type ObservationUnsubscribe = Unsubscribe;
+/** An observation name paired with its corresponding payload. */
+export type ObservationEventArgs = { [Key in keyof ObservationEventMap]: [name: Key, payload: ObservationEventMap[Key]]; }[keyof ObservationEventMap];
+export type ObservationEventPattern = EventPattern<ObservationEventMap>;
+export type ObservationEventHandler<Pattern extends ObservationEventPattern = ObservationEventPattern> = EventHandler<ObservationEventMap, Pattern>;
 /** Internal emitter facade used to publish workflow observation events. */
-interface ObservationEmitter {
+export interface ObservationEmitter {
   readonly on: <Pattern extends ObservationEventPattern>(pattern: Pattern, handler: ObservationEventHandler<Pattern>) => () => void;
   readonly once: <Pattern extends ObservationEventPattern>(pattern: Pattern, handler: ObservationEventHandler<Pattern>) => () => void;
   readonly off: <Pattern extends ObservationEventPattern>(pattern: Pattern, handler: ObservationEventHandler<Pattern>) => void;
@@ -129,12 +116,11 @@ interface ObservationEmitter {
   };
   readonly clearListeners: (pattern?: ObservationEventPattern) => void;
   readonly listenerCount: (pattern?: ObservationEventPattern) => number;
-  readonly emitRunEvent: (run: WorkflowRunRecord, previousRun?: WorkflowRunRecord) => void;
-  readonly emitRunMetadataUpdated: (run: WorkflowRunRecord, previousRun?: WorkflowRunRecord) => void;
+  readonly emitRunEvent: (run: RunRecord, previousRun?: RunRecord) => void;
+  readonly emitRunMetadataUpdated: (run: RunRecord, previousRun?: RunRecord) => void;
   readonly emitDurableEventAppended: (runId: RunId, event: EventRecord, events: readonly EventRecord[]) => void;
   readonly emitMessageSent: (runId: RunId, event: MessageSentEvent) => void;
-  readonly emitHookResumed: (runId: RunId, messageId: MessageId, payload: StorageValue | undefined, traceContext: TelemetryContext | undefined) => void;
-  readonly emitWebhookResumed: (runId: RunId, messageId: MessageId, payload: StorageValue | undefined, traceContext: TelemetryContext | undefined) => void;
+  readonly emitHookResumed: (kind: HookKind, runId: RunId, messageId: MessageId, payload: StorageValue | undefined, traceContext: TelemetryContext | undefined) => void;
   readonly emitChildWorkflowStarted: (event: ChildWorkflowStartedObservationEvent) => void;
   readonly emitCleanupCompleted: (result: CleanupRunsResult) => void;
   readonly emitRetentionApplied: (result: CleanupRunsResult) => void;
@@ -142,5 +128,4 @@ interface ObservationEmitter {
   readonly emitScheduleTicked: (event: ScheduleTickObservationEvent) => void;
   readonly emitScheduleRunCreated: (event: ScheduleRunCreatedObservationEvent) => void;
 }
-//#endregion
-export { ChildWorkflowStartedObservationEvent, CleanupObservationEvent, DurableEventObservationEvent, MessageObservationEvent, ObservationEmitter, ObservationEventHandler, ObservationEventMap, ObservationEventPattern, ObservationUnsubscribe, ResumeObservationEvent, RunObservationEvent, ScheduleRunCreatedObservationEvent, ScheduleTickObservationEvent, StepAttemptObservationEvent, StreamObservationEvent, WorkerOperationObservationEvent };
+//#endregion

package/dist/types/pagination.d.mts

@@ -1,32 +1,16 @@
-import { z } from "zod";
 //#region src/types/pagination.d.ts
-declare const workflowCursorSchema: z.ZodString;
-declare const workflowPageDirectionSchema: z.ZodLiteral<"forward">;
-declare const workflowCursorKeyPartSchema: z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull]>;
-declare const workflowCursorPayloadSchema: z.ZodObject<{
-  key: z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull]>>;
-}, z.core.$strip>;
-/** Type used for workflow cursor values. */
-type Cursor = string;
-/** Type used for workflow page direction values. */
-type PageDirection = "forward";
-/** Options for workflow page. */
-interface PageOptions {
+export type Cursor = string;
+export interface PageOptions {
   readonly cursor?: Cursor;
   readonly limit?: number;
-  readonly direction?: PageDirection;
 }
-/** Type used for encoded workflow cursor payloads. */
-interface CursorPayload {
+export interface CursorPayload {
   readonly key: readonly CursorKeyPart[];
 }
-/** Type used for sortable workflow cursor key parts. */
-type CursorKeyPart = string | number | boolean | null;
-/** Describes the workflow page contract. */
-interface WorkflowPage<TItem> {
+export type CursorKeyPart = string | number | boolean | null;
+export interface WorkflowPage<TItem> {
   readonly items: readonly TItem[];
   readonly nextCursor?: Cursor;
   readonly hasMore: boolean;
 }
-//#endregion
-export { Cursor, CursorKeyPart, CursorPayload, PageDirection, PageOptions, WorkflowPage, workflowCursorKeyPartSchema, workflowCursorPayloadSchema, workflowCursorSchema, workflowPageDirectionSchema };
+//#endregion

package/dist/types/pagination.mjs

@@ -1,13 +1 @@
-import { z } from "zod";
-//#region src/types/pagination.ts
-const workflowCursorSchema = z.string({ error: "Workflow cursor is invalid" });
-const workflowPageDirectionSchema = z.literal("forward", { error: "Workflow page direction is invalid" });
-const workflowCursorKeyPartSchema = z.union([
-	z.string(),
-	z.number(),
-	z.boolean(),
-	z.null()
-]);
-const workflowCursorPayloadSchema = z.object({ key: z.array(workflowCursorKeyPartSchema).nonempty() });
-//#endregion
-export { workflowCursorKeyPartSchema, workflowCursorPayloadSchema, workflowCursorSchema, workflowPageDirectionSchema };
+export {};

package/dist/types/result.d.mts

@@ -1,62 +1,30 @@
-import { RunId } from "./run-id.mjs";
-import { Timeline } from "./timeline.mjs";
-import { WorkflowAttributePatch, WorkflowRunRecord, WorkflowRunStatus } from "./run.mjs";
 import { WorkflowErrorRecord } from "./error.mjs";
-import { EventRecord } from "./events.mjs";
-import { StorageValue } from "@temelj/storage";
+import { RunRecord } from "./run.mjs";
 //#region src/types/result.d.ts
-/** Kind values for workflow execution results. */
-type ExecutionResultKind = "completed" | "waiting" | "failed";
-/** Base contract for workflow execution results. */
-interface ExecutionResultBase {
-  readonly kind: ExecutionResultKind;
-  readonly run: WorkflowRunRecord;
-}
+export type ExecutionResultKind = "completed" | "waiting" | "failed";
 /** Result returned after a workflow execution attempt completes, waits, or fails. */
-type ExecutionResult<TOutput = unknown> = CompletedResult<TOutput> | WaitingResult | FailedResult;
+export type ExecutionResult<TOutput = unknown> = CompletedResult<TOutput> | WaitingResult | FailedResult;
 /** Execution result for a workflow run that completed during the attempt. */
-interface CompletedResult<TOutput> {
+export interface CompletedResult<TOutput> {
   readonly kind: "completed";
-  readonly run: WorkflowRunRecord<StorageValue, TOutput>;
+  readonly run: RunRecord;
   readonly output: TOutput;
 }
 /** Execution result for a workflow run that parked until a later time or message. */
-interface WaitingResult {
+export interface WaitingResult {
   readonly kind: "waiting";
-  readonly run: WorkflowRunRecord;
+  readonly run: RunRecord;
   readonly availableAt: Temporal.Instant;
 }
 /** Execution result for a workflow run that failed during the attempt. */
-interface FailedResult {
+export interface FailedResult {
   readonly kind: "failed";
-  readonly run: WorkflowRunRecord;
+  readonly run: RunRecord;
   readonly error: WorkflowErrorRecord;
 }
-/** Engine-level handle for inspecting and controlling a workflow run. */
-interface WorkflowHandle<TOutput = unknown> {
-  readonly runId: RunId;
-  readonly workflowName: string;
-  readonly workflowVersion?: string;
-  getRun(): Promise<WorkflowRunRecord>;
-  status(): Promise<WorkflowRunStatus>;
-  events(): Promise<readonly EventRecord[]>;
-  timeline(): Promise<Timeline>;
-  result(): Promise<ExecutionResult<TOutput>>;
-  setMetadata(metadata: unknown): Promise<WorkflowRunRecord>;
-  setAttributes(attributes: WorkflowAttributePatch): Promise<WorkflowRunRecord>;
-  cancel(): Promise<WorkflowRunRecord>;
-}
-/** Operations backing a workflow run handle facade. */
-interface HandleOperations {
-  getTimeline(runId: RunId): Promise<Timeline>;
-  setMetadata(runId: RunId, metadata: unknown): Promise<WorkflowRunRecord>;
-  setAttributes(runId: RunId, attributes: WorkflowAttributePatch): Promise<WorkflowRunRecord>;
-  cancel(runId: RunId): Promise<WorkflowRunRecord>;
-}
 /** Options for polling a client run handle until the run reaches a terminal result. */
-interface ResultOptions {
+export interface ResultOptions {
   readonly pollInterval?: Temporal.Duration;
   readonly timeout?: Temporal.Duration;
 }
-//#endregion
-export { CompletedResult, ExecutionResult, ExecutionResultBase, ExecutionResultKind, FailedResult, HandleOperations, ResultOptions, WaitingResult, WorkflowHandle };
+//#endregion

package/dist/types/retry.d.mts

@@ -1,48 +1,41 @@
 //#region src/types/retry.d.ts
 /** Retry policy for workflow runs after retryable workflow failures. */
-interface WorkflowRetryConfig {
+export interface RetryConfig {
   readonly maximumAttempts?: number;
   readonly initialInterval?: Temporal.Duration;
   readonly backoffCoefficient?: number;
   readonly maximumInterval?: Temporal.Duration;
 }
 /** Retry policy after duration values and defaults have been normalized. */
-interface WorkflowResolvedRetryConfig {
+export interface ResolvedRetryConfig {
   readonly maximumAttempts: number;
   readonly initialInterval?: Temporal.Duration;
   readonly backoffCoefficient: number;
   readonly maximumInterval?: Temporal.Duration;
 }
-/** Retry policy for durable task attempts. */
-type WorkflowStepRetryConfig = WorkflowRetryConfig;
-/** Step retry policy after duration values and defaults have been normalized. */
-type WorkflowResolvedStepRetryConfig = WorkflowResolvedRetryConfig;
 /** Resolved retry policy used after a worker cannot find a workflow implementation. */
-interface WorkflowResolvedMissingImplementationRetryConfig {
+export interface ResolvedMissingImplementationRetryConfig {
   readonly initialInterval: Temporal.Duration;
   readonly backoffCoefficient: number;
   readonly maximumInterval?: Temporal.Duration;
   readonly maximumAttempts: number;
 }
 /** Required default values used to complete missing-implementation retry options. */
-interface WorkflowMissingImplementationRetryDefaults {
+export interface MissingImplementationRetryDefaults {
   readonly initialInterval: Temporal.Duration;
   readonly backoffCoefficient: number;
   readonly maximumAttempts: number;
 }
 /** Required default values used to complete workflow and step retry options. */
-interface WorkflowResolvedRetryDefaults {
+export interface ResolvedRetryDefaults {
   readonly maximumAttempts: number;
   readonly backoffCoefficient: number;
 }
-/** Parsed retry policy before runtime defaults are applied. */
-type WorkflowParsedRetryConfig = WorkflowRetryConfig;
 /** Retry policy used when a worker cannot find an implementation for a claimed run. */
-interface WorkflowMissingImplementationRetryConfig {
+export interface MissingImplementationRetryConfig {
   readonly initialInterval?: Temporal.Duration;
   readonly backoffCoefficient?: number;
   readonly maximumInterval?: Temporal.Duration;
   readonly maximumAttempts?: number;
 }
-//#endregion
-export { WorkflowMissingImplementationRetryConfig, WorkflowMissingImplementationRetryDefaults, WorkflowParsedRetryConfig, WorkflowResolvedMissingImplementationRetryConfig, WorkflowResolvedRetryConfig, WorkflowResolvedRetryDefaults, WorkflowResolvedStepRetryConfig, WorkflowRetryConfig, WorkflowStepRetryConfig };
+//#endregion

package/dist/types/run-list.d.mts

@@ -1,10 +1,9 @@
 import { PageOptions } from "./pagination.mjs";
-import { WorkflowListStepAttemptsOptions } from "./step-attempts.mjs";
-import { WorkflowAttributeValue, WorkflowRunRetryReason, WorkflowRunStatus, WorkflowRunTransitionReason } from "./run.mjs";
+import { ListStepAttemptsOptions } from "./step-attempts.mjs";
+import { RunRetryReason, RunStatus, RunTransitionReason, WorkflowAttributeValue } from "./run.mjs";
 //#region src/types/run-list.d.ts
-/** Filters for listing stored workflow runs. */
-interface WorkflowListRunsOptions {
-  readonly status?: WorkflowRunStatus | readonly WorkflowRunStatus[];
+export interface ListRunsOptions {
+  readonly status?: RunStatus | readonly RunStatus[];
   readonly workflowName?: string;
   readonly workflowVersion?: string;
   readonly idempotencyKey?: string;
@@ -13,7 +12,7 @@ interface WorkflowListRunsOptions {
   readonly parentStepId?: string;
   readonly parentStepName?: string;
   readonly parentStepAttempt?: number;
-  readonly lastTransitionReason?: WorkflowRunTransitionReason | readonly WorkflowRunTransitionReason[];
+  readonly lastTransitionReason?: RunTransitionReason | readonly RunTransitionReason[];
   readonly createdAtFrom?: Temporal.Instant;
   readonly createdAtTo?: Temporal.Instant;
   readonly updatedAtFrom?: Temporal.Instant;
@@ -26,7 +25,7 @@ interface WorkflowListRunsOptions {
   readonly availableAtTo?: Temporal.Instant;
   readonly leaseExpiresAtFrom?: Temporal.Instant;
   readonly leaseExpiresAtTo?: Temporal.Instant;
-  readonly retryReason?: WorkflowRunRetryReason | readonly WorkflowRunRetryReason[];
+  readonly retryReason?: RunRetryReason | readonly RunRetryReason[];
   readonly retryAtFrom?: Temporal.Instant;
   readonly retryAtTo?: Temporal.Instant;
   readonly cleanupFinishedAtBefore?: Temporal.Instant;
@@ -36,8 +35,7 @@ interface WorkflowListRunsOptions {
   readonly limit?: number;
 }
 /** Paginated filters for listing stored workflow runs. */
-type WorkflowListRunsPageOptions = WorkflowListRunsOptions & PageOptions;
+export type ListRunsPageOptions = ListRunsOptions & PageOptions;
 /** Paginated filters for listing materialized step attempts. */
-type WorkflowListStepAttemptsPageOptions = WorkflowListStepAttemptsOptions & PageOptions;
-//#endregion
-export { WorkflowListRunsOptions, WorkflowListRunsPageOptions, WorkflowListStepAttemptsPageOptions };
+export type ListStepAttemptsPageOptions = ListStepAttemptsOptions & PageOptions;
+//#endregion

package/dist/types/run-options.d.mts

@@ -1,86 +1,79 @@
-import { RunId } from "./run-id.mjs";
-import { StepId } from "./step-id.mjs";
+import { RunId, StepId } from "./ids.mjs";
 import { WorkflowDefinition } from "./definition.mjs";
-import "./run.mjs";
 //#region src/types/run-options.d.ts
 /** Callback used to resolve the workflow version stored on a new run. */
-type WorkflowVersionResolver = (workflowName: string, definition: WorkflowDefinition<unknown, unknown, unknown>) => string | undefined | Promise<string | undefined>;
+export type VersionResolver = (workflowName: string, definition: WorkflowDefinition<unknown, unknown, unknown>) => string | undefined | Promise<string | undefined>;
 /** Options that control workflow run creation and scheduling. */
-interface WorkflowStartOptions {
+export interface StartOptions {
   readonly id?: string;
   readonly idempotencyKey?: string;
   readonly workflowVersion?: string;
-  readonly workflowVersionResolver?: WorkflowVersionResolver;
+  readonly workflowVersionResolver?: VersionResolver;
   readonly context?: unknown;
-  readonly parent?: WorkflowRunParentOptions;
+  readonly parent?: RunParentOptions;
   readonly availableAt?: Temporal.Instant;
   readonly deadlineAt?: Temporal.Instant;
 }
 /** Options for creating a single delayed workflow run at the next interval boundary. */
-interface ScheduleNextOptions {
+export interface ScheduleNextOptions {
   readonly id?: string;
   readonly every: Temporal.Duration;
   readonly idempotencyKey: string;
   readonly workflowVersion?: string;
-  readonly workflowVersionResolver?: WorkflowVersionResolver;
+  readonly workflowVersionResolver?: VersionResolver;
   readonly context?: unknown;
-  readonly parent?: WorkflowRunParentOptions;
+  readonly parent?: RunParentOptions;
   readonly deadlineAt?: Temporal.Instant;
   readonly from?: Temporal.Instant;
 }
 /** Resolved schedule-next options split into schedule metadata and run-start options. */
-interface ResolvedScheduleNextOptions {
+export interface ResolvedScheduleNextOptions {
   readonly schedule: ScheduleNextOptions & {
     readonly from: Temporal.Instant;
   };
-  readonly start: WorkflowStartOptions;
+  readonly start: StartOptions;
 }
-/** Single item in a batch workflow-start request. */
-interface WorkflowBatchStartItem<TRawInput = unknown> {
+export interface BatchStartItem<TRawInput = unknown> {
   readonly input: TRawInput;
-  readonly options?: WorkflowStartOptions;
+  readonly options?: StartOptions;
 }
 /** Parent workflow metadata stored on a child workflow run. */
-interface WorkflowRunParentOptions {
+export interface RunParentOptions {
   readonly runId: RunId;
   readonly stepId?: StepId;
   readonly stepName?: string;
   readonly stepAttempt?: number;
 }
 /** Options for executing or resuming a workflow run. */
-interface WorkflowExecutionOptions {
-  readonly start?: WorkflowStartOptions;
+export interface ExecutionOptions {
+  readonly start?: StartOptions;
   readonly signal?: AbortSignal;
 }
 /** Options for creating a new run from an existing run record. */
-interface WorkflowRerunOptions {
+export interface RerunOptions {
   readonly workflowName?: string;
   readonly workflowVersion?: string;
-  readonly workflowVersionResolver?: WorkflowVersionResolver;
-  readonly start?: WorkflowStartOptions;
+  readonly workflowVersionResolver?: VersionResolver;
+  readonly start?: StartOptions;
 }
 /** Options for moving a run back to pending at a new availability time. */
-interface WorkflowRescheduleRunOptions {
+export interface RescheduleRunOptions {
   readonly availableAt?: Temporal.Instant;
 }
 /** Options for releasing an expired worker lease from a run. */
-interface WorkflowReleaseStaleLeaseOptions {
+export interface ReleaseStaleLeaseOptions {
   readonly availableAt?: Temporal.Instant;
 }
-/** Options for retrying a failed workflow run. */
-interface WorkflowRetryFailedRunOptions {
+export interface RetryFailedRunOptions {
   readonly availableAt?: Temporal.Instant;
   readonly force?: boolean;
 }
-/** Options for marking a run as permanently failed. */
-interface WorkflowMarkRunPermanentlyFailedOptions {
+export interface MarkRunPermanentlyFailedOptions {
   readonly reason: string;
 }
-/** Options for resuming workflow execution. */
-interface WorkflowResumeOptions {
+export interface ResumeOptions {
   readonly signal?: AbortSignal;
 }
 /** Typed argument tuple used by runnable workflow wrappers. */
-type WorkflowRunArguments<TRawInput, TOptions> = [unknown] extends [TRawInput] ? [input: TRawInput, options?: TOptions] : [undefined] extends [TRawInput] ? [input?: TRawInput, options?: TOptions] : [input: TRawInput, options?: TOptions];
-//#endregion
-export { ResolvedScheduleNextOptions, ScheduleNextOptions, WorkflowBatchStartItem, WorkflowExecutionOptions, WorkflowMarkRunPermanentlyFailedOptions, WorkflowReleaseStaleLeaseOptions, WorkflowRerunOptions, WorkflowRescheduleRunOptions, WorkflowResumeOptions, WorkflowRetryFailedRunOptions, WorkflowRunArguments, WorkflowRunParentOptions, WorkflowStartOptions, WorkflowVersionResolver };
+export type RunArguments<TRawInput, TOptions> = [unknown] extends [TRawInput] ? [input: TRawInput, options?: TOptions] : [undefined] extends [TRawInput] ? [input?: TRawInput, options?: TOptions] : [input: TRawInput, options?: TOptions];
+//#endregion