@ai-sdk/openai 4.0.0-canary.49 → 4.0.0-canary.50

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # @ai-sdk/openai
 
+## 4.0.0-canary.50
+
+### Patch Changes
+
+- 29e6ac6: feat: add allowedTools provider option for OpenAI Responses
+
 ## 4.0.0-canary.49
 
 ### Patch Changes

package/dist/index.d.ts

@@ -1067,6 +1067,10 @@ declare const openaiLanguageModelResponsesOptionsSchema: _ai_sdk_provider_utils.
         type: "compaction";
         compactThreshold: number;
     }[] | null | undefined;
+    allowedTools?: {
+        toolNames: string[];
+        mode?: "auto" | "required" | undefined;
+    } | undefined;
 }>;
 type OpenAILanguageModelResponsesOptions = InferSchema<typeof openaiLanguageModelResponsesOptionsSchema>;
 

package/dist/index.js

@@ -4746,7 +4746,21 @@ var openaiLanguageModelResponsesOptionsSchema = lazySchema23(
           type: z25.literal("compaction"),
           compactThreshold: z25.number()
         })
-      ).nullish()
+      ).nullish(),
+      /**
+       * 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: z25.object({
+        toolNames: z25.array(z25.string()).min(1),
+        mode: z25.enum(["auto", "required"]).optional()
+      }).optional()
     })
   )
 );
@@ -4762,10 +4776,11 @@ import {
 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) {
@@ -4956,6 +4971,23 @@ async function prepareResponsesTools({
         break;
     }
   }
+  if (allowedTools != null) {
+    return {
+      tools: openaiTools2,
+      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: openaiTools2, toolChoice: void 0, toolWarnings };
   }
@@ -4966,7 +4998,7 @@ async function prepareResponsesTools({
     case "required":
       return { tools: openaiTools2, 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: openaiTools2,
         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 },
@@ -5088,7 +5120,7 @@ var OpenAIResponsesLanguageModel = class _OpenAIResponsesLanguageModel {
     toolChoice,
     responseFormat
   }) {
-    var _a, _b, _c, _d, _e, _f, _g, _h, _i, _j;
+    var _a, _b, _c, _d, _e, _f, _g, _h, _i, _j, _k;
     const warnings = [];
     const modelCapabilities = getOpenAILanguageModelCapabilities(this.modelId);
     if (topK != null) {
@@ -5151,16 +5183,17 @@ var OpenAIResponsesLanguageModel = class _OpenAIResponsesLanguageModel {
     } = await prepareResponsesTools({
       tools,
       toolChoice,
+      allowedTools: (_c = openaiOptions == null ? void 0 : openaiOptions.allowedTools) != null ? _c : void 0,
       toolNameMapping,
       customProviderToolNames
     });
     const { input, warnings: inputWarnings } = await convertToOpenAIResponsesInput({
       prompt,
       toolNameMapping,
-      systemMessageMode: (_c = openaiOptions == null ? void 0 : openaiOptions.systemMessageMode) != null ? _c : isReasoningModel ? "developer" : modelCapabilities.systemMessageMode,
+      systemMessageMode: (_d = openaiOptions == null ? void 0 : openaiOptions.systemMessageMode) != null ? _d : isReasoningModel ? "developer" : modelCapabilities.systemMessageMode,
       providerOptionsName,
       fileIdPrefixes: this.config.fileIdPrefixes,
-      store: (_d = openaiOptions == null ? void 0 : openaiOptions.store) != null ? _d : true,
+      store: (_e = openaiOptions == null ? void 0 : openaiOptions.store) != null ? _e : true,
       hasConversation: (openaiOptions == null ? void 0 : openaiOptions.conversation) != null,
       hasLocalShellTool: hasOpenAITool("openai.local_shell"),
       hasShellTool: hasOpenAITool("openai.shell"),
@@ -5168,7 +5201,7 @@ var OpenAIResponsesLanguageModel = class _OpenAIResponsesLanguageModel {
       customProviderToolNames: customProviderToolNames.size > 0 ? customProviderToolNames : void 0
     });
     warnings.push(...inputWarnings);
-    const strictJsonSchema = (_e = openaiOptions == null ? void 0 : openaiOptions.strictJsonSchema) != null ? _e : true;
+    const strictJsonSchema = (_f = openaiOptions == null ? void 0 : openaiOptions.strictJsonSchema) != null ? _f : true;
     let include = openaiOptions == null ? void 0 : openaiOptions.include;
     function addInclude(key) {
       if (include == null) {
@@ -5184,9 +5217,9 @@ var OpenAIResponsesLanguageModel = class _OpenAIResponsesLanguageModel {
     if (topLogprobs) {
       addInclude("message.output_text.logprobs");
     }
-    const webSearchToolName = (_f = tools == null ? void 0 : tools.find(
+    const webSearchToolName = (_g = tools == null ? void 0 : tools.find(
       (tool) => tool.type === "provider" && (tool.id === "openai.web_search" || tool.id === "openai.web_search_preview")
-    )) == null ? void 0 : _f.name;
+    )) == null ? void 0 : _g.name;
     if (webSearchToolName) {
       addInclude("web_search_call.action.sources");
     }
@@ -5209,7 +5242,7 @@ var OpenAIResponsesLanguageModel = class _OpenAIResponsesLanguageModel {
             format: responseFormat.schema != null ? {
               type: "json_schema",
               strict: strictJsonSchema,
-              name: (_g = responseFormat.name) != null ? _g : "response",
+              name: (_h = responseFormat.name) != null ? _h : "response",
               description: responseFormat.description,
               schema: responseFormat.schema
             } : { type: "json_object" }
@@ -5305,9 +5338,9 @@ var OpenAIResponsesLanguageModel = class _OpenAIResponsesLanguageModel {
       });
       delete baseArgs.service_tier;
     }
-    const shellToolEnvType = (_j = (_i = (_h = tools == null ? void 0 : tools.find(
+    const shellToolEnvType = (_k = (_j = (_i = tools == null ? void 0 : tools.find(
       (tool) => tool.type === "provider" && tool.id === "openai.shell"
-    )) == null ? void 0 : _h.args) == null ? void 0 : _i.environment) == null ? void 0 : _j.type;
+    )) == null ? void 0 : _i.args) == null ? void 0 : _j.environment) == null ? void 0 : _k.type;
     const isShellProviderExecuted = shellToolEnvType === "containerAuto" || shellToolEnvType === "containerReference";
     return {
       webSearchToolName,
@@ -7259,7 +7292,7 @@ var OpenAISkills = class {
 };
 
 // src/version.ts
-var VERSION = true ? "4.0.0-canary.49" : "0.0.0-test";
+var VERSION = true ? "4.0.0-canary.50" : "0.0.0-test";
 
 // src/openai-provider.ts
 function createOpenAI(options = {}) {