deepline 0.3.131 → 0.3.133

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.131',
+  version: '0.3.133',
   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/types.ts

@@ -783,6 +783,16 @@ export interface PlayStatus {
   progress?: PlayProgressStatus;
   /** Partial or final result. Available once the play returns. */
   result?: unknown;
+  /**
+   * Terminal row outcome truth. A completed run may still contain failed rows
+   * when row-level failure isolation persisted those rows for retry.
+   */
+  rowOutcomes?: {
+    completedRows: number;
+    failedRows: number;
+    totalRows: number;
+    hasRowFailures: boolean;
+  };
   /** Compact typed run package returned by current run status endpoints. */
   package?: PlayRunPackage;
   /** Compact typed output summaries, mirrored from the run package when present. */

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

@@ -9461,6 +9461,7 @@ export class PlayContextImpl implements ScalarPlayAuthoringRuntimeContext {
       totalRows: totalInputCount,
       completedRowKeys,
       pendingRowKeys,
+      failedRowsCount: 0,
       startedAt: Date.now(),
       updatedAt: Date.now(),
     });
@@ -10159,6 +10160,7 @@ export class PlayContextImpl implements ScalarPlayAuthoringRuntimeContext {
     let liveFrameSets: {
       completedRowKeys: Set<string>;
       pendingRowKeys: Set<string>;
+      failedRowsCount: number;
     } | null = null;
     let lastFrameFlushAt = 0;
     let rowsSinceFrameFlush = 0;
@@ -10181,6 +10183,10 @@ export class PlayContextImpl implements ScalarPlayAuthoringRuntimeContext {
       liveFrameSets ??= {
         completedRowKeys: new Set(existing.completedRowKeys),
         pendingRowKeys: new Set(existing.pendingRowKeys),
+        // Failure counts are explicit row outcomes, not the complement of the
+        // live key sets. The sets may be intentionally sparse for a fed map
+        // and may lag the durable row writer while a batch is in flight.
+        failedRowsCount: 0,
       };
       const { completedRowKeys, pendingRowKeys } = liveFrameSets;
       const completedBefore = completedRowKeys.size;
@@ -10211,6 +10217,7 @@ export class PlayContextImpl implements ScalarPlayAuthoringRuntimeContext {
       if (input.failedRowKey?.trim()) {
         pendingRowKeys.delete(input.failedRowKey.trim());
       }
+      liveFrameSets.failedRowsCount += Math.max(0, input.failedDelta ?? 0);
       rowsSinceFrameFlush += completedRowKeys.size - completedBefore;
 
       const isTransition =
@@ -10246,14 +10253,14 @@ export class PlayContextImpl implements ScalarPlayAuthoringRuntimeContext {
                 pendingRowsCount: pendingRowKeys.size,
                 failedRowsCount:
                   liveNumber(runtimeOptions?.progressFailedOffset, 0) +
-                  Math.max(
-                    0,
-                    items.length - completedRowKeys.size - pendingRowKeys.size,
-                  ),
+                  liveFrameSets.failedRowsCount,
               }
             : {
                 completedRowKeys: [...completedRowKeys],
                 pendingRowKeys: [...pendingRowKeys],
+                failedRowsCount:
+                  liveNumber(runtimeOptions?.progressFailedOffset, 0) +
+                  liveFrameSets.failedRowsCount,
               }),
           ...(input.activeBoundaryId !== undefined
             ? { activeBoundaryId: input.activeBoundaryId }
@@ -10271,7 +10278,7 @@ export class PlayContextImpl implements ScalarPlayAuthoringRuntimeContext {
         const failedRows = Math.max(
           0,
           liveNumber(runtimeOptions?.progressFailedOffset, 0) +
-            (items.length - completedRowKeys.size - pendingRowKeys.size),
+            liveFrameSets.failedRowsCount,
         );
         this.emitExecutionEvent({
           type: progressEventType,
@@ -10616,7 +10623,7 @@ export class PlayContextImpl implements ScalarPlayAuthoringRuntimeContext {
                 rowKey,
                 normalizedTableNamespace,
               );
-              updateMapFrameProgress({ failedRowKey: rowKey });
+              updateMapFrameProgress({ failedDelta: 1, failedRowKey: rowKey });
             });
             return FAILED_ROW;
           } finally {
@@ -10799,6 +10806,7 @@ export class PlayContextImpl implements ScalarPlayAuthoringRuntimeContext {
         }
         const fieldName = rowContext.getStore()?.fieldName;
         updateMapFrameProgress({
+          failedDelta: 1,
           status: 'failed',
           emitEventType: 'map.failed',
         });

package/dist/bundling-sources/shared_libs/play-runtime/map-execution-frame.ts

@@ -39,6 +39,7 @@ export class MapExecutionFrameStore {
     totalRows: number;
     completedRowKeys: readonly string[];
     pendingRowKeys: readonly string[];
+    failedRows?: number;
   }): void {
     const now = Date.now();
     this.set({
@@ -50,6 +51,7 @@ export class MapExecutionFrameStore {
       totalRows: input.totalRows,
       completedRowKeys: [...input.completedRowKeys],
       pendingRowKeys: [...input.pendingRowKeys],
+      failedRowsCount: Math.max(0, input.failedRows ?? 0),
       startedAt: now,
       updatedAt: now,
     });
@@ -72,6 +74,7 @@ export class MapExecutionFrameStore {
     status?: MapExecutionFrame['status'];
     completedRowKey?: string | null;
     pendingRowKey?: string | null;
+    failedDelta?: number;
     activeBoundaryId?: string | null;
     emitEventType?: PlayExecutionEvent['type'];
   }): void {
@@ -91,11 +94,16 @@ export class MapExecutionFrameStore {
     if (input.pendingRowKey?.trim()) {
       pendingRowKeys.add(input.pendingRowKey.trim());
     }
+    const failedRowsCount = Math.max(
+      0,
+      (existing.failedRowsCount ?? 0) + Math.max(0, input.failedDelta ?? 0),
+    );
     const nextFrame: MapExecutionFrame = {
       ...existing,
       status: input.status ?? existing.status,
       completedRowKeys: [...completedRowKeys],
       pendingRowKeys: [...pendingRowKeys],
+      failedRowsCount,
       ...(input.activeBoundaryId !== undefined
         ? { activeBoundaryId: input.activeBoundaryId }
         : {}),
@@ -113,12 +121,7 @@ export class MapExecutionFrameStore {
         logicalNamespace: input.scope.logicalNamespace,
         artifactTableNamespace: input.scope.artifactTableNamespace,
         completedRows: nextFrame.completedRowKeys.length,
-        failedRows: Math.max(
-          0,
-          input.totalRows -
-            nextFrame.completedRowKeys.length -
-            nextFrame.pendingRowKeys.length,
-        ),
+        failedRows: failedRowsCount,
         totalRows: input.totalRows,
         at: Date.now(),
       } as PlayExecutionEvent);

package/dist/cli/index.js

@@ -3068,7 +3068,7 @@ var 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.131",
+  version: "0.3.133",
   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: {
     updatePreferences: 1
@@ -14866,6 +14866,15 @@ function customerDbColumnNames(result) {
 function errorMessage(value) {
   return value instanceof Error ? value.message : String(value ?? "");
 }
+function resolveDbQuerySql(rawSql, readFile7 = (path) => (0, import_node_fs8.readFileSync)(path, "utf8")) {
+  const value = rawSql.trim();
+  if (!value.startsWith("@")) return value;
+  const filePath = value.slice(1).trim();
+  if (!filePath) {
+    throw new Error("--sql @file requires a file path after `@`.");
+  }
+  return readFile7((0, import_node_path9.resolve)(filePath)).trim();
+}
 function collectErrorText(value) {
   if (!value || typeof value !== "object" || Array.isArray(value)) {
     return errorMessage(value);
@@ -14964,13 +14973,24 @@ function dbQueryExportEnvelope(input2) {
 }
 async function handleDbQuery(args) {
   const sqlIndex = args.indexOf("--sql");
-  const sql = sqlIndex >= 0 ? args[sqlIndex + 1]?.trim() : "";
-  if (!sql) {
+  const rawSql = sqlIndex >= 0 ? args[sqlIndex + 1]?.trim() : "";
+  if (!rawSql) {
     console.error(
-      'Usage: deepline db query --sql "select * from table limit 20" [--max-rows N] [--json]'
+      'Usage: deepline db query --sql "select * from table limit 20"|@query.sql [--max-rows N] [--json]'
     );
     return 1;
   }
+  let sql;
+  try {
+    sql = resolveDbQuerySql(rawSql);
+  } catch (error) {
+    console.error(errorMessage(error));
+    return 1;
+  }
+  if (!sql) {
+    console.error("SQL file is empty.");
+    return 1;
+  }
   const maxRowsIndex = args.indexOf("--max-rows");
   const maxRows = maxRowsIndex >= 0 && args[maxRowsIndex + 1] ? parseMaxRows(args[maxRowsIndex + 1]) : void 0;
   const formatIndex = args.indexOf("--format");
@@ -15136,8 +15156,9 @@ function registerDbCommands(program) {
   const db = program.command("db").description("Query the tenant customer database.").addHelpText(
     "after",
     `
-Notes:
+  Notes:
   Agent-safe SQL for the active workspace customer database.
+  Use --sql @query.sql for multiline or shell-sensitive SQL (portable across macOS and Windows).
   Reads: SELECT, EXPLAIN, and read-only WITH can inspect permitted schemas.
   Writes: CREATE TABLE, INSERT, UPDATE, DELETE, ALTER, DROP, TRUNCATE, and
   CREATE INDEX must target schema-qualified storage tables, such as storage.agent_notes.
@@ -15150,6 +15171,7 @@ Examples:
   deepline db query --sql "select domain, name from companies limit 20" --json
   deepline db query --sql "create table if not exists storage.agent_notes (id text primary key, note text not null)"
   deepline db query --sql "select * from contacts" --max-rows 100 --json
+  deepline db query --sql @query.sql --json
   deepline db query --sql "select * from contacts limit 20" --format csv --out contacts.csv
   deepline db query --sql "select domain, name from companies limit 20" --format markdown
 `
@@ -15157,8 +15179,8 @@ Examples:
   db.command("query").description("Run SQL against the tenant customer database.").addHelpText(
     "after",
     `
-Notes:
-  Requires --sql. Output is a compact table in a terminal and raw JSON with
+  Notes:
+  Requires --sql (inline SQL or @file.sql). Output is a compact table in a terminal and raw JSON with
   --json or when stdout is piped. The active auth workspace determines scope.
   Read permitted schemas with SELECT, EXPLAIN, or read-only WITH.
   Write only to schema-qualified storage tables. For example, use
@@ -15171,6 +15193,7 @@ Examples:
   deepline db query --sql "select domain, name from companies limit 20" --json
   deepline db query --sql "create table if not exists storage.agent_notes (id text primary key, note text not null)"
   deepline db query --sql "select count(*) from contacts" --json
+  deepline db query --sql @query.sql --json
   deepline db query --sql "select * from contacts limit 20" --format csv --out contacts.csv
   deepline db query --sql "select domain, name from companies limit 20" --format markdown
 `
@@ -23563,6 +23586,19 @@ function getProgressLinesFromLiveEvent(event) {
       `progress ${formatProgressLabel(record3.nodeId ?? progress.artifactTableNamespace)}: ${counts}${messageSuffix}`
     );
   }
+  const rowOutcomes = readRowOutcomeSummary({
+    rowOutcomes: payload.rowOutcomes
+  });
+  if (rowOutcomes?.hasRowFailures) {
+    const counts = formatProgressCounts({
+      completed: rowOutcomes.completedRows,
+      total: rowOutcomes.totalRows,
+      failed: rowOutcomes.failedRows
+    });
+    if (counts) {
+      lines.push(`progress run outcomes: ${counts}`);
+    }
+  }
   return lines;
 }
 function shouldPrintPlayProgressLine(input2) {
@@ -24427,6 +24463,7 @@ function collectDatasetHandleLines(value, path = "result") {
   return lines;
 }
 function buildRunWarnings(status, rowsInfo) {
+  const rowOutcomes = readRowOutcomeSummary(status);
   const result = readRecord(status.result);
   const metadata = readRecord(result?._metadata);
   const outputWarnings = Array.isArray(metadata?.outputWarnings) ? metadata.outputWarnings.map((warning) => readRecord(warning)).filter((warning) => {
@@ -24435,16 +24472,24 @@ function buildRunWarnings(status, rowsInfo) {
   }).map((warning) => warning?.message).filter(
     (message) => typeof message === "string" && message.trim().length > 0
   ).slice(0, 16) : [];
+  const rowOutcomeWarnings = rowOutcomes?.hasRowFailures ? [
+    `${status.status === "completed" ? "Run completed" : "Run ended"} with ${formatInteger(rowOutcomes.failedRows)} failed row(s); inspect the persisted failed rows before treating the output as complete.`
+  ] : [];
   if (status.status === "completed" && rowsInfo?.totalRows === 0) {
-    return ["Run completed with 0 output rows.", ...outputWarnings];
+    return [
+      ...rowOutcomeWarnings,
+      "Run completed with 0 output rows.",
+      ...outputWarnings
+    ];
   }
   if (rowsInfo && !rowsInfo.complete) {
     return [
+      ...rowOutcomeWarnings,
       `Run output is partial: showing ${rowsInfo.rows.length} preview row(s) of ${rowsInfo.totalRows}.`,
       ...outputWarnings
     ];
   }
-  return outputWarnings;
+  return [...rowOutcomeWarnings, ...outputWarnings];
 }
 function buildRunNextCommands(status) {
   const runId = status.runId?.trim();
@@ -24480,6 +24525,23 @@ function getNumericField(value, key) {
   const field = getRecordField(value, key);
   return typeof field === "number" && Number.isFinite(field) ? field : null;
 }
+function readRowOutcomeSummary(value) {
+  const record3 = getRecordField(value, "rowOutcomes");
+  if (!record3) return null;
+  const completedRows = getNumericField(record3, "completedRows");
+  const failedRows = getNumericField(record3, "failedRows");
+  const totalRows = getNumericField(record3, "totalRows");
+  if (completedRows === null || failedRows === null || totalRows === null) {
+    return null;
+  }
+  const explicitHasFailures = getRecordField(record3, "hasRowFailures");
+  return {
+    completedRows,
+    failedRows,
+    totalRows,
+    hasRowFailures: typeof explicitHasFailures === "boolean" ? explicitHasFailures : failedRows > 0
+  };
+}
 function getStringField(value, key) {
   const field = getRecordField(value, key);
   return typeof field === "string" && field.trim() ? field : null;
@@ -24693,9 +24755,10 @@ function normalizeRunStatusForEnvelope(status) {
 }
 function normalizeProgressForEnvelope(status, rowsInfo) {
   const progress = status.progress;
-  const total = getNumericField(progress, "totalRows") ?? getNumericField(progress, "total") ?? rowsInfo?.totalRows ?? null;
-  const failed = getNumericField(progress, "failed") ?? getNumericField(progress, "failedRows") ?? null;
-  const completed = getNumericField(progress, "completed") ?? getNumericField(progress, "completedRows") ?? (status.status === "completed" ? total : null);
+  const rowOutcomes = readRowOutcomeSummary(status);
+  const total = rowOutcomes?.totalRows ?? getNumericField(progress, "totalRows") ?? getNumericField(progress, "total") ?? rowsInfo?.totalRows ?? null;
+  const failed = rowOutcomes?.failedRows ?? getNumericField(progress, "failed") ?? getNumericField(progress, "failedRows") ?? null;
+  const completed = rowOutcomes?.completedRows ?? getNumericField(progress, "completed") ?? getNumericField(progress, "completedRows") ?? (status.status === "completed" ? total : null);
   const pending = getNumericField(progress, "pending") ?? (typeof total === "number" && typeof completed === "number" && typeof failed === "number" ? Math.max(0, total - completed - failed) : null);
   return {
     total,
@@ -24824,9 +24887,22 @@ function compactPlayStatus(status) {
     const packagedError = typeof packagedRun?.error === "string" ? packagedRun.error : null;
     const error2 = selectRunErrorForDisplay(status) ?? (typeof status.error === "string" ? String(status.error) : packagedError);
     const compactError = error2 ? compactRunErrorForEnvelope(error2, status.runId) : null;
+    const rowOutcomes2 = readRowOutcomeSummary(status);
+    const packagedWithRowOutcomes = rowOutcomes2 ? {
+      ...packaged,
+      rowOutcomes: rowOutcomes2,
+      warnings: [
+        ...Array.isArray(packaged.warnings) ? packaged.warnings.filter(
+          (warning) => typeof warning === "string"
+        ) : [],
+        ...rowOutcomes2.hasRowFailures ? [
+          `${status.status === "completed" ? "Run completed" : "Run ended"} with ${formatInteger(rowOutcomes2.failedRows)} failed row(s); inspect the persisted failed rows before treating the output as complete.`
+        ] : []
+      ]
+    } : packaged;
     if (!error2) {
       return status.failedLogs || status.rerunCommand ? {
-        ...packaged,
+        ...packagedWithRowOutcomes,
         ...status.failedLogs ? { failedLogs: status.failedLogs } : {},
         next: {
           ...readRecord(packaged.next) ?? {},
@@ -24835,11 +24911,11 @@ function compactPlayStatus(status) {
           } : {},
           ...status.rerunCommand ? { run: status.rerunCommand } : {}
         }
-      } : packaged;
+      } : packagedWithRowOutcomes;
     }
     const run = packagedRun;
     return {
-      ...packaged,
+      ...packagedWithRowOutcomes,
       ...status.failedLogs ? { failedLogs: status.failedLogs } : {},
       ...status.failedLogs ? {
         next: {
@@ -24868,6 +24944,7 @@ function compactPlayStatus(status) {
   ) : null;
   const error = selectRunErrorForDisplay(status) ?? (typeof status.error === "string" ? String(status.error) : null);
   const displayError = formatPlayErrorForDisplay(status, error);
+  const rowOutcomes = readRowOutcomeSummary(status);
   return {
     runId: status.runId,
     apiVersion: status.apiVersion ?? 1,
@@ -24877,6 +24954,7 @@ function compactPlayStatus(status) {
     status: status.status,
     run: normalizeRunStatusForEnvelope(status),
     progress: normalizeProgressForEnvelope(status, rowsInfo),
+    ...rowOutcomes ? { rowOutcomes } : {},
     steps: normalizeStepsForEnvelope(status),
     errors: normalizeErrorsForEnvelope(status, error),
     logs: normalizeLogsForEnvelope(status),

package/dist/cli/index.mjs

@@ -3063,7 +3063,7 @@ var 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.131",
+  version: "0.3.133",
   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: {
     updatePreferences: 1
@@ -14800,7 +14800,7 @@ Examples:
 }
 
 // src/cli/commands/db.ts
-import { writeFileSync as writeFileSync8 } from "fs";
+import { readFileSync as readFileSync7, writeFileSync as writeFileSync8 } from "fs";
 import { resolve as resolve6 } from "path";
 var CUSTOMER_DB_QUERY_FORMATS = /* @__PURE__ */ new Set(["table", "json", "csv", "markdown"]);
 var CUSTOMER_DB_QUERY_MAX_ROWS = 1e3;
@@ -14881,6 +14881,15 @@ function customerDbColumnNames(result) {
 function errorMessage(value) {
   return value instanceof Error ? value.message : String(value ?? "");
 }
+function resolveDbQuerySql(rawSql, readFile7 = (path) => readFileSync7(path, "utf8")) {
+  const value = rawSql.trim();
+  if (!value.startsWith("@")) return value;
+  const filePath = value.slice(1).trim();
+  if (!filePath) {
+    throw new Error("--sql @file requires a file path after `@`.");
+  }
+  return readFile7(resolve6(filePath)).trim();
+}
 function collectErrorText(value) {
   if (!value || typeof value !== "object" || Array.isArray(value)) {
     return errorMessage(value);
@@ -14979,13 +14988,24 @@ function dbQueryExportEnvelope(input2) {
 }
 async function handleDbQuery(args) {
   const sqlIndex = args.indexOf("--sql");
-  const sql = sqlIndex >= 0 ? args[sqlIndex + 1]?.trim() : "";
-  if (!sql) {
+  const rawSql = sqlIndex >= 0 ? args[sqlIndex + 1]?.trim() : "";
+  if (!rawSql) {
     console.error(
-      'Usage: deepline db query --sql "select * from table limit 20" [--max-rows N] [--json]'
+      'Usage: deepline db query --sql "select * from table limit 20"|@query.sql [--max-rows N] [--json]'
     );
     return 1;
   }
+  let sql;
+  try {
+    sql = resolveDbQuerySql(rawSql);
+  } catch (error) {
+    console.error(errorMessage(error));
+    return 1;
+  }
+  if (!sql) {
+    console.error("SQL file is empty.");
+    return 1;
+  }
   const maxRowsIndex = args.indexOf("--max-rows");
   const maxRows = maxRowsIndex >= 0 && args[maxRowsIndex + 1] ? parseMaxRows(args[maxRowsIndex + 1]) : void 0;
   const formatIndex = args.indexOf("--format");
@@ -15151,8 +15171,9 @@ function registerDbCommands(program) {
   const db = program.command("db").description("Query the tenant customer database.").addHelpText(
     "after",
     `
-Notes:
+  Notes:
   Agent-safe SQL for the active workspace customer database.
+  Use --sql @query.sql for multiline or shell-sensitive SQL (portable across macOS and Windows).
   Reads: SELECT, EXPLAIN, and read-only WITH can inspect permitted schemas.
   Writes: CREATE TABLE, INSERT, UPDATE, DELETE, ALTER, DROP, TRUNCATE, and
   CREATE INDEX must target schema-qualified storage tables, such as storage.agent_notes.
@@ -15165,6 +15186,7 @@ Examples:
   deepline db query --sql "select domain, name from companies limit 20" --json
   deepline db query --sql "create table if not exists storage.agent_notes (id text primary key, note text not null)"
   deepline db query --sql "select * from contacts" --max-rows 100 --json
+  deepline db query --sql @query.sql --json
   deepline db query --sql "select * from contacts limit 20" --format csv --out contacts.csv
   deepline db query --sql "select domain, name from companies limit 20" --format markdown
 `
@@ -15172,8 +15194,8 @@ Examples:
   db.command("query").description("Run SQL against the tenant customer database.").addHelpText(
     "after",
     `
-Notes:
-  Requires --sql. Output is a compact table in a terminal and raw JSON with
+  Notes:
+  Requires --sql (inline SQL or @file.sql). Output is a compact table in a terminal and raw JSON with
   --json or when stdout is piped. The active auth workspace determines scope.
   Read permitted schemas with SELECT, EXPLAIN, or read-only WITH.
   Write only to schema-qualified storage tables. For example, use
@@ -15186,6 +15208,7 @@ Examples:
   deepline db query --sql "select domain, name from companies limit 20" --json
   deepline db query --sql "create table if not exists storage.agent_notes (id text primary key, note text not null)"
   deepline db query --sql "select count(*) from contacts" --json
+  deepline db query --sql @query.sql --json
   deepline db query --sql "select * from contacts limit 20" --format csv --out contacts.csv
   deepline db query --sql "select domain, name from companies limit 20" --format markdown
 `
@@ -15252,7 +15275,7 @@ import { createHash as createHash4, randomUUID as randomUUID4 } from "crypto";
 import {
   existsSync as existsSync9,
   mkdirSync as mkdirSync7,
-  readFileSync as readFileSync8,
+  readFileSync as readFileSync9,
   readdirSync as readdirSync2,
   realpathSync as realpathSync2,
   statSync as statSync3,
@@ -16988,7 +17011,7 @@ import { realpath as realpath2 } from "fs/promises";
 
 // ../plays/bundling/index.ts
 import { createHash as createHash2 } from "crypto";
-import { existsSync as existsSync7, readFileSync as readFileSync7 } from "fs";
+import { existsSync as existsSync7, readFileSync as readFileSync8 } from "fs";
 import { mkdir as mkdir3, readFile, realpath, stat, writeFile as writeFile3 } from "fs/promises";
 import { tmpdir as tmpdir2 } from "os";
 import {
@@ -22566,7 +22589,7 @@ function materializeRemotePlaySource(input2) {
       if (!existsSync9(outputPath2)) {
         writeFileSync10(outputPath2, sourceCode, "utf-8");
         created += 1;
-      } else if (readFileSync8(outputPath2, "utf-8") !== sourceCode) {
+      } else if (readFileSync9(outputPath2, "utf-8") !== sourceCode) {
         writeFileSync10(outputPath2, sourceCode, "utf-8");
         updated += 1;
       }
@@ -22580,7 +22603,7 @@ function materializeRemotePlaySource(input2) {
   }
   const outputPath = input2.outPath ?? defaultMaterializedPlayPath(input2.playName);
   if (existsSync9(outputPath)) {
-    const existingSource = readFileSync8(outputPath, "utf-8");
+    const existingSource = readFileSync9(outputPath, "utf-8");
     if (existingSource === entrySource) {
       return { path: outputPath, status: "unchanged", created: false };
     }
@@ -22661,7 +22684,7 @@ function parsePositiveInteger3(value, flagName) {
   return parsed;
 }
 function parseJsonInput(raw) {
-  const source = raw.startsWith("@") ? readFileSync8(resolve12(raw.slice(1)), "utf-8") : raw;
+  const source = raw.startsWith("@") ? readFileSync9(resolve12(raw.slice(1)), "utf-8") : raw;
   const parsed = JSON.parse(source);
   if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) {
     throw new Error("--input must be a JSON object.");
@@ -22891,7 +22914,7 @@ function preflightLocalFileInputs(runtimeInput) {
 function preflightCsvDataInput(ref, absolutePath) {
   let content;
   try {
-    content = readFileSync8(absolutePath, "utf-8");
+    content = readFileSync9(absolutePath, "utf-8");
   } catch (error) {
     throw new DeeplineError(
       `Input ${ref.inputPath} CSV ${ref.value} is not readable: ${error instanceof Error ? error.message : String(error)}. No run was created.`,
@@ -23006,7 +23029,7 @@ async function stageFileInputArgs(input2) {
   };
 }
 function stageFile(logicalPath, absolutePath) {
-  const buffer = readFileSync8(absolutePath);
+  const buffer = readFileSync9(absolutePath);
   return {
     logicalPath,
     contentBase64: buffer.toString("base64"),
@@ -23635,6 +23658,19 @@ function getProgressLinesFromLiveEvent(event) {
       `progress ${formatProgressLabel(record3.nodeId ?? progress.artifactTableNamespace)}: ${counts}${messageSuffix}`
     );
   }
+  const rowOutcomes = readRowOutcomeSummary({
+    rowOutcomes: payload.rowOutcomes
+  });
+  if (rowOutcomes?.hasRowFailures) {
+    const counts = formatProgressCounts({
+      completed: rowOutcomes.completedRows,
+      total: rowOutcomes.totalRows,
+      failed: rowOutcomes.failedRows
+    });
+    if (counts) {
+      lines.push(`progress run outcomes: ${counts}`);
+    }
+  }
   return lines;
 }
 function shouldPrintPlayProgressLine(input2) {
@@ -24499,6 +24535,7 @@ function collectDatasetHandleLines(value, path = "result") {
   return lines;
 }
 function buildRunWarnings(status, rowsInfo) {
+  const rowOutcomes = readRowOutcomeSummary(status);
   const result = readRecord(status.result);
   const metadata = readRecord(result?._metadata);
   const outputWarnings = Array.isArray(metadata?.outputWarnings) ? metadata.outputWarnings.map((warning) => readRecord(warning)).filter((warning) => {
@@ -24507,16 +24544,24 @@ function buildRunWarnings(status, rowsInfo) {
   }).map((warning) => warning?.message).filter(
     (message) => typeof message === "string" && message.trim().length > 0
   ).slice(0, 16) : [];
+  const rowOutcomeWarnings = rowOutcomes?.hasRowFailures ? [
+    `${status.status === "completed" ? "Run completed" : "Run ended"} with ${formatInteger(rowOutcomes.failedRows)} failed row(s); inspect the persisted failed rows before treating the output as complete.`
+  ] : [];
   if (status.status === "completed" && rowsInfo?.totalRows === 0) {
-    return ["Run completed with 0 output rows.", ...outputWarnings];
+    return [
+      ...rowOutcomeWarnings,
+      "Run completed with 0 output rows.",
+      ...outputWarnings
+    ];
   }
   if (rowsInfo && !rowsInfo.complete) {
     return [
+      ...rowOutcomeWarnings,
       `Run output is partial: showing ${rowsInfo.rows.length} preview row(s) of ${rowsInfo.totalRows}.`,
       ...outputWarnings
     ];
   }
-  return outputWarnings;
+  return [...rowOutcomeWarnings, ...outputWarnings];
 }
 function buildRunNextCommands(status) {
   const runId = status.runId?.trim();
@@ -24552,6 +24597,23 @@ function getNumericField(value, key) {
   const field = getRecordField(value, key);
   return typeof field === "number" && Number.isFinite(field) ? field : null;
 }
+function readRowOutcomeSummary(value) {
+  const record3 = getRecordField(value, "rowOutcomes");
+  if (!record3) return null;
+  const completedRows = getNumericField(record3, "completedRows");
+  const failedRows = getNumericField(record3, "failedRows");
+  const totalRows = getNumericField(record3, "totalRows");
+  if (completedRows === null || failedRows === null || totalRows === null) {
+    return null;
+  }
+  const explicitHasFailures = getRecordField(record3, "hasRowFailures");
+  return {
+    completedRows,
+    failedRows,
+    totalRows,
+    hasRowFailures: typeof explicitHasFailures === "boolean" ? explicitHasFailures : failedRows > 0
+  };
+}
 function getStringField(value, key) {
   const field = getRecordField(value, key);
   return typeof field === "string" && field.trim() ? field : null;
@@ -24765,9 +24827,10 @@ function normalizeRunStatusForEnvelope(status) {
 }
 function normalizeProgressForEnvelope(status, rowsInfo) {
   const progress = status.progress;
-  const total = getNumericField(progress, "totalRows") ?? getNumericField(progress, "total") ?? rowsInfo?.totalRows ?? null;
-  const failed = getNumericField(progress, "failed") ?? getNumericField(progress, "failedRows") ?? null;
-  const completed = getNumericField(progress, "completed") ?? getNumericField(progress, "completedRows") ?? (status.status === "completed" ? total : null);
+  const rowOutcomes = readRowOutcomeSummary(status);
+  const total = rowOutcomes?.totalRows ?? getNumericField(progress, "totalRows") ?? getNumericField(progress, "total") ?? rowsInfo?.totalRows ?? null;
+  const failed = rowOutcomes?.failedRows ?? getNumericField(progress, "failed") ?? getNumericField(progress, "failedRows") ?? null;
+  const completed = rowOutcomes?.completedRows ?? getNumericField(progress, "completed") ?? getNumericField(progress, "completedRows") ?? (status.status === "completed" ? total : null);
   const pending = getNumericField(progress, "pending") ?? (typeof total === "number" && typeof completed === "number" && typeof failed === "number" ? Math.max(0, total - completed - failed) : null);
   return {
     total,
@@ -24896,9 +24959,22 @@ function compactPlayStatus(status) {
     const packagedError = typeof packagedRun?.error === "string" ? packagedRun.error : null;
     const error2 = selectRunErrorForDisplay(status) ?? (typeof status.error === "string" ? String(status.error) : packagedError);
     const compactError = error2 ? compactRunErrorForEnvelope(error2, status.runId) : null;
+    const rowOutcomes2 = readRowOutcomeSummary(status);
+    const packagedWithRowOutcomes = rowOutcomes2 ? {
+      ...packaged,
+      rowOutcomes: rowOutcomes2,
+      warnings: [
+        ...Array.isArray(packaged.warnings) ? packaged.warnings.filter(
+          (warning) => typeof warning === "string"
+        ) : [],
+        ...rowOutcomes2.hasRowFailures ? [
+          `${status.status === "completed" ? "Run completed" : "Run ended"} with ${formatInteger(rowOutcomes2.failedRows)} failed row(s); inspect the persisted failed rows before treating the output as complete.`
+        ] : []
+      ]
+    } : packaged;
     if (!error2) {
       return status.failedLogs || status.rerunCommand ? {
-        ...packaged,
+        ...packagedWithRowOutcomes,
         ...status.failedLogs ? { failedLogs: status.failedLogs } : {},
         next: {
           ...readRecord(packaged.next) ?? {},
@@ -24907,11 +24983,11 @@ function compactPlayStatus(status) {
           } : {},
           ...status.rerunCommand ? { run: status.rerunCommand } : {}
         }
-      } : packaged;
+      } : packagedWithRowOutcomes;
     }
     const run = packagedRun;
     return {
-      ...packaged,
+      ...packagedWithRowOutcomes,
       ...status.failedLogs ? { failedLogs: status.failedLogs } : {},
       ...status.failedLogs ? {
         next: {
@@ -24940,6 +25016,7 @@ function compactPlayStatus(status) {
   ) : null;
   const error = selectRunErrorForDisplay(status) ?? (typeof status.error === "string" ? String(status.error) : null);
   const displayError = formatPlayErrorForDisplay(status, error);
+  const rowOutcomes = readRowOutcomeSummary(status);
   return {
     runId: status.runId,
     apiVersion: status.apiVersion ?? 1,
@@ -24949,6 +25026,7 @@ function compactPlayStatus(status) {
     status: status.status,
     run: normalizeRunStatusForEnvelope(status),
     progress: normalizeProgressForEnvelope(status, rowsInfo),
+    ...rowOutcomes ? { rowOutcomes } : {},
     steps: normalizeStepsForEnvelope(status),
     errors: normalizeErrorsForEnvelope(status, error),
     logs: normalizeLogsForEnvelope(status),
@@ -26997,7 +27075,7 @@ async function handlePlayCheck(args) {
     }
   }
   const absolutePlayPath = resolve12(options.target);
-  const sourceCode = readFileSync8(absolutePlayPath, "utf-8");
+  const sourceCode = readFileSync9(absolutePlayPath, "utf-8");
   const exportNames = resolvePlayCheckExportNames(sourceCode);
   const outcomes = [];
   for (const exportName of exportNames) {
@@ -27243,7 +27321,7 @@ async function handleFileBackedRun(options, hooks) {
   const sourceCode = traceCliSync(
     "cli.play_file_read_source",
     { targetKind: "file" },
-    () => readFileSync8(absolutePlayPath, "utf-8")
+    () => readFileSync9(absolutePlayPath, "utf-8")
   );
   const runtimeInput = options.input ? { ...options.input } : {};
   try {
@@ -28435,7 +28513,7 @@ async function handlePlayGet(args) {
     );
     return 2;
   }
-  const playName = isFileTarget(target) ? extractPlayName(readFileSync8(resolve12(target), "utf-8"), resolve12(target)) : parseReferencedPlayTarget2(target).playName;
+  const playName = isFileTarget(target) ? extractPlayName(readFileSync9(resolve12(target), "utf-8"), resolve12(target)) : parseReferencedPlayTarget2(target).playName;
   const includeSource = sourceOutput || outPath !== null;
   const detail = isFileTarget(target) ? await client2.getPlay(
     playName,
@@ -28940,7 +29018,7 @@ async function handlePlayDescribe(args) {
     const definedName = isFileTarget(playName) ? (() => {
       try {
         return extractPlayName(
-          readFileSync8(resolve12(playName), "utf-8"),
+          readFileSync9(resolve12(playName), "utf-8"),
           playName
         );
       } catch {
@@ -35861,7 +35939,7 @@ function registerEnrichCommand(program) {
 
 // src/cli/commands/feedback.ts
 import { Option as Option3 } from "commander";
-import { readFileSync as readFileSync9 } from "fs";
+import { readFileSync as readFileSync10 } from "fs";
 async function handleFeedback(text, options) {
   const message = resolveFeedbackText(text, options.file);
   const { http } = getAuthedHttpClient();
@@ -35885,7 +35963,7 @@ async function handleFeedback(text, options) {
     { json: options.json }
   );
 }
-function resolveFeedbackText(text, file, readFile7 = (path) => readFileSync9(path, "utf8")) {
+function resolveFeedbackText(text, file, readFile7 = (path) => readFileSync10(path, "utf8")) {
   if (text !== void 0 && file !== void 0) {
     throw new Error(
       "Pass feedback text positionally or with --file, not both."
@@ -35956,7 +36034,7 @@ import {
   existsSync as existsSync10,
   mkdirSync as mkdirSync8,
   readdirSync as readdirSync3,
-  readFileSync as readFileSync10,
+  readFileSync as readFileSync11,
   statSync as statSync4,
   writeFileSync as writeFileSync11
 } from "fs";
@@ -36094,7 +36172,7 @@ function sessionIdFromCodexFilePath(filePath) {
 }
 function readCodexSessionId(filePath) {
   try {
-    for (const line of normalizedJsonLines(readFileSync10(filePath)).slice(
+    for (const line of normalizedJsonLines(readFileSync11(filePath)).slice(
       0,
       20
     )) {
@@ -36413,7 +36491,7 @@ async function handleSessionsSend(options) {
       throw new Error(`File not found: ${options.file}`);
     }
     const response2 = await uploadPayload("/api/v2/cli/send-session", {
-      file: readFileSync10(filePath).toString("base64"),
+      file: readFileSync11(filePath).toString("base64"),
       filename: basename5(filePath)
     });
     printCommandEnvelope(
@@ -36443,7 +36521,7 @@ async function handleSessionsSend(options) {
     agent: options.agent
   });
   const built = targets.map((target) => {
-    const upload = buildSessionUploadContent(readFileSync10(target.filePath));
+    const upload = buildSessionUploadContent(readFileSync11(target.filePath));
     return { ...target, ...upload };
   });
   if (built.some((session) => session.needsChunking)) {
@@ -36527,8 +36605,8 @@ function loadViewerAssets() {
       const jsPath = join15(root, "viewer.js");
       if (!existsSync10(cssPath) || !existsSync10(jsPath)) continue;
       return {
-        css: readFileSync10(cssPath, "utf8"),
-        js: readFileSync10(jsPath, "utf8")
+        css: readFileSync11(cssPath, "utf8"),
+        js: readFileSync11(jsPath, "utf8")
       };
     } catch {
       continue;
@@ -36566,7 +36644,7 @@ async function handleSessionsRender(options) {
   const sessions = targets.map((target) => ({
     label: target.label,
     events: parsePreparedEvents(
-      prepareSessionBuffer(readFileSync10(target.filePath))
+      prepareSessionBuffer(readFileSync11(target.filePath))
     )
   }));
   const { css, js } = loadViewerAssets();
@@ -36800,7 +36878,7 @@ Examples:
 
 // src/cli/commands/monitors.ts
 import { randomUUID as randomUUID6 } from "crypto";
-import { readFileSync as readFileSync11, writeFileSync as writeFileSync12 } from "fs";
+import { readFileSync as readFileSync12, writeFileSync as writeFileSync12 } from "fs";
 import { resolve as resolve15 } from "path";
 import { createInterface } from "readline/promises";
 
@@ -37664,8 +37742,8 @@ function parseJsonObjectArg(raw, argLabel) {
   return parsed;
 }
 function resolveMonitorJsonBody(input2) {
-  const readFile7 = input2.readFile ?? ((path) => readFileSync11(path, "utf-8"));
-  const readStdin = input2.readStdin ?? (() => readFileSync11(0, "utf-8"));
+  const readFile7 = input2.readFile ?? ((path) => readFileSync12(path, "utf-8"));
+  const readStdin = input2.readStdin ?? (() => readFileSync12(0, "utf-8"));
   if (input2.positional !== void 0 && input2.file !== void 0) {
     throw new MonitorsUsageError(
       `Pass exactly one source for ${input2.argLabel}: the positional JSON or --file, not both.`
@@ -38328,7 +38406,7 @@ function monitorJobIdempotencyKey(operation, supplied) {
 function readMonitorDefinitionsJsonFile(file) {
   let raw;
   try {
-    raw = file === "-" ? readFileSync11(0, "utf8") : readFileSync11(file, "utf8");
+    raw = file === "-" ? readFileSync12(0, "utf8") : readFileSync12(file, "utf8");
   } catch (error) {
     throw new MonitorsUsageError(
       `Could not read --file ${file}: ${error instanceof Error ? error.message : String(error)}`
@@ -39843,7 +39921,7 @@ async function handleMonitorBatchDeploy(options) {
   }
   let manifestNdjson;
   try {
-    manifestNdjson = readFileSync11(resolve15(options.file), "utf8");
+    manifestNdjson = readFileSync12(resolve15(options.file), "utf8");
   } catch (error) {
     throw new MonitorsUsageError(
       `Could not read monitor batch manifest '${options.file}': ${error instanceof Error ? error.message : String(error)}`
@@ -40746,7 +40824,7 @@ import { createHash as createHash5, randomUUID as randomUUID7 } from "crypto";
 import {
   existsSync as existsSync11,
   mkdirSync as mkdirSync9,
-  readFileSync as readFileSync12,
+  readFileSync as readFileSync13,
   unlinkSync,
   writeFileSync as writeFileSync13
 } from "fs";
@@ -40758,7 +40836,7 @@ function pendingOrgCreatePath(baseUrl, accountId, sourceOrgId, name) {
 function readPendingOrgCreate(path, accountId, sourceOrgId, name) {
   let value;
   try {
-    value = JSON.parse(readFileSync12(path, "utf8"));
+    value = JSON.parse(readFileSync13(path, "utf8"));
   } catch (error) {
     throw new Error(
       `Cannot resume the pending workspace creation recorded at ${path}: ${error instanceof Error ? error.message : String(error)}`
@@ -42015,7 +42093,7 @@ import {
   existsSync as existsSync15,
   lstatSync as lstatSync2,
   mkdirSync as mkdirSync12,
-  readFileSync as readFileSync16,
+  readFileSync as readFileSync17,
   realpathSync as realpathSync4,
   writeFileSync as writeFileSync16
 } from "fs";
@@ -42026,7 +42104,7 @@ import { dirname as dirname16, join as join20, resolve as resolve17 } from "path
 import {
   existsSync as existsSync12,
   lstatSync,
-  readFileSync as readFileSync13,
+  readFileSync as readFileSync14,
   realpathSync as realpathSync3,
   rmSync as rmSync4
 } from "fs";
@@ -42042,7 +42120,7 @@ var nodeFileSystem = {
   },
   read(path) {
     try {
-      return readFileSync13(path, "utf8");
+      return readFileSync14(path, "utf8");
     } catch {
       return "";
     }
@@ -42152,7 +42230,7 @@ function isOwnedInstallerCommandPath(input2) {
 
 // src/cli/commands/skills.ts
 import { spawn as spawn3 } from "child_process";
-import { existsSync as existsSync14, mkdirSync as mkdirSync11, readFileSync as readFileSync15, writeFileSync as writeFileSync15 } from "fs";
+import { existsSync as existsSync14, mkdirSync as mkdirSync11, readFileSync as readFileSync16, writeFileSync as writeFileSync15 } from "fs";
 import { homedir as homedir8 } from "os";
 import { dirname as dirname15, join as join19 } from "path";
 
@@ -42273,7 +42351,7 @@ import {
   appendFileSync,
   existsSync as existsSync13,
   mkdirSync as mkdirSync10,
-  readFileSync as readFileSync14,
+  readFileSync as readFileSync15,
   renameSync,
   rmSync as rmSync5,
   unlinkSync as unlinkSync2,
@@ -42892,7 +42970,7 @@ function flushDeferredSkillsNotices(baseUrl, agents) {
   if (!tombstone) return;
   let text = "";
   try {
-    text = readFileSync14(tombstone, "utf-8");
+    text = readFileSync15(tombstone, "utf-8");
   } catch {
     return;
   } finally {
@@ -42930,7 +43008,7 @@ function hasMarkedSkillsSyncVersion(path, version) {
 }
 function readMarkedSkillsSyncVersion(path) {
   try {
-    return existsSync13(path) ? readFileSync14(path, "utf-8").trim() : "";
+    return existsSync13(path) ? readFileSync15(path, "utf-8").trim() : "";
   } catch {
     return "";
   }
@@ -43491,7 +43569,7 @@ function isSkillsPlanCurrent(plan, state) {
 }
 function readSkillsInstallState(path) {
   try {
-    const parsed = JSON.parse(readFileSync15(path, "utf8"));
+    const parsed = JSON.parse(readFileSync16(path, "utf8"));
     return parsed !== null && typeof parsed === "object" && !Array.isArray(parsed) ? parsed : null;
   } catch {
     return null;
@@ -43859,7 +43937,7 @@ function phasesFromLegacyStatus(status) {
 function readSetupState(input2) {
   try {
     const parsed = JSON.parse(
-      readFileSync16(
+      readFileSync17(
         setupStatePath(input2.baseUrl, input2.scope, input2.root),
         "utf8"
       )
@@ -43964,7 +44042,7 @@ function asRecord3(value) {
 }
 function safeRead(path) {
   try {
-    return readFileSync16(path, "utf8");
+    return readFileSync17(path, "utf8");
   } catch {
     return "";
   }
@@ -44723,13 +44801,13 @@ Examples:
 }
 
 // src/cli/commands/settings.ts
-import { readFileSync as readFileSync20 } from "fs";
+import { readFileSync as readFileSync21 } from "fs";
 
 // src/cli/update-preferences.ts
 import {
   existsSync as existsSync16,
   mkdirSync as mkdirSync13,
-  readFileSync as readFileSync17,
+  readFileSync as readFileSync18,
   renameSync as renameSync2,
   rmSync as rmSync6,
   writeFileSync as writeFileSync17
@@ -44776,7 +44854,7 @@ function readCliUpdatePreferences(homeDir2 = homedir10()) {
   const path = cliUpdatePreferencesPath(homeDir2);
   if (!existsSync16(path)) return defaultPreferences();
   try {
-    const parsed = JSON.parse(readFileSync17(path, "utf8"));
+    const parsed = JSON.parse(readFileSync18(path, "utf8"));
     return {
       schemaVersion: UPDATE_PREFERENCES_SCHEMA_VERSION,
       autoUpdateEnabled: typeof parsed.autoUpdateEnabled === "boolean" ? parsed.autoUpdateEnabled : true,
@@ -44855,7 +44933,7 @@ import {
   existsSync as existsSync18,
   mkdirSync as mkdirSync14,
   realpathSync as realpathSync5,
-  readFileSync as readFileSync19,
+  readFileSync as readFileSync20,
   renameSync as renameSync3,
   rmSync as rmSync7,
   unlinkSync as unlinkSync3,
@@ -44873,7 +44951,7 @@ import {
 
 // src/cli/install-integrity.ts
 import { createRequire } from "module";
-import { existsSync as existsSync17, readFileSync as readFileSync18, statSync as statSync5 } from "fs";
+import { existsSync as existsSync17, readFileSync as readFileSync19, statSync as statSync5 } from "fs";
 import { isAbsolute as isAbsolute6, join as join22, relative as relative7, resolve as resolve18 } from "path";
 var SDK_SIDECAR_CRITICAL_PACKAGE_FILES = [
   "dist/cli/index.mjs",
@@ -44909,7 +44987,7 @@ function resolveContainedPath(root, value) {
   return target;
 }
 function parseJson(path) {
-  return JSON.parse(readFileSync18(path, "utf8"));
+  return JSON.parse(readFileSync19(path, "utf8"));
 }
 function isFile(path) {
   try {
@@ -45113,7 +45191,7 @@ function publicNpmFallbackRegistryUrl(hostUrl) {
 }
 function readOptionalText(path) {
   try {
-    return readFileSync19(path, "utf8").trim();
+    return readFileSync20(path, "utf8").trim();
   } catch {
     return "";
   }
@@ -45316,7 +45394,7 @@ function readAutoUpdateFailure(plan) {
   if (!path) return null;
   try {
     const parsed = JSON.parse(
-      readFileSync19(path, "utf8")
+      readFileSync20(path, "utf8")
     );
     if ((parsed.kind === "npm-global" || parsed.kind === "python-sidecar") && typeof parsed.packageSpec === "string" && typeof parsed.failedAt === "string" && typeof parsed.exitCode === "number" && typeof parsed.manualCommand === "string") {
       return parsed;
@@ -45402,7 +45480,7 @@ function installedPackageVersion(versionDir) {
     "package.json"
   );
   try {
-    const parsed = JSON.parse(readFileSync19(packageJsonPath, "utf8"));
+    const parsed = JSON.parse(readFileSync20(packageJsonPath, "utf8"));
     return typeof parsed.version === "string" ? safeVersionSegment(parsed.version) : "";
   } catch {
     return "";
@@ -46442,7 +46520,7 @@ function collectEvent(value, previous = []) {
 function collectNotificationTarget(value, previous = []) {
   return [...previous, value];
 }
-async function readNotificationConfigurationChange(source, read = (path, encoding) => readFileSync20(path, encoding)) {
+async function readNotificationConfigurationChange(source, read = (path, encoding) => readFileSync21(path, encoding)) {
   const label = source === "-" ? "stdin" : source;
   let text;
   try {
@@ -46785,7 +46863,7 @@ import {
   chmodSync,
   existsSync as existsSync19,
   mkdtempSync,
-  readFileSync as readFileSync21,
+  readFileSync as readFileSync22,
   writeFileSync as writeFileSync20
 } from "fs";
 import { tmpdir as tmpdir6 } from "os";
@@ -48927,7 +49005,7 @@ function readJsonArgument(raw, flagName) {
     throw new Error(`Invalid ${flagName} value: empty @file path.`);
   }
   try {
-    return readFileSync21(resolveAtFilePath(filePath), "utf8").replace(
+    return readFileSync22(resolveAtFilePath(filePath), "utf8").replace(
       /^\uFEFF/,
       ""
     );

package/dist/index.d.mts

@@ -1734,6 +1734,16 @@ interface PlayStatus {
     progress?: PlayProgressStatus;
     /** Partial or final result. Available once the play returns. */
     result?: unknown;
+    /**
+     * Terminal row outcome truth. A completed run may still contain failed rows
+     * when row-level failure isolation persisted those rows for retry.
+     */
+    rowOutcomes?: {
+        completedRows: number;
+        failedRows: number;
+        totalRows: number;
+        hasRowFailures: boolean;
+    };
     /** Compact typed run package returned by current run status endpoints. */
     package?: PlayRunPackage;
     /** Compact typed output summaries, mirrored from the run package when present. */

package/dist/index.d.ts

@@ -1734,6 +1734,16 @@ interface PlayStatus {
     progress?: PlayProgressStatus;
     /** Partial or final result. Available once the play returns. */
     result?: unknown;
+    /**
+     * Terminal row outcome truth. A completed run may still contain failed rows
+     * when row-level failure isolation persisted those rows for retry.
+     */
+    rowOutcomes?: {
+        completedRows: number;
+        failedRows: number;
+        totalRows: number;
+        hasRowFailures: boolean;
+    };
     /** Compact typed run package returned by current run status endpoints. */
     package?: PlayRunPackage;
     /** Compact typed output summaries, mirrored from the run package when present. */

package/dist/index.js

@@ -864,7 +864,7 @@ var 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.131",
+  version: "0.3.133",
   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: {
     updatePreferences: 1

package/dist/index.mjs

@@ -768,7 +768,7 @@ var 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.131",
+  version: "0.3.133",
   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: {
     updatePreferences: 1

package/dist/release.d.mts

@@ -149,7 +149,7 @@ type SdkRelease = {
     supportPolicy: SdkSupportPolicy;
 };
 declare const SDK_RELEASE: {
-    readonly version: "0.3.131";
+    readonly version: "0.3.133";
     readonly 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.";
     readonly packageCapabilities: {
         readonly updatePreferences: 1;

package/dist/release.d.ts

@@ -149,7 +149,7 @@ type SdkRelease = {
     supportPolicy: SdkSupportPolicy;
 };
 declare const SDK_RELEASE: {
-    readonly version: "0.3.131";
+    readonly version: "0.3.133";
     readonly 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.";
     readonly packageCapabilities: {
         readonly updatePreferences: 1;

package/dist/release.js

@@ -74,7 +74,7 @@ var 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.131",
+  version: "0.3.133",
   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: {
     updatePreferences: 1

package/dist/release.mjs

@@ -48,7 +48,7 @@ var 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.131",
+  version: "0.3.133",
   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: {
     updatePreferences: 1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "deepline",
-  "version": "0.3.131",
+  "version": "0.3.133",
   "description": "GTM data CLI and TypeScript SDK for coding agents",
   "license": "MIT",
   "homepage": "https://code.deepline.com",