deepline 0.3.367 → 0.3.369

package/dist/cli/{chunk-GD2VVYGB.mjs → chunk-4RVNJQ7D.mjs}

@@ -49,7 +49,7 @@ var SDK_RELEASE = {
   // getters keep their established compatibility behavior.
   // 0.3.1 deprecated the legacy `deepline enrich` command in favor of Plays.
   // 0.3.90 is the first deliberately versioned SDK release for API v3.
-  version: "0.3.367",
+  version: "0.3.369",
   updateSummary: "Play grep now returns concise results with the matched fields and terms. Automatic CLI updates are enabled by default; use `deepline settings autoupdate off` to opt out, `deepline settings autoupdate on` to re-enable updates, or `deepline settings autoupdate pin <version>` to hold an exact release.",
   packageCapabilities: {
     updatePreferences: 1
@@ -93,6 +93,11 @@ var SDK_RELEASE = {
         introducedIn: "0.3.91",
         reason: "deepline search was added in SDK CLI 0.3.91 as the one search across tools, monitors, and plays. On an older version run deepline tools search or deepline plays search, or update."
       },
+      {
+        command: "describe",
+        introducedIn: "0.3.312",
+        reason: "deepline describe was added in SDK CLI 0.3.312 as the one describe for tools, monitor types, and plays. On an older version run deepline tools describe or deepline plays describe, or update."
+      },
       {
         command: "notifications",
         introducedIn: "0.2.40",

package/dist/cli/{chunk-OCX5D2WI.mjs → chunk-5IXQ6VP4.mjs}

@@ -14,7 +14,7 @@ import {
 } from "./chunk-NXGCO4JB.mjs";
 import {
   SDK_RELEASE
-} from "./chunk-GD2VVYGB.mjs";
+} from "./chunk-4RVNJQ7D.mjs";
 
 // src/errors.ts
 var CustomerDbQueryOutcomeUnknownError = class extends DeeplineError {

package/dist/cli/{chunk-AVSPBILZ.js → chunk-6A3GNWSU.js}

@@ -1,10 +1,10 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _nullishCoalesce(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return rhsFn(); } } function _optionalChain(ops) { let lastAccessLHS = undefined; let value = ops[0]; let i = 1; while (i < ops.length) { const op = ops[i]; const fn = ops[i + 1]; i += 2; if ((op === 'optionalAccess' || op === 'optionalCall') && value == null) { return undefined; } if (op === 'access' || op === 'optionalAccess') { lastAccessLHS = value; value = fn(value); } else if (op === 'call' || op === 'optionalCall') { value = fn((...args) => value.call(lastAccessLHS, ...args)); lastAccessLHS = undefined; } } return value; }
 
 
-var _chunkD7SELX66js = require('./chunk-D7SELX66.js');
+var _chunkERMXQOIVjs = require('./chunk-ERMXQOIV.js');
 
 
-var _chunkR2HHZLOPjs = require('./chunk-R2HHZLOP.js');
+var _chunk2AENFV3Bjs = require('./chunk-2AENFV3B.js');
 
 // src/cli/commands/sessions.ts
 
@@ -139,7 +139,7 @@ function currentSessionFile(agent) {
   const newestFirst = listSessionFiles(agent).sort(
     (a, b) => b.mtimeMs - a.mtimeMs
   );
-  const sessionId = _chunkR2HHZLOPjs.agentSessionIdFromEnvironment.call(void 0, );
+  const sessionId = _chunk2AENFV3Bjs.agentSessionIdFromEnvironment.call(void 0, );
   const cwd = process.cwd();
   return _nullishCoalesce(_nullishCoalesce(_nullishCoalesce(newestFirst.find((candidate) => candidate.sessionId === sessionId), () => ( newestFirst.find(
     (candidate) => sessionStartedInDirectory(candidate, cwd)
@@ -448,7 +448,7 @@ function buildSessionUploadContent(raw) {
   return { encodedContent: encoded, needsChunking: true };
 }
 async function uploadPayload(path, payload) {
-  const { http } = _chunkD7SELX66js.getAuthedHttpClient.call(void 0, );
+  const { http } = _chunkERMXQOIVjs.getAuthedHttpClient.call(void 0, );
   return await http.post(path, payload);
 }
 async function uploadChunkedSessions(sessions, options) {
@@ -481,7 +481,7 @@ async function uploadChunkedSessions(sessions, options) {
     ...options.rating ? { rating: options.rating } : {}
   });
   const sessionIds = sessions.map((session) => session.sessionId);
-  _chunkD7SELX66js.printCommandEnvelope.call(void 0, 
+  _chunkERMXQOIVjs.printCommandEnvelope.call(void 0, 
     {
       ...response,
       ok: true,
@@ -513,7 +513,7 @@ async function handleSessionsSend(options) {
       filename: _path.basename.call(void 0, filePath),
       ...rating ? { rating } : {}
     });
-    _chunkD7SELX66js.printCommandEnvelope.call(void 0, 
+    _chunkERMXQOIVjs.printCommandEnvelope.call(void 0, 
       {
         ...response2,
         ok: true,
@@ -563,7 +563,7 @@ async function handleSessionsSend(options) {
     ...rating ? { rating } : {}
   });
   const sessionIds = built.map((session) => session.sessionId);
-  _chunkD7SELX66js.printCommandEnvelope.call(void 0, 
+  _chunkERMXQOIVjs.printCommandEnvelope.call(void 0, 
     {
       ...response,
       ok: true,
@@ -671,7 +671,7 @@ ${refreshMeta}
 </body>
 </html>`;
   _fs.writeFileSync.call(void 0, outputPath, html, "utf8");
-  _chunkD7SELX66js.printCommandEnvelope.call(void 0, 
+  _chunkERMXQOIVjs.printCommandEnvelope.call(void 0, 
     {
       ok: true,
       file: outputPath,

package/dist/cli/{chunk-Z35CB3I5.js → chunk-74XTRGY5.js}

@@ -1,6 +1,6 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _nullishCoalesce(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return rhsFn(); } } function _optionalChain(ops) { let lastAccessLHS = undefined; let value = ops[0]; let i = 1; while (i < ops.length) { const op = ops[i]; const fn = ops[i + 1]; i += 2; if ((op === 'optionalAccess' || op === 'optionalCall') && value == null) { return undefined; } if (op === 'access' || op === 'optionalAccess') { lastAccessLHS = value; value = fn(value); } else if (op === 'call' || op === 'optionalCall') { value = fn((...args) => value.call(lastAccessLHS, ...args)); lastAccessLHS = undefined; } } return value; }
 
-var _chunk3BZR22CZjs = require('./chunk-3BZR22CZ.js');
+var _chunkOEQC4QLUjs = require('./chunk-OEQC4QLU.js');
 
 // src/cli/npm-script-policy.ts
 var _child_process = require('child_process');
@@ -13,7 +13,7 @@ function npmSupportsAllowScripts(version) {
 }
 function readNpmVersion(env) {
   try {
-    const plan = _chunk3BZR22CZjs.resolveShellSpawn.call(void 0, "npm", ["--version"], process.platform, env);
+    const plan = _chunkOEQC4QLUjs.resolveShellSpawn.call(void 0, "npm", ["--version"], process.platform, env);
     const result = _child_process.spawnSync.call(void 0, plan.command, plan.args, {
       encoding: "utf8",
       env,

package/dist/cli/{chunk-6DRGO4CB.mjs → chunk-COEBGYBW.mjs}

@@ -19,11 +19,11 @@ import {
 } from "./chunk-EDWJY6T4.mjs";
 import {
   registerDeprecatedSearchCommand
-} from "./chunk-HEWGTHI2.mjs";
+} from "./chunk-RIT4UED6.mjs";
 import {
   handleDeploymentGet,
   handleDeploymentsList
-} from "./chunk-DIDYT2TH.mjs";
+} from "./chunk-TRRFXE4X.mjs";
 import {
   pinLocalPlayImports,
   planLocalPlayExecution
@@ -42,7 +42,7 @@ import {
   normalizeRunEventOperationRequest,
   parseLogLevel,
   playInputExampleArgs
-} from "./chunk-JNQECSK5.mjs";
+} from "./chunk-VUYCB2RY.mjs";
 import {
   CSV_DATA_INPUT_KEY,
   buildNamedPlayRunRequest,
@@ -75,10 +75,10 @@ import {
   printJsonError,
   renderCommandEnvelopeText,
   shouldEmitJson
-} from "./chunk-K4V4FX76.mjs";
+} from "./chunk-EJC3INZD.mjs";
 import {
   fetchWithDeploymentProtection
-} from "./chunk-OCX5D2WI.mjs";
+} from "./chunk-5IXQ6VP4.mjs";
 import {
   DeeplineError
 } from "./chunk-NXGCO4JB.mjs";
@@ -16476,7 +16476,7 @@ Examples:
         process.exitCode = await ownView();
         return;
       }
-      const { describeAnything } = await import("./describe-RYXCBLJG.mjs");
+      const { describeAnything } = await import("./describe-L6LADCXI.mjs");
       process.exitCode = await describeAnything(
         name,
         {

package/dist/cli/{chunk-K4V4FX76.mjs → chunk-EJC3INZD.mjs}

@@ -3,7 +3,7 @@ import {
   detectAgentRuntime,
   resolveCliCommandContext,
   resolveConfig
-} from "./chunk-OCX5D2WI.mjs";
+} from "./chunk-5IXQ6VP4.mjs";
 import {
   DeeplineError
 } from "./chunk-NXGCO4JB.mjs";

package/dist/cli/{chunk-D7SELX66.js → chunk-ERMXQOIV.js}

@@ -3,7 +3,7 @@
 
 
 
-var _chunkR2HHZLOPjs = require('./chunk-R2HHZLOP.js');
+var _chunk2AENFV3Bjs = require('./chunk-2AENFV3B.js');
 
 
 var _chunk7P5AA3SNjs = require('./chunk-7P5AA3SN.js');
@@ -225,8 +225,8 @@ var BROWSER_OPEN_COOLDOWN_MS = 3e4;
 var SAME_URL_BROWSER_OPEN_COOLDOWN_MS = 5 * 6e4;
 var defaultBrowserCommandRunner = childProcess;
 function getAuthedHttpClient() {
-  const config = _chunkR2HHZLOPjs.resolveConfig.call(void 0, );
-  return { config, http: new (0, _chunkR2HHZLOPjs.HttpClient)(config) };
+  const config = _chunk2AENFV3Bjs.resolveConfig.call(void 0, );
+  return { config, http: new (0, _chunk2AENFV3Bjs.HttpClient)(config) };
 }
 function stableOsUserId() {
   try {
@@ -566,7 +566,7 @@ function collectLocalEnvInfo() {
     os: `${process.platform} ${process.arch}`,
     node_version: process.version,
     home_dir: homeDir,
-    agent_runtime: _chunkR2HHZLOPjs.detectAgentRuntime.call(void 0, )
+    agent_runtime: _chunk2AENFV3Bjs.detectAgentRuntime.call(void 0, )
   };
   const env = process.env;
   const optional = {
@@ -813,9 +813,9 @@ function markdownTableFromRows(rows, preferredColumns = []) {
 }
 function withAgentCommandContext(value) {
   const valueRecord = value !== null && typeof value === "object" && !Array.isArray(value) ? value : null;
-  return _chunkR2HHZLOPjs.detectAgentRuntime.call(void 0, ) !== "unknown" && valueRecord && !Object.prototype.hasOwnProperty.call(valueRecord, "command_context") ? {
+  return _chunk2AENFV3Bjs.detectAgentRuntime.call(void 0, ) !== "unknown" && valueRecord && !Object.prototype.hasOwnProperty.call(valueRecord, "command_context") ? {
     ...valueRecord,
-    command_context: _chunkR2HHZLOPjs.resolveCliCommandContext.call(void 0, )
+    command_context: _chunk2AENFV3Bjs.resolveCliCommandContext.call(void 0, )
   } : value;
 }
 function printJson(value, fields) {

package/dist/cli/{chunk-5NVMNFCG.js → chunk-FXVRQHJC.js}

@@ -1,17 +1,17 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _nullishCoalesce(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return rhsFn(); } } function _optionalChain(ops) { let lastAccessLHS = undefined; let value = ops[0]; let i = 1; while (i < ops.length) { const op = ops[i]; const fn = ops[i + 1]; i += 2; if ((op === 'optionalAccess' || op === 'optionalCall') && value == null) { return undefined; } if (op === 'access' || op === 'optionalAccess') { lastAccessLHS = value; value = fn(value); } else if (op === 'call' || op === 'optionalCall') { value = fn((...args) => value.call(lastAccessLHS, ...args)); lastAccessLHS = undefined; } } return value; }
 
 
-var _chunkZ35CB3I5js = require('./chunk-Z35CB3I5.js');
+var _chunk74XTRGY5js = require('./chunk-74XTRGY5.js');
 
 
 
-var _chunk3BZR22CZjs = require('./chunk-3BZR22CZ.js');
+var _chunkOEQC4QLUjs = require('./chunk-OEQC4QLU.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');
 
 // src/cli/commands/update.ts
 var _child_process = require('child_process');
@@ -489,7 +489,7 @@ function normalizedNpmPrefix(value) {
 }
 function resolveNpmGlobalPrefix(env) {
   try {
-    const plan = _chunk3BZR22CZjs.resolveShellSpawn.call(void 0, "npm", ["prefix", "-g"], process.platform, env);
+    const plan = _chunkOEQC4QLUjs.resolveShellSpawn.call(void 0, "npm", ["prefix", "-g"], process.platform, env);
     const result = _child_process.spawnSync.call(void 0, plan.command, plan.args, {
       encoding: "utf8",
       env,
@@ -545,8 +545,8 @@ function resolveUpdatePlan(options = {}) {
   const npmGlobalPrefix = options.npmGlobalPrefix !== void 0 ? options.npmGlobalPrefix : resolveNpmGlobalPrefix(env);
   const hasVerifiedNpmOwnership = inferredInstallPrefix !== null && normalizedNpmPrefix(inferredInstallPrefix) === normalizedNpmPrefix(npmGlobalPrefix);
   const installPrefix = options.requireVerifiedNpmOwnership ? hasVerifiedNpmOwnership ? inferredInstallPrefix : null : inferredInstallPrefix;
-  const npmVersion = options.npmVersion === void 0 ? _chunkZ35CB3I5js.readNpmVersion.call(void 0, env) : options.npmVersion;
-  const npmGlobalInstallFlags = _chunkZ35CB3I5js.npmSupportsAllowScripts.call(void 0, npmVersion) ? [...NPM_SDK_INSTALL_COMMON_FLAGS, "--allow-scripts=esbuild"] : NPM_SDK_INSTALL_COMMON_FLAGS;
+  const npmVersion = options.npmVersion === void 0 ? _chunk74XTRGY5js.readNpmVersion.call(void 0, env) : options.npmVersion;
+  const npmGlobalInstallFlags = _chunk74XTRGY5js.npmSupportsAllowScripts.call(void 0, npmVersion) ? [...NPM_SDK_INSTALL_COMMON_FLAGS, "--allow-scripts=esbuild"] : NPM_SDK_INSTALL_COMMON_FLAGS;
   const args = installPrefix ? [
     "install",
     "-g",
@@ -556,7 +556,7 @@ function resolveUpdatePlan(options = {}) {
     packageSpec
   ] : ["install", "-g", ...npmGlobalInstallFlags, packageSpec];
   const fallbackRegistryUrl = options.npmFallbackRegistryUrl !== void 0 ? options.npmFallbackRegistryUrl : publicNpmFallbackRegistryUrl(
-    _optionalChain([env, 'access', _18 => _18.DEEPLINE_HOST_URL, 'optionalAccess', _19 => _19.trim, 'call', _20 => _20()]) || _chunkR2HHZLOPjs.autoDetectBaseUrl.call(void 0, )
+    _optionalChain([env, 'access', _18 => _18.DEEPLINE_HOST_URL, 'optionalAccess', _19 => _19.trim, 'call', _20 => _20()]) || _chunk2AENFV3Bjs.autoDetectBaseUrl.call(void 0, )
   );
   return {
     kind: "npm-global",
@@ -703,7 +703,7 @@ function sidecarInstallFailure(versionDir) {
 function runCommand(command, args, env = process.env) {
   return new Promise((resolveResult) => {
     let output = "";
-    const plan = _chunk3BZR22CZjs.resolveShellSpawn.call(void 0, command, args, process.platform, env);
+    const plan = _chunkOEQC4QLUjs.resolveShellSpawn.call(void 0, command, args, process.platform, env);
     const child = _child_process.spawn.call(void 0, plan.command, plan.args, {
       stdio: ["inherit", "pipe", "pipe"],
       shell: plan.shell,
@@ -1079,14 +1079,14 @@ async function publishedVersionSupportsPin(version, fallbackRegistryUrl) {
   throw _nullishCoalesce(lastError, () => ( new Error("No npm registry was available")));
 }
 async function runUpdateCommand(options, dependencies = {}) {
-  const detectBaseUrl = _nullishCoalesce(dependencies.detectBaseUrl, () => ( _chunkR2HHZLOPjs.autoDetectBaseUrl));
+  const detectBaseUrl = _nullishCoalesce(dependencies.detectBaseUrl, () => ( _chunk2AENFV3Bjs.autoDetectBaseUrl));
   const resolvePlan = _nullishCoalesce(dependencies.resolvePlan, () => ( resolveUpdatePlan));
   const runPlan = _nullishCoalesce(dependencies.runPlan, () => ( runUpdatePlan));
   const syncSkills = _nullishCoalesce(dependencies.syncSkillsIfNeeded, () => ( (async () => {
     const originalWrite = process.stdout.write.bind(process.stdout);
     process.stdout.write = (() => true);
     try {
-      const exitCode = await _chunk3BZR22CZjs.runSkillsCommand.call(void 0, { json: true });
+      const exitCode = await _chunkOEQC4QLUjs.runSkillsCommand.call(void 0, { json: true });
       if (exitCode !== 0) {
         throw new Error(
           `Deepline skills update failed with exit ${exitCode}.`
@@ -1157,11 +1157,11 @@ async function runUpdateCommand(options, dependencies = {}) {
     ]
   };
   if (options.json && !options.executeWithJson) {
-    _chunkD7SELX66js.printCommandEnvelope.call(void 0, { ...plan, render }, { json: true });
+    _chunkERMXQOIVjs.printCommandEnvelope.call(void 0, { ...plan, render }, { json: true });
     return 0;
   }
   if (options.printCommand) {
-    _chunkD7SELX66js.printCommandEnvelope.call(void 0, 
+    _chunkERMXQOIVjs.printCommandEnvelope.call(void 0, 
       {
         ...plan,
         render: {
@@ -1174,7 +1174,7 @@ async function runUpdateCommand(options, dependencies = {}) {
     return 0;
   }
   if (plan.kind === "source" || plan.kind === "homebrew") {
-    _chunkD7SELX66js.printCommandEnvelope.call(void 0, { ...plan, render }, { json: false });
+    _chunkERMXQOIVjs.printCommandEnvelope.call(void 0, { ...plan, render }, { json: false });
     return 0;
   }
   stderr.write(`Updating Deepline SDK/CLI with: ${plan.manualCommand}
@@ -1204,7 +1204,7 @@ To retry with full installer output, run: deepline skills --json
     );
   }
   if (options.executeWithJson && options.json) {
-    _chunkD7SELX66js.printCommandEnvelope.call(void 0, 
+    _chunkERMXQOIVjs.printCommandEnvelope.call(void 0, 
       {
         ok: true,
         pinnedVersion

package/dist/cli/{chunk-3ZO2O2LE.mjs → chunk-H4N6FMJ5.mjs}

@@ -2,7 +2,7 @@ import {
   argsWantJson,
   openInBrowser,
   printCommandEnvelope
-} from "./chunk-K4V4FX76.mjs";
+} from "./chunk-EJC3INZD.mjs";
 import {
   ACTIVE_ORG_ID_ENV,
   ACTIVE_ORG_NAME_ENV,
@@ -25,7 +25,7 @@ import {
   saveHostEnvValues,
   saveProjectDeeplineEnvValues,
   storedHostApiKey
-} from "./chunk-OCX5D2WI.mjs";
+} from "./chunk-5IXQ6VP4.mjs";
 
 // src/cli/commands/auth.ts
 import {

package/dist/cli/{chunk-BBQ5IWRX.mjs → chunk-JGLIB4JN.mjs}

@@ -9,9 +9,11 @@ import {
   shellQuote
 } from "./chunk-OVDNJAJN.mjs";
 import {
+  Capability,
+  observedMaxText,
   recentSearchRef,
   registerDeprecatedSearchCommand
-} from "./chunk-HEWGTHI2.mjs";
+} from "./chunk-RIT4UED6.mjs";
 import {
   extractSummaryFields,
   projectRowOutput,
@@ -26,7 +28,7 @@ import {
 import {
   DeeplineClient,
   validateExecutionIdempotencyKey
-} from "./chunk-JNQECSK5.mjs";
+} from "./chunk-VUYCB2RY.mjs";
 import {
   beginToolExecuteCommand,
   getToolExecuteInvocationId,
@@ -40,11 +42,11 @@ import {
   printJsonError,
   renderCommandEnvelopeText,
   shouldEmitJson
-} from "./chunk-K4V4FX76.mjs";
+} from "./chunk-EJC3INZD.mjs";
 import {
   resolveConfig,
   sdkCliStateDirPath
-} from "./chunk-OCX5D2WI.mjs";
+} from "./chunk-5IXQ6VP4.mjs";
 import {
   DeeplineError
 } from "./chunk-NXGCO4JB.mjs";
@@ -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(
-      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"
-        ) : []
-      } : {}
-    };
-  }
-};
-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") {
@@ -1030,7 +936,7 @@ Examples:
         process.exitCode = await narrowView();
         return;
       }
-      const { describeAnything } = await import("./describe-RYXCBLJG.mjs");
+      const { describeAnything } = await import("./describe-L6LADCXI.mjs");
       process.exitCode = await describeAnything(
         toolId,
         { ...options, kinds: ["tools", "monitors"], fetchedTool: metadata },
@@ -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})`,
+      observedMaxText(cost) && `\u2014 ${observedMaxText(cost)}`
     ].filter(Boolean).join(" ") || void 0,
     guidance: [
       ...contract.deprecated === true ? [`Deprecated. ${stringField2(deprecation, "message")}`.trim()] : [],
@@ -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 [
     `${options.heading ?? `Pricing: ${toolId}`}: ${price}`,
+    ...observedMaxText(cost) ? [`  ${observedMaxText(cost)}`] : [],
     ...cost.observedReference || cost.estimatedRange ? [
       ...summary ? [`  ${summary}`] : [],
       ...(cost.details ?? []).map((detail) => `  ${detail}`)

package/dist/cli/{chunk-KJFND3YT.js → chunk-KGZRUGL7.js}

@@ -21,7 +21,7 @@ var _chunkLA46MMTLjs = require('./chunk-LA46MMTL.js');
 
 
 
-var _chunkR2HHZLOPjs = require('./chunk-R2HHZLOP.js');
+var _chunk2AENFV3Bjs = require('./chunk-2AENFV3B.js');
 
 
 
@@ -167,7 +167,7 @@ async function queryCustomerDatabase(http, input) {
     if (error instanceof _chunk7P5AA3SNjs.DeeplineError && (_optionalChain([error, 'access', _2 => _2.code, 'optionalAccess', _3 => _3.startsWith, 'call', _4 => _4("NETWORK_")]) || // Older API readers return PostgreSQL errors as HTTP 400, including
     // lost connections and explicitly unknown transaction resolution.
     /^08[A-Z0-9]{3}$/.test(_nullishCoalesce(error.code, () => ( ""))) || ["57P01", "57P02", "57P03"].includes(_nullishCoalesce(error.code, () => ( ""))) || error.statusCode === 408 || (_nullishCoalesce(error.statusCode, () => ( 0))) >= 500)) {
-      throw new (0, _chunkR2HHZLOPjs.CustomerDbQueryOutcomeUnknownError)(
+      throw new (0, _chunk2AENFV3Bjs.CustomerDbQueryOutcomeUnknownError)(
         error,
         plan.request.body.operation_key
       );
@@ -175,7 +175,7 @@ async function queryCustomerDatabase(http, input) {
     throw error;
   }
   if (!result || typeof result !== "object" || Array.isArray(result) || typeof result.command !== "string" || !Array.isArray(result.columns) || !Array.isArray(result.rows) || typeof result.truncated !== "boolean" || result.row_count !== null && (!Number.isSafeInteger(result.row_count) || result.row_count < 0) || !Number.isSafeInteger(result.row_count_returned) || result.row_count_returned < 0) {
-    throw new (0, _chunkR2HHZLOPjs.CustomerDbQueryOutcomeUnknownError)(
+    throw new (0, _chunk2AENFV3Bjs.CustomerDbQueryOutcomeUnknownError)(
       new (0, _chunk7P5AA3SNjs.DeeplineError)(
         "The SQL response did not contain a valid result.",
         200,
@@ -186,7 +186,7 @@ async function queryCustomerDatabase(http, input) {
   }
   const operation = result.operation;
   if (input.operationKey !== void 0 && (!operation || operation.operation_key !== input.operationKey || !Number.isSafeInteger(operation.completed_at_ms) || operation.completed_at_ms < 0 || !["executed", "operation_recovery"].includes(operation.source))) {
-    throw new (0, _chunkR2HHZLOPjs.CustomerDbQueryOutcomeUnknownError)(
+    throw new (0, _chunk2AENFV3Bjs.CustomerDbQueryOutcomeUnknownError)(
       new (0, _chunk7P5AA3SNjs.DeeplineError)(
         "The server did not confirm the original atomic SQL operation.",
         200,
@@ -2910,8 +2910,8 @@ function runtimeSelectionHeaders(runtime) {
   }
   const receivers = _optionalChain([process, 'access', _104 => _104.env, 'access', _105 => _105.DEEPLINE_RUNTIME_RETAINED_PIPELINE_RECEIVERS, 'optionalAccess', _106 => _106.trim, 'call', _107 => _107()]);
   return {
-    [_chunkR2HHZLOPjs.RUNTIME_ENVIRONMENT_TOKEN_HEADER]: token,
-    ...receivers ? { [_chunkR2HHZLOPjs.RETAINED_PIPELINE_RECEIVERS_HEADER]: receivers } : {}
+    [_chunk2AENFV3Bjs.RUNTIME_ENVIRONMENT_TOKEN_HEADER]: token,
+    ...receivers ? { [_chunk2AENFV3Bjs.RETAINED_PIPELINE_RECEIVERS_HEADER]: receivers } : {}
   };
 }
 function isolatedCiRuntimeEventReadHeaders() {
@@ -2927,7 +2927,7 @@ function isolatedCiRuntimeEventReadHeaders() {
       "RUNTIME_EVENT_INTERNAL_TOKEN_REQUIRED"
     );
   }
-  return { [_chunkR2HHZLOPjs.COORDINATOR_INTERNAL_TOKEN_HEADER]: token };
+  return { [_chunk2AENFV3Bjs.COORDINATOR_INTERNAL_TOKEN_HEADER]: token };
 }
 function normalizeTestPolicyOverrides(value, source) {
   if (value && typeof value === "object" && !Array.isArray(value)) {
@@ -3217,8 +3217,8 @@ var DeeplineClient = (_class = class _DeeplineClient {
    * @throws {@link ConfigError} if no API key can be resolved from any source.
    */
   constructor(options) {
-    this.config = _chunkR2HHZLOPjs.resolveConfig.call(void 0, options);
-    this.http = new (0, _chunkR2HHZLOPjs.HttpClient)(this.config);
+    this.config = _chunk2AENFV3Bjs.resolveConfig.call(void 0, options);
+    this.http = new (0, _chunk2AENFV3Bjs.HttpClient)(this.config);
     this.toolCalls = new ToolCalls(
       this.http,
       this.config.timeout,

package/dist/cli/{chunk-B7JTGFDS.js → chunk-KR5NWPWI.js}

@@ -49,7 +49,7 @@ var SDK_RELEASE = {
   // getters keep their established compatibility behavior.
   // 0.3.1 deprecated the legacy `deepline enrich` command in favor of Plays.
   // 0.3.90 is the first deliberately versioned SDK release for API v3.
-  version: "0.3.367",
+  version: "0.3.369",
   updateSummary: "Play grep now returns concise results with the matched fields and terms. Automatic CLI updates are enabled by default; use `deepline settings autoupdate off` to opt out, `deepline settings autoupdate on` to re-enable updates, or `deepline settings autoupdate pin <version>` to hold an exact release.",
   packageCapabilities: {
     updatePreferences: 1
@@ -93,6 +93,11 @@ var SDK_RELEASE = {
         introducedIn: "0.3.91",
         reason: "deepline search was added in SDK CLI 0.3.91 as the one search across tools, monitors, and plays. On an older version run deepline tools search or deepline plays search, or update."
       },
+      {
+        command: "describe",
+        introducedIn: "0.3.312",
+        reason: "deepline describe was added in SDK CLI 0.3.312 as the one describe for tools, monitor types, and plays. On an older version run deepline tools describe or deepline plays describe, or update."
+      },
       {
         command: "notifications",
         introducedIn: "0.2.40",

package/dist/cli/{chunk-LDSBBKSM.mjs → chunk-KU4X5TWN.mjs}

@@ -1,10 +1,10 @@
 import {
   getAuthedHttpClient,
   printCommandEnvelope
-} from "./chunk-K4V4FX76.mjs";
+} from "./chunk-EJC3INZD.mjs";
 import {
   agentSessionIdFromEnvironment
-} from "./chunk-OCX5D2WI.mjs";
+} from "./chunk-5IXQ6VP4.mjs";
 
 // src/cli/commands/sessions.ts
 import {