deepline 0.3.314 → 0.3.316

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

@@ -654,6 +654,8 @@ function searchParams(options: ToolSearchOptions): URLSearchParams {
 export type RunsListOptions = {
   play?: string;
   status?: string;
+  /** Mermaid node id; returns that node's latest settled input/output per run. Requires play. */
+  node?: string;
   limit?: number;
   /** Zero-based page offset. Requires `play` because status-only inventory is not paginated. */
   offset?: number;
@@ -4599,6 +4601,16 @@ export class DeeplineClient {
     if (status) {
       params.set('status', status);
     }
+    const node = options.node?.trim();
+    if (node) {
+      if (!playName)
+        throw new Error('runs.list options.node requires options.play.');
+      if (node.length > 300)
+        throw new Error(
+          'runs.list options.node must be at most 300 characters.',
+        );
+      params.set('node', node);
+    }
     if (typeof options.limit === 'number' && Number.isFinite(options.limit)) {
       params.set('limit', String(Math.max(1, Math.floor(options.limit))));
     }

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.314',
+  version: '0.3.316',
   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: {

package/dist/bundling-sources/sdk/src/runs/overview.ts

@@ -209,7 +209,11 @@ function stepExecution(
 
 /** A read-only overview of recorded run facts, never a complete row export. */
 export function buildRunOverview(status: PlayStatus, fullStatus?: PlayStatus) {
-  const pkg = status.package;
+  // Full inspection can observe a later lifecycle transition than the compact
+  // read. Present its package and status together; older full servers without
+  // a package retain the existing compact inspection path.
+  const inspectedStatus = fullStatus?.package ? fullStatus : status;
+  const pkg = inspectedStatus.package;
   if (!pkg) {
     throw new Error(
       'This server did not return a run package; use runs get --full --json.',
@@ -218,7 +222,10 @@ export function buildRunOverview(status: PlayStatus, fullStatus?: PlayStatus) {
   const outputs = Object.entries(pkg.outputs);
   const resultPackage = fullStatus?.package?.resultState
     ? fullStatus.package
-    : pkg;
+    : (status.package ?? pkg);
+  // The CLI requests this log window with its compact read; full inspection
+  // may omit that independent query option.
+  const failedLogs = inspectedStatus.failedLogs ?? status.failedLogs;
   const warnings = [...(pkg.warnings ?? [])];
   const { outcome: _outcome, ...run } = pkg.run;
   const steps = pkg.steps.map((step) => {
@@ -373,13 +380,13 @@ export function buildRunOverview(status: PlayStatus, fullStatus?: PlayStatus) {
   return {
     schemaVersion: pkg.schemaVersion,
     kind: 'run_overview',
-    ...((status.runStatus ?? pkg.runStatus)
-      ? { runStatus: status.runStatus ?? pkg.runStatus }
+    ...((inspectedStatus.runStatus ?? pkg.runStatus)
+      ? { runStatus: inspectedStatus.runStatus ?? pkg.runStatus }
       : {}),
     run: {
       ...run,
-      ...(status.revisionId && !run.revisionId
-        ? { revisionId: status.revisionId }
+      ...(inspectedStatus.revisionId && !run.revisionId
+        ? { revisionId: inspectedStatus.revisionId }
         : {}),
     },
     steps,
@@ -406,23 +413,23 @@ export function buildRunOverview(status: PlayStatus, fullStatus?: PlayStatus) {
     },
     errorDetails: {
       coverage: 'unknown',
-      reported: record(pkg)?.errors ?? record(status)?.errors ?? [],
+      reported: record(pkg)?.errors ?? record(inspectedStatus)?.errors ?? [],
       ...(pkg.run.error ? { run: pkg.run.error } : {}),
       steps: steps
         .filter((step) => step.error)
         .map((step) => ({ stepId: step.id, message: step.error })),
       ...(pkg.next?.logs ? { getMore: 'actions.getLogsCmd' } : {}),
     },
-    rowOutcomes: status.rowOutcomes,
+    rowOutcomes: inspectedStatus.rowOutcomes ?? pkg.rowOutcomes,
     warnings,
-    ...(status.failedLogs ? { failedLogs: status.failedLogs } : {}),
+    ...(failedLogs ? { failedLogs } : {}),
     datasets,
     ...(Object.hasOwn(resultPackage, 'result')
       ? { result: resultPackage.result }
       : {}),
     resultState: resultPackage.resultState ?? 'unavailable',
     actions: {
-      ...lifecycleActions(status, pkg.run.id, pkg.run.status),
+      ...lifecycleActions(inspectedStatus, pkg.run.id, pkg.run.status),
       ...actions(pkg.next, {
         inspect: 'getRunCmd',
         full: 'getFullRunCmd',

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

@@ -793,11 +793,8 @@ export type PlayRunDatasetActions = {
 };
 
 /**
- * Compact canonical package for an inspected play run.
- *
- * This object is designed for SDK/CLI/API consumers that need stable run
- * metadata, output handles, and follow-up actions without reading dashboard
- * internals.
+ * Compact canonical run package for SDK/CLI consumers: stable metadata,
+ * output handles and follow-up actions without dashboard internals.
  */
 export interface PlayRunPackage {
   /** Package schema version. */
@@ -818,6 +815,8 @@ export interface PlayRunPackage {
   overview?: RunLifecycleStatus;
   /** Optional bounded live evidence from the existing run status projection. */
   runStatus?: RunGetStatus;
+  /** Terminal scalar row outcomes shared with full status and watch snapshots. */
+  rowOutcomes?: PlayStatus['rowOutcomes'];
   /** Run identity, status, timing, and dashboard metadata. */
   run: {
     id: string;
@@ -969,6 +968,8 @@ export interface PlayStatus {
     failedRows: number;
     totalRows: number;
     hasRowFailures: boolean;
+    /** Terminal rows omitted from this run's latest view because a newer write won. */
+    supersededRows?: number;
   };
   /** Compact typed run package returned by current run status endpoints. */
   package?: PlayRunPackage;
@@ -1314,6 +1315,16 @@ export interface PlayRunListItem {
   billingTotalCredits?: number;
   /** Configured per-run Deepline credit cap, when available. */
   billingMaxCreditsPerRun?: number | null;
+  /** Latest settled Mermaid-node invocation when `runs.list` is filtered by `node`. */
+  nodeObservation?: {
+    attempt: number;
+    status: 'completed' | 'failed';
+    inputs: Record<string, unknown> | null;
+    outputs: Record<string, unknown> | null;
+    error: string | null;
+    inputsTruncated: boolean;
+    outputsTruncated: boolean;
+  } | null;
   /** Metadata attached to the workflow. */
   memo: {
     /** Organization that owns this run. */