deepline 0.3.394 → 0.3.396

package/dist/cli/{chunk-NR3DFKNF.mjs → chunk-XKZXO7D3.mjs}

@@ -3,7 +3,7 @@ import {
   detectAgentRuntime,
   resolveCliCommandContext,
   resolveConfig
-} from "./chunk-FJGW5GXU.mjs";
+} from "./chunk-VE3U3SQC.mjs";
 import {
   DeeplineError,
   serializeToolExecutionFailure

package/dist/cli/{csv-5AXRB35H.mjs → csv-RLRR74RQ.mjs}

@@ -4,11 +4,11 @@ import {
   printCommandEnvelope,
   printJson,
   readCsvRows
-} from "./chunk-NR3DFKNF.mjs";
-import "./chunk-FJGW5GXU.mjs";
+} from "./chunk-XKZXO7D3.mjs";
+import "./chunk-VE3U3SQC.mjs";
 import "./chunk-DLIRSHV6.mjs";
 import "./chunk-NXGCO4JB.mjs";
-import "./chunk-TJI2EN6K.mjs";
+import "./chunk-NHB5YUCS.mjs";
 import "./chunk-WZYKRD7T.mjs";
 import "./chunk-KRD6H754.mjs";
 

package/dist/cli/{csv-LU7O75WE.js → csv-TF576S77.js}

@@ -4,11 +4,11 @@
 
 
 
-var _chunkKGNTKMRGjs = require('./chunk-KGNTKMRG.js');
-require('./chunk-CS6RAIVY.js');
+var _chunkRTO5QZWTjs = require('./chunk-RTO5QZWT.js');
+require('./chunk-V7UP2F4U.js');
 require('./chunk-XNYIZMNQ.js');
 require('./chunk-7P5AA3SN.js');
