deepline 0.3.183 → 0.3.184

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.183',
+  version: '0.3.184',
   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/cli/index.js

@@ -3051,7 +3051,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.183",
+  version: "0.3.184",
   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
@@ -14141,6 +14141,7 @@ function mergeCanonicalRowsInfo(left, right) {
     source: preferred.source ?? fallback.source,
     datasetId: preferred.datasetId ?? fallback.datasetId,
     tableNamespace: preferred.tableNamespace ?? fallback.tableNamespace,
+    currentTableQueryCommand: preferred.currentTableQueryCommand ?? fallback.currentTableQueryCommand,
     ...left.recovered || right.recovered ? { recovered: true } : {},
     ...recoveredReturnPaths2.length ? { recoveredReturnPaths: recoveredReturnPaths2 } : {},
     ...currentTable ? { currentTable: true } : {},
@@ -14209,6 +14210,12 @@ function hasCurrentTableExport(value) {
   const exportCsv = value.actions.exportCsv;
   return isRecord8(exportCsv) && isRecord8(exportCsv.scope) && exportCsv.scope.kind === "database" && exportCsv.scope.mutability === "current";
 }
+function currentTableQueryCommand(value) {
+  if (!isRecord8(value) || !isRecord8(value.actions)) return void 0;
+  const query = value.actions.queryCurrentTable;
+  const command = isRecord8(query) ? query.command : void 0;
+  return typeof command === "string" && command.trim() ? command.trim() : void 0;
+}
 function recoveredReturnPaths(value) {
   if (!Array.isArray(value)) return [];
   return [
@@ -14316,6 +14323,9 @@ function canonicalRowsInfoFromCandidate(input2) {
       tableNamespace: typeof candidate.value.tableNamespace === "string" ? candidate.value.tableNamespace : null,
       ...candidate.value.recovered === true ? { recovered: true } : {},
       ...hasCurrentTableExport(candidate.value) ? { currentTable: true } : {},
+      ...currentTableQueryCommand(candidate.value) ? {
+        currentTableQueryCommand: currentTableQueryCommand(candidate.value)
+      } : {},
       ...recoveredReturnPaths(candidate.value.recoveredReturnPaths).length ? {
         recoveredReturnPaths: recoveredReturnPaths(
           candidate.value.recoveredReturnPaths
@@ -26317,7 +26327,20 @@ async function fetchBackingDatasetRows(input2) {
     offset += page.rows.length;
   }
   const rows = sheetRows.map(exportableSheetRow).filter((row) => Boolean(row));
-  const hasCompleteSettledPrefix = !currentTable && acceptsSettledRowsAsCompleteExport(input2.status) && settledTotal !== null && rows.length >= settledTotal;
+  const hasCompleteSettledPrefix = !currentTable && acceptsSettledRowsAsCompleteExport(input2.status) && settledTotal !== null && // A zero-row run-scoped read is not a settled export when the returned
+  // Dataset Handle advertised rows. That shape is the replay/reuse case:
+  // the rows belong to another writer (or the projection has not caught up)
+  // and must not erase the run package's advertised count.
+  (settledTotal > 0 || input2.rowsInfo.totalRows === 0) && rows.length >= settledTotal;
+  if (!currentTable && acceptsSettledRowsAsCompleteExport(input2.status) && settledTotal === 0 && rows.length === 0 && input2.rowsInfo.totalRows > 0) {
+    return {
+      ...input2.rowsInfo,
+      rows: [],
+      totalRows: input2.rowsInfo.totalRows,
+      complete: true,
+      source: `${input2.rowsInfo.source ?? "result.rows"} -> /api/v2/plays/${playName}/sheet?tableNamespace=${tableNamespace}`
+    };
+  }
   if (!currentTable && rows.length < input2.rowsInfo.totalRows && !hasCompleteSettledPrefix || currentTable && rows.length === 0 && input2.rowsInfo.totalRows > 0) {
     return null;
   }
@@ -26373,7 +26396,8 @@ function assertDatasetHasExportableRows(input2) {
     "output.csv",
     datasetLabel
   );
-  const explanation = terminalRunWithMissingAdvertisedRows ? ` The terminal result advertised ${advertisedRows} row(s), but none are currently attributed to this run's durable sheet. Those rows may have been reused from an earlier run or the projection may still be lagging; export refuses to guess another run's rows. Retry the same export after projection catches up (do not rerun the Play): ${retryCommand}. If it remains empty, inspect the full package with ${inspectCommand} and export the run that owns the durable dataset; this command will not use a database-wide table query that could mix runs.` : ` The run status is '${runStatus || "unknown"}', so it likely failed before persisting rows to this dataset. That means provider calls may have been billed without a durable row; inspect ${inspectCommand}, fix the failure cause, then rerun the Play so completed receipts can be reused.`;
+  const currentTableQueryCommand2 = input2.rowsInfo.currentTableQueryCommand;
+  const explanation = terminalRunWithMissingAdvertisedRows ? ` The terminal result advertised ${advertisedRows} row(s), but none are currently attributed to this run's durable sheet. Those rows may have been reused from an earlier run or the projection may still be lagging; export refuses to guess another run's rows. Retry the same export after projection catches up (do not rerun the Play): ${retryCommand}. If it remains empty, inspect the full package with ${inspectCommand}` + (currentTableQueryCommand2 ? `, then inspect the current table's _run_id/_writer_run_id with ${currentTableQueryCommand2} and export the run that owns those rows` : " and export the run that owns the durable dataset") + "; this command will not use a database-wide table query that could mix runs." : ` The run status is '${runStatus || "unknown"}', so it likely failed before persisting rows to this dataset. That means provider calls may have been billed without a durable row; inspect ${inspectCommand}, fix the failure cause, then rerun the Play so completed receipts can be reused.`;
   throw new DeeplineError(
     `Run ${input2.status.runId} has zero rows to export from dataset '${datasetLabel}'.` + explanation + (available.length > 0 ? ` Available datasets: ${available.join(", ")}.` : " No datasets were materialized for this run."),
     void 0,
@@ -26386,6 +26410,7 @@ function assertDatasetHasExportableRows(input2) {
       guidance: terminalRunWithMissingAdvertisedRows ? {
         inspect_command: inspectCommand,
         retry_command: retryCommand,
+        ...currentTableQueryCommand2 ? { lookup_writer_command: currentTableQueryCommand2 } : {},
         do_not_rerun: true,
         reason: "Run output is terminal but its rows are not attributed to this run; export refuses to guess another writer."
       } : {

package/dist/cli/index.mjs

@@ -3046,7 +3046,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.183",
+  version: "0.3.184",
   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
@@ -14156,6 +14156,7 @@ function mergeCanonicalRowsInfo(left, right) {
     source: preferred.source ?? fallback.source,
     datasetId: preferred.datasetId ?? fallback.datasetId,
     tableNamespace: preferred.tableNamespace ?? fallback.tableNamespace,
+    currentTableQueryCommand: preferred.currentTableQueryCommand ?? fallback.currentTableQueryCommand,
     ...left.recovered || right.recovered ? { recovered: true } : {},
     ...recoveredReturnPaths2.length ? { recoveredReturnPaths: recoveredReturnPaths2 } : {},
     ...currentTable ? { currentTable: true } : {},
@@ -14224,6 +14225,12 @@ function hasCurrentTableExport(value) {
   const exportCsv = value.actions.exportCsv;
   return isRecord8(exportCsv) && isRecord8(exportCsv.scope) && exportCsv.scope.kind === "database" && exportCsv.scope.mutability === "current";
 }
+function currentTableQueryCommand(value) {
+  if (!isRecord8(value) || !isRecord8(value.actions)) return void 0;
+  const query = value.actions.queryCurrentTable;
+  const command = isRecord8(query) ? query.command : void 0;
+  return typeof command === "string" && command.trim() ? command.trim() : void 0;
+}
 function recoveredReturnPaths(value) {
   if (!Array.isArray(value)) return [];
   return [
@@ -14331,6 +14338,9 @@ function canonicalRowsInfoFromCandidate(input2) {
       tableNamespace: typeof candidate.value.tableNamespace === "string" ? candidate.value.tableNamespace : null,
       ...candidate.value.recovered === true ? { recovered: true } : {},
       ...hasCurrentTableExport(candidate.value) ? { currentTable: true } : {},
+      ...currentTableQueryCommand(candidate.value) ? {
+        currentTableQueryCommand: currentTableQueryCommand(candidate.value)
+      } : {},
       ...recoveredReturnPaths(candidate.value.recoveredReturnPaths).length ? {
         recoveredReturnPaths: recoveredReturnPaths(
           candidate.value.recoveredReturnPaths
@@ -26389,7 +26399,20 @@ async function fetchBackingDatasetRows(input2) {
     offset += page.rows.length;
   }
   const rows = sheetRows.map(exportableSheetRow).filter((row) => Boolean(row));
-  const hasCompleteSettledPrefix = !currentTable && acceptsSettledRowsAsCompleteExport(input2.status) && settledTotal !== null && rows.length >= settledTotal;
+  const hasCompleteSettledPrefix = !currentTable && acceptsSettledRowsAsCompleteExport(input2.status) && settledTotal !== null && // A zero-row run-scoped read is not a settled export when the returned
+  // Dataset Handle advertised rows. That shape is the replay/reuse case:
+  // the rows belong to another writer (or the projection has not caught up)
+  // and must not erase the run package's advertised count.
+  (settledTotal > 0 || input2.rowsInfo.totalRows === 0) && rows.length >= settledTotal;
+  if (!currentTable && acceptsSettledRowsAsCompleteExport(input2.status) && settledTotal === 0 && rows.length === 0 && input2.rowsInfo.totalRows > 0) {
+    return {
+      ...input2.rowsInfo,
+      rows: [],
+      totalRows: input2.rowsInfo.totalRows,
+      complete: true,
+      source: `${input2.rowsInfo.source ?? "result.rows"} -> /api/v2/plays/${playName}/sheet?tableNamespace=${tableNamespace}`
+    };
+  }
   if (!currentTable && rows.length < input2.rowsInfo.totalRows && !hasCompleteSettledPrefix || currentTable && rows.length === 0 && input2.rowsInfo.totalRows > 0) {
     return null;
   }
@@ -26445,7 +26468,8 @@ function assertDatasetHasExportableRows(input2) {
     "output.csv",
     datasetLabel
   );
-  const explanation = terminalRunWithMissingAdvertisedRows ? ` The terminal result advertised ${advertisedRows} row(s), but none are currently attributed to this run's durable sheet. Those rows may have been reused from an earlier run or the projection may still be lagging; export refuses to guess another run's rows. Retry the same export after projection catches up (do not rerun the Play): ${retryCommand}. If it remains empty, inspect the full package with ${inspectCommand} and export the run that owns the durable dataset; this command will not use a database-wide table query that could mix runs.` : ` The run status is '${runStatus || "unknown"}', so it likely failed before persisting rows to this dataset. That means provider calls may have been billed without a durable row; inspect ${inspectCommand}, fix the failure cause, then rerun the Play so completed receipts can be reused.`;
+  const currentTableQueryCommand2 = input2.rowsInfo.currentTableQueryCommand;
+  const explanation = terminalRunWithMissingAdvertisedRows ? ` The terminal result advertised ${advertisedRows} row(s), but none are currently attributed to this run's durable sheet. Those rows may have been reused from an earlier run or the projection may still be lagging; export refuses to guess another run's rows. Retry the same export after projection catches up (do not rerun the Play): ${retryCommand}. If it remains empty, inspect the full package with ${inspectCommand}` + (currentTableQueryCommand2 ? `, then inspect the current table's _run_id/_writer_run_id with ${currentTableQueryCommand2} and export the run that owns those rows` : " and export the run that owns the durable dataset") + "; this command will not use a database-wide table query that could mix runs." : ` The run status is '${runStatus || "unknown"}', so it likely failed before persisting rows to this dataset. That means provider calls may have been billed without a durable row; inspect ${inspectCommand}, fix the failure cause, then rerun the Play so completed receipts can be reused.`;
   throw new DeeplineError(
     `Run ${input2.status.runId} has zero rows to export from dataset '${datasetLabel}'.` + explanation + (available.length > 0 ? ` Available datasets: ${available.join(", ")}.` : " No datasets were materialized for this run."),
     void 0,
@@ -26458,6 +26482,7 @@ function assertDatasetHasExportableRows(input2) {
       guidance: terminalRunWithMissingAdvertisedRows ? {
         inspect_command: inspectCommand,
         retry_command: retryCommand,
+        ...currentTableQueryCommand2 ? { lookup_writer_command: currentTableQueryCommand2 } : {},
         do_not_rerun: true,
         reason: "Run output is terminal but its rows are not attributed to this run; export refuses to guess another writer."
       } : {

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.183",
+  version: "0.3.184",
   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.183",
+  version: "0.3.184",
   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.183";
+    readonly version: "0.3.184";
     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.183";
+    readonly version: "0.3.184";
     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.183",
+  version: "0.3.184",
   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.183",
+  version: "0.3.184",
   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.183",
+  "version": "0.3.184",
   "description": "GTM data CLI and TypeScript SDK for coding agents",
   "license": "MIT",
   "homepage": "https://code.deepline.com",