deepline 0.3.226 → 0.3.228

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.226',
+  version: '0.3.228',
   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/run-ledger-event-transport.ts

@@ -132,3 +132,32 @@ export function selectRunEventsForAppRuntimeProjectionChunk(
   const batches = partitionRunEventsForAppRuntime(events);
   return batches.length === chunk.count ? batches[chunk.index] : undefined;
 }
+
+/**
+ * Return the wire shapes accepted by the lease verifier. Older projectors sent
+ * the canonical events directly; current projectors also split large log
+ * events before grouping them into HTTP batches. A split can still fit in one
+ * HTTP batch, so that request has no projection chunk marker.
+ */
+export function runEventsForAppRuntimeProjectionCandidates(
+  events: readonly PlayRunLedgerIngressEvent[],
+  chunk?: RunLedgerProjectionChunk,
+): Array<PlayRunLedgerIngressEvent[] | null> {
+  if (chunk) {
+    return [selectRunEventsForAppRuntimeProjectionChunk(events, chunk) ?? null];
+  }
+
+  const candidates: PlayRunLedgerIngressEvent[][] = [[...events]];
+  const batches = partitionRunEventsForAppRuntime(events);
+  if (batches.length === 1) {
+    const transportBatch = batches[0];
+    if (
+      transportBatch &&
+      (transportBatch.length !== events.length ||
+        transportBatch.some((event, index) => event !== events[index]))
+    ) {
+      candidates.push(transportBatch);
+    }
+  }
+  return candidates;
+}

package/dist/bundling-sources/shared_libs/play-runtime/run-ledger-projection-diagnostics.ts

@@ -15,6 +15,10 @@ type ComparableRunLedgerEvent =
   | AcceptedPlayRunLedgerEvent
   | PlayRunLedgerIngressEvent;
 
