deepline 0.3.135 → 0.3.137

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.135',
+  version: '0.3.137',
   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/observability/dlq.ts

@@ -200,6 +200,11 @@ export const QUEUE_ITEM_STATES = [
 
 export type QueueItemState = (typeof QUEUE_ITEM_STATES)[number];
 
+/** Operator disposition is an overlay on native source state. Retiring an
+ * item removes it from active operational views without pretending the owner
+ * completed, deleted, or replayed the source row. */
+export type QueueItemDisposition = 'active' | 'retired';
+
 export type QueueItemAction =
   | 'archive'
   | 'quarantine'
@@ -207,6 +212,7 @@ export type QueueItemAction =
   | 'hold'
   | 'resume'
   | 'cancel'
+  | 'retire'
   | 'update';
 
 export const QUEUE_ITEM_ACTIONS = [
@@ -216,6 +222,7 @@ export const QUEUE_ITEM_ACTIONS = [
   'hold',
   'resume',
   'cancel',
+  'retire',
   'update',
 ] as const satisfies readonly QueueItemAction[];
 
@@ -262,6 +269,8 @@ export type QueueItem = {
   readonly revision: string;
   readonly observedAt: string;
   readonly state: QueueItemState;
+  /** Additive operator overlay; older connectors may omit it. */
+  readonly disposition?: QueueItemDisposition;
   readonly nativeState: string;
   readonly lastError?: QueueItemLastError;
   readonly actions: readonly ActionAvailability[];
@@ -269,6 +278,8 @@ export type QueueItem = {
   readonly createdAt?: string;
   readonly updatedAt?: string;
   readonly summary?: string;
+  readonly retiredAt?: string;
+  readonly retirementReason?: string;
 };
 
 /** Keep old DLQ verbs working at the boundary while exposing a smaller,
@@ -424,8 +435,9 @@ export type QueueItemConnectorContext = {
 
 /**
  * Owner implementation port. The connector owns native reads, state mapping,
- * lease/CAS checks, and outcome verification. The shared control service only
- * authenticates, validates, journals idempotency, and returns this result.
+ * lease/CAS checks, and outcome verification. `retire` is the one shared
+ * disposition action: connectors fence the source revision, while the shared
+ * control plane records an overlay and never mutates the owner row.
  */
 export type QueueItemConnector = {
   readonly id: string;

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.135",
+  version: "0.3.137",
   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
@@ -24717,6 +24717,22 @@ function formatPlayErrorForDisplay(status, error) {
   }
   return error;
 }
+function structuredErrorsForStatus(status) {
+  const directErrors = getRecordField(status, "errors");
+  if (Array.isArray(directErrors)) {
+    const records = directErrors.filter(
+      (entry) => Boolean(entry) && typeof entry === "object" && !Array.isArray(entry)
+    );
+    if (records.length > 0) return records;
+  }
+  const resultErrors = getRecordField(
+    getRecordField(status, "result"),
+    "errors"
+  );
+  return Array.isArray(resultErrors) ? resultErrors.filter(
+    (entry) => Boolean(entry) && typeof entry === "object" && !Array.isArray(entry)
+  ) : [];
+}
 function isGenericInternalServerError(error) {
   if (!error) return false;
   return /^(?:internalservererror|internal server error|http 500|500)$/i.test(
@@ -24725,16 +24741,21 @@ function isGenericInternalServerError(error) {
 }
 function selectRunErrorForDisplay(status) {
   const progressError = getStringField(status.progress, "error");
+  const structuredErrors = structuredErrorsForStatus(status);
+  const structuredMessage = structuredErrors.map((entry) => getStringField(entry, "message")).find((message) => Boolean(message));
+  const structuredRuntimeLimit = structuredErrors.some(
+    (entry) => getStringField(entry, "code") === "RUNTIME_LIMIT_EXCEEDED"
+  );
+  if (structuredMessage && (structuredRuntimeLimit || !progressError && getPlayRunPackage(status) === null)) {
+    return structuredMessage;
+  }
   if (!isGenericInternalServerError(progressError)) {
     return progressError;
   }
-  const directErrors = getRecordField(status, "errors");
-  if (Array.isArray(directErrors)) {
-    for (const entry of directErrors) {
-      const message = getStringField(entry, "message");
-      if (message && !isGenericInternalServerError(message)) {
-        return message;
-      }
+  for (const entry of structuredErrors) {
+    const message = getStringField(entry, "message");
+    if (message && !isGenericInternalServerError(message)) {
+      return message;
     }
   }
   const directError = getStringField(status, "error");
@@ -24792,11 +24813,9 @@ function normalizeStepsForEnvelope(status) {
   return [];
 }
 function normalizeErrorsForEnvelope(status, error) {
-  const directErrors = getRecordField(status, "errors");
-  if (Array.isArray(directErrors)) {
-    return directErrors.filter(
-      (entry) => Boolean(entry) && typeof entry === "object" && !Array.isArray(entry)
-    ).map((entry) => {
+  const structuredErrors = structuredErrorsForStatus(status);
+  if (structuredErrors.length > 0) {
+    return structuredErrors.map((entry) => {
       const message2 = typeof entry.message === "string" && entry.message.trim() ? entry.message : error;
       const billing2 = getObjectField(entry, "billing");
       if (!isInsufficientCreditsBilling(billing2) || !message2) {
@@ -25144,8 +25163,9 @@ function packageReturnedDatasetIdentity(packaged) {
   }
   return { datasetIds, paths };
 }
-function formatPackageDatasetActionLines(packaged) {
+function formatPackageDatasetActionLines(packaged, options) {
   const returned = packageReturnedDatasetIdentity(packaged);
+  const includeSummary = options?.includeSummary ?? true;
   const lines = [];
   for (const dataset of packageDatasetRecords(packaged)) {
     const path = typeof dataset.path === "string" && dataset.path.trim() ? dataset.path.trim() : "dataset";
@@ -25154,14 +25174,16 @@ function formatPackageDatasetActionLines(packaged) {
     const category = isReturned ? "returned" : dataset.recovered === true ? "recovered" : "persisted";
     const rowCount = typeof dataset.rowCount === "number" && Number.isFinite(dataset.rowCount) ? Math.max(0, Math.trunc(dataset.rowCount)) : null;
     const actions = readRecord(dataset.actions) ?? {};
-    if (category === "recovered" && Object.keys(actions).length === 0) {
-      lines.push(
-        `  dataset ${path}: available, ${rowCount === null ? "persisted" : formatInteger(rowCount)} rows persisted; re-running reuses completed work`
-      );
-    } else {
-      lines.push(
-        `  ${category} dataset ${path}: ${rowCount === null ? "unknown rows" : `${formatInteger(rowCount)} ${rowCount === 1 ? "row" : "rows"}`}`
-      );
+    if (includeSummary) {
+      if (category === "recovered" && Object.keys(actions).length === 0) {
+        lines.push(
+          `  dataset ${path}: available, ${rowCount === null ? "persisted" : formatInteger(rowCount)} rows persisted; re-running reuses completed work`
+        );
+      } else {
+        lines.push(
+          `  ${category} dataset ${path}: ${rowCount === null ? "unknown rows" : `${formatInteger(rowCount)} ${rowCount === 1 ? "row" : "rows"}`}`
+        );
+      }
     }
     const exportAction = readRecord(actions.exportCsv);
     const exportCommand = actionToCommand(exportAction);
@@ -25187,6 +25209,52 @@ function formatPackageDatasetActionLines(packaged) {
   }
   return lines;
 }
+function packageSavedRowCount(packaged) {
+  const rowCounts = packageDatasetRecords(packaged).map((dataset) => dataset.rowCount).filter(
+    (rowCount) => typeof rowCount === "number" && Number.isFinite(rowCount)
+  ).map((rowCount) => Math.max(0, Math.trunc(rowCount)));
+  if (rowCounts.length === 0) return null;
+  return rowCounts.reduce((total, rowCount) => total + rowCount, 0);
+}
+function runtimeLimitWindowLabel(runtimeLimitFailure) {
+  const message = getStringField(runtimeLimitFailure, "message") ?? "";
+  const configuredSeconds = /\bconfigured\s+(\d+)\s+second(?:s)?\s+runtime limit\b/i.exec(message)?.[1];
+  if (configuredSeconds) {
+    const seconds = Number(configuredSeconds);
+    if (Number.isSafeInteger(seconds) && seconds > 0) {
+      if (seconds % 3600 === 0) return `${seconds / 3600}-hour`;
+      if (seconds % 60 === 0) return `${seconds / 60}-minute`;
+      return `${seconds}-second`;
+    }
+  }
+  const match = /\b(\d+)\s+(hour|hours|minute|minutes|second|seconds)\b/i.exec(
+    message
+  );
+  if (!match) return "30-minute";
+  const unit = match[2].toLowerCase().replace(/s$/, "");
+  return `${match[1]}-${unit}`;
+}
+function runtimeLimitCheckpointLines(packaged, runId, runtimeLimitFailure) {
+  const savedRows = packageSavedRowCount(packaged);
+  const lines = [
+    `\u2713 progress saved  ${runId}`,
+    "",
+    `The Play reached its ${runtimeLimitWindowLabel(runtimeLimitFailure)} runtime window.`
+  ];
+  if (savedRows === null) {
+    lines.push("Progress completed before the runtime window closed.");
+  } else {
+    lines.push(
+      `${formatInteger(savedRows)} ${savedRows === 1 ? "row was" : "rows were"} saved successfully.`
+    );
+  }
+  lines.push(
+    "",
+    "Run the same Play again to continue where you left off.",
+    "Completed work will be reused automatically."
+  );
+  return lines;
+}
 function formatInlinePackageValue(value) {
   const compacted = compactReturnValue(value);
   const json2 = JSON.stringify(compacted);
@@ -25298,24 +25366,20 @@ function buildRunPackageTextLines(packaged) {
   const runId = typeof run.id === "string" ? run.id : "unknown";
   const status = typeof run.status === "string" ? run.status : "unknown";
   const playName = typeof run.playName === "string" ? run.playName : null;
-  const lines = [
+  const runtimeLimitFailure = readRecordArray(packaged.errors).find(
+    (entry) => entry.code === "RUNTIME_LIMIT_EXCEEDED"
+  );
+  const isRuntimeTimeout = status === "failed" && (runtimeLimitFailure !== void 0 || typeof run.error === "string" && /RUNTIME_LIMIT_EXCEEDED/.test(run.error));
+  const isRuntimeLimitCheckpoint = isRuntimeTimeout;
+  const checkpointFailure = runtimeLimitFailure ?? (typeof run.error === "string" ? { message: run.error } : { message: "The Play reached its runtime limit and was stopped." });
+  const lines = isRuntimeLimitCheckpoint ? runtimeLimitCheckpointLines(packaged, runId, checkpointFailure) : [
     `${status === "completed" ? "\u2713" : status === "failed" ? "\u2717" : "\u2022"} ${status}  ${runId}`
   ];
-  const isRuntimeTimeout = status === "failed" && (readRecordArray(packaged.errors).some(
-    (error) => error.code === "RUNTIME_LIMIT_EXCEEDED"
-  ) || typeof run.error === "string" && /RUNTIME_LIMIT_EXCEEDED/.test(run.error));
-  if (isRuntimeTimeout) {
-    lines.push("  RUNTIME_LIMIT_EXCEEDED: the Play stopped before returning.");
-    lines.push(
-      "  Inspect the dataset catalog below and export saved data before rerunning unfinished work."
-    );
-    lines.push(
-      "  Adjust runtime.timeout in the Play (maximum 4h), remove the override for the 30-minute default, or use fewer rows."
-    );
-  }
   const runError = typeof run.error === "string" && run.error.trim() ? run.error.trim() : null;
-  if (runError && (status === "failed" || status === "cancelled")) {
-    lines.push(`  error: ${truncateErrorForDisplay(runError, runId)}`);
+  const structuredRuntimeLimitMessage = typeof runtimeLimitFailure?.message === "string" && runtimeLimitFailure.message.trim() ? `${typeof runtimeLimitFailure.code === "string" ? runtimeLimitFailure.code : "RUNTIME_LIMIT_EXCEEDED"}: ${runtimeLimitFailure.message.trim()}` : null;
+  const displayRunError = structuredRuntimeLimitMessage ?? runError;
+  if (!isRuntimeLimitCheckpoint && displayRunError && (status === "failed" || status === "cancelled")) {
+    lines.push(`  error: ${truncateErrorForDisplay(displayRunError, runId)}`);
     const stackFrames = authoredPackageStackFrames(packaged);
     if (stackFrames.length > 0) {
       lines.push("  stack:");
@@ -25352,12 +25416,18 @@ function buildRunPackageTextLines(packaged) {
       failedLogAssociation === "retained_before_truncation" ? `  retained logs: ${failedLogNext.logs}` : `  retry failed logs: ${failedLogNext.logs}`
     );
   }
-  if (playName) {
+  if (playName && !isRuntimeLimitCheckpoint) {
     lines.push(`  play: ${playName}`);
   }
-  lines.push(...buildRunActivityTextLines(run));
+  if (!isRuntimeLimitCheckpoint) {
+    lines.push(...buildRunActivityTextLines(run));
+  }
   lines.push(...formatPackageValueOutputLines(packaged));
-  lines.push(...formatPackageDatasetActionLines(packaged));
+  lines.push(
+    ...formatPackageDatasetActionLines(packaged, {
+      includeSummary: !isRuntimeLimitCheckpoint
+    })
+  );
   const next = packaged.next && typeof packaged.next === "object" && !Array.isArray(packaged.next) ? packaged.next : {};
   const billingCommand = actionToCommand(next.billing);
   const logsCommand = actionToCommand(next.logs);
@@ -25365,7 +25435,7 @@ function buildRunPackageTextLines(packaged) {
     const costState = status === "completed" || status === "failed" || status === "cancelled" ? "settles asynchronously \u2014 run the billing command below for totals" : "pending";
     lines.push(`  cost: ${costState}`);
   }
-  for (const step of readRecordArray(packaged.steps).slice(0, 8)) {
+  for (const step of isRuntimeLimitCheckpoint ? [] : readRecordArray(packaged.steps).slice(0, 8)) {
     const id = typeof step.id === "string" ? step.id : "step";
     const kind = typeof step.kind === "string" ? step.kind : "step";
     const stepStatus = typeof step.status === "string" ? step.status : status;
@@ -25398,10 +25468,8 @@ function buildRunPackageTextLines(packaged) {
   if (legacyExportCommand) {
     lines.push(`  export CSV: ${legacyExportCommand}`);
   }
-  if (runAgainCommand) {
-    lines.push(
-      isRuntimeTimeout ? "  run again after adjusting the deadline or batch (compatible completed work may be reused):" : "  run again (completed work is reused):"
-    );
+  if (runAgainCommand && !isRuntimeLimitCheckpoint) {
+    lines.push("  run again (completed work is reused):");
     lines.push(`    ${runAgainCommand}`);
   }
   return lines;

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.135",
+  version: "0.3.137",
   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
@@ -24789,6 +24789,22 @@ function formatPlayErrorForDisplay(status, error) {
   }
   return error;
 }
+function structuredErrorsForStatus(status) {
+  const directErrors = getRecordField(status, "errors");
+  if (Array.isArray(directErrors)) {
+    const records = directErrors.filter(
+      (entry) => Boolean(entry) && typeof entry === "object" && !Array.isArray(entry)
+    );
+    if (records.length > 0) return records;
+  }
+  const resultErrors = getRecordField(
+    getRecordField(status, "result"),
+    "errors"
+  );
+  return Array.isArray(resultErrors) ? resultErrors.filter(
+    (entry) => Boolean(entry) && typeof entry === "object" && !Array.isArray(entry)
+  ) : [];
+}
 function isGenericInternalServerError(error) {
   if (!error) return false;
   return /^(?:internalservererror|internal server error|http 500|500)$/i.test(
@@ -24797,16 +24813,21 @@ function isGenericInternalServerError(error) {
 }
 function selectRunErrorForDisplay(status) {
   const progressError = getStringField(status.progress, "error");
+  const structuredErrors = structuredErrorsForStatus(status);
+  const structuredMessage = structuredErrors.map((entry) => getStringField(entry, "message")).find((message) => Boolean(message));
+  const structuredRuntimeLimit = structuredErrors.some(
+    (entry) => getStringField(entry, "code") === "RUNTIME_LIMIT_EXCEEDED"
+  );
+  if (structuredMessage && (structuredRuntimeLimit || !progressError && getPlayRunPackage(status) === null)) {
+    return structuredMessage;
+  }
   if (!isGenericInternalServerError(progressError)) {
     return progressError;
   }
-  const directErrors = getRecordField(status, "errors");
-  if (Array.isArray(directErrors)) {
-    for (const entry of directErrors) {
-      const message = getStringField(entry, "message");
-      if (message && !isGenericInternalServerError(message)) {
-        return message;
-      }
+  for (const entry of structuredErrors) {
+    const message = getStringField(entry, "message");
+    if (message && !isGenericInternalServerError(message)) {
+      return message;
     }
   }
   const directError = getStringField(status, "error");
@@ -24864,11 +24885,9 @@ function normalizeStepsForEnvelope(status) {
   return [];
 }
 function normalizeErrorsForEnvelope(status, error) {
-  const directErrors = getRecordField(status, "errors");
-  if (Array.isArray(directErrors)) {
-    return directErrors.filter(
-      (entry) => Boolean(entry) && typeof entry === "object" && !Array.isArray(entry)
-    ).map((entry) => {
+  const structuredErrors = structuredErrorsForStatus(status);
+  if (structuredErrors.length > 0) {
+    return structuredErrors.map((entry) => {
       const message2 = typeof entry.message === "string" && entry.message.trim() ? entry.message : error;
       const billing2 = getObjectField(entry, "billing");
       if (!isInsufficientCreditsBilling(billing2) || !message2) {
@@ -25216,8 +25235,9 @@ function packageReturnedDatasetIdentity(packaged) {
   }
   return { datasetIds, paths };
 }
-function formatPackageDatasetActionLines(packaged) {
+function formatPackageDatasetActionLines(packaged, options) {
   const returned = packageReturnedDatasetIdentity(packaged);
+  const includeSummary = options?.includeSummary ?? true;
   const lines = [];
   for (const dataset of packageDatasetRecords(packaged)) {
     const path = typeof dataset.path === "string" && dataset.path.trim() ? dataset.path.trim() : "dataset";
@@ -25226,14 +25246,16 @@ function formatPackageDatasetActionLines(packaged) {
     const category = isReturned ? "returned" : dataset.recovered === true ? "recovered" : "persisted";
     const rowCount = typeof dataset.rowCount === "number" && Number.isFinite(dataset.rowCount) ? Math.max(0, Math.trunc(dataset.rowCount)) : null;
     const actions = readRecord(dataset.actions) ?? {};
-    if (category === "recovered" && Object.keys(actions).length === 0) {
-      lines.push(
-        `  dataset ${path}: available, ${rowCount === null ? "persisted" : formatInteger(rowCount)} rows persisted; re-running reuses completed work`
-      );
-    } else {
-      lines.push(
-        `  ${category} dataset ${path}: ${rowCount === null ? "unknown rows" : `${formatInteger(rowCount)} ${rowCount === 1 ? "row" : "rows"}`}`
-      );
+    if (includeSummary) {
+      if (category === "recovered" && Object.keys(actions).length === 0) {
+        lines.push(
+          `  dataset ${path}: available, ${rowCount === null ? "persisted" : formatInteger(rowCount)} rows persisted; re-running reuses completed work`
+        );
+      } else {
+        lines.push(
+          `  ${category} dataset ${path}: ${rowCount === null ? "unknown rows" : `${formatInteger(rowCount)} ${rowCount === 1 ? "row" : "rows"}`}`
+        );
+      }
     }
     const exportAction = readRecord(actions.exportCsv);
     const exportCommand = actionToCommand(exportAction);
@@ -25259,6 +25281,52 @@ function formatPackageDatasetActionLines(packaged) {
   }
   return lines;
 }
+function packageSavedRowCount(packaged) {
+  const rowCounts = packageDatasetRecords(packaged).map((dataset) => dataset.rowCount).filter(
+    (rowCount) => typeof rowCount === "number" && Number.isFinite(rowCount)
+  ).map((rowCount) => Math.max(0, Math.trunc(rowCount)));
+  if (rowCounts.length === 0) return null;
+  return rowCounts.reduce((total, rowCount) => total + rowCount, 0);
+}
+function runtimeLimitWindowLabel(runtimeLimitFailure) {
+  const message = getStringField(runtimeLimitFailure, "message") ?? "";
+  const configuredSeconds = /\bconfigured\s+(\d+)\s+second(?:s)?\s+runtime limit\b/i.exec(message)?.[1];
+  if (configuredSeconds) {
+    const seconds = Number(configuredSeconds);
+    if (Number.isSafeInteger(seconds) && seconds > 0) {
+      if (seconds % 3600 === 0) return `${seconds / 3600}-hour`;
+      if (seconds % 60 === 0) return `${seconds / 60}-minute`;
+      return `${seconds}-second`;
+    }
+  }
+  const match = /\b(\d+)\s+(hour|hours|minute|minutes|second|seconds)\b/i.exec(
+    message
+  );
+  if (!match) return "30-minute";
+  const unit = match[2].toLowerCase().replace(/s$/, "");
+  return `${match[1]}-${unit}`;
+}
+function runtimeLimitCheckpointLines(packaged, runId, runtimeLimitFailure) {
+  const savedRows = packageSavedRowCount(packaged);
+  const lines = [
+    `\u2713 progress saved  ${runId}`,
+    "",
+    `The Play reached its ${runtimeLimitWindowLabel(runtimeLimitFailure)} runtime window.`
+  ];
+  if (savedRows === null) {
+    lines.push("Progress completed before the runtime window closed.");
+  } else {
+    lines.push(
+      `${formatInteger(savedRows)} ${savedRows === 1 ? "row was" : "rows were"} saved successfully.`
+    );
+  }
+  lines.push(
+    "",
+    "Run the same Play again to continue where you left off.",
+    "Completed work will be reused automatically."
+  );
+  return lines;
+}
 function formatInlinePackageValue(value) {
   const compacted = compactReturnValue(value);
   const json2 = JSON.stringify(compacted);
@@ -25370,24 +25438,20 @@ function buildRunPackageTextLines(packaged) {
   const runId = typeof run.id === "string" ? run.id : "unknown";
   const status = typeof run.status === "string" ? run.status : "unknown";
   const playName = typeof run.playName === "string" ? run.playName : null;
-  const lines = [
+  const runtimeLimitFailure = readRecordArray(packaged.errors).find(
+    (entry) => entry.code === "RUNTIME_LIMIT_EXCEEDED"
+  );
+  const isRuntimeTimeout = status === "failed" && (runtimeLimitFailure !== void 0 || typeof run.error === "string" && /RUNTIME_LIMIT_EXCEEDED/.test(run.error));
+  const isRuntimeLimitCheckpoint = isRuntimeTimeout;
+  const checkpointFailure = runtimeLimitFailure ?? (typeof run.error === "string" ? { message: run.error } : { message: "The Play reached its runtime limit and was stopped." });
+  const lines = isRuntimeLimitCheckpoint ? runtimeLimitCheckpointLines(packaged, runId, checkpointFailure) : [
     `${status === "completed" ? "\u2713" : status === "failed" ? "\u2717" : "\u2022"} ${status}  ${runId}`
   ];
-  const isRuntimeTimeout = status === "failed" && (readRecordArray(packaged.errors).some(
-    (error) => error.code === "RUNTIME_LIMIT_EXCEEDED"
-  ) || typeof run.error === "string" && /RUNTIME_LIMIT_EXCEEDED/.test(run.error));
-  if (isRuntimeTimeout) {
-    lines.push("  RUNTIME_LIMIT_EXCEEDED: the Play stopped before returning.");
-    lines.push(
-      "  Inspect the dataset catalog below and export saved data before rerunning unfinished work."
-    );
-    lines.push(
-      "  Adjust runtime.timeout in the Play (maximum 4h), remove the override for the 30-minute default, or use fewer rows."
-    );
-  }
   const runError = typeof run.error === "string" && run.error.trim() ? run.error.trim() : null;
-  if (runError && (status === "failed" || status === "cancelled")) {
-    lines.push(`  error: ${truncateErrorForDisplay(runError, runId)}`);
+  const structuredRuntimeLimitMessage = typeof runtimeLimitFailure?.message === "string" && runtimeLimitFailure.message.trim() ? `${typeof runtimeLimitFailure.code === "string" ? runtimeLimitFailure.code : "RUNTIME_LIMIT_EXCEEDED"}: ${runtimeLimitFailure.message.trim()}` : null;
+  const displayRunError = structuredRuntimeLimitMessage ?? runError;
+  if (!isRuntimeLimitCheckpoint && displayRunError && (status === "failed" || status === "cancelled")) {
+    lines.push(`  error: ${truncateErrorForDisplay(displayRunError, runId)}`);
     const stackFrames = authoredPackageStackFrames(packaged);
     if (stackFrames.length > 0) {
       lines.push("  stack:");
@@ -25424,12 +25488,18 @@ function buildRunPackageTextLines(packaged) {
       failedLogAssociation === "retained_before_truncation" ? `  retained logs: ${failedLogNext.logs}` : `  retry failed logs: ${failedLogNext.logs}`
     );
   }
-  if (playName) {
+  if (playName && !isRuntimeLimitCheckpoint) {
     lines.push(`  play: ${playName}`);
   }
-  lines.push(...buildRunActivityTextLines(run));
+  if (!isRuntimeLimitCheckpoint) {
+    lines.push(...buildRunActivityTextLines(run));
+  }
   lines.push(...formatPackageValueOutputLines(packaged));
-  lines.push(...formatPackageDatasetActionLines(packaged));
+  lines.push(
+    ...formatPackageDatasetActionLines(packaged, {
+      includeSummary: !isRuntimeLimitCheckpoint
+    })
+  );
   const next = packaged.next && typeof packaged.next === "object" && !Array.isArray(packaged.next) ? packaged.next : {};
   const billingCommand = actionToCommand(next.billing);
   const logsCommand = actionToCommand(next.logs);
@@ -25437,7 +25507,7 @@ function buildRunPackageTextLines(packaged) {
     const costState = status === "completed" || status === "failed" || status === "cancelled" ? "settles asynchronously \u2014 run the billing command below for totals" : "pending";
     lines.push(`  cost: ${costState}`);
   }
-  for (const step of readRecordArray(packaged.steps).slice(0, 8)) {
+  for (const step of isRuntimeLimitCheckpoint ? [] : readRecordArray(packaged.steps).slice(0, 8)) {
     const id = typeof step.id === "string" ? step.id : "step";
     const kind = typeof step.kind === "string" ? step.kind : "step";
     const stepStatus = typeof step.status === "string" ? step.status : status;
@@ -25470,10 +25540,8 @@ function buildRunPackageTextLines(packaged) {
   if (legacyExportCommand) {
     lines.push(`  export CSV: ${legacyExportCommand}`);
   }
-  if (runAgainCommand) {
-    lines.push(
-      isRuntimeTimeout ? "  run again after adjusting the deadline or batch (compatible completed work may be reused):" : "  run again (completed work is reused):"
-    );
+  if (runAgainCommand && !isRuntimeLimitCheckpoint) {
+    lines.push("  run again (completed work is reused):");
     lines.push(`    ${runAgainCommand}`);
   }
   return lines;

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