@ai-sdk/openai 4.0.0-beta.6 → 4.0.0-beta.74

package/README.md

@@ -3,6 +3,8 @@
 The **[OpenAI provider](https://ai-sdk.dev/providers/ai-sdk-providers/openai)** for the [AI SDK](https://ai-sdk.dev/docs)
 contains language model support for the OpenAI chat and completion APIs and embedding model support for the OpenAI embeddings API.
 
+> **Deploying to Vercel?** With Vercel's AI Gateway you can access OpenAI (and hundreds of models from other providers) — no additional packages, API keys, or extra cost. [Get started with AI Gateway](https://vercel.com/ai-gateway).
+
 ## Setup
 
 The OpenAI provider is available in the `@ai-sdk/openai` module. You can install it with

package/dist/index.d.ts

@@ -1,9 +1,9 @@
 import * as _ai_sdk_provider from '@ai-sdk/provider';
-import { ProviderV4, LanguageModelV4, EmbeddingModelV4, ImageModelV4, TranscriptionModelV4, SpeechModelV4 } from '@ai-sdk/provider';
+import { JSONValue, ProviderV4, LanguageModelV4, EmbeddingModelV4, ImageModelV4, TranscriptionModelV4, SpeechModelV4, Experimental_RealtimeFactoryV4, FilesV4, SkillsV4, Experimental_RealtimeModelV4, Experimental_RealtimeModelV4ClientSecretOptions, Experimental_RealtimeModelV4ClientSecretResult, Experimental_RealtimeModelV4ServerEvent, Experimental_RealtimeModelV4ClientEvent, Experimental_RealtimeModelV4SessionConfig } from '@ai-sdk/provider';
 import * as _ai_sdk_provider_utils from '@ai-sdk/provider-utils';
 import { InferSchema, FetchFunction } from '@ai-sdk/provider-utils';
 
-type OpenAIChatModelId = 'o1' | 'o1-2024-12-17' | 'o3-mini' | 'o3-mini-2025-01-31' | 'o3' | 'o3-2025-04-16' | 'o4-mini' | 'o4-mini-2025-04-16' | 'gpt-4.1' | 'gpt-4.1-2025-04-14' | 'gpt-4.1-mini' | 'gpt-4.1-mini-2025-04-14' | 'gpt-4.1-nano' | 'gpt-4.1-nano-2025-04-14' | 'gpt-4o' | 'gpt-4o-2024-05-13' | 'gpt-4o-2024-08-06' | 'gpt-4o-2024-11-20' | 'gpt-4o-audio-preview' | 'gpt-4o-audio-preview-2024-12-17' | 'gpt-4o-audio-preview-2025-06-03' | 'gpt-4o-mini' | 'gpt-4o-mini-2024-07-18' | 'gpt-4o-mini-audio-preview' | 'gpt-4o-mini-audio-preview-2024-12-17' | 'gpt-4o-search-preview' | 'gpt-4o-search-preview-2025-03-11' | 'gpt-4o-mini-search-preview' | 'gpt-4o-mini-search-preview-2025-03-11' | 'gpt-3.5-turbo-0125' | 'gpt-3.5-turbo' | 'gpt-3.5-turbo-1106' | 'gpt-3.5-turbo-16k' | 'gpt-5' | 'gpt-5-2025-08-07' | 'gpt-5-mini' | 'gpt-5-mini-2025-08-07' | 'gpt-5-nano' | 'gpt-5-nano-2025-08-07' | 'gpt-5-chat-latest' | 'gpt-5.1' | 'gpt-5.1-2025-11-13' | 'gpt-5.1-chat-latest' | 'gpt-5.2' | 'gpt-5.2-2025-12-11' | 'gpt-5.2-chat-latest' | 'gpt-5.2-pro' | 'gpt-5.2-pro-2025-12-11' | 'gpt-5.3-chat-latest' | 'gpt-5.4' | 'gpt-5.4-2026-03-05' | 'gpt-5.4-pro' | 'gpt-5.4-pro-2026-03-05' | (string & {});
+type OpenAIChatModelId = 'o1' | 'o1-2024-12-17' | 'o3-mini' | 'o3-mini-2025-01-31' | 'o3' | 'o3-2025-04-16' | 'o4-mini' | 'o4-mini-2025-04-16' | 'gpt-4.1' | 'gpt-4.1-2025-04-14' | 'gpt-4.1-mini' | 'gpt-4.1-mini-2025-04-14' | 'gpt-4.1-nano' | 'gpt-4.1-nano-2025-04-14' | 'gpt-4o' | 'gpt-4o-2024-05-13' | 'gpt-4o-2024-08-06' | 'gpt-4o-2024-11-20' | 'gpt-4o-audio-preview' | 'gpt-4o-audio-preview-2024-12-17' | 'gpt-4o-audio-preview-2025-06-03' | 'gpt-4o-mini' | 'gpt-4o-mini-2024-07-18' | 'gpt-4o-mini-audio-preview' | 'gpt-4o-mini-audio-preview-2024-12-17' | 'gpt-4o-search-preview' | 'gpt-4o-search-preview-2025-03-11' | 'gpt-4o-mini-search-preview' | 'gpt-4o-mini-search-preview-2025-03-11' | 'gpt-3.5-turbo-0125' | 'gpt-3.5-turbo' | 'gpt-3.5-turbo-1106' | 'gpt-3.5-turbo-16k' | 'gpt-5' | 'gpt-5-2025-08-07' | 'gpt-5-mini' | 'gpt-5-mini-2025-08-07' | 'gpt-5-nano' | 'gpt-5-nano-2025-08-07' | 'gpt-5-chat-latest' | 'gpt-5.1' | 'gpt-5.1-2025-11-13' | 'gpt-5.1-chat-latest' | 'gpt-5.2' | 'gpt-5.2-2025-12-11' | 'gpt-5.2-chat-latest' | 'gpt-5.2-pro' | 'gpt-5.2-pro-2025-12-11' | 'gpt-5.3-chat-latest' | 'gpt-5.4' | 'gpt-5.4-2026-03-05' | 'gpt-5.4-mini' | 'gpt-5.4-mini-2026-03-17' | 'gpt-5.4-nano' | 'gpt-5.4-nano-2026-03-17' | 'gpt-5.4-pro' | 'gpt-5.4-pro-2026-03-05' | 'gpt-5.5' | 'gpt-5.5-2026-04-23' | (string & {});
 declare const openaiLanguageModelChatOptions: _ai_sdk_provider_utils.LazySchema<{
     logitBias?: Record<number, number> | undefined;
     logprobs?: number | boolean | undefined;
@@ -42,9 +42,36 @@ declare const openaiEmbeddingModelOptions: _ai_sdk_provider_utils.LazySchema<{
 }>;
 type OpenAIEmbeddingModelOptions = InferSchema<typeof openaiEmbeddingModelOptions>;
 
-type OpenAIImageModelId = 'dall-e-3' | 'dall-e-2' | 'gpt-image-1' | 'gpt-image-1-mini' | 'gpt-image-1.5' | 'chatgpt-image-latest' | (string & {});
+type OpenAIImageModelId = 'dall-e-3' | 'dall-e-2' | 'gpt-image-1' | 'gpt-image-1-mini' | 'gpt-image-1.5' | 'gpt-image-2' | 'chatgpt-image-latest' | (string & {});
+declare const openaiImageModelOptions: _ai_sdk_provider_utils.LazySchema<{
+    quality?: "auto" | "low" | "medium" | "high" | "standard" | "hd" | undefined;
+    background?: "auto" | "transparent" | "opaque" | undefined;
+    outputFormat?: "png" | "jpeg" | "webp" | undefined;
+    outputCompression?: number | undefined;
+    user?: string | undefined;
+}>;
+type OpenAIImageModelOptions = InferSchema<typeof openaiImageModelOptions>;
+declare const openaiImageModelGenerationOptions: _ai_sdk_provider_utils.LazySchema<{
+    quality?: "auto" | "low" | "medium" | "high" | "standard" | "hd" | undefined;
+    background?: "auto" | "transparent" | "opaque" | undefined;
+    outputFormat?: "png" | "jpeg" | "webp" | undefined;
+    outputCompression?: number | undefined;
+    user?: string | undefined;
+    style?: "vivid" | "natural" | undefined;
+    moderation?: "auto" | "low" | undefined;
+}>;
+type OpenAIImageModelGenerationOptions = InferSchema<typeof openaiImageModelGenerationOptions>;
+declare const openaiImageModelEditOptions: _ai_sdk_provider_utils.LazySchema<{
+    quality?: "auto" | "low" | "medium" | "high" | "standard" | "hd" | undefined;
+    background?: "auto" | "transparent" | "opaque" | undefined;
+    outputFormat?: "png" | "jpeg" | "webp" | undefined;
+    outputCompression?: number | undefined;
+    user?: string | undefined;
+    inputFidelity?: "low" | "high" | undefined;
+}>;
+type OpenAIImageModelEditOptions = InferSchema<typeof openaiImageModelEditOptions>;
 
-declare const webSearchToolFactory: _ai_sdk_provider_utils.ProviderToolFactoryWithOutputSchema<{}, {
+declare const webSearchToolFactory: _ai_sdk_provider_utils.ProviderExecutedToolFactory<{}, {
     /**
      * An object describing the specific action taken in this web search call.
      * Includes details on how the model used the web (search, open_page, find_in_page).
@@ -56,8 +83,14 @@ declare const webSearchToolFactory: _ai_sdk_provider_utils.ProviderToolFactoryWi
         type: "search";
         /**
          * The search query.
+         *
+         * @deprecated Use `queries` instead.
          */
         query?: string;
+        /**
+         * The search queries the model used.
+         */
+        queries?: string[];
     } | {
         /**
          * Action type "openPage" - Opens a specific URL from search results.
@@ -141,7 +174,7 @@ declare const webSearchToolFactory: _ai_sdk_provider_utils.ProviderToolFactoryWi
          */
         timezone?: string;
     };
-}>;
+}, {}>;
 
 /**
  * A filter used to compare a specified attribute key to a given value using a defined comparison operation.
@@ -176,6 +209,21 @@ type OpenAIResponsesFileSearchToolCompoundFilter = {
 declare const openaiResponsesChunkSchema: _ai_sdk_provider_utils.LazySchema<{
     type: "unknown_chunk";
     message: string;
+} | {
+    type: "error";
+    sequence_number: number;
+    error: {
+        type: string;
+        code: string;
+        message: string;
+        param?: string | null | undefined;
+    };
+} | {
+    type: "error";
+    sequence_number: number;
+    message: string;
+    code?: string | null | undefined;
+    param?: string | null | undefined;
 } | {
     type: "response.output_text.delta";
     item_id: string;
@@ -206,6 +254,29 @@ declare const openaiResponsesChunkSchema: _ai_sdk_provider_utils.LazySchema<{
         } | null | undefined;
         service_tier?: string | null | undefined;
     };
+} | {
+    type: "response.failed";
+    sequence_number: number;
+    response: {
+        error?: {
+            message: string;
+            code?: string | null | undefined;
+        } | null | undefined;
+        incomplete_details?: {
+            reason: string;
+        } | null | undefined;
+        usage?: {
+            input_tokens: number;
+            output_tokens: number;
+            input_tokens_details?: {
+                cached_tokens?: number | null | undefined;
+            } | null | undefined;
+            output_tokens_details?: {
+                reasoning_tokens?: number | null | undefined;
+            } | null | undefined;
+        } | null | undefined;
+        service_tier?: string | null | undefined;
+    };
 } | {
     type: "response.created";
     response: {
@@ -231,6 +302,7 @@ declare const openaiResponsesChunkSchema: _ai_sdk_provider_utils.LazySchema<{
         call_id: string;
         name: string;
         arguments: string;
+        namespace?: string | null | undefined;
     } | {
         type: "web_search_call";
         id: string;
@@ -300,6 +372,10 @@ declare const openaiResponsesChunkSchema: _ai_sdk_provider_utils.LazySchema<{
         action: {
             commands: string[];
         };
+    } | {
+        type: "compaction";
+        id: string;
+        encrypted_content?: string | null | undefined;
     } | {
         type: "shell_call_output";
         id: string;
@@ -315,6 +391,20 @@ declare const openaiResponsesChunkSchema: _ai_sdk_provider_utils.LazySchema<{
                 exit_code: number;
             };
         }[];
+    } | {
+        type: "tool_search_call";
+        id: string;
+        execution: "server" | "client";
+        call_id: string | null;
+        status: "completed" | "in_progress" | "incomplete";
+        arguments: unknown;
+    } | {
+        type: "tool_search_output";
+        id: string;
+        execution: "server" | "client";
+        call_id: string | null;
+        status: "completed" | "in_progress" | "incomplete";
+        tools: Record<string, JSONValue | undefined>[];
     };
 } | {
     type: "response.output_item.done";
@@ -334,6 +424,7 @@ declare const openaiResponsesChunkSchema: _ai_sdk_provider_utils.LazySchema<{
         name: string;
         arguments: string;
         status: "completed";
+        namespace?: string | null | undefined;
     } | {
         type: "custom_tool_call";
         id: string;
@@ -364,6 +455,7 @@ declare const openaiResponsesChunkSchema: _ai_sdk_provider_utils.LazySchema<{
         action?: {
             type: "search";
             query?: string | null | undefined;
+            queries?: string[] | null | undefined;
             sources?: ({
                 type: "url";
                 url: string;
@@ -469,6 +561,10 @@ declare const openaiResponsesChunkSchema: _ai_sdk_provider_utils.LazySchema<{
         action: {
             commands: string[];
         };
+    } | {
+        type: "compaction";
+        id: string;
+        encrypted_content: string;
     } | {
         type: "shell_call_output";
         id: string;
@@ -484,6 +580,20 @@ declare const openaiResponsesChunkSchema: _ai_sdk_provider_utils.LazySchema<{
                 exit_code: number;
             };
         }[];
+    } | {
+        type: "tool_search_call";
+        id: string;
+        execution: "server" | "client";
+        call_id: string | null;
+        status: "completed" | "in_progress" | "incomplete";
+        arguments: unknown;
+    } | {
+        type: "tool_search_output";
+        id: string;
+        execution: "server" | "client";
+        call_id: string | null;
+        status: "completed" | "in_progress" | "incomplete";
+        tools: Record<string, JSONValue | undefined>[];
     };
 } | {
     type: "response.function_call_arguments.delta";
@@ -559,26 +669,13 @@ declare const openaiResponsesChunkSchema: _ai_sdk_provider_utils.LazySchema<{
     item_id: string;
     output_index: number;
     diff: string;
-} | {
-    type: "error";
-    sequence_number: number;
-    error: {
-        type: string;
-        code: string;
-        message: string;
-        param?: string | null | undefined;
-    };
 }>;
 type OpenAIResponsesChunk = InferSchema<typeof openaiResponsesChunkSchema>;
 type OpenAIResponsesLogprobs = NonNullable<(OpenAIResponsesChunk & {
     type: 'response.output_text.delta';
 })['logprobs']> | null;
 
-declare const customToolFactory: _ai_sdk_provider_utils.ProviderToolFactory<string, {
-    /**
-     * The name of the custom tool, used to identify it in the API.
-     */
-    name: string;
+declare const customToolFactory: _ai_sdk_provider_utils.ProviderDefinedToolFactory<string, {
     /**
      * An optional description of what the tool does.
      */
@@ -594,7 +691,7 @@ declare const customToolFactory: _ai_sdk_provider_utils.ProviderToolFactory<stri
     } | {
         type: "text";
     };
-}>;
+}, {}>;
 
 /**
  * Type definitions for the apply_patch operations.
@@ -635,23 +732,22 @@ declare const openaiTools: {
      * enabling iterative, multi-step code editing workflows.
      *
      */