-require('./chunk-6YAUMG27.js');
+require('./chunk-GNN4MY5X.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 : _chunkKGNTKMRGjs.clip.call(void 0, value, 42)).length;
+          return (verbose ? value : _chunkRTO5QZWTjs.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 : _chunkKGNTKMRGjs.clip.call(void 0, raw, 42);
+      const display = verbose ? raw : _chunkRTO5QZWTjs.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 = _chunkKGNTKMRGjs.readCsvRows.call(void 0, csvPath);
+  const allRows = _chunkRTO5QZWTjs.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") {
-      _chunkKGNTKMRGjs.printJson.call(void 0, {
+      _chunkRTO5QZWTjs.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(_chunkKGNTKMRGjs.csvStringFromRows.call(void 0, displayRows));
+      process.stdout.write(_chunkRTO5QZWTjs.csvStringFromRows.call(void 0, displayRows));
       return;
     }
     process.stdout.write(
@@ -193,7 +193,7 @@ async function handleCsvShow(path, options, command) {
     return;
   }
   if (format === "json") {
-    _chunkKGNTKMRGjs.printJson.call(void 0, {
+    _chunkRTO5QZWTjs.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:
-${_chunkKGNTKMRGjs.clip.call(void 0, log, 2e3)}`;
+${_chunkRTO5QZWTjs.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}`);
-  _chunkKGNTKMRGjs.printCommandEnvelope.call(void 0, payload, {
+  _chunkRTO5QZWTjs.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";
-  _chunkKGNTKMRGjs.printCommandEnvelope.call(void 0, payload, { json: options.json, text });
+  _chunkRTO5QZWTjs.printCommandEnvelope.call(void 0, payload, { json: options.json, text });
 }
 async function handleCsvRender(action, options) {
   const normalized = _nullishCoalesce(action, () => ( "start"));

package/dist/cli/{db-F7YTFKVM.js → db-FDBJUTFO.js}

@@ -4,9 +4,10 @@ var _chunkAID3OYVJjs = require('./chunk-AID3OYVJ.js');
 
 
 
-var _chunkE23BQ5SCjs = require('./chunk-E23BQ5SC.js');
+var _chunkWQJJNIMQjs = require('./chunk-WQJJNIMQ.js');
 require('./chunk-S6R3OX7B.js');
 require('./chunk-UHNDVD3P.js');
+require('./chunk-KXMNM4AQ.js');
 require('./chunk-XDVT3GOM.js');
 
 
@@ -17,15 +18,15 @@ require('./chunk-XDVT3GOM.js');
 
 
 
-var _chunkKGNTKMRGjs = require('./chunk-KGNTKMRG.js');
+var _chunkRTO5QZWTjs = require('./chunk-RTO5QZWT.js');
 
 
-var _chunkCS6RAIVYjs = require('./chunk-CS6RAIVY.js');
+var _chunkV7UP2F4Ujs = require('./chunk-V7UP2F4U.js');
 require('./chunk-XNYIZMNQ.js');
 
 
 var _chunk7P5AA3SNjs = require('./chunk-7P5AA3SN.js');
-require('./chunk-6YAUMG27.js');
+require('./chunk-GNN4MY5X.js');
 require('./chunk-OG64RBAC.js');
 require('./chunk-COGTRVWW.js');
 
@@ -48,8 +49,8 @@ function formatCell(value) {
   return text.length > 80 ? `${text.slice(0, 77)}...` : text;
 }
 function tableLines(result) {
-  const rows = _chunkKGNTKMRGjs.dataExportRows.call(void 0, customerDbRows(result));
-  const responseColumns = _chunkKGNTKMRGjs.dataExportColumns.call(void 0, 
+  const rows = _chunkRTO5QZWTjs.dataExportRows.call(void 0, customerDbRows(result));
+  const responseColumns = _chunkRTO5QZWTjs.dataExportColumns.call(void 0, 
     rows,
     customerDbColumnNames(result)
   );
@@ -95,7 +96,7 @@ function tableLines(result) {
   return lines;
 }
 function customerDbRows(result) {
-  return _chunkKGNTKMRGjs.recordRows.call(void 0, result.rows);
+  return _chunkRTO5QZWTjs.recordRows.call(void 0, result.rows);
 }
 function customerDbColumnNames(result) {
   return result.columns.map((column) => column.name).filter(Boolean);
@@ -117,15 +118,15 @@ function collectErrorText(value) {
   ].filter(Boolean).join("\n");
 }
 function formatDbQueryError(sql, error) {
-  const text = error instanceof _chunkCS6RAIVYjs.CustomerDbQueryOutcomeUnknownError ? collectErrorText(error.cause) : collectErrorText(error);
+  const text = error instanceof _chunkV7UP2F4Ujs.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 _chunkCS6RAIVYjs.CustomerDbQueryOutcomeUnknownError ? [error.message] : [],
-      error instanceof _chunkCS6RAIVYjs.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 _chunkV7UP2F4Ujs.CustomerDbQueryOutcomeUnknownError ? [error.message] : [],
+      error instanceof _chunkV7UP2F4Ujs.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)}`
@@ -133,7 +134,7 @@ function formatDbQueryError(sql, error) {
   }
   if (referencesStorage && runIdColumnMissing) {
     return [
-      ...error instanceof _chunkCS6RAIVYjs.CustomerDbQueryOutcomeUnknownError ? [error.message] : [],
+      ...error instanceof _chunkV7UP2F4Ujs.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)}`
@@ -148,7 +149,7 @@ function writeCustomerDbCsv(result, outPath) {
   const resolved = _path.resolve.call(void 0, outPath);
   _fs.writeFileSync.call(void 0, 
     resolved,
-    _chunkKGNTKMRGjs.dataExportCsvString.call(void 0, customerDbRows(result), customerDbColumnNames(result)),
+    _chunkRTO5QZWTjs.dataExportCsvString.call(void 0, customerDbRows(result), customerDbColumnNames(result)),
     "utf-8"
   );
   return resolved;
@@ -189,7 +190,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 || _chunkKGNTKMRGjs.shouldEmitJson.call(void 0, );
+  const jsonOutput = explicitJsonOutput || _chunkRTO5QZWTjs.shouldEmitJson.call(void 0, );
   const toolPayload = JSON.stringify({
     sql,
     result_mode: "rows",
@@ -200,7 +201,7 @@ function renderDbQueryResult(result, query, options) {
   if (format === "csv") {
     if (outPath) {
       const exportedPath = writeCustomerDbCsv(result, outPath);
-      _chunkKGNTKMRGjs.printCommandEnvelope.call(void 0, 
+      _chunkRTO5QZWTjs.printCommandEnvelope.call(void 0, 
         dbQueryExportEnvelope({
           result,
           format,
@@ -216,7 +217,7 @@ function renderDbQueryResult(result, query, options) {
       );
       return;
     }
-    _chunkKGNTKMRGjs.printCommandEnvelope.call(void 0, 
+    _chunkRTO5QZWTjs.printCommandEnvelope.call(void 0, 
       dbQueryExportEnvelope({
         result,
         format,
@@ -226,7 +227,7 @@ function renderDbQueryResult(result, query, options) {
       }),
       {
         json: explicitJsonOutput,
-        text: _chunkKGNTKMRGjs.dataExportCsvString.call(void 0, 
+        text: _chunkRTO5QZWTjs.dataExportCsvString.call(void 0, 
           customerDbRows(result),
           customerDbColumnNames(result)
         )
@@ -235,14 +236,14 @@ function renderDbQueryResult(result, query, options) {
     return;
   }
   if (format === "markdown") {
-    const content = _chunkKGNTKMRGjs.markdownTableFromRows.call(void 0, 
+    const content = _chunkRTO5QZWTjs.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");
-      _chunkKGNTKMRGjs.printCommandEnvelope.call(void 0, 
+      _chunkRTO5QZWTjs.printCommandEnvelope.call(void 0, 
         dbQueryExportEnvelope({
           result,
           format,
@@ -258,7 +259,7 @@ function renderDbQueryResult(result, query, options) {
       );
       return;
     }
-    _chunkKGNTKMRGjs.printCommandEnvelope.call(void 0, 
+    _chunkRTO5QZWTjs.printCommandEnvelope.call(void 0, 
       dbQueryExportEnvelope({
         result,
         format,
@@ -273,7 +274,7 @@ function renderDbQueryResult(result, query, options) {
     );
     return;
   }
-  _chunkKGNTKMRGjs.printCommandEnvelope.call(void 0, 
+  _chunkRTO5QZWTjs.printCommandEnvelope.call(void 0, 
     {
       ...result,
       next: {
@@ -347,9 +348,9 @@ async function runDbQueryCommand(options) {
       ...maxRows === void 0 ? {} : { maxRows },
       ...operationKey === void 0 ? {} : { operationKey }
     };
-    const plan = _chunkE23BQ5SCjs.planCustomerDbQuery.call(void 0, query);
+    const plan = _chunkWQJJNIMQjs.planCustomerDbQuery.call(void 0, query);
     if (options.dryRun) {
-      _chunkKGNTKMRGjs.printCommandEnvelope.call(void 0, 
+      _chunkRTO5QZWTjs.printCommandEnvelope.call(void 0, 
         {
           dryRun: true,
           ...plan,
@@ -362,11 +363,11 @@ async function runDbQueryCommand(options) {
             ...out === void 0 ? {} : { file: _path.resolve.call(void 0, out) }
           }
         },
-        { json: options.json || _chunkKGNTKMRGjs.shouldEmitJson.call(void 0, ) }
+        { json: options.json || _chunkRTO5QZWTjs.shouldEmitJson.call(void 0, ) }
       );
       return 0;
     }
-    const client = new (0, _chunkE23BQ5SCjs.DeeplineClient)();
+    const client = new (0, _chunkWQJJNIMQjs.DeeplineClient)();
     const result = await client.db.query(query);
     renderDbQueryResult(result, query, {
       format,
@@ -375,8 +376,8 @@ async function runDbQueryCommand(options) {
     });
     return 0;
   } catch (error) {
-    if (error instanceof _chunkCS6RAIVYjs.CustomerDbQueryOutcomeUnknownError && (options.json || _chunkKGNTKMRGjs.shouldEmitJson.call(void 0, ))) {
-      _chunkKGNTKMRGjs.printCommandEnvelope.call(void 0, 
+    if (error instanceof _chunkV7UP2F4Ujs.CustomerDbQueryOutcomeUnknownError && (options.json || _chunkRTO5QZWTjs.shouldEmitJson.call(void 0, ))) {
+      _chunkRTO5QZWTjs.printCommandEnvelope.call(void 0, 
         {
           ok: false,
           error: {
@@ -424,8 +425,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 = _chunkKGNTKMRGjs.argsWantJson.call(void 0, args);
-  const client = new (0, _chunkE23BQ5SCjs.DeeplineClient)();
+  const jsonOutput = _chunkRTO5QZWTjs.argsWantJson.call(void 0, args);
+  const client = new (0, _chunkWQJJNIMQjs.DeeplineClient)();
   let result;
   try {
     result = await client.repairIngestionStorage(
@@ -441,7 +442,7 @@ async function handleDbRepair(args) {
     console.error(errorMessage2(error));
     return 1;
   }
-  _chunkKGNTKMRGjs.printCommandEnvelope.call(void 0, 
+  _chunkRTO5QZWTjs.printCommandEnvelope.call(void 0, 
     {
       command: "db repair",
       status: result.status,

package/dist/cli/{db-7XP5UWEW.mjs → db-XORGNBIC.mjs}

@@ -4,9 +4,10 @@ import {
 import {
   DeeplineClient,
   planCustomerDbQuery
-} from "./chunk-JHIJIHFB.mjs";
+} from "./chunk-MR6XCBQJ.mjs";
 import "./chunk-6IKARAYD.mjs";
 import "./chunk-JI2B4RZP.mjs";
+import "./chunk-EIMG75BT.mjs";
 import "./chunk-UBKA33KY.mjs";
 import {
   argsWantJson,
@@ -17,15 +18,15 @@ import {
   printCommandEnvelope,
   recordRows,
   shouldEmitJson
-} from "./chunk-NR3DFKNF.mjs";
+} from "./chunk-XKZXO7D3.mjs";
 import {
   CustomerDbQueryOutcomeUnknownError
-} from "./chunk-FJGW5GXU.mjs";
+} from "./chunk-VE3U3SQC.mjs";
 import "./chunk-DLIRSHV6.mjs";
 import {
   DeeplineError
 } from "./chunk-NXGCO4JB.mjs";
-import "./chunk-TJI2EN6K.mjs";
+import "./chunk-NHB5YUCS.mjs";
 import "./chunk-WZYKRD7T.mjs";
 import "./chunk-KRD6H754.mjs";
 

package/dist/cli/{describe-K4ES5LIL.mjs → describe-6O2ENKTP.mjs}

@@ -1,50 +1,43 @@
-import {
-  buildPlayDashboardUrl,
-  describedPlay
-} from "./chunk-5BB2RGAX.mjs";
 import {
   describedTool,
   formatModelDescription,
   publicToolSchemas,
+  seedToolListScript,
   toolMetadataJsonForDescribe
-} from "./chunk-XXUDVEXK.mjs";
+} from "./chunk-3T4MCB5R.mjs";
 import {
   SCHEMA_LINE_LIMIT,
   addDescribeOptions,
+  buildPlayDashboardUrl,
   byokLines,
   describedJson,
   describedLines,
+  describedPlay,
   examples,
   schemaLines,
   topLevelField
-} from "./chunk-VB6KECLU.mjs";
+} from "./chunk-5WNJF2T3.mjs";
 import "./chunk-OVDNJAJN.mjs";
-import "./chunk-3HWALOL2.mjs";
-import "./chunk-H7HIDGZ7.mjs";
-import "./chunk-HQXL5526.mjs";
-import "./chunk-ZYBGA4AR.mjs";
-import "./chunk-XRQ2AQL7.mjs";
-import "./chunk-ERFN2QY4.mjs";
-import "./chunk-KZZC33PY.mjs";
+import "./chunk-QHGPA362.mjs";
+import "./chunk-H5KLUGY7.mjs";
 import "./chunk-3HU47EGZ.mjs";
 import {
   DeeplineClient
-} from "./chunk-JHIJIHFB.mjs";
+} from "./chunk-MR6XCBQJ.mjs";
 import "./chunk-6IKARAYD.mjs";
 import "./chunk-JI2B4RZP.mjs";
+import "./chunk-EIMG75BT.mjs";
 import "./chunk-UBKA33KY.mjs";
-import "./chunk-UFS752TU.mjs";
 import "./chunk-WXLOW623.mjs";
-import "./chunk-GAMFK2ZP.mjs";
 import {
   printCommandEnvelope
-} from "./chunk-NR3DFKNF.mjs";
-import "./chunk-FJGW5GXU.mjs";
+} from "./chunk-XKZXO7D3.mjs";
+import "./chunk-VE3U3SQC.mjs";
 import "./chunk-DLIRSHV6.mjs";
 import {
   DeeplineError
 } from "./chunk-NXGCO4JB.mjs";
-import "./chunk-TJI2EN6K.mjs";
+import "./chunk-NHB5YUCS.mjs";
 import "./chunk-WZYKRD7T.mjs";
 import "./chunk-KRD6H754.mjs";
 
@@ -115,29 +108,19 @@ async function describeFeature(tool, feature, value, dependencies) {
   return VIEWS[feature.view](value ?? feature.defaultValue, tool, dependencies);
 }
 
-// src/cli/commands/describe.ts
+// src/cli/describe-core.ts
 var FILTER_OF = {
   tool: "tools",
   monitor_type: "monitors",
   prebuilt_play: "prebuilts",
   custom_play: "custom"
 };
-async function found(lookup) {
-  try {
-    return await lookup;
-  } catch (error) {
-    if (error instanceof DeeplineError && (error.statusCode === 404 || error.code === "PLAY_NOT_FOUND" || error.code === "NOT_FOUND")) {
-      return null;
-    }
-    throw error;
-  }
-}
-async function describeAnything(name, options, onMissing) {
+async function describeName(name, options, lookups) {
   const maintainedOnly = options.prebuilt === true || options.tool === true;
   const wants = (filter) => (!options.kinds || options.kinds.includes(filter)) && !(maintainedOnly && filter === "custom");
-  const client = new DeeplineClient();
   const play = async (reference) => {
-    const record2 = await client.describePlay(reference);
+    const record2 = await lookups.play(reference);
+    if (!record2) return null;
     return {
       described: describedPlay(record2),
       record: { ...record2 },
@@ -148,7 +131,8 @@ async function describeAnything(name, options, onMissing) {
     };
   };
   const tool = async () => {
-    const record2 = options.fetchedTool ?? await client.getTool(name);
+    const record2 = await lookups.tool(name);
+    if (!record2) return null;
     const { byok } = record2;
     const features = toolFeatures(record2);
     return {
@@ -159,12 +143,16 @@ async function describeAnything(name, options, onMissing) {
         ...byok?.required === true ? { byok } : {},
         ...features.length ? { features: features.map(({ view: _view, ...feature }) => feature) } : {}
       },
-      record: toolMetadataJsonForDescribe(record2, name),
+      record: toolMetadataJsonForDescribe(
+        record2,
+        name,
+        lookups.seedStarterScript
+      ),
       schemas: publicToolSchemas(record2),
       feature: (featureName, value) => {
         const feature = features.find(({ name: name2 }) => name2 === featureName);
         return feature ? describeFeature(record2, feature, value, {
-          describeModel: (model) => client.describeModel(model)
+          describeModel: (model) => lookups.describeModel(model)
         }) : null;
       }
     };
@@ -176,19 +164,13 @@ async function describeAnything(name, options, onMissing) {
   ];
   const matches = await Promise.all(
     sources.filter((source) => source.kinds.some(wants)).map(async ({ kinds, find }) => {
-      const match = await found(find());
+      const match = await find();
       const filter = match && FILTER_OF[match.described.kind];
       return filter && kinds.includes(filter) && wants(filter) ? match : null;
     })
   );
   const [chosen, shadowed] = matches.filter((match) => match !== null);
-  if (!chosen) {
-    if (onMissing) return onMissing();
-    console.error(
-      `Nothing named "${name}". Search for it: deepline search ${JSON.stringify(name.replace(/[-_./]+/g, " "))}`
-    );
-    return 2;
-  }
+  if (!chosen) return { status: "missing" };
   const { described, record } = chosen;
   const shadows = described.kind === "custom_play" && shadowed ? {
     kind: shadowed.described.kind,
@@ -196,49 +178,49 @@ async function describeAnything(name, options, onMissing) {
   } : null;
   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 isPlay = described.kind === "prebuilt_play" || described.kind === "custom_play";
-  const dashboardUrl = isPlay ? buildPlayDashboardUrl(client.baseUrl, described.id) : null;
+  const dashboardUrl = isPlay ? buildPlayDashboardUrl(lookups.baseUrl, described.id) : null;
   if (options.webUrl) {
     if (!dashboardUrl) {
-      console.error(
-        `${described.id} is a ${described.kind.replace("_", " ")}, not a play; only plays have a play page.`
-      );
-      return 1;
+      return {
+        status: "refused",
+        message: `${described.id} is a ${described.kind.replace("_", " ")}, not a play; only plays have a play page.`,
+        exitCode: 1
+      };
     }
-    printCommandEnvelope(
-      { dashboardUrl },
-      { json, text: `${dashboardUrl}
-` }
-    );
-    return 0;
+    return {
+      status: "described",
+      envelope: { dashboardUrl },
+      lines: [dashboardUrl]
+    };
   }
   if (options.feature !== void 0) {
     const { name: featureName, value } = parseFeatureRequest(options.feature);
     const pending = chosen.feature?.(featureName, value) ?? null;
     const features = described.features ?? [];
     if (!pending) {
-      console.error(
-        features.length ? `${described.id} has no feature "${featureName}". Its features: ${features.map(({ name: name2 }) => name2).join(", ")}.` : `${described.id} has no features to describe.`
-      );
-      return 2;
+      return {
+        status: "refused",
+        message: features.length ? `${described.id} has no feature "${featureName}". Its features: ${features.map(({ name: name2 }) => name2).join(", ")}.` : `${described.id} has no features to describe.`,
+        exitCode: 2
+      };
     }
     const shownValue = value ?? features.find(({ name: name2 }) => name2 === featureName)?.defaultValue;
     const { details, lines } = await pending;
-    return deliver(
-      {
+    return {
+      status: "described",
+      envelope: {
         kind: described.kind,
         id: described.id,
         feature: featureName,
         ...shownValue ? { value: shownValue } : {},
         details
       },
-      [
+      lines: [
         `${described.id} --feature ${featureName}${shownValue ? `=${shownValue}` : ""}`,
         ...lines
-      ],
-      { json, out: options.out }
-    );
+      ]
+    };
   }
   const fields = (options.fields ?? "").split(",").map((name2) => name2.trim()).filter(Boolean);
   const named = options.cliExample === true || options.playExample === true;
@@ -304,7 +286,44 @@ async function describeAnything(name, options, onMissing) {
     ...dashboardUrl ? { dashboardUrl } : {},
     ...shadows ? { shadows, note } : {}
   };
-  return deliver(envelope, view.lines, { json, out: options.out });
+  return { status: "described", envelope, lines: view.lines };
+}
+
+// src/cli/commands/describe.ts
+async function found(lookup) {
+  try {
+    return await lookup;
+  } catch (error) {
+    if (error instanceof DeeplineError && (error.statusCode === 404 || error.code === "PLAY_NOT_FOUND" || error.code === "NOT_FOUND")) {
+      return null;
+    }
+    throw error;
+  }
+}
+async function describeAnything(name, options, onMissing) {
+  const client = new DeeplineClient();
+  const outcome = await describeName(name, options, {
+    play: (reference) => found(client.describePlay(reference)),
+    tool: async (toolName) => options.fetchedTool ?? await found(client.getTool(toolName)),
+    describeModel: (model) => client.describeModel(model),
+    baseUrl: client.baseUrl,
+    seedStarterScript: seedToolListScript
+  });
+  if (outcome.status === "missing") {
+    if (onMissing) return onMissing();
+    console.error(
+      `Nothing named "${name}". Search for it: deepline search ${JSON.stringify(name.replace(/[-_./]+/g, " "))}`
+    );
+    return 2;
+  }
+  if (outcome.status === "refused") {
+    console.error(outcome.message);
+    return outcome.exitCode;
+  }
+  return deliver(outcome.envelope, outcome.lines, {
+    json: options.json === true,
+    out: options.out
+  });
 }
 function deliver(envelope, lines, { json, out }) {
   const text = `${lines.join("\n")}