deepline 0.1.148 → 0.1.150

package/dist/index.d.mts

@@ -1072,6 +1072,7 @@ type EnrichCompiledConfig = {
 
 type ExecuteToolRawOptions = {
     includeToolMetadata?: boolean;
+    responseIntent?: 'raw' | 'row_artifact';
 };
 /**
  * Standard provider/tool execution envelope returned by low-level SDK calls.
@@ -2739,9 +2740,10 @@ type ToolExecuteResultAccessors<TExtracted extends Record<string, unknown> = Par
  * getters live under `extractedValues.<name>.get()`, and list getters live
  * under `extractedLists.<name>.get()`.
  *
- * Use extractors first when a tool contract exposes them. Drop to
- * `toolResponse.raw` when you need provider-specific fields or when debugging
- * from persisted run rows.
+ * Use extractors first when a tool contract exposes them. Use list getters for
+ * row-shaped data. Drop to `toolResponse.raw` only for provider-specific scalar
+ * fields or bounded debugging context; persisted rows may clip declared lists to
+ * previews.
  *
  * @sdkReference runtime 200
  */
@@ -3951,6 +3953,12 @@ type ListConversionResult = {
     /** Dotted path to where the list was found (e.g. `"output.body"`, `"people"`). */
     sourcePath: string | null;
 };
+type CsvOutputArtifact = {
+    path: string;
+    rowCount: number;
+    columns: string[];
+    preview: string;
+};
 type Scalar = string | number | boolean | null;
 /**
  * Extract a list of records from a tool response.
@@ -4042,12 +4050,7 @@ declare function writeJsonOutputFile(payload: unknown, stem: string): string;
  */
 declare function writeCsvOutputFile(rows: Array<Record<string, unknown>>, stem: string, options?: {
     outPath?: string;
-}): {
-    path: string;
-    rowCount: number;
-    columns: string[];
-    preview: string;
-};
+}): CsvOutputArtifact;
 /**
  * Extract scalar (non-nested) fields from a tool response for summary display.
  *

package/dist/index.d.ts

@@ -1072,6 +1072,7 @@ type EnrichCompiledConfig = {
 
 type ExecuteToolRawOptions = {
     includeToolMetadata?: boolean;
+    responseIntent?: 'raw' | 'row_artifact';
 };
 /**
  * Standard provider/tool execution envelope returned by low-level SDK calls.
@@ -2739,9 +2740,10 @@ type ToolExecuteResultAccessors<TExtracted extends Record<string, unknown> = Par
  * getters live under `extractedValues.<name>.get()`, and list getters live
  * under `extractedLists.<name>.get()`.
  *
- * Use extractors first when a tool contract exposes them. Drop to
- * `toolResponse.raw` when you need provider-specific fields or when debugging
- * from persisted run rows.
+ * Use extractors first when a tool contract exposes them. Use list getters for
+ * row-shaped data. Drop to `toolResponse.raw` only for provider-specific scalar
+ * fields or bounded debugging context; persisted rows may clip declared lists to
+ * previews.
  *
  * @sdkReference runtime 200
  */
@@ -3951,6 +3953,12 @@ type ListConversionResult = {
     /** Dotted path to where the list was found (e.g. `"output.body"`, `"people"`). */
     sourcePath: string | null;
 };
