@dudousxd/nestjs-durable-core 0.66.0 → 0.67.0

package/dist/index.d.cts

@@ -1032,6 +1032,16 @@ interface StateStore {
      */
     transaction?<T>(work: (tx: StoreTransaction) => Promise<T>): Promise<T>;
     listRuns(query: RunQuery): Promise<WorkflowRun[]>;
+    /**
+     * Count the runs matching `query`, grouped by `(status, origin)` — the totals behind a console's
+     * status and origin chips, in ONE aggregate instead of a full listing the caller counts in memory.
+     * This is what lets a run list be paginated at all: `listRuns` can return 100 rows while the chips
+     * still say how many of the 9,000 are failed.
+     *
+     * Cells with a zero count are simply absent. Optional: a store that omits it still works — callers
+     * fall back to counting a {@link listRuns} result, which is correct but unbounded.
+     */
+    runFacets?(query: RunFacetQuery): Promise<RunFacetRow[]>;
     listCheckpoints(runId: string): Promise<StepCheckpoint[]>;
     /**
      * The LATEST checkpoint for `runId` whose `name` equals `name` exactly (highest `seq` wins), or
@@ -1143,14 +1153,34 @@ interface RunQuery {
      * Restrict to runs whose workflow was declared by this package (exact match against
      * {@link WorkflowRun.origin}), ANDed with the other predicates.
      *
-     * A run with NO origin (unknown — see the field) matches no `origin` value at all, so a UI facet
+     * A run with NO origin (unknown — see the field) matches no `origin` VALUE at all, so a UI facet
      * built on this must keep an "all origins" option: filtering by any single package silently hides
-     * every unattributed run, which reads to an operator as "those runs do not exist".
+     * every unattributed run, which reads to an operator as "those runs do not exist". `null` selects
+     * exactly that absent bucket (`origin IS NULL`), so a paginated console can offer an "unknown"
+     * facet without having to hold every run in the browser to find them.
      */
-    origin?: string | undefined;
+    origin?: string | null | undefined;
     limit?: number | undefined;
     offset?: number | undefined;
 }
