deepline 0.3.184 → 0.3.186

package/dist/bundling-sources/shared_libs/play-runtime/tool-execute-retry-policy.ts

@@ -29,6 +29,8 @@ export const TOOL_EXECUTE_CONCURRENCY_BACKPRESSURE_MAX_ATTEMPTS = 65;
 // for an operation that has not opted into ordinary transient-5xx retries.
 // Keep its window aligned with other local control-plane queue signals.
 export const TOOL_EXECUTE_RUNTIME_SCHEDULER_CAPACITY_MAX_ATTEMPTS = 65;
+/** Re-admission after a stale shared provider permit is safely replayable. */
+export const TOOL_EXECUTE_PROVIDER_PACING_WAIT_MAX_ATTEMPTS = 65;
 export const TOOL_EXECUTE_TRANSPORT_MAX_ATTEMPTS = 3;
 export const TOOL_EXECUTE_TRANSPORT_RETRY_DELAY_MS = 1_000;
 export const TOOL_EXECUTE_RETRY_DELAY_FALLBACK_MS = 1_000;
@@ -69,6 +71,15 @@ export const TOOL_EXECUTE_RUNNER_ACCEPTS_CONCURRENCY_BACKPRESSURE =
 /** The capability tokens this runner build advertises on provider execute. */
 export const TOOL_EXECUTE_RUNNER_ACCEPTS_VALUE =
   TOOL_EXECUTE_RUNNER_ACCEPTS_CONCURRENCY_BACKPRESSURE;
+/** Runner proof headers consumed only by the execution gateway. */
+export const TOOL_EXECUTE_PROVIDER_RATE_SCOPE_HEADER =
+  'x-deepline-provider-rate-scope';
+export const TOOL_EXECUTE_PROVIDER_RATE_RETRY_SNAPSHOT_HEADER =
+  'x-deepline-provider-rate-retry-snapshot';
+/** Server-minted only for an internal executor's provider-owned 429. */
+export const TOOL_EXECUTE_PROVIDER_THROTTLE_HEADER =
+  'x-deepline-provider-throttle';
+export const TOOL_EXECUTE_PROVIDER_PACING_WAIT_CODE = 'PROVIDER_PACING_WAIT';
 
 /**
  * Parse the advertisement as a comma-separated token list so a later runner can
@@ -106,6 +117,7 @@ export type ToolExecuteHttpRetryDecision = {
     | 'rate_limit'
     | 'concurrency_backpressure'
     | 'runtime_scheduler_capacity'
+    | 'provider_pacing_wait'
     | 'idempotency_in_progress'
     | 'gateway_invocation_in_progress'
     | 'customer_db_storage_unavailable'
@@ -122,6 +134,8 @@ export type ToolExecuteHttpFailureOutcome = ToolExecuteHttpRetryDecision & {
   fate: 'retry' | 'settle_row_failure' | 'fail_run';
   retryDelayMs: number;
   backpressureDelayMs: number | null;
+  /** Retry-After for known-not-dispatched gateway pacing; not provider feedback. */
+  providerPacingWaitMs: number | null;
   chargeRetryBudget: boolean;
   /** The response proves the provider request was never dispatched. */
   knownNotDispatched: boolean;
@@ -214,6 +228,19 @@ function isRuntimeSchedulerCapacityResponse(input: {
   );
 }
 
