@ai-sdk/openai 4.0.61 → 4.0.63

package/dist/internal/index.d.ts

@@ -116,6 +116,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
@@ -155,12 +162,12 @@ declare class OpenAIEmbeddingModel implements EmbeddingModelV4 {
     doEmbed({ values, headers, abortSignal, providerOptions, }: Parameters<EmbeddingModelV4['doEmbed']>[0]): Promise<Awaited<ReturnType<EmbeddingModelV4['doEmbed']>>>;
 }
 
-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 modelMaxImagesPerCall: Record<OpenAIImageModelId, number>;
 declare function hasDefaultResponseFormat(modelId: string): boolean;
 declare function getMaxImagesPerCall(modelId: OpenAIImageModelId): number;
 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;
@@ -168,7 +175,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;
@@ -178,7 +185,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;
@@ -422,6 +429,7 @@ type OpenAIResponsesInputItem = OpenAIResponsesSystemMessage | OpenAIResponsesUs
 type OpenAIResponsesIncludeValue = 'web_search_call.action.sources' | 'web_search_call.results' | 'code_interpreter_call.outputs' | 'computer_call_output.output.image_url' | 'file_search_call.results' | 'message.input_image.image_url' | 'message.output_text.logprobs' | 'reasoning.encrypted_content';
 type OpenAIResponsesIncludeOptions = Array<OpenAIResponsesIncludeValue> | undefined | null;
 type OpenAIResponsesSystemMessage = {
+    type?: 'message';
     role: 'system' | 'developer';
     content: string | Array<{
         type: 'input_text';
@@ -432,6 +440,7 @@ type OpenAIResponsesSystemMessage = {
     }>;
 };
 type OpenAIResponsesUserMessage = {
+    type?: 'message';
     role: 'user';
     content: Array<{
         type: 'input_text';
@@ -473,6 +482,7 @@ type OpenAIResponsesUserMessage = {
     }>;
 };
 type OpenAIResponsesAssistantMessage = {
+    type?: 'message';
     role: 'assistant';
     content: Array<{
         type: 'output_text';
@@ -791,7 +801,7 @@ type OpenAIResponsesTool = OpenAIResponsesFunctionTool | {
     output_compression: number | undefined;
     output_format: 'png' | 'jpeg' | 'webp' | undefined;
     partial_images: number | undefined;
-    quality: 'auto' | 'low' | 'medium' | 'high' | undefined;
+    quality: 'auto' | 'low' | 'medium' | 'high' | 'xhigh' | 'max' | undefined;
     size: 'auto' | '1024x1024' | '1024x1536' | '1536x1024' | (string & {}) | undefined;
 }
 /**
@@ -2315,7 +2325,7 @@ declare const imageGenerationArgsSchema: _ai_sdk_provider_utils.LazySchema<{
     outputCompression?: number | undefined;
     outputFormat?: "png" | "jpeg" | "webp" | undefined;
     partialImages?: number | undefined;
-    quality?: "low" | "medium" | "high" | "auto" | undefined;
+    quality?: "low" | "medium" | "high" | "xhigh" | "max" | "auto" | undefined;
     size?: string | undefined;
 }>;
 declare const imageGenerationOutputSchema: _ai_sdk_provider_utils.LazySchema<{
@@ -2371,13 +2381,15 @@ type ImageGenerationArgs = {
     partialImages?: number;
     /**
      * The quality of the generated image.
-     * One of low, medium, high, or auto. Default: auto.
+     * One of low, medium, high, xhigh, max, or auto. Default: auto.
+     * xhigh and max are supported by GPT Image 2.5 models.
      */
-    quality?: 'auto' | 'low' | 'medium' | 'high';
+    quality?: 'auto' | 'low' | 'medium' | 'high' | 'xhigh' | 'max';
     /**
      * The size of the generated image.
-     * One of 1024x1024, 1024x1536, 1536x1024, or auto. gpt-image-2 also accepts
-     * arbitrary WIDTHxHEIGHT sizes where both are divisible by 16, e.g. 1536x864.
+     * One of 1024x1024, 1024x1536, 1536x1024, or auto. GPT Image 2 and 2.5
+     * models also accept arbitrary WIDTHxHEIGHT sizes where both are divisible
+     * by 16, e.g. 1536x864.
      * Default: auto.
      */
     size?: 'auto' | '1024x1024' | '1024x1536' | '1536x1024' | (string & {});

package/dist/internal/index.js

@@ -2114,6 +2114,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-"];
@@ -2130,9 +2134,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).
    *
@@ -3861,6 +3866,7 @@ async function convertToOpenAIResponsesInput({
   toolNameMapping,
   systemMessageMode,
   providerOptionsName,
+  explicitMessageItemType = false,
   fileIdPrefixes,
   passThroughUnsupportedFiles = false,
   store,
@@ -3878,6 +3884,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
@@ -3894,6 +3901,7 @@ async function convertToOpenAIResponsesInput({
               providerOptionsName
             );
             input.push({
+              ...explicitMessageItemType && { type: "message" },
               role: "system",
               content: promptCacheBreakpoint == null ? content : [
                 {
@@ -3911,6 +3919,7 @@ async function convertToOpenAIResponsesInput({
               providerOptionsName
             );
             input.push({
+              ...explicitMessageItemType && { type: "message" },
               role: "developer",
               content: promptCacheBreakpoint == null ? content : [
                 {
@@ -3940,6 +3949,7 @@ async function convertToOpenAIResponsesInput({
       }
       case "user": {
         input.push({
+          ...explicitMessageItemType && { type: "message" },
           role: "user",
           content: content.map((part, index) => {
             var _a3, _b2, _c2, _d2, _e2;
@@ -4056,6 +4066,7 @@ async function convertToOpenAIResponsesInput({
                 break;
               }
               input.push({
+                ...explicitMessageItemType && { type: "message" },
                 role: "assistant",
                 content: [{ type: "output_text", text: part.text }],
                 id,
@@ -4096,6 +4107,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;
               }
@@ -4747,6 +4761,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 UnsupportedFunctionalityError5({
+              functionality: "execution-denied results for programmatic tool calls"
+            });
+          }
           const contentValue = await convertFunctionToolResultOutput({
             output,
             toolName: part.toolName,
@@ -4759,9 +4779,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,
@@ -6298,7 +6316,7 @@ var imageGenerationArgsSchema = lazySchema22(
       outputCompression: z24.number().int().min(0).max(100).optional(),
       outputFormat: z24.enum(["png", "jpeg", "webp"]).optional(),
       partialImages: z24.number().int().min(0).max(3).optional(),
-      quality: z24.enum(["auto", "low", "medium", "high"]).optional(),
+      quality: z24.enum(["auto", "low", "medium", "high", "xhigh", "max"]).optional(),
       size: z24.union([
         z24.enum(["1024x1024", "1024x1536", "1536x1024", "auto"]),
         z24.string().regex(/^\d+x\d+$/)
@@ -7254,6 +7272,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,
@@ -8012,6 +8031,7 @@ var OpenAIResponsesLanguageModel = class _OpenAIResponsesLanguageModel {
           break;
         }
         case "apply_patch_call": {
+          hasFunctionCall = true;
           content.push({
             type: "tool-call",
             toolCallId: part.call_id,
@@ -8755,6 +8775,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,