deepline 0.3.372 → 0.3.374

package/dist/cli/{csv-UJ3M7NFP.js → csv-WSRTANXI.js}

@@ -4,11 +4,11 @@
 
 
 
-var _chunkVVFH745Ljs = require('./chunk-VVFH745L.js');
-require('./chunk-ML2ZY7YD.js');
+var _chunk3XKAOV74js = require('./chunk-3XKAOV74.js');
+require('./chunk-JK547IDB.js');
 require('./chunk-XNYIZMNQ.js');
 require('./chunk-7P5AA3SN.js');
-require('./chunk-DM5QUZJR.js');
+require('./chunk-NOSIMGZV.js');
 require('./chunk-OG64RBAC.js');
 require('./chunk-COGTRVWW.js');
 
@@ -126,7 +126,7 @@ function renderTable(rows, totalRows, verbose, footer = `showing ${rows.length}
         column.length,
         ...rows.map((row) => {
           const value = _nullishCoalesce(row[column], () => ( ""));
-          return (verbose ? value : _chunkVVFH745Ljs.clip.call(void 0, value, 42)).length;
+          return (verbose ? value : _chunk3XKAOV74js.clip.call(void 0, value, 42)).length;
         })
       )
     ])
@@ -136,7 +136,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 : _chunkVVFH745Ljs.clip.call(void 0, raw, 42);
+      const display = verbose ? raw : _chunk3XKAOV74js.clip.call(void 0, raw, 42);
       return display.padEnd(widths[column]);
     }).join(" | ")
   );
@@ -156,7 +156,7 @@ async function handleCsvShow(path, options, command) {
       { exitCode: 2 }
     );
   }
-  const allRows = _chunkVVFH745Ljs.readCsvRows.call(void 0, csvPath);
+  const allRows = _chunk3XKAOV74js.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(
@@ -169,7 +169,7 @@ async function handleCsvShow(path, options, command) {
   if (options.summary) {
     const summaries = summarizeColumns(selected, columns);
     if (format === "json") {
-      _chunkVVFH745Ljs.printJson.call(void 0, {
+      _chunk3XKAOV74js.printJson.call(void 0, {
         rows: summaries,
         total_rows: selected.length,
         source_total_rows: allRows.length
@@ -178,7 +178,7 @@ async function handleCsvShow(path, options, command) {
     }
     const displayRows = summaryDisplayRows(summaries);
     if (format === "csv") {
-      process.stdout.write(_chunkVVFH745Ljs.csvStringFromRows.call(void 0, displayRows));
+      process.stdout.write(_chunk3XKAOV74js.csvStringFromRows.call(void 0, displayRows));
       return;
     }
     process.stdout.write(
@@ -193,7 +193,7 @@ async function handleCsvShow(path, options, command) {
     return;
   }
   if (format === "json") {
-    _chunkVVFH745Ljs.printJson.call(void 0, {
+    _chunk3XKAOV74js.printJson.call(void 0, {
       rows: selected.map((row, index) => ({ __row: rowStart + index, ...row }))
     });
     return;
@@ -436,7 +436,7 @@ async function handleCsvRenderStart(options) {
       if (log) {
         detail = `
 CSV render log:
-${_chunkVVFH745Ljs.clip.call(void 0, log, 2e3)}`;
+${_chunk3XKAOV74js.clip.call(void 0, log, 2e3)}`;
       }
     } catch (e7) {
     }
