@ai-sdk/openai 4.0.19 → 4.0.20

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # @ai-sdk/openai
 
+## 4.0.20
+
+### Patch Changes
+
+- 1f6dd3a: Add OpenAI Responses Programmatic Tool Calling with hosted program tools, function caller controls, structured output schemas, and multi-step continuation support.
+
 ## 4.0.19
 
 ### Patch Changes

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 import * as _ai_sdk_provider 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 { JSONValue, ProviderV4, LanguageModelV4, EmbeddingModelV4, ImageModelV4, TranscriptionModelV4, SpeechModelV4, Experimental_RealtimeFactoryV4, FilesV4, SkillsV4, Experimental_RealtimeModelV4, Experimental_RealtimeModelV4ClientSecretOptions, Experimental_RealtimeModelV4ClientSecretResult, Experimental_RealtimeModelV4ServerEvent, Experimental_RealtimeModelV4ClientEvent, Experimental_RealtimeModelV4SessionConfig, JSONObject } from '@ai-sdk/provider';
 import * as _ai_sdk_provider_utils from '@ai-sdk/provider-utils';
 import { InferSchema, FetchFunction, WebSocketConstructor } from '@ai-sdk/provider-utils';
 import { z } from 'zod/v4';
@@ -414,6 +414,24 @@ declare const openaiResponsesChunkSchema: _ai_sdk_provider_utils.LazySchema<{
         name: string;
         arguments: string;
         namespace?: string | null | undefined;
+        caller?: {
+            type: "direct";
+        } | {
+            type: "program";
+            caller_id: string;
+        } | null | undefined;
+    } | {
+        type: "program";
+        id: string;
+        call_id: string;
+        code: string;
+        fingerprint: string;
+    } | {
+        type: "program_output";
+        id: string;
+        call_id: string;
+        result: string;
+        status: "completed" | "incomplete";
     } | {
         type: "web_search_call";
         id: string;
@@ -608,6 +626,18 @@ declare const openaiResponsesChunkSchema: _ai_sdk_provider_utils.LazySchema<{
             code?: string | null | undefined;
             message?: string | null | undefined;
         }[] | null | undefined;
+    } | {
+        type: "program";
+        id: string;
+        call_id: string;
+        code: string;
+        fingerprint: string;
+    } | {
+        type: "program_output";
+        id: string;
+        call_id: string;
+        result: string;
+        status: "completed" | "incomplete";
     } | {
         type: "message";
         id: string;
@@ -622,8 +652,14 @@ declare const openaiResponsesChunkSchema: _ai_sdk_provider_utils.LazySchema<{
         call_id: string;
         name: string;
         arguments: string;
-        status: "completed";
+        status: "completed" | "in_progress" | "incomplete";
         namespace?: string | null | undefined;
+        caller?: {
+            type: "direct";
+        } | {
+            type: "program";
+            caller_id: string;
+        } | null | undefined;
     } | {
         type: "custom_tool_call";
         id: string;
@@ -1253,6 +1289,17 @@ declare const openaiTools: {
         output?: string | null;
         error?: _ai_sdk_provider.JSONValue;
     }, {}>;
+    /**
+     * Programmatic Tool Calling lets OpenAI Responses models write and execute
+     * JavaScript that orchestrates eligible tools.
+     */
+    programmaticToolCalling: () => _ai_sdk_provider_utils.ProviderExecutedTool<{
+        code: string;
+        fingerprint: string;
+    }, {
+        result: string;
+        status: "completed" | "incomplete";
+    }, {}>;
     /**
      * 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
@@ -1479,6 +1526,16 @@ declare class OpenAIRealtimeModel implements Experimental_RealtimeModelV4 {
     buildSessionConfig(config: Experimental_RealtimeModelV4SessionConfig): Record<string, unknown>;
 }
 
+type OpenAIToolOptions = {
+    allowedCallers?: Array<'direct' | 'programmatic'>;
+    deferLoading?: boolean;
+    outputSchema?: JSONObject;
+    namespace?: {
+        name: string;
+        description: string;
+    };
+};
+
 declare const openaiFilesOptionsSchema: _ai_sdk_provider_utils.LazySchema<{
     purpose?: string | undefined;
     expiresAfter?: number | undefined;
@@ -1595,4 +1652,4 @@ type OpenaiResponsesSourceDocumentProviderMetadata = {
 
 declare const VERSION: string;
 
-export { OpenAIRealtimeModel as Experimental_OpenAIRealtimeModel, type OpenAIRealtimeModelConfig as Experimental_OpenAIRealtimeModelConfig, type OpenAILanguageModelChatOptions as OpenAIChatLanguageModelOptions, type OpenAIComputerAction, type OpenAIComputerSafetyCheck, 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 };
+export { OpenAIRealtimeModel as Experimental_OpenAIRealtimeModel, type OpenAIRealtimeModelConfig as Experimental_OpenAIRealtimeModelConfig, type OpenAILanguageModelChatOptions as OpenAIChatLanguageModelOptions, type OpenAIComputerAction, type OpenAIComputerSafetyCheck, 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 OpenAIToolOptions, type OpenAITranscriptionModelOptions, type OpenaiResponsesCompactionProviderMetadata, type OpenaiResponsesProviderMetadata, type OpenaiResponsesReasoningProviderMetadata, type OpenaiResponsesSourceDocumentProviderMetadata, type OpenaiResponsesTextProviderMetadata, VERSION, createOpenAI, openai };