deepline 0.1.30 → 0.1.31

package/dist/cli/index.js

@@ -266,8 +266,8 @@ function saveProjectDeeplineEnvValues(baseUrl, values, startDir = projectEnvStar
 }
 
 // src/version.ts
-var SDK_VERSION = "0.1.30";
-var SDK_API_CONTRACT = "2026-05-runs-v2-datasets";
+var SDK_VERSION = "0.1.31";
+var SDK_API_CONTRACT = "2026-05-runs-export-v3";
 
 // ../shared_libs/play-runtime/coordinator-headers.ts
 var COORDINATOR_INTERNAL_TOKEN_HEADER = "x-deepline-internal-token";
@@ -6384,7 +6384,7 @@ function stripProviderSpendFromBilling(value) {
   }
   return next;
 }
-function compactPlayStatus(status, options) {
+function compactPlayStatus(status) {
   const rowsInfo = extractCanonicalRowsInfo(status);
   const result = status && typeof status === "object" ? status.result : null;
   const warnings = buildRunWarnings(status, rowsInfo);
@@ -6413,7 +6413,6 @@ function compactPlayStatus(status, options) {
     ...error ? { error } : {},
     ...warnings.length > 0 ? { warnings } : {},
     ...result !== void 0 ? { result } : {},
-    ...options?.exportedPath ? { local: { csv_path: options.exportedPath } } : {},
     ...status.resultView ? { resultView: status.resultView } : {},
     ...datasetStats ? { dataset_stats: datasetStats } : {},
     ...billing ? { billing } : {},
@@ -6455,7 +6454,7 @@ function formatDatasetStatsLines(datasetStats) {
 }
 function writePlayResult(status, jsonOutput, options) {
   if (jsonOutput) {
-    const payload2 = options?.fullJson ? enrichPlayStatusWithDatasetStats(status) : compactPlayStatus(status, options);
+    const payload2 = options?.fullJson ? enrichPlayStatusWithDatasetStats(status) : compactPlayStatus(status);
     printCommandEnvelope({
       ...payload2,
       render: {
@@ -6485,9 +6484,6 @@ function writePlayResult(status, jsonOutput, options) {
     rowsInfo.columns,
     extractDatasetExecutionStats(status)
   ) : null;
-  if (options?.exportedPath) {
-    lines.push(`  exported CSV: file=${options.exportedPath}`);
-  }
   for (const warning of warnings) {
     lines.push(`  warning: ${warning}`);
   }
@@ -6505,7 +6501,7 @@ function writePlayResult(status, jsonOutput, options) {
     lines.push(...renderedServerView.lines);
   }
   lines.push(...renderedServerView.actions);
-  const payload = options?.fullJson ? enrichPlayStatusWithDatasetStats(status) : compactPlayStatus(status, options);
+  const payload = options?.fullJson ? enrichPlayStatusWithDatasetStats(status) : compactPlayStatus(status);
   printCommandEnvelope({
     ...payload,
     render: {
@@ -6515,8 +6511,6 @@ function writePlayResult(status, jsonOutput, options) {
 ` });
 }
 var RUN_EXPORT_PAGE_SIZE = 5e3;
-var PLAY_RUN_OUT_EXPORT_ATTEMPTS = 8;
-var PLAY_RUN_OUT_EXPORT_RETRY_DELAY_MS = 1e3;
 function shellSingleQuote(value) {
   return `'${value.replace(/'/g, `'\\''`)}'`;
 }
@@ -6565,6 +6559,27 @@ function exportableSheetRow(row) {
   }
   return fallback;
 }
+function mergeExportColumns(preferredColumns, rows) {
+  const columns = [];
+  const seen = /* @__PURE__ */ new Set();
+  for (const column of preferredColumns) {
+    if (!column || seen.has(column)) {
+      continue;
+    }
+    seen.add(column);
+    columns.push(column);
+  }
+  for (const row of rows) {
+    for (const column of Object.keys(row)) {
+      if (seen.has(column)) {
+        continue;
+      }
+      seen.add(column);
+      columns.push(column);
+    }
+  }
+  return columns;
+}
 async function fetchBackingDatasetRows(input) {
   const playName = extractRunPlayName(input.status);
   const tableNamespace = input.rowsInfo.tableNamespace?.trim();
@@ -6596,7 +6611,10 @@ async function fetchBackingDatasetRows(input) {
   if (rows.length < input.rowsInfo.totalRows) {
     return null;
   }
-  const columns = input.rowsInfo.columnsExplicit && input.rowsInfo.columns.length ? input.rowsInfo.columns : [...new Set(rows.flatMap((row) => Object.keys(row)))];
+  const columns = mergeExportColumns(
+    input.rowsInfo.columnsExplicit ? input.rowsInfo.columns : [],
+    rows
+  );
   return {
     ...input.rowsInfo,
     rows,
@@ -6638,20 +6656,27 @@ async function exportPlayStatusRows(client, status, outPath, options = {}) {
   const attempts = Math.max(1, Math.trunc(options.attempts ?? 1));
   const retryDelayMs = Math.max(0, Math.trunc(options.retryDelayMs ?? 0));
   for (let attempt = 1; attempt <= attempts; attempt += 1) {
-    if (rowsInfo.complete) {
-      return { path: writeCanonicalRowsCsv(rowsInfo, outPath), rowsInfo };
+    let fetchedRowsInfo = null;
+    try {
+      fetchedRowsInfo = await fetchBackingDatasetRows({
+        client,
+        status,
+        rowsInfo
+      });
+    } catch (error) {
+      if (!rowsInfo.complete) {
+        throw error;
+      }
     }
-    const fetchedRowsInfo = await fetchBackingDatasetRows({
-      client,
-      status,
-      rowsInfo
-    });
     if (fetchedRowsInfo?.complete) {
       return {
         path: writeCanonicalRowsCsv(fetchedRowsInfo, outPath),
         rowsInfo: fetchedRowsInfo
       };
     }
+    if (rowsInfo.complete) {
+      return { path: writeCanonicalRowsCsv(rowsInfo, outPath), rowsInfo };
+    }
     if (attempt < attempts && retryDelayMs > 0) {
       await sleep4(retryDelayMs);
     }
@@ -6779,7 +6804,7 @@ function writeStartedPlayRun(input) {
 ` });
 }
 function parsePlayRunOptions(args) {
-  const usage = "Usage: deepline plays run <play-name> [--input '{...}'] [--watch] [--out output.csv] [--tail-timeout-ms 30000] [--force] [--<input> value]\n       deepline plays run <play-file.ts> [--input '{...}'] [--watch] [--out output.csv] [--tail-timeout-ms 30000] [--force] [--<input> value]\n       deepline plays run --file <play-file.ts> [--input '{...}'] [--watch] [--out output.csv] [--tail-timeout-ms 30000] [--force] [--<input> value]\n       deepline plays run --name <name> [--input '{...}'] [--live|--latest|--revision-id <id>] [--watch] [--out output.csv] [--tail-timeout-ms 30000] [--force] [--no-open] [--json] [--<input> value]\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.map guidance.";
+  const usage = "Usage: deepline plays run <play-name> [--input '{...}'] [--watch] [--tail-timeout-ms 30000] [--force] [--<input> value]\n       deepline plays run <play-file.ts> [--input '{...}'] [--watch] [--tail-timeout-ms 30000] [--force] [--<input> value]\n       deepline plays run --file <play-file.ts> [--input '{...}'] [--watch] [--tail-timeout-ms 30000] [--force] [--<input> value]\n       deepline plays run --name <name> [--input '{...}'] [--live|--latest|--revision-id <id>] [--watch] [--tail-timeout-ms 30000] [--force] [--no-open] [--json] [--<input> value]\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.map guidance.";
   let filePath = null;
   let playName = null;
   let input = null;
@@ -6790,7 +6815,6 @@ function parsePlayRunOptions(args) {
   const emitLogs = !jsonOutput || args.includes("--logs");
   const force = args.includes("--force");
   const noOpen = args.includes("--no-open");
-  let outPath = null;
   let waitTimeoutMs = null;
   for (let index = 0; index < args.length; index += 1) {
     const arg = args[index];
@@ -6818,9 +6842,10 @@ function parsePlayRunOptions(args) {
       revisionSelector = "latest";
       continue;
     }
-    if (arg === "--out" && args[index + 1]) {
-      outPath = (0, import_node_path9.resolve)(args[++index]);
-      continue;
+    if (arg === "--out" || arg.startsWith("--out=")) {
+      throw new Error(
+        "--out is not a plays run flag. Run the play first, then export rows with: deepline runs export <run-id> --out output.csv"
+      );
     }
     if (arg === "--poll-interval-ms" || arg === "--interval-ms") {
       throw new Error(
@@ -6890,11 +6915,6 @@ function parsePlayRunOptions(args) {
       "--live, --latest, and --revision-id only apply to named plays."
     );
   }
-  if (outPath && !watch) {
-    throw new Error(
-      "--out requires --watch so the CLI can export the completed run output."
-    );
-  }
   return {
     target: filePath ? { kind: "file", path: filePath } : { kind: "name", name: playName },
     input,
@@ -6905,7 +6925,6 @@ function parsePlayRunOptions(args) {
     jsonOutput,
     waitTimeoutMs,
     force,
-    outPath,
     noOpen
   };
 }
@@ -7080,14 +7099,6 @@ async function handleFileBackedRun(options) {
         progress
       })
     );
-    const exportResult = await traceCliSpan(
-      "cli.play_export_rows",
-      { targetKind: "file", playName },
-      () => exportPlayStatusRows(client, finalStatus, options.outPath, {
-        attempts: PLAY_RUN_OUT_EXPORT_ATTEMPTS,
-        retryDelayMs: PLAY_RUN_OUT_EXPORT_RETRY_DELAY_MS
-      })
-    );
     if (finalStatus.status === "completed") {
       progress.complete();
     } else {
@@ -7096,7 +7107,7 @@ async function handleFileBackedRun(options) {
     traceCliSync(
       "cli.play_write_result",
       { targetKind: "file", playName },
-      () => writePlayResult(finalStatus, options.jsonOutput, { exportedPath: exportResult?.path ?? null })
+      () => writePlayResult(finalStatus, options.jsonOutput)
     );
     return finalStatus.status === "completed" ? 0 : 1;
   }
@@ -7224,14 +7235,6 @@ async function handleNamedRun(options) {
         progress
       })
     );
-    const exportResult = await traceCliSpan(
-      "cli.play_export_rows",
-      { targetKind: "name", playName },
-      () => exportPlayStatusRows(client, finalStatus, options.outPath, {
-        attempts: PLAY_RUN_OUT_EXPORT_ATTEMPTS,
-        retryDelayMs: PLAY_RUN_OUT_EXPORT_RETRY_DELAY_MS
-      })
-    );
     if (finalStatus.status === "completed") {
       progress.complete();
     } else {
@@ -7240,7 +7243,7 @@ async function handleNamedRun(options) {
     traceCliSync(
       "cli.play_write_result",
       { targetKind: "name", playName },
-      () => writePlayResult(finalStatus, options.jsonOutput, { exportedPath: exportResult?.path ?? null })
+      () => writePlayResult(finalStatus, options.jsonOutput)
     );
     return finalStatus.status === "completed" ? 0 : 1;
   }
@@ -8006,17 +8009,14 @@ Idempotent execution:
 Examples:
   deepline plays run my.play.ts --input '{"domain":"stripe.com"}' --watch
   deepline plays run my.play.ts --input @input.json --wait --json
-  deepline plays run enrich.play.ts --input '{"file":"leads.csv"}' --watch --out leads-enriched.csv
   deepline plays run person-linkedin-to-email --input '{"linkedin_url":"..."}' --watch
   deepline plays run cto-search.play.ts --limit 5 --watch
+  deepline runs export <run-id> --out output.csv
   deepline runs get <run-id>
 `
   ).option("--file <path>", "Local play file to run").option("--name <name>", "Saved play name to run").option("-i, --input <json>", "Input JSON object or @file path").option("--live", "Run the current live revision explicitly").option("--latest", "Run the newest saved revision, even if it is not live").option(
     "--revision-id <id>",
     "Run a specific saved revision instead of the live revision"
-  ).option(
-    "--out <path>",
-    "Write the completed row output to CSV; requires --watch"
   ).option("--watch", "Stream logs until completion").option("--wait", "Alias for --watch; stream logs until completion").option(
     "--logs",
     "When output is non-interactive, stream play logs to stderr while waiting"
@@ -8048,7 +8048,6 @@ Pass-through input flags:
       ...options.live ? ["--live"] : [],
       ...options.latest ? ["--latest"] : [],
       ...options.revisionId ? ["--revision-id", options.revisionId] : [],
-      ...options.out ? ["--out", options.out] : [],
       ...options.watch || options.wait ? ["--watch"] : [],
       ...options.logs ? ["--logs"] : [],
       ...options.tailTimeoutMs ? ["--tail-timeout-ms", options.tailTimeoutMs] : [],

package/dist/cli/index.mjs

@@ -243,8 +243,8 @@ function saveProjectDeeplineEnvValues(baseUrl, values, startDir = projectEnvStar
 }
 
 // src/version.ts
-var SDK_VERSION = "0.1.30";
-var SDK_API_CONTRACT = "2026-05-runs-v2-datasets";
+var SDK_VERSION = "0.1.31";
+var SDK_API_CONTRACT = "2026-05-runs-export-v3";
 
 // ../shared_libs/play-runtime/coordinator-headers.ts
 var COORDINATOR_INTERNAL_TOKEN_HEADER = "x-deepline-internal-token";
@@ -6371,7 +6371,7 @@ function stripProviderSpendFromBilling(value) {
   }
   return next;
 }
-function compactPlayStatus(status, options) {
+function compactPlayStatus(status) {
   const rowsInfo = extractCanonicalRowsInfo(status);
   const result = status && typeof status === "object" ? status.result : null;
   const warnings = buildRunWarnings(status, rowsInfo);
@@ -6400,7 +6400,6 @@ function compactPlayStatus(status, options) {
     ...error ? { error } : {},
     ...warnings.length > 0 ? { warnings } : {},
     ...result !== void 0 ? { result } : {},
-    ...options?.exportedPath ? { local: { csv_path: options.exportedPath } } : {},
     ...status.resultView ? { resultView: status.resultView } : {},
     ...datasetStats ? { dataset_stats: datasetStats } : {},
     ...billing ? { billing } : {},
@@ -6442,7 +6441,7 @@ function formatDatasetStatsLines(datasetStats) {
 }
 function writePlayResult(status, jsonOutput, options) {
   if (jsonOutput) {
-    const payload2 = options?.fullJson ? enrichPlayStatusWithDatasetStats(status) : compactPlayStatus(status, options);
+    const payload2 = options?.fullJson ? enrichPlayStatusWithDatasetStats(status) : compactPlayStatus(status);
     printCommandEnvelope({
       ...payload2,
       render: {
@@ -6472,9 +6471,6 @@ function writePlayResult(status, jsonOutput, options) {
     rowsInfo.columns,
     extractDatasetExecutionStats(status)
   ) : null;
-  if (options?.exportedPath) {
-    lines.push(`  exported CSV: file=${options.exportedPath}`);
-  }
   for (const warning of warnings) {
     lines.push(`  warning: ${warning}`);
   }
@@ -6492,7 +6488,7 @@ function writePlayResult(status, jsonOutput, options) {
     lines.push(...renderedServerView.lines);
   }
   lines.push(...renderedServerView.actions);
-  const payload = options?.fullJson ? enrichPlayStatusWithDatasetStats(status) : compactPlayStatus(status, options);
+  const payload = options?.fullJson ? enrichPlayStatusWithDatasetStats(status) : compactPlayStatus(status);
   printCommandEnvelope({
     ...payload,
     render: {
@@ -6502,8 +6498,6 @@ function writePlayResult(status, jsonOutput, options) {
 ` });
 }
 var RUN_EXPORT_PAGE_SIZE = 5e3;
-var PLAY_RUN_OUT_EXPORT_ATTEMPTS = 8;
-var PLAY_RUN_OUT_EXPORT_RETRY_DELAY_MS = 1e3;
 function shellSingleQuote(value) {
   return `'${value.replace(/'/g, `'\\''`)}'`;
 }
@@ -6552,6 +6546,27 @@ function exportableSheetRow(row) {
   }
   return fallback;
 }
+function mergeExportColumns(preferredColumns, rows) {
+  const columns = [];
+  const seen = /* @__PURE__ */ new Set();
+  for (const column of preferredColumns) {
+    if (!column || seen.has(column)) {
+      continue;
+    }
+    seen.add(column);
+    columns.push(column);
+  }
+  for (const row of rows) {
+    for (const column of Object.keys(row)) {
+      if (seen.has(column)) {
+        continue;
+      }
+      seen.add(column);
+      columns.push(column);
+    }
+  }
+  return columns;
+}
 async function fetchBackingDatasetRows(input) {
   const playName = extractRunPlayName(input.status);
   const tableNamespace = input.rowsInfo.tableNamespace?.trim();
@@ -6583,7 +6598,10 @@ async function fetchBackingDatasetRows(input) {
   if (rows.length < input.rowsInfo.totalRows) {
     return null;
   }
-  const columns = input.rowsInfo.columnsExplicit && input.rowsInfo.columns.length ? input.rowsInfo.columns : [...new Set(rows.flatMap((row) => Object.keys(row)))];
+  const columns = mergeExportColumns(
+    input.rowsInfo.columnsExplicit ? input.rowsInfo.columns : [],
+    rows
+  );
   return {
     ...input.rowsInfo,
     rows,
@@ -6625,20 +6643,27 @@ async function exportPlayStatusRows(client, status, outPath, options = {}) {
   const attempts = Math.max(1, Math.trunc(options.attempts ?? 1));
   const retryDelayMs = Math.max(0, Math.trunc(options.retryDelayMs ?? 0));
   for (let attempt = 1; attempt <= attempts; attempt += 1) {
-    if (rowsInfo.complete) {
-      return { path: writeCanonicalRowsCsv(rowsInfo, outPath), rowsInfo };
+    let fetchedRowsInfo = null;
+    try {
+      fetchedRowsInfo = await fetchBackingDatasetRows({
+        client,
+        status,
+        rowsInfo
+      });
+    } catch (error) {
+      if (!rowsInfo.complete) {
+        throw error;
+      }
     }
-    const fetchedRowsInfo = await fetchBackingDatasetRows({
-      client,
-      status,
-      rowsInfo
-    });
     if (fetchedRowsInfo?.complete) {
       return {
         path: writeCanonicalRowsCsv(fetchedRowsInfo, outPath),
         rowsInfo: fetchedRowsInfo
       };
     }
+    if (rowsInfo.complete) {
+      return { path: writeCanonicalRowsCsv(rowsInfo, outPath), rowsInfo };
+    }
     if (attempt < attempts && retryDelayMs > 0) {
       await sleep4(retryDelayMs);
     }
@@ -6766,7 +6791,7 @@ function writeStartedPlayRun(input) {
 ` });
 }
 function parsePlayRunOptions(args) {
-  const usage = "Usage: deepline plays run <play-name> [--input '{...}'] [--watch] [--out output.csv] [--tail-timeout-ms 30000] [--force] [--<input> value]\n       deepline plays run <play-file.ts> [--input '{...}'] [--watch] [--out output.csv] [--tail-timeout-ms 30000] [--force] [--<input> value]\n       deepline plays run --file <play-file.ts> [--input '{...}'] [--watch] [--out output.csv] [--tail-timeout-ms 30000] [--force] [--<input> value]\n       deepline plays run --name <name> [--input '{...}'] [--live|--latest|--revision-id <id>] [--watch] [--out output.csv] [--tail-timeout-ms 30000] [--force] [--no-open] [--json] [--<input> value]\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.map guidance.";
+  const usage = "Usage: deepline plays run <play-name> [--input '{...}'] [--watch] [--tail-timeout-ms 30000] [--force] [--<input> value]\n       deepline plays run <play-file.ts> [--input '{...}'] [--watch] [--tail-timeout-ms 30000] [--force] [--<input> value]\n       deepline plays run --file <play-file.ts> [--input '{...}'] [--watch] [--tail-timeout-ms 30000] [--force] [--<input> value]\n       deepline plays run --name <name> [--input '{...}'] [--live|--latest|--revision-id <id>] [--watch] [--tail-timeout-ms 30000] [--force] [--no-open] [--json] [--<input> value]\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.map guidance.";
   let filePath = null;
   let playName = null;
   let input = null;
@@ -6777,7 +6802,6 @@ function parsePlayRunOptions(args) {
   const emitLogs = !jsonOutput || args.includes("--logs");
   const force = args.includes("--force");
   const noOpen = args.includes("--no-open");
-  let outPath = null;
   let waitTimeoutMs = null;
   for (let index = 0; index < args.length; index += 1) {
     const arg = args[index];
@@ -6805,9 +6829,10 @@ function parsePlayRunOptions(args) {
       revisionSelector = "latest";
       continue;
     }
-    if (arg === "--out" && args[index + 1]) {
-      outPath = resolve8(args[++index]);
-      continue;
+    if (arg === "--out" || arg.startsWith("--out=")) {
+      throw new Error(
+        "--out is not a plays run flag. Run the play first, then export rows with: deepline runs export <run-id> --out output.csv"
+      );
     }
     if (arg === "--poll-interval-ms" || arg === "--interval-ms") {
       throw new Error(
@@ -6877,11 +6902,6 @@ function parsePlayRunOptions(args) {
       "--live, --latest, and --revision-id only apply to named plays."
     );
   }
-  if (outPath && !watch) {
-    throw new Error(
-      "--out requires --watch so the CLI can export the completed run output."
-    );
-  }
   return {
     target: filePath ? { kind: "file", path: filePath } : { kind: "name", name: playName },
     input,
@@ -6892,7 +6912,6 @@ function parsePlayRunOptions(args) {
     jsonOutput,
     waitTimeoutMs,
     force,
-    outPath,
     noOpen
   };
 }
@@ -7067,14 +7086,6 @@ async function handleFileBackedRun(options) {
         progress
       })
     );
-    const exportResult = await traceCliSpan(
-      "cli.play_export_rows",
-      { targetKind: "file", playName },
-      () => exportPlayStatusRows(client, finalStatus, options.outPath, {
-        attempts: PLAY_RUN_OUT_EXPORT_ATTEMPTS,
-        retryDelayMs: PLAY_RUN_OUT_EXPORT_RETRY_DELAY_MS
-      })
-    );
     if (finalStatus.status === "completed") {
       progress.complete();
     } else {
@@ -7083,7 +7094,7 @@ async function handleFileBackedRun(options) {
     traceCliSync(
       "cli.play_write_result",
       { targetKind: "file", playName },
-      () => writePlayResult(finalStatus, options.jsonOutput, { exportedPath: exportResult?.path ?? null })
+      () => writePlayResult(finalStatus, options.jsonOutput)
     );
     return finalStatus.status === "completed" ? 0 : 1;
   }
@@ -7211,14 +7222,6 @@ async function handleNamedRun(options) {
         progress
       })
     );
-    const exportResult = await traceCliSpan(
-      "cli.play_export_rows",
-      { targetKind: "name", playName },
-      () => exportPlayStatusRows(client, finalStatus, options.outPath, {
-        attempts: PLAY_RUN_OUT_EXPORT_ATTEMPTS,
-        retryDelayMs: PLAY_RUN_OUT_EXPORT_RETRY_DELAY_MS
-      })
-    );
     if (finalStatus.status === "completed") {
       progress.complete();
     } else {
@@ -7227,7 +7230,7 @@ async function handleNamedRun(options) {
     traceCliSync(
       "cli.play_write_result",
       { targetKind: "name", playName },
-      () => writePlayResult(finalStatus, options.jsonOutput, { exportedPath: exportResult?.path ?? null })
+      () => writePlayResult(finalStatus, options.jsonOutput)
     );
     return finalStatus.status === "completed" ? 0 : 1;
   }
@@ -7993,17 +7996,14 @@ Idempotent execution:
 Examples:
   deepline plays run my.play.ts --input '{"domain":"stripe.com"}' --watch
   deepline plays run my.play.ts --input @input.json --wait --json
-  deepline plays run enrich.play.ts --input '{"file":"leads.csv"}' --watch --out leads-enriched.csv
   deepline plays run person-linkedin-to-email --input '{"linkedin_url":"..."}' --watch
   deepline plays run cto-search.play.ts --limit 5 --watch
+  deepline runs export <run-id> --out output.csv
   deepline runs get <run-id>
 `
   ).option("--file <path>", "Local play file to run").option("--name <name>", "Saved play name to run").option("-i, --input <json>", "Input JSON object or @file path").option("--live", "Run the current live revision explicitly").option("--latest", "Run the newest saved revision, even if it is not live").option(
     "--revision-id <id>",
     "Run a specific saved revision instead of the live revision"
-  ).option(
-    "--out <path>",
-    "Write the completed row output to CSV; requires --watch"
   ).option("--watch", "Stream logs until completion").option("--wait", "Alias for --watch; stream logs until completion").option(
     "--logs",
     "When output is non-interactive, stream play logs to stderr while waiting"
@@ -8035,7 +8035,6 @@ Pass-through input flags:
       ...options.live ? ["--live"] : [],
       ...options.latest ? ["--latest"] : [],
       ...options.revisionId ? ["--revision-id", options.revisionId] : [],
-      ...options.out ? ["--out", options.out] : [],
       ...options.watch || options.wait ? ["--watch"] : [],
       ...options.logs ? ["--logs"] : [],
       ...options.tailTimeoutMs ? ["--tail-timeout-ms", options.tailTimeoutMs] : [],

package/dist/index.d.mts

@@ -1438,8 +1438,8 @@ declare class DeeplineClient {
     }>;
 }
 
-declare const SDK_VERSION = "0.1.30";
-declare const SDK_API_CONTRACT = "2026-05-runs-v2-datasets";
+declare const SDK_VERSION = "0.1.31";
+declare const SDK_API_CONTRACT = "2026-05-runs-export-v3";
 
 /**
  * Base error class for all Deepline SDK errors.

package/dist/index.d.ts

@@ -1438,8 +1438,8 @@ declare class DeeplineClient {
     }>;
 }
 
-declare const SDK_VERSION = "0.1.30";
-declare const SDK_API_CONTRACT = "2026-05-runs-v2-datasets";
+declare const SDK_VERSION = "0.1.31";
+declare const SDK_API_CONTRACT = "2026-05-runs-export-v3";
 
 /**
  * Base error class for all Deepline SDK errors.

package/dist/index.js

@@ -241,8 +241,8 @@ function resolveConfig(options) {
 }
 
 // src/version.ts
-var SDK_VERSION = "0.1.30";
-var SDK_API_CONTRACT = "2026-05-runs-v2-datasets";
+var SDK_VERSION = "0.1.31";
+var SDK_API_CONTRACT = "2026-05-runs-export-v3";
 
 // ../shared_libs/play-runtime/coordinator-headers.ts
 var COORDINATOR_INTERNAL_TOKEN_HEADER = "x-deepline-internal-token";

package/dist/index.mjs

@@ -195,8 +195,8 @@ function resolveConfig(options) {
 }
 
 // src/version.ts
-var SDK_VERSION = "0.1.30";
-var SDK_API_CONTRACT = "2026-05-runs-v2-datasets";
+var SDK_VERSION = "0.1.31";
+var SDK_API_CONTRACT = "2026-05-runs-export-v3";
 
 // ../shared_libs/play-runtime/coordinator-headers.ts
 var COORDINATOR_INTERNAL_TOKEN_HEADER = "x-deepline-internal-token";

package/dist/repo/sdk/src/version.ts

@@ -1,2 +1,2 @@
-export const SDK_VERSION = "0.1.30";
-export const SDK_API_CONTRACT = "2026-05-runs-v2-datasets";
+export const SDK_VERSION = "0.1.31";
+export const SDK_API_CONTRACT = "2026-05-runs-export-v3";

package/package.json

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