@@ -487,7 +487,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}`);
-  _chunkVVFH745Ljs.printCommandEnvelope.call(void 0, payload, {
+  _chunk3XKAOV74js.printCommandEnvelope.call(void 0, payload, {
     json: options.json,
     text: `${lines.join("\n")}
 `
@@ -523,7 +523,7 @@ async function handleCsvRenderStop(options) {
   };
   const text = stopped.length > 0 ? `Stopped CSV render process(es): ${stopped.join(" ")}
 ` : "No running CSV render process found.\n";
-  _chunkVVFH745Ljs.printCommandEnvelope.call(void 0, payload, { json: options.json, text });
+  _chunk3XKAOV74js.printCommandEnvelope.call(void 0, payload, { json: options.json, text });
 }
 async function handleCsvRender(action, options) {
   const normalized = _nullishCoalesce(action, () => ( "start"));

package/dist/cli/{db-SIOWA63T.mjs → db-BH25DX2G.mjs}

@@ -4,7 +4,7 @@ import {
 import {
   DeeplineClient,
   planCustomerDbQuery
-} from "./chunk-2RC5JQ3C.mjs";
+} from "./chunk-A62HBMHY.mjs";
 import "./chunk-6IKARAYD.mjs";
 import "./chunk-CBVIJSHF.mjs";
 import {
@@ -16,15 +16,15 @@ import {
   printCommandEnvelope,
   recordRows,
   shouldEmitJson
-} from "./chunk-MIMV5LTU.mjs";
+} from "./chunk-NNYQ24O5.mjs";
 import {
   CustomerDbQueryOutcomeUnknownError
-} from "./chunk-FGHRRJ3D.mjs";
+} from "./chunk-VZSVYNZH.mjs";
 import "./chunk-DLIRSHV6.mjs";
 import {
   DeeplineError
 } from "./chunk-NXGCO4JB.mjs";
-import "./chunk-JAERLCMH.mjs";
+import "./chunk-IZVGMVNX.mjs";
 import "./chunk-WZYKRD7T.mjs";
 import "./chunk-KRD6H754.mjs";
 

package/dist/cli/{db-444XYOTV.js → db-JXZNMFCE.js}

@@ -4,7 +4,7 @@ var _chunkAID3OYVJjs = require('./chunk-AID3OYVJ.js');
 
 
 
-var _chunkRUYZAREBjs = require('./chunk-RUYZAREB.js');
+var _chunkHC5L6KGEjs = require('./chunk-HC5L6KGE.js');
 require('./chunk-S6R3OX7B.js');
 require('./chunk-LA46MMTL.js');
 
@@ -16,15 +16,15 @@ require('./chunk-LA46MMTL.js');
 
 
 
-var _chunkVVFH745Ljs = require('./chunk-VVFH745L.js');
+var _chunk3XKAOV74js = require('./chunk-3XKAOV74.js');
 
 
-var _chunkML2ZY7YDjs = require('./chunk-ML2ZY7YD.js');
+var _chunkJK547IDBjs = require('./chunk-JK547IDB.js');
 require('./chunk-XNYIZMNQ.js');
 
 
 var _chunk7P5AA3SNjs = require('./chunk-7P5AA3SN.js');
-require('./chunk-DM5QUZJR.js');
+require('./chunk-NOSIMGZV.js');
 require('./chunk-OG64RBAC.js');
 require('./chunk-COGTRVWW.js');
 
@@ -47,8 +47,8 @@ function formatCell(value) {
   return text.length > 80 ? `${text.slice(0, 77)}...` : text;
 }
 function tableLines(result) {
-  const rows = _chunkVVFH745Ljs.dataExportRows.call(void 0, customerDbRows(result));
-  const responseColumns = _chunkVVFH745Ljs.dataExportColumns.call(void 0, 
+  const rows = _chunk3XKAOV74js.dataExportRows.call(void 0, customerDbRows(result));
+  const responseColumns = _chunk3XKAOV74js.dataExportColumns.call(void 0, 
     rows,
     customerDbColumnNames(result)
   );
@@ -94,7 +94,7 @@ function tableLines(result) {
   return lines;
 }
 function customerDbRows(result) {
-  return _chunkVVFH745Ljs.recordRows.call(void 0, result.rows);
+  return _chunk3XKAOV74js.recordRows.call(void 0, result.rows);
 }
 function customerDbColumnNames(result) {
   return result.columns.map((column) => column.name).filter(Boolean);
@@ -116,15 +116,15 @@ function collectErrorText(value) {
   ].filter(Boolean).join("\n");
 }
 function formatDbQueryError(sql, error) {
-  const text = error instanceof _chunkML2ZY7YDjs.CustomerDbQueryOutcomeUnknownError ? collectErrorText(error.cause) : collectErrorText(error);
+  const text = error instanceof _chunkJK547IDBjs.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 _chunkML2ZY7YDjs.CustomerDbQueryOutcomeUnknownError ? [error.message] : [],
-      error instanceof _chunkML2ZY7YDjs.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 _chunkJK547IDBjs.CustomerDbQueryOutcomeUnknownError ? [error.message] : [],
+      error instanceof _chunkJK547IDBjs.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`.",
       `Original error: ${errorMessage(error)}`
