@ai-sdk/xai 3.0.96 → 3.0.97

package/docs/01-xai.mdx

@@ -121,9 +121,16 @@ await generateText({
 
 The following optional provider options are available for xAI chat models:
 
-- **reasoningEffort** _'low' | 'high'_
+- **reasoningEffort** _'none' | 'low' | 'medium' | 'high'_
 
-  Reasoning effort for reasoning models.
+  Reasoning effort for reasoning models. `'none'` disables reasoning entirely.
+
+<Note>
+  Not every Grok model accepts every reasoning effort, for example
+  `grok-build-0.1` does not support reasoning effort. See xAI's [reasoning
+  docs](https://docs.x.ai/docs/guides/reasoning) for the values each model
+  accepts.
+</Note>
 
 - **logprobs** _boolean_
 
@@ -454,9 +461,16 @@ const result = await generateText({
 
 The following provider options are available:
 
-- **reasoningEffort** _'low' | 'medium' | 'high'_
+- **reasoningEffort** _'none' | 'low' | 'medium' | 'high'_
 
-  Control the reasoning effort for the model. Higher effort may produce more thorough results at the cost of increased latency and token usage.
+  Control the reasoning effort for the model. Higher effort may produce more thorough results at the cost of increased latency and token usage. `'none'` disables reasoning entirely.
+
+<Note>
+  Not every Grok model accepts every reasoning effort, for example
+  `grok-build-0.1` does not support reasoning effort. See xAI's [reasoning
+  docs](https://docs.x.ai/docs/guides/reasoning) for the values each model
+  accepts.
+</Note>
 
 - **logprobs** _boolean_
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ai-sdk/xai",
-  "version": "3.0.96",
+  "version": "3.0.97",
   "license": "Apache-2.0",
   "sideEffects": false,
   "main": "./dist/index.js",

package/src/responses/xai-responses-options.ts

@@ -1,14 +1,11 @@
 import { z } from 'zod/v4';
 
 export type XaiResponsesModelId =
-  | 'grok-4-1-fast-reasoning'
-  | 'grok-4-1-fast-non-reasoning'
-  | 'grok-4'
-  | 'grok-4-fast-non-reasoning'
-  | 'grok-4-fast-reasoning'
-  | 'grok-4.20-0309-non-reasoning'
+  | 'grok-4.3'
   | 'grok-4.20-0309-reasoning'
+  | 'grok-4.20-0309-non-reasoning'
   | 'grok-4.20-multi-agent-0309'
+  | 'grok-build-0.1'
   | (string & {});
 
 /**
@@ -17,9 +14,11 @@ export type XaiResponsesModelId =
 export const xaiLanguageModelResponsesOptions = z.object({
   /**
    * Constrains how hard a reasoning model thinks before responding.
-   * Possible values are `low` (uses fewer reasoning tokens), `medium` and `high` (uses more reasoning tokens).
+   * Possible values are `none` (disables reasoning), `low` (uses fewer reasoning
+   * tokens), `medium` and `high` (uses more reasoning tokens). Not all models
+   * support reasoning effort; see xAI's docs for the values each model accepts.
    */
-  reasoningEffort: z.enum(['low', 'medium', 'high']).optional(),
+  reasoningEffort: z.enum(['none', 'low', 'medium', 'high']).optional(),
   logprobs: z.boolean().optional(),
   topLogprobs: z.number().int().min(0).max(8).optional(),
   /**

package/src/xai-chat-options.ts

@@ -2,21 +2,11 @@ import { z } from 'zod/v4';
 
 // https://docs.x.ai/docs/models
 export type XaiChatModelId =
-  | 'grok-4-1-fast-reasoning'
-  | 'grok-4-1-fast-non-reasoning'
-  | 'grok-4-fast-non-reasoning'
-  | 'grok-4-fast-reasoning'
-  | 'grok-4.20-0309-non-reasoning'
+  | 'grok-4.3'
   | 'grok-4.20-0309-reasoning'
+  | 'grok-4.20-0309-non-reasoning'
   | 'grok-4.20-multi-agent-0309'
-  | 'grok-code-fast-1'
-  | 'grok-4'
-  | 'grok-4-0709'
-  | 'grok-4-latest'
-  | 'grok-3'
-  | 'grok-3-latest'
-  | 'grok-3-mini'
-  | 'grok-3-mini-latest'
+  | 'grok-build-0.1'
   | (string & {});
 
 // search source schemas
@@ -61,7 +51,7 @@ const searchSourceSchema = z.discriminatedUnion('type', [
 
 // xai-specific provider options
 export const xaiLanguageModelChatOptions = z.object({
-  reasoningEffort: z.enum(['low', 'high']).optional(),
+  reasoningEffort: z.enum(['none', 'low', 'medium', 'high']).optional(),
   logprobs: z.boolean().optional(),
   topLogprobs: z.number().int().min(0).max(8).optional(),
 

package/src/xai-image-settings.ts

@@ -1,4 +1,4 @@
 export type XaiImageModelId =
   | 'grok-imagine-image'
-  | 'grok-imagine-image-pro'
+  | 'grok-imagine-image-quality'
   | (string & {});