@ai-sdk/provider-utils 3.0.0-beta.1 → 3.0.0-beta.10

package/CHANGELOG.md

@@ -1,5 +1,63 @@
 # @ai-sdk/provider-utils
 
+## 3.0.0-beta.10
+
+### Patch Changes
+
+- 88a8ee5: fix (ai): support abort during retry waits
+
+## 3.0.0-beta.9
+
+### Patch Changes
+
+- Updated dependencies [27deb4d]
+  - @ai-sdk/provider@2.0.0-beta.2
+
+## 3.0.0-beta.8
+
+### Patch Changes
+
+- dd5fd43: feat (ai): support dynamic tools in Chat onToolCall
+
+## 3.0.0-beta.7
+
+### Patch Changes
+
+- e7fcc86: feat (ai): introduce dynamic tools
+
+## 3.0.0-beta.6
+
+### Patch Changes
+
+- ac34802: Add clear object function to StructuredObject
+
+## 3.0.0-beta.5
+
+### Patch Changes
+
+- 57edfcb: Adds support for async zod validators
+- 383cbfa: feat (ai): add isAborted to onFinish callback for ui message streams
+
+## 3.0.0-beta.4
+
+### Patch Changes
+
+- 205077b: fix: improve Zod compatibility
+
+## 3.0.0-beta.3
+
+### Patch Changes
+
+- 05d2819: feat: allow zod 4.x as peer dependency
+
+## 3.0.0-beta.2
+
+### Patch Changes
+
+- 0571b98: chore (provider-utils): update eventsource-parser to 3.0.3
+- 39a4fab: fix (provider-utils): detect failed fetch in browser environments
+- d1a034f: feature: using Zod 4 for internal stuff
+
 ## 3.0.0-beta.1
 
 ### Major Changes

package/dist/index.d.mts

@@ -1,7 +1,7 @@
-import { JSONSchema7, JSONValue, JSONParseError, TypeValidationError, APICallError, SharedV2ProviderOptions, LanguageModelV2ToolResultOutput, LanguageModelV2ToolResultPart } from '@ai-sdk/provider';
-import { ZodSchema, z } from 'zod';
+import { JSONValue, JSONParseError, TypeValidationError, APICallError, 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 * as z4 from 'zod/v4/core';
 import { StandardSchemaV1 } from '@standard-schema/spec';
 export * from '@standard-schema/spec';
 export { EventSourceMessage, EventSourceParserStream } from 'eventsource-parser/stream';
@@ -20,9 +20,13 @@ declare function convertAsyncIteratorToReadableStream<T>(iterator: AsyncIterator
 /**
  * Creates a Promise that resolves after a specified delay
  * @param delayInMs - The delay duration in milliseconds. If null or undefined, resolves immediately.
+ * @param signal - Optional AbortSignal to cancel the delay
  * @returns A Promise that resolves after the specified delay
+ * @throws {DOMException} When the signal is aborted
  */
-declare function delay(delayInMs?: number | null): Promise<void>;
+declare function delay(delayInMs?: number | null, options?: {
+    abortSignal?: AbortSignal;
+}): Promise<void>;
 
 /**
 Extracts the headers from a response object and returns them as a key-value object.
@@ -96,45 +100,8 @@ 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<OBJECT>): Validator<OBJECT>;
-declare function standardSchemaValidator<OBJECT>(standardSchema: StandardSchemaV1<OBJECT>): Validator<OBJECT>;
-
-/**
- * Used to mark schemas so we can support both Zod and custom schemas.
- */
-declare const schemaSymbol: unique symbol;
-type Schema<OBJECT = unknown> = Validator<OBJECT> & {
-    /**
-     * Used to mark schemas so we can support both Zod and custom schemas.
-     */
-    [schemaSymbol]: true;
-    /**
-     * Schema type for inference.
-     */
-    _type: OBJECT;
-    /**
-     * The JSON Schema for the schema. It is passed to the providers.
-     */
-    readonly jsonSchema: JSONSchema7;
-};
-type FlexibleSchema<T> = z4.$ZodType<T> | z3.Schema<T> | Schema<T>;
-type InferSchema<SCHEMA> = SCHEMA extends z3.Schema ? z3.infer<SCHEMA> : SCHEMA extends z4.$ZodType ? z4.infer<SCHEMA> : 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, }?: {
-    validate?: (value: unknown) => {
-        success: true;
-        value: OBJECT;
-    } | {
-        success: false;
-        error: Error;
-    };
-}): Schema<OBJECT>;
-declare function asSchema<OBJECT>(schema: z4.$ZodType<OBJECT, any> | z3.Schema<OBJECT, z3.ZodTypeDef, any> | Schema<OBJECT> | undefined): Schema<OBJECT>;
+declare function asValidator<OBJECT>(value: Validator<OBJECT> | StandardSchemaV1<unknown, OBJECT>): Validator<OBJECT>;
+declare function standardSchemaValidator<OBJECT>(standardSchema: StandardSchemaV1<unknown, OBJECT>): Validator<OBJECT>;
 
 /**
  * Parses a JSON string into an unknown object.
@@ -154,10 +121,10 @@ declare function parseJSON(options: {
  * @param {Validator<T>} schema - The schema to use for parsing the JSON.
  * @returns {Promise<T>} - The parsed object.
  */
