deepline 0.1.298 → 0.1.299

package/dist/bundling-sources/sdk/src/client.ts

@@ -93,6 +93,7 @@ import {
   normalizePlayRuntimeSelection,
   type PlayRuntimeSelection,
 } from '../../shared_libs/play-runtime/runtime-environment.js';
+import { decodePlayRunPublicStatus } from '../../shared_libs/play-runtime/run-lifecycle-policy.js';
 
 const TERMINAL_PLAY_STATUSES = new Set(['completed', 'failed', 'cancelled']);
 const INCLUDE_TOOL_METADATA_HEADER = 'x-deepline-include-tool-metadata';
@@ -991,12 +992,18 @@ function normalizePlayStatus(raw: Record<string, unknown>): PlayStatus {
       ? raw.package
       : null;
   const packageRun = runPackage?.run;
-  const status =
+  const rawStatus =
     typeof raw.status === 'string'
       ? raw.status
       : typeof packageRun?.status === 'string'
         ? packageRun.status
-        : 'running';
+        : null;
+  const status = decodePlayRunPublicStatus(rawStatus);
+  if (!status) {
+    throw new Error(
+      `Invalid play run lifecycle status in API response: ${JSON.stringify(rawStatus)}.`,
+    );
+  }
   const runId =
     typeof raw.runId === 'string'
       ? raw.runId
@@ -1007,7 +1014,7 @@ function normalizePlayStatus(raw: Record<string, unknown>): PlayStatus {
     ...(raw as unknown as Omit<PlayStatus, 'runId' | 'status'>),
     runId,
     ...(runPackage ? { package: runPackage, outputs: runPackage.outputs } : {}),
-    status: status as PlayStatus['status'],
+    status,
   };
 }
 

package/dist/bundling-sources/sdk/src/release.ts

