@ai-sdk/openai 3.0.129 → 3.0.131

package/CHANGELOG.md

@@ -1,5 +1,22 @@
 # @ai-sdk/openai
 
+## 3.0.131
+
+### Patch Changes
+
+- 6afa8a8: Defer validation schema construction until first use to reduce provider import time.
+- aad3b66: feat(openai): support 12h prompt cache writes and cache prewarming
+- Updated dependencies [1183cc4]
+- Updated dependencies [d726591]
+  - @ai-sdk/provider-utils@4.0.62
+
+## 3.0.130
+
+### Patch Changes
+
+- Updated dependencies [5aa3086]
+  - @ai-sdk/provider-utils@4.0.61
+
 ## 3.0.129
 
 ### Patch Changes

package/dist/index.d.mts

@@ -244,6 +244,10 @@ declare const openaiResponsesChunkSchema: _ai_sdk_provider_utils.LazySchema<{
             input_tokens_details?: (Record<string, JSONValue | undefined> & {
                 cached_tokens?: number | null | undefined;
                 cache_write_tokens?: number | null | undefined;
+                cache_write_tokens_details?: (Record<string, JSONValue | undefined> & {
+                    ttl_30m_tokens?: number | null | undefined;
+                    ttl_12h_tokens?: number | null | undefined;
+                }) | null | undefined;
                 orchestration_input_tokens?: number | null | undefined;
                 orchestration_input_cached_tokens?: number | null | undefined;
             }) | null | undefined;
@@ -275,6 +279,10 @@ declare const openaiResponsesChunkSchema: _ai_sdk_provider_utils.LazySchema<{
             input_tokens_details?: (Record<string, JSONValue | undefined> & {
                 cached_tokens?: number | null | undefined;
                 cache_write_tokens?: number | null | undefined;
+                cache_write_tokens_details?: (Record<string, JSONValue | undefined> & {
+                    ttl_30m_tokens?: number | null | undefined;
+                    ttl_12h_tokens?: number | null | undefined;
+                }) | null | undefined;
                 orchestration_input_tokens?: number | null | undefined;
                 orchestration_input_cached_tokens?: number | null | undefined;
             }) | null | undefined;
@@ -1105,7 +1113,8 @@ declare const openaiLanguageModelResponsesOptionsSchema: _ai_sdk_provider_utils.
     promptCacheKey?: string | null | undefined;
     promptCacheOptions?: {
         mode?: "explicit" | "implicit" | undefined;
-        ttl?: "30m" | undefined;
+        ttl?: "30m" | "12h" | undefined;
+        prewarm?: boolean | undefined;
     } | undefined;
     promptCacheRetention?: "in_memory" | "24h" | null | undefined;
     reasoningEffort?: string | null | undefined;

package/dist/index.d.ts

@@ -244,6 +244,10 @@ declare const openaiResponsesChunkSchema: _ai_sdk_provider_utils.LazySchema<{
             input_tokens_details?: (Record<string, JSONValue | undefined> & {
                 cached_tokens?: number | null | undefined;
                 cache_write_tokens?: number | null | undefined;
+                cache_write_tokens_details?: (Record<string, JSONValue | undefined> & {
+                    ttl_30m_tokens?: number | null | undefined;
+                    ttl_12h_tokens?: number | null | undefined;
+                }) | null | undefined;
                 orchestration_input_tokens?: number | null | undefined;
                 orchestration_input_cached_tokens?: number | null | undefined;
             }) | null | undefined;
@@ -275,6 +279,10 @@ declare const openaiResponsesChunkSchema: _ai_sdk_provider_utils.LazySchema<{
             input_tokens_details?: (Record<string, JSONValue | undefined> & {
                 cached_tokens?: number | null | undefined;
                 cache_write_tokens?: number | null | undefined;
+                cache_write_tokens_details?: (Record<string, JSONValue | undefined> & {
+                    ttl_30m_tokens?: number | null | undefined;
+                    ttl_12h_tokens?: number | null | undefined;
+                }) | null | undefined;
                 orchestration_input_tokens?: number | null | undefined;
                 orchestration_input_cached_tokens?: number | null | undefined;
             }) | null | undefined;
@@ -1105,7 +1113,8 @@ declare const openaiLanguageModelResponsesOptionsSchema: _ai_sdk_provider_utils.
     promptCacheKey?: string | null | undefined;
     promptCacheOptions?: {
         mode?: "explicit" | "implicit" | undefined;
-        ttl?: "30m" | undefined;
+        ttl?: "30m" | "12h" | undefined;
+        prewarm?: boolean | undefined;
     } | undefined;
     promptCacheRetention?: "in_memory" | "24h" | null | undefined;
     reasoningEffort?: string | null | undefined;

package/dist/index.js

@@ -36,7 +36,7 @@ var import_provider_utils5 = require("@ai-sdk/provider-utils");
 // src/openai-error.ts
 var import_v4 = require("zod/v4");
 var import_provider_utils = require("@ai-sdk/provider-utils");
-var openaiErrorDataSchema = import_v4.z.object({
+var openaiErrorDataSchema = () => import_v4.z.object({
   error: import_v4.z.object({
     message: import_v4.z.string(),
     // The additional information below is handled loosely to support
@@ -47,8 +47,11 @@ var openaiErrorDataSchema = import_v4.z.object({
     code: import_v4.z.union([import_v4.z.string(), import_v4.z.number()]).nullish()
   })
 });
+var openaiErrorDataSchemaValidator = (0, import_provider_utils.lazySchema)(
+  () => (0, import_provider_utils.zodSchema)(openaiErrorDataSchema())
+);
 var openaiFailedResponseHandler = (0, import_provider_utils.createJsonErrorResponseHandler)({
-  errorSchema: openaiErrorDataSchema,
+  errorSchema: openaiErrorDataSchemaValidator,
   errorToMessage: (data) => data.error.message
 });
 
@@ -802,7 +805,7 @@ var openaiChatChunkSchema = (0, import_provider_utils3.lazySchema)(
           }).nullish()
         }).nullish()
       }),
-      openaiErrorDataSchema
+      openaiErrorDataSchema()
     ])
   )
 );
