@gullabs/xai 0.4.1 → 0.5.1

package/dist/index.d.cts

@@ -99,7 +99,7 @@ interface XaiResponseCreateParams {
     input: XaiInputItem[];
     instructions?: string;
     reasoning?: {
-        effort: 'low' | 'high';
+        effort: 'low' | 'medium' | 'high' | 'xhigh';
     };
     text?: {
         format: XaiTextFormat;
@@ -108,6 +108,11 @@ interface XaiResponseCreateParams {
     top_p?: number;
     max_output_tokens?: number;
     prompt_cache_key?: string;
+    /**
+     * Responses `service_tier`. Only `'priority'` is forwarded (live-verified
+     * on grok-4.6, 2026-08-12). Omitted when the caller did not request a tier.
+     */
+    service_tier?: 'priority';
     /** Always `false` — this library never relies on xAI-side conversation storage. */
     store: false;
 }
@@ -181,6 +186,11 @@ interface XaiResponseShape {
         effort?: string;
         summary?: string;
     };
+    /**
+     * Echoed served tier. Observed values: `"default"`, `"priority"`.
+     * Kept as a plain string — xAI may add further values.
+     */
+    service_tier?: string;
     store?: boolean;
     prompt_cache_key?: string | null;
     /**
@@ -230,28 +240,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 {
@@ -446,19 +451,53 @@ declare const Grok45ConfigSchema: z.ZodObject<{
     }, z.core.$strict>>;
 }, z.core.$strict>;
 
+/**
+ * Strict Zod config schema for xAI's `grok-4.6` model.
+ *
+ * Same Responses-API surface as grok-4.5, plus live-verified (2026-08-12)
+ * `reasoning.effort` of `'low' | 'medium' | 'high' | 'xhigh'` and
+ * `serviceTier: 'priority'`. `'none'` is rejected by the live API. Unknown
+ * tiers (`flex`, `standard`, `batch`) are rejected — `flex` is silently
+ * remapped to `default` by xAI, so this schema never admits it.
+ *
+ * @module
+ */
+
+declare const Grok46ConfigSchema: z.ZodObject<{
+    temperature: z.ZodOptional<z.ZodNumber>;
+    topP: z.ZodOptional<z.ZodNumber>;
+    maxOutputTokens: z.ZodOptional<z.ZodNumber>;
+    reasoning: z.ZodOptional<z.ZodObject<{
+        effort: z.ZodEnum<{
+            low: "low";
+            medium: "medium";
+            high: "high";
+            xhigh: "xhigh";
+        }>;
+    }, z.core.$strict>>;
+    serviceTier: z.ZodOptional<z.ZodLiteral<"priority">>;
+    timeoutMs: z.ZodOptional<z.ZodNumber>;
+    providerOptions: z.ZodOptional<z.ZodObject<{
+        xai: z.ZodOptional<z.ZodObject<{
+            promptCacheKey: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+
 /**
  * Model descriptor + registry for @gullabs/xai.
  *
- * v1 ships exactly one model: `grok-4.5` (canonical id only — the
- * `grok-4.5-latest` / `grok-build-latest` aliases visible in xAI's
- * `/v1/models` listing are intentionally NOT registered as separate
- * descriptors; reject-don't-map, callers must use `grok-4.5` verbatim).
+ * Ships two canonical models: `grok-4.5` and `grok-4.6`. xAI aliases
+ * (`grok-4.5-latest`, `grok-build-latest`) visible in `/v1/models` are
+ * intentionally NOT registered (reject-don't-map). `grok-4.6` has no
+ * aliases as of the 2026-08-12 `/v1/models` listing.
  *
  * @module
  */
 
 declare const grok45ModelDescriptor: ModelDescriptor;
-/** Every model descriptor `@gullabs/xai` contributes. v1 ships only grok-4.5. */
+declare const grok46ModelDescriptor: ModelDescriptor;
+/** Every model descriptor `@gullabs/xai` contributes. */
 declare const xaiModelDescriptors: ModelDescriptor[];
 declare const xaiRegistry: ModelRegistry;
 
@@ -474,35 +513,33 @@ declare const xaiRegistry: ModelRegistry;
  * (those are Gemini-only). `PricingSource` is provider-scoped by contract
  * (see `packages/core/src/ports.ts`); this module is xai's own.
  *
- * **Long-context tier.** grok-4.5 charges a premium when the GROSS input
- * token count exceeds 200,000 (`long_context_threshold` in xAI's
+ * **Long-context tier.** grok-4.5 / grok-4.6 charge a premium when the GROSS
+ * input token count exceeds 200,000 (`long_context_threshold` in xAI's
  * `/v1/models` listing). Selected by `inputTokens` (incl. cached), not by
  * billable input — mirrors core's `selectRates` convention exactly (strictly
  * greater than 200,000).
  *
- * **Service tiers.** xAI has no service-tier concept for grok-4.5 — there is
- * no `TIER_FACTOR`-equivalent here. `price()`'s `tier` param is accepted for
- * `PricingSource` structural conformance but any *defined* tier is treated
- * as unrecognized → unpriced (reject-don't-map), mirroring core's own
- * defensive stance for an unrecognized tier. `undefined` (no tier requested,
- * the only value xAI adapters ever pass — `xaiAdapter` rejects `serviceTier`
- * upstream) prices normally.
+ * **Service tiers.** grok-4.5 has none. grok-4.6 admits `'priority'`
+ * (echo live-verified 2026-08-12). The 2× multiplier is confirmed by
+ * fixture `12-grok-4-6-xhigh-priority.json` (`cost_in_usd_ticks` equals
+ * exactly 2× standard list). `'default'` (the value xAI echoes when no
+ * priority is served) and `undefined` (no tier requested) price at the
+ * standard list. Any other defined tier is unpriced (reject-don't-map).
  *
  * **Conversion factor.** xAI's `/v1/models` raw `*_token_price` fields are
  * in hundred-thousandths of a dollar per token (i.e. divide the raw integer
- * by 10,000 to get USD per million tokens): e.g. `grok-4.5`'s raw
- * `prompt_text_token_price: 20000` ÷ 10,000 = $2.00/M, which matches the
- * confirmed live-verified figure.
+ * by 10,000 to get USD per million tokens): e.g. `grok-4.6`'s raw
+ * `prompt_text_token_price: 20000` ÷ 10,000 = $2.00/M.
  *
- * Verified against `/v1/models` fixture captured 2026-07-09 (see
- * `docs/provider-plugins-and-xai-grok-4-5-plan.md` and the live-verification
- * fixture directory referenced in the commit-3 task brief).
+ * Verified against `/v1/models` on 2026-08-12. Prior snapshot
+ * `xai-2026-07-09` priced grok-4.5 cached input at $0.50 / $1.00; the live
+ * listing now reports $0.30 / $0.60.
  *
  * @module
  */
 
 /** Identifies this pricing snapshot — bump the date when rates change. */
-declare const xaiPricingVersion: "xai-2026-07-09";
+declare const xaiPricingVersion: "xai-2026-08-12";
 /**
  * Per-model rate entry (all values in µUSD per million tokens).
  *
@@ -521,6 +558,14 @@ interface XaiModelRates {
         cachedPerM: number;
         outputPerM: number;
     };
+    /**
+     * Multiplier for Responses `service_tier: "priority"`. Absent = this
+     * model does not admit priority (unpriced). Uncached standard-list 2×
+     * is confirmed by fixture `12-grok-4-6-xhigh-priority.json` ticks;
+     * cached and `gt200k` legs follow the official 2×-after-cache-discount
+     * docs rule (that fixture has cached=0 and input < 200k).
+     */
+    priorityFactor?: number;
 }
 /**
  * Frozen xAI pricing snapshot (per-1M in µUSD).
@@ -539,8 +584,10 @@ declare const XAI_PRICING: Readonly<Record<string, XaiModelRates>>;
  * **Algorithm** (mirrors `@gullabs/core`'s `computeCost` exactly, xai-owned):
  * 1. Look up rates for `model`; if not found, return an unpriced `Cost`
  *    (`microUsd: null`) naming the model.
- * 2. A defined `tier` is always unpriced (xai has no tiers; reject-don't-map).
- *    `undefined` prices normally.
+ * 2. `undefined` or `'default'` prices at the standard list.
+ *    `'priority'` applies `rates.priorityFactor` when present.
+ *    Any other defined tier, or `'priority'` on a model without
+ *    `priorityFactor`, is unpriced (reject-don't-map).
  * 3. Select base vs. `>200k` long-context rates from GROSS `inputTokens`.
  * 4. Billable input = `inputTokens − (cachedInputTokens ?? 0)`, clamped to 0.
  * 5. Round each component (input, cached, output) independently to the
@@ -558,7 +605,7 @@ declare function computeXaiCost(model: string, usage: Usage, tier?: string): Cos
  * import { xaiPricingSource } from '@gullabs/xai'
  *
  * const pricing = xaiPricingSource()
- * const cost = pricing.price('grok-4.5', usage)
+ * const cost = pricing.price('grok-4.6', usage)
  * ```
  */
 declare function xaiPricingSource(): PricingSource;
@@ -566,8 +613,9 @@ declare function xaiPricingSource(): PricingSource;
 /**
  * `xaiProvider` — {@link ProviderPlugin} factory for @gullabs/xai.
  *
- * Bundles the xAI Grok adapter, the `grok-4.5` model descriptor, and the
- * xai pricing source into a single plugin for {@link composeProviders}.
+ * Bundles the xAI Grok adapter, the `grok-4.5` / `grok-4.6` model
+ * descriptors, and the xai pricing source into a single plugin for
+ * {@link composeProviders}.
  *
  * @module
  */
@@ -576,8 +624,8 @@ declare function xaiPricingSource(): PricingSource;
  * Create a {@link ProviderPlugin} for the xAI Grok provider.
  *
  * @param opts - Forwarded to {@link xaiAdapter}.
- * @returns A plugin bundling the xAI adapter, the `grok-4.5` model
- *   descriptor, and the built-in xai pricing source.
+ * @returns A plugin bundling the xAI adapter, the `grok-4.5` / `grok-4.6`
+ *   model descriptors, and the built-in xai pricing source.
  *
  * @example
  * ```ts
@@ -591,4 +639,4 @@ declare function xaiPricingSource(): PricingSource;
  */
 declare function xaiProvider(opts?: XaiAdapterOptions): ProviderPlugin;
 
-export { type FileDeleteOptions, Grok45ConfigSchema, 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, 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, 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 };

package/dist/index.d.ts

@@ -99,7 +99,7 @@ interface XaiResponseCreateParams {
     input: XaiInputItem[];
     instructions?: string;
     reasoning?: {
-        effort: 'low' | 'high';
+        effort: 'low' | 'medium' | 'high' | 'xhigh';
     };
     text?: {
         format: XaiTextFormat;
@@ -108,6 +108,11 @@ interface XaiResponseCreateParams {
     top_p?: number;
     max_output_tokens?: number;
     prompt_cache_key?: string;
+    /**
+     * Responses `service_tier`. Only `'priority'` is forwarded (live-verified
+     * on grok-4.6, 2026-08-12). Omitted when the caller did not request a tier.
+     */
+    service_tier?: 'priority';
     /** Always `false` — this library never relies on xAI-side conversation storage. */
     store: false;
 }
@@ -181,6 +186,11 @@ interface XaiResponseShape {
         effort?: string;
         summary?: string;
     };
+    /**
+     * Echoed served tier. Observed values: `"default"`, `"priority"`.
+     * Kept as a plain string — xAI may add further values.
+     */
+    service_tier?: string;
     store?: boolean;
     prompt_cache_key?: string | null;
     /**
@@ -230,28 +240,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 {
@@ -446,19 +451,53 @@ declare const Grok45ConfigSchema: z.ZodObject<{
     }, z.core.$strict>>;
 }, z.core.$strict>;
 
+/**
+ * Strict Zod config schema for xAI's `grok-4.6` model.
+ *
+ * Same Responses-API surface as grok-4.5, plus live-verified (2026-08-12)
+ * `reasoning.effort` of `'low' | 'medium' | 'high' | 'xhigh'` and
+ * `serviceTier: 'priority'`. `'none'` is rejected by the live API. Unknown
+ * tiers (`flex`, `standard`, `batch`) are rejected — `flex` is silently
+ * remapped to `default` by xAI, so this schema never admits it.
+ *
+ * @module
+ */
+
+declare const Grok46ConfigSchema: z.ZodObject<{
+    temperature: z.ZodOptional<z.ZodNumber>;
+    topP: z.ZodOptional<z.ZodNumber>;
+    maxOutputTokens: z.ZodOptional<z.ZodNumber>;
+    reasoning: z.ZodOptional<z.ZodObject<{
+        effort: z.ZodEnum<{
+            low: "low";
+            medium: "medium";
+            high: "high";
+            xhigh: "xhigh";
+        }>;
+    }, z.core.$strict>>;
+    serviceTier: z.ZodOptional<z.ZodLiteral<"priority">>;
+    timeoutMs: z.ZodOptional<z.ZodNumber>;
+    providerOptions: z.ZodOptional<z.ZodObject<{
+        xai: z.ZodOptional<z.ZodObject<{
+            promptCacheKey: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+
 /**
  * Model descriptor + registry for @gullabs/xai.
  *
- * v1 ships exactly one model: `grok-4.5` (canonical id only — the
- * `grok-4.5-latest` / `grok-build-latest` aliases visible in xAI's
- * `/v1/models` listing are intentionally NOT registered as separate
- * descriptors; reject-don't-map, callers must use `grok-4.5` verbatim).
+ * Ships two canonical models: `grok-4.5` and `grok-4.6`. xAI aliases
+ * (`grok-4.5-latest`, `grok-build-latest`) visible in `/v1/models` are
+ * intentionally NOT registered (reject-don't-map). `grok-4.6` has no
+ * aliases as of the 2026-08-12 `/v1/models` listing.
  *
  * @module
  */
 
 declare const grok45ModelDescriptor: ModelDescriptor;
-/** Every model descriptor `@gullabs/xai` contributes. v1 ships only grok-4.5. */
+declare const grok46ModelDescriptor: ModelDescriptor;
+/** Every model descriptor `@gullabs/xai` contributes. */
 declare const xaiModelDescriptors: ModelDescriptor[];
 declare const xaiRegistry: ModelRegistry;
 
@@ -474,35 +513,33 @@ declare const xaiRegistry: ModelRegistry;
  * (those are Gemini-only). `PricingSource` is provider-scoped by contract
  * (see `packages/core/src/ports.ts`); this module is xai's own.
  *
- * **Long-context tier.** grok-4.5 charges a premium when the GROSS input
- * token count exceeds 200,000 (`long_context_threshold` in xAI's
+ * **Long-context tier.** grok-4.5 / grok-4.6 charge a premium when the GROSS
+ * input token count exceeds 200,000 (`long_context_threshold` in xAI's
  * `/v1/models` listing). Selected by `inputTokens` (incl. cached), not by
  * billable input — mirrors core's `selectRates` convention exactly (strictly
  * greater than 200,000).
  *
- * **Service tiers.** xAI has no service-tier concept for grok-4.5 — there is
- * no `TIER_FACTOR`-equivalent here. `price()`'s `tier` param is accepted for
- * `PricingSource` structural conformance but any *defined* tier is treated
- * as unrecognized → unpriced (reject-don't-map), mirroring core's own
- * defensive stance for an unrecognized tier. `undefined` (no tier requested,
- * the only value xAI adapters ever pass — `xaiAdapter` rejects `serviceTier`
- * upstream) prices normally.
+ * **Service tiers.** grok-4.5 has none. grok-4.6 admits `'priority'`
+ * (echo live-verified 2026-08-12). The 2× multiplier is confirmed by
+ * fixture `12-grok-4-6-xhigh-priority.json` (`cost_in_usd_ticks` equals
+ * exactly 2× standard list). `'default'` (the value xAI echoes when no
+ * priority is served) and `undefined` (no tier requested) price at the
+ * standard list. Any other defined tier is unpriced (reject-don't-map).
  *
  * **Conversion factor.** xAI's `/v1/models` raw `*_token_price` fields are
  * in hundred-thousandths of a dollar per token (i.e. divide the raw integer
- * by 10,000 to get USD per million tokens): e.g. `grok-4.5`'s raw
- * `prompt_text_token_price: 20000` ÷ 10,000 = $2.00/M, which matches the
- * confirmed live-verified figure.
+ * by 10,000 to get USD per million tokens): e.g. `grok-4.6`'s raw
+ * `prompt_text_token_price: 20000` ÷ 10,000 = $2.00/M.
  *
- * Verified against `/v1/models` fixture captured 2026-07-09 (see
- * `docs/provider-plugins-and-xai-grok-4-5-plan.md` and the live-verification
- * fixture directory referenced in the commit-3 task brief).
+ * Verified against `/v1/models` on 2026-08-12. Prior snapshot
+ * `xai-2026-07-09` priced grok-4.5 cached input at $0.50 / $1.00; the live
+ * listing now reports $0.30 / $0.60.
  *
  * @module
  */
 
 /** Identifies this pricing snapshot — bump the date when rates change. */
-declare const xaiPricingVersion: "xai-2026-07-09";
+declare const xaiPricingVersion: "xai-2026-08-12";
 /**
  * Per-model rate entry (all values in µUSD per million tokens).
  *
@@ -521,6 +558,14 @@ interface XaiModelRates {
         cachedPerM: number;
         outputPerM: number;
     };
+    /**
+     * Multiplier for Responses `service_tier: "priority"`. Absent = this
+     * model does not admit priority (unpriced). Uncached standard-list 2×
+     * is confirmed by fixture `12-grok-4-6-xhigh-priority.json` ticks;
+     * cached and `gt200k` legs follow the official 2×-after-cache-discount
+     * docs rule (that fixture has cached=0 and input < 200k).
+     */
+    priorityFactor?: number;
 }
 /**
  * Frozen xAI pricing snapshot (per-1M in µUSD).
@@ -539,8 +584,10 @@ declare const XAI_PRICING: Readonly<Record<string, XaiModelRates>>;
  * **Algorithm** (mirrors `@gullabs/core`'s `computeCost` exactly, xai-owned):
  * 1. Look up rates for `model`; if not found, return an unpriced `Cost`
  *    (`microUsd: null`) naming the model.
- * 2. A defined `tier` is always unpriced (xai has no tiers; reject-don't-map).
- *    `undefined` prices normally.
+ * 2. `undefined` or `'default'` prices at the standard list.
+ *    `'priority'` applies `rates.priorityFactor` when present.
+ *    Any other defined tier, or `'priority'` on a model without
+ *    `priorityFactor`, is unpriced (reject-don't-map).
  * 3. Select base vs. `>200k` long-context rates from GROSS `inputTokens`.
  * 4. Billable input = `inputTokens − (cachedInputTokens ?? 0)`, clamped to 0.
  * 5. Round each component (input, cached, output) independently to the
@@ -558,7 +605,7 @@ declare function computeXaiCost(model: string, usage: Usage, tier?: string): Cos
  * import { xaiPricingSource } from '@gullabs/xai'
  *
  * const pricing = xaiPricingSource()
- * const cost = pricing.price('grok-4.5', usage)
+ * const cost = pricing.price('grok-4.6', usage)
  * ```
  */
 declare function xaiPricingSource(): PricingSource;
@@ -566,8 +613,9 @@ declare function xaiPricingSource(): PricingSource;
 /**
  * `xaiProvider` — {@link ProviderPlugin} factory for @gullabs/xai.
  *
- * Bundles the xAI Grok adapter, the `grok-4.5` model descriptor, and the
- * xai pricing source into a single plugin for {@link composeProviders}.
+ * Bundles the xAI Grok adapter, the `grok-4.5` / `grok-4.6` model
+ * descriptors, and the xai pricing source into a single plugin for
+ * {@link composeProviders}.
  *
  * @module
  */
@@ -576,8 +624,8 @@ declare function xaiPricingSource(): PricingSource;
  * Create a {@link ProviderPlugin} for the xAI Grok provider.
  *
  * @param opts - Forwarded to {@link xaiAdapter}.
- * @returns A plugin bundling the xAI adapter, the `grok-4.5` model
- *   descriptor, and the built-in xai pricing source.
+ * @returns A plugin bundling the xAI adapter, the `grok-4.5` / `grok-4.6`
+ *   model descriptors, and the built-in xai pricing source.
  *
  * @example
  * ```ts
@@ -591,4 +639,4 @@ declare function xaiPricingSource(): PricingSource;
  */
 declare function xaiProvider(opts?: XaiAdapterOptions): ProviderPlugin;
 
-export { type FileDeleteOptions, Grok45ConfigSchema, 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, 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, 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 };