@ai-sdk/xai 4.0.0-beta.45 → 4.0.0-beta.47

package/CHANGELOG.md

@@ -1,5 +1,30 @@
 # @ai-sdk/xai
 
+## 4.0.0-beta.47
+
+### Patch Changes
+
+- 9bd6512: feat(provider): change file part data property to be tagged with a type and remove the image part type
+- 258c093: chore: ensure consistent import handling and avoid import duplicates or cycles
+- Updated dependencies [9bd6512]
+- Updated dependencies [258c093]
+- Updated dependencies [b6783da]
+  - @ai-sdk/openai-compatible@3.0.0-beta.34
+  - @ai-sdk/provider-utils@5.0.0-beta.29
+  - @ai-sdk/provider@4.0.0-beta.14
+
+## 4.0.0-beta.46
+
+### Patch Changes
+
+- 78b6433: feat(provider/xai): support non-image file parts (PDF, text, CSV) in the Responses API via `input_file` + `file_url`
+
+  The xAI Responses API accepts `{ type: 'input_file', file_url }` for non-image documents (see https://docs.x.ai/docs/guides/chat-with-files), but the AI SDK xAI Responses provider previously threw `UnsupportedFunctionalityError` for any file part whose `mediaType` did not start with `image/`.
+
+  When a file part is passed with `data: URL` and a non-image media type, the provider now emits `{ type: 'input_file', file_url }`. `application/pdf` and `text/*` are also added to `supportedUrls` so the SDK does not download them to bytes before reaching the converter.
+
+  Inline-byte (base64) inputs for non-image media types continue to throw, since xAI's Responses API requires either a public URL or a pre-uploaded `file_id` for non-image documents.
+
 ## 4.0.0-beta.45
 
 ### Patch Changes

package/dist/index.d.ts

@@ -186,7 +186,7 @@ declare const codeExecutionToolFactory: _ai_sdk_provider_utils.ProviderExecutedT
     output: string;
     error?: string | undefined;
 }, object, {}>;
-declare const codeExecution: (args?: Parameters<typeof codeExecutionToolFactory>[0]) => _ai_sdk_provider_utils.Tool<Record<string, never>, {
+declare const codeExecution: (args?: Parameters<typeof codeExecutionToolFactory>[0]) => _ai_sdk_provider_utils.ProviderExecutedTool<Record<string, never>, {
     output: string;
     error?: string | undefined;
 }, {}>;
@@ -203,7 +203,7 @@ declare const mcpServerToolFactory: _ai_sdk_provider_utils.ProviderExecutedToolF
     headers?: Record<string, string>;
     authorization?: string;
 }, {}>;