@@ -1651,7 +1654,7 @@ var openaiCompletionChunkSchema = (0, import_provider_utils6.lazySchema)(
           total_tokens: import_v44.z.number()
         }).nullish()
       }),
-      openaiErrorDataSchema
+      openaiErrorDataSchema()
     ])
   )
 );
@@ -2109,7 +2112,7 @@ function getMaxImagesPerCall(modelId) {
   var _a2;
   return (_a2 = modelMaxImagesPerCall[modelId]) != null ? _a2 : modelId.startsWith("gpt-image-") ? 10 : 1;
 }
-var baseImageModelOptionsObject = import_v49.z.object({
+var baseImageModelOptionsObject = () => import_v49.z.object({
   /**
    * Quality of the generated image(s).
    *
@@ -2140,11 +2143,11 @@ var baseImageModelOptionsObject = import_v49.z.object({
   user: import_v49.z.string().optional()
 });
 var openaiImageModelOptions = (0, import_provider_utils13.lazySchema)(
-  () => (0, import_provider_utils13.zodSchema)(baseImageModelOptionsObject)
+  () => (0, import_provider_utils13.zodSchema)(baseImageModelOptionsObject())
 );
 var openaiImageModelGenerationOptions = (0, import_provider_utils13.lazySchema)(
   () => (0, import_provider_utils13.zodSchema)(
-    baseImageModelOptionsObject.extend({
+    baseImageModelOptionsObject().extend({
       /**
        * Style of the generated image. `vivid` produces hyper-real and
        * dramatic images; `natural` produces more subdued, less hyper-real
@@ -2161,7 +2164,7 @@ var openaiImageModelGenerationOptions = (0, import_provider_utils13.lazySchema)(
 );
 var openaiImageModelEditOptions = (0, import_provider_utils13.lazySchema)(
   () => (0, import_provider_utils13.zodSchema)(
-    baseImageModelOptionsObject.extend({
+    baseImageModelOptionsObject().extend({
       /**
        * Fidelity of the output image(s) to the input image(s).
        */
@@ -2501,15 +2504,16 @@ var customTool = (args) => customToolFactory(args);
 // src/tool/file-search.ts
 var import_provider_utils18 = require("@ai-sdk/provider-utils");
 var import_v413 = require("zod/v4");
-var comparisonFilterSchema = import_v413.z.object({
+var comparisonFilterSchema = () => import_v413.z.object({
   key: import_v413.z.string(),
   type: import_v413.z.enum(["eq", "ne", "gt", "gte", "lt", "lte", "in", "nin"]),
   value: import_v413.z.union([import_v413.z.string(), import_v413.z.number(), import_v413.z.boolean(), import_v413.z.array(import_v413.z.string())])
 });
-var compoundFilterSchema = import_v413.z.object({
+var cachedCompoundFilterSchema;
+var compoundFilterSchema = () => cachedCompoundFilterSchema != null ? cachedCompoundFilterSchema : cachedCompoundFilterSchema = import_v413.z.object({
   type: import_v413.z.enum(["and", "or"]),
   filters: import_v413.z.array(
-    import_v413.z.union([comparisonFilterSchema, import_v413.z.lazy(() => compoundFilterSchema)])
+    import_v413.z.union([comparisonFilterSchema(), import_v413.z.lazy(() => compoundFilterSchema())])
   )
 });
 var fileSearchArgsSchema = (0, import_provider_utils18.lazySchema)(
@@ -2521,7 +2525,7 @@ var fileSearchArgsSchema = (0, import_provider_utils18.lazySchema)(
         ranker: import_v413.z.string().optional(),
         scoreThreshold: import_v413.z.number().optional()
       }).optional(),
-      filters: import_v413.z.union([comparisonFilterSchema, compoundFilterSchema]).optional()
+      filters: import_v413.z.union([comparisonFilterSchema(), compoundFilterSchema()]).optional()
     })
   )
 );
@@ -2638,7 +2642,7 @@ var shellOutputSchema = (0, import_provider_utils21.lazySchema)(
     })
   )
 );
-var shellSkillsSchema = import_v416.z.array(
+var shellSkillsSchema = () => import_v416.z.array(
   import_v416.z.discriminatedUnion("type", [
     import_v416.z.object({
       type: import_v416.z.literal("skillReference"),
@@ -2679,7 +2683,7 @@ var shellArgsSchema = (0, import_provider_utils21.lazySchema)(
               ).optional()
             })
           ]).optional(),
-          skills: shellSkillsSchema
+          skills: shellSkillsSchema()
         }),
         import_v416.z.object({
           type: import_v416.z.literal("containerReference"),
@@ -2847,14 +2851,15 @@ var webSearchPreview = (0, import_provider_utils24.createProviderToolFactoryWith
 // src/tool/mcp.ts
 var import_provider_utils25 = require("@ai-sdk/provider-utils");
 var import_v420 = require("zod/v4");
-var jsonValueSchema = import_v420.z.lazy(
+var cachedJsonValueSchema;
+var jsonValueSchema = () => cachedJsonValueSchema != null ? cachedJsonValueSchema : cachedJsonValueSchema = import_v420.z.lazy(
   () => import_v420.z.union([
     import_v420.z.string(),
     import_v420.z.number(),
     import_v420.z.boolean(),
     import_v420.z.null(),
-    import_v420.z.array(jsonValueSchema),
-    import_v420.z.record(import_v420.z.string(), jsonValueSchema)
+    import_v420.z.array(jsonValueSchema()),
+    import_v420.z.record(import_v420.z.string(), jsonValueSchema())
   ])
 );
 var mcpArgsSchema = (0, import_provider_utils25.lazySchema)(
@@ -2896,7 +2901,7 @@ var mcpOutputSchema = (0, import_provider_utils25.lazySchema)(
       name: import_v420.z.string(),
       arguments: import_v420.z.string(),
       output: import_v420.z.string().nullish(),
-      error: import_v420.z.union([import_v420.z.string(), jsonValueSchema]).optional()
+      error: import_v420.z.union([import_v420.z.string(), jsonValueSchema()]).optional()
     })
   )
 );
@@ -3223,11 +3228,13 @@ var openaiLanguageModelResponsesOptionsSchema = (0, import_provider_utils26.lazy
       /**
        * 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.
+       * `ttl` sets the minimum cache lifetime: `'30m'` (default) or `'12h'`.
+       * `prewarm` writes the prompt to the cache without generating output.
        */
       promptCacheOptions: import_v421.z.object({
         mode: import_v421.z.enum(["implicit", "explicit"]).optional(),
-        ttl: import_v421.z.literal("30m").optional()
+        ttl: import_v421.z.enum(["30m", "12h"]).optional(),
+        prewarm: import_v421.z.boolean().optional()
       }).optional(),
       /**
        * The retention policy for the prompt cache.
@@ -4487,10 +4494,14 @@ ${text}`,
   }
   return { input, warnings };
 }
-var openaiResponsesReasoningProviderOptionsSchema = import_v422.z.object({
-  itemId: import_v422.z.string().nullish(),
-  reasoningEncryptedContent: import_v422.z.string().nullish()
-});
+var openaiResponsesReasoningProviderOptionsSchema = (0, import_provider_utils28.lazySchema)(
+  () => (0, import_provider_utils28.zodSchema)(
+    import_v422.z.object({
+      itemId: import_v422.z.string().nullish(),
+      reasoningEncryptedContent: import_v422.z.string().nullish()
+    })
+  )
+);
 
 // src/responses/map-openai-responses-finish-reason.ts
 function mapOpenAIResponseFinishReason({
@@ -4513,33 +4524,41 @@ function mapOpenAIResponseFinishReason({
 // src/responses/openai-responses-api.ts
 var import_provider_utils29 = require("@ai-sdk/provider-utils");
 var import_v423 = require("zod/v4");
-var jsonValueSchema2 = import_v423.z.lazy(
+var cachedJsonValueSchema2;
+var jsonValueSchema2 = () => cachedJsonValueSchema2 != null ? cachedJsonValueSchema2 : cachedJsonValueSchema2 = import_v423.z.lazy(
   () => import_v423.z.union([
     import_v423.z.string(),
     import_v423.z.number(),
     import_v423.z.boolean(),
     import_v423.z.null(),
-    import_v423.z.array(jsonValueSchema2),
-    import_v423.z.record(import_v423.z.string(), jsonValueSchema2.optional())
+    import_v423.z.array(jsonValueSchema2()),
+    import_v423.z.record(import_v423.z.string(), jsonValueSchema2().optional())
   ])
 );
-var jsonObjectSchema = import_v423.z.record(import_v423.z.string(), jsonValueSchema2.optional());
-var openaiResponsesUsageSchema = import_v423.z.intersection(
-  jsonObjectSchema,
+var jsonObjectSchema = () => import_v423.z.record(import_v423.z.string(), jsonValueSchema2().optional());
+var openaiResponsesUsageSchema = () => import_v423.z.intersection(
+  jsonObjectSchema(),
   import_v423.z.object({
     input_tokens: import_v423.z.number(),
     input_tokens_details: import_v423.z.intersection(
-      jsonObjectSchema,
+      jsonObjectSchema(),
       import_v423.z.object({
         cached_tokens: import_v423.z.number().nullish(),
         cache_write_tokens: import_v423.z.number().nullish(),
+        cache_write_tokens_details: import_v423.z.intersection(
+          jsonObjectSchema(),
+          import_v423.z.object({
+            ttl_30m_tokens: import_v423.z.number().nullish(),
+            ttl_12h_tokens: import_v423.z.number().nullish()
+          })
+        ).nullish(),
         orchestration_input_tokens: import_v423.z.number().nullish(),
         orchestration_input_cached_tokens: import_v423.z.number().nullish()
       })
     ).nullish(),
     output_tokens: import_v423.z.number(),
     output_tokens_details: import_v423.z.intersection(
-      jsonObjectSchema,
+      jsonObjectSchema(),
       import_v423.z.object({
         reasoning_tokens: import_v423.z.number().nullish(),
         orchestration_output_tokens: import_v423.z.number().nullish()
@@ -4551,7 +4570,7 @@ var openaiResponsesUsageSchema = import_v423.z.intersection(
 function isRecord(value) {
   return value != null && typeof value === "object" && !Array.isArray(value);
 }
-var openaiResponsesLocalShellCallSchema = import_v423.z.object({
+var openaiResponsesLocalShellCallSchema = () => import_v423.z.object({
   type: import_v423.z.literal("local_shell_call"),
   id: import_v423.z.string(),
   call_id: import_v423.z.string(),
@@ -4564,7 +4583,7 @@ var openaiResponsesLocalShellCallSchema = import_v423.z.object({
     env: import_v423.z.record(import_v423.z.string(), import_v423.z.string()).optional()
   })
 });
-var openaiResponsesNestedErrorChunkSchema = import_v423.z.object({
+var openaiResponsesNestedErrorChunkSchema = () => import_v423.z.object({
   type: import_v423.z.literal("error"),
   sequence_number: import_v423.z.number(),
   error: import_v423.z.object({
@@ -4574,7 +4593,7 @@ var openaiResponsesNestedErrorChunkSchema = import_v423.z.object({
     param: import_v423.z.string().nullish()
   })
 });
-var openaiResponsesErrorChunkSchema = import_v423.z.object({
+var openaiResponsesErrorChunkSchema = () => import_v423.z.object({
   type: import_v423.z.literal("error"),
   sequence_number: import_v423.z.number(),
   code: import_v423.z.string().nullish(),
@@ -4659,7 +4678,7 @@ var openaiResponsesChunkSchema = (0, import_provider_utils29.lazySchema)(
         type: import_v423.z.enum(["response.completed", "response.incomplete"]),
         response: import_v423.z.object({
           incomplete_details: import_v423.z.object({ reason: import_v423.z.string() }).nullish(),
-          usage: openaiResponsesUsageSchema.nullish(),
+          usage: openaiResponsesUsageSchema().nullish(),
           reasoning: import_v423.z.object({
             context: import_v423.z.string().nullish()
           }).nullish(),
@@ -4675,7 +4694,7 @@ var openaiResponsesChunkSchema = (0, import_provider_utils29.lazySchema)(
             message: import_v423.z.string()
           }).nullish(),
           incomplete_details: import_v423.z.object({ reason: import_v423.z.string() }).nullish(),
-          usage: openaiResponsesUsageSchema.nullish(),
+          usage: openaiResponsesUsageSchema().nullish(),
           reasoning: import_v423.z.object({
             context: import_v423.z.string().nullish()
           }).nullish(),
@@ -4728,7 +4747,7 @@ var openaiResponsesChunkSchema = (0, import_provider_utils29.lazySchema)(
             type: import_v423.z.literal("file_search_call"),
             id: import_v423.z.string()
           }),
-          openaiResponsesLocalShellCallSchema,
+          openaiResponsesLocalShellCallSchema(),
           import_v423.z.object({
             type: import_v423.z.literal("image_generation_call"),
             id: import_v423.z.string()
@@ -4832,7 +4851,7 @@ var openaiResponsesChunkSchema = (0, import_provider_utils29.lazySchema)(
             execution: import_v423.z.enum(["server", "client"]),
             call_id: import_v423.z.string().nullable(),
             status: import_v423.z.enum(["in_progress", "completed", "incomplete"]),
-            tools: import_v423.z.array(import_v423.z.record(import_v423.z.string(), jsonValueSchema2.optional()))
+            tools: import_v423.z.array(import_v423.z.record(import_v423.z.string(), jsonValueSchema2().optional()))
           })
         ])
       }),
@@ -4930,7 +4949,7 @@ var openaiResponsesChunkSchema = (0, import_provider_utils29.lazySchema)(
               })
             ).nullish()
           }),
-          openaiResponsesLocalShellCallSchema,
+          openaiResponsesLocalShellCallSchema(),
           import_v423.z.object({
             type: import_v423.z.literal("computer_call"),
             id: import_v423.z.string(),
@@ -5047,7 +5066,7 @@ var openaiResponsesChunkSchema = (0, import_provider_utils29.lazySchema)(
             execution: import_v423.z.enum(["server", "client"]),
             call_id: import_v423.z.string().nullable(),
             status: import_v423.z.enum(["in_progress", "completed", "incomplete"]),
-            tools: import_v423.z.array(import_v423.z.record(import_v423.z.string(), jsonValueSchema2.optional()))
+            tools: import_v423.z.array(import_v423.z.record(import_v423.z.string(), jsonValueSchema2().optional()))
           })
         ])
       }),
@@ -5149,8 +5168,8 @@ var openaiResponsesChunkSchema = (0, import_provider_utils29.lazySchema)(
         output_index: import_v423.z.number(),
         diff: import_v423.z.string()
       }),
-      openaiResponsesNestedErrorChunkSchema,
-      openaiResponsesErrorChunkSchema,
+      openaiResponsesNestedErrorChunkSchema(),
+      openaiResponsesErrorChunkSchema(),
       import_v423.z.object({ type: import_v423.z.string() }).loose().refine((value) => !isModeledOpenAIResponsesChunk(value), {
         message: "Known response chunk failed schema validation"
       }).transform((value) => ({
@@ -5293,7 +5312,7 @@ var openaiResponsesResponseSchema = (0, import_provider_utils29.lazySchema)(
             id: import_v423.z.string(),
             result: import_v423.z.string()
           }),
-          openaiResponsesLocalShellCallSchema,
+          openaiResponsesLocalShellCallSchema(),
           import_v423.z.object({
             type: import_v423.z.literal("function_call"),
             call_id: import_v423.z.string(),
@@ -5438,7 +5457,9 @@ var openaiResponsesResponseSchema = (0, import_provider_utils29.lazySchema)(
             execution: import_v423.z.enum(["server", "client"]),
             call_id: import_v423.z.string().nullable(),
             status: import_v423.z.enum(["in_progress", "completed", "incomplete"]),
-            tools: import_v423.z.array(import_v423.z.record(import_v423.z.string(), jsonValueSchema2.optional()))
+            tools: import_v423.z.array(
+              import_v423.z.record(import_v423.z.string(), jsonValueSchema2().optional())
+            )
           })
         ])
       ).optional(),
@@ -5447,7 +5468,7 @@ var openaiResponsesResponseSchema = (0, import_provider_utils29.lazySchema)(
         context: import_v423.z.string().nullish()
       }).nullish(),
       incomplete_details: import_v423.z.object({ reason: import_v423.z.string() }).nullish(),
-      usage: openaiResponsesUsageSchema.nullish()
+      usage: openaiResponsesUsageSchema().nullish()
     })
   )
 );
@@ -8304,7 +8325,7 @@ var OpenAITranscriptionModel = class {
 };
 
 // src/version.ts
-var VERSION = true ? "3.0.129" : "0.0.0-test";
+var VERSION = true ? "3.0.131" : "0.0.0-test";
 
 // src/openai-provider.ts
 function createOpenAI(options = {}) {