deepline 0.3.219 → 0.3.220

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.219',
+  version: '0.3.220',
   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/activity-observation.ts

@@ -237,7 +237,14 @@ export function derivePlayActivityVisibility(input: {
   }
   if (state.kind === 'queued' || state.kind === 'scheduled') return 'headline';
   if (state.kind === 'retrying') {
-    return state.retryAt - input.now <= 30_000 ? 'hidden' : 'timeline';
+    if (
+      state.reason === 'rate_limit' &&
+      input.observation.target.kind === 'capacity'
+    ) {
+      return 'headline';
+    }
+    if (state.retryAt - input.now <= 30_000) return 'hidden';
+    return state.reason === 'rate_limit' ? 'headline' : 'timeline';
   }
   if (state.kind === 'active') return 'headline';
   return 'timeline';
@@ -292,6 +299,9 @@ export function summarizePlayActivity(
       }
       return `Paused: ${label}; the legacy producer did not report a typed reason.`;
     case 'retrying':
+      if (state.reason === 'rate_limit') {
+        return `Waiting for ${label} request capacity; the run will retry automatically.`;
+      }
       return `Delayed: ${label} will retry automatically.`;
     case 'scheduled':
       return `Scheduled: ${label} will resume automatically.`;
@@ -397,9 +407,19 @@ export function projectPlayRunActivity(input: {
     return null;
   }
 
-  const explicit = [...(input.explicit ?? [])]
+  const latestExplicit = [...(input.explicit ?? [])]
     .filter((candidate) => !isTerminalActivityState(candidate.state))
     .sort((left, right) => right.observedAt - left.observedAt)[0];
+  // A provider wait is an observation, not a permanent run state. Once its
+  // deadline has passed, use the current lifecycle/step facts until the next
+  // producer observation arrives instead of claiming the old hold persists.
+  const explicit =
+    latestExplicit?.target.kind === 'capacity' &&
+    latestExplicit.target.pool === 'provider' &&
+    latestExplicit.state.kind === 'retrying' &&
+    latestExplicit.state.retryAt < now
+      ? null
+      : latestExplicit;
   if (explicit) return projection(explicit, now);
 
   if (input.waitKind === 'detached_runner') {

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

@@ -11525,6 +11525,15 @@ export class PlayContextImpl implements ScalarPlayAuthoringRuntimeContext {
           })}`,
           { level: 'warn' },
         );
+        // The ordinary provider sleep emits this below. A mixed event/provider
+        // suspension takes the event-batch path instead, so report its one
+        // aggregate provider hold here rather than once for every waiting row.
+        if (uniqueBoundaries.length > 0) {
+          this.observeProviderCapacityWait(
+            earliestHold.provider,
+            providerWakeAtMs,
+          );
+        }
       }
       this.pendingRowEventBoundaries = [];
       if (uniqueBoundaries.length > 0) {
@@ -14582,6 +14591,26 @@ export class PlayContextImpl implements ScalarPlayAuthoringRuntimeContext {
     );
   }
 
+  private observeProviderCapacityWait(
+    provider: string,
+    retryAtMs: number,
+  ): void {
+    const observedAt = Date.now();
+    this.emitExecutionEvent({
+      type: 'activity.observed',
+      observation: {
+        activityId: `capacity:provider:${provider}`,
+        target: { kind: 'capacity', pool: 'provider', label: provider },
+        state: {
+          kind: 'retrying',
+          reason: 'rate_limit',
+          retryAt: Math.max(observedAt, retryAtMs),
+        },
+        observedAt,
+      },
+    });
+  }
+
   private async waitForProviderBackpressure(
     provider: string,
     retryAtMs: number,
@@ -14633,6 +14662,7 @@ export class PlayContextImpl implements ScalarPlayAuthoringRuntimeContext {
       })}`,
       { level: 'warn' },
     );
+    this.observeProviderCapacityWait(provider, Date.now() + delayMs);
     this.suspendDurably({ kind: 'sleep', boundaryId, delayMs });
   }
 

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.219",
+  version: "0.3.220",
   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
@@ -5121,7 +5121,11 @@ function derivePlayActivityVisibility(input2) {
   }
   if (state.kind === "queued" || state.kind === "scheduled") return "headline";
   if (state.kind === "retrying") {
-    return state.retryAt - input2.now <= 3e4 ? "hidden" : "timeline";
+    if (state.reason === "rate_limit" && input2.observation.target.kind === "capacity") {
+      return "headline";
+    }
+    if (state.retryAt - input2.now <= 3e4) return "hidden";
+    return state.reason === "rate_limit" ? "headline" : "timeline";
   }
   if (state.kind === "active") return "headline";
   return "timeline";
@@ -5166,6 +5170,9 @@ function summarizePlayActivity(observation) {
       }
       return `Paused: ${label}; the legacy producer did not report a typed reason.`;
     case "retrying":
+      if (state.reason === "rate_limit") {
+        return `Waiting for ${label} request capacity; the run will retry automatically.`;
+      }
       return `Delayed: ${label} will retry automatically.`;
     case "scheduled":
       return `Scheduled: ${label} will resume automatically.`;
