deepline 0.3.311 → 0.3.313

package/dist/cli/{tools-WN7T25LW.js → chunk-6G7ZYA6E.js}

@@ -1,7 +1,13 @@
-"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; }
+"use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _interopRequireWildcard(obj) { if (obj && obj.__esModule) { return obj; } else { var newObj = {}; if (obj != null) { for (var key in obj) { if (Object.prototype.hasOwnProperty.call(obj, key)) { newObj[key] = obj[key]; } } } newObj.default = obj; return newObj; } } 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 _chunkIB7OGQGHjs = require('./chunk-IB7OGQGH.js');
+
+
+var _chunkXNL3SEMCjs = require('./chunk-XNL3SEMC.js');
+
+
+
+var _chunkQQMKX7JWjs = require('./chunk-QQMKX7JW.js');
 
 
 
@@ -12,8 +18,7 @@ var _chunkIB7OGQGHjs = require('./chunk-IB7OGQGH.js');
 var _chunkNXDRDJ4Kjs = require('./chunk-NXDRDJ4K.js');
 
 
-var _chunkQYL5ZV4Ujs = require('./chunk-QYL5ZV4U.js');
-require('./chunk-LA46MMTL.js');
+var _chunkVSAYSOVCjs = require('./chunk-VSAYSOVC.js');
 
 
 
@@ -28,19 +33,14 @@ var _chunkQJBJZVG6js = require('./chunk-QJBJZVG6.js');
 
 
 
-var _chunkXDUQQTISjs = require('./chunk-XDUQQTIS.js');
+var _chunkGQXEHX5Xjs = require('./chunk-GQXEHX5X.js');
 
 
 
-var _chunkRNJ74JDHjs = require('./chunk-RNJ74JDH.js');
-require('./chunk-XNYIZMNQ.js');
-require('./chunk-FYPZ43Y4.js');
-require('./chunk-S6R3OX7B.js');
+var _chunkFSZTWQFKjs = require('./chunk-FSZTWQFK.js');
 
 
 var _chunk7P5AA3SNjs = require('./chunk-7P5AA3SN.js');
-require('./chunk-OG64RBAC.js');
-require('./chunk-COGTRVWW.js');
 
 // src/cli/commands/tools.ts
 var _commander = require('commander');
@@ -82,10 +82,10 @@ var ToolCallRecovery = class _ToolCallRecovery {
   }
 };
 function pendingToolExecutionPath(input) {
-  const config = _chunkRNJ74JDHjs.resolveConfig.call(void 0, );
+  const config = _chunkFSZTWQFKjs.resolveConfig.call(void 0, );
   const fingerprint = _crypto.createHash.call(void 0, "sha256").update(config.baseUrl).update("\0").update(_crypto.createHash.call(void 0, "sha256").update(config.apiKey).digest("hex")).update("\0").update(input.toolId).update("\0").update(_chunkNXDRDJ4Kjs.stableStringify.call(void 0, input.params)).update("\0").update(input.responseIntent).digest("hex");
   return _path.join.call(void 0, 
-    _chunkRNJ74JDHjs.sdkCliStateDirPath.call(void 0, config.baseUrl),
+    _chunkFSZTWQFKjs.sdkCliStateDirPath.call(void 0, config.baseUrl),
     `pending-tool-execution-${fingerprint}.json`
   );
 }
