deepline 0.3.172 → 0.3.173

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.172',
+  version: '0.3.173',
   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/async-operation.ts

@@ -83,6 +83,9 @@ export type AsyncOperationContractWire = {
    * Keep a default synchronous Play call in the runner process: launch the
    * provider job, expose its handle in run progress, then poll companion tools
    * until terminal. Direct tools.execute callers keep their own legacy policy.
+   * These calls receive the canonical raw-v2 response alongside the legacy
+   * projection, so terminal classification can consult it when every declared
+   * status path is absent from the projection.
    */
   runtimeManagedWait?: true;
   /** Preserve the provider's historical public async metadata exactly. */
@@ -671,16 +674,22 @@ function conditionMatches(
 export function classifyAsyncOperationResult(
   contract: AsyncOperationContractWire,
   result: unknown,
+  fallbackResult?: unknown,
 ): { outcome: AsyncOperationTerminalOutcome; message?: string } {
+  const classificationResult = resolveAsyncOperationClassificationResult(
+    contract,
+    result,
+    fallbackResult,
+  );
   for (const rule of contract.terminal.rules) {
     const matches = rule.conditions.map((condition) =>
-      conditionMatches(result, condition),
+      conditionMatches(classificationResult, condition),
     );
     const matched =
       rule.mode === 'any' ? matches.some(Boolean) : matches.every(Boolean);
     if (!matched) continue;
     const message = rule.messagePath
-      ? readAsyncOperationPath(result, rule.messagePath)
+      ? readAsyncOperationPath(classificationResult, rule.messagePath)
       : undefined;
     return {
       outcome: rule.outcome,
@@ -695,15 +704,52 @@ export function classifyAsyncOperationResult(
 export function hasExplicitAsyncOperationTerminalMatch(
   contract: AsyncOperationContractWire,
   result: unknown,
+  fallbackResult?: unknown,
 ): boolean {
+  const classificationResult = resolveAsyncOperationClassificationResult(
+    contract,
+    result,
+    fallbackResult,
+  );
   return contract.terminal.rules.some((rule) => {
     const matches = rule.conditions.map((condition) =>
-      conditionMatches(result, condition),
+      conditionMatches(classificationResult, condition),
     );
     return rule.mode === 'any' ? matches.some(Boolean) : matches.every(Boolean);
   });
 }
 
+/**
+ * Runtime-managed Play calls carry both the compatibility projection and the
+ * canonical provider response. Use the canonical view only when every path
+ * declared by the terminal rules is absent from the compatibility view. A
+ * present value (including null) remains authoritative, so a stale or
+ * transport-level rawV2 status cannot override an observed provider status.
+ */
+function resolveAsyncOperationClassificationResult(
+  contract: AsyncOperationContractWire,
+  result: unknown,
+  fallbackResult: unknown,
+): unknown {
+  if (!contract.runtimeManagedWait || fallbackResult === undefined) {
+    return result;
+  }
+  const conditionPaths = new Set(
+    contract.terminal.rules.flatMap((rule) =>
+      rule.conditions.map((condition) => condition.path),
+    ),
+  );
+  if (
+    conditionPaths.size === 0 ||
+    [...conditionPaths].some(
+      (path) => readAsyncOperationPath(result, path) !== undefined,
+    )
+  ) {
+    return result;
+  }
+  return fallbackResult;
+}
+
 function isEmptyAsyncResult(value: unknown): boolean {
   return (
     value == null ||
@@ -907,6 +953,8 @@ export async function executeAsyncOperationLifecycle<Response>(input: {
     abortSignal: AbortSignal;
   }) => Promise<Response>;
   responseValue: (response: Response) => unknown;
+  /** Canonical provider response used only when terminal paths are missing from responseValue. */
+  classificationFallback?: (response: Response) => unknown;
   sleep?: (ms: number) => Promise<void>;
   now?: () => number;
   /** Called after the provider handle is known and before the first poll. */
@@ -1111,6 +1159,7 @@ export async function executeAsyncOperationLifecycle<Response>(input: {
     const classification = classifyAsyncOperationResult(
       input.contract,
       previousPollResult,
+      input.classificationFallback?.(pollResponse),
     );
     input.onPoll?.({
       jobId,

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

@@ -3915,6 +3915,14 @@ export class PlayContextImpl implements ScalarPlayAuthoringRuntimeContext {
     this.activeMapCheckpointMemory = null;
   }
 
+  private activeMapCheckpointUpdatesForTable(
+    tableNamespace: string,
+  ): PlayRowUpdate[] {
+    return [...(this.activeMapCheckpointUpdates?.values() ?? [])].filter(
+      (update) => (update.tableNamespace ?? tableNamespace) === tableNamespace,
+    );
+  }
+
   /**
    * Checkpoint updates merge at field grain. Re-serializing every row after
    * each cell would turn this safety measurement into O(rows x columns), so
@@ -11196,12 +11204,8 @@ export class PlayContextImpl implements ScalarPlayAuthoringRuntimeContext {
           ]),
         ).values(),
       ];
-      const checkpointUpdates = [
-        ...(this.activeMapCheckpointUpdates?.values() ?? []),
-      ].filter(
-        (update) =>
-          (update.tableNamespace ?? normalizedTableNamespace) ===
-          normalizedTableNamespace,
+      const checkpointUpdates = this.activeMapCheckpointUpdatesForTable(
+        normalizedTableNamespace,
       );
       // A suspension is not observable until both terminal rows and partial
       // completed-cell patches cross the same writer's durability barrier.
@@ -12088,6 +12092,14 @@ export class PlayContextImpl implements ScalarPlayAuthoringRuntimeContext {
       );
     };
     if (!this.persistenceLatch.tripped) {
+      // A run-fatal row error (for example a Deepline billing denial) unwinds
+      // before it can produce a terminal MapRowOutcome. Persist its latest
+      // row/cell checkpoint first so a previously enriched value cannot remain
+      // reusable after this failed attempt. Terminal rows already accepted by
+      // this writer win over same-key checkpoints.
+      await incrementalPersistence?.checkpoint(
+        this.activeMapCheckpointUpdatesForTable(input.tableNamespace),
+      );
       await incrementalPersistence?.flush();
       const rows = unpersistedRows();
       const persistStartedAt = Date.now();
@@ -17853,14 +17865,17 @@ export class PlayContextImpl implements ScalarPlayAuthoringRuntimeContext {
     startResponse: ParsedToolExecuteResponse;
   }): Promise<ParsedToolExecuteResponse> {
     const startResult = input.startResponse.toolResponse?.raw;
+    const startClassificationFallback = input.startResponse.toolResponse?.rawV2;
     const jobId = extractAsyncOperationJobId(input.contract, startResult);
     const hasTerminalMatch = hasExplicitAsyncOperationTerminalMatch(
       input.contract,
       startResult,
+      startClassificationFallback,
     );
     const startClassification = classifyAsyncOperationResult(
       input.contract,
       startResult,
+      startClassificationFallback,
     );
     const launchIsRunning =
       input.contract.launch?.unclassifiedJobOutcome === 'running' &&
@@ -17928,6 +17943,7 @@ export class PlayContextImpl implements ScalarPlayAuthoringRuntimeContext {
           uncachedAsyncLifecycleCall: true,
         }),
       responseValue: (response) => response.toolResponse?.raw,
+      classificationFallback: (response) => response.toolResponse?.rawV2,
       onJobStarted: () => {
         this.runtimeLog(
           `Provider task ${jobId} is running. This Play remains synchronous while it checks for completion. ` +

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

@@ -16531,37 +16531,73 @@ export async function dispatchRunLedgerOutboxToLedgerBatchOnceWithClientScope(
     // late producer commits cannot split one run between different heads.
     await client.query('BEGIN');
     try {
-      const selected = await client.query<{ run_id: string }>(
-        `
-        WITH heads AS MATERIALIZED (
-          SELECT DISTINCT ON (pending.run_id)
-            pending.run_id,
-            pending.event_id,
-            pending.event_type,
-            pending.created_at,
-            pending.next_attempt_at,
-            pending.failed_at
-          FROM ${tableName('outbox', options)} AS pending
-          WHERE pending.delivered_at IS NULL
-            AND ($1::text IS NULL OR pending.run_id = $1)
-          ORDER BY pending.run_id, ${runLedgerOrderSql('pending')}
-        )
-        SELECT runs.run_id
-        FROM heads AS head
-        JOIN ${tableName('runs', options)} AS runs ON runs.run_id = head.run_id
-        WHERE head.failed_at IS NULL
-          AND coalesce(head.next_attempt_at, head.created_at) <= now()
-          AND NOT EXISTS (
-            SELECT 1 FROM ${tableName('outbox', options)} AS active
-            WHERE active.run_id = runs.run_id AND active.delivered_at IS NULL
-              AND active.lease_owner IS NOT NULL AND active.lease_expires_at > now()
+      const targetRunId = input.runId?.trim() || null;
+      // A worker fast path always names one run. Keep that lookup on the
+      // run-scoped outbox prefix: combining it with global recovery through a
+      // nullable predicate made PostgreSQL materialize every pending run head
+      // for each lifecycle transition. Only the two dedicated projectors may
+      // perform the global distinct-head scan below.
+      const selected = targetRunId
+        ? await client.query<{ run_id: string }>(
+            `
+            WITH head AS MATERIALIZED (
+              SELECT pending.run_id,
+                     pending.event_id,
+                     pending.event_type,
+                     pending.created_at,
+                     pending.next_attempt_at,
+                     pending.failed_at
+              FROM ${tableName('outbox', options)} AS pending
+              WHERE pending.run_id = $1
+                AND pending.delivered_at IS NULL
+              ORDER BY ${runLedgerOrderSql('pending')}
+              LIMIT 1
+            )
+            SELECT runs.run_id
+            FROM head
+            JOIN ${tableName('runs', options)} AS runs ON runs.run_id = head.run_id
+            WHERE head.failed_at IS NULL
+              AND coalesce(head.next_attempt_at, head.created_at) <= now()
+              AND NOT EXISTS (
+                SELECT 1 FROM ${tableName('outbox', options)} AS active
+                WHERE active.run_id = runs.run_id
+                  AND active.delivered_at IS NULL
+                  AND active.lease_owner IS NOT NULL
+                  AND active.lease_expires_at > now()
+              )
+            FOR UPDATE OF runs SKIP LOCKED
+          `,
+            [targetRunId],
           )
-        ORDER BY CASE WHEN head.event_type = 'run.created' THEN 0 ELSE 1 END,
-                 head.created_at, runs.run_id
-        FOR UPDATE OF runs SKIP LOCKED LIMIT 1
-      `,
-        [input.runId?.trim() || null],
-      );
+        : await client.query<{ run_id: string }>(`
+            WITH heads AS MATERIALIZED (
+              SELECT DISTINCT ON (pending.run_id)
+                pending.run_id,
+                pending.event_id,
+                pending.event_type,
+                pending.created_at,
+                pending.next_attempt_at,
+                pending.failed_at
+              FROM ${tableName('outbox', options)} AS pending
+              WHERE pending.delivered_at IS NULL
+              ORDER BY pending.run_id, ${runLedgerOrderSql('pending')}
+            )
+            SELECT runs.run_id
+            FROM heads AS head
+            JOIN ${tableName('runs', options)} AS runs ON runs.run_id = head.run_id
+            WHERE head.failed_at IS NULL
+              AND coalesce(head.next_attempt_at, head.created_at) <= now()
+              AND NOT EXISTS (
+                SELECT 1 FROM ${tableName('outbox', options)} AS active
+                WHERE active.run_id = runs.run_id
+                  AND active.delivered_at IS NULL
+                  AND active.lease_owner IS NOT NULL
+                  AND active.lease_expires_at > now()
+              )
+            ORDER BY CASE WHEN head.event_type = 'run.created' THEN 0 ELSE 1 END,
+                     head.created_at, runs.run_id
+            FOR UPDATE OF runs SKIP LOCKED LIMIT 1
+          `);
       const runId = selected.rows[0]?.run_id;
       const claimed = runId
         ? await readPendingPostgresSchedulerOutboxEvents(

package/dist/bundling-sources/shared_libs/play-runtime/scheduler-backends/run-ledger-outbox-recovery.ts

@@ -53,6 +53,13 @@ const MAX_TIMEOUT_MS = 2_147_483_647;
 // saturated the shared serverless scheduler pool before projection began.
 export const RUN_LEDGER_OUTBOX_RECOVERY_MAX_IN_FLIGHT = 32;
 
+// Two production replicas compete for the same durable queue. Eight delivery
+// slots per replica keep enough headroom to drain a webhook burst while
+// bounding one notification to sixteen global head claims across the service.
+// The higher exported ceiling remains available to isolated recovery callers,
+// but it is not the steady-state production setting.
+const RUN_LEDGER_OUTBOX_RECOVERY_PRODUCTION_IN_FLIGHT = 8;
+
 type RecoveryTimer = ReturnType<typeof setTimeout>;
 
 export type RunLedgerOutboxRecoveryLogger = Pick<Console, 'info' | 'warn'>;
@@ -385,10 +392,10 @@ export function startRunLedgerOutboxRecoveryController(input: {
         schedulerOptions,
       ),
     // `dispatchRunLedgerOutboxToLedgerBatchOnceWithClientScope` releases each
-    // short scheduler checkout before it calls the Vercel gateway. Keep the
-    // durable projection wave large enough for a webhook burst without
-    // expanding the process' Postgres connection budget.
-    parallelism: RUN_LEDGER_OUTBOX_RECOVERY_MAX_IN_FLIGHT,
+    // short scheduler checkout before it calls the Vercel gateway. The two
+    // replicas therefore drain up to sixteen independent runs concurrently
+    // without turning one outbox notification into sixty-four head scans.
+    parallelism: RUN_LEDGER_OUTBOX_RECOVERY_PRODUCTION_IN_FLIGHT,
     readNextDueAt: () =>
       withRuntimeSchedulerClient(input.poolOptions, (client) =>
         readPostgresSchedulerOutboxNextDueAt(client, schedulerOptions),

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

package/dist/release.d.mts

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