@ai-sdk/provider-utils 3.0.10 → 3.0.11

package/CHANGELOG.md

@@ -1,5 +1,12 @@
 # @ai-sdk/provider-utils
 
+## 3.0.11
+
+### Patch Changes
+
+- 6f0644c: chore: use import \* from zod/v4
+- 6f0644c: chore: load zod schemas lazily
+
 ## 3.0.10
 
 ### Patch Changes

package/dist/index.d.mts

@@ -1,9 +1,9 @@
-import { JSONValue, JSONParseError, TypeValidationError, APICallError, LanguageModelV2Prompt, JSONSchema7, SharedV2ProviderOptions, LanguageModelV2ToolResultOutput, LanguageModelV2ToolResultPart } from '@ai-sdk/provider';
+import { JSONParseError, TypeValidationError, JSONValue, APICallError, LanguageModelV2Prompt, JSONSchema7, SharedV2ProviderOptions, LanguageModelV2ToolResultOutput, LanguageModelV2ToolResultPart } from '@ai-sdk/provider';
 import * as z4 from 'zod/v4';
-import { ZodType, z } from 'zod/v4';
-import * as z3 from 'zod/v3';
+import { ZodType } from 'zod/v4';
 import { StandardSchemaV1 } from '@standard-schema/spec';
 export * from '@standard-schema/spec';
+import * as z3 from 'zod/v3';
 export { EventSourceMessage, EventSourceParserStream } from 'eventsource-parser/stream';
 
 declare function combineHeaders(...headers: Array<Record<string, string | undefined> | undefined>): Record<string, string | undefined>;
