deepline 0.1.188 → 0.1.190

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

@@ -612,7 +612,7 @@ export type CsvOptions = {
  *
  * @example
  * ```typescript
- * definePlay('example', async (ctx, input: { domain: string }) => {
+ * definePlay('example', async (ctx, input: { domain: string; csv: string }) => {
  *   // Call a tool
  *   const company = await ctx.tools.execute({
  *     id: 'company_search',
@@ -633,8 +633,8 @@ export type CsvOptions = {
  *       }))
  *     .run({ description: 'Look up company details.' });
  *
- *   // Load CSV data
- *   const leads = await ctx.csv('leads.csv');
+ *   // Load CSV data from a submitted play input field.
+ *   const leads = await ctx.csv(input.csv);
  *
  *   // Emit a log line (visible in `play tail`)
  *   ctx.log(`Loaded ${await leads.count()} leads`);
@@ -642,8 +642,8 @@ export type CsvOptions = {
  *   // Pause execution
  *   await ctx.sleep(1000);
  *
- *   // Access the raw input object
- *   console.log(ctx.input);
+ *   // Access submitted input through the handler's second argument.
+ *   ctx.log(`Running for ${input.domain}`);
  *
  *   return { company, enriched };
  * });
@@ -656,7 +656,12 @@ export interface DeeplinePlayRuntimeContext {
    * Use this when a play receives a CSV path from the CLI or API and row work
    * should continue through {@link DeeplinePlayRuntimeContext.dataset}. The path is
    * normally an input field such as `input.csv`, populated by
-   * `deepline plays run my.play.ts --csv rows.csv`.
+   * `deepline plays run my.play.ts --csv rows.csv`. Prefer `input.csv` for row
+   * data so the CLI can run strict CSV preflight before starting a run.
+   * Pass-through flags can also target non-reserved field names. If a play
+   * intentionally calls `ctx.csv(input.file)`, use `--input
+   * '{"file":"rows.csv"}'` because `--file` is reserved for the play source
+   * path.
    *
    * Each CSV row becomes an object keyed by canonical column names. Use
    * `options.columns` / `options.rename` to map user headers such as
@@ -903,7 +908,11 @@ export interface DeeplinePlayRuntimeContext {
    */
   sleep(ms: number): Promise<void>;
 
-  /** The raw input object passed when the play was started. */
+  /**
+   * @deprecated Read submitted play input from the handler's second argument:
+   * `definePlay('example', async (ctx, input) => ...)`. This legacy field is
+   * not the supported V2 play input API.
+   */
   readonly input: Record<string, unknown>;
 }
 

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

package/dist/bundling-sources/shared_libs/plays/static-pipeline.ts

@@ -510,6 +510,7 @@ export type PlayStaticControlFlowBranch = {
   label: string;
   /** The arm's condition source text, when it has one (omitted for `else`). */
   condition?: string;
+  /** Static work in this arm. Empty for log/throw/return-only arms. */
   steps: PlayStaticSubstep[];
 };
 

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.188",
+  version: "0.1.190",
   apiContract: "2026-06-dataset-handle-results-hard-cutover",
   supportPolicy: {
-    latest: "0.1.188",
+    latest: "0.1.190",
     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;
 }
@@ -16968,16 +17018,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 +20071,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 +20582,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 +20984,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 +21024,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 +21079,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 +21177,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 +21201,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 +21257,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 +21312,8 @@ function registerEnrichCommand(program) {
             batch: {
               chunks: chunkCount,
               chunkRows: autoBatchRows,
-              selectedRows: selectedRange.count
+              selectedRows: selectedRange.count,
+              manifest: batchManifestPath
             },
             output: finalExportResult ? {
               sourceCsvRows: selectedRange.sourceRows,
@@ -21278,7 +21443,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.188",
+  version: "0.1.190",
   apiContract: "2026-06-dataset-handle-results-hard-cutover",
   supportPolicy: {
-    latest: "0.1.188",
+    latest: "0.1.190",
     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;
 }
@@ -16995,16 +17045,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 +20098,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 +20609,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 +21011,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 +21051,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 +21106,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 +21204,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 +21228,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 +21284,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 +21339,8 @@ function registerEnrichCommand(program) {
             batch: {
               chunks: chunkCount,
               chunkRows: autoBatchRows,
-              selectedRows: selectedRange.count
+              selectedRows: selectedRange.count,
+              manifest: batchManifestPath
             },
             output: finalExportResult ? {
               sourceCsvRows: selectedRange.sourceRows,
@@ -21305,7 +21470,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 });

package/dist/{compiler-manifest-OwORQ07f.d.mts → compiler-manifest-j6z8qzpd.d.mts}

@@ -111,6 +111,7 @@ type PlayStaticControlFlowBranch = {
     label: string;
     /** The arm's condition source text, when it has one (omitted for `else`). */
     condition?: string;
+    /** Static work in this arm. Empty for log/throw/return-only arms. */
     steps: PlayStaticSubstep[];
 };
 type PlayStaticSubstep = PlayStaticSubstepMetadata & ({

package/dist/{compiler-manifest-OwORQ07f.d.ts → compiler-manifest-j6z8qzpd.d.ts}

@@ -111,6 +111,7 @@ type PlayStaticControlFlowBranch = {
     label: string;
     /** The arm's condition source text, when it has one (omitted for `else`). */
     condition?: string;
+    /** Static work in this arm. Empty for log/throw/return-only arms. */
     steps: PlayStaticSubstep[];
 };
 type PlayStaticSubstep = PlayStaticSubstepMetadata & ({

package/dist/index.d.mts

@@ -1,4 +1,4 @@
-import { a as PlayCompilerManifest } from './compiler-manifest-OwORQ07f.mjs';
+import { a as PlayCompilerManifest } from './compiler-manifest-j6z8qzpd.mjs';
 
 declare const DEEPLINE_TOOL_CATEGORIES: readonly ["company_search", "people_search", "people_enrich", "email_finder", "email_verify", "phone_finder", "phone_verify", "identity_resolution", "reverse_lookup", "enrichment", "batch", "premium", "free"];
 type DeeplineToolCategory = (typeof DEEPLINE_TOOL_CATEGORIES)[number] | (string & {});
@@ -3313,7 +3313,7 @@ type CsvOptions = {
  *
  * @example
  * ```typescript
- * definePlay('example', async (ctx, input: { domain: string }) => {
+ * definePlay('example', async (ctx, input: { domain: string; csv: string }) => {
  *   // Call a tool
  *   const company = await ctx.tools.execute({
  *     id: 'company_search',
@@ -3334,8 +3334,8 @@ type CsvOptions = {
  *       }))
  *     .run({ description: 'Look up company details.' });
  *
- *   // Load CSV data
- *   const leads = await ctx.csv('leads.csv');
+ *   // Load CSV data from a submitted play input field.
+ *   const leads = await ctx.csv(input.csv);
  *
  *   // Emit a log line (visible in `play tail`)
  *   ctx.log(`Loaded ${await leads.count()} leads`);
@@ -3343,8 +3343,8 @@ type CsvOptions = {
  *   // Pause execution
  *   await ctx.sleep(1000);
  *
- *   // Access the raw input object
- *   console.log(ctx.input);
+ *   // Access submitted input through the handler's second argument.
+ *   ctx.log(`Running for ${input.domain}`);
  *
  *   return { company, enriched };
  * });
@@ -3357,7 +3357,12 @@ interface DeeplinePlayRuntimeContext {
      * Use this when a play receives a CSV path from the CLI or API and row work
      * should continue through {@link DeeplinePlayRuntimeContext.dataset}. The path is
      * normally an input field such as `input.csv`, populated by
-     * `deepline plays run my.play.ts --csv rows.csv`.
+     * `deepline plays run my.play.ts --csv rows.csv`. Prefer `input.csv` for row
+     * data so the CLI can run strict CSV preflight before starting a run.
+     * Pass-through flags can also target non-reserved field names. If a play
+     * intentionally calls `ctx.csv(input.file)`, use `--input
+     * '{"file":"rows.csv"}'` because `--file` is reserved for the play source
+     * path.
      *
      * Each CSV row becomes an object keyed by canonical column names. Use
      * `options.columns` / `options.rename` to map user headers such as
@@ -3570,7 +3575,11 @@ interface DeeplinePlayRuntimeContext {
      * @param ms - Duration in milliseconds
      */
     sleep(ms: number): Promise<void>;
-    /** The raw input object passed when the play was started. */
+    /**
+     * @deprecated Read submitted play input from the handler's second argument:
+     * `definePlay('example', async (ctx, input) => ...)`. This legacy field is
+     * not the supported V2 play input API.
+     */
     readonly input: Record<string, unknown>;
 }
 /**

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { a as PlayCompilerManifest } from './compiler-manifest-OwORQ07f.js';
+import { a as PlayCompilerManifest } from './compiler-manifest-j6z8qzpd.js';
 
 declare const DEEPLINE_TOOL_CATEGORIES: readonly ["company_search", "people_search", "people_enrich", "email_finder", "email_verify", "phone_finder", "phone_verify", "identity_resolution", "reverse_lookup", "enrichment", "batch", "premium", "free"];
 type DeeplineToolCategory = (typeof DEEPLINE_TOOL_CATEGORIES)[number] | (string & {});
@@ -3313,7 +3313,7 @@ type CsvOptions = {
  *
  * @example
  * ```typescript
- * definePlay('example', async (ctx, input: { domain: string }) => {
+ * definePlay('example', async (ctx, input: { domain: string; csv: string }) => {
  *   // Call a tool
  *   const company = await ctx.tools.execute({
  *     id: 'company_search',
@@ -3334,8 +3334,8 @@ type CsvOptions = {
  *       }))
  *     .run({ description: 'Look up company details.' });
  *
- *   // Load CSV data
- *   const leads = await ctx.csv('leads.csv');
+ *   // Load CSV data from a submitted play input field.
+ *   const leads = await ctx.csv(input.csv);
  *
  *   // Emit a log line (visible in `play tail`)
  *   ctx.log(`Loaded ${await leads.count()} leads`);
@@ -3343,8 +3343,8 @@ type CsvOptions = {
  *   // Pause execution
  *   await ctx.sleep(1000);
  *
- *   // Access the raw input object
- *   console.log(ctx.input);
+ *   // Access submitted input through the handler's second argument.
+ *   ctx.log(`Running for ${input.domain}`);
  *
  *   return { company, enriched };
  * });
@@ -3357,7 +3357,12 @@ interface DeeplinePlayRuntimeContext {
      * Use this when a play receives a CSV path from the CLI or API and row work
      * should continue through {@link DeeplinePlayRuntimeContext.dataset}. The path is
      * normally an input field such as `input.csv`, populated by
-     * `deepline plays run my.play.ts --csv rows.csv`.
+     * `deepline plays run my.play.ts --csv rows.csv`. Prefer `input.csv` for row
+     * data so the CLI can run strict CSV preflight before starting a run.
+     * Pass-through flags can also target non-reserved field names. If a play
+     * intentionally calls `ctx.csv(input.file)`, use `--input
+     * '{"file":"rows.csv"}'` because `--file` is reserved for the play source
+     * path.
      *
      * Each CSV row becomes an object keyed by canonical column names. Use
      * `options.columns` / `options.rename` to map user headers such as
@@ -3570,7 +3575,11 @@ interface DeeplinePlayRuntimeContext {
      * @param ms - Duration in milliseconds
      */
     sleep(ms: number): Promise<void>;
-    /** The raw input object passed when the play was started. */
+    /**
+     * @deprecated Read submitted play input from the handler's second argument:
+     * `definePlay('example', async (ctx, input) => ...)`. This legacy field is
+     * not the supported V2 play input API.
+     */
     readonly input: Record<string, unknown>;
 }
 /**

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.188",
+  version: "0.1.190",
   apiContract: "2026-06-dataset-handle-results-hard-cutover",
   supportPolicy: {
-    latest: "0.1.188",
+    latest: "0.1.190",
     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.188",
+  version: "0.1.190",
   apiContract: "2026-06-dataset-handle-results-hard-cutover",
   supportPolicy: {
-    latest: "0.1.188",
+    latest: "0.1.190",
     minimumSupported: "0.1.53",
     deprecatedBelow: "0.1.53",
     commandMinimumSupported: [

package/dist/plays/bundle-play-file.d.mts

@@ -1,5 +1,5 @@
-import { P as PlayArtifactKind$1, a as PlayCompilerManifest } from '../compiler-manifest-OwORQ07f.mjs';
-export { b as PLAY_ARTIFACT_KINDS } from '../compiler-manifest-OwORQ07f.mjs';
+import { P as PlayArtifactKind$1, a as PlayCompilerManifest } from '../compiler-manifest-j6z8qzpd.mjs';
+export { b as PLAY_ARTIFACT_KINDS } from '../compiler-manifest-j6z8qzpd.mjs';
 
 type PlayPackageImport = {
     name: string;

package/dist/plays/bundle-play-file.d.ts

@@ -1,5 +1,5 @@
-import { P as PlayArtifactKind$1, a as PlayCompilerManifest } from '../compiler-manifest-OwORQ07f.js';
-export { b as PLAY_ARTIFACT_KINDS } from '../compiler-manifest-OwORQ07f.js';
+import { P as PlayArtifactKind$1, a as PlayCompilerManifest } from '../compiler-manifest-j6z8qzpd.js';
+export { b as PLAY_ARTIFACT_KINDS } from '../compiler-manifest-j6z8qzpd.js';
 
 type PlayPackageImport = {
     name: string;

package/package.json

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