deepline 0.3.367 → 0.3.369

package/dist/cli/{chunk-LJIWLZHS.js → chunk-PRMAO43X.js}

@@ -11,7 +11,9 @@ var _chunkAID3OYVJjs = require('./chunk-AID3OYVJ.js');
 
 
 
-var _chunkCRRVBNZDjs = require('./chunk-CRRVBNZD.js');
+
+
+var _chunkLH3BV773js = require('./chunk-LH3BV773.js');
 
 
 
@@ -26,7 +28,7 @@ var _chunk5O4B6AUNjs = require('./chunk-5O4B6AUN.js');
 
 
 
-var _chunkKJFND3YTjs = require('./chunk-KJFND3YT.js');
+var _chunkKGZRUGL7js = require('./chunk-KGZRUGL7.js');
 
 
 
@@ -40,11 +42,11 @@ var _chunkQJBJZVG6js = require('./chunk-QJBJZVG6.js');
 
 
 
-var _chunkD7SELX66js = require('./chunk-D7SELX66.js');
+var _chunkERMXQOIVjs = require('./chunk-ERMXQOIV.js');
 
 
 
-var _chunkR2HHZLOPjs = require('./chunk-R2HHZLOP.js');
+var _chunk2AENFV3Bjs = require('./chunk-2AENFV3B.js');
 
 
 var _chunk7P5AA3SNjs = require('./chunk-7P5AA3SN.js');
@@ -89,10 +91,10 @@ var ToolCallRecovery = class _ToolCallRecovery {
   }
 };
 function pendingToolExecutionPath(input) {
-  const config = _chunkR2HHZLOPjs.resolveConfig.call(void 0, );
+  const config = _chunk2AENFV3Bjs.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, 
-    _chunkR2HHZLOPjs.sdkCliStateDirPath.call(void 0, config.baseUrl),
+    _chunk2AENFV3Bjs.sdkCliStateDirPath.call(void 0, config.baseUrl),
     `pending-tool-execution-${fingerprint}.json`
   );
 }
@@ -243,102 +245,6 @@ function arrayField(value, key) {
   return Array.isArray(candidate) ? candidate : [];
 }
 