-declare const mcpServer: (args: Parameters<typeof mcpServerToolFactory>[0]) => _ai_sdk_provider_utils.Tool<{}, {
+declare const mcpServer: (args: Parameters<typeof mcpServerToolFactory>[0]) => _ai_sdk_provider_utils.ProviderExecutedTool<{}, {
     name: string;
     arguments: string;
     result: unknown;
@@ -213,7 +213,7 @@ declare const viewImageToolFactory: _ai_sdk_provider_utils.ProviderExecutedToolF
     description: string;
     objects?: string[] | undefined;
 }, object, {}>;
-declare const viewImage: (args?: Parameters<typeof viewImageToolFactory>[0]) => _ai_sdk_provider_utils.Tool<Record<string, never>, {
+declare const viewImage: (args?: Parameters<typeof viewImageToolFactory>[0]) => _ai_sdk_provider_utils.ProviderExecutedTool<Record<string, never>, {
     description: string;
     objects?: string[] | undefined;
 }, {}>;
@@ -223,7 +223,7 @@ declare const viewXVideoToolFactory: _ai_sdk_provider_utils.ProviderExecutedTool
     transcript?: string | undefined;
     duration?: number | undefined;
 }, object, {}>;
-declare const viewXVideo: (args?: Parameters<typeof viewXVideoToolFactory>[0]) => _ai_sdk_provider_utils.Tool<Record<string, never>, {
+declare const viewXVideo: (args?: Parameters<typeof viewXVideoToolFactory>[0]) => _ai_sdk_provider_utils.ProviderExecutedTool<Record<string, never>, {
     description: string;
     transcript?: string | undefined;
     duration?: number | undefined;
@@ -241,7 +241,7 @@ declare const webSearchToolFactory: _ai_sdk_provider_utils.ProviderExecutedToolF
     excludedDomains?: string[];
     enableImageUnderstanding?: boolean;
 }, {}>;
-declare const webSearch: (args?: Parameters<typeof webSearchToolFactory>[0]) => _ai_sdk_provider_utils.Tool<{}, {
+declare const webSearch: (args?: Parameters<typeof webSearchToolFactory>[0]) => _ai_sdk_provider_utils.ProviderExecutedTool<{}, {
     query: string;
     sources: Array<{
         title: string;
@@ -266,7 +266,7 @@ declare const xSearchToolFactory: _ai_sdk_provider_utils.ProviderExecutedToolFac
     enableImageUnderstanding?: boolean;
     enableVideoUnderstanding?: boolean;
 }, {}>;
-declare const xSearch: (args?: Parameters<typeof xSearchToolFactory>[0]) => _ai_sdk_provider_utils.Tool<{}, {
+declare const xSearch: (args?: Parameters<typeof xSearchToolFactory>[0]) => _ai_sdk_provider_utils.ProviderExecutedTool<{}, {
     query: string;
     posts: Array<{
         author: string;
@@ -280,7 +280,7 @@ declare const xaiTools: {
     codeExecution: (args?: Parameters<_ai_sdk_provider_utils.ProviderExecutedToolFactory<Record<string, never>, {
         output: string;
         error?: string | undefined;
-    }, object, {}>>[0]) => _ai_sdk_provider_utils.Tool<Record<string, never>, {
+    }, object, {}>>[0]) => _ai_sdk_provider_utils.ProviderExecutedTool<Record<string, never>, {
         output: string;
         error?: string | undefined;
     }, {}>;
@@ -295,7 +295,7 @@ declare const xaiTools: {
     }, {
         vectorStoreIds: string[];
         maxNumResults?: number;
-    }, {}>>[0]) => _ai_sdk_provider_utils.Tool<{}, {
+    }, {}>>[0]) => _ai_sdk_provider_utils.ProviderExecutedTool<{}, {
         queries: string[];
         results: null | {
             fileId: string;
@@ -315,7 +315,7 @@ declare const xaiTools: {
         allowedTools?: string[];
         headers?: Record<string, string>;
         authorization?: string;
-    }, {}>>[0]) => _ai_sdk_provider_utils.Tool<{}, {
+    }, {}>>[0]) => _ai_sdk_provider_utils.ProviderExecutedTool<{}, {
         name: string;
         arguments: string;
         result: unknown;
@@ -323,7 +323,7 @@ declare const xaiTools: {
     viewImage: (args?: Parameters<_ai_sdk_provider_utils.ProviderExecutedToolFactory<Record<string, never>, {
         description: string;
         objects?: string[] | undefined;
-    }, object, {}>>[0]) => _ai_sdk_provider_utils.Tool<Record<string, never>, {
+    }, object, {}>>[0]) => _ai_sdk_provider_utils.ProviderExecutedTool<Record<string, never>, {
         description: string;
         objects?: string[] | undefined;
     }, {}>;
@@ -331,7 +331,7 @@ declare const xaiTools: {
         description: string;
         transcript?: string | undefined;
         duration?: number | undefined;
-    }, object, {}>>[0]) => _ai_sdk_provider_utils.Tool<Record<string, never>, {
+    }, object, {}>>[0]) => _ai_sdk_provider_utils.ProviderExecutedTool<Record<string, never>, {
         description: string;
         transcript?: string | undefined;
         duration?: number | undefined;
@@ -347,7 +347,7 @@ declare const xaiTools: {
         allowedDomains?: string[];
         excludedDomains?: string[];
         enableImageUnderstanding?: boolean;
-    }, {}>>[0]) => _ai_sdk_provider_utils.Tool<{}, {
+    }, {}>>[0]) => _ai_sdk_provider_utils.ProviderExecutedTool<{}, {
         query: string;
         sources: Array<{
             title: string;
@@ -370,7 +370,7 @@ declare const xaiTools: {
         toDate?: string;
         enableImageUnderstanding?: boolean;
         enableVideoUnderstanding?: boolean;
-    }, {}>>[0]) => _ai_sdk_provider_utils.Tool<{}, {
+    }, {}>>[0]) => _ai_sdk_provider_utils.ProviderExecutedTool<{}, {
         query: string;
         posts: Array<{
             author: string;

package/dist/index.js

@@ -35,7 +35,8 @@ import {
 } from "@ai-sdk/provider";
 import {
   convertToBase64,
-  isProviderReference,
+  getTopLevelMediaType,
+  resolveFullMediaType,
   resolveProviderReference
 } from "@ai-sdk/provider-utils";
 function convertToXaiChatMessages(prompt) {
@@ -61,29 +62,38 @@ function convertToXaiChatMessages(prompt) {
                 return { type: "text", text: part.text };
               }
               case "file": {
-                if (isProviderReference(part.data)) {
-                  return {
-                    type: "file",
-                    file: {
-                      file_id: resolveProviderReference({
-                        reference: part.data,
-                        provider: "xai"
-                      })
-                    }
-                  };
-                }
-                if (part.mediaType.startsWith("image/")) {
-                  const mediaType = part.mediaType === "image/*" ? "image/jpeg" : part.mediaType;
-                  return {
-                    type: "image_url",
-                    image_url: {
-                      url: part.data instanceof URL ? part.data.toString() : `data:${mediaType};base64,${convertToBase64(part.data)}`
+                switch (part.data.type) {
+                  case "reference": {
+                    return {
+                      type: "file",
+                      file: {
+                        file_id: resolveProviderReference({
+                          reference: part.data.reference,
+                          provider: "xai"
+                        })
+                      }
+                    };
+                  }
+                  case "text": {
+                    throw new UnsupportedFunctionalityError({
+                      functionality: "text file parts"
+                    });
+                  }
+                  case "url":
+                  case "data": {
+                    if (getTopLevelMediaType(part.mediaType) === "image") {
+                      return {
+                        type: "image_url",
+                        image_url: {
+                          url: part.data.type === "url" ? part.data.url.toString() : `data:${resolveFullMediaType({ part })};base64,${convertToBase64(part.data.data)}`
+                        }
+                      };
+                    } else {
+                      throw new UnsupportedFunctionalityError({
+                        functionality: `file part media type ${part.mediaType}`
+                      });
                     }
-                  };
-                } else {
-                  throw new UnsupportedFunctionalityError({
-                    functionality: `file part media type ${part.mediaType}`
-                  });
+                  }
                 }
               }
             }
@@ -1110,7 +1120,8 @@ import {
 } from "@ai-sdk/provider";
 import {
   convertToBase64 as convertToBase642,
-  isProviderReference as isProviderReference2,
+  getTopLevelMediaType as getTopLevelMediaType2,
+  resolveFullMediaType as resolveFullMediaType2,
   resolveProviderReference as resolveProviderReference2
 } from "@ai-sdk/provider-utils";
 async function convertToXaiResponsesInput({
@@ -1137,22 +1148,42 @@ async function convertToXaiResponsesInput({
               break;
             }
             case "file": {
-              if (isProviderReference2(block.data)) {
-                contentParts.push({
-                  type: "input_file",
-                  file_id: resolveProviderReference2({
-                    reference: block.data,
-                    provider: "xai"
-                  })
-                });
-              } else if (block.mediaType.startsWith("image/")) {
-                const mediaType = block.mediaType === "image/*" ? "image/jpeg" : block.mediaType;
-                const imageUrl = block.data instanceof URL ? block.data.toString() : `data:${mediaType};base64,${convertToBase642(block.data)}`;
-                contentParts.push({ type: "input_image", image_url: imageUrl });
-              } else {
-                throw new UnsupportedFunctionalityError3({
-                  functionality: `file part media type ${block.mediaType}`
-                });
+              switch (block.data.type) {
+                case "reference": {
+                  contentParts.push({
+                    type: "input_file",
+                    file_id: resolveProviderReference2({
+                      reference: block.data.reference,
+                      provider: "xai"
+                    })
+                  });
+                  break;
+                }
+                case "text": {
+                  throw new UnsupportedFunctionalityError3({
+                    functionality: "text file parts"
+                  });
+                }
+                case "url":
+                case "data": {
+                  if (getTopLevelMediaType2(block.mediaType) === "image") {
+                    const imageUrl = block.data.type === "url" ? block.data.url.toString() : `data:${resolveFullMediaType2({ part: block })};base64,${convertToBase642(block.data.data)}`;
+                    contentParts.push({
+                      type: "input_image",
+                      image_url: imageUrl
+                    });
+                  } else if (block.data.type === "url") {
+                    contentParts.push({
+                      type: "input_file",
+                      file_url: block.data.url.toString()
+                    });
+                  } else {
+                    throw new UnsupportedFunctionalityError3({
+                      functionality: `file part media type ${block.mediaType} as inline data (xAI Responses requires a URL or a Files API reference for non-image files)`
+                    });
+                  }
+                  break;
+                }
               }
               break;
             }
@@ -2111,7 +2142,12 @@ var XaiResponsesLanguageModel = class _XaiResponsesLanguageModel {
   constructor(modelId, config) {
     this.specificationVersion = "v4";
     this.supportedUrls = {
-      "image/*": [/^https?:\/\/.*$/]
+      "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.modelId = modelId;
     this.config = config;
@@ -2929,12 +2965,12 @@ var xaiTools = {
 };
 
 // src/version.ts
-var VERSION = true ? "4.0.0-beta.45" : "0.0.0-test";
+var VERSION = true ? "4.0.0-beta.47" : "0.0.0-test";
 
 // src/files/xai-files.ts
 import {
   combineHeaders as combineHeaders4,
-  convertBase64ToUint8Array,
+  convertInlineFileDataToUint8Array,
   createJsonResponseHandler as createJsonResponseHandler4,
   parseProviderOptions as parseProviderOptions4,
   postFormDataToApi
@@ -2958,7 +2994,10 @@ var xaiFilesResponseSchema = lazySchema5(
 );
 
 // src/files/xai-files-options.ts
-import { lazySchema as lazySchema6, zodSchema as zodSchema6 } from "@ai-sdk/provider-utils";
+import {
+  lazySchema as lazySchema6,
+  zodSchema as zodSchema6
+} from "@ai-sdk/provider-utils";
 import { z as z16 } from "zod/v4";
 var xaiFilesOptionsSchema = lazySchema6(
   () => zodSchema6(
@@ -2990,7 +3029,7 @@ var XaiFiles = class {
       providerOptions,
       schema: xaiFilesOptionsSchema
     });
-    const fileBytes = data instanceof Uint8Array ? data : convertBase64ToUint8Array(data);
+    const fileBytes = convertInlineFileDataToUint8Array(data);
     const blob = new Blob([fileBytes], {
       type: mediaType
     });