deepline 0.3.144 → 0.3.146

package/dist/bundling-sources/shared_libs/play-runtime/scheduler-backends/postgres.ts

@@ -9099,6 +9099,9 @@ export async function directCompletePostgresSchedulerRunnerTerminal(
     input.result,
     { logMetadata: input.completionLogMetadata ?? 'attach' },
   );
+  const resultSummary = terminalRowOutcomesSummary(
+    (input.result as { rowOutcomes?: unknown }).rowOutcomes,
+  );
   const terminalResult = assertTerminalRunResultWithinLimit(terminalOutput);
   const ledgerTerminalResult = terminalRunResultForLedger(terminalResult, {
     content: 'full',
@@ -9352,7 +9355,8 @@ export async function directCompletePostgresSchedulerRunnerTerminal(
           jsonb_build_object(
             'output', $6::jsonb,
             'terminalLogLines', $7::jsonb,
-            'terminalProgressEvents', $8::jsonb
+            'terminalProgressEvents', $8::jsonb,
+            'resultSummary', $16::jsonb
           ),
           ${causalOutboxCreatedAt('run_terminal.run_id', options)}
         FROM run_terminal
@@ -9386,6 +9390,7 @@ export async function directCompletePostgresSchedulerRunnerTerminal(
       input.engineWake.eventName,
       input.engineWake.wakeChannel,
       input.allowCappedCompletion === true,
+      stringifyPostgresJson(resultSummary),
     ],
   );
   if (completed.rows.length > 0) return 'completed';
@@ -11271,6 +11276,7 @@ export async function completePostgresSchedulerAttempt(
     attempt: number;
     leaseToken: string;
     output: unknown;
+    rowOutcomes?: unknown;
     runtimeTiming?: PlayRunnerRuntimeTiming | null;
     terminalLogLines?: readonly string[] | null;
   },
@@ -11280,6 +11286,7 @@ export async function completePostgresSchedulerAttempt(
   const ledgerTerminalResult = terminalRunResultForLedger(terminalResult, {
     content: 'full',
   });
+  const resultSummary = terminalRowOutcomesSummary(input.rowOutcomes);
   const terminalLogLines = (input.terminalLogLines ?? [])
     .map((line) => line.trim())
     .filter(Boolean)
@@ -11458,7 +11465,8 @@ export async function completePostgresSchedulerAttempt(
           'run.completed',
           jsonb_build_object(
             'output', $9::jsonb,
-            'terminalLogLines', $8::jsonb
+            'terminalLogLines', $8::jsonb,
+            'resultSummary', $10::jsonb
           ),
           ${causalOutboxCreatedAt('run_terminal.run_id', options)}
         FROM run_terminal
@@ -11479,6 +11487,7 @@ export async function completePostgresSchedulerAttempt(
       JSON.stringify({ runId: input.runId, status: 'completed' }),
       JSON.stringify(terminalLogLines),
       stringifyPostgresJson(ledgerTerminalResult ?? null),
+      stringifyPostgresJson(resultSummary),
     ],
   );
   if (completed.rows.length === 0) {
@@ -11522,6 +11531,9 @@ export async function failPostgresSchedulerAttempt(
     terminalResult === undefined ? (input.result ?? null) : terminalResult,
     terminalResult === undefined ? {} : { content: 'full' },
   );
+  const resultSummary = terminalRowOutcomesSummary(
+    (input.result as { rowOutcomes?: unknown } | null)?.rowOutcomes,
+  );
   // Keep the recovery tail separate from result: large failures are represented
   // by a result reference, but their customer guidance must still be logged.
   const terminalLogLines = (input.terminalLogLines ?? [])
@@ -11762,7 +11774,8 @@ export async function failPostgresSchedulerAttempt(
           jsonb_build_object(
             'error', $4::jsonb ->> 'message',
             'result', $8::jsonb,
-            'terminalLogLines', $12::jsonb
+            'terminalLogLines', $12::jsonb,
+            'resultSummary', $13::jsonb
           ),
           ${causalOutboxCreatedAt('run_terminal.run_id', options)}
         FROM run_terminal
@@ -11786,6 +11799,7 @@ export async function failPostgresSchedulerAttempt(
       stringifyPostgresJson(input.sandboxCrashDiagnostic ?? null),
       input.preserveRunnerTerminal === true,
       JSON.stringify(terminalLogLines),
+      stringifyPostgresJson(resultSummary),
     ],
   );
   return failed.rows.length > 0;
@@ -12265,6 +12279,23 @@ function finiteRunnerNumber(value: unknown): number | null {
     : null;
 }
 
+function terminalRowOutcomesSummary(value: unknown): {
+  rowOutcomes: Record<string, number>;
+} | null {
+  if (!value || typeof value !== 'object' || Array.isArray(value)) return null;
+  const record = value as Record<string, unknown>;
+  const completedRows = finiteRunnerNumber(record.completedRows);
+  const failedRows = finiteRunnerNumber(record.failedRows);
+  const totalRows = finiteRunnerNumber(record.totalRows);
+  const supersededRows = finiteRunnerNumber(record.supersededRows);
+  const rowOutcomes: Record<string, number> = {};
+  if (completedRows !== null) rowOutcomes.completedRows = completedRows;
+  if (failedRows !== null) rowOutcomes.failedRows = failedRows;
+  if (totalRows !== null) rowOutcomes.totalRows = totalRows;
+  if (supersededRows !== null) rowOutcomes.supersededRows = supersededRows;
+  return Object.keys(rowOutcomes).length > 0 ? { rowOutcomes } : null;
+}
+
 function readPlayRunnerRuntimeTiming(
   value: unknown,
 ): PlayRunnerRuntimeTiming | null {
@@ -12425,6 +12456,18 @@ function attachRunnerWorkProgressMetadata(
   const skipped = finiteRunnerNumber(
     (runnerResult as { skipped?: unknown }).skipped,
   );
+  const runnerRowOutcomes = terminalRowOutcomesSummary(
+    (runnerResult as { rowOutcomes?: unknown }).rowOutcomes,
+  )?.rowOutcomes;
+  const existingRowOutcomes =
+    metadata?.rowOutcomes &&
+    typeof metadata.rowOutcomes === 'object' &&
+    !Array.isArray(metadata.rowOutcomes)
+      ? (metadata.rowOutcomes as Record<string, unknown>)
+      : null;
+  const rowOutcomes = runnerRowOutcomes
+    ? { ...(existingRowOutcomes ?? {}), ...runnerRowOutcomes }
+    : null;
   const logs = Array.isArray((runnerResult as { logs?: unknown }).logs)
     ? (runnerResult as { logs: unknown[] }).logs.filter(
         (line): line is string =>
@@ -12480,6 +12523,7 @@ function attachRunnerWorkProgressMetadata(
     (total === null || skipped === null || metadata?.workProgress) &&
     !runLogTail &&
     !runtimeResources &&
+    !rowOutcomes &&
     mergedOutputWarnings.length === 0
   ) {
     return output;
@@ -12511,6 +12555,7 @@ function attachRunnerWorkProgressMetadata(
     _metadata: {
       ...(metadata ?? {}),
       ...(workProgress ? { workProgress } : {}),
+      ...(rowOutcomes ? { rowOutcomes } : {}),
       ...(runLogTail ? { runLogTail } : {}),
       ...(runtimeResources ? { runtimeResources } : {}),
       ...(mergedOutputWarnings.length > 0
@@ -12608,6 +12653,7 @@ export async function executePostgresSchedulerClaim(
         attempt: claim.attempt,
         leaseToken: claim.leaseToken,
         output: terminalOutput,
+        rowOutcomes: (output as { rowOutcomes?: unknown } | null)?.rowOutcomes,
         runtimeTiming: extractRunnerRuntimeTiming(output),
         terminalLogLines: terminalLogLinesForOutbox(
           output,
@@ -15736,6 +15782,7 @@ export function buildRunLedgerEventsFromPostgresSchedulerOutbox(
       event.runId,
     );
     const lines = stringArrayPayloadField(event.payload, 'terminalLogLines');
+    const resultSummary = payloadField(event.payload, 'resultSummary');
     return [
       ...progressEvents,
       ...(lines.length === 0
@@ -15757,6 +15804,9 @@ export function buildRunLedgerEventsFromPostgresSchedulerOutbox(
         result: terminalRunResultForLedger(
           payloadField(event.payload, 'output'),
         ),
+        ...(resultSummary === undefined || resultSummary === null
+          ? {}
+          : { resultSummary }),
       },
     ];
   }
@@ -15770,6 +15820,7 @@ export function buildRunLedgerEventsFromPostgresSchedulerOutbox(
     const result = terminalRunResultForLedger(
       payloadField(event.payload, 'result'),
     );
+    const resultSummary = payloadField(event.payload, 'resultSummary');
     return [
       ...progressEvents,
       ...(lines.length === 0
@@ -15790,6 +15841,9 @@ export function buildRunLedgerEventsFromPostgresSchedulerOutbox(
         source: 'system',
         error: stringPayloadField(event.payload, 'error'),
         ...(result === null || result === undefined ? {} : { result }),
+        ...(resultSummary === undefined || resultSummary === null
+          ? {}
+          : { resultSummary }),
       },
     ];
   }

package/dist/bundling-sources/shared_libs/play-runtime/step-progress.ts

@@ -25,6 +25,7 @@ export type PlayVisualNodeProgress = {
   activeRows?: number;
   waitingRows?: number;
   completedRows?: number;
+  supersededRows?: number;
   message?: string;
   updatedAt?: number | null;
   startedAt?: number | null;
@@ -129,6 +130,11 @@ export function normalizePlayVisualNodeProgressMap(
       Number.isFinite(rawProgress.completedRows)
         ? rawProgress.completedRows
         : undefined;
+    const supersededRows =
+      typeof rawProgress.supersededRows === 'number' &&
+      Number.isFinite(rawProgress.supersededRows)
+        ? rawProgress.supersededRows
+        : undefined;
     const updatedAt =
       typeof rawProgress.updatedAt === 'number' &&
       Number.isFinite(rawProgress.updatedAt)
@@ -165,6 +171,7 @@ export function normalizePlayVisualNodeProgressMap(
       ...(activeRows !== undefined ? { activeRows } : {}),
       ...(waitingRows !== undefined ? { waitingRows } : {}),
       ...(completedRows !== undefined ? { completedRows } : {}),
+      ...(supersededRows !== undefined ? { supersededRows } : {}),
       ...(updatedAt !== undefined ? { updatedAt } : {}),
       ...(startedAt !== undefined ? { startedAt } : {}),
       ...(completedAt !== undefined ? { completedAt } : {}),

package/dist/bundling-sources/shared_libs/play-runtime/tool-result.ts

@@ -664,6 +664,21 @@ function findFirstTargetByPath(
   return null;
 }
 
+function findFirstExplicitNullTargetByPath(
+  result: unknown,
+  paths: readonly string[] | undefined,
+): ToolResultTargetMetadata | null {
+  for (const path of paths ?? []) {
+    for (const candidate of candidateResultPaths(path)) {
+      const explicitNull = valuesAtSegments(result, parsePath(candidate)).find(
+        (entry) => entry.value === null,
+      );
+      if (explicitNull) return { value: null, path: explicitNull.path };
+    }
+  }
+  return null;
+}
+
 function firstValueForPaths(
   result: unknown,
   paths: readonly string[] | undefined,
@@ -1015,7 +1030,15 @@ function buildTargets(
       continue;
     }
     const fromExtractor = findFirstTargetByPath(result, descriptor.paths);
-    if (!fromExtractor) continue;
+    if (!fromExtractor) {
+      // A declared null is an explicit provider answer, not permission to
+      // guess from a similarly named sibling such as `emailDomain`.
+      const explicitNull = isSemanticStatus
+        ? null
+        : findFirstExplicitNullTargetByPath(result, descriptor.paths);
+      if (explicitNull) targets[target] = explicitNull;
+      continue;
+    }
     const transformed = coerceToEnum(
       applyExtractorTransforms(fromExtractor.value, descriptor),
       descriptor,
@@ -1038,6 +1061,14 @@ function buildTargets(
       targets[target] = fromMetadata;
       continue;
     }
+    const explicitNull = findFirstExplicitNullTargetByPath(
+      result,
+      targetGetters?.[target],
+    );
+    if (explicitNull) {
+      targets[target] = explicitNull;
+      continue;
+    }
     // Declared paths are routinely incomplete against the shape a provider
     // actually returns (zerobounce declares `result.data.email` and answers
     // with `address`), so the key scan stays as the rescue. It is bounded by
@@ -1053,6 +1084,7 @@ function buildTargets(
   }
   if (metadataTargets.size === 0) {
     for (const target of ['email', 'phone', 'linkedin', 'domain', 'status']) {
+      if (targets[target]) continue;
       const found = findFirstTargetByKey(result, target);
       if (found) targets[target] = found;
     }
@@ -1333,8 +1365,8 @@ export function readValue(
   selector: readonly string[] | string,
 ): unknown {
   if (typeof selector === 'string') {
-    const declared = result.extractedValues[selector]?.get();
-    if (declared != null) return declared;
+    const declared = result.extractedValues[selector];
+    if (declared) return declared.get();
   }
   const root = resultRootOf(result);
   const paths = Array.isArray(selector) ? selector : [selector];

package/dist/bundling-sources/shared_libs/play-runtime/worker-api-types.ts

@@ -18,6 +18,7 @@ export type PlayVisualNodeProgress = {
   activeRows?: number;
   waitingRows?: number;
   completedRows?: number;
+  supersededRows?: number;
   message?: string;
   updatedAt?: number;
   startedAt?: number;

package/dist/bundling-sources/shared_libs/plays/tool-result-types.ts

@@ -13,7 +13,17 @@ export type ToolResultBilling = {
   cost_usd?: number;
   /** Missing on historical responses. Pending pricing has no final amount. */
   pricing_status?: 'final' | 'pending';
-  settlement_status?: 'pending' | 'queued' | 'settled' | 'requires_recovery';
+  settlement_status?:
+    | 'pending'
+    | 'queued'
+    | 'settled'
+    | 'released'
+    | 'requires_recovery';
+  billing_outcome_reason?:
+    | 'free_operation'
+    | 'provider_no_billable_result'
+    | 'provider_reported_zero_usage'
+    | 'zero_price';
   estimated_credits?: number;
   estimated_cost_usd?: number;
   /** Preserve additive public pricing details across runtime/deployment skew. */

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.144",
+  version: "0.3.146",
   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
@@ -5313,19 +5313,32 @@ function summarizeRunRowOutcomes(snapshot) {
   let completedRows = 0;
   let failedRows = 0;
   let totalRows = 0;
+  let supersededRows = 0;
   for (const step of Object.values(snapshot.stepsById)) {
     const progress = step.progress;
     if (!progress) continue;
     completedRows += Math.max(0, finiteNumber(progress.completed) ?? 0);
     failedRows += Math.max(0, finiteNumber(progress.failed) ?? 0);
+    supersededRows += Math.max(0, finiteNumber(progress.supersededRows) ?? 0);
     const stepTotal = finiteNumber(progress.total);
-    totalRows += stepTotal !== null && stepTotal >= 0 ? stepTotal : Math.max(0, finiteNumber(progress.completed) ?? 0) + Math.max(0, finiteNumber(progress.failed) ?? 0);
-  }
+    totalRows += stepTotal !== null && stepTotal >= 0 ? stepTotal : Math.max(0, finiteNumber(progress.completed) ?? 0) + Math.max(0, finiteNumber(progress.failed) ?? 0) + Math.max(0, finiteNumber(progress.supersededRows) ?? 0);
+  }
+  const resultSummary = isRecord5(snapshot.resultSummary) ? snapshot.resultSummary : null;
+  const resultRowOutcomes = isRecord5(resultSummary?.rowOutcomes) ? resultSummary.rowOutcomes : null;
+  const terminalCompletedRows = finiteNumber(resultRowOutcomes?.completedRows);
+  const terminalFailedRows = finiteNumber(resultRowOutcomes?.failedRows);
+  const terminalTotalRows = finiteNumber(resultRowOutcomes?.totalRows);
+  const terminalSupersededRows = finiteNumber(
+    resultRowOutcomes?.supersededRows
+  );
+  const settledCompletedRows = terminalCompletedRows ?? completedRows;
+  const settledFailedRows = terminalFailedRows ?? failedRows;
   return {
-    completedRows,
-    failedRows,
-    totalRows,
-    hasRowFailures: failedRows > 0
+    completedRows: settledCompletedRows,
+    failedRows: settledFailedRows,
+    totalRows: terminalTotalRows ?? totalRows,
+    hasRowFailures: settledFailedRows > 0,
+    ...(terminalSupersededRows ?? supersededRows) > 0 ? { supersededRows: terminalSupersededRows ?? supersededRows } : {}
   };
 }
 function createEmptyPlayRunLedgerSnapshot(input2) {
@@ -5483,6 +5496,7 @@ function normalizeStepProgress(value) {
     ...optionalFiniteNumber(value.activeRows) !== void 0 ? { activeRows: optionalFiniteNumber(value.activeRows) } : {},
     ...optionalFiniteNumber(value.waitingRows) !== void 0 ? { waitingRows: optionalFiniteNumber(value.waitingRows) } : {},
     ...optionalFiniteNumber(value.completedRows) !== void 0 ? { completedRows: optionalFiniteNumber(value.completedRows) } : {},
+    ...optionalFiniteNumber(value.supersededRows) !== void 0 ? { supersededRows: optionalFiniteNumber(value.supersededRows) } : {},
     ...optionalString(value.message) ? { message: optionalString(value.message) } : {},
     ...optionalNullableString(value.artifactTableNamespace) !== void 0 ? {
       artifactTableNamespace: optionalNullableString(
@@ -5734,6 +5748,7 @@ function buildSnapshotFromLedger(snapshot) {
       activeRows: step.progress.activeRows,
       waitingRows: step.progress.waitingRows,
       completedRows: step.progress.completedRows,
+      supersededRows: step.progress.supersededRows,
       message: step.progress.message,
       artifactTableNamespace: step.progress.artifactTableNamespace ?? step.artifactTableNamespace ?? null,
       startedAt: step.startedAt ?? null,
@@ -5747,7 +5762,8 @@ function buildSnapshotFromLedger(snapshot) {
     ...step.progress?.nodeIo ? { nodeIo: step.progress.nodeIo } : {}
   }));
   const liveStatus = normalizePlayRunLiveStatus(snapshot.status);
-  const rowOutcomes = isTerminalPlayRunLiveStatus(liveStatus) && Object.keys(snapshot.stepsById).length > 0 ? summarizeRunRowOutcomes(snapshot) : null;
+  const terminalRowOutcomes = isTerminalPlayRunLiveStatus(liveStatus) ? summarizeRunRowOutcomes(snapshot) : null;
+  const rowOutcomes = terminalRowOutcomes && (Object.keys(snapshot.stepsById).length > 0 || terminalRowOutcomes.totalRows > 0 || (terminalRowOutcomes.supersededRows ?? 0) > 0) ? terminalRowOutcomes : null;
   return {
     runId: snapshot.runId,
     status: liveStatus,
@@ -7100,6 +7116,7 @@ var DeeplineClient = class _DeeplineClient {
       invoices: {
         list: (options2) => this.listBillingInvoices(options2)
       },
+      usageEvent: (requestId) => this.getBillingUsageEvent(requestId),
       targetPlans: () => this.getTargetBillingPlans(),
       targetStatus: () => this.getTargetBillingStatus(),
       autoRecharge: {
@@ -7434,7 +7451,7 @@ var DeeplineClient = class _DeeplineClient {
    * guaranteed support for every model. Runtime AI SDK/Gateway errors remain
    * authoritative for model-gated values.
    *
-   * @param model - Gateway model id such as `"openai/gpt-5.5"`
+   * @param model - Exact-case Gateway model id such as `"openai/gpt-5.6-luna"`
    * @returns Model metadata, provider option shapes, and runnable examples
    */
   async describeModel(model) {
@@ -9471,6 +9488,33 @@ var DeeplineClient = class _DeeplineClient {
   async getBillingPlans() {
     return this.http.get("/api/v2/billing/catalog/current");
   }
+  /**
+   * Read the authenticated usage record for one execution request. The
+   * request id comes from the original `executeTool` result and is not a
+   * retry or idempotency token.
+   */
+  async getBillingUsageEvent(requestId) {
+    const normalizedRequestId = requestId.trim();
+    if (normalizedRequestId.length === 0 || normalizedRequestId.length > 200 || normalizedRequestId !== requestId) {
+      throw new DeeplineError(
+        "Usage request_id must contain 1\u2013200 characters with no leading or trailing whitespace.",
+        void 0,
+        "INVALID_USAGE_REQUEST_ID"
+      );
+    }
+    const response = await this.http.get(
+      `/api/v2/usage/events?request_id=${encodeURIComponent(normalizedRequestId)}`
+    );
+    const event = response.entries?.[0];
+    if (!event) {
+      throw new DeeplineError(
+        "No usage event was found for this request_id.",
+        void 0,
+        "USAGE_EVENT_NOT_FOUND"
+      );
+    }
+    return event;
+  }
   /**
    * Charge the saved payment method and add Deepline credits to the active
    * workspace. Prefer `client.billing.topUp(...)`.
@@ -23628,14 +23672,18 @@ function getProgressLinesFromLiveEvent(event) {
   const rowOutcomes = readRowOutcomeSummary({
     rowOutcomes: payload.rowOutcomes
   });
-  if (rowOutcomes?.hasRowFailures) {
+  if (rowOutcomes && (rowOutcomes.hasRowFailures || (rowOutcomes.supersededRows ?? 0) > 0)) {
     const counts = formatProgressCounts({
       completed: rowOutcomes.completedRows,
       total: rowOutcomes.totalRows,
       failed: rowOutcomes.failedRows
     });
-    if (counts) {
-      lines.push(`progress run outcomes: ${counts}`);
+    const outcomeParts = [
+      counts,
+      ...rowOutcomes && (rowOutcomes.supersededRows ?? 0) > 0 ? [formatSupersededRowsNotice(rowOutcomes.supersededRows)] : []
+    ].filter((part) => Boolean(part));
+    if (outcomeParts.length > 0) {
+      lines.push(`progress run outcomes: ${outcomeParts.join(", ")}`);
     }
   }
   return lines;
@@ -24514,9 +24562,13 @@ function buildRunWarnings(status, rowsInfo) {
   const rowOutcomeWarnings = rowOutcomes?.hasRowFailures ? [
     `${status.status === "completed" ? "Run completed" : "Run ended"} with ${formatInteger(rowOutcomes.failedRows)} failed row(s); inspect the persisted failed rows before treating the output as complete.`
   ] : [];
+  const supersededRowNotices = (rowOutcomes?.supersededRows ?? 0) > 0 ? [
+    `Latest-write-wins: ${formatSupersededRowsNotice(rowOutcomes.supersededRows ?? 0)}; the newer write still owns that Runtime Sheet row.`
+  ] : [];
   if (status.status === "completed" && rowsInfo?.totalRows === 0) {
     return [
       ...rowOutcomeWarnings,
+      ...supersededRowNotices,
       "Run completed with 0 output rows.",
       ...outputWarnings
     ];
@@ -24524,11 +24576,12 @@ function buildRunWarnings(status, rowsInfo) {
   if (rowsInfo && !rowsInfo.complete) {
     return [
       ...rowOutcomeWarnings,
+      ...supersededRowNotices,
       `Run output is partial: showing ${rowsInfo.rows.length} preview row(s) of ${rowsInfo.totalRows}.`,
       ...outputWarnings
     ];
   }
-  return [...rowOutcomeWarnings, ...outputWarnings];
+  return [...rowOutcomeWarnings, ...supersededRowNotices, ...outputWarnings];
 }
 function buildRunNextCommands(status) {
   const runId = status.runId?.trim();
@@ -24564,6 +24617,9 @@ function getNumericField(value, key) {
   const field = getRecordField(value, key);
   return typeof field === "number" && Number.isFinite(field) ? field : null;
 }
+function formatSupersededRowsNotice(count) {
+  return `${formatInteger(count)} row${count === 1 ? "" : "s"} skipped because a newer Runtime Sheet write took precedence`;
+}
 function readRowOutcomeSummary(value) {
   const record3 = getRecordField(value, "rowOutcomes");
   if (!record3) return null;
@@ -24574,11 +24630,13 @@ function readRowOutcomeSummary(value) {
     return null;
   }
   const explicitHasFailures = getRecordField(record3, "hasRowFailures");
+  const supersededRows = getNumericField(record3, "supersededRows");
   return {
     completedRows,
     failedRows,
     totalRows,
-    hasRowFailures: typeof explicitHasFailures === "boolean" ? explicitHasFailures : failedRows > 0
+    hasRowFailures: typeof explicitHasFailures === "boolean" ? explicitHasFailures : failedRows > 0,
+    ...supersededRows !== null ? { supersededRows: Math.max(0, supersededRows) } : {}
   };
 }
 function getStringField(value, key) {
@@ -24821,12 +24879,16 @@ function normalizeProgressForEnvelope(status, rowsInfo) {
   const total = rowOutcomes?.totalRows ?? getNumericField(progress, "totalRows") ?? getNumericField(progress, "total") ?? rowsInfo?.totalRows ?? null;
   const failed = rowOutcomes?.failedRows ?? getNumericField(progress, "failed") ?? getNumericField(progress, "failedRows") ?? null;
   const completed = rowOutcomes?.completedRows ?? getNumericField(progress, "completed") ?? getNumericField(progress, "completedRows") ?? (status.status === "completed" ? total : null);
-  const pending = getNumericField(progress, "pending") ?? (typeof total === "number" && typeof completed === "number" && typeof failed === "number" ? Math.max(0, total - completed - failed) : null);
+  const supersededRows = rowOutcomes?.supersededRows ?? getNumericField(progress, "supersededRows");
+  const supersededOffset = supersededRows ?? 0;
+  const progressPending = getNumericField(progress, "pending");
+  const pending = (progressPending !== null ? Math.max(0, progressPending - supersededOffset) : null) ?? (typeof total === "number" && typeof completed === "number" && typeof failed === "number" ? Math.max(0, total - completed - failed - supersededOffset) : null);
   return {
     total,
     totalRows: total,
     completed,
     completedRows: completed,
+    ...supersededRows !== null ? { supersededRows: Math.max(0, supersededRows) } : {},
     pending,
     failed,
     executed: getNumericField(progress, "executed"),
@@ -24957,6 +25019,9 @@ function compactPlayStatus(status) {
         ) : [],
         ...rowOutcomes2.hasRowFailures ? [
           `${status.status === "completed" ? "Run completed" : "Run ended"} with ${formatInteger(rowOutcomes2.failedRows)} failed row(s); inspect the persisted failed rows before treating the output as complete.`
+        ] : [],
+        ...(rowOutcomes2.supersededRows ?? 0) > 0 ? [
+          `Latest-write-wins: ${formatSupersededRowsNotice(rowOutcomes2.supersededRows ?? 0)}; the newer write still owns that Runtime Sheet row.`
         ] : []
       ]
     } : packaged;
@@ -47911,7 +47976,7 @@ Examples:
   deepline tools describe hunter_email_verifier --schema-only
   deepline tools describe hunter_email_verifier --examples-only
   deepline tools describe hunter_email_verifier --json
-  deepline tools describe deeplineagent --model openai/gpt-5.5 --json
+  deepline tools describe deeplineagent --model openai/gpt-5.6-luna --json
   deepline tools describe ai_inference --estimate-payload @payload.json --json
   deepline tools describe ai_evaluate --estimate-payload @payload.json --json
   deepline tools execute hunter_email_verifier --input '{"email":"a@b.com"}'
@@ -47957,9 +48022,11 @@ Notes:
   waterfalls, row maps, checkpoints, and retries.
   Calling a provider-backed tool can spend Deepline credits. Use --json for the
   stable result payload plus output preview and debugging helpers.
+  --timeout sets this CLI request's HTTP deadline; it does not cancel provider work.
 
 Examples:
   deepline tools execute hunter_email_verifier --input '{"email":"a@b.com"}'
+  deepline tools execute bounceban_verify_bulk --input @batch.json --timeout 10m --json
   deepline tools execute hunter_email_verifier -p email=a@b.com
   deepline tools execute test_rate_limit --input '{"key":"smoke"}' --timeout 90s --json
   deepline tools execute test_rate_limit --input '{"key":"smoke"}' --json | jq '.status'
@@ -47984,7 +48051,7 @@ Examples:
     "Merge a JSON object or @file path into the tool params"
   ).option(
     "--timeout <duration>",
-    "Execution HTTP deadline (for example 90s, 5m, or 1h; bare numbers are seconds)"
+    "Client-side HTTP deadline (for example 90s, 5m, or 1h; bare numbers are seconds); it does not cancel provider work"
   ).option(
     "--output-format <format>",
     "Output format: auto, csv, csv_file, json, or json_file"
@@ -49609,6 +49676,7 @@ async function executeTool(args) {
     return 2;
   }
   const rawResponse = await client2.executeTool(parsed.toolId, parsed.params, {
+    ...parsed.timeoutMs !== void 0 ? { timeout: parsed.timeoutMs } : {},
     responseIntent: parsed.outPath || parsed.outputFormat === "csv" || parsed.outputFormat === "csv_file" ? "row_artifact" : "raw",
     ...parsed.timeoutMs !== void 0 ? { timeout: parsed.timeoutMs } : {}
   });