deepline 0.3.395 → 0.3.396

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

@@ -1,51 +1,43 @@
-import {
-  buildPlayDashboardUrl,
-  describedPlay
-} from "./chunk-XMAPE2KH.mjs";
-import "./chunk-3TRY7KAC.mjs";
 import {
   describedTool,
   formatModelDescription,
   publicToolSchemas,
+  seedToolListScript,
   toolMetadataJsonForDescribe
-} from "./chunk-EFLQHJZ6.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-7XAM7KDW.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-G4IWGRMK.mjs";
+} from "./chunk-MR6XCBQJ.mjs";
 import "./chunk-6IKARAYD.mjs";
 import "./chunk-JI2B4RZP.mjs";
-import "./chunk-5VCZ3WRH.mjs";
+import "./chunk-EIMG75BT.mjs";
 import "./chunk-UBKA33KY.mjs";
-import "./chunk-UFS752TU.mjs";
-import "./chunk-GAMFK2ZP.mjs";
 import "./chunk-WXLOW623.mjs";
 import {
   printCommandEnvelope
-} from "./chunk-47M6HPGP.mjs";
-import "./chunk-6D7A2FSL.mjs";
+} from "./chunk-XKZXO7D3.mjs";
+import "./chunk-VE3U3SQC.mjs";
 import "./chunk-DLIRSHV6.mjs";
 import {
   DeeplineError
 } from "./chunk-NXGCO4JB.mjs";
-import "./chunk-BON3DRC6.mjs";
+import "./chunk-NHB5YUCS.mjs";
 import "./chunk-WZYKRD7T.mjs";
 import "./chunk-KRD6H754.mjs";
 
@@ -116,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 },
@@ -149,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 {
@@ -160,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;
       }
     };
@@ -177,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,
@@ -197,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;
@@ -305,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")}

package/dist/cli/{describe-YKOE54ZO.js → describe-EFWNECHI.js}

@@ -1,14 +1,12 @@
 "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 _chunk4KLCLLTOjs = require('./chunk-4KLCLLTO.js');
-require('./chunk-K5T3EN6D.js');
 
 
 
+var _chunk2VOLOWYZjs = require('./chunk-2VOLOWYZ.js');
 
 
-var _chunkLZLBR2SFjs = require('./chunk-LZLBR2SF.js');
 
 
 
@@ -18,34 +16,28 @@ var _chunkLZLBR2SFjs = require('./chunk-LZLBR2SF.js');
 
 
 
-var _chunkZMVJSS6Njs = require('./chunk-ZMVJSS6N.js');
+var _chunkNSOTASOPjs = require('./chunk-NSOTASOP.js');
 require('./chunk-AID3OYVJ.js');
-require('./chunk-MH73HMPV.js');
-require('./chunk-3KC45UVF.js');
-require('./chunk-GSK6NHVM.js');
-require('./chunk-R4XZO6Z5.js');
-require('./chunk-GEJDBXXM.js');
-require('./chunk-RDXFGPJU.js');
+require('./chunk-KAEZNPUM.js');
+require('./chunk-LWERJUKN.js');
 require('./chunk-KB4SDX5S.js');
 
 
-var _chunk36ML3YKAjs = require('./chunk-36ML3YKA.js');
+var _chunkWQJJNIMQjs = require('./chunk-WQJJNIMQ.js');
 require('./chunk-S6R3OX7B.js');
 require('./chunk-UHNDVD3P.js');
-require('./chunk-DRM3CMHL.js');
+require('./chunk-KXMNM4AQ.js');
 require('./chunk-XDVT3GOM.js');
-require('./chunk-AYHLUHE5.js');
-require('./chunk-WJYPBHTE.js');
 require('./chunk-QJBJZVG6.js');
 
 
-var _chunkHRWUQJ4Kjs = require('./chunk-HRWUQJ4K.js');
-require('./chunk-56IFFVIB.js');
+var _chunkRTO5QZWTjs = require('./chunk-RTO5QZWT.js');
+require('./chunk-V7UP2F4U.js');
 require('./chunk-XNYIZMNQ.js');
 
 
 var _chunk7P5AA3SNjs = require('./chunk-7P5AA3SN.js');
-require('./chunk-TO2MWPGR.js');
+require('./chunk-GNN4MY5X.js');
 require('./chunk-OG64RBAC.js');
 require('./chunk-COGTRVWW.js');
 
@@ -66,13 +58,13 @@ var VIEWS = {
       details: model,
       lines: [
         ...unlisted,
-        ..._chunkLZLBR2SFjs.formatModelDescription.call(void 0, model).trimEnd().split("\n")
+        ..._chunk2VOLOWYZjs.formatModelDescription.call(void 0, model).trimEnd().split("\n")
       ]
     };
   },
   byok: async (_value, tool) => ({
     details: _nullishCoalesce(tool.byok, () => ( {})),
-    lines: _chunkZMVJSS6Njs.byokLines.call(void 0, _nullishCoalesce(tool.byok, () => ( {})))
+    lines: _chunkNSOTASOPjs.byokLines.call(void 0, _nullishCoalesce(tool.byok, () => ( {})))
   })
 };
 var isFeatureView = (value) => typeof value === "string" && Object.hasOwn(VIEWS, value);
