deepline 0.3.409 → 0.3.410

package/dist/cli/chunk-ZCALLYF6.mjs

@@ -0,0 +1,62 @@
+// ../plays/fetch-http-error.ts
+var CtxFetchHttpError = class extends Error {
+  /** Build the error from the durable response record. */
+  constructor(response) {
+    const body = response.bodyText || "empty response body";
+    super(
+      `ctx.fetch(${response.url}) returned HTTP ${response.status}${response.statusText ? ` ${response.statusText}` : ""}: ${body}`
+    );
+    this.response = response;
+    this.name = "CtxFetchHttpError";
+    this.status = response.status;
+    this.statusText = response.statusText;
+    this.url = response.url;
+    this.headers = response.headers;
+    this.bodyText = response.bodyText;
+    this.json = response.json;
+  }
+  /**
+   * Play source and the runtime are separately bundled. Recognize the stable
+   * public error code so `instanceof` works across that boundary as well.
+   */
+  static [Symbol.hasInstance](value) {
+    return value !== null && typeof value === "object" && value.code === "CTX_FETCH_HTTP_ERROR";
+  }
+  /** Stable machine-readable HTTP-failure code. */
+  code = "CTX_FETCH_HTTP_ERROR";
+  /** Upstream HTTP status. */
+  status;
+  /** Upstream HTTP status text. */
+  statusText;
+  /** Final response URL after redirects. */
+  url;
+  /** Secret-redacted response headers. */
+  headers;
+  /** Complete secret-redacted response body. */
+  bodyText;
+  /** Eagerly parsed secret-redacted JSON, or null. */
+  json;
+};
+
+// ../plays/ambiguous-write-error.ts
+var CtxFetchAmbiguousWriteError = class extends Error {
+  constructor(method, origin, options) {
+    super(
+      `ctx.fetch ${method} to ${origin} was dispatched, but its outcome is unknown. Reconcile with the provider or retry only under its supported idempotency contract using the same intended-operation key.`,
+      options
+    );
+    this.method = method;
+    this.origin = origin;
+    this.name = "CtxFetchAmbiguousWriteError";
+  }
+  static [Symbol.hasInstance](value) {
+    return value !== null && typeof value === "object" && value.code === "CTX_FETCH_WRITE_OUTCOME_UNKNOWN";
+  }
+  code = "CTX_FETCH_WRITE_OUTCOME_UNKNOWN";
+  outcome = "unknown";
+};
+
+export {
+  CtxFetchHttpError,
+  CtxFetchAmbiguousWriteError
+};

package/dist/cli/{chunk-WHG43Z67.js → chunk-ZFZ427HN.js}

@@ -1,10 +1,10 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _nullishCoalesce(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return rhsFn(); } } function _optionalChain(ops) { let lastAccessLHS = undefined; let value = ops[0]; let i = 1; while (i < ops.length) { const op = ops[i]; const fn = ops[i + 1]; i += 2; if ((op === 'optionalAccess' || op === 'optionalCall') && value == null) { return undefined; } if (op === 'access' || op === 'optionalAccess') { lastAccessLHS = value; value = fn(value); } else if (op === 'call' || op === 'optionalCall') { value = fn((...args) => value.call(lastAccessLHS, ...args)); lastAccessLHS = undefined; } } return value; }
 
 
-var _chunkYD7B53RWjs = require('./chunk-YD7B53RW.js');
+var _chunkNF4V5DTYjs = require('./chunk-NF4V5DTY.js');
 
 
-var _chunkFJCIUF34js = require('./chunk-FJCIUF34.js');
+var _chunkFVLNYDI4js = require('./chunk-FVLNYDI4.js');
 
 // src/cli/commands/sessions.ts
 
