deepline 0.3.245 → 0.3.246

package/dist/cli/index.mjs

@@ -3468,7 +3468,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.245",
+  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
@@ -3811,6 +3811,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";
@@ -4230,6 +4231,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();
     }
@@ -5584,7 +5590,7 @@ function diffPlayRunStreamEvents(input2) {
   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;
@@ -5852,7 +5858,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
@@ -5959,7 +5964,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)) {
@@ -6122,7 +6131,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
   };
 }
@@ -6200,11 +6209,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);
@@ -6237,7 +6247,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);
@@ -7395,13 +7405,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,
@@ -7409,19 +7412,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,
@@ -7602,15 +7603,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;
     }
@@ -8588,7 +8581,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;
       }
     }
@@ -23492,7 +23485,7 @@ function pendingStartFailureStatus(input2) {
     }
   };
 }
-var TERMINAL_PLAY_STATUSES2 = /* @__PURE__ */ new Set([
+var TERMINAL_PLAY_STATUSES = /* @__PURE__ */ new Set([
   "completed",
   "failed",
   "cancelled"
@@ -23992,18 +23985,12 @@ function openPlayDashboard(dashboardUrl, open2) {
   }
 }
 function printPlayLogLines(input2) {
+  if (!input2.emitLogs) return;
   for (const line of input2.lines) {
-    if (input2.emitLogs) {
-      const formatted = formatPlayLogLine(
-        line,
-        input2.status ?? void 0,
-        input2.state
-      );
-      if (formatted) {
-        input2.progress.writeLogLine(formatted);
-      }
+    const formatted = formatPlayLogLine(line, input2.state);
+    if (formatted) {
+      input2.progress.writeLogLine(formatted);
     }
-    input2.state.lastLogIndex += 1;
   }
 }
 function assertPlayWaitNotTimedOut(input2) {
@@ -24064,7 +24051,7 @@ async function waitForPlayCompletionByWatch(input2) {
     if (refreshed.runId === input2.workflowId && statusProvesPlayRunExecution(refreshed.status)) {
       await confirmAdmission();
     }
-    return TERMINAL_PLAY_STATUSES2.has(refreshed.status) ? withDashboardUrl(refreshed) : null;
+    return TERMINAL_PLAY_STATUSES.has(refreshed.status) ? withDashboardUrl(refreshed) : null;
   };
   const handleLiveEvent = async (event) => {
     assertPlayWaitNotTimedOut({ ...input2, lastPhase });
@@ -24091,8 +24078,6 @@ async function waitForPlayCompletionByWatch(input2) {
     });
     printPlayLogLines({
       lines: getLogLinesFromLiveEvent(event),
-      status: null,
-      jsonOutput: input2.jsonOutput,
       emitLogs: input2.emitLogs,
       state: input2.state,
       progress: input2.progress
@@ -24125,7 +24110,7 @@ async function waitForPlayCompletionByWatch(input2) {
       return withDashboardUrl(finalStatus);
     }
     const status = getStatusFromLiveEvent(event);
-    if (status && TERMINAL_PLAY_STATUSES2.has(status)) {
+    if (status && TERMINAL_PLAY_STATUSES.has(status)) {
       terminalStatusRead ??= fetchTerminalStatus();
       return await terminalStatusRead;
     }
@@ -24209,7 +24194,6 @@ async function startAndWaitForPlayCompletionByStreamOnce(input2) {
     input2.playName
   );
   const state = {
-    lastLogIndex: 0,
     emittedRunnerStarted: false,
     verbose: input2.verboseLogs === true,
     logLevel: input2.logLevel ?? "info",
@@ -24256,7 +24240,7 @@ async function startAndWaitForPlayCompletionByStreamOnce(input2) {
     if (refreshed.runId === lastKnownWorkflowId && statusProvesPlayRunExecution(refreshed.status)) {
       await confirmAdmission(lastKnownWorkflowId);
     }
-    return TERMINAL_PLAY_STATUSES2.has(refreshed.status) ? {
+    return TERMINAL_PLAY_STATUSES.has(refreshed.status) ? {
       ...refreshed,
       dashboardUrl,
       ...launchedRevisionId ? { revisionId: launchedRevisionId } : {}
@@ -24320,8 +24304,6 @@ async function startAndWaitForPlayCompletionByStreamOnce(input2) {
       });
       printPlayLogLines({
         lines: getLogLinesFromLiveEvent(event),
-        status: null,
-        jsonOutput: input2.jsonOutput,
         emitLogs: input2.emitLogs,
         state,
         progress: input2.progress
@@ -24592,7 +24574,7 @@ var BULKY_RETURN_KEYS = /* @__PURE__ */ new Set([
   "sequenceTrace",
   "logs"
 ]);
-function formatPlayLogLine(rawLine, status, state) {
+function formatPlayLogLine(rawLine, state) {
   const classified = classifyLogLine(rawLine);
   const line = classified.line;
   const timestampMatch = line.match(/^\[([^\]]+)\]\s*(.*)$/);
@@ -24624,12 +24606,6 @@ function formatPlayLogLine(rawLine, status, state) {
     state.emittedRunnerStarted = true;
     return `${prefix}runner started`;
   }
-  const stages = (status?.contract?.staticPipeline?.stages ?? []).filter((stage) => stage.tableNamespace);
-  const sourceLabelForNamespace = (namespace) => {
-    const stage = stages.find((entry) => entry.tableNamespace === namespace);
-    const range = stage?.sourceRange;
-    return range?.startLine && range?.endLine ? `${namespace} lines ${range.startLine}-${range.endLine}` : namespace;
-  };
   const mapStart = message.match(
     /^Starting map over (\d+) items with (\d+) fields \(key: ([^;]+); (\d+) already satisfied; (\d+) pending\)$/
   );
@@ -24638,7 +24614,7 @@ function formatPlayLogLine(rawLine, status, state) {
       return null;
     }
     const [, rows, fields2, namespace, cached, pending] = mapStart;
-    return `${prefix}map ${sourceLabelForNamespace(namespace)}: ${formatInteger(Number(rows))} rows, ${fields2} fields, ${formatInteger(Number(cached))} cached, ${formatInteger(Number(pending))} pending`;
+    return `${prefix}map ${namespace}: ${formatInteger(Number(rows))} rows, ${fields2} fields, ${formatInteger(Number(cached))} cached, ${formatInteger(Number(pending))} pending`;
   }
   const mapDone = message.match(
     /^Map completed: (\d+) results \((\d+) executed, (\d+) already satisfied\)$/
@@ -28716,7 +28692,6 @@ async function handleRunTail(args) {
   const compact = args.includes("--compact");
   const showLiveLogs = debug || hasExplicitLogLevel || !jsonOutput && !compact;
   const compactState = {
-    lastLogIndex: 0,
     emittedRunnerStarted: false,
     lastProgressSignature: null,
     lastProgressHeartbeatAt: 0,
@@ -28737,14 +28712,9 @@ async function handleRunTail(args) {
     } : compact || showLiveLogs ? (event) => {
       if (showLiveLogs) {
         for (const line of getLogLinesFromLiveEvent(event)) {
-          const formatted = formatPlayLogLine(
-            line,
-            void 0,
-            compactState
-          );
+          const formatted = formatPlayLogLine(line, compactState);
           if (formatted) process.stderr.write(`${formatted}
 `);
-          compactState.lastLogIndex += 1;
         }
       }
       if (!compact || jsonOutput) return;

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