deepline 0.1.149 → 0.1.150

package/dist/cli/index.js

@@ -655,10 +655,10 @@ var SDK_RELEASE = {
   // the SDK enrich generator's one-second stale policy.
   // 0.1.110 ships authored V2 prebuilts and required top-level play descriptions.
   // 0.1.111 ships dataset-native tool list getters and result row datasets.
-  version: "0.1.149",
+  version: "0.1.150",
   apiContract: "2026-06-dataset-handle-results-hard-cutover",
   supportPolicy: {
-    latest: "0.1.149",
+    latest: "0.1.150",
     minimumSupported: "0.1.53",
     deprecatedBelow: "0.1.53",
     commandMinimumSupported: [
@@ -2122,6 +2122,7 @@ async function* observeRunEvents(options) {
 var TERMINAL_PLAY_STATUSES = /* @__PURE__ */ new Set(["completed", "failed", "cancelled"]);
 var INCLUDE_TOOL_METADATA_HEADER = "x-deepline-include-tool-metadata";
 var EXECUTE_RESPONSE_CONTRACT_HEADER = "x-deepline-execute-response-contract";
+var EXECUTE_RESPONSE_INTENT_HEADER = "x-deepline-execute-response-intent";
 var V2_EXECUTE_RESPONSE_CONTRACT = "v2-tool-response";
 var COMPILE_MANIFEST_RETRY_DELAYS_MS = [250, 1e3];
 var REGISTER_PLAY_ARTIFACTS_COMPILE_CONCURRENCY = 3;
@@ -2606,7 +2607,8 @@ var DeeplineClient = class {
   async executeTool(toolId, input2, options) {
     const headers = {
       [EXECUTE_RESPONSE_CONTRACT_HEADER]: V2_EXECUTE_RESPONSE_CONTRACT,
-      ...options?.includeToolMetadata ? { [INCLUDE_TOOL_METADATA_HEADER]: "true" } : {}
+      ...options?.includeToolMetadata ? { [INCLUDE_TOOL_METADATA_HEADER]: "true" } : {},
+      ...options?.responseIntent ? { [EXECUTE_RESPONSE_INTENT_HEADER]: options.responseIntent } : {}
     };
     return this.http.post(
       `/api/v2/integrations/${encodeURIComponent(toolId)}/execute`,
@@ -20554,6 +20556,19 @@ function normalizeRows(value) {
     return { value: entry };
   });
 }
+function columnsForRows(rows) {
+  const seen = /* @__PURE__ */ new Set();
+  const columns = [];
+  for (const row of rows) {
+    for (const key of Object.keys(row)) {
+      if (!seen.has(key)) {
+        seen.add(key);
+        columns.push(key);
+      }
+    }
+  }
+  return columns;
+}
 function candidateRoots(payload) {
   const roots = [
     { path: null, value: payload }
@@ -20636,6 +20651,16 @@ function tryConvertToList(payload, options) {
   }
   return null;
 }
+function projectRowOutput(conversion) {
+  return {
+    rows: conversion.rows,
+    rowCount: conversion.rows.length,
+    columns: columnsForRows(conversion.rows),
+    previewRows: conversion.rows.slice(0, 5),
+    strategy: conversion.strategy,
+    sourcePath: conversion.sourcePath
+  };
+}
 function ensureOutputDir() {
   const outputDir = (0, import_node_path14.join)((0, import_node_os10.homedir)(), ".local", "share", "deepline", "data");
   (0, import_node_fs12.mkdirSync)(outputDir, { recursive: true });
@@ -20650,16 +20675,7 @@ function writeJsonOutputFile(payload, stem) {
 function writeCsvOutputFile(rows, stem, options) {
   const outputPath = options?.outPath ? options.outPath : (0, import_node_path14.join)(ensureOutputDir(), `${stem}_${Date.now()}.csv`);
   (0, import_node_fs12.mkdirSync)((0, import_node_path14.dirname)(outputPath), { recursive: true });
-  const seen = /* @__PURE__ */ new Set();
-  const columns = [];
-  for (const row of rows) {
-    for (const key of Object.keys(row)) {
-      if (!seen.has(key)) {
-        seen.add(key);
-        columns.push(key);
-      }
-    }
-  }
+  const columns = columnsForRows(rows);
   const escapeCell = (value) => {
     const normalized = value == null ? "" : typeof value === "string" || typeof value === "number" || typeof value === "boolean" ? String(value) : JSON.stringify(value);
     if (/[",\n]/.test(normalized)) {
@@ -20667,13 +20683,20 @@ function writeCsvOutputFile(rows, stem, options) {
     }
     return normalized;
   };
-  const lines = [];
-  lines.push(columns.map(escapeCell).join(","));
-  for (const row of rows) {
-    lines.push(columns.map((column) => escapeCell(row[column])).join(","));
+  const fd = (0, import_node_fs12.openSync)(outputPath, "w");
+  try {
+    (0, import_node_fs12.writeSync)(fd, `${columns.map(escapeCell).join(",")}
+`);
+    for (const row of rows) {
+      (0, import_node_fs12.writeSync)(
+        fd,
+        `${columns.map((column) => escapeCell(row[column])).join(",")}
+`
+      );
+    }
+  } finally {
+    (0, import_node_fs12.closeSync)(fd);
   }
-  (0, import_node_fs12.writeFileSync)(outputPath, `${lines.join("\n")}
-`, "utf-8");
   const previewRows = rows.slice(0, 5);
   const previewColumns = columns.slice(0, 5);
   const preview = [
@@ -21200,10 +21223,7 @@ Examples:
   ).option(
     "--output-format <format>",
     "Output format: auto, csv, csv_file, json, or json_file"
-  ).option(
-    "-o, --out <path>",
-    "Write row-shaped tool output to this CSV path"
-  ).option(
+  ).option("-o, --out <path>", "Write row-shaped tool output to this CSV path").option(
     "--no-preview",
     "Only print the extracted output path when applicable"
   ).action(async (toolId, options) => {
@@ -22057,6 +22077,100 @@ function buildToolExecuteBaseEnvelope(input2) {
     }
   };
 }
+function buildToolExecuteRowArtifactEnvelope(input2) {
+  const {
+    toolResponse: _toolResponse,
+    result: _result,
+    output: _output,
+    output_preview: _outputPreview,
+    render: _render,
+    next: _next,
+    local: _local,
+    ...base
+  } = input2.baseEnvelope;
+  void _toolResponse;
+  void _result;
+  void _output;
+  void _outputPreview;
+  void _render;
+  void _next;
+  void _local;
+  return {
+    ...base,
+    status: typeof base.status === "string" ? base.status : "completed",
+    output_preview: {
+      kind: "list",
+      rowCount: input2.rowOutput.rowCount,
+      columns: input2.rowOutput.columns,
+      preview: input2.rowOutput.previewRows,
+      listStrategy: input2.rowOutput.strategy,
+      listSourcePath: input2.rowOutput.sourcePath
+    },
+    csv_path: input2.csv.path,
+    row_count: input2.csv.rowCount,
+    row_count_returned: input2.csv.rowCount,
+    columns: input2.csv.columns,
+    extracted_csv: input2.csv.path,
+    extracted_csv_rows: input2.csv.rowCount,
+    extracted_csv_columns: input2.csv.columns,
+    preview: input2.csv.preview,
+    list_strategy: input2.rowOutput.strategy,
+    list_source_path: input2.rowOutput.sourcePath,
+    summary: input2.summary,
+    local: {
+      extracted_csv: input2.csv.path,
+      extracted_csv_rows: input2.csv.rowCount,
+      extracted_csv_columns: input2.csv.columns,
+      preview: input2.csv.preview,
+      starter_script: input2.seededScript.path,
+      project_dir: input2.seededScript.projectDir,
+      copy_to_project: {
+        macos_linux: input2.seededScript.macCopyCommand,
+        windows_powershell: input2.seededScript.windowsCopyCommand
+      }
+    },
+    starter_script: input2.seededScript.path,
+    project_dir: input2.seededScript.projectDir,
+    copy_to_project: {
+      macos_linux: input2.seededScript.macCopyCommand,
+      windows_powershell: input2.seededScript.windowsCopyCommand
+    },
+    next: {
+      inspect: "Re-run with --json only when you need the raw provider/tool response.",
+      listSourcePath: input2.rowOutput.sourcePath,
+      expandToPlay: "Use stable map and step keys so reruns are idempotent: completed rows are reused, and only missing or stale work runs again."
+    },
+    render: {
+      sections: [
+        {
+          title: `${input2.csv.path} (${input2.csv.rowCount} rows)`,
+          lines: [
+            ...input2.csv.columns.length > 0 ? [`columns: ${JSON.stringify(input2.csv.columns)}`] : [],
+            ...Object.keys(input2.summary).length > 0 ? [
+              `summary: ${Object.entries(input2.summary).map(([key, value]) => `${key}=${String(value)}`).join(", ")}`
+            ] : [],
+            `preview: ${JSON.stringify(input2.rowOutput.previewRows)}`,
+            `starter script: ${input2.seededScript.path}`
+          ]
+        }
+      ],
+      actions: [
+        {
+          label: "next",
+          command: "Move the script into a project folder and expand it into a Deepline play. Use stable map and step keys so reruns are idempotent: completed rows are reused, and only missing or stale work runs again."
+        },
+        {
+          label: "macOS/Linux",
+          command: input2.seededScript.macCopyCommand
+        },
+        {
+          label: "Windows PowerShell",
+          command: input2.seededScript.windowsCopyCommand
+        }
+      ]
+    }
+  };
+}
 async function executeTool(args) {
   let parsed;
   try {
@@ -22108,7 +22222,9 @@ async function executeTool(args) {
     }
     return 2;
   }
-  const rawResponse = await client2.executeTool(parsed.toolId, parsed.params);
+  const rawResponse = await client2.executeTool(parsed.toolId, parsed.params, {
+    responseIntent: parsed.outPath || parsed.outputFormat === "csv" || parsed.outputFormat === "csv_file" ? "row_artifact" : "raw"
+  });
   const listConversion = tryConvertToList(rawResponse, {
     listExtractorPaths: listExtractorPathsFromUsageGuidance(metadata)
   });
@@ -22172,6 +22288,7 @@ async function executeTool(args) {
     printCommandEnvelope(baseEnvelope, { json: false });
     return 0;
   }
+  const rowOutput = projectRowOutput(listConversion);
   const csv = writeCsvOutputFile(
     listConversion.rows,
     `${parsed.toolId}_output`,
@@ -22182,91 +22299,23 @@ async function executeTool(args) {
     payload: parsed.params,
     rows: listConversion.rows
   });
-  const materializedEnvelope = {
-    ...baseEnvelope,
-    local: {
-      extracted_csv: csv.path,
-      extracted_csv_rows: csv.rowCount,
-      extracted_csv_columns: csv.columns,
-      preview: csv.preview,
-      starter_script: seededScript.path,
-      project_dir: seededScript.projectDir,
-      copy_to_project: {
-        macos_linux: seededScript.macCopyCommand,
-        windows_powershell: seededScript.windowsCopyCommand
-      }
-    },
-    render: {
-      sections: [
-        {
-          title: `${csv.path} (${csv.rowCount} rows)`,
-          lines: [
-            ...csv.columns.length > 0 ? [`columns: ${JSON.stringify(csv.columns)}`] : [],
-            ...Object.keys(summary).length > 0 ? [
-              `summary: ${Object.entries(summary).map(([key, value]) => `${key}=${String(value)}`).join(", ")}`
-            ] : [],
-            `preview: ${JSON.stringify(csv.preview)}`,
-            `starter script: ${seededScript.path}`
-          ]
-        }
-      ],
-      actions: [
-        {
-          label: "next",
-          command: "Move the script into a project folder and expand it into a Deepline play. Use stable map and step keys so reruns are idempotent: completed rows are reused, and only missing or stale work runs again."
-        },
-        {
-          label: "macOS/Linux",
-          command: seededScript.macCopyCommand
-        },
-        {
-          label: "Windows PowerShell",
-          command: seededScript.windowsCopyCommand
-        }
-      ]
-    }
-  };
+  const materializedEnvelope = buildToolExecuteRowArtifactEnvelope({
+    baseEnvelope,
+    csv,
+    rowOutput,
+    summary,
+    seededScript
+  });
   if (parsed.outputFormat === "csv_file") {
-    printCommandEnvelope(
-      {
-        ...materializedEnvelope,
-        extracted_csv: csv.path,
-        extracted_csv_rows: csv.rowCount,
-        extracted_csv_columns: csv.columns,
-        preview: csv.preview,
-        list_strategy: listConversion.strategy,
-        list_source_path: listConversion.sourcePath,
-        starter_script: seededScript.path,
-        project_dir: seededScript.projectDir,
-        copy_to_project: {
-          macos_linux: seededScript.macCopyCommand,
-          windows_powershell: seededScript.windowsCopyCommand
-        },
-        summary
-      },
-      { json: true }
-    );
+    printCommandEnvelope(materializedEnvelope, { json: true });
     return 0;
   }
   if (parsed.outPath) {
-    printCommandEnvelope(
-      {
-        ...materializedEnvelope,
-        csv_path: csv.path,
-        row_count: csv.rowCount,
-        row_count_returned: csv.rowCount,
-        columns: csv.columns,
-        preview: csv.preview,
-        list_strategy: listConversion.strategy,
-        list_source_path: listConversion.sourcePath,
-        summary
-      },
-      {
-        json: argsWantJson(args) || shouldEmitJson(),
-        text: `Wrote ${csv.rowCount} row(s) to ${csv.path}
+    printCommandEnvelope(materializedEnvelope, {
+      json: argsWantJson(args) || shouldEmitJson(),
+      text: `Wrote ${csv.rowCount} row(s) to ${csv.path}
 `
-      }
-    );
+    });
     return 0;
   }
   if (parsed.noPreview) {