@gullabs/xai 0.5.0 → 0.6.0

package/dist/index.d.ts

@@ -12,9 +12,29 @@ import { z } from 'zod';
  *
  * @module
  */
+type XaiWebSearchTool = {
+    type: 'web_search';
+    allowedDomains?: string[];
+    excludedDomains?: string[];
+    enableImageUnderstanding?: boolean;
+    enableImageSearch?: boolean;
+};
+type XaiXSearchTool = {
+    type: 'x_search';
+    allowedXHandles?: string[];
+    excludedXHandles?: string[];
+    fromDate?: string;
+    toDate?: string;
+    enableImageUnderstanding?: boolean;
+    enableVideoUnderstanding?: boolean;
+};
 type XaiProviderOptions = {
     /** xAI conversation-routing cache key — maps to Responses API `prompt_cache_key`. */
     promptCacheKey?: string;
+    /** Server-side Live Search tools (`web_search`, `x_search`). */
+    tools?: Array<XaiWebSearchTool | XaiXSearchTool>;
+    /** xAI-only; Gemini has no parallel-tool knob. */
+    parallelToolCalls?: boolean;
 };
 declare module '@gullabs/core' {
     interface ProviderOptionsMap {
@@ -73,6 +93,20 @@ interface XaiInputItem {
     role: 'user' | 'assistant' | 'system' | 'developer';
     content: XaiInputContentPart[];
 }
+/** Live-verified store:false replay item. */
+interface XaiFunctionCallInputItem {
+    type: 'function_call';
+    call_id: string;
+    name: string;
+    arguments: string;
+}
+/** Live-verified store:false replay item. */
+interface XaiFunctionCallOutputInputItem {
+    type: 'function_call_output';
+    call_id: string;
+    output: string;
+}
+type XaiRequestInputItem = XaiInputItem | XaiFunctionCallInputItem | XaiFunctionCallOutputInputItem;
 /**
  * Structured-output text-format request shape.
  * Real xAI field: `text.format`, NOT `response_format`.
@@ -96,7 +130,7 @@ type XaiTextFormat = {
  */
 interface XaiResponseCreateParams {
     model: string;
-    input: XaiInputItem[];
+    input: XaiRequestInputItem[];
     instructions?: string;
     reasoning?: {
         effort: 'low' | 'medium' | 'high' | 'xhigh';
@@ -115,6 +149,17 @@ interface XaiResponseCreateParams {
     service_tier?: 'priority';
     /** Always `false` — this library never relies on xAI-side conversation storage. */
     store: false;
+    /**
+     * Server-side and/or function tools. Wire names are snake_case.
+     * Shape is pinned from live 2026-08-24 fixtures.
+     */
+    tools?: Array<Record<string, unknown>>;
+    /** `'auto' | 'required' | 'none'` or live-verified `{ type: 'function', name }`. */
+    tool_choice?: string | {
+        type: 'function';
+        name: string;
+    };
+    parallel_tool_calls?: boolean;
 }
 /** A single summary-text segment of a `type: 'reasoning'` output item. */
 interface XaiReasoningSummaryPart {
@@ -143,8 +188,13 @@ interface XaiMessageOutputItem {
     status?: string;
     content: XaiOutputTextPart[];
 }
+/** Server-tool or function-call output items we do not collapse as messages. */
+interface XaiOtherOutputItem {
+    type: string;
+    [key: string]: unknown;
+}
 /** Union of output-item shapes the Responses API may return. */
-type XaiOutputItem = XaiReasoningOutputItem | XaiMessageOutputItem;
+type XaiOutputItem = XaiReasoningOutputItem | XaiMessageOutputItem | XaiOtherOutputItem;
 /**
  * Token usage metadata returned alongside an xAI response.
  *
@@ -200,6 +250,12 @@ interface XaiResponseShape {
     metadata?: {
         [key: string]: unknown;
     } | null;
+    /**
+     * Top-level citations array. Live 2026-08-24 search-tools probes returned
+     * `null`; citations arrived as `output_text.annotations` of type
+     * `url_citation` instead.
+     */
+    citations?: unknown;
 }
 /**
  * Structural interface for the `openai` SDK's `client.responses` surface
@@ -240,28 +296,23 @@ declare function buildXaiClient(auth: AuthMaterial): Promise<XaiClientLike>;
  * Classify a raw error thrown from the xAI Responses API call into a typed
  * {@link LlmError}.
  *
- * xAI's Responses API returns HTTP 400 (NOT 401) for an invalid API key, so
- * generic {@link classifyHttpStatus}-based classification (which maps 400 →
- * `bad_request`) is wrong for this one case. This function special-cases it:
- * a 400 response whose STRUCTURED parsed body matches the exact recorded
- * xAI auth-failure signature (`code: 'invalid-argument'` AND message prefix
- * `"Incorrect API key provided"` — see fixture 09) is reclassified as
- * `invalid_auth`. Free-form `Error.message` text is never scanned, so a 400
- * whose message merely *mentions* an API key (e.g. schema validation echoing
- * user content) stays `bad_request`. When the structured body is unavailable
- * or unparseable, classification falls through to the status-based
- * `classifyError` from `@gullabs/core`.
- *
- * A second special case widens `classifyError`'s generic fallback: when the
- * base classification lands on `kind: 'unknown'` (no HTTP status to route
- * by) AND the raw error matches a known transport-failure signature (see
- * {@link isXaiTransportError}), it is reclassified `kind: 'server',
- * retryable: true` — the same "provider fault, not caller fault, safe to
- * retry" bucket this adapter's `countTokens` path already uses for
- * provider-side failures with no HTTP status. A connection that never
- * reached xAI is not the caller's fault and is safe to retry; it must never
- * be surfaced as the non-retryable `unknown` kind, which Temporal treats as
- * fatal and uses to kill the run outright.
+ * HTTP status is a hint, not a kind. Overlays inspect the STRUCTURED parsed
+ * body only — never free-form `Error.message` — so echoed user content cannot
+ * change classification.
+ *
+ * 1. Already an {@link LlmError} → returned unchanged (including an untagged
+ *    one).
+ * 2. HTTP 400 whose structured body starts with
+ *    `"Incorrect API key provided"` (fixture 09; prefix only — the SDK may
+ *    drop `code`) → `invalid_auth`.
+ * 3. HTTP 403 whose structured body starts with
+ *    `"Content violates usage guidelines"` (fixture 15; `SAFETY_CHECK_TYPE_*`
+ *    suffixes vary) → `content_filter`. A bare 403 without that body stays
+ *    the core default, `invalid_auth`.
+ * 4. `kind: 'unknown'` with a known transport-failure signature (see
+ *    {@link isXaiTransportError}) → `server`, retryable. A connection that
+ *    never reached xAI is not the caller's fault.
+ * 5. Else rebuild the core classification tagged `provider: 'xai'`.
  */
 declare function classifyXaiError(rawErr: unknown): LlmError;
 interface XaiAdapterOptions {
@@ -280,6 +331,12 @@ interface XaiAdapterOptions {
      * Never set this in production code. Mirrors `GeminiAdapterOptions._clientFactory`.
      */
     _clientFactory?: (auth: AuthMaterial) => XaiClientLike | Promise<XaiClientLike>;
+    /**
+     * @internal Testing-only.
+     *
+     * Override `fetch` for `POST /v1/tokenize-text` (not on the openai SDK).
+     */
+    _fetch?: typeof fetch;
 }
 /**
  * Create an xAI Grok provider adapter (Responses API).
@@ -433,7 +490,8 @@ declare class XaiFileStore {
  * Mirrors `@gullabs/core`'s `packages/core/src/model-config/*.ts` doc-density
  * style, but is a single self-contained `z.strictObject` — unlike Gemini's
  * schemas, xai has no service-tier branching (no `z.union` of tier variants
- * needed), no `topK`, and only a single reasoning-effort union (`'low'|'high'`).
+ * needed), no `topK`, and a reasoning-effort union of `'low'|'medium'|'high'`
+ * (live-verified 2026-08-24).
  *
  * @module
  */
@@ -445,6 +503,7 @@ declare const Grok45ConfigSchema: z.ZodObject<{
     reasoning: z.ZodOptional<z.ZodObject<{
         effort: z.ZodEnum<{
             low: "low";
+            medium: "medium";
             high: "high";
         }>;
     }, z.core.$strict>>;
@@ -452,6 +511,110 @@ declare const Grok45ConfigSchema: z.ZodObject<{
     providerOptions: z.ZodOptional<z.ZodObject<{
         xai: z.ZodOptional<z.ZodObject<{
             promptCacheKey: z.ZodOptional<z.ZodString>;
+            tools: z.ZodOptional<z.ZodUnion<readonly [z.ZodTuple<[z.ZodUnion<readonly [z.ZodObject<{
+                enableImageUnderstanding: z.ZodOptional<z.ZodBoolean>;
+                enableImageSearch: z.ZodOptional<z.ZodBoolean>;
+                type: z.ZodLiteral<"web_search">;
+                allowedDomains: z.ZodArray<z.ZodString>;
+            }, z.core.$strict>, z.ZodObject<{
+                enableImageUnderstanding: z.ZodOptional<z.ZodBoolean>;
+                enableImageSearch: z.ZodOptional<z.ZodBoolean>;
+                type: z.ZodLiteral<"web_search">;
+                excludedDomains: z.ZodArray<z.ZodString>;
+            }, z.core.$strict>, z.ZodObject<{
+                enableImageUnderstanding: z.ZodOptional<z.ZodBoolean>;
+                enableImageSearch: z.ZodOptional<z.ZodBoolean>;
+                type: z.ZodLiteral<"web_search">;
+            }, z.core.$strict>]>], null>, z.ZodTuple<[z.ZodUnion<readonly [z.ZodObject<{
+                fromDate: z.ZodOptional<z.ZodISODate>;
+                toDate: z.ZodOptional<z.ZodISODate>;
+                enableImageUnderstanding: z.ZodOptional<z.ZodBoolean>;
+                enableVideoUnderstanding: z.ZodOptional<z.ZodBoolean>;
+                type: z.ZodLiteral<"x_search">;
+                allowedXHandles: z.ZodArray<z.ZodString>;
+            }, z.core.$strict>, z.ZodObject<{
+                fromDate: z.ZodOptional<z.ZodISODate>;
+                toDate: z.ZodOptional<z.ZodISODate>;
+                enableImageUnderstanding: z.ZodOptional<z.ZodBoolean>;
+                enableVideoUnderstanding: z.ZodOptional<z.ZodBoolean>;
+                type: z.ZodLiteral<"x_search">;
+                excludedXHandles: z.ZodArray<z.ZodString>;
+            }, z.core.$strict>, z.ZodObject<{
+                fromDate: z.ZodOptional<z.ZodISODate>;
+                toDate: z.ZodOptional<z.ZodISODate>;
+                enableImageUnderstanding: z.ZodOptional<z.ZodBoolean>;
+                enableVideoUnderstanding: z.ZodOptional<z.ZodBoolean>;
+                type: z.ZodLiteral<"x_search">;
+            }, z.core.$strict>]>], null>, z.ZodTuple<[z.ZodUnion<readonly [z.ZodObject<{
+                enableImageUnderstanding: z.ZodOptional<z.ZodBoolean>;
+                enableImageSearch: z.ZodOptional<z.ZodBoolean>;
+                type: z.ZodLiteral<"web_search">;
+                allowedDomains: z.ZodArray<z.ZodString>;
+            }, z.core.$strict>, z.ZodObject<{
+                enableImageUnderstanding: z.ZodOptional<z.ZodBoolean>;
+                enableImageSearch: z.ZodOptional<z.ZodBoolean>;
+                type: z.ZodLiteral<"web_search">;
+                excludedDomains: z.ZodArray<z.ZodString>;
+            }, z.core.$strict>, z.ZodObject<{
+                enableImageUnderstanding: z.ZodOptional<z.ZodBoolean>;
+                enableImageSearch: z.ZodOptional<z.ZodBoolean>;
+                type: z.ZodLiteral<"web_search">;
+            }, z.core.$strict>]>, z.ZodUnion<readonly [z.ZodObject<{
+                fromDate: z.ZodOptional<z.ZodISODate>;
+                toDate: z.ZodOptional<z.ZodISODate>;
+                enableImageUnderstanding: z.ZodOptional<z.ZodBoolean>;
+                enableVideoUnderstanding: z.ZodOptional<z.ZodBoolean>;
+                type: z.ZodLiteral<"x_search">;
+                allowedXHandles: z.ZodArray<z.ZodString>;
+            }, z.core.$strict>, z.ZodObject<{
+                fromDate: z.ZodOptional<z.ZodISODate>;
+                toDate: z.ZodOptional<z.ZodISODate>;
+                enableImageUnderstanding: z.ZodOptional<z.ZodBoolean>;
+                enableVideoUnderstanding: z.ZodOptional<z.ZodBoolean>;
+                type: z.ZodLiteral<"x_search">;
+                excludedXHandles: z.ZodArray<z.ZodString>;
+            }, z.core.$strict>, z.ZodObject<{
+                fromDate: z.ZodOptional<z.ZodISODate>;
+                toDate: z.ZodOptional<z.ZodISODate>;
+                enableImageUnderstanding: z.ZodOptional<z.ZodBoolean>;
+                enableVideoUnderstanding: z.ZodOptional<z.ZodBoolean>;
+                type: z.ZodLiteral<"x_search">;
+            }, z.core.$strict>]>], null>, z.ZodTuple<[z.ZodUnion<readonly [z.ZodObject<{
+                fromDate: z.ZodOptional<z.ZodISODate>;
+                toDate: z.ZodOptional<z.ZodISODate>;
+                enableImageUnderstanding: z.ZodOptional<z.ZodBoolean>;
+                enableVideoUnderstanding: z.ZodOptional<z.ZodBoolean>;
+                type: z.ZodLiteral<"x_search">;
+                allowedXHandles: z.ZodArray<z.ZodString>;
+            }, z.core.$strict>, z.ZodObject<{
+                fromDate: z.ZodOptional<z.ZodISODate>;
+                toDate: z.ZodOptional<z.ZodISODate>;
+                enableImageUnderstanding: z.ZodOptional<z.ZodBoolean>;
+                enableVideoUnderstanding: z.ZodOptional<z.ZodBoolean>;
+                type: z.ZodLiteral<"x_search">;
+                excludedXHandles: z.ZodArray<z.ZodString>;
+            }, z.core.$strict>, z.ZodObject<{
+                fromDate: z.ZodOptional<z.ZodISODate>;
+                toDate: z.ZodOptional<z.ZodISODate>;
+                enableImageUnderstanding: z.ZodOptional<z.ZodBoolean>;
+                enableVideoUnderstanding: z.ZodOptional<z.ZodBoolean>;
+                type: z.ZodLiteral<"x_search">;
+            }, z.core.$strict>]>, z.ZodUnion<readonly [z.ZodObject<{
+                enableImageUnderstanding: z.ZodOptional<z.ZodBoolean>;
+                enableImageSearch: z.ZodOptional<z.ZodBoolean>;
+                type: z.ZodLiteral<"web_search">;
+                allowedDomains: z.ZodArray<z.ZodString>;
+            }, z.core.$strict>, z.ZodObject<{
+                enableImageUnderstanding: z.ZodOptional<z.ZodBoolean>;
+                enableImageSearch: z.ZodOptional<z.ZodBoolean>;
+                type: z.ZodLiteral<"web_search">;
+                excludedDomains: z.ZodArray<z.ZodString>;
+            }, z.core.$strict>, z.ZodObject<{
+                enableImageUnderstanding: z.ZodOptional<z.ZodBoolean>;
+                enableImageSearch: z.ZodOptional<z.ZodBoolean>;
+                type: z.ZodLiteral<"web_search">;
+            }, z.core.$strict>]>], null>]>>;
+            parallelToolCalls: z.ZodOptional<z.ZodBoolean>;
         }, z.core.$strict>>;
     }, z.core.$strict>>;
 }, z.core.$strict>;
@@ -485,6 +648,110 @@ declare const Grok46ConfigSchema: z.ZodObject<{
     providerOptions: z.ZodOptional<z.ZodObject<{
         xai: z.ZodOptional<z.ZodObject<{
             promptCacheKey: z.ZodOptional<z.ZodString>;
+            tools: z.ZodOptional<z.ZodUnion<readonly [z.ZodTuple<[z.ZodUnion<readonly [z.ZodObject<{
+                enableImageUnderstanding: z.ZodOptional<z.ZodBoolean>;
+                enableImageSearch: z.ZodOptional<z.ZodBoolean>;
+                type: z.ZodLiteral<"web_search">;
+                allowedDomains: z.ZodArray<z.ZodString>;
+            }, z.core.$strict>, z.ZodObject<{
+                enableImageUnderstanding: z.ZodOptional<z.ZodBoolean>;
+                enableImageSearch: z.ZodOptional<z.ZodBoolean>;
+                type: z.ZodLiteral<"web_search">;
+                excludedDomains: z.ZodArray<z.ZodString>;
+            }, z.core.$strict>, z.ZodObject<{
+                enableImageUnderstanding: z.ZodOptional<z.ZodBoolean>;
+                enableImageSearch: z.ZodOptional<z.ZodBoolean>;
+                type: z.ZodLiteral<"web_search">;
+            }, z.core.$strict>]>], null>, z.ZodTuple<[z.ZodUnion<readonly [z.ZodObject<{
+                fromDate: z.ZodOptional<z.ZodISODate>;
+                toDate: z.ZodOptional<z.ZodISODate>;
+                enableImageUnderstanding: z.ZodOptional<z.ZodBoolean>;
+                enableVideoUnderstanding: z.ZodOptional<z.ZodBoolean>;
+                type: z.ZodLiteral<"x_search">;
+                allowedXHandles: z.ZodArray<z.ZodString>;
+            }, z.core.$strict>, z.ZodObject<{
+                fromDate: z.ZodOptional<z.ZodISODate>;
+                toDate: z.ZodOptional<z.ZodISODate>;
+                enableImageUnderstanding: z.ZodOptional<z.ZodBoolean>;
+                enableVideoUnderstanding: z.ZodOptional<z.ZodBoolean>;
+                type: z.ZodLiteral<"x_search">;
+                excludedXHandles: z.ZodArray<z.ZodString>;
+            }, z.core.$strict>, z.ZodObject<{
+                fromDate: z.ZodOptional<z.ZodISODate>;
+                toDate: z.ZodOptional<z.ZodISODate>;
+                enableImageUnderstanding: z.ZodOptional<z.ZodBoolean>;
+                enableVideoUnderstanding: z.ZodOptional<z.ZodBoolean>;
+                type: z.ZodLiteral<"x_search">;
+            }, z.core.$strict>]>], null>, z.ZodTuple<[z.ZodUnion<readonly [z.ZodObject<{
+                enableImageUnderstanding: z.ZodOptional<z.ZodBoolean>;
+                enableImageSearch: z.ZodOptional<z.ZodBoolean>;
+                type: z.ZodLiteral<"web_search">;
+                allowedDomains: z.ZodArray<z.ZodString>;
+            }, z.core.$strict>, z.ZodObject<{
+                enableImageUnderstanding: z.ZodOptional<z.ZodBoolean>;
+                enableImageSearch: z.ZodOptional<z.ZodBoolean>;
+                type: z.ZodLiteral<"web_search">;
+                excludedDomains: z.ZodArray<z.ZodString>;
+            }, z.core.$strict>, z.ZodObject<{
+                enableImageUnderstanding: z.ZodOptional<z.ZodBoolean>;
+                enableImageSearch: z.ZodOptional<z.ZodBoolean>;
+                type: z.ZodLiteral<"web_search">;
+            }, z.core.$strict>]>, z.ZodUnion<readonly [z.ZodObject<{
+                fromDate: z.ZodOptional<z.ZodISODate>;
+                toDate: z.ZodOptional<z.ZodISODate>;
+                enableImageUnderstanding: z.ZodOptional<z.ZodBoolean>;
+                enableVideoUnderstanding: z.ZodOptional<z.ZodBoolean>;
+                type: z.ZodLiteral<"x_search">;
+                allowedXHandles: z.ZodArray<z.ZodString>;
+            }, z.core.$strict>, z.ZodObject<{
+                fromDate: z.ZodOptional<z.ZodISODate>;
+                toDate: z.ZodOptional<z.ZodISODate>;
+                enableImageUnderstanding: z.ZodOptional<z.ZodBoolean>;
+                enableVideoUnderstanding: z.ZodOptional<z.ZodBoolean>;
+                type: z.ZodLiteral<"x_search">;
+                excludedXHandles: z.ZodArray<z.ZodString>;
+            }, z.core.$strict>, z.ZodObject<{
+                fromDate: z.ZodOptional<z.ZodISODate>;
+                toDate: z.ZodOptional<z.ZodISODate>;
+                enableImageUnderstanding: z.ZodOptional<z.ZodBoolean>;
+                enableVideoUnderstanding: z.ZodOptional<z.ZodBoolean>;
+                type: z.ZodLiteral<"x_search">;
+            }, z.core.$strict>]>], null>, z.ZodTuple<[z.ZodUnion<readonly [z.ZodObject<{
+                fromDate: z.ZodOptional<z.ZodISODate>;
+                toDate: z.ZodOptional<z.ZodISODate>;
+                enableImageUnderstanding: z.ZodOptional<z.ZodBoolean>;
+                enableVideoUnderstanding: z.ZodOptional<z.ZodBoolean>;
+                type: z.ZodLiteral<"x_search">;
+                allowedXHandles: z.ZodArray<z.ZodString>;
+            }, z.core.$strict>, z.ZodObject<{
+                fromDate: z.ZodOptional<z.ZodISODate>;
+                toDate: z.ZodOptional<z.ZodISODate>;
+                enableImageUnderstanding: z.ZodOptional<z.ZodBoolean>;
+                enableVideoUnderstanding: z.ZodOptional<z.ZodBoolean>;
+                type: z.ZodLiteral<"x_search">;
+                excludedXHandles: z.ZodArray<z.ZodString>;
+            }, z.core.$strict>, z.ZodObject<{
+                fromDate: z.ZodOptional<z.ZodISODate>;
+                toDate: z.ZodOptional<z.ZodISODate>;
+                enableImageUnderstanding: z.ZodOptional<z.ZodBoolean>;
+                enableVideoUnderstanding: z.ZodOptional<z.ZodBoolean>;
+                type: z.ZodLiteral<"x_search">;
+            }, z.core.$strict>]>, z.ZodUnion<readonly [z.ZodObject<{
+                enableImageUnderstanding: z.ZodOptional<z.ZodBoolean>;
+                enableImageSearch: z.ZodOptional<z.ZodBoolean>;
+                type: z.ZodLiteral<"web_search">;
+                allowedDomains: z.ZodArray<z.ZodString>;
+            }, z.core.$strict>, z.ZodObject<{
+                enableImageUnderstanding: z.ZodOptional<z.ZodBoolean>;
+                enableImageSearch: z.ZodOptional<z.ZodBoolean>;
+                type: z.ZodLiteral<"web_search">;
+                excludedDomains: z.ZodArray<z.ZodString>;
+            }, z.core.$strict>, z.ZodObject<{
+                enableImageUnderstanding: z.ZodOptional<z.ZodBoolean>;
+                enableImageSearch: z.ZodOptional<z.ZodBoolean>;
+                type: z.ZodLiteral<"web_search">;
+            }, z.core.$strict>]>], null>]>>;
+            parallelToolCalls: z.ZodOptional<z.ZodBoolean>;
         }, z.core.$strict>>;
     }, z.core.$strict>>;
 }, z.core.$strict>;
@@ -544,7 +811,16 @@ declare const xaiRegistry: ModelRegistry;
  */
 
 /** Identifies this pricing snapshot — bump the date when rates change. */
-declare const xaiPricingVersion: "xai-2026-08-12";
+declare const xaiPricingVersion: "xai-2026-08-24";
+/**
+ * Live-pinned 2026-08-24 per-invocation tool rates (µUSD per call).
+ * Source: `usage.server_side_tool_usage_details` on /v1/responses.
+ * $5 / 1,000 web or X searches; $10 / 1,000 attachment/document searches.
+ */
+declare const XAI_TOOL_RATE_MICRO_USD: {
+    readonly web_search_calls: 5000;
+    readonly x_search_calls: 5000;
+};
 /**
  * Per-model rate entry (all values in µUSD per million tokens).
  *
@@ -597,8 +873,13 @@ declare const XAI_PRICING: Readonly<Record<string, XaiModelRates>>;
  * 4. Billable input = `inputTokens − (cachedInputTokens ?? 0)`, clamped to 0.
  * 5. Round each component (input, cached, output) independently to the
  *    nearest integer micro-USD.
- * 6. `microUsd` is the sum of the three components — guarantees
- *    `details.input + details.cached + details.output === microUsd` exactly.
+ * 6. `microUsd` is the sum of the four components — guarantees
+ *    `details.input + details.cached + details.output + details.tools === microUsd`.
+ * 7. Tool lanes: live-pinned counters `web_search_calls`, `x_search_calls`,
+ *    `document_search_calls`. If `usage.details.server_tools_requested === 1`
+ *    and those counters are absent, token lanes are priced, `tools: 0`,
+ *    `confidence: 'estimated'`. `'exact'` requires counters present or no
+ *    server tools requested.
  */
 declare function computeXaiCost(model: string, usage: Usage, tier?: string): Cost;
 /**
@@ -644,4 +925,4 @@ declare function xaiPricingSource(): PricingSource;
  */
 declare function xaiProvider(opts?: XaiAdapterOptions): ProviderPlugin;
 
-export { type FileDeleteOptions, Grok45ConfigSchema, Grok46ConfigSchema, XAI_FILES_DEFAULT_BASE_URL, XAI_FILE_MAX_BYTES, XAI_FILE_TTL_MAX_SECONDS, XAI_FILE_TTL_MIN_SECONDS, XAI_PRICING, type XaiAdapterOptions, type XaiClientLike, type XaiFileHandle, type XaiFileListOptions, type XaiFileListResult, XaiFileStore, type XaiFileStoreOptions, type XaiFileUploadInput, type XaiInputContentPart, type XaiInputFilePart, type XaiInputImagePart, type XaiInputItem, type XaiInputTextPart, type XaiMessageOutputItem, type XaiModelRates, type XaiOutputItem, type XaiOutputTextPart, type XaiProviderOptions, type XaiReasoningOutputItem, type XaiReasoningSummaryPart, type XaiResponseCreateParams, type XaiResponseShape, type XaiTextFormat, type XaiUsageShape, buildXaiClient, classifyXaiError, computeXaiCost, grok45ModelDescriptor, grok46ModelDescriptor, requireApiKey, xaiAdapter, xaiModelDescriptors, xaiPricingSource, xaiPricingVersion, xaiProvider, xaiRegistry };
+export { type FileDeleteOptions, Grok45ConfigSchema, Grok46ConfigSchema, XAI_FILES_DEFAULT_BASE_URL, XAI_FILE_MAX_BYTES, XAI_FILE_TTL_MAX_SECONDS, XAI_FILE_TTL_MIN_SECONDS, XAI_PRICING, XAI_TOOL_RATE_MICRO_USD, type XaiAdapterOptions, type XaiClientLike, type XaiFileHandle, type XaiFileListOptions, type XaiFileListResult, XaiFileStore, type XaiFileStoreOptions, type XaiFileUploadInput, type XaiInputContentPart, type XaiInputFilePart, type XaiInputImagePart, type XaiInputItem, type XaiInputTextPart, type XaiMessageOutputItem, type XaiModelRates, type XaiOutputItem, type XaiOutputTextPart, type XaiProviderOptions, type XaiReasoningOutputItem, type XaiReasoningSummaryPart, type XaiResponseCreateParams, type XaiResponseShape, type XaiTextFormat, type XaiUsageShape, type XaiWebSearchTool, type XaiXSearchTool, buildXaiClient, classifyXaiError, computeXaiCost, grok45ModelDescriptor, grok46ModelDescriptor, requireApiKey, xaiAdapter, xaiModelDescriptors, xaiPricingSource, xaiPricingVersion, xaiProvider, xaiRegistry };