deepline 0.3.395 → 0.3.397

package/dist/cli/{chunk-R4XZO6Z5.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 _chunk36ML3YKAjs = require('./chunk-36ML3YKA.js');
+var _chunkZM2YPJQJjs = require('./chunk-ZM2YPJQJ.js');
 
 
+var _chunkUVXBVUZQjs = require('./chunk-UVXBVUZQ.js');
 
-var _chunkHRWUQJ4Kjs = require('./chunk-HRWUQJ4K.js');
 
 
+var _chunkDQ65ZVHNjs = require('./chunk-DQ65ZVHN.js');
 
-var _chunk56IFFVIBjs = require('./chunk-56IFFVIB.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, _chunk56IFFVIBjs.sdkCliStateDirPath.call(void 0, _chunk56IFFVIBjs.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());
@@ -238,9 +138,14 @@ function rateLimitDisplay(item) {
   );
   return tightest ? `${tightest.requestsPerWindow}/${_nullishCoalesce(RATE_WINDOW_UNITS[tightest.windowMs], () => ( `${tightest.windowMs / 1e3}s`))}` : "\u2014";
 }
+function failureRateDisplay(rate) {
+  if (typeof rate !== "number") return "\u2014";
+  const percent = Math.round(rate * 100);
+  return percent === 0 && rate > 0 ? "<1%" : `${percent}%`;
+}
 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") {
@@ -253,13 +158,16 @@ function searchRow(item) {
     kind: item.kind,
     cost,
     rateLimit: rateLimitDisplay(item),
+    // Production share of errored or rate-limited calls; absent when too few
+    // calls or orgs used the tool to say.
+    failureRate: failureRateDisplay(item.failureRate),
     summary: clipSummary(_nullishCoalesce(item.description, () => ( ""))),
     notes
   };
 }
 function renderSearchResults(result) {
   if (result.results.length === 0)
-    return _chunkHRWUQJ4Kjs.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");
@@ -274,6 +182,13 @@ function renderSearchResults(result) {
         alignment: "right"
       }
     ] : [],
+    ...rows.some((row) => row.failureRate !== "\u2014") ? [
+      {
+        header: "FAILURES",
+        value: (row) => row.failureRate,
+        alignment: "right"
+      }
+    ] : [],
     { header: "SUMMARY", value: (row) => row.summary }
   ];
   const render = result.render;
@@ -283,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]) ? `
-${_chunkHRWUQJ4Kjs.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}`)
   );
@@ -360,7 +275,7 @@ async function runSearch(queryInput, options, types, exclude = []) {
     console.error(USAGE);
     return 1;
   }