-    applyPatch: _ai_sdk_provider_utils.ProviderToolFactoryWithOutputSchema<{
+    applyPatch: _ai_sdk_provider_utils.ProviderDefinedToolFactoryWithOutputSchema<{
         callId: string;
         operation: ApplyPatchOperation;
     }, {
         status: "completed" | "failed";
         output?: string;
-    }, {}>;
+    }, {}, {}>;
     /**
      * Custom tools let callers constrain model output to a grammar (regex or
      * Lark syntax). The model returns a `custom_tool_call` output item whose
      * `input` field is a string matching the specified grammar.
      *
-     * @param name - The name of the custom tool.
      * @param description - An optional description of the tool.
      * @param format - The output format constraint (grammar type, syntax, and definition).
      */
-    customTool: (args: Parameters<typeof customToolFactory>[0]) => _ai_sdk_provider_utils.Tool<string, unknown>;
+    customTool: (args: Parameters<typeof customToolFactory>[0]) => _ai_sdk_provider_utils.ProviderDefinedTool<string, unknown, {}>;
     /**
      * The Code Interpreter tool allows models to write and run Python code in a
      * sandboxed environment to solve complex problems in domains like data analysis,
@@ -663,7 +759,7 @@ declare const openaiTools: {
         container?: string | {
             fileIds?: string[];
         };
-    }) => _ai_sdk_provider_utils.Tool<{
+    }) => _ai_sdk_provider_utils.ProviderExecutedTool<{
         code?: string | null;
         containerId: string;
     }, {
@@ -674,7 +770,7 @@ declare const openaiTools: {
             type: "image";
             url: string;
         }> | null;
-    }>;
+    }, {}>;
     /**
      * File search is a tool available in the Responses API. It enables models to
      * retrieve information in a knowledge base of previously uploaded files through
@@ -685,7 +781,7 @@ declare const openaiTools: {
      * @param ranking - The ranking options to use for the file search.
      * @param filters - The filters to use for the file search.
      */
