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

package/dist/types/client.d.mts

@@ -1,180 +1,137 @@
-import { RunId } from "./run-id.mjs";
+import { RunId, StreamIdOrName, WorkerId } from "./ids.mjs";
 import { CleanupMarkerRecord, CleanupRunsOptions, CleanupRunsResult, RetentionPolicyOptions } from "./cleanup.mjs";
-import { PageOptions, WorkflowPage } from "./pagination.mjs";
-import { ListSchedulesOptions, ListSchedulesPageOptions, ScheduleConfig, ScheduleId, ScheduleRecord, TickSchedulesOptions, TickSchedulesResult } from "./schedule.mjs";
-import { WorkflowMissingImplementationRetryConfig } from "./retry.mjs";
-import { WorkflowDefinition, WorkflowHandler, WorkflowImplementation, WorkflowStartTarget } from "./definition.mjs";
-import { HookInspection, ResumeHookOptions, ResumeWebhookOptions } from "./hook.mjs";
+import { HookInspection, ResumeHookOptions } from "./hook.mjs";
+import { WorkflowPage } from "./pagination.mjs";
+import { ListSchedulesPageOptions, ScheduleConfig, ScheduleId, ScheduleRecord, TickSchedulesOptions, TickSchedulesResult } from "./schedule.mjs";
+import { MissingImplementationRetryConfig } from "./retry.mjs";
+import { StartTarget, WorkflowDefinition, WorkflowImplementation } from "./definition.mjs";
 import { AcquireLockOptions, LockRecord, ReleaseLockOptions, ReleaseStaleLockOptions } from "./lock.mjs";
-import { WorkflowListRunsOptions, WorkflowListRunsPageOptions, WorkflowListStepAttemptsPageOptions } from "./run-list.mjs";
-import { BroadcastMessageChannelOptions, BroadcastMessageInput, BroadcastMessageResult, MessageChannel, SendMessageChannelOptions, SendMessageInput } from "./message.mjs";
-import { StreamIdOrName } from "./stream-id.mjs";
-import { FollowStreamOptions, ReadStreamOptions, ReadStreamPageOptions, StreamChunk, StreamInfo, StreamPage, StreamState, StreamUpdate, WaitStreamOptions } from "./stream.mjs";
-import { WorkflowRecoverySummary, WorkflowRecoverySummaryOptions, WorkflowRunSummary, WorkflowRunSummaryOptions } from "./summary.mjs";
-import { WorkflowListStepAttemptsOptions, WorkflowStepAttemptRecord, WorkflowStepAttemptSummary } from "./step-attempts.mjs";
-import { WorkerId } from "./worker-id.mjs";
-import { Timeline } from "./timeline.mjs";
-import { ResultOptions } from "./result.mjs";
-import { WorkflowAttributePatch, WorkflowRunRecord, WorkflowRunStatus } from "./run.mjs";
+import { ListRunsOptions, ListRunsPageOptions, ListStepAttemptsPageOptions } from "./run-list.mjs";
+import { BroadcastMessageChannelOptions, BroadcastMessageInput, BroadcastMessageResult, MessageChannel, MessageSender } from "./message.mjs";
+import { FollowStreamOptions, ReadStreamOptions, StreamChunk, StreamInfo, StreamState, StreamUpdate, WaitStreamOptions } from "./stream.mjs";
+import { StepDefinition } from "./step.mjs";
+import { RecoverySummary, RunSummary } from "./summary.mjs";
+import { ListStepAttemptsOptions, StepAttemptRecord, StepAttemptSummary } from "./step-attempts.mjs";
+import { ObservationEventHandler, ObservationEventPattern } from "./observation.mjs";
+import { AttributePatch, RunRecord } from "./run.mjs";
 import { EventRecord } from "./events.mjs";
-import { ScheduleNextOptions, WorkflowBatchStartItem, WorkflowMarkRunPermanentlyFailedOptions, WorkflowReleaseStaleLeaseOptions, WorkflowRerunOptions, WorkflowRescheduleRunOptions, WorkflowRetryFailedRunOptions, WorkflowRunArguments, WorkflowStartOptions } from "./run-options.mjs";
-import { WorkflowWakeDueRunsOptions, WorkflowWorker, WorkflowWorkerRunFilterOptions, WorkflowWorkerRunResult } from "./worker.mjs";
+import { WakeDueRunsOptions, WorkerRunFilterOptions, WorkerRunResult, WorkflowWorker } from "./worker.mjs";
+import { BatchStartItem, MarkRunPermanentlyFailedOptions, ReleaseStaleLeaseOptions, RerunOptions, RescheduleRunOptions, RetryFailedRunOptions, RunArguments, ScheduleNextOptions, StartOptions } from "./run-options.mjs";
+import { COMPILED_STEP, COMPILED_WORKFLOW } from "../compiled-function.mjs";
+import { RunHandle, RuntimeRunsApi, WorkflowRuntime } from "./runtime.mjs";
+import { Timeline } from "./timeline.mjs";
+import { StorageValue } from "@temelj/storage";
+import { Unsubscribe } from "@temelj/event";
 //#region src/types/client.d.ts
 /** Function shape emitted by the directive compiler for workflow and step functions. */
