deepline 0.3.222 → 0.3.224

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.222',
+  version: '0.3.224',
   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/context.ts

@@ -1721,6 +1721,14 @@ function toolAttemptOutcomeForResult(
   return record.status === 'no_result' ? 'no_result' : 'completed';
 }
 
+function isControlledPlaySuspension(error: unknown): boolean {
+  return (
+    isPlayExecutionSuspendedError(error) ||
+    isPlayRowExecutionSuspendedError(error) ||
+    error instanceof PlayRowProviderBackpressureError
+  );
+}
+
 /**
  * Explicit execution location for a queued row-scoped tool call (ADR 0018).
  * `toolIdOverride` lets a native batch report the batch operation it actually
@@ -3614,6 +3622,9 @@ export class PlayContextImpl implements ScalarPlayAuthoringRuntimeContext {
       });
     };
     const fail = (error: unknown): void => {
+      // Durable waits unwind the authored node so the scheduler can resume it.
+      // Keep its started observation; the resumed invocation will settle it.
+      if (isControlledPlaySuspension(error)) return;
       const errorPreview = buildPlayDocflowNodeErrorPreview(
         error,
         this.secretRedactor,
@@ -13476,7 +13487,13 @@ export class PlayContextImpl implements ScalarPlayAuthoringRuntimeContext {
           }
           return this.materializeToolExecutionResult(wrapped);
         } catch (error) {
-          settleDirectCall('failed', error);
+          if (isControlledPlaySuspension(error)) {
+            // A durable pause is not a terminal tool failure. Leave the start
+            // event open so the resumed attempt can settle the same node.
+            directSettled = true;
+          } else {
+            settleDirectCall('failed', error);
+          }
           throw error;
         } finally {
           settleDirectCall('failed');
@@ -13541,8 +13558,14 @@ export class PlayContextImpl implements ScalarPlayAuthoringRuntimeContext {
       };
       const settleProducerAttempt = (
         outcome: PlayCellProducerAttempt['outcome'],
+        waiting = false,
       ) => {
         producerAttempt.outcome = outcome;
+        if (waiting) {
+          producerAttempt.waiting = true;
+        } else {
+          delete producerAttempt.waiting;
+        }
         producerAttempt.durationMs = Date.now() - producerAttemptStartedAt;
       };
       // Everything the resolver did since its previous result landed — user
@@ -13666,7 +13689,8 @@ export class PlayContextImpl implements ScalarPlayAuthoringRuntimeContext {
           observeLogicalCallWall();
           observeResultDelivery();
           this.openRowResolverGap(resolverGap);
-          settleProducerAttempt('failed');
+          const waiting = isControlledPlaySuspension(error);
+          settleProducerAttempt(waiting ? 'running' : 'failed', waiting);
           throw error;
         },
       );

package/dist/bundling-sources/shared_libs/play-runtime/ctx-types.ts

@@ -398,7 +398,10 @@ export type RuntimeDatasetRunOptions<TItem = Record<string, unknown>> = Pick<
   'description' | 'key' | 'onRowError' | 'mode' | 'undrawnColumns'
 >;
 
-export type ToolCallOptions = PlayToolCallOptions;
+/** Runtime-only receipt recovery bit; never part of the customer authoring API. */
+export type ToolCallOptions = PlayToolCallOptions & {
+  forceFailedRefresh?: boolean;
+};
 export type ToolExecutionRequest = PlayToolExecutionRequest;
 
 export type PlayCallOptions = Omit<
@@ -1491,6 +1494,8 @@ export interface PlayCellProducerAttempt {
   /** Attempt start, epoch ms. */
   at: number;
   outcome: 'running' | 'completed' | 'no_result' | 'failed' | 'cached';
+  /** True when the in-flight call yielded to a durable runtime wait. */
+  waiting?: boolean;
   durationMs?: number | null;
 }
 

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

@@ -1,4 +1,5 @@
 import type { PlayRunLedgerIngressEvent } from './run-ledger';