+type CsvOutputArtifact = {
+    path: string;
+    rowCount: number;
+    columns: string[];
+    preview: string;
+};
 type Scalar = string | number | boolean | null;
 /**
  * Extract a list of records from a tool response.
@@ -4042,12 +4050,7 @@ declare function writeJsonOutputFile(payload: unknown, stem: string): string;
  */
 declare function writeCsvOutputFile(rows: Array<Record<string, unknown>>, stem: string, options?: {
     outPath?: string;
-}): {
-    path: string;
-    rowCount: number;
-    columns: string[];
-    preview: string;
-};
+}): CsvOutputArtifact;
 /**
  * Extract scalar (non-nested) fields from a tool response for summary display.
  *

package/dist/index.js

@@ -419,10 +419,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.148",
+  version: "0.1.150",
   apiContract: "2026-06-dataset-handle-results-hard-cutover",
   supportPolicy: {
-    latest: "0.1.148",
+    latest: "0.1.150",
     minimumSupported: "0.1.53",
     deprecatedBelow: "0.1.53",
     commandMinimumSupported: [
@@ -1886,6 +1886,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;
@@ -2370,7 +2371,8 @@ var DeeplineClient = class {
   async executeTool(toolId, input, 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`,
@@ -5592,6 +5594,19 @@ function normalizeRows2(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 }
@@ -5688,16 +5703,7 @@ function writeJsonOutputFile(payload, stem) {
 function writeCsvOutputFile(rows, stem, options) {
   const outputPath = options?.outPath ? options.outPath : (0, import_node_path3.join)(ensureOutputDir(), `${stem}_${Date.now()}.csv`);
   (0, import_node_fs3.mkdirSync)((0, import_node_path3.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)) {
@@ -5705,13 +5711,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_fs3.openSync)(outputPath, "w");
+  try {
+    (0, import_node_fs3.writeSync)(fd, `${columns.map(escapeCell).join(",")}
+`);
+    for (const row of rows) {
+      (0, import_node_fs3.writeSync)(
+        fd,
+        `${columns.map((column) => escapeCell(row[column])).join(",")}
+`
+      );
+    }
+  } finally {
+    (0, import_node_fs3.closeSync)(fd);
   }
-  (0, import_node_fs3.writeFileSync)(outputPath, `${lines.join("\n")}
-`, "utf-8");
   const previewRows = rows.slice(0, 5);
   const previewColumns = columns.slice(0, 5);
   const preview = [

package/dist/index.mjs

@@ -349,10 +349,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.148",
+  version: "0.1.150",
   apiContract: "2026-06-dataset-handle-results-hard-cutover",
   supportPolicy: {
-    latest: "0.1.148",
+    latest: "0.1.150",
     minimumSupported: "0.1.53",
     deprecatedBelow: "0.1.53",
     commandMinimumSupported: [
@@ -1816,6 +1816,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;
@@ -2300,7 +2301,8 @@ var DeeplineClient = class {
   async executeTool(toolId, input, 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`,
@@ -5499,7 +5501,13 @@ function getDefinedPlayMetadata(value) {
 }
 
 // src/tool-output.ts
-import { mkdirSync as mkdirSync2, writeFileSync as writeFileSync2 } from "fs";
+import {
+  closeSync,
+  mkdirSync as mkdirSync2,
+  openSync,
+  writeFileSync as writeFileSync2,
+  writeSync
+} from "fs";
 import { homedir as homedir4 } from "os";
 import { dirname as dirname2, join as join3 } from "path";
 function isPlainObject(value) {
@@ -5522,6 +5530,19 @@ function normalizeRows2(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 }
@@ -5618,16 +5639,7 @@ function writeJsonOutputFile(payload, stem) {
 function writeCsvOutputFile(rows, stem, options) {
   const outputPath = options?.outPath ? options.outPath : join3(ensureOutputDir(), `${stem}_${Date.now()}.csv`);
   mkdirSync2(dirname2(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)) {
@@ -5635,13 +5647,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 = openSync(outputPath, "w");
+  try {
+    writeSync(fd, `${columns.map(escapeCell).join(",")}
+`);
+    for (const row of rows) {
+      writeSync(
+        fd,
+        `${columns.map((column) => escapeCell(row[column])).join(",")}
+`
+      );
+    }
+  } finally {
+    closeSync(fd);
   }
-  writeFileSync2(outputPath, `${lines.join("\n")}
-`, "utf-8");
   const previewRows = rows.slice(0, 5);
   const previewColumns = columns.slice(0, 5);
   const preview = [

package/package.json

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