@ai-sdk/openai 4.0.0-beta.0 → 4.0.0-beta.10

package/CHANGELOG.md

@@ -1,5 +1,148 @@
 # @ai-sdk/openai
 
+## 4.0.0-beta.10
+
+### Major Changes
+
+- 61753c3: ### `@ai-sdk/openai`: remove redundant `name` argument from `openai.tools.customTool()`
+
+  `openai.tools.customTool()` no longer accepts a `name` field. the tool name is now derived from the sdk tool key (the object key in the `tools` object).
+
+  migration: remove the `name` property from `customTool()` calls. the object key is now used as the tool name sent to the openai api.
+
+  before:
+
+  ```ts
+  tools: {
+    write_sql: openai.tools.customTool({
+      name: 'write_sql',
+      description: '...',
+    }),
+  }
+  ```
+
+  after:
+
+  ```ts
+  tools: {
+    write_sql: openai.tools.customTool({
+      description: '...',
+    }),
+  }
+  ```
+
+  ### `@ai-sdk/provider-utils`: `createToolNameMapping()` no longer accepts the `resolveProviderToolName` parameter
+
+  before: tool name can be set dynamically
+
+  ```ts
+  const toolNameMapping = createToolNameMapping({
+    tools,
+    providerToolNames: {
+      'openai.code_interpreter': 'code_interpreter',
+      'openai.file_search': 'file_search',
+      'openai.image_generation': 'image_generation',
+      'openai.local_shell': 'local_shell',
+      'openai.shell': 'shell',
+      'openai.web_search': 'web_search',
+      'openai.web_search_preview': 'web_search_preview',
+      'openai.mcp': 'mcp',
+      'openai.apply_patch': 'apply_patch',
+    },
+    resolveProviderToolName: tool =>
+      tool.id === 'openai.custom'
+        ? (tool.args as { name?: string }).name
+        : undefined,
+  });
+  ```
+
+  after: tool name is static based on `tools` keys
+
+  ```
+  const toolNameMapping = createToolNameMapping({
+    tools,
+    providerToolNames: {
+      'openai.code_interpreter': 'code_interpreter',
+      'openai.file_search': 'file_search',
+      'openai.image_generation': 'image_generation',
+      'openai.local_shell': 'local_shell',
+      'openai.shell': 'shell',
+      'openai.web_search': 'web_search',
+      'openai.web_search_preview': 'web_search_preview',
+      'openai.mcp': 'mcp',
+      'openai.apply_patch': 'apply_patch',
+    }
+  });
+  ```
+
+### Patch Changes
+
+- Updated dependencies [61753c3]
+  - @ai-sdk/provider-utils@5.0.0-beta.4
+
+## 4.0.0-beta.9
+
+### Patch Changes
+
+- 156cdf0: feat(openai): add new tool search tool
+
+## 4.0.0-beta.8
+
+### Patch Changes
+
+- Updated dependencies [f7d4f01]
+  - @ai-sdk/provider-utils@5.0.0-beta.3
+  - @ai-sdk/provider@4.0.0-beta.2
+
+## 4.0.0-beta.7
+
+### Patch Changes
+
+- Updated dependencies [5c2a5a2]
+  - @ai-sdk/provider@4.0.0-beta.1
+  - @ai-sdk/provider-utils@5.0.0-beta.2
+
+## 4.0.0-beta.6
+
+### Patch Changes
+
+- 83f9d04: feat(openai): upgrade v3 specs to v4
+
+## 4.0.0-beta.5
+
+### Patch Changes
+
+- ac18f89: feat(provider/openai): add `gpt-5.3-chat-latest`
+
+## 4.0.0-beta.4
+
+### Patch Changes
+
+- a71d345: fix(provider/openai): drop reasoning parts without encrypted content when store: false
+
+## 4.0.0-beta.3
+
+### Patch Changes
+
+- 45b3d76: fix(security): prevent streaming tool calls from finalizing on parsable partial JSON
+
+  Streaming tool call arguments were finalized using `isParsableJson()` as a heuristic for completion. If partial accumulated JSON happened to be valid JSON before all chunks arrived, the tool call would be executed with incomplete arguments. Tool call finalization now only occurs in `flush()` after the stream is fully consumed.
+
+- f7295cb: revert incorrect fix https://github.com/vercel/ai/pull/13172
+
+## 4.0.0-beta.2
+
+### Patch Changes
+
+- Updated dependencies [531251e]
+  - @ai-sdk/provider-utils@5.0.0-beta.1
+
+## 4.0.0-beta.1
+
+### Patch Changes
+
+- 7afaece: feat(provider/openai): add GPT-5.4 model support
+
 ## 4.0.0-beta.0
 
 ### Major Changes

