@ai-sdk/xai 0.0.0-64aae7dd-20260114144918

package/LICENSE

@@ -0,0 +1,13 @@
+Copyright 2023 Vercel, Inc.
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+    http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.

package/README.md

@@ -0,0 +1,36 @@
+# AI SDK - xAI Grok Provider
+
+The **[xAI Grok provider](https://ai-sdk.dev/providers/ai-sdk-providers/xai)** for the [AI SDK](https://ai-sdk.dev/docs)
+contains language model support for the xAI chat and completion APIs.
+
+## Setup
+
+The xAI Grok provider is available in the `@ai-sdk/xai` module. You can install it with
+
+```bash
+npm i @ai-sdk/xai
+```
+
+## Provider Instance
+
+You can import the default provider instance `xai` from `@ai-sdk/xai`:
+
+```ts
+import { xai } from '@ai-sdk/xai';
+```
+
+## Example
+
+```ts
+import { xai } from '@ai-sdk/xai';
+import { generateText } from 'ai';
+
+const { text } = await generateText({
+  model: xai('grok-3-beta'),
+  prompt: 'Write a vegetarian lasagna recipe for 4 people.',
+});
+```
+
+## Documentation
+
+Please check out the **[xAI Grok provider documentation](https://ai-sdk.dev/providers/ai-sdk-providers/xai)** for more information.

package/dist/index.d.mts

@@ -0,0 +1,279 @@
+import { z } from 'zod/v4';
+import { ProviderV3, LanguageModelV3, ImageModelV3 } 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' | '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-fast' | 'grok-3-fast-latest' | 'grok-3-mini' | 'grok-3-mini-latest' | 'grok-3-mini-fast' | 'grok-3-mini-fast-latest' | 'grok-2-vision-1212' | 'grok-2-vision' | 'grok-2-vision-latest' | 'grok-2-image-1212' | 'grok-2-image' | 'grok-2-image-latest' | 'grok-2-1212' | 'grok-2' | 'grok-2-latest' | 'grok-vision-beta' | 'grok-beta' | (string & {});
+declare const xaiProviderOptions: z.ZodObject<{
+    reasoningEffort: z.ZodOptional<z.ZodEnum<{
+        low: "low";
+        high: "high";
+    }>>;
+    parallel_function_calling: z.ZodOptional<z.ZodBoolean>;
+    searchParameters: z.ZodOptional<z.ZodObject<{
+        mode: z.ZodEnum<{
+            off: "off";
+            auto: "auto";
+            on: "on";
+        }>;
+        returnCitations: z.ZodOptional<z.ZodBoolean>;
+        fromDate: z.ZodOptional<z.ZodString>;
+        toDate: z.ZodOptional<z.ZodString>;
+        maxSearchResults: z.ZodOptional<z.ZodNumber>;
+        sources: z.ZodOptional<z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+            type: z.ZodLiteral<"web">;
+            country: z.ZodOptional<z.ZodString>;
+            excludedWebsites: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            allowedWebsites: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            safeSearch: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$strip>, z.ZodObject<{
+            type: z.ZodLiteral<"x">;
+            excludedXHandles: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            includedXHandles: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            postFavoriteCount: z.ZodOptional<z.ZodNumber>;
+            postViewCount: z.ZodOptional<z.ZodNumber>;
+            xHandles: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        }, z.core.$strip>, z.ZodObject<{
+            type: z.ZodLiteral<"news">;
+            country: z.ZodOptional<z.ZodString>;
+            excludedWebsites: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            safeSearch: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$strip>, z.ZodObject<{
+            type: z.ZodLiteral<"rss">;
+            links: z.ZodArray<z.ZodString>;
+        }, z.core.$strip>]>>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+type XaiProviderOptions = z.infer<typeof xaiProviderOptions>;
+
+declare const xaiErrorDataSchema: z.ZodObject<{
+    error: z.ZodObject<{
+        message: z.ZodString;
+        type: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        param: z.ZodOptional<z.ZodNullable<z.ZodAny>>;
+        code: z.ZodOptional<z.ZodNullable<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>>;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+type XaiErrorData = z.infer<typeof xaiErrorDataSchema>;
+
+type XaiResponsesModelId = 'grok-4-1' | 'grok-4-1-fast-reasoning' | 'grok-4-1-fast-non-reasoning' | 'grok-4' | 'grok-4-fast' | 'grok-4-fast-non-reasoning' | (string & {});
+/**
+ * @see https://docs.x.ai/docs/api-reference#create-new-response
+ */
+declare const xaiResponsesProviderOptions: z.ZodObject<{
+    reasoningEffort: z.ZodOptional<z.ZodEnum<{
+        low: "low";
+        high: "high";
+        medium: "medium";
+    }>>;
+    store: z.ZodOptional<z.ZodBoolean>;
+    previousResponseId: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+type XaiResponsesProviderOptions = z.infer<typeof xaiResponsesProviderOptions>;
+
+type XaiImageModelId = 'grok-2-image' | (string & {});
+
+declare const codeExecutionToolFactory: _ai_sdk_provider_utils.ProviderToolFactoryWithOutputSchema<Record<string, never>, {
+    output: string;
+    error?: string | undefined;
+}, object>;
+declare const codeExecution: (args?: Parameters<typeof codeExecutionToolFactory>[0]) => _ai_sdk_provider_utils.Tool<Record<string, never>, {
+    output: string;
+    error?: string | undefined;
+}>;
+
+declare const viewImageToolFactory: _ai_sdk_provider_utils.ProviderToolFactoryWithOutputSchema<Record<string, never>, {
+    description: string;
+    objects?: string[] | undefined;
+}, 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>;
+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<Record<string, never>, {
+    query: string;
+    sources: Array<{
+        title: string;
+        url: string;
+        snippet: string;
+    }>;
+}, {
+    allowedDomains?: string[];
+    excludedDomains?: string[];
+    enableImageUnderstanding?: boolean;
+}>;
+declare const webSearch: (args?: Parameters<typeof webSearchToolFactory>[0]) => _ai_sdk_provider_utils.Tool<Record<string, never>, {
+    query: string;
+    sources: Array<{
+        title: string;
+        url: string;
+        snippet: string;
+    }>;
+}>;
+
+declare const xSearchToolFactory: _ai_sdk_provider_utils.ProviderToolFactoryWithOutputSchema<Record<string, never>, {
+    query: string;
+    posts: Array<{
+        author: string;
+        text: string;
+        url: string;
+        likes: number;
+    }>;
+}, {
+    allowedXHandles?: string[];
+    excludedXHandles?: string[];
+    fromDate?: string;
+    toDate?: string;
+    enableImageUnderstanding?: boolean;
+    enableVideoUnderstanding?: boolean;
+}>;
+declare const xSearch: (args?: Parameters<typeof xSearchToolFactory>[0]) => _ai_sdk_provider_utils.Tool<Record<string, never>, {
+    query: string;
+    posts: Array<{
+        author: string;
+        text: string;
+        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>, {
+        output: string;
+        error?: string | undefined;
+    }>;
+    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>, {
+        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>, {
+        description: string;
+        transcript?: string | undefined;
+        duration?: number | undefined;
+    }>;
+    webSearch: (args?: Parameters<_ai_sdk_provider_utils.ProviderToolFactoryWithOutputSchema<Record<string, never>, {
+        query: string;
+        sources: Array<{
+            title: string;
+            url: string;
+            snippet: string;
+        }>;
+    }, {
+        allowedDomains?: string[];
+        excludedDomains?: string[];
+        enableImageUnderstanding?: boolean;
+    }>>[0]) => _ai_sdk_provider_utils.Tool<Record<string, never>, {
+        query: string;
+        sources: Array<{
+            title: string;
+            url: string;
+            snippet: string;
+        }>;
+    }>;
+    xSearch: (args?: Parameters<_ai_sdk_provider_utils.ProviderToolFactoryWithOutputSchema<Record<string, never>, {
+        query: string;
+        posts: Array<{
+            author: string;
+            text: string;
+            url: string;
+            likes: number;
+        }>;
+    }, {
+        allowedXHandles?: string[];
+        excludedXHandles?: string[];
+        fromDate?: string;
+        toDate?: string;
+        enableImageUnderstanding?: boolean;
+        enableVideoUnderstanding?: boolean;
+    }>>[0]) => _ai_sdk_provider_utils.Tool<Record<string, never>, {
+        query: string;
+        posts: Array<{
+            author: string;
+            text: string;
+            url: string;
+            likes: number;
+        }>;
+    }>;
+};
+
+interface XaiProvider extends ProviderV3 {
+    /**
+  Creates an Xai chat model for text generation.
+     */
+    (modelId: XaiChatModelId): LanguageModelV3;
+    /**
+  Creates an Xai language model for text generation.
+     */
+    languageModel(modelId: XaiChatModelId): LanguageModelV3;
+    /**
+  Creates an Xai chat model for text generation.
+     */
+    chat: (modelId: XaiChatModelId) => LanguageModelV3;
+    /**
+  Creates an Xai responses model for agentic tool calling.
+     */
+    responses: (modelId: XaiResponsesModelId) => LanguageModelV3;
+    /**
+  Creates an Xai image model for image generation.
+     */
+    image(modelId: XaiImageModelId): ImageModelV3;
+    /**
+  Creates an Xai image model for image generation.
+     */
+    imageModel(modelId: XaiImageModelId): ImageModelV3;
+    /**
+  Server-side agentic tools for use with the responses API.
+     */
+    tools: typeof xaiTools;
+    /**
+     * @deprecated Use `embeddingModel` instead.
+     */
+    textEmbeddingModel(modelId: string): never;
+}
+interface XaiProviderSettings {
+    /**
+  Base URL for the xAI API calls.
+       */
+    baseURL?: string;
+    /**
+  API key for authenticating requests.
+     */
+    apiKey?: string;
+    /**
+  Custom headers to include in the requests.
+     */
+    headers?: Record<string, string>;
+    /**
+  Custom fetch implementation. You can use it as a middleware to intercept requests,
+  or to provide a custom fetch implementation for e.g. testing.
+    */
+    fetch?: FetchFunction;
+}
+declare function createXai(options?: XaiProviderSettings): XaiProvider;
+declare const xai: XaiProvider;
+
+declare const VERSION: string;
+
+export { VERSION, type XaiErrorData, type XaiProvider, type XaiProviderOptions, type XaiProviderSettings, type XaiResponsesProviderOptions, codeExecution, createXai, viewImage, viewXVideo, webSearch, xSearch, xai, xaiTools };

package/dist/index.d.ts

@@ -0,0 +1,279 @@
+import { z } from 'zod/v4';
+import { ProviderV3, LanguageModelV3, ImageModelV3 } 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' | '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-fast' | 'grok-3-fast-latest' | 'grok-3-mini' | 'grok-3-mini-latest' | 'grok-3-mini-fast' | 'grok-3-mini-fast-latest' | 'grok-2-vision-1212' | 'grok-2-vision' | 'grok-2-vision-latest' | 'grok-2-image-1212' | 'grok-2-image' | 'grok-2-image-latest' | 'grok-2-1212' | 'grok-2' | 'grok-2-latest' | 'grok-vision-beta' | 'grok-beta' | (string & {});
+declare const xaiProviderOptions: z.ZodObject<{
+    reasoningEffort: z.ZodOptional<z.ZodEnum<{
+        low: "low";
+        high: "high";
+    }>>;
+    parallel_function_calling: z.ZodOptional<z.ZodBoolean>;
+    searchParameters: z.ZodOptional<z.ZodObject<{
+        mode: z.ZodEnum<{
+            off: "off";
+            auto: "auto";
+            on: "on";
+        }>;
+        returnCitations: z.ZodOptional<z.ZodBoolean>;
+        fromDate: z.ZodOptional<z.ZodString>;
+        toDate: z.ZodOptional<z.ZodString>;
+        maxSearchResults: z.ZodOptional<z.ZodNumber>;
+        sources: z.ZodOptional<z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+            type: z.ZodLiteral<"web">;
+            country: z.ZodOptional<z.ZodString>;
+            excludedWebsites: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            allowedWebsites: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            safeSearch: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$strip>, z.ZodObject<{
+            type: z.ZodLiteral<"x">;
+            excludedXHandles: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            includedXHandles: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            postFavoriteCount: z.ZodOptional<z.ZodNumber>;
+            postViewCount: z.ZodOptional<z.ZodNumber>;
+            xHandles: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        }, z.core.$strip>, z.ZodObject<{
+            type: z.ZodLiteral<"news">;
+            country: z.ZodOptional<z.ZodString>;
+            excludedWebsites: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            safeSearch: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$strip>, z.ZodObject<{
+            type: z.ZodLiteral<"rss">;
+            links: z.ZodArray<z.ZodString>;
+        }, z.core.$strip>]>>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+type XaiProviderOptions = z.infer<typeof xaiProviderOptions>;
+
+declare const xaiErrorDataSchema: z.ZodObject<{
+    error: z.ZodObject<{
+        message: z.ZodString;
+        type: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        param: z.ZodOptional<z.ZodNullable<z.ZodAny>>;
+        code: z.ZodOptional<z.ZodNullable<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>>;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+type XaiErrorData = z.infer<typeof xaiErrorDataSchema>;
+
+type XaiResponsesModelId = 'grok-4-1' | 'grok-4-1-fast-reasoning' | 'grok-4-1-fast-non-reasoning' | 'grok-4' | 'grok-4-fast' | 'grok-4-fast-non-reasoning' | (string & {});
+/**
+ * @see https://docs.x.ai/docs/api-reference#create-new-response
+ */
+declare const xaiResponsesProviderOptions: z.ZodObject<{
+    reasoningEffort: z.ZodOptional<z.ZodEnum<{
+        low: "low";
+        high: "high";
+        medium: "medium";
+    }>>;
+    store: z.ZodOptional<z.ZodBoolean>;
+    previousResponseId: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+type XaiResponsesProviderOptions = z.infer<typeof xaiResponsesProviderOptions>;
+
+type XaiImageModelId = 'grok-2-image' | (string & {});
+
+declare const codeExecutionToolFactory: _ai_sdk_provider_utils.ProviderToolFactoryWithOutputSchema<Record<string, never>, {
+    output: string;
+    error?: string | undefined;
+}, object>;
+declare const codeExecution: (args?: Parameters<typeof codeExecutionToolFactory>[0]) => _ai_sdk_provider_utils.Tool<Record<string, never>, {
+    output: string;
+    error?: string | undefined;
+}>;
+
+declare const viewImageToolFactory: _ai_sdk_provider_utils.ProviderToolFactoryWithOutputSchema<Record<string, never>, {
+    description: string;
+    objects?: string[] | undefined;
+}, 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>;
+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<Record<string, never>, {
+    query: string;
+    sources: Array<{
+        title: string;
+        url: string;
+        snippet: string;
+    }>;
+}, {
+    allowedDomains?: string[];
+    excludedDomains?: string[];
+    enableImageUnderstanding?: boolean;
+}>;
+declare const webSearch: (args?: Parameters<typeof webSearchToolFactory>[0]) => _ai_sdk_provider_utils.Tool<Record<string, never>, {
+    query: string;
+    sources: Array<{
+        title: string;
+        url: string;
+        snippet: string;
+    }>;
+}>;
+
+declare const xSearchToolFactory: _ai_sdk_provider_utils.ProviderToolFactoryWithOutputSchema<Record<string, never>, {
+    query: string;
+    posts: Array<{
+        author: string;
+        text: string;
+        url: string;
+        likes: number;
+    }>;
+}, {
+    allowedXHandles?: string[];
+    excludedXHandles?: string[];
+    fromDate?: string;
+    toDate?: string;
+    enableImageUnderstanding?: boolean;
+    enableVideoUnderstanding?: boolean;
+}>;
+declare const xSearch: (args?: Parameters<typeof xSearchToolFactory>[0]) => _ai_sdk_provider_utils.Tool<Record<string, never>, {
+    query: string;
+    posts: Array<{
+        author: string;
+        text: string;
+        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>, {
+        output: string;
+        error?: string | undefined;
+    }>;
+    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>, {
+        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>, {
+        description: string;
+        transcript?: string | undefined;
+        duration?: number | undefined;
+    }>;
+    webSearch: (args?: Parameters<_ai_sdk_provider_utils.ProviderToolFactoryWithOutputSchema<Record<string, never>, {
+        query: string;
+        sources: Array<{
+            title: string;
+            url: string;
+            snippet: string;
+        }>;
+    }, {
+        allowedDomains?: string[];
+        excludedDomains?: string[];
+        enableImageUnderstanding?: boolean;
+    }>>[0]) => _ai_sdk_provider_utils.Tool<Record<string, never>, {
+        query: string;
+        sources: Array<{
+            title: string;
+            url: string;
+            snippet: string;
+        }>;
+    }>;
+    xSearch: (args?: Parameters<_ai_sdk_provider_utils.ProviderToolFactoryWithOutputSchema<Record<string, never>, {
+        query: string;
+        posts: Array<{
+            author: string;
+            text: string;
+            url: string;
+            likes: number;
+        }>;
+    }, {
+        allowedXHandles?: string[];
+        excludedXHandles?: string[];
+        fromDate?: string;
+        toDate?: string;
+        enableImageUnderstanding?: boolean;
+        enableVideoUnderstanding?: boolean;
+    }>>[0]) => _ai_sdk_provider_utils.Tool<Record<string, never>, {
+        query: string;
+        posts: Array<{
+            author: string;
+            text: string;
+            url: string;
+            likes: number;
+        }>;
+    }>;
+};
+
+interface XaiProvider extends ProviderV3 {
+    /**
+  Creates an Xai chat model for text generation.
+     */
+    (modelId: XaiChatModelId): LanguageModelV3;
+    /**
+  Creates an Xai language model for text generation.
+     */
+    languageModel(modelId: XaiChatModelId): LanguageModelV3;
+    /**
+  Creates an Xai chat model for text generation.
+     */
+    chat: (modelId: XaiChatModelId) => LanguageModelV3;
+    /**
+  Creates an Xai responses model for agentic tool calling.
+     */
+    responses: (modelId: XaiResponsesModelId) => LanguageModelV3;
+    /**
+  Creates an Xai image model for image generation.
+     */
+    image(modelId: XaiImageModelId): ImageModelV3;
+    /**
+  Creates an Xai image model for image generation.
+     */
+    imageModel(modelId: XaiImageModelId): ImageModelV3;
+    /**
+  Server-side agentic tools for use with the responses API.
+     */
+    tools: typeof xaiTools;
+    /**
+     * @deprecated Use `embeddingModel` instead.
+     */
+    textEmbeddingModel(modelId: string): never;
+}
+interface XaiProviderSettings {
+    /**
+  Base URL for the xAI API calls.
+       */
+    baseURL?: string;
+    /**
+  API key for authenticating requests.
+     */
+    apiKey?: string;
+    /**
+  Custom headers to include in the requests.
+     */
+    headers?: Record<string, string>;
+    /**
+  Custom fetch implementation. You can use it as a middleware to intercept requests,
+  or to provide a custom fetch implementation for e.g. testing.
+    */
+    fetch?: FetchFunction;
+}
+declare function createXai(options?: XaiProviderSettings): XaiProvider;
+declare const xai: XaiProvider;
+
+declare const VERSION: string;
+
+export { VERSION, type XaiErrorData, type XaiProvider, type XaiProviderOptions, type XaiProviderSettings, type XaiResponsesProviderOptions, codeExecution, createXai, viewImage, viewXVideo, webSearch, xSearch, xai, xaiTools };