-    fileSearch: _ai_sdk_provider_utils.ProviderToolFactoryWithOutputSchema<{}, {
+    fileSearch: _ai_sdk_provider_utils.ProviderExecutedToolFactory<{}, {
         queries: string[];
         results: null | {
             attributes: Record<string, unknown>;
@@ -702,7 +798,7 @@ declare const openaiTools: {
             scoreThreshold?: number;
         };
         filters?: OpenAIResponsesFileSearchToolComparisonFilter | OpenAIResponsesFileSearchToolCompoundFilter;
-    }>;
+    }, {}>;
     /**
      * The image generation tool allows you to generate images using a text prompt,
      * and optionally image inputs. It leverages the GPT Image model,
@@ -733,16 +829,16 @@ declare const openaiTools: {
         partialImages?: number;
         quality?: "auto" | "low" | "medium" | "high";
         size?: "auto" | "1024x1024" | "1024x1536" | "1536x1024";
-    }) => _ai_sdk_provider_utils.Tool<{}, {
+    }) => _ai_sdk_provider_utils.ProviderExecutedTool<{}, {
         result: string;
-    }>;
+    }, {}>;
     /**
      * Local shell is a tool that allows agents to run shell commands locally
      * on a machine you or the user provides.
      *
      * Supported models: `gpt-5-codex`
      */
-    localShell: _ai_sdk_provider_utils.ProviderToolFactoryWithOutputSchema<{
+    localShell: _ai_sdk_provider_utils.ProviderDefinedToolFactoryWithOutputSchema<{
         action: {
             type: "exec";
             command: string[];
@@ -753,7 +849,7 @@ declare const openaiTools: {
         };
     }, {
         output: string;
-    }, {}>;
+    }, {}, {}>;
     /**
      * The shell tool allows the model to interact with your local computer through
      * a controlled command-line interface. The model proposes shell commands; your
@@ -765,7 +861,7 @@ declare const openaiTools: {
      * execution or add strict allow-/deny-lists before forwarding a command to
      * the system shell.
      */
-    shell: _ai_sdk_provider_utils.ProviderToolFactoryWithOutputSchema<{
+    shell: _ai_sdk_provider_utils.ProviderDefinedToolFactoryWithOutputSchema<{
         action: {
             commands: string[];
             timeoutMs?: number;
@@ -800,7 +896,7 @@ declare const openaiTools: {
             };
             skills?: Array<{
                 type: "skillReference";
-                skillId: string;
+                providerReference: _ai_sdk_provider.SharedV4ProviderReference;
                 version?: string;
             } | {
                 type: "inline";
@@ -817,13 +913,27 @@ declare const openaiTools: {
             containerId: string;
         } | {
             type?: "local";
-            skills?: Array<{
+            skills
+            /**
+             * Web search allows models to access up-to-date information from the internet
+             * and provide answers with sourced citations.
+             *
+             * @param searchContextSize - The search context size to use for the web search.
+             * @param userLocation - The user location to use for the web search.
+             */
+            ? /**
+             * Web search allows models to access up-to-date information from the internet
+             * and provide answers with sourced citations.
+             *
+             * @param searchContextSize - The search context size to use for the web search.
+             * @param userLocation - The user location to use for the web search.
+             */: Array<{
                 name: string;
                 description: string;
                 path: string;
             }>;
         };
-    }>;
+    }, {}>;
     /**
      * Web search allows models to access up-to-date information from the internet
      * and provide answers with sourced citations.
@@ -831,7 +941,7 @@ declare const openaiTools: {
      * @param searchContextSize - The search context size to use for the web search.
      * @param userLocation - The user location to use for the web search.
      */
-    webSearchPreview: _ai_sdk_provider_utils.ProviderToolFactoryWithOutputSchema<{}, {
+    webSearchPreview: _ai_sdk_provider_utils.ProviderExecutedToolFactory<{}, {
         action?: {
             type: "search";
             query?: string;
@@ -852,7 +962,7 @@ declare const openaiTools: {
             region?: string;
             timezone?: string;
         };
-    }>;
+    }, {}>;
     /**
      * Web search allows models to access up-to-date information from the internet
      * and provide answers with sourced citations.
@@ -861,10 +971,11 @@ declare const openaiTools: {
      * @param searchContextSize - The search context size to use for the web search.
      * @param userLocation - The user location to use for the web search.
      */
-    webSearch: (args?: Parameters<typeof webSearchToolFactory>[0]) => _ai_sdk_provider_utils.Tool<{}, {
+    webSearch: (args?: Parameters<typeof webSearchToolFactory>[0]) => _ai_sdk_provider_utils.ProviderExecutedTool<{}, {
         action?: {
             type: "search";
             query?: string;
+            queries?: string[];
         } | {
             type: "openPage";
             url?: string | null;
@@ -880,7 +991,7 @@ declare const openaiTools: {
             type: "api";
             name: string;
         }>;
-    }>;
+    }, {}>;
     /**
      * MCP (Model Context Protocol) allows models to call tools exposed by
      * remote MCP servers or service connectors.
@@ -910,17 +1021,41 @@ declare const openaiTools: {
         };
         serverDescription?: string;
         serverUrl?: string;
-    }) => _ai_sdk_provider_utils.Tool<{}, {
+    }) => _ai_sdk_provider_utils.ProviderExecutedTool<{}, {
         type: "call";
         serverLabel: string;
         name: string;
         arguments: string;
         output?: string | null;
         error?: _ai_sdk_provider.JSONValue;
-    }>;
+    }, {}>;
+    /**
+     * Tool search allows the model to dynamically search for and load deferred
+     * tools into the model's context as needed. This helps reduce overall token
+     * usage, cost, and latency by only loading tools when the model needs them.
+     *
+     * To use tool search, mark functions or namespaces with `defer_loading: true`
+     * in the tools array. The model will use tool search to load these tools
+     * when it determines they are needed.
+     */
+    toolSearch: (args?: Parameters<_ai_sdk_provider_utils.ProviderDefinedToolFactoryWithOutputSchema<{
+        arguments?: unknown;
+        call_id?: string | null;
+    }, {
+        tools: Array<_ai_sdk_provider.JSONObject>;
+    }, {
+        execution?: "server" | "client";
+        description?: string;
+        parameters?: Record<string, unknown>;
+    }, {}>>[0]) => _ai_sdk_provider_utils.ProviderDefinedTool<{
+        arguments?: unknown;
+        call_id?: string | null;
+    }, {
+        tools: Array<_ai_sdk_provider.JSONObject>;
+    }, {}>;
 };
 
-type OpenAIResponsesModelId = 'gpt-3.5-turbo-0125' | 'gpt-3.5-turbo-1106' | 'gpt-3.5-turbo' | 'gpt-4.1-2025-04-14' | 'gpt-4.1-mini-2025-04-14' | 'gpt-4.1-mini' | 'gpt-4.1-nano-2025-04-14' | 'gpt-4.1-nano' | 'gpt-4.1' | 'gpt-4o-2024-05-13' | 'gpt-4o-2024-08-06' | 'gpt-4o-2024-11-20' | 'gpt-4o-mini-2024-07-18' | 'gpt-4o-mini' | 'gpt-4o' | 'gpt-5.1' | 'gpt-5.1-2025-11-13' | 'gpt-5.1-chat-latest' | 'gpt-5.1-codex-mini' | 'gpt-5.1-codex' | 'gpt-5.1-codex-max' | 'gpt-5.2' | 'gpt-5.2-2025-12-11' | 'gpt-5.2-chat-latest' | 'gpt-5.2-pro' | 'gpt-5.2-pro-2025-12-11' | 'gpt-5.2-codex' | 'gpt-5.3-chat-latest' | 'gpt-5.3-codex' | 'gpt-5.4' | 'gpt-5.4-2026-03-05' | 'gpt-5.4-pro' | 'gpt-5.4-pro-2026-03-05' | 'gpt-5-2025-08-07' | 'gpt-5-chat-latest' | 'gpt-5-codex' | 'gpt-5-mini-2025-08-07' | 'gpt-5-mini' | 'gpt-5-nano-2025-08-07' | 'gpt-5-nano' | 'gpt-5-pro-2025-10-06' | 'gpt-5-pro' | 'gpt-5' | 'o1-2024-12-17' | 'o1' | 'o3-2025-04-16' | 'o3-mini-2025-01-31' | 'o3-mini' | 'o3' | 'o4-mini' | 'o4-mini-2025-04-16' | (string & {});
+type OpenAIResponsesModelId = 'gpt-3.5-turbo-0125' | 'gpt-3.5-turbo-1106' | 'gpt-3.5-turbo' | 'gpt-4.1-2025-04-14' | 'gpt-4.1-mini-2025-04-14' | 'gpt-4.1-mini' | 'gpt-4.1-nano-2025-04-14' | 'gpt-4.1-nano' | 'gpt-4.1' | 'gpt-4o-2024-05-13' | 'gpt-4o-2024-08-06' | 'gpt-4o-2024-11-20' | 'gpt-4o-mini-2024-07-18' | 'gpt-4o-mini' | 'gpt-4o' | 'gpt-5.1' | 'gpt-5.1-2025-11-13' | 'gpt-5.1-chat-latest' | 'gpt-5.1-codex-mini' | 'gpt-5.1-codex' | 'gpt-5.1-codex-max' | 'gpt-5.2' | 'gpt-5.2-2025-12-11' | 'gpt-5.2-chat-latest' | 'gpt-5.2-pro' | 'gpt-5.2-pro-2025-12-11' | 'gpt-5.2-codex' | 'gpt-5.3-chat-latest' | 'gpt-5.3-codex' | 'gpt-5.4' | 'gpt-5.4-2026-03-05' | 'gpt-5.4-mini' | 'gpt-5.4-mini-2026-03-17' | 'gpt-5.4-nano' | 'gpt-5.4-nano-2026-03-17' | 'gpt-5.4-pro' | 'gpt-5.4-pro-2026-03-05' | 'gpt-5.5' | 'gpt-5.5-2026-04-23' | 'gpt-5-2025-08-07' | 'gpt-5-chat-latest' | 'gpt-5-codex' | 'gpt-5-mini-2025-08-07' | 'gpt-5-mini' | 'gpt-5-nano-2025-08-07' | 'gpt-5-nano' | 'gpt-5-pro-2025-10-06' | 'gpt-5-pro' | 'gpt-5' | 'o1-2024-12-17' | 'o1' | 'o3-2025-04-16' | 'o3-mini-2025-01-31' | 'o3-mini' | 'o3' | 'o4-mini' | 'o4-mini-2025-04-16' | (string & {});
 declare const openaiLanguageModelResponsesOptionsSchema: _ai_sdk_provider_utils.LazySchema<{
     conversation?: string | null | undefined;
     include?: ("file_search_call.results" | "message.output_text.logprobs" | "reasoning.encrypted_content")[] | null | undefined;
@@ -937,12 +1072,21 @@ declare const openaiLanguageModelResponsesOptionsSchema: _ai_sdk_provider_utils.
     safetyIdentifier?: string | null | undefined;
     serviceTier?: "default" | "auto" | "flex" | "priority" | null | undefined;
     store?: boolean | null | undefined;
+    passThroughUnsupportedFiles?: boolean | undefined;
     strictJsonSchema?: boolean | null | undefined;
     textVerbosity?: "low" | "medium" | "high" | null | undefined;
     truncation?: "auto" | "disabled" | null | undefined;
     user?: string | null | undefined;
     systemMessageMode?: "remove" | "system" | "developer" | undefined;
     forceReasoning?: boolean | undefined;
+    contextManagement?: {
+        type: "compaction";
+        compactThreshold: number;
+    }[] | null | undefined;
+    allowedTools?: {
+        toolNames: string[];
+        mode?: "auto" | "required" | undefined;
+    } | undefined;
 }>;
 type OpenAILanguageModelResponsesOptions = InferSchema<typeof openaiLanguageModelResponsesOptionsSchema>;
 
@@ -1013,6 +1157,19 @@ interface OpenAIProvider extends ProviderV4 {
      * Creates a model for speech generation.
      */
     speech(modelId: OpenAISpeechModelId): SpeechModelV4;
+    /**
+     * Creates an experimental realtime model for bidirectional audio/text
+     * communication over WebSocket.
+     */
+    experimental_realtime: Experimental_RealtimeFactoryV4;
+    /**
+     * Returns a FilesV4 interface for uploading files to OpenAI.
+     */
+    files(): FilesV4;
+    /**
+     * Returns a SkillsV4 interface for uploading skills to OpenAI.
+     */
+    skills(): SkillsV4;
     /**
      * OpenAI-specific tools.
      */
@@ -1058,6 +1215,37 @@ declare function createOpenAI(options?: OpenAIProviderSettings): OpenAIProvider;
  */
 declare const openai: OpenAIProvider;
 
+type OpenAIRealtimeModelConfig = {
+    provider: string;
+    baseURL: string;
+    headers: () => Record<string, string | undefined>;
+    fetch?: FetchFunction;
+};
+declare class OpenAIRealtimeModel implements Experimental_RealtimeModelV4 {
+    readonly specificationVersion: "v4";
+    readonly provider: string;
+    readonly modelId: string;
+    private readonly config;
+    constructor(modelId: string, config: OpenAIRealtimeModelConfig);
+    doCreateClientSecret(options: Experimental_RealtimeModelV4ClientSecretOptions): Promise<Experimental_RealtimeModelV4ClientSecretResult>;
+    getWebSocketConfig(options: {
+        token: string;
+        url: string;
+    }): {
+        url: string;
+        protocols?: string[];
+    };
+    parseServerEvent(raw: unknown): Experimental_RealtimeModelV4ServerEvent;
+    serializeClientEvent(event: Experimental_RealtimeModelV4ClientEvent): unknown;
+    buildSessionConfig(config: Experimental_RealtimeModelV4SessionConfig): Record<string, unknown>;
+}
+
+declare const openaiFilesOptionsSchema: _ai_sdk_provider_utils.LazySchema<{
+    purpose?: string | undefined;
+    expiresAfter?: number | undefined;
+}>;
+type OpenAIFilesOptions = InferSchema<typeof openaiFilesOptionsSchema>;
+
 type OpenaiResponsesChunk = InferSchema<typeof openaiResponsesChunkSchema>;
 type ResponsesOutputTextAnnotationProviderMetadata = Extract<OpenaiResponsesChunk, {
     type: 'response.output_text.annotation.added';
@@ -1077,6 +1265,14 @@ type OpenaiResponsesReasoningProviderMetadata = {
 type OpenaiResponsesProviderMetadata = {
     openai: ResponsesProviderMetadata;
 };
+type ResponsesCompactionProviderMetadata = {
+    type: 'compaction';
+    itemId: string;
+    encryptedContent?: string;
+};
+type OpenaiResponsesCompactionProviderMetadata = {
+    openai: ResponsesCompactionProviderMetadata;
+};
 type ResponsesTextProviderMetadata = {
     itemId: string;
     phase?: 'commentary' | 'final_answer' | null;
@@ -1104,4 +1300,4 @@ type OpenaiResponsesSourceDocumentProviderMetadata = {
 
 declare const VERSION: string;
 
-export { type OpenAILanguageModelChatOptions as OpenAIChatLanguageModelOptions, type OpenAIEmbeddingModelOptions, type OpenAILanguageModelChatOptions, type OpenAILanguageModelCompletionOptions, type OpenAILanguageModelResponsesOptions, type OpenAIProvider, type OpenAIProviderSettings, type OpenAILanguageModelResponsesOptions as OpenAIResponsesProviderOptions, type OpenAISpeechModelOptions, type OpenAITranscriptionModelOptions, type OpenaiResponsesProviderMetadata, type OpenaiResponsesReasoningProviderMetadata, type OpenaiResponsesSourceDocumentProviderMetadata, type OpenaiResponsesTextProviderMetadata, VERSION, createOpenAI, openai };
+export { OpenAIRealtimeModel as Experimental_OpenAIRealtimeModel, type OpenAIRealtimeModelConfig as Experimental_OpenAIRealtimeModelConfig, type OpenAILanguageModelChatOptions as OpenAIChatLanguageModelOptions, type OpenAIEmbeddingModelOptions, type OpenAIFilesOptions, type OpenAIImageModelEditOptions, type OpenAIImageModelGenerationOptions, type OpenAIImageModelOptions, type OpenAILanguageModelChatOptions, type OpenAILanguageModelCompletionOptions, type OpenAILanguageModelResponsesOptions, type OpenAIProvider, type OpenAIProviderSettings, type OpenAILanguageModelResponsesOptions as OpenAIResponsesProviderOptions, type OpenAISpeechModelOptions, type OpenAITranscriptionModelOptions, type OpenaiResponsesCompactionProviderMetadata, type OpenaiResponsesProviderMetadata, type OpenaiResponsesReasoningProviderMetadata, type OpenaiResponsesSourceDocumentProviderMetadata, type OpenaiResponsesTextProviderMetadata, VERSION, createOpenAI, openai };