deepline 0.3.324 → 0.3.326

package/dist/cli/{db-7UPW3N5U.mjs → db-X4B7YFNY.mjs}

@@ -1,6 +1,10 @@
 import {
-  DeeplineClient
-} from "./chunk-3ZKAKQYC.mjs";
+  shellQuote
+} from "./chunk-OVDNJAJN.mjs";
+import {
+  DeeplineClient,
+  planCustomerDbQuery
+} from "./chunk-KLWBAQ5A.mjs";
 import "./chunk-CBVIJSHF.mjs";
 import {
   argsWantJson,
@@ -9,11 +13,14 @@ import {
   dataExportRows,
   markdownTableFromRows,
   printCommandEnvelope,
-  recordRows
-} from "./chunk-I7RLL7LN.mjs";
-import "./chunk-TJGJTB5T.mjs";
+  recordRows,
+  shouldEmitJson
+} from "./chunk-M7CPVMDB.mjs";
+import {
+  CustomerDbQueryOutcomeUnknownError
+} from "./chunk-BR7GGTAE.mjs";
 import "./chunk-DLIRSHV6.mjs";
-import "./chunk-HHZDWBSQ.mjs";
+import "./chunk-BQJVMKWL.mjs";
 import "./chunk-6IKARAYD.mjs";
 import {
   DeeplineError
@@ -21,26 +28,18 @@ import {
 import "./chunk-WZYKRD7T.mjs";
 import "./chunk-KRD6H754.mjs";
 
-// src/cli/commands/db.ts
-import { readFileSync, writeFileSync } from "fs";
+// src/cli/operations/db-query.ts
+import { readFileSync } from "fs";
+import { resolve as resolve2 } from "path";
+
+// src/cli/renderers/db-query.ts
+import { writeFileSync } from "fs";
 import { resolve } from "path";
-var CUSTOMER_DB_QUERY_FORMATS = /* @__PURE__ */ new Set(["table", "json", "csv", "markdown"]);
-var CUSTOMER_DB_QUERY_MAX_ROWS = 1e3;
-function parsePositiveInteger(value, flagName) {
-  const parsed = Number.parseInt(value, 10);
-  if (!Number.isFinite(parsed) || parsed <= 0) {
-    throw new Error(`${flagName} must be a positive integer.`);
-  }
-  return parsed;
+function queryIntentLine(operationKey) {
+  return operationKey === void 0 ? "The tool equivalent starts a new SQL execution; it cannot recover this unkeyed operation." : "The tool equivalent recovers this SQL operation through its original key.";
 }
-function parseMaxRows(value) {
-  const parsed = parsePositiveInteger(value, "--max-rows");
-  if (parsed > CUSTOMER_DB_QUERY_MAX_ROWS) {
-    throw new Error(
-      `--max-rows must be ${CUSTOMER_DB_QUERY_MAX_ROWS} or less. Add LIMIT/OFFSET to page larger exports.`
-    );
-  }
-  return parsed;
+function errorMessage(value) {
+  return value instanceof Error ? value.message : String(value ?? "");
 }
 function formatCell(value) {
   if (value === null || value === void 0) return "";
@@ -100,18 +99,6 @@ function customerDbRows(result) {
 function customerDbColumnNames(result) {
   return result.columns.map((column) => column.name).filter(Boolean);
 }
-function errorMessage(value) {
-  return value instanceof Error ? value.message : String(value ?? "");
-}
-function resolveDbQuerySql(rawSql, readFile = (path) => readFileSync(path, "utf8")) {
-  const value = rawSql.trim();
-  if (!value.startsWith("@")) return value;
-  const filePath = value.slice(1).trim();
-  if (!filePath) {
-    throw new Error("--sql @file requires a file path after `@`.");
-  }
-  return readFile(resolve(filePath)).trim();
-}
 function collectErrorText(value) {
   if (!value || typeof value !== "object" || Array.isArray(value)) {
     return errorMessage(value);
@@ -129,14 +116,15 @@ function collectErrorText(value) {
   ].filter(Boolean).join("\n");
 }
 function formatDbQueryError(sql, error) {
-  const text = collectErrorText(error);
+  const text = error instanceof 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 [
-      "Customer DB query failed: the referenced storage table does not exist.",
+      ...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 --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)}`
@@ -144,6 +132,7 @@ function formatDbQueryError(sql, error) {
   }
   if (referencesStorage && runIdColumnMissing) {
     return [
+      ...error instanceof 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)}`
@@ -154,28 +143,6 @@ function formatDbQueryError(sql, error) {
   }
   return errorMessage(error);
 }
-function dbRepairHumanLines(result) {
-  const repair = result.repair;
-  return [
-    "Workspace storage repair completed.",
-    ...repair ? [
-      `Location changed: ${repair.location.changed ? "yes" : "no"}`,
-      `Storage contract: ${repair.storage_contract.current ? "current" : "not ready"}`,
-      `Runtime migration: ${repair.runtime_migration.current ? "current" : "not ready"}`,
-      `Runtime capability probe: ${repair.runtime_capabilities.after.runtime_capabilities_ready ? "passed" : "failed"}`,
-      `Materialized table grants reconciled: ${repair.materialized_tables.repaired_count}`
-    ] : [
-      "Runtime capability probe: unavailable from this server version",
-      `Materialized table grants reconciled: ${result.count}`
-    ],
-    `Runtime role: ${result.connection_grants.runtime_role}`,
-    `Customer DB role: ${result.connection_grants.customer_db_role}`
-  ];
-}
-function dbRepairPlainText(result) {
-  return result.repair ? "Workspace storage repair completed. Runtime capability probe passed.\n" : `Workspace storage repair completed. ${result.count} materialized table grant(s) reconciled; runtime capability probe unavailable.
-`;
-}
 function writeCustomerDbCsv(result, outPath) {
   const resolved = resolve(outPath);
   writeFileSync(
@@ -194,72 +161,41 @@ function dbQueryExportEnvelope(input) {
     row_count_returned: input.result.row_count_returned,
     truncated: input.result.truncated,
     ...input.outPath ? { file: input.outPath, local: { file: input.outPath } } : {},
-    next: { toolEquivalent: input.toolCommand },
+    next: {
+      toolEquivalent: input.toolCommand,
+      executionIntent: input.operationKey === void 0 ? "new_execution" : "recover_original",
+      ...input.operationKey === void 0 ? {} : { recoverOperation: input.toolCommand }
+    },
     render: {
       sections: [
         {
           title: "customer db export",
           lines: [
-            `Rendered ${input.result.row_count_returned} row(s) as ${input.format} to ${destination}`
+            `Rendered ${input.result.row_count_returned} row(s) as ${input.format} to ${destination}`,
+            queryIntentLine(input.operationKey)
           ]
         }
       ],
-      actions: [{ label: "Tool equivalent", command: input.toolCommand }]
+      actions: [
+        {
+          label: "Tool equivalent",
+          command: input.toolCommand
+        }
+      ]
     }
   };
 }
-async function handleDbQuery(args) {
-  const sqlIndex = args.indexOf("--sql");
-  const rawSql = sqlIndex >= 0 ? args[sqlIndex + 1]?.trim() : "";
-  if (!rawSql) {
-    console.error(
-      'Usage: deepline db query --sql "select * from table limit 20"|@query.sql [--max-rows N] [--json]'
-    );
-    return 1;
-  }
-  let sql;
-  try {
-    sql = resolveDbQuerySql(rawSql);
-  } catch (error) {
-    console.error(errorMessage(error));
-    return 1;
-  }
-  if (!sql) {
-    console.error("SQL file is empty.");
-    return 1;
-  }
-  const maxRowsIndex = args.indexOf("--max-rows");
-  const maxRows = maxRowsIndex >= 0 && args[maxRowsIndex + 1] ? parseMaxRows(args[maxRowsIndex + 1]) : void 0;
-  const formatIndex = args.indexOf("--format");
-  const format = formatIndex >= 0 ? args[formatIndex + 1]?.trim().toLowerCase() : "";
-  if (format && !CUSTOMER_DB_QUERY_FORMATS.has(format)) {
-    console.error(
-      'Usage: deepline db query --sql "select * from table limit 20" [--format table|json|csv|markdown] [--out path]'
-    );
-    return 1;
-  }
-  const outIndex = args.indexOf("--out");
-  const outPath = outIndex >= 0 ? args[outIndex + 1]?.trim() : "";
-  if (outIndex >= 0 && !outPath) {
-    console.error("--out requires a path.");
-    return 1;
-  }
-  const jsonOutput = argsWantJson(args);
-  const explicitJsonOutput = args.includes("--json");
-  const client = new DeeplineClient();
-  let result;
-  try {
-    result = await client.db.query({ sql, maxRows });
-  } catch (error) {
-    console.error(formatDbQueryError(sql, error));
-    return 1;
-  }
-  const toolCommand = `deepline tools execute query_customer_db --payload ${JSON.stringify(
-    {
-      sql,
-      ...maxRows ? { max_rows: maxRows } : {}
-    }
-  )} --json`;
+function renderDbQueryResult(result, query, options) {
+  const { sql, maxRows, operationKey } = query;
+  const { format, out: outPath, json: explicitJsonOutput = false } = options;
+  const jsonOutput = explicitJsonOutput || shouldEmitJson();
+  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 ${shellQuote(toolPayload)} --json`;
   if (format === "csv") {
     if (outPath) {
       const exportedPath = writeCustomerDbCsv(result, outPath);
@@ -268,7 +204,8 @@ async function handleDbQuery(args) {
           result,
           format,
           outPath: exportedPath,
-          toolCommand
+          toolCommand,
+          operationKey
         }),
         {
           json: jsonOutput,
@@ -276,14 +213,15 @@ async function handleDbQuery(args) {
 `
         }
       );
-      return 0;
+      return;
     }
     printCommandEnvelope(
       dbQueryExportEnvelope({
         result,
         format,
         outPath: null,
-        toolCommand
+        toolCommand,
+        operationKey
       }),
       {
         json: explicitJsonOutput,
@@ -293,7 +231,7 @@ async function handleDbQuery(args) {
         )
       }
     );
-    return 0;
+    return;
   }
   if (format === "markdown") {
     const content = markdownTableFromRows(
@@ -308,7 +246,8 @@ async function handleDbQuery(args) {
           result,
           format,
           outPath: exportedPath,
-          toolCommand
+          toolCommand,
+          operationKey
         }),
         {
           json: jsonOutput,
@@ -316,36 +255,170 @@ async function handleDbQuery(args) {
 `
         }
       );
-      return 0;
+      return;
     }
     printCommandEnvelope(
       dbQueryExportEnvelope({
         result,
         format,
         outPath: null,
-        toolCommand
+        toolCommand,
+        operationKey
       }),
       {
         json: explicitJsonOutput,
         text: content
       }
     );
-    return 0;
+    return;
   }
   printCommandEnvelope(
     {
       ...result,
-      next: { toolEquivalent: toolCommand },
+      next: {
+        toolEquivalent: toolCommand,
+        executionIntent: operationKey === void 0 ? "new_execution" : "recover_original",
+        ...operationKey === void 0 ? {} : { recoverOperation: toolCommand }
+      },
       render: {
-        sections: [{ title: "customer db query", lines: tableLines(result) }],
-        actions: [{ label: "Tool equivalent", command: toolCommand }]
+        sections: [
+          {
+            title: "customer db query",
+            lines: [...tableLines(result), queryIntentLine(operationKey)]
+          }
+        ],
+        actions: [
+          {
+            label: "Tool equivalent",
+            command: toolCommand
+          }
+        ]
       }
     },
     {
       json: explicitJsonOutput || format === "json" || format !== "table" && jsonOutput
     }
   );
-  return 0;
+  return;
+}
+
+// src/cli/operations/db-query.ts
+function resolveDbQuerySql(rawSql, readFile = (path) => readFileSync(path, "utf8")) {
+  const value = rawSql.trim();
+  if (!value.startsWith("@")) return value;
+  const filePath = value.slice(1).trim();
+  if (!filePath) {
+    throw new Error("--sql @file requires a file path after `@`.");
+  }
+  return readFile(resolve2(filePath)).trim();
+}
+async function runDbQueryCommand(options) {
+  let sql = "";
+  try {
+    sql = resolveDbQuerySql(options.sql);
+    if (!sql) throw new Error("SQL file is empty.");
+    const maxRows = options.maxRows === void 0 ? void 0 : Number(options.maxRows);
+    if (maxRows !== void 0 && maxRows > 1e3)
+      throw new Error(
+        "--max-rows must be 1000 or less. Add LIMIT/OFFSET to page larger exports."
+      );
+    if (maxRows !== void 0 && (!Number.isSafeInteger(maxRows) || maxRows < 1)) {
+      throw new Error(
+        "--max-rows must be a positive whole number of 1000 or less. Add LIMIT/OFFSET to page larger exports."
+      );
+    }
+    const operationKey = options.operationKey;
+    if (operationKey !== void 0 && (!operationKey.trim() || operationKey.length > 512)) {
+      throw new Error(
+        "--operation-key requires a non-empty intended-operation key of at most 512 characters."
+      );
+    }
+    const format = options.format?.trim().toLowerCase();
+    if (format !== void 0 && !["table", "json", "csv", "markdown"].includes(format)) {
+      throw new Error("--format must be table, json, csv, or markdown.");
+    }
+    const out = options.out?.trim();
+    if (out !== void 0 && !out) throw new Error("--out requires a path.");
+    if (out !== void 0 && format !== "csv" && format !== "markdown")
+      throw new Error("--out requires --format csv or --format markdown.");
+    const query = {
+      sql,
+      ...maxRows === void 0 ? {} : { maxRows },
+      ...operationKey === void 0 ? {} : { operationKey }
+    };
+    const plan = planCustomerDbQuery(query);
+    if (options.dryRun) {
+      printCommandEnvelope(
+        {
+          dryRun: true,
+          ...plan,
+          effects: {
+            ...plan.effects,
+            localWrites: out === void 0 ? "none" : "export_file"
+          },
+          output: {
+            format: format ?? "automatic",
+            ...out === void 0 ? {} : { file: resolve2(out) }
+          }
+        },
+        { json: options.json || shouldEmitJson() }
+      );
+      return 0;
+    }
+    const client = new DeeplineClient();
+    const result = await client.db.query(query);
+    renderDbQueryResult(result, query, {
+      format,
+      out,
+      json: options.json
+    });
+    return 0;
+  } catch (error) {
+    if (error instanceof CustomerDbQueryOutcomeUnknownError && (options.json || shouldEmitJson())) {
+      printCommandEnvelope(
+        {
+          ok: false,
+          error: {
+            code: error.code,
+            message: error.message,
+            outcome: error.outcome,
+            retryable: error.retryable,
+            ...error.operationKey === void 0 ? {} : { operationKey: error.operationKey }
+          }
+        },
+        { json: true }
+      );
+    }
+    console.error(formatDbQueryError(sql, error));
+    return 1;
+  }
+}
+
+// src/cli/commands/db.ts
+function errorMessage2(value) {
+  return value instanceof Error ? value.message : String(value ?? "");
+}
+function dbRepairHumanLines(result) {
+  const repair = result.repair;
+  return [
+    "Workspace storage repair completed.",
+    ...repair ? [
+      `Location changed: ${repair.location.changed ? "yes" : "no"}`,
+      `Storage contract: ${repair.storage_contract.current ? "current" : "not ready"}`,
+      `Runtime migration: ${repair.runtime_migration.current ? "current" : "not ready"}`,
+      `Runtime capability probe: ${repair.runtime_capabilities.after.runtime_capabilities_ready ? "passed" : "failed"}`,
+      `Materialized table grants reconciled: ${repair.materialized_tables.repaired_count}`
+    ] : [
+      "Runtime capability probe: unavailable from this server version",
+      `Materialized table grants reconciled: ${result.count}`
+    ],
+    `Runtime role: ${result.connection_grants.runtime_role}`,
+    `Customer DB role: ${result.connection_grants.customer_db_role}`
+  ];
+}
+function dbRepairPlainText(result) {
+  return result.repair ? "Workspace storage repair completed. Runtime capability probe passed.\n" : `Workspace storage repair completed. ${result.count} materialized table grant(s) reconciled; runtime capability probe unavailable.
+`;
 }
 async function handleDbRepair(args) {
   const providerIndex = args.indexOf("--provider");
@@ -364,7 +437,7 @@ async function handleDbRepair(args) {
       );
       return 1;
     }
-    console.error(errorMessage(error));
+    console.error(errorMessage2(error));
     return 1;
   }
   printCommandEnvelope(
@@ -427,6 +500,11 @@ Examples:
   CREATE TABLE storage.blocked (...) instead of CREATE TABLE blocked (...).
   --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.
+  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.
 
 Examples:
   deepline db query --sql "select * from companies limit 20"
@@ -437,18 +515,17 @@ Examples:
   deepline db query --sql "select * from contacts limit 20" --format csv --out contacts.csv
   deepline db query --sql "select domain, name from companies limit 20" --format markdown
 `
-  ).requiredOption("--sql <sql>", "SQL statement").option("--max-rows <n>", "Maximum returned rows").option("--format <format>", "Output format: table, json, csv, or markdown").option("--out <path>", "Write csv or markdown output to a file").option(
+  ).requiredOption("--sql <sql>", "SQL statement").option(
+    "--dry-run",
+    "Describe the request, effects and recovery without executing SQL or writing an export"
+  ).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. Also automatic when stdout is piped"
   ).action(async (options) => {
-    process.exitCode = await handleDbQuery([
-      "--sql",
-      options.sql,
-      ...options.maxRows ? ["--max-rows", options.maxRows] : [],
-      ...options.format ? ["--format", options.format] : [],
-      ...options.out ? ["--out", options.out] : [],
-      ...options.json ? ["--json"] : []
-    ]);
+    process.exitCode = await runDbQueryCommand(options);
   });
   db.command("repair").description(
     "Repair this workspace storage contract (role/DB grants). Org admin only."

package/dist/cli/{describe-VDRY2JCE.js → describe-BDBARWZJ.js}

@@ -2,10 +2,10 @@
 
 
 
-var _chunkTZZNI2A4js = require('./chunk-TZZNI2A4.js');
+var _chunkTZQMFWLFjs = require('./chunk-TZQMFWLF.js');
 
 
-var _chunkEXKRHZRGjs = require('./chunk-EXKRHZRG.js');
+var _chunk4LNBSQM4js = require('./chunk-4LNBSQM4.js');
 
 
 
@@ -13,26 +13,27 @@ var _chunkEXKRHZRGjs = require('./chunk-EXKRHZRG.js');
 
 
 
-var _chunkXNL3SEMCjs = require('./chunk-XNL3SEMC.js');
+var _chunkAFNEQ43Jjs = require('./chunk-AFNEQ43J.js');
+require('./chunk-AID3OYVJ.js');
 require('./chunk-5JLQPVNX.js');
-require('./chunk-QM2Z4FQF.js');
-require('./chunk-NC2ZXG2Y.js');
+require('./chunk-T33W6JUJ.js');
+require('./chunk-3NGWGFVL.js');
 require('./chunk-NXDRDJ4K.js');
-require('./chunk-SDK3ZA2C.js');
+require('./chunk-LVEDPCLJ.js');
 
 
-var _chunkN5E66DP3js = require('./chunk-N5E66DP3.js');
+var _chunkGVYKY6T6js = require('./chunk-GVYKY6T6.js');
 require('./chunk-LA46MMTL.js');
 require('./chunk-QJBJZVG6.js');
 require('./chunk-AYHLUHE5.js');
 require('./chunk-WJYPBHTE.js');
 
 
-var _chunkGROXVGGWjs = require('./chunk-GROXVGGW.js');
-require('./chunk-D5YJHGST.js');
+var _chunkCUUHQ3AOjs = require('./chunk-CUUHQ3AO.js');
+require('./chunk-TXVOB5J2.js');
 require('./chunk-XNYIZMNQ.js');
-require('./chunk-IXYR65PW.js');
-require('./chunk-XSEMQ4II.js');
+require('./chunk-BUYZEUY4.js');
+require('./chunk-AGH6YP2T.js');
 require('./chunk-3KC45UVF.js');
 require('./chunk-2HKPAZVJ.js');
 require('./chunk-S6R3OX7B.js');
@@ -64,11 +65,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, _chunkN5E66DP3js.DeeplineClient)();
+  const client = new (0, _chunkGVYKY6T6js.DeeplineClient)();
   const play = async (reference) => {
     const record2 = await client.describePlay(reference);
     return {
-      described: _chunkEXKRHZRGjs.describedPlay.call(void 0, record2),
+      described: _chunk4LNBSQM4js.describedPlay.call(void 0, record2),
       record: { ...record2 },
       schemas: {
         inputSchema: _nullishCoalesce(record2.inputSchema, () => ( null)),
@@ -79,9 +80,9 @@ async function describeAnything(name, options, onMissing) {
   const tool = async () => {
     const record2 = await _asyncNullishCoalesce(options.fetchedTool, async () => ( await client.getTool(name)));
     return {
-      described: _chunkTZZNI2A4js.describedTool.call(void 0, record2, name),
-      record: _chunkTZZNI2A4js.toolMetadataJsonForDescribe.call(void 0, record2, name),
-      schemas: _chunkTZZNI2A4js.publicToolSchemas.call(void 0, record2)
+      described: _chunkTZQMFWLFjs.describedTool.call(void 0, record2, name),
+      record: _chunkTZQMFWLFjs.toolMetadataJsonForDescribe.call(void 0, record2, name),
+      schemas: _chunkTZQMFWLFjs.publicToolSchemas.call(void 0, record2)
     };
   };
   const sources = name.includes("/") ? [{ kinds: ["prebuilts", "custom"], find: () => play(name) }] : [
@@ -130,21 +131,21 @@ async function describeAnything(name, options, onMissing) {
     },
     lines: [
       `${described.id} [${described.kind.replace("_", " ")}]`,
-      ..._chunkXNL3SEMCjs.schemaLines.call(void 0, described, { full: true })
+      ..._chunkAFNEQ43Jjs.schemaLines.call(void 0, described, { full: true })
     ]
   } : {
     envelope: {
       ...summary,
-      inputs: inputs.map(_chunkXNL3SEMCjs.topLevelField),
-      outputs: outputs.map(_chunkXNL3SEMCjs.topLevelField),
-      ...described.rowInputs ? { rowInputs: described.rowInputs.map(_chunkXNL3SEMCjs.topLevelField) } : {},
-      ...described.rowOutputs ? { rowOutputs: described.rowOutputs.map(_chunkXNL3SEMCjs.topLevelField) } : {},
-      runExamples: _chunkXNL3SEMCjs.examples.call(void 0, described, { verbose }),
+      inputs: inputs.map(_chunkAFNEQ43Jjs.topLevelField),
+      outputs: outputs.map(_chunkAFNEQ43Jjs.topLevelField),
+      ...described.rowInputs ? { rowInputs: described.rowInputs.map(_chunkAFNEQ43Jjs.topLevelField) } : {},
+      ...described.rowOutputs ? { rowOutputs: described.rowOutputs.map(_chunkAFNEQ43Jjs.topLevelField) } : {},
+      runExamples: _chunkAFNEQ43Jjs.examples.call(void 0, described, { verbose }),
       ...shadows ? { shadows, note } : {}
     },
     lines: [
       ...note ? [`Note: ${note}`, ""] : [],
-      ..._chunkXNL3SEMCjs.describedLines.call(void 0, described, {
+      ..._chunkAFNEQ43Jjs.describedLines.call(void 0, described, {
         cli: shown && (!named || options.cliExample === true),
         play: shown && (!named || options.playExample === true),
         explain: named,
@@ -166,18 +167,18 @@ async function describeAnything(name, options, onMissing) {
 ` : text;
     _fs.writeFileSync.call(void 0, path, content);
     const bytes = Buffer.byteLength(content);
-    _chunkGROXVGGWjs.printCommandEnvelope.call(void 0, 
+    _chunkCUUHQ3AOjs.printCommandEnvelope.call(void 0, 
       { path, bytes },
       { json, text: `Wrote ${path} (${bytes} bytes)
 ` }
     );
     return 0;
   }
-  _chunkGROXVGGWjs.printCommandEnvelope.call(void 0, envelope, { json, text });
+  _chunkCUUHQ3AOjs.printCommandEnvelope.call(void 0, envelope, { json, text });
   return 0;
 }
 function registerDescribeCommand(program) {
-  _chunkXNL3SEMCjs.addDescribeOptions.call(void 0, program.command("describe <name>")).description(
+  _chunkAFNEQ43Jjs.addDescribeOptions.call(void 0, program.command("describe <name>")).description(
     "Describe anything search returns: a tool, monitor type, or play."
   ).addHelpText(
     "after",
@@ -204,7 +205,7 @@ Examples in the output:
   --no-example     no examples
 
 Schema size and format:
-  A schema over ${_chunkXNL3SEMCjs.SCHEMA_LINE_LIMIT} lines is folded: deeper objects show only their field
+  A schema over ${_chunkAFNEQ43Jjs.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