deepline 0.3.244 → 0.3.246

package/dist/index.js

@@ -1286,7 +1286,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.244",
+  version: "0.3.246",
   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
@@ -1592,6 +1592,7 @@ var COORDINATOR_URL_OVERRIDE_HEADER = "x-deepline-coordinator-url";
 var WORKER_CALLBACK_URL_OVERRIDE_HEADER = "x-deepline-worker-callback-url";
 var RUNTIME_SCHEDULER_SCHEMA_OVERRIDE_HEADER = "x-deepline-runtime-scheduler-schema";
 var RUNTIME_ENVIRONMENT_TOKEN_HEADER = "x-deepline-runtime-environment-token";
+var RETAINED_PIPELINE_RECEIVERS_HEADER = "x-deepline-retained-pipeline-receivers";
 var ABSURD_RELEASE_OVERRIDE_HEADER = "x-deepline-absurd-release";
 var PREFERRED_RECEIPT_GATEWAY_MACHINE_ID_HEADER = "x-deepline-preferred-receipt-gateway-machine-id";
 var SYNTHETIC_RUN_HEADER = "x-deepline-synthetic-run";
@@ -2011,6 +2012,11 @@ var HttpClient = class {
     if (runtimeTestFault?.trim()) {
       headers[PLAY_RUNTIME_TEST_FAULT_HEADER] = runtimeTestFault.trim();
     }
+    const retainedReceivers = typeof process !== "undefined" ? process.env?.DEEPLINE_RUNTIME_RETAINED_PIPELINE_RECEIVERS?.trim() : void 0;
+    if (retainedReceivers && coordinatorInternalToken?.trim()) {
+      headers[RETAINED_PIPELINE_RECEIVERS_HEADER] = retainedReceivers;
+      headers[COORDINATOR_INTERNAL_TOKEN_HEADER] = coordinatorInternalToken.trim();
+    }
     if (absurdReleaseOverride?.trim() && coordinatorInternalToken?.trim()) {
       headers[ABSURD_RELEASE_OVERRIDE_HEADER] = absurdReleaseOverride.trim();
     }
@@ -3220,7 +3226,7 @@ function diffPlayRunStreamEvents(input) {
   return { events, next };
 }
 
-// src/stream-reconnect.ts
+// src/runs/read-errors.ts
 function isTransientPlayRunReadError(error) {
   if (error instanceof DeeplineError && error.code === "PLAY_STREAM_NETWORK_ABORTED") {
     return true;
@@ -3488,7 +3494,6 @@ function parseNotificationGroupTarget(value) {
 function notificationObjectKey(kind) {
   return `${kind}.${globalThis.crypto.randomUUID()}`;
 }
-var TERMINAL_PLAY_STATUSES = /* @__PURE__ */ new Set(["completed", "failed", "cancelled"]);
 var MONITOR_NON_RETRYABLE_MUTATION_OPTIONS = {
   maxRetries: 0,
   exactUrlOnly: true
@@ -3595,7 +3600,11 @@ function runtimeSelectionHeaders(runtime) {
       "RUNTIME_ENVIRONMENT_TOKEN_REQUIRED"
     );
   }
-  return { [RUNTIME_ENVIRONMENT_TOKEN_HEADER]: token };
+  const receivers = process.env.DEEPLINE_RUNTIME_RETAINED_PIPELINE_RECEIVERS?.trim();
+  return {
+    [RUNTIME_ENVIRONMENT_TOKEN_HEADER]: token,
+    ...receivers ? { [RETAINED_PIPELINE_RECEIVERS_HEADER]: receivers } : {}
+  };
 }
 function normalizeTestPolicyOverrides(value, source) {
   if (value && typeof value === "object" && !Array.isArray(value)) {
@@ -3779,7 +3788,7 @@ function normalizePlayRunStart(raw) {
     name: runPackage.run.playName,
     status,
     ...runPackage.run.dashboardUrl ? { dashboardUrl: runPackage.run.dashboardUrl } : {},
-    ...TERMINAL_PLAY_STATUSES.has(status) ? { finalStatus: runPackage } : {},
+    ...isTerminalPlayRunLifecycleStatus(status) ? { finalStatus: runPackage } : {},
     package: runPackage
   };
 }
@@ -3857,11 +3866,12 @@ function readStringArray(value) {
 function getPlayLiveEventPayload(event) {
   return event.payload && typeof event.payload === "object" ? event.payload : {};
 }
-function normalizeLiveStatus(value) {
-  if (value === "queued" || value === "running" || value === "waiting" || value === "completed" || value === "failed" || value === "cancelled") {
-    return value;
+function playLiveRunStatus(event) {
+  if (event.type !== "play.run.snapshot" && event.type !== "play.run.status" && event.type !== "play.run.final_status") {
+    return null;
   }
-  return null;
+  const payload = getPlayLiveEventPayload(event);
+  return decodePlayRunPublicStatus(payload.status) ?? (isPlayRunPackage(payload) ? decodePlayRunPublicStatus(payload.run.status) : null);
 }
 function appendPlayLiveLogLines(state, payload) {
   const lines = readStringArray(payload.lines);
@@ -3894,7 +3904,7 @@ function updatePlayLiveStatusState(state, event) {
     return null;
   }
   const runId = typeof payload.runId === "string" && payload.runId ? payload.runId : isPlayRunPackage(payload) ? payload.run.id : state.runId;
-  const status = normalizeLiveStatus(payload.status) ?? (isPlayRunPackage(payload) ? normalizeLiveStatus(payload.run.status) : null) ?? state.status;
+  const status = playLiveRunStatus(event) ?? state.status;
   const progressPayload = isRecord4(payload.progress) ? payload.progress : {};
   if (event.type === "play.run.final_status" && state.logs.length === 0 && state.lastLogSeq === 0) {
     const payloadLogs = readStringArray(payload.logs);
@@ -5052,13 +5062,6 @@ var DeeplineClient = class _DeeplineClient {
   }
   /** Poll snapshots to terminal status and return the durable package. */
   async watchRunToTerminal(runId, options) {
-    const state = {
-      runId,
-      status: "running",
-      logs: [],
-      lastLogSeq: 0,
-      latest: null
-    };
     let terminalObserved = false;
     for await (const event of this.watchRunEvents(runId, {
       signal: options?.signal,
@@ -5066,19 +5069,17 @@ var DeeplineClient = class _DeeplineClient {
       onRetry: options?.onRetry ?? options?.onReconnect
     })) {
       options?.onEvent?.(event);
-      const status = updatePlayLiveStatusState(state, event);
-      if (status && TERMINAL_PLAY_STATUSES.has(status.status)) {
+      if (isTerminalPlayRunLifecycleStatus(playLiveRunStatus(event))) {
         terminalObserved = true;
       }
     }
     if (options?.signal?.aborted) {
       throw new DeeplineError("Run watch aborted.", void 0, "ABORTED");
     }
-    if (terminalObserved) {
-      return await this.getRunStatus(runId);
-    }
     const refreshed = await this.getRunStatus(runId);
-    if (TERMINAL_PLAY_STATUSES.has(refreshed.status)) return refreshed;
+    if (terminalObserved || isTerminalPlayRunLifecycleStatus(refreshed.status)) {
+      return refreshed;
+    }
     throw new DeeplineError(
       `Run watch for ${runId} ended before a terminal status.`,
       void 0,
@@ -5259,15 +5260,7 @@ var DeeplineClient = class _DeeplineClient {
       `/api/v2/runs/${encodeURIComponent(runId)}${query}`,
       { headers: { "x-deepline-run-status": "1" } }
     );
-    const responseRunStatus = isPlayRunPackage(response) ? response.runStatus : isPlayRunPackage(response.package) ? response.package.runStatus : response.runStatus;
-    const responseOverview = isPlayRunPackage(response) ? response.overview : isPlayRunPackage(response.package) ? response.package.overview : response.overview;
     const status = normalizePlayStatus(response);
-    if (isRecord4(responseRunStatus)) {
-      status.runStatus = responseRunStatus;
-    }
-    if (isRecord4(responseOverview)) {
-      status.overview = responseOverview;
-    }
     if (options?.failedLogs !== true || status.status !== "failed") {
       return status;
     }
@@ -6245,7 +6238,7 @@ var DeeplineClient = class _DeeplineClient {
       if (event.type !== "play.run.status" || status.status !== previousStatus) {
         options?.onProgress?.(status);
       }
-      if (TERMINAL_PLAY_STATUSES.has(status.status)) {
+      if (isTerminalPlayRunLifecycleStatus(status.status)) {
         terminalObserved = status;
       }
     }

package/dist/index.mjs

@@ -1190,7 +1190,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.244",
+  version: "0.3.246",
   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
@@ -1496,6 +1496,7 @@ var COORDINATOR_URL_OVERRIDE_HEADER = "x-deepline-coordinator-url";
 var WORKER_CALLBACK_URL_OVERRIDE_HEADER = "x-deepline-worker-callback-url";
 var RUNTIME_SCHEDULER_SCHEMA_OVERRIDE_HEADER = "x-deepline-runtime-scheduler-schema";
 var RUNTIME_ENVIRONMENT_TOKEN_HEADER = "x-deepline-runtime-environment-token";
+var RETAINED_PIPELINE_RECEIVERS_HEADER = "x-deepline-retained-pipeline-receivers";
 var ABSURD_RELEASE_OVERRIDE_HEADER = "x-deepline-absurd-release";
 var PREFERRED_RECEIPT_GATEWAY_MACHINE_ID_HEADER = "x-deepline-preferred-receipt-gateway-machine-id";
 var SYNTHETIC_RUN_HEADER = "x-deepline-synthetic-run";
@@ -1915,6 +1916,11 @@ var HttpClient = class {
     if (runtimeTestFault?.trim()) {
       headers[PLAY_RUNTIME_TEST_FAULT_HEADER] = runtimeTestFault.trim();
     }
+    const retainedReceivers = typeof process !== "undefined" ? process.env?.DEEPLINE_RUNTIME_RETAINED_PIPELINE_RECEIVERS?.trim() : void 0;
+    if (retainedReceivers && coordinatorInternalToken?.trim()) {
+      headers[RETAINED_PIPELINE_RECEIVERS_HEADER] = retainedReceivers;
+      headers[COORDINATOR_INTERNAL_TOKEN_HEADER] = coordinatorInternalToken.trim();
+    }
     if (absurdReleaseOverride?.trim() && coordinatorInternalToken?.trim()) {
       headers[ABSURD_RELEASE_OVERRIDE_HEADER] = absurdReleaseOverride.trim();
     }
@@ -3124,7 +3130,7 @@ function diffPlayRunStreamEvents(input) {
   return { events, next };
 }
 
-// src/stream-reconnect.ts
+// src/runs/read-errors.ts
 function isTransientPlayRunReadError(error) {
   if (error instanceof DeeplineError && error.code === "PLAY_STREAM_NETWORK_ABORTED") {
     return true;
@@ -3392,7 +3398,6 @@ function parseNotificationGroupTarget(value) {
 function notificationObjectKey(kind) {
   return `${kind}.${globalThis.crypto.randomUUID()}`;
 }
-var TERMINAL_PLAY_STATUSES = /* @__PURE__ */ new Set(["completed", "failed", "cancelled"]);
 var MONITOR_NON_RETRYABLE_MUTATION_OPTIONS = {
   maxRetries: 0,
   exactUrlOnly: true
@@ -3499,7 +3504,11 @@ function runtimeSelectionHeaders(runtime) {
       "RUNTIME_ENVIRONMENT_TOKEN_REQUIRED"
     );
   }
-  return { [RUNTIME_ENVIRONMENT_TOKEN_HEADER]: token };
+  const receivers = process.env.DEEPLINE_RUNTIME_RETAINED_PIPELINE_RECEIVERS?.trim();
+  return {
+    [RUNTIME_ENVIRONMENT_TOKEN_HEADER]: token,
+    ...receivers ? { [RETAINED_PIPELINE_RECEIVERS_HEADER]: receivers } : {}
+  };
 }
 function normalizeTestPolicyOverrides(value, source) {
   if (value && typeof value === "object" && !Array.isArray(value)) {
@@ -3683,7 +3692,7 @@ function normalizePlayRunStart(raw) {
     name: runPackage.run.playName,
     status,
     ...runPackage.run.dashboardUrl ? { dashboardUrl: runPackage.run.dashboardUrl } : {},
-    ...TERMINAL_PLAY_STATUSES.has(status) ? { finalStatus: runPackage } : {},
+    ...isTerminalPlayRunLifecycleStatus(status) ? { finalStatus: runPackage } : {},
     package: runPackage
   };
 }
@@ -3761,11 +3770,12 @@ function readStringArray(value) {
 function getPlayLiveEventPayload(event) {
   return event.payload && typeof event.payload === "object" ? event.payload : {};
 }
-function normalizeLiveStatus(value) {
-  if (value === "queued" || value === "running" || value === "waiting" || value === "completed" || value === "failed" || value === "cancelled") {
-    return value;
+function playLiveRunStatus(event) {
+  if (event.type !== "play.run.snapshot" && event.type !== "play.run.status" && event.type !== "play.run.final_status") {
+    return null;
   }
-  return null;
+  const payload = getPlayLiveEventPayload(event);
+  return decodePlayRunPublicStatus(payload.status) ?? (isPlayRunPackage(payload) ? decodePlayRunPublicStatus(payload.run.status) : null);
 }
 function appendPlayLiveLogLines(state, payload) {
   const lines = readStringArray(payload.lines);
@@ -3798,7 +3808,7 @@ function updatePlayLiveStatusState(state, event) {
     return null;
   }
   const runId = typeof payload.runId === "string" && payload.runId ? payload.runId : isPlayRunPackage(payload) ? payload.run.id : state.runId;
-  const status = normalizeLiveStatus(payload.status) ?? (isPlayRunPackage(payload) ? normalizeLiveStatus(payload.run.status) : null) ?? state.status;
+  const status = playLiveRunStatus(event) ?? state.status;
   const progressPayload = isRecord4(payload.progress) ? payload.progress : {};
   if (event.type === "play.run.final_status" && state.logs.length === 0 && state.lastLogSeq === 0) {
     const payloadLogs = readStringArray(payload.logs);
@@ -4956,13 +4966,6 @@ var DeeplineClient = class _DeeplineClient {
   }
   /** Poll snapshots to terminal status and return the durable package. */
   async watchRunToTerminal(runId, options) {
-    const state = {
-      runId,
-      status: "running",
-      logs: [],
-      lastLogSeq: 0,
-      latest: null
-    };
     let terminalObserved = false;
     for await (const event of this.watchRunEvents(runId, {
       signal: options?.signal,
@@ -4970,19 +4973,17 @@ var DeeplineClient = class _DeeplineClient {
       onRetry: options?.onRetry ?? options?.onReconnect
     })) {
       options?.onEvent?.(event);
-      const status = updatePlayLiveStatusState(state, event);
-      if (status && TERMINAL_PLAY_STATUSES.has(status.status)) {
+      if (isTerminalPlayRunLifecycleStatus(playLiveRunStatus(event))) {
         terminalObserved = true;
       }
     }
     if (options?.signal?.aborted) {
       throw new DeeplineError("Run watch aborted.", void 0, "ABORTED");
     }
-    if (terminalObserved) {
-      return await this.getRunStatus(runId);
-    }
     const refreshed = await this.getRunStatus(runId);
-    if (TERMINAL_PLAY_STATUSES.has(refreshed.status)) return refreshed;
+    if (terminalObserved || isTerminalPlayRunLifecycleStatus(refreshed.status)) {
+      return refreshed;
+    }
     throw new DeeplineError(
       `Run watch for ${runId} ended before a terminal status.`,
       void 0,
@@ -5163,15 +5164,7 @@ var DeeplineClient = class _DeeplineClient {
       `/api/v2/runs/${encodeURIComponent(runId)}${query}`,
       { headers: { "x-deepline-run-status": "1" } }
     );
-    const responseRunStatus = isPlayRunPackage(response) ? response.runStatus : isPlayRunPackage(response.package) ? response.package.runStatus : response.runStatus;
-    const responseOverview = isPlayRunPackage(response) ? response.overview : isPlayRunPackage(response.package) ? response.package.overview : response.overview;
     const status = normalizePlayStatus(response);
-    if (isRecord4(responseRunStatus)) {
-      status.runStatus = responseRunStatus;
-    }
-    if (isRecord4(responseOverview)) {
-      status.overview = responseOverview;
-    }
     if (options?.failedLogs !== true || status.status !== "failed") {
       return status;
     }
@@ -6149,7 +6142,7 @@ var DeeplineClient = class _DeeplineClient {
       if (event.type !== "play.run.status" || status.status !== previousStatus) {
         options?.onProgress?.(status);
       }
-      if (TERMINAL_PLAY_STATUSES.has(status.status)) {
+      if (isTerminalPlayRunLifecycleStatus(status.status)) {
         terminalObserved = status;
       }
     }

package/dist/install-integrity.json

@@ -21,9 +21,9 @@
     "dist/bundling-sources/sdk/src/plays/local-file-discovery.ts",
     "dist/bundling-sources/sdk/src/release.ts",
     "dist/bundling-sources/sdk/src/runs/observe-transport.ts",
+    "dist/bundling-sources/sdk/src/runs/read-errors.ts",
     "dist/bundling-sources/sdk/src/runs/watch-polling.ts",
     "dist/bundling-sources/sdk/src/skills-version.ts",
-    "dist/bundling-sources/sdk/src/stream-reconnect.ts",
     "dist/bundling-sources/sdk/src/tool-calls.ts",
     "dist/bundling-sources/sdk/src/tool-output.ts",
     "dist/bundling-sources/sdk/src/types.ts",

package/dist/release.d.mts

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

package/dist/bundling-sources/sdk/src/stream-reconnect.ts

@@ -1,47 +0,0 @@
-import { DeeplineError } from './errors.js';
-
-/**
- * Retry policy for the legacy run SSE compatibility method. Ordinary run
- * watching uses a fixed REST snapshot cadence and shares only the transient
- * read-error classification below.
- */
-
-/** Base delay for the full-jitter exponential backoff between reconnects. */
-export const STREAM_RECONNECT_BASE_DELAY_MS = 500;
-/** Upper bound for a single reconnect delay. */
-export const STREAM_RECONNECT_MAX_DELAY_MS = 15_000;
-/**
- * A connection that stayed open at least this long (or delivered any event)
- * counts as healthy and resets the backoff sequence.
- */
-export const STREAM_HEALTHY_CONNECTION_MS = 30_000;
-
-/** Full-jitter exponential backoff: uniform in [1, min(cap, base * 2^attempt)]. */
-export function streamReconnectDelayMs(attempt: number): number {
-  const cappedExponentialMs = Math.min(
-    STREAM_RECONNECT_MAX_DELAY_MS,
-    STREAM_RECONNECT_BASE_DELAY_MS * 2 ** Math.max(0, attempt),
-  );
-  return Math.max(1, Math.floor(Math.random() * (cappedExponentialMs + 1)));
-}
-
-export function isTransientPlayRunReadError(error: unknown): boolean {
-  if (
-    error instanceof DeeplineError &&
-    error.code === 'PLAY_STREAM_NETWORK_ABORTED'
-  ) {
-    return true;
-  }
-  if (error instanceof DeeplineError && typeof error.statusCode === 'number') {
-    // 5xx responses and network-level failures may recover. Client errors,
-    // especially 404, stay visible instead of disappearing into a retry loop.
-    return error.statusCode >= 500 && error.statusCode < 600;
-  }
-  const text = error instanceof Error ? error.message : String(error);
-  return /auth validation backend timed out|coordinator \/submit(?:\?[^ ]*)? 5\d\d|Worker threw exception|Internal Server Error|Service Unavailable|fetch failed|eaddrnotavail|econnreset|etimedout|eai_again|socket hang up/i.test(
-    text,
-  );
-}
-
-/** @deprecated Use `isTransientPlayRunReadError`. */
-export const isTransientPlayStreamError = isTransientPlayRunReadError;