@ai-sdk/openai 4.0.98 → 4.0.99

package/dist/internal/index.js

@@ -2,14 +2,15 @@ import { APICallError, InvalidPromptError, InvalidResponseDataError, TooManyEmbe
 import { EXPERIMENTAL_EMBEDDING_MODEL_MAX_INPUT_BYTES_PER_CALL, StreamingToolCallTracker, WORKFLOW_DESERIALIZE, WORKFLOW_SERIALIZE, combineHeaders, connectToWebSocket, convertBase64ToUint8Array, convertToBase64, convertToFormData, createBinaryResponseHandler, createEventSourceResponseHandler, createJsonErrorResponseHandler, createJsonResponseHandler, createLanguageModelResponseMetadata, createLanguageModelResponseMetadata as getResponseMetadata, createNullLanguageModelUsage, createProviderDefinedToolFactory, createProviderDefinedToolFactoryWithOutputSchema, createProviderExecutedToolFactory, createProviderStreamError, createToolNameMapping, downloadBlob, experimental_toolCaller, generateId, getTopLevelMediaType, isCustomReasoning, isNonNullable, isRecord, lazySchema, mediaTypeToExtension, parseJSON, parseProviderOptions, postFormDataToApi, postJsonToApi, resolveFullMediaType, resolveProviderReference, safeParseJSON, safeValidateTypes, serializeModelOptions, toWebSocketUrl, validateTypes, waitForWebSocketBufferDrain, zodSchema } from "@ai-sdk/provider-utils";
 import { z } from "zod/v4";
 //#region src/openai-error.ts
-const openaiErrorDataSchema = z.object({ error: z.object({
+const openaiErrorDataSchema = () => z.object({ error: z.object({
 	message: z.string(),
 	type: z.string().nullish(),
 	param: z.any().nullish(),
 	code: z.union([z.string(), z.number()]).nullish()
 }) });
+const openaiErrorDataSchemaValidator = lazySchema(() => zodSchema(openaiErrorDataSchema()));
 const openaiFailedResponseHandler = createJsonErrorResponseHandler({
-	errorSchema: openaiErrorDataSchema,
+	errorSchema: openaiErrorDataSchemaValidator,
 	errorToMessage: (data) => data.error.message
 });
 //#endregion
@@ -567,7 +568,7 @@ const openaiChatChunkSchema = lazySchema(() => zodSchema(z.union([z.object({
 			rejected_prediction_tokens: z.number().nullish()
 		}).nullish()
 	}).nullish()
-}), openaiErrorDataSchema])));
+}), openaiErrorDataSchema()])));
 //#endregion
 //#region src/chat/openai-chat-language-model-options.ts
 const openaiLanguageModelChatOptions = lazySchema(() => zodSchema(z.object({
@@ -1427,7 +1428,7 @@ const openaiCompletionChunkSchema = lazySchema(() => zodSchema(z.union([z.object
 		completion_tokens: z.number(),
 		total_tokens: z.number()
 	}).nullish()
-}), openaiErrorDataSchema])));
+}), openaiErrorDataSchema()])));
 //#endregion
 //#region src/completion/openai-completion-language-model-options.ts
 const openaiLanguageModelCompletionOptions = lazySchema(() => zodSchema(z.object({
@@ -1828,7 +1829,7 @@ function hasDefaultResponseFormat(modelId) {
 function getMaxImagesPerCall(modelId) {
 	return modelMaxImagesPerCall[modelId] ?? (modelId.startsWith("gpt-image-") ? 10 : 1);
 }
-const baseImageModelOptionsObject = z.object({
+const baseImageModelOptionsObject = () => z.object({
 	/**
 	* Quality of the generated image(s).
 	*
@@ -1875,8 +1876,8 @@ const baseImageModelOptionsObject = z.object({
 	*/
 	user: z.string().optional()
 });
-const openaiImageModelOptions = lazySchema(() => zodSchema(baseImageModelOptionsObject));
-const openaiImageModelGenerationOptions = lazySchema(() => zodSchema(baseImageModelOptionsObject.extend({
+const openaiImageModelOptions = lazySchema(() => zodSchema(baseImageModelOptionsObject()));
+const openaiImageModelGenerationOptions = lazySchema(() => zodSchema(baseImageModelOptionsObject().extend({
 	/**
 	* Style of the generated image. `vivid` produces hyper-real and
 	* dramatic images; `natural` produces more subdued, less hyper-real
@@ -1889,7 +1890,7 @@ const openaiImageModelGenerationOptions = lazySchema(() => zodSchema(baseImageMo
 	*/
 	moderation: z.enum(["auto", "low"]).optional()
 })));
-const openaiImageModelEditOptions = lazySchema(() => zodSchema(baseImageModelOptionsObject.extend({ 
+const openaiImageModelEditOptions = lazySchema(() => zodSchema(baseImageModelOptionsObject().extend({ 
 /**
 * Fidelity of the output image(s) to the input image(s).
 */
@@ -2770,11 +2771,13 @@ const openaiLanguageModelResponsesOptionsSchema = lazySchema(() => zodSchema(z.o
 	/**
 	* 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: z.object({
 		mode: z.enum(["implicit", "explicit"]).optional(),
-		ttl: z.literal("30m").optional()
+		ttl: z.enum(["30m", "12h"]).optional(),
+		prewarm: z.boolean().optional()
 	}).optional(),
 	/**
 	* The retention policy for the prompt cache.
@@ -3032,12 +3035,12 @@ const applyPatchToolFactory = createProviderDefinedToolFactoryWithOutputSchema({
 const applyPatch = applyPatchToolFactory;
 //#endregion
 //#region src/tool/computer.ts
-const safetyCheckSchema = z.object({
+const safetyCheckSchema = () => z.object({
 	id: z.string(),
 	code: z.string().optional(),
 	message: z.string().optional()
 });
-const computerActionSchema = z.discriminatedUnion("type", [
+const computerActionSchema = () => z.discriminatedUnion("type", [
 	z.object({
 		type: z.literal("click"),
 		button: z.enum([
@@ -3091,8 +3094,8 @@ const computerActionSchema = z.discriminatedUnion("type", [
 	z.object({ type: z.literal("wait") })
 ]);
 const computerInputSchema = lazySchema(() => zodSchema(z.object({
-	actions: z.array(computerActionSchema),
-	pendingSafetyChecks: z.array(safetyCheckSchema),
+	actions: z.array(computerActionSchema()),
+	pendingSafetyChecks: z.array(safetyCheckSchema()),
 	status: z.enum([
 		"in_progress",
 		"completed",
@@ -3121,7 +3124,7 @@ const computerOutputSchema = lazySchema(() => zodSchema(z.object({
 			"original"
 		]).optional()
 	})]),
-	acknowledgedSafetyChecks: z.array(safetyCheckSchema).optional()
+	acknowledgedSafetyChecks: z.array(safetyCheckSchema()).optional()
 })));
 createProviderDefinedToolFactoryWithOutputSchema({
 	id: "openai.computer",
@@ -3162,7 +3165,7 @@ const shellOutputSchema = lazySchema(() => zodSchema(z.object({
 		})])
 	}))
 })));
-const shellSkillsSchema = z.array(z.discriminatedUnion("type", [z.object({
+const shellSkillsSchema = () => z.array(z.discriminatedUnion("type", [z.object({
 	type: z.literal("skillReference"),
 	providerReference: z.record(z.string(), z.string()),
 	version: z.string().optional()
@@ -3195,7 +3198,7 @@ const shellArgsSchema = lazySchema(() => zodSchema(z.object({ environment: z.uni
 				value: z.string()
 			})).optional()
 		})]).optional(),
-		skills: shellSkillsSchema
+		skills: shellSkillsSchema()
 	}),
 	z.object({
 		type: z.literal("containerReference"),
@@ -4397,10 +4400,10 @@ async function convertToOpenAIResponsesInput({ prompt, toolNameMapping, systemMe
 		warnings
 	};
 }
-const openaiResponsesReasoningProviderOptionsSchema = z.object({
+const openaiResponsesReasoningProviderOptionsSchema = lazySchema(() => zodSchema(z.object({
 	itemId: z.string().nullish(),
 	reasoningEncryptedContent: z.string().nullish()
-});
+})));
 //#endregion
 //#region src/responses/map-openai-responses-annotation.ts
 function mapOpenAIResponsesAnnotationSource(annotation, providerOptionsName, id) {
@@ -4448,36 +4451,41 @@ function mapOpenAIResponseFinishReason({ finishReason, hasFunctionCall }) {
 }
 //#endregion
 //#region src/responses/openai-responses-api.ts
-const jsonValueSchema$1 = z.lazy(() => z.union([
+let cachedJsonValueSchema$1;
+const jsonValueSchema$1 = () => cachedJsonValueSchema$1 ??= z.lazy(() => z.union([
 	z.string(),
 	z.number(),
 	z.boolean(),
 	z.null(),
-	z.array(jsonValueSchema$1),
-	z.record(z.string(), jsonValueSchema$1.optional())
+	z.array(jsonValueSchema$1()),
+	z.record(z.string(), jsonValueSchema$1().optional())
 ]));
-const jsonObjectSchema = z.record(z.string(), jsonValueSchema$1.optional());
-const openaiResponsesUsageSchema = z.intersection(jsonObjectSchema, z.object({
+const jsonObjectSchema = () => z.record(z.string(), jsonValueSchema$1().optional());
+const openaiResponsesUsageSchema = () => z.intersection(jsonObjectSchema(), z.object({
 	input_tokens: z.number(),
-	input_tokens_details: z.intersection(jsonObjectSchema, z.object({
+	input_tokens_details: z.intersection(jsonObjectSchema(), z.object({
 		cached_tokens: z.number().nullish(),
 		cache_write_tokens: z.number().nullish(),
+		cache_write_tokens_details: z.intersection(jsonObjectSchema(), z.object({
+			ttl_30m_tokens: z.number().nullish(),
+			ttl_12h_tokens: z.number().nullish()
+		})).nullish(),
 		orchestration_input_tokens: z.number().nullish(),
 		orchestration_input_cached_tokens: z.number().nullish()
 	})).nullish(),
 	output_tokens: z.number(),
-	output_tokens_details: z.intersection(jsonObjectSchema, z.object({
+	output_tokens_details: z.intersection(jsonObjectSchema(), z.object({
 		reasoning_tokens: z.number().nullish(),
 		orchestration_output_tokens: z.number().nullish()
 	})).nullish(),
 	total_tokens: z.number().optional()
 }));
-const openaiResponsesComputerSafetyCheckSchema = z.object({
+const openaiResponsesComputerSafetyCheckSchema = () => z.object({
 	id: z.string(),
 	code: z.string().nullish(),
 	message: z.string().nullish()
 });
-const openaiResponsesComputerActionSchema = z.discriminatedUnion("type", [
+const openaiResponsesComputerActionSchema = () => z.discriminatedUnion("type", [
 	z.object({
 		type: z.literal("click"),
 		button: z.enum([
@@ -4530,7 +4538,7 @@ const openaiResponsesComputerActionSchema = z.discriminatedUnion("type", [
 	}),
 	z.object({ type: z.literal("wait") })
 ]);
-const openaiResponsesComputerCallSchema = z.object({
+const openaiResponsesComputerCallSchema = () => z.object({
 	type: z.literal("computer_call"),
 	id: z.string(),
 	call_id: z.string().nullish(),
@@ -4539,29 +4547,29 @@ const openaiResponsesComputerCallSchema = z.object({
 		"completed",
 		"incomplete"
 	]),
-	action: openaiResponsesComputerActionSchema.nullish(),
-	actions: z.array(openaiResponsesComputerActionSchema).nullish(),
-	pending_safety_checks: z.array(openaiResponsesComputerSafetyCheckSchema).nullish()
+	action: openaiResponsesComputerActionSchema().nullish(),
+	actions: z.array(openaiResponsesComputerActionSchema()).nullish(),
+	pending_safety_checks: z.array(openaiResponsesComputerSafetyCheckSchema()).nullish()
 });
-const openaiResponsesToolCallerSchema = z.discriminatedUnion("type", [z.object({ type: z.literal("direct") }), z.object({
+const openaiResponsesToolCallerSchema = () => z.discriminatedUnion("type", [z.object({ type: z.literal("direct") }), z.object({
 	type: z.literal("program"),
 	caller_id: z.string()
 })]);
-const openaiResponsesProgramSchema = z.object({
+const openaiResponsesProgramSchema = () => z.object({
 	type: z.literal("program"),
 	id: z.string(),
 	call_id: z.string(),
 	code: z.string(),
 	fingerprint: z.string()
 });
-const openaiResponsesProgramOutputSchema = z.object({
+const openaiResponsesProgramOutputSchema = () => z.object({
 	type: z.literal("program_output"),
 	id: z.string(),
 	call_id: z.string(),
 	result: z.string(),
 	status: z.enum(["completed", "incomplete"])
 });
-const openaiResponsesLocalShellCallSchema = z.object({
+const openaiResponsesLocalShellCallSchema = () => z.object({
 	type: z.literal("local_shell_call"),
 	id: z.string(),
 	call_id: z.string(),
@@ -4574,7 +4582,7 @@ const openaiResponsesLocalShellCallSchema = z.object({
 		env: z.record(z.string(), z.string()).optional()
 	})
 });
-const openaiResponsesNestedErrorChunkSchema = z.object({
+const openaiResponsesNestedErrorChunkSchema = () => z.object({
 	type: z.literal("error"),
 	sequence_number: z.number(),
 	error: z.object({
@@ -4584,7 +4592,7 @@ const openaiResponsesNestedErrorChunkSchema = z.object({
 		param: z.string().nullish()
 	})
 });
-const openaiResponsesErrorChunkSchema = z.object({
+const openaiResponsesErrorChunkSchema = () => z.object({
 	type: z.literal("error"),
 	sequence_number: z.number(),
 	code: z.string().nullish(),
@@ -4672,7 +4680,7 @@ const openaiResponsesChunkSchema = lazySchema(() => zodSchema(z.union([
 		type: z.enum(["response.completed", "response.incomplete"]),
 		response: z.object({
 			incomplete_details: z.object({ reason: z.string() }).nullish(),
-			usage: openaiResponsesUsageSchema.nullish(),
+			usage: openaiResponsesUsageSchema().nullish(),
 			reasoning: z.object({ context: z.string().nullish() }).nullish(),
 			service_tier: z.string().nullish()
 		})
@@ -4686,7 +4694,7 @@ const openaiResponsesChunkSchema = lazySchema(() => zodSchema(z.union([
 				message: z.string()
 			}).nullish(),
 			incomplete_details: z.object({ reason: z.string() }).nullish(),
-			usage: openaiResponsesUsageSchema.nullish(),
+			usage: openaiResponsesUsageSchema().nullish(),
 			reasoning: z.object({ context: z.string().nullish() }).nullish(),
 			service_tier: z.string().nullish()
 		})
@@ -4731,21 +4739,21 @@ const openaiResponsesChunkSchema = lazySchema(() => zodSchema(z.union([
 				arguments: z.string(),
 				async: z.boolean().nullish(),
 				namespace: z.string().nullish(),
-				caller: openaiResponsesToolCallerSchema.nullish()
+				caller: openaiResponsesToolCallerSchema().nullish()
 			}),
-			openaiResponsesProgramSchema,
-			openaiResponsesProgramOutputSchema,
+			openaiResponsesProgramSchema(),
+			openaiResponsesProgramOutputSchema(),
 			z.object({
 				type: z.literal("web_search_call"),
 				id: z.string(),
 				status: z.string()
 			}),
-			openaiResponsesComputerCallSchema,
+			openaiResponsesComputerCallSchema(),
 			z.object({
 				type: z.literal("file_search_call"),
 				id: z.string()
 			}),
-			openaiResponsesLocalShellCallSchema,
+			openaiResponsesLocalShellCallSchema(),
 			z.object({
 				type: z.literal("image_generation_call"),
 				id: z.string()
@@ -4869,7 +4877,7 @@ const openaiResponsesChunkSchema = lazySchema(() => zodSchema(z.union([
 					"completed",
 					"incomplete"
 				]),
-				tools: z.array(z.record(z.string(), jsonValueSchema$1.optional()))
+				tools: z.array(z.record(z.string(), jsonValueSchema$1().optional()))
 			})
 		])
 	}),
@@ -4900,10 +4908,10 @@ const openaiResponsesChunkSchema = lazySchema(() => zodSchema(z.union([
 					"incomplete"
 				]),
 				namespace: z.string().nullish(),
-				caller: openaiResponsesToolCallerSchema.nullish()
+				caller: openaiResponsesToolCallerSchema().nullish()
 			}),
-			openaiResponsesProgramSchema,
-			openaiResponsesProgramOutputSchema,
+			openaiResponsesProgramSchema(),
+			openaiResponsesProgramOutputSchema(),
 			z.object({
 				type: z.literal("custom_tool_call"),
 				id: z.string(),
@@ -4975,8 +4983,8 @@ const openaiResponsesChunkSchema = lazySchema(() => zodSchema(z.union([
 					text: z.string()
 				})).nullish()
 			}),
-			openaiResponsesLocalShellCallSchema,
-			openaiResponsesComputerCallSchema,
+			openaiResponsesLocalShellCallSchema(),
+			openaiResponsesComputerCallSchema(),
 			z.object({
 				type: z.literal("mcp_call"),
 				id: z.string(),
@@ -5099,7 +5107,7 @@ const openaiResponsesChunkSchema = lazySchema(() => zodSchema(z.union([
 					"completed",
 					"incomplete"
 				]),
-				tools: z.array(z.record(z.string(), jsonValueSchema$1.optional()))
+				tools: z.array(z.record(z.string(), jsonValueSchema$1().optional()))
 			})
 		])
 	}),
@@ -5202,8 +5210,8 @@ const openaiResponsesChunkSchema = lazySchema(() => zodSchema(z.union([
 		output_index: z.number(),
 		diff: z.string()
 	}),
-	openaiResponsesNestedErrorChunkSchema,
-	openaiResponsesErrorChunkSchema,
+	openaiResponsesNestedErrorChunkSchema(),
+	openaiResponsesErrorChunkSchema(),
 	z.object({ type: z.string() }).loose().refine((value) => !isModeledOpenAIResponsesChunk(value), { message: "Known response chunk failed schema validation" }).transform((value) => ({
 		type: "unknown_chunk",
 		message: value.type
@@ -5328,7 +5336,7 @@ const openaiResponsesResponseSchema = lazySchema(() => zodSchema(z.object({
 			id: z.string(),
 			result: z.string()
 		}),
-		openaiResponsesLocalShellCallSchema,
+		openaiResponsesLocalShellCallSchema(),
 		z.object({
 			type: z.literal("function_call"),
 			call_id: z.string(),
@@ -5337,10 +5345,10 @@ const openaiResponsesResponseSchema = lazySchema(() => zodSchema(z.object({
 			id: z.string(),
 			async: z.boolean().nullish(),
 			namespace: z.string().nullish(),
-			caller: openaiResponsesToolCallerSchema.nullish()
+			caller: openaiResponsesToolCallerSchema().nullish()
 		}),
-		openaiResponsesProgramSchema,
-		openaiResponsesProgramOutputSchema,
+		openaiResponsesProgramSchema(),
+		openaiResponsesProgramOutputSchema(),
 		z.object({
 			type: z.literal("custom_tool_call"),
 			call_id: z.string(),
@@ -5349,7 +5357,7 @@ const openaiResponsesResponseSchema = lazySchema(() => zodSchema(z.object({
 			id: z.string(),
 			async: z.boolean().nullish()
 		}),
-		openaiResponsesComputerCallSchema,
+		openaiResponsesComputerCallSchema(),
 		z.object({
 			type: z.literal("reasoning"),
 			id: z.string(),
@@ -5481,13 +5489,13 @@ const openaiResponsesResponseSchema = lazySchema(() => zodSchema(z.object({
 				"completed",
 				"incomplete"
 			]),
-			tools: z.array(z.record(z.string(), jsonValueSchema$1.optional()))
+			tools: z.array(z.record(z.string(), jsonValueSchema$1().optional()))
 		})
 	])).optional(),
 	service_tier: z.string().nullish(),
 	reasoning: z.object({ context: z.string().nullish() }).nullish(),
 	incomplete_details: z.object({ reason: z.string() }).nullish(),
-	usage: openaiResponsesUsageSchema.nullish()
+	usage: openaiResponsesUsageSchema().nullish()
 })));
 //#endregion
 //#region src/tool/code-interpreter.ts
@@ -5513,7 +5521,7 @@ const codeInterpreter = (args = {}) => {
 };
 //#endregion
 //#region src/tool/file-search.ts
-const comparisonFilterSchema = z.object({
+const comparisonFilterSchema = () => z.object({
 	key: z.string(),
 	type: z.enum([
 		"eq",
@@ -5532,9 +5540,10 @@ const comparisonFilterSchema = z.object({
 		z.array(z.string())
 	])
 });
-const compoundFilterSchema = z.object({
+let cachedCompoundFilterSchema;
+const compoundFilterSchema = () => cachedCompoundFilterSchema ??= z.object({
 	type: z.enum(["and", "or"]),
-	filters: z.array(z.union([comparisonFilterSchema, z.lazy(() => compoundFilterSchema)]))
+	filters: z.array(z.union([comparisonFilterSchema(), z.lazy(() => compoundFilterSchema())]))
 });
 const fileSearchArgsSchema = lazySchema(() => zodSchema(z.object({
 	vectorStoreIds: z.array(z.string()),
@@ -5543,7 +5552,7 @@ const fileSearchArgsSchema = lazySchema(() => zodSchema(z.object({
 		ranker: z.string().optional(),
 		scoreThreshold: z.number().optional()
 	}).optional(),
-	filters: z.union([comparisonFilterSchema, compoundFilterSchema]).optional()
+	filters: z.union([comparisonFilterSchema(), compoundFilterSchema()]).optional()
 })));
 const fileSearchOutputSchema = lazySchema(() => zodSchema(z.object({
 	queries: z.array(z.string()),
@@ -5630,13 +5639,14 @@ createProviderDefinedToolFactory({
 });
 //#endregion
 //#region src/tool/mcp.ts
-const jsonValueSchema = z.lazy(() => z.union([
+let cachedJsonValueSchema;
+const jsonValueSchema = () => cachedJsonValueSchema ??= z.lazy(() => z.union([
 	z.string(),
 	z.number(),
 	z.boolean(),
 	z.null(),
-	z.array(jsonValueSchema),
-	z.record(z.string(), jsonValueSchema)
+	z.array(jsonValueSchema()),
+	z.record(z.string(), jsonValueSchema())
 ]));
 const mcpArgsSchema = lazySchema(() => zodSchema(z.object({
 	serverLabel: z.string(),
@@ -5658,7 +5668,7 @@ const mcpOutputSchema = lazySchema(() => zodSchema(z.object({
 	name: z.string(),
 	arguments: z.string(),
 	output: z.string().nullish(),
-	error: z.union([z.string(), jsonValueSchema]).optional()
+	error: z.union([z.string(), jsonValueSchema()]).optional()
 })));
 createProviderExecutedToolFactory({
 	id: "openai.mcp",