@ai-sdk/openai 3.0.109 → 3.0.111

package/dist/internal/index.mjs

@@ -47,6 +47,7 @@ function getOpenAILanguageModelCapabilities(modelId) {
     supportsFlexProcessing,
     supportsPriorityProcessing,
     supportsConfigurationUpdate: isGpt6OrLaterModel,
+    supportsAsyncToolCalling: isGpt6OrLaterModel,
     supportedReasoningEfforts: isGpt6OrLaterModel ? ["low", "medium", "high", "xhigh", "max"] : void 0,
     isReasoningModel,
     systemMessageMode,
@@ -2082,6 +2083,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-"];
@@ -2098,9 +2103,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).
    *
@@ -3274,6 +3280,7 @@ async function convertToOpenAIResponsesInput({
   toolNameMapping,
   systemMessageMode,
   providerOptionsName,
+  explicitMessageItemType = false,
   fileIdPrefixes,
   passThroughUnsupportedFiles = false,
   store,
@@ -3285,7 +3292,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();
@@ -3305,6 +3312,7 @@ async function convertToOpenAIResponsesInput({
               providerOptionsName
             );
             input.push({
+              ...explicitMessageItemType && { type: "message" },
               role: "system",
               content: promptCacheBreakpoint == null ? content : [
                 {
@@ -3322,6 +3330,7 @@ async function convertToOpenAIResponsesInput({
               providerOptionsName
             );
             input.push({
+              ...explicitMessageItemType && { type: "message" },
               role: "developer",
               content: promptCacheBreakpoint == null ? content : [
                 {
@@ -3351,6 +3360,7 @@ async function convertToOpenAIResponsesInput({
       }
       case "user": {
         input.push({
+          ...explicitMessageItemType && { type: "message" },
           role: "user",
           content: content.map((part, index) => {
             var _a3, _b2, _c2;
@@ -3432,6 +3442,7 @@ async function convertToOpenAIResponsesInput({
                 break;
               }
               input.push({
+                ...explicitMessageItemType && { type: "message" },
                 role: "assistant",
                 content: [{ type: "output_text", text: part.text }],
                 id,
@@ -3470,6 +3481,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;
               }
@@ -3493,7 +3505,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
                 });
@@ -3507,7 +3519,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;
               }
@@ -3573,6 +3585,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;
@@ -3582,6 +3595,7 @@ async function convertToOpenAIResponsesInput({
                 call_id: part.toolCallId,
                 name: resolvedToolName,
                 arguments: serializeToolCallArguments2(part.input),
+                ...isAsync != null && { async: isAsync },
                 ...namespace != null && { namespace }
               });
               break;
@@ -3598,7 +3612,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") {
@@ -3639,7 +3653,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({
@@ -3806,7 +3820,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;
             }
@@ -3893,7 +3907,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":
@@ -4234,6 +4248,7 @@ var openaiResponsesChunkSchema = lazySchema16(
             call_id: z18.string(),
             name: z18.string(),
             arguments: z18.string(),
+            async: z18.boolean().nullish(),
             namespace: z18.string().nullish()
           }),
           z18.object({
@@ -4309,7 +4324,8 @@ var openaiResponsesChunkSchema = lazySchema16(
             id: z18.string(),
             call_id: z18.string(),
             name: z18.string(),
-            input: z18.string()
+            input: z18.string(),
+            async: z18.boolean().nullish()
           }),
           z18.object({
             type: z18.literal("shell_call"),
@@ -4377,6 +4393,7 @@ var openaiResponsesChunkSchema = lazySchema16(
             call_id: z18.string(),
             name: z18.string(),
             arguments: z18.string(),
+            async: z18.boolean().nullish(),
             status: z18.literal("completed"),
             namespace: z18.string().nullish()
           }),
@@ -4386,6 +4403,7 @@ var openaiResponsesChunkSchema = lazySchema16(
             call_id: z18.string(),
             name: z18.string(),
             input: z18.string(),
+            async: z18.boolean().nullish(),
             status: z18.literal("completed")
           }),
           z18.object({
@@ -4819,6 +4837,7 @@ var openaiResponsesResponseSchema = lazySchema16(
             name: z18.string(),
             arguments: z18.string(),
             id: z18.string(),
+            async: z18.boolean().nullish(),
             namespace: z18.string().nullish()
           }),
           z18.object({
@@ -4826,7 +4845,8 @@ var openaiResponsesResponseSchema = lazySchema16(
             call_id: z18.string(),
             name: z18.string(),
             input: z18.string(),
-            id: z18.string()
+            id: z18.string(),
+            async: z18.boolean().nullish()
           }),
           z18.object({
             type: z18.literal("computer_call"),
@@ -5381,7 +5401,7 @@ var imageGenerationArgsSchema = lazySchema20(
       outputCompression: z22.number().int().min(0).max(100).optional(),
       outputFormat: z22.enum(["png", "jpeg", "webp"]).optional(),
       partialImages: z22.number().int().min(0).max(3).optional(),
-      quality: z22.enum(["auto", "low", "medium", "high"]).optional(),
+      quality: z22.enum(["auto", "low", "medium", "high", "xhigh", "max"]).optional(),
       size: z22.enum(["1024x1024", "1024x1536", "1536x1024", "auto"]).optional()
     }).strict()
   )
@@ -5411,6 +5431,7 @@ var customArgsSchema = lazySchema21(
     z23.object({
       name: z23.string(),
       description: z23.string().optional(),
+      async: z23.boolean().optional(),
       format: z23.union([
         z23.object({
           type: z23.literal("grammar"),
@@ -5615,7 +5636,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;
@@ -5646,7 +5668,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) {
@@ -5828,6 +5856,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);
@@ -5999,7 +6033,8 @@ function toAllowedToolResolution(tool) {
 }
 function prepareFunctionTool({
   tool,
-  options
+  options,
+  async
 }) {
   const deferLoading = options == null ? void 0 : options.deferLoading;
   return {
@@ -6007,10 +6042,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;
@@ -6178,13 +6230,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,
@@ -6688,6 +6742,7 @@ var OpenAIResponsesLanguageModel = class {
             providerMetadata: {
               [providerOptionsName]: {
                 itemId: part.id,
+                ...part.async != null && { async: part.async },
                 ...part.namespace != null && { namespace: part.namespace }
               }
             }
@@ -6704,7 +6759,8 @@ var OpenAIResponsesLanguageModel = class {
             input: JSON.stringify(part.input),
             providerMetadata: {
               [providerOptionsName]: {
-                itemId: part.id
+                itemId: part.id,
+                ...part.async != null && { async: part.async }
               }
             }
           });
@@ -6992,7 +7048,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({
@@ -7007,7 +7064,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",
@@ -7251,6 +7309,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
                         }
@@ -7295,6 +7354,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(
@@ -7311,7 +7371,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 } : {}
                     }
                   }
                 });