@ai-sdk/openai 4.0.10 → 4.0.11

package/dist/index.js

@@ -181,7 +181,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: {
@@ -201,13 +201,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,
@@ -231,23 +232,47 @@ import {
 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": {
@@ -267,19 +292,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
+                );
                 switch (part.data.type) {
                   case "reference": {
                     return {
@@ -289,6 +326,9 @@ function convertToOpenAIChatMessages({
                           reference: part.data.reference,
                           provider: "openai"
                         })
+                      },
+                      ...promptCacheBreakpoint != null && {
+                        prompt_cache_breakpoint: promptCacheBreakpoint
                       }
                     };
                   }
@@ -305,7 +345,10 @@ function convertToOpenAIChatMessages({
                         type: "image_url",
                         image_url: {
                           url: part.data.type === "url" ? part.data.url.toString() : `data:${resolveFullMediaType({ part })};base64,${convertToBase64(part.data.data)}`,
-                          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 (topLevel === "audio") {
@@ -322,6 +365,9 @@ function convertToOpenAIChatMessages({
                             input_audio: {
                               data: convertToBase64(part.data.data),
                               format: "wav"
+                            },
+                            ...promptCacheBreakpoint != null && {
+                              prompt_cache_breakpoint: promptCacheBreakpoint
                             }
                           };
                         }
@@ -332,6 +378,9 @@ function convertToOpenAIChatMessages({
                             input_audio: {
                               data: convertToBase64(part.data.data),
                               format: "mp3"
+                            },
+                            ...promptCacheBreakpoint != null && {
+                              prompt_cache_breakpoint: promptCacheBreakpoint
                             }
                           };
                         }
@@ -359,6 +408,9 @@ function convertToOpenAIChatMessages({
                         file: {
                           filename: (_c = part.filename) != null ? _c : `part-${index}.pdf`,
                           file_data: `data:application/pdf;base64,${convertToBase64(part.data.data)}`
+                        },
+                        ...promptCacheBreakpoint != null && {
+                          prompt_cache_breakpoint: promptCacheBreakpoint
                         }
                       };
                     }
@@ -372,11 +424,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": {
@@ -394,7 +459,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;
@@ -405,6 +470,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":
@@ -412,7 +478,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":
@@ -423,7 +489,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;
@@ -529,7 +601,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(),
@@ -598,7 +671,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(),
@@ -650,7 +724,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.
        */
@@ -694,11 +768,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'
        */
@@ -893,6 +978,7 @@ var OpenAIChatLanguageModel = class _OpenAIChatLanguageModel {
       reasoning_effort: resolvedReasoningEffort,
       service_tier: openaiOptions.serviceTier,
       prompt_cache_key: openaiOptions.promptCacheKey,
+      prompt_cache_options: openaiOptions.promptCacheOptions,
       prompt_cache_retention: openaiOptions.promptCacheRetention,
       safety_identifier: openaiOptions.safetyIdentifier,
       // messages:
@@ -3433,7 +3519,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: {
@@ -3453,13 +3539,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,
@@ -3488,6 +3575,10 @@ import { z as z23 } from "zod/v4";
 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));
@@ -3511,16 +3602,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": {
@@ -3546,9 +3663,23 @@ async function convertToOpenAIResponsesInput({
             var _a2, _b2, _c2, _d2, _e2;
             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
+                );
                 switch (part.data.type) {
                   case "reference": {
                     const fileId = resolveProviderReference2({
@@ -3559,12 +3690,18 @@ async function convertToOpenAIResponsesInput({
                       return {
                         type: "input_image",
                         file_id: fileId,
-                        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
+                        }
                       };
                     }
                     return {
                       type: "input_file",
-                      file_id: fileId
+                      file_id: fileId,
+                      ...promptCacheBreakpoint != null && {
+                        prompt_cache_breakpoint: promptCacheBreakpoint
+                      }
                     };
                   }
                   case "text": {
@@ -3581,13 +3718,19 @@ async function convertToOpenAIResponsesInput({
                         ...part.data.type === "url" ? { image_url: part.data.url.toString() } : typeof part.data.data === "string" && isFileId(part.data.data, fileIdPrefixes) ? { file_id: part.data.data } : {
                           image_url: `data:${resolveFullMediaType2({ part })};base64,${convertToBase642(part.data.data)}`
                         },
-                        detail: (_d2 = (_c2 = part.providerOptions) == null ? void 0 : _c2[providerOptionsName]) == null ? void 0 : _d2.imageDetail
+                        detail: (_d2 = (_c2 = part.providerOptions) == null ? void 0 : _c2[providerOptionsName]) == null ? void 0 : _d2.imageDetail,
+                        ...promptCacheBreakpoint != null && {
+                          prompt_cache_breakpoint: promptCacheBreakpoint
+                        }
                       };
                     } else {
                       if (part.data.type === "url") {
                         return {
                           type: "input_file",
-                          file_url: part.data.url.toString()
+                          file_url: part.data.url.toString(),
+                          ...promptCacheBreakpoint != null && {
+                            prompt_cache_breakpoint: promptCacheBreakpoint
+                          }
                         };
                       }
                       const fullMediaType = resolveFullMediaType2({ part });
@@ -3601,6 +3744,9 @@ async function convertToOpenAIResponsesInput({
                         ...typeof part.data.data === "string" && isFileId(part.data.data, fileIdPrefixes) ? { file_id: part.data.data } : {
                           filename: (_e2 = part.filename) != null ? _e2 : fullMediaType === "application/pdf" ? `part-${index}.pdf` : `part-${index}`,
                           file_data: `data:${fullMediaType};base64,${convertToBase642(part.data.data)}`
+                        },
+                        ...promptCacheBreakpoint != null && {
+                          prompt_cache_breakpoint: promptCacheBreakpoint
                         }
                       };
                     }
@@ -3617,9 +3763,9 @@ async function convertToOpenAIResponsesInput({
         for (const part of content) {
           switch (part.type) {
             case "text": {
-              const providerOptions = (_a = part.providerOptions) == null ? void 0 : _a[providerOptionsName];
-              const id = providerOptions == null ? void 0 : providerOptions.itemId;
-              const phase = providerOptions == null ? void 0 : providerOptions.phase;
+              const providerOptions2 = (_a = part.providerOptions) == null ? void 0 : _a[providerOptionsName];
+              const id = providerOptions2 == null ? void 0 : providerOptions2.itemId;
+              const phase = providerOptions2 == null ? void 0 : providerOptions2.phase;
               if (hasConversation && id != null) {
                 break;
               }
@@ -3816,12 +3962,12 @@ async function convertToOpenAIResponsesInput({
               break;
             }
             case "reasoning": {
-              const providerOptions = await parseProviderOptions6({
+              const providerOptions2 = await parseProviderOptions6({
                 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;
               }
@@ -3853,19 +3999,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) {
@@ -3890,8 +4036,8 @@ async function convertToOpenAIResponsesInput({
             }
             case "custom": {
               if (part.kind === "openai.compaction") {
-                const providerOptions = (_t = part.providerOptions) == null ? void 0 : _t[providerOptionsName];
-                const id = providerOptions == null ? void 0 : providerOptions.itemId;
+                const providerOptions2 = (_t = part.providerOptions) == null ? void 0 : _t[providerOptionsName];
+                const id = providerOptions2 == null ? void 0 : providerOptions2.itemId;
                 if (hasConversation && id != null) {
                   break;
                 }
@@ -3899,7 +4045,7 @@ async function convertToOpenAIResponsesInput({
                   input.push({ type: "item_reference", id });
                   break;
                 }
-                const encryptedContent = providerOptions == null ? void 0 : providerOptions.encryptedContent;
+                const encryptedContent = providerOptions2 == null ? void 0 : providerOptions2.encryptedContent;
                 if (id != null) {
                   input.push({
                     type: "compaction",
@@ -4020,9 +4166,19 @@ async function convertToOpenAIResponsesInput({
               case "content":
                 outputValue = output.value.map((item) => {
                   var _a2, _b2, _c2;
+                  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 "file": {
                       const topLevel = getTopLevelMediaType2(item.mediaType);
                       const imageDetail = (_b2 = (_a2 = item.providerOptions) == null ? void 0 : _a2[providerOptionsName]) == null ? void 0 : _b2.imageDetail;
@@ -4034,13 +4190,19 @@ async function convertToOpenAIResponsesInput({
                           return {
                             type: "input_image",
                             image_url: `data:${fullMediaType};base64,${convertToBase642(item.data.data)}`,
-                            detail: imageDetail
+                            detail: imageDetail,
+                            ...promptCacheBreakpoint != null && {
+                              prompt_cache_breakpoint: promptCacheBreakpoint
+                            }
                           };
                         }
                         return {
                           type: "input_file",
                           filename: (_c2 = item.filename) != null ? _c2 : "data",
-                          file_data: `data:${fullMediaType};base64,${convertToBase642(item.data.data)}`
+                          file_data: `data:${fullMediaType};base64,${convertToBase642(item.data.data)}`,
+                          ...promptCacheBreakpoint != null && {
+                            prompt_cache_breakpoint: promptCacheBreakpoint
+                          }
                         };
                       }
                       if (item.data.type === "url") {
@@ -4048,12 +4210,18 @@ async function convertToOpenAIResponsesInput({
                           return {
                             type: "input_image",
                             image_url: item.data.url.toString(),
-                            detail: imageDetail
+                            detail: imageDetail,
+                            ...promptCacheBreakpoint != null && {
+                              prompt_cache_breakpoint: promptCacheBreakpoint
+                            }
                           };
                         }
                         return {
                           type: "input_file",
-                          file_url: item.data.url.toString()
+                          file_url: item.data.url.toString(),
+                          ...promptCacheBreakpoint != null && {
+                            prompt_cache_breakpoint: promptCacheBreakpoint
+                          }
                         };
                       }
                       warnings.push({
@@ -4097,9 +4265,19 @@ async function convertToOpenAIResponsesInput({
             case "content":
               contentValue = output.value.map((item) => {
                 var _a2, _b2, _c2;
+                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 "file": {
                     const topLevel = getTopLevelMediaType2(item.mediaType);
@@ -4112,13 +4290,19 @@ async function convertToOpenAIResponsesInput({
                         return {
                           type: "input_image",
                           image_url: `data:${fullMediaType};base64,${convertToBase642(item.data.data)}`,
-                          detail: imageDetail
+                          detail: imageDetail,
+                          ...promptCacheBreakpoint != null && {
+                            prompt_cache_breakpoint: promptCacheBreakpoint
+                          }
                         };
                       }
                       return {
                         type: "input_file",
                         filename: (_c2 = item.filename) != null ? _c2 : "data",
-                        file_data: `data:${fullMediaType};base64,${convertToBase642(item.data.data)}`
+                        file_data: `data:${fullMediaType};base64,${convertToBase642(item.data.data)}`,
+                        ...promptCacheBreakpoint != null && {
+                          prompt_cache_breakpoint: promptCacheBreakpoint
+                        }
                       };
                     }
                     if (item.data.type === "url") {
@@ -4126,12 +4310,18 @@ async function convertToOpenAIResponsesInput({
                         return {
                           type: "input_image",
                           image_url: item.data.url.toString(),
-                          detail: imageDetail
+                          detail: imageDetail,
+                          ...promptCacheBreakpoint != null && {
+                            prompt_cache_breakpoint: promptCacheBreakpoint
+                          }
                         };
                       }
                       return {
                         type: "input_file",
-                        file_url: item.data.url.toString()
+                        file_url: item.data.url.toString(),
+                        ...promptCacheBreakpoint != null && {
+                          prompt_cache_breakpoint: promptCacheBreakpoint
+                        }
                       };
                     }
                     warnings.push({
@@ -4262,6 +4452,7 @@ var openaiResponsesChunkSchema = lazySchema22(
             input_tokens: z24.number(),
             input_tokens_details: z24.object({
               cached_tokens: z24.number().nullish(),
+              cache_write_tokens: z24.number().nullish(),
               orchestration_input_tokens: z24.number().nullish(),
               orchestration_input_cached_tokens: z24.number().nullish()
             }).nullish(),
@@ -4271,6 +4462,9 @@ var openaiResponsesChunkSchema = lazySchema22(
               orchestration_output_tokens: z24.number().nullish()
             }).nullish()
           }),
+          reasoning: z24.object({
+            context: z24.string().nullish()
+          }).nullish(),
           service_tier: z24.string().nullish()
         })
       }),
@@ -4287,6 +4481,7 @@ var openaiResponsesChunkSchema = lazySchema22(
             input_tokens: z24.number(),
             input_tokens_details: z24.object({
               cached_tokens: z24.number().nullish(),
+              cache_write_tokens: z24.number().nullish(),
               orchestration_input_tokens: z24.number().nullish(),
               orchestration_input_cached_tokens: z24.number().nullish()
             }).nullish(),
@@ -4296,6 +4491,9 @@ var openaiResponsesChunkSchema = lazySchema22(
               orchestration_output_tokens: z24.number().nullish()
             }).nullish()
           }).nullish(),
+          reasoning: z24.object({
+            context: z24.string().nullish()
+          }).nullish(),
           service_tier: z24.string().nullish()
         })
       }),
@@ -5082,11 +5280,15 @@ var openaiResponsesResponseSchema = lazySchema22(
         ])
       ).optional(),
       service_tier: z24.string().nullish(),
+      reasoning: z24.object({
+        context: z24.string().nullish()
+      }).nullish(),
       incomplete_details: z24.object({ reason: z24.string() }).nullish(),
       usage: z24.object({
         input_tokens: z24.number(),
         input_tokens_details: z24.object({
           cached_tokens: z24.number().nullish(),
+          cache_write_tokens: z24.number().nullish(),
           orchestration_input_tokens: z24.number().nullish(),
           orchestration_input_cached_tokens: z24.number().nullish()
         }).nullish(),
@@ -5244,11 +5446,22 @@ var openaiLanguageModelResponsesOptionsSchema = lazySchema23(
        * Sets a cache key to tie this prompt to cached prefixes for better caching performance.
        */
       promptCacheKey: z25.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: z25.object({
+        mode: z25.enum(["implicit", "explicit"]).optional(),
+        ttl: z25.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'
        */
@@ -5256,14 +5469,21 @@ var openaiLanguageModelResponsesOptionsSchema = lazySchema23(
       /**
        * 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: z25.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: z25.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: z25.enum(["auto", "current_turn", "all_turns"]).optional(),
       /**
        * Controls reasoning summary output from the model.
        * Set to "auto" to automatically receive the richest level available,
@@ -5896,6 +6116,7 @@ var OpenAIResponsesLanguageModel = class _OpenAIResponsesLanguageModel {
       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,
@@ -5908,13 +6129,19 @@ var OpenAIResponsesLanguageModel = class _OpenAIResponsesLanguageModel {
         }))
       },
       // model-specific settings:
-      ...isReasoningModel && (resolvedReasoningEffort != null || resolvedReasoningSummary != null) && {
+      ...isReasoningModel && (resolvedReasoningEffort != null || resolvedReasoningSummary != null || (openaiOptions == null ? void 0 : openaiOptions.reasoningMode) != null || (openaiOptions == null ? void 0 : openaiOptions.reasoningContext) != null) && {
         reasoning: {
           ...resolvedReasoningEffort != null && {
             effort: resolvedReasoningEffort
           },
           ...resolvedReasoningSummary != null && {
             summary: resolvedReasoningSummary
+          },
+          ...(openaiOptions == null ? void 0 : openaiOptions.reasoningMode) != null && {
+            mode: openaiOptions.reasoningMode
+          },
+          ...(openaiOptions == null ? void 0 : openaiOptions.reasoningContext) != null && {
+            context: openaiOptions.reasoningContext
           }
         }
       }
@@ -5953,6 +6180,20 @@ var OpenAIResponsesLanguageModel = class _OpenAIResponsesLanguageModel {
           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({
@@ -5989,7 +6230,7 @@ var OpenAIResponsesLanguageModel = class _OpenAIResponsesLanguageModel {
     };
   }
   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, _C, _D;
+    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;
     const {
       args: body,
       warnings,
@@ -6452,7 +6693,8 @@ var OpenAIResponsesLanguageModel = class _OpenAIResponsesLanguageModel {
       [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 } : {},
+        ...((_B = response.reasoning) == null ? void 0 : _B.context) != null ? { reasoningContext: response.reasoning.context } : {}
       }
     };
     const usage = response.usage;
@@ -6460,10 +6702,10 @@ var OpenAIResponsesLanguageModel = class _OpenAIResponsesLanguageModel {
       content,
       finishReason: {
         unified: mapOpenAIResponseFinishReason({
-          finishReason: (_B = response.incomplete_details) == null ? void 0 : _B.reason,
+          finishReason: (_C = response.incomplete_details) == null ? void 0 : _C.reason,
           hasFunctionCall
         }),
-        raw: (_D = (_C = response.incomplete_details) == null ? void 0 : _C.reason) != null ? _D : void 0
+        raw: (_E = (_D = response.incomplete_details) == null ? void 0 : _D.reason) != null ? _E : void 0
       },
       usage: convertOpenAIResponsesUsage(usage),
       request: { body },
@@ -6531,6 +6773,7 @@ var OpenAIResponsesLanguageModel = class _OpenAIResponsesLanguageModel {
     let hasFunctionCall = false;
     const activeReasoning = {};
     let serviceTier;
+    let reasoningContext;
     const hostedToolSearchCallIds = [];
     let encounteredStreamError = false;
     const result = {
@@ -6540,7 +6783,7 @@ var OpenAIResponsesLanguageModel = class _OpenAIResponsesLanguageModel {
             controller.enqueue({ type: "stream-start", warnings });
           },
           transform(chunk, controller) {
-            var _a2, _b2, _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 _a2, _b2, _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 });
             }
@@ -7294,8 +7537,11 @@ var OpenAIResponsesLanguageModel = class _OpenAIResponsesLanguageModel {
               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,
@@ -7303,7 +7549,10 @@ var OpenAIResponsesLanguageModel = class _OpenAIResponsesLanguageModel {
                 }) : "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({
@@ -7325,7 +7574,7 @@ var OpenAIResponsesLanguageModel = class _OpenAIResponsesLanguageModel {
                 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
                 });
@@ -7333,7 +7582,7 @@ var OpenAIResponsesLanguageModel = class _OpenAIResponsesLanguageModel {
                 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,
@@ -7349,7 +7598,7 @@ var OpenAIResponsesLanguageModel = class _OpenAIResponsesLanguageModel {
                 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,
@@ -7365,7 +7614,7 @@ var OpenAIResponsesLanguageModel = class _OpenAIResponsesLanguageModel {
                 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,
@@ -7389,7 +7638,8 @@ var OpenAIResponsesLanguageModel = class _OpenAIResponsesLanguageModel {
               [providerOptionsName]: {
                 responseId,
                 ...logprobs.length > 0 ? { logprobs } : {},
-                ...serviceTier !== void 0 ? { serviceTier } : {}
+                ...serviceTier !== void 0 ? { serviceTier } : {},
+                ...reasoningContext !== void 0 ? { reasoningContext } : {}
               }
             };
             controller.enqueue({
@@ -8254,7 +8504,7 @@ var OpenAISkills = class {
 };
 
 // src/version.ts
-var VERSION = true ? "4.0.10" : "0.0.0-test";
+var VERSION = true ? "4.0.11" : "0.0.0-test";
 
 // src/openai-provider.ts
 function createOpenAI(options = {}) {