@@ -333,7 +333,7 @@ function toolConnectionStatusMessage(input) {
 
 // src/cli/commands/tools.ts
 var TOOL_COMMAND_TEMPLATES = {
-  describe: "deepline tools describe <toolId>",
+  describe: "deepline describe <toolId>",
   execute: "deepline tools execute <toolId> --input '{...}'"
 };
 function toListedTool(tool) {
@@ -517,12 +517,12 @@ function categoryEnumerationRender(summaries) {
   };
 }
 async function listToolCategories(emitJson, compact) {
-  const client = new (0, _chunkQYL5ZV4Ujs.DeeplineClient)();
+  const client = new (0, _chunkVSAYSOVCjs.DeeplineClient)();
   const rawTools = await client.listTools({ compact });
   const items = rawTools.map(toListedTool);
   const summaries = aggregateCategorySummaries(rawTools);
   const outputItems = compact ? items.map(compactTool) : items;
-  _chunkXDUQQTISjs.printCommandEnvelope.call(void 0, 
+  _chunkGQXEHX5Xjs.printCommandEnvelope.call(void 0, 
     {
       tools: outputItems,
       count: outputItems.length,
@@ -541,7 +541,7 @@ function unknownCategoryError(category, summaries, emitJson) {
   const known = summaries.map((item) => item.name);
   const message = `Unknown tool category "${category}". Run \`deepline tools list\` to browse categories.`;
   if (emitJson) {
-    _chunkXDUQQTISjs.printJson.call(void 0, {
+    _chunkGQXEHX5Xjs.printJson.call(void 0, {
       ok: false,
       exitCode: 4,
       code: "TOOL_CATEGORY_NOT_FOUND",
@@ -555,13 +555,13 @@ function unknownCategoryError(category, summaries, emitJson) {
   const render = categoryEnumerationRender(summaries);
   console.error(message);
   console.error("");
-  console.error(_chunkXDUQQTISjs.renderCommandEnvelopeText.call(void 0, { render }).trimEnd());
+  console.error(_chunkGQXEHX5Xjs.renderCommandEnvelopeText.call(void 0, { render }).trimEnd());
   console.error("");
   console.error(`Valid categories: ${known.join(", ")}`);
   return 4;
 }
 async function listToolsInCategory(category, emitJson) {
-  const client = new (0, _chunkQYL5ZV4Ujs.DeeplineClient)();
+  const client = new (0, _chunkVSAYSOVCjs.DeeplineClient)();
   const rawTools = await client.listTools({
     categories: category,
     compact: false
@@ -594,13 +594,11 @@ async function listToolsInCategory(category, emitJson) {
       },
       {
         title: "next",
-        lines: [
-          "Run `deepline tools describe <toolId>` for the full contract."
-        ]
+        lines: ["Run `deepline describe <toolId>` for the full contract."]
       }
     ]
   };
-  _chunkXDUQQTISjs.printCommandEnvelope.call(void 0, 
+  _chunkGQXEHX5Xjs.printCommandEnvelope.call(void 0, 
     {
       category,
       total: rows.length,
@@ -613,7 +611,7 @@ async function listToolsInCategory(category, emitJson) {
   return 0;
 }
 async function listToolsForCategoryFilter(requestedCategories, emitJson, compact) {
-  const client = new (0, _chunkQYL5ZV4Ujs.DeeplineClient)();
+  const client = new (0, _chunkVSAYSOVCjs.DeeplineClient)();
   const items = (await client.listTools({
     categories: requestedCategories.join(","),
     compact
@@ -636,13 +634,13 @@ async function listToolsForCategoryFilter(requestedCategories, emitJson, compact
       {
         title: "next",
         lines: [
-          "Run `deepline tools describe <toolId>` before executing a tool."
+          "Run `deepline describe <toolId>` before executing a tool."
         ]
       }
     ]
   };
   const outputItems = compact ? items.map(compactTool) : items;
-  _chunkXDUQQTISjs.printCommandEnvelope.call(void 0, 
+  _chunkGQXEHX5Xjs.printCommandEnvelope.call(void 0, 
     {
       tools: outputItems,
       count: outputItems.length,
@@ -661,13 +659,13 @@ async function listTools(category, options = {}) {
   const positional = _nullishCoalesce(_optionalChain([category, 'optionalAccess', _9 => _9.trim, 'call', _10 => _10()]), () => ( ""));
   const flagCategories = (_nullishCoalesce(options.categories, () => ( ""))).split(",").map((item) => item.trim()).filter(Boolean);
   const compact = options.compact !== false;
-  const emitJson = options.json === true || _chunkXDUQQTISjs.shouldEmitJson.call(void 0, );
+  const emitJson = options.json === true || _chunkGQXEHX5Xjs.shouldEmitJson.call(void 0, );
   if (positional && flagCategories.length > 0) {
     const flagIsSameSingle = flagCategories.length === 1 && flagCategories[0] === positional;
     if (!flagIsSameSingle) {
       const message = `Category "${positional}" and --categories ${flagCategories.join(",")} disagree. Pass one: deepline tools list ${positional}`;
       if (emitJson) {
-        _chunkXDUQQTISjs.printJson.call(void 0, {
+        _chunkGQXEHX5Xjs.printJson.call(void 0, {
           ok: false,
           exitCode: 2,
           code: "TOOL_LIST_CATEGORY_CONFLICT",
@@ -694,7 +692,7 @@ async function grepTools(queryInput, options = {}) {
     console.error("Usage: deepline tools grep <query> [--json]");
     return 1;
   }
-  const client = new (0, _chunkQYL5ZV4Ujs.DeeplineClient)();
+  const client = new (0, _chunkVSAYSOVCjs.DeeplineClient)();
   const requestedCategories = options.categories ? options.categories.split(",").map((item) => item.trim()).filter(Boolean) : [];
   const mode = _nullishCoalesce(options.mode, () => ( "all"));
   const jsonOutput = options.json === true;
@@ -737,7 +735,7 @@ async function grepTools(queryInput, options = {}) {
     query,
     mode
   }) : null;
-  _chunkXDUQQTISjs.printCommandEnvelope.call(void 0, 
+  _chunkGQXEHX5Xjs.printCommandEnvelope.call(void 0, 
     {
       tools: outputTools,
       count: outputTools.length,
@@ -755,7 +753,7 @@ async function grepTools(queryInput, options = {}) {
       } : {},
       commandTemplates: TOOL_COMMAND_TEMPLATES
     },
-    { json: options.json || _chunkXDUQQTISjs.shouldEmitJson.call(void 0, ) }
+    { json: options.json || _chunkGQXEHX5Xjs.shouldEmitJson.call(void 0, ) }
   );
   return 0;
 }
@@ -802,7 +800,7 @@ function playAliasToolErrorMessage(toolId, play) {
   const playName = _nullishCoalesce(play.reference, () => ( play.name));
   return `${toolId} is a play, not a tool.
 Use: deepline plays run ${playName} --input '{...}'
-Inspect its schema with: deepline plays describe ${playName} --json`;
+Inspect its schema with: deepline describe ${playName}`;
 }
 function printPlayAliasToolError(toolId, play) {
   console.error(playAliasToolErrorMessage(toolId, play));
@@ -847,6 +845,15 @@ function playLikeToolExecuteErrorMessage(toolId, tool) {
 function printPlayLikeToolExecuteError(toolId, tool) {
   console.error(playLikeToolExecuteErrorMessage(toolId, tool));
 }
+var TOOL_ONLY_VIEWS = [
+  "compact",
+  "contractJson",
+  "pricingOnly",
+  "examplesOnly",
+  "gettersOnly",
+  "model",
+  "estimatePayload"
+];
 function registerToolsCommands(program) {
   const tools = program.command("tools").description(
     "Search by intent or structured filters, describe, and execute atomic provider tools."
@@ -859,13 +866,12 @@ Concepts:
 
 Common commands:
   deepline search --type tools email --json
-  deepline tools describe hunter_email_verifier --json
-  deepline tools describe hunter_email_verifier --pricing-only --json
+  deepline describe hunter_email_verifier
   deepline tools execute hunter_email_verifier --input '{"email":"a@b.com"}'
   deepline billing usage --request-id <job_id> --json
 
 Output:
-  Use describe for tool contracts.
+  Use deepline describe for tool contracts.
   Use execute to run a tool.
   Read pricing before execution; use the returned next.billing command for its
   exact charge. Workspace balance changes also include other callers' activity.
@@ -903,7 +909,7 @@ Examples:
       json: Boolean(options.json)
     });
   });
-  _chunkIB7OGQGHjs.registerDeprecatedSearchCommand.call(void 0, tools, () => ["tools", "monitors"]);
+  _chunkQQMKX7JWjs.registerDeprecatedSearchCommand.call(void 0, tools, () => ["tools", "monitors"]);
   tools.command("grep <query>").description(
     "Literal grep over tool ids, descriptions, categories, and input fields."
   ).addHelpText(
@@ -955,7 +961,6 @@ Examples:
   deepline tools describe hunter_email_verifier
   deepline tools describe hunter_email_verifier --pricing-only
   deepline tools describe hunter_email_verifier --pricing-only --json
-  deepline tools describe hunter_email_verifier --schema-only
   deepline tools describe hunter_email_verifier --examples-only
   deepline tools describe hunter_email_verifier --json
   deepline tools describe deeplineagent --model openai/gpt-5.6-luna --json
@@ -969,7 +974,7 @@ Examples:
     ).option(
       "--estimate-payload <payload>",
       "Quote an ai_evaluate, ai_inference, or deeplineagent JSON payload (inline or @file)"
-    ).option("--pricing-only", "Only print pricing and billing semantics").option("--schema-only", "Only print input schema fields").option(
+    ).option("--pricing-only", "Only print pricing and billing semantics").option(
       "--examples-only",
       "Only print input payload and full Deepline execution response examples"
     ).option("--getters-only", "Only print extracted list/value getters").addOption(
@@ -985,7 +990,7 @@ Examples:
     ).action(async (toolId, options) => {
       const metadata = compatibilityMetadata;
       compatibilityMetadata = void 0;
-      process.exitCode = await getTool(
+      const narrowView = () => getTool(
         toolId,
         {
           json: Boolean(options.json),
@@ -1000,9 +1005,26 @@ Examples:
         },
         metadata
       );
+      const narrow = !toolId || TOOL_ONLY_VIEWS.some((view) => options[view] !== void 0);
+      if (narrow) {
+        process.exitCode = await narrowView();
+        return;
+      }
+      const { describeAnything } = await Promise.resolve().then(() => _interopRequireWildcard(require("./describe-GS5A2XH4.js")));
+      process.exitCode = await describeAnything(
+        toolId,
+        { ...options, kinds: ["tools", "monitors"], fetchedTool: metadata },
+        // An unknown id keeps this command's own error and play hint.
+        narrowView
+      );
     });
   };
-  addToolMetadataCommand(tools.command("describe <toolId>").alias("get"));
+  addToolMetadataCommand(
+    _chunkXNL3SEMCjs.addDescribeOptions.call(void 0, 
+      tools.command("describe <toolId>", { hidden: true }).alias("get"),
+      { json: false }
+    )
+  );
   tools.command("execute <toolId>").description("Execute a tool by id.").addHelpText(
     "after",
     `
@@ -1011,14 +1033,14 @@ Notes:
   waterfalls, row maps, checkpoints, and retries.
   Calling a provider-backed tool can spend Deepline credits. Use --json for the
   stable result payload plus output preview and debugging helpers.
-  Read pricing first with tools describe <toolId> --pricing-only --json.
+  Read pricing first with deepline describe <toolId>.
   Use the returned next.billing command to look up this execution's exact charge;
   workspace balance changes also include other callers' activity.
   --timeout sets this CLI request's HTTP deadline; it does not cancel provider work.
 
 Examples:
   deepline tools execute hunter_email_verifier --input '{"email":"a@b.com"}'
-  deepline tools describe hunter_email_verifier --pricing-only --json
+  deepline describe hunter_email_verifier
   deepline billing usage --request-id <job_id> --json
   deepline tools execute bounceban_verify_bulk --input @batch.json --timeout 10m --json
   deepline tools execute hunter_email_verifier -p email=a@b.com
@@ -1085,7 +1107,7 @@ async function getTool(toolId, options = {}, compatibilityMetadata) {
     console.error("Usage: deepline tools describe <toolId> [--json]");
     return 1;
   }
-  const client = new (0, _chunkQYL5ZV4Ujs.DeeplineClient)();
+  const client = new (0, _chunkVSAYSOVCjs.DeeplineClient)();
   let tool;
   try {
     tool = await _asyncNullishCoalesce(compatibilityMetadata, async () => ( await client.getTool(toolId)));
@@ -1139,7 +1161,7 @@ async function getTool(toolId, options = {}, compatibilityMetadata) {
     const lines = toolPricingOnlyLines(tool, toolId);
     if (inferenceQuote)
       lines.push(...inferenceQuoteSummaryLines(inferenceQuote));
-    _chunkXDUQQTISjs.printCommandEnvelope.call(void 0, 
+    _chunkGQXEHX5Xjs.printCommandEnvelope.call(void 0, 
       {
         toolId: String(tool.toolId || toolId),
         cost: Capability.fromCatalogEntry(tool).describe().customerCost(),
@@ -1157,7 +1179,7 @@ async function getTool(toolId, options = {}, compatibilityMetadata) {
   }
   if ((options.schemaOnly || options.examplesOnly || options.gettersOnly) && !isMonitorTypeTool(tool) && !isPlayLikeTool(tool) && (options.json || options.contractJson)) {
     const contract = toolContractJsonForDescribe(tool, toolId);
-    _chunkXDUQQTISjs.printCompactJson.call(void 0, {
+    _chunkGQXEHX5Xjs.printCompactJson.call(void 0, {
       toolId: contract.toolId,
       ...options.schemaOnly ? {
         inputSchema: contract.inputSchema,
@@ -1180,7 +1202,7 @@ async function getTool(toolId, options = {}, compatibilityMetadata) {
     return 0;
   }
   if (options.contractJson) {
-    _chunkXDUQQTISjs.printCompactJson.call(void 0, {
+    _chunkGQXEHX5Xjs.printCompactJson.call(void 0, {
       ...toolContractJsonForDescribe(tool, toolId),
       ...modelDescription ? { modelOptions: modelDescription } : {},
       ...inferenceQuote ? { inferenceQuote } : {}
@@ -1189,7 +1211,7 @@ async function getTool(toolId, options = {}, compatibilityMetadata) {
   }
   const emitJson = options.json === true;
   if (emitJson) {
-    _chunkXDUQQTISjs.printCompactJson.call(void 0, {
+    _chunkGQXEHX5Xjs.printCompactJson.call(void 0, {
       ...toolMetadataJsonForDescribe(tool, toolId),
       ...modelDescription ? { modelOptions: modelDescription } : {},
       ...inferenceQuote ? { inferenceQuote } : {}
@@ -1220,8 +1242,8 @@ ${formatModelDescription(modelDescription)}`);
     if (inferenceQuote) printInferenceQuoteSummary(inferenceQuote);
     return 0;
   }
-  if (_chunkXDUQQTISjs.shouldEmitJson.call(void 0, )) {
-    _chunkXDUQQTISjs.printCompactJson.call(void 0, {
+  if (_chunkGQXEHX5Xjs.shouldEmitJson.call(void 0, )) {
+    _chunkGQXEHX5Xjs.printCompactJson.call(void 0, {
       ...toolContractJsonForDescribe(tool, toolId),
       ...modelDescription ? { modelOptions: modelDescription } : {},
       ...inferenceQuote ? { inferenceQuote } : {}
@@ -1459,7 +1481,127 @@ function printMonitorTypeContract(tool, requestedToolId) {
   console.log("");
   printMonitorTypeDeploy(tool);
   console.log("");
-  console.log(`More: deepline tools get ${toolId} --json`);
+  console.log(`More: deepline describe ${toolId}`);
+}
+function schemaNodeAt(schema, path) {
+  let node = schema;
+  for (const part of path.split(".").filter(Boolean)) {
+    const [key, ...indexes] = part.split("[");
+    node = recordField(isRecord(node) ? node : {}, "properties")[key];
+    for (const _index of indexes)
+      node = isRecord(node) ? node.items : void 0;
+  }
+  return node;
+}
+function jsonSchemaOf(wrapper) {
+  return isRecord(wrapper.jsonSchema) ? wrapper.jsonSchema : wrapper;
+}
+function publicToolSchemas(tool) {
+  const scrubbed = (...keys) => {
+    const schema = recordField(tool, ...keys);
+    if (Object.keys(schema).length === 0) return null;
+    const cleaned = publicToolInputSchemaForDescribe(schema);
+    return isRecord(cleaned.jsonSchema) ? cleaned.jsonSchema : cleaned;
+  };
+  const responseSchema = scrubbed("responseSchema", "response_schema");
+  return {
+    inputSchema: scrubbed(
+      "inputSchema",
+      "input_schema",
+      "payload_schema",
+      "payloadSchema"
+    ),
+    outputSchema: scrubbed("outputSchema", "output_schema"),
+    ...responseSchema ? { responseSchema } : {}
+  };
+}
+function describedTool(tool, requestedToolId) {
+  const id = stringField2(tool, "toolId") || requestedToolId;
+  const displayName = stringField2(tool, "displayName") || void 0;
+  const description = stringField2(tool, "description") || void 0;
+  if (isMonitorTypeTool(tool)) {
+    return {
+      kind: "monitor_type",
+      id,
+      displayName,
+      description,
+      cost: stringField2(recordField(tool, "pricing"), "displayText") || void 0,
+      guidance: [],
+      inputs: _chunkXNL3SEMCjs.schemaFields.call(void 0, 
+        recordField(tool, "payload_schema", "payloadSchema")
+      ),
+      outputs: [],
+      runner: {
+        via: "monitor",
+        deploy: stringField2(recordField(tool, "deploy"), "example") || `deepline monitors deploy '{"key":"...","tool":"${id}","payload":{...}}'`
+      }
+    };
+  }
+  const contract = toolContractJsonForDescribe(tool, requestedToolId);
+  const cost = recordField(contract, "cost");
+  const billing = stringField2(cost, "billingSourceLabel");
+  const deprecation = recordField(contract, "deprecation");
+  const getters = recordField(contract, "getters");
+  const outputSchema = jsonSchemaOf(recordField(contract, "outputSchema"));
+  const toolResult = recordField(tool, "toolResult", "tool_result");
+  const getterDetails = (kind) => new Map(
+    arrayField2(toolResult, kind).filter(isRecord).map((item) => [
+      stringField2(item, "name"),
+      recordField(item, "details")
+    ])
+  );
+  const getterOutputs = (kind, roots) => {
+    const details = getterDetails(kind);
+    return arrayField2(getters, kind).filter(isRecord).map((entry) => {
+      const name = stringField2(entry, "name");
+      const paths = arrayField2(
+        _nullishCoalesce(details.get(name), () => ( {})),
+        "rawToolOutputPaths"
+      ).map((path) => String(path).replace(/^toolResponse\.raw\./, ""));
+      const node = roots.flatMap((root) => paths.map((path) => schemaNodeAt(root, path))).find(isRecord);
+      const { fields, ...typed } = _chunkXNL3SEMCjs.schemaField.call(void 0, name, node, true);
+      const valueType = stringField2(_nullishCoalesce(details.get(name), () => ( {})), "valueType");
+      const field = {
+        ...typed,
+        // A normalized value has a named type instead of the response's shape.
+        ...valueType ? { type: valueType } : fields ? { fields } : {},
+        // A list's row columns that matter are value getters of their own.
+        ...kind === "extractedLists" && fields ? { summarized: true } : {},
+        read: playResultExpression(entry)
+      };
+      return { field, node };
+    });
+  };
+  const lists = getterOutputs("extractedLists", [outputSchema]);
+  const values = getterOutputs("extractedValues", [
+    outputSchema,
+    ...lists.map(({ node }) => _optionalChain([node, 'optionalAccess', _13 => _13.items]))
+  ]);
+  const playReference = isPlayLikeTool(tool) ? playReferenceForTool(tool) : null;
+  return {
+    kind: "tool",
+    id: String(contract.toolId),
+    displayName,
+    description,
+    cost: [
+      stringField2(cost, "displayText"),
+      // "Free (free)" says the same thing twice.
+      billing.toLowerCase() === stringField2(cost, "displayText").toLowerCase() ? "" : billing && `(${billing})`
+    ].filter(Boolean).join(" ") || void 0,
+    guidance: [
+      ...contract.deprecated === true ? [`Deprecated. ${stringField2(deprecation, "message")}`.trim()] : [],
+      ...Object.values(recordField(contract, "guidance")).filter(
+        (line) => typeof line === "string" && /[a-z0-9]/i.test(line)
+      )
+    ],
+    rateLimit: _chunkXNL3SEMCjs.rateLimitSummary.call(void 0, 
+      recordField(contract, "executionMetadata").configuredRateLimits
+    ),
+    inputs: _chunkXNL3SEMCjs.schemaFields.call(void 0, jsonSchemaOf(recordField(contract, "inputSchema"))),
+    outputs: [...lists, ...values].map(({ field }) => field),
+    rawResponse: _chunkXNL3SEMCjs.schemaFields.call(void 0, outputSchema),
+    runner: playReference ? { via: "play", reference: playReference } : { via: "tool", toolId: String(contract.toolId) }
+  };
 }
 function toolGuidanceLines(guidance) {
   const record = isRecord(guidance) ? guidance : {};
@@ -1516,7 +1658,7 @@ function printCompactToolContract(tool, requestedToolId) {
     }
     console.log("");
     console.log(
-      `More: deepline tools describe ${replacementToolId || contract.toolId} --json`
+      `More: deepline describe ${replacementToolId || contract.toolId} --json`
     );
     return;
   }
@@ -1574,9 +1716,7 @@ function printCompactToolContract(tool, requestedToolId) {
   console.log(
     "Provider-specific fields: inspect result.toolResponse.rawV2 and its observed envelope. Prefer the declared getters above."
   );
-  console.log(
-    `More: deepline tools describe ${contract.toolId} --pricing-only | --schema-only | --examples-only | --getters-only | --json`
-  );
+  console.log(`More: deepline describe ${contract.toolId} --json`);
 }
 function toolPricingOnlyLines(tool, requestedToolId, options = {}) {
   if (isMonitorTypeTool(tool)) {
@@ -1718,7 +1858,7 @@ function printPlayLikeToolUsage(tool, requestedToolId) {
     )
   );
   if (playReference) {
-    console.log(`deepline plays describe ${playReference} --json`);
+    console.log(`deepline describe ${playReference}`);
   }
 }
 function printToolGettersOnly(tool, requestedToolId) {
@@ -1934,9 +2074,9 @@ function toolInputFieldsForDisplay(inputSchema) {
     );
     return fields.map((field) => {
       const jsonSchemaField = typeof field.name === "string" ? jsonSchemaFields.get(field.name) : void 0;
-      const minItems = typeof field.minItems === "number" ? field.minItems : _optionalChain([jsonSchemaField, 'optionalAccess', _13 => _13.minItems]);
-      const maxItems = typeof field.maxItems === "number" ? field.maxItems : _optionalChain([jsonSchemaField, 'optionalAccess', _14 => _14.maxItems]);
-      const items = isRecord(field.items) ? field.items : _optionalChain([jsonSchemaField, 'optionalAccess', _15 => _15.items]);
+      const minItems = typeof field.minItems === "number" ? field.minItems : _optionalChain([jsonSchemaField, 'optionalAccess', _14 => _14.minItems]);
+      const maxItems = typeof field.maxItems === "number" ? field.maxItems : _optionalChain([jsonSchemaField, 'optionalAccess', _15 => _15.maxItems]);
+      const items = isRecord(field.items) ? field.items : _optionalChain([jsonSchemaField, 'optionalAccess', _16 => _16.items]);
       return {
         ...field,
         ...isRecord(items) ? { items } : {},
@@ -2125,7 +2265,7 @@ function inputFieldJsonForDescribe(field) {
 function arrayItemBoundsSuffix(field) {
   const itemSchema = isRecord(field.items) ? field.items : null;
   const itemType = itemSchema ? typeof itemSchema.type === "string" ? itemSchema.type : isRecord(itemSchema.properties) ? "object" : "unknown" : null;
-  const itemEnum = Array.isArray(_optionalChain([itemSchema, 'optionalAccess', _16 => _16.enum])) ? ` enum=${itemSchema.enum.map(String).join("|")}` : "";
+  const itemEnum = Array.isArray(_optionalChain([itemSchema, 'optionalAccess', _17 => _17.enum])) ? ` enum=${itemSchema.enum.map(String).join("|")}` : "";
   const itemTypeSuffix = itemType && itemType !== "unknown" ? ` items=${itemType}${itemEnum}` : "";
   const minItems = typeof field.minItems === "number" && Number.isFinite(field.minItems) ? field.minItems : null;
   const maxItems = typeof field.maxItems === "number" && Number.isFinite(field.maxItems) ? field.maxItems : null;
@@ -2254,7 +2394,7 @@ function extractToolExecutionWarningMessages(rawResponse) {
   ];
   const messages = [];
   for (const candidate of candidates) {
-    const warnings = _optionalChain([candidate, 'optionalAccess', _17 => _17.warnings]);
+    const warnings = _optionalChain([candidate, 'optionalAccess', _18 => _18.warnings]);
     if (!Array.isArray(warnings)) continue;
     for (const warning of warnings) {
       if (typeof warning === "string" && warning.trim()) {
@@ -2290,10 +2430,10 @@ function apifySyncRecoveryNext(rawResponse) {
   };
 }
 function listExtractorPathsFromUsageGuidance(tool) {
-  const toolExecutionResult = _optionalChain([tool, 'access', _18 => _18.usageGuidance, 'optionalAccess', _19 => _19.toolExecutionResult]);
-  const extractedLists = Array.isArray(_optionalChain([toolExecutionResult, 'optionalAccess', _20 => _20.extractedLists])) ? toolExecutionResult.extractedLists : isRecord(_optionalChain([toolExecutionResult, 'optionalAccess', _21 => _21.extractedLists])) ? Object.values(toolExecutionResult.extractedLists) : [];
+  const toolExecutionResult = _optionalChain([tool, 'access', _19 => _19.usageGuidance, 'optionalAccess', _20 => _20.toolExecutionResult]);
+  const extractedLists = Array.isArray(_optionalChain([toolExecutionResult, 'optionalAccess', _21 => _21.extractedLists])) ? toolExecutionResult.extractedLists : isRecord(_optionalChain([toolExecutionResult, 'optionalAccess', _22 => _22.extractedLists])) ? Object.values(toolExecutionResult.extractedLists) : [];
   return extractedLists.flatMap((entry) => {
-    const paths = _nullishCoalesce(_optionalChain([entry, 'access', _22 => _22.details, 'optionalAccess', _23 => _23.candidatePaths]), () => ( _optionalChain([entry, 'access', _24 => _24.details, 'optionalAccess', _25 => _25.rawToolOutputPaths])));
+    const paths = _nullishCoalesce(_optionalChain([entry, 'access', _23 => _23.details, 'optionalAccess', _24 => _24.candidatePaths]), () => ( _optionalChain([entry, 'access', _25 => _25.details, 'optionalAccess', _26 => _26.rawToolOutputPaths])));
     if (!Array.isArray(paths)) return [];
     return paths.map(
       (path) => path.trim().replace(/^toolExecutionResult\.toolResponse\.raw\.?/, "").replace(/^toolExecutionResult\.toolOutput\.raw\.?/, "").replace(/^\./, "")
@@ -2775,15 +2915,15 @@ async function executeTool(args) {
   try {
     parsed = parseExecuteOptions(args);
   } catch (error) {
-    if (_chunkXDUQQTISjs.argsWantJson.call(void 0, args)) {
-      _chunkXDUQQTISjs.printJsonError.call(void 0, error);
+    if (_chunkGQXEHX5Xjs.argsWantJson.call(void 0, args)) {
+      _chunkGQXEHX5Xjs.printJsonError.call(void 0, error);
     } else {
       console.error(error instanceof Error ? error.message : String(error));
     }
     return 1;
   }
   const cliInvocationId = _nullishCoalesce(_chunkQJBJZVG6js.getToolExecuteInvocationId.call(void 0, ), () => ( _chunkQJBJZVG6js.beginToolExecuteCommand.call(void 0, )));
-  const client = new (0, _chunkQYL5ZV4Ujs.DeeplineClient)();
+  const client = new (0, _chunkVSAYSOVCjs.DeeplineClient)();
   let metadata;
   try {
     metadata = await _chunkQJBJZVG6js.runToolExecuteStage.call(void 0, 
@@ -2797,8 +2937,8 @@ async function executeTool(args) {
         () => findPlayForToolId(client, parsed.toolId, cliInvocationId)
       );
       if (play) {
-        if (_chunkXDUQQTISjs.argsWantJson.call(void 0, args)) {
-          _chunkXDUQQTISjs.printJsonError.call(void 0, 
+        if (_chunkGQXEHX5Xjs.argsWantJson.call(void 0, args)) {
+          _chunkGQXEHX5Xjs.printJsonError.call(void 0, 
             new Error(playAliasToolErrorMessage(parsed.toolId, play))
           );
         } else {
@@ -2810,8 +2950,8 @@ async function executeTool(args) {
     throw error;
   }
   if (isPlayLikeTool(metadata)) {
-    if (_chunkXDUQQTISjs.argsWantJson.call(void 0, args)) {
-      _chunkXDUQQTISjs.printJsonError.call(void 0, 
+    if (_chunkGQXEHX5Xjs.argsWantJson.call(void 0, args)) {
+      _chunkGQXEHX5Xjs.printJsonError.call(void 0, 
         new Error(
           playLikeToolExecuteErrorMessage(
             parsed.toolId,
@@ -2843,11 +2983,11 @@ async function executeTool(args) {
     "execute request",
     () => client.executeTool(parsed.toolId, parsed.params, {
       ...parsed.timeoutMs !== void 0 ? { timeout: parsed.timeoutMs } : {},
-      ..._optionalChain([metadata, 'access', _26 => _26.executionMetadata, 'optionalAccess', _27 => _27.retrySafeTransientHttp]) === true ? { maxRetries: 2, retryApiErrors: true } : {},
+      ..._optionalChain([metadata, 'access', _27 => _27.executionMetadata, 'optionalAccess', _28 => _28.retrySafeTransientHttp]) === true ? { maxRetries: 2, retryApiErrors: true } : {},
       responseIntent,
       ...idempotencyKey ? { idempotencyKey } : {},
       ...parsed.recoveryTimeoutMs !== void 0 ? { recoveryTimeoutMs: parsed.recoveryTimeoutMs } : {},
-      searchRef: _chunkIB7OGQGHjs.recentSearchRef.call(void 0, ),
+      searchRef: _chunkQQMKX7JWjs.recentSearchRef.call(void 0, ),
       cliInvocationId
     }).catch((error) => {
       const guidanceLines = toolGuidanceLines(metadata.guidance);
@@ -2886,8 +3026,8 @@ async function executeTool(args) {
   );
   const executeExitCode = toolExecuteExitCode(baseEnvelope);
   const delivered = await _chunkQJBJZVG6js.runToolExecuteStage.call(void 0, "output delivery", () => {
-    if (!parsed.outPath && (parsed.outputFormat === "json" || parsed.outputFormat === "auto" && _chunkXDUQQTISjs.shouldEmitJson.call(void 0, ))) {
-      _chunkXDUQQTISjs.printCommandEnvelope.call(void 0, baseEnvelope, { json: true });
+    if (!parsed.outPath && (parsed.outputFormat === "json" || parsed.outputFormat === "auto" && _chunkGQXEHX5Xjs.shouldEmitJson.call(void 0, ))) {
+      _chunkGQXEHX5Xjs.printCommandEnvelope.call(void 0, baseEnvelope, { json: true });
       return true;
     }
     if (parsed.outputFormat === "json_file") {
@@ -2895,7 +3035,7 @@ async function executeTool(args) {
         rawResponse,
         `payload_${parsed.toolId}`
       );
-      _chunkXDUQQTISjs.printCommandEnvelope.call(void 0, 
+      _chunkGQXEHX5Xjs.printCommandEnvelope.call(void 0, 
         {
           ...baseEnvelope,
           local: {
@@ -2912,8 +3052,8 @@ async function executeTool(args) {
         const error = new Error(
           `${parsed.toolId} did not expose row-shaped output to write as CSV. Re-run with --json to inspect the raw tool response.`
         );
-        if (_chunkXDUQQTISjs.argsWantJson.call(void 0, args)) {
-          _chunkXDUQQTISjs.printJsonError.call(void 0, error);
+        if (_chunkGQXEHX5Xjs.argsWantJson.call(void 0, args)) {
+          _chunkGQXEHX5Xjs.printJsonError.call(void 0, error);
         } else {
           console.error(error.message);
         }
@@ -2924,18 +3064,18 @@ async function executeTool(args) {
           rawResponse,
           `payload_${parsed.toolId}`
         );
-        _chunkXDUQQTISjs.printCommandEnvelope.call(void 0, 
+        _chunkGQXEHX5Xjs.printCommandEnvelope.call(void 0, 
           {
             ...baseEnvelope,
             local: {
               payload_file: jsonPath
             }
           },
-          { json: parsed.outputFormat === "csv_file" || _chunkXDUQQTISjs.shouldEmitJson.call(void 0, ) }
+          { json: parsed.outputFormat === "csv_file" || _chunkGQXEHX5Xjs.shouldEmitJson.call(void 0, ) }
         );
         return true;
       }
-      _chunkXDUQQTISjs.printCommandEnvelope.call(void 0, baseEnvelope, { json: false });
+      _chunkGQXEHX5Xjs.printCommandEnvelope.call(void 0, baseEnvelope, { json: false });
       return true;
     }
     const rowOutput = _chunkNXDRDJ4Kjs.projectRowOutput.call(void 0, listConversion);
@@ -2957,19 +3097,19 @@ async function executeTool(args) {
       seededScript
     });
     if (parsed.outputFormat === "csv_file") {
-      _chunkXDUQQTISjs.printCommandEnvelope.call(void 0, materializedEnvelope, { json: true });
+      _chunkGQXEHX5Xjs.printCommandEnvelope.call(void 0, materializedEnvelope, { json: true });
       return true;
     }
     if (parsed.outPath) {
-      _chunkXDUQQTISjs.printCommandEnvelope.call(void 0, materializedEnvelope, {
-        json: _chunkXDUQQTISjs.argsWantJson.call(void 0, args) || _chunkXDUQQTISjs.shouldEmitJson.call(void 0, ),
+      _chunkGQXEHX5Xjs.printCommandEnvelope.call(void 0, materializedEnvelope, {
+        json: _chunkGQXEHX5Xjs.argsWantJson.call(void 0, args) || _chunkGQXEHX5Xjs.shouldEmitJson.call(void 0, ),
         text: `Wrote ${csv.rowCount} row(s) to ${csv.path}
 `
       });
       return true;
     }
     if (parsed.noPreview) {
-      _chunkXDUQQTISjs.printCommandEnvelope.call(void 0, 
+      _chunkGQXEHX5Xjs.printCommandEnvelope.call(void 0, 
         {
           ...materializedEnvelope,
           local: {
@@ -2977,12 +3117,12 @@ async function executeTool(args) {
             output_path: csv.path
           }
         },
-        { json: _chunkXDUQQTISjs.shouldEmitJson.call(void 0, ), text: `${csv.path}
+        { json: _chunkGQXEHX5Xjs.shouldEmitJson.call(void 0, ), text: `${csv.path}
 ` }
       );
       return true;
     }
-    _chunkXDUQQTISjs.printCommandEnvelope.call(void 0, materializedEnvelope, { json: false });
+    _chunkGQXEHX5Xjs.printCommandEnvelope.call(void 0, materializedEnvelope, { json: false });
     return true;
   });
   if (delivered) {
@@ -3001,4 +3141,8 @@ async function executeTool(args) {
 
 
 
-exports.buildToolExecuteBaseEnvelope = buildToolExecuteBaseEnvelope; exports.extractToolExecutionWarningMessages = extractToolExecutionWarningMessages; exports.isMonitorTypeTool = isMonitorTypeTool; exports.printCompactToolContract = printCompactToolContract; exports.printMonitorTypeContract = printMonitorTypeContract; exports.registerToolsCommands = registerToolsCommands; exports.toolContractJsonForDescribe = toolContractJsonForDescribe;
+
+
+
+
+exports.isMonitorTypeTool = isMonitorTypeTool; exports.registerToolsCommands = registerToolsCommands; exports.toolContractJsonForDescribe = toolContractJsonForDescribe; exports.printMonitorTypeContract = printMonitorTypeContract; exports.publicToolSchemas = publicToolSchemas; exports.describedTool = describedTool; exports.printCompactToolContract = printCompactToolContract; exports.toolMetadataJsonForDescribe = toolMetadataJsonForDescribe; exports.extractToolExecutionWarningMessages = extractToolExecutionWarningMessages; exports.buildToolExecuteBaseEnvelope = buildToolExecuteBaseEnvelope;