@@ -139,7 +139,10 @@ function currentSessionFile(agent) {
   const newestFirst = listSessionFiles(agent).sort(
     (a, b) => b.mtimeMs - a.mtimeMs
   );
-  const sessionId = _chunkFJCIUF34js.agentSessionIdFromEnvironment.call(void 0, );
+  const sessionId = _chunkFVLNYDI4js.agentSessionIdFromEnvironment.call(void 0, 
+    process.env,
+    agent === "auto" ? void 0 : agent === "claude" ? "claude_code" : "codex"
+  );
   const cwd = process.cwd();
   return _nullishCoalesce(_nullishCoalesce(_nullishCoalesce(newestFirst.find((candidate) => candidate.sessionId === sessionId), () => ( newestFirst.find(
     (candidate) => sessionStartedInDirectory(candidate, cwd)
@@ -448,7 +451,7 @@ function buildSessionUploadContent(raw) {
   return { encodedContent: encoded, needsChunking: true };
 }
 async function uploadPayload(path, payload) {
-  const { http } = _chunkYD7B53RWjs.getAuthedHttpClient.call(void 0, );
+  const { http } = _chunkNF4V5DTYjs.getAuthedHttpClient.call(void 0, );
   return await http.post(path, payload);
 }
 async function uploadChunkedSessions(sessions, options) {
@@ -481,7 +484,7 @@ async function uploadChunkedSessions(sessions, options) {
     ...options.rating ? { rating: options.rating } : {}
   });
   const sessionIds = sessions.map((session) => session.sessionId);
-  _chunkYD7B53RWjs.printCommandEnvelope.call(void 0, 
+  _chunkNF4V5DTYjs.printCommandEnvelope.call(void 0, 
     {
       ...response,
       ok: true,
@@ -513,7 +516,7 @@ async function handleSessionsSend(options) {
       filename: _path.basename.call(void 0, filePath),
       ...rating ? { rating } : {}
     });
-    _chunkYD7B53RWjs.printCommandEnvelope.call(void 0, 
+    _chunkNF4V5DTYjs.printCommandEnvelope.call(void 0, 
       {
         ...response2,
         ok: true,
@@ -563,7 +566,7 @@ async function handleSessionsSend(options) {
     ...rating ? { rating } : {}
   });
   const sessionIds = built.map((session) => session.sessionId);
-  _chunkYD7B53RWjs.printCommandEnvelope.call(void 0, 
+  _chunkNF4V5DTYjs.printCommandEnvelope.call(void 0, 
     {
       ...response,
       ok: true,
@@ -671,7 +674,7 @@ ${refreshMeta}
 </body>
 </html>`;
   _fs.writeFileSync.call(void 0, outputPath, html, "utf8");
-  _chunkYD7B53RWjs.printCommandEnvelope.call(void 0, 
+  _chunkNF4V5DTYjs.printCommandEnvelope.call(void 0, 
     {
       ok: true,
       file: outputPath,

package/dist/cli/{chunk-J6DCKJNM.mjs → chunk-ZKYEW55U.mjs}

@@ -1,6 +1,18 @@
 import {
   writeRawStderr
-} from "./chunk-JRAVVJ3T.mjs";
+} from "./chunk-5V5Y37BC.mjs";
+
+// src/cli/maintenance-policy.ts
+import { InvalidArgumentError } from "commander";
+function parseCliMaintenancePolicy(value) {
+  if (value === "configured" || value === "off") return value;
+  throw new InvalidArgumentError(
+    "Maintenance policy must be configured or off."
+  );
+}
+function resolveCliMaintenancePolicy(input) {
+  return input.dryRun ? "off" : input.maintenance ?? "configured";
+}
 
 // src/cli/trace.ts
 var cliTraceStartedAt = Date.now();
@@ -51,6 +63,9 @@ async function traceCliSpan(phase, fields, run) {
 }
 
 export {
+  parseCliMaintenancePolicy,
+  resolveCliMaintenancePolicy,
+  isCliTraceEnabled,
   recordCliTrace,
   traceCliSpan
 };

package/dist/cli/{csv-BBOTCGQY.js → csv-7U3FJYKZ.js}

@@ -4,12 +4,12 @@
 
 
 
-var _chunkYD7B53RWjs = require('./chunk-YD7B53RW.js');
-require('./chunk-FJCIUF34.js');
-require('./chunk-Q2E4E4FJ.js');
+var _chunkNF4V5DTYjs = require('./chunk-NF4V5DTY.js');
+require('./chunk-FVLNYDI4.js');
+require('./chunk-NPBJI7RE.js');
 require('./chunk-XNYIZMNQ.js');
-require('./chunk-7P5AA3SN.js');
-require('./chunk-DEC3JECC.js');
+require('./chunk-PPDBRJRW.js');
+require('./chunk-5UUQAGJS.js');
 require('./chunk-OG64RBAC.js');
 require('./chunk-COGTRVWW.js');
 
@@ -127,7 +127,7 @@ function renderTable(rows, totalRows, verbose, footer = `showing ${rows.length}
         column.length,
         ...rows.map((row) => {
           const value = _nullishCoalesce(row[column], () => ( ""));
-          return (verbose ? value : _chunkYD7B53RWjs.clip.call(void 0, value, 42)).length;
+          return (verbose ? value : _chunkNF4V5DTYjs.clip.call(void 0, value, 42)).length;
         })
       )
     ])
@@ -137,7 +137,7 @@ function renderTable(rows, totalRows, verbose, footer = `showing ${rows.length}
   const body = rows.map(
     (row) => columns.map((column) => {
       const raw = _nullishCoalesce(row[column], () => ( ""));
-      const display = verbose ? raw : _chunkYD7B53RWjs.clip.call(void 0, raw, 42);
+      const display = verbose ? raw : _chunkNF4V5DTYjs.clip.call(void 0, raw, 42);
       return display.padEnd(widths[column]);
     }).join(" | ")
   );
@@ -157,7 +157,7 @@ async function handleCsvShow(path, options, command) {
       { exitCode: 2 }
     );
   }
-  const allRows = _chunkYD7B53RWjs.readCsvRows.call(void 0, csvPath);
+  const allRows = _chunkNF4V5DTYjs.readCsvRows.call(void 0, csvPath);
   const [rowStart, rowEnd] = parseRowRange(options.rows);
   const rows = options.summary && options.rows === void 0 ? allRows : selectRows(allRows, rowStart, rowEnd);
   const { rows: selected, columns } = selectColumns(
@@ -170,7 +170,7 @@ async function handleCsvShow(path, options, command) {
   if (options.summary) {
     const summaries = summarizeColumns(selected, columns);
     if (format === "json") {
-      _chunkYD7B53RWjs.printJson.call(void 0, {
+      _chunkNF4V5DTYjs.printJson.call(void 0, {
         rows: summaries,
         total_rows: selected.length,
         source_total_rows: allRows.length
@@ -179,7 +179,7 @@ async function handleCsvShow(path, options, command) {
     }
     const displayRows = summaryDisplayRows(summaries);
     if (format === "csv") {
-      process.stdout.write(_chunkYD7B53RWjs.csvStringFromRows.call(void 0, displayRows));
+      process.stdout.write(_chunkNF4V5DTYjs.csvStringFromRows.call(void 0, displayRows));
       return;
     }
     process.stdout.write(
@@ -194,7 +194,7 @@ async function handleCsvShow(path, options, command) {
     return;
   }
   if (format === "json") {
-    _chunkYD7B53RWjs.printJson.call(void 0, {
+    _chunkNF4V5DTYjs.printJson.call(void 0, {
       rows: selected.map((row, index) => ({ __row: rowStart + index, ...row }))
     });
     return;
@@ -437,7 +437,7 @@ async function handleCsvRenderStart(options) {
       if (log) {
         detail = `
 CSV render log:
-${_chunkYD7B53RWjs.clip.call(void 0, log, 2e3)}`;
+${_chunkNF4V5DTYjs.clip.call(void 0, log, 2e3)}`;
       }
     } catch (e7) {
     }
@@ -488,7 +488,7 @@ async function handleCsvRenderStatus(options) {
   if (payload.pid) lines.push(`Render PID: ${payload.pid}`);
   if (payload.url) lines.push(`Render URL: ${payload.url}`);
   lines.push(`Render Health: ${payload.health_status}`);
-  _chunkYD7B53RWjs.printCommandEnvelope.call(void 0, payload, {
+  _chunkNF4V5DTYjs.printCommandEnvelope.call(void 0, payload, {
     json: options.json,
     text: `${lines.join("\n")}
 `
@@ -524,7 +524,7 @@ async function handleCsvRenderStop(options) {
   };
   const text = stopped.length > 0 ? `Stopped CSV render process(es): ${stopped.join(" ")}
 ` : "No running CSV render process found.\n";
-  _chunkYD7B53RWjs.printCommandEnvelope.call(void 0, payload, { json: options.json, text });
+  _chunkNF4V5DTYjs.printCommandEnvelope.call(void 0, payload, { json: options.json, text });
 }
 async function handleCsvRender(action, options) {
   const normalized = _nullishCoalesce(action, () => ( "start"));

package/dist/cli/{csv-A2MP6EFV.mjs → csv-ZWLDMM4A.mjs}

@@ -4,12 +4,12 @@ import {
   printCommandEnvelope,
   printJson,
   readCsvRows
-} from "./chunk-JRAVVJ3T.mjs";
-import "./chunk-2PRO2JTX.mjs";
-import "./chunk-YHPYUZZX.mjs";
+} from "./chunk-5V5Y37BC.mjs";
+import "./chunk-RFB25DSQ.mjs";
+import "./chunk-MAMVGOSC.mjs";
 import "./chunk-DLIRSHV6.mjs";
-import "./chunk-NXGCO4JB.mjs";
-import "./chunk-TQNHMWUR.mjs";
+import "./chunk-E4IXDAZI.mjs";
+import "./chunk-2YR7BIIC.mjs";
 import "./chunk-WZYKRD7T.mjs";
 import "./chunk-KRD6H754.mjs";
 

package/dist/cli/{db-G4CODDCA.js → db-DNCGV5PC.js}

@@ -4,9 +4,9 @@ var _chunkAID3OYVJjs = require('./chunk-AID3OYVJ.js');
 
 
 
-var _chunkV76R6HMVjs = require('./chunk-V76R6HMV.js');
-require('./chunk-S6R3OX7B.js');
-require('./chunk-UHNDVD3P.js');
+var _chunk63S7X326js = require('./chunk-63S7X326.js');
+require('./chunk-E4CABWXL.js');
+require('./chunk-2H4EY7KH.js');
 require('./chunk-KXMNM4AQ.js');
 require('./chunk-XDVT3GOM.js');
 
@@ -18,16 +18,16 @@ require('./chunk-XDVT3GOM.js');
 
 
 
-var _chunkYD7B53RWjs = require('./chunk-YD7B53RW.js');
-require('./chunk-FJCIUF34.js');
+var _chunkNF4V5DTYjs = require('./chunk-NF4V5DTY.js');
+require('./chunk-FVLNYDI4.js');
 
 
-var _chunkQ2E4E4FJjs = require('./chunk-Q2E4E4FJ.js');
+var _chunkNPBJI7REjs = require('./chunk-NPBJI7RE.js');
 require('./chunk-XNYIZMNQ.js');
 
 
-var _chunk7P5AA3SNjs = require('./chunk-7P5AA3SN.js');
-require('./chunk-DEC3JECC.js');
+var _chunkPPDBRJRWjs = require('./chunk-PPDBRJRW.js');
+require('./chunk-5UUQAGJS.js');
 require('./chunk-OG64RBAC.js');
 require('./chunk-COGTRVWW.js');
 
@@ -50,8 +50,8 @@ function formatCell(value) {
   return text.length > 80 ? `${text.slice(0, 77)}...` : text;
 }
 function tableLines(result) {
-  const rows = _chunkYD7B53RWjs.dataExportRows.call(void 0, customerDbRows(result));
-  const responseColumns = _chunkYD7B53RWjs.dataExportColumns.call(void 0, 
+  const rows = _chunkNF4V5DTYjs.dataExportRows.call(void 0, customerDbRows(result));
+  const responseColumns = _chunkNF4V5DTYjs.dataExportColumns.call(void 0, 
     rows,
     customerDbColumnNames(result)
   );
@@ -70,7 +70,7 @@ function tableLines(result) {
       `Showing ${columns.length}/${responseColumns.length} columns; hidden metadata: ${hiddenColumns.join(", ")}`
     );
     lines.push(
-      "Select metadata columns explicitly when you need run ids/errors/stages."
+      "Use --json or select metadata columns explicitly when you need run ids/errors/stages."
     );
   }
   if (rows.length === 0) {
@@ -97,7 +97,7 @@ function tableLines(result) {
   return lines;
 }
 function customerDbRows(result) {
-  return _chunkYD7B53RWjs.recordRows.call(void 0, result.rows);
+  return _chunkNF4V5DTYjs.recordRows.call(void 0, result.rows);
 }
 function customerDbColumnNames(result) {
   return result.columns.map((column) => column.name).filter(Boolean);
@@ -119,29 +119,29 @@ function collectErrorText(value) {
   ].filter(Boolean).join("\n");
 }
 function formatDbQueryError(sql, error) {
-  const text = error instanceof _chunkQ2E4E4FJjs.CustomerDbQueryOutcomeUnknownError ? collectErrorText(error.cause) : collectErrorText(error);
+  const text = error instanceof _chunkNPBJI7REjs.CustomerDbQueryOutcomeUnknownError ? collectErrorText(error.cause) : collectErrorText(error);
   const lower = text.toLowerCase();
   const referencesStorage = /"storage"\.|storage\./i.test(sql);
   const runIdColumnMissing = /column\s+"?run_id"?\s+does not exist/i.test(text) || /run_id.*does not exist/i.test(lower);
   const relationMissing = /relation\s+["']?[^"']*storage[^"']*["']?\s+does not exist/i.test(text) || /42p01/i.test(text);
   if (referencesStorage && relationMissing) {
     return [
-      ...error instanceof _chunkQ2E4E4FJjs.CustomerDbQueryOutcomeUnknownError ? [error.message] : [],
-      error instanceof _chunkQ2E4E4FJjs.CustomerDbQueryOutcomeUnknownError ? "The server reported that the referenced storage table does not exist." : "Customer DB query failed: the referenced storage table does not exist.",
+      ...error instanceof _chunkNPBJI7REjs.CustomerDbQueryOutcomeUnknownError ? [error.message] : [],
+      error instanceof _chunkNPBJI7REjs.CustomerDbQueryOutcomeUnknownError ? "The server reported that the referenced storage table does not exist." : "Customer DB query failed: the referenced storage table does not exist.",
       "Play dataset tables are created only when the corresponding ctx.dataset(...).run(...) call executes. Pilot branches, early returns, and runs that fail before the dataset do not create that table.",
-      "Use `deepline runs get <run-id> --full` to inspect returned dataset handles, then export them with `deepline runs export <run-id> --dataset result.rows --out rows.csv`.",
+      "Use `deepline runs get <run-id> --full --json` to inspect returned dataset handles, then export them with `deepline runs export <run-id> --dataset result.rows --out rows.csv`.",
       `Original error: ${errorMessage(error)}`
     ].join("\n");
   }
   if (referencesStorage && runIdColumnMissing) {
     return [
-      ...error instanceof _chunkQ2E4E4FJjs.CustomerDbQueryOutcomeUnknownError ? [error.message] : [],
+      ...error instanceof _chunkNPBJI7REjs.CustomerDbQueryOutcomeUnknownError ? [error.message] : [],
       "Customer DB query failed: storage dataset tables use `_run_id`, not `run_id`.",
       "Prefer `deepline runs export <run-id> --dataset result.rows --out rows.csv` unless you are doing deep table debugging.",
       `Original error: ${errorMessage(error)}`
     ].join("\n");
   }
-  if (error instanceof _chunk7P5AA3SNjs.DeeplineError) {
+  if (error instanceof _chunkPPDBRJRWjs.DeeplineError) {
     return error.message;
   }
   return errorMessage(error);
@@ -150,7 +150,7 @@ function writeCustomerDbCsv(result, outPath) {
   const resolved = _path.resolve.call(void 0, outPath);
   _fs.writeFileSync.call(void 0, 
     resolved,
-    _chunkYD7B53RWjs.dataExportCsvString.call(void 0, customerDbRows(result), customerDbColumnNames(result)),
+    _chunkNF4V5DTYjs.dataExportCsvString.call(void 0, customerDbRows(result), customerDbColumnNames(result)),
     "utf-8"
   );
   return resolved;
@@ -191,18 +191,18 @@ function dbQueryExportEnvelope(input) {
 function renderDbQueryResult(result, query, options) {
   const { sql, maxRows, operationKey } = query;
   const { format, out: outPath, json: explicitJsonOutput = false } = options;
-  const jsonOutput = explicitJsonOutput || _chunkYD7B53RWjs.shouldEmitJson.call(void 0, );
+  const jsonOutput = explicitJsonOutput || _chunkNF4V5DTYjs.shouldEmitJson.call(void 0, );
   const toolPayload = JSON.stringify({
     sql,
     result_mode: "rows",
     ...maxRows ? { max_rows: maxRows } : {},
     ...operationKey !== void 0 ? { operation_key: operationKey } : {}
   });
-  const toolCommand = `deepline tools execute query_customer_db --payload ${_chunkAID3OYVJjs.shellQuote.call(void 0, toolPayload)}`;
+  const toolCommand = `deepline tools execute query_customer_db --payload ${_chunkAID3OYVJjs.shellQuote.call(void 0, toolPayload)} --json`;
   if (format === "csv") {
     if (outPath) {
       const exportedPath = writeCustomerDbCsv(result, outPath);
-      _chunkYD7B53RWjs.printCommandEnvelope.call(void 0, 
+      _chunkNF4V5DTYjs.printCommandEnvelope.call(void 0, 
         dbQueryExportEnvelope({
           result,
           format,
@@ -218,7 +218,7 @@ function renderDbQueryResult(result, query, options) {
       );
       return;
     }
-    _chunkYD7B53RWjs.printCommandEnvelope.call(void 0, 
+    _chunkNF4V5DTYjs.printCommandEnvelope.call(void 0, 
       dbQueryExportEnvelope({
         result,
         format,
@@ -228,7 +228,7 @@ function renderDbQueryResult(result, query, options) {
       }),
       {
         json: explicitJsonOutput,
-        text: _chunkYD7B53RWjs.dataExportCsvString.call(void 0, 
+        text: _chunkNF4V5DTYjs.dataExportCsvString.call(void 0, 
           customerDbRows(result),
           customerDbColumnNames(result)
         )
@@ -237,14 +237,14 @@ function renderDbQueryResult(result, query, options) {
     return;
   }
   if (format === "markdown") {
-    const content = _chunkYD7B53RWjs.markdownTableFromRows.call(void 0, 
+    const content = _chunkNF4V5DTYjs.markdownTableFromRows.call(void 0, 
       customerDbRows(result),
       customerDbColumnNames(result)
     );
     if (outPath) {
       const exportedPath = _path.resolve.call(void 0, outPath);
       _fs.writeFileSync.call(void 0, exportedPath, content, "utf-8");
-      _chunkYD7B53RWjs.printCommandEnvelope.call(void 0, 
+      _chunkNF4V5DTYjs.printCommandEnvelope.call(void 0, 
         dbQueryExportEnvelope({
           result,
           format,
@@ -260,7 +260,7 @@ function renderDbQueryResult(result, query, options) {
       );
       return;
     }
-    _chunkYD7B53RWjs.printCommandEnvelope.call(void 0, 
+    _chunkNF4V5DTYjs.printCommandEnvelope.call(void 0, 
       dbQueryExportEnvelope({
         result,
         format,
@@ -275,7 +275,7 @@ function renderDbQueryResult(result, query, options) {
     );
     return;
   }
-  _chunkYD7B53RWjs.printCommandEnvelope.call(void 0, 
+  _chunkNF4V5DTYjs.printCommandEnvelope.call(void 0, 
     {
       ...result,
       next: {
@@ -349,9 +349,9 @@ async function runDbQueryCommand(options) {
       ...maxRows === void 0 ? {} : { maxRows },
       ...operationKey === void 0 ? {} : { operationKey }
     };
-    const plan = _chunkV76R6HMVjs.planCustomerDbQuery.call(void 0, query);
+    const plan = _chunk63S7X326js.planCustomerDbQuery.call(void 0, query);
     if (options.dryRun) {
-      _chunkYD7B53RWjs.printCommandEnvelope.call(void 0, 
+      _chunkNF4V5DTYjs.printCommandEnvelope.call(void 0, 
         {
           dryRun: true,
           ...plan,
@@ -364,11 +364,11 @@ async function runDbQueryCommand(options) {
             ...out === void 0 ? {} : { file: _path.resolve.call(void 0, out) }
           }
         },
-        { json: options.json || _chunkYD7B53RWjs.shouldEmitJson.call(void 0, ) }
+        { json: options.json || _chunkNF4V5DTYjs.shouldEmitJson.call(void 0, ) }
       );
       return 0;
     }
-    const client = new (0, _chunkV76R6HMVjs.DeeplineClient)();
+    const client = new (0, _chunk63S7X326js.DeeplineClient)();
     const result = await client.db.query(query);
     renderDbQueryResult(result, query, {
       format,
@@ -377,8 +377,8 @@ async function runDbQueryCommand(options) {
     });
     return 0;
   } catch (error) {
-    if (error instanceof _chunkQ2E4E4FJjs.CustomerDbQueryOutcomeUnknownError && (options.json || _chunkYD7B53RWjs.shouldEmitJson.call(void 0, ))) {
-      _chunkYD7B53RWjs.printCommandEnvelope.call(void 0, 
+    if (error instanceof _chunkNPBJI7REjs.CustomerDbQueryOutcomeUnknownError && (options.json || _chunkNF4V5DTYjs.shouldEmitJson.call(void 0, ))) {
+      _chunkNF4V5DTYjs.printCommandEnvelope.call(void 0, 
         {
           ok: false,
           error: {
@@ -426,15 +426,15 @@ function dbRepairPlainText(result) {
 async function handleDbRepair(args) {
   const providerIndex = args.indexOf("--provider");
   const provider = providerIndex >= 0 ? _optionalChain([args, 'access', _9 => _9[providerIndex + 1], 'optionalAccess', _10 => _10.trim, 'call', _11 => _11()]) : void 0;
-  const jsonOutput = _chunkYD7B53RWjs.argsWantJson.call(void 0, args);
-  const client = new (0, _chunkV76R6HMVjs.DeeplineClient)();
+  const jsonOutput = _chunkNF4V5DTYjs.argsWantJson.call(void 0, args);
+  const client = new (0, _chunk63S7X326js.DeeplineClient)();
   let result;
   try {
     result = await client.repairIngestionStorage(
       provider ? { provider } : void 0
     );
   } catch (error) {
-    if (error instanceof _chunk7P5AA3SNjs.DeeplineError && error.statusCode === 403) {
+    if (error instanceof _chunkPPDBRJRWjs.DeeplineError && error.statusCode === 403) {
       console.error(
         "deepline db repair requires org admin. Ask an organization admin to run it."
       );
@@ -443,7 +443,7 @@ async function handleDbRepair(args) {
     console.error(errorMessage2(error));
     return 1;
   }
-  _chunkYD7B53RWjs.printCommandEnvelope.call(void 0, 
+  _chunkNF4V5DTYjs.printCommandEnvelope.call(void 0, 
     {
       command: "db repair",
       status: result.status,
@@ -503,7 +503,8 @@ Examples:
   --format csv and --format markdown are explicit data/display formats and can
   be written directly with --out.
   Effects: SQL may mutate customer storage; --out writes one local export. SQL does not spend credits.
-  SQL is attempted once, without automatic retries or URL failover. A lost response means unknown outcome.
+  Unkeyed SQL is attempted once, without retries or URL failover; a lost response means unknown outcome.
+  Keyed SQL can recover only with the same operation key and the server's matching atomic acknowledgement.
   For recoverable writes, choose --operation-key before execution. Recover with the original key,
   SQL and options; a new key starts a new operation. A key added afterward cannot recover unkeyed SQL.
   --dry-run shows this plan without executing SQL, exporting data, or maintaining the installation.
@@ -523,10 +524,7 @@ Examples:
   ).option("--max-rows <n>", "Maximum returned rows").option(
     "--operation-key <key>",
     "Recover this intended transactional SQL operation; separate intentions need separate keys"
-  ).option("--format <format>", "Output format: table, json, csv, or markdown").option("--out <path>", "Write csv or markdown output to a file").option(
-    "--json",
-    "Emit raw JSON response"
-  ).action(async (options) => {
+  ).option("--format <format>", "Output format: table, json, csv, or markdown").option("--out <path>", "Write csv or markdown output to a file").option("--json", "Emit raw JSON response").action(async (options) => {
     process.exitCode = await runDbQueryCommand(options);
   });
   db.command("repair").description(
@@ -546,10 +544,7 @@ Examples:
   ).option(
     "--provider <provider>",
     "Limit materialized-table repair to one provider"
-  ).option(
-    "--json",
-    "Emit raw JSON response"
-  ).action(async (options) => {
+  ).option("--json", "Emit raw JSON response").action(async (options) => {
     process.exitCode = await handleDbRepair([
       ...options.provider ? ["--provider", options.provider] : [],
       ...options.json ? ["--json"] : []

package/dist/cli/{db-3W5DMTUX.mjs → db-IMYXVMGI.mjs}

@@ -4,9 +4,9 @@ import {
 import {
   DeeplineClient,
   planCustomerDbQuery
-} from "./chunk-PBZYY7VZ.mjs";
-import "./chunk-6IKARAYD.mjs";
-import "./chunk-JI2B4RZP.mjs";
+} from "./chunk-4XQLVUC7.mjs";
+import "./chunk-L2VKAASU.mjs";
+import "./chunk-KCC3FKIW.mjs";
 import "./chunk-EIMG75BT.mjs";
 import "./chunk-UBKA33KY.mjs";
 import {
@@ -18,16 +18,16 @@ import {
   printCommandEnvelope,
   recordRows,
   shouldEmitJson
-} from "./chunk-JRAVVJ3T.mjs";
-import "./chunk-2PRO2JTX.mjs";
+} from "./chunk-5V5Y37BC.mjs";
+import "./chunk-RFB25DSQ.mjs";
 import {
   CustomerDbQueryOutcomeUnknownError
-} from "./chunk-YHPYUZZX.mjs";
+} from "./chunk-MAMVGOSC.mjs";
 import "./chunk-DLIRSHV6.mjs";
 import {
   DeeplineError
-} from "./chunk-NXGCO4JB.mjs";
-import "./chunk-TQNHMWUR.mjs";
+} from "./chunk-E4IXDAZI.mjs";
+import "./chunk-2YR7BIIC.mjs";
 import "./chunk-WZYKRD7T.mjs";
 import "./chunk-KRD6H754.mjs";
 
@@ -70,7 +70,7 @@ function tableLines(result) {
       `Showing ${columns.length}/${responseColumns.length} columns; hidden metadata: ${hiddenColumns.join(", ")}`
     );
     lines.push(
-      "Select metadata columns explicitly when you need run ids/errors/stages."
+      "Use --json or select metadata columns explicitly when you need run ids/errors/stages."
     );
   }
   if (rows.length === 0) {
@@ -129,7 +129,7 @@ function formatDbQueryError(sql, error) {
       ...error instanceof CustomerDbQueryOutcomeUnknownError ? [error.message] : [],
       error instanceof CustomerDbQueryOutcomeUnknownError ? "The server reported that the referenced storage table does not exist." : "Customer DB query failed: the referenced storage table does not exist.",
       "Play dataset tables are created only when the corresponding ctx.dataset(...).run(...) call executes. Pilot branches, early returns, and runs that fail before the dataset do not create that table.",
-      "Use `deepline runs get <run-id> --full` to inspect returned dataset handles, then export them with `deepline runs export <run-id> --dataset result.rows --out rows.csv`.",
+      "Use `deepline runs get <run-id> --full --json` to inspect returned dataset handles, then export them with `deepline runs export <run-id> --dataset result.rows --out rows.csv`.",
       `Original error: ${errorMessage(error)}`
     ].join("\n");
   }
@@ -198,7 +198,7 @@ function renderDbQueryResult(result, query, options) {
     ...maxRows ? { max_rows: maxRows } : {},
     ...operationKey !== void 0 ? { operation_key: operationKey } : {}
   });
-  const toolCommand = `deepline tools execute query_customer_db --payload ${shellQuote(toolPayload)}`;
+  const toolCommand = `deepline tools execute query_customer_db --payload ${shellQuote(toolPayload)} --json`;
   if (format === "csv") {
     if (outPath) {
       const exportedPath = writeCustomerDbCsv(result, outPath);
@@ -503,7 +503,8 @@ Examples:
   --format csv and --format markdown are explicit data/display formats and can
   be written directly with --out.
   Effects: SQL may mutate customer storage; --out writes one local export. SQL does not spend credits.
-  SQL is attempted once, without automatic retries or URL failover. A lost response means unknown outcome.
+  Unkeyed SQL is attempted once, without retries or URL failover; a lost response means unknown outcome.
+  Keyed SQL can recover only with the same operation key and the server's matching atomic acknowledgement.
   For recoverable writes, choose --operation-key before execution. Recover with the original key,
   SQL and options; a new key starts a new operation. A key added afterward cannot recover unkeyed SQL.
   --dry-run shows this plan without executing SQL, exporting data, or maintaining the installation.
@@ -523,10 +524,7 @@ Examples:
   ).option("--max-rows <n>", "Maximum returned rows").option(
     "--operation-key <key>",
     "Recover this intended transactional SQL operation; separate intentions need separate keys"
-  ).option("--format <format>", "Output format: table, json, csv, or markdown").option("--out <path>", "Write csv or markdown output to a file").option(
-    "--json",
-    "Emit raw JSON response"
-  ).action(async (options) => {
+  ).option("--format <format>", "Output format: table, json, csv, or markdown").option("--out <path>", "Write csv or markdown output to a file").option("--json", "Emit raw JSON response").action(async (options) => {
     process.exitCode = await runDbQueryCommand(options);
   });
   db.command("repair").description(
@@ -546,10 +544,7 @@ Examples:
   ).option(
     "--provider <provider>",
     "Limit materialized-table repair to one provider"
-  ).option(
-    "--json",
-    "Emit raw JSON response"
-  ).action(async (options) => {
+  ).option("--json", "Emit raw JSON response").action(async (options) => {
     process.exitCode = await handleDbRepair([
       ...options.provider ? ["--provider", options.provider] : [],
       ...options.json ? ["--json"] : []