deepline 0.3.119 → 0.3.121

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.119',
+  version: '0.3.121',
   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/observability/telemetry.ts

@@ -31,6 +31,9 @@ export type TelemetryContext = {
   workflowOrigin?: string | null;
   playName?: string | null;
   machineId?: string | null;
+  gatewayRole?: string | null;
+  /** Stable identity for one in-process gateway handler lifecycle. */
+  gatewayLifecycleId?: string | null;
 };
 
 export type TelemetryLevel = 'debug' | 'info' | 'warn' | 'error';
@@ -182,6 +185,8 @@ const RESERVED_FIELDS = new Set([
   'workflowOrigin',
   'playName',
   'machineId',
+  'gatewayRole',
+  'gatewayLifecycleId',
 ]);
 
 function errorTriage(fields: TelemetryFields | undefined): TelemetryTriage {

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

@@ -110,6 +110,7 @@ import {
   type ToolResponseView,
 } from '../plays/tool-response-contract';
 import {
+  AllAdmittedRowsFailedError,
   isProviderExhaustedFailure,
   ProviderExhaustedError,
 } from './run-failure';
@@ -1529,10 +1530,13 @@ type FieldMapRunResult = {
   failedRows: PersistableMapRow[];
   completedRowCount: number;
   failedRowCount: number;
+  failureSamples: Array<{ rowLabel: string; error: string }>;
   previewRows: Record<string, unknown>[];
   retainedRowsComplete: boolean;
 };
 
+const MAP_FAILURE_SAMPLE_LIMIT = 3;
+
 type RuntimeMapRowPersistence = {
   persistRows: (rows: PersistableMapRow[]) => {
     admitted: Promise<void>;
@@ -6804,6 +6808,8 @@ export class PlayContextImpl implements ScalarPlayAuthoringRuntimeContext {
       let failedCount = 0;
       let duplicateReuseCount = 0;
       let executedCount = 0;
+      const failureSamples: Array<{ rowLabel: string; error: string }> = [];
+      const failureSampleErrors = new Set<string>();
       const previewRows: Record<string, unknown>[] = [];
       // A bounded dataset may be materialized by authored code immediately
       // after run(). Keep the rows produced by this exact awaited execution so
@@ -7179,6 +7185,16 @@ export class PlayContextImpl implements ScalarPlayAuthoringRuntimeContext {
         executedCount += rowsToExecute.length;
         successfulCount += mapResult.completedRowCount;
         failedCount += mapResult.failedRowCount;
+        for (const sample of mapResult.failureSamples) {
+          if (
+            failureSamples.length >= MAP_FAILURE_SAMPLE_LIMIT ||
+            failureSampleErrors.has(sample.error)
+          ) {
+            continue;
+          }
+          failureSampleErrors.add(sample.error);
+          failureSamples.push(sample);
+        }
         processedCount += rowsToExecute.length;
         page.rows.length = 0;
       }
@@ -7216,10 +7232,12 @@ export class PlayContextImpl implements ScalarPlayAuthoringRuntimeContext {
           totalRows: totalInputCount,
           at: Date.now(),
         });
-        throw new Error(
-          `ctx.dataset("${normalizedMapNamespace}") failed for every admitted row (${failedCount}/${totalInputCount}). ` +
-            'Failed rows were persisted and will be retried on the next run.',
-        );
+        throw new AllAdmittedRowsFailedError({
+          mapName: normalizedMapNamespace,
+          failedCount,
+          totalInputCount,
+          samples: failureSamples,
+        });
       }
 
       this.setMapFrame({
@@ -8105,6 +8123,8 @@ export class PlayContextImpl implements ScalarPlayAuthoringRuntimeContext {
     const failFastOnRowError = runtimeOptions?.onRowError === 'fail';
     const completedRowsToPersist: PersistableMapRow[] = [];
     const failedRowsToPersist: PersistableMapRow[] = [];
+    const failureSamples: Array<{ rowLabel: string; error: string }> = [];
+    const failureSampleErrors = new Set<string>();
     const previewRows: Record<string, unknown>[] = [];
     let completedRowCount = 0;
     let failedRowCount = 0;
@@ -8368,6 +8388,7 @@ export class PlayContextImpl implements ScalarPlayAuthoringRuntimeContext {
         failedRows: [],
         completedRowCount: results.length,
         failedRowCount: 0,
+        failureSamples: [],
         previewRows: results.slice(0, 5),
         retainedRowsComplete: true,
       };
@@ -8573,6 +8594,16 @@ export class PlayContextImpl implements ScalarPlayAuthoringRuntimeContext {
               error: formattedError,
             });
             failedRowCount += 1;
+            if (
+              failureSamples.length < MAP_FAILURE_SAMPLE_LIMIT &&
+              !failureSampleErrors.has(formattedError)
+            ) {
+              failureSampleErrors.add(formattedError);
+              failureSamples.push({
+                rowLabel: failedMapRowLogLabel(failedRow),
+                error: formattedError,
+              });
+            }
             retainPersistedRow(failedRow, failedRowsToPersist);
             this.emitScopedRowUpdate(rowKey, normalizedTableNamespace, {
               rowId: idx,
@@ -8985,6 +9016,7 @@ export class PlayContextImpl implements ScalarPlayAuthoringRuntimeContext {
       failedRows: failedRowsToPersist,
       completedRowCount,
       failedRowCount,
+      failureSamples,
       previewRows,
       retainedRowsComplete,
     };

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

@@ -23,12 +23,23 @@ export const PLAY_RUN_PRE_RUN_VALIDATION_FAILED =
   'PLAY_RUN_PRE_RUN_VALIDATION_FAILED' as const;
 export const RUNTIME_DB_SESSION_PRELOAD_INCOMPLETE =
   'RUNTIME_DB_SESSION_PRELOAD_INCOMPLETE' as const;
+/**
+ * A disabled-source replay cannot create a new Runtime Run. If the original
+ * Run is absent, retrying the same existing-only admission can never make
+ * progress and only keeps the receipt on the 503 retry path.
+ */
+export const PLAY_RUN_ADMISSION_REPLAY_MISSING =
+  'PLAY_RUN_ADMISSION_REPLAY_MISSING' as const;
+/** A reused Run identity with different launch facts is permanently invalid. */
+export const PLAY_RUN_LAUNCH_CONFLICT = 'PLAY_RUN_LAUNCH_CONFLICT' as const;
 
 export type PlayAdmissionBlockedCode =
   | typeof PLAY_ADMISSION_PAYLOAD_UNREADABLE
   | typeof PLAY_SECRET_UNAVAILABLE
   | typeof PLAY_RUN_PRE_RUN_VALIDATION_FAILED
-  | typeof RUNTIME_DB_SESSION_PRELOAD_INCOMPLETE;
+  | typeof RUNTIME_DB_SESSION_PRELOAD_INCOMPLETE
+  | typeof PLAY_RUN_ADMISSION_REPLAY_MISSING
+  | typeof PLAY_RUN_LAUNCH_CONFLICT;
 
 export type PlayAdmissionRetryableCode = typeof PLAY_ADMISSION_INTERNAL_FAILURE;
 
@@ -49,6 +60,8 @@ export type PlayAdmissionFailure =
 const TERMINAL_PRE_ADMISSION_CODES = new Set<PlayAdmissionBlockedCode>([
   PLAY_RUN_PRE_RUN_VALIDATION_FAILED,
   RUNTIME_DB_SESSION_PRELOAD_INCOMPLETE,
+  PLAY_RUN_ADMISSION_REPLAY_MISSING,
+  PLAY_RUN_LAUNCH_CONFLICT,
 ]);
 
 function stableErrorCode(error: unknown): string | null {

package/dist/bundling-sources/shared_libs/play-runtime/run-failure.ts

@@ -58,6 +58,93 @@ export const MODAL_PAYLOAD_UPLOAD_TIMEOUT_MESSAGE =
 
 export const WORKSPACE_STORAGE_NOT_READY_CODE = 'WORKSPACE_STORAGE_NOT_READY';
 
+export const ALL_ADMITTED_ROWS_FAILED_CODE = 'ALL_ADMITTED_ROWS_FAILED';
+
+export type AllAdmittedRowsFailedSample = {
+  rowLabel: string;
+  error: string;
+};
+
+const ALL_ADMITTED_ROWS_FAILED_SAMPLE_LIMIT = 3;
+const ALL_ADMITTED_ROWS_FAILED_SAMPLE_TEXT_LIMIT = 500;
+
+function boundedAllAdmittedRowsFailedSample(value: string): string {
+  const normalized = value.trim();
+  if (normalized.length <= ALL_ADMITTED_ROWS_FAILED_SAMPLE_TEXT_LIMIT) {
+    return normalized;
+  }
+  return `${normalized.slice(0, ALL_ADMITTED_ROWS_FAILED_SAMPLE_TEXT_LIMIT - 1)}…`;
+}
+
+function allAdmittedRowsFailedMessage(input: {
+  mapName: string;
+  failedCount: number;
+  totalInputCount: number;
+  samples: readonly AllAdmittedRowsFailedSample[];
+}): string {
+  const representativeFailures = input.samples
+    .slice(0, ALL_ADMITTED_ROWS_FAILED_SAMPLE_LIMIT)
+    .map(
+      (sample) =>
+        `${boundedAllAdmittedRowsFailedSample(sample.rowLabel)}: ${boundedAllAdmittedRowsFailedSample(sample.error)}`,
+    )
+    .join('; ');
+  const omittedCount = Math.max(
+    0,
+    input.failedCount -
+      Math.min(input.samples.length, ALL_ADMITTED_ROWS_FAILED_SAMPLE_LIMIT),
+  );
+  const omittedSuffix =
+    omittedCount > 0 ? `; ${omittedCount} additional failure(s) omitted` : '';
+  return (
+    `ctx.dataset("${input.mapName}") produced no successful rows ` +
+    `(${input.failedCount}/${input.totalInputCount} admitted rows failed). ` +
+    (representativeFailures
+      ? `Representative failures: ${representativeFailures}${omittedSuffix}. `
+      : '') +
+    'Failed rows were persisted for review and may be retried on a later run.'
+  );
+}
+
+export class AllAdmittedRowsFailedError extends Error {
+  readonly code = ALL_ADMITTED_ROWS_FAILED_CODE;
+
+  constructor(input: {
+    mapName: string;
+    failedCount: number;
+    totalInputCount: number;
+    samples?: readonly AllAdmittedRowsFailedSample[];
+  }) {
+    super(
+      `${ALL_ADMITTED_ROWS_FAILED_CODE}: ${allAdmittedRowsFailedMessage({
+        ...input,
+        samples: input.samples ?? [],
+      })}`,
+    );
+    this.name = 'AllAdmittedRowsFailedError';
+  }
+}
+
+export function isAllAdmittedRowsFailedFailure(error: unknown): boolean {
+  if (error instanceof AllAdmittedRowsFailedError) return true;
+  const code =
+    error && typeof error === 'object'
+      ? (error as { code?: unknown }).code
+      : null;
+  const message = error instanceof Error ? error.message : String(error ?? '');
+  return (
+    code === ALL_ADMITTED_ROWS_FAILED_CODE ||
+    new RegExp(`^${ALL_ADMITTED_ROWS_FAILED_CODE}:\\s*`).test(message)
+  );
+}
+
+function allAdmittedRowsFailedPublicMessage(cause: string): string {
+  return cause.replace(
+    new RegExp(`^${ALL_ADMITTED_ROWS_FAILED_CODE}:\\s*`),
+    '',
+  );
+}
+
 // User-facing message. Contains NO SQL, role names, database names, or hosts by
 // construction, so it is safe past redactRuntimeInternalError (which only strips
 // postgres-URI passwords). The raw pg error goes in the Error `cause` for server
@@ -323,6 +410,15 @@ function toErrorText(error: unknown): string {
 export function normalizePlayRunFailure(error: unknown): PlayRunFailureDetails {
   const rawCause = toErrorText(error);
   const cause = boundedFailureText(rawCause);
+  if (isAllAdmittedRowsFailedFailure(error)) {
+    return {
+      code: ALL_ADMITTED_ROWS_FAILED_CODE,
+      phase: 'runtime',
+      message: allAdmittedRowsFailedPublicMessage(cause),
+      retryable: false,
+      cause,
+    };
+  }
   if (
     error instanceof ToolExecutionError &&
     error.origin === 'deepline' &&

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

@@ -2043,6 +2043,16 @@ async function prepareAbsurdAttempt(input: {
             exists: projection.exists,
             blocked: projection.blocked,
           });
+          console.info('[runtime.scheduler.projection_deferred]', {
+            runId: input.runId,
+            eventId,
+            phase: 'run_created_projection_gate',
+            status: 'deferred',
+            exists: projection.exists,
+            blocked: projection.blocked,
+            delaySeconds: projection.blocked ? 5 : 1,
+            attemptAllocated: false,
+          });
           throw new DeferTask(
             `Run-created projection is not yet delivered for ${input.runId}.`,
             projection.blocked ? 5 : 1,

package/dist/bundling-sources/shared_libs/play-runtime/webhook-receipt-retry.ts

@@ -1,11 +1,15 @@
 import { createHash } from 'node:crypto';
 import {
   classifyPlayAdmissionFailure,
+  PLAY_RUN_ADMISSION_REPLAY_MISSING,
+  PLAY_RUN_LAUNCH_CONFLICT,
   PLAY_RUN_PRE_RUN_VALIDATION_FAILED,
   RUNTIME_DB_SESSION_PRELOAD_INCOMPLETE,
 } from './/play-admission-outcome';
 
 export {
+  PLAY_RUN_ADMISSION_REPLAY_MISSING,
+  PLAY_RUN_LAUNCH_CONFLICT,
   PLAY_RUN_PRE_RUN_VALIDATION_FAILED,
   RUNTIME_DB_SESSION_PRELOAD_INCOMPLETE,
 };

package/dist/cli/index.js

@@ -3068,7 +3068,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.119",
+  version: "0.3.121",
   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

@@ -3063,7 +3063,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.119",
+  version: "0.3.121",
   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

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