deepline 0.3.396 → 0.3.398

package/dist/cli/chunk-FIVKWNMT.mjs

@@ -0,0 +1,210 @@
+// src/tool-output.ts
+import {
+  closeSync,
+  mkdirSync,
+  openSync,
+  writeFileSync,
+  writeSync
+} from "fs";
+import { homedir } from "os";
+import { dirname, join } from "path";
+function isPlainObject(value) {
+  return Boolean(value) && typeof value === "object" && !Array.isArray(value);
+}
+function getByDottedPath(root, dottedPath) {
+  let current = root;
+  for (const segment of String(dottedPath || "").split(".").filter(Boolean)) {
+    if (!isPlainObject(current) || !(segment in current)) {
+      return null;
+    }
+    current = current[segment];
+  }
+  return current;
+}
+function normalizeRows(value) {
+  if (!Array.isArray(value)) return null;
+  return value.map((entry) => {
+    if (isPlainObject(entry)) return entry;
+    return { value: entry };
+  });
+}
+function columnsForRows(rows) {
+  const seen = /* @__PURE__ */ new Set();
+  const columns = [];
+  for (const row of rows) {
+    for (const key of Object.keys(row)) {
+      if (!seen.has(key)) {
+        seen.add(key);
+        columns.push(key);
+      }
+    }
+  }
+  return columns;
+}
+function candidateRoots(payload) {
+  const roots = [
+    { path: null, value: payload }
+  ];
+  if (isPlainObject(payload) && isPlainObject(payload.toolResponse)) {
+    roots.push({ path: "toolResponse", value: payload.toolResponse });
+    if (Object.prototype.hasOwnProperty.call(payload.toolResponse, "raw")) {
+      roots.push({
+        path: "toolResponse.raw",
+        value: payload.toolResponse.raw
+      });
+    }
+  }
+  if (isPlainObject(payload) && isPlainObject(payload.output)) {
+    roots.push({ path: "output", value: payload.output });
+    if (Object.prototype.hasOwnProperty.call(payload.output, "body")) {
+      roots.push({ path: "output.body", value: payload.output.body });
+    }
+  }
+  if (isPlainObject(payload) && isPlainObject(payload.result)) {
+    roots.push({ path: "result", value: payload.result });
+    if (isPlainObject(payload.result.data)) {
+      roots.push({ path: "result.data", value: payload.result.data });
+    }
+  }
+  return roots;
+}
+function findBestArrayCandidate(value, pathPrefix = "", depth = 0) {
+  if (depth > 5) return null;
+  const directRows = normalizeRows(value);
+  const hasObjectRow = directRows?.some(
+    (row) => Object.keys(row).some((key) => key !== "value")
+  ) ?? false;
+  let best = directRows && directRows.length > 0 && hasObjectRow ? { path: pathPrefix, rows: directRows } : null;
+  if (!isPlainObject(value)) {
+    return best;
+  }
+  for (const [key, child] of Object.entries(value)) {
+    const childPath = pathPrefix ? `${pathPrefix}.${key}` : key;
+    const candidate = findBestArrayCandidate(child, childPath, depth + 1);
+    if (!candidate) continue;
+    if (!best || candidate.rows.length > best.rows.length) {
+      best = candidate;
+    }
+  }
+  return best;
+}
+function tryConvertToList(payload, options) {
+  const listExtractorPaths = Array.isArray(options?.listExtractorPaths) ? options?.listExtractorPaths.filter(
+    (entry) => typeof entry === "string" && entry.trim().length > 0
+  ) : [];
+  if (listExtractorPaths.length > 0) {
+    let emptyMatch = null;
+    for (const root of candidateRoots(payload)) {
+      for (const extractorPath of listExtractorPaths) {
+        const resolved = getByDottedPath(root.value, extractorPath);
+        const rows = normalizeRows(resolved);
+        if (!rows) {
+          continue;
+        }
+        const sourcePath = root.path ? `${root.path}.${extractorPath}` : extractorPath;
+        if (rows.length > 0) {
+          return { rows, strategy: "configured_paths", sourcePath };
+        }
+        emptyMatch ??= { rows, strategy: "configured_paths", sourcePath };
+      }
+    }
+    if (emptyMatch) {
+      return emptyMatch;
+    }
+  }
+  const roots = candidateRoots(payload);
+  const v2Raw = roots.find((root) => root.path === "toolResponse.raw");
+  for (const root of v2Raw ? [v2Raw] : roots) {
+    const candidate = findBestArrayCandidate(root.value, root.path ?? "");
+    if (!candidate || candidate.rows.length === 0) continue;
+    return {
+      rows: candidate.rows,
+      strategy: "auto_detected",
+      sourcePath: candidate.path || root.path
+    };
+  }
+  return null;
+}
+function projectRowOutput(conversion) {
+  return {
+    rows: conversion.rows,
+    rowCount: conversion.rows.length,
+    columns: columnsForRows(conversion.rows),
+    previewRows: conversion.rows.slice(0, 5),
+    strategy: conversion.strategy,
+    sourcePath: conversion.sourcePath
+  };
+}
+function ensureOutputDir() {
+  const outputDir = join(homedir(), ".local", "share", "deepline", "data");
+  mkdirSync(outputDir, { recursive: true });
+  return outputDir;
+}
+function writeJsonOutputFile(payload, stem) {
+  const outputDir = ensureOutputDir();
+  const outputPath = join(outputDir, `${stem}_${Date.now()}.json`);
+  writeFileSync(outputPath, JSON.stringify(payload, null, 2), "utf-8");
+  return outputPath;
+}
+function writeCsvOutputFile(rows, stem, options) {
+  const outputPath = options?.outPath ? options.outPath : join(ensureOutputDir(), `${stem}_${Date.now()}.csv`);
+  mkdirSync(dirname(outputPath), { recursive: true });
+  const columns = columnsForRows(rows);
+  const escapeCell = (value) => {
+    const normalized = value == null ? "" : typeof value === "string" || typeof value === "number" || typeof value === "boolean" ? String(value) : JSON.stringify(value);
+    if (/[",\n]/.test(normalized)) {
+      return `"${normalized.replace(/"/g, '""')}"`;
+    }
+    return normalized;
+  };
+  const fd = openSync(outputPath, "w");
+  try {
+    writeSync(fd, `${columns.map(escapeCell).join(",")}
+`);
+    for (const row of rows) {
+      writeSync(
+        fd,
+        `${columns.map((column) => escapeCell(row[column])).join(",")}
+`
+      );
+    }
+  } finally {
+    closeSync(fd);
+  }
+  const previewRows = rows.slice(0, 5);
+  const previewColumns = columns.slice(0, 5);
+  const preview = [
+    previewColumns.join(","),
+    ...previewRows.map(
+      (row) => previewColumns.map((column) => escapeCell(row[column])).join(",")
+    )
+  ].join("\n");
+  return {
+    path: outputPath,
+    rowCount: rows.length,
+    columns,
+    preview
+  };
+}
+function extractSummaryFields(payload) {
+  const candidates = candidateRoots(payload);
+  for (const candidate of candidates) {
+    if (!isPlainObject(candidate.value)) continue;
+    const summaryEntries = Object.entries(candidate.value).filter(
+      ([, value]) => {
+        return value == null || typeof value === "string" || typeof value === "number" || typeof value === "boolean";
+      }
+    );
+    if (summaryEntries.length === 0) continue;
+    return Object.fromEntries(summaryEntries);
+  }
+  return {};
+}
+
+export {
+  tryConvertToList,
+  projectRowOutput,
+  writeJsonOutputFile,
+  writeCsvOutputFile,
+  extractSummaryFields
+};

package/dist/cli/{chunk-7Z66NHUC.js → chunk-G6BP55EP.js}

@@ -2,10 +2,10 @@
 
 
 
-var _chunkRTO5QZWTjs = require('./chunk-RTO5QZWT.js');
+var _chunkS22ZQZMUjs = require('./chunk-S22ZQZMU.js');
 
 
-var _chunkV7UP2F4Ujs = require('./chunk-V7UP2F4U.js');
+var _chunkJU3PF7WMjs = require('./chunk-JU3PF7WM.js');
 
 // src/cli/commands/git.ts
 function shellQuote(value) {
@@ -32,11 +32,11 @@ function renderDeployment(deployment) {
   return `${deployment.id}  ${source} (${kind}) - ${deployment.status}${suffix}`;
 }
 async function handleList(options) {
-  const { http } = _chunkRTO5QZWTjs.getAuthedHttpClient.call(void 0, );
+  const { http } = _chunkS22ZQZMUjs.getAuthedHttpClient.call(void 0, );
   const payload = await http.get(
     `/api/v2/play-projects${options.all ? "?includeDisabled=1" : ""}`
   );
-  _chunkRTO5QZWTjs.printCommandEnvelope.call(void 0, 
+  _chunkS22ZQZMUjs.printCommandEnvelope.call(void 0, 
     {
       projects: payload.projects,
       count: payload.projects.length,
@@ -73,7 +73,7 @@ function describeInstallationStatus(installation) {
   }
 }
 async function handleStatus(options) {
-  const { http } = _chunkRTO5QZWTjs.getAuthedHttpClient.call(void 0, );
+  const { http } = _chunkS22ZQZMUjs.getAuthedHttpClient.call(void 0, );
   const payload = await http.get("/api/v2/github/installation");
   const installation = payload.installation;
   const others = (_nullishCoalesce(payload.installations, () => ( []))).filter(
@@ -136,7 +136,7 @@ async function handleStatus(options) {
       )
     );
   }
-  _chunkRTO5QZWTjs.printCommandEnvelope.call(void 0, 
+  _chunkS22ZQZMUjs.printCommandEnvelope.call(void 0, 
     {
       installation,
       installations: _nullishCoalesce(payload.installations, () => ( [])),
@@ -147,10 +147,10 @@ async function handleStatus(options) {
   );
 }
 async function handleRepos(options) {
-  const { http } = _chunkRTO5QZWTjs.getAuthedHttpClient.call(void 0, );
+  const { http } = _chunkS22ZQZMUjs.getAuthedHttpClient.call(void 0, );
   const query = options.installation ? `?installationId=${encodeURIComponent(options.installation)}` : "";
   const payload = await http.get(`/api/v2/github/repos${query}`);
-  _chunkRTO5QZWTjs.printCommandEnvelope.call(void 0, 
+  _chunkS22ZQZMUjs.printCommandEnvelope.call(void 0, 
     {
       installation: payload.installation,
       repositories: payload.repositories,
@@ -171,7 +171,7 @@ async function handleRepos(options) {
 }
 async function resolveRepoId(repo, installation) {
   if (/^\d+$/.test(repo)) return Number(repo);
-  const { http } = _chunkRTO5QZWTjs.getAuthedHttpClient.call(void 0, );
+  const { http } = _chunkS22ZQZMUjs.getAuthedHttpClient.call(void 0, );
   const query = installation ? `?installationId=${encodeURIComponent(installation)}` : "";
   const payload = await http.get(
     `/api/v2/github/repos${query}`
@@ -188,7 +188,7 @@ async function resolveRepoId(repo, installation) {
 }
 async function handleLink(repo, options) {
   const repoId = await resolveRepoId(repo, options.installation);
-  const { http } = _chunkRTO5QZWTjs.getAuthedHttpClient.call(void 0, );
+  const { http } = _chunkS22ZQZMUjs.getAuthedHttpClient.call(void 0, );
   const payload = await http.post("/api/v2/play-projects", {
     repoId,
     ...options.installation !== void 0 ? { installationId: options.installation } : {},
@@ -197,7 +197,7 @@ async function handleLink(repo, options) {
     ...options.branch !== void 0 ? { productionBranch: options.branch } : {},
     ...options.prChecks !== void 0 ? { checkOnPullRequest: options.prChecks } : {}
   });
-  _chunkRTO5QZWTjs.printCommandEnvelope.call(void 0, 
+  _chunkS22ZQZMUjs.printCommandEnvelope.call(void 0, 
     {
       project: payload.project,
       render: {
@@ -220,11 +220,11 @@ async function handleLink(repo, options) {
   );
 }
 async function handleGet(id, options) {
-  const { http } = _chunkRTO5QZWTjs.getAuthedHttpClient.call(void 0, );
+  const { http } = _chunkS22ZQZMUjs.getAuthedHttpClient.call(void 0, );
   const payload = await http.get(
     `/api/v2/play-projects/${encodeURIComponent(id)}`
   );
-  _chunkRTO5QZWTjs.printCommandEnvelope.call(void 0, 
+  _chunkS22ZQZMUjs.printCommandEnvelope.call(void 0, 
     {
       project: payload.project,
       render: {
@@ -240,7 +240,7 @@ async function handleGet(id, options) {
   );
 }
 async function handleSet(id, options) {
-  const { http } = _chunkRTO5QZWTjs.getAuthedHttpClient.call(void 0, );
+  const { http } = _chunkS22ZQZMUjs.getAuthedHttpClient.call(void 0, );
   const payload = await http.patch(
     `/api/v2/play-projects/${encodeURIComponent(id)}`,
     {
@@ -251,7 +251,7 @@ async function handleSet(id, options) {
       ...options.disabled !== void 0 ? { disabled: options.disabled } : {}
     }
   );
-  _chunkRTO5QZWTjs.printCommandEnvelope.call(void 0, 
+  _chunkS22ZQZMUjs.printCommandEnvelope.call(void 0, 
     {
       project: payload.project,
       render: {
@@ -264,9 +264,9 @@ async function handleSet(id, options) {
   );
 }
 async function handleUnlink(id, options) {
-  const { http } = _chunkRTO5QZWTjs.getAuthedHttpClient.call(void 0, );
+  const { http } = _chunkS22ZQZMUjs.getAuthedHttpClient.call(void 0, );
   await http.delete(`/api/v2/play-projects/${encodeURIComponent(id)}`);
-  _chunkRTO5QZWTjs.printCommandEnvelope.call(void 0, 
+  _chunkS22ZQZMUjs.printCommandEnvelope.call(void 0, 
     {
       ok: true,
       id,
@@ -286,10 +286,10 @@ async function handleUnlink(id, options) {
   );
 }
 async function handleConnect(options) {
-  const baseUrl = _chunkV7UP2F4Ujs.resolveBaseUrlOnly.call(void 0, );
+  const baseUrl = _chunkJU3PF7WMjs.resolveBaseUrlOnly.call(void 0, );
   const connectUrl = `${baseUrl.replace(/\/$/, "")}/api/v2/github/connect`;
-  const opened = _chunkRTO5QZWTjs.openInBrowser.call(void 0, connectUrl);
-  _chunkRTO5QZWTjs.printCommandEnvelope.call(void 0, 
+  const opened = _chunkS22ZQZMUjs.openInBrowser.call(void 0, connectUrl);
+  _chunkS22ZQZMUjs.printCommandEnvelope.call(void 0, 
     {
       connectUrl,
       browser: opened,
@@ -311,7 +311,7 @@ async function handleConnect(options) {
   );
 }
 async function handleDeploymentsList(options) {
-  const { http } = _chunkRTO5QZWTjs.getAuthedHttpClient.call(void 0, );
+  const { http } = _chunkS22ZQZMUjs.getAuthedHttpClient.call(void 0, );
   const query = new URLSearchParams();
   if (options.repo) query.set("projectId", options.repo);
   if (options.limit) query.set("limit", options.limit);
@@ -319,7 +319,7 @@ async function handleDeploymentsList(options) {
   const payload = await http.get(
     `/api/v2/deployments${suffix}`
   );
-  _chunkRTO5QZWTjs.printCommandEnvelope.call(void 0, 
+  _chunkS22ZQZMUjs.printCommandEnvelope.call(void 0, 
     {
       deployments: payload.deployments,
       count: payload.deployments.length,
@@ -363,12 +363,12 @@ function renderDeploymentMonitorLines(results) {
   ]);
 }
 async function handleDeploymentGet(id, options) {
-  const { http } = _chunkRTO5QZWTjs.getAuthedHttpClient.call(void 0, );
+  const { http } = _chunkS22ZQZMUjs.getAuthedHttpClient.call(void 0, );
   const payload = await http.get(`/api/v2/deployments/${encodeURIComponent(id)}`);
   const playLines = renderDeploymentPlayLines(payload.deployment.results);
   const monitorLines = renderDeploymentMonitorLines(payload.deployment.results);
   const repository = _nullishCoalesce(_optionalChain([payload, 'access', _10 => _10.project, 'optionalAccess', _11 => _11.repoFullName]), () => ( payload.deployment.repoFullName));
-  _chunkRTO5QZWTjs.printCommandEnvelope.call(void 0, 
+  _chunkS22ZQZMUjs.printCommandEnvelope.call(void 0, 
     {
       deployment: payload.deployment,
       project: payload.project,
@@ -387,9 +387,9 @@ async function handleDeploymentGet(id, options) {
   );
 }
 async function handleDeploymentCancel(id, options) {
-  const { http } = _chunkRTO5QZWTjs.getAuthedHttpClient.call(void 0, );
+  const { http } = _chunkS22ZQZMUjs.getAuthedHttpClient.call(void 0, );
   const payload = await http.post(`/api/v2/deployments/${encodeURIComponent(id)}/cancel`, {});
-  _chunkRTO5QZWTjs.printCommandEnvelope.call(void 0, 
+  _chunkS22ZQZMUjs.printCommandEnvelope.call(void 0, 
     {
       cancelled: payload.cancelled,
       deployment: payload.deployment,

package/dist/cli/{chunk-GNN4MY5X.js → chunk-HFDBZXMV.js}

@@ -49,7 +49,7 @@ var SDK_RELEASE = {
   // getters keep their established compatibility behavior.
   // 0.3.1 deprecated the legacy `deepline enrich` command in favor of Plays.
   // 0.3.90 is the first deliberately versioned SDK release for API v3.
-  version: "0.3.396",
+  version: "0.3.398",
   updateSummary: "Play grep now returns concise results with the matched fields and terms. Automatic CLI updates are enabled by default; use `deepline settings autoupdate off` to opt out, `deepline settings autoupdate on` to re-enable updates, or `deepline settings autoupdate pin <version>` to hold an exact release.",
   packageCapabilities: {
     updatePreferences: 1,

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

@@ -2,12 +2,9 @@ import {
   describedTool,
   formatModelDescription,
   publicToolSchemas,
-  seedToolListScript,
   toolMetadataJsonForDescribe
-} from "./chunk-3T4MCB5R.mjs";
+} from "./chunk-YHZUZO3U.mjs";
 import {
-  SCHEMA_LINE_LIMIT,
-  addDescribeOptions,
   buildPlayDashboardUrl,
   byokLines,
   describedJson,
@@ -16,34 +13,10 @@ import {
   examples,
   schemaLines,
   topLevelField
-} from "./chunk-5WNJF2T3.mjs";
-import "./chunk-OVDNJAJN.mjs";
-import "./chunk-QHGPA362.mjs";
-import "./chunk-H5KLUGY7.mjs";
-import "./chunk-3HU47EGZ.mjs";
-import {
-  DeeplineClient
-} from "./chunk-MR6XCBQJ.mjs";
-import "./chunk-6IKARAYD.mjs";
-import "./chunk-JI2B4RZP.mjs";
-import "./chunk-EIMG75BT.mjs";
-import "./chunk-UBKA33KY.mjs";
-import "./chunk-WXLOW623.mjs";
-import {
-  printCommandEnvelope
-} from "./chunk-XKZXO7D3.mjs";
-import "./chunk-VE3U3SQC.mjs";
-import "./chunk-DLIRSHV6.mjs";
+} from "./chunk-IHG7UAHD.mjs";
 import {
   DeeplineError
 } from "./chunk-NXGCO4JB.mjs";
-import "./chunk-NHB5YUCS.mjs";
-import "./chunk-WZYKRD7T.mjs";
-import "./chunk-KRD6H754.mjs";
-
-// src/cli/commands/describe.ts
-import { writeFileSync } from "fs";
-import { resolve } from "path";
 
 // src/cli/tool-features.ts
 var VIEWS = {
@@ -115,6 +88,24 @@ var FILTER_OF = {
   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;
+  }
+}
+function describeLookupsFor(client) {
+  return {
+    play: (reference) => found(client.describePlay(reference)),
+    tool: (name) => found(client.getTool(name)),
+    describeModel: (model) => client.describeModel(model),
+    baseUrl: client.baseUrl
+  };
+}
 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");
@@ -289,136 +280,7 @@ async function describeName(name, options, lookups) {
   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")}
-`;
-  if (out) {
-    const path = resolve(out);
-    const content = json ? `${JSON.stringify(envelope, null, 2)}
-` : text;
-    writeFileSync(path, content);
-    const bytes = Buffer.byteLength(content);
-    printCommandEnvelope(
-      { path, bytes },
-      { json, text: `Wrote ${path} (${bytes} bytes)
-` }
-    );
-    return 0;
-  }
-  printCommandEnvelope(envelope, { json, text });
-  return 0;
-}
-function registerDescribeCommand(program) {
-  addDescribeOptions(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",
-    `
-What you can describe:
-  Any id deepline search returns: a tool id, a monitor type id, or a play name
-  or reference. You do not say which kind it is; tool ids, monitor type ids
-  and prebuilt play names never overlap.
-
-When a name is taken twice:
-  A play your workspace created is shown instead of a Deepline tool, monitor
-  type or prebuilt play with the same name, and the output says so.
-  Pass --prebuilt (or --tool) to see the Deepline one.
-
-What it prints:
-  The same sections for every kind: what it is, cost, inputs, outputs, then
-  an example of running it from the CLI and from inside a play.
-
-Examples in the output:
-  (default)        required inputs filled in, first 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
-
-Features:
-  A tool lists its features: parts with their own description, such as the
-  model an AI tool runs. --feature <name> describes one at its default value,
-  --feature <name>=<value> at another, e.g. --feature model=openai/gpt-5.6-luna.
-
-Schema size and format:
-  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 ${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           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
-  --out <path>     save any of the above to a file instead of printing it
-
-Play page:
-  For a play, the output ends with its play page URL (JSON: dashboardUrl).
-  --web-url        print only that URL; with --json, {"dashboardUrl": ...}.
-                   Fails for a tool or monitor type, which have no play page.
-
-Older commands:
-  deepline tools describe and deepline plays describe are this command limited
-  to one kind. Their own flags still work: --pricing-only, --examples-only,
-  --model and --estimate-payload on tools; --json <fields> on plays.
-
-Examples:
-  deepline describe hunter_email_verifier
-  deepline describe person-linkedin-to-email
-  deepline describe my-play --prebuilt
-  deepline describe ai_ark_people_search --full-schema
-  deepline describe prebuilt/person-to-email-batch --web-url
-  deepline describe ai_ark_people_search --schema-only --out schema.json
-`
-  ).action(async (name, options) => {
-    process.exitCode = await describeAnything(name, options);
-  });
-}
 export {
-  describeAnything,
-  registerDescribeCommand
+  describeLookupsFor,
+  describeName
 };