+function isProviderPacingWaitResponse(input: {
+  status: number;
+  bodyText: string;
+}): boolean {
+  const body = parseJsonObject(input.bodyText);
+  return (
+    input.status === 503 &&
+    body?.code === TOOL_EXECUTE_PROVIDER_PACING_WAIT_CODE &&
+    body.failure_origin === 'deepline_rate_limit' &&
+    body.provider_request_dispatched === false
+  );
+}
+
 function idempotencyInProgressRetryDelayMs(attempt: number): number {
   return (
     TOOL_EXECUTE_IDEMPOTENCY_IN_PROGRESS_RETRY_DELAYS_MS[
@@ -249,6 +276,7 @@ function decideToolExecuteHttpRetry(input: {
   customerDbStorageUnavailable?: boolean;
   concurrencyBackpressure?: boolean;
   runtimeSchedulerCapacity?: boolean;
+  providerPacingWait?: boolean;
   hardBillingFailure?: boolean;
   hasRetryAfterHeader?: boolean;
   transientHttpRetrySafe?: boolean;
@@ -289,6 +317,13 @@ function decideToolExecuteHttpRetry(input: {
       reason: 'runtime_scheduler_capacity',
     };
   }
+  if (input.providerPacingWait) {
+    return {
+      retryable: true,
+      attemptCap: TOOL_EXECUTE_PROVIDER_PACING_WAIT_MAX_ATTEMPTS,
+      reason: 'provider_pacing_wait',
+    };
+  }
   if (input.gatewayInvocationInProgress) {
     return {
       retryable: true,
@@ -342,6 +377,7 @@ export function createToolExecuteHttpFailureAttemptTracker(): ToolExecuteHttpFai
     rate_limit: 0,
     concurrency_backpressure: 0,
     runtime_scheduler_capacity: 0,
+    provider_pacing_wait: 0,
     idempotency_in_progress: 0,
     gateway_invocation_in_progress: 0,
     customer_db_storage_unavailable: 0,
@@ -376,6 +412,10 @@ export function createToolExecuteHttpFailureAttemptTracker(): ToolExecuteHttpFai
           status: input.status,
           bodyText: input.bodyText ?? '',
         }),
+        providerPacingWait: isProviderPacingWaitResponse({
+          status: input.status,
+          bodyText: input.bodyText ?? '',
+        }),
         hasRetryAfterHeader: true,
         transientHttpRetrySafe: input.transientHttpRetrySafe === true,
       });
@@ -391,12 +431,12 @@ export function parseToolExecuteRetryAfterMs(
 ): number {
   if (!header) return TOOL_EXECUTE_RETRY_DELAY_FALLBACK_MS;
   const seconds = Number(header);
-  if (Number.isFinite(seconds) && seconds > 0) {
+  if (Number.isFinite(seconds) && seconds >= 0) {
     return Math.ceil(seconds * 1000);
   }
   const retryAt = Date.parse(header);
   if (Number.isFinite(retryAt)) {
-    return Math.max(1, retryAt - nowMs);
+    return Math.max(0, retryAt - nowMs);
   }
   return TOOL_EXECUTE_RETRY_DELAY_FALLBACK_MS;
 }
@@ -423,6 +463,7 @@ export function classifyToolExecuteHttpFailure(input: {
     isCustomerDbStorageUnavailableResponse(input);
   const concurrencyBackpressure = isConcurrencyBackpressureResponse(input);
   const runtimeSchedulerCapacity = isRuntimeSchedulerCapacityResponse(input);
+  const providerPacingWait = isProviderPacingWaitResponse(input);
   const initialRetryDecision = decideToolExecuteHttpRetry({
     status: input.status,
     idempotencyInProgress,
@@ -430,13 +471,33 @@ export function classifyToolExecuteHttpFailure(input: {
     customerDbStorageUnavailable,
     concurrencyBackpressure,
     runtimeSchedulerCapacity,
+    providerPacingWait,
     hasRetryAfterHeader,
     transientHttpRetrySafe,
   });
-  const retryAfterMs = parseToolExecuteRetryAfterMs(
-    input.retryAfterHeader,
-    input.nowMs,
-  );
+  const providerPacingWaitBody = providerPacingWait
+    ? parseJsonObject(input.bodyText)
+    : null;
+  const rawProviderPacingWaitMs = providerPacingWaitBody?.retry_after_ms;
+  const exactProviderPacingWaitMs =
+    typeof rawProviderPacingWaitMs === 'number' &&
+    Number.isFinite(rawProviderPacingWaitMs) &&
+    rawProviderPacingWaitMs >= 0
+      ? rawProviderPacingWaitMs
+      : null;
+  const attestedProviderDeadline =
+    providerPacingWait &&
+    (providerPacingWaitBody?.reason === 'retry_after' ||
+      providerPacingWaitBody?.reason === 'stale_permit') &&
+    typeof providerPacingWaitBody?.retry_at_ms === 'number' &&
+    Number.isFinite(providerPacingWaitBody.retry_at_ms) &&
+    providerPacingWaitBody.retry_at_ms > (input.nowMs ?? Date.now()) &&
+    exactProviderPacingWaitMs !== null &&
+    exactProviderPacingWaitMs > 0;
+  const retryAfterMs =
+    providerPacingWait && exactProviderPacingWaitMs !== null
+      ? exactProviderPacingWaitMs
+      : parseToolExecuteRetryAfterMs(input.retryAfterHeader, input.nowMs);
   const error = normalizeToolHttpErrorMessage({
     toolId: input.toolId,
     status: input.status,
@@ -446,7 +507,9 @@ export function classifyToolExecuteHttpFailure(input: {
     schemaVersion: input.schemaVersion,
     retryable: initialRetryDecision.retryable,
     retryAfterMs:
-      (input.status === 429 && hasRetryAfterHeader) || runtimeSchedulerCapacity
+      (input.status === 429 && hasRetryAfterHeader) ||
+      runtimeSchedulerCapacity ||
+      providerPacingWait
         ? retryAfterMs
         : null,
   });
@@ -458,6 +521,11 @@ export function classifyToolExecuteHttpFailure(input: {
     error.message = `${error.message} (provider call ${Math.round(input.providerLatencyMs)}ms)`;
   }
   const hardBillingFailure = isHardBillingToolHttpError(error);
+  const providerOwnedRateLimit =
+    input.status === 429 &&
+    !hardBillingFailure &&
+    error instanceof ToolExecutionError &&
+    error.origin === 'provider';
   const retryDecision = decideToolExecuteHttpRetry({
     status: input.status,
     idempotencyInProgress,
@@ -465,12 +533,15 @@ export function classifyToolExecuteHttpFailure(input: {
     customerDbStorageUnavailable,
     concurrencyBackpressure,
     runtimeSchedulerCapacity,
+    providerPacingWait,
     hardBillingFailure,
     hasRetryAfterHeader,
     transientHttpRetrySafe,
   });
   const shouldRetry =
-    retryDecision.retryable && input.attempt < retryDecision.attemptCap;
+    providerOwnedRateLimit ||
+    attestedProviderDeadline ||
+    (retryDecision.retryable && input.attempt < retryDecision.attemptCap);
   // In-attempt retry safety and later-run repairability are different
   // decisions. A non-idempotent 5xx must not be repeated automatically inside
   // this execution attempt, but an explicit later `plays run` must be able to
@@ -496,23 +567,37 @@ export function classifyToolExecuteHttpFailure(input: {
             TOOL_EXECUTE_RETRY_DELAY_MAX_MS,
             Math.max(retryAfterMs, TOOL_EXECUTE_RETRY_DELAY_FALLBACK_MS),
           )
-        : input.status === 429
-          ? Math.min(
-              TOOL_EXECUTE_RATE_LIMIT_RETRY_DELAY_MAX_MS,
-              Math.max(
-                retryAfterMs,
-                TOOL_EXECUTE_RETRY_DELAY_FALLBACK_MS * input.attempt,
-              ),
-            )
-          : retryDecision.reason === 'idempotency_in_progress' &&
-              !hasRetryAfterHeader
-            ? idempotencyInProgressRetryDelayMs(input.attempt)
-            : retryDecision.reason === 'gateway_invocation_in_progress' &&
+        : retryDecision.reason === 'provider_pacing_wait'
+          ? retryAfterMs
+          : input.status === 429
+            ? hasRetryAfterHeader
+              ? providerOwnedRateLimit
+                ? // The provider's explicit deadline is authoritative. Attempt-
+                  // scaled fallback backoff is only for a bare 429; extending a
+                  // valid Retry-After by the attempt number needlessly idles this
+                  // row after the shared provider pacer has already enforced the
+                  // deadline for every caller using the credential.
+                  retryAfterMs
+                : Math.max(
+                    retryAfterMs,
+                    TOOL_EXECUTE_RETRY_DELAY_FALLBACK_MS * input.attempt,
+                  )
+              : Math.min(
+                  TOOL_EXECUTE_RATE_LIMIT_RETRY_DELAY_MAX_MS,
+                  Math.max(
+                    retryAfterMs,
+                    TOOL_EXECUTE_RETRY_DELAY_FALLBACK_MS * input.attempt,
+                  ),
+                )
+            : retryDecision.reason === 'idempotency_in_progress' &&
                 !hasRetryAfterHeader
               ? idempotencyInProgressRetryDelayMs(input.attempt)
-              : retryAfterMs > 0
-                ? Math.min(TOOL_EXECUTE_RETRY_DELAY_MAX_MS, retryAfterMs)
-                : TOOL_EXECUTE_RETRY_DELAY_FALLBACK_MS;
+              : retryDecision.reason === 'gateway_invocation_in_progress' &&
+                  !hasRetryAfterHeader
+                ? idempotencyInProgressRetryDelayMs(input.attempt)
+                : retryAfterMs > 0
+                  ? Math.min(TOOL_EXECUTE_RETRY_DELAY_MAX_MS, retryAfterMs)
+                  : TOOL_EXECUTE_RETRY_DELAY_FALLBACK_MS;
   return {
     ...retryDecision,
     error,
@@ -528,24 +613,25 @@ export function classifyToolExecuteHttpFailure(input: {
     // caller, and malformed responses are never evidence that a provider is
     // throttling; feeding any of them into the pacer can incorrectly exhaust
     // every customer sharing that provider credential.
-    backpressureDelayMs:
-      input.status === 429 &&
-      retryDecision.reason !== 'hard_billing_error' &&
-      error instanceof ToolExecutionError &&
-      error.origin === 'provider'
-        ? hasRetryAfterHeader && retryAfterMs > 0
-          ? retryAfterMs
-          : TOOL_EXECUTE_BARE_RATE_LIMIT_BACKPRESSURE_MS
-        : null,
+    backpressureDelayMs: providerOwnedRateLimit
+      ? hasRetryAfterHeader
+        ? retryAfterMs
+        : TOOL_EXECUTE_BARE_RATE_LIMIT_BACKPRESSURE_MS
+      : null,
+    providerPacingWaitMs:
+      attestedProviderDeadline && shouldRetry ? retryAfterMs : null,
     chargeRetryBudget:
       shouldRetry &&
+      !providerOwnedRateLimit &&
       retryDecision.reason !== 'gateway_invocation_in_progress' &&
       retryDecision.reason !== 'concurrency_backpressure' &&
-      retryDecision.reason !== 'runtime_scheduler_capacity',
+      retryDecision.reason !== 'runtime_scheduler_capacity' &&
+      retryDecision.reason !== 'provider_pacing_wait',
     // Scheduler capacity and the relay's explicit concurrency shed both occur
     // before a provider request is dispatched. Carry that proof in the shared
     // classification so the retry boundary can safely pace either response
     // without asking a non-idempotent provider call to be replayed.
-    knownNotDispatched: runtimeSchedulerCapacity || concurrencyBackpressure,
+    knownNotDispatched:
+      runtimeSchedulerCapacity || concurrencyBackpressure || providerPacingWait,
   };
 }

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

@@ -1593,6 +1593,22 @@ function serializedListRowsFromRaw(input: {
   return entries.length > 0 ? Object.fromEntries(entries) : undefined;
 }
 
+/**
+ * V2 receipts keep the complete provider body in rawV2. Use that body as the
+ * durable source for list handles instead of writing the same rows to the
+ * compatibility-only listRows field.
+ */
+function serializedListRowsFromRawV2(input: {
+  rawV2: unknown;
+  view: 'data' | 'rawV2';
+  metadata: ToolResultMetadataInput;
+}): Record<string, Array<Record<string, unknown>>> | undefined {
+  return serializedListRowsFromRaw({
+    raw: legacyRawFromToolResponseRawV2(input.rawV2, input.view),
+    metadata: input.metadata,
+  });
+}
+
 function preservedSerializedListRows(
   value: ToolExecuteResult,
 ): Record<string, Array<Record<string, unknown>>> | undefined {
@@ -1864,6 +1880,52 @@ function sameJsonValue(left: unknown, right: unknown): boolean {
   }
 }
 
+/**
+ * New V2 receipts must not carry a second full copy of list rows. Keep the
+ * optional field when the rows cannot be proven identical to the canonical
+ * rawV2 body; this makes the compaction conservative for unusual or historical
+ * envelopes while allowing ordinary V2 receipts to store rows exactly once.
+ */
+function listRowsAreInCanonicalRawV2(input: {
+  rawV2: unknown;
+  view: 'data' | 'rawV2';
+  metadata: ToolResultMetadataInput;
+  listRows: Record<string, Array<Record<string, unknown>>> | undefined;
+}): boolean {
+  if (!input.listRows || Object.keys(input.listRows).length === 0) {
+    return false;
+  }
+  const canonicalRows = serializedListRowsFromRawV2({
+    rawV2: input.rawV2,
+    view: input.view,
+    metadata: input.metadata,
+  });
+  if (!canonicalRows) return false;
+  return Object.entries(input.listRows).every(([name, rows]) =>
+    sameJsonValue(canonicalRows[name], rows),
+  );
+}
+
+function completeListRowsForDatasets(input: {
+  listRows: Record<string, Array<Record<string, unknown>>> | undefined;
+  listDatasets:
+    | Record<string, SerializedPlayDataset<Record<string, unknown>>>
+    | undefined;
+}): Record<string, Array<Record<string, unknown>>> | undefined {
+  if (!input.listRows || !input.listDatasets) return undefined;
+  const datasets = Object.entries(input.listDatasets);
+  if (datasets.length === 0) return undefined;
+  if (
+    !datasets.every(([name, dataset]) => {
+      const rows = input.listRows?.[name];
+      return rows !== undefined && rows.length >= dataset.count;
+    })
+  ) {
+    return undefined;
+  }
+  return input.listRows;
+}
+
 function responseMetaOutsideRawV2(input: {
   rawV2: unknown;
   view: 'data' | 'rawV2';
@@ -1931,6 +1993,14 @@ export function serializeToolExecuteResult(
   });
   if (Object.prototype.hasOwnProperty.call(value.toolResponse, 'rawV2')) {
     const view = value.toolResponse.view ?? 'rawV2';
+    const persistedListRows = listRowsAreInCanonicalRawV2({
+      rawV2: value.toolResponse.rawV2,
+      view,
+      metadata,
+      listRows,
+    })
+      ? undefined
+      : listRows;
     const responseMeta = responseMetaOutsideRawV2({
       rawV2: value.toolResponse.rawV2,
       view,
@@ -1960,7 +2030,7 @@ export function serializeToolExecuteResult(
         ...(responseMeta ? { responseMeta } : {}),
       },
       ...(listDatasets ? { listDatasets } : {}),
-      ...(listRows ? { listRows } : {}),
+      ...(persistedListRows ? { listRows: persistedListRows } : {}),
       ...(targetValues ? { targetValues } : {}),
       metadata,
       execution: value._metadata.execution,
@@ -2023,6 +2093,16 @@ export function deserializeToolExecuteResult(
     )
       ? value.toolResponse.legacyRaw
       : raw;
+    const listRows =
+      value.listRows ??
+      completeListRowsForDatasets({
+        listRows: serializedListRowsFromRawV2({
+          rawV2,
+          view,
+          metadata: value.metadata,
+        }),
+        listDatasets: value.listDatasets,
+      });
     return applySerializedListDatasets(
       applySerializedTargetValues(
         createToolExecuteResult({
@@ -2045,7 +2125,7 @@ export function deserializeToolExecuteResult(
         value.targetValues,
       ),
       value.listDatasets,
-      value.listRows,
+      listRows,
     );
   }
   return applySerializedListDatasets(

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

@@ -119,7 +119,7 @@ export type SerializedToolExecuteResultV1 = {
     meta?: Record<string, unknown>;
   };
   listDatasets?: Record<string, SerializedPlayDataset<Record<string, unknown>>>;
-  /** Full declared list rows used to rehydrate list Dataset Handles. */
+  /** Full declared list rows retained by historical V1 receipts. */
   listRows?: Record<string, Array<Record<string, unknown>>>;
   /** Computed scalar/object getters preserved before raw list previews are clipped. */
   targetValues?: Record<string, ToolResultTargetMetadata>;
@@ -133,7 +133,7 @@ export type SerializedToolExecuteResultV1 = {
  */
 export type SerializedToolExecuteResultV2 = Omit<
   SerializedToolExecuteResultV1,
-  '__kind' | 'toolResponse'
+  '__kind' | 'toolResponse' | 'listRows'
 > & {
   __kind: 'deepline.tool_execute_result.v2';
   toolResponse: {
@@ -144,6 +144,11 @@ export type SerializedToolExecuteResultV2 = Omit<
     /** Deepline-owned additions not already represented in `rawV2.meta`. */
     responseMeta?: Record<string, unknown>;
   };
+  /**
+   * Compatibility fallback for older V2 receipts whose rawV2 body was not
+   * complete. New V2 receipts derive list rows from rawV2 and omit this copy.
+   */
+  listRows?: Record<string, Array<Record<string, unknown>>>;
 };
 
 export type SerializedToolExecuteResult =

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.184",
+  version: "0.3.186",
   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
@@ -27485,7 +27485,9 @@ function readLiveCronMetadata(play) {
   return {
     schedule: typeof metadata?.cronSchedule === "string" ? metadata.cronSchedule : null,
     timezone: typeof metadata?.cronTimezone === "string" ? metadata.cronTimezone : null,
-    nextScheduledAt: typeof metadata?.nextScheduledAt === "number" ? metadata.nextScheduledAt : null
+    nextScheduledAt: typeof metadata?.nextScheduledAt === "number" ? metadata.nextScheduledAt : null,
+    blockedAt: typeof metadata?.blockedAt === "number" ? metadata.blockedAt : null,
+    blockedReasonCode: typeof metadata?.blockedReasonCode === "string" ? metadata.blockedReasonCode : null
   };
 }
 function liveTriggerStatusLines(status, play) {
@@ -27504,6 +27506,18 @@ function liveTriggerStatusLines(status, play) {
     }
     if (status?.blockedReason) {
       lines.push(`  Schedule issue: ${status.blockedReason}`);
+      if (status.blockedReasonCode || cron.blockedReasonCode) {
+        lines.push(
+          `  Schedule issue code: ${status.blockedReasonCode ?? cron.blockedReasonCode}`
+        );
+      }
+      const blockedAt = status.blockedAt ?? cron.blockedAt;
+      if (blockedAt !== null && blockedAt !== void 0) {
+        lines.push(`  Schedule blocked at: ${formatTimestamp(blockedAt)}`);
+      }
+      lines.push(
+        "  Recovery: republish the live revision to re-arm this schedule after the platform issue is fixed."
+      );
     }
   }
   if (status?.webhook) {
@@ -27516,7 +27530,9 @@ function triggerStatusFromMetadata(value) {
   return {
     cron: typeof metadata?.cronStatus === "string" ? metadata.cronStatus : null,
     webhook: typeof metadata?.webhookStatus === "string" ? metadata.webhookStatus : null,
-    blockedReason: typeof metadata?.blockedReason === "string" ? metadata.blockedReason : null
+    blockedReason: typeof metadata?.blockedReason === "string" ? metadata.blockedReason : null,
+    blockedReasonCode: typeof metadata?.blockedReasonCode === "string" ? metadata.blockedReasonCode : null,
+    blockedAt: typeof metadata?.blockedAt === "number" ? metadata.blockedAt : null
   };
 }
 function printPublishReceipt(input2) {
@@ -29318,6 +29334,16 @@ async function handlePlayList(args) {
       );
       if (play.triggerStatus.blockedReason) {
         lines.push(`    schedule issue: ${play.triggerStatus.blockedReason}`);
+        if (play.triggerStatus.blockedReasonCode) {
+          lines.push(
+            `    schedule issue code: ${play.triggerStatus.blockedReasonCode}`
+          );
+        }
+        if (play.triggerStatus.blockedAt !== void 0) {
+          lines.push(
+            `    schedule blocked at: ${formatTimestamp(play.triggerStatus.blockedAt)}`
+          );
+        }
       }
     } else {
       lines.push("    scheduled execution: not configured");

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.184",
+  version: "0.3.186",
   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
@@ -27557,7 +27557,9 @@ function readLiveCronMetadata(play) {
   return {
     schedule: typeof metadata?.cronSchedule === "string" ? metadata.cronSchedule : null,
     timezone: typeof metadata?.cronTimezone === "string" ? metadata.cronTimezone : null,
-    nextScheduledAt: typeof metadata?.nextScheduledAt === "number" ? metadata.nextScheduledAt : null
+    nextScheduledAt: typeof metadata?.nextScheduledAt === "number" ? metadata.nextScheduledAt : null,
+    blockedAt: typeof metadata?.blockedAt === "number" ? metadata.blockedAt : null,
+    blockedReasonCode: typeof metadata?.blockedReasonCode === "string" ? metadata.blockedReasonCode : null
   };
 }
 function liveTriggerStatusLines(status, play) {
@@ -27576,6 +27578,18 @@ function liveTriggerStatusLines(status, play) {
     }
     if (status?.blockedReason) {
       lines.push(`  Schedule issue: ${status.blockedReason}`);
+      if (status.blockedReasonCode || cron.blockedReasonCode) {
+        lines.push(
+          `  Schedule issue code: ${status.blockedReasonCode ?? cron.blockedReasonCode}`
+        );
+      }
+      const blockedAt = status.blockedAt ?? cron.blockedAt;
+      if (blockedAt !== null && blockedAt !== void 0) {
+        lines.push(`  Schedule blocked at: ${formatTimestamp(blockedAt)}`);
+      }
+      lines.push(
+        "  Recovery: republish the live revision to re-arm this schedule after the platform issue is fixed."
+      );
     }
   }
   if (status?.webhook) {
@@ -27588,7 +27602,9 @@ function triggerStatusFromMetadata(value) {
   return {
     cron: typeof metadata?.cronStatus === "string" ? metadata.cronStatus : null,
     webhook: typeof metadata?.webhookStatus === "string" ? metadata.webhookStatus : null,
-    blockedReason: typeof metadata?.blockedReason === "string" ? metadata.blockedReason : null
+    blockedReason: typeof metadata?.blockedReason === "string" ? metadata.blockedReason : null,
+    blockedReasonCode: typeof metadata?.blockedReasonCode === "string" ? metadata.blockedReasonCode : null,
+    blockedAt: typeof metadata?.blockedAt === "number" ? metadata.blockedAt : null
   };
 }
 function printPublishReceipt(input2) {
@@ -29390,6 +29406,16 @@ async function handlePlayList(args) {
       );
       if (play.triggerStatus.blockedReason) {
         lines.push(`    schedule issue: ${play.triggerStatus.blockedReason}`);
+        if (play.triggerStatus.blockedReasonCode) {
+          lines.push(
+            `    schedule issue code: ${play.triggerStatus.blockedReasonCode}`
+          );
+        }
+        if (play.triggerStatus.blockedAt !== void 0) {
+          lines.push(
+            `    schedule blocked at: ${formatTimestamp(play.triggerStatus.blockedAt)}`
+          );
+        }
       }
     } else {
       lines.push("    scheduled execution: not configured");

package/dist/index.d.mts

@@ -2207,6 +2207,8 @@ interface PlayDefinitionDetail {
         cronTimezone?: string | null;
         nextScheduledAt?: number | null;
         lastScheduledAt?: number | null;
+        blockedAt?: number | null;
+        blockedReasonCode?: string | null;
         blockedReason?: string | null;
         [key: string]: unknown;
     } | null;
@@ -2270,6 +2272,8 @@ interface PlayTriggerStatus {
     cron: string | null;
     webhook: string | null;
     blockedReason: string | null;
+    blockedReasonCode?: string;
+    blockedAt?: number;
 }
 interface ProductNotificationEventDefinition {
     id: string;

package/dist/index.d.ts

@@ -2207,6 +2207,8 @@ interface PlayDefinitionDetail {
         cronTimezone?: string | null;
         nextScheduledAt?: number | null;
         lastScheduledAt?: number | null;
+        blockedAt?: number | null;
+        blockedReasonCode?: string | null;
         blockedReason?: string | null;
         [key: string]: unknown;
     } | null;
@@ -2270,6 +2272,8 @@ interface PlayTriggerStatus {
     cron: string | null;
     webhook: string | null;
     blockedReason: string | null;
+    blockedReasonCode?: string;
+    blockedAt?: number;
 }
 interface ProductNotificationEventDefinition {
     id: string;

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.184",
+  version: "0.3.186",
   updateSummary: "Play grep now returns concise results with the matched fields and terms. Automatic CLI updates are enabled by default; use `deepline settings autoupdate off` to opt out, `deepline settings autoupdate on` to re-enable updates, or `deepline settings autoupdate pin <version>` to hold an exact release.",
   packageCapabilities: {
     updatePreferences: 1

package/dist/index.mjs

@@ -768,7 +768,7 @@ var SDK_RELEASE = {
   // getters keep their established compatibility behavior.
   // 0.3.1 deprecated the legacy `deepline enrich` command in favor of Plays.
   // 0.3.90 is the first deliberately versioned SDK release for API v3.
-  version: "0.3.184",
+  version: "0.3.186",
   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/install-integrity.json

@@ -209,6 +209,7 @@
     "dist/bundling-sources/shared_libs/play-runtime/internal-bootstrap-token.ts",
     "dist/bundling-sources/shared_libs/play-runtime/internal-step-ids.ts",
     "dist/bundling-sources/shared_libs/play-runtime/lane-retirement-gate.ts",
+    "dist/bundling-sources/shared_libs/play-runtime/launch-identity.ts",
     "dist/bundling-sources/shared_libs/play-runtime/launch-source-policy.ts",
     "dist/bundling-sources/shared_libs/play-runtime/lease-policy.ts",
     "dist/bundling-sources/shared_libs/play-runtime/ledger-safe-payload.ts",
@@ -388,6 +389,7 @@
     "dist/bundling-sources/shared_libs/play-runtime/scheduler-backends/postgres-budget-state.ts",
     "dist/bundling-sources/shared_libs/play-runtime/scheduler-backends/postgres-pool.ts",
     "dist/bundling-sources/shared_libs/play-runtime/scheduler-backends/postgres-progress.ts",
+    "dist/bundling-sources/shared_libs/play-runtime/scheduler-backends/postgres-rate-scope.ts",
     "dist/bundling-sources/shared_libs/play-runtime/scheduler-backends/postgres-rate-state.ts",
     "dist/bundling-sources/shared_libs/play-runtime/scheduler-backends/postgres.ts",
     "dist/bundling-sources/shared_libs/play-runtime/scheduler-backends/receipt-completion-coalescer.ts",

package/dist/release.d.mts

@@ -149,7 +149,7 @@ type SdkRelease = {
     supportPolicy: SdkSupportPolicy;
 };
 declare const SDK_RELEASE: {
-    readonly version: "0.3.184";
+    readonly version: "0.3.186";
     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;