deepline 0.1.190 → 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,9 +1386,18 @@ 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 {
+  return RETRYABLE_RUNTIME_API_ERROR_RE.test(
+    error instanceof Error ? error.message : String(error),
+  );
+}
+
+function isRetryableRuntimePersistenceError(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(
+  return /deadlock detected|Runtime Postgres connection timed out|could not serialize access|tuple concurrently updated/i.test(
     message,
   );
 }
@@ -1404,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> {
@@ -4495,6 +4499,10 @@ function createMinimalWorkerCtx(
       executionPlan: plan,
       staticPipeline: staticPipelineFromReq(req),
     });
+    const mapHasExternalSideEffects =
+      mapDispatchPlan.workEstimate.providerToolCallsPerRow > 0 ||
+      mapDispatchPlan.workEstimate.childPlaySubmitsPerRow > 0 ||
+      mapDispatchPlan.workEstimate.eventWaitsPerRow > 0;
     const rowsPerChunk = mapDispatchPlan.rowsPerChunk;
     recordRunnerPerfTrace({
       req,
@@ -5765,6 +5773,13 @@ function createMinimalWorkerCtx(
           },
         });
       } catch (error) {
+        if (
+          workflowStep &&
+          !mapHasExternalSideEffects &&
+          isRetryableRuntimePersistenceError(error)
+        ) {
+          throw error;
+        }
         tripRuntimePersistenceLatch(persistenceLatch, error);
         recordRunnerPerfTrace({
           req,
@@ -8287,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.190',
+  version: '0.1.192',
   apiContract: '2026-06-dataset-handle-results-hard-cutover',
   supportPolicy: {
-    latest: '0.1.190',
+    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.190",
+  version: "0.1.192",
   apiContract: "2026-06-dataset-handle-results-hard-cutover",
   supportPolicy: {
-    latest: "0.1.190",
+    latest: "0.1.192",
     minimumSupported: "0.1.53",
     deprecatedBelow: "0.1.53",
     commandMinimumSupported: [
@@ -7443,6 +7443,9 @@ async function waitForRenderHealth(url, state) {
     if (isOwnedCsvRenderHealth(await fetchCsvRenderHealth(url), state)) {
       return true;
     }
+    if (state.pid && !processAlive(state.pid)) {
+      return false;
+    }
     await new Promise((resolveDelay) => setTimeout(resolveDelay, 100));
   }
   return false;
@@ -7505,6 +7508,10 @@ const server = http.createServer((req, res) => {
 });
 
 server.listen(port, '127.0.0.1');
+server.on('error', (error) => {
+  console.error(error && error.stack ? error.stack : error);
+  process.exit(1);
+});
 process.on('SIGTERM', () => server.close(() => process.exit(0)));
 process.on('SIGINT', () => server.close(() => process.exit(0)));
 `;
@@ -7560,17 +7567,23 @@ async function handleCsvRenderStart(options) {
   }
   ensureCsvRenderStateDir();
   const logPath = csvRenderLogPath();
+  const logFd = (0, import_node_fs7.openSync)(logPath, "w");
   const token = (0, import_node_crypto2.randomUUID)();
-  const child = (0, import_node_child_process.spawn)(process.execPath, ["-e", CSV_RENDER_SERVER_SOURCE], {
-    detached: true,
-    stdio: ["ignore", "ignore", "ignore"],
-    env: {
-      ...process.env,
-      DEEPLINE_CSV_RENDER_PORT: String(port),
-      DEEPLINE_CSV_RENDER_CSV: csvPath,
-      DEEPLINE_CSV_RENDER_TOKEN: token
+  const child = (0, import_node_child_process.spawn)(
+    process.execPath,
+    ["-e", CSV_RENDER_SERVER_SOURCE],
+    {
+      detached: true,
+      stdio: ["ignore", logFd, logFd],
+      env: {
+        ...process.env,
+        DEEPLINE_CSV_RENDER_PORT: String(port),
+        DEEPLINE_CSV_RENDER_CSV: csvPath,
+        DEEPLINE_CSV_RENDER_TOKEN: token
+      }
     }
-  });
+  );
+  (0, import_node_fs7.closeSync)(logFd);
   child.unref();
   const state = {
     pid: child.pid ?? null,
@@ -7586,7 +7599,19 @@ async function handleCsvRenderStart(options) {
     if (processAlive(child.pid)) {
       process.kill(child.pid, "SIGTERM");
     }
-    throw new Error(`Timed out waiting for CSV render to start at ${url}.`);
+    let detail = "";
+    try {
+      const log = (0, import_node_fs7.readFileSync)(logPath, "utf8").trim();
+      if (log) {
+        detail = `
+CSV render log:
+${clip(log, 2e3)}`;
+      }
+    } catch {
+    }
+    throw new Error(
+      `Timed out waiting for CSV render to start at ${url}.${detail}`
+    );
   }
   writeCsvRenderState(state);
   (0, import_node_fs7.writeFileSync)(
@@ -19360,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) {
@@ -21202,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.190",
+  version: "0.1.192",
   apiContract: "2026-06-dataset-handle-results-hard-cutover",
   supportPolicy: {
-    latest: "0.1.190",
+    latest: "0.1.192",
     minimumSupported: "0.1.53",
     deprecatedBelow: "0.1.53",
     commandMinimumSupported: [
@@ -6670,8 +6670,10 @@ Examples:
 import { spawn } from "child_process";
 import { randomUUID } from "crypto";
 import {
+  closeSync,
   existsSync as existsSync6,
   mkdirSync as mkdirSync5,
+  openSync,
   readFileSync as readFileSync6,
   rmSync as rmSync3,
   writeFileSync as writeFileSync6
@@ -7446,6 +7448,9 @@ async function waitForRenderHealth(url, state) {
     if (isOwnedCsvRenderHealth(await fetchCsvRenderHealth(url), state)) {
       return true;
     }
+    if (state.pid && !processAlive(state.pid)) {
+      return false;
+    }
     await new Promise((resolveDelay) => setTimeout(resolveDelay, 100));
   }
   return false;
@@ -7508,6 +7513,10 @@ const server = http.createServer((req, res) => {
 });
 
 server.listen(port, '127.0.0.1');
+server.on('error', (error) => {
+  console.error(error && error.stack ? error.stack : error);
+  process.exit(1);
+});
 process.on('SIGTERM', () => server.close(() => process.exit(0)));
 process.on('SIGINT', () => server.close(() => process.exit(0)));
 `;
@@ -7563,17 +7572,23 @@ async function handleCsvRenderStart(options) {
   }
   ensureCsvRenderStateDir();
   const logPath = csvRenderLogPath();
+  const logFd = openSync(logPath, "w");
   const token = randomUUID();
-  const child = spawn(process.execPath, ["-e", CSV_RENDER_SERVER_SOURCE], {
-    detached: true,
-    stdio: ["ignore", "ignore", "ignore"],
-    env: {
-      ...process.env,
-      DEEPLINE_CSV_RENDER_PORT: String(port),
-      DEEPLINE_CSV_RENDER_CSV: csvPath,
-      DEEPLINE_CSV_RENDER_TOKEN: token
+  const child = spawn(
+    process.execPath,
+    ["-e", CSV_RENDER_SERVER_SOURCE],
+    {
+      detached: true,
+      stdio: ["ignore", logFd, logFd],
+      env: {
+        ...process.env,
+        DEEPLINE_CSV_RENDER_PORT: String(port),
+        DEEPLINE_CSV_RENDER_CSV: csvPath,
+        DEEPLINE_CSV_RENDER_TOKEN: token
+      }
     }
-  });
+  );
+  closeSync(logFd);
   child.unref();
   const state = {
     pid: child.pid ?? null,
@@ -7589,7 +7604,19 @@ async function handleCsvRenderStart(options) {
     if (processAlive(child.pid)) {
       process.kill(child.pid, "SIGTERM");
     }
-    throw new Error(`Timed out waiting for CSV render to start at ${url}.`);
+    let detail = "";
+    try {
+      const log = readFileSync6(logPath, "utf8").trim();
+      if (log) {
+        detail = `
+CSV render log:
+${clip(log, 2e3)}`;
+      }
+    } catch {
+    }
+    throw new Error(
+      `Timed out waiting for CSV render to start at ${url}.${detail}`
+    );
   }
   writeCsvRenderState(state);
   writeFileSync6(
@@ -8155,8 +8182,8 @@ import { parse as parseCsvSync2 } from "csv-parse/sync";
 
 // src/cli/commands/plays/bootstrap.ts
 import {
-  closeSync,
-  openSync,
+  closeSync as closeSync2,
+  openSync as openSync2,
   readSync,
   statSync as statSync2,
   writeFileSync as writeFileSync8
@@ -8734,11 +8761,11 @@ function inferCsvColumnSpecs(headers, rows) {
 function readCsvSample(csvPath) {
   const resolvedPath = resolve7(csvPath);
   const size = statSync2(resolvedPath).size;
-  const fd = openSync(resolvedPath, "r");
+  const fd = openSync2(resolvedPath, "r");
   const byteLength = Math.min(size, CSV_HEADER_SAMPLE_BYTES);
   const buffer = Buffer.alloc(byteLength);
   const bytesRead = readSync(fd, buffer, 0, byteLength, 0);
-  closeSync(fd);
+  closeSync2(fd);
   if (bytesRead === 0) {
     throw new PlayBootstrapUsageError(`--from csv:${csvPath} is empty.`);
   }
@@ -19387,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) {
@@ -21229,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;
@@ -24354,9 +24407,9 @@ import { join as join11, resolve as resolve11 } from "path";
 
 // src/tool-output.ts
 import {
-  closeSync as closeSync2,
+  closeSync as closeSync3,
   mkdirSync as mkdirSync8,
-  openSync as openSync2,
+  openSync as openSync3,
   writeFileSync as writeFileSync12,
   writeSync
 } from "fs";
@@ -24509,7 +24562,7 @@ function writeCsvOutputFile(rows, stem, options) {
     }
     return normalized;
   };
-  const fd = openSync2(outputPath, "w");
+  const fd = openSync3(outputPath, "w");
   try {
     writeSync(fd, `${columns.map(escapeCell).join(",")}
 `);
@@ -24521,7 +24574,7 @@ function writeCsvOutputFile(rows, stem, options) {
       );
     }
   } finally {
-    closeSync2(fd);
+    closeSync3(fd);
   }
   const previewRows = rows.slice(0, 5);
   const previewColumns = columns.slice(0, 5);

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.190",
+  version: "0.1.192",
   apiContract: "2026-06-dataset-handle-results-hard-cutover",
   supportPolicy: {
-    latest: "0.1.190",
+    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.190",
+  version: "0.1.192",
   apiContract: "2026-06-dataset-handle-results-hard-cutover",
   supportPolicy: {
-    latest: "0.1.190",
+    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.190",
+  "version": "0.1.192",
   "description": "Deepline SDK + CLI — B2B data enrichment powered by durable cloud execution",
   "license": "MIT",
   "repository": {