deepline 0.3.396 → 0.3.397

package/dist/cli/{chunk-KAEZNPUM.js → chunk-PSGEDGLT.js}

@@ -1,14 +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 _chunkWQJJNIMQjs = require('./chunk-WQJJNIMQ.js');
+var _chunkZM2YPJQJjs = require('./chunk-ZM2YPJQJ.js');
 
 
+var _chunkUVXBVUZQjs = require('./chunk-UVXBVUZQ.js');
 
-var _chunkRTO5QZWTjs = require('./chunk-RTO5QZWT.js');
 
 
+var _chunkDQ65ZVHNjs = require('./chunk-DQ65ZVHN.js');
 
-var _chunkV7UP2F4Ujs = require('./chunk-V7UP2F4U.js');
+
+
+var _chunkRYW4HPSMjs = require('./chunk-RYW4HPSM.js');
 
 // src/cli/commands/search.ts
 var _commander = require('commander');
@@ -18,7 +21,7 @@ var _fs = require('fs');
 var _path = require('path');
 var SEARCH_REF_TTL_MS = 15 * 6e4;
 function lastSearchPath() {
-  return _path.join.call(void 0, _chunkV7UP2F4Ujs.sdkCliStateDirPath.call(void 0, _chunkV7UP2F4Ujs.resolveConfig.call(void 0, ).baseUrl), "last-search.json");
+  return _path.join.call(void 0, _chunkRYW4HPSMjs.sdkCliStateDirPath.call(void 0, _chunkRYW4HPSMjs.resolveConfig.call(void 0, ).baseUrl), "last-search.json");
 }
 function rememberSearchRef(searchRef) {
   try {
@@ -63,109 +66,6 @@ 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(
-      _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"
-        ) : []
-      } : {},
-      ...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());
@@ -245,7 +145,7 @@ function failureRateDisplay(rate) {
 }
 function searchRow(item) {
   const { cost, notes } = pricingDisplay(item);
-  const observedMax = item.billingSource === "own_provider_credentials" ? "" : observedMaxText(item.pricing);
+  const observedMax = item.billingSource === "own_provider_credentials" ? "" : _chunkZM2YPJQJjs.observedMaxText.call(void 0, item.pricing);
   if (observedMax)
     notes.push(`${observedMax[0].toUpperCase()}${observedMax.slice(1)}.`);
   if (item.credentialStatus === "requires_connection") {
@@ -267,7 +167,7 @@ function searchRow(item) {
 }
 function renderSearchResults(result) {
   if (result.results.length === 0)
-    return _chunkRTO5QZWTjs.renderCommandEnvelopeText.call(void 0, result);
+    return _chunkDQ65ZVHNjs.renderCommandEnvelopeText.call(void 0, result);
   const rows = result.results.map(searchRow);
   const kinds = new Set(rows.map((row) => row.kind));
   const onlyTools = kinds.size === 1 && kinds.has("tool");
@@ -298,7 +198,7 @@ function renderSearchResults(result) {
     actions: _optionalChain([render, 'optionalAccess', _11 => _11.actions])
   };
   const followUps = _optionalChain([remaining, 'access', _12 => _12.sections, 'optionalAccess', _13 => _13.length]) || _optionalChain([remaining, 'access', _14 => _14.actions, 'optionalAccess', _15 => _15.length]) ? `
-${_chunkRTO5QZWTjs.renderCommandEnvelopeText.call(void 0, { render: remaining })}` : "";
+${_chunkDQ65ZVHNjs.renderCommandEnvelopeText.call(void 0, { render: remaining })}` : "";
   const notes = rows.flatMap(
     (row) => row.notes.map((note) => `  ${row.id}: ${note}`)
   );
@@ -375,7 +275,7 @@ async function runSearch(queryInput, options, types, exclude = []) {
     console.error(USAGE);
     return 1;
   }
-  const { search_ref: searchRef, ...result } = await new (0, _chunkWQJJNIMQjs.DeeplineClient)().search({
+  const { search_ref: searchRef, ...result } = await new (0, _chunkUVXBVUZQjs.DeeplineClient)().search({
     query,
     types,
     exclude,
@@ -389,7 +289,7 @@ async function runSearch(queryInput, options, types, exclude = []) {
   });
   if (searchRef) rememberSearchRef(searchRef);
   pointAtDescribe(result);
-  _chunkRTO5QZWTjs.printCommandEnvelope.call(void 0, result, {
+  _chunkDQ65ZVHNjs.printCommandEnvelope.call(void 0, result, {
     json: options.json === true,
     text: renderSearchResults(result)
   });
@@ -489,6 +389,4 @@ Examples:
 
 
 
-
-
-exports.recentSearchRef = recentSearchRef; exports.observedMaxText = observedMaxText; exports.Capability = Capability; exports.SEARCH_TYPES = SEARCH_TYPES; exports.parseTypes = parseTypes; exports.appendCsv = appendCsv; exports.pointAtDescribe = pointAtDescribe; exports.registerDeprecatedSearchCommand = registerDeprecatedSearchCommand; exports.registerSearchCommand = registerSearchCommand;
+exports.recentSearchRef = recentSearchRef; exports.SEARCH_TYPES = SEARCH_TYPES; exports.parseTypes = parseTypes; exports.appendCsv = appendCsv; exports.pointAtDescribe = pointAtDescribe; exports.registerDeprecatedSearchCommand = registerDeprecatedSearchCommand; exports.registerSearchCommand = registerSearchCommand;

package/dist/cli/chunk-Q2E4E4FJ.js

@@ -0,0 +1,112 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _nullishCoalesce(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return rhsFn(); } } var _class;
+
+
+
+
+var _chunk7P5AA3SNjs = require('./chunk-7P5AA3SN.js');
+
+// src/errors.ts
+var CustomerDbQueryOutcomeUnknownError = (_class = class extends _chunk7P5AA3SNjs.DeeplineError {
+  __init() {this.outcome = "unknown"}
+  
+  
+  constructor(cause, operationKey, options = {}) {
+    const recoveryAvailable = operationKey !== void 0 && options.recoveryAvailable !== false;
+    super(
+      operationKey === void 0 ? "SQL outcome is unknown. The unkeyed request was attempted once; inspect the database before issuing another write. An operation key added afterwards cannot recover this request." : recoveryAvailable ? "SQL outcome is unknown. Recover by submitting the same SQL and options with the original operation key; do not use a new key." : "SQL outcome is unknown. The server did not confirm atomic recovery support. Do not resubmit this write; inspect the database and confirm reader support before recovering with the original operation key.",
+      cause.statusCode,
+      "CUSTOMER_DB_QUERY_OUTCOME_UNKNOWN",
+      {
+        outcome: "unknown",
+        recovery: recoveryAvailable ? "original_operation_key" : "unavailable",
+        causeCode: cause.code
+      }
+    );_class.prototype.__init.call(this);;
+    this.name = "CustomerDbQueryOutcomeUnknownError";
+    this.operationKey = operationKey;
+    this.retryable = recoveryAvailable;
+    Object.defineProperty(this, "cause", { value: cause, configurable: true });
+  }
+}, _class);
+var AuthError = class extends _chunk7P5AA3SNjs.DeeplineError {
+  /** Constructed by the SDK when Deepline rejects the caller's credentials. */
+  constructor(message = "Authentication failed. Check your DEEPLINE_API_KEY.") {
+    super(message, 401, "AUTH_ERROR");
+    this.name = "AuthError";
+  }
+};
+var RateLimitError = class extends _chunk7P5AA3SNjs.DeeplineError {
+  /** Milliseconds to wait before retrying, from the `Retry-After` response header. Defaults to 5000. */
+  
+  /** Constructed by the SDK after exhausting HTTP-level rate-limit retries. */
+  constructor(retryAfterMs = 5e3, message) {
+    super(
+      _nullishCoalesce(message, () => ( `Rate limited. Retry after ${retryAfterMs}ms.`)),
+      429,
+      "RATE_LIMIT"
+    );
+    this.name = "RateLimitError";
+    this.retryAfterMs = retryAfterMs;
+  }
+};
+var ToolRateLimitError = class extends RateLimitError {
+  /** Public tool id passed to `tools.execute`. */
+  
+  /** Provider responsible for the operation, or `null`. */
+  
+  /** Provider operation name, or `null`. */
+  
+  /** Stable machine-readable failure code when one exists. */
+  
+  /** Boundary responsible for the failure. */
+  
+  /** Stable reason family for policy and diagnostics. */
+  
+  /** Whether repeating the same semantic call is delivery-safe. */
+  
+  /** Provider or Deepline request id, or `null`. */
+  
+  /** Network failure kind, or `null` for non-network failures. */
+  
+  /** Network boundary that failed, or `null` for non-network failures. */
+  
+  /** Explicitly allowlisted diagnostics safe for SDK callers. */
+  
+  /** Constructed by the SDK after a structured tool HTTP 429. */
+  constructor(message, options) {
+    super(_nullishCoalesce(options.retryAfterMs, () => ( 5e3)), message);
+    this.name = "ToolRateLimitError";
+    this.statusCode = _nullishCoalesce(options.statusCode, () => ( 429));
+    this.code = _nullishCoalesce(options.code, () => ( void 0));
+    this.toolId = options.toolId;
+    this.provider = options.provider;
+    this.operation = options.operation;
+    this.origin = options.origin;
+    this.category = options.category;
+    this.retryable = options.retryable;
+    this.requestId = options.requestId;
+    this.networkKind = options.networkKind;
+    this.networkScope = options.networkScope;
+    this.publicDetails = _nullishCoalesce(options.publicDetails, () => ( null));
+    this.details = options.details;
+    _chunk7P5AA3SNjs.brandAsToolExecutionError.call(void 0, this);
+    if (_chunk7P5AA3SNjs.isProviderTransientFailure.call(void 0, this)) {
+      _chunk7P5AA3SNjs.brandAsProviderTransientError.call(void 0, this);
+    }
+  }
+};
+var ConfigError = class extends _chunk7P5AA3SNjs.DeeplineError {
+  /** Construct a local SDK configuration failure. */
+  constructor(message) {
+    super(message, void 0, "CONFIG_ERROR");
+    this.name = "ConfigError";
+  }
+};
+
+
+
+
+
+
+
+exports.CustomerDbQueryOutcomeUnknownError = CustomerDbQueryOutcomeUnknownError; exports.AuthError = AuthError; exports.RateLimitError = RateLimitError; exports.ToolRateLimitError = ToolRateLimitError; exports.ConfigError = ConfigError;

package/dist/cli/{describe-EFWNECHI.js → chunk-RFG3MRAC.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(); } } 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 _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 _chunk7DRPTGCKjs = require('./chunk-7DRPTGCK.js');
 
-var _chunk2VOLOWYZjs = require('./chunk-2VOLOWYZ.js');
 
 
 
@@ -13,37 +13,10 @@ var _chunk2VOLOWYZjs = require('./chunk-2VOLOWYZ.js');
 
 
 
-
-
-
-var _chunkNSOTASOPjs = require('./chunk-NSOTASOP.js');
-require('./chunk-AID3OYVJ.js');
-require('./chunk-KAEZNPUM.js');
-require('./chunk-LWERJUKN.js');
-require('./chunk-KB4SDX5S.js');
-
-
-var _chunkWQJJNIMQjs = require('./chunk-WQJJNIMQ.js');
-require('./chunk-S6R3OX7B.js');
-require('./chunk-UHNDVD3P.js');
-require('./chunk-KXMNM4AQ.js');
-require('./chunk-XDVT3GOM.js');
-require('./chunk-QJBJZVG6.js');
-
-
-var _chunkRTO5QZWTjs = require('./chunk-RTO5QZWT.js');
-require('./chunk-V7UP2F4U.js');
-require('./chunk-XNYIZMNQ.js');
+var _chunkBQR6UN3Cjs = require('./chunk-BQR6UN3C.js');
 
 
 var _chunk7P5AA3SNjs = require('./chunk-7P5AA3SN.js');
-require('./chunk-GNN4MY5X.js');
-require('./chunk-OG64RBAC.js');
-require('./chunk-COGTRVWW.js');
-
-// src/cli/commands/describe.ts
-var _fs = require('fs');
-var _path = require('path');
 
 // src/cli/tool-features.ts
 var VIEWS = {
@@ -58,13 +31,13 @@ var VIEWS = {
       details: model,
       lines: [
         ...unlisted,
-        ..._chunk2VOLOWYZjs.formatModelDescription.call(void 0, model).trimEnd().split("\n")
+        ..._chunk7DRPTGCKjs.formatModelDescription.call(void 0, model).trimEnd().split("\n")
       ]
     };
   },
   byok: async (_value, tool) => ({
     details: _nullishCoalesce(tool.byok, () => ( {})),
-    lines: _chunkNSOTASOPjs.byokLines.call(void 0, _nullishCoalesce(tool.byok, () => ( {})))
+    lines: _chunkBQR6UN3Cjs.byokLines.call(void 0, _nullishCoalesce(tool.byok, () => ( {})))
   })
 };
 var isFeatureView = (value) => typeof value === "string" && Object.hasOwn(VIEWS, value);
@@ -115,6 +88,24 @@ var FILTER_OF = {
   prebuilt_play: "prebuilts",
   custom_play: "custom"
 };
+async function found(lookup) {
+  try {
+    return await lookup;
+  } catch (error) {
+    if (error instanceof _chunk7P5AA3SNjs.DeeplineError && (error.statusCode === 404 || error.code === "PLAY_NOT_FOUND" || error.code === "NOT_FOUND")) {
+      return null;
+    }
+    throw error;
+  }
+}
+function describeLookupsFor(client) {
+  return {
+    play: (reference) => found(client.describePlay(reference)),
+    tool: (name) => found(client.getTool(name)),
+    describeModel: (model) => client.describeModel(model),
+    baseUrl: client.baseUrl
+  };
+}
 async function describeName(name, options, lookups) {
   const maintainedOnly = options.prebuilt === true || options.tool === true;
   const wants = (filter) => (!options.kinds || options.kinds.includes(filter)) && !(maintainedOnly && filter === "custom");
@@ -122,7 +113,7 @@ async function describeName(name, options, lookups) {
     const record2 = await lookups.play(reference);
     if (!record2) return null;
     return {
-      described: _chunkNSOTASOPjs.describedPlay.call(void 0, record2),
+      described: _chunkBQR6UN3Cjs.describedPlay.call(void 0, record2),
       record: { ...record2 },
       schemas: {
         inputSchema: _nullishCoalesce(record2.inputSchema, () => ( null)),
@@ -137,18 +128,18 @@ async function describeName(name, options, lookups) {
     const features = toolFeatures(record2);
     return {
       described: {
-        ..._chunk2VOLOWYZjs.describedTool.call(void 0, record2, name),
+        ..._chunk7DRPTGCKjs.describedTool.call(void 0, record2, name),
         // Shown when the tool runs only on your own credentials; otherwise
         // it is a feature, described with --feature byok.
         ..._optionalChain([byok, 'optionalAccess', _3 => _3.required]) === true ? { byok } : {},
         ...features.length ? { features: features.map(({ view: _view, ...feature }) => feature) } : {}
       },
-      record: _chunk2VOLOWYZjs.toolMetadataJsonForDescribe.call(void 0, 
+      record: _chunk7DRPTGCKjs.toolMetadataJsonForDescribe.call(void 0, 
         record2,
         name,
         lookups.seedStarterScript
       ),
-      schemas: _chunk2VOLOWYZjs.publicToolSchemas.call(void 0, record2),
+      schemas: _chunk7DRPTGCKjs.publicToolSchemas.call(void 0, record2),
       feature: (featureName, value) => {
         const feature = features.find(({ name: name2 }) => name2 === featureName);
         return feature ? describeFeature(record2, feature, value, {
@@ -179,7 +170,7 @@ async function describeName(name, options, lookups) {
   const note = shadows ? `Showing your workspace play "${name}". It has the same name as a Deepline ${shadows.kind.replace("_", " ")}; see that one with: ${shadows.describeCommand}` : null;
   const verbose = options.verbose === true;
   const isPlay = described.kind === "prebuilt_play" || described.kind === "custom_play";
-  const dashboardUrl = isPlay ? _chunkNSOTASOPjs.buildPlayDashboardUrl.call(void 0, lookups.baseUrl, described.id) : null;
+  const dashboardUrl = isPlay ? _chunkBQR6UN3Cjs.buildPlayDashboardUrl.call(void 0, lookups.baseUrl, described.id) : null;
   if (options.webUrl) {
     if (!dashboardUrl) {
       return {
@@ -243,7 +234,7 @@ async function describeName(name, options, lookups) {
     },
     lines: [
       `${described.id} [${described.kind.replace("_", " ")}]`,
-      ..._chunkNSOTASOPjs.schemaLines.call(void 0, described, {
+      ..._chunkBQR6UN3Cjs.schemaLines.call(void 0, described, {
         full: true,
         secondary: true,
         ...fields.length ? { fields } : {}
@@ -252,17 +243,17 @@ async function describeName(name, options, lookups) {
   } : {
     envelope: {
       ...summary,
-      inputs: inputs.map(_chunkNSOTASOPjs.topLevelField),
-      outputs: outputs.map(_chunkNSOTASOPjs.topLevelField),
-      ...described.rowInputs ? { rowInputs: described.rowInputs.map(_chunkNSOTASOPjs.topLevelField) } : {},
-      ...described.rowOutputs ? { rowOutputs: described.rowOutputs.map(_chunkNSOTASOPjs.topLevelField) } : {},
-      runExamples: _chunkNSOTASOPjs.examples.call(void 0, described, { verbose }),
+      inputs: inputs.map(_chunkBQR6UN3Cjs.topLevelField),
+      outputs: outputs.map(_chunkBQR6UN3Cjs.topLevelField),
+      ...described.rowInputs ? { rowInputs: described.rowInputs.map(_chunkBQR6UN3Cjs.topLevelField) } : {},
+      ...described.rowOutputs ? { rowOutputs: described.rowOutputs.map(_chunkBQR6UN3Cjs.topLevelField) } : {},
+      runExamples: _chunkBQR6UN3Cjs.examples.call(void 0, described, { verbose }),
       ...dashboardUrl ? { dashboardUrl } : {},
       ...shadows ? { shadows, note } : {}
     },
     lines: [
       ...note ? [`Note: ${note}`, ""] : [],
-      ..._chunkNSOTASOPjs.describedLines.call(void 0, described, {
+      ..._chunkBQR6UN3Cjs.describedLines.call(void 0, described, {
         cli: shown && (!named || options.cliExample === true),
         play: shown && (!named || options.playExample === true),
         explain: named,
@@ -279,7 +270,7 @@ async function describeName(name, options, lookups) {
     // its value stands, so callers of the older commands read what they did.
     { ...view.envelope, ...record }
   ) : {
-    ..._chunkNSOTASOPjs.describedJson.call(void 0, described, {
+    ..._chunkBQR6UN3Cjs.describedJson.call(void 0, described, {
       secondary: verbose || fields.length > 0,
       verbose
     }),
@@ -289,136 +280,7 @@ async function describeName(name, options, lookups) {
   return { status: "described", envelope, lines: view.lines };
 }
 
-// src/cli/commands/describe.ts
-async function found(lookup) {
-  try {
-    return await lookup;
-  } catch (error) {
-    if (error instanceof _chunk7P5AA3SNjs.DeeplineError && (error.statusCode === 404 || error.code === "PLAY_NOT_FOUND" || error.code === "NOT_FOUND")) {
-      return null;
-    }
-    throw error;
-  }
-}
-async function describeAnything(name, options, onMissing) {
-  const client = new (0, _chunkWQJJNIMQjs.DeeplineClient)();
-  const outcome = await describeName(name, options, {
-    play: (reference) => found(client.describePlay(reference)),
-    tool: async (toolName) => await _asyncNullishCoalesce(options.fetchedTool, async () => ( await found(client.getTool(toolName)))),
-    describeModel: (model) => client.describeModel(model),
-    baseUrl: client.baseUrl,
-    seedStarterScript: _chunk2VOLOWYZjs.seedToolListScript
-  });
-  if (outcome.status === "missing") {
-    if (onMissing) return onMissing();
-    console.error(
-      `Nothing named "${name}". Search for it: deepline search ${JSON.stringify(name.replace(/[-_./]+/g, " "))}`
-    );
-    return 2;
-  }
-  if (outcome.status === "refused") {
-    console.error(outcome.message);
-    return outcome.exitCode;
-  }
-  return deliver(outcome.envelope, outcome.lines, {
-    json: options.json === true,
-    out: options.out
-  });
-}
-function deliver(envelope, lines, { json, out }) {
-  const text = `${lines.join("\n")}
-`;
-  if (out) {
-    const path = _path.resolve.call(void 0, out);
-    const content = json ? `${JSON.stringify(envelope, null, 2)}
-` : text;
-    _fs.writeFileSync.call(void 0, path, content);
-    const bytes = Buffer.byteLength(content);
-    _chunkRTO5QZWTjs.printCommandEnvelope.call(void 0, 
-      { path, bytes },
-      { json, text: `Wrote ${path} (${bytes} bytes)
-` }
-    );
-    return 0;
-  }
-  _chunkRTO5QZWTjs.printCommandEnvelope.call(void 0, envelope, { json, text });
-  return 0;
-}
-function registerDescribeCommand(program) {
-  _chunkNSOTASOPjs.addDescribeOptions.call(void 0, program.command("describe <name>")).option("--web-url", "Print only a play's play page URL").description(
-    "Describe anything search returns: a tool, monitor type, or play."
-  ).addHelpText(
-    "after",
-    `
-What you can describe:
-  Any id deepline search returns: a tool id, a monitor type id, or a play name
-  or reference. You do not say which kind it is; tool ids, monitor type ids
-  and prebuilt play names never overlap.
-
-When a name is taken twice:
-  A play your workspace created is shown instead of a Deepline tool, monitor
-  type or prebuilt play with the same name, and the output says so.
-  Pass --prebuilt (or --tool) to see the Deepline one.
-
-What it prints:
-  The same sections for every kind: what it is, cost, inputs, outputs, then
-  an example of running it from the CLI and from inside a play.
-
-Examples in the output:
-  (default)        required inputs filled in, first output read
-  --verbose        every input filled in, every output read; also shows
-                   secondary fields
-  --cli-example    only the CLI example, with how inputs and outputs work
-  --play-example   only the in-play example, with how inputs and outputs work
-  --no-example     no examples
-
-Features:
-  A tool lists its features: parts with their own description, such as the
-  model an AI tool runs. --feature <name> describes one at its default value,
-  --feature <name>=<value> at another, e.g. --feature model=openai/gpt-5.6-luna.
-
-Schema size and format:
-  Secondary fields (diagnostics, attempt logs, echoes of input) are left out
-  by default; the output names them, and --verbose shows them.
-  --fields email,miss_reason shows only the fields you name, plus every
-  required input, and names the rest. Use it when you know what you need.
-  A schema over ${_chunkNSOTASOPjs.SCHEMA_LINE_LIMIT} lines is folded: deeper objects show only their field
-  names. A shape used more than once is printed once under Types.
-  --full-schema    the normal output, with the schema not folded
-  --schema-only    only the schema, not folded, and nothing else
-  --json           the same facts as JSON: fields keyed by name, with what
-                   each means and, for a tool, where it is in the result;
-                   secondary fields are named in "hidden"
-  --json --full-schema  the whole catalog record, as tools describe and
-                   plays describe print it
-  --schema-only --json
-                   only the input and output JSON Schemas; use this for a
-                   program, or for a schema too large to read
-  --out <path>     save any of the above to a file instead of printing it
-
-Play page:
-  For a play, the output ends with its play page URL (JSON: dashboardUrl).
-  --web-url        print only that URL; with --json, {"dashboardUrl": ...}.
-                   Fails for a tool or monitor type, which have no play page.
-
-Older commands:
-  deepline tools describe and deepline plays describe are this command limited
-  to one kind. Their own flags still work: --pricing-only, --examples-only,
-  --model and --estimate-payload on tools; --json <fields> on plays.
-
-Examples:
-  deepline describe hunter_email_verifier
-  deepline describe person-linkedin-to-email
-  deepline describe my-play --prebuilt
-  deepline describe ai_ark_people_search --full-schema
-  deepline describe prebuilt/person-to-email-batch --web-url
-  deepline describe ai_ark_people_search --schema-only --out schema.json
-`
-  ).action(async (name, options) => {
-    process.exitCode = await describeAnything(name, options);
-  });
-}
 
 
 
-exports.describeAnything = describeAnything; exports.registerDescribeCommand = registerDescribeCommand;
+exports.describeLookupsFor = describeLookupsFor; exports.describeName = describeName;

package/dist/cli/{chunk-XKZXO7D3.mjs → chunk-RNSWDKBM.mjs}

@@ -3,7 +3,7 @@ import {
   detectAgentRuntime,
   resolveCliCommandContext,
   resolveConfig
-} from "./chunk-VE3U3SQC.mjs";
+} from "./chunk-2LDADJNO.mjs";
 import {
   DeeplineError,
   serializeToolExecutionFailure