deepline 0.3.373 → 0.3.375

package/dist/cli/command-docs.js

@@ -3,11 +3,11 @@
 
 
 
-var _chunkJSK6GUY6js = require('./chunk-JSK6GUY6.js');
+var _chunk4WINCNNHjs = require('./chunk-4WINCNNH.js');
 require('./chunk-COGTRVWW.js');
 
 
 
 
 
-exports.COMMAND_DOCS = _chunkJSK6GUY6js.COMMAND_DOCS; exports.commandDocKey = _chunkJSK6GUY6js.commandDocKey; exports.helpDetailFromArgv = _chunkJSK6GUY6js.helpDetailFromArgv; exports.renderCommandExplanation = _chunkJSK6GUY6js.renderCommandExplanation;
+exports.COMMAND_DOCS = _chunk4WINCNNHjs.COMMAND_DOCS; exports.commandDocKey = _chunk4WINCNNHjs.commandDocKey; exports.helpDetailFromArgv = _chunk4WINCNNHjs.helpDetailFromArgv; exports.renderCommandExplanation = _chunk4WINCNNHjs.renderCommandExplanation;

package/dist/cli/command-docs.mjs

@@ -3,7 +3,7 @@ import {
   commandDocKey,
   helpDetailFromArgv,
   renderCommandExplanation
-} from "./chunk-46JCJ7FT.mjs";
+} from "./chunk-FWF24ULX.mjs";
 import "./chunk-KRD6H754.mjs";
 export {
   COMMAND_DOCS,

package/dist/cli/{csv-3FNCVMWA.mjs → csv-3FTYTEJ3.mjs}

@@ -4,11 +4,11 @@ import {
   printCommandEnvelope,
   printJson,
   readCsvRows
-} from "./chunk-HNLXC5BP.mjs";
-import "./chunk-IUYKSTWB.mjs";
+} from "./chunk-M5QDOHLG.mjs";
+import "./chunk-4GP56LRE.mjs";
 import "./chunk-DLIRSHV6.mjs";
 import "./chunk-NXGCO4JB.mjs";
-import "./chunk-P5JPGZNI.mjs";
+import "./chunk-IG3GOO4T.mjs";
 import "./chunk-WZYKRD7T.mjs";
 import "./chunk-KRD6H754.mjs";
 

package/dist/cli/{csv-NFQYQWWO.js → csv-WAEVGKHF.js}

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

package/dist/cli/{db-VA7HULGR.mjs → db-HUGGFIVS.mjs}

@@ -4,7 +4,7 @@ import {
 import {
   DeeplineClient,
   planCustomerDbQuery
-} from "./chunk-Y32GUTEN.mjs";
+} from "./chunk-ZHXPNJQI.mjs";
 import "./chunk-6IKARAYD.mjs";
 import "./chunk-CBVIJSHF.mjs";
 import {
@@ -16,15 +16,15 @@ import {
   printCommandEnvelope,
   recordRows,
   shouldEmitJson
-} from "./chunk-HNLXC5BP.mjs";
+} from "./chunk-M5QDOHLG.mjs";
 import {
   CustomerDbQueryOutcomeUnknownError
-} from "./chunk-IUYKSTWB.mjs";
+} from "./chunk-4GP56LRE.mjs";
 import "./chunk-DLIRSHV6.mjs";
 import {
   DeeplineError
 } from "./chunk-NXGCO4JB.mjs";
-import "./chunk-P5JPGZNI.mjs";
+import "./chunk-IG3GOO4T.mjs";
 import "./chunk-WZYKRD7T.mjs";
 import "./chunk-KRD6H754.mjs";
 

package/dist/cli/{db-CTLGRV3X.js → db-UDMDGNKO.js}

@@ -4,7 +4,7 @@ var _chunkAID3OYVJjs = require('./chunk-AID3OYVJ.js');
 
 
 
-var _chunkE7MGPPM5js = require('./chunk-E7MGPPM5.js');
+var _chunkDAG4ZBTJjs = require('./chunk-DAG4ZBTJ.js');
 require('./chunk-S6R3OX7B.js');
 require('./chunk-LA46MMTL.js');
 