+/**
+ * The predicates a {@link RunFacetRow} count is taken over — a {@link RunQuery} minus the axes the
+ * facets THEMSELVES report (`status`/`origin`) and minus paging. Keeping them out of the type is
+ * what makes the counts answerable in one query: a console narrows by tag/tenant/attribute, and the
+ * one call back tells it how the matching runs split across every status and every origin at once.
+ */
+type RunFacetQuery = Omit<RunQuery, 'status' | 'statuses' | 'origin' | 'limit' | 'offset'>;
+/**
+ * One `(status, origin)` cell of {@link StateStore.runFacets} — a `GROUP BY` row, not a page of runs.
+ * A console pivots these into its status chips and its origin chips, so both stay exact while the
+ * list itself is paginated. `origin` is `null` for runs carrying none (see {@link WorkflowRun.origin});
+ * that bucket is a real, countable answer here rather than the absence a value-match cannot express.
+ */
+interface RunFacetRow {
+    status: RunStatus;
+    origin: string | null;
+    count: number;
+}
 /** The transaction handle `StateStore.transaction` hands to its work callback. */
 interface StoreTransaction {
     /** The store-native transaction handle (TypeORM `EntityManager`, Prisma tx client, MikroORM `EntityManager`,
@@ -1214,6 +1244,9 @@ type RunRequestKind = {
 } | {
     kind: 'listRuns';
     query: RunQuery;
+} | {
+    kind: 'runFacets';
+    query: RunFacetQuery;
 } | {
     kind: 'workerHealth';
 } | {
@@ -4344,6 +4377,25 @@ declare class RemoteWorkflowExecutor implements WorkflowExecutor {
     dispatch(run: WorkflowRun, history: HistoryEvent[], taskId: string, pendingSignals?: WorkflowTask['pendingSignals']): Promise<void>;
 }
 
+/**
+ * The origin a facet cell is filed under. An origin that is absent, null, or blank is all the same
+ * thing to an operator — a run no package claims — so they collapse to `null` here. Without this the
+ * "unknown" chip would count only one of those spellings while `origin IS NULL` paging returned
+ * another, and the chip's number would not match the page it opens.
+ */
+declare function facetOrigin(origin: string | null | undefined): string | null;
+/**
+ * Fold `(status, origin)` counts into one cell per pair, normalising origins via {@link facetOrigin}.
+ * Store adapters group in SQL and pipe their rows through this, so every adapter — and the in-memory
+ * store the tests run against — agrees on what lands in the unattributed bucket instead of each
+ * collapsing blanks its own way.
+ */
+declare function mergeRunFacetRows(rows: readonly {
+    status: RunStatus;
+    origin: string | null | undefined;
+    count: number;
+}[]): RunFacetRow[];
+
 /** A run as returned by the gateway's list — the durable run plus an optional {@link RunWaiting}
  *  descriptor the control plane resolves (what a suspended run is parked on), so the dashboard can
  *  name the wait in a list row without fetching each run's timeline. Additive: `waiting` is absent
@@ -4401,6 +4453,12 @@ declare abstract class RunGateway {
      *  parked on). The store-backed gateway resolves `waiting`; a proxy relays whatever the control
      *  plane sent. */
     abstract listRuns(query: RunQuery): Promise<RunListItem[]>;
+    /**
+     * Counts of the runs matching `query`, grouped by `(status, origin)` — what a console's status and
+     * origin chips display. Separate from {@link listRuns} precisely so the list can be PAGINATED: the
+     * page bounds what is rendered, these counts stay whole-set exact. Zero-count cells are absent.
+     */
+    abstract runFacets(query: RunFacetQuery): Promise<RunFacetRow[]>;
     /**
      * Bulk-resolve {@link RunWaiting} for an arbitrary set of run ids — for a consumer with its OWN
      * filtered/paginated run listing (so it isn't just `listRuns` under another name) that needs to know
@@ -4479,6 +4537,13 @@ interface PayloadCodec {
 declare class CodecStateStore implements StateStore {
     private readonly inner;
     private readonly codec;
+    /**
+     * Forwarded verbatim — a facet cell counts `status`/`origin`, neither of which the codec touches
+     * (it encodes payloads: input/output/error). Bound as a PROPERTY, and only when the inner store
+     * actually aggregates, so `store.runFacets?.()` still reports absence through the wrapper instead
+     * of resolving to a silently wrong empty result.
+     */
+    readonly runFacets?: (query: RunFacetQuery) => Promise<RunFacetRow[]>;
     constructor(inner: StateStore, codec: PayloadCodec);
     private enc;
     private dec;
@@ -4932,7 +4997,11 @@ declare class InMemoryStateStore implements StateStore {
      * scan `strValue` rows. This is the in-memory analog of the SQL EXISTS on `durable_run_attributes`.
      */
     private candidatesForFilter;
+    /** Every run satisfying `query`'s predicates, unsorted and unpaged — the shared body of
+     *  {@link listRuns} (which then sorts + pages it) and {@link runFacets} (which groups it). */
+    private matching;
     listRuns(query: RunQuery): Promise<WorkflowRun[]>;
+    runFacets(query: RunFacetQuery): Promise<RunFacetRow[]>;
     listCheckpoints(runId: string): Promise<StepCheckpoint[]>;
     getLatestCheckpointByName(runId: string, name: string): Promise<StepCheckpoint | undefined>;
     listCheckpointsByNamePrefix(runId: string, prefixes: string[]): Promise<StepCheckpoint[]>;
@@ -4964,4 +5033,4 @@ declare class InMemoryTransport implements Transport, ControlPlane {
     onControl(handler: (msg: ControlMessage) => void): void;
 }
 
-export { type AccumulatorHost, type Admission, type AdmissionBackend, type AdmissionItem, type AnnouncedWorkflow, type AnnouncementEvidence, type AttributeFilter, type AttributeOp, type BackoffStrategy, type BlockedDispatch, type BlockedResolution, CONTROL_FLOW_SIGNAL, CURRENT_PROTOCOL_VERSION, type CapabilityRequirement, type ChildCallOptions, CodecStateStore, ContinueAsNew, type ControlMessage, type ControlPlane, DEFAULT_PARTITION, DURABLE_OPTIONS, DURABLE_OPTIONS_CANONICAL, DURABLE_STEP_CONFIG, DURABLE_STEP_NAME, type Disagreement, type DispatchDiagnostics, type DispatchPlan, type DurableExecution, type DurableExecutionWrapper, type DurableTopology, type DurableWebhook, DurableWorkflow, EVENT_BUFFER_SCAN_LIMIT, EVENT_TOKEN_PREFIX, type EngineEvent, type EngineEventType, type EngineListener, Entities, type EntityConfig, type EntityHandler, type EntityHost, EventAccumulators, type EventBatchConfig, FatalError, GatherError, type GroupHealth, type Heartbeat, type HeartbeatSighting, type HeartbeatStatus, type HistoryEvent, InMemoryAdmissionBackend, InMemoryStateStore, InMemoryTransport, type InferSearchAttributes, LEGACY_V1_CAPABILITIES, LEGACY_V1_PROTOCOL, type MetricsCollector, type MetricsSnapshot, type NamedTransport, type NegotiateOptions, type NegotiationOutcome, type NegotiationReason, type NegotiationResult, NonDeterminismError, type PartitionSighting, type PayloadCodec, type QueueConfig, QueueController, type RawWorkerDescriptor, RemoteStepError, RemoteStepTimeout, type RemoteTask, RemoteWorkflowExecutor, RemoteWorkflowTimeout, type RetentionPolicy, type RoutableDispatch, type RoutableResolution, type RoutingResolution, type RunAttributeRow, type RunDetail, type RunDispatcher, RunGateway, type RunListItem, type RunQuery, type RunReply, type RunReplyResult, type RunRequest, type RunRequestKind, type RunResult, type RunSchedulesOptions, type RunStatus, type RunWaiting, STATE_STORE, STATE_STORE_CANONICAL, type ScheduledWorkflow, type SearchAttributes, type SearchAttributesSchema, SignalTimeoutError, type SignalWaiter, type SingletonConfig, SingletonQueueFullError, StandardSchemaV1, type StartOptions, type StartRunMessage, type StateStore, type StepCheckpoint, type StepConfig, type StepDef, type StepDispatchOpts, type StepError, type StepEvent, type StepHandler, type StepInterceptor, type StepInvocation, type StepKind, type StepLogger, type StepOptions, type StepRef, type StepResult, type StepUndo, type StoreTransaction, type SubProcessHandle, TERMINAL_RUN_STATUSES, TRANSPORT, TRANSPORT_CANONICAL, type TenantEvent, type Transport, type UndoOf, type UpdateResult, type UpdateValidator, VERSION_UNDECLARED_TAG, WORKFLOW_NAME_KEY, type WireDates, type WorkerAdjust, type WorkerConcurrencyStatus, type WorkerDescriptor, type WorkerHeartbeat, type WorkerLifecycle, type WorkerStatus, type WorkflowAnnouncement, WorkflowBlocked, type WorkflowClass, type WorkflowCommand, type WorkflowCtx, type WorkflowDecision, type WorkflowDirectory, WorkflowEngine, type WorkflowEngineDeps, type WorkflowExecutor, type WorkflowHandler, type WorkflowInputOf, type WorkflowOutputOf, type WorkflowRef, type WorkflowRegistration, type WorkflowRun, type WorkflowStartClient, type WorkflowStepEvent, WorkflowSuspended, type WorkflowTask, aggregateAnnouncements, announcementsOf, applyAttributeQuery, attributeColumnFor, attributeOperand, bindWorkflowClass, breakpointToken, buildWorkflowDirectory, canRoute, capableWorkers, classifyWaiterToken, clearDurableExecutionWrappers, collectMetrics, controlPlaneDescriptor, coveredTokens, createStepLogger, currentStep, currentWorkflowCtx, debug, describeWorker, descriptorHash, error, eventMatchOf, eventMatches, eventNameOf, eventPrefix, eventToken, hasDurableExecutionWrappers, heartbeatStatus, indexWaitersByRun, info, isEventToken, isLegacyDescriptor, isWorkflowControlFlowSignal, log, matchesAttributes, missingCapabilities, negotiate, normalizeAttributeRows, normalizeDescriptor, observedAnnouncements, parseDuration, partitionOfToken, planDispatch, prevCronFireMs, readSearchAttributes, requiredCapabilities, resolveRouting, resolveRunWaiting, runDurableExecution, runInStepLogger, runInWorkflowCtx, runSchedules, runStepHandler, sanitizeQueueToken, scheduledRunId, sqlComparator, stepConfigOf, stepId, stepNameOf, sub, subEvent, subProcess, tenantGroup, useDurableExecution, warn, workflowName };
+export { type AccumulatorHost, type Admission, type AdmissionBackend, type AdmissionItem, type AnnouncedWorkflow, type AnnouncementEvidence, type AttributeFilter, type AttributeOp, type BackoffStrategy, type BlockedDispatch, type BlockedResolution, CONTROL_FLOW_SIGNAL, CURRENT_PROTOCOL_VERSION, type CapabilityRequirement, type ChildCallOptions, CodecStateStore, ContinueAsNew, type ControlMessage, type ControlPlane, DEFAULT_PARTITION, DURABLE_OPTIONS, DURABLE_OPTIONS_CANONICAL, DURABLE_STEP_CONFIG, DURABLE_STEP_NAME, type Disagreement, type DispatchDiagnostics, type DispatchPlan, type DurableExecution, type DurableExecutionWrapper, type DurableTopology, type DurableWebhook, DurableWorkflow, EVENT_BUFFER_SCAN_LIMIT, EVENT_TOKEN_PREFIX, type EngineEvent, type EngineEventType, type EngineListener, Entities, type EntityConfig, type EntityHandler, type EntityHost, EventAccumulators, type EventBatchConfig, FatalError, GatherError, type GroupHealth, type Heartbeat, type HeartbeatSighting, type HeartbeatStatus, type HistoryEvent, InMemoryAdmissionBackend, InMemoryStateStore, InMemoryTransport, type InferSearchAttributes, LEGACY_V1_CAPABILITIES, LEGACY_V1_PROTOCOL, type MetricsCollector, type MetricsSnapshot, type NamedTransport, type NegotiateOptions, type NegotiationOutcome, type NegotiationReason, type NegotiationResult, NonDeterminismError, type PartitionSighting, type PayloadCodec, type QueueConfig, QueueController, type RawWorkerDescriptor, RemoteStepError, RemoteStepTimeout, type RemoteTask, RemoteWorkflowExecutor, RemoteWorkflowTimeout, type RetentionPolicy, type RoutableDispatch, type RoutableResolution, type RoutingResolution, type RunAttributeRow, type RunDetail, type RunDispatcher, type RunFacetQuery, type RunFacetRow, RunGateway, type RunListItem, type RunQuery, type RunReply, type RunReplyResult, type RunRequest, type RunRequestKind, type RunResult, type RunSchedulesOptions, type RunStatus, type RunWaiting, STATE_STORE, STATE_STORE_CANONICAL, type ScheduledWorkflow, type SearchAttributes, type SearchAttributesSchema, SignalTimeoutError, type SignalWaiter, type SingletonConfig, SingletonQueueFullError, StandardSchemaV1, type StartOptions, type StartRunMessage, type StateStore, type StepCheckpoint, type StepConfig, type StepDef, type StepDispatchOpts, type StepError, type StepEvent, type StepHandler, type StepInterceptor, type StepInvocation, type StepKind, type StepLogger, type StepOptions, type StepRef, type StepResult, type StepUndo, type StoreTransaction, type SubProcessHandle, TERMINAL_RUN_STATUSES, TRANSPORT, TRANSPORT_CANONICAL, type TenantEvent, type Transport, type UndoOf, type UpdateResult, type UpdateValidator, VERSION_UNDECLARED_TAG, WORKFLOW_NAME_KEY, type WireDates, type WorkerAdjust, type WorkerConcurrencyStatus, type WorkerDescriptor, type WorkerHeartbeat, type WorkerLifecycle, type WorkerStatus, type WorkflowAnnouncement, WorkflowBlocked, type WorkflowClass, type WorkflowCommand, type WorkflowCtx, type WorkflowDecision, type WorkflowDirectory, WorkflowEngine, type WorkflowEngineDeps, type WorkflowExecutor, type WorkflowHandler, type WorkflowInputOf, type WorkflowOutputOf, type WorkflowRef, type WorkflowRegistration, type WorkflowRun, type WorkflowStartClient, type WorkflowStepEvent, WorkflowSuspended, type WorkflowTask, aggregateAnnouncements, announcementsOf, applyAttributeQuery, attributeColumnFor, attributeOperand, bindWorkflowClass, breakpointToken, buildWorkflowDirectory, canRoute, capableWorkers, classifyWaiterToken, clearDurableExecutionWrappers, collectMetrics, controlPlaneDescriptor, coveredTokens, createStepLogger, currentStep, currentWorkflowCtx, debug, describeWorker, descriptorHash, error, eventMatchOf, eventMatches, eventNameOf, eventPrefix, eventToken, facetOrigin, hasDurableExecutionWrappers, heartbeatStatus, indexWaitersByRun, info, isEventToken, isLegacyDescriptor, isWorkflowControlFlowSignal, log, matchesAttributes, mergeRunFacetRows, missingCapabilities, negotiate, normalizeAttributeRows, normalizeDescriptor, observedAnnouncements, parseDuration, partitionOfToken, planDispatch, prevCronFireMs, readSearchAttributes, requiredCapabilities, resolveRouting, resolveRunWaiting, runDurableExecution, runInStepLogger, runInWorkflowCtx, runSchedules, runStepHandler, sanitizeQueueToken, scheduledRunId, sqlComparator, stepConfigOf, stepId, stepNameOf, sub, subEvent, subProcess, tenantGroup, useDurableExecution, warn, workflowName };

package/dist/index.d.ts

@@ -1032,6 +1032,16 @@ interface StateStore {
      */
     transaction?<T>(work: (tx: StoreTransaction) => Promise<T>): Promise<T>;
     listRuns(query: RunQuery): Promise<WorkflowRun[]>;
+    /**
+     * Count the runs matching `query`, grouped by `(status, origin)` — the totals behind a console's
+     * status and origin chips, in ONE aggregate instead of a full listing the caller counts in memory.
+     * This is what lets a run list be paginated at all: `listRuns` can return 100 rows while the chips
+     * still say how many of the 9,000 are failed.
+     *
+     * Cells with a zero count are simply absent. Optional: a store that omits it still works — callers
+     * fall back to counting a {@link listRuns} result, which is correct but unbounded.
+     */
+    runFacets?(query: RunFacetQuery): Promise<RunFacetRow[]>;
     listCheckpoints(runId: string): Promise<StepCheckpoint[]>;
     /**
      * The LATEST checkpoint for `runId` whose `name` equals `name` exactly (highest `seq` wins), or
@@ -1143,14 +1153,34 @@ interface RunQuery {
      * Restrict to runs whose workflow was declared by this package (exact match against
      * {@link WorkflowRun.origin}), ANDed with the other predicates.
      *
-     * A run with NO origin (unknown — see the field) matches no `origin` value at all, so a UI facet
+     * A run with NO origin (unknown — see the field) matches no `origin` VALUE at all, so a UI facet
      * built on this must keep an "all origins" option: filtering by any single package silently hides
-     * every unattributed run, which reads to an operator as "those runs do not exist".
+     * every unattributed run, which reads to an operator as "those runs do not exist". `null` selects
+     * exactly that absent bucket (`origin IS NULL`), so a paginated console can offer an "unknown"
+     * facet without having to hold every run in the browser to find them.
      */
-    origin?: string | undefined;
+    origin?: string | null | undefined;
     limit?: number | undefined;
     offset?: number | undefined;
 }
+/**
+ * The predicates a {@link RunFacetRow} count is taken over — a {@link RunQuery} minus the axes the
+ * facets THEMSELVES report (`status`/`origin`) and minus paging. Keeping them out of the type is
+ * what makes the counts answerable in one query: a console narrows by tag/tenant/attribute, and the
+ * one call back tells it how the matching runs split across every status and every origin at once.
+ */
+type RunFacetQuery = Omit<RunQuery, 'status' | 'statuses' | 'origin' | 'limit' | 'offset'>;
+/**
+ * One `(status, origin)` cell of {@link StateStore.runFacets} — a `GROUP BY` row, not a page of runs.
+ * A console pivots these into its status chips and its origin chips, so both stay exact while the
+ * list itself is paginated. `origin` is `null` for runs carrying none (see {@link WorkflowRun.origin});
+ * that bucket is a real, countable answer here rather than the absence a value-match cannot express.
+ */
+interface RunFacetRow {
+    status: RunStatus;
+    origin: string | null;
+    count: number;
+}
 /** The transaction handle `StateStore.transaction` hands to its work callback. */
 interface StoreTransaction {
     /** The store-native transaction handle (TypeORM `EntityManager`, Prisma tx client, MikroORM `EntityManager`,
@@ -1214,6 +1244,9 @@ type RunRequestKind = {
 } | {
     kind: 'listRuns';
     query: RunQuery;
+} | {
+    kind: 'runFacets';
+    query: RunFacetQuery;
 } | {
     kind: 'workerHealth';
 } | {
@@ -4344,6 +4377,25 @@ declare class RemoteWorkflowExecutor implements WorkflowExecutor {
     dispatch(run: WorkflowRun, history: HistoryEvent[], taskId: string, pendingSignals?: WorkflowTask['pendingSignals']): Promise<void>;
 }
 
+/**
+ * The origin a facet cell is filed under. An origin that is absent, null, or blank is all the same
+ * thing to an operator — a run no package claims — so they collapse to `null` here. Without this the
+ * "unknown" chip would count only one of those spellings while `origin IS NULL` paging returned
+ * another, and the chip's number would not match the page it opens.
+ */
+declare function facetOrigin(origin: string | null | undefined): string | null;
+/**
+ * Fold `(status, origin)` counts into one cell per pair, normalising origins via {@link facetOrigin}.
+ * Store adapters group in SQL and pipe their rows through this, so every adapter — and the in-memory
+ * store the tests run against — agrees on what lands in the unattributed bucket instead of each
+ * collapsing blanks its own way.
+ */
+declare function mergeRunFacetRows(rows: readonly {
+    status: RunStatus;
+    origin: string | null | undefined;
+    count: number;
+}[]): RunFacetRow[];
+
 /** A run as returned by the gateway's list — the durable run plus an optional {@link RunWaiting}
  *  descriptor the control plane resolves (what a suspended run is parked on), so the dashboard can
  *  name the wait in a list row without fetching each run's timeline. Additive: `waiting` is absent
@@ -4401,6 +4453,12 @@ declare abstract class RunGateway {
      *  parked on). The store-backed gateway resolves `waiting`; a proxy relays whatever the control
      *  plane sent. */
     abstract listRuns(query: RunQuery): Promise<RunListItem[]>;
+    /**
+     * Counts of the runs matching `query`, grouped by `(status, origin)` — what a console's status and
+     * origin chips display. Separate from {@link listRuns} precisely so the list can be PAGINATED: the
+     * page bounds what is rendered, these counts stay whole-set exact. Zero-count cells are absent.
+     */
+    abstract runFacets(query: RunFacetQuery): Promise<RunFacetRow[]>;
     /**
      * Bulk-resolve {@link RunWaiting} for an arbitrary set of run ids — for a consumer with its OWN
      * filtered/paginated run listing (so it isn't just `listRuns` under another name) that needs to know
@@ -4479,6 +4537,13 @@ interface PayloadCodec {
 declare class CodecStateStore implements StateStore {
     private readonly inner;
     private readonly codec;
+    /**
+     * Forwarded verbatim — a facet cell counts `status`/`origin`, neither of which the codec touches
+     * (it encodes payloads: input/output/error). Bound as a PROPERTY, and only when the inner store
+     * actually aggregates, so `store.runFacets?.()` still reports absence through the wrapper instead
+     * of resolving to a silently wrong empty result.
+     */
+    readonly runFacets?: (query: RunFacetQuery) => Promise<RunFacetRow[]>;
     constructor(inner: StateStore, codec: PayloadCodec);
     private enc;
     private dec;
@@ -4932,7 +4997,11 @@ declare class InMemoryStateStore implements StateStore {
      * scan `strValue` rows. This is the in-memory analog of the SQL EXISTS on `durable_run_attributes`.
      */
     private candidatesForFilter;
+    /** Every run satisfying `query`'s predicates, unsorted and unpaged — the shared body of
+     *  {@link listRuns} (which then sorts + pages it) and {@link runFacets} (which groups it). */
+    private matching;
     listRuns(query: RunQuery): Promise<WorkflowRun[]>;
+    runFacets(query: RunFacetQuery): Promise<RunFacetRow[]>;
     listCheckpoints(runId: string): Promise<StepCheckpoint[]>;
     getLatestCheckpointByName(runId: string, name: string): Promise<StepCheckpoint | undefined>;
     listCheckpointsByNamePrefix(runId: string, prefixes: string[]): Promise<StepCheckpoint[]>;
@@ -4964,4 +5033,4 @@ declare class InMemoryTransport implements Transport, ControlPlane {
     onControl(handler: (msg: ControlMessage) => void): void;
 }
 
-export { type AccumulatorHost, type Admission, type AdmissionBackend, type AdmissionItem, type AnnouncedWorkflow, type AnnouncementEvidence, type AttributeFilter, type AttributeOp, type BackoffStrategy, type BlockedDispatch, type BlockedResolution, CONTROL_FLOW_SIGNAL, CURRENT_PROTOCOL_VERSION, type CapabilityRequirement, type ChildCallOptions, CodecStateStore, ContinueAsNew, type ControlMessage, type ControlPlane, DEFAULT_PARTITION, DURABLE_OPTIONS, DURABLE_OPTIONS_CANONICAL, DURABLE_STEP_CONFIG, DURABLE_STEP_NAME, type Disagreement, type DispatchDiagnostics, type DispatchPlan, type DurableExecution, type DurableExecutionWrapper, type DurableTopology, type DurableWebhook, DurableWorkflow, EVENT_BUFFER_SCAN_LIMIT, EVENT_TOKEN_PREFIX, type EngineEvent, type EngineEventType, type EngineListener, Entities, type EntityConfig, type EntityHandler, type EntityHost, EventAccumulators, type EventBatchConfig, FatalError, GatherError, type GroupHealth, type Heartbeat, type HeartbeatSighting, type HeartbeatStatus, type HistoryEvent, InMemoryAdmissionBackend, InMemoryStateStore, InMemoryTransport, type InferSearchAttributes, LEGACY_V1_CAPABILITIES, LEGACY_V1_PROTOCOL, type MetricsCollector, type MetricsSnapshot, type NamedTransport, type NegotiateOptions, type NegotiationOutcome, type NegotiationReason, type NegotiationResult, NonDeterminismError, type PartitionSighting, type PayloadCodec, type QueueConfig, QueueController, type RawWorkerDescriptor, RemoteStepError, RemoteStepTimeout, type RemoteTask, RemoteWorkflowExecutor, RemoteWorkflowTimeout, type RetentionPolicy, type RoutableDispatch, type RoutableResolution, type RoutingResolution, type RunAttributeRow, type RunDetail, type RunDispatcher, RunGateway, type RunListItem, type RunQuery, type RunReply, type RunReplyResult, type RunRequest, type RunRequestKind, type RunResult, type RunSchedulesOptions, type RunStatus, type RunWaiting, STATE_STORE, STATE_STORE_CANONICAL, type ScheduledWorkflow, type SearchAttributes, type SearchAttributesSchema, SignalTimeoutError, type SignalWaiter, type SingletonConfig, SingletonQueueFullError, StandardSchemaV1, type StartOptions, type StartRunMessage, type StateStore, type StepCheckpoint, type StepConfig, type StepDef, type StepDispatchOpts, type StepError, type StepEvent, type StepHandler, type StepInterceptor, type StepInvocation, type StepKind, type StepLogger, type StepOptions, type StepRef, type StepResult, type StepUndo, type StoreTransaction, type SubProcessHandle, TERMINAL_RUN_STATUSES, TRANSPORT, TRANSPORT_CANONICAL, type TenantEvent, type Transport, type UndoOf, type UpdateResult, type UpdateValidator, VERSION_UNDECLARED_TAG, WORKFLOW_NAME_KEY, type WireDates, type WorkerAdjust, type WorkerConcurrencyStatus, type WorkerDescriptor, type WorkerHeartbeat, type WorkerLifecycle, type WorkerStatus, type WorkflowAnnouncement, WorkflowBlocked, type WorkflowClass, type WorkflowCommand, type WorkflowCtx, type WorkflowDecision, type WorkflowDirectory, WorkflowEngine, type WorkflowEngineDeps, type WorkflowExecutor, type WorkflowHandler, type WorkflowInputOf, type WorkflowOutputOf, type WorkflowRef, type WorkflowRegistration, type WorkflowRun, type WorkflowStartClient, type WorkflowStepEvent, WorkflowSuspended, type WorkflowTask, aggregateAnnouncements, announcementsOf, applyAttributeQuery, attributeColumnFor, attributeOperand, bindWorkflowClass, breakpointToken, buildWorkflowDirectory, canRoute, capableWorkers, classifyWaiterToken, clearDurableExecutionWrappers, collectMetrics, controlPlaneDescriptor, coveredTokens, createStepLogger, currentStep, currentWorkflowCtx, debug, describeWorker, descriptorHash, error, eventMatchOf, eventMatches, eventNameOf, eventPrefix, eventToken, hasDurableExecutionWrappers, heartbeatStatus, indexWaitersByRun, info, isEventToken, isLegacyDescriptor, isWorkflowControlFlowSignal, log, matchesAttributes, missingCapabilities, negotiate, normalizeAttributeRows, normalizeDescriptor, observedAnnouncements, parseDuration, partitionOfToken, planDispatch, prevCronFireMs, readSearchAttributes, requiredCapabilities, resolveRouting, resolveRunWaiting, runDurableExecution, runInStepLogger, runInWorkflowCtx, runSchedules, runStepHandler, sanitizeQueueToken, scheduledRunId, sqlComparator, stepConfigOf, stepId, stepNameOf, sub, subEvent, subProcess, tenantGroup, useDurableExecution, warn, workflowName };
+export { type AccumulatorHost, type Admission, type AdmissionBackend, type AdmissionItem, type AnnouncedWorkflow, type AnnouncementEvidence, type AttributeFilter, type AttributeOp, type BackoffStrategy, type BlockedDispatch, type BlockedResolution, CONTROL_FLOW_SIGNAL, CURRENT_PROTOCOL_VERSION, type CapabilityRequirement, type ChildCallOptions, CodecStateStore, ContinueAsNew, type ControlMessage, type ControlPlane, DEFAULT_PARTITION, DURABLE_OPTIONS, DURABLE_OPTIONS_CANONICAL, DURABLE_STEP_CONFIG, DURABLE_STEP_NAME, type Disagreement, type DispatchDiagnostics, type DispatchPlan, type DurableExecution, type DurableExecutionWrapper, type DurableTopology, type DurableWebhook, DurableWorkflow, EVENT_BUFFER_SCAN_LIMIT, EVENT_TOKEN_PREFIX, type EngineEvent, type EngineEventType, type EngineListener, Entities, type EntityConfig, type EntityHandler, type EntityHost, EventAccumulators, type EventBatchConfig, FatalError, GatherError, type GroupHealth, type Heartbeat, type HeartbeatSighting, type HeartbeatStatus, type HistoryEvent, InMemoryAdmissionBackend, InMemoryStateStore, InMemoryTransport, type InferSearchAttributes, LEGACY_V1_CAPABILITIES, LEGACY_V1_PROTOCOL, type MetricsCollector, type MetricsSnapshot, type NamedTransport, type NegotiateOptions, type NegotiationOutcome, type NegotiationReason, type NegotiationResult, NonDeterminismError, type PartitionSighting, type PayloadCodec, type QueueConfig, QueueController, type RawWorkerDescriptor, RemoteStepError, RemoteStepTimeout, type RemoteTask, RemoteWorkflowExecutor, RemoteWorkflowTimeout, type RetentionPolicy, type RoutableDispatch, type RoutableResolution, type RoutingResolution, type RunAttributeRow, type RunDetail, type RunDispatcher, type RunFacetQuery, type RunFacetRow, RunGateway, type RunListItem, type RunQuery, type RunReply, type RunReplyResult, type RunRequest, type RunRequestKind, type RunResult, type RunSchedulesOptions, type RunStatus, type RunWaiting, STATE_STORE, STATE_STORE_CANONICAL, type ScheduledWorkflow, type SearchAttributes, type SearchAttributesSchema, SignalTimeoutError, type SignalWaiter, type SingletonConfig, SingletonQueueFullError, StandardSchemaV1, type StartOptions, type StartRunMessage, type StateStore, type StepCheckpoint, type StepConfig, type StepDef, type StepDispatchOpts, type StepError, type StepEvent, type StepHandler, type StepInterceptor, type StepInvocation, type StepKind, type StepLogger, type StepOptions, type StepRef, type StepResult, type StepUndo, type StoreTransaction, type SubProcessHandle, TERMINAL_RUN_STATUSES, TRANSPORT, TRANSPORT_CANONICAL, type TenantEvent, type Transport, type UndoOf, type UpdateResult, type UpdateValidator, VERSION_UNDECLARED_TAG, WORKFLOW_NAME_KEY, type WireDates, type WorkerAdjust, type WorkerConcurrencyStatus, type WorkerDescriptor, type WorkerHeartbeat, type WorkerLifecycle, type WorkerStatus, type WorkflowAnnouncement, WorkflowBlocked, type WorkflowClass, type WorkflowCommand, type WorkflowCtx, type WorkflowDecision, type WorkflowDirectory, WorkflowEngine, type WorkflowEngineDeps, type WorkflowExecutor, type WorkflowHandler, type WorkflowInputOf, type WorkflowOutputOf, type WorkflowRef, type WorkflowRegistration, type WorkflowRun, type WorkflowStartClient, type WorkflowStepEvent, WorkflowSuspended, type WorkflowTask, aggregateAnnouncements, announcementsOf, applyAttributeQuery, attributeColumnFor, attributeOperand, bindWorkflowClass, breakpointToken, buildWorkflowDirectory, canRoute, capableWorkers, classifyWaiterToken, clearDurableExecutionWrappers, collectMetrics, controlPlaneDescriptor, coveredTokens, createStepLogger, currentStep, currentWorkflowCtx, debug, describeWorker, descriptorHash, error, eventMatchOf, eventMatches, eventNameOf, eventPrefix, eventToken, facetOrigin, hasDurableExecutionWrappers, heartbeatStatus, indexWaitersByRun, info, isEventToken, isLegacyDescriptor, isWorkflowControlFlowSignal, log, matchesAttributes, mergeRunFacetRows, missingCapabilities, negotiate, normalizeAttributeRows, normalizeDescriptor, observedAnnouncements, parseDuration, partitionOfToken, planDispatch, prevCronFireMs, readSearchAttributes, requiredCapabilities, resolveRouting, resolveRunWaiting, runDurableExecution, runInStepLogger, runInWorkflowCtx, runSchedules, runStepHandler, sanitizeQueueToken, scheduledRunId, sqlComparator, stepConfigOf, stepId, stepNameOf, sub, subEvent, subProcess, tenantGroup, useDurableExecution, warn, workflowName };

package/dist/index.js

@@ -5975,6 +5975,33 @@ var TERMINAL_RUN_STATUSES = [
   "dead"
 ];
 
+// src/run-facets.ts
+function facetOrigin(origin) {
+  return origin?.trim() ? origin : null;
+}
+__name(facetOrigin, "facetOrigin");
+function mergeRunFacetRows(rows) {
+  const cells = /* @__PURE__ */ new Map();
+  for (const row of rows) {
+    const origin = facetOrigin(row.origin);
+    const key = JSON.stringify([
+      row.status,
+      origin
+    ]);
+    const cell = cells.get(key);
+    if (cell) cell.count += row.count;
+    else cells.set(key, {
+      status: row.status,
+      origin,
+      count: row.count
+    });
+  }
+  return [
+    ...cells.values()
+  ];
+}
+__name(mergeRunFacetRows, "mergeRunFacetRows");
+
 // src/run-gateway.ts
 var RunGateway = class {
   static {
@@ -5989,9 +6016,18 @@ var CodecStateStore = class {
   }
   inner;
   codec;
+  /**
+  * Forwarded verbatim — a facet cell counts `status`/`origin`, neither of which the codec touches
+  * (it encodes payloads: input/output/error). Bound as a PROPERTY, and only when the inner store
+  * actually aggregates, so `store.runFacets?.()` still reports absence through the wrapper instead
+  * of resolving to a silently wrong empty result.
+  */
+  runFacets;
   constructor(inner, codec) {
     this.inner = inner;
     this.codec = codec;
+    const facets = inner.runFacets;
+    if (facets) this.runFacets = (query) => facets.call(inner, query);
   }
   enc(v) {
     return v === void 0 ? void 0 : this.codec.encode(v);
@@ -6689,7 +6725,9 @@ var InMemoryStateStore = class {
     }
     return out;
   }
-  async listRuns(query) {
+  /** Every run satisfying `query`'s predicates, unsorted and unpaged — the shared body of
+  *  {@link listRuns} (which then sorts + pages it) and {@link runFacets} (which groups it). */
+  matching(query) {
     let runs = [
       ...this.runs.values()
     ];
@@ -6698,7 +6736,8 @@ var InMemoryStateStore = class {
     if (query.statuses) runs = runs.filter((r) => query.statuses?.includes(r.status));
     if (query.tag) runs = runs.filter((r) => r.tags?.includes(query.tag));
     if (query.namespace !== void 0) runs = runs.filter((r) => r.namespace === query.namespace);
-    if (query.origin !== void 0) runs = runs.filter((r) => r.origin === query.origin);
+    if (query.origin === null) runs = runs.filter((r) => r.origin == null);
+    else if (query.origin !== void 0) runs = runs.filter((r) => r.origin === query.origin);
     if (query.attributes?.length) {
       let candidates = null;
       for (const f of query.attributes) {
@@ -6717,6 +6756,10 @@ var InMemoryStateStore = class {
       this.lastAttributeCandidates = ids.size;
       runs = runs.filter((r) => ids.has(r.id));
     }
+    return runs;
+  }
+  async listRuns(query) {
+    const runs = this.matching(query);
     runs.sort((a, b) => b.createdAt.getTime() - a.createdAt.getTime());
     const offset = query.offset ?? 0;
     const limit = query.limit ?? runs.length;
@@ -6724,6 +6767,13 @@ var InMemoryStateStore = class {
       ...r
     }));
   }
+  async runFacets(query) {
+    return mergeRunFacetRows(this.matching(query).map((run) => ({
+      status: run.status,
+      origin: run.origin,
+      count: 1
+    })));
+  }
   async listCheckpoints(runId) {
     const rows = [
       ...this.checkpoints.values()
@@ -6868,6 +6918,7 @@ export {
   eventNameOf,
   eventPrefix,
   eventToken,
+  facetOrigin,
   hasDurableExecutionWrappers,
   heartbeatStatus,
   indexWaitersByRun,
@@ -6877,6 +6928,7 @@ export {
   isWorkflowControlFlowSignal,
   log,
   matchesAttributes,
+  mergeRunFacetRows,
   missingCapabilities,
   negotiate,
   normalizeAttributeRows,