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

package/dist/internal/index.d.ts

@@ -1,8 +1,9 @@
-import { LanguageModelV4, LanguageModelV4CallOptions, LanguageModelV4GenerateResult, LanguageModelV4StreamResult, EmbeddingModelV4, ImageModelV4, TranscriptionModelV4CallOptions, TranscriptionModelV4, SpeechModelV4 } from '@ai-sdk/provider';
+import * as _ai_sdk_provider from '@ai-sdk/provider';
+import { LanguageModelV4, LanguageModelV4CallOptions, LanguageModelV4GenerateResult, LanguageModelV4StreamResult, EmbeddingModelV4, ImageModelV4, TranscriptionModelV4CallOptions, TranscriptionModelV4, SpeechModelV4, JSONValue } from '@ai-sdk/provider';
 import * as _ai_sdk_provider_utils from '@ai-sdk/provider-utils';
-import { InferSchema, FetchFunction } from '@ai-sdk/provider-utils';
+import { InferSchema, WORKFLOW_SERIALIZE, WORKFLOW_DESERIALIZE, 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;
@@ -26,7 +27,7 @@ type OpenAILanguageModelChatOptions = InferSchema<typeof openaiLanguageModelChat
 
 type OpenAIChatConfig = {
     provider: string;
-    headers: () => Record<string, string | undefined>;
+    headers?: () => Record<string, string | undefined>;
     url: (options: {
         modelId: string;
         path: string;
@@ -40,6 +41,14 @@ declare class OpenAIChatLanguageModel implements LanguageModelV4 {
         'image/*': RegExp[];
     };
     private readonly config;
+    static [WORKFLOW_SERIALIZE](model: OpenAIChatLanguageModel): {
+        modelId: string;
+        config: _ai_sdk_provider.JSONObject;
+    };
+    static [WORKFLOW_DESERIALIZE](options: {
+        modelId: OpenAIChatModelId;
+        config: OpenAIChatConfig;
+    }): OpenAIChatLanguageModel;
     constructor(modelId: OpenAIChatModelId, config: OpenAIChatConfig);
     get provider(): string;
     private getArgs;
@@ -59,7 +68,7 @@ type OpenAILanguageModelCompletionOptions = InferSchema<typeof openaiLanguageMod
 
 type OpenAICompletionConfig = {
     provider: string;
-    headers: () => Record<string, string | undefined>;
+    headers?: () => Record<string, string | undefined>;
     url: (options: {
         modelId: string;
         path: string;
@@ -71,6 +80,14 @@ declare class OpenAICompletionLanguageModel implements LanguageModelV4 {
     readonly modelId: OpenAICompletionModelId;
     private readonly config;
     private get providerOptionsName();
+    static [WORKFLOW_SERIALIZE](model: OpenAICompletionLanguageModel): {
+        modelId: string;
+        config: _ai_sdk_provider.JSONObject;
+    };
+    static [WORKFLOW_DESERIALIZE](options: {
+        modelId: OpenAICompletionModelId;
+        config: OpenAICompletionConfig;
+    }): OpenAICompletionLanguageModel;
     constructor(modelId: OpenAICompletionModelId, config: OpenAICompletionConfig);
     get provider(): string;
     readonly supportedUrls: Record<string, RegExp[]>;
@@ -85,16 +102,16 @@ type OpenAIConfig = {
         modelId: string;
         path: string;
     }) => string;
-    headers: () => Record<string, string | undefined>;
+    headers?: () => Record<string, string | undefined>;
     fetch?: FetchFunction;
     generateId?: () => string;
     /**
-     * File ID prefixes used to identify file IDs in Responses API.
-     * When undefined, all file data is treated as base64 content.
+     * This is soft-deprecated. Use provider references (e.g. `{ openai: 'file-abc123' }`)
+     * in file part data instead. File ID prefixes used to identify file IDs
+     * in Responses API. When undefined, all string file data is treated as
+     * base64 content.
      *
-     * Examples:
-     * - OpenAI: ['file-'] for IDs like 'file-abc123'
-     * - Azure OpenAI: ['assistant-'] for IDs like 'assistant-abc123'
+     * TODO: remove in v8
      */
     fileIdPrefixes?: readonly string[];
 };
@@ -112,14 +129,49 @@ declare class OpenAIEmbeddingModel implements EmbeddingModelV4 {
     readonly maxEmbeddingsPerCall = 2048;
     readonly supportsParallelCalls = true;
     private readonly config;
+    static [WORKFLOW_SERIALIZE](model: OpenAIEmbeddingModel): {
+        modelId: string;
+        config: _ai_sdk_provider.JSONObject;
+    };
+    static [WORKFLOW_DESERIALIZE](options: {
+        modelId: OpenAIEmbeddingModelId;
+        config: OpenAIConfig;
+    }): OpenAIEmbeddingModel;
     get provider(): string;
     constructor(modelId: OpenAIEmbeddingModelId, config: OpenAIConfig);
     doEmbed({ values, headers, abortSignal, providerOptions, }: Parameters<EmbeddingModelV4['doEmbed']>[0]): Promise<Awaited<ReturnType<EmbeddingModelV4['doEmbed']>>>;
 }
 
-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 modelMaxImagesPerCall: Record<OpenAIImageModelId, number>;
 declare function hasDefaultResponseFormat(modelId: string): boolean;
+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>;
 
 interface OpenAIImageModelConfig extends OpenAIConfig {
     _internal?: {
@@ -130,6 +182,14 @@ declare class OpenAIImageModel implements ImageModelV4 {
     readonly modelId: OpenAIImageModelId;
     private readonly config;
     readonly specificationVersion = "v4";
+    static [WORKFLOW_SERIALIZE](model: OpenAIImageModel): {
+        modelId: string;
+        config: _ai_sdk_provider.JSONObject;
+    };
+    static [WORKFLOW_DESERIALIZE](options: {
+        modelId: OpenAIImageModelId;
+        config: OpenAIImageModelConfig;
+    }): OpenAIImageModel;
     get maxImagesPerCall(): number;
     get provider(): string;
     constructor(modelId: OpenAIImageModelId, config: OpenAIImageModelConfig);
@@ -160,6 +220,14 @@ declare class OpenAITranscriptionModel implements TranscriptionModelV4 {
     readonly modelId: OpenAITranscriptionModelId;
     private readonly config;
     readonly specificationVersion = "v4";
+    static [WORKFLOW_SERIALIZE](model: OpenAITranscriptionModel): {
+        modelId: string;
+        config: _ai_sdk_provider.JSONObject;
+    };
+    static [WORKFLOW_DESERIALIZE](options: {
+        modelId: OpenAITranscriptionModelId;
+        config: OpenAITranscriptionModelConfig;
+    }): OpenAITranscriptionModel;
     get provider(): string;
     constructor(modelId: OpenAITranscriptionModelId, config: OpenAITranscriptionModelConfig);
     private getArgs;
@@ -182,18 +250,34 @@ declare class OpenAISpeechModel implements SpeechModelV4 {
     readonly modelId: OpenAISpeechModelId;
     private readonly config;
     readonly specificationVersion = "v4";
+    static [WORKFLOW_SERIALIZE](model: OpenAISpeechModel): {
+        modelId: string;
+        config: _ai_sdk_provider.JSONObject;
+    };
+    static [WORKFLOW_DESERIALIZE](options: {
+        modelId: OpenAISpeechModelId;
+        config: OpenAISpeechModelConfig;
+    }): OpenAISpeechModel;
     get provider(): string;
     constructor(modelId: OpenAISpeechModelId, config: OpenAISpeechModelConfig);
     private getArgs;
     doGenerate(options: Parameters<SpeechModelV4['doGenerate']>[0]): Promise<Awaited<ReturnType<SpeechModelV4['doGenerate']>>>;
 }
 
-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 class OpenAIResponsesLanguageModel implements LanguageModelV4 {
     readonly specificationVersion = "v4";
     readonly modelId: OpenAIResponsesModelId;
     private readonly config;
+    static [WORKFLOW_SERIALIZE](model: OpenAIResponsesLanguageModel): {
+        modelId: string;
+        config: _ai_sdk_provider.JSONObject;
+    };
+    static [WORKFLOW_DESERIALIZE](options: {
+        modelId: OpenAIResponsesModelId;
+        config: OpenAIConfig;
+    }): OpenAIResponsesLanguageModel;
     constructor(modelId: OpenAIResponsesModelId, config: OpenAIConfig);
     readonly supportedUrls: Record<string, RegExp[]>;
     get provider(): string;
@@ -235,6 +319,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;
@@ -265,6 +364,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: {
@@ -290,6 +412,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;
@@ -359,6 +482,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;
@@ -374,6 +501,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";
@@ -393,6 +534,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;
@@ -423,6 +565,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;
@@ -528,6 +671,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;
@@ -543,6 +690,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";
@@ -618,15 +779,6 @@ 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 & {
@@ -652,6 +804,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;
@@ -751,7 +911,7 @@ type ApplyPatchOperation = {
  * - Returns the status of applying those patches (completed or failed)
  *
  */
-declare const applyPatchToolFactory: _ai_sdk_provider_utils.ProviderToolFactoryWithOutputSchema<{
+declare const applyPatchToolFactory: _ai_sdk_provider_utils.ProviderDefinedToolFactoryWithOutputSchema<{
     /**
      * The unique ID of the apply patch tool call generated by the model.
      */
@@ -772,14 +932,14 @@ declare const applyPatchToolFactory: _ai_sdk_provider_utils.ProviderToolFactoryW
      * (e.g., patch results or errors).
      */
     output?: string;
-}, {}>;
+}, {}, {}>;
 /**
  * The apply_patch tool lets GPT-5.1 create, update, and delete files in your
  * codebase using structured diffs. Instead of just suggesting edits, the model
  * emits patch operations that your application applies and then reports back on,
  * enabling iterative, multi-step code editing workflows.
  */
-declare const applyPatch: _ai_sdk_provider_utils.ProviderToolFactoryWithOutputSchema<{
+declare const applyPatch: _ai_sdk_provider_utils.ProviderDefinedToolFactoryWithOutputSchema<{
     /**
      * The unique ID of the apply patch tool call generated by the model.
      */
@@ -800,7 +960,7 @@ declare const applyPatch: _ai_sdk_provider_utils.ProviderToolFactoryWithOutputSc
      * (e.g., patch results or errors).
      */
     output?: string;
-}, {}>;
+}, {}, {}>;
 
 declare const codeInterpreterInputSchema: _ai_sdk_provider_utils.LazySchema<{
     containerId: string;
@@ -830,7 +990,7 @@ type CodeInterpreterArgs = {
         fileIds?: string[];
     };
 };
-declare const codeInterpreterToolFactory: _ai_sdk_provider_utils.ProviderToolFactoryWithOutputSchema<{
+declare const codeInterpreterToolFactory: _ai_sdk_provider_utils.ProviderExecutedToolFactory<{
     /**
      * The code to run, or null if not available.
      */
@@ -857,8 +1017,8 @@ declare const codeInterpreterToolFactory: _ai_sdk_provider_utils.ProviderToolFac
          */
         url: string;
     }> | null;
-}, CodeInterpreterArgs>;
-declare const codeInterpreter: (args?: CodeInterpreterArgs) => _ai_sdk_provider_utils.Tool<{
+}, CodeInterpreterArgs, {}>;
+declare const codeInterpreter: (args?: CodeInterpreterArgs) => _ai_sdk_provider_utils.ProviderExecutedTool<{
     /**
      * The code to run, or null if not available.
      */
@@ -885,7 +1045,7 @@ declare const codeInterpreter: (args?: CodeInterpreterArgs) => _ai_sdk_provider_
          */
         url: string;
     }> | null;
-}>;
+}, {}>;
 
 declare const fileSearchArgsSchema: _ai_sdk_provider_utils.LazySchema<{
     vectorStoreIds: string[];
@@ -906,7 +1066,7 @@ declare const fileSearchOutputSchema: _ai_sdk_provider_utils.LazySchema<{
         text: string;
     }[] | null;
 }>;
-declare const fileSearch: _ai_sdk_provider_utils.ProviderToolFactoryWithOutputSchema<{}, {
+declare const fileSearch: _ai_sdk_provider_utils.ProviderExecutedToolFactory<{}, {
     /**
      * The search query to execute.
      */
@@ -968,7 +1128,7 @@ declare const fileSearch: _ai_sdk_provider_utils.ProviderToolFactoryWithOutputSc
      * A filter to apply.
      */
     filters?: OpenAIResponsesFileSearchToolComparisonFilter | OpenAIResponsesFileSearchToolCompoundFilter;
-}>;
+}, {}>;
 
 declare const imageGenerationArgsSchema: _ai_sdk_provider_utils.LazySchema<{
     background?: "auto" | "transparent" | "opaque" | undefined;
@@ -1044,12 +1204,206 @@ type ImageGenerationArgs = {
      */
     size?: 'auto' | '1024x1024' | '1024x1536' | '1536x1024';
 };
-declare const imageGeneration: (args?: ImageGenerationArgs) => _ai_sdk_provider_utils.Tool<{}, {
+declare const imageGeneration: (args?: ImageGenerationArgs) => _ai_sdk_provider_utils.ProviderExecutedTool<{}, {
     /**
      * The generated image encoded in base64.
      */
     result: string;
+}, {}>;
+
+declare const webSearchArgsSchema: _ai_sdk_provider_utils.LazySchema<{
+    externalWebAccess?: boolean | undefined;
+    filters?: {
+        allowedDomains?: string[] | undefined;
+    } | undefined;
+    searchContextSize?: "low" | "medium" | "high" | undefined;
+    userLocation?: {
+        type: "approximate";
+        country?: string | undefined;
+        city?: string | undefined;
+        region?: string | undefined;
+        timezone?: string | undefined;
+    } | undefined;
 }>;
+declare const webSearchOutputSchema: _ai_sdk_provider_utils.LazySchema<{
+    action?: {
+        type: "search";
+        query?: string | undefined;
+        queries?: string[] | undefined;
+    } | {
+        type: "openPage";
+        url?: string | null | undefined;
+    } | {
+        type: "findInPage";
+        url?: string | null | undefined;
+        pattern?: string | null | undefined;
+    } | undefined;
+    sources?: ({
+        type: "url";
+        url: string;
+    } | {
+        type: "api";
+        name: string;
+    })[] | undefined;
+}>;
+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).
+     */
+    action?: {
+        /**
+         * Action type "search" - Performs a web search query.
+         */
+        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.
+         */
+        type: "openPage";
+        /**
+         * The URL opened by the model.
+         */
+        url?: string | null;
+    } | {
+        /**
+         * Action type "findInPage": Searches for a pattern within a loaded page.
+         */
+        type: "findInPage";
+        /**
+         * The URL of the page searched for the pattern.
+         */
+        url?: string | null;
+        /**
+         * The pattern or text to search for within the page.
+         */
+        pattern?: string | null;
+    };
+    /**
+     * Optional sources cited by the model for the web search call.
+     */
+    sources?: Array<{
+        type: "url";
+        url: string;
+    } | {
+        type: "api";
+        name: string;
+    }>;
+}, {
+    /**
+     * Whether to use external web access for fetching live content.
+     * - true: Fetch live web content (default)
+     * - false: Use cached/indexed results
+     */
+    externalWebAccess?: boolean;
+    /**
+     * Filters for the search.
+     */
+    filters?: {
+        /**
+         * Allowed domains for the search.
+         * If not provided, all domains are allowed.
+         * Subdomains of the provided domains are allowed as well.
+         */
+        allowedDomains?: string[];
+    };
+    /**
+     * Search context size to use for the web search.
+     * - high: Most comprehensive context, highest cost, slower response
+     * - medium: Balanced context, cost, and latency (default)
+     * - low: Least context, lowest cost, fastest response
+     */
+    searchContextSize?: "low" | "medium" | "high";
+    /**
+     * User location information to provide geographically relevant search results.
+     */
+    userLocation?: {
+        /**
+         * Type of location (always 'approximate')
+         */
+        type: "approximate";
+        /**
+         * Two-letter ISO country code (e.g., 'US', 'GB')
+         */
+        country?: string;
+        /**
+         * City name (free text, e.g., 'Minneapolis')
+         */
+        city?: string;
+        /**
+         * Region name (free text, e.g., 'Minnesota')
+         */
+        region?: string;
+        /**
+         * IANA timezone (e.g., 'America/Chicago')
+         */
+        timezone?: string;
+    };
+}, {}>;
+declare const webSearch: (args?: Parameters<typeof webSearchToolFactory>[0]) => _ai_sdk_provider_utils.ProviderExecutedTool<{}, {
+    /**
+     * 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).
+     */
+    action?: {
+        /**
+         * Action type "search" - Performs a web search query.
+         */
+        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.
+         */
+        type: "openPage";
+        /**
+         * The URL opened by the model.
+         */
+        url?: string | null;
+    } | {
+        /**
+         * Action type "findInPage": Searches for a pattern within a loaded page.
+         */
+        type: "findInPage";
+        /**
+         * The URL of the page searched for the pattern.
+         */
+        url?: string | null;
+        /**
+         * The pattern or text to search for within the page.
+         */
+        pattern?: string | null;
+    };
+    /**
+     * Optional sources cited by the model for the web search call.
+     */
+    sources?: Array<{
+        type: "url";
+        url: string;
+    } | {
+        type: "api";
+        name: string;
+    }>;
+}, {}>;
 
 declare const webSearchPreviewArgsSchema: _ai_sdk_provider_utils.LazySchema<{
     searchContextSize?: "low" | "medium" | "high" | undefined;
@@ -1062,7 +1416,7 @@ declare const webSearchPreviewArgsSchema: _ai_sdk_provider_utils.LazySchema<{
     } | undefined;
 }>;
 declare const webSearchPreviewInputSchema: _ai_sdk_provider_utils.LazySchema<Record<string, never>>;
-declare const webSearchPreview: _ai_sdk_provider_utils.ProviderToolFactoryWithOutputSchema<{}, {
+declare const webSearchPreview: _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).
@@ -1132,6 +1486,6 @@ declare const webSearchPreview: _ai_sdk_provider_utils.ProviderToolFactoryWithOu
          */
         timezone?: string;
     };
-}>;
+}, {}>;
 
-export { type ApplyPatchOperation, OpenAIChatLanguageModel, type OpenAIChatModelId, OpenAICompletionLanguageModel, type OpenAICompletionModelId, OpenAIEmbeddingModel, type OpenAIEmbeddingModelId, type OpenAIEmbeddingModelOptions, OpenAIImageModel, type OpenAIImageModelId, type OpenAILanguageModelChatOptions, type OpenAILanguageModelCompletionOptions, OpenAIResponsesLanguageModel, OpenAISpeechModel, type OpenAISpeechModelId, type OpenAISpeechModelOptions, type OpenAITranscriptionCallOptions, OpenAITranscriptionModel, type OpenAITranscriptionModelId, type OpenAITranscriptionModelOptions, type OpenaiResponsesProviderMetadata, type OpenaiResponsesReasoningProviderMetadata, type OpenaiResponsesSourceDocumentProviderMetadata, type OpenaiResponsesTextProviderMetadata, type ResponsesProviderMetadata, type ResponsesReasoningProviderMetadata, type ResponsesSourceDocumentProviderMetadata, type ResponsesTextProviderMetadata, applyPatch, applyPatchArgsSchema, applyPatchInputSchema, applyPatchOutputSchema, applyPatchToolFactory, codeInterpreter, codeInterpreterArgsSchema, codeInterpreterInputSchema, codeInterpreterOutputSchema, codeInterpreterToolFactory, fileSearch, fileSearchArgsSchema, fileSearchOutputSchema, hasDefaultResponseFormat, imageGeneration, imageGenerationArgsSchema, imageGenerationOutputSchema, modelMaxImagesPerCall, openAITranscriptionModelOptions, openaiEmbeddingModelOptions, openaiLanguageModelChatOptions, openaiLanguageModelCompletionOptions, openaiSpeechModelOptionsSchema, webSearchPreview, webSearchPreviewArgsSchema, webSearchPreviewInputSchema };
+export { type ApplyPatchOperation, OpenAIChatLanguageModel, type OpenAIChatModelId, OpenAICompletionLanguageModel, type OpenAICompletionModelId, OpenAIEmbeddingModel, type OpenAIEmbeddingModelId, type OpenAIEmbeddingModelOptions, OpenAIImageModel, type OpenAIImageModelEditOptions, type OpenAIImageModelGenerationOptions, type OpenAIImageModelId, type OpenAIImageModelOptions, type OpenAILanguageModelChatOptions, type OpenAILanguageModelCompletionOptions, OpenAIResponsesLanguageModel, OpenAISpeechModel, type OpenAISpeechModelId, type OpenAISpeechModelOptions, type OpenAITranscriptionCallOptions, OpenAITranscriptionModel, type OpenAITranscriptionModelId, type OpenAITranscriptionModelOptions, type OpenaiResponsesCompactionProviderMetadata, type OpenaiResponsesProviderMetadata, type OpenaiResponsesReasoningProviderMetadata, type OpenaiResponsesSourceDocumentProviderMetadata, type OpenaiResponsesTextProviderMetadata, type ResponsesCompactionProviderMetadata, type ResponsesProviderMetadata, type ResponsesReasoningProviderMetadata, type ResponsesSourceDocumentProviderMetadata, type ResponsesTextProviderMetadata, applyPatch, applyPatchArgsSchema, applyPatchInputSchema, applyPatchOutputSchema, applyPatchToolFactory, codeInterpreter, codeInterpreterArgsSchema, codeInterpreterInputSchema, codeInterpreterOutputSchema, codeInterpreterToolFactory, fileSearch, fileSearchArgsSchema, fileSearchOutputSchema, hasDefaultResponseFormat, imageGeneration, imageGenerationArgsSchema, imageGenerationOutputSchema, modelMaxImagesPerCall, openAITranscriptionModelOptions, openaiEmbeddingModelOptions, openaiImageModelEditOptions, openaiImageModelGenerationOptions, openaiImageModelOptions, openaiLanguageModelChatOptions, openaiLanguageModelCompletionOptions, openaiSpeechModelOptionsSchema, webSearch, webSearchArgsSchema, webSearchOutputSchema, webSearchPreview, webSearchPreviewArgsSchema, webSearchPreviewInputSchema, webSearchToolFactory };