@ai-sdk/openai 3.0.82 → 3.0.84

package/dist/internal/index.mjs

@@ -35,7 +35,7 @@ function getOpenAILanguageModelCapabilities(modelId) {
   const supportsFlexProcessing = modelId.startsWith("o3") || modelId.startsWith("o4-mini") || modelId.startsWith("gpt-5") && !modelId.startsWith("gpt-5-chat");
   const supportsPriorityProcessing = modelId.startsWith("gpt-4") || modelId.startsWith("gpt-5") && !modelId.startsWith("gpt-5-nano") && !modelId.startsWith("gpt-5-chat") && !modelId.startsWith("gpt-5.4-nano") || modelId.startsWith("o3") || modelId.startsWith("o4-mini");
   const isReasoningModel = modelId.startsWith("o1") || modelId.startsWith("o3") || modelId.startsWith("o4-mini") || modelId.startsWith("gpt-5") && !modelId.startsWith("gpt-5-chat");
-  const supportsNonReasoningParameters = modelId.startsWith("gpt-5.1") || modelId.startsWith("gpt-5.2") || modelId.startsWith("gpt-5.3") || modelId.startsWith("gpt-5.4") || modelId.startsWith("gpt-5.5");
+  const supportsNonReasoningParameters = modelId.startsWith("gpt-5.1") || modelId.startsWith("gpt-5.2") || modelId.startsWith("gpt-5.3") || modelId.startsWith("gpt-5.4") || modelId.startsWith("gpt-5.5") || modelId.startsWith("gpt-5.6");
   const systemMessageMode = isReasoningModel ? "developer" : "system";
   return {
     supportsFlexProcessing,
@@ -171,7 +171,7 @@ function isHttpErrorStatusCode(value) {
 
 // src/chat/convert-openai-chat-usage.ts
 function convertOpenAIChatUsage(usage) {
-  var _a, _b, _c, _d, _e, _f;
+  var _a, _b, _c, _d, _e, _f, _g, _h;
   if (usage == null) {
     return {
       inputTokens: {
@@ -191,13 +191,14 @@ function convertOpenAIChatUsage(usage) {
   const promptTokens = (_a = usage.prompt_tokens) != null ? _a : 0;
   const completionTokens = (_b = usage.completion_tokens) != null ? _b : 0;
   const cachedTokens = (_d = (_c = usage.prompt_tokens_details) == null ? void 0 : _c.cached_tokens) != null ? _d : 0;
-  const reasoningTokens = (_f = (_e = usage.completion_tokens_details) == null ? void 0 : _e.reasoning_tokens) != null ? _f : 0;
+  const cacheWriteTokens = (_f = (_e = usage.prompt_tokens_details) == null ? void 0 : _e.cache_write_tokens) != null ? _f : void 0;
+  const reasoningTokens = (_h = (_g = usage.completion_tokens_details) == null ? void 0 : _g.reasoning_tokens) != null ? _h : 0;
   return {
     inputTokens: {
       total: promptTokens,
-      noCache: promptTokens - cachedTokens,
+      noCache: promptTokens - cachedTokens - (cacheWriteTokens != null ? cacheWriteTokens : 0),
       cacheRead: cachedTokens,
-      cacheWrite: void 0
+      cacheWrite: cacheWriteTokens
     },
     outputTokens: {
       total: completionTokens,
@@ -216,23 +217,47 @@ import { convertToBase64 } from "@ai-sdk/provider-utils";
 function serializeToolCallArguments(input) {
   return JSON.stringify(input === void 0 ? {} : input);
 }
+function getPromptCacheBreakpoint(providerOptions) {
+  var _a;
+  return (_a = providerOptions == null ? void 0 : providerOptions.openai) == null ? void 0 : _a.promptCacheBreakpoint;
+}
 function convertToOpenAIChatMessages({
   prompt,
   systemMessageMode = "system"
 }) {
-  var _a;
+  var _a, _b;
   const messages = [];
   const warnings = [];
-  for (const { role, content } of prompt) {
+  for (const { role, content, providerOptions } of prompt) {
     switch (role) {
       case "system": {
         switch (systemMessageMode) {
           case "system": {
-            messages.push({ role: "system", content });
+            const promptCacheBreakpoint = getPromptCacheBreakpoint(providerOptions);
+            messages.push({
+              role: "system",
+              content: promptCacheBreakpoint == null ? content : [
+                {
+                  type: "text",
+                  text: content,
+                  prompt_cache_breakpoint: promptCacheBreakpoint
+                }
+              ]
+            });
             break;
           }
           case "developer": {
-            messages.push({ role: "developer", content });
+            const promptCacheBreakpoint = getPromptCacheBreakpoint(providerOptions);
+            messages.push({
+              role: "developer",
+              content: promptCacheBreakpoint == null ? content : [
+                {
+                  type: "text",
+                  text: content,
+                  prompt_cache_breakpoint: promptCacheBreakpoint
+                }
+              ]
+            });
             break;
           }
           case "remove": {
@@ -252,19 +277,31 @@ function convertToOpenAIChatMessages({
         break;
       }
       case "user": {
-        if (content.length === 1 && content[0].type === "text") {
+        if (content.length === 1 && content[0].type === "text" && getPromptCacheBreakpoint(content[0].providerOptions) == null) {
           messages.push({ role: "user", content: content[0].text });
           break;
         }
         messages.push({
           role: "user",
           content: content.map((part, index) => {
-            var _a2, _b, _c;
+            var _a2, _b2, _c;
             switch (part.type) {
               case "text": {
-                return { type: "text", text: part.text };
+                const promptCacheBreakpoint = getPromptCacheBreakpoint(
+                  part.providerOptions
+                );
+                return {
+                  type: "text",
+                  text: part.text,
+                  ...promptCacheBreakpoint != null && {
+                    prompt_cache_breakpoint: promptCacheBreakpoint
+                  }
+                };
               }
               case "file": {
+                const promptCacheBreakpoint = getPromptCacheBreakpoint(
+                  part.providerOptions
+                );
                 if (part.mediaType.startsWith("image/")) {
                   const mediaType = part.mediaType === "image/*" ? "image/jpeg" : part.mediaType;
                   return {
@@ -272,7 +309,10 @@ function convertToOpenAIChatMessages({
                     image_url: {
                       url: part.data instanceof URL ? part.data.toString() : `data:${mediaType};base64,${convertToBase64(part.data)}`,
                       // OpenAI specific extension: image detail
-                      detail: (_b = (_a2 = part.providerOptions) == null ? void 0 : _a2.openai) == null ? void 0 : _b.imageDetail
+                      detail: (_b2 = (_a2 = part.providerOptions) == null ? void 0 : _a2.openai) == null ? void 0 : _b2.imageDetail
+                    },
+                    ...promptCacheBreakpoint != null && {
+                      prompt_cache_breakpoint: promptCacheBreakpoint
                     }
                   };
                 } else if (part.mediaType.startsWith("audio/")) {
@@ -288,6 +328,9 @@ function convertToOpenAIChatMessages({
                         input_audio: {
                           data: convertToBase64(part.data),
                           format: "wav"
+                        },
+                        ...promptCacheBreakpoint != null && {
+                          prompt_cache_breakpoint: promptCacheBreakpoint
                         }
                       };
                     }
@@ -298,6 +341,9 @@ function convertToOpenAIChatMessages({
                         input_audio: {
                           data: convertToBase64(part.data),
                           format: "mp3"
+                        },
+                        ...promptCacheBreakpoint != null && {
+                          prompt_cache_breakpoint: promptCacheBreakpoint
                         }
                       };
                     }
@@ -318,6 +364,9 @@ function convertToOpenAIChatMessages({
                     file: typeof part.data === "string" && part.data.startsWith("file-") ? { file_id: part.data } : {
                       filename: (_c = part.filename) != null ? _c : `part-${index}.pdf`,
                       file_data: `data:application/pdf;base64,${convertToBase64(part.data)}`
+                    },
+                    ...promptCacheBreakpoint != null && {
+                      prompt_cache_breakpoint: promptCacheBreakpoint
                     }
                   };
                 } else {
@@ -333,11 +382,24 @@ function convertToOpenAIChatMessages({
       }
       case "assistant": {
         let text = "";
+        const textParts = [];
+        let hasPromptCacheBreakpoint = false;
         const toolCalls = [];
         for (const part of content) {
           switch (part.type) {
             case "text": {
+              const promptCacheBreakpoint = getPromptCacheBreakpoint(
+                part.providerOptions
+              );
               text += part.text;
+              textParts.push({
+                type: "text",
+                text: part.text,
+                ...promptCacheBreakpoint != null && {
+                  prompt_cache_breakpoint: promptCacheBreakpoint
+                }
+              });
+              hasPromptCacheBreakpoint || (hasPromptCacheBreakpoint = promptCacheBreakpoint != null);
               break;
             }
             case "tool-call": {
@@ -355,7 +417,7 @@ function convertToOpenAIChatMessages({
         }
         messages.push({
           role: "assistant",
-          content: toolCalls.length > 0 ? text || null : text,
+          content: hasPromptCacheBreakpoint ? textParts : toolCalls.length > 0 ? text || null : text,
           tool_calls: toolCalls.length > 0 ? toolCalls : void 0
         });
         break;
@@ -366,6 +428,7 @@ function convertToOpenAIChatMessages({
             continue;
           }
           const output = toolResponse.output;
+          const promptCacheBreakpoint = (_a = output.type === "content" ? output.value.map((part) => getPromptCacheBreakpoint(part.providerOptions)).find((breakpoint) => breakpoint != null) : getPromptCacheBreakpoint(output.providerOptions)) != null ? _a : getPromptCacheBreakpoint(toolResponse.providerOptions);
           let contentValue;
           switch (output.type) {
             case "text":
@@ -373,7 +436,7 @@ function convertToOpenAIChatMessages({
               contentValue = output.value;
               break;
             case "execution-denied":
-              contentValue = (_a = output.reason) != null ? _a : "Tool call execution denied.";
+              contentValue = (_b = output.reason) != null ? _b : "Tool call execution denied.";
               break;
             case "content":
             case "json":
@@ -384,7 +447,13 @@ function convertToOpenAIChatMessages({
           messages.push({
             role: "tool",
             tool_call_id: toolResponse.toolCallId,
-            content: contentValue
+            content: promptCacheBreakpoint == null ? contentValue : [
+              {
+                type: "text",
+                text: contentValue,
+                prompt_cache_breakpoint: promptCacheBreakpoint
+              }
+            ]
           });
         }
         break;
@@ -490,7 +559,8 @@ var openaiChatResponseSchema = lazySchema(
         completion_tokens: z2.number().nullish(),
         total_tokens: z2.number().nullish(),
         prompt_tokens_details: z2.object({
-          cached_tokens: z2.number().nullish()
+          cached_tokens: z2.number().nullish(),
+          cache_write_tokens: z2.number().nullish()
         }).nullish(),
         completion_tokens_details: z2.object({
           reasoning_tokens: z2.number().nullish(),
@@ -559,7 +629,8 @@ var openaiChatChunkSchema = lazySchema(
           completion_tokens: z2.number().nullish(),
           total_tokens: z2.number().nullish(),
           prompt_tokens_details: z2.object({
-            cached_tokens: z2.number().nullish()
+            cached_tokens: z2.number().nullish(),
+            cache_write_tokens: z2.number().nullish()
           }).nullish(),
           completion_tokens_details: z2.object({
             reasoning_tokens: z2.number().nullish(),
@@ -611,7 +682,7 @@ var openaiLanguageModelChatOptions = lazySchema2(
       /**
        * Reasoning effort for reasoning models. Defaults to `medium`.
        */
-      reasoningEffort: z3.enum(["none", "minimal", "low", "medium", "high", "xhigh"]).optional(),
+      reasoningEffort: z3.enum(["none", "minimal", "low", "medium", "high", "xhigh", "max"]).optional(),
       /**
        * Maximum number of completion tokens to generate. Useful for reasoning models.
        */
@@ -655,11 +726,22 @@ var openaiLanguageModelChatOptions = lazySchema2(
        * Useful for improving cache hit rates and working around automatic caching issues.
        */
       promptCacheKey: z3.string().optional(),
+      /**
+       * Prompt cache behavior for GPT-5.6 and later models.
+       * `mode` controls whether OpenAI also places an implicit breakpoint.
+       * `ttl` sets the minimum cache lifetime and currently only supports 30 minutes.
+       */
+      promptCacheOptions: z3.object({
+        mode: z3.enum(["implicit", "explicit"]).optional(),
+        ttl: z3.literal("30m").optional()
+      }).optional(),
       /**
        * The retention policy for the prompt cache.
        * - 'in_memory': Default. Standard prompt caching behavior.
        * - '24h': Extended prompt caching that keeps cached prefixes active for up to 24 hours.
-       *          Currently only available for 5.1 series models.
+       *          Available for models before GPT-5.6 that support extended caching.
+       *
+       * @deprecated For GPT-5.6 and later models, use `promptCacheOptions.ttl`.
        *
        * @default 'in_memory'
        */
@@ -843,6 +925,7 @@ var OpenAIChatLanguageModel = class {
       reasoning_effort: openaiOptions.reasoningEffort,
       service_tier: openaiOptions.serviceTier,
       prompt_cache_key: openaiOptions.promptCacheKey,
+      prompt_cache_options: openaiOptions.promptCacheOptions,
       prompt_cache_retention: openaiOptions.promptCacheRetention,
       safety_identifier: openaiOptions.safetyIdentifier,
       // messages:
@@ -2600,7 +2683,7 @@ import {
 
 // src/responses/convert-openai-responses-usage.ts
 function convertOpenAIResponsesUsage(usage) {
-  var _a, _b, _c, _d;
+  var _a, _b, _c, _d, _e, _f;
   if (usage == null) {
     return {
       inputTokens: {
@@ -2620,13 +2703,14 @@ function convertOpenAIResponsesUsage(usage) {
   const inputTokens = usage.input_tokens;
   const outputTokens = usage.output_tokens;
   const cachedTokens = (_b = (_a = usage.input_tokens_details) == null ? void 0 : _a.cached_tokens) != null ? _b : 0;
-  const reasoningTokens = (_d = (_c = usage.output_tokens_details) == null ? void 0 : _c.reasoning_tokens) != null ? _d : 0;
+  const cacheWriteTokens = (_d = (_c = usage.input_tokens_details) == null ? void 0 : _c.cache_write_tokens) != null ? _d : void 0;
+  const reasoningTokens = (_f = (_e = usage.output_tokens_details) == null ? void 0 : _e.reasoning_tokens) != null ? _f : 0;
   return {
     inputTokens: {
       total: inputTokens,
-      noCache: inputTokens - cachedTokens,
+      noCache: inputTokens - cachedTokens - (cacheWriteTokens != null ? cacheWriteTokens : 0),
       cacheRead: cachedTokens,
-      cacheWrite: void 0
+      cacheWrite: cacheWriteTokens
     },
     outputTokens: {
       total: outputTokens,
@@ -2868,6 +2952,10 @@ var toolSearchToolFactory = createProviderToolFactoryWithOutputSchema4({
 function serializeToolCallArguments2(input) {
   return JSON.stringify(input === void 0 ? {} : input);
 }
+function getPromptCacheBreakpoint2(providerOptions, providerOptionsName) {
+  var _a;
+  return (_a = providerOptions == null ? void 0 : providerOptions[providerOptionsName]) == null ? void 0 : _a.promptCacheBreakpoint;
+}
 function isFileId(data, prefixes) {
   if (!prefixes) return false;
   return prefixes.some((prefix) => data.startsWith(prefix));
@@ -2891,16 +2979,42 @@ async function convertToOpenAIResponsesInput({
   let input = [];
   const warnings = [];
   const processedApprovalIds = /* @__PURE__ */ new Set();
-  for (const { role, content } of prompt) {
+  for (const { role, content, providerOptions } of prompt) {
     switch (role) {
       case "system": {
         switch (systemMessageMode) {
           case "system": {
-            input.push({ role: "system", content });
+            const promptCacheBreakpoint = getPromptCacheBreakpoint2(
+              providerOptions,
+              providerOptionsName
+            );
+            input.push({
+              role: "system",
+              content: promptCacheBreakpoint == null ? content : [
+                {
+                  type: "input_text",
+                  text: content,
+                  prompt_cache_breakpoint: promptCacheBreakpoint
+                }
+              ]
+            });
             break;
           }
           case "developer": {
-            input.push({ role: "developer", content });
+            const promptCacheBreakpoint = getPromptCacheBreakpoint2(
+              providerOptions,
+              providerOptionsName
+            );
+            input.push({
+              role: "developer",
+              content: promptCacheBreakpoint == null ? content : [
+                {
+                  type: "input_text",
+                  text: content,
+                  prompt_cache_breakpoint: promptCacheBreakpoint
+                }
+              ]
+            });
             break;
           }
           case "remove": {
@@ -2926,9 +3040,23 @@ async function convertToOpenAIResponsesInput({
             var _a2, _b2, _c2;
             switch (part.type) {
               case "text": {
-                return { type: "input_text", text: part.text };
+                const promptCacheBreakpoint = getPromptCacheBreakpoint2(
+                  part.providerOptions,
+                  providerOptionsName
+                );
+                return {
+                  type: "input_text",
+                  text: part.text,
+                  ...promptCacheBreakpoint != null && {
+                    prompt_cache_breakpoint: promptCacheBreakpoint
+                  }
+                };
               }
               case "file": {
+                const promptCacheBreakpoint = getPromptCacheBreakpoint2(
+                  part.providerOptions,
+                  providerOptionsName
+                );
                 const mediaType = part.mediaType === "image/*" ? "image/jpeg" : part.mediaType;
                 if (mediaType.startsWith("image/")) {
                   return {
@@ -2936,13 +3064,19 @@ async function convertToOpenAIResponsesInput({
                     ...part.data instanceof URL ? { image_url: part.data.toString() } : typeof part.data === "string" && isFileId(part.data, fileIdPrefixes) ? { file_id: part.data } : {
                       image_url: `data:${mediaType};base64,${convertToBase642(part.data)}`
                     },
-                    detail: (_b2 = (_a2 = part.providerOptions) == null ? void 0 : _a2[providerOptionsName]) == null ? void 0 : _b2.imageDetail
+                    detail: (_b2 = (_a2 = part.providerOptions) == null ? void 0 : _a2[providerOptionsName]) == null ? void 0 : _b2.imageDetail,
+                    ...promptCacheBreakpoint != null && {
+                      prompt_cache_breakpoint: promptCacheBreakpoint
+                    }
                   };
                 }
                 if (part.data instanceof URL) {
                   return {
                     type: "input_file",
-                    file_url: part.data.toString()
+                    file_url: part.data.toString(),
+                    ...promptCacheBreakpoint != null && {
+                      prompt_cache_breakpoint: promptCacheBreakpoint
+                    }
                   };
                 }
                 if (mediaType !== "application/pdf" && !passThroughUnsupportedFiles) {
@@ -2955,6 +3089,9 @@ async function convertToOpenAIResponsesInput({
                   ...typeof part.data === "string" && isFileId(part.data, fileIdPrefixes) ? { file_id: part.data } : {
                     filename: (_c2 = part.filename) != null ? _c2 : mediaType === "application/pdf" ? `part-${index}.pdf` : `part-${index}`,
                     file_data: `data:${mediaType};base64,${convertToBase642(part.data)}`
+                  },
+                  ...promptCacheBreakpoint != null && {
+                    prompt_cache_breakpoint: promptCacheBreakpoint
                   }
                 };
               }
@@ -3167,12 +3304,12 @@ async function convertToOpenAIResponsesInput({
               break;
             }
             case "reasoning": {
-              const providerOptions = await parseProviderOptions7({
+              const providerOptions2 = await parseProviderOptions7({
                 provider: providerOptionsName,
                 providerOptions: part.providerOptions,
                 schema: openaiResponsesReasoningProviderOptionsSchema
               });
-              const reasoningId = providerOptions == null ? void 0 : providerOptions.itemId;
+              const reasoningId = providerOptions2 == null ? void 0 : providerOptions2.itemId;
               if ((hasConversation || hasPreviousResponseId) && reasoningId != null) {
                 break;
               }
@@ -3204,19 +3341,19 @@ async function convertToOpenAIResponsesInput({
                     reasoningMessages[reasoningId] = {
                       type: "reasoning",
                       id: reasoningId,
-                      encrypted_content: providerOptions == null ? void 0 : providerOptions.reasoningEncryptedContent,
+                      encrypted_content: providerOptions2 == null ? void 0 : providerOptions2.reasoningEncryptedContent,
                       summary: summaryParts
                     };
                     input.push(reasoningMessages[reasoningId]);
                   } else {
                     reasoningMessage.summary.push(...summaryParts);
-                    if ((providerOptions == null ? void 0 : providerOptions.reasoningEncryptedContent) != null) {
-                      reasoningMessage.encrypted_content = providerOptions.reasoningEncryptedContent;
+                    if ((providerOptions2 == null ? void 0 : providerOptions2.reasoningEncryptedContent) != null) {
+                      reasoningMessage.encrypted_content = providerOptions2.reasoningEncryptedContent;
                     }
                   }
                 }
               } else {
-                const encryptedContent = providerOptions == null ? void 0 : providerOptions.reasoningEncryptedContent;
+                const encryptedContent = providerOptions2 == null ? void 0 : providerOptions2.reasoningEncryptedContent;
                 if (encryptedContent != null) {
                   const summaryParts = [];
                   if (part.text.length > 0) {
@@ -3349,31 +3486,53 @@ async function convertToOpenAIResponsesInput({
               case "content":
                 outputValue = output.value.map((item) => {
                   var _a2, _b2, _c2, _d2, _e2;
+                  const promptCacheBreakpoint = getPromptCacheBreakpoint2(
+                    item.providerOptions,
+                    providerOptionsName
+                  );
                   switch (item.type) {
                     case "text":
-                      return { type: "input_text", text: item.text };
+                      return {
+                        type: "input_text",
+                        text: item.text,
+                        ...promptCacheBreakpoint != null && {
+                          prompt_cache_breakpoint: promptCacheBreakpoint
+                        }
+                      };
                     case "image-data":
                       return {
                         type: "input_image",
                         image_url: `data:${item.mediaType};base64,${item.data}`,
-                        detail: (_b2 = (_a2 = item.providerOptions) == null ? void 0 : _a2[providerOptionsName]) == null ? void 0 : _b2.imageDetail
+                        detail: (_b2 = (_a2 = item.providerOptions) == null ? void 0 : _a2[providerOptionsName]) == null ? void 0 : _b2.imageDetail,
+                        ...promptCacheBreakpoint != null && {
+                          prompt_cache_breakpoint: promptCacheBreakpoint
+                        }
                       };
                     case "image-url":
                       return {
                         type: "input_image",
                         image_url: item.url,
-                        detail: (_d2 = (_c2 = item.providerOptions) == null ? void 0 : _c2[providerOptionsName]) == null ? void 0 : _d2.imageDetail
+                        detail: (_d2 = (_c2 = item.providerOptions) == null ? void 0 : _c2[providerOptionsName]) == null ? void 0 : _d2.imageDetail,
+                        ...promptCacheBreakpoint != null && {
+                          prompt_cache_breakpoint: promptCacheBreakpoint
+                        }
                       };
                     case "file-data":
                       return {
                         type: "input_file",
                         filename: (_e2 = item.filename) != null ? _e2 : "data",
-                        file_data: `data:${item.mediaType};base64,${item.data}`
+                        file_data: `data:${item.mediaType};base64,${item.data}`,
+                        ...promptCacheBreakpoint != null && {
+                          prompt_cache_breakpoint: promptCacheBreakpoint
+                        }
                       };
                     case "file-url":
                       return {
                         type: "input_file",
-                        file_url: item.url
+                        file_url: item.url,
+                        ...promptCacheBreakpoint != null && {
+                          prompt_cache_breakpoint: promptCacheBreakpoint
+                        }
                       };
                     default:
                       warnings.push({
@@ -3410,35 +3569,57 @@ async function convertToOpenAIResponsesInput({
             case "content":
               contentValue = output.value.map((item) => {
                 var _a2, _b2, _c2, _d2, _e2;
+                const promptCacheBreakpoint = getPromptCacheBreakpoint2(
+                  item.providerOptions,
+                  providerOptionsName
+                );
                 switch (item.type) {
                   case "text": {
-                    return { type: "input_text", text: item.text };
+                    return {
+                      type: "input_text",
+                      text: item.text,
+                      ...promptCacheBreakpoint != null && {
+                        prompt_cache_breakpoint: promptCacheBreakpoint
+                      }
+                    };
                   }
                   case "image-data": {
                     return {
                       type: "input_image",
                       image_url: `data:${item.mediaType};base64,${item.data}`,
-                      detail: (_b2 = (_a2 = item.providerOptions) == null ? void 0 : _a2[providerOptionsName]) == null ? void 0 : _b2.imageDetail
+                      detail: (_b2 = (_a2 = item.providerOptions) == null ? void 0 : _a2[providerOptionsName]) == null ? void 0 : _b2.imageDetail,
+                      ...promptCacheBreakpoint != null && {
+                        prompt_cache_breakpoint: promptCacheBreakpoint
+                      }
                     };
                   }
                   case "image-url": {
                     return {
                       type: "input_image",
                       image_url: item.url,
-                      detail: (_d2 = (_c2 = item.providerOptions) == null ? void 0 : _c2[providerOptionsName]) == null ? void 0 : _d2.imageDetail
+                      detail: (_d2 = (_c2 = item.providerOptions) == null ? void 0 : _c2[providerOptionsName]) == null ? void 0 : _d2.imageDetail,
+                      ...promptCacheBreakpoint != null && {
+                        prompt_cache_breakpoint: promptCacheBreakpoint
+                      }
                     };
                   }
                   case "file-data": {
                     return {
                       type: "input_file",
                       filename: (_e2 = item.filename) != null ? _e2 : "data",
-                      file_data: `data:${item.mediaType};base64,${item.data}`
+                      file_data: `data:${item.mediaType};base64,${item.data}`,
+                      ...promptCacheBreakpoint != null && {
+                        prompt_cache_breakpoint: promptCacheBreakpoint
+                      }
                     };
                   }
                   case "file-url": {
                     return {
                       type: "input_file",
-                      file_url: item.url
+                      file_url: item.url,
+                      ...promptCacheBreakpoint != null && {
+                        prompt_cache_breakpoint: promptCacheBreakpoint
+                      }
                     };
                   }
                   default: {
@@ -3563,6 +3744,7 @@ var openaiResponsesChunkSchema = lazySchema16(
             input_tokens: z18.number(),
             input_tokens_details: z18.object({
               cached_tokens: z18.number().nullish(),
+              cache_write_tokens: z18.number().nullish(),
               orchestration_input_tokens: z18.number().nullish(),
               orchestration_input_cached_tokens: z18.number().nullish()
             }).nullish(),
@@ -3572,6 +3754,9 @@ var openaiResponsesChunkSchema = lazySchema16(
               orchestration_output_tokens: z18.number().nullish()
             }).nullish()
           }),
+          reasoning: z18.object({
+            context: z18.string().nullish()
+          }).nullish(),
           service_tier: z18.string().nullish()
         })
       }),
@@ -3588,6 +3773,7 @@ var openaiResponsesChunkSchema = lazySchema16(
             input_tokens: z18.number(),
             input_tokens_details: z18.object({
               cached_tokens: z18.number().nullish(),
+              cache_write_tokens: z18.number().nullish(),
               orchestration_input_tokens: z18.number().nullish(),
               orchestration_input_cached_tokens: z18.number().nullish()
             }).nullish(),
@@ -3597,6 +3783,9 @@ var openaiResponsesChunkSchema = lazySchema16(
               orchestration_output_tokens: z18.number().nullish()
             }).nullish()
           }).nullish(),
+          reasoning: z18.object({
+            context: z18.string().nullish()
+          }).nullish(),
           service_tier: z18.string().nullish()
         })
       }),
@@ -4368,11 +4557,15 @@ var openaiResponsesResponseSchema = lazySchema16(
         ])
       ).optional(),
       service_tier: z18.string().nullish(),
+      reasoning: z18.object({
+        context: z18.string().nullish()
+      }).nullish(),
       incomplete_details: z18.object({ reason: z18.string() }).nullish(),
       usage: z18.object({
         input_tokens: z18.number(),
         input_tokens_details: z18.object({
           cached_tokens: z18.number().nullish(),
+          cache_write_tokens: z18.number().nullish(),
           orchestration_input_tokens: z18.number().nullish(),
           orchestration_input_cached_tokens: z18.number().nullish()
         }).nullish(),
@@ -4431,7 +4624,11 @@ var openaiResponsesReasoningModelIds = [
   "gpt-5.4-pro",
   "gpt-5.4-pro-2026-03-05",
   "gpt-5.5",
-  "gpt-5.5-2026-04-23"
+  "gpt-5.5-2026-04-23",
+  "gpt-5.6",
+  "gpt-5.6-luna",
+  "gpt-5.6-sol",
+  "gpt-5.6-terra"
 ];
 var openaiResponsesModelIds = [
   "gpt-4.1",
@@ -4526,11 +4723,22 @@ var openaiLanguageModelResponsesOptionsSchema = lazySchema17(
        * Sets a cache key to tie this prompt to cached prefixes for better caching performance.
        */
       promptCacheKey: z19.string().nullish(),
+      /**
+       * Prompt cache behavior for GPT-5.6 and later models.
+       * `mode` controls whether OpenAI also places an implicit breakpoint.
+       * `ttl` sets the minimum cache lifetime and currently only supports 30 minutes.
+       */
+      promptCacheOptions: z19.object({
+        mode: z19.enum(["implicit", "explicit"]).optional(),
+        ttl: z19.literal("30m").optional()
+      }).optional(),
       /**
        * The retention policy for the prompt cache.
        * - 'in_memory': Default. Standard prompt caching behavior.
        * - '24h': Extended prompt caching that keeps cached prefixes active for up to 24 hours.
-       *          Currently only available for 5.1 series models.
+       *          Available for models before GPT-5.6 that support extended caching.
+       *
+       * @deprecated For GPT-5.6 and later models, use `promptCacheOptions.ttl`.
        *
        * @default 'in_memory'
        */
@@ -4538,14 +4746,21 @@ var openaiLanguageModelResponsesOptionsSchema = lazySchema17(
       /**
        * Reasoning effort for reasoning models. Defaults to `medium`. If you use
        * `providerOptions` to set the `reasoningEffort` option, this model setting will be ignored.
-       * Valid values: 'none' | 'minimal' | 'low' | 'medium' | 'high' | 'xhigh'
-       *
-       * The 'none' type for `reasoningEffort` is only available for OpenAI's GPT-5.1
-       * models. Also, the 'xhigh' type for `reasoningEffort` is only available for
-       * OpenAI's GPT-5.1-Codex-Max model. Setting `reasoningEffort` to 'none' or 'xhigh' with unsupported models will result in
-       * an error.
+       * GPT-5.6 supports 'none' | 'low' | 'medium' | 'high' | 'xhigh' | 'max'.
+       * Supported values vary by model.
        */
       reasoningEffort: z19.string().nullish(),
+      /**
+       * Controls how much model work GPT-5.6 performs before returning a final answer.
+       * `standard` is the default. `pro` increases quality, latency, and token usage.
+       */
+      reasoningMode: z19.enum(["standard", "pro"]).optional(),
+      /**
+       * Controls which available reasoning items GPT-5.6 can use.
+       * `auto` uses the model default, `current_turn` excludes reasoning from earlier
+       * turns, and `all_turns` makes compatible earlier reasoning available.
+       */
+      reasoningContext: z19.enum(["auto", "current_turn", "all_turns"]).optional(),
       /**
        * Controls reasoning summary output from the model.
        * Set to "auto" to automatically receive the richest level available,
@@ -5498,18 +5713,25 @@ var OpenAIResponsesLanguageModel = class {
       service_tier: openaiOptions == null ? void 0 : openaiOptions.serviceTier,
       include,
       prompt_cache_key: openaiOptions == null ? void 0 : openaiOptions.promptCacheKey,
+      prompt_cache_options: openaiOptions == null ? void 0 : openaiOptions.promptCacheOptions,
       prompt_cache_retention: openaiOptions == null ? void 0 : openaiOptions.promptCacheRetention,
       safety_identifier: openaiOptions == null ? void 0 : openaiOptions.safetyIdentifier,
       top_logprobs: topLogprobs,
       truncation: openaiOptions == null ? void 0 : openaiOptions.truncation,
       // model-specific settings:
-      ...isReasoningModel && ((openaiOptions == null ? void 0 : openaiOptions.reasoningEffort) != null || (openaiOptions == null ? void 0 : openaiOptions.reasoningSummary) != null) && {
+      ...isReasoningModel && ((openaiOptions == null ? void 0 : openaiOptions.reasoningEffort) != null || (openaiOptions == null ? void 0 : openaiOptions.reasoningSummary) != null || (openaiOptions == null ? void 0 : openaiOptions.reasoningMode) != null || (openaiOptions == null ? void 0 : openaiOptions.reasoningContext) != null) && {
         reasoning: {
           ...(openaiOptions == null ? void 0 : openaiOptions.reasoningEffort) != null && {
             effort: openaiOptions.reasoningEffort
           },
           ...(openaiOptions == null ? void 0 : openaiOptions.reasoningSummary) != null && {
             summary: openaiOptions.reasoningSummary
+          },
+          ...(openaiOptions == null ? void 0 : openaiOptions.reasoningMode) != null && {
+            mode: openaiOptions.reasoningMode
+          },
+          ...(openaiOptions == null ? void 0 : openaiOptions.reasoningContext) != null && {
+            context: openaiOptions.reasoningContext
           }
         }
       }
@@ -5548,6 +5770,20 @@ var OpenAIResponsesLanguageModel = class {
           details: "reasoningSummary is not supported for non-reasoning models"
         });
       }
+      if ((openaiOptions == null ? void 0 : openaiOptions.reasoningMode) != null) {
+        warnings.push({
+          type: "unsupported",
+          feature: "reasoningMode",
+          details: "reasoningMode is not supported for non-reasoning models"
+        });
+      }
+      if ((openaiOptions == null ? void 0 : openaiOptions.reasoningContext) != null) {
+        warnings.push({
+          type: "unsupported",
+          feature: "reasoningContext",
+          details: "reasoningContext is not supported for non-reasoning models"
+        });
+      }
     }
     if ((openaiOptions == null ? void 0 : openaiOptions.serviceTier) === "flex" && !modelCapabilities.supportsFlexProcessing) {
       warnings.push({
@@ -5584,7 +5820,7 @@ var OpenAIResponsesLanguageModel = class {
     };
   }
   async doGenerate(options) {
-    var _a, _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;
+    var _a, _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;
     const {
       args: body,
       warnings,
@@ -6033,7 +6269,8 @@ var OpenAIResponsesLanguageModel = class {
       [providerOptionsName]: {
         responseId: response.id,
         ...logprobs.length > 0 ? { logprobs } : {},
-        ...typeof response.service_tier === "string" ? { serviceTier: response.service_tier } : {}
+        ...typeof response.service_tier === "string" ? { serviceTier: response.service_tier } : {},
+        ...((_z = response.reasoning) == null ? void 0 : _z.context) != null ? { reasoningContext: response.reasoning.context } : {}
       }
     };
     const usage = response.usage;
@@ -6041,10 +6278,10 @@ var OpenAIResponsesLanguageModel = class {
       content,
       finishReason: {
         unified: mapOpenAIResponseFinishReason({
-          finishReason: (_z = response.incomplete_details) == null ? void 0 : _z.reason,
+          finishReason: (_A = response.incomplete_details) == null ? void 0 : _A.reason,
           hasFunctionCall
         }),
-        raw: (_B = (_A = response.incomplete_details) == null ? void 0 : _A.reason) != null ? _B : void 0
+        raw: (_C = (_B = response.incomplete_details) == null ? void 0 : _B.reason) != null ? _C : void 0
       },
       usage: convertOpenAIResponsesUsage(usage),
       request: { body },
@@ -6111,6 +6348,7 @@ var OpenAIResponsesLanguageModel = class {
     let hasFunctionCall = false;
     const activeReasoning = {};
     let serviceTier;
+    let reasoningContext;
     const hostedToolSearchCallIds = [];
     let encounteredStreamError = false;
     const result = {
@@ -6120,7 +6358,7 @@ var OpenAIResponsesLanguageModel = class {
             controller.enqueue({ type: "stream-start", warnings });
           },
           transform(chunk, controller) {
-            var _a, _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, _E, _F, _G, _H, _I, _J, _K, _L;
+            var _a, _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, _E, _F, _G, _H, _I, _J, _K, _L, _M, _N;
             if (options.includeRawChunks) {
               controller.enqueue({ type: "raw", rawValue: chunk.rawValue });
             }
@@ -6862,8 +7100,11 @@ var OpenAIResponsesLanguageModel = class {
               if (typeof value.response.service_tier === "string") {
                 serviceTier = value.response.service_tier;
               }
+              if (((_y = value.response.reasoning) == null ? void 0 : _y.context) != null) {
+                reasoningContext = value.response.reasoning.context;
+              }
             } else if (isResponseFailedChunk(value)) {
-              const incompleteReason = (_y = value.response.incomplete_details) == null ? void 0 : _y.reason;
+              const incompleteReason = (_z = value.response.incomplete_details) == null ? void 0 : _z.reason;
               finishReason = {
                 unified: incompleteReason ? mapOpenAIResponseFinishReason({
                   finishReason: incompleteReason,
@@ -6871,7 +7112,10 @@ var OpenAIResponsesLanguageModel = class {
                 }) : "error",
                 raw: incompleteReason != null ? incompleteReason : "error"
               };
-              usage = (_z = value.response.usage) != null ? _z : void 0;
+              usage = (_A = value.response.usage) != null ? _A : void 0;
+              if (((_B = value.response.reasoning) == null ? void 0 : _B.context) != null) {
+                reasoningContext = value.response.reasoning.context;
+              }
               if (!encounteredStreamError && value.response.error != null) {
                 encounteredStreamError = true;
                 controller.enqueue({
@@ -6893,7 +7137,7 @@ var OpenAIResponsesLanguageModel = class {
                 controller.enqueue({
                   type: "source",
                   sourceType: "url",
-                  id: (_C = (_B = (_A = self.config).generateId) == null ? void 0 : _B.call(_A)) != null ? _C : generateId2(),
+                  id: (_E = (_D = (_C = self.config).generateId) == null ? void 0 : _D.call(_C)) != null ? _E : generateId2(),
                   url: value.annotation.url,
                   title: value.annotation.title
                 });
@@ -6901,7 +7145,7 @@ var OpenAIResponsesLanguageModel = class {
                 controller.enqueue({
                   type: "source",
                   sourceType: "document",
-                  id: (_F = (_E = (_D = self.config).generateId) == null ? void 0 : _E.call(_D)) != null ? _F : generateId2(),
+                  id: (_H = (_G = (_F = self.config).generateId) == null ? void 0 : _G.call(_F)) != null ? _H : generateId2(),
                   mediaType: "text/plain",
                   title: value.annotation.filename,
                   filename: value.annotation.filename,
@@ -6917,7 +7161,7 @@ var OpenAIResponsesLanguageModel = class {
                 controller.enqueue({
                   type: "source",
                   sourceType: "document",
-                  id: (_I = (_H = (_G = self.config).generateId) == null ? void 0 : _H.call(_G)) != null ? _I : generateId2(),
+                  id: (_K = (_J = (_I = self.config).generateId) == null ? void 0 : _J.call(_I)) != null ? _K : generateId2(),
                   mediaType: "text/plain",
                   title: value.annotation.filename,
                   filename: value.annotation.filename,
@@ -6933,7 +7177,7 @@ var OpenAIResponsesLanguageModel = class {
                 controller.enqueue({
                   type: "source",
                   sourceType: "document",
-                  id: (_L = (_K = (_J = self.config).generateId) == null ? void 0 : _K.call(_J)) != null ? _L : generateId2(),
+                  id: (_N = (_M = (_L = self.config).generateId) == null ? void 0 : _M.call(_L)) != null ? _N : generateId2(),
                   mediaType: "application/octet-stream",
                   title: value.annotation.file_id,
                   filename: value.annotation.file_id,
@@ -6957,7 +7201,8 @@ var OpenAIResponsesLanguageModel = class {
               [providerOptionsName]: {
                 responseId,
                 ...logprobs.length > 0 ? { logprobs } : {},
-                ...serviceTier !== void 0 ? { serviceTier } : {}
+                ...serviceTier !== void 0 ? { serviceTier } : {},
+                ...reasoningContext !== void 0 ? { reasoningContext } : {}
               }
             };
             controller.enqueue({