+import type { RunLedgerProjectionChunk } from './run-ledger-projection-contract';
 
 const APP_RUNTIME_LOG_EVENT_MAX_JSON_BYTES = 128 * 1024;
 const APP_RUNTIME_EVENT_BATCH_MAX_JSON_BYTES = 512 * 1024;
@@ -108,3 +109,26 @@ export function partitionRunEventsForAppRuntime(
   if (current.length > 0) batches.push(current);
   return batches;
 }
+
+/**
+ * Select a projection chunk from the raw canonical prefix. Callers must apply
+ * route sanitization only after this boundary is selected, because sanitizing
+ * event payloads can change their encoded sizes and shift transport chunks.
+ */
+export function selectRunEventsForAppRuntimeProjectionChunk(
+  events: readonly PlayRunLedgerIngressEvent[],
+  chunk: RunLedgerProjectionChunk,
+): PlayRunLedgerIngressEvent[] | undefined {
+  if (
+    !Number.isSafeInteger(chunk.index) ||
+    !Number.isSafeInteger(chunk.count) ||
+    chunk.index < 0 ||
+    chunk.count < 2 ||
+    chunk.index >= chunk.count
+  ) {
+    return undefined;
+  }
+
+  const batches = partitionRunEventsForAppRuntime(events);
+  return batches.length === chunk.count ? batches[chunk.index] : undefined;
+}

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

@@ -101,7 +101,7 @@ import {
   buildRunLedgerStartIdempotencyKey,
   buildRunLedgerTerminalIdempotencyKey,
 } from '../run-ledger-projection-contract';
-import { partitionRunEventsForAppRuntime } from '../run-ledger-event-transport';
+import { selectRunEventsForAppRuntimeProjectionChunk } from '../run-ledger-event-transport';
 import {
   assertTerminalRunResultWithinLimit,
   isLedgerTerminalResultRef,
@@ -16030,7 +16030,7 @@ export async function assertPostgresRunLedgerDelivery(
     leaseOwner?: string;
     projectedEvents?: readonly AcceptedPlayRunLedgerEvent[];
     projectionChunk?: RunLedgerProjectionChunk;
-    normalizeProjectedEvents?: (
+    sanitizeExpectedProjectionEvents?: (
       events: readonly PlayRunLedgerIngressEvent[],
     ) => readonly AcceptedPlayRunLedgerEvent[];
   },
@@ -16163,24 +16163,25 @@ export async function assertPostgresRunLedgerDelivery(
           }),
         );
       }
-      const comparablePrefixEvents: readonly (
-        | AcceptedPlayRunLedgerEvent
-        | PlayRunLedgerIngressEvent
-      )[] = input.normalizeProjectedEvents
-        ? input.normalizeProjectedEvents(prefixEvents)
-        : prefixEvents;
       let expectedProjectionEvents:
         | readonly (AcceptedPlayRunLedgerEvent | PlayRunLedgerIngressEvent)[]