package/dist/index.d.mts

@@ -1,9 +1,9 @@
 import * as _ai_sdk_provider from '@ai-sdk/provider';
-import { ProviderV3, LanguageModelV3, EmbeddingModelV3, ImageModelV3, TranscriptionModelV3, SpeechModelV3 } from '@ai-sdk/provider';
+import { JSONValue, ProviderV4, LanguageModelV4, EmbeddingModelV4, ImageModelV4, TranscriptionModelV4, SpeechModelV4 } 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' | (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-pro' | 'gpt-5.4-pro-2026-03-05' | (string & {});
 declare const openaiLanguageModelChatOptions: _ai_sdk_provider_utils.LazySchema<{
     logitBias?: Record<number, number> | undefined;
     logprobs?: number | boolean | undefined;
@@ -315,6 +315,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";
@@ -484,6 +498,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";
@@ -575,10 +603,6 @@ type OpenAIResponsesLogprobs = NonNullable<(OpenAIResponsesChunk & {
 })['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;
     /**
      * An optional description of what the tool does.
      */
@@ -647,7 +671,6 @@ declare const openaiTools: {
      * 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).
      */
@@ -918,9 +941,33 @@ declare const openaiTools: {
         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.ProviderToolFactoryWithOutputSchema<{
+        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.Tool<{
+        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-codex' | '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-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 & {});
 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;
@@ -963,56 +1010,56 @@ declare const openAITranscriptionModelOptions: _ai_sdk_provider_utils.LazySchema
 }>;
 type OpenAITranscriptionModelOptions = InferSchema<typeof openAITranscriptionModelOptions>;
 
-interface OpenAIProvider extends ProviderV3 {
-    (modelId: OpenAIResponsesModelId): LanguageModelV3;
+interface OpenAIProvider extends ProviderV4 {
+    (modelId: OpenAIResponsesModelId): LanguageModelV4;
     /**
      * Creates an OpenAI model for text generation.
      */
-    languageModel(modelId: OpenAIResponsesModelId): LanguageModelV3;
+    languageModel(modelId: OpenAIResponsesModelId): LanguageModelV4;
     /**
      * Creates an OpenAI chat model for text generation.
      */
-    chat(modelId: OpenAIChatModelId): LanguageModelV3;
+    chat(modelId: OpenAIChatModelId): LanguageModelV4;
     /**
      * Creates an OpenAI responses API model for text generation.
      */
-    responses(modelId: OpenAIResponsesModelId): LanguageModelV3;
+    responses(modelId: OpenAIResponsesModelId): LanguageModelV4;
     /**
      * Creates an OpenAI completion model for text generation.
      */
-    completion(modelId: OpenAICompletionModelId): LanguageModelV3;
+    completion(modelId: OpenAICompletionModelId): LanguageModelV4;
     /**
      * Creates a model for text embeddings.
      */
-    embedding(modelId: OpenAIEmbeddingModelId): EmbeddingModelV3;
+    embedding(modelId: OpenAIEmbeddingModelId): EmbeddingModelV4;
     /**
      * Creates a model for text embeddings.
      */
-    embeddingModel(modelId: OpenAIEmbeddingModelId): EmbeddingModelV3;
+    embeddingModel(modelId: OpenAIEmbeddingModelId): EmbeddingModelV4;
     /**
      * @deprecated Use `embedding` instead.
      */
-    textEmbedding(modelId: OpenAIEmbeddingModelId): EmbeddingModelV3;
+    textEmbedding(modelId: OpenAIEmbeddingModelId): EmbeddingModelV4;
     /**
      * @deprecated Use `embeddingModel` instead.
      */
-    textEmbeddingModel(modelId: OpenAIEmbeddingModelId): EmbeddingModelV3;
+    textEmbeddingModel(modelId: OpenAIEmbeddingModelId): EmbeddingModelV4;
     /**
      * Creates a model for image generation.
      */
-    image(modelId: OpenAIImageModelId): ImageModelV3;
+    image(modelId: OpenAIImageModelId): ImageModelV4;
     /**
      * Creates a model for image generation.
      */
-    imageModel(modelId: OpenAIImageModelId): ImageModelV3;
+    imageModel(modelId: OpenAIImageModelId): ImageModelV4;
     /**
      * Creates a model for transcription.
      */
-    transcription(modelId: OpenAITranscriptionModelId): TranscriptionModelV3;
+    transcription(modelId: OpenAITranscriptionModelId): TranscriptionModelV4;
     /**
      * Creates a model for speech generation.
      */
-    speech(modelId: OpenAISpeechModelId): SpeechModelV3;
+    speech(modelId: OpenAISpeechModelId): SpeechModelV4;
     /**
      * OpenAI-specific tools.
      */

package/dist/index.d.ts

@@ -1,9 +1,9 @@
 import * as _ai_sdk_provider from '@ai-sdk/provider';
-import { ProviderV3, LanguageModelV3, EmbeddingModelV3, ImageModelV3, TranscriptionModelV3, SpeechModelV3 } from '@ai-sdk/provider';
+import { JSONValue, ProviderV4, LanguageModelV4, EmbeddingModelV4, ImageModelV4, TranscriptionModelV4, SpeechModelV4 } 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' | (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-pro' | 'gpt-5.4-pro-2026-03-05' | (string & {});
 declare const openaiLanguageModelChatOptions: _ai_sdk_provider_utils.LazySchema<{
     logitBias?: Record<number, number> | undefined;
     logprobs?: number | boolean | undefined;
@@ -315,6 +315,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";
@@ -484,6 +498,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";
@@ -575,10 +603,6 @@ type OpenAIResponsesLogprobs = NonNullable<(OpenAIResponsesChunk & {
 })['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;
     /**
      * An optional description of what the tool does.
      */
@@ -647,7 +671,6 @@ declare const openaiTools: {
      * 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).
      */
@@ -918,9 +941,33 @@ declare const openaiTools: {
         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.ProviderToolFactoryWithOutputSchema<{
+        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.Tool<{
+        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-codex' | '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-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 & {});
 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;
@@ -963,56 +1010,56 @@ declare const openAITranscriptionModelOptions: _ai_sdk_provider_utils.LazySchema
 }>;
 type OpenAITranscriptionModelOptions = InferSchema<typeof openAITranscriptionModelOptions>;
 
-interface OpenAIProvider extends ProviderV3 {
-    (modelId: OpenAIResponsesModelId): LanguageModelV3;
+interface OpenAIProvider extends ProviderV4 {
+    (modelId: OpenAIResponsesModelId): LanguageModelV4;
     /**
      * Creates an OpenAI model for text generation.
      */
-    languageModel(modelId: OpenAIResponsesModelId): LanguageModelV3;
+    languageModel(modelId: OpenAIResponsesModelId): LanguageModelV4;
     /**
      * Creates an OpenAI chat model for text generation.
      */
-    chat(modelId: OpenAIChatModelId): LanguageModelV3;
+    chat(modelId: OpenAIChatModelId): LanguageModelV4;
     /**
      * Creates an OpenAI responses API model for text generation.
      */
-    responses(modelId: OpenAIResponsesModelId): LanguageModelV3;
+    responses(modelId: OpenAIResponsesModelId): LanguageModelV4;
     /**
      * Creates an OpenAI completion model for text generation.
      */
-    completion(modelId: OpenAICompletionModelId): LanguageModelV3;
+    completion(modelId: OpenAICompletionModelId): LanguageModelV4;
     /**
      * Creates a model for text embeddings.
      */
-    embedding(modelId: OpenAIEmbeddingModelId): EmbeddingModelV3;
+    embedding(modelId: OpenAIEmbeddingModelId): EmbeddingModelV4;
     /**
      * Creates a model for text embeddings.
      */
-    embeddingModel(modelId: OpenAIEmbeddingModelId): EmbeddingModelV3;
+    embeddingModel(modelId: OpenAIEmbeddingModelId): EmbeddingModelV4;
     /**
      * @deprecated Use `embedding` instead.
      */
-    textEmbedding(modelId: OpenAIEmbeddingModelId): EmbeddingModelV3;
+    textEmbedding(modelId: OpenAIEmbeddingModelId): EmbeddingModelV4;
     /**
      * @deprecated Use `embeddingModel` instead.
      */
-    textEmbeddingModel(modelId: OpenAIEmbeddingModelId): EmbeddingModelV3;
+    textEmbeddingModel(modelId: OpenAIEmbeddingModelId): EmbeddingModelV4;
     /**
      * Creates a model for image generation.
      */
-    image(modelId: OpenAIImageModelId): ImageModelV3;
+    image(modelId: OpenAIImageModelId): ImageModelV4;
     /**
      * Creates a model for image generation.
      */
-    imageModel(modelId: OpenAIImageModelId): ImageModelV3;
+    imageModel(modelId: OpenAIImageModelId): ImageModelV4;
     /**
      * Creates a model for transcription.
      */
-    transcription(modelId: OpenAITranscriptionModelId): TranscriptionModelV3;
+    transcription(modelId: OpenAITranscriptionModelId): TranscriptionModelV4;
     /**
      * Creates a model for speech generation.
      */
-    speech(modelId: OpenAISpeechModelId): SpeechModelV3;
+    speech(modelId: OpenAISpeechModelId): SpeechModelV4;
     /**
      * OpenAI-specific tools.
      */