+type RunLedgerProjectionEventCandidate =
+  | readonly ComparableRunLedgerEvent[]
+  | null;
+
 /**
  * A newer app may receive a projection from a worker that predates optional
  * wait metadata. Normalize only those absent fields before the exact compare.
@@ -95,7 +99,7 @@ function safeMismatchedFields(
  */
 export function runLedgerProjectionMismatch(input: {
   projectedEvents: readonly AcceptedPlayRunLedgerEvent[];
-  expectedEvents: readonly ComparableRunLedgerEvent[] | null;
+  expectedEvents: RunLedgerProjectionEventCandidate;
   chunk?: RunLedgerProjectionChunk;
 }): RunLedgerProjectionMismatchDiagnostic | null {
   const chunkIndex = input.chunk?.index ?? null;
@@ -149,3 +153,41 @@ export function runLedgerProjectionMismatch(input: {
   }
   return null;
 }
+
+/**
+ * Compare a received projection against every wire shape accepted for its
+ * canonical prefix. Prefer a mismatch with the same event count as the
+ * received projection, since it identifies the first content difference
+ * instead of reporting a secondary count difference.
+ */
+export function runLedgerProjectionMismatchAcrossCandidates(input: {
+  projectedEvents: readonly AcceptedPlayRunLedgerEvent[];
+  expectedEventCandidates: readonly RunLedgerProjectionEventCandidate[];
+  chunk?: RunLedgerProjectionChunk;
+}): RunLedgerProjectionMismatchDiagnostic | null {
+  if (input.expectedEventCandidates.length === 0) {
+    return runLedgerProjectionMismatch({
+      projectedEvents: input.projectedEvents,
+      expectedEvents: null,
+      ...(input.chunk ? { chunk: input.chunk } : {}),
+    });
+  }
+
+  let bestMismatch: RunLedgerProjectionMismatchDiagnostic | null = null;
+  for (const expectedEvents of input.expectedEventCandidates) {
+    const mismatch = runLedgerProjectionMismatch({
+      projectedEvents: input.projectedEvents,
+      expectedEvents,
+      ...(input.chunk ? { chunk: input.chunk } : {}),
+    });
+    if (mismatch === null) return null;
+    if (
+      bestMismatch === null ||
+      (mismatch.expectedEventCount === input.projectedEvents.length &&
+        bestMismatch.expectedEventCount !== input.projectedEvents.length)
+    ) {
+      bestMismatch = mismatch;
+    }
+  }
+  return bestMismatch;
+}

package/dist/bundling-sources/shared_libs/play-runtime/runtime-map-row-feed.ts

@@ -39,6 +39,11 @@ type Waiter<T> = {
   timer: ReturnType<typeof setTimeout>;
 };
 
+type DrainWaiter = Waiter<void> & {
+  idleStartedAt: number;
+  onTimeout: () => void;
+};
+
 export class RuntimeMapRowFeed {
   #appended = 0;
   #dispatched = 0;
@@ -47,7 +52,7 @@ export class RuntimeMapRowFeed {
   #failure: unknown = null;
   #failed = false;
   readonly #rowWaiters = new Map<Waiter<boolean>, number>();
-  #drainWaiter: Waiter<void> | null = null;
+  #drainWaiter: DrainWaiter | null = null;
   #onAppended: ((fromIndex: number, toIndex: number) => void) | null = null;
   readonly #maxWaitMs: number;
 
@@ -70,7 +75,9 @@ export class RuntimeMapRowFeed {
       throw new Error('Runtime map row feed is closed; cannot append rows.');
     }
     if (!Number.isInteger(rowCount) || rowCount < 0) {
-      throw new Error(`Runtime map row feed append count must be a non-negative integer, got ${String(rowCount)}.`);
+      throw new Error(
+        `Runtime map row feed append count must be a non-negative integer, got ${String(rowCount)}.`,
+      );
     }
     const fromIndex = this.#appended;
     this.#appended += rowCount;
@@ -111,13 +118,29 @@ export class RuntimeMapRowFeed {
   }
 
   markDispatched(count = 1): void {
-    this.#dispatched += count;
-    if (this.#dispatched > this.#appended) {
+    if (!Number.isInteger(count) || count < 0) {
       throw new Error(
-        `Runtime map row feed dispatched ${this.#dispatched} rows but only ${this.#appended} were appended.`,
+        `Runtime map row feed dispatch count must be a non-negative integer, got ${String(count)}.`,
       );
     }
+    const dispatched = this.#dispatched + count;
+    if (dispatched > this.#appended) {
+      throw new Error(
+        `Runtime map row feed dispatched ${dispatched} rows but only ${this.#appended} were appended.`,
+      );
+    }
+    this.#dispatched = dispatched;
     this.#settleDrainWaiter();
+    const waiter = this.#drainWaiter;
+    if (count > 0 && waiter) {
+      // A slow page can take longer than the idle bound to dispatch. Only
+      // advancing its pending work resets the diagnostic, never page age,
+      // provider logs, or unrelated activity.
+      clearTimeout(waiter.timer);
+      waiter.idleStartedAt = Date.now();
+      waiter.timer = setTimeout(waiter.onTimeout, this.#maxWaitMs);
+      waiter.timer.unref?.();
+    }
   }
 
   /**
@@ -149,7 +172,7 @@ export class RuntimeMapRowFeed {
     });
   }
 
-  /** Resolves once every appended row has been dispatched to a worker. */
+  /** Resolves on full dispatch; rejects after the bound with no dispatch progress. */
   waitUntilDrained(): Promise<void> {
     if (this.#failed) return Promise.reject(this.#failure);
     if (this.#dispatched >= this.#appended) return Promise.resolve();
@@ -159,22 +182,25 @@ export class RuntimeMapRowFeed {
       );
     }
     return new Promise<void>((resolve, reject) => {
-      const startedAt = Date.now();
-      this.#drainWaiter = {
+      const waiter: DrainWaiter = {
         resolve,
         reject,
-        timer: setTimeout(() => {
+        idleStartedAt: Date.now(),
+        onTimeout: () => {
+          if (this.#drainWaiter !== waiter) return;
           this.#drainWaiter = null;
           reject(
             new RuntimeMapRowFeedStalledError({
               waiter: 'pump',
-              waitMs: Date.now() - startedAt,
+              waitMs: Date.now() - waiter.idleStartedAt,
               snapshot: this.snapshot(),
             }),
           );
-        }, this.#maxWaitMs),
+        },
+        timer: setTimeout(() => waiter.onTimeout(), this.#maxWaitMs),
       };
-      this.#drainWaiter.timer.unref?.();
+      this.#drainWaiter = waiter;
+      waiter.timer.unref?.();
     });
   }
 

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

@@ -93,7 +93,6 @@ import {
 } from '../log-provenance';
 import {
   buildRunLedgerEventsIdempotencyKey,
-  isRunLedgerProjectionChunk,
   RunLedgerProjectionLeaseLostError,
   type RunLedgerProjectionChunk,
   type RunLedgerProjectionLeaseLostReason,
@@ -101,8 +100,8 @@ import {
   buildRunLedgerStartIdempotencyKey,
   buildRunLedgerTerminalIdempotencyKey,
 } from '../run-ledger-projection-contract';
-import { runLedgerProjectionMismatch } from '../run-ledger-projection-diagnostics';
-import { selectRunEventsForAppRuntimeProjectionChunk } from '../run-ledger-event-transport';
+import { runLedgerProjectionMismatchAcrossCandidates } from '../run-ledger-projection-diagnostics';
+import { runEventsForAppRuntimeProjectionCandidates } from '../run-ledger-event-transport';
 import {
   assertTerminalRunResultWithinLimit,
   isLedgerTerminalResultRef,
@@ -16106,32 +16105,22 @@ export async function assertPostgresRunLedgerDelivery(
           }),
         );
       }
-      let expectedProjectionEvents:
-        | readonly (AcceptedPlayRunLedgerEvent | PlayRunLedgerIngressEvent)[]
-        | undefined;
-      if (input.projectionChunk) {
-        const chunk = input.projectionChunk;
-        // The sender partitions ingress events before the route sanitizes each chunk.
-        const expectedTransportChunk = isRunLedgerProjectionChunk(chunk)
-          ? selectRunEventsForAppRuntimeProjectionChunk(prefixEvents, chunk)
-          : undefined;
-        expectedProjectionEvents =
-          expectedTransportChunk === undefined
-            ? undefined
+      const expectedProjectionCandidates =
+        runEventsForAppRuntimeProjectionCandidates(
+          prefixEvents,
+          input.projectionChunk,
+        ).map((candidate) =>
+          candidate === null
+            ? null
             : input.sanitizeExpectedProjectionEvents
-              ? input.sanitizeExpectedProjectionEvents(expectedTransportChunk)
-              : expectedTransportChunk;
-      } else {
-        expectedProjectionEvents = input.sanitizeExpectedProjectionEvents
-          ? input.sanitizeExpectedProjectionEvents(prefixEvents)
-          : prefixEvents;
-      }
-      const projectionMismatch: RunLedgerProjectionMismatchDiagnostic | null =
-        runLedgerProjectionMismatch({
-          projectedEvents: input.projectedEvents,
-          expectedEvents: expectedProjectionEvents ?? null,
-          ...(input.projectionChunk ? { chunk: input.projectionChunk } : {}),
-        });
+              ? input.sanitizeExpectedProjectionEvents(candidate)
+              : candidate,
+        );
+      const projectionMismatch = runLedgerProjectionMismatchAcrossCandidates({
+        projectedEvents: input.projectedEvents,
+        expectedEventCandidates: expectedProjectionCandidates,
+        ...(input.projectionChunk ? { chunk: input.projectionChunk } : {}),
+      });
       if (projectionMismatch === null) return;
       throw new RunLedgerProjectionLeaseLostError(
         'projected_events_mismatch',

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.226",
+  version: "0.3.228",
   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.226",
+  version: "0.3.228",
   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.226",
+  version: "0.3.228",
   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.226",
+  version: "0.3.228",
   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.226";
+    readonly version: "0.3.228";
     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.226";
+    readonly version: "0.3.228";
     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.226",
+  version: "0.3.228",
   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.226",
+  version: "0.3.228",
   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.226",
+  "version": "0.3.228",
   "description": "GTM data CLI and TypeScript SDK for coding agents",
   "license": "MIT",
   "homepage": "https://code.deepline.com",