deepline 0.3.289 → 0.3.290

package/dist/bundling-sources/shared_libs/play-runtime/scheduler-backends/runtime-receipt-value-storage.ts

@@ -85,6 +85,8 @@ type RuntimeReceiptValueStorageInput = {
   inlineFields?: RuntimeReceiptValueInlineFields;
   inlineMaxBytes?: number;
   store?: RuntimeReceiptValueBlobStore;
+  /** Consult the durable writer fence only when this value needs a reference. */
+  referencesWritable?: () => Promise<boolean>;
 };
 
 export type PersistedRuntimeReceiptValue =
@@ -206,7 +208,10 @@ export async function persistRuntimeReceiptValue(
     input.inlineFields === undefined
       ? undefined
       : normalizeRuntimeReceiptValueInlineFields(input.inlineFields);
-  if (body.byteLength <= inlineMaxBytes) {
+  if (
+    body.byteLength <= inlineMaxBytes ||
+    (input.referencesWritable && !(await input.referencesWritable()))
+  ) {
     return { kind: 'inline', outputJson: input.serialized };
   }
 
@@ -242,6 +247,7 @@ export function createRuntimeReceiptValuePersister(
   input: {
     store?: RuntimeReceiptValueBlobStore;
     inlineMaxBytes?: number;
+    referencesWritable?: () => Promise<boolean>;
   } = {},
 ): RuntimeReceiptValuePersister {
   const inlineMaxBytes =
@@ -278,6 +284,9 @@ export function createRuntimeReceiptValuePersister(
                 ...value,
                 inlineMaxBytes,
                 ...(input.store ? { store: input.store } : {}),
+                ...(input.referencesWritable
+                  ? { referencesWritable: input.referencesWritable }
+                  : {}),
               }),
             };
           } catch (error) {

package/dist/bundling-sources/shared_libs/play-runtime/test-admission-batching.ts

@@ -0,0 +1,103 @@
+import {
+  defineBatchStrategyMap,
+  type BatchOperationStrategy,
+} from './batching-types';
+
+type Single = {
+  key: string;
+  simulated_delay_ms?: number;
+  overlap_group?: string;
+};
+type Result = {
+  key: string;
+  physical_id: string;
+  batch_size: number;
+  started_at_ms: number;
+  finished_at_ms: number;
+};
+type Bulk = {
+  items: Array<{ key: string }>;
+  simulated_delay_ms?: number;
+  overlap_group?: string;
+};
+const bucket = (input: Single) =>
+  JSON.stringify([input.simulated_delay_ms ?? 0, input.overlap_group ?? null]);
+
+const strategy: BatchOperationStrategy<
+  Single,
+  Single | Bulk,
+  Result | { items: Result[] },
+  Result
+> = {
+  sourceOperation: 'test_batching_single',
+  batchOperation: 'test_batching_bulk',
+  kind: 'identifier_batch',
+  maxBatchSize: 100,
+  bucketKeyPayloadFields: ['simulated_delay_ms', 'overlap_group'],
+  toBucketKey: bucket,
+  toItemKey: (input) => input.key,
+  canBatchWith: (left, right) => bucket(left) === bucket(right),
+  compile(inputs) {
+    const first = inputs[0];
+    if (
+      !first ||
+      inputs.length > 100 ||
+      inputs.some((input) => !input.key || bucket(input) !== bucket(first))
+    ) {
+      throw new Error('Synthetic batch needs 1–100 compatible keyed members.');
+    }
+    const keys = [...new Set(inputs.map((input) => input.key))];
+    return {
+      batchOperation:
+        keys.length === 1 ? 'test_batching_single' : 'test_batching_bulk',
+      batchPayload:
+        keys.length === 1
+          ? first
+          : {
+              items: keys.map((key) => ({ key })),
+              simulated_delay_ms: first.simulated_delay_ms,
+              ...(first.overlap_group
+                ? { overlap_group: first.overlap_group }
+                : {}),
+            },
+      items: inputs.map((payload) => ({ itemKey: payload.key, payload })),
+    };
+  },
+  splitResult(result, compiled) {
+    const rows =
+      compiled.batchOperation === 'test_batching_single'
+        ? [result as Result]
+        : (result as { items: Result[] }).items;
+    if (!Array.isArray(rows))
+      throw new Error('Synthetic batch omitted its result list.');
+    const byKey = new Map<string, Result>();
+    const expected = new Set(compiled.items.map((item) => item.itemKey));
+    for (const row of rows) {
+      if (
+        !row ||
+        !expected.has(row.key) ||
+        byKey.has(row.key) ||
+        typeof row.physical_id !== 'string' ||
+        row.physical_id.length === 0 ||
+        row.batch_size !== expected.size ||
+        !Number.isInteger(row.started_at_ms) ||
+        row.started_at_ms < 0 ||
+        !Number.isInteger(row.finished_at_ms) ||
+        row.finished_at_ms < row.started_at_ms
+      ) {
+        throw new Error(
+          'Synthetic batch returned a malformed or unexpected member.',
+        );
+      }
+      byKey.set(row.key, row);
+    }
+    return compiled.items.map((item) => {
+      const row = byKey.get(item.itemKey);
+      if (!row) throw new Error('Synthetic batch omitted a member.');
+      return { itemKey: item.itemKey, result: row, rawResult: row };
+    });
+  },
+};
+export const testAdmissionBatchStrategies = defineBatchStrategyMap({
+  test_batching_single: strategy,
+});

package/dist/bundling-sources/shared_libs/play-runtime/zerobounce-batching.ts

@@ -8,11 +8,38 @@ type Bulk = {
   email_batch: Array<{ email_address: string; ip_address?: string }>;
 };
 type Verdict = Record<string, unknown> & { address: string; status: string };
-type Results = { email_batch?: unknown[]; errors?: unknown[]; data?: Results };
+type Results = {
+  email_batch?: unknown[];
+  errors?: unknown[];
+  data?: Results;
+  // The scalar validate endpoint returns one verdict at the top level.
+  address?: unknown;
+  status?: unknown;
+};
+
+const VERDICT_STATUSES = [
+  'valid',
+  'invalid',
+  'catch-all',
+  'unknown',
+  'spamtrap',
+  'abuse',
+  'do_not_mail',
+];
 
 function emailKey(email: string) {
   return email.trim().toLowerCase();
 }
+
+function isVerdict(value: unknown): value is Verdict {
+  const row = value as Verdict | null;
+  return Boolean(
+    row &&
+    typeof row.address === 'string' &&
+    typeof row.status === 'string' &&
+    VERDICT_STATUSES.includes(row.status),
+  );
+}
 function bucket(payload: Single) {
   // The response identifies emails, but does not echo the supplied IP.
   return JSON.stringify([
@@ -23,7 +50,7 @@ function bucket(payload: Single) {
 
 export const zerobounceValidateBatchStrategy: BatchOperationStrategy<
   Single,
-  Bulk,
+  Bulk | Single,
   Results,
   { data: Verdict }
 > = {
@@ -47,25 +74,58 @@ export const zerobounceValidateBatchStrategy: BatchOperationStrategy<
         'ZeroBounce batch requires 1–100 emails with matching IP options.',
       );
     }
+    const items = payloads.map((payload) => ({
+      itemKey: zerobounceValidateBatchStrategy.toItemKey(payload),
+      payload,
+    }));
+    const emails = [...new Set(payloads.map((p) => emailKey(p.email!)))];
+    if (emails.length === 1) {
+      // One distinct email (a per-row waterfall, duplicate rows, or receipt
+      // dedup leaving one owned member) must not ride the bulk endpoint:
+      // zerobounce_batch_validate is gated at 30/min provider_shared, while
+      // the scalar validate endpoint allows 80,000 validations per 10 s.
+      // Compiling here covers both the receipt-owned cohort
+      // (compileOwnedPhysicalBatch) and the legacy path.
+      return {
+        batchOperation: 'zerobounce_validate',
+        batchPayload: first,
+        items,
+      };
+    }
     return {
-      // Receipt deduplication may leave one owned email. Keep the bulk operation.
       batchOperation: 'zerobounce_batch_validate',
       batchPayload: {
-        email_batch: [...new Set(payloads.map((p) => emailKey(p.email!)))].map(
-          (email_address) => ({
-            email_address,
-            ...(first.ip_address ? { ip_address: first.ip_address } : {}),
-          }),
-        ),
+        email_batch: emails.map((email_address) => ({
+          email_address,
+          ...(first.ip_address ? { ip_address: first.ip_address } : {}),
+        })),
       },
-      items: payloads.map((payload) => ({
-        itemKey: zerobounceValidateBatchStrategy.toItemKey(payload),
-        payload,
-      })),
+      items,
     };
   },
   splitResult(fullResult, compiled) {
     const result = fullResult.data ?? fullResult;
+    if (compiled.batchOperation === 'zerobounce_validate') {
+      if (
+        !isVerdict(result) ||
+        compiled.items.some(
+          (item) => emailKey(result.address) !== emailKey(item.payload.email!),
+        )
+      ) {
+        throw new Error(
+          'ZeroBounce single verification returned a malformed or mismatched verdict.',
+        );
+      }
+      // Every item shares the one distinct email this call verified.
+      return compiled.items.map((item) => ({
+        itemKey: item.itemKey,
+        result: { data: result },
+        rawResult: result,
+      }));
+    }
+    if (!('email_batch' in compiled.batchPayload)) {
+      throw new Error('ZeroBounce bulk split received a scalar payload.');
+    }
     if (
       !Array.isArray(result.email_batch) ||
       (result.errors !== undefined &&
@@ -79,21 +139,8 @@ export const zerobounceValidateBatchStrategy: BatchOperationStrategy<
       compiled.batchPayload.email_batch.map((p) => emailKey(p.email_address)),
     );
     const byEmail = new Map<string, Verdict>();
-    for (const value of result.email_batch) {
-      const row = value as Verdict | null;
-      if (
-        !row ||
-        typeof row.address !== 'string' ||
-        ![
-          'valid',
-          'invalid',
-          'catch-all',
-          'unknown',
-          'spamtrap',
-          'abuse',
-          'do_not_mail',
-        ].includes(row.status)
-      ) {
+    for (const row of result.email_batch) {
+      if (!isVerdict(row)) {
         throw new Error(
           'ZeroBounce bulk verification returned a malformed verdict.',
         );

package/dist/cli/index.js

@@ -3515,7 +3515,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.289",
+  version: "0.3.290",
   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
@@ -5551,6 +5551,7 @@ var RUN_SCHEDULER_OUTBOX_EVENT_TYPE = {
   runCancelled: RUN_EVENT_KIND.runCancelled,
   runEvents: "run.events",
   runnerLogs: "runner.logs",
+  receiptEvent: "receipt.event",
   runWaitTimeout: "run.wait_timeout"
 };
 var RUN_SCHEDULER_OUTBOX_EVENT_TYPES = Object.freeze(
@@ -5651,6 +5652,7 @@ var RUN_SCHEDULER_OUTBOX_EVENT_TYPE_SQL_LITERAL = {
   runCancelled: sqlStringLiteral(RUN_SCHEDULER_OUTBOX_EVENT_TYPE.runCancelled),
   runEvents: sqlStringLiteral(RUN_SCHEDULER_OUTBOX_EVENT_TYPE.runEvents),
   runnerLogs: sqlStringLiteral(RUN_SCHEDULER_OUTBOX_EVENT_TYPE.runnerLogs),
+  receiptEvent: sqlStringLiteral(RUN_SCHEDULER_OUTBOX_EVENT_TYPE.receiptEvent),
   runWaitTimeout: sqlStringLiteral(
     RUN_SCHEDULER_OUTBOX_EVENT_TYPE.runWaitTimeout
   )

package/dist/cli/index.mjs

@@ -3510,7 +3510,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.289",
+  version: "0.3.290",
   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
@@ -5546,6 +5546,7 @@ var RUN_SCHEDULER_OUTBOX_EVENT_TYPE = {
   runCancelled: RUN_EVENT_KIND.runCancelled,
   runEvents: "run.events",
   runnerLogs: "runner.logs",
+  receiptEvent: "receipt.event",
   runWaitTimeout: "run.wait_timeout"
 };
 var RUN_SCHEDULER_OUTBOX_EVENT_TYPES = Object.freeze(
@@ -5646,6 +5647,7 @@ var RUN_SCHEDULER_OUTBOX_EVENT_TYPE_SQL_LITERAL = {
   runCancelled: sqlStringLiteral(RUN_SCHEDULER_OUTBOX_EVENT_TYPE.runCancelled),
   runEvents: sqlStringLiteral(RUN_SCHEDULER_OUTBOX_EVENT_TYPE.runEvents),
   runnerLogs: sqlStringLiteral(RUN_SCHEDULER_OUTBOX_EVENT_TYPE.runnerLogs),
+  receiptEvent: sqlStringLiteral(RUN_SCHEDULER_OUTBOX_EVENT_TYPE.receiptEvent),
   runWaitTimeout: sqlStringLiteral(
     RUN_SCHEDULER_OUTBOX_EVENT_TYPE.runWaitTimeout
   )

package/dist/index.js

@@ -1328,7 +1328,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.289",
+  version: "0.3.290",
   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
@@ -3302,6 +3302,7 @@ var RUN_SCHEDULER_OUTBOX_EVENT_TYPE = {
   runCancelled: RUN_EVENT_KIND.runCancelled,
   runEvents: "run.events",
   runnerLogs: "runner.logs",
+  receiptEvent: "receipt.event",
   runWaitTimeout: "run.wait_timeout"
 };
 var RUN_SCHEDULER_OUTBOX_EVENT_TYPES = Object.freeze(
@@ -3402,6 +3403,7 @@ var RUN_SCHEDULER_OUTBOX_EVENT_TYPE_SQL_LITERAL = {
   runCancelled: sqlStringLiteral(RUN_SCHEDULER_OUTBOX_EVENT_TYPE.runCancelled),
   runEvents: sqlStringLiteral(RUN_SCHEDULER_OUTBOX_EVENT_TYPE.runEvents),
   runnerLogs: sqlStringLiteral(RUN_SCHEDULER_OUTBOX_EVENT_TYPE.runnerLogs),
+  receiptEvent: sqlStringLiteral(RUN_SCHEDULER_OUTBOX_EVENT_TYPE.receiptEvent),
   runWaitTimeout: sqlStringLiteral(
     RUN_SCHEDULER_OUTBOX_EVENT_TYPE.runWaitTimeout
   )

package/dist/index.mjs

@@ -1232,7 +1232,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.289",
+  version: "0.3.290",
   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
@@ -3206,6 +3206,7 @@ var RUN_SCHEDULER_OUTBOX_EVENT_TYPE = {
   runCancelled: RUN_EVENT_KIND.runCancelled,
   runEvents: "run.events",
   runnerLogs: "runner.logs",
+  receiptEvent: "receipt.event",
   runWaitTimeout: "run.wait_timeout"
 };
 var RUN_SCHEDULER_OUTBOX_EVENT_TYPES = Object.freeze(
@@ -3306,6 +3307,7 @@ var RUN_SCHEDULER_OUTBOX_EVENT_TYPE_SQL_LITERAL = {
   runCancelled: sqlStringLiteral(RUN_SCHEDULER_OUTBOX_EVENT_TYPE.runCancelled),
   runEvents: sqlStringLiteral(RUN_SCHEDULER_OUTBOX_EVENT_TYPE.runEvents),
   runnerLogs: sqlStringLiteral(RUN_SCHEDULER_OUTBOX_EVENT_TYPE.runnerLogs),
+  receiptEvent: sqlStringLiteral(RUN_SCHEDULER_OUTBOX_EVENT_TYPE.receiptEvent),
   runWaitTimeout: sqlStringLiteral(
     RUN_SCHEDULER_OUTBOX_EVENT_TYPE.runWaitTimeout
   )

package/dist/install-integrity.json

@@ -394,6 +394,7 @@
     "dist/bundling-sources/shared_libs/play-runtime/scheduler-backends/absurd-deadline-reconciliation.ts",
     "dist/bundling-sources/shared_libs/play-runtime/scheduler-backends/absurd-play-deploy-task.ts",
     "dist/bundling-sources/shared_libs/play-runtime/scheduler-backends/absurd-play-run-task.ts",
+    "dist/bundling-sources/shared_libs/play-runtime/scheduler-backends/absurd-pool-options.ts",
     "dist/bundling-sources/shared_libs/play-runtime/scheduler-backends/absurd-pool.ts",
     "dist/bundling-sources/shared_libs/play-runtime/scheduler-backends/absurd-queue-lifecycle.ts",
     "dist/bundling-sources/shared_libs/play-runtime/scheduler-backends/absurd-queue-suffix.ts",
@@ -420,6 +421,7 @@
     "dist/bundling-sources/shared_libs/play-runtime/scheduler-backends/postgres.ts",
     "dist/bundling-sources/shared_libs/play-runtime/scheduler-backends/receipt-completion-coalescer.ts",
     "dist/bundling-sources/shared_libs/play-runtime/scheduler-backends/receipt-gateway.ts",
+    "dist/bundling-sources/shared_libs/play-runtime/scheduler-backends/run-ledger-dispatch-authority.ts",
     "dist/bundling-sources/shared_libs/play-runtime/scheduler-backends/run-ledger-outbox-recovery.ts",
     "dist/bundling-sources/shared_libs/play-runtime/scheduler-backends/run-terminal-transition.ts",
     "dist/bundling-sources/shared_libs/play-runtime/scheduler-backends/runner-push.ts",
@@ -449,6 +451,7 @@
     "dist/bundling-sources/shared_libs/play-runtime/step-progress.ts",
     "dist/bundling-sources/shared_libs/play-runtime/submit-limits.ts",
     "dist/bundling-sources/shared_libs/play-runtime/suspension.ts",
+    "dist/bundling-sources/shared_libs/play-runtime/test-admission-batching.ts",
     "dist/bundling-sources/shared_libs/play-runtime/test-async-batching.ts",
     "dist/bundling-sources/shared_libs/play-runtime/test-runtime-seams.ts",
     "dist/bundling-sources/shared_libs/play-runtime/tool-batch-executor.ts",

package/dist/release.d.mts

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