@ai-sdk/xai 4.0.53 → 4.0.55

package/CHANGELOG.md

@@ -1,5 +1,23 @@
 # @ai-sdk/xai
 
+## 4.0.55
+
+### Patch Changes
+
+- a4ba394: feat: support per-request models in batch
+- Updated dependencies [a4ba394]
+- Updated dependencies [45099da]
+- Updated dependencies [9e1d1b2]
+- Updated dependencies [a495511]
+  - @ai-sdk/provider@4.0.11
+  - @ai-sdk/provider-utils@5.0.37
+
+## 4.0.54
+
+### Patch Changes
+
+- 048ce06: feat(batch): surface the uploaded input file on the batch start result (`providerMetadata.<provider>.inputFileId` / `inputFileExpiresAt`) and accept an `inputFileExpiresAfter` provider option on the OpenAI and xAI batch input file upload
+
 ## 4.0.53
 
 ### Patch Changes

package/dist/index.d.ts

@@ -1,7 +1,7 @@
 import { z } from 'zod/v4';
 import * as _ai_sdk_provider_utils from '@ai-sdk/provider-utils';
 import { InferSchema, FetchFunction, WebSocketConstructor } from '@ai-sdk/provider-utils';
-import { ProviderV4, Experimental_BatchLanguageModelV4, LanguageModelV4, ImageModelV4, Experimental_VideoModelV4, Experimental_RealtimeFactoryV4, SpeechModelV4, TranscriptionModelV4, FilesV4, Experimental_RealtimeModelV4, Experimental_RealtimeModelV4ClientSecretOptions, Experimental_RealtimeModelV4ClientSecretResult, Experimental_RealtimeModelV4ServerEvent, Experimental_RealtimeModelV4ClientEvent, Experimental_RealtimeModelV4SessionConfig } from '@ai-sdk/provider';
+import { ProviderV4, LanguageModelV4, Experimental_BatchV4, ImageModelV4, Experimental_VideoModelV4, Experimental_RealtimeFactoryV4, SpeechModelV4, TranscriptionModelV4, FilesV4, Experimental_RealtimeModelV4, Experimental_RealtimeModelV4ClientSecretOptions, Experimental_RealtimeModelV4ClientSecretResult, Experimental_RealtimeModelV4ServerEvent, Experimental_RealtimeModelV4ClientEvent, Experimental_RealtimeModelV4SessionConfig } from '@ai-sdk/provider';
 
 type XaiChatModelId = 'grok-4.20-non-reasoning' | 'grok-4.20-reasoning' | 'grok-4.3' | 'grok-4.5' | 'grok-4.6' | 'grok-latest' | (string & {});
 declare const xaiLanguageModelChatOptions: z.ZodObject<{
@@ -535,11 +535,11 @@ declare const xaiTools: {
 };
 
 interface XaiProvider extends ProviderV4 {
-    (modelId: XaiResponsesModelId): Experimental_BatchLanguageModelV4;
+    (modelId: XaiResponsesModelId): LanguageModelV4;
     /**
      * Creates an Xai language model for text generation.
      */
-    languageModel(modelId: XaiResponsesModelId): Experimental_BatchLanguageModelV4;
+    languageModel(modelId: XaiResponsesModelId): LanguageModelV4;
     /**
      * Creates an Xai chat model for text generation.
      */
@@ -547,7 +547,13 @@ interface XaiProvider extends ProviderV4 {
     /**
      * Creates an Xai responses model for text generation.
      */
-    responses: (modelId: XaiResponsesModelId) => Experimental_BatchLanguageModelV4;
+    responses: (modelId: XaiResponsesModelId) => LanguageModelV4;
+    /**
+     * Returns a BatchV4 interface for processing batches with xAI.
+     */
+    experimental_batch(): Experimental_BatchV4<{
+        text: XaiResponsesModelId;
+    }>;
     /**
      * Creates an Xai image model for image generation.
      */

package/dist/index.js

@@ -1239,7 +1239,7 @@ var xaiImageResponseSchema = z6.object({
   }).nullish()
 });
 
-// src/responses/xai-responses-batch.ts
+// src/xai-batch.ts
 import {
   InvalidArgumentError
 } from "@ai-sdk/provider";
@@ -1251,11 +1251,10 @@ import {
   getFromApi as getFromApi2,
   lazySchema as lazySchema7,
   normalizeBatchRequestCounts,
+  parseProviderOptions as parseProviderOptions6,
   postFormDataToApi,
   postJsonToApi as postJsonToApi4,
   safeValidateTypes,
-  WORKFLOW_DESERIALIZE as WORKFLOW_DESERIALIZE4,
-  WORKFLOW_SERIALIZE as WORKFLOW_SERIALIZE4,
   zodSchema as zodSchema7
 } from "@ai-sdk/provider-utils";
 import { z as z15 } from "zod/v4";
@@ -2519,17 +2518,18 @@ function getHttpStatusCode(value) {
 function isRetryableStatusCode(statusCode) {
   return statusCode === 408 || statusCode === 409 || statusCode === 429 || statusCode >= 500;
 }
+var xaiResponsesSupportedUrls = {
+  "image/*": [/^https?:\/\/.*$/],
+  // xAI's Responses API accepts non-image documents (PDF, plain text, CSV, etc.) as
+  // `{ type: 'input_file', file_url }`. Keeping these URLs intact here lets them pass
+  // through to the converter instead of being downloaded to bytes by the SDK.
+  "application/pdf": [/^https?:\/\/.*$/],
+  "text/*": [/^https?:\/\/.*$/]
+};
 var XaiResponsesLanguageModel = class _XaiResponsesLanguageModel {
   constructor(modelId, config) {
     this.specificationVersion = "v4";
-    this.supportedUrls = {
-      "image/*": [/^https?:\/\/.*$/],
-      // xAI's Responses API accepts non-image documents (PDF, plain text, CSV, etc.) as
-      // `{ type: 'input_file', file_url }`. Keeping these URLs intact here lets them pass
-      // through to the converter instead of being downloaded to bytes by the SDK.
-      "application/pdf": [/^https?:\/\/.*$/],
-      "text/*": [/^https?:\/\/.*$/]
-    };
+    this.supportedUrls = xaiResponsesSupportedUrls;
     this.modelId = modelId;
     this.config = config;
   }
@@ -2545,21 +2545,24 @@ var XaiResponsesLanguageModel = class _XaiResponsesLanguageModel {
   get provider() {
     return this.config.provider;
   }
-  async getArgs({
-    prompt,
-    maxOutputTokens,
-    temperature,
-    topP,
-    topK,
-    frequencyPenalty,
-    presencePenalty,
-    stopSequences,
-    seed,
-    responseFormat,
-    providerOptions,
-    tools,
-    toolChoice,
-    reasoning
+  static async prepareRequest({
+    modelId,
+    options: {
+      prompt,
+      maxOutputTokens,
+      temperature,
+      topP,
+      topK,
+      frequencyPenalty,
+      presencePenalty,
+      stopSequences,
+      seed,
+      responseFormat,
+      providerOptions,
+      tools,
+      toolChoice,
+      reasoning
+    }
   }) {
     var _a, _b, _c, _d, _e, _f, _g, _h, _i;
     const warnings = [];
@@ -2622,7 +2625,7 @@ var XaiResponsesLanguageModel = class _XaiResponsesLanguageModel {
     }
     let resolvedReasoningEffort = options.reasoningEffort;
     if (resolvedReasoningEffort == null && isCustomReasoning2(reasoning)) {
-      if (!supportsReasoningEffort(this.modelId)) {
+      if (!supportsReasoningEffort(modelId)) {
         warnings.push({
           type: "unsupported",
           feature: "reasoning",
@@ -2638,14 +2641,14 @@ var XaiResponsesLanguageModel = class _XaiResponsesLanguageModel {
             low: "low",
             medium: "medium",
             high: "high",
-            xhigh: this.modelId === "grok-4.6" ? "xhigh" : "high"
+            xhigh: modelId === "grok-4.6" ? "xhigh" : "high"
           },
           warnings
         });
       }
     }
     const baseArgs = {
-      model: this.modelId,
+      model: modelId,
       input,
       logprobs: options.logprobs === true || options.topLogprobs != null ? true : void 0,
       top_logprobs: options.topLogprobs,
@@ -2704,6 +2707,12 @@ var XaiResponsesLanguageModel = class _XaiResponsesLanguageModel {
       imageGenerationToolName
     };
   }
+  getArgs(options) {
+    return _XaiResponsesLanguageModel.prepareRequest({
+      modelId: this.modelId,
+      options
+    });
+  }
   async doGenerate(options) {
     var _a, _b, _c, _d, _e, _f, _g, _h, _i, _j, _k, _l, _m, _n, _o, _p, _q, _r;
     const {
@@ -3506,10 +3515,22 @@ function mapWebSearchAction(action) {
   }
 }
 
-// src/responses/xai-responses-batch.ts
+// src/xai-batch.ts
 var xaiBatchEndpoint = "/v1/responses";
 var xaiBatchName = "ai-sdk-text-batch";
 var xaiBatchResultsPageSize = 1e3;
+var xaiBatchProviderOptionsSchema = lazySchema7(
+  () => zodSchema7(
+    z15.object({
+      /**
+       * TTL in seconds for the uploaded batch input file, measured from
+       * upload time. xAI accepts integers between 3600 (1 hour) and
+       * 2592000 (30 days) inclusive. Without it the file has no expiry.
+       */
+      inputFileExpiresAfter: z15.number().int().min(3600).max(2592e3).optional()
+    })
+  )
+);
 var xaiBatchResponseSchema = lazySchema7(
   () => zodSchema7(
     z15.object({
@@ -3551,11 +3572,14 @@ var xaiBatchResultsPageSchema = lazySchema7(
     })
   )
 );
-var XaiResponsesBatch = class {
+var XaiBatch = class {
   constructor(options) {
     this.options = options;
+    this.specificationVersion = "v4";
+    this.supportedUrls = xaiResponsesSupportedUrls;
+    this.provider = options.provider;
   }
-  async startBatch(options) {
+  async doStartBatch(options) {
     var _a, _b;
     const fileParts = [];
     const warnings = options.webhookUrl == null ? [] : [
@@ -3567,8 +3591,13 @@ var XaiResponsesBatch = class {
         }
       }
     ];
+    const batchOptions = await parseProviderOptions6({
+      provider: "xai",
+      providerOptions: options.providerOptions,
+      schema: xaiBatchProviderOptionsSchema
+    });
     for (const request of options.requests) {
-      const preparedRequest = await this.options.prepareRequest(request);
+      const preparedRequest = await this.prepareRequest(request);
       fileParts.push(
         JSON.stringify({
           custom_id: request.id,
@@ -3586,6 +3615,12 @@ var XaiResponsesBatch = class {
     const file = new Blob(fileParts, { type: "application/jsonl" });
     fileParts.length = 0;
     const formData = new FormData();
+    if ((batchOptions == null ? void 0 : batchOptions.inputFileExpiresAfter) != null) {
+      formData.append(
+        "expires_after",
+        String(batchOptions.inputFileExpiresAfter)
+      );
+    }
     formData.append("file", file, filename);
     const headers = combineHeaders4(
       (_b = (_a = this.options.config).headers) == null ? void 0 : _b.call(_a),
@@ -3619,13 +3654,23 @@ var XaiResponsesBatch = class {
     return {
       batchId: batch.batch_id,
       ...convertXaiBatchStatus(batch),
+      providerMetadata: {
+        xai: {
+          inputFileId: uploadedFile.id,
+          ...uploadedFile.expires_at != null ? {
+            inputFileExpiresAt: new Date(
+              uploadedFile.expires_at * 1e3
+            ).toISOString()
+          } : {}
+        }
+      },
       warnings
     };
   }
-  async getBatchStatus(options) {
+  async doGetBatchStatus(options) {
     return convertXaiBatchStatus(await this.retrieveBatch(options));
   }
-  async getBatchResults(options) {
+  async doGetBatchResults(options) {
     const batch = await this.retrieveBatch(options);
     if (convertXaiBatchStatus(batch).status === "pending") {
       throw new InvalidArgumentError({
@@ -3690,6 +3735,7 @@ var XaiResponsesBatch = class {
     if (((_c = (_b = result.error_message) == null ? void 0 : _b.length) != null ? _c : 0) > 0 || (error == null ? void 0 : error.code) != null && error.code !== 0 && error.code !== "0" || (error == null ? void 0 : error.code) == null && ((_e = (_d = error == null ? void 0 : error.message) == null ? void 0 : _d.length) != null ? _e : 0) > 0) {
       const convertedError = convertXaiBatchError(result);
       return {
+        type: "text",
         id: result.batch_request_id,
         status: isXaiCancellationError(error == null ? void 0 : error.code) ? "cancelled" : "failed",
         error: convertedError
@@ -3706,10 +3752,12 @@ var XaiResponsesBatch = class {
       }
       const conversion = convertXaiChatBatchResponse(validation.value);
       return conversion.success ? {
+        type: "text",
         id: result.batch_request_id,
         status: "succeeded",
         result: conversion.result
       } : {
+        type: "text",
         id: result.batch_request_id,
         status: "failed",
         error: conversion.error
@@ -3717,38 +3765,18 @@ var XaiResponsesBatch = class {
     }
     return invalidXaiBatchResult(result.batch_request_id);
   }
+  async prepareRequest(request) {
+    const { args: body, warnings } = await XaiResponsesLanguageModel.prepareRequest({
+      modelId: request.modelId,
+      options: request.options
+    });
+    return { body, warnings };
+  }
   getUrl(path) {
     var _a;
     return `${(_a = this.options.config.baseURL) != null ? _a : "https://api.x.ai/v1"}${path}`;
   }
 };
-var XaiResponsesBatchLanguageModel = class _XaiResponsesBatchLanguageModel extends XaiResponsesLanguageModel {
-  static [WORKFLOW_SERIALIZE4](model) {
-    return XaiResponsesLanguageModel[WORKFLOW_SERIALIZE4](model);
-  }
-  static [WORKFLOW_DESERIALIZE4](options) {
-    return new _XaiResponsesBatchLanguageModel(options.modelId, options.config);
-  }
-  constructor(modelId, config) {
-    super(modelId, config);
-    this.batch = new XaiResponsesBatch({
-      config,
-      prepareRequest: async (request) => {
-        const { args: body, warnings } = await this.getArgs(request.options);
-        return { body, warnings };
-      }
-    });
-  }
-  experimental_doStartBatch(options) {
-    return this.batch.startBatch(options);
-  }
-  experimental_doGetBatchStatus(options) {
-    return this.batch.getBatchStatus(options);
-  }
-  experimental_doGetBatchResults(options) {
-    return this.batch.getBatchResults(options);
-  }
-};
 function convertXaiBatchStatus(batch) {
   var _a, _b, _c, _d, _e, _f;
   const requestCounts = normalizeBatchRequestCounts({
@@ -3799,6 +3827,7 @@ function isXaiCancellationError(code) {
 }
 function invalidXaiBatchResult(id) {
   return {
+    type: "text",
     id,
     status: "failed",
     error: {
@@ -4329,7 +4358,7 @@ var xaiTools = {
 };
 
 // src/version.ts
-var VERSION = true ? "4.0.53" : "0.0.0-test";
+var VERSION = true ? "4.0.55" : "0.0.0-test";
 
 // src/files/xai-files.ts
 import {
@@ -4342,7 +4371,7 @@ import {
   createJsonResponseHandler as createJsonResponseHandler5,
   deleteFromApi,
   getFromApi as getFromApi3,
-  parseProviderOptions as parseProviderOptions6,
+  parseProviderOptions as parseProviderOptions7,
   postFormDataToApi as postFormDataToApi2,
   postMultipartStreamToApi
 } from "@ai-sdk/provider-utils";
@@ -4405,7 +4434,7 @@ var XaiFiles = class {
     var _a, _b;
     let xaiOptions;
     try {
-      xaiOptions = await parseProviderOptions6({
+      xaiOptions = await parseProviderOptions7({
         provider: "xai",
         providerOptions,
         schema: xaiFilesOptionsSchema
@@ -4594,7 +4623,7 @@ import {
   extractResponseHeaders as extractResponseHeaders2,
   getFromApi as getFromApi4,
   getTopLevelMediaType as getTopLevelMediaType3,
-  parseProviderOptions as parseProviderOptions7,
+  parseProviderOptions as parseProviderOptions8,
   postJsonToApi as postJsonToApi5,
   safeParseJSON as safeParseJSON2
 } from "@ai-sdk/provider-utils";
@@ -4706,7 +4735,7 @@ var XaiVideoModel = class {
   }
   async buildRequestBody(options) {
     const warnings = [];
-    const xaiOptions = await parseProviderOptions7({
+    const xaiOptions = await parseProviderOptions8({
       provider: "xai",
       providerOptions: options.providerOptions,
       schema: xaiVideoModelOptionsSchema
@@ -5126,12 +5155,12 @@ import {
   convertBase64ToUint8Array,
   createBinaryResponseHandler as createBinaryResponseHandler2,
   createJsonResponseHandler as createJsonResponseHandler7,
-  parseProviderOptions as parseProviderOptions8,
+  parseProviderOptions as parseProviderOptions9,
   postJsonToApi as postJsonToApi6,
   resolve,
   serializeModelOptions as serializeModelOptions4,
-  WORKFLOW_DESERIALIZE as WORKFLOW_DESERIALIZE5,
-  WORKFLOW_SERIALIZE as WORKFLOW_SERIALIZE5
+  WORKFLOW_DESERIALIZE as WORKFLOW_DESERIALIZE4,
+  WORKFLOW_SERIALIZE as WORKFLOW_SERIALIZE4
 } from "@ai-sdk/provider-utils";
 import { z as z23 } from "zod/v4";
 
@@ -5196,13 +5225,13 @@ var XaiSpeechModel = class _XaiSpeechModel {
     this.config = config;
     this.specificationVersion = "v4";
   }
-  static [WORKFLOW_SERIALIZE5](model) {
+  static [WORKFLOW_SERIALIZE4](model) {
     return serializeModelOptions4({
       modelId: model.modelId,
       config: model.config
     });
   }
-  static [WORKFLOW_DESERIALIZE5](options) {
+  static [WORKFLOW_DESERIALIZE4](options) {
     return new _XaiSpeechModel(options.modelId, options.config);
   }
   get provider() {
@@ -5218,7 +5247,7 @@ var XaiSpeechModel = class _XaiSpeechModel {
     providerOptions
   }) {
     const warnings = [];
-    const xaiOptions = await parseProviderOptions8({
+    const xaiOptions = await parseProviderOptions9({
       provider: "xai",
       providerOptions,
       schema: xaiSpeechModelOptionsSchema
@@ -5347,14 +5376,14 @@ import {
   createJsonResponseHandler as createJsonResponseHandler8,
   connectToWebSocket,
   mediaTypeToExtension,
-  parseProviderOptions as parseProviderOptions9,
+  parseProviderOptions as parseProviderOptions10,
   postFormDataToApi as postFormDataToApi3,
   safeParseJSON as safeParseJSON3,
   serializeModelOptions as serializeModelOptions5,
   toWebSocketUrl,
   waitForWebSocketBufferDrain,
-  WORKFLOW_DESERIALIZE as WORKFLOW_DESERIALIZE6,
-  WORKFLOW_SERIALIZE as WORKFLOW_SERIALIZE6
+  WORKFLOW_DESERIALIZE as WORKFLOW_DESERIALIZE5,
+  WORKFLOW_SERIALIZE as WORKFLOW_SERIALIZE5
 } from "@ai-sdk/provider-utils";
 import { z as z25 } from "zod/v4";
 
@@ -5442,13 +5471,13 @@ var XaiTranscriptionModel = class _XaiTranscriptionModel {
     this.config = config;
     this.specificationVersion = "v4";
   }
-  static [WORKFLOW_SERIALIZE6](model) {
+  static [WORKFLOW_SERIALIZE5](model) {
     return serializeModelOptions5({
       modelId: model.modelId,
       config: model.config
     });
   }
-  static [WORKFLOW_DESERIALIZE6](options) {
+  static [WORKFLOW_DESERIALIZE5](options) {
     return new _XaiTranscriptionModel(options.modelId, options.config);
   }
   get provider() {
@@ -5460,7 +5489,7 @@ var XaiTranscriptionModel = class _XaiTranscriptionModel {
     providerOptions
   }) {
     const warnings = [];
-    const xaiOptions = await parseProviderOptions9({
+    const xaiOptions = await parseProviderOptions10({
       provider: "xai",
       providerOptions,
       schema: xaiTranscriptionModelOptionsSchema
@@ -5537,7 +5566,7 @@ var XaiTranscriptionModel = class _XaiTranscriptionModel {
     var _a, _b, _c, _d, _e, _f, _g;
     const currentDate = (_c = (_b = (_a = this.config._internal) == null ? void 0 : _a.currentDate) == null ? void 0 : _b.call(_a)) != null ? _c : /* @__PURE__ */ new Date();
     const warnings = [];
-    const xaiOptions = await parseProviderOptions9({
+    const xaiOptions = await parseProviderOptions10({
       provider: "xai",
       providerOptions: options.providerOptions,
       schema: xaiTranscriptionModelOptionsSchema
@@ -5868,7 +5897,7 @@ function createXai(options = {}) {
     });
   };
   const createResponsesLanguageModel = (modelId) => {
-    return new XaiResponsesBatchLanguageModel(modelId, {
+    return new XaiResponsesLanguageModel(modelId, {
       provider: "xai.responses",
       baseURL,
       headers: getHeaders,
@@ -5940,6 +5969,16 @@ function createXai(options = {}) {
     headers: getHeaders,
     fetch: options.fetch
   });
+  const createBatch = () => new XaiBatch({
+    provider: "xai.batch",
+    config: {
+      provider: "xai.responses",
+      baseURL,
+      headers: getHeaders,
+      generateId,
+      fetch: options.fetch
+    }
+  });
   const provider = (modelId) => createResponsesLanguageModel(modelId);
   provider.specificationVersion = "v4";
   provider.languageModel = createResponsesLanguageModel;
@@ -5959,6 +5998,7 @@ function createXai(options = {}) {
   provider.transcriptionModel = createTranscriptionModel;
   provider.transcription = createTranscriptionModel;
   provider.files = createFiles;
+  provider.experimental_batch = createBatch;
   provider.tools = xaiTools;
   return provider;
 }