@@ -132,7 +132,7 @@ function formatDbQueryError(sql, error) {
   }
   if (referencesStorage && runIdColumnMissing) {
     return [
-      ...error instanceof _chunkML2ZY7YDjs.CustomerDbQueryOutcomeUnknownError ? [error.message] : [],
+      ...error instanceof _chunkJK547IDBjs.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)}`
@@ -147,7 +147,7 @@ function writeCustomerDbCsv(result, outPath) {
   const resolved = _path.resolve.call(void 0, outPath);
   _fs.writeFileSync.call(void 0, 
     resolved,
-    _chunkVVFH745Ljs.dataExportCsvString.call(void 0, customerDbRows(result), customerDbColumnNames(result)),
+    _chunk3XKAOV74js.dataExportCsvString.call(void 0, customerDbRows(result), customerDbColumnNames(result)),
     "utf-8"
   );
   return resolved;
@@ -188,7 +188,7 @@ function dbQueryExportEnvelope(input) {
 function renderDbQueryResult(result, query, options) {
   const { sql, maxRows, operationKey } = query;
   const { format, out: outPath, json: explicitJsonOutput = false } = options;
-  const jsonOutput = explicitJsonOutput || _chunkVVFH745Ljs.shouldEmitJson.call(void 0, );
+  const jsonOutput = explicitJsonOutput || _chunk3XKAOV74js.shouldEmitJson.call(void 0, );
   const toolPayload = JSON.stringify({
     sql,
     result_mode: "rows",
@@ -199,7 +199,7 @@ function renderDbQueryResult(result, query, options) {
   if (format === "csv") {
     if (outPath) {
       const exportedPath = writeCustomerDbCsv(result, outPath);
-      _chunkVVFH745Ljs.printCommandEnvelope.call(void 0, 
+      _chunk3XKAOV74js.printCommandEnvelope.call(void 0, 
         dbQueryExportEnvelope({
           result,
           format,
@@ -215,7 +215,7 @@ function renderDbQueryResult(result, query, options) {
       );
       return;
     }
-    _chunkVVFH745Ljs.printCommandEnvelope.call(void 0, 
+    _chunk3XKAOV74js.printCommandEnvelope.call(void 0, 
       dbQueryExportEnvelope({
         result,
         format,
@@ -225,7 +225,7 @@ function renderDbQueryResult(result, query, options) {
       }),
       {
         json: explicitJsonOutput,
-        text: _chunkVVFH745Ljs.dataExportCsvString.call(void 0, 
+        text: _chunk3XKAOV74js.dataExportCsvString.call(void 0, 
           customerDbRows(result),
           customerDbColumnNames(result)
         )
@@ -234,14 +234,14 @@ function renderDbQueryResult(result, query, options) {
     return;
   }
   if (format === "markdown") {
-    const content = _chunkVVFH745Ljs.markdownTableFromRows.call(void 0, 
+    const content = _chunk3XKAOV74js.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");
-      _chunkVVFH745Ljs.printCommandEnvelope.call(void 0, 
+      _chunk3XKAOV74js.printCommandEnvelope.call(void 0, 
         dbQueryExportEnvelope({
           result,
           format,
@@ -257,7 +257,7 @@ function renderDbQueryResult(result, query, options) {
       );
       return;
     }
-    _chunkVVFH745Ljs.printCommandEnvelope.call(void 0, 
+    _chunk3XKAOV74js.printCommandEnvelope.call(void 0, 
       dbQueryExportEnvelope({
         result,
         format,
@@ -272,7 +272,7 @@ function renderDbQueryResult(result, query, options) {
     );
     return;
   }
-  _chunkVVFH745Ljs.printCommandEnvelope.call(void 0, 
+  _chunk3XKAOV74js.printCommandEnvelope.call(void 0, 
     {
       ...result,
       next: {
@@ -346,9 +346,9 @@ async function runDbQueryCommand(options) {
       ...maxRows === void 0 ? {} : { maxRows },
       ...operationKey === void 0 ? {} : { operationKey }
     };
-    const plan = _chunkRUYZAREBjs.planCustomerDbQuery.call(void 0, query);
+    const plan = _chunkHC5L6KGEjs.planCustomerDbQuery.call(void 0, query);
     if (options.dryRun) {
-      _chunkVVFH745Ljs.printCommandEnvelope.call(void 0, 
+      _chunk3XKAOV74js.printCommandEnvelope.call(void 0, 
         {
           dryRun: true,
           ...plan,
@@ -361,11 +361,11 @@ async function runDbQueryCommand(options) {
             ...out === void 0 ? {} : { file: _path.resolve.call(void 0, out) }
           }
         },
-        { json: options.json || _chunkVVFH745Ljs.shouldEmitJson.call(void 0, ) }
+        { json: options.json || _chunk3XKAOV74js.shouldEmitJson.call(void 0, ) }
       );
       return 0;
     }
-    const client = new (0, _chunkRUYZAREBjs.DeeplineClient)();
+    const client = new (0, _chunkHC5L6KGEjs.DeeplineClient)();
     const result = await client.db.query(query);
     renderDbQueryResult(result, query, {
       format,
@@ -374,8 +374,8 @@ async function runDbQueryCommand(options) {
     });
     return 0;
   } catch (error) {
-    if (error instanceof _chunkML2ZY7YDjs.CustomerDbQueryOutcomeUnknownError && (options.json || _chunkVVFH745Ljs.shouldEmitJson.call(void 0, ))) {
-      _chunkVVFH745Ljs.printCommandEnvelope.call(void 0, 
+    if (error instanceof _chunkJK547IDBjs.CustomerDbQueryOutcomeUnknownError && (options.json || _chunk3XKAOV74js.shouldEmitJson.call(void 0, ))) {
+      _chunk3XKAOV74js.printCommandEnvelope.call(void 0, 
         {
           ok: false,
           error: {
@@ -423,8 +423,8 @@ 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 = _chunkVVFH745Ljs.argsWantJson.call(void 0, args);
-  const client = new (0, _chunkRUYZAREBjs.DeeplineClient)();
+  const jsonOutput = _chunk3XKAOV74js.argsWantJson.call(void 0, args);
+  const client = new (0, _chunkHC5L6KGEjs.DeeplineClient)();
   let result;
   try {
     result = await client.repairIngestionStorage(
@@ -440,7 +440,7 @@ async function handleDbRepair(args) {
     console.error(errorMessage2(error));
     return 1;
   }
-  _chunkVVFH745Ljs.printCommandEnvelope.call(void 0, 
+  _chunk3XKAOV74js.printCommandEnvelope.call(void 0, 
     {
       command: "db repair",
       status: result.status,

package/dist/cli/{describe-RRBESS3S.js → describe-N2OBGVJM.js}

@@ -1,11 +1,11 @@
-"use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _nullishCoalesce(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return rhsFn(); } } async function _asyncNullishCoalesce(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return await rhsFn(); } }
+"use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _nullishCoalesce(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return rhsFn(); } } async function _asyncNullishCoalesce(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return await 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 _chunkRJ7JJMQOjs = require('./chunk-RJ7JJMQO.js');
+var _chunkT35LCTC7js = require('./chunk-T35LCTC7.js');
 
 
 
 
-var _chunkWJWO74MMjs = require('./chunk-WJWO74MM.js');
+var _chunkX5V2QTDRjs = require('./chunk-X5V2QTDR.js');
 
 
 
@@ -13,19 +13,20 @@ var _chunkWJWO74MMjs = require('./chunk-WJWO74MM.js');
 
 
 
-var _chunk2JRRXXTAjs = require('./chunk-2JRRXXTA.js');
+
+var _chunkYPVTQRUMjs = require('./chunk-YPVTQRUM.js');
 require('./chunk-AID3OYVJ.js');
 require('./chunk-QGKPTBRR.js');
 require('./chunk-3KC45UVF.js');
 require('./chunk-5JLQPVNX.js');
-require('./chunk-N5TPMNTT.js');
-require('./chunk-GZQKUFM5.js');
+require('./chunk-53PZA4EP.js');
+require('./chunk-RXR7A2MX.js');
 require('./chunk-GEJDBXXM.js');
-require('./chunk-E5UD3JDQ.js');
+require('./chunk-3VN4FTE3.js');
 require('./chunk-5O4B6AUN.js');
 
 
-var _chunkRUYZAREBjs = require('./chunk-RUYZAREB.js');
+var _chunkHC5L6KGEjs = require('./chunk-HC5L6KGE.js');
 require('./chunk-S6R3OX7B.js');
 require('./chunk-LA46MMTL.js');
 require('./chunk-AYHLUHE5.js');
@@ -33,13 +34,13 @@ require('./chunk-QJBJZVG6.js');
 require('./chunk-WJYPBHTE.js');
 
 
-var _chunkVVFH745Ljs = require('./chunk-VVFH745L.js');
-require('./chunk-ML2ZY7YD.js');
+var _chunk3XKAOV74js = require('./chunk-3XKAOV74.js');
+require('./chunk-JK547IDB.js');
 require('./chunk-XNYIZMNQ.js');
 
 
 var _chunk7P5AA3SNjs = require('./chunk-7P5AA3SN.js');
-require('./chunk-DM5QUZJR.js');
+require('./chunk-NOSIMGZV.js');
 require('./chunk-OG64RBAC.js');
 require('./chunk-COGTRVWW.js');
 
@@ -65,11 +66,11 @@ async function found(lookup) {
 async function describeAnything(name, options, onMissing) {
   const maintainedOnly = options.prebuilt === true || options.tool === true;
   const wants = (filter) => (!options.kinds || options.kinds.includes(filter)) && !(maintainedOnly && filter === "custom");
-  const client = new (0, _chunkRUYZAREBjs.DeeplineClient)();
+  const client = new (0, _chunkHC5L6KGEjs.DeeplineClient)();
   const play = async (reference) => {
     const record2 = await client.describePlay(reference);
     return {
-      described: _chunkRJ7JJMQOjs.describedPlay.call(void 0, record2),
+      described: _chunkT35LCTC7js.describedPlay.call(void 0, record2),
       record: { ...record2 },
       schemas: {
         inputSchema: _nullishCoalesce(record2.inputSchema, () => ( null)),
@@ -79,10 +80,16 @@ async function describeAnything(name, options, onMissing) {
   };
   const tool = async () => {
     const record2 = await _asyncNullishCoalesce(options.fetchedTool, async () => ( await client.getTool(name)));
+    const { byok } = record2;
     return {
-      described: _chunkWJWO74MMjs.describedTool.call(void 0, record2, name),
-      record: _chunkWJWO74MMjs.toolMetadataJsonForDescribe.call(void 0, record2, name),
-      schemas: _chunkWJWO74MMjs.publicToolSchemas.call(void 0, record2)
+      described: {
+        ..._chunkX5V2QTDRjs.describedTool.call(void 0, record2, name),
+        // Shown when asked for, or when the tool runs only on your own
+        // credentials; a server that does not report it shows as unknown.
+        ...options.byok || _optionalChain([byok, 'optionalAccess', _ => _.required]) === true ? { byok: _nullishCoalesce(byok, () => ( {})) } : {}
+      },
+      record: _chunkX5V2QTDRjs.toolMetadataJsonForDescribe.call(void 0, record2, name),
+      schemas: _chunkX5V2QTDRjs.publicToolSchemas.call(void 0, record2)
     };
   };
   const sources = name.includes("/") ? [{ kinds: ["prebuilts", "custom"], find: () => play(name) }] : [
@@ -113,6 +120,7 @@ async function describeAnything(name, options, onMissing) {
   const note = shadows ? `Showing your workspace play "${name}". It has the same name as a Deepline ${shadows.kind.replace("_", " ")}; see that one with: ${shadows.describeCommand}` : null;
   const verbose = options.verbose === true;
   const json = options.json === true;
+  const fields = (_nullishCoalesce(options.fields, () => ( ""))).split(",").map((name2) => name2.trim()).filter(Boolean);
   const named = options.cliExample === true || options.playExample === true;
   const shown = options.example !== false;
   const {
@@ -131,34 +139,46 @@ async function describeAnything(name, options, onMissing) {
     },
     lines: [
       `${described.id} [${described.kind.replace("_", " ")}]`,
-      ..._chunk2JRRXXTAjs.schemaLines.call(void 0, described, { full: true })
+      ..._chunkYPVTQRUMjs.schemaLines.call(void 0, described, {
+        full: true,
+        secondary: true,
+        ...fields.length ? { fields } : {}
+      })
     ]
   } : {
     envelope: {
       ...summary,
-      inputs: inputs.map(_chunk2JRRXXTAjs.topLevelField),
-      outputs: outputs.map(_chunk2JRRXXTAjs.topLevelField),
-      ...described.rowInputs ? { rowInputs: described.rowInputs.map(_chunk2JRRXXTAjs.topLevelField) } : {},
-      ...described.rowOutputs ? { rowOutputs: described.rowOutputs.map(_chunk2JRRXXTAjs.topLevelField) } : {},
-      runExamples: _chunk2JRRXXTAjs.examples.call(void 0, described, { verbose }),
+      inputs: inputs.map(_chunkYPVTQRUMjs.topLevelField),
+      outputs: outputs.map(_chunkYPVTQRUMjs.topLevelField),
+      ...described.rowInputs ? { rowInputs: described.rowInputs.map(_chunkYPVTQRUMjs.topLevelField) } : {},
+      ...described.rowOutputs ? { rowOutputs: described.rowOutputs.map(_chunkYPVTQRUMjs.topLevelField) } : {},
+      runExamples: _chunkYPVTQRUMjs.examples.call(void 0, described, { verbose }),
       ...shadows ? { shadows, note } : {}
     },
     lines: [
       ...note ? [`Note: ${note}`, ""] : [],
-      ..._chunk2JRRXXTAjs.describedLines.call(void 0, described, {
+      ..._chunkYPVTQRUMjs.describedLines.call(void 0, described, {
         cli: shown && (!named || options.cliExample === true),
         play: shown && (!named || options.playExample === true),
         explain: named,
         verbose,
-        fullSchema: options.fullSchema === true
+        fullSchema: options.fullSchema === true,
+        ...fields.length ? { fields } : {}
       })
     ]
   };
-  const envelope = options.schemaOnly ? view.envelope : (
+  const fullRecord = options.fullRecord === true || options.fullSchema === true;
+  const envelope = options.schemaOnly ? view.envelope : fullRecord ? (
     // The shared keys lead; where the kind's own record has the same key,
     // its value stands, so callers of the older commands read what they did.
     { ...view.envelope, ...record }
-  );
+  ) : {
+    ..._chunkYPVTQRUMjs.describedJson.call(void 0, described, {
+      secondary: verbose || fields.length > 0,
+      verbose
+    }),
+    ...shadows ? { shadows, note } : {}
+  };
   const text = `${view.lines.join("\n")}
 `;
   if (options.out) {
@@ -167,18 +187,18 @@ async function describeAnything(name, options, onMissing) {
 ` : text;
     _fs.writeFileSync.call(void 0, path, content);
     const bytes = Buffer.byteLength(content);
