deepline 0.1.149 → 0.1.151

package/dist/cli/index.mjs

@@ -405,7 +405,7 @@ function loadProjectEnvCandidates(startDir = process.cwd()) {
   }));
 }
 function normalizeBaseUrl(baseUrl) {
-  const trimmed = baseUrl.trim().replace(/\/+$/, "");
+  const trimmed = baseUrl?.trim().replace(/\/+$/, "") ?? "";
   if (!trimmed) return "";
   try {
     const parsed = new URL(trimmed);
@@ -640,10 +640,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.151",
   apiContract: "2026-06-dataset-handle-results-hard-cutover",
   supportPolicy: {
-    latest: "0.1.149",
+    latest: "0.1.151",
     minimumSupported: "0.1.53",
     deprecatedBelow: "0.1.53",
     commandMinimumSupported: [
@@ -2107,6 +2107,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;
@@ -2591,7 +2592,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`,
@@ -10805,6 +10807,23 @@ async function startAndWaitForPlayCompletionByStreamOnce(input2) {
     },
     Math.max(1, input2.waitTimeoutMs)
   );
+  const fetchKnownTerminalStatus = async () => {
+    if (!lastKnownWorkflowId) {
+      return null;
+    }
+    let refreshed;
+    try {
+      refreshed = await input2.client.getPlayStatus(lastKnownWorkflowId, {
+        billing: false
+      });
+    } catch (error) {
+      if (isTransientPlayStreamError(error)) {
+        return null;
+      }
+      throw error;
+    }
+    return TERMINAL_PLAY_STATUSES2.has(refreshed.status) ? { ...refreshed, dashboardUrl } : null;
+  };
   try {
     for await (const event of input2.client.startPlayRunStream(input2.request, {
       signal: controller.signal
@@ -10900,6 +10919,21 @@ async function startAndWaitForPlayCompletionByStreamOnce(input2) {
     }
   } catch (error) {
     if (timedOut) {
+      const terminal = await fetchKnownTerminalStatus();
+      if (terminal) {
+        recordCliTrace({
+          phase: "cli.play_start_stream_timeout_status_reconcile",
+          ms: Date.now() - startedAt,
+          ok: true,
+          playName: input2.playName,
+          workflowId: lastKnownWorkflowId,
+          eventCount,
+          firstRunIdMs,
+          lastPhase,
+          status: terminal.status
+        });
+        return terminal;
+      }
       assertPlayWaitNotTimedOut({
         workflowId: lastKnownWorkflowId,
         startedAt,
@@ -20561,7 +20595,13 @@ import { tmpdir as tmpdir3 } from "os";
 import { join as join10, resolve as resolve10 } from "path";
 
 // src/tool-output.ts
-import { mkdirSync as mkdirSync7, writeFileSync as writeFileSync11 } from "fs";
+import {
+  closeSync as closeSync2,
+  mkdirSync as mkdirSync7,
+  openSync as openSync2,
+  writeFileSync as writeFileSync11,
+  writeSync
+} from "fs";
 import { homedir as homedir9 } from "os";
 import { dirname as dirname9, join as join9 } from "path";
 function isPlainObject(value) {
@@ -20584,6 +20624,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 }
@@ -20666,6 +20719,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 = join9(homedir9(), ".local", "share", "deepline", "data");
   mkdirSync7(outputDir, { recursive: true });
@@ -20680,16 +20743,7 @@ function writeJsonOutputFile(payload, stem) {
 function writeCsvOutputFile(rows, stem, options) {
   const outputPath = options?.outPath ? options.outPath : join9(ensureOutputDir(), `${stem}_${Date.now()}.csv`);
   mkdirSync7(dirname9(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)) {
@@ -20697,13 +20751,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 = openSync2(outputPath, "w");
+  try {
+    writeSync(fd, `${columns.map(escapeCell).join(",")}
+`);
+    for (const row of rows) {
+      writeSync(
+        fd,
+        `${columns.map((column) => escapeCell(row[column])).join(",")}
+`
+      );
+    }
+  } finally {
+    closeSync2(fd);
   }
-  writeFileSync11(outputPath, `${lines.join("\n")}
-`, "utf-8");
   const previewRows = rows.slice(0, 5);
   const previewColumns = columns.slice(0, 5);
   const preview = [
@@ -21230,10 +21291,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) => {
@@ -22087,6 +22145,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 {
@@ -22138,7 +22290,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)
   });
@@ -22202,6 +22356,7 @@ async function executeTool(args) {
     printCommandEnvelope(baseEnvelope, { json: false });
     return 0;
   }
+  const rowOutput = projectRowOutput(listConversion);
   const csv = writeCsvOutputFile(
     listConversion.rows,
     `${parsed.toolId}_output`,
@@ -22212,91 +22367,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) {

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

@@ -308,7 +308,7 @@ function loadProjectEnvCandidates(startDir = process.cwd()) {
   }));
 }
 function normalizeBaseUrl(baseUrl) {
-  const trimmed = baseUrl.trim().replace(/\/+$/, "");
+  const trimmed = baseUrl?.trim().replace(/\/+$/, "") ?? "";
   if (!trimmed) return "";
   try {
     const parsed = new URL(trimmed);
@@ -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.149",
+  version: "0.1.151",
   apiContract: "2026-06-dataset-handle-results-hard-cutover",
   supportPolicy: {
-    latest: "0.1.149",
+    latest: "0.1.151",
     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 = [