@@ -16,15 +16,15 @@ require('./chunk-LA46MMTL.js');
 
 
 
-var _chunkJHUMUIU6js = require('./chunk-JHUMUIU6.js');
+var _chunkGN5QM2BBjs = require('./chunk-GN5QM2BB.js');
 
 
-var _chunkND4BVWWZjs = require('./chunk-ND4BVWWZ.js');
+var _chunkIQTHRG6Ejs = require('./chunk-IQTHRG6E.js');
 require('./chunk-XNYIZMNQ.js');
 
 
 var _chunk7P5AA3SNjs = require('./chunk-7P5AA3SN.js');
-require('./chunk-CLEB5KUZ.js');
+require('./chunk-ADSZGPYZ.js');
 require('./chunk-OG64RBAC.js');
 require('./chunk-COGTRVWW.js');
 
@@ -47,8 +47,8 @@ function formatCell(value) {
   return text.length > 80 ? `${text.slice(0, 77)}...` : text;
 }
 function tableLines(result) {
-  const rows = _chunkJHUMUIU6js.dataExportRows.call(void 0, customerDbRows(result));
-  const responseColumns = _chunkJHUMUIU6js.dataExportColumns.call(void 0, 
+  const rows = _chunkGN5QM2BBjs.dataExportRows.call(void 0, customerDbRows(result));
+  const responseColumns = _chunkGN5QM2BBjs.dataExportColumns.call(void 0, 
     rows,
     customerDbColumnNames(result)
   );
@@ -94,7 +94,7 @@ function tableLines(result) {
   return lines;
 }
 function customerDbRows(result) {
-  return _chunkJHUMUIU6js.recordRows.call(void 0, result.rows);
+  return _chunkGN5QM2BBjs.recordRows.call(void 0, result.rows);
 }
 function customerDbColumnNames(result) {
   return result.columns.map((column) => column.name).filter(Boolean);
@@ -116,15 +116,15 @@ function collectErrorText(value) {
   ].filter(Boolean).join("\n");
 }
 function formatDbQueryError(sql, error) {
-  const text = error instanceof _chunkND4BVWWZjs.CustomerDbQueryOutcomeUnknownError ? collectErrorText(error.cause) : collectErrorText(error);
+  const text = error instanceof _chunkIQTHRG6Ejs.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 _chunkND4BVWWZjs.CustomerDbQueryOutcomeUnknownError ? [error.message] : [],
-      error instanceof _chunkND4BVWWZjs.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 _chunkIQTHRG6Ejs.CustomerDbQueryOutcomeUnknownError ? [error.message] : [],
+      error instanceof _chunkIQTHRG6Ejs.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)}`
@@ -132,7 +132,7 @@ function formatDbQueryError(sql, error) {
   }
   if (referencesStorage && runIdColumnMissing) {
     return [
-      ...error instanceof _chunkND4BVWWZjs.CustomerDbQueryOutcomeUnknownError ? [error.message] : [],
+      ...error instanceof _chunkIQTHRG6Ejs.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)}`
@@ -147,7 +147,7 @@ function writeCustomerDbCsv(result, outPath) {
   const resolved = _path.resolve.call(void 0, outPath);
   _fs.writeFileSync.call(void 0, 
     resolved,
-    _chunkJHUMUIU6js.dataExportCsvString.call(void 0, customerDbRows(result), customerDbColumnNames(result)),
+    _chunkGN5QM2BBjs.dataExportCsvString.call(void 0, customerDbRows(result), customerDbColumnNames(result)),
     "utf-8"
   );
   return resolved;
@@ -188,7 +188,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 || _chunkJHUMUIU6js.shouldEmitJson.call(void 0, );
+  const jsonOutput = explicitJsonOutput || _chunkGN5QM2BBjs.shouldEmitJson.call(void 0, );
   const toolPayload = JSON.stringify({
     sql,
     result_mode: "rows",
@@ -199,7 +199,7 @@ function renderDbQueryResult(result, query, options) {
   if (format === "csv") {
     if (outPath) {
       const exportedPath = writeCustomerDbCsv(result, outPath);
-      _chunkJHUMUIU6js.printCommandEnvelope.call(void 0, 
+      _chunkGN5QM2BBjs.printCommandEnvelope.call(void 0, 
         dbQueryExportEnvelope({
           result,
           format,
@@ -215,7 +215,7 @@ function renderDbQueryResult(result, query, options) {
       );
       return;
     }
-    _chunkJHUMUIU6js.printCommandEnvelope.call(void 0, 
+    _chunkGN5QM2BBjs.printCommandEnvelope.call(void 0, 
       dbQueryExportEnvelope({
         result,
         format,
@@ -225,7 +225,7 @@ function renderDbQueryResult(result, query, options) {
       }),
       {
         json: explicitJsonOutput,
-        text: _chunkJHUMUIU6js.dataExportCsvString.call(void 0, 
+        text: _chunkGN5QM2BBjs.dataExportCsvString.call(void 0, 
           customerDbRows(result),
           customerDbColumnNames(result)
         )
@@ -234,14 +234,14 @@ function renderDbQueryResult(result, query, options) {
     return;
   }
   if (format === "markdown") {
-    const content = _chunkJHUMUIU6js.markdownTableFromRows.call(void 0, 
+    const content = _chunkGN5QM2BBjs.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");
-      _chunkJHUMUIU6js.printCommandEnvelope.call(void 0, 
+      _chunkGN5QM2BBjs.printCommandEnvelope.call(void 0, 
         dbQueryExportEnvelope({
           result,
           format,
@@ -257,7 +257,7 @@ function renderDbQueryResult(result, query, options) {
       );
       return;
     }
-    _chunkJHUMUIU6js.printCommandEnvelope.call(void 0, 
+    _chunkGN5QM2BBjs.printCommandEnvelope.call(void 0, 
       dbQueryExportEnvelope({
         result,
         format,
@@ -272,7 +272,7 @@ function renderDbQueryResult(result, query, options) {
     );
     return;
   }
-  _chunkJHUMUIU6js.printCommandEnvelope.call(void 0, 
+  _chunkGN5QM2BBjs.printCommandEnvelope.call(void 0, 
     {
       ...result,
       next: {
@@ -346,9 +346,9 @@ async function runDbQueryCommand(options) {
       ...maxRows === void 0 ? {} : { maxRows },
       ...operationKey === void 0 ? {} : { operationKey }
     };
-    const plan = _chunkE7MGPPM5js.planCustomerDbQuery.call(void 0, query);
+    const plan = _chunkDAG4ZBTJjs.planCustomerDbQuery.call(void 0, query);
     if (options.dryRun) {
-      _chunkJHUMUIU6js.printCommandEnvelope.call(void 0, 
+      _chunkGN5QM2BBjs.printCommandEnvelope.call(void 0, 
         {
           dryRun: true,
           ...plan,
@@ -361,11 +361,11 @@ async function runDbQueryCommand(options) {
             ...out === void 0 ? {} : { file: _path.resolve.call(void 0, out) }
           }
         },
-        { json: options.json || _chunkJHUMUIU6js.shouldEmitJson.call(void 0, ) }
+        { json: options.json || _chunkGN5QM2BBjs.shouldEmitJson.call(void 0, ) }
       );
       return 0;
     }
-    const client = new (0, _chunkE7MGPPM5js.DeeplineClient)();
+    const client = new (0, _chunkDAG4ZBTJjs.DeeplineClient)();
     const result = await client.db.query(query);
     renderDbQueryResult(result, query, {
       format,
@@ -374,8 +374,8 @@ async function runDbQueryCommand(options) {
     });
     return 0;
   } catch (error) {
-    if (error instanceof _chunkND4BVWWZjs.CustomerDbQueryOutcomeUnknownError && (options.json || _chunkJHUMUIU6js.shouldEmitJson.call(void 0, ))) {
-      _chunkJHUMUIU6js.printCommandEnvelope.call(void 0, 
+    if (error instanceof _chunkIQTHRG6Ejs.CustomerDbQueryOutcomeUnknownError && (options.json || _chunkGN5QM2BBjs.shouldEmitJson.call(void 0, ))) {
+      _chunkGN5QM2BBjs.printCommandEnvelope.call(void 0, 
         {
           ok: false,
           error: {
@@ -423,8 +423,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 = _chunkJHUMUIU6js.argsWantJson.call(void 0, args);
-  const client = new (0, _chunkE7MGPPM5js.DeeplineClient)();
+  const jsonOutput = _chunkGN5QM2BBjs.argsWantJson.call(void 0, args);
+  const client = new (0, _chunkDAG4ZBTJjs.DeeplineClient)();
   let result;
   try {
     result = await client.repairIngestionStorage(
@@ -440,7 +440,7 @@ async function handleDbRepair(args) {
     console.error(errorMessage2(error));
     return 1;
   }
-  _chunkJHUMUIU6js.printCommandEnvelope.call(void 0, 
+  _chunkGN5QM2BBjs.printCommandEnvelope.call(void 0, 
     {
       command: "db repair",
       status: result.status,

package/dist/cli/{describe-GXGRMP2M.mjs → describe-EOBOGTB5.mjs}

@@ -1,52 +1,119 @@
-import {
-  describedPlay
-} from "./chunk-QSV76EMO.mjs";
 import {
   describedTool,
+  formatModelDescription,
   publicToolSchemas,
   toolMetadataJsonForDescribe
-} from "./chunk-PZ26EKNC.mjs";
+} from "./chunk-ZFWU5V2A.mjs";
+import {
+  describedPlay
+} from "./chunk-STYH5U6W.mjs";
 import {
   SCHEMA_LINE_LIMIT,
   addDescribeOptions,
+  byokLines,
   describedJson,
   describedLines,
   examples,
   schemaLines,
   topLevelField
-} from "./chunk-E6BZWURC.mjs";
+} from "./chunk-B2LFDTXZ.mjs";
 import "./chunk-OVDNJAJN.mjs";
 import "./chunk-DSWSEHRX.mjs";
 import "./chunk-H7HIDGZ7.mjs";
 import "./chunk-EDWJY6T4.mjs";
-import "./chunk-YHHY2YHK.mjs";
-import "./chunk-TB73PXE3.mjs";
-import "./chunk-ERFN2QY4.mjs";
+import "./chunk-HSIVHAZA.mjs";
+import "./chunk-SJVJZOPT.mjs";
 import "./chunk-Y6VOGHF2.mjs";
+import "./chunk-ERFN2QY4.mjs";
 import "./chunk-7E66A24V.mjs";
 import {
   DeeplineClient
-} from "./chunk-Y32GUTEN.mjs";
+} from "./chunk-ZHXPNJQI.mjs";
 import "./chunk-6IKARAYD.mjs";
 import "./chunk-CBVIJSHF.mjs";
-import "./chunk-UFS752TU.mjs";
 import "./chunk-WXLOW623.mjs";
+import "./chunk-UFS752TU.mjs";
 import "./chunk-GAMFK2ZP.mjs";
 import {
   printCommandEnvelope
-} from "./chunk-HNLXC5BP.mjs";
-import "./chunk-IUYKSTWB.mjs";
+} from "./chunk-M5QDOHLG.mjs";
+import "./chunk-4GP56LRE.mjs";
 import "./chunk-DLIRSHV6.mjs";
 import {
   DeeplineError
 } from "./chunk-NXGCO4JB.mjs";
-import "./chunk-P5JPGZNI.mjs";
+import "./chunk-IG3GOO4T.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 = {
+  ai_gateway_model: async (value, _tool, { describeModel }) => {
+    if (!value)
+      throw new Error("Name a model: --feature model=<provider/model>");
+    const model = await describeModel(value);
+    const unlisted = model.modelMetadata ? [] : [
+      `Warning: ${value} is not in the live AI Gateway catalog; check the id at https://ai-gateway.vercel.sh/v1/models.`
+    ];
+    return {
+      details: model,
+      lines: [
+        ...unlisted,
+        ...formatModelDescription(model).trimEnd().split("\n")
+      ]
+    };
+  },
+  byok: async (_value, tool) => ({
+    details: tool.byok ?? {},
+    lines: byokLines(tool.byok ?? {})
+  })
+};
+var isFeatureView = (value) => typeof value === "string" && Object.hasOwn(VIEWS, value);
+var asRecord = (value) => value && typeof value === "object" && !Array.isArray(value) ? value : {};
+function inputProperties(tool) {
+  const inputSchema = asRecord(tool.inputSchema);
+  const jsonSchema = asRecord(inputSchema.jsonSchema ?? inputSchema);
+  return asRecord(jsonSchema.properties);
+}
+var firstSentence = (text) => typeof text === "string" ? text.split(/(?<=\.)\s/)[0] ?? text : "";
+function toolFeatures(tool) {
+  const inputs = Object.entries(inputProperties(tool)).flatMap(
+    ([name, value]) => {
+      const schema = asRecord(value);
+      if (!isFeatureView(schema.feature)) return [];
+      return [
+        {
+          name,
+          summary: firstSentence(schema.description),
+          view: schema.feature,
+          ...typeof schema.default === "string" ? { defaultValue: schema.default } : {}
+        }
+      ];
+    }
+  );
+  const byok = tool.byok?.supported === true ? [
+    {
+      name: "byok",
+      summary: "Run it on your own provider credentials.",
+      view: "byok"
+    }
+  ] : [];
+  return [...inputs, ...byok];
+}
+function parseFeatureRequest(request) {
+  const [name = "", ...rest] = request.split("=");
+  const value = rest.join("=");
+  return value ? { name, value } : { name };
+}
+async function describeFeature(tool, feature, value, dependencies) {
+  return VIEWS[feature.view](value ?? feature.defaultValue, tool, dependencies);
+}
+
+// src/cli/commands/describe.ts
 var FILTER_OF = {
   tool: "tools",
   monitor_type: "monitors",
@@ -81,15 +148,23 @@ async function describeAnything(name, options, onMissing) {
   const tool = async () => {
     const record2 = options.fetchedTool ?? await client.getTool(name);
     const { byok } = record2;
+    const features = toolFeatures(record2);
     return {
       described: {
         ...describedTool(record2, name),
-        // Shown when asked for, or when the tool runs only on your own
-        // credentials; a server that does not report it shows as unknown.
-        ...options.byok || byok?.required === true ? { byok: byok ?? {} } : {}
+        // Shown when the tool runs only on your own credentials; otherwise
+        // it is a feature, described with --feature byok.
+        ...byok?.required === true ? { byok } : {},
+        ...features.length ? { features: features.map(({ view: _view, ...feature }) => feature) } : {}
       },
       record: toolMetadataJsonForDescribe(record2, name),
-      schemas: publicToolSchemas(record2)
+      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)
+        }) : null;
+      }
     };
   };
   const sources = name.includes("/") ? [{ kinds: ["prebuilts", "custom"], find: () => play(name) }] : [
@@ -120,6 +195,33 @@ async function describeAnything(name, options, onMissing) {
   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;
+  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;
+    }
+    const shownValue = value ?? features.find(({ name: name2 }) => name2 === featureName)?.defaultValue;
+    const { details, lines } = await pending;
+    return deliver(
+      {
+        kind: described.kind,
+        id: described.id,
+        feature: featureName,
+        ...shownValue ? { value: shownValue } : {},
+        details
+      },
+      [
+        `${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;
   const shown = options.example !== false;
@@ -179,10 +281,13 @@ async function describeAnything(name, options, onMissing) {
     }),
     ...shadows ? { shadows, note } : {}
   };
-  const text = `${view.lines.join("\n")}
+  return deliver(envelope, view.lines, { json, out: options.out });
+}
+function deliver(envelope, lines, { json, out }) {
+  const text = `${lines.join("\n")}
 `;
-  if (options.out) {
-    const path = resolve(options.out);
+  if (out) {
+    const path = resolve(out);
     const content = json ? `${JSON.stringify(envelope, null, 2)}
 ` : text;
     writeFileSync(path, content);
@@ -225,6 +330,11 @@ Examples in the output:
   --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.