deepline 0.3.143 → 0.3.145

package/dist/bundling-sources/sdk/src/client.ts

@@ -1960,6 +1960,21 @@ export type WorkspacesNamespace = {
   }) => Promise<WorkspaceCreateResult>;
 };
 
+/** One authenticated per-request usage event from `/api/v2/usage/events`. */
+export type BillingUsageEvent = {
+  id: string | null;
+  provider: string;
+  operation: string;
+  status: string;
+  request_id: string;
+  billing_outcome_reason: string | null;
+  credits: number | null;
+  billing_mode: string | null;
+  pricing_model: string | null;
+  policy_id: string | null;
+  created_at: string;
+};
+
 /**
  * Public `client.billing` namespace for CLI commands and programmatic callers.
  * Covers plans, subscription state, cancellation, and invoice/receipt history.
@@ -1989,6 +2004,8 @@ export type BillingNamespace = {
     /** Subscription invoices plus credit purchase receipts, newest first. */
     list: (options?: { limit?: number }) => Promise<BillingInvoicesResult>;
   };
+  /** Read one exact execution outcome using the request_id returned by executeTool. */
+  usageEvent: (requestId: string) => Promise<BillingUsageEvent>;
   /** Metronome-authored target catalog and current Contract projection. */
   targetPlans: () => Promise<TargetBillingPlansResult>;
   /** Normalized target billing state. */