-        | undefined = comparablePrefixEvents;
+        | undefined;
       if (input.projectionChunk) {
         const chunk = input.projectionChunk;
-        const chunks = isRunLedgerProjectionChunk(chunk)
-          ? partitionRunEventsForAppRuntime(
-              comparablePrefixEvents as readonly PlayRunLedgerIngressEvent[],
-            )
-          : [];
+        // The sender partitions ingress events before the route sanitizes each chunk.
+        const expectedTransportChunk = isRunLedgerProjectionChunk(chunk)
+          ? selectRunEventsForAppRuntimeProjectionChunk(prefixEvents, chunk)
+          : undefined;
         expectedProjectionEvents =
-          chunks.length === chunk.count ? chunks[chunk.index] : undefined;
+          expectedTransportChunk === undefined
+            ? undefined
+            : input.sanitizeExpectedProjectionEvents
+              ? input.sanitizeExpectedProjectionEvents(expectedTransportChunk)
+              : expectedTransportChunk;
+      } else {
+        expectedProjectionEvents = input.sanitizeExpectedProjectionEvents
+          ? input.sanitizeExpectedProjectionEvents(prefixEvents)
+          : prefixEvents;
       }
       if (
         expectedProjectionEvents !== undefined &&

package/dist/bundling-sources/shared_libs/product-notifications/slack-delivery.ts

@@ -25,7 +25,8 @@ export type SlackChannelKey =
   | 'python_cli_session'
   | 'monitor_activity'
   | 'monitor_error_activity'
-  | 'plain_thread_activity';
+  | 'plain_thread_activity'
+  | 'inbound_leads';
 
 export type SlackPayloadEnricher = (
   payload: SlackPayload,
@@ -57,6 +58,10 @@ const CHANNEL_WEBHOOK_ENV: Partial<Record<SlackChannelKey, string>> = {
   monitor_activity: 'SLACK_MONITOR_ACTIVITY_WEBHOOK_URL',
   monitor_error_activity: 'SLACK_MONITOR_ERROR_ACTIVITY_WEBHOOK_URL',
   plain_thread_activity: 'SLACK_PLAIN_THREAD_ACTIVITY_WEBHOOK_URL',
+  // Inbound demo requests are delivered by the shared reporting bot (see
+  // resolveBotChannel). This webhook is only a fallback for a deployment that
+  // has no bot token.
+  inbound_leads: 'SLACK_INBOUND_LEADS_WEBHOOK_URL',
 };
 
 const CHANNEL_WEBHOOK_FALLBACK_ENVS: Partial<
@@ -70,6 +75,9 @@ const SLACK_DEEPLINE_REPORTING_BOT_TOKEN_ENV =
 const SLACK_PROVIDER_ALERTS_CHANNEL_ID_ENV = 'SLACK_PROVIDER_ALERTS_CHANNEL_ID';
 const SLACK_ERROR_ACTIVITY_CHANNEL_ID_ENV = 'SLACK_ERROR_ACTIVITY_CHANNEL_ID';
 const SLACK_USER_SIGNUP_CHANNEL_ID_ENV = 'SLACK_USER_SIGNUP_CHANNEL_ID';
+const SLACK_INBOUND_LEADS_CHANNEL_ID_ENV = 'SLACK_INBOUND_LEADS_CHANNEL_ID';
+// #alerts-gtm. Inbound demo requests go where GTM already watches for leads.
+const DEFAULT_INBOUND_LEADS_CHANNEL_ID = 'C07KT4HB24U';
 const SLACK_MONITOR_ACTIVITY_CHANNEL_ID_ENV =
   'SLACK_MONITOR_ACTIVITY_CHANNEL_ID';
 const SLACK_MONITOR_ERROR_ACTIVITY_CHANNEL_ID_ENV =
@@ -117,6 +125,7 @@ const CHANNEL_ALERT_LEVEL: Record<
   monitor_activity: 'info',
   monitor_error_activity: 'error',
   plain_thread_activity: 'info',
+  inbound_leads: 'info',
 };
 
 function normalizeText(value: unknown): string {
@@ -135,6 +144,8 @@ function getSlackChannelEnvironmentRequirement(
     case 'user_signup':
     case 'sdk_cli_activity':
     case 'sdk_cli_errors':
+    // Preview and local deploys must never page GTM with test submissions.
+    case 'inbound_leads':
       return 'prod';
     case 'session_activity':
     case 'error_activity':
@@ -242,6 +253,13 @@ function resolveBotChannel(
           process.env[SLACK_MONITOR_ERROR_ACTIVITY_CHANNEL_ID_ENV]?.trim() ||
           DEFAULT_MONITOR_ERROR_ACTIVITY_CHANNEL_ID,
       };
+    case 'inbound_leads':
+      return {
+        token,
+        channelId:
+          process.env[SLACK_INBOUND_LEADS_CHANNEL_ID_ENV]?.trim() ||
+          DEFAULT_INBOUND_LEADS_CHANNEL_ID,
+      };
     case 'sdk_cli_activity':
       return { token, channelId: SDK_CLI_ACTIVITY_SLACK_CHANNEL_ID };
     case 'sdk_cli_errors':

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