@ai-sdk/openai 3.0.109 → 3.0.111

package/dist/index.mjs

@@ -55,6 +55,7 @@ function getOpenAILanguageModelCapabilities(modelId) {
     supportsFlexProcessing,
     supportsPriorityProcessing,
     supportsConfigurationUpdate: isGpt6OrLaterModel,
+    supportsAsyncToolCalling: isGpt6OrLaterModel,
     supportedReasoningEfforts: isGpt6OrLaterModel ? ["low", "medium", "high", "xhigh", "max"] : void 0,
     isReasoningModel,
     systemMessageMode,
@@ -2090,6 +2091,10 @@ var modelMaxImagesPerCall = {
   "gpt-image-1-mini": 10,
   "gpt-image-1.5": 10,
   "gpt-image-2": 10,
+  "gpt-image-2.5-flare": 10,
+  "gpt-image-2.5-flare-2026-09-08": 10,
+  "gpt-image-2.5-sunburst": 10,
+  "gpt-image-2.5-sunburst-2026-09-08": 10,
   "chatgpt-image-latest": 10
 };
 var defaultResponseFormatPrefixes = ["chatgpt-image-", "gpt-image-"];
@@ -2106,9 +2111,10 @@ var baseImageModelOptionsObject = z9.object({
   /**
    * Quality of the generated image(s).
    *
-   * Valid values: `standard`, `hd`, `low`, `medium`, `high`, `auto`.
+   * Valid values: `standard`, `hd`, `low`, `medium`, `high`, `xhigh`, `max`, `auto`.
+   * `xhigh` and `max` are supported by GPT Image 2.5 models.
    */
-  quality: z9.enum(["standard", "hd", "low", "medium", "high", "auto"]).optional(),
+  quality: z9.enum(["standard", "hd", "low", "medium", "high", "xhigh", "max", "auto"]).optional(),
   /**
    * Background behavior for the generated image(s).
    *
@@ -2481,6 +2487,7 @@ var customArgsSchema = lazySchema11(
     z12.object({
       name: z12.string(),
       description: z12.string().optional(),
+      async: z12.boolean().optional(),
       format: z12.union([
         z12.object({
           type: z12.literal("grammar"),
@@ -2575,7 +2582,7 @@ var imageGenerationArgsSchema = lazySchema13(
       outputCompression: z14.number().int().min(0).max(100).optional(),
       outputFormat: z14.enum(["png", "jpeg", "webp"]).optional(),
       partialImages: z14.number().int().min(0).max(3).optional(),
-      quality: z14.enum(["auto", "low", "medium", "high"]).optional(),
+      quality: z14.enum(["auto", "low", "medium", "high", "xhigh", "max"]).optional(),
       size: z14.enum(["1024x1024", "1024x1536", "1536x1024", "auto"]).optional()
     }).strict()
   )
@@ -2959,6 +2966,7 @@ var openaiTools = {
    *
    * @param name - The name of the custom tool.
    * @param description - An optional description of the tool.
+   * @param async - Whether the model can continue without waiting for the tool result.
    * @param format - The output format constraint (grammar type, syntax, and definition).
    */
   customTool,
@@ -2994,7 +3002,7 @@ var openaiTools = {
    * @param outputCompression - Compression level for the output image (0-100).
    * @param outputFormat - The output format of the generated image. One of 'png', 'jpeg', or 'webp'.
    * @param partialImages - Number of partial images to generate in streaming mode (0-3).
-   * @param quality - The quality of the generated image. One of 'auto', 'low', 'medium', or 'high'.
+   * @param quality - The quality of the generated image. One of 'auto', 'low', 'medium', 'high', 'xhigh', or 'max'. 'xhigh' and 'max' require a GPT Image 2.5 model.
    * @param size - The size of the generated image. One of 'auto', '1024x1024', '1024x1536', or '1536x1024'.
    */
   imageGeneration,
@@ -3383,6 +3391,7 @@ async function convertToOpenAIResponsesInput({
   toolNameMapping,
   systemMessageMode,
   providerOptionsName,
+  explicitMessageItemType = false,
   fileIdPrefixes,
   passThroughUnsupportedFiles = false,
   store,
@@ -3394,7 +3403,7 @@ async function convertToOpenAIResponsesInput({
   toolSearchToolName,
   customProviderToolNames
 }) {
-  var _a2, _b, _c, _d, _e, _f, _g, _h, _i, _j, _k, _l, _m, _n, _o, _p, _q, _r, _s, _t, _u, _v, _w, _x, _y;
+  var _a2, _b, _c, _d, _e, _f, _g, _h, _i, _j, _k, _l, _m, _n, _o, _p, _q, _r, _s, _t, _u, _v, _w, _x, _y, _z, _A, _B, _C, _D;
   let input = [];
   const warnings = [];
   const processedApprovalIds = /* @__PURE__ */ new Set();
@@ -3414,6 +3423,7 @@ async function convertToOpenAIResponsesInput({
               providerOptionsName
             );
             input.push({
+              ...explicitMessageItemType && { type: "message" },
               role: "system",
               content: promptCacheBreakpoint == null ? content : [
                 {
@@ -3431,6 +3441,7 @@ async function convertToOpenAIResponsesInput({
               providerOptionsName
             );
             input.push({
+              ...explicitMessageItemType && { type: "message" },
               role: "developer",
               content: promptCacheBreakpoint == null ? content : [
                 {
@@ -3460,6 +3471,7 @@ async function convertToOpenAIResponsesInput({
       }
       case "user": {
         input.push({
+          ...explicitMessageItemType && { type: "message" },
           role: "user",
           content: content.map((part, index) => {
             var _a3, _b2, _c2;
@@ -3541,6 +3553,7 @@ async function convertToOpenAIResponsesInput({
                 break;
               }
               input.push({
+                ...explicitMessageItemType && { type: "message" },
                 role: "assistant",
                 content: [{ type: "output_text", text: part.text }],
                 id,
@@ -3579,6 +3592,7 @@ async function convertToOpenAIResponsesInput({
               }
               const id = (_f = (_c = (_b = part.providerOptions) == null ? void 0 : _b[providerOptionsName]) == null ? void 0 : _c.itemId) != null ? _f : (_e = (_d = part.providerMetadata) == null ? void 0 : _d[providerOptionsName]) == null ? void 0 : _e.itemId;
               const namespace = (_k = (_h = (_g = part.providerOptions) == null ? void 0 : _g[providerOptionsName]) == null ? void 0 : _h.namespace) != null ? _k : (_j = (_i = part.providerMetadata) == null ? void 0 : _i[providerOptionsName]) == null ? void 0 : _j.namespace;
+              const isAsync = (_p = (_m = (_l = part.providerOptions) == null ? void 0 : _l[providerOptionsName]) == null ? void 0 : _m.async) != null ? _p : (_o = (_n = part.providerMetadata) == null ? void 0 : _n[providerOptionsName]) == null ? void 0 : _o.async;
               if (hasConversation && id != null) {
                 break;
               }
@@ -3602,7 +3616,7 @@ async function convertToOpenAIResponsesInput({
                   type: "tool_search_call",
                   id: id != null ? id : part.toolCallId,
                   execution,
-                  call_id: (_l = parsedInput.call_id) != null ? _l : null,
+                  call_id: (_q = parsedInput.call_id) != null ? _q : null,
                   status: "completed",
                   arguments: parsedInput.arguments
                 });
@@ -3616,7 +3630,7 @@ async function convertToOpenAIResponsesInput({
                   break;
                 }
               }
-              const isProviderDefinedToolCall = hasLocalShellTool && resolvedToolName === "local_shell" || hasShellTool && resolvedToolName === "shell" || hasApplyPatchTool && resolvedToolName === "apply_patch" || ((_m = customProviderToolNames == null ? void 0 : customProviderToolNames.has(resolvedToolName)) != null ? _m : false);
+              const isProviderDefinedToolCall = hasLocalShellTool && resolvedToolName === "local_shell" || hasShellTool && resolvedToolName === "shell" || hasApplyPatchTool && resolvedToolName === "apply_patch" || ((_r = customProviderToolNames == null ? void 0 : customProviderToolNames.has(resolvedToolName)) != null ? _r : false);
               if (hasPreviousResponseId && store && id != null && isProviderDefinedToolCall) {
                 break;
               }
@@ -3682,6 +3696,7 @@ async function convertToOpenAIResponsesInput({
                   call_id: part.toolCallId,
                   name: resolvedToolName,
                   input: typeof part.input === "string" ? part.input : JSON.stringify(part.input),
+                  ...isAsync != null && { async: isAsync },
                   id
                 });
                 break;
@@ -3691,6 +3706,7 @@ async function convertToOpenAIResponsesInput({
                 call_id: part.toolCallId,
                 name: resolvedToolName,
                 arguments: serializeToolCallArguments2(part.input),
+                ...isAsync != null && { async: isAsync },
                 ...namespace != null && { namespace }
               });
               break;
@@ -3707,7 +3723,7 @@ async function convertToOpenAIResponsesInput({
                 part.toolName
               );
               if (part.toolName === toolSearchToolName) {
-                const itemId = (_s = (_r = (_o = (_n = part.providerOptions) == null ? void 0 : _n[providerOptionsName]) == null ? void 0 : _o.itemId) != null ? _r : (_q = (_p = part.providerMetadata) == null ? void 0 : _p[providerOptionsName]) == null ? void 0 : _q.itemId) != null ? _s : part.toolCallId;
+                const itemId = (_x = (_w = (_t = (_s = part.providerOptions) == null ? void 0 : _s[providerOptionsName]) == null ? void 0 : _t.itemId) != null ? _w : (_v = (_u = part.providerMetadata) == null ? void 0 : _u[providerOptionsName]) == null ? void 0 : _v.itemId) != null ? _x : part.toolCallId;
                 if (store) {
                   input.push({ type: "item_reference", id: itemId });
                 } else if (part.output.type === "json") {
@@ -3748,7 +3764,7 @@ async function convertToOpenAIResponsesInput({
                 break;
               }
               if (store) {
-                const itemId = (_v = (_u = (_t = part.providerOptions) == null ? void 0 : _t[providerOptionsName]) == null ? void 0 : _u.itemId) != null ? _v : part.toolCallId;
+                const itemId = (_A = (_z = (_y = part.providerOptions) == null ? void 0 : _y[providerOptionsName]) == null ? void 0 : _z.itemId) != null ? _A : part.toolCallId;
                 input.push({ type: "item_reference", id: itemId });
               } else {
                 warnings.push({
@@ -3915,7 +3931,7 @@ ${text}`,
           }
           const output = part.output;
           if (output.type === "execution-denied") {
-            const approvalId = (_x = (_w = output.providerOptions) == null ? void 0 : _w.openai) == null ? void 0 : _x.approvalId;
+            const approvalId = (_C = (_B = output.providerOptions) == null ? void 0 : _B.openai) == null ? void 0 : _C.approvalId;
             if (approvalId) {
               continue;
             }
@@ -4002,7 +4018,7 @@ ${text}`,
                 break;
               case "execution-denied":
                 outputValue = convertScalarOutput(
-                  (_y = output.reason) != null ? _y : "Tool call execution denied."
+                  (_D = output.reason) != null ? _D : "Tool call execution denied."
                 );
                 break;
               case "json":
@@ -4343,6 +4359,7 @@ var openaiResponsesChunkSchema = lazySchema20(
             call_id: z22.string(),
             name: z22.string(),
             arguments: z22.string(),
+            async: z22.boolean().nullish(),
             namespace: z22.string().nullish()
           }),
           z22.object({
@@ -4418,7 +4435,8 @@ var openaiResponsesChunkSchema = lazySchema20(
             id: z22.string(),
             call_id: z22.string(),
             name: z22.string(),
-            input: z22.string()
+            input: z22.string(),
+            async: z22.boolean().nullish()
           }),
           z22.object({
             type: z22.literal("shell_call"),
@@ -4486,6 +4504,7 @@ var openaiResponsesChunkSchema = lazySchema20(
             call_id: z22.string(),
             name: z22.string(),
             arguments: z22.string(),
+            async: z22.boolean().nullish(),
             status: z22.literal("completed"),
             namespace: z22.string().nullish()
           }),
@@ -4495,6 +4514,7 @@ var openaiResponsesChunkSchema = lazySchema20(
             call_id: z22.string(),
             name: z22.string(),
             input: z22.string(),
+            async: z22.boolean().nullish(),
             status: z22.literal("completed")
           }),
           z22.object({
@@ -4928,6 +4948,7 @@ var openaiResponsesResponseSchema = lazySchema20(
             name: z22.string(),
             arguments: z22.string(),
             id: z22.string(),
+            async: z22.boolean().nullish(),
             namespace: z22.string().nullish()
           }),
           z22.object({
@@ -4935,7 +4956,8 @@ var openaiResponsesResponseSchema = lazySchema20(
             call_id: z22.string(),
             name: z22.string(),
             input: z22.string(),
-            id: z22.string()
+            id: z22.string(),
+            async: z22.boolean().nullish()
           }),
           z22.object({
             type: z22.literal("computer_call"),
@@ -5372,7 +5394,8 @@ async function prepareResponsesTools({
   toolChoice,
   allowedTools,
   toolNameMapping,
-  customProviderToolNames
+  customProviderToolNames,
+  supportsAsyncToolCalling = true
 }) {
   var _a2, _b, _c, _d;
   tools = (tools == null ? void 0 : tools.length) ? tools : void 0;
@@ -5403,7 +5426,13 @@ async function prepareResponsesTools({
         const openaiOptions = (_a2 = tool.providerOptions) == null ? void 0 : _a2.openai;
         const openaiFunctionTool = prepareFunctionTool({
           tool,
-          options: openaiOptions
+          options: openaiOptions,
+          async: resolveAsyncToolOption({
+            value: openaiOptions == null ? void 0 : openaiOptions.async,
+            supportsAsyncToolCalling,
+            toolName: tool.name,
+            toolWarnings
+          })
         });
         const namespace = openaiOptions == null ? void 0 : openaiOptions.namespace;
         if (namespace == null) {
@@ -5585,6 +5614,12 @@ async function prepareResponsesTools({
               type: "custom",
               name: args.name,
               description: args.description,
+              ...resolveAsyncToolOption({
+                value: args.async,
+                supportsAsyncToolCalling,
+                toolName: args.name,
+                toolWarnings
+              }) != null ? { async: args.async } : {},
               format: args.format
             });
             resolvedCustomProviderToolNames.add(args.name);
@@ -5756,7 +5791,8 @@ function toAllowedToolResolution(tool) {
 }
 function prepareFunctionTool({
   tool,
-  options
+  options,
+  async
 }) {
   const deferLoading = options == null ? void 0 : options.deferLoading;
   return {
@@ -5764,10 +5800,27 @@ function prepareFunctionTool({
     name: tool.name,
     description: tool.description,
     parameters: tool.inputSchema,
+    ...async != null ? { async } : {},
     ...tool.strict != null ? { strict: tool.strict } : {},
     ...deferLoading != null ? { defer_loading: deferLoading } : {}
   };
 }
+function resolveAsyncToolOption({
+  value,
+  supportsAsyncToolCalling,
+  toolName,
+  toolWarnings
+}) {
+  if (value !== true || supportsAsyncToolCalling) {
+    return value;
+  }
+  toolWarnings.push({
+    type: "unsupported",
+    feature: `async tool calling for "${toolName}"`,
+    details: "Async tool calling is only supported by GPT-6 and later models."
+  });
+  return void 0;
+}
 function mapShellEnvironment(environment) {
   if (environment.type === "containerReference") {
     const env2 = environment;
@@ -5935,13 +5988,15 @@ var OpenAIResponsesLanguageModel = class {
       toolChoice,
       allowedTools: (_b = openaiOptions == null ? void 0 : openaiOptions.allowedTools) != null ? _b : void 0,
       toolNameMapping,
-      customProviderToolNames
+      customProviderToolNames,
+      supportsAsyncToolCalling: modelCapabilities.supportsAsyncToolCalling
     });
     const { input, warnings: inputWarnings } = await convertToOpenAIResponsesInput({
       prompt,
       toolNameMapping,
       systemMessageMode: (_c = openaiOptions == null ? void 0 : openaiOptions.systemMessageMode) != null ? _c : isReasoningModel ? "developer" : modelCapabilities.systemMessageMode,
       providerOptionsName,
+      explicitMessageItemType: this.config.explicitMessageItemType,
       fileIdPrefixes: this.config.fileIdPrefixes,
       passThroughUnsupportedFiles: (_d = openaiOptions == null ? void 0 : openaiOptions.passThroughUnsupportedFiles) != null ? _d : false,
       store: (_e = openaiOptions == null ? void 0 : openaiOptions.store) != null ? _e : true,
@@ -6445,6 +6500,7 @@ var OpenAIResponsesLanguageModel = class {
             providerMetadata: {
               [providerOptionsName]: {
                 itemId: part.id,
+                ...part.async != null && { async: part.async },
                 ...part.namespace != null && { namespace: part.namespace }
               }
             }
@@ -6461,7 +6517,8 @@ var OpenAIResponsesLanguageModel = class {
             input: JSON.stringify(part.input),
             providerMetadata: {
               [providerOptionsName]: {
-                itemId: part.id
+                itemId: part.id,
+                ...part.async != null && { async: part.async }
               }
             }
           });
@@ -6749,7 +6806,8 @@ var OpenAIResponsesLanguageModel = class {
                   toolName: value.item.name,
                   toolCallId: value.item.call_id,
                   suppressInputStreaming,
-                  bufferedInputDeltas: suppressInputStreaming ? [] : void 0
+                  bufferedInputDeltas: suppressInputStreaming ? [] : void 0,
+                  async: value.item.async
                 };
                 if (!suppressInputStreaming) {
                   controller.enqueue({
@@ -6764,7 +6822,8 @@ var OpenAIResponsesLanguageModel = class {
                 );
                 ongoingToolCalls[value.output_index] = {
                   toolName,
-                  toolCallId: value.item.call_id
+                  toolCallId: value.item.call_id,
+                  async: value.item.async
                 };
                 controller.enqueue({
                   type: "tool-input-start",
@@ -7008,6 +7067,7 @@ var OpenAIResponsesLanguageModel = class {
                     providerMetadata: {
                       [providerOptionsName]: {
                         itemId: item.id,
+                        ...item.async != null ? { async: item.async } : (ongoingToolCall == null ? void 0 : ongoingToolCall.async) != null ? { async: ongoingToolCall.async } : {},
                         ...item.namespace != null && {
                           namespace: item.namespace
                         }
@@ -7052,6 +7112,7 @@ var OpenAIResponsesLanguageModel = class {
                   }
                 });
               } else if (value.item.type === "custom_tool_call") {
+                const ongoingToolCall = ongoingToolCalls[value.output_index];
                 ongoingToolCalls[value.output_index] = void 0;
                 hasFunctionCall = true;
                 const toolName = toolNameMapping.toCustomToolName(
@@ -7068,7 +7129,8 @@ var OpenAIResponsesLanguageModel = class {
                   input: JSON.stringify(value.item.input),
                   providerMetadata: {
                     [providerOptionsName]: {
-                      itemId: value.item.id
+                      itemId: value.item.id,
+                      ...value.item.async != null ? { async: value.item.async } : (ongoingToolCall == null ? void 0 : ongoingToolCall.async) != null ? { async: ongoingToolCall.async } : {}
                     }
                   }
                 });
@@ -8164,7 +8226,7 @@ var OpenAITranscriptionModel = class {
 };
 
 // src/version.ts
-var VERSION = true ? "3.0.109" : "0.0.0-test";
+var VERSION = true ? "3.0.111" : "0.0.0-test";
 
 // src/openai-provider.ts
 function createOpenAI(options = {}) {