-  const { search_ref: searchRef, ...result } = await new (0, _chunk36ML3YKAjs.DeeplineClient)().search({
+  const { search_ref: searchRef, ...result } = await new (0, _chunkUVXBVUZQjs.DeeplineClient)().search({
     query,
     types,
     exclude,
@@ -374,7 +289,7 @@ async function runSearch(queryInput, options, types, exclude = []) {
   });
   if (searchRef) rememberSearchRef(searchRef);
   pointAtDescribe(result);
-  _chunkHRWUQJ4Kjs.printCommandEnvelope.call(void 0, result, {
+  _chunkDQ65ZVHNjs.printCommandEnvelope.call(void 0, result, {
     json: options.json === true,
     text: renderSearchResults(result)
   });
@@ -474,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/chunk-RFG3MRAC.js

@@ -0,0 +1,286 @@
+"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 _chunkBQR6UN3Cjs = require('./chunk-BQR6UN3C.js');
+
+
+var _chunk7P5AA3SNjs = require('./chunk-7P5AA3SN.js');
+
+// src/cli/tool-features.ts
+var VIEWS = {
+  ai_gateway_model: async (value, _tool, { describeModel }) => {
+    if (!value)
+      throw new Error("Name a model: --feature model=<provider/model>");
+    const model = await describeModel(value);
+    const unlisted = model.modelMetadata ? [] : [
+      `Warning: ${value} is not in the live AI Gateway catalog; check the id at https://ai-gateway.vercel.sh/v1/models.`
+    ];
+    return {
+      details: model,
+      lines: [
+        ...unlisted,
+        ..._chunk7DRPTGCKjs.formatModelDescription.call(void 0, model).trimEnd().split("\n")
+      ]
+    };
+  },
+  byok: async (_value, tool) => ({
+    details: _nullishCoalesce(tool.byok, () => ( {})),
+    lines: _chunkBQR6UN3Cjs.byokLines.call(void 0, _nullishCoalesce(tool.byok, () => ( {})))
+  })
+};
+var isFeatureView = (value) => typeof value === "string" && Object.hasOwn(VIEWS, value);
+var asRecord = (value) => value && typeof value === "object" && !Array.isArray(value) ? value : {};
+function inputProperties(tool) {
+  const inputSchema = asRecord(tool.inputSchema);
+  const jsonSchema = asRecord(_nullishCoalesce(inputSchema.jsonSchema, () => ( inputSchema)));
+  return asRecord(jsonSchema.properties);
+}
+var firstSentence = (text) => typeof text === "string" ? _nullishCoalesce(text.split(/(?<=\.)\s/)[0], () => ( text)) : "";
+function toolFeatures(tool) {
+  const inputs = Object.entries(inputProperties(tool)).flatMap(
+    ([name, value]) => {
+      const schema = asRecord(value);
+      if (!isFeatureView(schema.feature)) return [];
+      return [
+        {
+          name,
+          summary: firstSentence(schema.description),
+          view: schema.feature,
+          ...typeof schema.default === "string" ? { defaultValue: schema.default } : {}
+        }
+      ];
+    }
+  );
+  const byok = _optionalChain([tool, 'access', _ => _.byok, 'optionalAccess', _2 => _2.supported]) === true ? [
+    {
+      name: "byok",
+      summary: "Run it on your own provider credentials.",
+      view: "byok"
+    }
+  ] : [];
+  return [...inputs, ...byok];
+}
+function parseFeatureRequest(request) {
+  const [name = "", ...rest] = request.split("=");
+  const value = rest.join("=");
+  return value ? { name, value } : { name };
+}
+async function describeFeature(tool, feature, value, dependencies) {
+  return VIEWS[feature.view](_nullishCoalesce(value, () => ( feature.defaultValue)), tool, dependencies);
+}
+
+// src/cli/describe-core.ts
+var FILTER_OF = {
+  tool: "tools",
+  monitor_type: "monitors",
+  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");
+  const play = async (reference) => {
+    const record2 = await lookups.play(reference);
+    if (!record2) return null;
+    return {
+      described: _chunkBQR6UN3Cjs.describedPlay.call(void 0, record2),
+      record: { ...record2 },
+      schemas: {
+        inputSchema: _nullishCoalesce(record2.inputSchema, () => ( null)),
+        outputSchema: _nullishCoalesce(record2.outputSchema, () => ( null))
+      }
+    };
+  };
+  const tool = async () => {
+    const record2 = await lookups.tool(name);
+    if (!record2) return null;
+    const { byok } = record2;
+    const features = toolFeatures(record2);
+    return {
+      described: {
+        ..._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: _chunk7DRPTGCKjs.toolMetadataJsonForDescribe.call(void 0, 
+        record2,
+        name,
+        lookups.seedStarterScript
+      ),
+      schemas: _chunk7DRPTGCKjs.publicToolSchemas.call(void 0, record2),
+      feature: (featureName, value) => {
+        const feature = features.find(({ name: name2 }) => name2 === featureName);
+        return feature ? describeFeature(record2, feature, value, {
+          describeModel: (model) => lookups.describeModel(model)
+        }) : null;
+      }
+    };
+  };
+  const sources = name.includes("/") ? [{ kinds: ["prebuilts", "custom"], find: () => play(name) }] : [
+    { kinds: ["custom"], find: () => play(name) },
+    { kinds: ["tools", "monitors"], find: tool },
+    { kinds: ["prebuilts"], find: () => play(`prebuilt/${name}`) }
+  ];
+  const matches = await Promise.all(
+    sources.filter((source) => source.kinds.some(wants)).map(async ({ kinds, find }) => {
+      const match = await find();
+      const filter = match && FILTER_OF[match.described.kind];
+      return filter && kinds.includes(filter) && wants(filter) ? match : null;
+    })
+  );
+  const [chosen, shadowed] = matches.filter((match) => match !== null);
+  if (!chosen) return { status: "missing" };
+  const { described, record } = chosen;
+  const shadows = described.kind === "custom_play" && shadowed ? {
+    kind: shadowed.described.kind,
+    describeCommand: `deepline describe ${name} --prebuilt`
+  } : null;
+  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 ? _chunkBQR6UN3Cjs.buildPlayDashboardUrl.call(void 0, lookups.baseUrl, described.id) : null;
+  if (options.webUrl) {
+    if (!dashboardUrl) {
+      return {
+        status: "refused",
+        message: `${described.id} is a ${described.kind.replace("_", " ")}, not a play; only plays have a play page.`,
+        exitCode: 1
+      };
+    }
+    return {
+      status: "described",
+      envelope: { dashboardUrl },
+      lines: [dashboardUrl]
+    };
+  }
+  if (options.feature !== void 0) {
+    const { name: featureName, value } = parseFeatureRequest(options.feature);
+    const pending = _nullishCoalesce(_optionalChain([chosen, 'access', _4 => _4.feature, 'optionalCall', _5 => _5(featureName, value)]), () => ( null));
+    const features = _nullishCoalesce(described.features, () => ( []));
+    if (!pending) {
+      return {
+        status: "refused",
+        message: features.length ? `${described.id} has no feature "${featureName}". Its features: ${features.map(({ name: name2 }) => name2).join(", ")}.` : `${described.id} has no features to describe.`,
+        exitCode: 2
+      };
+    }
+    const shownValue = _nullishCoalesce(value, () => ( _optionalChain([features, 'access', _6 => _6.find, 'call', _7 => _7(({ name: name2 }) => name2 === featureName), 'optionalAccess', _8 => _8.defaultValue])));
+    const { details, lines } = await pending;
+    return {
+      status: "described",
+      envelope: {
+        kind: described.kind,
+        id: described.id,
+        feature: featureName,
+        ...shownValue ? { value: shownValue } : {},
+        details
+      },
+      lines: [
+        `${described.id} --feature ${featureName}${shownValue ? `=${shownValue}` : ""}`,
+        ...lines
+      ]
+    };
+  }
+  const fields = (_nullishCoalesce(options.fields, () => ( ""))).split(",").map((name2) => name2.trim()).filter(Boolean);
+  const named = options.cliExample === true || options.playExample === true;
+  const shown = options.example !== false;
+  const {
+    runner: _runner,
+    inputs,
+    outputs,
+    rowInputs: _rowInputs,
+    rowOutputs: _rowOutputs,
+    rowOutputsAddToSource: _rowOutputsAddToSource,
+    csvInput: _csvInput,
+    ...summary
+  } = described;
+  const view = options.schemaOnly ? {
+    envelope: {
+      kind: described.kind,
+      id: described.id,
+      ...chosen.schemas
+    },
+    lines: [
+      `${described.id} [${described.kind.replace("_", " ")}]`,
+      ..._chunkBQR6UN3Cjs.schemaLines.call(void 0, described, {
+        full: true,
+        secondary: true,
+        ...fields.length ? { fields } : {}
+      })
+    ]
+  } : {
+    envelope: {
+      ...summary,
+      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}`, ""] : [],
+      ..._chunkBQR6UN3Cjs.describedLines.call(void 0, described, {
+        cli: shown && (!named || options.cliExample === true),
+        play: shown && (!named || options.playExample === true),
+        explain: named,
+        verbose,
+        fullSchema: options.fullSchema === true,
+        ...fields.length ? { fields } : {}
+      }),
+      ...dashboardUrl ? ["", `Play page: ${dashboardUrl}`] : []
+    ]
+  };
+  const fullRecord = options.fullRecord === true || options.fullSchema === true;
+  const envelope = options.schemaOnly ? view.envelope : fullRecord ? (
+    // The shared keys lead; where the kind's own record has the same key,
+    // its value stands, so callers of the older commands read what they did.
+    { ...view.envelope, ...record }
+  ) : {
+    ..._chunkBQR6UN3Cjs.describedJson.call(void 0, described, {
+      secondary: verbose || fields.length > 0,
+      verbose
+    }),
+    ...dashboardUrl ? { dashboardUrl } : {},
+    ...shadows ? { shadows, note } : {}
+  };
+  return { status: "described", envelope, lines: view.lines };
+}
+
+
+
+
+exports.describeLookupsFor = describeLookupsFor; exports.describeName = describeName;

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

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