deepline 0.3.311 → 0.3.313

package/dist/cli/{db-6NIH4KTZ.js → db-VRE7CLIQ.js}

@@ -1,6 +1,6 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _nullishCoalesce(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return 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 _chunkQYL5ZV4Ujs = require('./chunk-QYL5ZV4U.js');
+var _chunkVSAYSOVCjs = require('./chunk-VSAYSOVC.js');
 require('./chunk-LA46MMTL.js');
 
 
@@ -10,10 +10,10 @@ require('./chunk-LA46MMTL.js');
 
 
 
-var _chunkXDUQQTISjs = require('./chunk-XDUQQTIS.js');
-require('./chunk-RNJ74JDH.js');
+var _chunkGQXEHX5Xjs = require('./chunk-GQXEHX5X.js');
+require('./chunk-FSZTWQFK.js');
 require('./chunk-XNYIZMNQ.js');
-require('./chunk-FYPZ43Y4.js');
+require('./chunk-HY2SSFRI.js');
 require('./chunk-S6R3OX7B.js');
 
 
@@ -48,8 +48,8 @@ function formatCell(value) {
   return text.length > 80 ? `${text.slice(0, 77)}...` : text;
 }
 function tableLines(result) {
-  const rows = _chunkXDUQQTISjs.dataExportRows.call(void 0, customerDbRows(result));
-  const responseColumns = _chunkXDUQQTISjs.dataExportColumns.call(void 0, 
+  const rows = _chunkGQXEHX5Xjs.dataExportRows.call(void 0, customerDbRows(result));
+  const responseColumns = _chunkGQXEHX5Xjs.dataExportColumns.call(void 0, 
     rows,
     customerDbColumnNames(result)
   );
@@ -95,7 +95,7 @@ function tableLines(result) {
   return lines;
 }
 function customerDbRows(result) {
-  return _chunkXDUQQTISjs.recordRows.call(void 0, result.rows);
+  return _chunkGQXEHX5Xjs.recordRows.call(void 0, result.rows);
 }
 function customerDbColumnNames(result) {
   return result.columns.map((column) => column.name).filter(Boolean);
@@ -180,7 +180,7 @@ function writeCustomerDbCsv(result, outPath) {
   const resolved = _path.resolve.call(void 0, outPath);
   _fs.writeFileSync.call(void 0, 
     resolved,
-    _chunkXDUQQTISjs.dataExportCsvString.call(void 0, customerDbRows(result), customerDbColumnNames(result)),
+    _chunkGQXEHX5Xjs.dataExportCsvString.call(void 0, customerDbRows(result), customerDbColumnNames(result)),
     "utf-8"
   );
   return resolved;
@@ -244,9 +244,9 @@ async function handleDbQuery(args) {
     console.error("--out requires a path.");
     return 1;
   }
-  const jsonOutput = _chunkXDUQQTISjs.argsWantJson.call(void 0, args);
+  const jsonOutput = _chunkGQXEHX5Xjs.argsWantJson.call(void 0, args);
   const explicitJsonOutput = args.includes("--json");
-  const client = new (0, _chunkQYL5ZV4Ujs.DeeplineClient)();
+  const client = new (0, _chunkVSAYSOVCjs.DeeplineClient)();
   let result;
   try {
     result = await client.db.query({ sql, maxRows });
@@ -263,7 +263,7 @@ async function handleDbQuery(args) {
   if (format === "csv") {
     if (outPath) {
       const exportedPath = writeCustomerDbCsv(result, outPath);
-      _chunkXDUQQTISjs.printCommandEnvelope.call(void 0, 
+      _chunkGQXEHX5Xjs.printCommandEnvelope.call(void 0, 
         dbQueryExportEnvelope({
           result,
           format,
@@ -278,7 +278,7 @@ async function handleDbQuery(args) {
       );
       return 0;
     }
-    _chunkXDUQQTISjs.printCommandEnvelope.call(void 0, 
+    _chunkGQXEHX5Xjs.printCommandEnvelope.call(void 0, 
       dbQueryExportEnvelope({
         result,
         format,
@@ -287,7 +287,7 @@ async function handleDbQuery(args) {
       }),
       {
         json: explicitJsonOutput,
-        text: _chunkXDUQQTISjs.dataExportCsvString.call(void 0, 
+        text: _chunkGQXEHX5Xjs.dataExportCsvString.call(void 0, 
           customerDbRows(result),
           customerDbColumnNames(result)
         )
@@ -296,14 +296,14 @@ async function handleDbQuery(args) {
     return 0;
   }
   if (format === "markdown") {
-    const content = _chunkXDUQQTISjs.markdownTableFromRows.call(void 0, 
+    const content = _chunkGQXEHX5Xjs.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");
-      _chunkXDUQQTISjs.printCommandEnvelope.call(void 0, 
+      _chunkGQXEHX5Xjs.printCommandEnvelope.call(void 0, 
         dbQueryExportEnvelope({
           result,
           format,
@@ -318,7 +318,7 @@ async function handleDbQuery(args) {
       );
       return 0;
     }
-    _chunkXDUQQTISjs.printCommandEnvelope.call(void 0, 
+    _chunkGQXEHX5Xjs.printCommandEnvelope.call(void 0, 
       dbQueryExportEnvelope({
         result,
         format,
@@ -332,7 +332,7 @@ async function handleDbQuery(args) {
     );
     return 0;
   }
-  _chunkXDUQQTISjs.printCommandEnvelope.call(void 0, 
+  _chunkGQXEHX5Xjs.printCommandEnvelope.call(void 0, 
     {
       ...result,
       next: { toolEquivalent: toolCommand },
@@ -350,8 +350,8 @@ async function handleDbQuery(args) {
 async function handleDbRepair(args) {
   const providerIndex = args.indexOf("--provider");
   const provider = providerIndex >= 0 ? _optionalChain([args, 'access', _12 => _12[providerIndex + 1], 'optionalAccess', _13 => _13.trim, 'call', _14 => _14()]) : void 0;
-  const jsonOutput = _chunkXDUQQTISjs.argsWantJson.call(void 0, args);
-  const client = new (0, _chunkQYL5ZV4Ujs.DeeplineClient)();
+  const jsonOutput = _chunkGQXEHX5Xjs.argsWantJson.call(void 0, args);
+  const client = new (0, _chunkVSAYSOVCjs.DeeplineClient)();
   let result;
   try {
     result = await client.repairIngestionStorage(
@@ -367,7 +367,7 @@ async function handleDbRepair(args) {
     console.error(errorMessage(error));
     return 1;
   }
-  _chunkXDUQQTISjs.printCommandEnvelope.call(void 0, 
+  _chunkGQXEHX5Xjs.printCommandEnvelope.call(void 0, 
     {
       command: "db repair",
       status: result.status,

package/dist/cli/describe-GS5A2XH4.js

@@ -0,0 +1,236 @@
+"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(); } }
+
+
+
+var _chunk6G7ZYA6Ejs = require('./chunk-6G7ZYA6E.js');
+
+
+var _chunkP4N7233Bjs = require('./chunk-P4N7233B.js');
+
+
+
+
+
+
+
+var _chunkXNL3SEMCjs = require('./chunk-XNL3SEMC.js');
+require('./chunk-5JLQPVNX.js');
+require('./chunk-QQMKX7JW.js');
+require('./chunk-4UXNEC5C.js');
+require('./chunk-NXDRDJ4K.js');
+require('./chunk-SDK3ZA2C.js');
+
+
+var _chunkVSAYSOVCjs = require('./chunk-VSAYSOVC.js');
+require('./chunk-LA46MMTL.js');
+require('./chunk-QJBJZVG6.js');
+require('./chunk-AYHLUHE5.js');
+require('./chunk-WJYPBHTE.js');
+
+
+var _chunkGQXEHX5Xjs = require('./chunk-GQXEHX5X.js');
+require('./chunk-FSZTWQFK.js');
+require('./chunk-XNYIZMNQ.js');
+require('./chunk-HY2SSFRI.js');
+require('./chunk-IALPYID6.js');
+require('./chunk-3KC45UVF.js');
+require('./chunk-OJ243ZA5.js');
+require('./chunk-S6R3OX7B.js');
+
+
+var _chunk7P5AA3SNjs = require('./chunk-7P5AA3SN.js');
+require('./chunk-OG64RBAC.js');
+require('./chunk-COGTRVWW.js');
+
+// src/cli/commands/describe.ts
+var _fs = require('fs');
+var _path = require('path');
+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) {
+  const maintainedOnly = options.prebuilt === true || options.tool === true;
+  const wants = (filter) => (!options.kinds || options.kinds.includes(filter)) && !(maintainedOnly && filter === "custom");
+  const client = new (0, _chunkVSAYSOVCjs.DeeplineClient)();
+  const play = async (reference) => {
+    const record2 = await client.describePlay(reference);
+    return {
+      described: _chunkP4N7233Bjs.describedPlay.call(void 0, record2),
+      record: { ...record2 },
+      schemas: {
+        inputSchema: _nullishCoalesce(record2.inputSchema, () => ( null)),
+        outputSchema: _nullishCoalesce(record2.outputSchema, () => ( null))
+      }
+    };
+  };
+  const tool = async () => {
+    const record2 = await _asyncNullishCoalesce(options.fetchedTool, async () => ( await client.getTool(name)));
+    return {
+      described: _chunk6G7ZYA6Ejs.describedTool.call(void 0, record2, name),
+      record: _chunk6G7ZYA6Ejs.toolMetadataJsonForDescribe.call(void 0, record2, name),
+      schemas: _chunk6G7ZYA6Ejs.publicToolSchemas.call(void 0, record2)
+    };
+  };
+  const sources = name.includes("/") ? [{ kinds: ["prebuilts", "custom"], find: () => play(name) }] : [
+    { kinds: ["custom"], find: () => play(name) },
+    { kinds: ["tools", "monitors"], find: tool },
+    { kinds: ["prebuilts"], find: () => play(`prebuilt/${name}`) }
+  ];
+  const matches = await Promise.all(
+    sources.filter((source) => source.kinds.some(wants)).map(async ({ kinds, find }) => {
+      const match = await found(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;
+  }
+  const { described, record } = chosen;
+  const shadows = described.kind === "custom_play" && shadowed ? {
+    kind: shadowed.described.kind,
+    describeCommand: `deepline describe ${name} --prebuilt`
+  } : 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 named = options.cliExample === true || options.playExample === true;
+  const shown = options.example !== false;
+  const {
+    runner: _runner,
+    inputs,
+    outputs,
+    rowInputs: _rowInputs,
+    rowOutputs: _rowOutputs,
+    ...summary
+  } = described;
+  const view = options.schemaOnly ? {
+    envelope: {
+      kind: described.kind,
+      id: described.id,
+      ...chosen.schemas
+    },
+    lines: [
+      `${described.id} [${described.kind.replace("_", " ")}]`,
+      ..._chunkXNL3SEMCjs.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 }),
+      ...shadows ? { shadows, note } : {}
+    },
+    lines: [
+      ...note ? [`Note: ${note}`, ""] : [],
+      ..._chunkXNL3SEMCjs.describedLines.call(void 0, described, {
+        cli: shown && (!named || options.cliExample === true),
+        play: shown && (!named || options.playExample === true),
+        explain: named,
+        verbose,
+        fullSchema: options.fullSchema === true
+      })
+    ]
+  };
+  const envelope = options.schemaOnly ? view.envelope : (
+    // The shared keys lead; where the kind's own record has the same key,
+    // its value stands, so callers of the older commands read what they did.
+    { ...view.envelope, ...record }
+  );
+  const text = `${view.lines.join("\n")}
+`;
+  if (options.out) {
+    const path = _path.resolve.call(void 0, options.out);
+    const content = json ? `${JSON.stringify(envelope, null, 2)}
+` : text;
+    _fs.writeFileSync.call(void 0, path, content);
+    const bytes = Buffer.byteLength(content);
+    _chunkGQXEHX5Xjs.printCommandEnvelope.call(void 0, 
+      { path, bytes },
+      { json, text: `Wrote ${path} (${bytes} bytes)
+` }
+    );
+    return 0;
+  }
+  _chunkGQXEHX5Xjs.printCommandEnvelope.call(void 0, envelope, { json, text });
+  return 0;
+}
+function registerDescribeCommand(program) {
+  _chunkXNL3SEMCjs.addDescribeOptions.call(void 0, program.command("describe <name>")).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
+  --cli-example    only the CLI example, with how inputs and outputs work
+  --play-example   only the in-play example, with how inputs and outputs work
+  --no-example     no examples
+
+Schema size and format:
+  A schema over ${_chunkXNL3SEMCjs.SCHEMA_LINE_LIMIT} lines is folded: deeper objects show only their field
+  names. A shape used more than once is printed once under Types.
+  --full-schema    the normal output, with the schema not folded
+  --schema-only    only the schema, not folded, and nothing else
+  --json           everything as JSON; the schema is never folded in JSON
+  --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
+
+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 --json
+  deepline describe my-play --prebuilt
+  deepline describe ai_ark_people_search --full-schema
+  deepline describe ai_ark_people_search --schema-only --json --out schema.json
+`
+  ).action(async (name, options) => {
+    process.exitCode = await describeAnything(name, options);
+  });
+}
+
+
+
+exports.describeAnything = describeAnything; exports.registerDescribeCommand = registerDescribeCommand;

package/dist/cli/describe-WCBZTSOF.mjs

@@ -0,0 +1,236 @@
+import {
+  describedTool,
+  publicToolSchemas,
+  toolMetadataJsonForDescribe
+} from "./chunk-UQBMMN4U.mjs";
+import {
+  describedPlay
+} from "./chunk-BS4GAUMH.mjs";
+import {
+  SCHEMA_LINE_LIMIT,
+  addDescribeOptions,
+  describedLines,
+  examples,
+  schemaLines,
+  topLevelField
+} from "./chunk-76VKBPOC.mjs";
+import "./chunk-EDWJY6T4.mjs";
+import "./chunk-RDUS2EDE.mjs";
+import "./chunk-QCXDLOGA.mjs";
+import "./chunk-MIMASXO4.mjs";
+import "./chunk-OWJZUE3Y.mjs";
+import {
+  DeeplineClient
+} from "./chunk-YZ5PP6TX.mjs";
+import "./chunk-CBVIJSHF.mjs";
+import "./chunk-WXLOW623.mjs";
+import "./chunk-UFS752TU.mjs";
+import "./chunk-GAMFK2ZP.mjs";
+import {
+  printCommandEnvelope
+} from "./chunk-CSH4PKPJ.mjs";
+import "./chunk-DOI3UBGV.mjs";
+import "./chunk-DLIRSHV6.mjs";
+import "./chunk-HM2TSTCT.mjs";
+import "./chunk-US4S3E4Y.mjs";
+import "./chunk-H7HIDGZ7.mjs";
+import "./chunk-N5V2SBB2.mjs";
+import "./chunk-6IKARAYD.mjs";
+import {
+  DeeplineError
+} from "./chunk-NXGCO4JB.mjs";
+import "./chunk-WZYKRD7T.mjs";
+import "./chunk-KRD6H754.mjs";
+
+// src/cli/commands/describe.ts
+import { writeFileSync } from "fs";
+import { resolve } from "path";
+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) {
+  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);
+    return {
+      described: describedPlay(record2),
+      record: { ...record2 },
+      schemas: {
+        inputSchema: record2.inputSchema ?? null,
+        outputSchema: record2.outputSchema ?? null
+      }
+    };
+  };
+  const tool = async () => {
+    const record2 = options.fetchedTool ?? await client.getTool(name);
+    return {
+      described: describedTool(record2, name),
+      record: toolMetadataJsonForDescribe(record2, name),
+      schemas: publicToolSchemas(record2)
+    };
+  };
+  const sources = name.includes("/") ? [{ kinds: ["prebuilts", "custom"], find: () => play(name) }] : [
+    { kinds: ["custom"], find: () => play(name) },
+    { kinds: ["tools", "monitors"], find: tool },
+    { kinds: ["prebuilts"], find: () => play(`prebuilt/${name}`) }
+  ];
+  const matches = await Promise.all(
+    sources.filter((source) => source.kinds.some(wants)).map(async ({ kinds, find }) => {
+      const match = await found(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;
+  }
+  const { described, record } = chosen;
+  const shadows = described.kind === "custom_play" && shadowed ? {
+    kind: shadowed.described.kind,
+    describeCommand: `deepline describe ${name} --prebuilt`
+  } : 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 named = options.cliExample === true || options.playExample === true;
+  const shown = options.example !== false;
+  const {
+    runner: _runner,
+    inputs,
+    outputs,
+    rowInputs: _rowInputs,
+    rowOutputs: _rowOutputs,
+    ...summary
+  } = described;
+  const view = options.schemaOnly ? {
+    envelope: {
+      kind: described.kind,
+      id: described.id,
+      ...chosen.schemas
+    },
+    lines: [
+      `${described.id} [${described.kind.replace("_", " ")}]`,
+      ...schemaLines(described, { full: true })
+    ]
+  } : {
+    envelope: {
+      ...summary,
+      inputs: inputs.map(topLevelField),
+      outputs: outputs.map(topLevelField),
+      ...described.rowInputs ? { rowInputs: described.rowInputs.map(topLevelField) } : {},
+      ...described.rowOutputs ? { rowOutputs: described.rowOutputs.map(topLevelField) } : {},
+      runExamples: examples(described, { verbose }),
+      ...shadows ? { shadows, note } : {}
+    },
+    lines: [
+      ...note ? [`Note: ${note}`, ""] : [],
+      ...describedLines(described, {
+        cli: shown && (!named || options.cliExample === true),
+        play: shown && (!named || options.playExample === true),
+        explain: named,
+        verbose,
+        fullSchema: options.fullSchema === true
+      })
+    ]
+  };
+  const envelope = options.schemaOnly ? view.envelope : (
+    // The shared keys lead; where the kind's own record has the same key,
+    // its value stands, so callers of the older commands read what they did.
+    { ...view.envelope, ...record }
+  );
+  const text = `${view.lines.join("\n")}
+`;
+  if (options.out) {
+    const path = resolve(options.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>")).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
+  --cli-example    only the CLI example, with how inputs and outputs work
+  --play-example   only the in-play example, with how inputs and outputs work
+  --no-example     no examples
+
+Schema size and format:
+  A schema over ${SCHEMA_LINE_LIMIT} lines is folded: deeper objects show only their field
+  names. A shape used more than once is printed once under Types.
+  --full-schema    the normal output, with the schema not folded
+  --schema-only    only the schema, not folded, and nothing else
+  --json           everything as JSON; the schema is never folded in JSON
+  --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
+
+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 --json
+  deepline describe my-play --prebuilt
+  deepline describe ai_ark_people_search --full-schema
+  deepline describe ai_ark_people_search --schema-only --json --out schema.json
+`
+  ).action(async (name, options) => {
+    process.exitCode = await describeAnything(name, options);
+  });
+}
+export {
+  describeAnything,
+  registerDescribeCommand
+};

package/dist/cli/{executions-TQ5WRHDS.js → executions-ENMOOKWH.js}

@@ -1,13 +1,13 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true});
 
-var _chunkQYL5ZV4Ujs = require('./chunk-QYL5ZV4U.js');
+var _chunkVSAYSOVCjs = require('./chunk-VSAYSOVC.js');
 require('./chunk-LA46MMTL.js');
 
 
-var _chunkXDUQQTISjs = require('./chunk-XDUQQTIS.js');
-require('./chunk-RNJ74JDH.js');
+var _chunkGQXEHX5Xjs = require('./chunk-GQXEHX5X.js');
+require('./chunk-FSZTWQFK.js');
 require('./chunk-XNYIZMNQ.js');
-require('./chunk-FYPZ43Y4.js');
+require('./chunk-HY2SSFRI.js');
 require('./chunk-S6R3OX7B.js');
 require('./chunk-7P5AA3SN.js');
 require('./chunk-OG64RBAC.js');
@@ -17,10 +17,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, _chunkQYL5ZV4Ujs.DeeplineClient)().executions.getByKey(
+    const result = await new (0, _chunkVSAYSOVCjs.DeeplineClient)().executions.getByKey(
       options.idempotencyKey
     );
-    _chunkXDUQQTISjs.printCommandEnvelope.call(void 0, result, { json: true });
+    _chunkGQXEHX5Xjs.printCommandEnvelope.call(void 0, result, { json: true });
   });
 }
 

package/dist/cli/{executions-RDDXGT2Y.mjs → executions-UTN3O372.mjs}

@@ -1,13 +1,13 @@
 import {
   DeeplineClient
-} from "./chunk-5OVNL6LS.mjs";
+} from "./chunk-YZ5PP6TX.mjs";
 import "./chunk-CBVIJSHF.mjs";
 import {
   printCommandEnvelope
-} from "./chunk-SPUTBCUR.mjs";
-import "./chunk-Q3LYQTSO.mjs";
+} from "./chunk-CSH4PKPJ.mjs";
+import "./chunk-DOI3UBGV.mjs";
 import "./chunk-DLIRSHV6.mjs";
-import "./chunk-SGTSJCOA.mjs";
+import "./chunk-HM2TSTCT.mjs";
 import "./chunk-6IKARAYD.mjs";
 import "./chunk-NXGCO4JB.mjs";
 import "./chunk-WZYKRD7T.mjs";