deepline 0.3.221 → 0.3.222

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.221',
+  version: '0.3.222',
   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/app-runtime-api.ts

@@ -52,8 +52,10 @@ import { PLAY_RUNTIME_API_COMPAT_PATH } from './/runtime-api-paths';
 import {
   buildRunLedgerEventsIdempotencyKey,
   isRunLedgerProjectionLeaseLostReason,
+  type RunLedgerProjectionChunk,
   type RunLedgerProjectionLeaseLostReason,
 } from './run-ledger-projection-contract';
+import { partitionRunEventsForAppRuntime } from './run-ledger-event-transport';
 import {
   RUNTIME_API_ACCEPTS_HEADER,
   gzipRuntimeApiRequestBody,
@@ -79,6 +81,8 @@ import {
   type RuntimeTrafficPolicy,
 } from './/runtime-traffic-policy';
 
+export type { RunLedgerProjectionChunk } from './run-ledger-projection-contract';
+
 export type StoredPlayArtifactPayload = {
   sourceCode: string;
   codeFormat: 'function' | 'cjs_module' | 'esm_module';
@@ -170,6 +174,7 @@ type RuntimeApiRequest =
       idempotencyKey?: string;
       deliveryIdempotencyKey?: string;
       deliveryLeaseOwner?: string;
+      projectionChunk?: RunLedgerProjectionChunk;
     }
   | {
       action: 'start_run';
@@ -499,9 +504,8 @@ const runStatusUpdateChains = new Map<string, Promise<void>>();
 const receiptClaimResponseTimeoutFaults = new Map<string, number>();
 const receiptClaimQueryHoldFaults = new Set<string>();
 const RECEIPT_CLAIM_RESPONSE_TIMEOUT_FAULT_LIMIT = 1_000;
-const APP_RUNTIME_LOG_EVENT_MAX_JSON_BYTES = 128 * 1024;
-const APP_RUNTIME_EVENT_BATCH_MAX_JSON_BYTES = 512 * 1024;
-const appRuntimeTextEncoder = new TextEncoder();
+
+export { partitionRunEventsForAppRuntime } from './run-ledger-event-transport';
 
 function shouldSuppressBulkClaimResponse(input: {
   body: RuntimeApiRequest;
@@ -593,106 +597,6 @@ async function suppressBulkClaimResponseUntilTimeout(
   });
 }
 
-function isRecord(value: unknown): value is Record<string, unknown> {
-  return Boolean(value && typeof value === 'object' && !Array.isArray(value));
-}
-
-function splitRunEventForAppRuntime(
-  event: PlayRunLedgerIngressEvent,
-): PlayRunLedgerIngressEvent[] {
-  const eventType =
-    typeof event.key === 'string'
-      ? event.key
-      : typeof event.type === 'string'
-        ? event.type
-        : null;
-  const payload = isRecord(event.payload) ? event.payload : null;
-  const payloadLines = payload?.lines;
-  const payloadOwnsLines = Array.isArray(payloadLines);
-  const rawLines = payloadOwnsLines ? payloadLines : event.lines;
-  const lines = Array.isArray(rawLines)
-    ? rawLines.filter((line): line is string => typeof line === 'string')
-    : [];
-  if (eventType !== 'log.appended' || lines.length === 0) return [event];
-  const payloadChannelOffset =
-    typeof payload?.channelOffset === 'number'
-      ? payload.channelOffset
-      : undefined;
-  const eventChannelOffset =
-    typeof event.channelOffset === 'number' ? event.channelOffset : undefined;
-  const split: PlayRunLedgerIngressEvent[] = [];
-  const { lines: _outerLines, ...eventWithoutOuterLines } = event;
-  let index = 0;
-  while (index < lines.length) {
-    const start = index;
-    let bytes = 2;
-    while (index < lines.length) {
-      const lineBytes = appRuntimeTextEncoder.encode(
-        JSON.stringify(lines[index]!),
-      ).length;
-      if (
-        index > start &&
-        bytes + lineBytes + 1 > APP_RUNTIME_LOG_EVENT_MAX_JSON_BYTES
-      ) {
-        break;
-      }
-      bytes += lineBytes + 1;
-      index += 1;
-    }
-    const batchLines = lines.slice(start, index);
-    split.push(
-      payload
-        ? {
-            ...eventWithoutOuterLines,
-            ...(payloadOwnsLines ? {} : { lines: batchLines }),
-            payload: {
-              ...payload,
-              ...(payloadOwnsLines ? { lines: batchLines } : {}),
-              ...(payloadChannelOffset === undefined
-                ? {}
-                : { channelOffset: payloadChannelOffset + start }),
-            },
-            ...(eventChannelOffset === undefined
-              ? {}
-              : { channelOffset: eventChannelOffset + start }),
-          }
-        : {
-            ...event,
-            lines: batchLines,
-            ...(eventChannelOffset === undefined
-              ? {}
-              : { channelOffset: eventChannelOffset + start }),
-          },
-    );
-  }
-  return split;
-}
-
-export function partitionRunEventsForAppRuntime(
-  events: readonly PlayRunLedgerIngressEvent[],
-): PlayRunLedgerIngressEvent[][] {
-  const batches: PlayRunLedgerIngressEvent[][] = [];
-  let current: PlayRunLedgerIngressEvent[] = [];
-  let currentBytes = 2;
-  for (const event of events.flatMap(splitRunEventForAppRuntime)) {
-    const eventBytes = appRuntimeTextEncoder.encode(
-      JSON.stringify(event),
-    ).length;
-    if (
-      current.length > 0 &&
-      currentBytes + eventBytes + 1 > APP_RUNTIME_EVENT_BATCH_MAX_JSON_BYTES
-    ) {
-      batches.push(current);
-      current = [];
-      currentBytes = 2;
-    }
-    current.push(event);
-    currentBytes += eventBytes + 1;
-  }
-  if (current.length > 0) batches.push(current);
-  return batches;
-}
-
 async function appendRunEventBatchesViaAppRuntime(
   context: WorkerRuntimeApiContext,
   input: { playId: string; events: readonly PlayRunLedgerEvent[] },
@@ -2436,6 +2340,9 @@ export async function projectRunEventsViaAppRuntime(
       idempotencyKey,
       deliveryIdempotencyKey: input.idempotencyKey,
       deliveryLeaseOwner: input.deliveryLeaseOwner,
+      ...(batches.length > 1
+        ? { projectionChunk: { index, count: batches.length } }
+        : {}),
     };
     // The durable outbox owns recovery; this helper does not retry OCCs or
     // other delivery failures inside an already-leased invocation.

package/dist/bundling-sources/shared_libs/play-runtime/run-ledger-event-transport.ts

@@ -0,0 +1,110 @@
+import type { PlayRunLedgerIngressEvent } from './run-ledger';
+
+const APP_RUNTIME_LOG_EVENT_MAX_JSON_BYTES = 128 * 1024;
+const APP_RUNTIME_EVENT_BATCH_MAX_JSON_BYTES = 512 * 1024;
+const appRuntimeTextEncoder = new TextEncoder();
+
+function isRecord(value: unknown): value is Record<string, unknown> {
+  return Boolean(value && typeof value === 'object' && !Array.isArray(value));
+}
+
+function splitRunEventForAppRuntime(
+  event: PlayRunLedgerIngressEvent,
+): PlayRunLedgerIngressEvent[] {
+  const eventType =
+    typeof event.key === 'string'
+      ? event.key
+      : typeof event.type === 'string'
+        ? event.type
+        : null;
+  const payload = isRecord(event.payload) ? event.payload : null;
+  const payloadLines = payload?.lines;
+  const payloadOwnsLines = Array.isArray(payloadLines);
+  const rawLines = payloadOwnsLines ? payloadLines : event.lines;
+  const lines = Array.isArray(rawLines)
+    ? rawLines.filter((line): line is string => typeof line === 'string')
+    : [];
+  if (eventType !== 'log.appended' || lines.length === 0) return [event];
+  const payloadChannelOffset =
+    typeof payload?.channelOffset === 'number'
+      ? payload.channelOffset
+      : undefined;
+  const eventChannelOffset =
+    typeof event.channelOffset === 'number' ? event.channelOffset : undefined;
+  const split: PlayRunLedgerIngressEvent[] = [];
+  const { lines: _outerLines, ...eventWithoutOuterLines } = event;
+  let index = 0;
+  while (index < lines.length) {
+    const start = index;
+    let bytes = 2;
+    while (index < lines.length) {
+      const lineBytes = appRuntimeTextEncoder.encode(
+        JSON.stringify(lines[index]!),
+      ).length;
+      if (
+        index > start &&
+        bytes + lineBytes + 1 > APP_RUNTIME_LOG_EVENT_MAX_JSON_BYTES
+      ) {
+        break;
+      }
+      bytes += lineBytes + 1;
+      index += 1;
+    }
+    const batchLines = lines.slice(start, index);
+    split.push(
+      payload
+        ? {
+            ...eventWithoutOuterLines,
+            ...(payloadOwnsLines ? {} : { lines: batchLines }),
+            payload: {
+              ...payload,
+              ...(payloadOwnsLines ? { lines: batchLines } : {}),
+              ...(payloadChannelOffset === undefined
+                ? {}
+                : { channelOffset: payloadChannelOffset + start }),
+            },
+            ...(eventChannelOffset === undefined
+              ? {}
+              : { channelOffset: eventChannelOffset + start }),
+          }
+        : {
+            ...event,
+            lines: batchLines,
+            ...(eventChannelOffset === undefined
+              ? {}
+              : { channelOffset: eventChannelOffset + start }),
+          },
+    );
+  }
+  return split;
+}
+
+/**
+ * Reproduce the exact event and byte boundaries used by the App Runtime API.
+ * The outbox lease verifier uses this same function to validate each chunk
+ * against its canonical event prefix before accepting a projection.
+ */
+export function partitionRunEventsForAppRuntime(
+  events: readonly PlayRunLedgerIngressEvent[],
+): PlayRunLedgerIngressEvent[][] {
+  const batches: PlayRunLedgerIngressEvent[][] = [];
+  let current: PlayRunLedgerIngressEvent[] = [];
+  let currentBytes = 2;
+  for (const event of events.flatMap(splitRunEventForAppRuntime)) {
+    const eventBytes = appRuntimeTextEncoder.encode(
+      JSON.stringify(event),
+    ).length;
+    if (
+      current.length > 0 &&
+      currentBytes + eventBytes + 1 > APP_RUNTIME_EVENT_BATCH_MAX_JSON_BYTES
+    ) {
+      batches.push(current);
+      current = [];
+      currentBytes = 2;
+    }
+    current.push(event);
+    currentBytes += eventBytes + 1;
+  }
+  if (current.length > 0) batches.push(current);
+  return batches;
+}

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

@@ -10,6 +10,29 @@ const UUID_PATTERN =
   /^[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i;
 const SHA256_HEX_PATTERN = /^[0-9a-f]{64}$/i;
 
+/** Identifies one bounded transport piece of a canonical outbox projection. */
+export type RunLedgerProjectionChunk = {
+  index: number;
+  count: number;
+};
+
+/** Shared wire validation for the app route and the outbox lease verifier. */
+export function isRunLedgerProjectionChunk(
+  value: unknown,
+): value is RunLedgerProjectionChunk {
+  if (!value || typeof value !== 'object' || Array.isArray(value)) {
+    return false;
+  }
+  const candidate = value as Record<string, unknown>;
+  return (
+    Number.isSafeInteger(candidate.index) &&
+    Number.isSafeInteger(candidate.count) &&
+    Number(candidate.index) >= 0 &&
+    Number(candidate.count) > 1 &&
+    Number(candidate.index) < Number(candidate.count)
+  );
+}
+
 export const RUN_LEDGER_PROJECTION_LEASE_LOST_REASONS = [
   'delivery_lease_not_current',
   'head_lease_missing',

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

@@ -94,11 +94,14 @@ import {
 } from '../log-provenance';
 import {
   buildRunLedgerEventsIdempotencyKey,
+  isRunLedgerProjectionChunk,
   RunLedgerProjectionLeaseLostError,
+  type RunLedgerProjectionChunk,
   type RunLedgerProjectionLeaseLostReason,
   buildRunLedgerStartIdempotencyKey,
   buildRunLedgerTerminalIdempotencyKey,
 } from '../run-ledger-projection-contract';
+import { partitionRunEventsForAppRuntime } from '../run-ledger-event-transport';
 import {
   assertTerminalRunResultWithinLimit,
   isLedgerTerminalResultRef,
@@ -16026,6 +16029,7 @@ export async function assertPostgresRunLedgerDelivery(
     idempotencyKey: string;
     leaseOwner?: string;
     projectedEvents?: readonly AcceptedPlayRunLedgerEvent[];
+    projectionChunk?: RunLedgerProjectionChunk;
     normalizeProjectedEvents?: (
       events: readonly PlayRunLedgerIngressEvent[],
     ) => readonly AcceptedPlayRunLedgerEvent[];
@@ -16165,10 +16169,24 @@ export async function assertPostgresRunLedgerDelivery(
       )[] = input.normalizeProjectedEvents
         ? input.normalizeProjectedEvents(prefixEvents)
         : prefixEvents;
+      let expectedProjectionEvents:
+        | readonly (AcceptedPlayRunLedgerEvent | PlayRunLedgerIngressEvent)[]
+        | undefined = comparablePrefixEvents;
+      if (input.projectionChunk) {
+        const chunk = input.projectionChunk;
+        const chunks = isRunLedgerProjectionChunk(chunk)
+          ? partitionRunEventsForAppRuntime(
+              comparablePrefixEvents as readonly PlayRunLedgerIngressEvent[],
+            )
+          : [];
+        expectedProjectionEvents =
+          chunks.length === chunk.count ? chunks[chunk.index] : undefined;
+      }
       if (
+        expectedProjectionEvents !== undefined &&
         runLedgerProjectionMatchesCanonicalPrefix(
           input.projectedEvents,
-          comparablePrefixEvents,
+          expectedProjectionEvents,
         )
       ) {
         return;

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.221",
+  version: "0.3.222",
   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.221",
+  version: "0.3.222",
   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.221",
+  version: "0.3.222",
   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.221",
+  version: "0.3.222",
   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

@@ -293,6 +293,7 @@
     "dist/bundling-sources/shared_libs/play-runtime/run-execution-scope.ts",
     "dist/bundling-sources/shared_libs/play-runtime/run-failure.ts",
     "dist/bundling-sources/shared_libs/play-runtime/run-identity.ts",
+    "dist/bundling-sources/shared_libs/play-runtime/run-ledger-event-transport.ts",
     "dist/bundling-sources/shared_libs/play-runtime/run-ledger-projection-contract.ts",
     "dist/bundling-sources/shared_libs/play-runtime/run-ledger.ts",
     "dist/bundling-sources/shared_libs/play-runtime/run-lifecycle-policy.ts",

package/dist/release.d.mts

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