@ai-sdk/xai 4.0.0-beta.2 → 4.0.0-beta.21

package/dist/index.d.ts

@@ -1,9 +1,9 @@
 import { z } from 'zod/v4';
-import { ProviderV3, LanguageModelV3, ImageModelV3, Experimental_VideoModelV3 } from '@ai-sdk/provider';
+import { ProviderV4, LanguageModelV4, ImageModelV4, Experimental_VideoModelV4 } from '@ai-sdk/provider';
 import * as _ai_sdk_provider_utils from '@ai-sdk/provider-utils';
 import { FetchFunction } from '@ai-sdk/provider-utils';
 
-type XaiChatModelId = 'grok-4-1-fast-reasoning' | 'grok-4-1-fast-non-reasoning' | 'grok-4-fast-non-reasoning' | 'grok-4-fast-reasoning' | '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-2-vision-1212' | 'grok-2-vision' | 'grok-2-vision-latest' | 'grok-2-image-1212' | 'grok-2-image' | 'grok-2-image-latest' | (string & {});
+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.20-0309-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' | (string & {});
 declare const xaiLanguageModelChatOptions: z.ZodObject<{
     reasoningEffort: z.ZodOptional<z.ZodEnum<{
         low: "low";
@@ -58,7 +58,7 @@ declare const xaiErrorDataSchema: z.ZodObject<{
 }, z.core.$strip>;
 type XaiErrorData = z.infer<typeof xaiErrorDataSchema>;
 
-type XaiResponsesModelId = 'grok-4-1-fast-reasoning' | 'grok-4-1-fast-non-reasoning' | 'grok-4' | 'grok-4-fast-non-reasoning' | 'grok-4-fast-reasoning' | (string & {});
+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.20-0309-reasoning' | 'grok-4.20-multi-agent-0309' | (string & {});
 /**
  * @see https://docs.x.ai/docs/api-reference#create-new-response
  */
@@ -68,6 +68,11 @@ declare const xaiLanguageModelResponsesOptions: z.ZodObject<{
         high: "high";
         medium: "medium";
     }>>;
+    reasoningSummary: z.ZodOptional<z.ZodEnum<{
+        auto: "auto";
+        concise: "concise";
+        detailed: "detailed";
+    }>>;
     logprobs: z.ZodOptional<z.ZodBoolean>;
     topLogprobs: z.ZodOptional<z.ZodNumber>;
     store: z.ZodOptional<z.ZodBoolean>;
@@ -86,6 +91,12 @@ declare const xaiImageModelOptions: z.ZodObject<{
         "1k": "1k";
         "2k": "2k";
     }>>;
+    quality: z.ZodOptional<z.ZodEnum<{
+        low: "low";
+        high: "high";
+        medium: "medium";
+    }>>;
+    user: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
 type XaiImageModelOptions = z.infer<typeof xaiImageModelOptions>;
 
@@ -99,16 +110,16 @@ type XaiVideoModelOptions = {
     [key: string]: unknown;
 };
 
-type XaiImageModelId = 'grok-2-image' | 'grok-2-image-1212' | 'grok-imagine-image' | 'grok-imagine-image-pro' | (string & {});
+type XaiImageModelId = 'grok-imagine-image' | 'grok-imagine-image-pro' | (string & {});
 
 declare const codeExecutionToolFactory: _ai_sdk_provider_utils.ProviderToolFactoryWithOutputSchema<Record<string, never>, {
     output: string;
     error?: string | undefined;
-}, object>;
+}, object, {}>;
 declare const codeExecution: (args?: Parameters<typeof codeExecutionToolFactory>[0]) => _ai_sdk_provider_utils.Tool<Record<string, never>, {
     output: string;
     error?: string | undefined;
-}>;
+}, {}>;
 
 declare const mcpServerToolFactory: _ai_sdk_provider_utils.ProviderToolFactoryWithOutputSchema<{}, {
     name: string;
@@ -121,32 +132,32 @@ declare const mcpServerToolFactory: _ai_sdk_provider_utils.ProviderToolFactoryWi
     allowedTools?: string[];
     headers?: Record<string, string>;
     authorization?: string;
-}>;
+}, {}>;
 declare const mcpServer: (args: Parameters<typeof mcpServerToolFactory>[0]) => _ai_sdk_provider_utils.Tool<{}, {
     name: string;
     arguments: string;
     result: unknown;
-}>;
+}, {}>;
 
 declare const viewImageToolFactory: _ai_sdk_provider_utils.ProviderToolFactoryWithOutputSchema<Record<string, never>, {
     description: string;
     objects?: string[] | undefined;
-}, object>;
+}, object, {}>;
 declare const viewImage: (args?: Parameters<typeof viewImageToolFactory>[0]) => _ai_sdk_provider_utils.Tool<Record<string, never>, {
     description: string;
     objects?: string[] | undefined;
-}>;
+}, {}>;
 
 declare const viewXVideoToolFactory: _ai_sdk_provider_utils.ProviderToolFactoryWithOutputSchema<Record<string, never>, {
     description: string;
     transcript?: string | undefined;
     duration?: number | undefined;
-}, object>;
+}, object, {}>;
 declare const viewXVideo: (args?: Parameters<typeof viewXVideoToolFactory>[0]) => _ai_sdk_provider_utils.Tool<Record<string, never>, {
     description: string;
     transcript?: string | undefined;
     duration?: number | undefined;
-}>;
+}, {}>;
 
 declare const webSearchToolFactory: _ai_sdk_provider_utils.ProviderToolFactoryWithOutputSchema<{}, {
     query: string;
@@ -159,7 +170,7 @@ declare const webSearchToolFactory: _ai_sdk_provider_utils.ProviderToolFactoryWi
     allowedDomains?: string[];
     excludedDomains?: string[];
     enableImageUnderstanding?: boolean;
-}>;
+}, {}>;
 declare const webSearch: (args?: Parameters<typeof webSearchToolFactory>[0]) => _ai_sdk_provider_utils.Tool<{}, {
     query: string;
     sources: Array<{
@@ -167,7 +178,7 @@ declare const webSearch: (args?: Parameters<typeof webSearchToolFactory>[0]) =>
         url: string;
         snippet: string;
     }>;
-}>;
+}, {}>;
 
 declare const xSearchToolFactory: _ai_sdk_provider_utils.ProviderToolFactoryWithOutputSchema<{}, {
     query: string;
@@ -184,7 +195,7 @@ declare const xSearchToolFactory: _ai_sdk_provider_utils.ProviderToolFactoryWith
     toDate?: string;
     enableImageUnderstanding?: boolean;
     enableVideoUnderstanding?: boolean;
-}>;
+}, {}>;
 declare const xSearch: (args?: Parameters<typeof xSearchToolFactory>[0]) => _ai_sdk_provider_utils.Tool<{}, {
     query: string;
     posts: Array<{
@@ -193,16 +204,16 @@ declare const xSearch: (args?: Parameters<typeof xSearchToolFactory>[0]) => _ai_
         url: string;
         likes: number;
     }>;
-}>;
+}, {}>;
 
 declare const xaiTools: {
     codeExecution: (args?: Parameters<_ai_sdk_provider_utils.ProviderToolFactoryWithOutputSchema<Record<string, never>, {
         output: string;
         error?: string | undefined;
-    }, object>>[0]) => _ai_sdk_provider_utils.Tool<Record<string, never>, {
+    }, object, {}>>[0]) => _ai_sdk_provider_utils.Tool<Record<string, never>, {
         output: string;
         error?: string | undefined;
-    }>;
+    }, {}>;
     fileSearch: (args: Parameters<_ai_sdk_provider_utils.ProviderToolFactoryWithOutputSchema<{}, {
         queries: string[];
         results: null | {
@@ -214,7 +225,7 @@ declare const xaiTools: {
     }, {
         vectorStoreIds: string[];
         maxNumResults?: number;
-    }>>[0]) => _ai_sdk_provider_utils.Tool<{}, {
+    }, {}>>[0]) => _ai_sdk_provider_utils.Tool<{}, {
         queries: string[];
         results: null | {
             fileId: string;
@@ -222,7 +233,7 @@ declare const xaiTools: {
             score: number;
             text: string;
         }[];
-    }>;
+    }, {}>;
     mcpServer: (args: Parameters<_ai_sdk_provider_utils.ProviderToolFactoryWithOutputSchema<{}, {
         name: string;
         arguments: string;
@@ -234,27 +245,27 @@ declare const xaiTools: {
         allowedTools?: string[];
         headers?: Record<string, string>;
         authorization?: string;
-    }>>[0]) => _ai_sdk_provider_utils.Tool<{}, {
+    }, {}>>[0]) => _ai_sdk_provider_utils.Tool<{}, {
         name: string;
         arguments: string;
         result: unknown;
-    }>;
+    }, {}>;
     viewImage: (args?: Parameters<_ai_sdk_provider_utils.ProviderToolFactoryWithOutputSchema<Record<string, never>, {
         description: string;
         objects?: string[] | undefined;
-    }, object>>[0]) => _ai_sdk_provider_utils.Tool<Record<string, never>, {
+    }, object, {}>>[0]) => _ai_sdk_provider_utils.Tool<Record<string, never>, {
         description: string;
         objects?: string[] | undefined;
-    }>;
+    }, {}>;
     viewXVideo: (args?: Parameters<_ai_sdk_provider_utils.ProviderToolFactoryWithOutputSchema<Record<string, never>, {
         description: string;
         transcript?: string | undefined;
         duration?: number | undefined;
-    }, object>>[0]) => _ai_sdk_provider_utils.Tool<Record<string, never>, {
+    }, object, {}>>[0]) => _ai_sdk_provider_utils.Tool<Record<string, never>, {
         description: string;
         transcript?: string | undefined;
         duration?: number | undefined;
-    }>;
+    }, {}>;
     webSearch: (args?: Parameters<_ai_sdk_provider_utils.ProviderToolFactoryWithOutputSchema<{}, {
         query: string;
         sources: Array<{
@@ -266,14 +277,14 @@ declare const xaiTools: {
         allowedDomains?: string[];
         excludedDomains?: string[];
         enableImageUnderstanding?: boolean;
-    }>>[0]) => _ai_sdk_provider_utils.Tool<{}, {
+    }, {}>>[0]) => _ai_sdk_provider_utils.Tool<{}, {
         query: string;
         sources: Array<{
             title: string;
             url: string;
             snippet: string;
         }>;
-    }>;
+    }, {}>;
     xSearch: (args?: Parameters<_ai_sdk_provider_utils.ProviderToolFactoryWithOutputSchema<{}, {
         query: string;
         posts: Array<{
@@ -289,7 +300,7 @@ declare const xaiTools: {
         toDate?: string;
         enableImageUnderstanding?: boolean;
         enableVideoUnderstanding?: boolean;
-    }>>[0]) => _ai_sdk_provider_utils.Tool<{}, {
+    }, {}>>[0]) => _ai_sdk_provider_utils.Tool<{}, {
         query: string;
         posts: Array<{
             author: string;
@@ -297,42 +308,39 @@ declare const xaiTools: {
             url: string;
             likes: number;
         }>;
-    }>;
+    }, {}>;
 };
 
