@ai-sdk/openai 4.0.61 → 4.0.63

package/CHANGELOG.md

@@ -1,5 +1,20 @@
 # @ai-sdk/openai
 
+## 4.0.63
+
+### Patch Changes
+
+- 85db433: Include explicit message item types in Azure AI Foundry Responses requests.
+- 5fb2a64: feat(openai): add GPT Image 2.5 Flare and Sunburst model IDs
+- e105b2b: fix(openai): reject denied programmatic tool calls
+- 45f2b6a: fix(openai): report apply patch responses with a tool-calls finish reason
+
+## 4.0.62
+
+### Patch Changes
+
+- 8487955: Add `xhigh` and `max` quality support for GPT Image 2.5 Flare and Sunburst in image generation, image editing, and the Responses API image generation tool.
+
 ## 4.0.61
 
 ### Patch Changes

package/dist/index.d.ts

@@ -47,9 +47,9 @@ declare const openaiEmbeddingModelOptions: _ai_sdk_provider_utils.LazySchema<{
 }>;
 type OpenAIEmbeddingModelOptions = InferSchema<typeof openaiEmbeddingModelOptions>;
 
-type OpenAIImageModelId = 'dall-e-3' | 'dall-e-2' | 'gpt-image-1' | 'gpt-image-1-mini' | 'gpt-image-1.5' | 'gpt-image-2' | 'chatgpt-image-latest' | (string & {});
+type OpenAIImageModelId = 'dall-e-3' | 'dall-e-2' | 'gpt-image-1' | 'gpt-image-1-mini' | 'gpt-image-1.5' | 'gpt-image-2' | 'gpt-image-2.5-flare' | 'gpt-image-2.5-flare-2026-09-08' | 'gpt-image-2.5-sunburst' | 'gpt-image-2.5-sunburst-2026-09-08' | 'chatgpt-image-latest' | (string & {});
 declare const openaiImageModelOptions: _ai_sdk_provider_utils.LazySchema<{
-    quality?: "low" | "medium" | "high" | "auto" | "standard" | "hd" | undefined;
+    quality?: "low" | "medium" | "high" | "xhigh" | "max" | "auto" | "standard" | "hd" | undefined;
     background?: "auto" | "transparent" | "opaque" | undefined;
     outputFormat?: "png" | "jpeg" | "webp" | undefined;
     outputCompression?: number | undefined;
@@ -57,7 +57,7 @@ declare const openaiImageModelOptions: _ai_sdk_provider_utils.LazySchema<{
 }>;
 type OpenAIImageModelOptions = InferSchema<typeof openaiImageModelOptions>;
 declare const openaiImageModelGenerationOptions: _ai_sdk_provider_utils.LazySchema<{
-    quality?: "low" | "medium" | "high" | "auto" | "standard" | "hd" | undefined;
+    quality?: "low" | "medium" | "high" | "xhigh" | "max" | "auto" | "standard" | "hd" | undefined;
     background?: "auto" | "transparent" | "opaque" | undefined;
     outputFormat?: "png" | "jpeg" | "webp" | undefined;
     outputCompression?: number | undefined;
@@ -67,7 +67,7 @@ declare const openaiImageModelGenerationOptions: _ai_sdk_provider_utils.LazySche
 }>;
 type OpenAIImageModelGenerationOptions = InferSchema<typeof openaiImageModelGenerationOptions>;
 declare const openaiImageModelEditOptions: _ai_sdk_provider_utils.LazySchema<{
-    quality?: "low" | "medium" | "high" | "auto" | "standard" | "hd" | undefined;
+    quality?: "low" | "medium" | "high" | "xhigh" | "max" | "auto" | "standard" | "hd" | undefined;
     background?: "auto" | "transparent" | "opaque" | undefined;
     outputFormat?: "png" | "jpeg" | "webp" | undefined;
     outputCompression?: number | undefined;
@@ -1134,7 +1134,7 @@ declare const 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: (args?: {
@@ -1150,7 +1150,7 @@ declare const openaiTools: {
         outputCompression?: number;
         outputFormat?: "png" | "jpeg" | "webp";
         partialImages?: number;
-        quality?: "auto" | "low" | "medium" | "high";
+        quality?: "auto" | "low" | "medium" | "high" | "xhigh" | "max";
         size?: "auto" | "1024x1024" | "1024x1536" | "1536x1024" | (string & {});
     }) => _ai_sdk_provider_utils.ProviderExecutedTool<{}, {
         result: string;
@@ -1629,6 +1629,13 @@ type OpenAIConfig = {
     fetch?: FetchFunction;
     webSocket?: WebSocketConstructor;
     generateId?: () => string;
+    /**
+     * Whether Responses API message input items must include an explicit
+     * `type: 'message'` discriminator.
+     *
+     * @see https://github.com/vercel/ai/issues/20180
+     */
+    explicitMessageItemType?: boolean;
     /**
      * This is soft-deprecated. Use provider references (e.g. `{ openai: 'file-abc123' }`)
      * in file part data instead. File ID prefixes used to identify file IDs

package/dist/index.js

@@ -2401,6 +2401,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-"];
@@ -2417,9 +2421,10 @@ var baseImageModelOptionsObject = z11.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: z11.enum(["standard", "hd", "low", "medium", "high", "auto"]).optional(),
+  quality: z11.enum(["standard", "hd", "low", "medium", "high", "xhigh", "max", "auto"]).optional(),
   /**
    * Background behavior for the generated image(s).
    *
@@ -2993,7 +2998,7 @@ var imageGenerationArgsSchema = lazySchema16(
       outputCompression: z17.number().int().min(0).max(100).optional(),
       outputFormat: z17.enum(["png", "jpeg", "webp"]).optional(),
       partialImages: z17.number().int().min(0).max(3).optional(),
-      quality: z17.enum(["auto", "low", "medium", "high"]).optional(),
+      quality: z17.enum(["auto", "low", "medium", "high", "xhigh", "max"]).optional(),
       size: z17.union([
         z17.enum(["1024x1024", "1024x1536", "1536x1024", "auto"]),
         z17.string().regex(/^\d+x\d+$/)
@@ -3474,7 +3479,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,
@@ -4998,6 +5003,7 @@ async function convertToOpenAIResponsesInput({
   toolNameMapping,
   systemMessageMode,
   providerOptionsName,
+  explicitMessageItemType = false,
   fileIdPrefixes,
   passThroughUnsupportedFiles = false,
   store,
@@ -5015,6 +5021,7 @@ async function convertToOpenAIResponsesInput({
   let input = [];
   const warnings = [];
   const processedApprovalIds = /* @__PURE__ */ new Set();
+  const programmaticToolCallIds = /* @__PURE__ */ new Set();
   const parallelToolResultGroups = hasConversation || hasPreviousResponseId ? collectCompleteParallelToolResultGroups({
     prompt,
     providerOptionsName
@@ -5031,6 +5038,7 @@ async function convertToOpenAIResponsesInput({
               providerOptionsName
             );
             input.push({
+              ...explicitMessageItemType && { type: "message" },
               role: "system",
               content: promptCacheBreakpoint == null ? content : [
                 {
@@ -5048,6 +5056,7 @@ async function convertToOpenAIResponsesInput({
               providerOptionsName
             );
             input.push({
+              ...explicitMessageItemType && { type: "message" },
               role: "developer",
               content: promptCacheBreakpoint == null ? content : [
                 {
@@ -5077,6 +5086,7 @@ async function convertToOpenAIResponsesInput({
       }
       case "user": {
         input.push({
+          ...explicitMessageItemType && { type: "message" },
           role: "user",
           content: content.map((part, index) => {
             var _a3, _b2, _c2, _d2, _e2;
@@ -5193,6 +5203,7 @@ async function convertToOpenAIResponsesInput({
                 break;
               }
               input.push({
+                ...explicitMessageItemType && { type: "message" },
                 role: "assistant",
                 content: [{ type: "output_text", text: part.text }],
                 id,
@@ -5233,6 +5244,9 @@ async function convertToOpenAIResponsesInput({
               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;
               const caller = (_r = (_q = part.providerOptions) == null ? void 0 : _q[providerOptionsName]) == null ? void 0 : _r.caller;
+              if ((caller == null ? void 0 : caller.type) === "program") {
+                programmaticToolCallIds.add(part.toolCallId);
+              }
               if (hasConversation && id != null) {
                 break;
               }
@@ -5884,6 +5898,12 @@ ${text}`,
             });
             continue;
           }
+          const resultCaller = (_P = (_O = part.providerOptions) == null ? void 0 : _O[providerOptionsName]) == null ? void 0 : _P.caller;
+          if (output.type === "execution-denied" && ((resultCaller == null ? void 0 : resultCaller.type) === "program" || programmaticToolCallIds.has(part.toolCallId))) {
+            throw new UnsupportedFunctionalityError4({
+              functionality: "execution-denied results for programmatic tool calls"
+            });
+          }
           const contentValue = await convertFunctionToolResultOutput({
             output,
             toolName: part.toolName,
@@ -5896,9 +5916,7 @@ ${text}`,
             providerOptionsName,
             warnings
           });
-          const caller = mapToolCaller(
-            (_P = (_O = part.providerOptions) == null ? void 0 : _O[providerOptionsName]) == null ? void 0 : _P.caller
-          );
+          const caller = mapToolCaller(resultCaller);
           input.push({
             type: "function_call_output",
             call_id: part.toolCallId,
@@ -6962,6 +6980,7 @@ var OpenAIResponsesLanguageModel = class _OpenAIResponsesLanguageModel {
       toolNameMapping,
       systemMessageMode: (_d = openaiOptions == null ? void 0 : openaiOptions.systemMessageMode) != null ? _d : isReasoningModel ? "developer" : modelCapabilities.systemMessageMode,
       providerOptionsName,
+      explicitMessageItemType: config.explicitMessageItemType,
       fileIdPrefixes: config.fileIdPrefixes,
       passThroughUnsupportedFiles: (_e = openaiOptions == null ? void 0 : openaiOptions.passThroughUnsupportedFiles) != null ? _e : false,
       store: (_f = openaiOptions == null ? void 0 : openaiOptions.store) != null ? _f : true,
@@ -7720,6 +7739,7 @@ var OpenAIResponsesLanguageModel = class _OpenAIResponsesLanguageModel {
           break;
         }
         case "apply_patch_call": {
+          hasFunctionCall = true;
           content.push({
             type: "tool-call",
             toolCallId: part.call_id,
@@ -8463,6 +8483,7 @@ var OpenAIResponsesLanguageModel = class _OpenAIResponsesLanguageModel {
                   toolCall.applyPatch.endEmitted = true;
                 }
                 if (toolCall && value.item.status === "completed") {
+                  hasFunctionCall = true;
                   controller.enqueue({
                     type: "tool-call",
                     toolCallId: toolCall.toolCallId,
@@ -11187,7 +11208,7 @@ var OpenAISkills = class {
 };
 
 // src/version.ts
-var VERSION = true ? "4.0.61" : "0.0.0-test";
+var VERSION = true ? "4.0.63" : "0.0.0-test";
 
 // src/openai-provider.ts
 function createOpenAI(options = {}) {