@ai-sdk/openai 3.0.61 → 3.0.62

package/dist/internal/index.js

@@ -4370,7 +4370,21 @@ var openaiLanguageModelResponsesOptionsSchema = (0, import_provider_utils26.lazy
        * When enabled, the SDK applies reasoning-model parameter compatibility rules
        * and defaults `systemMessageMode` to `developer` unless overridden.
        */
-      forceReasoning: import_v419.z.boolean().optional()
+      forceReasoning: import_v419.z.boolean().optional(),
+      /**
+       * Restrict the callable tools to a subset while keeping the full tools
+       * list intact, so prompt caching is preserved across requests with
+       * different allowlists.
+       *
+       * When set, this overrides the request-level `toolChoice` and emits
+       * `tool_choice: { type: "allowed_tools", mode, tools }` on the wire.
+       *
+       * @see https://developers.openai.com/api/reference/resources/responses/methods/create#(resource)%20responses%20%3E%20(model)%20tool_choice_allowed%20%3E%20(schema)
+       */
+      allowedTools: import_v419.z.object({
+        toolNames: import_v419.z.array(import_v419.z.string()).min(1),
+        mode: import_v419.z.enum(["auto", "required"]).optional()
+      }).optional()
     })
   )
 );
@@ -4700,10 +4714,11 @@ var webSearchPreview = (0, import_provider_utils33.createProviderToolFactoryWith
 async function prepareResponsesTools({
   tools,
   toolChoice,
+  allowedTools,
   toolNameMapping,
   customProviderToolNames
 }) {
-  var _a, _b;
+  var _a, _b, _c;
   tools = (tools == null ? void 0 : tools.length) ? tools : void 0;
   const toolWarnings = [];
   if (tools == null) {
@@ -4894,6 +4909,23 @@ async function prepareResponsesTools({
         break;
     }
   }
+  if (allowedTools != null) {
+    return {
+      tools: openaiTools,
+      toolChoice: {
+        type: "allowed_tools",
+        mode: (_b = allowedTools.mode) != null ? _b : "auto",
+        tools: allowedTools.toolNames.map((name) => {
+          var _a2;
+          return {
+            type: "function",
+            name: (_a2 = toolNameMapping == null ? void 0 : toolNameMapping.toProviderToolName(name)) != null ? _a2 : name
+          };
+        })
+      },
+      toolWarnings
+    };
+  }
   if (toolChoice == null) {
     return { tools: openaiTools, toolChoice: void 0, toolWarnings };
   }
@@ -4904,7 +4936,7 @@ async function prepareResponsesTools({
     case "required":
       return { tools: openaiTools, toolChoice: type, toolWarnings };
     case "tool": {
-      const resolvedToolName = (_b = toolNameMapping == null ? void 0 : toolNameMapping.toProviderToolName(toolChoice.toolName)) != null ? _b : toolChoice.toolName;
+      const resolvedToolName = (_c = toolNameMapping == null ? void 0 : toolNameMapping.toProviderToolName(toolChoice.toolName)) != null ? _c : toolChoice.toolName;
       return {
         tools: openaiTools,
         toolChoice: resolvedToolName === "code_interpreter" || resolvedToolName === "file_search" || resolvedToolName === "image_generation" || resolvedToolName === "web_search_preview" || resolvedToolName === "web_search" || resolvedToolName === "mcp" || resolvedToolName === "apply_patch" ? { type: resolvedToolName } : resolvedCustomProviderToolNames.has(resolvedToolName) ? { type: "custom", name: resolvedToolName } : { type: "function", name: resolvedToolName },
@@ -5010,7 +5042,7 @@ var OpenAIResponsesLanguageModel = class {
     toolChoice,
     responseFormat
   }) {
-    var _a, _b, _c, _d, _e, _f, _g, _h, _i;
+    var _a, _b, _c, _d, _e, _f, _g, _h, _i, _j;
     const warnings = [];
     const modelCapabilities = getOpenAILanguageModelCapabilities(this.modelId);
     if (topK != null) {
@@ -5073,16 +5105,17 @@ var OpenAIResponsesLanguageModel = class {
     } = await prepareResponsesTools({
       tools,
       toolChoice,
+      allowedTools: (_b = openaiOptions == null ? void 0 : openaiOptions.allowedTools) != null ? _b : void 0,
       toolNameMapping,
       customProviderToolNames
     });
     const { input, warnings: inputWarnings } = await convertToOpenAIResponsesInput({
       prompt,
       toolNameMapping,
-      systemMessageMode: (_b = openaiOptions == null ? void 0 : openaiOptions.systemMessageMode) != null ? _b : isReasoningModel ? "developer" : modelCapabilities.systemMessageMode,
+      systemMessageMode: (_c = openaiOptions == null ? void 0 : openaiOptions.systemMessageMode) != null ? _c : isReasoningModel ? "developer" : modelCapabilities.systemMessageMode,
       providerOptionsName,
       fileIdPrefixes: this.config.fileIdPrefixes,
-      store: (_c = openaiOptions == null ? void 0 : openaiOptions.store) != null ? _c : true,
+      store: (_d = openaiOptions == null ? void 0 : openaiOptions.store) != null ? _d : true,
       hasConversation: (openaiOptions == null ? void 0 : openaiOptions.conversation) != null,
       hasLocalShellTool: hasOpenAITool("openai.local_shell"),
       hasShellTool: hasOpenAITool("openai.shell"),
@@ -5090,7 +5123,7 @@ var OpenAIResponsesLanguageModel = class {
       customProviderToolNames: customProviderToolNames.size > 0 ? customProviderToolNames : void 0
     });
     warnings.push(...inputWarnings);
-    const strictJsonSchema = (_d = openaiOptions == null ? void 0 : openaiOptions.strictJsonSchema) != null ? _d : true;
+    const strictJsonSchema = (_e = openaiOptions == null ? void 0 : openaiOptions.strictJsonSchema) != null ? _e : true;
     let include = openaiOptions == null ? void 0 : openaiOptions.include;
     function addInclude(key) {
       if (include == null) {
@@ -5106,9 +5139,9 @@ var OpenAIResponsesLanguageModel = class {
     if (topLogprobs) {
       addInclude("message.output_text.logprobs");
     }
-    const webSearchToolName = (_e = tools == null ? void 0 : tools.find(
+    const webSearchToolName = (_f = tools == null ? void 0 : tools.find(
       (tool) => tool.type === "provider" && (tool.id === "openai.web_search" || tool.id === "openai.web_search_preview")
-    )) == null ? void 0 : _e.name;
+    )) == null ? void 0 : _f.name;
     if (webSearchToolName) {
       addInclude("web_search_call.action.sources");
     }
@@ -5131,7 +5164,7 @@ var OpenAIResponsesLanguageModel = class {
             format: responseFormat.schema != null ? {
               type: "json_schema",
               strict: strictJsonSchema,
-              name: (_f = responseFormat.name) != null ? _f : "response",
+              name: (_g = responseFormat.name) != null ? _g : "response",
               description: responseFormat.description,
               schema: responseFormat.schema
             } : { type: "json_object" }
@@ -5220,9 +5253,9 @@ var OpenAIResponsesLanguageModel = class {
       });
       delete baseArgs.service_tier;
     }
-    const shellToolEnvType = (_i = (_h = (_g = tools == null ? void 0 : tools.find(
+    const shellToolEnvType = (_j = (_i = (_h = tools == null ? void 0 : tools.find(
       (tool) => tool.type === "provider" && tool.id === "openai.shell"
-    )) == null ? void 0 : _g.args) == null ? void 0 : _h.environment) == null ? void 0 : _i.type;
+    )) == null ? void 0 : _h.args) == null ? void 0 : _i.environment) == null ? void 0 : _j.type;
     const isShellProviderExecuted = shellToolEnvType === "containerAuto" || shellToolEnvType === "containerReference";
     return {
       webSearchToolName,