@@ -155,7 +155,7 @@ export const SDK_RELEASE = {
   // 0.1.253 makes play-page browser opening opt-in and retires --no-open.
   // 0.1.254 removes the internal operations tree from the published SDK CLI.
   // Operators use the checkout-local deepline-admin binary instead.
-  version: '0.1.298',
+  version: '0.1.299',
   contracts: {
     api: {
       name: 'sdk-http-api',

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

@@ -3,7 +3,6 @@ import {
   PLATFORM_DEPLOY_INTERRUPTED_MESSAGE,
 } from './run-failure';
 import {
-  isAuthoritativePlayRunTerminalSource,
   nextPlayRunLedgerTerminalSource,
   normalizePlayRunLedgerTerminalSource,
 } from './run-terminal-source';
@@ -643,16 +642,6 @@ function nextTerminalSource(
   });
 }
 
-function shouldUpgradeFromCoordinatorTerminal(
-  base: PlayRunLedgerSnapshot,
-  eventSource: PlayRunLedgerEventSource,
-): boolean {
-  return (
-    base.terminalSource === 'coordinator' &&
-    isAuthoritativePlayRunTerminalSource(eventSource)
-  );
-}
-
 function shouldIgnoreNonTerminalAfterStickyTerminal(
   base: PlayRunLedgerSnapshot,
 ): boolean {
@@ -908,13 +897,10 @@ function appendLogLines(
 }
 
 /**
- * Terminal-status precedence. Conflicting terminal events use
- * newest-terminal-wins by event time: older events are ignored and logged,
- * newer events reconcile the snapshot. Same-status terminal events continue to
- * the reducer so recovery/transport paths can fill in canonical payloads after
- * an earlier partial terminal snapshot. Retryable platform-deploy failures are
- * the narrow exception: they are never allowed to replace a real terminal
- * result from the runtime.
+ * Terminal-status precedence. The first accepted run terminal is immutable:
+ * later events may enrich the same terminal payload, but may never change its
+ * outcome. Attempt retries are not authority to rewrite a terminal run, and
+ * producer timestamps are telemetry rather than an ordering mechanism.
  */
 function conflictingTerminalSnapshot(
   base: PlayRunLedgerSnapshot,
@@ -923,26 +909,12 @@ function conflictingTerminalSnapshot(
   eventError?: string | null,
   options?: {
     allowStaleSameStatusPayloadMerge?: boolean;
-    allowCoordinatorTerminalUpgrade?: boolean;
   },
 ): PlayRunLedgerSnapshot | null {
   if (!isTerminalPlayRunLedgerStatus(base.status)) {
     return null;
   }
   const terminalAt = base.finishedAt ?? base.updatedAt ?? 0;
-  if (base.status === 'cancelled' && eventType !== 'run.cancelled') {
-    if (occurredAt <= terminalAt) {
-      return withTiming(
-        appendLogLines(base, [
-          `[ledger] stale conflicting terminal event ${eventType} ignored; status already ${base.status}`,
-        ]),
-      );
-    }
-    return withTiming(base);
-  }
-  if (options?.allowCoordinatorTerminalUpgrade === true) {
-    return null;
-  }
   if (
     base.status === 'completed' &&
     eventType === 'run.failed' &&
@@ -970,12 +942,6 @@ function conflictingTerminalSnapshot(
     }
     return null;
   }
-  if (occurredAt > terminalAt) {
-    // Newer terminal evidence reconciles the run. This covers replay/receipt
-    // races where an earlier attempt failed but a later attempt recovered and
-    // completed with the durable result.
-    return null;
-  }
   return withTiming(
     appendLogLines(base, [
       `[ledger] stale conflicting terminal event ${eventType} ignored; status already ${base.status}`,
@@ -1205,12 +1171,7 @@ export function reducePlayRunLedgerEvent(
     case 'run.completed':
       return (
         conflictingTerminalSnapshot(base, event.type, occurredAt, null, {
-          allowCoordinatorTerminalUpgrade: shouldUpgradeFromCoordinatorTerminal(
-            base,
-            event.source,
-          ),
           allowStaleSameStatusPayloadMerge:
-            shouldUpgradeFromCoordinatorTerminal(base, event.source) ||
             (base.result === undefined && event.result !== undefined) ||
             (base.resultSummary === undefined &&
               event.resultSummary !== undefined),
@@ -1234,7 +1195,6 @@ export function reducePlayRunLedgerEvent(
         retryablePlatformDeployFailureSnapshot(base, event.error) ??
         conflictingTerminalSnapshot(base, event.type, occurredAt, event.error, {
           allowStaleSameStatusPayloadMerge:
-            shouldUpgradeFromCoordinatorTerminal(base, event.source) ||
             (base.error == null && event.error != null) ||
             (base.result === undefined && event.result !== undefined),
         }) ??
@@ -1258,7 +1218,6 @@ export function reducePlayRunLedgerEvent(
       return (
         conflictingTerminalSnapshot(base, event.type, occurredAt, event.error, {
           allowStaleSameStatusPayloadMerge:
-            shouldUpgradeFromCoordinatorTerminal(base, event.source) ||
             (base.error == null && event.error != null) ||
             (base.result === undefined && event.result !== undefined),
         }) ??

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

@@ -9,6 +9,15 @@ export type PlayRunLifecycleStatus =
   | 'timed_out'
   | 'unknown';
 
+/** The only lifecycle states exposed by the API, SDK, CLI, and UI. */
+export type PlayRunPublicStatus =
+  | 'queued'
+  | 'running'
+  | 'waiting'
+  | 'completed'
+  | 'failed'
+  | 'cancelled';
+
 const TERMINAL_PLAY_RUN_STATUSES = new Set<PlayRunLifecycleStatus>([
   'completed',
   'failed',
@@ -33,7 +42,7 @@ export function normalizePlayRunLifecycleStatus(
   switch (normalized) {
     case 'queued':
     case 'pending':
-      return 'running';
+      return 'queued';
     case 'running':
     case 'started':
       return 'running';
@@ -60,12 +69,43 @@ export function normalizePlayRunLifecycleStatus(
 }
 
 export function isTerminalPlayRunLifecycleStatus(status: unknown): boolean {
-  return TERMINAL_PLAY_RUN_STATUSES.has(normalizePlayRunLifecycleStatus(status));
+  return TERMINAL_PLAY_RUN_STATUSES.has(
+    normalizePlayRunLifecycleStatus(status),
+  );
 }
 
 export function isActivePlayRunLifecycleStatus(status: unknown): boolean {
   const normalized = normalizePlayRunLifecycleStatus(status);
-  return normalized === 'running' || normalized === 'waiting';
+  return (
+    normalized === 'queued' ||
+    normalized === 'running' ||
+    normalized === 'waiting'
+  );
+}
+
+/**
+ * Decode a public lifecycle value without inventing progress. Internal
+ * termination reasons intentionally collapse to the one public cancellation
+ * outcome at this Adapter boundary. Unknown/missing values are invalid.
+ */
+export function decodePlayRunPublicStatus(
+  value: unknown,
+): PlayRunPublicStatus | null {
+  const status = normalizePlayRunLifecycleStatus(value);
+  switch (status) {
+    case 'queued':
+    case 'running':
+    case 'waiting':
+    case 'completed':
+    case 'failed':
+    case 'cancelled':
+      return status;
+    case 'terminated':
+    case 'timed_out':
+      return 'cancelled';
+    case 'unknown':
+      return null;
+  }
 }
 
 export function isRecoverableDatasetRowStatus(status: unknown): boolean {

package/dist/cli/index.js

@@ -718,7 +718,7 @@ var SDK_RELEASE = {
   // 0.1.253 makes play-page browser opening opt-in and retires --no-open.
   // 0.1.254 removes the internal operations tree from the published SDK CLI.
   // Operators use the checkout-local deepline-admin binary instead.
-  version: "0.1.298",
+  version: "0.1.299",
   contracts: {
     api: {
       name: "sdk-http-api",
@@ -2113,7 +2113,7 @@ function normalizePlayRunLifecycleStatus(value) {
   switch (normalized) {
     case "queued":
     case "pending":
-      return "running";
+      return "queued";
     case "running":
     case "started":
       return "running";
@@ -2139,7 +2139,26 @@ function normalizePlayRunLifecycleStatus(value) {
   }
 }
 function isTerminalPlayRunLifecycleStatus(status) {
-  return TERMINAL_PLAY_RUN_STATUSES.has(normalizePlayRunLifecycleStatus(status));
+  return TERMINAL_PLAY_RUN_STATUSES.has(
+    normalizePlayRunLifecycleStatus(status)
+  );
+}
+function decodePlayRunPublicStatus(value) {
+  const status = normalizePlayRunLifecycleStatus(value);
+  switch (status) {
+    case "queued":
+    case "running":
+    case "waiting":
+    case "completed":
+    case "failed":
+    case "cancelled":
+      return status;
+    case "terminated":
+    case "timed_out":
+      return "cancelled";
+    case "unknown":
+      return null;
+  }
 }
 
 // ../shared_libs/play-runtime/run-snapshot-stream.ts
@@ -3080,7 +3099,13 @@ function isPlayRunPackage(value) {
 function normalizePlayStatus(raw) {
   const runPackage = isPlayRunPackage(raw) ? raw : isPlayRunPackage(raw.package) ? raw.package : null;
   const packageRun = runPackage?.run;
-  const status = typeof raw.status === "string" ? raw.status : typeof packageRun?.status === "string" ? packageRun.status : "running";
+  const rawStatus = typeof raw.status === "string" ? raw.status : typeof packageRun?.status === "string" ? packageRun.status : null;
+  const status = decodePlayRunPublicStatus(rawStatus);
+  if (!status) {
+    throw new Error(
+      `Invalid play run lifecycle status in API response: ${JSON.stringify(rawStatus)}.`
+    );
+  }
   const runId = typeof raw.runId === "string" ? raw.runId : typeof raw.workflowId === "string" ? raw.workflowId : packageRun?.id ?? "";
   return {
     ...raw,

package/dist/cli/index.mjs

@@ -703,7 +703,7 @@ var SDK_RELEASE = {
   // 0.1.253 makes play-page browser opening opt-in and retires --no-open.
   // 0.1.254 removes the internal operations tree from the published SDK CLI.
   // Operators use the checkout-local deepline-admin binary instead.
-  version: "0.1.298",
+  version: "0.1.299",
   contracts: {
     api: {
       name: "sdk-http-api",
@@ -2098,7 +2098,7 @@ function normalizePlayRunLifecycleStatus(value) {
   switch (normalized) {
     case "queued":
     case "pending":
-      return "running";
+      return "queued";
     case "running":
     case "started":
       return "running";
@@ -2124,7 +2124,26 @@ function normalizePlayRunLifecycleStatus(value) {
   }
 }
 function isTerminalPlayRunLifecycleStatus(status) {
-  return TERMINAL_PLAY_RUN_STATUSES.has(normalizePlayRunLifecycleStatus(status));
+  return TERMINAL_PLAY_RUN_STATUSES.has(
+    normalizePlayRunLifecycleStatus(status)
+  );
+}
+function decodePlayRunPublicStatus(value) {
+  const status = normalizePlayRunLifecycleStatus(value);
+  switch (status) {
+    case "queued":
+    case "running":
+    case "waiting":
+    case "completed":
+    case "failed":
+    case "cancelled":
+      return status;
+    case "terminated":
+    case "timed_out":
+      return "cancelled";
+    case "unknown":
+      return null;
+  }
 }
 
 // ../shared_libs/play-runtime/run-snapshot-stream.ts
@@ -3065,7 +3084,13 @@ function isPlayRunPackage(value) {
 function normalizePlayStatus(raw) {
   const runPackage = isPlayRunPackage(raw) ? raw : isPlayRunPackage(raw.package) ? raw.package : null;
   const packageRun = runPackage?.run;
-  const status = typeof raw.status === "string" ? raw.status : typeof packageRun?.status === "string" ? packageRun.status : "running";
+  const rawStatus = typeof raw.status === "string" ? raw.status : typeof packageRun?.status === "string" ? packageRun.status : null;
+  const status = decodePlayRunPublicStatus(rawStatus);
+  if (!status) {
+    throw new Error(
+      `Invalid play run lifecycle status in API response: ${JSON.stringify(rawStatus)}.`
+    );
+  }
   const runId = typeof raw.runId === "string" ? raw.runId : typeof raw.workflowId === "string" ? raw.workflowId : packageRun?.id ?? "";
   return {
     ...raw,

package/dist/index.js

@@ -438,7 +438,7 @@ var SDK_RELEASE = {
   // 0.1.253 makes play-page browser opening opt-in and retires --no-open.
   // 0.1.254 removes the internal operations tree from the published SDK CLI.
   // Operators use the checkout-local deepline-admin binary instead.
-  version: "0.1.298",
+  version: "0.1.299",
   contracts: {
     api: {
       name: "sdk-http-api",
@@ -1833,7 +1833,7 @@ function normalizePlayRunLifecycleStatus(value) {
   switch (normalized) {
     case "queued":
     case "pending":
-      return "running";
+      return "queued";
     case "running":
     case "started":
       return "running";
@@ -1859,7 +1859,26 @@ function normalizePlayRunLifecycleStatus(value) {
   }
 }
 function isTerminalPlayRunLifecycleStatus(status) {
-  return TERMINAL_PLAY_RUN_STATUSES.has(normalizePlayRunLifecycleStatus(status));
+  return TERMINAL_PLAY_RUN_STATUSES.has(
+    normalizePlayRunLifecycleStatus(status)
+  );
+}
+function decodePlayRunPublicStatus(value) {
+  const status = normalizePlayRunLifecycleStatus(value);
+  switch (status) {
+    case "queued":
+    case "running":
+    case "waiting":
+    case "completed":
+    case "failed":
+    case "cancelled":
+      return status;
+    case "terminated":
+    case "timed_out":
+      return "cancelled";
+    case "unknown":
+      return null;
+  }
 }
 
 // ../shared_libs/play-runtime/run-snapshot-stream.ts
@@ -2800,7 +2819,13 @@ function isPlayRunPackage(value) {
 function normalizePlayStatus(raw) {
   const runPackage = isPlayRunPackage(raw) ? raw : isPlayRunPackage(raw.package) ? raw.package : null;
   const packageRun = runPackage?.run;
-  const status = typeof raw.status === "string" ? raw.status : typeof packageRun?.status === "string" ? packageRun.status : "running";
+  const rawStatus = typeof raw.status === "string" ? raw.status : typeof packageRun?.status === "string" ? packageRun.status : null;
+  const status = decodePlayRunPublicStatus(rawStatus);
+  if (!status) {
+    throw new Error(
+      `Invalid play run lifecycle status in API response: ${JSON.stringify(rawStatus)}.`
+    );
+  }
   const runId = typeof raw.runId === "string" ? raw.runId : typeof raw.workflowId === "string" ? raw.workflowId : packageRun?.id ?? "";
   return {
     ...raw,

package/dist/index.mjs

@@ -367,7 +367,7 @@ var SDK_RELEASE = {
   // 0.1.253 makes play-page browser opening opt-in and retires --no-open.
   // 0.1.254 removes the internal operations tree from the published SDK CLI.
   // Operators use the checkout-local deepline-admin binary instead.
-  version: "0.1.298",
+  version: "0.1.299",
   contracts: {
     api: {
       name: "sdk-http-api",
@@ -1762,7 +1762,7 @@ function normalizePlayRunLifecycleStatus(value) {
   switch (normalized) {
     case "queued":
     case "pending":
-      return "running";
+      return "queued";
     case "running":
     case "started":
       return "running";
@@ -1788,7 +1788,26 @@ function normalizePlayRunLifecycleStatus(value) {
   }
 }
 function isTerminalPlayRunLifecycleStatus(status) {
-  return TERMINAL_PLAY_RUN_STATUSES.has(normalizePlayRunLifecycleStatus(status));
+  return TERMINAL_PLAY_RUN_STATUSES.has(
+    normalizePlayRunLifecycleStatus(status)
+  );
+}
+function decodePlayRunPublicStatus(value) {
+  const status = normalizePlayRunLifecycleStatus(value);
+  switch (status) {
+    case "queued":
+    case "running":
+    case "waiting":
+    case "completed":
+    case "failed":
+    case "cancelled":
+      return status;
+    case "terminated":
+    case "timed_out":
+      return "cancelled";
+    case "unknown":
+      return null;
+  }
 }
 
 // ../shared_libs/play-runtime/run-snapshot-stream.ts
@@ -2729,7 +2748,13 @@ function isPlayRunPackage(value) {
 function normalizePlayStatus(raw) {
   const runPackage = isPlayRunPackage(raw) ? raw : isPlayRunPackage(raw.package) ? raw.package : null;
   const packageRun = runPackage?.run;
-  const status = typeof raw.status === "string" ? raw.status : typeof packageRun?.status === "string" ? packageRun.status : "running";
+  const rawStatus = typeof raw.status === "string" ? raw.status : typeof packageRun?.status === "string" ? packageRun.status : null;
+  const status = decodePlayRunPublicStatus(rawStatus);
+  if (!status) {
+    throw new Error(
+      `Invalid play run lifecycle status in API response: ${JSON.stringify(rawStatus)}.`
+    );
+  }
   const runId = typeof raw.runId === "string" ? raw.runId : typeof raw.workflowId === "string" ? raw.workflowId : packageRun?.id ?? "";
   return {
     ...raw,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "deepline",
-  "version": "0.1.298",
+  "version": "0.1.299",
   "description": "Deepline SDK + CLI — B2B data enrichment powered by durable cloud execution",
   "license": "MIT",
   "repository": {