@@ -116,31 +108,21 @@ async function describeFeature(tool, feature, value, dependencies) {
   return VIEWS[feature.view](_nullishCoalesce(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 _chunk7P5AA3SNjs.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 (0, _chunk36ML3YKAjs.DeeplineClient)();
   const play = async (reference) => {
-    const record2 = await client.describePlay(reference);
+    const record2 = await lookups.play(reference);
+    if (!record2) return null;
     return {
-      described: _chunk4KLCLLTOjs.describedPlay.call(void 0, record2),
+      described: _chunkNSOTASOPjs.describedPlay.call(void 0, record2),
       record: { ...record2 },
       schemas: {
         inputSchema: _nullishCoalesce(record2.inputSchema, () => ( null)),
@@ -149,23 +131,28 @@ async function describeAnything(name, options, onMissing) {
     };
   };
   const tool = async () => {
-    const record2 = await _asyncNullishCoalesce(options.fetchedTool, async () => ( await client.getTool(name)));
+    const record2 = await lookups.tool(name);
+    if (!record2) return null;
     const { byok } = record2;
     const features = toolFeatures(record2);
     return {
       described: {
-        ..._chunkLZLBR2SFjs.describedTool.call(void 0, record2, name),
+        ..._chunk2VOLOWYZjs.describedTool.call(void 0, record2, name),
         // Shown when the tool runs only on your own credentials; otherwise
         // it is a feature, described with --feature byok.
         ..._optionalChain([byok, 'optionalAccess', _3 => _3.required]) === true ? { byok } : {},
         ...features.length ? { features: features.map(({ view: _view, ...feature }) => feature) } : {}
       },
-      record: _chunkLZLBR2SFjs.toolMetadataJsonForDescribe.call(void 0, record2, name),
-      schemas: _chunkLZLBR2SFjs.publicToolSchemas.call(void 0, record2),
+      record: _chunk2VOLOWYZjs.toolMetadataJsonForDescribe.call(void 0, 
+        record2,
+        name,
+        lookups.seedStarterScript
+      ),
+      schemas: _chunk2VOLOWYZjs.publicToolSchemas.call(void 0, 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;
       }
     };
@@ -177,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,
@@ -197,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 ? _chunk4KLCLLTOjs.buildPlayDashboardUrl.call(void 0, client.baseUrl, described.id) : null;
+  const dashboardUrl = isPlay ? _chunkNSOTASOPjs.buildPlayDashboardUrl.call(void 0, 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
+      };
     }
-    _chunkHRWUQJ4Kjs.printCommandEnvelope.call(void 0, 
-      { 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 = _nullishCoalesce(_optionalChain([chosen, 'access', _4 => _4.feature, 'optionalCall', _5 => _5(featureName, value)]), () => ( null));
     const features = _nullishCoalesce(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 = _nullishCoalesce(value, () => ( _optionalChain([features, 'access', _6 => _6.find, 'call', _7 => _7(({ name: name2 }) => name2 === featureName), 'optionalAccess', _8 => _8.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 = (_nullishCoalesce(options.fields, () => ( ""))).split(",").map((name2) => name2.trim()).filter(Boolean);
   const named = options.cliExample === true || options.playExample === true;
@@ -262,7 +243,7 @@ async function describeAnything(name, options, onMissing) {
     },
     lines: [
       `${described.id} [${described.kind.replace("_", " ")}]`,
-      ..._chunkZMVJSS6Njs.schemaLines.call(void 0, described, {
+      ..._chunkNSOTASOPjs.schemaLines.call(void 0, described, {
         full: true,
         secondary: true,
         ...fields.length ? { fields } : {}
@@ -271,17 +252,17 @@ async function describeAnything(name, options, onMissing) {
   } : {
     envelope: {
       ...summary,
-      inputs: inputs.map(_chunkZMVJSS6Njs.topLevelField),
-      outputs: outputs.map(_chunkZMVJSS6Njs.topLevelField),
-      ...described.rowInputs ? { rowInputs: described.rowInputs.map(_chunkZMVJSS6Njs.topLevelField) } : {},
-      ...described.rowOutputs ? { rowOutputs: described.rowOutputs.map(_chunkZMVJSS6Njs.topLevelField) } : {},
-      runExamples: _chunkZMVJSS6Njs.examples.call(void 0, described, { verbose }),
+      inputs: inputs.map(_chunkNSOTASOPjs.topLevelField),
+      outputs: outputs.map(_chunkNSOTASOPjs.topLevelField),
+      ...described.rowInputs ? { rowInputs: described.rowInputs.map(_chunkNSOTASOPjs.topLevelField) } : {},
+      ...described.rowOutputs ? { rowOutputs: described.rowOutputs.map(_chunkNSOTASOPjs.topLevelField) } : {},
+      runExamples: _chunkNSOTASOPjs.examples.call(void 0, described, { verbose }),
       ...dashboardUrl ? { dashboardUrl } : {},
       ...shadows ? { shadows, note } : {}
     },
     lines: [
       ...note ? [`Note: ${note}`, ""] : [],
-      ..._chunkZMVJSS6Njs.describedLines.call(void 0, described, {
+      ..._chunkNSOTASOPjs.describedLines.call(void 0, described, {
         cli: shown && (!named || options.cliExample === true),
         play: shown && (!named || options.playExample === true),
         explain: named,
@@ -298,14 +279,51 @@ async function describeAnything(name, options, onMissing) {
     // its value stands, so callers of the older commands read what they did.
     { ...view.envelope, ...record }
   ) : {
-    ..._chunkZMVJSS6Njs.describedJson.call(void 0, described, {
+    ..._chunkNSOTASOPjs.describedJson.call(void 0, described, {
       secondary: verbose || fields.length > 0,
       verbose
     }),
     ...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 _chunk7P5AA3SNjs.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 (0, _chunkWQJJNIMQjs.DeeplineClient)();
+  const outcome = await describeName(name, options, {
+    play: (reference) => found(client.describePlay(reference)),
+    tool: async (toolName) => await _asyncNullishCoalesce(options.fetchedTool, async () => ( await found(client.getTool(toolName)))),
+    describeModel: (model) => client.describeModel(model),
+    baseUrl: client.baseUrl,
+    seedStarterScript: _chunk2VOLOWYZjs.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")}
@@ -316,18 +334,18 @@ function deliver(envelope, lines, { json, out }) {
 ` : text;
     _fs.writeFileSync.call(void 0, path, content);
     const bytes = Buffer.byteLength(content);
-    _chunkHRWUQJ4Kjs.printCommandEnvelope.call(void 0, 
+    _chunkRTO5QZWTjs.printCommandEnvelope.call(void 0, 
       { path, bytes },
       { json, text: `Wrote ${path} (${bytes} bytes)
 ` }
     );
     return 0;
   }
-  _chunkHRWUQJ4Kjs.printCommandEnvelope.call(void 0, envelope, { json, text });
+  _chunkRTO5QZWTjs.printCommandEnvelope.call(void 0, envelope, { json, text });
   return 0;
 }
 function registerDescribeCommand(program) {
-  _chunkZMVJSS6Njs.addDescribeOptions.call(void 0, program.command("describe <name>")).option("--web-url", "Print only a play's play page URL").description(
+  _chunkNSOTASOPjs.addDescribeOptions.call(void 0, program.command("describe <name>")).option("--web-url", "Print only a play's play page URL").description(
     "Describe anything search returns: a tool, monitor type, or play."
   ).addHelpText(
     "after",
@@ -364,7 +382,7 @@ Schema size and format:
   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 ${_chunkZMVJSS6Njs.SCHEMA_LINE_LIMIT} lines is folded: deeper objects show only their field
+  A schema over ${_chunkNSOTASOPjs.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

package/dist/cli/{executions-GRQXTB2P.js → executions-SFYAXPF4.js}

@@ -1,17 +1,17 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true});
 
-var _chunk36ML3YKAjs = require('./chunk-36ML3YKA.js');
+var _chunkWQJJNIMQjs = require('./chunk-WQJJNIMQ.js');
 require('./chunk-S6R3OX7B.js');
 require('./chunk-UHNDVD3P.js');
-require('./chunk-DRM3CMHL.js');
+require('./chunk-KXMNM4AQ.js');
 require('./chunk-XDVT3GOM.js');
 
 
-var _chunkHRWUQJ4Kjs = require('./chunk-HRWUQJ4K.js');
-require('./chunk-56IFFVIB.js');
+var _chunkRTO5QZWTjs = require('./chunk-RTO5QZWT.js');
+require('./chunk-V7UP2F4U.js');
 require('./chunk-XNYIZMNQ.js');
 require('./chunk-7P5AA3SN.js');
-require('./chunk-TO2MWPGR.js');
+require('./chunk-GNN4MY5X.js');
 require('./chunk-OG64RBAC.js');
 require('./chunk-COGTRVWW.js');
 
@@ -19,10 +19,10 @@ require('./chunk-COGTRVWW.js');
 function registerExecutionsCommands(program) {
   const executions = program.command("executions").description("Inspect and recover keyed tool executions.");
   executions.command("get").description("Retrieve a tool execution by its idempotency key.").requiredOption("--idempotency-key <key>", "Stable execution recovery key").option("--json", "Emit the stable JSON response").action(async (options) => {
-    const result = await new (0, _chunk36ML3YKAjs.DeeplineClient)().executions.getByKey(
+    const result = await new (0, _chunkWQJJNIMQjs.DeeplineClient)().executions.getByKey(
       options.idempotencyKey
     );
-    _chunkHRWUQJ4Kjs.printCommandEnvelope.call(void 0, result, { json: true });
+    _chunkRTO5QZWTjs.printCommandEnvelope.call(void 0, result, { json: true });
   });
 }