-declare function parseJSON<VALIDATOR extends z4.$ZodType | z3.Schema | Validator, VALUE = InferSchema<VALIDATOR>>(options: {
+declare function parseJSON<T>(options: {
     text: string;
-    schema: VALIDATOR;
-}): Promise<VALUE>;
+    schema: z4.core.$ZodType<T> | z3.Schema<T> | Validator<T>;
+}): Promise<T>;
 type ParseResult<T> = {
     success: true;
     value: T;
@@ -185,10 +152,10 @@ declare function safeParseJSON(options: {
  * @param {Validator<T>} schema - The schema to use for parsing the JSON.
  * @returns An object with either a `success` flag and the parsed and typed data, or a `success` flag and an error object.
  */
-declare function safeParseJSON<SCHEMA extends z4.$ZodType | z3.Schema | Validator, VALUE = InferSchema<SCHEMA>>(options: {
+declare function safeParseJSON<T>(options: {
     text: string;
-    schema: SCHEMA;
-}): Promise<ParseResult<VALUE>>;
+    schema: z4.core.$ZodType<T> | z3.Schema<T> | Validator<T>;
+}): Promise<ParseResult<T>>;
 declare function isParsableJson(input: string): boolean;
 
 type ResponseHandler<RETURN_TYPE> = (options: {
@@ -201,13 +168,13 @@ type ResponseHandler<RETURN_TYPE> = (options: {
     responseHeaders?: Record<string, string>;
 }>;
 declare const createJsonErrorResponseHandler: <T>({ errorSchema, errorToMessage, isRetryable, }: {
-    errorSchema: ZodSchema<T>;
+    errorSchema: ZodType<T>;
     errorToMessage: (error: T) => string;
     isRetryable?: (response: Response, error?: T) => boolean;
 }) => ResponseHandler<APICallError>;
-declare const createEventSourceResponseHandler: <T>(chunkSchema: ZodSchema<T>) => ResponseHandler<ReadableStream<ParseResult<T>>>;
-declare const createJsonStreamResponseHandler: <T>(chunkSchema: ZodSchema<T>) => ResponseHandler<ReadableStream<ParseResult<T>>>;
-declare const createJsonResponseHandler: <T>(responseSchema: ZodSchema<T>) => ResponseHandler<T>;
+declare const createEventSourceResponseHandler: <T>(chunkSchema: ZodType<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 createBinaryResponseHandler: () => ResponseHandler<Uint8Array>;
 declare const createStatusCodeErrorResponseHandler: () => ResponseHandler<APICallError>;
 
@@ -283,13 +250,13 @@ declare function loadSetting({ settingValue, environmentVariableName, settingNam
  */
 declare function parseJsonEventStream<T>({ stream, schema, }: {
     stream: ReadableStream<Uint8Array>;
-    schema: ZodSchema<T>;
+    schema: ZodType<T>;
 }): ReadableStream<ParseResult<T>>;
 
 declare function parseProviderOptions<T>({ provider, providerOptions, schema, }: {
     provider: string;
     providerOptions: Record<string, unknown> | undefined;
-    schema: z.ZodSchema<T>;
+    schema: z.core.$ZodType<T, any>;
 }): Promise<T | undefined>;
 
 declare const postJsonToApi: <T>({ url, headers, body, failedResponseHandler, successfulResponseHandler, abortSignal, fetch, }: {
@@ -335,6 +302,37 @@ declare const postToApi: <T>({ url, headers, body, successfulResponseHandler, fa
     responseHeaders?: Record<string, string>;
 }>;
 
+/**
+ * Used to mark schemas so we can support both Zod and custom schemas.
+ */
+declare const schemaSymbol: unique symbol;
+type Schema<OBJECT = unknown> = Validator<OBJECT> & {
+    /**
+     * Used to mark schemas so we can support both Zod and custom schemas.
+     */
+    [schemaSymbol]: true;
+    /**
+     * Schema type for inference.
+     */
+    _type: OBJECT;
+    /**
+     * The JSON Schema for the schema. It is passed to the providers.
+     */
+    readonly jsonSchema: JSONSchema7;
+};
+type FlexibleSchema<T> = z4.core.$ZodType<T> | z3.Schema<T> | 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;
+/**
+ * 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, }?: {
+    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>;
+
 /**
 Additional provider-specific options.
 
@@ -650,12 +648,18 @@ If not provided, the tool will not be executed automatically.
     execute?: never;
 })> & ({
     /**
-Function tool.
+Tool with user-defined input and output schemas.
  */
     type?: undefined | 'function';
 } | {
     /**
-Provider-defined tool.
+Tool that is defined at runtime (e.g. an MCP tool).
+The types of input and output are not known at development time.
+   */
+    type: 'dynamic';
+} | {
+    /**
+Tool with provider-defined input and output schemas.
  */
     type: 'provider-defined';
     /**
@@ -686,6 +690,18 @@ declare function tool<INPUT, OUTPUT>(tool: Tool<INPUT, OUTPUT>): Tool<INPUT, OUT
 declare function tool<INPUT>(tool: Tool<INPUT, never>): Tool<INPUT, never>;
 declare function tool<OUTPUT>(tool: Tool<never, OUTPUT>): Tool<never, OUTPUT>;
 declare function tool(tool: Tool<never, never>): Tool<never, never>;
+/**
+Helper function for defining a dynamic tool.
+ */
+declare function dynamicTool(tool: {
+    description?: string;
+    providerOptions?: ProviderOptions;
+    inputSchema: FlexibleSchema<unknown>;
+    execute: ToolExecuteFunction<unknown, unknown>;
+    toModelOutput?: (output: unknown) => LanguageModelV2ToolResultPart['output'];
+}): Tool<unknown, unknown> & {
+    type: 'dynamic';
+};
 
 type ProviderDefinedToolFactory<INPUT, ARGS extends object> = <OUTPUT>(options: ARGS & {
     execute?: ToolExecuteFunction<INPUT, OUTPUT>;
@@ -742,7 +758,7 @@ declare function convertToBase64(value: string | Uint8Array): string;
  */
 declare function validateTypes<OBJECT>({ value, schema, }: {
     value: unknown;
-    schema: StandardSchemaV1<OBJECT> | Validator<OBJECT>;
+    schema: StandardSchemaV1<unknown, OBJECT> | Validator<OBJECT>;
 }): Promise<OBJECT>;
 /**
  * Safely validates the types of an unknown object using a schema and
@@ -755,7 +771,7 @@ declare function validateTypes<OBJECT>({ value, schema, }: {
  */
 declare function safeValidateTypes<OBJECT>({ value, schema, }: {
     value: unknown;
-    schema: StandardSchemaV1<OBJECT> | Validator<OBJECT>;
+    schema: StandardSchemaV1<unknown, OBJECT> | Validator<OBJECT>;
 }): Promise<{
     success: true;
     value: OBJECT;
@@ -768,7 +784,7 @@ declare function safeValidateTypes<OBJECT>({ value, schema, }: {
 
 declare function withoutTrailingSlash(url: string | undefined): string | undefined;
 
-declare function zodSchema<OBJECT>(zodSchema: z4.$ZodType<OBJECT, any> | z3.Schema<OBJECT, z3.ZodTypeDef, any>, options?: {
+declare function zodSchema<OBJECT>(zodSchema: z4.core.$ZodType<OBJECT, any> | z3.Schema<OBJECT, z3.ZodTypeDef, any>, options?: {
     /**
      * Enables support for references in the schema.
      * This is required for recursive schemas, e.g. with `z.lazy`.
@@ -800,6 +816,10 @@ interface ToolCall<NAME extends string, INPUT> {
      * If this flag is not set or is false, the tool call will be executed by the client.
      */
     providerExecuted?: boolean;
+    /**
+     * Whether the tool is dynamic.
+     */
+    dynamic?: boolean;
 }
 
 /**
@@ -823,6 +843,14 @@ interface ToolResult<NAME extends string, INPUT, OUTPUT> {
   Result of the tool call. This is the result of the tool's execution.
        */
     output: OUTPUT;
+    /**
+     * Whether the tool result has been executed by the provider.
+     */
+    providerExecuted?: boolean;
+    /**
+     * Whether the tool is dynamic.
+     */
+    dynamic?: boolean;
 }
 
-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, type ValidationResult, type Validator, asSchema, asValidator, combineHeaders, convertAsyncIteratorToReadableStream, convertBase64ToUint8Array, convertToBase64, convertUint8ArrayToBase64, createBinaryResponseHandler, createEventSourceResponseHandler, createIdGenerator, createJsonErrorResponseHandler, createJsonResponseHandler, createJsonStreamResponseHandler, createProviderDefinedToolFactory, createProviderDefinedToolFactoryWithOutputSchema, createStatusCodeErrorResponseHandler, delay, extractResponseHeaders, generateId, getErrorMessage, getFromApi, isAbortError, isParsableJson, isUrlSupported, isValidator, jsonSchema, loadApiKey, loadOptionalSetting, loadSetting, parseJSON, parseJsonEventStream, parseProviderOptions, postFormDataToApi, postJsonToApi, postToApi, removeUndefinedEntries, resolve, safeParseJSON, safeValidateTypes, standardSchemaValidator, tool, validateTypes, validator, validatorSymbol, withoutTrailingSlash, zodSchema };
+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, type ValidationResult, type Validator, asSchema, asValidator, combineHeaders, convertAsyncIteratorToReadableStream, convertBase64ToUint8Array, convertToBase64, convertUint8ArrayToBase64, createBinaryResponseHandler, createEventSourceResponseHandler, createIdGenerator, createJsonErrorResponseHandler, createJsonResponseHandler, createJsonStreamResponseHandler, createProviderDefinedToolFactory, createProviderDefinedToolFactoryWithOutputSchema, createStatusCodeErrorResponseHandler, delay, dynamicTool, extractResponseHeaders, generateId, getErrorMessage, getFromApi, isAbortError, isParsableJson, isUrlSupported, isValidator, jsonSchema, loadApiKey, loadOptionalSetting, loadSetting, parseJSON, parseJsonEventStream, parseProviderOptions, postFormDataToApi, postJsonToApi, postToApi, removeUndefinedEntries, resolve, safeParseJSON, safeValidateTypes, standardSchemaValidator, tool, validateTypes, validator, validatorSymbol, withoutTrailingSlash, zodSchema };

package/dist/index.d.ts

@@ -1,7 +1,7 @@
-import { JSONSchema7, JSONValue, JSONParseError, TypeValidationError, APICallError, SharedV2ProviderOptions, LanguageModelV2ToolResultOutput, LanguageModelV2ToolResultPart } from '@ai-sdk/provider';
-import { ZodSchema, z } from 'zod';
+import { JSONValue, JSONParseError, TypeValidationError, APICallError, 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 * as z4 from 'zod/v4/core';
 import { StandardSchemaV1 } from '@standard-schema/spec';
 export * from '@standard-schema/spec';
 export { EventSourceMessage, EventSourceParserStream } from 'eventsource-parser/stream';
@@ -20,9 +20,13 @@ declare function convertAsyncIteratorToReadableStream<T>(iterator: AsyncIterator
 /**
  * Creates a Promise that resolves after a specified delay
  * @param delayInMs - The delay duration in milliseconds. If null or undefined, resolves immediately.
+ * @param signal - Optional AbortSignal to cancel the delay
  * @returns A Promise that resolves after the specified delay
+ * @throws {DOMException} When the signal is aborted
  */
-declare function delay(delayInMs?: number | null): Promise<void>;
+declare function delay(delayInMs?: number | null, options?: {
+    abortSignal?: AbortSignal;
+}): Promise<void>;
 
 /**
 Extracts the headers from a response object and returns them as a key-value object.
@@ -96,45 +100,8 @@ 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<OBJECT>): Validator<OBJECT>;
-declare function standardSchemaValidator<OBJECT>(standardSchema: StandardSchemaV1<OBJECT>): Validator<OBJECT>;
-
-/**
- * Used to mark schemas so we can support both Zod and custom schemas.
- */
-declare const schemaSymbol: unique symbol;
-type Schema<OBJECT = unknown> = Validator<OBJECT> & {
-    /**
-     * Used to mark schemas so we can support both Zod and custom schemas.
-     */
-    [schemaSymbol]: true;
-    /**
-     * Schema type for inference.
-     */
-    _type: OBJECT;
-    /**
-     * The JSON Schema for the schema. It is passed to the providers.
-     */
-    readonly jsonSchema: JSONSchema7;
-};
-type FlexibleSchema<T> = z4.$ZodType<T> | z3.Schema<T> | Schema<T>;
-type InferSchema<SCHEMA> = SCHEMA extends z3.Schema ? z3.infer<SCHEMA> : SCHEMA extends z4.$ZodType ? z4.infer<SCHEMA> : 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, }?: {
-    validate?: (value: unknown) => {
-        success: true;
-        value: OBJECT;
-    } | {
-        success: false;
-        error: Error;
-    };
-}): Schema<OBJECT>;
-declare function asSchema<OBJECT>(schema: z4.$ZodType<OBJECT, any> | z3.Schema<OBJECT, z3.ZodTypeDef, any> | Schema<OBJECT> | undefined): Schema<OBJECT>;
+declare function asValidator<OBJECT>(value: Validator<OBJECT> | StandardSchemaV1<unknown, OBJECT>): Validator<OBJECT>;
+declare function standardSchemaValidator<OBJECT>(standardSchema: StandardSchemaV1<unknown, OBJECT>): Validator<OBJECT>;
 
 /**
  * Parses a JSON string into an unknown object.
@@ -154,10 +121,10 @@ declare function parseJSON(options: {
  * @param {Validator<T>} schema - The schema to use for parsing the JSON.
  * @returns {Promise<T>} - The parsed object.
  */
-declare function parseJSON<VALIDATOR extends z4.$ZodType | z3.Schema | Validator, VALUE = InferSchema<VALIDATOR>>(options: {
+declare function parseJSON<T>(options: {
     text: string;
-    schema: VALIDATOR;
-}): Promise<VALUE>;
+    schema: z4.core.$ZodType<T> | z3.Schema<T> | Validator<T>;
+}): Promise<T>;
 type ParseResult<T> = {
     success: true;
     value: T;
@@ -185,10 +152,10 @@ declare function safeParseJSON(options: {
  * @param {Validator<T>} schema - The schema to use for parsing the JSON.
  * @returns An object with either a `success` flag and the parsed and typed data, or a `success` flag and an error object.
  */
-declare function safeParseJSON<SCHEMA extends z4.$ZodType | z3.Schema | Validator, VALUE = InferSchema<SCHEMA>>(options: {
+declare function safeParseJSON<T>(options: {
     text: string;
-    schema: SCHEMA;
-}): Promise<ParseResult<VALUE>>;
+    schema: z4.core.$ZodType<T> | z3.Schema<T> | Validator<T>;
+}): Promise<ParseResult<T>>;
 declare function isParsableJson(input: string): boolean;
 
 type ResponseHandler<RETURN_TYPE> = (options: {
@@ -201,13 +168,13 @@ type ResponseHandler<RETURN_TYPE> = (options: {
     responseHeaders?: Record<string, string>;
 }>;
 declare const createJsonErrorResponseHandler: <T>({ errorSchema, errorToMessage, isRetryable, }: {
-    errorSchema: ZodSchema<T>;
+    errorSchema: ZodType<T>;
     errorToMessage: (error: T) => string;
     isRetryable?: (response: Response, error?: T) => boolean;
 }) => ResponseHandler<APICallError>;
-declare const createEventSourceResponseHandler: <T>(chunkSchema: ZodSchema<T>) => ResponseHandler<ReadableStream<ParseResult<T>>>;
-declare const createJsonStreamResponseHandler: <T>(chunkSchema: ZodSchema<T>) => ResponseHandler<ReadableStream<ParseResult<T>>>;
-declare const createJsonResponseHandler: <T>(responseSchema: ZodSchema<T>) => ResponseHandler<T>;
+declare const createEventSourceResponseHandler: <T>(chunkSchema: ZodType<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 createBinaryResponseHandler: () => ResponseHandler<Uint8Array>;
 declare const createStatusCodeErrorResponseHandler: () => ResponseHandler<APICallError>;
 
@@ -283,13 +250,13 @@ declare function loadSetting({ settingValue, environmentVariableName, settingNam
  */
 declare function parseJsonEventStream<T>({ stream, schema, }: {
     stream: ReadableStream<Uint8Array>;
-    schema: ZodSchema<T>;
+    schema: ZodType<T>;
 }): ReadableStream<ParseResult<T>>;
 
 declare function parseProviderOptions<T>({ provider, providerOptions, schema, }: {
     provider: string;
     providerOptions: Record<string, unknown> | undefined;
-    schema: z.ZodSchema<T>;
+    schema: z.core.$ZodType<T, any>;
 }): Promise<T | undefined>;
 
 declare const postJsonToApi: <T>({ url, headers, body, failedResponseHandler, successfulResponseHandler, abortSignal, fetch, }: {
@@ -335,6 +302,37 @@ declare const postToApi: <T>({ url, headers, body, successfulResponseHandler, fa
     responseHeaders?: Record<string, string>;
 }>;
 
+/**
+ * Used to mark schemas so we can support both Zod and custom schemas.
+ */
+declare const schemaSymbol: unique symbol;
+type Schema<OBJECT = unknown> = Validator<OBJECT> & {
+    /**
+     * Used to mark schemas so we can support both Zod and custom schemas.
+     */
+    [schemaSymbol]: true;
+    /**
+     * Schema type for inference.
+     */
+    _type: OBJECT;
+    /**
+     * The JSON Schema for the schema. It is passed to the providers.
+     */
+    readonly jsonSchema: JSONSchema7;
+};
+type FlexibleSchema<T> = z4.core.$ZodType<T> | z3.Schema<T> | 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;
+/**
+ * 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, }?: {
+    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>;
+
 /**
 Additional provider-specific options.
 
@@ -650,12 +648,18 @@ If not provided, the tool will not be executed automatically.
     execute?: never;
 })> & ({
     /**
-Function tool.
+Tool with user-defined input and output schemas.
  */
     type?: undefined | 'function';
 } | {
     /**
-Provider-defined tool.
+Tool that is defined at runtime (e.g. an MCP tool).
+The types of input and output are not known at development time.
+   */
+    type: 'dynamic';
+} | {
+    /**
+Tool with provider-defined input and output schemas.
  */
     type: 'provider-defined';
     /**
@@ -686,6 +690,18 @@ declare function tool<INPUT, OUTPUT>(tool: Tool<INPUT, OUTPUT>): Tool<INPUT, OUT
 declare function tool<INPUT>(tool: Tool<INPUT, never>): Tool<INPUT, never>;
 declare function tool<OUTPUT>(tool: Tool<never, OUTPUT>): Tool<never, OUTPUT>;
 declare function tool(tool: Tool<never, never>): Tool<never, never>;
+/**
+Helper function for defining a dynamic tool.
+ */
+declare function dynamicTool(tool: {
+    description?: string;
+    providerOptions?: ProviderOptions;
+    inputSchema: FlexibleSchema<unknown>;
+    execute: ToolExecuteFunction<unknown, unknown>;
+    toModelOutput?: (output: unknown) => LanguageModelV2ToolResultPart['output'];
+}): Tool<unknown, unknown> & {
+    type: 'dynamic';
+};
 
 type ProviderDefinedToolFactory<INPUT, ARGS extends object> = <OUTPUT>(options: ARGS & {
     execute?: ToolExecuteFunction<INPUT, OUTPUT>;
@@ -742,7 +758,7 @@ declare function convertToBase64(value: string | Uint8Array): string;
  */
 declare function validateTypes<OBJECT>({ value, schema, }: {
     value: unknown;
-    schema: StandardSchemaV1<OBJECT> | Validator<OBJECT>;
+    schema: StandardSchemaV1<unknown, OBJECT> | Validator<OBJECT>;
 }): Promise<OBJECT>;
 /**
  * Safely validates the types of an unknown object using a schema and
@@ -755,7 +771,7 @@ declare function validateTypes<OBJECT>({ value, schema, }: {
  */
 declare function safeValidateTypes<OBJECT>({ value, schema, }: {
     value: unknown;
-    schema: StandardSchemaV1<OBJECT> | Validator<OBJECT>;
+    schema: StandardSchemaV1<unknown, OBJECT> | Validator<OBJECT>;
 }): Promise<{
     success: true;
     value: OBJECT;
@@ -768,7 +784,7 @@ declare function safeValidateTypes<OBJECT>({ value, schema, }: {
 
 declare function withoutTrailingSlash(url: string | undefined): string | undefined;
 
-declare function zodSchema<OBJECT>(zodSchema: z4.$ZodType<OBJECT, any> | z3.Schema<OBJECT, z3.ZodTypeDef, any>, options?: {
+declare function zodSchema<OBJECT>(zodSchema: z4.core.$ZodType<OBJECT, any> | z3.Schema<OBJECT, z3.ZodTypeDef, any>, options?: {
     /**
      * Enables support for references in the schema.
      * This is required for recursive schemas, e.g. with `z.lazy`.
@@ -800,6 +816,10 @@ interface ToolCall<NAME extends string, INPUT> {
      * If this flag is not set or is false, the tool call will be executed by the client.
      */
     providerExecuted?: boolean;
+    /**
+     * Whether the tool is dynamic.
+     */
+    dynamic?: boolean;
 }
 
 /**
@@ -823,6 +843,14 @@ interface ToolResult<NAME extends string, INPUT, OUTPUT> {
   Result of the tool call. This is the result of the tool's execution.
        */
     output: OUTPUT;
+    /**
+     * Whether the tool result has been executed by the provider.
+     */
+    providerExecuted?: boolean;
+    /**
+     * Whether the tool is dynamic.
+     */
+    dynamic?: boolean;
 }
 
-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, type ValidationResult, type Validator, asSchema, asValidator, combineHeaders, convertAsyncIteratorToReadableStream, convertBase64ToUint8Array, convertToBase64, convertUint8ArrayToBase64, createBinaryResponseHandler, createEventSourceResponseHandler, createIdGenerator, createJsonErrorResponseHandler, createJsonResponseHandler, createJsonStreamResponseHandler, createProviderDefinedToolFactory, createProviderDefinedToolFactoryWithOutputSchema, createStatusCodeErrorResponseHandler, delay, extractResponseHeaders, generateId, getErrorMessage, getFromApi, isAbortError, isParsableJson, isUrlSupported, isValidator, jsonSchema, loadApiKey, loadOptionalSetting, loadSetting, parseJSON, parseJsonEventStream, parseProviderOptions, postFormDataToApi, postJsonToApi, postToApi, removeUndefinedEntries, resolve, safeParseJSON, safeValidateTypes, standardSchemaValidator, tool, validateTypes, validator, validatorSymbol, withoutTrailingSlash, zodSchema };
+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, type ValidationResult, type Validator, asSchema, asValidator, combineHeaders, convertAsyncIteratorToReadableStream, convertBase64ToUint8Array, convertToBase64, convertUint8ArrayToBase64, createBinaryResponseHandler, createEventSourceResponseHandler, createIdGenerator, createJsonErrorResponseHandler, createJsonResponseHandler, createJsonStreamResponseHandler, createProviderDefinedToolFactory, createProviderDefinedToolFactoryWithOutputSchema, createStatusCodeErrorResponseHandler, delay, dynamicTool, extractResponseHeaders, generateId, getErrorMessage, getFromApi, isAbortError, isParsableJson, isUrlSupported, isValidator, jsonSchema, loadApiKey, loadOptionalSetting, loadSetting, parseJSON, parseJsonEventStream, parseProviderOptions, postFormDataToApi, postJsonToApi, postToApi, removeUndefinedEntries, resolve, safeParseJSON, safeValidateTypes, standardSchemaValidator, tool, validateTypes, validator, validatorSymbol, withoutTrailingSlash, zodSchema };