@@ -43,20 +43,6 @@ declare function extractResponseHeaders(response: Response): {
  */
 type FetchFunction = typeof globalThis.fetch;
 
-declare function getRuntimeEnvironmentUserAgent(globalThisAny?: any): string;
-
-/**
- * Appends suffix parts to the `user-agent` header.
- * If a `user-agent` header already exists, the suffix parts are appended to it.
- * If no `user-agent` header exists, a new one is created with the suffix parts.
- * Automatically removes undefined entries from the headers.
- *
- * @param headers - The original headers.
- * @param userAgentSuffixParts - The parts to append to the `user-agent` header.
- * @returns The new headers with the `user-agent` header set or updated.
- */
-declare function withUserAgentSuffix(headers: HeadersInit | Record<string, string | undefined> | undefined, ...userAgentSuffixParts: string[]): Record<string, string>;
-
 /**
 Creates an ID generator.
 The total length of the ID is the sum of the prefix, separator, and random part length.
@@ -114,7 +100,19 @@ type Validator<OBJECT = unknown> = {
  */
 declare function validator<OBJECT>(validate?: undefined | ((value: unknown) => ValidationResult<OBJECT> | PromiseLike<ValidationResult<OBJECT>>)): Validator<OBJECT>;
 declare function isValidator(value: unknown): value is Validator;
-declare function asValidator<OBJECT>(value: Validator<OBJECT> | StandardSchemaV1<unknown, OBJECT>): Validator<OBJECT>;
+/**
+ * Creates a validator with deferred creation.
+ * This is important to reduce the startup time of the library
+ * and to avoid initializing unused validators.
+ *
+ * @param createValidator A function that creates a validator.
+ * @returns A function that returns a validator.
+ */
+declare function lazyValidator<OBJECT>(createValidator: () => Validator<OBJECT>): LazyValidator<OBJECT>;
+type LazyValidator<OBJECT> = () => Validator<OBJECT>;
+type FlexibleValidator<OBJECT> = Validator<OBJECT> | LazyValidator<OBJECT> | StandardSchemaV1<unknown, OBJECT>;
+type InferValidator<SCHEMA> = SCHEMA extends StandardSchemaV1<unknown, infer T> ? T : SCHEMA extends LazyValidator<infer T> ? T : SCHEMA extends Validator<infer T> ? T : never;
+declare function asValidator<OBJECT>(value: FlexibleValidator<OBJECT>): Validator<OBJECT>;
 declare function standardSchemaValidator<OBJECT>(standardSchema: StandardSchemaV1<unknown, OBJECT>): Validator<OBJECT>;
 
 /**
@@ -137,7 +135,7 @@ declare function parseJSON(options: {
  */
 declare function parseJSON<T>(options: {
     text: string;
-    schema: z4.core.$ZodType<T> | z3.Schema<T> | Validator<T>;
+    schema: FlexibleValidator<T>;
 }): Promise<T>;
 type ParseResult<T> = {
     success: true;
@@ -168,7 +166,7 @@ declare function safeParseJSON(options: {
  */
 declare function safeParseJSON<T>(options: {
     text: string;
-    schema: z4.core.$ZodType<T> | z3.Schema<T> | Validator<T>;
+    schema: FlexibleValidator<T>;
 }): Promise<ParseResult<T>>;
 declare function isParsableJson(input: string): boolean;
 
@@ -182,13 +180,13 @@ type ResponseHandler<RETURN_TYPE> = (options: {
     responseHeaders?: Record<string, string>;
 }>;
 declare const createJsonErrorResponseHandler: <T>({ errorSchema, errorToMessage, isRetryable, }: {
-    errorSchema: ZodType<T>;
+    errorSchema: FlexibleValidator<T>;
     errorToMessage: (error: T) => string;
     isRetryable?: (response: Response, error?: T) => boolean;
 }) => ResponseHandler<APICallError>;
-declare const createEventSourceResponseHandler: <T>(chunkSchema: ZodType<T>) => ResponseHandler<ReadableStream<ParseResult<T>>>;
+declare const createEventSourceResponseHandler: <T>(chunkSchema: FlexibleValidator<T>) => ResponseHandler<ReadableStream<ParseResult<T>>>;
 declare const createJsonStreamResponseHandler: <T>(chunkSchema: ZodType<T>) => ResponseHandler<ReadableStream<ParseResult<T>>>;
-declare const createJsonResponseHandler: <T>(responseSchema: ZodType<T>) => ResponseHandler<T>;
+declare const createJsonResponseHandler: <T>(responseSchema: FlexibleValidator<T>) => ResponseHandler<T>;
 declare const createBinaryResponseHandler: () => ResponseHandler<Uint8Array>;
 declare const createStatusCodeErrorResponseHandler: () => ResponseHandler<APICallError>;
 
@@ -205,6 +203,8 @@ declare const getFromApi: <T>({ url, headers, successfulResponseHandler, failedR
     responseHeaders?: Record<string, string>;
 }>;
 
+declare function getRuntimeEnvironmentUserAgent(globalThisAny?: any): string;
+
 declare function injectJsonInstructionIntoMessages({ messages, schema, schemaPrefix, schemaSuffix, }: {
     messages: LanguageModelV2Prompt;
     schema?: JSONSchema7;
@@ -282,14 +282,14 @@ declare function mediaTypeToExtension(mediaType: string): string;
  */
 declare function parseJsonEventStream<T>({ stream, schema, }: {
     stream: ReadableStream<Uint8Array>;
-    schema: ZodType<T>;
+    schema: FlexibleValidator<T>;
 }): ReadableStream<ParseResult<T>>;
 
-declare function parseProviderOptions<T>({ provider, providerOptions, schema, }: {
+declare function parseProviderOptions<OPTIONS>({ provider, providerOptions, schema, }: {
     provider: string;
     providerOptions: Record<string, unknown> | undefined;
-    schema: z.core.$ZodType<T, any>;
-}): Promise<T | undefined>;
+    schema: FlexibleValidator<OPTIONS>;
+}): Promise<OPTIONS | undefined>;
 
 declare const postJsonToApi: <T>({ url, headers, body, failedResponseHandler, successfulResponseHandler, abortSignal, fetch, }: {
     url: string;
@@ -352,18 +352,28 @@ type Schema<OBJECT = unknown> = Validator<OBJECT> & {
      */
     readonly jsonSchema: JSONSchema7;
 };
-type FlexibleSchema<T> = z4.core.$ZodType<T, any> | z3.Schema<T, z3.ZodTypeDef, any> | Schema<T>;
-type InferSchema<SCHEMA> = SCHEMA extends z3.Schema ? z3.infer<SCHEMA> : SCHEMA extends z4.core.$ZodType ? z4.infer<SCHEMA> : SCHEMA extends Schema<infer T> ? T : never;
+/**
+ * Creates a schema with deferred creation.
+ * This is important to reduce the startup time of the library
+ * and to avoid initializing unused validators.
+ *
+ * @param createValidator A function that creates a schema.
+ * @returns A function that returns a schema.
+ */
+declare function lazySchema<SCHEMA>(createSchema: () => Schema<SCHEMA>): LazySchema<SCHEMA>;
+type LazySchema<SCHEMA> = () => Schema<SCHEMA>;
+type FlexibleSchema<SCHEMA> = z4.core.$ZodType<SCHEMA, any> | z3.Schema<SCHEMA, z3.ZodTypeDef, any> | Schema<SCHEMA> | LazySchema<SCHEMA>;
+type InferSchema<SCHEMA> = SCHEMA extends z3.Schema ? z3.infer<SCHEMA> : SCHEMA extends z4.core.$ZodType ? z4.infer<SCHEMA> : SCHEMA extends LazySchema<infer T> ? T : SCHEMA extends Schema<infer T> ? T : never;
 /**
  * Create a schema using a JSON Schema.
  *
  * @param jsonSchema The JSON Schema for the schema.
  * @param options.validate Optional. A validation function for the schema.
  */
-declare function jsonSchema<OBJECT = unknown>(jsonSchema: JSONSchema7, { validate, }?: {
+declare function jsonSchema<OBJECT = unknown>(jsonSchema: JSONSchema7 | (() => JSONSchema7), { validate, }?: {
     validate?: (value: unknown) => ValidationResult<OBJECT> | PromiseLike<ValidationResult<OBJECT>>;
 }): Schema<OBJECT>;
-declare function asSchema<OBJECT>(schema: z4.core.$ZodType<OBJECT, any> | z3.Schema<OBJECT, z3.ZodTypeDef, any> | Schema<OBJECT> | undefined): Schema<OBJECT>;
+declare function asSchema<OBJECT>(schema: FlexibleSchema<OBJECT> | undefined): Schema<OBJECT>;
 
 /**
 Additional provider-specific options.
@@ -799,7 +809,7 @@ declare function convertToBase64(value: string | Uint8Array): string;
  */
 declare function validateTypes<OBJECT>({ value, schema, }: {
     value: unknown;
-    schema: StandardSchemaV1<unknown, OBJECT> | Validator<OBJECT>;
+    schema: FlexibleValidator<OBJECT>;
 }): Promise<OBJECT>;
 /**
  * Safely validates the types of an unknown object using a schema and
@@ -812,7 +822,7 @@ declare function validateTypes<OBJECT>({ value, schema, }: {
  */
 declare function safeValidateTypes<OBJECT>({ value, schema, }: {
     value: unknown;
-    schema: StandardSchemaV1<unknown, OBJECT> | Validator<OBJECT>;
+    schema: FlexibleValidator<OBJECT>;
 }): Promise<{
     success: true;
     value: OBJECT;
@@ -823,6 +833,20 @@ declare function safeValidateTypes<OBJECT>({ value, schema, }: {
     rawValue: unknown;
 }>;
 
+declare const VERSION: string;
+
+/**
+ * Appends suffix parts to the `user-agent` header.
+ * If a `user-agent` header already exists, the suffix parts are appended to it.
+ * If no `user-agent` header exists, a new one is created with the suffix parts.
+ * Automatically removes undefined entries from the headers.
+ *
+ * @param headers - The original headers.
+ * @param userAgentSuffixParts - The parts to append to the `user-agent` header.
+ * @returns The new headers with the `user-agent` header set or updated.
+ */
+declare function withUserAgentSuffix(headers: HeadersInit | Record<string, string | undefined> | undefined, ...userAgentSuffixParts: string[]): Record<string, string>;
+
 declare function withoutTrailingSlash(url: string | undefined): string | undefined;
 
 declare function zodSchema<OBJECT>(zodSchema: z4.core.$ZodType<OBJECT, any> | z3.Schema<OBJECT, z3.ZodTypeDef, any>, options?: {
@@ -906,6 +930,4 @@ interface ToolResult<NAME extends string, INPUT, OUTPUT> {
     dynamic?: boolean;
 }
 
-declare const VERSION: string;
-
-export { type AssistantContent, type AssistantModelMessage, type DataContent, type FetchFunction, type FilePart, type FlexibleSchema, type IdGenerator, type ImagePart, type InferSchema, type InferToolInput, type InferToolOutput, type ModelMessage, type ParseResult, type ProviderDefinedToolFactory, type ProviderDefinedToolFactoryWithOutputSchema, type ProviderOptions, type ReasoningPart, type Resolvable, type ResponseHandler, type Schema, type SystemModelMessage, type TextPart, type Tool, type ToolCall, type ToolCallOptions, type ToolCallPart, type ToolContent, type ToolExecuteFunction, type ToolModelMessage, type ToolResult, type ToolResultPart, type UserContent, type UserModelMessage, VERSION, type ValidationResult, type Validator, asSchema, asValidator, combineHeaders, convertAsyncIteratorToReadableStream, convertBase64ToUint8Array, convertToBase64, convertUint8ArrayToBase64, createBinaryResponseHandler, createEventSourceResponseHandler, createIdGenerator, createJsonErrorResponseHandler, createJsonResponseHandler, createJsonStreamResponseHandler, createProviderDefinedToolFactory, createProviderDefinedToolFactoryWithOutputSchema, createStatusCodeErrorResponseHandler, delay, dynamicTool, executeTool, extractResponseHeaders, generateId, getErrorMessage, getFromApi, getRuntimeEnvironmentUserAgent, injectJsonInstructionIntoMessages, isAbortError, isParsableJson, isUrlSupported, isValidator, jsonSchema, loadApiKey, loadOptionalSetting, loadSetting, mediaTypeToExtension, parseJSON, parseJsonEventStream, parseProviderOptions, postFormDataToApi, postJsonToApi, postToApi, removeUndefinedEntries, resolve, safeParseJSON, safeValidateTypes, standardSchemaValidator, tool, validateTypes, validator, validatorSymbol, withUserAgentSuffix, withoutTrailingSlash, zodSchema };
+export { type AssistantContent, type AssistantModelMessage, type DataContent, type FetchFunction, type FilePart, type FlexibleSchema, type FlexibleValidator, type IdGenerator, type ImagePart, type InferSchema, type InferToolInput, type InferToolOutput, type InferValidator, type LazySchema, type LazyValidator, type ModelMessage, type ParseResult, type ProviderDefinedToolFactory, type ProviderDefinedToolFactoryWithOutputSchema, type ProviderOptions, type ReasoningPart, type Resolvable, type ResponseHandler, type Schema, type SystemModelMessage, type TextPart, type Tool, type ToolCall, type ToolCallOptions, type ToolCallPart, type ToolContent, type ToolExecuteFunction, type ToolModelMessage, type ToolResult, type ToolResultPart, type UserContent, type UserModelMessage, VERSION, type ValidationResult, type Validator, asSchema, asValidator, combineHeaders, convertAsyncIteratorToReadableStream, convertBase64ToUint8Array, convertToBase64, convertUint8ArrayToBase64, createBinaryResponseHandler, createEventSourceResponseHandler, createIdGenerator, createJsonErrorResponseHandler, createJsonResponseHandler, createJsonStreamResponseHandler, createProviderDefinedToolFactory, createProviderDefinedToolFactoryWithOutputSchema, createStatusCodeErrorResponseHandler, delay, dynamicTool, executeTool, extractResponseHeaders, generateId, getErrorMessage, getFromApi, getRuntimeEnvironmentUserAgent, injectJsonInstructionIntoMessages, isAbortError, isParsableJson, isUrlSupported, isValidator, jsonSchema, lazySchema, lazyValidator, loadApiKey, loadOptionalSetting, loadSetting, mediaTypeToExtension, parseJSON, parseJsonEventStream, parseProviderOptions, postFormDataToApi, postJsonToApi, postToApi, removeUndefinedEntries, resolve, safeParseJSON, safeValidateTypes, standardSchemaValidator, tool, validateTypes, validator, withUserAgentSuffix, withoutTrailingSlash, zodSchema };

package/dist/index.d.ts

@@ -1,9 +1,9 @@
-import { JSONValue, JSONParseError, TypeValidationError, APICallError, LanguageModelV2Prompt, JSONSchema7, SharedV2ProviderOptions, LanguageModelV2ToolResultOutput, LanguageModelV2ToolResultPart } from '@ai-sdk/provider';
+import { JSONParseError, TypeValidationError, JSONValue, APICallError, LanguageModelV2Prompt, JSONSchema7, SharedV2ProviderOptions, LanguageModelV2ToolResultOutput, LanguageModelV2ToolResultPart } from '@ai-sdk/provider';
 import * as z4 from 'zod/v4';
-import { ZodType, z } from 'zod/v4';
-import * as z3 from 'zod/v3';
+import { ZodType } from 'zod/v4';
 import { StandardSchemaV1 } from '@standard-schema/spec';
 export * from '@standard-schema/spec';
+import * as z3 from 'zod/v3';
 export { EventSourceMessage, EventSourceParserStream } from 'eventsource-parser/stream';
 
 declare function combineHeaders(...headers: Array<Record<string, string | undefined> | undefined>): Record<string, string | undefined>;
@@ -43,20 +43,6 @@ declare function extractResponseHeaders(response: Response): {
  */
 type FetchFunction = typeof globalThis.fetch;
 
-declare function getRuntimeEnvironmentUserAgent(globalThisAny?: any): string;
-
-/**
- * Appends suffix parts to the `user-agent` header.
- * If a `user-agent` header already exists, the suffix parts are appended to it.
- * If no `user-agent` header exists, a new one is created with the suffix parts.
- * Automatically removes undefined entries from the headers.
- *
- * @param headers - The original headers.
- * @param userAgentSuffixParts - The parts to append to the `user-agent` header.
- * @returns The new headers with the `user-agent` header set or updated.
- */
-declare function withUserAgentSuffix(headers: HeadersInit | Record<string, string | undefined> | undefined, ...userAgentSuffixParts: string[]): Record<string, string>;
-
 /**
 Creates an ID generator.
 The total length of the ID is the sum of the prefix, separator, and random part length.
@@ -114,7 +100,19 @@ type Validator<OBJECT = unknown> = {
  */
 declare function validator<OBJECT>(validate?: undefined | ((value: unknown) => ValidationResult<OBJECT> | PromiseLike<ValidationResult<OBJECT>>)): Validator<OBJECT>;
 declare function isValidator(value: unknown): value is Validator;
-declare function asValidator<OBJECT>(value: Validator<OBJECT> | StandardSchemaV1<unknown, OBJECT>): Validator<OBJECT>;
+/**
+ * Creates a validator with deferred creation.
+ * This is important to reduce the startup time of the library
+ * and to avoid initializing unused validators.
+ *
+ * @param createValidator A function that creates a validator.
+ * @returns A function that returns a validator.
+ */
+declare function lazyValidator<OBJECT>(createValidator: () => Validator<OBJECT>): LazyValidator<OBJECT>;
+type LazyValidator<OBJECT> = () => Validator<OBJECT>;
+type FlexibleValidator<OBJECT> = Validator<OBJECT> | LazyValidator<OBJECT> | StandardSchemaV1<unknown, OBJECT>;
+type InferValidator<SCHEMA> = SCHEMA extends StandardSchemaV1<unknown, infer T> ? T : SCHEMA extends LazyValidator<infer T> ? T : SCHEMA extends Validator<infer T> ? T : never;
+declare function asValidator<OBJECT>(value: FlexibleValidator<OBJECT>): Validator<OBJECT>;
 declare function standardSchemaValidator<OBJECT>(standardSchema: StandardSchemaV1<unknown, OBJECT>): Validator<OBJECT>;
 
 /**
@@ -137,7 +135,7 @@ declare function parseJSON(options: {
  */
 declare function parseJSON<T>(options: {
     text: string;
-    schema: z4.core.$ZodType<T> | z3.Schema<T> | Validator<T>;
+    schema: FlexibleValidator<T>;
 }): Promise<T>;
 type ParseResult<T> = {
     success: true;
@@ -168,7 +166,7 @@ declare function safeParseJSON(options: {
  */
 declare function safeParseJSON<T>(options: {
     text: string;
-    schema: z4.core.$ZodType<T> | z3.Schema<T> | Validator<T>;
+    schema: FlexibleValidator<T>;
 }): Promise<ParseResult<T>>;
 declare function isParsableJson(input: string): boolean;
 
@@ -182,13 +180,13 @@ type ResponseHandler<RETURN_TYPE> = (options: {
     responseHeaders?: Record<string, string>;
 }>;
 declare const createJsonErrorResponseHandler: <T>({ errorSchema, errorToMessage, isRetryable, }: {
-    errorSchema: ZodType<T>;
+    errorSchema: FlexibleValidator<T>;
     errorToMessage: (error: T) => string;
     isRetryable?: (response: Response, error?: T) => boolean;
 }) => ResponseHandler<APICallError>;
-declare const createEventSourceResponseHandler: <T>(chunkSchema: ZodType<T>) => ResponseHandler<ReadableStream<ParseResult<T>>>;
+declare const createEventSourceResponseHandler: <T>(chunkSchema: FlexibleValidator<T>) => ResponseHandler<ReadableStream<ParseResult<T>>>;
 declare const createJsonStreamResponseHandler: <T>(chunkSchema: ZodType<T>) => ResponseHandler<ReadableStream<ParseResult<T>>>;
-declare const createJsonResponseHandler: <T>(responseSchema: ZodType<T>) => ResponseHandler<T>;
+declare const createJsonResponseHandler: <T>(responseSchema: FlexibleValidator<T>) => ResponseHandler<T>;
 declare const createBinaryResponseHandler: () => ResponseHandler<Uint8Array>;
 declare const createStatusCodeErrorResponseHandler: () => ResponseHandler<APICallError>;
 
@@ -205,6 +203,8 @@ declare const getFromApi: <T>({ url, headers, successfulResponseHandler, failedR
     responseHeaders?: Record<string, string>;
 }>;
 
+declare function getRuntimeEnvironmentUserAgent(globalThisAny?: any): string;
+
 declare function injectJsonInstructionIntoMessages({ messages, schema, schemaPrefix, schemaSuffix, }: {
     messages: LanguageModelV2Prompt;
     schema?: JSONSchema7;
@@ -282,14 +282,14 @@ declare function mediaTypeToExtension(mediaType: string): string;
  */
 declare function parseJsonEventStream<T>({ stream, schema, }: {
     stream: ReadableStream<Uint8Array>;
-    schema: ZodType<T>;
+    schema: FlexibleValidator<T>;
 }): ReadableStream<ParseResult<T>>;
 
-declare function parseProviderOptions<T>({ provider, providerOptions, schema, }: {
+declare function parseProviderOptions<OPTIONS>({ provider, providerOptions, schema, }: {
     provider: string;
     providerOptions: Record<string, unknown> | undefined;
-    schema: z.core.$ZodType<T, any>;
-}): Promise<T | undefined>;
+    schema: FlexibleValidator<OPTIONS>;
+}): Promise<OPTIONS | undefined>;
 
 declare const postJsonToApi: <T>({ url, headers, body, failedResponseHandler, successfulResponseHandler, abortSignal, fetch, }: {
     url: string;
@@ -352,18 +352,28 @@ type Schema<OBJECT = unknown> = Validator<OBJECT> & {
      */
     readonly jsonSchema: JSONSchema7;
 };
-type FlexibleSchema<T> = z4.core.$ZodType<T, any> | z3.Schema<T, z3.ZodTypeDef, any> | Schema<T>;
-type InferSchema<SCHEMA> = SCHEMA extends z3.Schema ? z3.infer<SCHEMA> : SCHEMA extends z4.core.$ZodType ? z4.infer<SCHEMA> : SCHEMA extends Schema<infer T> ? T : never;
+/**
+ * Creates a schema with deferred creation.
+ * This is important to reduce the startup time of the library
+ * and to avoid initializing unused validators.
+ *
+ * @param createValidator A function that creates a schema.
+ * @returns A function that returns a schema.
+ */
+declare function lazySchema<SCHEMA>(createSchema: () => Schema<SCHEMA>): LazySchema<SCHEMA>;
+type LazySchema<SCHEMA> = () => Schema<SCHEMA>;
+type FlexibleSchema<SCHEMA> = z4.core.$ZodType<SCHEMA, any> | z3.Schema<SCHEMA, z3.ZodTypeDef, any> | Schema<SCHEMA> | LazySchema<SCHEMA>;
+type InferSchema<SCHEMA> = SCHEMA extends z3.Schema ? z3.infer<SCHEMA> : SCHEMA extends z4.core.$ZodType ? z4.infer<SCHEMA> : SCHEMA extends LazySchema<infer T> ? T : SCHEMA extends Schema<infer T> ? T : never;
 /**
  * Create a schema using a JSON Schema.
  *
  * @param jsonSchema The JSON Schema for the schema.
  * @param options.validate Optional. A validation function for the schema.
  */
-declare function jsonSchema<OBJECT = unknown>(jsonSchema: JSONSchema7, { validate, }?: {
+declare function jsonSchema<OBJECT = unknown>(jsonSchema: JSONSchema7 | (() => JSONSchema7), { validate, }?: {
     validate?: (value: unknown) => ValidationResult<OBJECT> | PromiseLike<ValidationResult<OBJECT>>;
 }): Schema<OBJECT>;
-declare function asSchema<OBJECT>(schema: z4.core.$ZodType<OBJECT, any> | z3.Schema<OBJECT, z3.ZodTypeDef, any> | Schema<OBJECT> | undefined): Schema<OBJECT>;
+declare function asSchema<OBJECT>(schema: FlexibleSchema<OBJECT> | undefined): Schema<OBJECT>;
 
 /**
 Additional provider-specific options.
@@ -799,7 +809,7 @@ declare function convertToBase64(value: string | Uint8Array): string;
  */
 declare function validateTypes<OBJECT>({ value, schema, }: {
     value: unknown;
-    schema: StandardSchemaV1<unknown, OBJECT> | Validator<OBJECT>;
+    schema: FlexibleValidator<OBJECT>;
 }): Promise<OBJECT>;
 /**
  * Safely validates the types of an unknown object using a schema and
@@ -812,7 +822,7 @@ declare function validateTypes<OBJECT>({ value, schema, }: {
  */
 declare function safeValidateTypes<OBJECT>({ value, schema, }: {
     value: unknown;
-    schema: StandardSchemaV1<unknown, OBJECT> | Validator<OBJECT>;
+    schema: FlexibleValidator<OBJECT>;
 }): Promise<{
     success: true;
     value: OBJECT;
@@ -823,6 +833,20 @@ declare function safeValidateTypes<OBJECT>({ value, schema, }: {
     rawValue: unknown;
 }>;
 
+declare const VERSION: string;
+
+/**
+ * Appends suffix parts to the `user-agent` header.
+ * If a `user-agent` header already exists, the suffix parts are appended to it.
+ * If no `user-agent` header exists, a new one is created with the suffix parts.
+ * Automatically removes undefined entries from the headers.
+ *
+ * @param headers - The original headers.
+ * @param userAgentSuffixParts - The parts to append to the `user-agent` header.
+ * @returns The new headers with the `user-agent` header set or updated.
+ */
+declare function withUserAgentSuffix(headers: HeadersInit | Record<string, string | undefined> | undefined, ...userAgentSuffixParts: string[]): Record<string, string>;
+
 declare function withoutTrailingSlash(url: string | undefined): string | undefined;
 
 declare function zodSchema<OBJECT>(zodSchema: z4.core.$ZodType<OBJECT, any> | z3.Schema<OBJECT, z3.ZodTypeDef, any>, options?: {
@@ -906,6 +930,4 @@ interface ToolResult<NAME extends string, INPUT, OUTPUT> {
     dynamic?: boolean;
 }
 
-declare const VERSION: string;
-
-export { type AssistantContent, type AssistantModelMessage, type DataContent, type FetchFunction, type FilePart, type FlexibleSchema, type IdGenerator, type ImagePart, type InferSchema, type InferToolInput, type InferToolOutput, type ModelMessage, type ParseResult, type ProviderDefinedToolFactory, type ProviderDefinedToolFactoryWithOutputSchema, type ProviderOptions, type ReasoningPart, type Resolvable, type ResponseHandler, type Schema, type SystemModelMessage, type TextPart, type Tool, type ToolCall, type ToolCallOptions, type ToolCallPart, type ToolContent, type ToolExecuteFunction, type ToolModelMessage, type ToolResult, type ToolResultPart, type UserContent, type UserModelMessage, VERSION, type ValidationResult, type Validator, asSchema, asValidator, combineHeaders, convertAsyncIteratorToReadableStream, convertBase64ToUint8Array, convertToBase64, convertUint8ArrayToBase64, createBinaryResponseHandler, createEventSourceResponseHandler, createIdGenerator, createJsonErrorResponseHandler, createJsonResponseHandler, createJsonStreamResponseHandler, createProviderDefinedToolFactory, createProviderDefinedToolFactoryWithOutputSchema, createStatusCodeErrorResponseHandler, delay, dynamicTool, executeTool, extractResponseHeaders, generateId, getErrorMessage, getFromApi, getRuntimeEnvironmentUserAgent, injectJsonInstructionIntoMessages, isAbortError, isParsableJson, isUrlSupported, isValidator, jsonSchema, loadApiKey, loadOptionalSetting, loadSetting, mediaTypeToExtension, parseJSON, parseJsonEventStream, parseProviderOptions, postFormDataToApi, postJsonToApi, postToApi, removeUndefinedEntries, resolve, safeParseJSON, safeValidateTypes, standardSchemaValidator, tool, validateTypes, validator, validatorSymbol, withUserAgentSuffix, withoutTrailingSlash, zodSchema };
+export { type AssistantContent, type AssistantModelMessage, type DataContent, type FetchFunction, type FilePart, type FlexibleSchema, type FlexibleValidator, type IdGenerator, type ImagePart, type InferSchema, type InferToolInput, type InferToolOutput, type InferValidator, type LazySchema, type LazyValidator, type ModelMessage, type ParseResult, type ProviderDefinedToolFactory, type ProviderDefinedToolFactoryWithOutputSchema, type ProviderOptions, type ReasoningPart, type Resolvable, type ResponseHandler, type Schema, type SystemModelMessage, type TextPart, type Tool, type ToolCall, type ToolCallOptions, type ToolCallPart, type ToolContent, type ToolExecuteFunction, type ToolModelMessage, type ToolResult, type ToolResultPart, type UserContent, type UserModelMessage, VERSION, type ValidationResult, type Validator, asSchema, asValidator, combineHeaders, convertAsyncIteratorToReadableStream, convertBase64ToUint8Array, convertToBase64, convertUint8ArrayToBase64, createBinaryResponseHandler, createEventSourceResponseHandler, createIdGenerator, createJsonErrorResponseHandler, createJsonResponseHandler, createJsonStreamResponseHandler, createProviderDefinedToolFactory, createProviderDefinedToolFactoryWithOutputSchema, createStatusCodeErrorResponseHandler, delay, dynamicTool, executeTool, extractResponseHeaders, generateId, getErrorMessage, getFromApi, getRuntimeEnvironmentUserAgent, injectJsonInstructionIntoMessages, isAbortError, isParsableJson, isUrlSupported, isValidator, jsonSchema, lazySchema, lazyValidator, loadApiKey, loadOptionalSetting, loadSetting, mediaTypeToExtension, parseJSON, parseJsonEventStream, parseProviderOptions, postFormDataToApi, postJsonToApi, postToApi, removeUndefinedEntries, resolve, safeParseJSON, safeValidateTypes, standardSchemaValidator, tool, validateTypes, validator, withUserAgentSuffix, withoutTrailingSlash, zodSchema };