@@ -2600,6 +2617,7 @@ export class DeeplineClient {
       invoices: {
         list: (options) => this.listBillingInvoices(options),
       },
+      usageEvent: (requestId) => this.getBillingUsageEvent(requestId),
       targetPlans: () => this.getTargetBillingPlans(),
       targetStatus: () => this.getTargetBillingStatus(),
       autoRecharge: {
@@ -5803,6 +5821,40 @@ export class DeeplineClient {
     return this.http.get<BillingPlansResult>('/api/v2/billing/catalog/current');
   }
 
+  /**
+   * Read the authenticated usage record for one execution request. The
+   * request id comes from the original `executeTool` result and is not a
+   * retry or idempotency token.
+   */
+  async getBillingUsageEvent(requestId: string): Promise<BillingUsageEvent> {
+    const normalizedRequestId = requestId.trim();
+    if (
+      normalizedRequestId.length === 0 ||
+      normalizedRequestId.length > 200 ||
+      normalizedRequestId !== requestId
+    ) {
+      throw new DeeplineError(
+        'Usage request_id must contain 1–200 characters with no leading or trailing whitespace.',
+        undefined,
+        'INVALID_USAGE_REQUEST_ID',
+      );
+    }
+    const response = await this.http.get<{
+      entries?: BillingUsageEvent[];
+    }>(
+      `/api/v2/usage/events?request_id=${encodeURIComponent(normalizedRequestId)}`,
+    );
+    const event = response.entries?.[0];
+    if (!event) {
+      throw new DeeplineError(
+        'No usage event was found for this request_id.',
+        undefined,
+        'USAGE_EVENT_NOT_FOUND',
+      );
+    }
+    return event;
+  }
+
   /**
    * Charge the saved payment method and add Deepline credits to the active
    * workspace. Prefer `client.billing.topUp(...)`.

package/dist/bundling-sources/sdk/src/index.ts

@@ -73,6 +73,7 @@ export type {
   BillingSubscriptionCancelResult,
   BillingSubscriptionStatus,
   BillingTopUpResult,
+  BillingUsageEvent,
   WorkspaceCreateResult,
   WorkspacesNamespace,
   MonitorsNamespace,

package/dist/bundling-sources/sdk/src/release.ts

@@ -200,7 +200,7 @@ export const 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.143',
+  version: '0.3.145',
   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: {

package/dist/bundling-sources/shared_libs/play-runtime/tool-result.ts

@@ -664,6 +664,21 @@ function findFirstTargetByPath(
   return null;
 }
 
+function findFirstExplicitNullTargetByPath(
+  result: unknown,
+  paths: readonly string[] | undefined,
+): ToolResultTargetMetadata | null {
+  for (const path of paths ?? []) {
+    for (const candidate of candidateResultPaths(path)) {
+      const explicitNull = valuesAtSegments(result, parsePath(candidate)).find(
+        (entry) => entry.value === null,
+      );
+      if (explicitNull) return { value: null, path: explicitNull.path };
+    }
+  }
+  return null;
+}
+
 function firstValueForPaths(
   result: unknown,
   paths: readonly string[] | undefined,
@@ -1015,7 +1030,15 @@ function buildTargets(
       continue;
     }
     const fromExtractor = findFirstTargetByPath(result, descriptor.paths);
-    if (!fromExtractor) continue;
+    if (!fromExtractor) {
+      // A declared null is an explicit provider answer, not permission to
+      // guess from a similarly named sibling such as `emailDomain`.
+      const explicitNull = isSemanticStatus
+        ? null
+        : findFirstExplicitNullTargetByPath(result, descriptor.paths);
+      if (explicitNull) targets[target] = explicitNull;
+      continue;
+    }
     const transformed = coerceToEnum(
       applyExtractorTransforms(fromExtractor.value, descriptor),
       descriptor,
@@ -1038,6 +1061,14 @@ function buildTargets(
       targets[target] = fromMetadata;
       continue;
     }
+    const explicitNull = findFirstExplicitNullTargetByPath(
+      result,
+      targetGetters?.[target],
+    );
+    if (explicitNull) {
+      targets[target] = explicitNull;
+      continue;
+    }
     // Declared paths are routinely incomplete against the shape a provider
     // actually returns (zerobounce declares `result.data.email` and answers
     // with `address`), so the key scan stays as the rescue. It is bounded by
@@ -1053,6 +1084,7 @@ function buildTargets(
   }
   if (metadataTargets.size === 0) {
     for (const target of ['email', 'phone', 'linkedin', 'domain', 'status']) {
+      if (targets[target]) continue;
       const found = findFirstTargetByKey(result, target);
       if (found) targets[target] = found;
     }
@@ -1333,8 +1365,8 @@ export function readValue(
   selector: readonly string[] | string,
 ): unknown {
   if (typeof selector === 'string') {
-    const declared = result.extractedValues[selector]?.get();
-    if (declared != null) return declared;
+    const declared = result.extractedValues[selector];
+    if (declared) return declared.get();
   }
   const root = resultRootOf(result);
   const paths = Array.isArray(selector) ? selector : [selector];

package/dist/bundling-sources/shared_libs/plays/tool-result-types.ts

@@ -13,7 +13,17 @@ export type ToolResultBilling = {
   cost_usd?: number;
   /** Missing on historical responses. Pending pricing has no final amount. */
   pricing_status?: 'final' | 'pending';
-  settlement_status?: 'pending' | 'queued' | 'settled' | 'requires_recovery';
+  settlement_status?:
+    | 'pending'
+    | 'queued'
+    | 'settled'
+    | 'released'
+    | 'requires_recovery';
+  billing_outcome_reason?:
+    | 'free_operation'
+    | 'provider_no_billable_result'
+    | 'provider_reported_zero_usage'
+    | 'zero_price';
   estimated_credits?: number;
   estimated_cost_usd?: number;
   /** Preserve additive public pricing details across runtime/deployment skew. */

package/dist/bundling-sources/shared_libs/product-notifications/catalog.ts

@@ -108,6 +108,13 @@ type ProductNotificationRuleDefinition = {
 type NotificationTypeRegistration = NotificationTypeDefinition & {
   catalog?: ProductNotificationTypeCatalogMetadata;
   rule?: ProductNotificationRuleDefinition;
+  /**
+   * A platform-emitted rule with no catalog entry: never listed, never
+   * accepted by a workspace mutation, regardless of caller. Distinct from an
+   * inert catalog-less type (e.g. one with no producer yet) because a shadow
+   * type still ships a `rule.default` and fires for every workspace.
+   */
+  shadow?: true;
 };
 
 function validateInsufficientCreditDisable(
@@ -643,29 +650,19 @@ const PRODUCT_NOTIFICATION_TYPE_REGISTRY = [
     eventName: ProductNotificationEvent.CreditsPurchaseCompleted,
     requiredFilter: {},
     allowedTriggers: ['threshold_crossing'],
-    catalog: {
-      name: 'Credit purchase thank-you',
-      category: 'credits',
-      description:
-        'Thank the workspace when a credit purchase of at least the chosen size completes.',
-      allowMultiple: false,
-      editor: {
-        kind: 'threshold',
-        label: 'Minimum credits',
-        defaultThreshold: 500,
-        minimum: 0,
-        suffix: 'credits',
-      },
-    },
+    // Credit purchase thank-you: fires for every workspace once a purchase
+    // reaches 500 credits. Not configurable — see the `shadow` field.
+    catalog: undefined,
+    shadow: true,
     rule: {
-      default: { ruleKey: 'default.credits_purchased', groupKey: 'default' },
-      create: (input, base, editor) => ({
+      default: { ruleKey: 'default.credits_purchased', groupKey: 'shadow' },
+      create: (input, base) => ({
         ...base,
         repeatMode: 'every_match',
         trigger: {
           kind: 'threshold_crossing',
           direction: 'at_or_above',
-          threshold: input.threshold ?? defaultThreshold(editor),
+          threshold: input.threshold ?? 500,
           unit: 'credits',
         },
       }),
@@ -707,15 +704,12 @@ const PRODUCT_NOTIFICATION_TYPE_REGISTRY = [
     eventName: ProductNotificationEvent.BillingPlanPurchased,
     requiredFilter: {},
     allowedTriggers: ['each_match'],
-    catalog: {
-      name: 'Plan welcome',
-      category: 'credits',
-      description: 'Thank the workspace when it purchases a plan.',
-      allowMultiple: false,
-      editor: { kind: 'none' },
-    },
+    // Plan welcome: fires for every workspace on plan purchase. Not
+    // configurable — see the `shadow` field.
+    catalog: undefined,
+    shadow: true,
     rule: {
-      default: { ruleKey: 'default.plan_purchased', groupKey: 'default' },
+      default: { ruleKey: 'default.plan_purchased', groupKey: 'shadow' },
       create: (_input, base) => ({
         ...base,
         repeatMode: 'every_match',
@@ -911,10 +905,10 @@ export function createProductNotificationRule(input: {
   };
   if (rule?.create) {
     const editor = registration.catalog?.editor;
-    if (!editor) {
+    if (!editor && !(registration as NotificationTypeRegistration).shadow) {
       throw new Error(`${input.notificationType} is not configurable.`);
     }
-    return rule.create(input, base, editor);
+    return rule.create(input, base, editor ?? { kind: 'none' });
   }
   throw new Error(
     `Notification type ${input.notificationType} has no rule builder.`,
@@ -927,6 +921,17 @@ export const PRODUCT_NOTIFICATION_TYPE_CATALOG: readonly ProductNotificationType
     catalog ? [{ id, ...catalog }] : [],
   );
 
+/**
+ * Platform-owned notification types with a default rule that fires for every
+ * workspace but is never listed or user-editable. A workspace mutation must
+ * reject any of these ids outright, not merely omit them from a listing.
+ */
+export const PRODUCT_NOTIFICATION_SHADOW_TYPES: ReadonlySet<string> = new Set(
+  PRODUCT_NOTIFICATION_TYPE_REGISTRY.filter(
+    (registration) => (registration as NotificationTypeRegistration).shadow,
+  ).map(({ id }) => id),
+);
+
 /** Code-owned defaults declared beside the notification types they enable. */
 export const PRODUCT_NOTIFICATION_DEFAULT_RULES =
   PRODUCT_NOTIFICATION_TYPE_REGISTRY.flatMap((registration) => {

package/dist/bundling-sources/shared_libs/product-notifications/default-policy.ts

@@ -14,7 +14,7 @@ import {
  * they create sparse copy-on-write overrides.
  */
 export const CURRENT_PRODUCT_NOTIFICATION_DEFAULT_POLICY = {
-  version: 7,
+  version: 8,
   groups: [
     {
       groupKey: 'default',
@@ -22,6 +22,16 @@ export const CURRENT_PRODUCT_NOTIFICATION_DEFAULT_POLICY = {
       enabled: true,
       deliveryTiming: DEFAULT_PRODUCT_NOTIFICATION_DELIVERY_TIMING,
     },
+    {
+      // Holds shadow (platform-owned, unconfigurable) rules. Kept in its own
+      // group so a customer save of the "default" group's rules never diffs
+      // against — and so never implicitly disables — a shadow rule it can't
+      // see. See PRODUCT_NOTIFICATION_SHADOW_TYPES.
+      groupKey: 'shadow',
+      name: 'Platform notifications',
+      enabled: true,
+      deliveryTiming: DEFAULT_PRODUCT_NOTIFICATION_DELIVERY_TIMING,
+    },
   ],
   destinations: [
     {
@@ -31,6 +41,13 @@ export const CURRENT_PRODUCT_NOTIFICATION_DEFAULT_POLICY = {
       enabled: true,
       settings: { kind: 'email_roles', roles: ['owner'] },
     },
+    {
+      destinationKey: 'shadow.roles',
+      groupKey: 'shadow',
+      name: 'Workspace owners',
+      enabled: true,
+      settings: { kind: 'email_roles', roles: ['owner'] },
+    },
   ],
   rules: PRODUCT_NOTIFICATION_DEFAULT_RULES,
 } satisfies ProductNotificationDefaultPolicy;

package/dist/cli/index.js

@@ -3068,7 +3068,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.143",
+  version: "0.3.145",
   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
@@ -7100,6 +7100,7 @@ var DeeplineClient = class _DeeplineClient {
       invoices: {
         list: (options2) => this.listBillingInvoices(options2)
       },
+      usageEvent: (requestId) => this.getBillingUsageEvent(requestId),
       targetPlans: () => this.getTargetBillingPlans(),
       targetStatus: () => this.getTargetBillingStatus(),
       autoRecharge: {
@@ -9471,6 +9472,33 @@ var DeeplineClient = class _DeeplineClient {
   async getBillingPlans() {
     return this.http.get("/api/v2/billing/catalog/current");
   }
+  /**
+   * Read the authenticated usage record for one execution request. The
+   * request id comes from the original `executeTool` result and is not a
+   * retry or idempotency token.
+   */
+  async getBillingUsageEvent(requestId) {
+    const normalizedRequestId = requestId.trim();
+    if (normalizedRequestId.length === 0 || normalizedRequestId.length > 200 || normalizedRequestId !== requestId) {
+      throw new DeeplineError(
+        "Usage request_id must contain 1\u2013200 characters with no leading or trailing whitespace.",
+        void 0,
+        "INVALID_USAGE_REQUEST_ID"
+      );
+    }
+    const response = await this.http.get(
+      `/api/v2/usage/events?request_id=${encodeURIComponent(normalizedRequestId)}`
+    );
+    const event = response.entries?.[0];
+    if (!event) {
+      throw new DeeplineError(
+        "No usage event was found for this request_id.",
+        void 0,
+        "USAGE_EVENT_NOT_FOUND"
+      );
+    }
+    return event;
+  }
   /**
    * Charge the saved payment method and add Deepline credits to the active
    * workspace. Prefer `client.billing.topUp(...)`.
@@ -47961,6 +47989,7 @@ Notes:
 Examples:
   deepline tools execute hunter_email_verifier --input '{"email":"a@b.com"}'
   deepline tools execute hunter_email_verifier -p email=a@b.com
+  deepline tools execute test_rate_limit --input '{"key":"smoke"}' --timeout 90s --json
   deepline tools execute test_rate_limit --input '{"key":"smoke"}' --json | jq '.status'
   deepline tools execute free_simple_company_search --input '{"sql":"SELECT company_name FROM companies LIMIT 10"}' --out companies.csv
 `
@@ -47981,6 +48010,9 @@ Examples:
   ).option(
     "--payload <payload>",
     "Merge a JSON object or @file path into the tool params"
+  ).option(
+    "--timeout <duration>",
+    "Execution HTTP deadline (for example 90s, 5m, or 1h; bare numbers are seconds)"
   ).option(
     "--output-format <format>",
     "Output format: auto, csv, csv_file, json, or json_file"
@@ -47995,6 +48027,7 @@ Examples:
       ...typeof options.json === "string" ? ["--json", options.json] : [],
       ...options.input ? ["--input", options.input] : [],
       ...options.payload ? ["--payload", options.payload] : [],
+      ...options.timeout ? ["--timeout", options.timeout] : [],
       ...options.outputFormat ? ["--output-format", options.outputFormat] : [],
       ...options.out ? ["--out", options.out] : [],
       ...options.preview === false ? ["--no-preview"] : []
@@ -48747,8 +48780,10 @@ function toolInputFieldsForDisplay(inputSchema) {
       const jsonSchemaField = typeof field.name === "string" ? jsonSchemaFields.get(field.name) : void 0;
       const minItems = typeof field.minItems === "number" ? field.minItems : jsonSchemaField?.minItems;
       const maxItems = typeof field.maxItems === "number" ? field.maxItems : jsonSchemaField?.maxItems;
+      const items = isRecord12(field.items) ? field.items : jsonSchemaField?.items;
       return {
         ...field,
+        ...isRecord12(items) ? { items } : {},
         ...typeof minItems === "number" ? { minItems } : {},
         ...typeof maxItems === "number" ? { maxItems } : {}
       };
@@ -48764,6 +48799,7 @@ function toolInputFieldsForDisplay(inputSchema) {
       type: typeof property.type === "string" ? property.type : "unknown",
       required: required.has(name),
       description: property.description,
+      ...isRecord12(property.items) ? { items: property.items } : {},
       ...typeof property.minItems === "number" ? { minItems: property.minItems } : {},
       ...typeof property.maxItems === "number" ? { maxItems: property.maxItems } : {},
       ...Object.prototype.hasOwnProperty.call(property, "default") ? { default: property.default } : {}
@@ -48883,6 +48919,7 @@ function recursiveToolInputFieldsForDisplay(inputSchema) {
         required,
         description: schema.description,
         ...Array.isArray(schema.enum) ? { enum: schema.enum } : {},
+        ...isRecord12(schema.items) ? { items: schema.items } : {},
         ...typeof schema.minItems === "number" ? { minItems: schema.minItems } : {},
         ...typeof schema.maxItems === "number" ? { maxItems: schema.maxItems } : {},
         ...Object.prototype.hasOwnProperty.call(schema, "default") ? { default: schema.default } : {}
@@ -48917,25 +48954,31 @@ function recursiveToolInputFieldsForDisplay(inputSchema) {
   return fields.size ? [...fields.values()] : toolInputFieldsForDisplay(inputSchema);
 }
 function inputFieldJsonForDescribe(field) {
+  const publicItems = isRecord12(field.items) ? publicToolInputSchemaForDescribe({ items: field.items }).items : void 0;
   return {
     name: field.name,
     type: field.type ?? "unknown",
     required: Boolean(field.required),
     ...field.description ? { description: field.description } : {},
+    ...isRecord12(publicItems) ? { items: publicItems } : {},
     ...typeof field.minItems === "number" ? { minItems: field.minItems } : {},
     ...typeof field.maxItems === "number" ? { maxItems: field.maxItems } : {},
     ...Object.prototype.hasOwnProperty.call(field, "default") ? { default: field.default } : {}
   };
 }
 function arrayItemBoundsSuffix(field) {
+  const itemSchema = isRecord12(field.items) ? field.items : null;
+  const itemType = itemSchema ? typeof itemSchema.type === "string" ? itemSchema.type : isRecord12(itemSchema.properties) ? "object" : "unknown" : null;
+  const itemEnum = Array.isArray(itemSchema?.enum) ? ` enum=${itemSchema.enum.map(String).join("|")}` : "";
+  const itemTypeSuffix = itemType && itemType !== "unknown" ? ` items=${itemType}${itemEnum}` : "";
   const minItems = typeof field.minItems === "number" && Number.isFinite(field.minItems) ? field.minItems : null;
   const maxItems = typeof field.maxItems === "number" && Number.isFinite(field.maxItems) ? field.maxItems : null;
   if (minItems !== null && maxItems !== null) {
-    return ` items=${minItems}..${maxItems}`;
+    return itemTypeSuffix ? `${itemTypeSuffix} minItems=${minItems} maxItems=${maxItems}` : ` items=${minItems}..${maxItems}`;
   }
-  if (minItems !== null) return ` minItems=${minItems}`;
-  if (maxItems !== null) return ` maxItems=${maxItems}`;
-  return "";
+  if (minItems !== null) return `${itemTypeSuffix} minItems=${minItems}`;
+  if (maxItems !== null) return `${itemTypeSuffix} maxItems=${maxItems}`;
+  return itemTypeSuffix;
 }
 function printToolExecutionHints(value) {
   const batchCapabilityRecord = recordField2(
@@ -49224,13 +49267,14 @@ function parseExecuteOptions(args) {
   const toolId = args[0];
   if (!toolId) {
     throw new Error(
-      `Usage: deepline tools execute <toolId> [--param key=value ...] [--input '{"k":"v"}'] [--out rows.csv] [--output-format auto|csv|csv_file|json|json_file] [--no-preview]`
+      `Usage: deepline tools execute <toolId> [--param key=value ...] [--input '{"k":"v"}'] [--timeout <duration>] [--out rows.csv] [--output-format auto|csv|csv_file|json|json_file] [--no-preview]`
     );
   }
   const params = {};
   let outputFormat = "auto";
   let noPreview = false;
   let outPath = null;
+  let timeoutMs;
   for (let index = 1; index < args.length; index += 1) {
     const arg = args[index];
     if ((arg === "--param" || arg === "-p") && args[index + 1]) {
@@ -49254,6 +49298,10 @@ function parseExecuteOptions(args) {
       Object.assign(params, parseJsonObjectArgument(args[++index], arg));
       continue;
     }
+    if (arg === "--timeout" && args[index + 1]) {
+      timeoutMs = parseToolExecuteTimeout(args[++index]);
+      continue;
+    }
     if (arg === "--output-format" && args[index + 1]) {
       outputFormat = normalizeOutputFormat(args[++index]);
       continue;
@@ -49268,7 +49316,25 @@ function parseExecuteOptions(args) {
     }
     throw new Error(`Unknown option: ${arg}`);
   }
-  return { toolId, params, outputFormat, noPreview, outPath };
+  return { toolId, params, outputFormat, noPreview, outPath, timeoutMs };
+}
+function parseToolExecuteTimeout(raw) {
+  const match = /^(\d+)(ms|s|m|h)?$/i.exec(raw.trim());
+  if (!match) {
+    throw new Error(
+      "--timeout must be a duration like 500ms, 90s, 10m, or 1h (a bare number is seconds)."
+    );
+  }
+  const value = Number(match[1]);
+  const unit = (match[2] ?? "s").toLowerCase();
+  const factor = unit === "ms" ? 1 : unit === "s" ? 1e3 : unit === "m" ? 6e4 : 36e5;
+  const timeoutMs = value * factor;
+  if (!Number.isSafeInteger(timeoutMs) || timeoutMs < 1 || timeoutMs > 2147483647) {
+    throw new Error(
+      "--timeout must be between 1ms and 2147483647ms (24d 20h 31m 23s)."
+    );
+  }
+  return timeoutMs;
 }
 function safeFileStem(value) {
   return value.trim().replace(/[^a-zA-Z0-9_-]+/g, "-").replace(/^-+|-+$/g, "").slice(0, 64) || "tool";
@@ -49571,7 +49637,8 @@ async function executeTool(args) {
     return 2;
   }
   const rawResponse = await client2.executeTool(parsed.toolId, parsed.params, {
-    responseIntent: parsed.outPath || parsed.outputFormat === "csv" || parsed.outputFormat === "csv_file" ? "row_artifact" : "raw"
+    responseIntent: parsed.outPath || parsed.outputFormat === "csv" || parsed.outputFormat === "csv_file" ? "row_artifact" : "raw",
+    ...parsed.timeoutMs !== void 0 ? { timeout: parsed.timeoutMs } : {}
   });
   const listConversion = tryConvertToList(rawResponse, {
     listExtractorPaths: listExtractorPathsFromUsageGuidance(metadata)