deepline 0.3.134 → 0.3.136

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.134',
+  version: '0.3.136',
   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/plays/deploy/run-deployment.ts

@@ -1000,7 +1000,7 @@ export async function runDeployment(
       if (!project) {
         // A directory deploy of a repo-owned play: live now differs from
         // that repository, and a later push from it will replace this.
-        return `This play is deployed from ${owner}. This directory deploy made a different revision live, so it is marked drifted from ${owner} until that repository deploys again.`;
+        return `This play is deployed from ${owner}. This directory deploy made a different revision live, so it is marked drifted from ${owner} until that repository deploys again. If you are done with ${owner}, unlink it (deepline git unlink <id>) and this play is released from it.`;
       }
       return `This play was deployed from ${owner} and now deploys from ${project.repoFullName}. Taking it over was allowed because the old deployment target is disabled; re-enabling that target will not give the play back — its deploys will fail on this name instead.`;
     };

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.134",
+  version: "0.3.136",
   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
@@ -21189,7 +21189,7 @@ async function runDeployment(params, hooks) {
       const owner = state2?.playProjectRepo;
       if (!owner || owner === project?.repoFullName) return void 0;
       if (!project) {
-        return `This play is deployed from ${owner}. This directory deploy made a different revision live, so it is marked drifted from ${owner} until that repository deploys again.`;
+        return `This play is deployed from ${owner}. This directory deploy made a different revision live, so it is marked drifted from ${owner} until that repository deploys again. If you are done with ${owner}, unlink it (deepline git unlink <id>) and this play is released from it.`;
       }
       return `This play was deployed from ${owner} and now deploys from ${project.repoFullName}. Taking it over was allowed because the old deployment target is disabled; re-enabling that target will not give the play back \u2014 its deploys will fail on this name instead.`;
     };
@@ -21812,7 +21812,8 @@ async function handleUnlink(id, options) {
           {
             title: "unlinked",
             lines: [
-              `Repository link ${id} removed. Deployments stop immediately and in-flight deploy credentials die; live plays keep running.`
+              `Repository link ${id} removed. Deployments stop immediately and in-flight deploy credentials die; live plays keep running.`,
+              "Plays this repository deployed are released: they keep their live version, stop showing it as their source, and are no longer marked drifted from it."
             ]
           }
         ]
@@ -21978,7 +21979,9 @@ Examples:
       disabled: options.enabled === true ? false : options.disabled === true ? true : void 0
     })
   );
-  git.command("unlink").description("Unlink a repository (live plays keep running).").argument("<id>", "Repository link id").option("--json", "Emit JSON output").action(
+  git.command("unlink").description(
+    "Unlink a repository (live plays keep running, and are released from it)."
+  ).argument("<id>", "Repository link id").option("--json", "Emit JSON output").action(
     async (id, options) => handleUnlink(id, options)
   );
   git.command("deployments").description("Deployment history; pass an id for one deployment.").argument("[id]", "Deployment id (omit to list)").option("--repo <id>", "Filter to one repository link").option("--limit <n>", "Max rows (default 50)").option("--json", "Emit JSON output").action(
@@ -24714,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(
@@ -24722,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");
@@ -24789,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) {
@@ -25141,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";
@@ -25151,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);
@@ -25184,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);
@@ -25295,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:");
@@ -25349,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);
@@ -25362,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;
@@ -25395,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.134",
+  version: "0.3.136",
   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
@@ -21261,7 +21261,7 @@ async function runDeployment(params, hooks) {
       const owner = state2?.playProjectRepo;
       if (!owner || owner === project?.repoFullName) return void 0;
       if (!project) {
-        return `This play is deployed from ${owner}. This directory deploy made a different revision live, so it is marked drifted from ${owner} until that repository deploys again.`;
+        return `This play is deployed from ${owner}. This directory deploy made a different revision live, so it is marked drifted from ${owner} until that repository deploys again. If you are done with ${owner}, unlink it (deepline git unlink <id>) and this play is released from it.`;
       }
       return `This play was deployed from ${owner} and now deploys from ${project.repoFullName}. Taking it over was allowed because the old deployment target is disabled; re-enabling that target will not give the play back \u2014 its deploys will fail on this name instead.`;
     };
@@ -21884,7 +21884,8 @@ async function handleUnlink(id, options) {
           {
             title: "unlinked",
             lines: [
-              `Repository link ${id} removed. Deployments stop immediately and in-flight deploy credentials die; live plays keep running.`
+              `Repository link ${id} removed. Deployments stop immediately and in-flight deploy credentials die; live plays keep running.`,
+              "Plays this repository deployed are released: they keep their live version, stop showing it as their source, and are no longer marked drifted from it."
             ]
           }
         ]
@@ -22050,7 +22051,9 @@ Examples:
       disabled: options.enabled === true ? false : options.disabled === true ? true : void 0
     })
   );
-  git.command("unlink").description("Unlink a repository (live plays keep running).").argument("<id>", "Repository link id").option("--json", "Emit JSON output").action(
+  git.command("unlink").description(
+    "Unlink a repository (live plays keep running, and are released from it)."
+  ).argument("<id>", "Repository link id").option("--json", "Emit JSON output").action(
     async (id, options) => handleUnlink(id, options)
   );
   git.command("deployments").description("Deployment history; pass an id for one deployment.").argument("[id]", "Deployment id (omit to list)").option("--repo <id>", "Filter to one repository link").option("--limit <n>", "Max rows (default 50)").option("--json", "Emit JSON output").action(
@@ -24786,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(
@@ -24794,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");
@@ -24861,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) {
@@ -25213,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";
@@ -25223,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);
@@ -25256,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);
@@ -25367,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:");
@@ -25421,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);
@@ -25434,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;
@@ -25467,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.134",
+  version: "0.3.136",
   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.134",
+  version: "0.3.136",
   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.134";
+    readonly version: "0.3.136";
     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.134";
+    readonly version: "0.3.136";
     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.134",
+  version: "0.3.136",
   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.134",
+  version: "0.3.136",
   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.134",
+  "version": "0.3.136",
   "description": "GTM data CLI and TypeScript SDK for coding agents",
   "license": "MIT",
   "homepage": "https://code.deepline.com",