deepline 0.1.191 → 0.1.192

package/dist/bundling-sources/apps/play-runner-workers/src/coordinator-entry.ts

@@ -131,6 +131,8 @@ export type PlayWorkflowParams = {
   dynamicWorkerCode?: string | null;
   executorToken: string;
   baseUrl: string;
+  runtimeApiBaseUrl?: string | null;
+  callbackUrl?: string | null;
   integrationMode?: 'live' | 'eval_stub' | 'fixture' | null;
   orgId: string;
   userEmail: string;
@@ -402,6 +404,15 @@ function recordCoordinatorPerfTrace(event: CoordinatorPerfTraceInput): void {
   logCoordinatorPerfTrace(payload);
 }
 
+function safeOrigin(value: string | null | undefined): string | null {
+  if (!value?.trim()) return null;
+  try {
+    return new URL(value).origin;
+  } catch {
+    return '<invalid>';
+  }
+}
+
 async function appendCoordinatorPerfTrace(
   env: CoordinatorEnv,
   payload: CoordinatorPerfTracePayload,
@@ -1330,9 +1341,23 @@ async function markWorkflowRuntimeFailure(input: {
   const backoffMs = [200, 500, 1500];
   let lastError: unknown = null;
   for (let attempt = 0; attempt <= backoffMs.length; attempt += 1) {
+    const requestId = crypto.randomUUID();
     try {
+      headers.set('x-deepline-request-id', requestId);
       const response = await fetch(url, { method: 'POST', headers, body });
-      if (response.ok) return;
+      if (response.ok) {
+        if (attempt > 0) {
+          console.info('[coordinator.runtime_api.retry]', {
+            action: 'append_run_events',
+            status: 'ok',
+            attempt,
+            runId,
+            requestId,
+            baseOrigin: safeOrigin(baseUrl),
+          });
+        }
+        return;
+      }
       lastError = new Error(
         `runtime API responded ${response.status}: ${(await response.text().catch(() => '')).slice(0, 400)}`,
       );
@@ -1348,6 +1373,19 @@ async function markWorkflowRuntimeFailure(input: {
       lastError = error;
     }
     if (attempt < backoffMs.length) {
+      console.warn('[coordinator.runtime_api.retry]', {
+        action: 'append_run_events',
+        status: 'retry',
+        attempt: attempt + 1,
+        retryDelayMs: backoffMs[attempt],
+        runId,
+        requestId,
+        baseOrigin: safeOrigin(baseUrl),
+        error:
+          lastError instanceof Error
+            ? lastError.message.slice(0, 300)
+            : String(lastError).slice(0, 300),
+      });
       await new Promise((resolve) => setTimeout(resolve, backoffMs[attempt]));
     }
   }
@@ -2203,6 +2241,26 @@ async function callRuntimeApiFromCoordinator(input: {
   });
 
   const fetchStartedAt = Date.now();
+  const requestId = crypto.randomUUID();
+  const action =
+    body && typeof body === 'object' && !Array.isArray(body)
+      ? String((body as { action?: unknown }).action ?? 'unknown')
+      : 'unknown';
+  const runId =
+    body && typeof body === 'object' && !Array.isArray(body)
+      ? String(
+          (body as { runId?: unknown; playId?: unknown }).runId ??
+            (body as { runId?: unknown; playId?: unknown }).playId ??
+            '',
+        ) || null
+      : null;
+  console.info('[coordinator.runtime_api.breadcrumb]', {
+    phase: 'request',
+    action,
+    runId,
+    requestId,
+    baseOrigin: safeOrigin(input.baseUrl),
+  });
   const response = await input.env.HARNESS.runtimeApiCall({
     contract: PLAY_RUNTIME_CONTRACT,
     executorToken: input.executorToken,
@@ -2210,11 +2268,20 @@ async function callRuntimeApiFromCoordinator(input: {
     path: PLAY_RUNTIME_API_COMPAT_PATH,
     body,
     headers: {
-      'x-deepline-request-id': crypto.randomUUID(),
+      'x-deepline-request-id': requestId,
       [PLAY_RUNTIME_CONTRACT_HEADER]: String(PLAY_RUNTIME_CONTRACT),
     },
   });
   recordTiming('coordinator.runtime_api.fetch', fetchStartedAt);
+  console.info('[coordinator.runtime_api.breadcrumb]', {
+    phase: 'response',
+    action,
+    runId,
+    requestId,
+    status: response.status,
+    ms: Date.now() - fetchStartedAt,
+    baseOrigin: safeOrigin(input.baseUrl),
+  });
 
   const bodyStartedAt = Date.now();
   const responseBody = response.body;
@@ -2361,12 +2428,75 @@ function normalizeRuntimeBaseUrl(value: unknown): string | null {
   return parsed.toString().replace(/\/$/, '');
 }
 
-function resolveRuntimeBaseUrl(
+const DEEPLINE_PRODUCTION_APP_HOST = 'code.deepline.com';
+const DEEPLINE_VERCEL_DEPLOYMENT_HOST_RE =
+  /^deepline-api(?:-[a-z0-9-]+)?-aero-team-0f650658\.vercel\.app$/i;
+const DEEPLINE_VERCEL_PROJECT_HOST_RE =
+  /^deepline-[a-z0-9]+-aero-team-0f650658\.vercel\.app$/i;
+const DEEPLINE_WORKERS_DEV_SUBDOMAINS = new Set(['chirag-d94']);
+
+function isDeeplineCoordinatorWorkerHost(hostname: string): boolean {
+  const labels = hostname.toLowerCase().split('.');
+  return (
+    labels.length === 4 &&
+    labels[0]?.startsWith('deepline-play-coordinator-') &&
+    labels[2] === 'workers' &&
+    labels[3] === 'dev' &&
+    DEEPLINE_WORKERS_DEV_SUBDOMAINS.has(labels[1] ?? '')
+  );
+}
+
+function shouldCanonicalizeRuntimeApiBaseUrl(input: {
+  configuredBaseUrl: URL;
+  overrideBaseUrl: URL;
+}): boolean {
+  if (input.overrideBaseUrl.host === input.configuredBaseUrl.host) {
+    return false;
+  }
+  const configuredHostname = input.configuredBaseUrl.hostname.toLowerCase();
+  const overrideHostname = input.overrideBaseUrl.hostname.toLowerCase();
+  if (DEEPLINE_VERCEL_DEPLOYMENT_HOST_RE.test(overrideHostname)) {
+    return true;
+  }
+  if (
+    (configuredHostname === DEEPLINE_PRODUCTION_APP_HOST ||
+      DEEPLINE_VERCEL_PROJECT_HOST_RE.test(configuredHostname)) &&
+    DEEPLINE_VERCEL_PROJECT_HOST_RE.test(overrideHostname)
+  ) {
+    return true;
+  }
+  return isDeeplineCoordinatorWorkerHost(overrideHostname);
+}
+
+function resolveRuntimeApiBaseUrl(
+  env: CoordinatorEnv,
+  body: Record<string, unknown>,
+): string {
+  const configuredBaseUrl = env.DEEPLINE_API_BASE_URL.replace(/\/$/, '');
+  const overrideBaseUrl =
+    normalizeRuntimeBaseUrl(body.runtimeApiBaseUrl) ??
+    normalizeRuntimeBaseUrl(body.baseUrl);
+  if (!overrideBaseUrl) {
+    return configuredBaseUrl;
+  }
+  if (
+    shouldCanonicalizeRuntimeApiBaseUrl({
+      configuredBaseUrl: new URL(configuredBaseUrl),
+      overrideBaseUrl: new URL(overrideBaseUrl),
+    })
+  ) {
+    return configuredBaseUrl;
+  }
+  return overrideBaseUrl;
+}
+
+function resolveWorkflowCallbackBaseUrl(
   env: CoordinatorEnv,
   body: Record<string, unknown>,
 ): string {
   return (
     normalizeRuntimeBaseUrl(body.callbackBaseUrl) ??
+    normalizeRuntimeBaseUrl(body.callbackUrl) ??
     normalizeRuntimeBaseUrl(body.baseUrl) ??
     env.DEEPLINE_API_BASE_URL.replace(/\/$/, '')
   );
@@ -2388,7 +2518,8 @@ function validateChildSubmitBody(input: {
   const { parentRunId, body } = input;
   const manifest = body.manifest as PlayRuntimeManifest | undefined;
   const governance = body.internalRunPlay as
-    PlayCallGovernanceSnapshot | undefined;
+    | PlayCallGovernanceSnapshot
+    | undefined;
   const childPlayName =
     typeof body.name === 'string' && body.name.trim()
       ? body.name.trim()
@@ -2480,7 +2611,8 @@ function buildChildWorkflowParams(input: {
     dynamicWorkerCode,
     preloadedDbSessions,
   } = input;
-  const baseUrl = resolveRuntimeBaseUrl(env, body);
+  const baseUrl = resolveRuntimeApiBaseUrl(env, body);
+  const callbackUrl = resolveWorkflowCallbackBaseUrl(env, body);
   return {
     runId: childRunId,
     playId: childRunId,
@@ -2517,7 +2649,9 @@ function buildChildWorkflowParams(input: {
     preloadedDbSessions,
     dynamicWorkerCode,
     executorToken: childToken,
-    baseUrl,
+    baseUrl: callbackUrl,
+    runtimeApiBaseUrl: baseUrl,
+    callbackUrl,
     integrationMode: normalizeIntegrationMode(body.integrationMode),
     force: body.force === true || body.forceToolRefresh === true,
     forceToolRefresh: body.forceToolRefresh === true,
@@ -2545,9 +2679,9 @@ function runRequestFromPlayWorkflowParams(
     params.inputFile?.r2Key ?? params.inputFile?.storageKey ?? null;
   return {
     runId: params.runId,
-    callbackUrl: params.baseUrl,
+    callbackUrl: params.callbackUrl ?? params.baseUrl,
     executorToken: params.executorToken,
-    baseUrl: params.baseUrl,
+    baseUrl: params.runtimeApiBaseUrl ?? params.baseUrl,
     integrationMode: normalizeIntegrationMode(params.integrationMode),
     orgId: params.orgId,
     playName: params.playName,
@@ -2742,7 +2876,7 @@ async function executeChildInline(input: {
     input.body.parentPlayName.trim()
       ? input.body.parentPlayName.trim()
       : governance.parentPlayName;
-  const baseUrl = resolveRuntimeBaseUrl(input.env, input.body);
+  const baseUrl = resolveRuntimeApiBaseUrl(input.env, input.body);
   const { childToken, preloadedDbSessions, prepareTimings, transportTimings } =
     await prepareInlineChildRunWithRuntime({
       env: input.env,
@@ -3072,7 +3206,7 @@ async function submitChildWorkflowThroughCoordinator(input: {
     parentRunId: input.parentRunId,
     body: input.body,
   });
-  const baseUrl = resolveRuntimeBaseUrl(input.env, input.body);
+  const baseUrl = resolveRuntimeApiBaseUrl(input.env, input.body);
 
   const tokenStartedAt = Date.now();
   const childToken = await mintChildWorkflowExecutorToken({

package/dist/bundling-sources/apps/play-runner-workers/src/entry.ts

@@ -1386,10 +1386,12 @@ async function postRuntimeApi<T>(
   throw lastError instanceof Error ? lastError : new Error(String(lastError));
 }
 
+const RETRYABLE_RUNTIME_API_ERROR_RE =
+  /timeout|timed out|fetch failed|ECONNRESET|ECONNREFUSED|DeploymentNotFound|requested deployment .*exist|Authentication infrastructure/i;
+
 function isRetryableRuntimeApiError(error: unknown): boolean {
-  const message = error instanceof Error ? error.message : String(error);
-  return /timed out|timeout|fetch failed|ECONNRESET|ECONNREFUSED|UND_ERR_CONNECT_TIMEOUT/i.test(
-    message,
+  return RETRYABLE_RUNTIME_API_ERROR_RE.test(
+    error instanceof Error ? error.message : String(error),
   );
 }
 
@@ -1411,12 +1413,7 @@ function isRetryableRuntimeApiResponse(status: number, body: string): boolean {
   ) {
     return true;
   }
-  return (
-    status === 500 &&
-    /timeout exceeded when trying to connect|timed out|fetch failed|ECONNRESET|UND_ERR_CONNECT_TIMEOUT/i.test(
-      body,
-    )
-  );
+  return status === 500 && RETRYABLE_RUNTIME_API_ERROR_RE.test(body);
 }
 
 async function sleepRuntimeApiRetry(attempt: number): Promise<void> {
@@ -8305,9 +8302,9 @@ function runRequestFromWorkflowParams(
         : null;
   return {
     runId: String(params.runId ?? ''),
-    callbackUrl: String(params.baseUrl ?? ''),
+    callbackUrl: String(params.callbackUrl ?? params.baseUrl ?? ''),
     executorToken: String(params.executorToken ?? ''),
-    baseUrl: String(params.baseUrl ?? ''),
+    baseUrl: String(params.runtimeApiBaseUrl ?? params.baseUrl ?? ''),
     integrationMode: normalizeIntegrationMode(params.integrationMode),
     orgId: String(params.orgId ?? ''),
     playName: String(params.playName ?? ''),

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

@@ -105,10 +105,10 @@ export const SDK_RELEASE = {
   // 0.1.154 removes the short-lived generated enrich StepOptions recompute
   // fields shipped in 0.1.153.
   // 0.1.175 ships loud `deepline enrich` empty-waterfall reporting.
-  version: '0.1.191',
+  version: '0.1.192',
   apiContract: '2026-06-dataset-handle-results-hard-cutover',
   supportPolicy: {
-    latest: '0.1.191',
+    latest: '0.1.192',
     minimumSupported: '0.1.53',
     deprecatedBelow: '0.1.53',
     commandMinimumSupported: [

package/dist/bundling-sources/shared_libs/play-runtime/durable-receipt-execution.ts

@@ -11,6 +11,7 @@ import {
   isPlayExecutionSuspendedError,
   isPlayRowExecutionSuspendedError,
 } from './suspension';
+import { getToolHttpErrorReceiptFailureKind } from './tool-http-errors';
 import type { WorkReceiptFailureKind } from './work-receipts';
 import {
   PLAY_RUNTIME_WORK_RECEIPT_LEASE_TTL_MS,
@@ -48,6 +49,8 @@ function isInFlightRuntimeReceipt(
 export function runtimeReceiptFailureKindForError(
   error: unknown,
 ): WorkReceiptFailureKind {
+  const toolFailureKind = getToolHttpErrorReceiptFailureKind(error);
+  if (toolFailureKind) return toolFailureKind;
   return isPlayExecutionSuspendedError(error) ||
     isPlayRowExecutionSuspendedError(error)
     ? 'repairable'

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

@@ -128,6 +128,11 @@ export type PlaySchedulerSubmitInput = {
   /** Optional immutable Worker module source for local Dynamic Worker loading. */
   dynamicWorkerCode?: string | null;
   executorToken: string;
+  /**
+   * Public app origin used by Workers to call Deepline runtime API routes.
+   * When omitted, legacy schedulers fall back to baseUrl.
+   */
+  runtimeApiBaseUrl?: string | null;
   baseUrl: string;
   /** Optional per-run provider execution mode. Defaults to server policy when omitted. */
   integrationMode?: 'live' | 'eval_stub' | 'fixture';

package/dist/bundling-sources/shared_libs/play-runtime/tool-execute-retry-policy.ts

@@ -204,9 +204,7 @@ export function classifyToolExecuteHttpFailure(input: {
   });
   const shouldRetry =
     retryDecision.retryable && input.attempt < retryDecision.attemptCap;
-  error.receiptFailureKind = retryDecision.retryable
-    ? 'repairable'
-    : 'terminal';
+  if (retryDecision.retryable) error.receiptFailureKind = 'repairable';
   const retryAfterMs = parseToolExecuteRetryAfterMs(
     input.retryAfterHeader,
     input.nowMs,

package/dist/bundling-sources/shared_libs/play-runtime/tool-http-errors.ts

@@ -4,13 +4,13 @@ export class ToolHttpError extends Error {
   readonly billing: Record<string, unknown> | null;
   /** HTTP status of the failed tool-execute response (e.g. 429, 502). */
   readonly status: number;
-  receiptFailureKind: WorkReceiptFailureKind | null;
+  receiptFailureKind: WorkReceiptFailureKind;
 
   constructor(
     message: string,
     billing: Record<string, unknown> | null,
     status: number,
-    receiptFailureKind: WorkReceiptFailureKind | null = null,
+    receiptFailureKind: WorkReceiptFailureKind = 'terminal',
   ) {
     super(message);
     this.name = 'ToolHttpError';

package/dist/cli/index.js

@@ -623,10 +623,10 @@ var SDK_RELEASE = {
   // 0.1.154 removes the short-lived generated enrich StepOptions recompute
   // fields shipped in 0.1.153.
   // 0.1.175 ships loud `deepline enrich` empty-waterfall reporting.
-  version: "0.1.191",
+  version: "0.1.192",
   apiContract: "2026-06-dataset-handle-results-hard-cutover",
   supportPolicy: {
-    latest: "0.1.191",
+    latest: "0.1.192",
     minimumSupported: "0.1.53",
     deprecatedBelow: "0.1.53",
     commandMinimumSupported: [
@@ -19385,6 +19385,30 @@ function coalesceExportableSheetRows(rows, sourceRowStart = 0) {
     bySourceRowIndex.set(rowIndex, next);
     mergedRows.push(next);
   }
+  if (bySourceRowIndex.size > 0) {
+    mergedRows.sort((left, right) => {
+      const leftIndex = sourceRowIndexFromEnrichRow(
+        left,
+        sourceRowStart,
+        Number.MAX_SAFE_INTEGER
+      );
+      const rightIndex = sourceRowIndexFromEnrichRow(
+        right,
+        sourceRowStart,
+        Number.MAX_SAFE_INTEGER
+      );
+      if (leftIndex !== null && rightIndex !== null) {
+        return leftIndex - rightIndex;
+      }
+      if (leftIndex !== null) {
+        return -1;
+      }
+      if (rightIndex !== null) {
+        return 1;
+      }
+      return 0;
+    });
+  }
   return mergedRows;
 }
 function sourceRowIndexFromEnrichRow(row, start, end) {
@@ -21227,7 +21251,9 @@ function registerEnrichCommand(program) {
               ...finalExportResult ? { rowSetComplete: !finalExportResult.partial } : {}
             });
             if (chunk.exportResult) {
-              currentChunkCommittedExportResult = await commitInPlaceOutput(chunk.exportResult);
+              currentChunkCommittedExportResult = await commitInPlaceOutput(
+                chunk.exportResult
+              );
               finalExportResult = currentChunkCommittedExportResult;
             }
             const reportedExportResult = currentChunkCommittedExportResult ?? finalExportResult;

package/dist/cli/index.mjs

@@ -608,10 +608,10 @@ var SDK_RELEASE = {
   // 0.1.154 removes the short-lived generated enrich StepOptions recompute
   // fields shipped in 0.1.153.
   // 0.1.175 ships loud `deepline enrich` empty-waterfall reporting.
-  version: "0.1.191",
+  version: "0.1.192",
   apiContract: "2026-06-dataset-handle-results-hard-cutover",
   supportPolicy: {
-    latest: "0.1.191",
+    latest: "0.1.192",
     minimumSupported: "0.1.53",
     deprecatedBelow: "0.1.53",
     commandMinimumSupported: [
@@ -19414,6 +19414,30 @@ function coalesceExportableSheetRows(rows, sourceRowStart = 0) {
     bySourceRowIndex.set(rowIndex, next);
     mergedRows.push(next);
   }
+  if (bySourceRowIndex.size > 0) {
+    mergedRows.sort((left, right) => {
+      const leftIndex = sourceRowIndexFromEnrichRow(
+        left,
+        sourceRowStart,
+        Number.MAX_SAFE_INTEGER
+      );
+      const rightIndex = sourceRowIndexFromEnrichRow(
+        right,
+        sourceRowStart,
+        Number.MAX_SAFE_INTEGER
+      );
+      if (leftIndex !== null && rightIndex !== null) {
+        return leftIndex - rightIndex;
+      }
+      if (leftIndex !== null) {
+        return -1;
+      }
+      if (rightIndex !== null) {
+        return 1;
+      }
+      return 0;
+    });
+  }
   return mergedRows;
 }
 function sourceRowIndexFromEnrichRow(row, start, end) {
@@ -21256,7 +21280,9 @@ function registerEnrichCommand(program) {
               ...finalExportResult ? { rowSetComplete: !finalExportResult.partial } : {}
             });
             if (chunk.exportResult) {
-              currentChunkCommittedExportResult = await commitInPlaceOutput(chunk.exportResult);
+              currentChunkCommittedExportResult = await commitInPlaceOutput(
+                chunk.exportResult
+              );
               finalExportResult = currentChunkCommittedExportResult;
             }
             const reportedExportResult = currentChunkCommittedExportResult ?? finalExportResult;

package/dist/index.js

@@ -422,10 +422,10 @@ var SDK_RELEASE = {
   // 0.1.154 removes the short-lived generated enrich StepOptions recompute
   // fields shipped in 0.1.153.
   // 0.1.175 ships loud `deepline enrich` empty-waterfall reporting.
-  version: "0.1.191",
+  version: "0.1.192",
   apiContract: "2026-06-dataset-handle-results-hard-cutover",
   supportPolicy: {
-    latest: "0.1.191",
+    latest: "0.1.192",
     minimumSupported: "0.1.53",
     deprecatedBelow: "0.1.53",
     commandMinimumSupported: [

package/dist/index.mjs

@@ -352,10 +352,10 @@ var SDK_RELEASE = {
   // 0.1.154 removes the short-lived generated enrich StepOptions recompute
   // fields shipped in 0.1.153.
   // 0.1.175 ships loud `deepline enrich` empty-waterfall reporting.
-  version: "0.1.191",
+  version: "0.1.192",
   apiContract: "2026-06-dataset-handle-results-hard-cutover",
   supportPolicy: {
-    latest: "0.1.191",
+    latest: "0.1.192",
     minimumSupported: "0.1.53",
     deprecatedBelow: "0.1.53",
     commandMinimumSupported: [

package/package.json

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