deepline 0.1.155 → 0.1.157

package/dist/cli/index.js

@@ -657,10 +657,10 @@ var SDK_RELEASE = {
   // 0.1.111 ships dataset-native tool list getters and result row datasets.
   // 0.1.154 removes the short-lived generated enrich StepOptions recompute
   // fields shipped in 0.1.153.
-  version: "0.1.155",
+  version: "0.1.157",
   apiContract: "2026-06-dataset-handle-results-hard-cutover",
   supportPolicy: {
-    latest: "0.1.155",
+    latest: "0.1.157",
     minimumSupported: "0.1.53",
     deprecatedBelow: "0.1.53",
     commandMinimumSupported: [
@@ -9365,7 +9365,7 @@ async function traceCliSpan(phase, fields, run) {
 var EXTRACTED_GETTER_ERROR_HINT = "Deepline hint: extractedValues/extractedLists .get() only works for declared Deepline getters listed by `deepline tools describe <tool> --json`. Use `toolExecutionResult.toolResponse.raw` for provider/tool-specific fields.";
 var DATASET_API_HINT = "Deepline hint: PlayDataset is lazy and durable. Use `.peek(n)` for a small preview or `.materialize()` when you intentionally need rows in memory; do not use `.rows`, `.toArray()`, or array methods directly on the dataset handle.";
 var ROW_PROPERTY_HINT = "Deepline hint: this row type only contains fields produced by the CSV/schema and previous map steps. Check source column casing and the exact output field names from earlier steps before scaling.";
-var TOOLS_EXECUTE_SIGNATURE_HINT = "Deepline hint: ctx.tools.execute requires a request object: `ctx.tools.execute({ id, tool, input, description })`. The stable `id` is required for replay-safe receipts.";
+var TOOLS_EXECUTE_SIGNATURE_HINT = "Deepline hint: ctx.tools.execute requires a request object: `ctx.tools.execute({ id, tool, input, description })`. The stable `id` is required for logs, metadata, and receipt attachment; provider-call reuse is based on play, tool, semantic input, auth scope, provider action version, and cache policy.";
 var RUN_PLAY_SIGNATURE_HINT = "Deepline hint: ctx.runPlay uses a stable key plus a composable child play reference. Direct-run-only or map-backed batch plays must be run directly, exported, then consumed by a separate play.";
 var MAP_BACKED_CHILD_HINT = "Deepline hint: map-backed child plays own durable table state and cannot be called from another play. Run that play directly, export its dataset, then pass the CSV to the next play.";
 function sourceLineForError(sourceCode, error) {
@@ -12840,7 +12840,7 @@ function writeStartedPlayRun(input2) {
   );
 }
 function parsePlayRunOptions(args) {
-  const usage = "Usage: deepline plays run <play-name> [--input '{...}'] [--no-wait] [--tail-timeout-ms 30000] [--force] [--full] [--<input> value]\n       deepline plays run <play-file.ts> [--input '{...}'] [--no-wait] [--tail-timeout-ms 30000] [--force] [--full] [--<input> value]\n       deepline plays run --file <play-file.ts> [--input '{...}'] [--profile <id>] [--no-wait] [--tail-timeout-ms 30000] [--force] [--full] [--<input> value]\n       deepline plays run --name <name> [--input '{...}'] [--profile <id>] [--live|--latest|--revision-id <id>] [--no-wait] [--tail-timeout-ms 30000] [--force] [--no-open] [--json] [--full] [--<input> value]\n       --profile defaults to workers_edge; pass hatchet explicitly for Hatchet runtime comparison.\n       Unknown --<input> value flags, such as --limit 5, are passed into play input.\nRun `deepline plays run --help` for idempotency, tool call id, and ctx.dataset guidance.";
+  const usage = "Usage: deepline plays run <play-name> [--input '{...}'] [--no-wait] [--tail-timeout-ms 30000] [--force] [--full] [--<input> value]\n       deepline plays run <play-file.ts> [--input '{...}'] [--no-wait] [--tail-timeout-ms 30000] [--force] [--full] [--<input> value]\n       deepline plays run --file <play-file.ts> [--input '{...}'] [--profile <id>] [--no-wait] [--tail-timeout-ms 30000] [--force] [--full] [--<input> value]\n       deepline plays run --name <name> [--input '{...}'] [--profile <id>] [--live|--latest|--revision-id <id>] [--no-wait] [--tail-timeout-ms 30000] [--force] [--no-open] [--json] [--full] [--<input> value]\n       --profile defaults to workers_edge; pass hatchet explicitly for Hatchet runtime comparison.\n       Unknown --<input> value flags, such as --limit 5, are passed into play input.\nRun `deepline plays run --help` for idempotent call caching and ctx.dataset guidance.";
   let filePath = null;
   let playName = null;
   let input2 = null;
@@ -14696,10 +14696,15 @@ Notes:
   This command starts cloud work and may spend Deepline credits through tool calls.
 
 Idempotent execution:
-  Stable tool call ids are the reuse key:
+  Durable tool-call reuse is based on the actual external call identity:
+  same play, tool, semantic input, auth scope, provider action version, and
+  cache policy.
 
     await ctx.tools.execute({ id: 'company_lookup', tool, input });
 
+  The authored id is still required for readable logs, metadata, and receipt
+  attachment, but renaming it alone does not rebuy the same provider request.
+
   For rows, use ctx.dataset plus a stable row key:
 
     const rows = await ctx
@@ -14711,8 +14716,7 @@ Idempotent execution:
       }))
       .run({ key: 'domain' });
 
-  Reuse needs the same play, call id, semantic input, auth scope, and cache
-  policy. Dataset cells are storage; put freshness on the actual call:
+  Dataset cells are storage; put freshness on the actual call:
 
     await ctx.tools.execute({
       id: 'find_cto',
@@ -17633,7 +17637,7 @@ async function buildEnrichFailureReport(input2) {
     rows: input2.rows,
     rowRange: input2.rowRange,
     client: input2.client,
-    outputPath: input2.exportResult?.path ?? input2.outputPath ?? null,
+    outputPath: input2.reportOutputPath ?? input2.exportResult?.path ?? input2.outputPath ?? null,
     status: input2.status
   });
 }
@@ -18922,7 +18926,7 @@ function registerEnrichCommand(program) {
       return;
     }
     const rows = parseRows(options.rows, options.all);
-    const outputPath = options.inPlace ? inputCsv : options.output;
+    let outputPath = options.inPlace ? inputCsv : options.output;
     const sourceCsvPath = !options.inPlace && outputPath && await regularFileExists(outputPath) ? outputPath : inputCsv;
     const forceAliases = resolveForceAliases(config, options);
     for (const alias of collectFailedInputAliases(
@@ -18940,8 +18944,39 @@ function registerEnrichCommand(program) {
     });
     const tempDir = await (0, import_promises3.mkdtemp)((0, import_node_path12.join)((0, import_node_os8.tmpdir)(), "deepline-enrich-play-"));
     const tempPlay = (0, import_node_path12.join)(tempDir, "deepline-enrich.play.ts");
+    let inPlaceTempDir = null;
+    let inPlaceTempOutputPath = null;
+    const inPlaceFinalOutputPath = options.inPlace ? (0, import_node_path12.resolve)(inputCsv) : null;
+    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;
+    let inPlaceCommitted = false;
+    const commitInPlaceOutput = async (exportResult) => {
+      if (!inPlaceTempOutputPath || !inPlaceCommitOutputPath || !inPlaceFinalOutputPath) {
+        return exportResult;
+      }
+      await (0, import_promises3.rename)(inPlaceTempOutputPath, inPlaceCommitOutputPath);
+      inPlaceCommitted = true;
+      if (!exportResult) {
+        return null;
+      }
+      return {
+        ...exportResult,
+        path: inPlaceFinalOutputPath
+      };
+    };
     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;
+      }
       const runOne = async (input2) => {
         const runtimeInput = {
           file: (0, import_node_path12.resolve)(input2.sourceCsvPath),
@@ -19038,10 +19073,10 @@ function registerEnrichCommand(program) {
                   rows: chunkRows
                 },
                 result: chunk.status,
-                output: enrichOutputJson(chunk.exportResult)
+                output: options.inPlace ? null : enrichOutputJson(chunk.exportResult)
               });
             } else {
-              if (chunk.exportResult) {
+              if (chunk.exportResult && !options.inPlace) {
                 process.stderr.write(
                   `Wrote ${chunk.exportResult.rows} row(s) to ${chunk.exportResult.path}${chunk.exportResult.partial ? " (partial run output)" : ""}
 `
@@ -19073,15 +19108,18 @@ function registerEnrichCommand(program) {
             rowEnd: selectedRange.end
           },
           client: client2,
-          outputPath,
+          outputPath: failureReportOutputPath ?? finalExportResult?.path ?? outputPath,
           status: lastStatus
         });
+        if (!failureReport2) {
+          finalExportResult = await commitInPlaceOutput(finalExportResult);
+        }
         if (options.json) {
           const run = rewriteEnrichJsonStatus({
             status: lastStatus,
             config,
             forceAliases,
-            output: finalExportResult ? {
+            output: finalExportResult && (!failureReport2 || !options.inPlace) ? {
               ...finalExportResult,
               sourceCsvRows: selectedRange.sourceRows,
               selectedRows: selectedRange.count,
@@ -19099,7 +19137,7 @@ function registerEnrichCommand(program) {
               chunkRows: ENRICH_AUTO_BATCH_ROWS,
               selectedRows: selectedRange.count
             },
-            output: finalExportResult ? {
+            output: finalExportResult && (!failureReport2 || !options.inPlace) ? {
               sourceCsvRows: selectedRange.sourceRows,
               selectedRows: selectedRange.count,
               enrichedRows: totalEnrichedRows,
@@ -19126,7 +19164,7 @@ function registerEnrichCommand(program) {
       });
       const rowsForFailureReport = exportResult?.enrichedDataRows ?? extractCanonicalRowsInfo(status)?.rows ?? [];
       if (captured.result !== 0) {
-        if (exportResult) {
+        if (exportResult && !options.inPlace) {
           process.stderr.write(
             `Wrote ${exportResult.rows} row(s) to ${exportResult.path}${exportResult.partial ? " (partial run output)" : ""}
 `
@@ -19139,13 +19177,14 @@ function registerEnrichCommand(program) {
           client: client2,
           exportResult,
           outputPath,
+          reportOutputPath: failureReportOutputPath,
           status
         });
         if (options.json) {
           printJson({
             ok: false,
             run: status,
-            output: enrichOutputJson(exportResult),
+            output: options.inPlace ? null : enrichOutputJson(exportResult),
             ...failureReport2 ? {
               failure_report: {
                 path: failureReport2.path,
@@ -19165,19 +19204,21 @@ function registerEnrichCommand(program) {
           client: client2,
           exportResult,
           outputPath,
+          reportOutputPath: failureReportOutputPath,
           status
         });
+        const committedExportResult2 = failureReport2 ? exportResult : await commitInPlaceOutput(exportResult);
         const run = rewriteEnrichJsonStatus({
           status,
           config,
           forceAliases,
-          output: exportResult,
+          output: failureReport2 && options.inPlace ? null : committedExportResult2,
           failureReport: failureReport2
         });
         printJson({
           ok: !failureReport2,
           run,
-          output: enrichOutputJson(exportResult),
+          output: failureReport2 && options.inPlace ? null : enrichOutputJson(committedExportResult2),
           ...failureReport2 ? {
             failure_report: {
               path: failureReport2.path,
@@ -19190,32 +19231,38 @@ function registerEnrichCommand(program) {
         }
         return;
       }
-      if (exportResult) {
+      const failureReport = await maybeEmitEnrichFailureReport({
+        config,
+        rows: rowsForFailureReport,
+        rowRange: rows,
+        client: client2,
+        outputPath: failureReportOutputPath ?? exportResult?.path ?? null,
+        status
+      });
+      const committedExportResult = failureReport ? options.inPlace ? null : exportResult : await commitInPlaceOutput(exportResult);
+      if (committedExportResult) {
         process.stderr.write(
-          `Wrote ${exportResult.rows} row(s) to ${exportResult.path}
+          `Wrote ${committedExportResult.rows} row(s) to ${committedExportResult.path}
 `
         );
         const waterfallSummaryLines = buildEnrichWaterfallSummaryLines(
           config,
-          exportResult.enrichedDataRows
+          committedExportResult.enrichedDataRows
         );
         if (waterfallSummaryLines.length > 0) {
           process.stdout.write(`${waterfallSummaryLines.join("\n")}
 `);
         }
       }
-      const failureReport = await maybeEmitEnrichFailureReport({
-        config,
-        rows: rowsForFailureReport,
-        rowRange: rows,
-        client: client2,
-        outputPath: exportResult?.path ?? outputPath ?? null,
-        status
-      });
       if (failureReport) {
         process.exitCode = EXIT_SERVER2;
       }
     } finally {
+      if (inPlaceTempDir) {
+        await (0, import_promises3.rm)(inPlaceTempDir, { recursive: true, force: true });
+      } else if (inPlaceTempOutputPath && !inPlaceCommitted) {
+        await (0, import_promises3.rm)(inPlaceTempOutputPath, { force: true });
+      }
       await (0, import_promises3.rm)(tempDir, { recursive: true, force: true });
     }
   });