@ai-sdk/xai 4.0.0-beta.46 → 4.0.0-beta.48

package/CHANGELOG.md

@@ -1,5 +1,33 @@
 # @ai-sdk/xai
 
+## 4.0.0-beta.48
+
+### Major Changes
+
+- 04e9009: chore: make provider implementations code patterns more consistent, including renaming certain exported symbols
+
+  For all externally exported symbols that were renamed, the old names continue to work via deprecated aliases.
+
+### Patch Changes
+
+- Updated dependencies [08d2129]
+- Updated dependencies [04e9009]
+  - @ai-sdk/provider-utils@5.0.0-beta.30
+  - @ai-sdk/openai-compatible@3.0.0-beta.35
+
+## 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

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}`
-                  });
+                  }
                 }
               }
             }
@@ -212,7 +222,7 @@ function mapXaiFinishReason(finishReason) {
   }
 }
 
-// src/xai-chat-options.ts
+// src/xai-chat-language-model-options.ts
 import { z } from "zod/v4";
 var webSourceSchema = z.object({
   type: z.literal("web"),
@@ -925,7 +935,7 @@ import {
 } from "@ai-sdk/provider-utils";
 import { z as z5 } from "zod/v4";
 
-// src/xai-image-options.ts
+// src/xai-image-model-options.ts
 import { z as z4 } from "zod/v4";
 var xaiImageModelOptions = z4.object({
   aspect_ratio: z4.string().optional(),
@@ -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,27 +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 if (block.data instanceof URL) {
-                contentParts.push({
-                  type: "input_file",
-                  file_url: block.data.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)`
-                });
+              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;
             }
@@ -1776,7 +1802,7 @@ var xaiResponsesChunkSchema = z6.union([
   })
 ]);
 
-// src/responses/xai-responses-options.ts
+// src/responses/xai-responses-language-model-options.ts
 import { z as z7 } from "zod/v4";
 var xaiLanguageModelResponsesOptions = z7.object({
   /**
@@ -2939,12 +2965,12 @@ var xaiTools = {
 };
 
 // src/version.ts
-var VERSION = true ? "4.0.0-beta.46" : "0.0.0-test";
+var VERSION = true ? "4.0.0-beta.48" : "0.0.0-test";
 
 // src/files/xai-files.ts
 import {
   combineHeaders as combineHeaders4,
-  convertBase64ToUint8Array,
+  convertInlineFileDataToUint8Array,
   createJsonResponseHandler as createJsonResponseHandler4,
   parseProviderOptions as parseProviderOptions4,
   postFormDataToApi
@@ -2968,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(
@@ -3000,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
     });
@@ -3054,7 +3083,7 @@ import {
 } from "@ai-sdk/provider-utils";
 import { z as z18 } from "zod/v4";
 
-// src/xai-video-options.ts
+// src/xai-video-model-options.ts
 import { lazySchema as lazySchema7, zodSchema as zodSchema7 } from "@ai-sdk/provider-utils";
 import { z as z17 } from "zod/v4";
 var nonEmptyStringSchema = z17.string().min(1);