@@ -5193,7 +5200,8 @@ function projectPlayRunActivity(input2) {
   if (normalizedStatus === "completed" || normalizedStatus === "failed" || normalizedStatus === "cancelled" || normalizedStatus === "terminated" || normalizedStatus === "timed_out") {
     return null;
   }
-  const explicit = [...input2.explicit ?? []].filter((candidate) => !isTerminalActivityState(candidate.state)).sort((left, right) => right.observedAt - left.observedAt)[0];
+  const latestExplicit = [...input2.explicit ?? []].filter((candidate) => !isTerminalActivityState(candidate.state)).sort((left, right) => right.observedAt - left.observedAt)[0];
+  const explicit = latestExplicit?.target.kind === "capacity" && latestExplicit.target.pool === "provider" && latestExplicit.state.kind === "retrying" && latestExplicit.state.retryAt < now ? null : latestExplicit;
   if (explicit) return projection(explicit, now);
   if (input2.waitKind === "detached_runner") {
     return projection(
@@ -25833,6 +25841,15 @@ function formatPlayLogLine(rawLine, status, state) {
   }) : null;
   const message = timestampMatch?.[2] ?? line;
   const prefix = timestamp ? `${timestamp} ` : "";
+  if (!state.verbose && isProviderRowWaitLogLine(line)) return null;
+  const providerWait = formatProviderCapacityWaitLogLine(line);
+  if (providerWait && !state.verbose) {
+    return logLevelReaches("warn", state.logLevel ?? "info") ? `${prefix}${providerWait}` : null;
+  }
+  const mapProgress = formatMapProgressDiagnosticLogLine(line);
+  if (mapProgress && !state.verbose) {
+    return logLevelReaches("info", state.logLevel ?? "info") ? `${prefix}${mapProgress}` : null;
+  }
   if (/\[worker\] picked up run\b/.test(message)) {
     if (!logLevelReaches("info", state.logLevel ?? "info")) {
       return null;
@@ -25874,6 +25891,59 @@ function formatPlayLogLine(rawLine, status, state) {
   }
   return `${prefix}${message}`;
 }
+function runtimeLogMessage(line) {
+  const timestampMatch = line.match(/^\[([^\]]+)\]\s*(.*)$/);
+  const message = timestampMatch && !Number.isNaN(Date.parse(timestampMatch[1])) ? timestampMatch[2] : line;
+  return message.replace(/^\[(?:debug|info|warn|error)\]\s*/i, "");
+}
+function isProviderRowWaitLogLine(line) {
+  return /^\[runtime\.provider\.row_wait\]\s+\{/.test(runtimeLogMessage(line));
+}
+function formatProviderCapacityWaitLogLine(line) {
+  const match = runtimeLogMessage(line).match(
+    /^\[runtime\.provider\.(map_wait|row_wait|wait)\]\s+(\{.*\})$/
+  );
+  if (!match) return null;
+  let details;
+  try {
+    const parsed = JSON.parse(match[2]);
+    const record3 = readRecord(parsed);
+    if (!record3) return null;
+    details = record3;
+  } catch {
+    return null;
+  }
+  const provider = typeof details.provider === "string" ? details.provider.trim() : "";
+  const retryAt = typeof details.retry_at === "string" ? isoTimestamp(details.retry_at) : null;
+  if (!provider || !retryAt) return null;
+  const waitingRows = readNonNegativeInteger(details.waiting_rows);
+  return `Waiting for ${provider} request capacity` + (waitingRows === null ? "" : `; ${formatInteger(waitingRows)} rows waiting`) + `; next attempt scheduled for ${retryAt}`;
+}
+function formatMapProgressDiagnosticLogLine(line) {
+  const match = runtimeLogMessage(line).match(
+    /^\[runtime\.map_(heartbeat|stall)\]\s+(\{.*\})$/
+  );
+  if (!match) return null;
+  let details;
+  try {
+    const parsed = JSON.parse(match[2]);
+    const record3 = readRecord(parsed);
+    if (!record3) return null;
+    details = record3;
+  } catch {
+    return null;
+  }
+  const map = typeof details.map === "string" ? details.map.trim() : "";
+  if (!map) return null;
+  if (match[1] === "stall") {
+    return `No rows completed during the last observation window in ${map}.`;
+  }
+  const settled = readNonNegativeInteger(details.rows_settled);
+  const active = readNonNegativeInteger(details.rows_active);
+  const waiting = readNonNegativeInteger(details.rows_waiting);
+  if (settled === null || active === null || waiting === null) return null;
+  return `${map}: ${formatInteger(settled)} rows completed, ${formatInteger(active)} active, ${formatInteger(waiting)} waiting.`;
+}
 function isDatasetResultEnvelope(value) {
   return value !== null && typeof value === "object" && !Array.isArray(value) && value.kind === "dataset";
 }
@@ -26710,6 +26780,23 @@ function formatPackageDatasetActionLines(packaged, options) {
   const returned = packageReturnedDatasetIdentity(packaged);
   const includeSummary = options?.includeSummary ?? true;
   const lines = [];
+  const steps = readRecordArray(packaged.steps);
+  const stepsByDatasetId = /* @__PURE__ */ new Map();
+  const stepsByPath = /* @__PURE__ */ new Map();
+  const stepsByNamespace = /* @__PURE__ */ new Map();
+  for (const step of steps) {
+    if (step.kind !== "dataset") continue;
+    const output2 = readRecord(step.output);
+    if (typeof output2?.datasetId === "string") {
+      stepsByDatasetId.set(output2.datasetId, step);
+    }
+    if (typeof output2?.path === "string") {
+      stepsByPath.set(output2.path, step);
+    }
+    if (typeof step.id === "string") {
+      stepsByNamespace.set(step.id, step);
+    }
+  }
   for (const dataset of packageDatasetRecords(packaged)) {
     const path = typeof dataset.path === "string" && dataset.path.trim() ? dataset.path.trim() : "dataset";
     const datasetId = typeof dataset.datasetId === "string" ? dataset.datasetId.trim() : "";
@@ -26722,7 +26809,7 @@ function formatPackageDatasetActionLines(packaged, options) {
     const actions = readRecord(dataset.actions) ?? {};
     if (countUnconfirmed) {
       lines.push(
-        `  dataset ${path}: row count unconfirmed (at least ${formatInteger(persistedLowerBound)} persisted); export this run to inspect saved rows`
+        `  dataset ${path}: row count unconfirmed (at least ${formatInteger(persistedLowerBound)} persisted)`
       );
     } else if (includeSummary) {
       if (category === "recovered" && Object.keys(actions).length === 0) {
@@ -26735,21 +26822,50 @@ function formatPackageDatasetActionLines(packaged, options) {
         );
       }
     }
+    const step = (datasetId ? stepsByDatasetId.get(datasetId) : void 0) ?? stepsByPath.get(path) ?? (typeof dataset.tableNamespace === "string" ? stepsByNamespace.get(dataset.tableNamespace) : void 0);
+    const progress = readRecord(step?.progress);
+    if (progress) {
+      const executed = readNonNegativeInteger(progress.executed);
+      const total = readNonNegativeInteger(progress.total);
+      const reused = readNonNegativeInteger(progress.reused);
+      const pending = readNonNegativeInteger(progress.pending);
+      const active = readNonNegativeInteger(progress.activeRows);
+      const parts = [
+        executed === null ? "executed unknown" : `${formatInteger(executed)}${total === null ? "" : `/${formatInteger(total)}`} executed`,
+        ...reused === null || reused === 0 ? [] : [`${formatInteger(reused)} reused`],
+        ...pending === null ? [] : [`${formatInteger(pending)} pending`],
+        ...active === null ? [] : [`${formatInteger(active)} active`]
+      ];
+      lines.push(`    progress: ${parts.join(" \xB7 ")}`);
+    }
+    if (lifecycle) {
+      const succeeded = readNonNegativeInteger(lifecycle.succeededRowsAtLeast);
+      const failed = readNonNegativeInteger(lifecycle.failedRowsAtLeast);
+      const complete = lifecycle.complete === true;
+      lines.push(
+        `    saved: ${complete ? "" : "at least "}${formatInteger(persistedLowerBound)} persisted${succeeded === null ? "" : ` \xB7 ${complete ? "" : "at least "}${formatInteger(succeeded)} succeeded`}${failed === null ? "" : ` \xB7 ${complete ? "" : "at least "}${formatInteger(failed)} failed`}`
+      );
+    }
     const exportAction = readRecord(actions.exportCsv);
     const exportCommand = actionToCommand(exportAction);
     const exportScope = readRecord(exportAction?.scope);
+    const queryAction = readRecord(actions.query);
+    const queryScope = readRecord(queryAction?.scope);
+    const runQueryCommand = queryScope?.kind === "run" ? actionToCommand(queryAction) : null;
     const currentQueryCommand = actionToCommand(actions.queryCurrentTable);
     const legacyQueryCommand = actionToCommand(actions.query);
+    if (runQueryCommand) {
+      lines.push(`    query rows from this run: ${runQueryCommand}`);
+    } else if (currentQueryCommand) {
+      lines.push(`    query current table: ${currentQueryCommand}`);
+    } else if (legacyQueryCommand) {
+      lines.push(`    query run rows (legacy): ${legacyQueryCommand}`);
+    }
     if (exportCommand) {
       lines.push(
         exportScope?.kind === "database" ? `    export current table (may include other runs): ${exportCommand}` : `    export this run: ${exportCommand}`
       );
     }
-    if (currentQueryCommand) {
-      lines.push(`    query current table: ${currentQueryCommand}`);
-    } else if (legacyQueryCommand) {
-      lines.push(`    query run rows (legacy): ${legacyQueryCommand}`);
-    }
     const unavailable = readRecord(dataset.exportUnavailable);
     if (typeof unavailable?.reason === "string" && typeof unavailable.message === "string") {
       lines.push(
@@ -26813,12 +26929,42 @@ function formatInlinePackageValue(value) {
 function formatPackageValueOutputLines(packaged) {
   const outputs = packaged.outputs && typeof packaged.outputs === "object" && !Array.isArray(packaged.outputs) ? packaged.outputs : null;
   if (!outputs) return [];
-  const valueOutputs = Object.entries(outputs).filter(([, output2]) => {
-    return output2 && typeof output2 === "object" && !Array.isArray(output2) && output2.kind === "value" && Object.prototype.hasOwnProperty.call(output2, "value");
-  });
-  if (valueOutputs.length === 0) return [];
-  const lines = ["  outputs:"];
-  for (const [name, output2] of valueOutputs.slice(0, 8)) {
+  const returned = Object.entries(outputs).filter(([, output2]) => {
+    const record3 = readRecord(output2);
+    return record3?.kind === "dataset" || record3?.kind === "value" && Object.prototype.hasOwnProperty.call(record3, "value");
+  });
+  if (returned.length === 0) return [];
+  const datasets = packageDatasetRecords(packaged);
+  const datasetSteps = readRecordArray(packaged.steps).filter(
+    (step) => step.kind === "dataset"
+  );
+  const lines = ["  result:"];
+  for (const [name, rawOutput] of returned.slice(0, 8)) {
+    const output2 = readRecord(rawOutput);
+    if (output2.kind === "dataset") {
+      const path = typeof output2.dataset === "string" ? output2.dataset : name;
+      const rowCount = readNonNegativeInteger(output2.rowCount);
+      lines.push(
+        `    ${name}: dataset ${path}${rowCount === null ? "" : ` (${formatInteger(rowCount)} persisted rows)`}`
+      );
+      const dataset = datasets.find(
+        (candidate) => typeof output2.datasetId === "string" && candidate.datasetId === output2.datasetId || candidate.path === path
+      );
+      const stepOutput = datasetSteps.map((step) => readRecord(step.output)).find(
+        (candidate) => typeof output2.datasetId === "string" && candidate?.datasetId === output2.datasetId || candidate?.path === path
+      );
+      const preview = readRecord(stepOutput?.preview ?? dataset?.preview);
+      const rows = Array.isArray(preview?.rows) ? preview.rows.slice(0, 2) : [];
+      if (rows.length > 0) {
+        lines.push(`      sample rows (${rows.length}):`);
+        lines.push(
+          ...rows.map(
+            (row) => `        ${clampJsonPreviewText(JSON.stringify(row) ?? String(row), 350)}`
+          )
+        );
+      }
+      continue;
+    }
     const value = output2.value;
     const compacted = compactReturnValue(value);
     if (compacted && typeof compacted === "object") {
@@ -26828,8 +26974,8 @@ function formatPackageValueOutputLines(packaged) {
       lines.push(`    ${name}: ${formatInlinePackageValue(value)}`);
     }
   }
-  if (valueOutputs.length > 8) {
-    lines.push(`    ... ${valueOutputs.length - 8} more output(s)`);
+  if (returned.length > 8) {
+    lines.push(`    ... ${returned.length - 8} more output(s)`);
   }
   return lines;
 }
@@ -26885,9 +27031,9 @@ function buildRunActivityTextLines(run) {
   const reason = readRecord(state.reason);
   if (kind === "retrying") {
     const attempt = typeof state.attempt === "number" ? ` (attempt ${state.attempt})` : "";
-    const why = typeof state.reason === "string" ? ` after ${state.reason}` : "";
+    const why = typeof state.reason === "string" && state.reason !== "rate_limit" ? ` after ${state.reason}` : "";
     lines.push(
-      `  next retry: ${activityIsoTimestamp(state.retryAt) ?? "unknown"}${why}${attempt}`
+      `  ${state.reason === "rate_limit" ? "next attempt" : "next retry"}: ${activityIsoTimestamp(state.retryAt) ?? "unknown"}${why}${attempt}`
     );
   } else if (kind === "scheduled") {
     lines.push(
@@ -26946,16 +27092,65 @@ function buildRunStatusEvidenceTextLines(packaged) {
   }
   return lines;
 }
-function buildRecentRunLogTextLines(packaged) {
-  const logs = readRecord(packaged.logs);
-  const tail = Array.isArray(logs?.tail) ? logs.tail.filter((line) => typeof line === "string") : [];
+function formatRunTimingTextLines(run) {
+  const time = (value) => typeof value === "number" || typeof value === "string" ? isoTimestamp(value) : null;
+  const accepted = time(run.acceptedAt);
+  const started = time(run.startedAt);
+  const updated = time(run.updatedAt);
+  const finished = time(run.finishedAt);
+  const duration = typeof run.durationMs === "number" && Number.isFinite(run.durationMs) ? Math.max(0, Math.round(run.durationMs / 1e3)) : null;
+  const age = (value) => {
+    if (typeof value !== "number" || !Number.isFinite(value)) return null;
+    const seconds = Math.floor((Date.now() - value) / 1e3);
+    if (seconds < 0) return null;
+    if (seconds < 60) return `${seconds}s`;
+    if (seconds < 3600) return `${Math.floor(seconds / 60)}m ${seconds % 60}s`;
+    if (seconds < 86400)
+      return `${Math.floor(seconds / 3600)}h ${Math.floor(seconds % 3600 / 60)}m`;
+    return `${Math.floor(seconds / 86400)}d`;
+  };
+  const active = run.status === "running" || run.status === "queued" || run.status === "waiting";
+  const elapsed = active ? age(run.startedAt) : null;
+  const updateAge = active ? age(run.updatedAt) : null;
+  if (!accepted && !started && !updated && !finished && duration === null)
+    return [];
+  return [
+    `  time: ${[
+      ...accepted ? [`accepted ${accepted}`] : [],
+      ...started ? [`started ${started}`] : [],
+      ...updated ? [`updated ${updated}`] : [],
+      ...finished ? [`finished ${finished}`] : [],
+      ...duration === null ? [] : [`duration ${duration}s`],
+      ...elapsed ? [`elapsed ${elapsed}`] : [],
+      ...updateAge ? [`last update ${updateAge} ago`] : []
+    ].join(" \xB7 ")}`
+  ];
+}
+function formatRecentRunLogLines(value) {
+  const logs = readRecord(value);
+  if (!logs || !Array.isArray(logs.tail)) return [];
+  const tail = logs.tail.filter(
+    (line) => typeof line === "string"
+  );
   if (tail.length === 0) return [];
-  const visible = tail.slice(-5);
-  const total = typeof logs?.totalCount === "number" && Number.isFinite(logs.totalCount) ? ` of ${formatInteger(logs.totalCount)}` : "";
-  const lines = [`  recent logs: showing ${visible.length}${total}`];
-  lines.push(...visible.map((line) => `    ${line}`));
-  if (logs?.truncated === true) {
-    lines.push("    older log lines were truncated by the retention cap");
+  const shown = tail.map((line) => classifyLogLine(line)).filter(
+    (entry) => entry.level !== "debug" && !isProviderRowWaitLogLine(entry.line)
+  ).slice(-8);
+  const total = readNonNegativeInteger(logs.totalCount);
+  if (shown.length === 0) {
+    return [
+      `  recent logs: no non-debug lines in the retained preview (${total === null ? "total unknown" : `${formatInteger(total)} total`})`,
+      ...logs.truncated === true ? ["    [older log bodies lost to retention limit]"] : []
+    ];
+  }
+  const lines = [
+    `  recent logs (${total === null ? "count unknown" : `${formatInteger(total)} total`}; showing ${shown.length}):`,
+    ...shown.map(
+      (entry) => `    ${clampJsonPreviewText(formatProviderCapacityWaitLogLine(entry.line) ?? formatMapProgressDiagnosticLogLine(entry.line) ?? entry.line, 350)}`
+    )
+  ];
+  if (logs.truncated === true) {
+    lines.push("    [older log bodies lost to retention limit]");
   }
   return lines;
 }
@@ -27025,17 +27220,18 @@ function buildRunPackageTextLines(packaged) {
   if (playName && !isRuntimeLimitCheckpoint) {
     lines.push(`  play: ${playName}`);
   }
+  lines.push(...formatRunTimingTextLines(run));
   if (!isRuntimeLimitCheckpoint) {
     lines.push(...buildRunActivityTextLines(run));
   }
   lines.push(...buildRunStatusEvidenceTextLines(packaged));
-  lines.push(...buildRecentRunLogTextLines(packaged));
   lines.push(...formatPackageValueOutputLines(packaged));
   lines.push(
     ...formatPackageDatasetActionLines(packaged, {
       includeSummary: !isRuntimeLimitCheckpoint
     })
   );
+  lines.push(...formatRecentRunLogLines(packaged.logs));
   const next = packaged.next && typeof packaged.next === "object" && !Array.isArray(packaged.next) ? packaged.next : {};
   const logsCommand = actionToCommand(next.logs);
   for (const step of isRuntimeLimitCheckpoint ? [] : readRecordArray(packaged.steps).slice(0, 8)) {
@@ -29738,6 +29934,7 @@ async function handleRunTail(args) {
   const jsonLines = args.includes("--jsonl");
   const jsonOutput = !jsonLines && argsWantJson(args);
   const compact = args.includes("--compact");
+  const showLiveLogs = debug || hasExplicitLogLevel || !jsonOutput && !compact;
   const compactState = {
     lastLogIndex: 0,
     emittedRunnerStarted: false,
@@ -29757,8 +29954,8 @@ async function handleRunTail(args) {
         })}
 `
       );
-    } : compact || debug || hasExplicitLogLevel ? (event) => {
-      if (debug || hasExplicitLogLevel) {
+    } : compact || showLiveLogs ? (event) => {
+      if (showLiveLogs) {
         for (const line of getLogLinesFromLiveEvent(event)) {
           const formatted = formatPlayLogLine(
             line,
@@ -31962,7 +32159,9 @@ Examples:
     "after",
     `
 Notes:
-  Full run status read. Use --full --json when debugging raw stream/status fields.
+  Shows per-dataset progress, recorded Deepline usage, recent logs, and the
+  returned result when present. Registered sheets offer a run-scoped query
+  without reading or creating dataset rows. Use --full --json for raw detail.
   Use --input only when you intentionally need the original payload; it can
   contain customer data and is never included in ordinary status output.
 
@@ -32070,8 +32269,9 @@ Examples:
     "after",
     `
 Notes:
-  Streams live run events until the stream ends. Use get for current status and
-  logs for persisted log history. In human output, --compact prints deduplicated
+  Streams live run events until the stream ends. Human output shows info and
+  warning logs as they arrive. Use get for current status and logs for persisted
+  log history. In human output, --compact prints deduplicated
   step transitions and progress instead of the full event stream. --json emits
   one terminal package. --jsonl emits canonical live events as JSON Lines and
   ends with the same compact package shape as runs get --json. --log-level

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.219",
+  version: "0.3.220",
   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
@@ -5116,7 +5116,11 @@ function derivePlayActivityVisibility(input2) {
   }
   if (state.kind === "queued" || state.kind === "scheduled") return "headline";
   if (state.kind === "retrying") {
-    return state.retryAt - input2.now <= 3e4 ? "hidden" : "timeline";
+    if (state.reason === "rate_limit" && input2.observation.target.kind === "capacity") {
+      return "headline";
+    }
+    if (state.retryAt - input2.now <= 3e4) return "hidden";
+    return state.reason === "rate_limit" ? "headline" : "timeline";
   }
   if (state.kind === "active") return "headline";
   return "timeline";
@@ -5161,6 +5165,9 @@ function summarizePlayActivity(observation) {
       }
       return `Paused: ${label}; the legacy producer did not report a typed reason.`;
     case "retrying":
+      if (state.reason === "rate_limit") {
+        return `Waiting for ${label} request capacity; the run will retry automatically.`;
+      }
       return `Delayed: ${label} will retry automatically.`;
     case "scheduled":
       return `Scheduled: ${label} will resume automatically.`;
@@ -5188,7 +5195,8 @@ function projectPlayRunActivity(input2) {
   if (normalizedStatus === "completed" || normalizedStatus === "failed" || normalizedStatus === "cancelled" || normalizedStatus === "terminated" || normalizedStatus === "timed_out") {
     return null;
   }
-  const explicit = [...input2.explicit ?? []].filter((candidate) => !isTerminalActivityState(candidate.state)).sort((left, right) => right.observedAt - left.observedAt)[0];
+  const latestExplicit = [...input2.explicit ?? []].filter((candidate) => !isTerminalActivityState(candidate.state)).sort((left, right) => right.observedAt - left.observedAt)[0];
+  const explicit = latestExplicit?.target.kind === "capacity" && latestExplicit.target.pool === "provider" && latestExplicit.state.kind === "retrying" && latestExplicit.state.retryAt < now ? null : latestExplicit;
   if (explicit) return projection(explicit, now);
   if (input2.waitKind === "detached_runner") {
     return projection(
@@ -25906,6 +25914,15 @@ function formatPlayLogLine(rawLine, status, state) {
   }) : null;
   const message = timestampMatch?.[2] ?? line;
   const prefix = timestamp ? `${timestamp} ` : "";
+  if (!state.verbose && isProviderRowWaitLogLine(line)) return null;
+  const providerWait = formatProviderCapacityWaitLogLine(line);
+  if (providerWait && !state.verbose) {
+    return logLevelReaches("warn", state.logLevel ?? "info") ? `${prefix}${providerWait}` : null;
+  }
+  const mapProgress = formatMapProgressDiagnosticLogLine(line);
+  if (mapProgress && !state.verbose) {
+    return logLevelReaches("info", state.logLevel ?? "info") ? `${prefix}${mapProgress}` : null;
+  }
   if (/\[worker\] picked up run\b/.test(message)) {
     if (!logLevelReaches("info", state.logLevel ?? "info")) {
       return null;
@@ -25947,6 +25964,59 @@ function formatPlayLogLine(rawLine, status, state) {
   }
   return `${prefix}${message}`;
 }
+function runtimeLogMessage(line) {
+  const timestampMatch = line.match(/^\[([^\]]+)\]\s*(.*)$/);
+  const message = timestampMatch && !Number.isNaN(Date.parse(timestampMatch[1])) ? timestampMatch[2] : line;
+  return message.replace(/^\[(?:debug|info|warn|error)\]\s*/i, "");
+}
+function isProviderRowWaitLogLine(line) {
+  return /^\[runtime\.provider\.row_wait\]\s+\{/.test(runtimeLogMessage(line));
+}
+function formatProviderCapacityWaitLogLine(line) {
+  const match = runtimeLogMessage(line).match(
+    /^\[runtime\.provider\.(map_wait|row_wait|wait)\]\s+(\{.*\})$/
+  );
+  if (!match) return null;
+  let details;
+  try {
+    const parsed = JSON.parse(match[2]);
+    const record3 = readRecord(parsed);
+    if (!record3) return null;
+    details = record3;
+  } catch {
+    return null;
+  }
+  const provider = typeof details.provider === "string" ? details.provider.trim() : "";
+  const retryAt = typeof details.retry_at === "string" ? isoTimestamp(details.retry_at) : null;
+  if (!provider || !retryAt) return null;
+  const waitingRows = readNonNegativeInteger(details.waiting_rows);
+  return `Waiting for ${provider} request capacity` + (waitingRows === null ? "" : `; ${formatInteger(waitingRows)} rows waiting`) + `; next attempt scheduled for ${retryAt}`;
+}
+function formatMapProgressDiagnosticLogLine(line) {
+  const match = runtimeLogMessage(line).match(
+    /^\[runtime\.map_(heartbeat|stall)\]\s+(\{.*\})$/
+  );
+  if (!match) return null;
+  let details;
+  try {
+    const parsed = JSON.parse(match[2]);
+    const record3 = readRecord(parsed);
+    if (!record3) return null;
+    details = record3;
+  } catch {
+    return null;
+  }
+  const map = typeof details.map === "string" ? details.map.trim() : "";
+  if (!map) return null;
+  if (match[1] === "stall") {
+    return `No rows completed during the last observation window in ${map}.`;
+  }
+  const settled = readNonNegativeInteger(details.rows_settled);
+  const active = readNonNegativeInteger(details.rows_active);
+  const waiting = readNonNegativeInteger(details.rows_waiting);
+  if (settled === null || active === null || waiting === null) return null;
+  return `${map}: ${formatInteger(settled)} rows completed, ${formatInteger(active)} active, ${formatInteger(waiting)} waiting.`;
+}
 function isDatasetResultEnvelope(value) {
   return value !== null && typeof value === "object" && !Array.isArray(value) && value.kind === "dataset";
 }
@@ -26783,6 +26853,23 @@ function formatPackageDatasetActionLines(packaged, options) {
   const returned = packageReturnedDatasetIdentity(packaged);
   const includeSummary = options?.includeSummary ?? true;
   const lines = [];
+  const steps = readRecordArray(packaged.steps);
+  const stepsByDatasetId = /* @__PURE__ */ new Map();
+  const stepsByPath = /* @__PURE__ */ new Map();
+  const stepsByNamespace = /* @__PURE__ */ new Map();
+  for (const step of steps) {
+    if (step.kind !== "dataset") continue;
+    const output2 = readRecord(step.output);
+    if (typeof output2?.datasetId === "string") {
+      stepsByDatasetId.set(output2.datasetId, step);
+    }
+    if (typeof output2?.path === "string") {
+      stepsByPath.set(output2.path, step);
+    }
+    if (typeof step.id === "string") {
+      stepsByNamespace.set(step.id, step);
+    }
+  }
   for (const dataset of packageDatasetRecords(packaged)) {
     const path = typeof dataset.path === "string" && dataset.path.trim() ? dataset.path.trim() : "dataset";
     const datasetId = typeof dataset.datasetId === "string" ? dataset.datasetId.trim() : "";
@@ -26795,7 +26882,7 @@ function formatPackageDatasetActionLines(packaged, options) {
     const actions = readRecord(dataset.actions) ?? {};
     if (countUnconfirmed) {
       lines.push(
-        `  dataset ${path}: row count unconfirmed (at least ${formatInteger(persistedLowerBound)} persisted); export this run to inspect saved rows`
+        `  dataset ${path}: row count unconfirmed (at least ${formatInteger(persistedLowerBound)} persisted)`
       );
     } else if (includeSummary) {
       if (category === "recovered" && Object.keys(actions).length === 0) {
@@ -26808,21 +26895,50 @@ function formatPackageDatasetActionLines(packaged, options) {
         );
       }
     }
+    const step = (datasetId ? stepsByDatasetId.get(datasetId) : void 0) ?? stepsByPath.get(path) ?? (typeof dataset.tableNamespace === "string" ? stepsByNamespace.get(dataset.tableNamespace) : void 0);
+    const progress = readRecord(step?.progress);
+    if (progress) {
+      const executed = readNonNegativeInteger(progress.executed);
+      const total = readNonNegativeInteger(progress.total);
+      const reused = readNonNegativeInteger(progress.reused);
+      const pending = readNonNegativeInteger(progress.pending);
+      const active = readNonNegativeInteger(progress.activeRows);
+      const parts = [
+        executed === null ? "executed unknown" : `${formatInteger(executed)}${total === null ? "" : `/${formatInteger(total)}`} executed`,
+        ...reused === null || reused === 0 ? [] : [`${formatInteger(reused)} reused`],
+        ...pending === null ? [] : [`${formatInteger(pending)} pending`],
+        ...active === null ? [] : [`${formatInteger(active)} active`]
+      ];
+      lines.push(`    progress: ${parts.join(" \xB7 ")}`);
+    }
+    if (lifecycle) {
+      const succeeded = readNonNegativeInteger(lifecycle.succeededRowsAtLeast);
+      const failed = readNonNegativeInteger(lifecycle.failedRowsAtLeast);
+      const complete = lifecycle.complete === true;
+      lines.push(
+        `    saved: ${complete ? "" : "at least "}${formatInteger(persistedLowerBound)} persisted${succeeded === null ? "" : ` \xB7 ${complete ? "" : "at least "}${formatInteger(succeeded)} succeeded`}${failed === null ? "" : ` \xB7 ${complete ? "" : "at least "}${formatInteger(failed)} failed`}`
+      );
+    }
     const exportAction = readRecord(actions.exportCsv);
     const exportCommand = actionToCommand(exportAction);
     const exportScope = readRecord(exportAction?.scope);
+    const queryAction = readRecord(actions.query);
+    const queryScope = readRecord(queryAction?.scope);
+    const runQueryCommand = queryScope?.kind === "run" ? actionToCommand(queryAction) : null;
     const currentQueryCommand = actionToCommand(actions.queryCurrentTable);
     const legacyQueryCommand = actionToCommand(actions.query);
+    if (runQueryCommand) {
+      lines.push(`    query rows from this run: ${runQueryCommand}`);
+    } else if (currentQueryCommand) {
+      lines.push(`    query current table: ${currentQueryCommand}`);
+    } else if (legacyQueryCommand) {
+      lines.push(`    query run rows (legacy): ${legacyQueryCommand}`);
+    }
     if (exportCommand) {
       lines.push(
         exportScope?.kind === "database" ? `    export current table (may include other runs): ${exportCommand}` : `    export this run: ${exportCommand}`
       );
     }
-    if (currentQueryCommand) {
-      lines.push(`    query current table: ${currentQueryCommand}`);
-    } else if (legacyQueryCommand) {
-      lines.push(`    query run rows (legacy): ${legacyQueryCommand}`);
-    }
     const unavailable = readRecord(dataset.exportUnavailable);
     if (typeof unavailable?.reason === "string" && typeof unavailable.message === "string") {
       lines.push(
@@ -26886,12 +27002,42 @@ function formatInlinePackageValue(value) {
 function formatPackageValueOutputLines(packaged) {
   const outputs = packaged.outputs && typeof packaged.outputs === "object" && !Array.isArray(packaged.outputs) ? packaged.outputs : null;
   if (!outputs) return [];
-  const valueOutputs = Object.entries(outputs).filter(([, output2]) => {
-    return output2 && typeof output2 === "object" && !Array.isArray(output2) && output2.kind === "value" && Object.prototype.hasOwnProperty.call(output2, "value");
-  });
-  if (valueOutputs.length === 0) return [];
-  const lines = ["  outputs:"];
-  for (const [name, output2] of valueOutputs.slice(0, 8)) {
+  const returned = Object.entries(outputs).filter(([, output2]) => {
+    const record3 = readRecord(output2);
+    return record3?.kind === "dataset" || record3?.kind === "value" && Object.prototype.hasOwnProperty.call(record3, "value");
+  });
+  if (returned.length === 0) return [];
+  const datasets = packageDatasetRecords(packaged);
+  const datasetSteps = readRecordArray(packaged.steps).filter(
+    (step) => step.kind === "dataset"
+  );
+  const lines = ["  result:"];
+  for (const [name, rawOutput] of returned.slice(0, 8)) {
+    const output2 = readRecord(rawOutput);
+    if (output2.kind === "dataset") {
+      const path = typeof output2.dataset === "string" ? output2.dataset : name;
+      const rowCount = readNonNegativeInteger(output2.rowCount);
+      lines.push(
+        `    ${name}: dataset ${path}${rowCount === null ? "" : ` (${formatInteger(rowCount)} persisted rows)`}`
+      );
+      const dataset = datasets.find(
+        (candidate) => typeof output2.datasetId === "string" && candidate.datasetId === output2.datasetId || candidate.path === path
+      );
+      const stepOutput = datasetSteps.map((step) => readRecord(step.output)).find(
+        (candidate) => typeof output2.datasetId === "string" && candidate?.datasetId === output2.datasetId || candidate?.path === path
+      );
+      const preview = readRecord(stepOutput?.preview ?? dataset?.preview);
+      const rows = Array.isArray(preview?.rows) ? preview.rows.slice(0, 2) : [];
+      if (rows.length > 0) {
+        lines.push(`      sample rows (${rows.length}):`);
+        lines.push(
+          ...rows.map(
+            (row) => `        ${clampJsonPreviewText(JSON.stringify(row) ?? String(row), 350)}`
+          )
+        );
+      }
+      continue;
+    }
     const value = output2.value;
     const compacted = compactReturnValue(value);
     if (compacted && typeof compacted === "object") {
@@ -26901,8 +27047,8 @@ function formatPackageValueOutputLines(packaged) {
       lines.push(`    ${name}: ${formatInlinePackageValue(value)}`);
     }
   }
-  if (valueOutputs.length > 8) {
-    lines.push(`    ... ${valueOutputs.length - 8} more output(s)`);
+  if (returned.length > 8) {
+    lines.push(`    ... ${returned.length - 8} more output(s)`);
   }
   return lines;
 }
@@ -26958,9 +27104,9 @@ function buildRunActivityTextLines(run) {
   const reason = readRecord(state.reason);
   if (kind === "retrying") {
     const attempt = typeof state.attempt === "number" ? ` (attempt ${state.attempt})` : "";
-    const why = typeof state.reason === "string" ? ` after ${state.reason}` : "";
+    const why = typeof state.reason === "string" && state.reason !== "rate_limit" ? ` after ${state.reason}` : "";
     lines.push(
-      `  next retry: ${activityIsoTimestamp(state.retryAt) ?? "unknown"}${why}${attempt}`
+      `  ${state.reason === "rate_limit" ? "next attempt" : "next retry"}: ${activityIsoTimestamp(state.retryAt) ?? "unknown"}${why}${attempt}`
     );
   } else if (kind === "scheduled") {
     lines.push(
@@ -27019,16 +27165,65 @@ function buildRunStatusEvidenceTextLines(packaged) {
   }
   return lines;
 }
-function buildRecentRunLogTextLines(packaged) {
-  const logs = readRecord(packaged.logs);
-  const tail = Array.isArray(logs?.tail) ? logs.tail.filter((line) => typeof line === "string") : [];
+function formatRunTimingTextLines(run) {
+  const time = (value) => typeof value === "number" || typeof value === "string" ? isoTimestamp(value) : null;
+  const accepted = time(run.acceptedAt);
+  const started = time(run.startedAt);
+  const updated = time(run.updatedAt);
+  const finished = time(run.finishedAt);
+  const duration = typeof run.durationMs === "number" && Number.isFinite(run.durationMs) ? Math.max(0, Math.round(run.durationMs / 1e3)) : null;
+  const age = (value) => {
+    if (typeof value !== "number" || !Number.isFinite(value)) return null;
+    const seconds = Math.floor((Date.now() - value) / 1e3);
+    if (seconds < 0) return null;
+    if (seconds < 60) return `${seconds}s`;
+    if (seconds < 3600) return `${Math.floor(seconds / 60)}m ${seconds % 60}s`;
+    if (seconds < 86400)
+      return `${Math.floor(seconds / 3600)}h ${Math.floor(seconds % 3600 / 60)}m`;
+    return `${Math.floor(seconds / 86400)}d`;
+  };
+  const active = run.status === "running" || run.status === "queued" || run.status === "waiting";
+  const elapsed = active ? age(run.startedAt) : null;
+  const updateAge = active ? age(run.updatedAt) : null;
+  if (!accepted && !started && !updated && !finished && duration === null)
+    return [];
+  return [
+    `  time: ${[
+      ...accepted ? [`accepted ${accepted}`] : [],
+      ...started ? [`started ${started}`] : [],
+      ...updated ? [`updated ${updated}`] : [],
+      ...finished ? [`finished ${finished}`] : [],
+      ...duration === null ? [] : [`duration ${duration}s`],
+      ...elapsed ? [`elapsed ${elapsed}`] : [],
+      ...updateAge ? [`last update ${updateAge} ago`] : []
+    ].join(" \xB7 ")}`
+  ];
+}
+function formatRecentRunLogLines(value) {
+  const logs = readRecord(value);
+  if (!logs || !Array.isArray(logs.tail)) return [];
+  const tail = logs.tail.filter(
+    (line) => typeof line === "string"
+  );
   if (tail.length === 0) return [];
-  const visible = tail.slice(-5);
-  const total = typeof logs?.totalCount === "number" && Number.isFinite(logs.totalCount) ? ` of ${formatInteger(logs.totalCount)}` : "";
-  const lines = [`  recent logs: showing ${visible.length}${total}`];
-  lines.push(...visible.map((line) => `    ${line}`));
-  if (logs?.truncated === true) {
-    lines.push("    older log lines were truncated by the retention cap");
+  const shown = tail.map((line) => classifyLogLine(line)).filter(
+    (entry) => entry.level !== "debug" && !isProviderRowWaitLogLine(entry.line)
+  ).slice(-8);
+  const total = readNonNegativeInteger(logs.totalCount);
+  if (shown.length === 0) {
+    return [
+      `  recent logs: no non-debug lines in the retained preview (${total === null ? "total unknown" : `${formatInteger(total)} total`})`,
+      ...logs.truncated === true ? ["    [older log bodies lost to retention limit]"] : []
+    ];
+  }
+  const lines = [
+    `  recent logs (${total === null ? "count unknown" : `${formatInteger(total)} total`}; showing ${shown.length}):`,
+    ...shown.map(
+      (entry) => `    ${clampJsonPreviewText(formatProviderCapacityWaitLogLine(entry.line) ?? formatMapProgressDiagnosticLogLine(entry.line) ?? entry.line, 350)}`
+    )
+  ];
+  if (logs.truncated === true) {
+    lines.push("    [older log bodies lost to retention limit]");
   }
   return lines;
 }
@@ -27098,17 +27293,18 @@ function buildRunPackageTextLines(packaged) {
   if (playName && !isRuntimeLimitCheckpoint) {
     lines.push(`  play: ${playName}`);
   }
+  lines.push(...formatRunTimingTextLines(run));
   if (!isRuntimeLimitCheckpoint) {
     lines.push(...buildRunActivityTextLines(run));
   }
   lines.push(...buildRunStatusEvidenceTextLines(packaged));
-  lines.push(...buildRecentRunLogTextLines(packaged));
   lines.push(...formatPackageValueOutputLines(packaged));
   lines.push(
     ...formatPackageDatasetActionLines(packaged, {
       includeSummary: !isRuntimeLimitCheckpoint
     })
   );
+  lines.push(...formatRecentRunLogLines(packaged.logs));
   const next = packaged.next && typeof packaged.next === "object" && !Array.isArray(packaged.next) ? packaged.next : {};
   const logsCommand = actionToCommand(next.logs);
   for (const step of isRuntimeLimitCheckpoint ? [] : readRecordArray(packaged.steps).slice(0, 8)) {
@@ -29811,6 +30007,7 @@ async function handleRunTail(args) {
   const jsonLines = args.includes("--jsonl");
   const jsonOutput = !jsonLines && argsWantJson(args);
   const compact = args.includes("--compact");
+  const showLiveLogs = debug || hasExplicitLogLevel || !jsonOutput && !compact;
   const compactState = {
     lastLogIndex: 0,
     emittedRunnerStarted: false,
@@ -29830,8 +30027,8 @@ async function handleRunTail(args) {
         })}
 `
       );
-    } : compact || debug || hasExplicitLogLevel ? (event) => {
-      if (debug || hasExplicitLogLevel) {
+    } : compact || showLiveLogs ? (event) => {
+      if (showLiveLogs) {
         for (const line of getLogLinesFromLiveEvent(event)) {
           const formatted = formatPlayLogLine(
             line,
@@ -32035,7 +32232,9 @@ Examples:
     "after",
     `
 Notes:
-  Full run status read. Use --full --json when debugging raw stream/status fields.
+  Shows per-dataset progress, recorded Deepline usage, recent logs, and the
+  returned result when present. Registered sheets offer a run-scoped query
+  without reading or creating dataset rows. Use --full --json for raw detail.
   Use --input only when you intentionally need the original payload; it can
   contain customer data and is never included in ordinary status output.
 
@@ -32143,8 +32342,9 @@ Examples:
     "after",
     `
 Notes:
-  Streams live run events until the stream ends. Use get for current status and
-  logs for persisted log history. In human output, --compact prints deduplicated
+  Streams live run events until the stream ends. Human output shows info and
+  warning logs as they arrive. Use get for current status and logs for persisted
+  log history. In human output, --compact prints deduplicated
   step transitions and progress instead of the full event stream. --json emits
   one terminal package. --jsonl emits canonical live events as JSON Lines and
   ends with the same compact package shape as runs get --json. --log-level

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.219",
+  version: "0.3.220",
   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
@@ -2872,7 +2872,11 @@ function derivePlayActivityVisibility(input) {
   }
   if (state.kind === "queued" || state.kind === "scheduled") return "headline";
   if (state.kind === "retrying") {
-    return state.retryAt - input.now <= 3e4 ? "hidden" : "timeline";
+    if (state.reason === "rate_limit" && input.observation.target.kind === "capacity") {
+      return "headline";
+    }
+    if (state.retryAt - input.now <= 3e4) return "hidden";
+    return state.reason === "rate_limit" ? "headline" : "timeline";
   }
   if (state.kind === "active") return "headline";
   return "timeline";
@@ -2917,6 +2921,9 @@ function summarizePlayActivity(observation) {
       }
       return `Paused: ${label}; the legacy producer did not report a typed reason.`;
     case "retrying":
+      if (state.reason === "rate_limit") {
+        return `Waiting for ${label} request capacity; the run will retry automatically.`;
+      }
       return `Delayed: ${label} will retry automatically.`;
     case "scheduled":
       return `Scheduled: ${label} will resume automatically.`;
@@ -2944,7 +2951,8 @@ function projectPlayRunActivity(input) {
   if (normalizedStatus === "completed" || normalizedStatus === "failed" || normalizedStatus === "cancelled" || normalizedStatus === "terminated" || normalizedStatus === "timed_out") {
     return null;
   }
-  const explicit = [...input.explicit ?? []].filter((candidate) => !isTerminalActivityState(candidate.state)).sort((left, right) => right.observedAt - left.observedAt)[0];
+  const latestExplicit = [...input.explicit ?? []].filter((candidate) => !isTerminalActivityState(candidate.state)).sort((left, right) => right.observedAt - left.observedAt)[0];
+  const explicit = latestExplicit?.target.kind === "capacity" && latestExplicit.target.pool === "provider" && latestExplicit.state.kind === "retrying" && latestExplicit.state.retryAt < now ? null : latestExplicit;
   if (explicit) return projection(explicit, now);
   if (input.waitKind === "detached_runner") {
     return projection(

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.219",
+  version: "0.3.220",
   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
@@ -2776,7 +2776,11 @@ function derivePlayActivityVisibility(input) {
   }
   if (state.kind === "queued" || state.kind === "scheduled") return "headline";
   if (state.kind === "retrying") {
-    return state.retryAt - input.now <= 3e4 ? "hidden" : "timeline";
+    if (state.reason === "rate_limit" && input.observation.target.kind === "capacity") {
+      return "headline";
+    }
+    if (state.retryAt - input.now <= 3e4) return "hidden";
+    return state.reason === "rate_limit" ? "headline" : "timeline";
   }
   if (state.kind === "active") return "headline";
   return "timeline";
@@ -2821,6 +2825,9 @@ function summarizePlayActivity(observation) {
       }
       return `Paused: ${label}; the legacy producer did not report a typed reason.`;
     case "retrying":
+      if (state.reason === "rate_limit") {
+        return `Waiting for ${label} request capacity; the run will retry automatically.`;
+      }
       return `Delayed: ${label} will retry automatically.`;
     case "scheduled":
       return `Scheduled: ${label} will resume automatically.`;
@@ -2848,7 +2855,8 @@ function projectPlayRunActivity(input) {
   if (normalizedStatus === "completed" || normalizedStatus === "failed" || normalizedStatus === "cancelled" || normalizedStatus === "terminated" || normalizedStatus === "timed_out") {
     return null;
   }
-  const explicit = [...input.explicit ?? []].filter((candidate) => !isTerminalActivityState(candidate.state)).sort((left, right) => right.observedAt - left.observedAt)[0];
+  const latestExplicit = [...input.explicit ?? []].filter((candidate) => !isTerminalActivityState(candidate.state)).sort((left, right) => right.observedAt - left.observedAt)[0];
+  const explicit = latestExplicit?.target.kind === "capacity" && latestExplicit.target.pool === "provider" && latestExplicit.state.kind === "retrying" && latestExplicit.state.retryAt < now ? null : latestExplicit;
   if (explicit) return projection(explicit, now);
   if (input.waitKind === "detached_runner") {
     return projection(

package/dist/release.d.mts

@@ -149,7 +149,7 @@ type SdkRelease = {
     supportPolicy: SdkSupportPolicy;
 };
 declare const SDK_RELEASE: {
-    readonly version: "0.3.219";
+    readonly version: "0.3.220";
     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.219";
+    readonly version: "0.3.220";
     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.219",
+  version: "0.3.220",
   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.219",
+  version: "0.3.220",
   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.219",
+  "version": "0.3.220",
   "description": "GTM data CLI and TypeScript SDK for coding agents",
   "license": "MIT",
   "homepage": "https://code.deepline.com",