-    _chunkVVFH745Ljs.printCommandEnvelope.call(void 0, 
+    _chunk3XKAOV74js.printCommandEnvelope.call(void 0, 
       { path, bytes },
       { json, text: `Wrote ${path} (${bytes} bytes)
 ` }
     );
     return 0;
   }
-  _chunkVVFH745Ljs.printCommandEnvelope.call(void 0, envelope, { json, text });
+  _chunk3XKAOV74js.printCommandEnvelope.call(void 0, envelope, { json, text });
   return 0;
 }
 function registerDescribeCommand(program) {
-  _chunk2JRRXXTAjs.addDescribeOptions.call(void 0, program.command("describe <name>")).description(
+  _chunkYPVTQRUMjs.addDescribeOptions.call(void 0, program.command("describe <name>")).description(
     "Describe anything search returns: a tool, monitor type, or play."
   ).addHelpText(
     "after",
@@ -199,17 +219,26 @@ What it prints:
 
 Examples in the output:
   (default)        required inputs filled in, first output read
-  --verbose        every input filled in, every output read
+  --verbose        every input filled in, every output read; also shows
+                   secondary fields
   --cli-example    only the CLI example, with how inputs and outputs work
   --play-example   only the in-play example, with how inputs and outputs work
   --no-example     no examples
 
 Schema size and format:
-  A schema over ${_chunk2JRRXXTAjs.SCHEMA_LINE_LIMIT} lines is folded: deeper objects show only their field
+  Secondary fields (diagnostics, attempt logs, echoes of input) are left out
+  by default; the output names them, and --verbose shows them.
+  --fields email,miss_reason shows only the fields you name, plus every
+  required input, and names the rest. Use it when you know what you need.
+  A schema over ${_chunkYPVTQRUMjs.SCHEMA_LINE_LIMIT} lines is folded: deeper objects show only their field
   names. A shape used more than once is printed once under Types.
   --full-schema    the normal output, with the schema not folded
   --schema-only    only the schema, not folded, and nothing else
-  --json           everything as JSON; the schema is never folded in JSON
+  --json           the same facts as JSON: fields keyed by name, with what
+                   each means and, for a tool, where it is in the result;
+                   secondary fields are named in "hidden"
+  --json --full-schema  the whole catalog record, as tools describe and
+                   plays describe print it
   --schema-only --json
                    only the input and output JSON Schemas; use this for a
                    program, or for a schema too large to read