deepline 0.3.145 → 0.3.147

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

@@ -264,7 +264,9 @@ const POSTGRES_SCHEDULER_SCHEMA_INIT_STATEMENT_TIMEOUT_MS = 60_000;
 // v44 moves the v39-v43 shared-schema expansion onto the online, statement-
 // scoped migration path. The reader contract is unchanged; the marker ensures
 // deployment retries do not re-enter the old cross-table DDL transaction.
-export const POSTGRES_SCHEDULER_SCHEMA_VERSION = 44;
+// v45 adds the bucket-leading expiration index used by rate-reservation
+// cleanup. Shared schemas build it concurrently through the deploy migrator.
+export const POSTGRES_SCHEDULER_SCHEMA_VERSION = 45;
 const POSTGRES_SCHEDULER_SCHEMA_MIGRATIONS_TABLE =
   'scheduler_schema_migrations';
 export const POSTGRES_SCHEDULER_OPEN_RECOVERY_INDEX =
@@ -1829,6 +1831,15 @@ export async function hasCurrentPostgresSchedulerSchemaShape(
             AND index_class.relname = 'runtime_scheduler_runs_terminal_finished_idx'
             AND index_row.indrelid = to_regclass($4)
             AND index_row.indisready AND index_row.indisvalid
+        )
+        AND EXISTS (
+          SELECT 1 FROM pg_index AS index_row
+          JOIN pg_class AS index_class ON index_class.oid = index_row.indexrelid
+          JOIN pg_namespace AS index_namespace ON index_namespace.oid = index_class.relnamespace
+          WHERE index_namespace.nspname = $1
+            AND index_class.relname = 'runtime_scheduler_rate_reservation_bucket_expiry_idx'
+            AND index_row.indrelid = to_regclass($9)
+            AND index_row.indisready AND index_row.indisvalid
         ) AS ready
     `,
     [
@@ -1840,6 +1851,7 @@ export async function hasCurrentPostgresSchedulerSchemaShape(
       requirements.blockedOutboxIndex !== false,
       `${quotedSchema}.${quoteIdent('sandbox_cleanup_jobs_v2')}`,
       `${quotedSchema}.${quoteIdent('compute_billing_jobs_v2')}`,
+      `${quotedSchema}.${quoteIdent('rate_reservations')}`,
     ],
   );
   return runtimeAdminIndexes.rows[0]?.ready === true;
@@ -3434,7 +3446,10 @@ export async function ensurePostgresSchedulerSchema(
     END
     $$
   `);
-    await ensurePostgresRateStateSchema(client, options);
+    await ensurePostgresRateStateSchema(client, {
+      schema,
+      deferReservationBucketExpiryIndex: options?.deferRuntimeAdminIndexes,
+    });
     await ensurePostgresBudgetStateSchema(client, {
       schedulerSchema: schemaName(options),
     });
