deepline 0.3.286 → 0.3.288

package/dist/bundling-sources/sdk/src/client.ts

@@ -117,6 +117,8 @@ import type {
   DeeplineAgentModelDescription,
   InferenceQuote,
   ChildRunSummary,
+  SearchOptions,
+  SearchResult,
 } from './types.js';
 import { isStopAllPlayRunsDryRunResult } from './types.js';
 import type { MonitorDefinition } from './monitors.js';
@@ -610,6 +612,29 @@ function chunkRegisterPlayArtifacts<T>(artifacts: T[]): T[][] {
   return chunks;
 }
 
+/** Query parameters shared by every search route. */
+function searchParams(options: ToolSearchOptions): URLSearchParams {
+  const params = new URLSearchParams();
+  params.set('q', options.query?.trim() ?? '');
+  params.set(
+    'include_search_debug',
+    options.includeSearchDebug ? 'true' : 'false',
+  );
+  params.set('search_mode', options.searchMode ?? 'v2');
+  if (options.limit !== undefined) params.set('limit', String(options.limit));
+  if (options.offset !== undefined) {
+    params.set('offset', String(options.offset));
+  }
+  if (options.categories?.trim()) {
+    params.set('categories', options.categories.trim());
+  }
+  if (options.searchTerms?.trim()) {
+    params.set('search_terms', options.searchTerms.trim());
+  }
+  if (options.task?.trim()) params.set('task', options.task.trim());
+  return params;
+}
+
 /** Filters for `client.runs.list(...)`. */
 export type RunsListOptions = {
   play?: string;
@@ -3195,34 +3220,32 @@ export class DeeplineClient {
   async searchTools(
     options: ToolSearchOptions = {},
   ): Promise<ToolSearchResult> {
-    const params = new URLSearchParams();
-    const query = options.query?.trim() ?? '';
-    params.set('q', query);
-    params.set(
-      'include_search_debug',
-      options.includeSearchDebug ? 'true' : 'false',
-    );
-    params.set('search_mode', options.searchMode ?? 'v2');
-    if (options.limit !== undefined) {
-      params.set('limit', String(options.limit));
-    }
-    if (options.offset !== undefined) {
-      params.set('offset', String(options.offset));
-    }
-    if (options.categories?.trim()) {
-      params.set('categories', options.categories.trim());
-    }
-    if (options.searchTerms?.trim()) {
-      params.set('search_terms', options.searchTerms.trim());
-    }
-    if (options.task?.trim()) {
-      params.set('task', options.task.trim());
-    }
     return this.http.get<ToolSearchResult>(
-      `/api/v2/tools/search?${params.toString()}`,
+      `/api/v2/tools/search?${searchParams(options).toString()}`,
     );
   }
 
+  /**
+   * Search everything Deepline can run or deploy in one ranked list: tools,
+   * monitor types, prebuilt plays, and your workspace's own plays.
+   *
+   * @example
+   * ```typescript
+   * const { results } = await client.search({
+   *   query: 'find work email',
+   *   types: ['tools', 'prebuilts'],
+   * });
+   * ```
+   */
+  async search(options: SearchOptions = {}): Promise<SearchResult> {
+    const params = searchParams(options);
+    if (options.types?.length) params.set('types', options.types.join(','));
+    if (options.exclude?.length) {
+      params.set('exclude', options.exclude.join(','));
+    }
+    return this.http.get<SearchResult>(`/api/v2/search?${params.toString()}`);
+  }
+
   /**
    * Get detailed metadata for a single tool.
    *

package/dist/bundling-sources/sdk/src/index.ts

@@ -313,6 +313,10 @@ export type {
   StopPlayRunResult,
   ToolSearchOptions,
   ToolSearchResult,
+  SearchOptions,
+  SearchResult,
+  SearchResultItem,
+  SearchType,
 } from './types.js';
 
 export type {

package/dist/bundling-sources/sdk/src/release.ts

@@ -200,7 +200,7 @@ export const SDK_RELEASE = {
   // getters keep their established compatibility behavior.
   // 0.3.1 deprecated the legacy `deepline enrich` command in favor of Plays.
   // 0.3.90 is the first deliberately versioned SDK release for API v3.
-  version: '0.3.286',
+  version: '0.3.288',
   updateSummary:
     'Play grep now returns concise results with the matched fields and terms. Automatic CLI updates are enabled by default; use `deepline settings autoupdate off` to opt out, `deepline settings autoupdate on` to re-enable updates, or `deepline settings autoupdate pin <version>` to hold an exact release.',
   packageCapabilities: {
@@ -235,6 +235,12 @@ export const SDK_RELEASE = {
     minimumSupported: '0.1.53',
     deprecatedBelow: '0.3.1',
     commandIntroducedIn: [
+      {
+        command: 'search',
+        introducedIn: '0.3.91',
+        reason:
+          'deepline search was added in SDK CLI 0.3.91 as the one search across tools, monitors, and plays. On an older version run deepline tools search or deepline plays search, or update.',
+      },
       {
         command: 'notifications',
         introducedIn: '0.2.40',

package/dist/bundling-sources/sdk/src/types.ts

@@ -488,6 +488,42 @@ export interface ToolSearchOptions {
   includeSearchDebug?: boolean;
 }
 
+/** What a search can be narrowed to. `plays` is `prebuilts` plus `custom`. */
+export type SearchType =
+  | 'tools'
+  | 'plays'
+  | 'monitors'
+  | 'prebuilts'
+  | 'custom';
+
+/** Options for {@link DeeplineClient.search}. */
+export interface SearchOptions extends ToolSearchOptions {
+  /** Kinds of result to search. Omit to search everything. */
+  types?: readonly SearchType[];
+  /** Kinds of result to leave out; the opposite of `types`. */
+  exclude?: readonly SearchType[];
+}
+
+/** One ranked search result; `kind` says which fields accompany it. */
+export interface SearchResultItem {
+  /** Tool id for tools and monitor types, or play reference. */
+  id: string;
+  kind: 'tool' | 'monitor_type' | 'prebuilt_play' | 'custom_play';
+  displayName?: string;
+  description?: string;
+  [field: string]: unknown;
+}
+
+/** Ranked results across tools, monitor types, and plays. */
+export interface SearchResult extends Omit<
+  ToolSearchResult,
+  'tools' | 'omitted_plays_hint' | 'commandTemplates'
+> {
+  results: SearchResultItem[];
+  /** The result kinds this search covered. */
+  kinds: SearchResultItem['kind'][];
+}
+
 /**
  * Ranked tool/provider discovery response.
  *

package/dist/bundling-sources/shared_libs/play-runtime/cell-provenance.ts

@@ -45,6 +45,22 @@ export interface PlayCellDecision {
   reads: PlayCellReadRef[];
 }
 
+/** One persisted outcome per row and predicate, never evaluation attempts. */
+export type PlayConditionCounts = { true: number; false: number };
+
+export function normalizePlayConditionCounts(
+  value: unknown,
+): PlayConditionCounts | undefined {
+  if (!value || typeof value !== 'object') return undefined;
+  const counts = value as PlayConditionCounts;
+  return Number.isSafeInteger(counts.true) &&
+    counts.true >= 0 &&
+    Number.isSafeInteger(counts.false) &&
+    counts.false >= 0
+    ? { true: counts.true, false: counts.false }
+    : undefined;
+}
+
 /** Row-grain birth: the source row the runtime held while building this row. */
 export type PlayRowBornFromRow = { table: string; rowKey: string };
 

package/dist/bundling-sources/shared_libs/play-runtime/context.ts

@@ -371,6 +371,7 @@ import {
   type PlayExecutionSuspension,
 } from './suspension';
 import {
+  createRequestHeaderSecretRedactionContext,
   createSecretRedactionContext,
   type SecretRedactionContext,
 } from './secret-redaction';
@@ -14669,6 +14670,10 @@ export class PlayContextImpl implements ScalarPlayAuthoringRuntimeContext {
           if (headers['user-agent'] === undefined) {
             headers['user-agent'] = 'Deepline Play Runtime';
           }
+          const requestRedactor = createRequestHeaderSecretRedactionContext(
+            headers,
+            Object.keys(secretHeaderMarkers),
+          );
           const fetchInit = { ...init, headers };
           delete fetchInit.auth;
           const boundaryId = this.durableBoundaryId(
@@ -14755,18 +14760,18 @@ export class PlayContextImpl implements ScalarPlayAuthoringRuntimeContext {
               log: (message) => this.runtimeLog(message),
             });
             const rawJson = parseJsonOrNull(bodyText);
-            const redactedBodyText = this.secretRedactor.redactString(bodyText);
-            const output: PlayFetchResponse = {
-              ok: response.ok,
-              status: response.status,
-              statusText: response.statusText,
-              url: response.url,
-              headers: this.secretRedactor.redact(
-                Object.fromEntries(response.headers.entries()),
-              ) as Record<string, string>,
-              bodyText: redactedBodyText,
-              json: this.secretRedactor.redactKnownSecrets(rawJson),
-            };
+            const output: PlayFetchResponse =
+              this.secretRedactor.redactKnownSecrets(
+                requestRedactor.redactKnownSecrets({
+                  ok: response.ok,
+                  status: response.status,
+                  statusText: response.statusText,
+                  url: response.url,
+                  headers: Object.fromEntries(response.headers.entries()),
+                  bodyText,
+                  json: rawJson,
+                }),
+              );
 
             if (!output.ok) {
               this.logCtxFetchHttpFailure({

package/dist/bundling-sources/shared_libs/play-runtime/docflow-node-io.ts

@@ -73,7 +73,7 @@ export type PlayDocflowNodeIoState = {
 };
 
 type PreviewOptions = {
-  redactor?: SecretRedactionContext;
+  redactor?: Pick<SecretRedactionContext, 'redactRegisteredSecrets'>;
 };
 
 const utf8Encoder = new TextEncoder();
@@ -132,26 +132,13 @@ function truncateUtf8(value: string, maxBytes: number): string {
   return `${output}…`;
 }
 
-function redactString(
-  redactor: SecretRedactionContext,
-  value: string,
-  key?: string,
-): string {
-  if (!key) return redactor.redactString(value);
-  const wrapped = redactor.redact({ [key]: value }) as Record<string, unknown>;
-  return typeof wrapped[key] === 'string'
-    ? wrapped[key]
-    : redactor.redactString(value);
-}
-
 function safeString(
   value: unknown,
-  redactor: SecretRedactionContext,
-  key?: string,
+  redactor?: PreviewOptions['redactor'],
 ): string | undefined {
   if (typeof value !== 'string') return undefined;
   return truncateUtf8(
-    redactString(redactor, value, key),
+    redactor?.redactRegisteredSecrets(value) ?? value,
     DOCFLOW_NODE_IO_LIMITS.maxStringBytes,
   );
 }
@@ -161,8 +148,7 @@ function previewValue(
   input: {
     depth: number;
     ancestors: WeakSet<object>;
-    redactor: SecretRedactionContext;
-    key?: string;
+    redactor?: PreviewOptions['redactor'];
   },
 ): PlayDocflowNodeValuePreview {
   if (value === null) return { kind: 'null' };
@@ -170,7 +156,7 @@ function previewValue(
   if (typeof value === 'string') {
     return {
       kind: 'scalar',
-      value: safeString(value, input.redactor, input.key) ?? '',
+      value: safeString(value, input.redactor) ?? '',
     };
   }
   if (typeof value === 'number') {
@@ -207,18 +193,13 @@ function previewValue(
     ) {
       return {
         kind: 'dataset',
-        datasetId:
-          safeString(datasetId.value, input.redactor, 'datasetId') ?? 'dataset',
+        datasetId: safeString(datasetId.value, input.redactor) ?? 'dataset',
         datasetKind: datasetKind.value,
         tableNamespace:
           tableNamespace.ok && tableNamespace.value === null
             ? null
             : tableNamespace.ok
-              ? safeString(
-                  tableNamespace.value,
-                  input.redactor,
-                  'tableNamespace',
-                )
+              ? safeString(tableNamespace.value, input.redactor)
               : undefined,
       };
     }
@@ -239,18 +220,13 @@ function previewValue(
     ) {
       return {
         kind: 'dataset',
-        datasetId:
-          safeString(datasetId.value, input.redactor, 'datasetId') ?? 'dataset',
+        datasetId: safeString(datasetId.value, input.redactor) ?? 'dataset',
         datasetKind: datasetKind.value,
         tableNamespace:
           tableNamespace.ok && tableNamespace.value === null
             ? null
             : tableNamespace.ok
-              ? safeString(
-                  tableNamespace.value,
-                  input.redactor,
-                  'tableNamespace',
-                )
+              ? safeString(tableNamespace.value, input.redactor)
               : undefined,
         rowCount: Math.max(0, Math.floor(count.value)),
       };
@@ -309,7 +285,9 @@ function previewValue(
     const fields: Record<string, PlayDocflowNodeValuePreview> = {};
     for (const [key, descriptor] of selected) {
       const safeKey = truncateUtf8(
-        ledgerSafeDocflowPreviewKey(input.redactor.redactString(key)),
+        ledgerSafeDocflowPreviewKey(
+          input.redactor?.redactRegisteredSecrets(key) ?? key,
+        ),
         DOCFLOW_NODE_IO_LIMITS.maxStringBytes,
       );
       fields[safeKey] =
@@ -317,7 +295,6 @@ function previewValue(
           ? previewValue(descriptor.value, {
               ...input,
               depth: input.depth + 1,
-              key,
             })
           : { kind: 'unavailable', reason: 'access_error' };
     }
@@ -338,7 +315,6 @@ export function buildPlayDocflowNodeIoPreviewMap(
   values: Record<string, unknown>,
   options: PreviewOptions = {},
 ): { values: PlayDocflowNodeIoPreviewMap; truncated: boolean } {
-  const redactor = options.redactor ?? createSecretRedactionContext();
   const previews: PlayDocflowNodeIoPreviewMap = {};
   let truncated = false;
   let entries: Array<[string, unknown]>;
@@ -356,14 +332,15 @@ export function buildPlayDocflowNodeIoPreviewMap(
       break;
     }
     const safePath = truncateUtf8(
-      ledgerSafeDocflowPreviewKey(redactor.redactString(path)),
+      ledgerSafeDocflowPreviewKey(
+        options.redactor?.redactRegisteredSecrets(path) ?? path,
+      ),
       DOCFLOW_NODE_IO_LIMITS.maxStringBytes,
     );
     const preview = previewValue(value, {
       depth: 0,
       ancestors: new WeakSet(),
-      redactor,
-      key: path.split('.').at(-1),
+      redactor: options.redactor,
     });
     const candidate = { ...previews, [safePath]: preview };
     if (
@@ -413,7 +390,6 @@ export function buildPlayDocflowNodeInputPreviewMap(
   captures: readonly PlayDocflowNodeInputCapture[],
   options: PreviewOptions = {},
 ): { values: PlayDocflowNodeIoPreviewMap; truncated: boolean } {
-  const redactor = options.redactor ?? createSecretRedactionContext();
   const values: PlayDocflowNodeIoPreviewMap = {};
   let truncated = false;
   for (const capture of captures.slice(0, DOCFLOW_NODE_IO_LIMITS.maxPaths)) {
@@ -435,15 +411,16 @@ export function buildPlayDocflowNodeInputPreviewMap(
       }
     }
     const safePath = truncateUtf8(
-      ledgerSafeDocflowPreviewKey(redactor.redactString(capture.path)),
+      ledgerSafeDocflowPreviewKey(
+        options.redactor?.redactRegisteredSecrets(capture.path) ?? capture.path,
+      ),
       DOCFLOW_NODE_IO_LIMITS.maxStringBytes,
     );
     const preview: PlayDocflowNodeValuePreview = available
       ? previewValue(current, {
           depth: 0,
           ancestors: new WeakSet(),
-          redactor,
-          key: capture.properties.at(-1) ?? capture.path,
+          redactor: options.redactor,
         })
       : { kind: 'unavailable', reason: 'access_error' };
     const candidate = { ...values, [safePath]: preview };
@@ -494,7 +471,6 @@ function normalizePreview(
       return previewValue(value.value, {
         depth: 0,
         ancestors: new WeakSet(),
-        redactor: createSecretRedactionContext(),
       });
     }
     return null;
@@ -523,11 +499,7 @@ function normalizePreview(
       : null;
   }
   if (value.kind === 'dataset') {
-    const datasetId = safeString(
-      value.datasetId,
-      createSecretRedactionContext(),
-      'datasetId',
-    );
+    const datasetId = safeString(value.datasetId);
     if (
       !datasetId ||
       (value.datasetKind !== 'csv' && value.datasetKind !== 'map')
@@ -542,11 +514,7 @@ function normalizePreview(
         ? { tableNamespace: null }
         : typeof value.tableNamespace === 'string'
           ? {
-              tableNamespace: safeString(
-                value.tableNamespace,
-                createSecretRedactionContext(),
-                'tableNamespace',
-              ),
+              tableNamespace: safeString(value.tableNamespace),
             }
           : {}),
       ...(typeof value.rowCount === 'number' && Number.isFinite(value.rowCount)

package/dist/bundling-sources/shared_libs/play-runtime/ledger-safe-payload.ts

@@ -59,52 +59,33 @@ export function sanitizeOpaqueLedgerPayload(value: unknown): unknown {
   return redactedIssue ? opaqueLedgerPayloadSummary(redactedIssue) : redacted;
 }
 
-/** A receipt payload redacted once, serialized once, and measured from that text. */
+/** A customer receipt value serialized once and measured from the stored text. */
 export type SanitizedRuntimeReceiptPayload = {
-  /** The redacted value. Callers return or re-project this, never the source. */
   value: unknown;
-  /**
-   * Canonical Postgres JSON text for `value`, byte-identical to what
-   * `stringifyPostgresJson(value ?? null)` produces. `jsonb` accepts this text
-   * directly, so the completion path never re-serializes the same output.
-   */
+  /** Canonical Postgres JSON text, passed directly to the jsonb completion write. */
   serialized: string;
-  /** UTF-8 byte length of `serialized`; the measured size the limit is enforced on. */
+  /** UTF-8 byte length of `serialized`. */
   bytes: number;
 };
 
-/**
- * Secret-redact a receipt payload without coupling its 10 MiB cell limit to the
- * ledger, and serialize it exactly once.
- *
- * The limit is enforced on the redacted, serialized value that is actually
- * persisted. Redaction normally shrinks credential-shaped values but can expand
- * short matched strings, so measuring the source instead would be wrong in both
- * directions.
- *
- * Redaction is identity-preserving: a payload carrying no credential comes back
- * as the very object that was passed in, with no deep clone, and is serialized
- * exactly once. Only a payload that actually redacts pays for a rebuilt value.
- */
 export function sanitizeRuntimeReceiptPayloadForStorage(
   value: unknown,
 ): SanitizedRuntimeReceiptPayload {
-  const redacted = ledgerIngressRedactor.redact(value);
   // `undefined` is not JSON. The receipt contract stores it as jsonb `null`,
   // which is exactly what the previous `stringifyPostgresJson(output ?? null)`
   // parameter produced.
-  const serialized = stringifyPostgresJson(redacted ?? null);
+  const serialized = stringifyPostgresJson(value ?? null);
   if (serialized === undefined) {
     throw new TypeError('Runtime receipt output is not JSON-serializable.');
   }
   const bytes = assertSerializedRuntimeReceiptOutputWithinLimit({
     serialized,
-    path: 'runtime receipt output after secret redaction',
+    path: 'runtime receipt output',
   });
-  return { value: redacted, serialized, bytes };
+  return { value, serialized, bytes };
 }
 
-/** Secret-redact a receipt payload without coupling its 10 MiB cell limit to the ledger. */
+/** Enforce the customer receipt byte limit without altering its values. */
 export function sanitizeRuntimeReceiptPayload(value: unknown): unknown {
   return sanitizeRuntimeReceiptPayloadForStorage(value).value;
 }

package/dist/bundling-sources/shared_libs/play-runtime/live-state-contract.ts

@@ -1,6 +1,7 @@
 import type { PlayRunLifecycleStatus } from './run-lifecycle-policy';
 import type { PlayDocflowNodeIoState } from './docflow-node-io';
 import type { RunStopCause } from './run-execution-state';
+import type { PlayConditionCounts } from './cell-provenance';
 import type {
   PlayActivityObservation,
   PlayRunActivityProjection,
@@ -31,6 +32,7 @@ export type PlayVisualNodeProgressSnapshot = {
   completedAt?: number | null;
   artifactTableNamespace?: string | null;
   nodeIo?: PlayDocflowNodeIoState;
+  conditionCounts?: PlayConditionCounts;
 };
 
 /**

package/dist/bundling-sources/shared_libs/play-runtime/run-ledger.ts

@@ -20,6 +20,8 @@ import {
   mergeDatasetBornFrom,
   normalizeDatasetBornFrom,
   type PlayDatasetBornFrom,
+  normalizePlayConditionCounts,
+  type PlayConditionCounts,
 } from './cell-provenance';
 import { isLedgerTerminalResultRef } from './output-size-limits';
 import type { PlayLogContext } from './log-context';
@@ -98,6 +100,7 @@ export type PlayRunLedgerStepProgress = {
   completedAt?: number | null;
   updatedAt?: number | null;
   nodeIo?: PlayDocflowNodeIoState;
+  conditionCounts?: PlayConditionCounts;
 };
 
 export type PlayRunLedgerStepSnapshot = {
@@ -1400,6 +1403,9 @@ function normalizeStepProgress(
     ...(normalizePlayDocflowNodeIoState(value.nodeIo)
       ? { nodeIo: normalizePlayDocflowNodeIoState(value.nodeIo) }
       : {}),
+    ...(normalizePlayConditionCounts(value.conditionCounts)
+      ? { conditionCounts: normalizePlayConditionCounts(value.conditionCounts) }
+      : {}),
   };
 }
 
@@ -1760,11 +1766,36 @@ export function reducePlayRunLedgerEvent(
   // Detached runners can race their best-effort progress transport against the
   // terminal outbox, and gateway processes can restart or split that traffic.
   // The Play Run Ledger is the durable projection authority, so late
-  // `step.*` facts must be a true no-op here rather than relying on a gateway
-  // process to remember terminal state.
+  // lifecycle facts must be a true no-op here rather than relying on a gateway
+  // process to remember terminal state. Settled condition counts may arrive
+  // after that claim and fill an absent summary without changing lifecycle.
   if (isTerminalPlayRunLedgerStatus(snapshot.status)) {
     if (event.type === RUN_EVENT_KIND.stepProgress) {
-      return refineTerminalSyntheticStepStart(snapshot, event) ?? snapshot;
+      const refined =
+        refineTerminalSyntheticStepStart(snapshot, event) ?? snapshot;
+      const current = refined.stepsById[event.stepId];
+      const conditionCounts = normalizePlayConditionCounts(
+        event.progress.conditionCounts,
+      );
+      // Sheet reconciliation follows the fenced terminal claim. Accept its
+      // first settled predicate pair without reopening lifecycle or timestamps.
+      if (conditionCounts && !current?.progress?.conditionCounts) {
+        return {
+          ...refined,
+          orderedStepIds: appendOrderedStepId(refined, event.stepId),
+          stepsById: {
+            ...refined.stepsById,
+            [event.stepId]: {
+              ...(current ?? {
+                stepId: event.stepId,
+                status: 'completed' as const,
+              }),
+              progress: { ...current?.progress, conditionCounts },
+            },
+          },
+        };
+      }
+      return refined;
     }
     if (isStepLifecycleEvent(event)) return snapshot;
   }
@@ -2300,6 +2331,7 @@ function progressSignature(
     startedAt: progress?.startedAt ?? null,
     completedAt: progress?.completedAt ?? null,
     nodeIo: progress?.nodeIo ?? null,
+    conditionCounts: progress?.conditionCounts ?? null,
   });
 }
 
@@ -2621,6 +2653,9 @@ export function buildPlayRunLedgerEventsFromStatusPatch(input: {
         ? { completedAt: progress.completedAt }
         : {}),
       ...(progress.nodeIo !== undefined ? { nodeIo: progress.nodeIo } : {}),
+      ...(progress.conditionCounts !== undefined
+        ? { conditionCounts: progress.conditionCounts }
+        : {}),
       updatedAt: progress.updatedAt ?? checkpointAt,
     };
     if (

package/dist/bundling-sources/shared_libs/play-runtime/run-observation.ts

@@ -9,6 +9,10 @@ import {
   isTerminalPlayRunLifecycleStatus,
   type PlayRunPublicStatus,
 } from './run-lifecycle-policy';
+import {
+  normalizePlayConditionCounts,
+  type PlayConditionCounts,
+} from './cell-provenance';
 import type { RunStopCause } from './run-execution-state';
 
 /**
@@ -64,6 +68,7 @@ export type RunObservationNode = {
    * Run Snapshot fact `deriveNodeExecutionState` reads. Absent otherwise.
    */
   stoppedBy?: RunStopCause;
+  conditionCounts?: PlayConditionCounts;
 };
 
 export type RunObservation = {
@@ -204,6 +209,13 @@ function projectNode(node: PlayRunStreamNodeState): RunObservationNode {
     total: finite(node.progress?.total),
     settled: nonNegative(node.progress?.completed),
     failed: nonNegative(node.progress?.failed),
+    ...(normalizePlayConditionCounts(node.progress?.conditionCounts)
+      ? {
+          conditionCounts: normalizePlayConditionCounts(
+            node.progress?.conditionCounts,
+          ),
+        }
+      : {}),
     ...(node.stoppedBy ? { stoppedBy: node.stoppedBy } : {}),
   };
 }

package/dist/bundling-sources/shared_libs/play-runtime/run-snapshot-stream.ts

@@ -18,6 +18,7 @@ import {
 } from './run-lifecycle-policy';
 import type { PlayDocflowNodeIoState } from './docflow-node-io';
 import type { RunStopCause } from './run-execution-state';
+import type { PlayConditionCounts } from './cell-provenance';
 import type { PlayVisualNodeUsageSnapshot } from './live-state-contract';
 import {
   projectPlayRunActivity,
@@ -53,6 +54,7 @@ export type PlayRunStreamNodeProgress = {
   completedAt?: number | null;
   artifactTableNamespace?: string | null;
   nodeIo?: PlayDocflowNodeIoState;
+  conditionCounts?: PlayConditionCounts;
 };
 
 export type PlayRunStreamNodeState = {
@@ -250,6 +252,7 @@ function buildSnapshotFromLedger(
             completedAt: step.completedAt ?? null,
             updatedAt: step.progress.updatedAt ?? step.updatedAt ?? null,
             nodeIo: step.progress.nodeIo,
+            conditionCounts: step.progress.conditionCounts,
           }
         : null,
       startedAt: step.startedAt ?? null,