deepline 0.1.189 → 0.1.191

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

@@ -1393,6 +1393,13 @@ function isRetryableRuntimeApiError(error: unknown): boolean {
   );
 }
 
+function isRetryableRuntimePersistenceError(error: unknown): boolean {
+  const message = error instanceof Error ? error.message : String(error);
+  return /deadlock detected|Runtime Postgres connection timed out|could not serialize access|tuple concurrently updated/i.test(
+    message,
+  );
+}
+
 function isRetryableRuntimeApiResponse(status: number, body: string): boolean {
   if (
     status === 408 ||
@@ -4495,6 +4502,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 +5776,13 @@ function createMinimalWorkerCtx(
           },
         });
       } catch (error) {
+        if (
+          workflowStep &&
+          !mapHasExternalSideEffects &&
+          isRetryableRuntimePersistenceError(error)
+        ) {
+          throw error;
+        }
         tripRuntimePersistenceLatch(persistenceLatch, error);
         recordRunnerPerfTrace({
           req,

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.189',
+  version: '0.1.191',
   apiContract: '2026-06-dataset-handle-results-hard-cutover',
   supportPolicy: {
-    latest: '0.1.189',
+    latest: '0.1.191',
     minimumSupported: '0.1.53',
     deprecatedBelow: '0.1.53',
     commandMinimumSupported: [

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.189",
+  version: "0.1.191",
   apiContract: "2026-06-dataset-handle-results-hard-cutover",
   supportPolicy: {
-    latest: "0.1.189",
+    latest: "0.1.191",
     minimumSupported: "0.1.53",
     deprecatedBelow: "0.1.53",
     commandMinimumSupported: [
@@ -4829,14 +4829,64 @@ function readCsvRows(csvPath) {
   });
 }
 function csvStringFromRows(rows, columns) {
-  return (0, import_sync2.stringify)(rows, {
+  return (0, import_sync2.stringify)(rows.map(csvSafeRow), {
     header: true,
     cast: {
-      boolean: (value) => value ? "true" : "false"
+      boolean: (value) => value ? "true" : "false",
+      object: (value) => {
+        const cell = csvSafeCell(value);
+        return typeof cell === "string" ? cell : null;
+      }
     },
     ...columns?.length ? { columns } : {}
   });
 }
+function csvSafeRow(row) {
+  return Object.fromEntries(
+    Object.entries(row).map(([key, value]) => [key, csvSafeCell(value)])
+  );
+}
+function csvSafeCell(value) {
+  if (value === void 0) {
+    return null;
+  }
+  if (value === null) {
+    return null;
+  }
+  if (typeof value === "bigint") {
+    return value.toString();
+  }
+  if (typeof value === "string" || typeof value === "number" || typeof value === "boolean") {
+    return value;
+  }
+  if (value instanceof Date) {
+    return value.toISOString();
+  }
+  if (typeof value === "symbol" || typeof value === "function") {
+    return null;
+  }
+  if (typeof value !== "object") {
+    return String(value);
+  }
+  return csvSafeJsonString(value);
+}
+function csvSafeJsonReplacer(_key, nested) {
+  if (typeof nested === "bigint") {
+    return nested.toString();
+  }
+  if (nested === void 0 || typeof nested === "symbol" || typeof nested === "function") {
+    return null;
+  }
+  return nested;
+}
+function csvSafeJsonString(value) {
+  try {
+    const serialized = JSON.stringify(value, csvSafeJsonReplacer);
+    return serialized ?? null;
+  } catch {
+    return String(value);
+  }
+}
 function parseMaybeJsonObject(value) {
   if (typeof value !== "string") {
     return value;
@@ -4877,14 +4927,14 @@ function flattenObjectColumns(row, options = {}) {
     const value = parseMaybeJsonObject(rawValue);
     const parsedFromString = typeof rawValue === "string" && value !== rawValue;
     if (key === "_metadata") {
-      flattened[key] = value && typeof value === "object" ? JSON.stringify(value) : value;
+      flattened[key] = value && typeof value === "object" ? csvSafeJsonString(value) : value;
       continue;
     }
     if (value && typeof value === "object" && !Array.isArray(value)) {
       const record = value;
       const hasMatchedEnvelope = Object.prototype.hasOwnProperty.call(record, "matched_result") || Object.prototype.hasOwnProperty.call(record, "matchedResult");
       if (hasMatchedEnvelope) {
-        flattened[key] = JSON.stringify(record);
+        flattened[key] = csvSafeJsonString(record);
         continue;
       }
       if (parsedFromString && shouldPreserveJsonStringColumn(options.preserveJsonStringColumns, key)) {
@@ -4896,16 +4946,16 @@ function flattenObjectColumns(row, options = {}) {
           flattened[key] = failureMessage;
           continue;
         } else if (Object.prototype.hasOwnProperty.call(record, "result")) {
-          flattened[key] = JSON.stringify(record);
+          flattened[key] = csvSafeJsonString(record);
           continue;
         }
       }
       for (const [nestedKey, nestedValue] of Object.entries(record)) {
-        flattened[`${key}.${nestedKey}`] = nestedValue && typeof nestedValue === "object" ? JSON.stringify(nestedValue) : nestedValue;
+        flattened[`${key}.${nestedKey}`] = nestedValue && typeof nestedValue === "object" ? csvSafeJsonString(nestedValue) : nestedValue;
       }
       continue;
     }
-    flattened[key] = Array.isArray(value) ? JSON.stringify(value) : value;
+    flattened[key] = Array.isArray(value) ? csvSafeJsonString(value) : value;
   }
   return flattened;
 }
@@ -7393,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;
@@ -7455,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)));
 `;
@@ -7510,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,
@@ -7536,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)(
@@ -16968,16 +17043,39 @@ function helperSource() {
     ``,
     `function __dlGetByPath(root: unknown, path: string): unknown {`,
     `  let cursor = root;`,
-    `  for (const part of __dlPathParts(path)) {`,
+    `  const parts = __dlPathParts(path);`,
+    `  for (let index = 0; index < parts.length; index += 1) {`,
+    `    const part = parts[index] || '';`,
+    `    cursor = __dlParseJsonContainer(cursor);`,
     `    if (!cursor || typeof cursor !== 'object') return undefined;`,
     `    const record = cursor as Record<string, unknown>;`,
-    `    const field = __dlGetRecordField(record, part);`,
+    `    let field = { found: false, value: undefined as unknown };`,
+    `    for (let end = parts.length; end > index + 1; end -= 1) {`,
+    `      const dottedPart = parts.slice(index, end).join('.');`,
+    `      field = __dlGetRecordField(record, dottedPart);`,
+    `      if (field.found) {`,
+    `        index = end - 1;`,
+    `        break;`,
+    `      }`,
+    `    }`,
+    `    if (!field.found) field = __dlGetRecordField(record, part);`,
     `    if (!field.found) return undefined;`,
     `    cursor = field.value;`,
     `  }`,
     `  return cursor;`,
     `}`,
     ``,
+    `function __dlParseJsonContainer(value: unknown): unknown {`,
+    `  if (typeof value !== 'string') return value;`,
+    `  const trimmed = value.trim();`,
+    `  if ((!trimmed.startsWith('{') || !trimmed.endsWith('}')) && (!trimmed.startsWith('[') || !trimmed.endsWith(']'))) return value;`,
+    `  try {`,
+    `    return JSON.parse(trimmed);`,
+    `  } catch {`,
+    `    return value;`,
+    `  }`,
+    `}`,
+    ``,
     `function __dlMeaningful(value: unknown): boolean {`,
     `  if (value && typeof value === 'object' && !Array.isArray(value)) {`,
     `    const record = value as Record<string, unknown>;`,
@@ -19998,6 +20096,12 @@ function sidecarEnrichRowsExportPath(outputPath) {
   const stem = (0, import_node_path12.basename)(resolved, ext);
   return (0, import_node_path12.join)((0, import_node_path12.dirname)(resolved), `${stem}.deepline-enrich-rows${ext}`);
 }
+function sidecarEnrichBatchManifestPath(outputPath) {
+  const resolved = (0, import_node_path12.resolve)(outputPath);
+  const ext = (0, import_node_path12.extname)(resolved) || ".csv";
+  const stem = (0, import_node_path12.basename)(resolved, ext);
+  return (0, import_node_path12.join)((0, import_node_path12.dirname)(resolved), `${stem}.deepline-enrich-batches.json`);
+}
 function collectDatasetFollowUpCommands(value, state) {
   if (state.depth > 12 || !value || typeof value !== "object" || state.commands.length >= 8) {
     return;
@@ -20503,7 +20607,7 @@ var ENRICH_FLATTENED_CONTROL_FIELDS = /* @__PURE__ */ new Set([
 ]);
 function materializeCsvCellValue(value) {
   if (value && typeof value === "object") {
-    return JSON.stringify(value);
+    return csvSafeJsonString(value);
   }
   return value;
 }
@@ -20905,13 +21009,35 @@ function registerEnrichCommand(program) {
     const inPlaceCommitOutputPath = options.inPlace ? (await (0, import_promises3.lstat)(inputCsv)).isSymbolicLink() ? await (0, import_promises3.realpath)(inputCsv) : inPlaceFinalOutputPath : null;
     const failureReportOutputPath = options.inPlace ? inPlaceFinalOutputPath : null;
     const enrichIssueFollowUpOutputPath = options.inPlace && inPlaceFinalOutputPath ? sidecarEnrichRowsExportPath(inPlaceFinalOutputPath) : null;
-    let inPlaceCommitted = false;
+    const prepareInPlaceOutput = async () => {
+      if (!options.inPlace) {
+        return;
+      }
+      if (inPlaceTempDir) {
+        await (0, import_promises3.rm)(inPlaceTempDir, { recursive: true, force: true });
+      }
+      inPlaceTempDir = await (0, import_promises3.mkdtemp)(
+        (0, import_node_path12.join)(
+          (0, import_node_path12.dirname)(inPlaceCommitOutputPath ?? (0, import_node_path12.resolve)(inputCsv)),
+          ".deepline-enrich-in-place-"
+        )
+      );
+      inPlaceTempOutputPath = (0, import_node_path12.join)(inPlaceTempDir, "output.csv");
+      await (0, import_promises3.copyFile)((0, import_node_path12.resolve)(inputCsv), inPlaceTempOutputPath);
+      outputPath = inPlaceTempOutputPath;
+    };
     const commitInPlaceOutput = async (exportResult) => {
       if (!inPlaceTempOutputPath || !inPlaceCommitOutputPath || !inPlaceFinalOutputPath) {
         return exportResult;
       }
+      const committedTempDir = inPlaceTempDir;
       await (0, import_promises3.rename)(inPlaceTempOutputPath, inPlaceCommitOutputPath);
-      inPlaceCommitted = true;
+      inPlaceTempDir = null;
+      inPlaceTempOutputPath = null;
+      outputPath = inPlaceFinalOutputPath;
+      if (committedTempDir) {
+        await (0, import_promises3.rm)(committedTempDir, { recursive: true, force: true });
+      }
       if (!exportResult) {
         return null;
       }
@@ -20923,15 +21049,7 @@ function registerEnrichCommand(program) {
     try {
       await (0, import_promises3.writeFile)(tempPlay, playSource, "utf8");
       if (options.inPlace) {
-        inPlaceTempDir = await (0, import_promises3.mkdtemp)(
-          (0, import_node_path12.join)(
-            (0, import_node_path12.dirname)(inPlaceCommitOutputPath ?? (0, import_node_path12.resolve)(inputCsv)),
-            ".deepline-enrich-in-place-"
-          )
-        );
-        inPlaceTempOutputPath = (0, import_node_path12.join)(inPlaceTempDir, "output.csv");
-        await (0, import_promises3.copyFile)((0, import_node_path12.resolve)(inputCsv), inPlaceTempOutputPath);
-        outputPath = inPlaceTempOutputPath;
+        await prepareInPlaceOutput();
       }
       const runOne = async (input2) => {
         const runtimeInput = {
@@ -20986,12 +21104,62 @@ function registerEnrichCommand(program) {
       const autoBatchRows = enrichAutoBatchRowsForConfig(config);
       if (outputPath && selectedRange.count > autoBatchRows) {
         const chunkCount = Math.ceil(selectedRange.count / autoBatchRows);
+        const batchManifestPath = sidecarEnrichBatchManifestPath(
+          inPlaceFinalOutputPath ?? (0, import_node_path12.resolve)(outputPath)
+        );
+        const batchManifest = {
+          version: 1,
+          kind: "deepline_enrich_batch_manifest",
+          input: (0, import_node_path12.resolve)(inputCsv),
+          output: inPlaceFinalOutputPath ?? (0, import_node_path12.resolve)(outputPath),
+          selectedRows: selectedRange.count,
+          sourceCsvRows: selectedRange.sourceRows,
+          chunkRows: autoBatchRows,
+          chunks: chunkCount,
+          updatedAt: (/* @__PURE__ */ new Date()).toISOString(),
+          batches: []
+        };
+        const writeBatchManifest = async () => {
+          batchManifest.updatedAt = (/* @__PURE__ */ new Date()).toISOString();
+          await (0, import_promises3.writeFile)(
+            batchManifestPath,
+            `${JSON.stringify(batchManifest, null, 2)}
+`,
+            "utf8"
+          );
+        };
+        const appendBatchManifestEntry = async (input2) => {
+          const runId = extractRunId(input2.status) ?? firstCollectedStringField(input2.status, "runId");
+          batchManifest.batches.push({
+            chunk: input2.chunkIndex + 1,
+            chunks: chunkCount,
+            rows: {
+              rowStart: input2.rows.rowStart,
+              rowEnd: input2.rows.rowEnd
+            },
+            status: readEnrichRunStatus(input2.status),
+            runId,
+            customer_db: enrichCustomerDbJson({
+              status: input2.status,
+              client: client2,
+              outputPath: enrichIssueFollowUpOutputPath ?? input2.exportResult?.path ?? outputPath
+            }),
+            output: enrichOutputJson(input2.exportResult),
+            completedAt: (/* @__PURE__ */ new Date()).toISOString()
+          });
+          await writeBatchManifest();
+        };
+        await writeBatchManifest();
         if (!options.json) {
           process.stderr.write(
             `Large enrich input selected ${selectedRange.count.toLocaleString()} rows. Running ${chunkCount.toLocaleString()} sequential batch runs of up to ${autoBatchRows.toLocaleString()} rows and merging ${(0, import_node_path12.resolve)(outputPath)}.
 `
           );
         }
+        process.stderr.write(
+          `Batch recovery manifest: ${batchManifestPath}
+`
+        );
         let workingMergeSourceCsvPath = sourceCsvPath;
         let lastStatus = null;
         const batchStatuses = [];
@@ -21034,6 +21202,7 @@ function registerEnrichCommand(program) {
           lastStatus = chunk.status;
           batchStatuses.push(chunk.status);
           if (chunk.captured.result !== 0) {
+            let currentChunkCommittedExportResult = null;
             if (chunk.exportResult) {
               finalExportResult = chunk.exportResult;
               totalEnrichedRows += countEnrichedRowsInSourceRange(
@@ -21057,37 +21226,48 @@ function registerEnrichCommand(program) {
               waterfallStatus: batchStatuses,
               ...finalExportResult ? { rowSetComplete: !finalExportResult.partial } : {}
             });
-            const committedExportResult2 = finalExportResult ? await commitInPlaceOutput(finalExportResult) : null;
+            if (chunk.exportResult) {
+              currentChunkCommittedExportResult = await commitInPlaceOutput(chunk.exportResult);
+              finalExportResult = currentChunkCommittedExportResult;
+            }
+            const reportedExportResult = currentChunkCommittedExportResult ?? finalExportResult;
+            await appendBatchManifestEntry({
+              chunkIndex,
+              rows: chunkRows,
+              status: chunk.status,
+              exportResult: currentChunkCommittedExportResult
+            });
             if (options.json) {
               printJson({
                 ok: false,
                 batch: {
                   chunk: chunkIndex + 1,
                   chunks: chunkCount,
-                  rows: chunkRows
+                  rows: chunkRows,
+                  manifest: batchManifestPath
                 },
                 result: chunk.status,
-                output: committedExportResult2 ? {
+                output: reportedExportResult ? {
                   sourceCsvRows: selectedRange.sourceRows,
                   selectedRows: selectedRange.count,
                   enrichedRows: totalEnrichedRows,
-                  path: committedExportResult2.path,
-                  ...committedExportResult2.partial ? {
-                    rows: committedExportResult2.rows,
+                  path: reportedExportResult.path,
+                  ...reportedExportResult.partial ? {
+                    rows: reportedExportResult.rows,
                     partial: true
                   } : {}
                 } : null,
                 customer_db: enrichCustomerDbJson({
                   status: chunk.status,
                   client: client2,
-                  outputPath: enrichIssueFollowUpOutputPath ?? committedExportResult2?.path ?? outputPath
+                  outputPath: enrichIssueFollowUpOutputPath ?? reportedExportResult?.path ?? outputPath
                 }),
                 ...enrichReportJson(failureReport3)
               });
             } else {
-              if (committedExportResult2) {
+              if (reportedExportResult) {
                 process.stderr.write(
-                  `Wrote ${committedExportResult2.rows} row(s) to ${committedExportResult2.path}${committedExportResult2.partial ? " (partial run output)" : ""}
+                  `Wrote ${reportedExportResult.rows} row(s) to ${reportedExportResult.path}${reportedExportResult.partial ? " (partial run output)" : ""}
 `
                 );
               }
@@ -21102,13 +21282,22 @@ function registerEnrichCommand(program) {
             return;
           }
           if (chunk.exportResult) {
-            finalExportResult = chunk.exportResult;
             totalEnrichedRows += countEnrichedRowsInSourceRange(
               chunk.exportResult,
               chunkRows
             );
             batchFailureRows.push(...chunk.exportResult.enrichedDataRows);
+            finalExportResult = options.inPlace ? await commitInPlaceOutput(chunk.exportResult) : chunk.exportResult;
+            await appendBatchManifestEntry({
+              chunkIndex,
+              rows: chunkRows,
+              status: chunk.status,
+              exportResult: finalExportResult
+            });
             workingMergeSourceCsvPath = outputPath;
+            if (options.inPlace && (chunkRows.rowEnd ?? selectedRange.end) < selectedRange.end) {
+              await prepareInPlaceOutput();
+            }
           }
         }
         const outputRows = readCsvRows(outputPath);
@@ -21148,7 +21337,8 @@ function registerEnrichCommand(program) {
             batch: {
               chunks: chunkCount,
               chunkRows: autoBatchRows,
-              selectedRows: selectedRange.count
+              selectedRows: selectedRange.count,
+              manifest: batchManifestPath
             },
             output: finalExportResult ? {
               sourceCsvRows: selectedRange.sourceRows,
@@ -21278,7 +21468,7 @@ function registerEnrichCommand(program) {
     } finally {
       if (inPlaceTempDir) {
         await (0, import_promises3.rm)(inPlaceTempDir, { recursive: true, force: true });
-      } else if (inPlaceTempOutputPath && !inPlaceCommitted) {
+      } else if (inPlaceTempOutputPath) {
         await (0, import_promises3.rm)(inPlaceTempOutputPath, { force: true });
       }
       await (0, import_promises3.rm)(tempDir, { recursive: true, force: true });

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.189",
+  version: "0.1.191",
   apiContract: "2026-06-dataset-handle-results-hard-cutover",
   supportPolicy: {
-    latest: "0.1.189",
+    latest: "0.1.191",
     minimumSupported: "0.1.53",
     deprecatedBelow: "0.1.53",
     commandMinimumSupported: [
@@ -4826,14 +4826,64 @@ function readCsvRows(csvPath) {
   });
 }
 function csvStringFromRows(rows, columns) {
-  return stringify(rows, {
+  return stringify(rows.map(csvSafeRow), {
     header: true,
     cast: {
-      boolean: (value) => value ? "true" : "false"
+      boolean: (value) => value ? "true" : "false",
+      object: (value) => {
+        const cell = csvSafeCell(value);
+        return typeof cell === "string" ? cell : null;
+      }
     },
     ...columns?.length ? { columns } : {}
   });
 }
+function csvSafeRow(row) {
+  return Object.fromEntries(
+    Object.entries(row).map(([key, value]) => [key, csvSafeCell(value)])
+  );
+}
+function csvSafeCell(value) {
+  if (value === void 0) {
+    return null;
+  }
+  if (value === null) {
+    return null;
+  }
+  if (typeof value === "bigint") {
+    return value.toString();
+  }
+  if (typeof value === "string" || typeof value === "number" || typeof value === "boolean") {
+    return value;
+  }
+  if (value instanceof Date) {
+    return value.toISOString();
+  }
+  if (typeof value === "symbol" || typeof value === "function") {
+    return null;
+  }
+  if (typeof value !== "object") {
+    return String(value);
+  }
+  return csvSafeJsonString(value);
+}
+function csvSafeJsonReplacer(_key, nested) {
+  if (typeof nested === "bigint") {
+    return nested.toString();
+  }
+  if (nested === void 0 || typeof nested === "symbol" || typeof nested === "function") {
+    return null;
+  }
+  return nested;
+}
+function csvSafeJsonString(value) {
+  try {
+    const serialized = JSON.stringify(value, csvSafeJsonReplacer);
+    return serialized ?? null;
+  } catch {
+    return String(value);
+  }
+}
 function parseMaybeJsonObject(value) {
   if (typeof value !== "string") {
     return value;
@@ -4874,14 +4924,14 @@ function flattenObjectColumns(row, options = {}) {
     const value = parseMaybeJsonObject(rawValue);
     const parsedFromString = typeof rawValue === "string" && value !== rawValue;
     if (key === "_metadata") {
-      flattened[key] = value && typeof value === "object" ? JSON.stringify(value) : value;
+      flattened[key] = value && typeof value === "object" ? csvSafeJsonString(value) : value;
       continue;
     }
     if (value && typeof value === "object" && !Array.isArray(value)) {
       const record = value;
       const hasMatchedEnvelope = Object.prototype.hasOwnProperty.call(record, "matched_result") || Object.prototype.hasOwnProperty.call(record, "matchedResult");
       if (hasMatchedEnvelope) {
-        flattened[key] = JSON.stringify(record);
+        flattened[key] = csvSafeJsonString(record);
         continue;
       }
       if (parsedFromString && shouldPreserveJsonStringColumn(options.preserveJsonStringColumns, key)) {
@@ -4893,16 +4943,16 @@ function flattenObjectColumns(row, options = {}) {
           flattened[key] = failureMessage;
           continue;
         } else if (Object.prototype.hasOwnProperty.call(record, "result")) {
-          flattened[key] = JSON.stringify(record);
+          flattened[key] = csvSafeJsonString(record);
           continue;
         }
       }
       for (const [nestedKey, nestedValue] of Object.entries(record)) {
-        flattened[`${key}.${nestedKey}`] = nestedValue && typeof nestedValue === "object" ? JSON.stringify(nestedValue) : nestedValue;
+        flattened[`${key}.${nestedKey}`] = nestedValue && typeof nestedValue === "object" ? csvSafeJsonString(nestedValue) : nestedValue;
       }
       continue;
     }
-    flattened[key] = Array.isArray(value) ? JSON.stringify(value) : value;
+    flattened[key] = Array.isArray(value) ? csvSafeJsonString(value) : value;
   }
   return flattened;
 }
@@ -6620,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
@@ -7396,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;
@@ -7458,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)));
 `;
@@ -7513,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,
@@ -7539,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(
@@ -8105,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
@@ -8684,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.`);
   }
@@ -16995,16 +17072,39 @@ function helperSource() {
     ``,
     `function __dlGetByPath(root: unknown, path: string): unknown {`,
     `  let cursor = root;`,
-    `  for (const part of __dlPathParts(path)) {`,
+    `  const parts = __dlPathParts(path);`,
+    `  for (let index = 0; index < parts.length; index += 1) {`,
+    `    const part = parts[index] || '';`,
+    `    cursor = __dlParseJsonContainer(cursor);`,
     `    if (!cursor || typeof cursor !== 'object') return undefined;`,
     `    const record = cursor as Record<string, unknown>;`,
-    `    const field = __dlGetRecordField(record, part);`,
+    `    let field = { found: false, value: undefined as unknown };`,
+    `    for (let end = parts.length; end > index + 1; end -= 1) {`,
+    `      const dottedPart = parts.slice(index, end).join('.');`,
+    `      field = __dlGetRecordField(record, dottedPart);`,
+    `      if (field.found) {`,
+    `        index = end - 1;`,
+    `        break;`,
+    `      }`,
+    `    }`,
+    `    if (!field.found) field = __dlGetRecordField(record, part);`,
     `    if (!field.found) return undefined;`,
     `    cursor = field.value;`,
     `  }`,
     `  return cursor;`,
     `}`,
     ``,
+    `function __dlParseJsonContainer(value: unknown): unknown {`,
+    `  if (typeof value !== 'string') return value;`,
+    `  const trimmed = value.trim();`,
+    `  if ((!trimmed.startsWith('{') || !trimmed.endsWith('}')) && (!trimmed.startsWith('[') || !trimmed.endsWith(']'))) return value;`,
+    `  try {`,
+    `    return JSON.parse(trimmed);`,
+    `  } catch {`,
+    `    return value;`,
+    `  }`,
+    `}`,
+    ``,
     `function __dlMeaningful(value: unknown): boolean {`,
     `  if (value && typeof value === 'object' && !Array.isArray(value)) {`,
     `    const record = value as Record<string, unknown>;`,
@@ -20025,6 +20125,12 @@ function sidecarEnrichRowsExportPath(outputPath) {
   const stem = basename2(resolved, ext);
   return join7(dirname7(resolved), `${stem}.deepline-enrich-rows${ext}`);
 }
+function sidecarEnrichBatchManifestPath(outputPath) {
+  const resolved = resolve9(outputPath);
+  const ext = extname(resolved) || ".csv";
+  const stem = basename2(resolved, ext);
+  return join7(dirname7(resolved), `${stem}.deepline-enrich-batches.json`);
+}
 function collectDatasetFollowUpCommands(value, state) {
   if (state.depth > 12 || !value || typeof value !== "object" || state.commands.length >= 8) {
     return;
@@ -20530,7 +20636,7 @@ var ENRICH_FLATTENED_CONTROL_FIELDS = /* @__PURE__ */ new Set([
 ]);
 function materializeCsvCellValue(value) {
   if (value && typeof value === "object") {
-    return JSON.stringify(value);
+    return csvSafeJsonString(value);
   }
   return value;
 }
@@ -20932,13 +21038,35 @@ function registerEnrichCommand(program) {
     const inPlaceCommitOutputPath = options.inPlace ? (await lstat(inputCsv)).isSymbolicLink() ? await realpath(inputCsv) : inPlaceFinalOutputPath : null;
     const failureReportOutputPath = options.inPlace ? inPlaceFinalOutputPath : null;
     const enrichIssueFollowUpOutputPath = options.inPlace && inPlaceFinalOutputPath ? sidecarEnrichRowsExportPath(inPlaceFinalOutputPath) : null;
-    let inPlaceCommitted = false;
+    const prepareInPlaceOutput = async () => {
+      if (!options.inPlace) {
+        return;
+      }
+      if (inPlaceTempDir) {
+        await rm(inPlaceTempDir, { recursive: true, force: true });
+      }
+      inPlaceTempDir = await mkdtemp(
+        join7(
+          dirname7(inPlaceCommitOutputPath ?? resolve9(inputCsv)),
+          ".deepline-enrich-in-place-"
+        )
+      );
+      inPlaceTempOutputPath = join7(inPlaceTempDir, "output.csv");
+      await copyFile(resolve9(inputCsv), inPlaceTempOutputPath);
+      outputPath = inPlaceTempOutputPath;
+    };
     const commitInPlaceOutput = async (exportResult) => {
       if (!inPlaceTempOutputPath || !inPlaceCommitOutputPath || !inPlaceFinalOutputPath) {
         return exportResult;
       }
+      const committedTempDir = inPlaceTempDir;
       await rename(inPlaceTempOutputPath, inPlaceCommitOutputPath);
-      inPlaceCommitted = true;
+      inPlaceTempDir = null;
+      inPlaceTempOutputPath = null;
+      outputPath = inPlaceFinalOutputPath;
+      if (committedTempDir) {
+        await rm(committedTempDir, { recursive: true, force: true });
+      }
       if (!exportResult) {
         return null;
       }
@@ -20950,15 +21078,7 @@ function registerEnrichCommand(program) {
     try {
       await writeFile3(tempPlay, playSource, "utf8");
       if (options.inPlace) {
-        inPlaceTempDir = await mkdtemp(
-          join7(
-            dirname7(inPlaceCommitOutputPath ?? resolve9(inputCsv)),
-            ".deepline-enrich-in-place-"
-          )
-        );
-        inPlaceTempOutputPath = join7(inPlaceTempDir, "output.csv");
-        await copyFile(resolve9(inputCsv), inPlaceTempOutputPath);
-        outputPath = inPlaceTempOutputPath;
+        await prepareInPlaceOutput();
       }
       const runOne = async (input2) => {
         const runtimeInput = {
@@ -21013,12 +21133,62 @@ function registerEnrichCommand(program) {
       const autoBatchRows = enrichAutoBatchRowsForConfig(config);
       if (outputPath && selectedRange.count > autoBatchRows) {
         const chunkCount = Math.ceil(selectedRange.count / autoBatchRows);
+        const batchManifestPath = sidecarEnrichBatchManifestPath(
+          inPlaceFinalOutputPath ?? resolve9(outputPath)
+        );
+        const batchManifest = {
+          version: 1,
+          kind: "deepline_enrich_batch_manifest",
+          input: resolve9(inputCsv),
+          output: inPlaceFinalOutputPath ?? resolve9(outputPath),
+          selectedRows: selectedRange.count,
+          sourceCsvRows: selectedRange.sourceRows,
+          chunkRows: autoBatchRows,
+          chunks: chunkCount,
+          updatedAt: (/* @__PURE__ */ new Date()).toISOString(),
+          batches: []
+        };
+        const writeBatchManifest = async () => {
+          batchManifest.updatedAt = (/* @__PURE__ */ new Date()).toISOString();
+          await writeFile3(
+            batchManifestPath,
+            `${JSON.stringify(batchManifest, null, 2)}
+`,
+            "utf8"
+          );
+        };
+        const appendBatchManifestEntry = async (input2) => {
+          const runId = extractRunId(input2.status) ?? firstCollectedStringField(input2.status, "runId");
+          batchManifest.batches.push({
+            chunk: input2.chunkIndex + 1,
+            chunks: chunkCount,
+            rows: {
+              rowStart: input2.rows.rowStart,
+              rowEnd: input2.rows.rowEnd
+            },
+            status: readEnrichRunStatus(input2.status),
+            runId,
+            customer_db: enrichCustomerDbJson({
+              status: input2.status,
+              client: client2,
+              outputPath: enrichIssueFollowUpOutputPath ?? input2.exportResult?.path ?? outputPath
+            }),
+            output: enrichOutputJson(input2.exportResult),
+            completedAt: (/* @__PURE__ */ new Date()).toISOString()
+          });
+          await writeBatchManifest();
+        };
+        await writeBatchManifest();
         if (!options.json) {
           process.stderr.write(
             `Large enrich input selected ${selectedRange.count.toLocaleString()} rows. Running ${chunkCount.toLocaleString()} sequential batch runs of up to ${autoBatchRows.toLocaleString()} rows and merging ${resolve9(outputPath)}.
 `
           );
         }
+        process.stderr.write(
+          `Batch recovery manifest: ${batchManifestPath}
+`
+        );
         let workingMergeSourceCsvPath = sourceCsvPath;
         let lastStatus = null;
         const batchStatuses = [];
@@ -21061,6 +21231,7 @@ function registerEnrichCommand(program) {
           lastStatus = chunk.status;
           batchStatuses.push(chunk.status);
           if (chunk.captured.result !== 0) {
+            let currentChunkCommittedExportResult = null;
             if (chunk.exportResult) {
               finalExportResult = chunk.exportResult;
               totalEnrichedRows += countEnrichedRowsInSourceRange(
@@ -21084,37 +21255,48 @@ function registerEnrichCommand(program) {
               waterfallStatus: batchStatuses,
               ...finalExportResult ? { rowSetComplete: !finalExportResult.partial } : {}
             });
-            const committedExportResult2 = finalExportResult ? await commitInPlaceOutput(finalExportResult) : null;
+            if (chunk.exportResult) {
+              currentChunkCommittedExportResult = await commitInPlaceOutput(chunk.exportResult);
+              finalExportResult = currentChunkCommittedExportResult;
+            }
+            const reportedExportResult = currentChunkCommittedExportResult ?? finalExportResult;
+            await appendBatchManifestEntry({
+              chunkIndex,
+              rows: chunkRows,
+              status: chunk.status,
+              exportResult: currentChunkCommittedExportResult
+            });
             if (options.json) {
               printJson({
                 ok: false,
                 batch: {
                   chunk: chunkIndex + 1,
                   chunks: chunkCount,
-                  rows: chunkRows
+                  rows: chunkRows,
+                  manifest: batchManifestPath
                 },
                 result: chunk.status,
-                output: committedExportResult2 ? {
+                output: reportedExportResult ? {
                   sourceCsvRows: selectedRange.sourceRows,
                   selectedRows: selectedRange.count,
                   enrichedRows: totalEnrichedRows,
-                  path: committedExportResult2.path,
-                  ...committedExportResult2.partial ? {
-                    rows: committedExportResult2.rows,
+                  path: reportedExportResult.path,
+                  ...reportedExportResult.partial ? {
+                    rows: reportedExportResult.rows,
                     partial: true
                   } : {}
                 } : null,
                 customer_db: enrichCustomerDbJson({
                   status: chunk.status,
                   client: client2,
-                  outputPath: enrichIssueFollowUpOutputPath ?? committedExportResult2?.path ?? outputPath
+                  outputPath: enrichIssueFollowUpOutputPath ?? reportedExportResult?.path ?? outputPath
                 }),
                 ...enrichReportJson(failureReport3)
               });
             } else {
-              if (committedExportResult2) {
+              if (reportedExportResult) {
                 process.stderr.write(
-                  `Wrote ${committedExportResult2.rows} row(s) to ${committedExportResult2.path}${committedExportResult2.partial ? " (partial run output)" : ""}
+                  `Wrote ${reportedExportResult.rows} row(s) to ${reportedExportResult.path}${reportedExportResult.partial ? " (partial run output)" : ""}
 `
                 );
               }
@@ -21129,13 +21311,22 @@ function registerEnrichCommand(program) {
             return;
           }
           if (chunk.exportResult) {
-            finalExportResult = chunk.exportResult;
             totalEnrichedRows += countEnrichedRowsInSourceRange(
               chunk.exportResult,
               chunkRows
             );
             batchFailureRows.push(...chunk.exportResult.enrichedDataRows);
+            finalExportResult = options.inPlace ? await commitInPlaceOutput(chunk.exportResult) : chunk.exportResult;
+            await appendBatchManifestEntry({
+              chunkIndex,
+              rows: chunkRows,
+              status: chunk.status,
+              exportResult: finalExportResult
+            });
             workingMergeSourceCsvPath = outputPath;
+            if (options.inPlace && (chunkRows.rowEnd ?? selectedRange.end) < selectedRange.end) {
+              await prepareInPlaceOutput();
+            }
           }
         }
         const outputRows = readCsvRows(outputPath);
@@ -21175,7 +21366,8 @@ function registerEnrichCommand(program) {
             batch: {
               chunks: chunkCount,
               chunkRows: autoBatchRows,
-              selectedRows: selectedRange.count
+              selectedRows: selectedRange.count,
+              manifest: batchManifestPath
             },
             output: finalExportResult ? {
               sourceCsvRows: selectedRange.sourceRows,
@@ -21305,7 +21497,7 @@ function registerEnrichCommand(program) {
     } finally {
       if (inPlaceTempDir) {
         await rm(inPlaceTempDir, { recursive: true, force: true });
-      } else if (inPlaceTempOutputPath && !inPlaceCommitted) {
+      } else if (inPlaceTempOutputPath) {
         await rm(inPlaceTempOutputPath, { force: true });
       }
       await rm(tempDir, { recursive: true, force: true });
@@ -24189,9 +24381,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";
@@ -24344,7 +24536,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(",")}
 `);
@@ -24356,7 +24548,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.189",
+  version: "0.1.191",
   apiContract: "2026-06-dataset-handle-results-hard-cutover",
   supportPolicy: {
-    latest: "0.1.189",
+    latest: "0.1.191",
     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.189",
+  version: "0.1.191",
   apiContract: "2026-06-dataset-handle-results-hard-cutover",
   supportPolicy: {
-    latest: "0.1.189",
+    latest: "0.1.191",
     minimumSupported: "0.1.53",
     deprecatedBelow: "0.1.53",
     commandMinimumSupported: [

package/package.json

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