@@ -3792,6 +3807,11 @@ const POSTGRES_SCHEDULER_RUNTIME_ADMIN_INDEXES = [
       WHERE status IN ('completed', 'failed', 'cancelled')
         AND started_at IS NOT NULL`,
   },
+  {
+    name: 'runtime_scheduler_rate_reservation_bucket_expiry_idx',
+    table: 'rate_reservations',
+    definition: `(bucket_id, expires_at_ms)`,
+  },
 ] as const;
 
 async function readPostgresSchedulerIndexState(
@@ -3824,7 +3844,7 @@ async function readPostgresSchedulerIndexState(
 }
 
 /**
- * Remove interrupted dashboard index builds from a quiesced run-scoped
+ * Remove interrupted deploy-owned index builds from a quiesced run-scoped
  * schema so transactional CREATE INDEX IF NOT EXISTS can recreate them.
  * Shared schemas must use the concurrent repair path below.
  */
@@ -3848,9 +3868,9 @@ export async function repairInvalidRunScopedRuntimeAdminIndexes(
 }
 
 /**
- * The Runtime Workers dashboard and bounded delivered-outbox retention rely on
- * these indexes. Deploy owns the builds because the live scheduler tables are
- * too large for request or worker startup to run blocking DDL.
+ * Runtime health surfaces, bounded retention, and hot-path cleanup rely on
+ * these indexes. Deploy owns the builds because live scheduler tables are too
+ * large for request or worker startup to run blocking DDL.
  */
 export async function ensurePostgresSchedulerRuntimeAdminIndexesConcurrently(
   client: PostgresSchedulerQueryClient,
@@ -3882,7 +3902,7 @@ export async function ensurePostgresSchedulerRuntimeAdminIndexesConcurrently(
     );
     if (installed.kind !== 'ready') {
       throw new Error(
-        `Runtime scheduler dashboard index ${schema}.${index.name} is not valid and ready after concurrent creation.`,
+        `Runtime scheduler index ${schema}.${index.name} is not valid and ready after concurrent creation.`,
       );
     }
   }
@@ -9099,6 +9119,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 +9375,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 +9410,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 +11296,7 @@ export async function completePostgresSchedulerAttempt(
     attempt: number;
     leaseToken: string;
     output: unknown;
+    rowOutcomes?: unknown;
     runtimeTiming?: PlayRunnerRuntimeTiming | null;
     terminalLogLines?: readonly string[] | null;
   },
@@ -11280,6 +11306,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 +11485,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 +11507,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 +11551,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 +11794,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 +11819,7 @@ export async function failPostgresSchedulerAttempt(
       stringifyPostgresJson(input.sandboxCrashDiagnostic ?? null),
       input.preserveRunnerTerminal === true,
       JSON.stringify(terminalLogLines),
+      stringifyPostgresJson(resultSummary),
     ],
   );
   return failed.rows.length > 0;
@@ -12265,6 +12299,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 +12476,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 +12543,7 @@ function attachRunnerWorkProgressMetadata(
     (total === null || skipped === null || metadata?.workProgress) &&
     !runLogTail &&
     !runtimeResources &&
+    !rowOutcomes &&
     mergedOutputWarnings.length === 0
   ) {
     return output;
@@ -12511,6 +12575,7 @@ function attachRunnerWorkProgressMetadata(
     _metadata: {
       ...(metadata ?? {}),
       ...(workProgress ? { workProgress } : {}),
+      ...(rowOutcomes ? { rowOutcomes } : {}),
       ...(runLogTail ? { runLogTail } : {}),
       ...(runtimeResources ? { runtimeResources } : {}),
       ...(mergedOutputWarnings.length > 0
@@ -12608,6 +12673,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 +15802,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 +15824,9 @@ export function buildRunLedgerEventsFromPostgresSchedulerOutbox(
         result: terminalRunResultForLedger(
           payloadField(event.payload, 'output'),
         ),
+        ...(resultSummary === undefined || resultSummary === null
+          ? {}
+          : { resultSummary }),
       },
     ];
   }
@@ -15770,6 +15840,7 @@ export function buildRunLedgerEventsFromPostgresSchedulerOutbox(
     const result = terminalRunResultForLedger(
       payloadField(event.payload, 'result'),
     );
+    const resultSummary = payloadField(event.payload, 'resultSummary');
     return [
       ...progressEvents,
       ...(lines.length === 0
@@ -15790,6 +15861,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/test-runtime-seams.ts

@@ -202,11 +202,15 @@ export function runtimeSheetPageTailWriteMarkerEvent(
   ) {
     return null;
   }
+  const at = new Date().toISOString();
   return {
     type: 'log',
-    at: new Date().toISOString(),
+    at,
     source: 'play',
-    line: `[runtime.sheet-page-tail-write] phase=start table=${tableNamespace} rows=${rows.length}`,
+    // The status projection currently exposes the durable log line without
+    // the event envelope's `at`. Keep the emission time in the line so the
+    // runtime-preview proof can measure delayed projection accurately.
+    line: `[${at}] [runtime.sheet-page-tail-write] phase=start table=${tableNamespace} rows=${rows.length}`,
   };
 }
 

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/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.145",
+  version: "0.3.147",
   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,
@@ -7435,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) {
@@ -23656,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;
@@ -24542,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
     ];
@@ -24552,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();
@@ -24592,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;
@@ -24602,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) {
@@ -24849,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"),
@@ -24985,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;
@@ -47939,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"}'
@@ -47985,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'
@@ -48012,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"
@@ -49637,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 } : {}
   });