-// src/cli/tool-description.ts
-var Capability = class _Capability {
-  #catalogEntry;
-  constructor(catalogEntry) {
-    this.#catalogEntry = catalogEntry;
-  }
-  static fromCatalogEntry(catalogEntry) {
-    return new _Capability(catalogEntry);
-  }
-  describe() {
-    return CapabilityDescription.fromCatalogEntry(this.#catalogEntry);
-  }
-};
-var CapabilityDescription = class _CapabilityDescription {
-  #catalogEntry;
-  constructor(catalogEntry) {
-    this.#catalogEntry = catalogEntry;
-  }
-  static fromCatalogEntry(catalogEntry) {
-    return new _CapabilityDescription(catalogEntry);
-  }
-  /**
-   * The customer price already resolved by the catalog. This intentionally
-   * omits provider-price fields, even when a catalog Adapter carried them.
-   */
-  customerCost() {
-    const legacyCost = recordValue(this.#catalogEntry.cost);
-    const pricing = recordValue(this.#catalogEntry.pricing);
-    const unit = stringValue(pricing.unit);
-    const legacyPricingModel = stringValue(
-      _nullishCoalesce(legacyCost.pricingModel, () => ( legacyCost.pricing_model))
-    );
-    const pricingModel = unit === "call" ? "fixed" : unit === "result" || unit === "page" ? `per_${unit}` : unit === "usage" ? "provider_usage" : legacyPricingModel;
-    const canonicalCredits = pricingNumber(
-      pricing,
-      "creditsPerUnit",
-      "credits_per_unit",
-      _nullishCoalesce(this.#catalogEntry.deeplineCreditsPerPricingUnit, () => ( this.#catalogEntry.deepline_credits_per_pricing_unit))
-    );
-    const canonicalUsd = pricingNumber(
-      pricing,
-      "usdPerUnit",
-      "usd_per_unit",
-      _nullishCoalesce(this.#catalogEntry.deeplineUsdPerPricingUnit, () => ( this.#catalogEntry.deepline_usd_per_pricing_unit))
-    );
-    const billingSource = stringValue(
-      _nullishCoalesce(this.#catalogEntry.billingSource, () => ( this.#catalogEntry.billing_source))
-    );
-    const billingSourceLabel = stringValue(
-      _nullishCoalesce(this.#catalogEntry.billingSourceLabel, () => ( this.#catalogEntry.billing_source_label))
-    );
-    const isFree = billingSource === "free";
-    return {
-      pricingModel: pricingModel || null,
-      unit: unit || null,
-      displayText: isFree ? "Free" : stringValue(_nullishCoalesce(pricing.displayText, () => ( pricing.display_text))),
-      summary: isFree ? null : stringValue(pricing.summary),
-      billingMode: stringValue(
-        _nullishCoalesce(legacyCost.billingMode, () => ( legacyCost.billing_mode))
-      ),
-      billingSource,
-      billingSourceLabel,
-      deeplineCreditsPerPricingUnit: isFree ? 0 : canonicalCredits,
-      deeplineUsdPerPricingUnit: isFree ? 0 : canonicalUsd,
-      ...pricing.estimatedRange && !isFree && billingSource !== "own_provider_credentials" ? {
-        estimatedRange: pricing.estimatedRange,
-        details: Array.isArray(pricing.details) ? pricing.details.filter(
-          (value) => typeof value === "string"
-        ) : []
-      } : {},
-      ...pricing.observedReference && !isFree && billingSource !== "own_provider_credentials" ? {
-        observedReference: pricing.observedReference,
-        details: Array.isArray(pricing.details) ? pricing.details.filter(
-          (value) => typeof value === "string"
-        ) : []
-      } : {}
-    };
-  }
-};
-function recordValue(value) {
-  return value && typeof value === "object" && !Array.isArray(value) ? value : {};
-}
-function stringValue(value) {
-  return typeof value === "string" && value.trim() ? value : null;
-}
-function numberValue(value) {
-  return typeof value === "number" && Number.isFinite(value) ? value : null;
-}
-function pricingNumber(pricing, canonicalKey, aliasKey, legacyValue) {
-  for (const key of [canonicalKey, aliasKey]) {
-    if (Object.prototype.hasOwnProperty.call(pricing, key))
-      return numberValue(pricing[key]);
-  }
-  return numberValue(legacyValue);
-}
-
 // src/cli/tool-connection-status.ts
 function toolConnectionStatusMessage(input) {
   if (input.credentialStatus === "requires_connection") {
@@ -536,12 +442,12 @@ function categoryEnumerationRender(summaries) {
   };
 }
 async function listToolCategories(emitJson, compact) {
-  const client = new (0, _chunkKJFND3YTjs.DeeplineClient)();
+  const client = new (0, _chunkKGZRUGL7js.DeeplineClient)();
   const rawTools = await client.listTools({ compact });
   const items = rawTools.map(toListedTool);
   const summaries = aggregateCategorySummaries(rawTools);
   const outputItems = compact ? items.map(compactTool) : items;
-  _chunkD7SELX66js.printCommandEnvelope.call(void 0, 
+  _chunkERMXQOIVjs.printCommandEnvelope.call(void 0, 
     {
       tools: outputItems,
       count: outputItems.length,
@@ -560,7 +466,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) {
-    _chunkD7SELX66js.printJson.call(void 0, {
+    _chunkERMXQOIVjs.printJson.call(void 0, {
       ok: false,
       exitCode: 4,
       code: "TOOL_CATEGORY_NOT_FOUND",
@@ -574,13 +480,13 @@ function unknownCategoryError(category, summaries, emitJson) {
   const render = categoryEnumerationRender(summaries);
   console.error(message);
   console.error("");
-  console.error(_chunkD7SELX66js.renderCommandEnvelopeText.call(void 0, { render }).trimEnd());
+  console.error(_chunkERMXQOIVjs.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, _chunkKJFND3YTjs.DeeplineClient)();
+  const client = new (0, _chunkKGZRUGL7js.DeeplineClient)();
   const rawTools = await client.listTools({
     categories: category,
     compact: false
@@ -617,7 +523,7 @@ async function listToolsInCategory(category, emitJson) {
       }
     ]
   };
-  _chunkD7SELX66js.printCommandEnvelope.call(void 0, 
+  _chunkERMXQOIVjs.printCommandEnvelope.call(void 0, 
     {
       category,
       total: rows.length,
@@ -630,7 +536,7 @@ async function listToolsInCategory(category, emitJson) {
   return 0;
 }
 async function listToolsForCategoryFilter(requestedCategories, emitJson, compact) {
-  const client = new (0, _chunkKJFND3YTjs.DeeplineClient)();
+  const client = new (0, _chunkKGZRUGL7js.DeeplineClient)();
   const items = (await client.listTools({
     categories: requestedCategories.join(","),
     compact
@@ -659,7 +565,7 @@ async function listToolsForCategoryFilter(requestedCategories, emitJson, compact
     ]
   };
   const outputItems = compact ? items.map(compactTool) : items;
-  _chunkD7SELX66js.printCommandEnvelope.call(void 0, 
+  _chunkERMXQOIVjs.printCommandEnvelope.call(void 0, 
     {
       tools: outputItems,
       count: outputItems.length,
@@ -678,13 +584,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 || _chunkD7SELX66js.shouldEmitJson.call(void 0, );
+  const emitJson = options.json === true || _chunkERMXQOIVjs.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) {
-        _chunkD7SELX66js.printJson.call(void 0, {
+        _chunkERMXQOIVjs.printJson.call(void 0, {
           ok: false,
           exitCode: 2,
           code: "TOOL_LIST_CATEGORY_CONFLICT",
@@ -711,7 +617,7 @@ async function grepTools(queryInput, options = {}) {
     console.error("Usage: deepline tools grep <query> [--json]");
     return 1;
   }
-  const client = new (0, _chunkKJFND3YTjs.DeeplineClient)();
+  const client = new (0, _chunkKGZRUGL7js.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;
@@ -754,7 +660,7 @@ async function grepTools(queryInput, options = {}) {
     query,
     mode
   }) : null;
-  _chunkD7SELX66js.printCommandEnvelope.call(void 0, 
+  _chunkERMXQOIVjs.printCommandEnvelope.call(void 0, 
     {
       tools: outputTools,
       count: outputTools.length,
@@ -772,7 +678,7 @@ async function grepTools(queryInput, options = {}) {
       } : {},
       commandTemplates: TOOL_COMMAND_TEMPLATES
     },
-    { json: options.json || _chunkD7SELX66js.shouldEmitJson.call(void 0, ) }
+    { json: options.json || _chunkERMXQOIVjs.shouldEmitJson.call(void 0, ) }
   );
   return 0;
 }
@@ -928,7 +834,7 @@ Examples:
       json: Boolean(options.json)
     });
   });
-  _chunkCRRVBNZDjs.registerDeprecatedSearchCommand.call(void 0, tools, () => ["tools", "monitors"]);
+  _chunkLH3BV773js.registerDeprecatedSearchCommand.call(void 0, tools, () => ["tools", "monitors"]);
   tools.command("grep <query>").description(
     "Literal grep over tool ids, descriptions, categories, and input fields."
   ).addHelpText(
@@ -1030,7 +936,7 @@ Examples:
         process.exitCode = await narrowView();
         return;
       }
-      const { describeAnything } = await Promise.resolve().then(() => _interopRequireWildcard(require("./describe-AVXUIRDK.js")));
+      const { describeAnything } = await Promise.resolve().then(() => _interopRequireWildcard(require("./describe-DNDL3TC6.js")));
       process.exitCode = await describeAnything(
         toolId,
         { ...options, kinds: ["tools", "monitors"], fetchedTool: metadata },
@@ -1112,7 +1018,7 @@ async function getTool(toolId, options = {}, compatibilityMetadata) {
     console.error("Usage: deepline tools describe <toolId> [--json]");
     return 1;
   }
-  const client = new (0, _chunkKJFND3YTjs.DeeplineClient)();
+  const client = new (0, _chunkKGZRUGL7js.DeeplineClient)();
   let tool;
   try {
     tool = await _asyncNullishCoalesce(compatibilityMetadata, async () => ( await client.getTool(toolId)));
@@ -1166,10 +1072,10 @@ async function getTool(toolId, options = {}, compatibilityMetadata) {
     const lines = toolPricingOnlyLines(tool, toolId);
     if (inferenceQuote)
       lines.push(...inferenceQuoteSummaryLines(inferenceQuote));
-    _chunkD7SELX66js.printCommandEnvelope.call(void 0, 
+    _chunkERMXQOIVjs.printCommandEnvelope.call(void 0, 
       {
         toolId: String(tool.toolId || toolId),
-        cost: Capability.fromCatalogEntry(tool).describe().customerCost(),
+        cost: _chunkLH3BV773js.Capability.fromCatalogEntry(tool).describe().customerCost(),
         ...modelDescription ? { modelOptions: modelDescription } : {},
         ...isMonitorTypeTool(tool) ? { pricing: recordField(tool, "pricing") } : {},
         ...inferenceQuote ? { inferenceQuote } : {}
@@ -1184,7 +1090,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);
-    _chunkD7SELX66js.printCompactJson.call(void 0, {
+    _chunkERMXQOIVjs.printCompactJson.call(void 0, {
       toolId: contract.toolId,
       ...options.schemaOnly ? {
         inputSchema: contract.inputSchema,
@@ -1207,7 +1113,7 @@ async function getTool(toolId, options = {}, compatibilityMetadata) {
     return 0;
   }
   if (options.contractJson) {
-    _chunkD7SELX66js.printCompactJson.call(void 0, {
+    _chunkERMXQOIVjs.printCompactJson.call(void 0, {
       ...toolContractJsonForDescribe(tool, toolId),
       ...modelDescription ? { modelOptions: modelDescription } : {},
       ...inferenceQuote ? { inferenceQuote } : {}
@@ -1216,7 +1122,7 @@ async function getTool(toolId, options = {}, compatibilityMetadata) {
   }
   const emitJson = options.json === true;
   if (emitJson) {
-    _chunkD7SELX66js.printCompactJson.call(void 0, {
+    _chunkERMXQOIVjs.printCompactJson.call(void 0, {
       ...toolMetadataJsonForDescribe(tool, toolId),
       ...modelDescription ? { modelOptions: modelDescription } : {},
       ...inferenceQuote ? { inferenceQuote } : {}
@@ -1293,7 +1199,7 @@ function toolContractJsonForDescribe(tool, requestedToolId, authoringContractEdi
   const extractedValues = extractionContractEntries(
     arrayField2(toolExecutionResult, "extractedValues", "extracted_values")
   );
-  const pricing = Capability.fromCatalogEntry(tool).describe().customerCost();
+  const pricing = _chunkLH3BV773js.Capability.fromCatalogEntry(tool).describe().customerCost();
   const executionMetadataRecord = recordField(
     tool,
     "executionMetadata",
@@ -1587,7 +1493,8 @@ function describedTool(tool, requestedToolId) {
     cost: [
       stringField2(cost, "displayText"),
       // "Free (free)" says the same thing twice.
-      billing.toLowerCase() === stringField2(cost, "displayText").toLowerCase() ? "" : billing && `(${billing})`
+      billing.toLowerCase() === stringField2(cost, "displayText").toLowerCase() ? "" : billing && `(${billing})`,
+      _chunkLH3BV773js.observedMaxText.call(void 0, cost) && `\u2014 ${_chunkLH3BV773js.observedMaxText.call(void 0, cost)}`
     ].filter(Boolean).join(" ") || void 0,
     guidance: [
       ...contract.deprecated === true ? [`Deprecated. ${stringField2(deprecation, "message")}`.trim()] : [],
@@ -1724,7 +1631,7 @@ function toolPricingOnlyLines(tool, requestedToolId, options = {}) {
     return monitorTypePricingLines(tool);
   }
   const toolId = String(tool.toolId || requestedToolId);
-  const cost = Capability.fromCatalogEntry(tool).describe().customerCost();
+  const cost = _chunkLH3BV773js.Capability.fromCatalogEntry(tool).describe().customerCost();
   const pricingModel = stringField2(cost, "pricingModel") || "unknown";
   const billing = stringField2(cost, "billingSourceLabel") || stringField2(cost, "billingSource") || stringField2(cost, "billingMode") || "unknown";
   const explicitUnit = stringField2(cost, "unit");
@@ -1736,6 +1643,7 @@ function toolPricingOnlyLines(tool, requestedToolId, options = {}) {
   const price = displayText || summary || (credits !== null ? `${formatDecimal(credits)} Deepline credits${usd !== null ? ` / ${formatUsd(usd)}` : ""} per ${unit}` : "pricing unavailable");
   return [
     `${_nullishCoalesce(options.heading, () => ( `Pricing: ${toolId}`))}: ${price}`,
+    ..._chunkLH3BV773js.observedMaxText.call(void 0, cost) ? [`  ${_chunkLH3BV773js.observedMaxText.call(void 0, cost)}`] : [],
     ...cost.observedReference || cost.estimatedRange ? [
       ...summary ? [`  ${summary}`] : [],
       ...(_nullishCoalesce(cost.details, () => ( []))).map((detail) => `  ${detail}`)
@@ -2013,7 +1921,7 @@ function toolMetadataJsonForDescribe(tool, requestedToolId) {
   } = tool;
   const outputSchemaRecord = recordField(tool, "outputSchema", "output_schema");
   return {
-    cost: Capability.fromCatalogEntry(tool).describe().customerCost(),
+    cost: _chunkLH3BV773js.Capability.fromCatalogEntry(tool).describe().customerCost(),
     ...publicTool,
     toolId,
     provider: tool.provider,
@@ -2627,7 +2535,7 @@ function parseExecuteOptions(toolId, options, output) {
     outputFormat = normalizeOutputFormat(options.outputFormat);
   }
   if (options.idempotencyKey !== void 0) {
-    _chunkKJFND3YTjs.validateExecutionIdempotencyKey.call(void 0, options.idempotencyKey);
+    _chunkKGZRUGL7js.validateExecutionIdempotencyKey.call(void 0, options.idempotencyKey);
   }
   if (options.recoveryTimeoutMs !== void 0) {
     const parsed = Number(options.recoveryTimeoutMs);
@@ -2938,20 +2846,20 @@ function buildToolExecuteRowArtifactEnvelope(input) {
 }
 async function executeTool(toolId, options) {
   const output = toolExecuteJsonOption(options.json);
-  const wantsJson = _chunkD7SELX66js.shouldEmitJson.call(void 0, output.requested);
+  const wantsJson = _chunkERMXQOIVjs.shouldEmitJson.call(void 0, output.requested);
   let parsed;
   try {
     parsed = parseExecuteOptions(toolId, options, output);
   } catch (error) {
     if (wantsJson) {
-      _chunkD7SELX66js.printJsonError.call(void 0, error);
+      _chunkERMXQOIVjs.printJsonError.call(void 0, error);
     } else {
       console.error(error instanceof Error ? error.message : String(error));
     }
     return error instanceof _chunk7P5AA3SNjs.DeeplineError && error.code === "IDEMPOTENCY_KEY_INVALID" ? 2 : 1;
   }
   const cliInvocationId = _nullishCoalesce(_chunkQJBJZVG6js.getToolExecuteInvocationId.call(void 0, ), () => ( _chunkQJBJZVG6js.beginToolExecuteCommand.call(void 0, )));
-  const client = new (0, _chunkKJFND3YTjs.DeeplineClient)();
+  const client = new (0, _chunkKGZRUGL7js.DeeplineClient)();
   let metadata;
   try {
     metadata = await _chunkQJBJZVG6js.runToolExecuteStage.call(void 0, 
@@ -2966,7 +2874,7 @@ async function executeTool(toolId, options) {
       );
       if (play) {
         if (wantsJson) {
-          _chunkD7SELX66js.printJsonError.call(void 0, 
+          _chunkERMXQOIVjs.printJsonError.call(void 0, 
             new Error(playAliasToolErrorMessage(parsed.toolId, play))
           );
         } else {
@@ -2979,7 +2887,7 @@ async function executeTool(toolId, options) {
   }
   if (isPlayLikeTool(metadata)) {
     if (wantsJson) {
-      _chunkD7SELX66js.printJsonError.call(void 0, 
+      _chunkERMXQOIVjs.printJsonError.call(void 0, 
         new Error(
           playLikeToolExecuteErrorMessage(
             parsed.toolId,
@@ -3015,7 +2923,7 @@ async function executeTool(toolId, options) {
       responseIntent,
       ...idempotencyKey ? { idempotencyKey } : {},
       ...parsed.recoveryTimeoutMs !== void 0 ? { recoveryTimeoutMs: parsed.recoveryTimeoutMs } : {},
-      searchRef: _chunkCRRVBNZDjs.recentSearchRef.call(void 0, ),
+      searchRef: _chunkLH3BV773js.recentSearchRef.call(void 0, ),
       cliInvocationId,
       onResponseReceived: _chunkMX53GIOBjs.recordApiResponse
     }).catch((error) => {
@@ -3055,8 +2963,8 @@ async function executeTool(toolId, options) {
   );
   const executeExitCode = toolExecuteExitCode(baseEnvelope);
   const delivered = await _chunkQJBJZVG6js.runToolExecuteStage.call(void 0, "output delivery", () => {
-    if (!parsed.outPath && (parsed.outputFormat === "json" || parsed.outputFormat === "auto" && _chunkD7SELX66js.shouldEmitJson.call(void 0, ))) {
-      _chunkD7SELX66js.printCommandEnvelope.call(void 0, baseEnvelope, { json: true });
+    if (!parsed.outPath && (parsed.outputFormat === "json" || parsed.outputFormat === "auto" && _chunkERMXQOIVjs.shouldEmitJson.call(void 0, ))) {
+      _chunkERMXQOIVjs.printCommandEnvelope.call(void 0, baseEnvelope, { json: true });
       return true;
     }
     if (parsed.outputFormat === "json_file") {
@@ -3064,7 +2972,7 @@ async function executeTool(toolId, options) {
         rawResponse,
         `payload_${parsed.toolId}`
       );
-      _chunkD7SELX66js.printCommandEnvelope.call(void 0, 
+      _chunkERMXQOIVjs.printCommandEnvelope.call(void 0, 
         {
           ...baseEnvelope,
           local: {
@@ -3086,7 +2994,7 @@ async function executeTool(toolId, options) {
           `${parsed.toolId} did not expose row-shaped output to write as CSV. ${inspection.inspectDescription} Run: ${inspection.inspect}`
         );
         if (wantsJson) {
-          _chunkD7SELX66js.printJsonError.call(void 0, error);
+          _chunkERMXQOIVjs.printJsonError.call(void 0, error);
         } else {
           console.error(error.message);
         }
@@ -3097,18 +3005,18 @@ async function executeTool(toolId, options) {
           rawResponse,
           `payload_${parsed.toolId}`
         );
-        _chunkD7SELX66js.printCommandEnvelope.call(void 0, 
+        _chunkERMXQOIVjs.printCommandEnvelope.call(void 0, 
           {
             ...baseEnvelope,
             local: {
               payload_file: jsonPath
             }
           },
-          { json: parsed.outputFormat === "csv_file" || _chunkD7SELX66js.shouldEmitJson.call(void 0, ) }
+          { json: parsed.outputFormat === "csv_file" || _chunkERMXQOIVjs.shouldEmitJson.call(void 0, ) }
         );
         return true;
       }
-      _chunkD7SELX66js.printCommandEnvelope.call(void 0, baseEnvelope, { json: false });
+      _chunkERMXQOIVjs.printCommandEnvelope.call(void 0, baseEnvelope, { json: false });
       return true;
     }
     const rowOutput = _chunkNXDRDJ4Kjs.projectRowOutput.call(void 0, listConversion);
@@ -3132,7 +3040,7 @@ async function executeTool(toolId, options) {
       seededScript
     });
     if (parsed.outputFormat === "csv_file") {
-      _chunkD7SELX66js.printCommandEnvelope.call(void 0, materializedEnvelope, { json: true });
+      _chunkERMXQOIVjs.printCommandEnvelope.call(void 0, materializedEnvelope, { json: true });
       return true;
     }
     if (parsed.outPath) {
@@ -3140,7 +3048,7 @@ async function executeTool(toolId, options) {
         toolId: parsed.toolId,
         idempotencyKey
       });
-      _chunkD7SELX66js.printCommandEnvelope.call(void 0, materializedEnvelope, {
+      _chunkERMXQOIVjs.printCommandEnvelope.call(void 0, materializedEnvelope, {
         json: wantsJson,
         text: `Wrote ${csv.rowCount} row(s) to ${csv.path}
 inspect: ${inspection.inspect}
@@ -3149,7 +3057,7 @@ inspect: ${inspection.inspect}
       return true;
     }
     if (parsed.noPreview) {
-      _chunkD7SELX66js.printCommandEnvelope.call(void 0, 
+      _chunkERMXQOIVjs.printCommandEnvelope.call(void 0, 
         {
           ...materializedEnvelope,
           local: {
@@ -3157,12 +3065,12 @@ inspect: ${inspection.inspect}
             output_path: csv.path
           }
         },
-        { json: _chunkD7SELX66js.shouldEmitJson.call(void 0, ), text: `${csv.path}
+        { json: _chunkERMXQOIVjs.shouldEmitJson.call(void 0, ), text: `${csv.path}
 ` }
       );
       return true;
     }
-    _chunkD7SELX66js.printCommandEnvelope.call(void 0, materializedEnvelope, { json: false });
+    _chunkERMXQOIVjs.printCommandEnvelope.call(void 0, materializedEnvelope, { json: false });
     return true;
   });
   if (delivered) {

package/dist/cli/{chunk-HEWGTHI2.mjs → chunk-RIT4UED6.mjs}

@@ -1,14 +1,14 @@
 import {
   DeeplineClient
-} from "./chunk-JNQECSK5.mjs";
+} from "./chunk-VUYCB2RY.mjs";
 import {
   printCommandEnvelope,
   renderCommandEnvelopeText
-} from "./chunk-K4V4FX76.mjs";
+} from "./chunk-EJC3INZD.mjs";
 import {
   resolveConfig,
   sdkCliStateDirPath
-} from "./chunk-OCX5D2WI.mjs";
+} from "./chunk-5IXQ6VP4.mjs";
 
 // src/cli/commands/search.ts
 import { Option } from "commander";
@@ -63,6 +63,109 @@ function formatTextTable(rows, columns) {
   }).split("\n").map((line) => line.trimEnd()).join("\n").trimEnd();
 }
 
+// src/cli/tool-description.ts
+function observedMaxText(pricing) {
+  const max = recordValue(recordValue(pricing).observedMax);
+  return typeof max.creditsPerCall === "number" && max.creditsPerCall > 0 ? `max observed ${max.creditsPerCall} credits/call (last ${String(max.windowDays)} days)` : "";
+}
+var Capability = class _Capability {
+  #catalogEntry;
+  constructor(catalogEntry) {
+    this.#catalogEntry = catalogEntry;
+  }
+  static fromCatalogEntry(catalogEntry) {
+    return new _Capability(catalogEntry);
+  }
+  describe() {
+    return CapabilityDescription.fromCatalogEntry(this.#catalogEntry);
+  }
+};
+var CapabilityDescription = class _CapabilityDescription {
+  #catalogEntry;
+  constructor(catalogEntry) {
+    this.#catalogEntry = catalogEntry;
+  }
+  static fromCatalogEntry(catalogEntry) {
+    return new _CapabilityDescription(catalogEntry);
+  }
+  /**
+   * The customer price already resolved by the catalog. This intentionally
+   * omits provider-price fields, even when a catalog Adapter carried them.
+   */
+  customerCost() {
+    const legacyCost = recordValue(this.#catalogEntry.cost);
+    const pricing = recordValue(this.#catalogEntry.pricing);
+    const unit = stringValue(pricing.unit);
+    const legacyPricingModel = stringValue(
+      legacyCost.pricingModel ?? legacyCost.pricing_model
+    );
+    const pricingModel = unit === "call" ? "fixed" : unit === "result" || unit === "page" ? `per_${unit}` : unit === "usage" ? "provider_usage" : legacyPricingModel;
+    const canonicalCredits = pricingNumber(
+      pricing,
+      "creditsPerUnit",
+      "credits_per_unit",
+      this.#catalogEntry.deeplineCreditsPerPricingUnit ?? this.#catalogEntry.deepline_credits_per_pricing_unit
+    );
+    const canonicalUsd = pricingNumber(
+      pricing,
+      "usdPerUnit",
+      "usd_per_unit",
+      this.#catalogEntry.deeplineUsdPerPricingUnit ?? this.#catalogEntry.deepline_usd_per_pricing_unit
+    );
+    const billingSource = stringValue(
+      this.#catalogEntry.billingSource ?? this.#catalogEntry.billing_source
+    );
+    const billingSourceLabel = stringValue(
+      this.#catalogEntry.billingSourceLabel ?? this.#catalogEntry.billing_source_label
+    );
+    const isFree = billingSource === "free";
+    return {
+      pricingModel: pricingModel || null,
+      unit: unit || null,
+      displayText: isFree ? "Free" : stringValue(pricing.displayText ?? pricing.display_text),
+      summary: isFree ? null : stringValue(pricing.summary),
+      billingMode: stringValue(
+        legacyCost.billingMode ?? legacyCost.billing_mode
+      ),
+      billingSource,
+      billingSourceLabel,
+      deeplineCreditsPerPricingUnit: isFree ? 0 : canonicalCredits,
+      deeplineUsdPerPricingUnit: isFree ? 0 : canonicalUsd,
+      ...pricing.estimatedRange && !isFree && billingSource !== "own_provider_credentials" ? {
+        estimatedRange: pricing.estimatedRange,
+        details: Array.isArray(pricing.details) ? pricing.details.filter(
+          (value) => typeof value === "string"
+        ) : []
+      } : {},
+      ...pricing.observedReference && !isFree && billingSource !== "own_provider_credentials" ? {
+        observedReference: pricing.observedReference,
+        details: Array.isArray(pricing.details) ? pricing.details.filter(
+          (value) => typeof value === "string"
+        ) : []
+      } : {},
+      ...pricing.observedMax && !isFree && billingSource !== "own_provider_credentials" ? {
+        observedMax: pricing.observedMax
+      } : {}
+    };
+  }
+};
+function recordValue(value) {
+  return value && typeof value === "object" && !Array.isArray(value) ? value : {};
+}
+function stringValue(value) {
+  return typeof value === "string" && value.trim() ? value : null;
+}
+function numberValue(value) {
+  return typeof value === "number" && Number.isFinite(value) ? value : null;
+}
+function pricingNumber(pricing, canonicalKey, aliasKey, legacyValue) {
+  for (const key of [canonicalKey, aliasKey]) {
+    if (Object.prototype.hasOwnProperty.call(pricing, key))
+      return numberValue(pricing[key]);
+  }
+  return numberValue(legacyValue);
+}
+
 // src/cli/search-output.ts
 function clipSummary(value) {
   const characters = Array.from(value.replace(/\s+/gu, " ").trim());
@@ -137,6 +240,9 @@ function rateLimitDisplay(item) {
 }
 function searchRow(item) {
   const { cost, notes } = pricingDisplay(item);
+  const observedMax = item.billingSource === "own_provider_credentials" ? "" : observedMaxText(item.pricing);
+  if (observedMax)
+    notes.push(`${observedMax[0].toUpperCase()}${observedMax.slice(1)}.`);
   if (item.credentialStatus === "requires_connection") {
     notes.push("Requires your credentials \u2014 not connected (connect to use).");
   } else if (item.connected === false && item.credentialStatus === "managed") {
@@ -362,6 +468,8 @@ Examples:
 
 export {
   recentSearchRef,
+  observedMaxText,
+  Capability,
   SEARCH_TYPES,
   parseTypes,
   appendCsv,

package/dist/cli/{chunk-W2LUUB3U.mjs → chunk-SDOPEZYS.mjs}

@@ -1,17 +1,17 @@
 import {
   npmSupportsAllowScripts,
   readNpmVersion
-} from "./chunk-3Y3N7WQO.mjs";
+} from "./chunk-U5VEW7LL.mjs";
 import {
   resolveShellSpawn,
   runSkillsCommand
-} from "./chunk-GXRUBTXZ.mjs";
+} from "./chunk-YCLPW7QO.mjs";
 import {
   printCommandEnvelope
-} from "./chunk-K4V4FX76.mjs";
+} from "./chunk-EJC3INZD.mjs";
 import {
   autoDetectBaseUrl
-} from "./chunk-OCX5D2WI.mjs";
+} from "./chunk-5IXQ6VP4.mjs";
 
 // src/cli/commands/update.ts
 import { spawn, spawnSync } from "child_process";