@ai-sdk/xai 4.0.0-beta.35 → 4.0.0-beta.37

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ai-sdk/xai",
-  "version": "4.0.0-beta.35",
+  "version": "4.0.0-beta.37",
   "type": "module",
   "license": "Apache-2.0",
   "sideEffects": false,
@@ -29,9 +29,9 @@
     }
   },
   "dependencies": {
-    "@ai-sdk/openai-compatible": "3.0.0-beta.24",
-    "@ai-sdk/provider": "4.0.0-beta.11",
-    "@ai-sdk/provider-utils": "5.0.0-beta.19"
+    "@ai-sdk/provider-utils": "5.0.0-beta.20",
+    "@ai-sdk/openai-compatible": "3.0.0-beta.25",
+    "@ai-sdk/provider": "4.0.0-beta.12"
   },
   "devDependencies": {
     "@types/node": "20.17.24",

package/src/responses/convert-to-xai-responses-input.ts

@@ -135,7 +135,48 @@ export async function convertToXaiResponsesInput({
               break;
             }
 
-            case 'reasoning':
+            case 'reasoning': {
+              const itemId =
+                typeof part.providerOptions?.xai?.itemId === 'string'
+                  ? part.providerOptions.xai.itemId
+                  : undefined;
+              const encryptedContent =
+                typeof part.providerOptions?.xai?.reasoningEncryptedContent ===
+                'string'
+                  ? part.providerOptions.xai.reasoningEncryptedContent
+                  : undefined;
+
+              if (itemId != null || encryptedContent != null) {
+                const summaryParts: Array<{
+                  type: 'summary_text';
+                  text: string;
+                }> = [];
+                if (part.text.length > 0) {
+                  summaryParts.push({
+                    type: 'summary_text',
+                    text: part.text,
+                  });
+                }
+
+                input.push({
+                  type: 'reasoning',
+                  id: itemId ?? '',
+                  summary: summaryParts,
+                  status: 'completed',
+                  ...(encryptedContent != null && {
+                    encrypted_content: encryptedContent,
+                  }),
+                });
+              } else {
+                inputWarnings.push({
+                  type: 'other',
+                  message:
+                    'Reasoning parts without itemId or encrypted content cannot be sent back to xAI. Skipping.',
+                });
+              }
+              break;
+            }
+
             case 'reasoning-file':
             case 'custom':
             case 'file': {

package/src/responses/xai-responses-language-model.ts

@@ -19,6 +19,9 @@ import {
   parseProviderOptions,
   ParseResult,
   postJsonToApi,
+  serializeModelOptions,
+  WORKFLOW_SERIALIZE,
+  WORKFLOW_DESERIALIZE,
 } from '@ai-sdk/provider-utils';
 import { z } from 'zod/v4';
 import { getResponseMetadata } from '../get-response-metadata';
@@ -40,7 +43,7 @@ import { prepareResponsesTools } from './xai-responses-prepare-tools';
 type XaiResponsesConfig = {
   provider: string;
   baseURL: string | undefined;
-  headers: () => Record<string, string | undefined>;
+  headers?: () => Record<string, string | undefined>;
   generateId: () => string;
   fetch?: FetchFunction;
 };
@@ -52,6 +55,20 @@ export class XaiResponsesLanguageModel implements LanguageModelV4 {
 
   private readonly config: XaiResponsesConfig;
 
+  static [WORKFLOW_SERIALIZE](model: XaiResponsesLanguageModel) {
+    return serializeModelOptions({
+      modelId: model.modelId,
+      config: model.config,
+    });
+  }
+
+  static [WORKFLOW_DESERIALIZE](options: {
+    modelId: XaiResponsesModelId;
+    config: XaiResponsesConfig;
+  }) {
+    return new XaiResponsesLanguageModel(options.modelId, options.config);
+  }
+
   constructor(modelId: XaiResponsesModelId, config: XaiResponsesConfig) {
     this.modelId = modelId;
     this.config = config;
@@ -113,7 +130,7 @@ export class XaiResponsesLanguageModel implements LanguageModelV4 {
 
     const { input, inputWarnings } = await convertToXaiResponsesInput({
       prompt,
-      store: true,
+      store: options.store ?? true,
     });
     warnings.push(...inputWarnings);
 
@@ -246,7 +263,7 @@ export class XaiResponsesLanguageModel implements LanguageModelV4 {
       rawValue: rawResponse,
     } = await postJsonToApi({
       url: `${this.config.baseURL ?? 'https://api.x.ai/v1'}/responses`,
-      headers: combineHeaders(this.config.headers(), options.headers),
+      headers: combineHeaders(this.config.headers?.(), options.headers),
       body,
       failedResponseHandler: xaiFailedResponseHandler,
       successfulResponseHandler: createJsonResponseHandler(
@@ -400,11 +417,13 @@ export class XaiResponsesLanguageModel implements LanguageModelV4 {
             .filter(text => text && text.length > 0)
             .join('');
 
-          if (reasoningText) {
-            if (part.encrypted_content || part.id) {
-              content.push({
-                type: 'reasoning',
-                text: reasoningText,
+          // condition changed here since encrypted content can now come with empty reasoning text
+          if (reasoningText || part.encrypted_content) {
+            const hasMetadata = part.encrypted_content || part.id;
+            content.push({
+              type: 'reasoning',
+              text: reasoningText,
+              ...(hasMetadata && {
                 providerMetadata: {
                   xai: {
                     ...(part.encrypted_content && {
@@ -413,13 +432,8 @@ export class XaiResponsesLanguageModel implements LanguageModelV4 {
                     ...(part.id && { itemId: part.id }),
                   },
                 },
-              });
-            } else {
-              content.push({
-                type: 'reasoning',
-                text: reasoningText,
-              });
-            }
+              }),
+            });
           }
           break;
         }
@@ -473,7 +487,7 @@ export class XaiResponsesLanguageModel implements LanguageModelV4 {
 
     const { responseHeaders, value: response } = await postJsonToApi({
       url: `${this.config.baseURL ?? 'https://api.x.ai/v1'}/responses`,
-      headers: combineHeaders(this.config.headers(), options.headers),
+      headers: combineHeaders(this.config.headers?.(), options.headers),
       body,
       failedResponseHandler: xaiFailedResponseHandler,
       successfulResponseHandler: createEventSourceResponseHandler(

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

@@ -25,6 +25,8 @@ export const xaiLanguageModelResponsesOptions = z.object({
   topLogprobs: z.number().int().min(0).max(8).optional(),
   /**
    * Whether to store the input message(s) and model response for later retrieval.
+   * Must be set to `false` for teams with Zero Data Retention (ZDR) enabled,
+   * otherwise the API will return an error.
    * @default true
    */
   store: z.boolean().optional(),

package/src/xai-chat-language-model.ts

@@ -22,6 +22,9 @@ import {
   ParseResult,
   postJsonToApi,
   safeParseJSON,
+  serializeModelOptions,
+  WORKFLOW_SERIALIZE,
+  WORKFLOW_DESERIALIZE,
 } from '@ai-sdk/provider-utils';
 import { z } from 'zod/v4';
 import { convertToXaiChatMessages } from './convert-to-xai-chat-messages';
@@ -38,7 +41,7 @@ import { prepareTools } from './xai-prepare-tools';
 type XaiChatConfig = {
   provider: string;
   baseURL: string | undefined;
-  headers: () => Record<string, string | undefined>;
+  headers?: () => Record<string, string | undefined>;
   generateId: () => string;
   fetch?: FetchFunction;
 };
@@ -50,6 +53,20 @@ export class XaiChatLanguageModel implements LanguageModelV4 {
 
   private readonly config: XaiChatConfig;
 
+  static [WORKFLOW_SERIALIZE](model: XaiChatLanguageModel) {
+    return serializeModelOptions({
+      modelId: model.modelId,
+      config: model.config,
+    });
+  }
+
+  static [WORKFLOW_DESERIALIZE](options: {
+    modelId: XaiChatModelId;
+    config: XaiChatConfig;
+  }) {
+    return new XaiChatLanguageModel(options.modelId, options.config);
+  }
+
   constructor(modelId: XaiChatModelId, config: XaiChatConfig) {
     this.modelId = modelId;
     this.config = config;
@@ -233,7 +250,7 @@ export class XaiChatLanguageModel implements LanguageModelV4 {
       rawValue: rawResponse,
     } = await postJsonToApi({
       url,
-      headers: combineHeaders(this.config.headers(), options.headers),
+      headers: combineHeaders(this.config.headers?.(), options.headers),
       body,
       failedResponseHandler: xaiFailedResponseHandler,
       successfulResponseHandler: createJsonResponseHandler(
@@ -346,7 +363,7 @@ export class XaiChatLanguageModel implements LanguageModelV4 {
 
     const { responseHeaders, value: response } = await postJsonToApi({
       url,
-      headers: combineHeaders(this.config.headers(), options.headers),
+      headers: combineHeaders(this.config.headers?.(), options.headers),
       body,
       failedResponseHandler: xaiFailedResponseHandler,
       successfulResponseHandler: async ({ response }) => {

package/src/xai-image-model.ts

@@ -9,6 +9,9 @@ import {
   getFromApi,
   parseProviderOptions,
   postJsonToApi,
+  serializeModelOptions,
+  WORKFLOW_SERIALIZE,
+  WORKFLOW_DESERIALIZE,
 } from '@ai-sdk/provider-utils';
 import { z } from 'zod/v4';
 import { xaiFailedResponseHandler } from './xai-error';
@@ -18,7 +21,7 @@ import { XaiImageModelId } from './xai-image-settings';
 interface XaiImageModelConfig {
   provider: string;
   baseURL: string | undefined;
-  headers: () => Record<string, string | undefined>;
+  headers?: () => Record<string, string | undefined>;
   fetch?: FetchFunction;
   _internal?: {
     currentDate?: () => Date;
@@ -33,6 +36,20 @@ export class XaiImageModel implements ImageModelV4 {
     return this.config.provider;
   }
 
+  static [WORKFLOW_SERIALIZE](model: XaiImageModel) {
+    return serializeModelOptions({
+      modelId: model.modelId,
+      config: model.config,
+    });
+  }
+
+  static [WORKFLOW_DESERIALIZE](options: {
+    modelId: XaiImageModelId;
+    config: XaiImageModelConfig;
+  }) {
+    return new XaiImageModel(options.modelId, options.config);
+  }
+
   constructor(
     readonly modelId: XaiImageModelId,
     private config: XaiImageModelConfig,
@@ -135,7 +152,7 @@ export class XaiImageModel implements ImageModelV4 {
     const currentDate = this.config._internal?.currentDate?.() ?? new Date();
     const { value: response, responseHeaders } = await postJsonToApi({
       url: `${baseURL}${endpoint}`,
-      headers: combineHeaders(this.config.headers(), headers),
+      headers: combineHeaders(this.config.headers?.(), headers),
       body,
       failedResponseHandler: xaiFailedResponseHandler,
       successfulResponseHandler: createJsonResponseHandler(