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

package/dist/types/stream.d.mts

@@ -1,12 +1,9 @@
-import { RunId } from "./run-id.mjs";
-import { PageOptions, WorkflowPage } from "./pagination.mjs";
-import { StreamId } from "./stream-id.mjs";
-import "./run.mjs";
+import { RunId, StreamId } from "./ids.mjs";
 import { WorkflowErrorRecord } from "./error.mjs";
 import { StorageValue } from "@temelj/storage";
 //#region src/types/stream.d.ts
 /** Writable durable stream created by workflow code and persisted in run history. */
-interface Stream<TChunk = unknown> {
+export interface Stream<TChunk = unknown> {
   /** Stable stream ID recorded in workflow history. */
   readonly id: StreamId;
   /** User-facing stream name used to look up the stream. */
@@ -14,51 +11,49 @@ interface Stream<TChunk = unknown> {
   /** Optional MIME type or content type associated with stream chunks. */
   readonly contentType?: string;
   /** Optional persisted stream metadata. */
-  readonly metadata?: unknown;
+  readonly metadata?: StorageValue;
   /** Appends one chunk to the stream. */
   write(chunk: TChunk): Promise<void>;
   /** Closes the stream successfully. */
   close(): Promise<void>;
   /** Fails the stream with an error that readers can observe. */
-  error(error: unknown): Promise<void>;
+  error(cause: unknown): Promise<void>;
 }
 /** Options for creating a durable stream from workflow code. */
-interface CreateStreamOptions {
+export interface CreateStreamOptions {
   readonly id?: StreamId;
   readonly contentType?: string;
-  readonly metadata?: unknown;
+  readonly metadata?: StorageValue;
   readonly maximumChunks?: number;
 }
 /** Options for reading durable stream chunks by index or from the tail. */
-interface ReadStreamOptions {
+export interface ReadStreamOptions {
   readonly fromIndex?: number;
   readonly fromTail?: number;
   readonly maxChunks?: number;
 }
-/** Paginated stream read options combining stream offsets with cursor paging. */
-type ReadStreamPageOptions = ReadStreamOptions & PageOptions;
 /** Options for following stream updates until cancellation or a terminal stream event. */
-interface FollowStreamOptions extends ReadStreamOptions {
+export interface FollowStreamOptions extends ReadStreamOptions {
   readonly pollInterval?: Temporal.Duration;
   readonly signal?: AbortSignal;
   readonly includeTerminal?: boolean;
   readonly pageSize?: number;
 }
 /** Options for polling stream availability or terminal state. */
-interface WaitStreamOptions {
+export interface WaitStreamOptions {
   readonly pollInterval?: Temporal.Duration;
   readonly signal?: AbortSignal;
 }
 /** Terminal-aware status of a durable workflow stream. */
-type StreamStatus = "open" | "closed" | "failed";
+export type StreamStatus = "open" | "closed" | "failed";
 /** Single ordered value written to a durable workflow stream. */
-interface StreamChunk<TChunk = unknown> {
+export interface StreamChunk<TChunk = StorageValue | undefined> {
   readonly index: number;
   readonly timestamp: Temporal.Instant;
   readonly value: TChunk;
 }
 /** Current durable stream state including chunk history and optional terminal error. */
-interface StreamState<TChunk = unknown> {
+export interface StreamState<TChunk = StorageValue | undefined> {
   readonly runId: RunId;
   readonly id: StreamId;
   readonly name: string;
@@ -73,21 +68,7 @@ interface StreamState<TChunk = unknown> {
   readonly error?: WorkflowErrorRecord;
 }
 /** Durable stream metadata without chunk contents. */
-interface StreamInfo {
-  readonly runId: RunId;
-  readonly id: StreamId;
-  readonly name: string;
-  readonly status: StreamStatus;
-  readonly createdAt: Temporal.Instant;
-  readonly updatedAt: Temporal.Instant;
-  readonly contentType?: string;
-  readonly metadata?: StorageValue;
-  readonly chunkCount: number;
-  readonly lastIndex?: number;
-  readonly error?: WorkflowErrorRecord;
-}
-/** Paginated durable stream state where chunks are returned as a page. */
-interface StreamPage<TChunk = unknown> {
+export interface StreamInfo {
   readonly runId: RunId;
   readonly id: StreamId;
   readonly name: string;
@@ -99,28 +80,26 @@ interface StreamPage<TChunk = unknown> {
   readonly chunkCount: number;
   readonly lastIndex?: number;
   readonly error?: WorkflowErrorRecord;
-  readonly chunks: WorkflowPage<StreamChunk<TChunk>>;
 }
 /** Incremental update emitted when a durable stream chunk is written. */
-type StreamUpdateKind = "chunk" | "closed" | "failed";
+export type StreamUpdateKind = "chunk" | "closed" | "failed";
 /** Base contract for incremental durable stream updates. */
-interface StreamUpdateBase {
+export interface StreamUpdateBase {
   readonly kind: StreamUpdateKind;
   readonly runId: RunId;
   readonly streamId: StreamId;
   readonly streamName: string;
 }
 /** Incremental update emitted when a durable stream chunk is written. */
-type StreamChunkUpdate<TChunk = unknown> = StreamUpdateBase & {
+export type StreamChunkUpdate<TChunk = StorageValue | undefined> = StreamUpdateBase & {
   readonly kind: "chunk";
   readonly chunk: StreamChunk<TChunk>;
 };
 /** Incremental update emitted when a durable stream closes or fails. */
-type StreamTerminalUpdate = StreamUpdateBase & {
+export type StreamTerminalUpdate = StreamUpdateBase & {
   readonly kind: "closed" | "failed";
   readonly info: StreamInfo;
 };
 /** Incremental durable stream update yielded while following a stream. */
-type StreamUpdate<TChunk = unknown> = StreamChunkUpdate<TChunk> | StreamTerminalUpdate;
-//#endregion
-export { CreateStreamOptions, FollowStreamOptions, ReadStreamOptions, ReadStreamPageOptions, Stream, StreamChunk, StreamChunkUpdate, StreamInfo, StreamPage, StreamState, StreamStatus, StreamTerminalUpdate, StreamUpdate, StreamUpdateBase, StreamUpdateKind, WaitStreamOptions };
+export type StreamUpdate<TChunk = StorageValue | undefined> = StreamChunkUpdate<TChunk> | StreamTerminalUpdate;
+//#endregion

package/dist/types/summary.d.mts

@@ -1,318 +1,214 @@
-import { RunId } from "./run-id.mjs";
-import { StepId } from "./step-id.mjs";
+import { RunId, StepId } from "./ids.mjs";
 import { ScheduleId } from "./schedule.mjs";
-import { WorkflowListRunsOptions } from "./run-list.mjs";
-import { WorkflowRunRetryReason, WorkflowRunStatus, WorkflowRunTransitionReason, WorkflowTerminalRunStatus } from "./run.mjs";
+import { RunRetryReason, RunStatus, RunTransitionReason, TerminalRunStatus } from "./run.mjs";
 //#region src/types/summary.d.ts
-type WorkflowSummaryIdArray = readonly string[];
-/** Options for workflow run summary. */
-type WorkflowRunSummaryOptions = WorkflowListRunsOptions;
-/** Options for workflow recovery summary. */
-type WorkflowRecoverySummaryOptions = WorkflowListRunsOptions;
-/** Counts grouped by run status. */
-type WorkflowRunStatusCounts = Readonly<Record<WorkflowRunStatus, number>>;
-/** Run IDs grouped by run status. */
-type WorkflowRunStatusRunIds = Readonly<Record<WorkflowRunStatus, WorkflowSummaryIdArray>>;
-/** Counts grouped by run transition reason. */
-type WorkflowRunTransitionReasonCounts = Readonly<Record<WorkflowRunTransitionReason, number>>;
-/** Run IDs grouped by run transition reason. */
-type WorkflowRunTransitionReasonRunIds = Readonly<Record<WorkflowRunTransitionReason, WorkflowSummaryIdArray>>;
-/** Counts grouped by run retry reason. */
-type WorkflowRunRetryReasonCounts = Readonly<Record<WorkflowRunRetryReason, number>>;
-/** Counts grouped by terminal run status. */
-type WorkflowTerminalRunStatusCounts = Readonly<Record<WorkflowTerminalRunStatus, number>>;
-/** Run IDs grouped by terminal run status. */
-type WorkflowTerminalRunStatusRunIds = Readonly<Record<WorkflowTerminalRunStatus, WorkflowSummaryIdArray>>;
-/** Summary data for workflow recovery due. */
-interface WorkflowRecoveryDueSummary {
-  readonly total: number;
-  readonly runIds: WorkflowSummaryIdArray;
-  readonly pendingRunIds: WorkflowSummaryIdArray;
-  readonly waitingRunIds: WorkflowSummaryIdArray;
-  readonly invalidScheduleRunIds: WorkflowSummaryIdArray;
-  readonly nextAvailableAt?: Temporal.Instant;
-  readonly nextAvailableRunId?: RunId;
-}
-/** Summary data for workflow recovery lease. */
-interface WorkflowRecoveryLeaseSummary {
-  readonly total: number;
-  readonly stale: number;
-  readonly runIds: WorkflowSummaryIdArray;
-  readonly staleRunIds: WorkflowSummaryIdArray;
-  readonly ownerlessRunIds: WorkflowSummaryIdArray;
-  readonly missingExpiresAtRunIds: WorkflowSummaryIdArray;
-  readonly invalidExpiresAtRunIds: WorkflowSummaryIdArray;
-  readonly expiredRunIds: WorkflowSummaryIdArray;
-  readonly workerIds: WorkflowSummaryIdArray;
-  readonly nextExpiresAt?: Temporal.Instant;
-  readonly nextExpiringRunId?: RunId;
+type SummaryIdArray = readonly string[];
+export type RunStatusCounts = Readonly<Record<RunStatus, number>>;
+export type RunTransitionReasonCounts = Readonly<Record<RunTransitionReason, number>>;
+export type RunRetryReasonCounts = Readonly<Record<RunRetryReason, number>>;
+export type TerminalRunStatusCounts = Readonly<Record<TerminalRunStatus, number>>;
+/** The run whose deadline, wake-up, or expiry comes first. */
+export interface NextRun {
+  readonly at: Temporal.Instant;
+  readonly runId: RunId;
+}
+/** The step attempt whose wake-up or timeout comes first. */
+export interface NextStep extends NextRun {
+  readonly stepId: StepId;
+  readonly attemptKey?: string;
+}
+export interface NextSleep extends NextStep {
+  readonly duration?: Temporal.Duration;
+}
+export interface NextSchedule {
+  readonly at: Temporal.Instant;
+  readonly scheduleId: ScheduleId;
+}
+export interface NextLock {
+  readonly at: Temporal.Instant;
+  readonly key: string;
+}
+export interface RecoveryDueSummary {
+  readonly runIds: SummaryIdArray;
+  readonly pendingRunIds: SummaryIdArray;
+  readonly waitingRunIds: SummaryIdArray;
+  readonly next?: NextRun;
+}
+export interface RecoveryLeaseSummary {
+  readonly runIds: SummaryIdArray;
+  readonly staleRunIds: SummaryIdArray;
+  readonly ownerlessRunIds: SummaryIdArray;
+  readonly missingExpiresAtRunIds: SummaryIdArray;
+  readonly expiredRunIds: SummaryIdArray;
+  readonly workerIds: SummaryIdArray;
+  readonly next?: NextRun;
   readonly oldestStaleAt?: Temporal.Instant;
 }
-/** Summary data for workflow recovery retry. */
-interface WorkflowRecoveryRetrySummary {
-  readonly total: number;
-  readonly due: number;
-  readonly runIds: WorkflowSummaryIdArray;
-  readonly dueRunIds: WorkflowSummaryIdArray;
-  readonly nextRetryAt?: Temporal.Instant;
-  readonly nextRetryRunId?: RunId;
+export interface RecoveryRetrySummary {
+  readonly runIds: SummaryIdArray;
+  readonly dueRunIds: SummaryIdArray;
+  readonly next?: NextRun;
 }
-/** Summary data for workflow recovery missing implementation. */
-type WorkflowRecoveryMissingImplementationSummary = WorkflowRecoveryRetrySummary;
-/** Summary data for workflow recovery failed. */
-interface WorkflowRecoveryFailedSummary {
-  readonly total: number;
-  readonly runIds: WorkflowSummaryIdArray;
+export interface RecoveryFailedSummary {
+  readonly runIds: SummaryIdArray;
   readonly latestFailedAt?: Temporal.Instant;
 }
-/** Summary data for workflow recovery schedule. */
-interface WorkflowRecoveryScheduleSummary {
-  readonly total: number;
-  readonly due: number;
-  readonly scheduleIds: WorkflowSummaryIdArray;
-  readonly dueScheduleIds: WorkflowSummaryIdArray;
-  readonly invalidNextFireScheduleIds: WorkflowSummaryIdArray;
-  readonly nextFireAt?: Temporal.Instant;
-  readonly nextFireScheduleId?: ScheduleId;
-}
-/** Summary data for workflow recovery lock. */
-interface WorkflowRecoveryLockSummary {
-  readonly total: number;
-  readonly stale: number;
-  readonly keys: WorkflowSummaryIdArray;
-  readonly staleKeys: WorkflowSummaryIdArray;
-  readonly holderIds: WorkflowSummaryIdArray;
-  readonly waitingRunIds: WorkflowSummaryIdArray;
-  readonly dueWaitingRunIds: WorkflowSummaryIdArray;
-  readonly waitingStepIds: WorkflowSummaryIdArray;
-  readonly waitingKeys: WorkflowSummaryIdArray;
-  readonly nextExpiresAt?: Temporal.Instant;
-  readonly nextExpiringKey?: string;
+export interface RecoveryScheduleSummary {
+  readonly scheduleIds: SummaryIdArray;
+  readonly dueScheduleIds: SummaryIdArray;
+  readonly next?: NextSchedule;
+}
+export interface RecoveryLockSummary {
+  readonly keys: SummaryIdArray;
+  readonly staleKeys: SummaryIdArray;
+  readonly holderIds: SummaryIdArray;
+  readonly waitingRunIds: SummaryIdArray;
+  readonly dueWaitingRunIds: SummaryIdArray;
+  readonly waitingStepIds: SummaryIdArray;
+  readonly waitingKeys: SummaryIdArray;
   readonly oldestStaleAt?: Temporal.Instant;
-  readonly nextWaitDeadlineAt?: Temporal.Instant;
-  readonly nextWaitDeadlineRunId?: RunId;
-}
-/** Summary data for workflow recovery sleep wait. */
-interface WorkflowRecoverySleepWaitSummary {
-  readonly active: number;
-  readonly due: number;
-  readonly runIds: WorkflowSummaryIdArray;
-  readonly dueRunIds: WorkflowSummaryIdArray;
-  readonly dueStepIds: WorkflowSummaryIdArray;
-  readonly invalidUntilRunIds: WorkflowSummaryIdArray;
-  readonly nextWakeAt?: Temporal.Instant;
-  readonly nextWakeRunId?: RunId;
-}
-/** Summary data for workflow recovery message wait. */
-interface WorkflowRecoveryMessageWaitSummary {
-  readonly active: number;
-  readonly ready: number;
-  readonly timedOut: number;
-  readonly runIds: WorkflowSummaryIdArray;
-  readonly readyRunIds: WorkflowSummaryIdArray;
-  readonly timedOutRunIds: WorkflowSummaryIdArray;
-  readonly readyStepIds: WorkflowSummaryIdArray;
-  readonly timedOutStepIds: WorkflowSummaryIdArray;
-  readonly messages: WorkflowSummaryIdArray;
-  readonly nextTimeoutAt?: Temporal.Instant;
-  readonly nextTimeoutRunId?: RunId;
-}
-/** Summary data for workflow recovery child workflow wait. */
-interface WorkflowRecoveryChildWorkflowWaitSummary {
-  readonly active: number;
-  readonly terminal: number;
-  readonly missing: number;
-  readonly timedOut: number;
-  readonly runIds: WorkflowSummaryIdArray;
-  readonly terminalRunIds: WorkflowSummaryIdArray;
-  readonly missingRunIds: WorkflowSummaryIdArray;
-  readonly timedOutRunIds: WorkflowSummaryIdArray;
-  readonly terminalStepIds: WorkflowSummaryIdArray;
-  readonly missingStepIds: WorkflowSummaryIdArray;
-  readonly timedOutStepIds: WorkflowSummaryIdArray;
-  readonly childRunIds: WorkflowSummaryIdArray;
-  readonly completedChildRunIds: WorkflowSummaryIdArray;
-  readonly failedChildRunIds: WorkflowSummaryIdArray;
-  readonly canceledChildRunIds: WorkflowSummaryIdArray;
-  readonly nextTimeoutAt?: Temporal.Instant;
-  readonly nextTimeoutRunId?: RunId;
-}
-/** Summary data for workflow recovery wait. */
-interface WorkflowRecoveryWaitSummary {
-  readonly sleep: WorkflowRecoverySleepWaitSummary;
-  readonly message: WorkflowRecoveryMessageWaitSummary;
-  readonly childWorkflow: WorkflowRecoveryChildWorkflowWaitSummary;
-}
-/** Summary data for workflow recovery. */
-interface WorkflowRecoverySummary {
+  readonly nextExpiry?: NextLock;
+  readonly nextWaitDeadline?: NextRun;
+}
+export interface RecoverySleepWaitSummary {
+  readonly runIds: SummaryIdArray;
+  readonly dueRunIds: SummaryIdArray;
+  readonly dueStepIds: SummaryIdArray;
+  readonly invalidUntilRunIds: SummaryIdArray;
+  readonly next?: NextRun;
+}
+export interface RecoveryMessageWaitSummary {
+  readonly runIds: SummaryIdArray;
+  readonly readyRunIds: SummaryIdArray;
+  readonly timedOutRunIds: SummaryIdArray;
+  readonly readyStepIds: SummaryIdArray;
+  readonly timedOutStepIds: SummaryIdArray;
+  readonly messages: SummaryIdArray;
+  readonly next?: NextRun;
+}
+export interface RecoveryChildWorkflowWaitSummary {
+  readonly runIds: SummaryIdArray;
+  readonly terminalRunIds: SummaryIdArray;
+  readonly missingRunIds: SummaryIdArray;
+  readonly timedOutRunIds: SummaryIdArray;
+  readonly terminalStepIds: SummaryIdArray;
+  readonly missingStepIds: SummaryIdArray;
+  readonly timedOutStepIds: SummaryIdArray;
+  readonly childRunIds: SummaryIdArray;
+  readonly completedChildRunIds: SummaryIdArray;
+  readonly failedChildRunIds: SummaryIdArray;
+  readonly canceledChildRunIds: SummaryIdArray;
+  readonly next?: NextRun;
+}
+export interface RecoveryWaitSummary {
+  readonly sleep: RecoverySleepWaitSummary;
+  readonly message: RecoveryMessageWaitSummary;
+  readonly childWorkflow: RecoveryChildWorkflowWaitSummary;
+}
+export interface RecoverySummary {
   readonly total: number;
-  readonly recoverableRunIds: WorkflowSummaryIdArray;
-  readonly due: WorkflowRecoveryDueSummary;
-  readonly lease: WorkflowRecoveryLeaseSummary;
-  readonly retry: WorkflowRecoveryRetrySummary;
-  readonly missingImplementation: WorkflowRecoveryMissingImplementationSummary;
-  readonly failed: WorkflowRecoveryFailedSummary;
-  readonly schedule: WorkflowRecoveryScheduleSummary;
-  readonly lock: WorkflowRecoveryLockSummary;
-  readonly wait: WorkflowRecoveryWaitSummary;
+  readonly recoverableRunIds: SummaryIdArray;
+  readonly due: RecoveryDueSummary;
+  readonly lease: RecoveryLeaseSummary;
+  readonly retry: RecoveryRetrySummary;
+  readonly missingImplementation: RecoveryRetrySummary;
+  readonly failed: RecoveryFailedSummary;
+  readonly schedule: RecoveryScheduleSummary;
+  readonly lock: RecoveryLockSummary;
+  readonly wait: RecoveryWaitSummary;
   readonly nextRecoveryAt?: Temporal.Instant;
 }
-/** Describes the workflow run workflow count contract. */
-interface WorkflowRunWorkflowCount {
+/** Run count for one workflow name and version. */
+export interface RunWorkflowCount {
   readonly name: string;
   readonly version?: string;
   readonly count: number;
-  readonly runIds: WorkflowSummaryIdArray;
-}
-/** Summary data for workflow run workflow. */
-interface WorkflowRunWorkflowSummary {
-  readonly total: number;
-  readonly workflows: readonly WorkflowRunWorkflowCount[];
 }
-/** Summary data for workflow run transition. */
-interface WorkflowRunTransitionSummary {
+export interface RunTransitionSummary {
+  readonly reason: RunTransitionReasonCounts;
   readonly latestTransitionAt?: Temporal.Instant;
-  readonly reason: WorkflowRunTransitionReasonCounts;
-  readonly runIds: WorkflowRunTransitionReasonRunIds;
 }
-/** Summary data for workflow run retry. */
-interface WorkflowRunRetrySummary {
-  readonly total: number;
-  readonly retryRunIds: WorkflowSummaryIdArray;
-  readonly retryStepIds: WorkflowSummaryIdArray;
-  readonly retryStepNames: WorkflowSummaryIdArray;
-  readonly nextRetryAt?: Temporal.Instant;
-  readonly nextRetryRunId?: RunId;
+export interface RunRetrySummary {
+  readonly count: number;
+  readonly stepNames: SummaryIdArray;
+  readonly reason: RunRetryReasonCounts;
   readonly highestAttempt?: number;
-  readonly reason: WorkflowRunRetryReasonCounts;
+  readonly next?: NextRun;
 }
-/** Summary data for workflow run failure error. */
-interface WorkflowRunFailureErrorSummary {
+export interface RunFailureErrorSummary {
   readonly name: string;
   readonly count: number;
-  readonly failedRunIds: WorkflowSummaryIdArray;
   readonly latestFailedAt?: Temporal.Instant;
 }
-/** Summary data for workflow run failure. */
-interface WorkflowRunFailureSummary {
-  readonly total: number;
-  readonly failedRunIds: WorkflowSummaryIdArray;
-  readonly errors: readonly WorkflowRunFailureErrorSummary[];
+export interface RunFailureSummary {
+  readonly count: number;
+  readonly errors: readonly RunFailureErrorSummary[];
   readonly latestFailedAt?: Temporal.Instant;
 }
-/** Summary data for workflow run lease. */
-interface WorkflowRunLeaseSummary {
-  readonly total: number;
+export interface RunLeaseSummary {
+  readonly count: number;
   readonly expired: number;
-  readonly runIds: WorkflowSummaryIdArray;
-  readonly expiredRunIds: WorkflowSummaryIdArray;
-  readonly workerIds: WorkflowSummaryIdArray;
-  readonly nextExpiresAt?: Temporal.Instant;
-  readonly nextExpiringRunId?: RunId;
+  readonly workerIds: SummaryIdArray;
   readonly oldestExpiredAt?: Temporal.Instant;
+  readonly next?: NextRun;
 }
-/** Summary data for workflow run cleanup. */
-interface WorkflowRunCleanupSummary {
-  readonly eligibleRuns: number;
-  readonly status: WorkflowTerminalRunStatusCounts;
-  readonly statusRunIds: WorkflowTerminalRunStatusRunIds;
+export interface RunCleanupSummary {
+  readonly status: TerminalRunStatusCounts;
   readonly oldestFinishedAt?: Temporal.Instant;
   readonly newestFinishedAt?: Temporal.Instant;
 }
-/** Summary data for workflow run stream. */
-interface WorkflowRunStreamSummary {
-  readonly activeStreams: number;
-  readonly activeStreamRuns: number;
-  readonly streamRunIds: WorkflowSummaryIdArray;
-  readonly streamStepIds: WorkflowSummaryIdArray;
-  readonly streamIds: WorkflowSummaryIdArray;
-  readonly streamNames: WorkflowSummaryIdArray;
-  readonly chunkCount: number;
-  readonly oldestStartedAt?: Temporal.Instant;
-}
-/** Summary data for workflow run hook. */
-interface WorkflowRunHookSummary {
-  readonly activeHooks: number;
-  readonly activeWebhooks: number;
-  readonly activeHookRuns: number;
-  readonly hookRunIds: WorkflowSummaryIdArray;
-  readonly hookStepIds: WorkflowSummaryIdArray;
-  readonly hookNames: WorkflowSummaryIdArray;
-  readonly webhookNames: WorkflowSummaryIdArray;
-  readonly messages: WorkflowSummaryIdArray;
-  readonly oldestStartedAt?: Temporal.Instant;
-  readonly nextTimeoutAt?: Temporal.Instant;
-  readonly nextTimeoutRunId?: RunId;
-  readonly nextTimeoutStepId?: StepId;
-}
-/** Summary data for workflow run sleep. */
-interface WorkflowRunSleepSummary {
-  readonly activeSleeps: number;
-  readonly activeSleepRuns: number;
-  readonly sleepRunIds: WorkflowSummaryIdArray;
-  readonly sleepStepIds: WorkflowSummaryIdArray;
-  readonly sleepAttemptKeys: WorkflowSummaryIdArray;
+/** Active waits of one kind: how many, and since when. */
+export interface RunWaitSummary {
+  readonly count: number;
   readonly oldestStartedAt?: Temporal.Instant;
-  readonly nextWakeAt?: Temporal.Instant;
-  readonly nextWakingRunId?: RunId;
-  readonly nextWakingStepId?: StepId;
-  readonly nextWakingAttemptKey?: string;
-  readonly nextWakingDuration?: Temporal.Duration;
-}
-/** Summary data for workflow run messageId. */
-interface WorkflowRunMessageSummary {
-  readonly activeWaits: number;
-  readonly activeWaitRuns: number;
-  readonly waitRunIds: WorkflowSummaryIdArray;
-  readonly waitStepIds: WorkflowSummaryIdArray;
-  readonly waitAttemptKeys: WorkflowSummaryIdArray;
-  readonly messages: WorkflowSummaryIdArray;
-  readonly oldestWaitStartedAt?: Temporal.Instant;
-  readonly nextWaitTimeoutAt?: Temporal.Instant;
-  readonly nextWaitTimeoutRunId?: RunId;
-  readonly nextWaitTimeoutStepId?: StepId;
-  readonly nextWaitTimeoutAttemptKey?: string;
 }
-/** Summary data for workflow run child workflow. */
-interface WorkflowRunChildWorkflowSummary {
-  readonly activeWaits: number;
-  readonly activeWaitRuns: number;
-  readonly waitRunIds: WorkflowSummaryIdArray;
-  readonly waitStepIds: WorkflowSummaryIdArray;
-  readonly waitAttemptKeys: WorkflowSummaryIdArray;
-  readonly childRunIds: WorkflowSummaryIdArray;
-  readonly retryChildRunIds?: WorkflowSummaryIdArray;
-  readonly failedChildRunIds?: WorkflowSummaryIdArray;
-  readonly canceledChildRunIds?: WorkflowSummaryIdArray;
-  readonly workflows: WorkflowSummaryIdArray;
-  readonly childStatus: WorkflowRunStatusCounts;
-  readonly childRetry?: WorkflowRunRetrySummary;
-  readonly childFailure?: WorkflowRunFailureSummary;
-  readonly oldestWaitStartedAt?: Temporal.Instant;
-  readonly nextWaitTimeoutAt?: Temporal.Instant;
-  readonly nextWaitTimeoutRunId?: RunId;
-  readonly nextWaitTimeoutStepId?: StepId;
-  readonly nextWaitTimeoutAttemptKey?: string;
+export interface RunStreamSummary extends RunWaitSummary {
+  readonly names: SummaryIdArray;
+  readonly chunkCount: number;
 }
-/** Summary data for workflow run. */
-interface WorkflowRunSummary {
+export interface RunHookSummary extends RunWaitSummary {
+  readonly webhooks: number;
+  readonly hookNames: SummaryIdArray;
+  readonly webhookNames: SummaryIdArray;
+  readonly messages: SummaryIdArray;
+  readonly next?: NextStep;
+}
+export interface RunSleepSummary extends RunWaitSummary {
+  readonly next?: NextSleep;
+}
+export interface RunMessageSummary extends RunWaitSummary {
+  readonly messages: SummaryIdArray;
+  readonly next?: NextStep;
+}
+export interface RunChildWorkflowSummary extends RunWaitSummary {
+  readonly workflows: SummaryIdArray;
+  readonly childStatus: RunStatusCounts;
+  readonly childRetry?: RunRetrySummary;
+  readonly childFailure?: RunFailureSummary;
+  readonly next?: NextStep;
+}
+/**
+ * Counts and next due times across runs, sized by the number of distinct names rather than the
+ * number of runs. Use `runs.list` for the runs themselves, or `admin.recovery` for the runs that
+ * need action.
+ */
+export interface RunSummary {
   readonly total: number;
-  readonly status: WorkflowRunStatusCounts;
-  readonly statusRunIds: WorkflowRunStatusRunIds;
-  readonly workflow: WorkflowRunWorkflowSummary;
-  readonly transition: WorkflowRunTransitionSummary;
-  readonly retry: WorkflowRunRetrySummary;
-  readonly failure?: WorkflowRunFailureSummary;
-  readonly lease: WorkflowRunLeaseSummary;
-  readonly cleanup?: WorkflowRunCleanupSummary;
-  readonly stream?: WorkflowRunStreamSummary;
-  readonly hook?: WorkflowRunHookSummary;
-  readonly sleep?: WorkflowRunSleepSummary;
-  readonly childWorkflow?: WorkflowRunChildWorkflowSummary;
-  readonly messageId?: WorkflowRunMessageSummary;
+  readonly status: RunStatusCounts;
+  readonly workflows: readonly RunWorkflowCount[];
+  readonly transition: RunTransitionSummary;
+  readonly retry: RunRetrySummary;
+  readonly failure?: RunFailureSummary;
+  readonly lease: RunLeaseSummary;
+  readonly cleanup?: RunCleanupSummary;
+  readonly stream?: RunStreamSummary;
+  readonly hook?: RunHookSummary;
+  readonly sleep?: RunSleepSummary;
+  readonly childWorkflow?: RunChildWorkflowSummary;
+  readonly message?: RunMessageSummary;
   readonly nextAvailableAt?: Temporal.Instant;
   readonly oldestPendingAt?: Temporal.Instant;
   readonly oldestRunningAt?: Temporal.Instant;
 }
 //#endregion
-export { WorkflowRecoveryChildWorkflowWaitSummary, WorkflowRecoveryDueSummary, WorkflowRecoveryFailedSummary, WorkflowRecoveryLeaseSummary, WorkflowRecoveryLockSummary, WorkflowRecoveryMessageWaitSummary, WorkflowRecoveryMissingImplementationSummary, WorkflowRecoveryRetrySummary, WorkflowRecoveryScheduleSummary, WorkflowRecoverySleepWaitSummary, WorkflowRecoverySummary, WorkflowRecoverySummaryOptions, WorkflowRecoveryWaitSummary, WorkflowRunChildWorkflowSummary, WorkflowRunCleanupSummary, WorkflowRunFailureErrorSummary, WorkflowRunFailureSummary, WorkflowRunHookSummary, WorkflowRunLeaseSummary, WorkflowRunMessageSummary, WorkflowRunRetryReasonCounts, WorkflowRunRetrySummary, WorkflowRunSleepSummary, WorkflowRunStatusCounts, WorkflowRunStatusRunIds, WorkflowRunStreamSummary, WorkflowRunSummary, WorkflowRunSummaryOptions, WorkflowRunTransitionReasonCounts, WorkflowRunTransitionReasonRunIds, WorkflowRunTransitionSummary, WorkflowRunWorkflowCount, WorkflowRunWorkflowSummary, WorkflowTerminalRunStatusCounts, WorkflowTerminalRunStatusRunIds };
+export {};