-type CompiledWorkflowFunction<TArgs extends readonly unknown[], TOutput> = (...args: TArgs) => Promise<TOutput> | TOutput;
-/** Client-level handle for awaiting output and inspecting a workflow run. */
-interface WorkflowRunHandle<TOutput = unknown> {
-  /** ID of the workflow run represented by this handle. */
-  readonly runId: RunId;
-  /** Workflow definition name stored on the run. */
-  readonly workflowName: string;
-  /** Workflow version stored on the run, when one was resolved. */
-  readonly workflowVersion?: string;
-  /** Returns the latest run record. */
-  getRun(): Promise<WorkflowRunRecord>;
-  /** Returns the latest run status. */
-  status(): Promise<WorkflowRunStatus>;
+export type CompiledWorkflowFunction<TArgs extends readonly unknown[], TOutput> = ((...args: TArgs) => Promise<TOutput> | TOutput) & {
+  readonly [COMPILED_WORKFLOW]?: WorkflowImplementation<TArgs, Awaited<TOutput>, TArgs>;
+  readonly [COMPILED_STEP]?: StepDefinition<TArgs, Awaited<TOutput>>;
+};
+/** A local run handle: the portable operations plus history, streams, metadata, and attributes. */
+export interface WorkflowRunHandle<TOutput = unknown> extends RunHandle<TOutput> {
   /** Returns all durable events recorded for the run. */
   events(): Promise<readonly EventRecord[]>;
   /** Returns a timeline projection of the run's event history. */
   timeline(): Promise<Timeline>;
-  /** Waits for and returns the completed workflow output. */
-  result(options?: ResultOptions): Promise<TOutput>;
-  /** Returns metadata for a durable stream on this run. */
-  getStreamInfo(streamIdOrName: StreamIdOrName): Promise<StreamInfo>;
-  /** Follows durable stream updates from this run. */
-  followStream<TChunk = unknown>(streamIdOrName: StreamIdOrName, options?: FollowStreamOptions): AsyncIterable<StreamUpdate<TChunk>>;
-  /** Waits until a durable stream exists on this run. */
-  waitForStream(streamIdOrName: StreamIdOrName, options?: WaitStreamOptions): Promise<StreamInfo | undefined>;
-  /** Waits for the next durable stream chunk after an index. */
-  waitForStreamChunk<TChunk = unknown>(streamIdOrName: StreamIdOrName, afterIndex: number, options?: WaitStreamOptions): Promise<StreamChunk<TChunk> | undefined>;
-  /** Waits until a durable stream is closed or failed. */
-  waitForStreamTerminal(streamIdOrName: StreamIdOrName, options?: WaitStreamOptions): Promise<StreamInfo | undefined>;
-  /** Reads all currently stored chunks for a durable stream. */
-  readStream<TChunk = unknown>(streamIdOrName: StreamIdOrName, options?: ReadStreamOptions): Promise<StreamState<TChunk>>;
-  /** Reads one page of currently stored chunks for a durable stream. */
-  readStreamPage<TChunk = unknown>(streamIdOrName: StreamIdOrName, options?: ReadStreamPageOptions): Promise<StreamPage<TChunk>>;
-  /** Moves the run back to pending at an optional new availability time. */
-  reschedule(options?: WorkflowRescheduleRunOptions): Promise<WorkflowRunRecord>;
-  /** Releases this run's worker lease when it is stale. */
-  releaseStaleLease(options?: WorkflowReleaseStaleLeaseOptions): Promise<WorkflowRunRecord>;
-  /** Retries this failed run. */
-  retryFailed(options?: WorkflowRetryFailedRunOptions): Promise<WorkflowRunRecord>;
-  /** Marks this run as permanently failed with an operator reason. */
-  markPermanentlyFailed(options: WorkflowMarkRunPermanentlyFailedOptions): Promise<WorkflowRunRecord>;
+  /** Durable stream reads for this run. */
+  readonly streams: RunStreamsApi;
   /** Replaces this run's metadata value. */
-  setMetadata(metadata: unknown): Promise<WorkflowRunRecord>;
+  setMetadata(metadata: StorageValue): Promise<RunRecord>;
   /** Applies an attribute patch to this run. */
-  setAttributes(attributes: WorkflowAttributePatch): Promise<WorkflowRunRecord>;
-  /** Cancels this run if it has not already reached a terminal status. */
-  cancel(): Promise<WorkflowRunRecord>;
+  setAttributes(attributes: AttributePatch): Promise<RunRecord>;
 }
-/** Runnable wrapper that starts a workflow definition through a bound client. */
-interface WorkflowRunnable<TInput = unknown, TOutput = unknown, TRawInput = TInput> {
-  /** Workflow definition that will be started by run. */
-  readonly definition: WorkflowDefinition<TInput, TOutput, TRawInput>;
-  /** Starts the workflow through the bound client and returns a run handle. */
-  run(...args: WorkflowRunArguments<TRawInput, WorkflowStartOptions>): Promise<WorkflowRunHandle<TOutput>>;
+/** Durable stream reads for one run: the operations of `client.streams`, without the run ID. */
+export interface RunStreamsApi {
+  getInfo(streamIdOrName: StreamIdOrName): Promise<StreamInfo>;
+  follow(streamIdOrName: StreamIdOrName, options?: FollowStreamOptions): AsyncIterable<StreamUpdate>;
+  wait(streamIdOrName: StreamIdOrName, options?: WaitStreamOptions): Promise<StreamInfo | undefined>;
+  waitForChunk(streamIdOrName: StreamIdOrName, afterIndex: number, options?: WaitStreamOptions): Promise<StreamChunk | undefined>;
+  waitForTerminal(streamIdOrName: StreamIdOrName, options?: WaitStreamOptions): Promise<StreamInfo | undefined>;
+  read(streamIdOrName: StreamIdOrName, options?: ReadStreamOptions): Promise<StreamState>;
 }
-/** Describes the workflow client contract. */
-interface WorkflowClient {
+export interface WorkflowClient extends WorkflowRuntime {
+  /** Subscribes to run lifecycle and operation events, such as `workflow:run-completed`. */
+  on<Pattern extends ObservationEventPattern>(pattern: Pattern, handler: ObservationEventHandler<Pattern>): Unsubscribe;
+  once<Pattern extends ObservationEventPattern>(pattern: Pattern, handler: ObservationEventHandler<Pattern>): Unsubscribe;
+  off<Pattern extends ObservationEventPattern>(pattern: Pattern, handler: ObservationEventHandler<Pattern>): void;
   /** Grouped run inspection and history operations. */
-  readonly runs: WorkflowClientRunsApi;
+  readonly runs: ClientRunsApi;
   /** Grouped administrative run maintenance operations. */
-  readonly admin: WorkflowClientAdminApi;
+  readonly admin: ClientAdminApi;
   /** Grouped schedule management operations. */
-  readonly schedules: WorkflowClientSchedulesApi;
-  /** Grouped workflow lock operations. */
-  readonly locks: WorkflowClientLocksApi;
+  readonly schedules: ClientSchedulesApi;
+  readonly locks: ClientLocksApi;
   /** Grouped external resume hook operations. */
-  readonly hooks: WorkflowClientHooksApi;
+  readonly hooks: ClientHooksApi;
   /** Grouped durable stream read operations. */
-  readonly streams: WorkflowClientStreamsApi;
+  readonly streams: ClientStreamsApi;
   /** Grouped message send operations. */
-  readonly messages: WorkflowClientMessagesApi;
+  readonly messages: ClientMessagesApi;
   /** Grouped worker creation and wake operations. */
-  readonly workers: WorkflowClientWorkersApi;
-  /** Flushes resources owned by the underlying engine when it supports explicit shutdown. */
-  close(): Promise<void>;
-  /** Registers a workflow implementation in the client's registry. */
-  implementWorkflow<TInput, TOutput, TRawInput = TInput>(definition: WorkflowDefinition<TInput, TOutput, TRawInput>, handler: WorkflowHandler<TInput, TOutput>): WorkflowImplementation<TInput, TOutput, TRawInput>;
-  /** Registers an existing workflow implementation in the client's registry. */
-  register<TInput, TOutput, TRawInput = TInput>(implementation: WorkflowImplementation<TInput, TOutput, TRawInput>): void;
-  /** Registers a workflow implementation and returns a client-bound runnable. */
-  workflow<TInput, TOutput, TRawInput = TInput>(definition: WorkflowDefinition<TInput, TOutput, TRawInput>, handler: WorkflowHandler<TInput, TOutput>): WorkflowRunnable<TInput, TOutput, TRawInput>;
+  readonly workers: ClientWorkersApi;
 }
-/** Describes the workflow client runs API contract. */
-interface WorkflowClientRunsApi {
-  /** Starts one workflow run and returns a typed handle. */
-  start<TInput, TOutput, TRawInput = TInput>(workflow: WorkflowStartTarget<TInput, TOutput, TRawInput>, ...args: WorkflowRunArguments<TRawInput, WorkflowStartOptions>): Promise<WorkflowRunHandle<TOutput>>;
+export interface ClientRunsApi extends RuntimeRunsApi {
+  /** Starts a run of a definition. */
+  start<TInput, TOutput, TRawInput = TInput>(workflow: WorkflowDefinition<TInput, TOutput, TRawInput>, ...args: RunArguments<TRawInput, StartOptions>): Promise<WorkflowRunHandle<TOutput>>;
+  /** Registers an implementation when needed, then starts a run of it. */
+  start<TInput, TOutput, TRawInput = TInput>(workflow: WorkflowImplementation<TInput, TOutput, TRawInput>, ...args: RunArguments<TRawInput, StartOptions>): Promise<WorkflowRunHandle<TOutput>>;
+  /** Starts a compiled workflow function produced by the workflow transform. */
+  start<TArgs extends readonly unknown[], TOutput>(workflow: CompiledWorkflowFunction<TArgs, TOutput>, ...args: TArgs): Promise<WorkflowRunHandle<Awaited<TOutput>>>;
+  /** A handle for an existing run. A run ID does not establish its output type, so validate the result. */
+  getHandle(runId: RunId): Promise<WorkflowRunHandle<StorageValue | undefined>>;
+  list(options?: ListRunsPageOptions): Promise<WorkflowPage<RunRecord>>;
   /** Starts multiple workflow runs for the same definition. */
-  startBatch<TInput, TOutput, TRawInput = TInput>(workflow: WorkflowStartTarget<TInput, TOutput, TRawInput>, items: readonly WorkflowBatchStartItem<TRawInput>[]): Promise<readonly WorkflowRunHandle<TOutput>[]>;
+  startBatch<TInput, TOutput, TRawInput = TInput>(workflow: StartTarget<TInput, TOutput, TRawInput>, items: readonly BatchStartItem<TRawInput>[]): Promise<readonly WorkflowRunHandle<TOutput>[]>;
   /** Returns a workflow run by ID, if it exists. */
-  get(runId: RunId): Promise<WorkflowRunRecord | undefined>;
+  get(runId: RunId): Promise<RunRecord | undefined>;
   /** Returns all durable events recorded for a run. */
   events(runId: RunId): Promise<readonly EventRecord[]>;
-  /** Lists one page of durable events recorded for a run. */
-  eventsPage(runId: RunId, options?: PageOptions): Promise<WorkflowPage<EventRecord>>;
-  /** Lists workflow runs matching optional filters. */
-  list(options?: WorkflowListRunsOptions): Promise<readonly WorkflowRunRecord[]>;
-  /** Lists one page of workflow runs matching optional filters. */
-  page(options?: WorkflowListRunsPageOptions): Promise<WorkflowPage<WorkflowRunRecord>>;
   /** Counts workflow runs matching optional filters. */
-  count(options?: WorkflowListRunsOptions): Promise<number>;
+  count(options?: ListRunsOptions): Promise<number>;
   /** Returns aggregate run metrics for runs matching optional filters. */
-  summary(options?: WorkflowRunSummaryOptions): Promise<WorkflowRunSummary>;
+  summary(options?: ListRunsOptions): Promise<RunSummary>;
   /** Returns recovery-oriented aggregate metrics for runs matching optional filters. */
-  recovery(options?: WorkflowRecoverySummaryOptions): Promise<WorkflowRecoverySummary>;
-  /** Returns a timeline projection for one run. */
+  recoverySummary(options?: ListRunsOptions): Promise<RecoverySummary>;
   timeline(runId: RunId): Promise<Timeline>;
-  /** Lists materialized step attempts for a run. */
-  listStepAttempts(runId: RunId, options?: WorkflowListStepAttemptsOptions): Promise<readonly WorkflowStepAttemptRecord[]>;
-  /** Lists one page of materialized step attempts for a run. */
-  listStepAttemptsPage(runId: RunId, options?: WorkflowListStepAttemptsPageOptions): Promise<WorkflowPage<WorkflowStepAttemptRecord>>;
-  /** Counts materialized step attempts for a run. */
-  countStepAttempts(runId: RunId, options?: WorkflowListStepAttemptsOptions): Promise<number>;
+  listStepAttempts(runId: RunId, options?: ListStepAttemptsPageOptions): Promise<WorkflowPage<StepAttemptRecord>>;
+  countStepAttempts(runId: RunId, options?: ListStepAttemptsOptions): Promise<number>;
   /** Returns aggregate step-attempt metrics for a run. */
-  stepAttemptSummary(runId: RunId, options?: WorkflowListStepAttemptsOptions): Promise<WorkflowStepAttemptSummary>;
+  stepAttemptSummary(runId: RunId, options?: ListStepAttemptsOptions): Promise<StepAttemptSummary>;
 }
-/** Describes the workflow client admin API contract. */
-interface WorkflowClientAdminApi {
+export interface ClientAdminApi {
   /** Deletes terminal run data according to cleanup options. */
   cleanup(options: CleanupRunsOptions): Promise<CleanupRunsResult>;
-  /** Lists cleanup marker records. */
   cleanupMarkers(): Promise<readonly CleanupMarkerRecord[]>;
   /** Deletes terminal run data according to a retention policy. */
   applyRetentionPolicy(options: RetentionPolicyOptions): Promise<CleanupRunsResult>;
   /** Creates a new run from an existing run record and returns its handle. */
-  rerun(runId: RunId, options?: WorkflowRerunOptions): Promise<WorkflowRunHandle<unknown>>;
+  rerun(runId: RunId, options?: RerunOptions): Promise<WorkflowRunHandle<unknown>>;
   /** Moves a run back to pending at an optional new availability time. */
-  reschedule(runId: RunId, options?: WorkflowRescheduleRunOptions): Promise<WorkflowRunRecord>;
+  reschedule(runId: RunId, options?: RescheduleRunOptions): Promise<RunRecord>;
   /** Releases a run's worker lease when it is stale. */
-  releaseStaleLease(runId: RunId, options?: WorkflowReleaseStaleLeaseOptions): Promise<WorkflowRunRecord>;
-  /** Retries a failed workflow run. */
-  retryFailed(runId: RunId, options?: WorkflowRetryFailedRunOptions): Promise<WorkflowRunRecord>;
+  releaseStaleLease(runId: RunId, options?: ReleaseStaleLeaseOptions): Promise<RunRecord>;
+  retryFailed(runId: RunId, options?: RetryFailedRunOptions): Promise<RunRecord>;
   /** Marks a workflow run as permanently failed with an operator reason. */
-  markPermanentlyFailed(runId: RunId, options: WorkflowMarkRunPermanentlyFailedOptions): Promise<WorkflowRunRecord>;
+  markPermanentlyFailed(runId: RunId, options: MarkRunPermanentlyFailedOptions): Promise<RunRecord>;
   /** Replaces a workflow run's metadata value. */
-  updateMetadata(runId: RunId, metadata: unknown): Promise<WorkflowRunRecord>;
+  setMetadata(runId: RunId, metadata: StorageValue): Promise<RunRecord>;
   /** Applies an attribute patch to a workflow run. */
-  setAttributes(runId: RunId, attributes: WorkflowAttributePatch): Promise<WorkflowRunRecord>;
+  setAttributes(runId: RunId, attributes: AttributePatch): Promise<RunRecord>;
   /** Cancels a workflow run if it has not already reached a terminal status. */
-  cancel(runId: RunId): Promise<WorkflowRunRecord>;
+  cancel(runId: RunId): Promise<RunRecord>;
 }
-/** Describes the workflow client schedules API contract. */
-interface WorkflowClientSchedulesApi {
+export interface ClientSchedulesApi {
   /** Schedules one workflow run at the next interval boundary. */
-  next<TInput, TOutput, TRawInput = TInput>(workflow: WorkflowStartTarget<TInput, TOutput, TRawInput>, input: TRawInput, options: ScheduleNextOptions): Promise<WorkflowRunHandle<TOutput>>;
+  next<TInput, TOutput, TRawInput = TInput>(workflow: StartTarget<TInput, TOutput, TRawInput>, input: TRawInput, options: ScheduleNextOptions): Promise<WorkflowRunHandle<TOutput>>;
   /** Creates a recurring workflow schedule. */
-  create<TInput, TOutput, TRawInput = TInput>(workflow: WorkflowStartTarget<TInput, TOutput, TRawInput>, options: ScheduleConfig<TInput, TRawInput>): Promise<ScheduleRecord<TInput>>;
+  create<TInput, TOutput, TRawInput = TInput>(workflow: StartTarget<TInput, TOutput, TRawInput>, options: ScheduleConfig<TInput, TRawInput>): Promise<ScheduleRecord>;
   /** Creates or updates a recurring workflow schedule. */
-  upsert<TInput, TOutput, TRawInput = TInput>(workflow: WorkflowStartTarget<TInput, TOutput, TRawInput>, options: ScheduleConfig<TInput, TRawInput>): Promise<ScheduleRecord<TInput>>;
+  upsert<TInput, TOutput, TRawInput = TInput>(workflow: StartTarget<TInput, TOutput, TRawInput>, options: ScheduleConfig<TInput, TRawInput>): Promise<ScheduleRecord>;
   /** Returns a schedule by ID, if it exists. */
   get(scheduleId: ScheduleId): Promise<ScheduleRecord | undefined>;
   /** Lists schedules matching optional filters. */
-  list(options?: ListSchedulesOptions): Promise<readonly ScheduleRecord[]>;
-  /** Lists one page of schedules matching optional filters. */
-  page(options?: ListSchedulesPageOptions): Promise<WorkflowPage<ScheduleRecord>>;
+  list(options?: ListSchedulesPageOptions): Promise<WorkflowPage<ScheduleRecord>>;
   /** Pauses an active schedule. */
   pause(scheduleId: ScheduleId): Promise<ScheduleRecord>;
   /** Resumes a paused or archived schedule. */
@@ -186,85 +143,67 @@ interface WorkflowClientSchedulesApi {
   /** Starts runs for schedules that are due. */
   tick(options?: TickSchedulesOptions): Promise<TickSchedulesResult>;
 }
-/** Describes the workflow client locks API contract. */
-interface WorkflowClientLocksApi {
-  /** Acquires a workflow lock. */
+export interface ClientLocksApi {
   acquire(key: string, options: AcquireLockOptions): Promise<LockRecord>;
   /** Returns a workflow lock by key, if it exists. */
   get(key: string): Promise<LockRecord | undefined>;
-  /** Lists workflow locks. */
   list(): Promise<readonly LockRecord[]>;
   /** Releases a workflow lock held by the supplied holder. */
   release(key: string, options: ReleaseLockOptions): Promise<LockRecord>;
   /** Releases a workflow lock only when its lease is stale. */
   releaseStale(key: string, options?: ReleaseStaleLockOptions): Promise<LockRecord>;
 }
-/** Describes the workflow client external hook API contract. */
-interface WorkflowClientHooksApi {
+export interface ClientHooksApi {
   /** Completes a pending message-backed external resume hook. */
   resume(token: string, options?: ResumeHookOptions): Promise<void>;
-  /** Completes a pending webhook-labeled external resume hook. */
-  resumeWebhook(token: string, options?: ResumeWebhookOptions): Promise<void>;
   /** Disposes a pending message-backed external resume hook. */
   dispose(token: string): Promise<HookInspection>;
-  /** Disposes a pending webhook-labeled external resume hook. */
-  disposeWebhook(token: string): Promise<HookInspection>;
   /** Returns inspection data for an external resume hook token. */
   getByToken(token: string): Promise<HookInspection>;
 }
-/** Describes the workflow client streams API contract. */
-interface WorkflowClientStreamsApi {
+export interface ClientStreamsApi {
   /** Returns metadata for a durable stream on a run. */
   getInfo(runId: RunId, streamIdOrName: StreamIdOrName): Promise<StreamInfo>;
   /** Follows durable stream updates from a run. */
-  follow<TChunk = unknown>(runId: RunId, streamIdOrName: StreamIdOrName, options?: FollowStreamOptions): AsyncIterable<StreamUpdate<TChunk>>;
+  follow(runId: RunId, streamIdOrName: StreamIdOrName, options?: FollowStreamOptions): AsyncIterable<StreamUpdate>;
   /** Waits until a durable stream exists on a run. */
   wait(runId: RunId, streamIdOrName: StreamIdOrName, options?: WaitStreamOptions): Promise<StreamInfo | undefined>;
   /** Waits for the next durable stream chunk after an index. */
-  waitForChunk<TChunk = unknown>(runId: RunId, streamIdOrName: StreamIdOrName, afterIndex: number, options?: WaitStreamOptions): Promise<StreamChunk<TChunk> | undefined>;
+  waitForChunk(runId: RunId, streamIdOrName: StreamIdOrName, afterIndex: number, options?: WaitStreamOptions): Promise<StreamChunk | undefined>;
   /** Waits until a durable stream is closed or failed. */
   waitForTerminal(runId: RunId, streamIdOrName: StreamIdOrName, options?: WaitStreamOptions): Promise<StreamInfo | undefined>;
   /** Reads all currently stored chunks for a durable stream. */
-  read<TChunk = unknown>(runId: RunId, streamIdOrName: StreamIdOrName, options?: ReadStreamOptions): Promise<StreamState<TChunk>>;
-  /** Reads one page of currently stored chunks for a durable stream. */
-  readPage<TChunk = unknown>(runId: RunId, streamIdOrName: StreamIdOrName, options?: ReadStreamPageOptions): Promise<StreamPage<TChunk>>;
+  read(runId: RunId, streamIdOrName: StreamIdOrName, options?: ReadStreamOptions): Promise<StreamState>;
 }
-/** Describes the workflow client messages API contract. */
-interface WorkflowClientMessagesApi {
-  /** Sends a named message to a workflow run. */
-  send(runId: RunId, options: SendMessageInput): Promise<void>;
-  /** Sends a typed message channel payload to a workflow run. */
-  send<TPayload, TKey = void>(runId: RunId, channel: MessageChannel<TPayload, TKey>, options?: SendMessageChannelOptions<TPayload, TKey>): Promise<void>;
+export interface ClientMessagesApi extends MessageSender {
   /** Broadcasts a named message to runs matching the target options. */
   broadcast(options: BroadcastMessageInput): Promise<BroadcastMessageResult>;
   /** Broadcasts a typed message channel payload to runs matching the target options. */
-  broadcast<TPayload, TKey = void>(channel: MessageChannel<TPayload, TKey>, options?: BroadcastMessageChannelOptions<TPayload, TKey>): Promise<BroadcastMessageResult>;
+  broadcast<TPayload, TRawPayload = TPayload>(channel: MessageChannel<TPayload, TRawPayload>, options?: BroadcastMessageChannelOptions<TRawPayload>): Promise<BroadcastMessageResult>;
 }
-/** Describes the workflow client worker API contract. */
-interface WorkflowClientWorkersApi {
+export interface ClientWorkersApi {
   /** Creates a worker bound to this client engine and registry. */
-  create(options?: WorkflowClientWorkerOptions): WorkflowWorker;
+  create(options?: ClientWorkerOptions): WorkflowWorker;
   /** Processes a specific run once by ID. */
-  processRun(runId: RunId, options?: WorkflowClientProcessRunOptions): Promise<void>;
+  processRun(runId: RunId, options?: ClientProcessRunOptions): Promise<void>;
   /** Processes currently due runs matching optional filters. */
-  wakeDueRuns(options?: WorkflowWakeDueRunsOptions): Promise<WorkflowWorkerRunResult>;
+  wakeDueRuns(options?: WakeDueRunsOptions): Promise<WorkerRunResult>;
 }
 /** Options for creating a worker from the grouped client worker API. */
-interface WorkflowClientWorkerOptions {
+export interface ClientWorkerOptions {
   readonly workerId?: WorkerId;
   readonly leaseDuration?: Temporal.Duration;
   readonly pollInterval?: Temporal.Duration;
   readonly heartbeatInterval?: Temporal.Duration;
   readonly stopDrainTimeout?: Temporal.Duration;
-  readonly missingImplementationRetry?: WorkflowMissingImplementationRetryConfig;
+  readonly missingImplementationRetry?: MissingImplementationRetryConfig;
 }
 /** Options for processing one run through a client worker facet. */
-interface WorkflowClientProcessRunOptions extends WorkflowWorkerRunFilterOptions {
+export interface ClientProcessRunOptions extends WorkerRunFilterOptions {
   readonly workerId?: string;
   readonly leaseDuration?: Temporal.Duration;
   readonly heartbeatInterval?: Temporal.Duration;
-  readonly missingImplementationRetry?: WorkflowMissingImplementationRetryConfig;
+  readonly missingImplementationRetry?: MissingImplementationRetryConfig;
   readonly signal?: AbortSignal;
 }
-//#endregion
-export { CompiledWorkflowFunction, WorkflowClient, WorkflowClientAdminApi, WorkflowClientHooksApi, WorkflowClientLocksApi, WorkflowClientMessagesApi, WorkflowClientProcessRunOptions, WorkflowClientRunsApi, WorkflowClientSchedulesApi, WorkflowClientStreamsApi, WorkflowClientWorkerOptions, WorkflowClientWorkersApi, WorkflowRunHandle, WorkflowRunnable };
+//#endregion

package/dist/types/{vite.d.mts → compiler.d.mts}

@@ -1,21 +1,18 @@
-//#region src/types/vite.d.ts
-/** Kind values for workflow directive. */
-type DirectiveKind = "workflow" | "step";
-/** Describes the workflow transform metadata entry contract. */
-interface TransformMetadataEntry {
+import { SourceMapCompact } from "unplugin";
+//#region src/types/compiler.d.ts
+export type DirectiveKind = "workflow" | "step";
+export interface TransformMetadataEntry {
   readonly kind: DirectiveKind;
   readonly name: string;
   readonly generatedName: string;
   readonly workflowName: string;
   readonly version?: string;
 }
-/** Describes the workflow transform metadata contract. */
-interface TransformMetadata {
+export interface TransformMetadata {
   readonly file: string;
   readonly entries: readonly TransformMetadataEntry[];
 }
-/** Describes the workflow transform manifest function contract. */
-interface TransformManifestFunction {
+export interface TransformManifestFunction {
   readonly kind: DirectiveKind;
   readonly exportName: string;
   readonly localName: string;
@@ -23,8 +20,7 @@ interface TransformManifestFunction {
   readonly workflowName: string;
   readonly version?: string;
 }
-/** Describes the workflow transform manifest import edge contract. */
-interface TransformManifestImportEdge {
+export interface TransformManifestImportEdge {
   readonly source: string;
   readonly importName: string;
   readonly localName: string;
@@ -32,14 +28,12 @@ interface TransformManifestImportEdge {
   readonly workflowName: string;
   readonly version?: string;
 }
-/** Describes the workflow transform manifest contract. */
-interface TransformManifest {
+export interface TransformManifest {
   readonly file: string;
   readonly functions: readonly TransformManifestFunction[];
   readonly imports: readonly TransformManifestImportEdge[];
 }
-/** Options for workflow transform. */
-interface TransformOptions {
+export interface TransformOptions {
   readonly root?: string;
   readonly name?: (localName: string, file: string, kind: DirectiveKind) => string;
   readonly version?: string | ((workflowName: string, file: string) => string | undefined);
@@ -47,19 +41,18 @@ interface TransformOptions {
   readonly sourcemap?: boolean;
   readonly runtimeImport?: string;
 }
-/** Result returned by workflow transform. */
-interface TransformResult {
+/** Source map emitted by the workflow compiler, including the original source text. */
+export interface SourceMap extends SourceMapCompact {
+  sourcesContent: string[];
+}
+export interface TransformResult {
   readonly code: string;
-  readonly map?: unknown;
+  readonly map?: SourceMap;
   readonly metadata: TransformMetadata;
   readonly manifest: TransformManifest;
 }
-/** Options for workflow build-tool plugins. */
-interface WorkflowPluginOptions extends TransformOptions {
+export interface PluginOptions extends TransformOptions {
   readonly include?: readonly string[];
   readonly exclude?: readonly string[];
 }
-/** Options for workflow Vite plugin. */
-type VitePluginOptions = WorkflowPluginOptions;
-//#endregion
-export { DirectiveKind, TransformManifest, TransformManifestFunction, TransformManifestImportEdge, TransformMetadata, TransformMetadataEntry, TransformOptions, TransformResult, VitePluginOptions, WorkflowPluginOptions };
+//#endregion

package/dist/types/compiler.mjs

@@ -0,0 +1 @@
+export {};

package/dist/types/definition.d.mts

@@ -1,92 +1,80 @@
-import { WorkflowRetryConfig } from "./retry.mjs";
-import { WorkflowDeterministicApi, WorkflowStepApi } from "./step.mjs";
+import { RetryConfig } from "./retry.mjs";
+import { StepApi } from "./step.mjs";
 import { Schema, SchemaOutput } from "@temelj/standard-schema";
-import { Logger } from "@temelj/log";
 //#region src/types/definition.d.ts
 /** Configuration used to name, version, validate, and retry a workflow definition. */
-interface WorkflowDefinitionConfig<TSchema extends Schema | undefined = undefined> {
+export interface DefinitionConfig<TSchema extends Schema | undefined = undefined> {
   readonly name: string;
   readonly version?: string;
   readonly schema?: TSchema;
-  readonly retry?: WorkflowRetryConfig;
+  readonly retry?: RetryConfig;
 }
 /** Infers the parsed workflow input type from a schema, falling back when no schema is present. */
-type WorkflowInputFromSchema<TSchema extends Schema | undefined, TFallback> = TSchema extends Schema ? SchemaOutput<TSchema> : TFallback;
+export type InputFromSchema<TSchema extends Schema | undefined, TFallback> = TSchema extends Schema ? SchemaOutput<TSchema> : TFallback;
 /** Infers the raw workflow input accepted before schema parsing, falling back when no schema is present. */
-type WorkflowRawInputFromSchema<TSchema extends Schema | undefined, TFallback> = TSchema extends Schema<infer TInput, unknown> ? TInput : TFallback;
+export type RawInputFromSchema<TSchema extends Schema | undefined, TFallback> = TSchema extends Schema<infer TInput, unknown> ? TInput : TFallback;
 /** Durable workflow contract identified by name, optional version, and typed input/output markers. */
-interface WorkflowDefinition<TInput = unknown, TOutput = unknown, TRawInput = TInput> {
+export interface WorkflowDefinition<TInput = unknown, TOutput = unknown, TRawInput = TInput> {
   readonly kind: "definition";
-  readonly config: WorkflowDefinitionConfig<Schema | undefined>;
+  readonly config: DefinitionConfig<Schema | undefined>;
   readonly name: string;
   readonly version?: string;
-  readonly types?: WorkflowDefinitionTypes<TInput, TOutput, TRawInput>;
+  readonly types?: DefinitionTypes<TInput, TOutput, TRawInput>;
 }
 /** Compile-time type markers carried by workflow definitions without affecting runtime behavior. */
-interface WorkflowDefinitionTypes<TInput, TOutput, TRawInput> {
+export interface DefinitionTypes<TInput, TOutput, TRawInput> {
   /** Parsed input type received by the workflow handler. */
   readonly input: TInput;
-  /** Output type returned by the workflow handler. */
   readonly output: TOutput;
   /** Raw input type accepted before schema validation. */
   readonly rawInput: TRawInput;
 }
 /** Executable workflow implementation that binds a durable definition to a handler. */
-interface WorkflowImplementation<TInput = unknown, TOutput = unknown, TRawInput = TInput> {
+export interface WorkflowImplementation<TInput = unknown, TOutput = unknown, TRawInput = TInput> {
   readonly kind: "implementation";
   readonly definition: WorkflowDefinition<TInput, TOutput, TRawInput>;
-  readonly config: WorkflowDefinitionConfig<Schema | undefined>;
+  readonly config: DefinitionConfig<Schema | undefined>;
   readonly name: string;
   readonly version?: string;
   readonly handler: WorkflowHandler<TInput, TOutput>;
 }
 /** Function that runs workflow logic with a replay-safe workflow context. */
-type WorkflowHandler<TInput, TOutput> = (context: WorkflowContext<TInput>) => Promise<TOutput> | TOutput;
+export type WorkflowHandler<TInput, TOutput> = (context: WorkflowContext<TInput>) => Promise<TOutput> | TOutput;
 /** Context passed to a workflow handler during execution and replay. */
-interface WorkflowContext<TInput> {
+export interface WorkflowContext<TInput> {
   /** Parsed workflow input for the current run. */
   readonly input: TInput;
   /** Durable command API for workflow code. */
-  readonly step: WorkflowStepApi;
-  /** Replay-safe time, random, ID, and byte sources for workflow orchestration code. */
-  readonly deterministic: WorkflowDeterministicApi;
-  /** Scoped operational logger for workflow orchestration code. */
-  readonly log: Logger;
+  readonly step: StepApi;
   /** Stable identity and creation metadata for the current run. */
-  readonly run: WorkflowRunContext;
-  /** Abort signal for workflow cancellation. */
+  readonly run: RunContext;
   readonly signal: AbortSignal;
-  /** Workflow version stored on the current run, if any. */
-  readonly version: string | undefined;
 }
 /** Stable identity and creation metadata for the currently executing run. */
-interface WorkflowRunContext {
+export interface RunContext {
   readonly id: string;
   readonly workflowName: string;
   readonly workflowVersion?: string;
   readonly createdAt: Temporal.Instant;
 }
 /** Workflow target accepted by start and schedule APIs. */
-type WorkflowStartTarget<TInput = unknown, TOutput = unknown, TRawInput = TInput> = WorkflowDefinition<TInput, TOutput, TRawInput> | WorkflowImplementation<TInput, TOutput, TRawInput>;
+export type StartTarget<TInput = unknown, TOutput = unknown, TRawInput = TInput> = WorkflowDefinition<TInput, TOutput, TRawInput> | WorkflowImplementation<TInput, TOutput, TRawInput>;
 /** Registry surface required by clients, workers, and runtimes. */
-interface RegistryLike {
+export interface RegistryLike {
   /** Creates and registers a workflow implementation. */
   implementWorkflow<TInput, TOutput, TRawInput = TInput>(definition: WorkflowDefinition<TInput, TOutput, TRawInput>, handler: WorkflowHandler<TInput, TOutput>): WorkflowImplementation<TInput, TOutput, TRawInput>;
-  /** Registers an existing workflow implementation. */
   register<TInput, TOutput, TRawInput = TInput>(implementation: WorkflowImplementation<TInput, TOutput, TRawInput>): void;
-  /** Returns the implementation registered for a definition, if present. */
+  /** Returns the implementation registered for this exact definition object, if present. */
   get<TInput, TOutput, TRawInput = TInput>(definition: WorkflowDefinition<TInput, TOutput, TRawInput>): WorkflowImplementation<TInput, TOutput, TRawInput> | undefined;
   /** Returns the implementation registered for a workflow name and optional version. */
   getByName(name: string, version?: string): WorkflowImplementation<unknown, unknown> | undefined;
   /** Returns the latest registered implementation for a workflow name. */
   latest(name: string): WorkflowImplementation<unknown, unknown> | undefined;
 }
-/** In-memory workflow registry contract. */
-interface Registry extends RegistryLike {
+export interface Registry extends RegistryLike {
   /** Returns all registered workflow implementations. */
   entries(): readonly WorkflowImplementation<unknown, unknown>[];
   /** Returns the latest registered implementation for a workflow name. */
   latest(name: string): WorkflowImplementation<unknown, unknown> | undefined;
 }
-//#endregion
-export { Registry, RegistryLike, WorkflowContext, WorkflowDefinition, WorkflowDefinitionConfig, WorkflowDefinitionTypes, WorkflowHandler, WorkflowImplementation, WorkflowInputFromSchema, WorkflowRawInputFromSchema, WorkflowRunContext, WorkflowStartTarget };
+//#endregion