-interface XaiProvider extends ProviderV3 {
-    /**
-     * Creates an Xai chat model for text generation.
-     */
-    (modelId: XaiChatModelId): LanguageModelV3;
+interface XaiProvider extends ProviderV4 {
+    (modelId: XaiResponsesModelId): LanguageModelV4;
     /**
      * Creates an Xai language model for text generation.
      */
-    languageModel(modelId: XaiChatModelId): LanguageModelV3;
+    languageModel(modelId: XaiResponsesModelId): LanguageModelV4;
     /**
      * Creates an Xai chat model for text generation.
      */
-    chat: (modelId: XaiChatModelId) => LanguageModelV3;
+    chat: (modelId: XaiChatModelId) => LanguageModelV4;
     /**
-     * Creates an Xai responses model for agentic tool calling.
+     * Creates an Xai responses model for text generation.
      */
-    responses: (modelId: XaiResponsesModelId) => LanguageModelV3;
+    responses: (modelId: XaiResponsesModelId) => LanguageModelV4;
     /**
      * Creates an Xai image model for image generation.
      */
-    image(modelId: XaiImageModelId): ImageModelV3;
+    image(modelId: XaiImageModelId): ImageModelV4;
     /**
      * Creates an Xai image model for image generation.
      */
-    imageModel(modelId: XaiImageModelId): ImageModelV3;
+    imageModel(modelId: XaiImageModelId): ImageModelV4;
     /**
      * Creates an Xai video model for video generation.
      */
-    video(modelId: XaiVideoModelId): Experimental_VideoModelV3;
+    video(modelId: XaiVideoModelId): Experimental_VideoModelV4;
     /**
      * Creates an Xai video model for video generation.
      */
-    videoModel(modelId: XaiVideoModelId): Experimental_VideoModelV3;
+    videoModel(modelId: XaiVideoModelId): Experimental_VideoModelV4;
     /**
      * Server-side agentic tools for use with the responses API.
      */