deepline 0.3.182 → 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.182',
+  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/bundling-sources/shared_libs/play-runtime/scheduler-backends/postgres.ts

@@ -11836,6 +11836,9 @@ export async function failPostgresSchedulerAttempt(
  * Cancel a run: terminal `cancelled` status, all live attempts cancelled, and
  * terminal notify so observers settle immediately. An in-flight executor's
  * complete/fail then no-ops on its status guard (the run stays cancelled).
+ * Receipt ownership is released by the terminal run status itself; claimers
+ * lazily take an incomplete receipt from a terminal owner instead of making
+ * cancellation rewrite an unbounded number of receipt rows.
  */
 export async function cancelPostgresSchedulerRun(
   client: PostgresSchedulerQueryClient,
@@ -11902,29 +11905,7 @@ export async function cancelPostgresSchedulerRun(
         WHERE target.run_id = $1
           AND target.status IN ('queued', 'running', 'waiting')
           ${strandedEligibility}
-        RETURNING target.run_id, target.org_id, target.launch_json
-      ),
-      released_receipts AS (
-        -- Cancellation is a terminal, and a terminal releases everything the
-        -- run claimed. A receipt left 'running' behind a dead lease matches no
-        -- non-forced claim status set, so a successor would park on it for the
-        -- whole receipt wait budget instead of executing the call itself.
-        UPDATE ${tableName('receipts', options)} AS receipt
-        SET ${RELEASE_RECEIPT_TO_PENDING_SET_CLAUSE}
-        FROM cancelled_run
-        WHERE receipt.org_id = cancelled_run.org_id
-          AND receipt.status IN ('queued', 'running')
-          -- Every successful claim stamps both run_id and
-          -- lease_owner_run_id with the current owner. Keep the explicit
-          -- owner fence below for mixed-version rows, while giving Postgres
-          -- the direct run_id equality it needs to use
-          -- runtime_scheduler_receipts_run_idx. Without this predicate,
-          -- COALESCE forces a scan of the org's complete receipt history and
-          -- cancellation can hit its statement timeout on a large workspace.
-          AND receipt.run_id = cancelled_run.run_id
-          AND COALESCE(receipt.lease_owner_run_id, receipt.run_id)
-              = cancelled_run.run_id
-        RETURNING receipt.k
+        RETURNING target.run_id, target.launch_json
       ),
       cancelled_attempts AS (
         UPDATE ${tableName('attempts', options)}
@@ -14562,10 +14543,9 @@ export async function releasePostgresSchedulerReceipt(
 }
 
 /**
- * The write that returns a claimed receipt to the free pool. Every release
- * path shares it so a successor's non-forced claim always matches what a dead
- * owner left behind. Claimers also understand terminal ownership directly so
- * a later writer release can stop rewriting every receipt synchronously.
+ * The write that returns one attempt's claimed receipts to the free pool.
+ * Attempt cleanup uses this eager path; whole-run terminalization is the
+ * constant-time ownership fence that claimers resolve lazily.
  */
 const RELEASE_RECEIPT_TO_PENDING_SET_CLAUSE = `status = 'pending',
           output_json = NULL,

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