@mastra/ai-sdk 1.10.4 → 1.10.5-alpha.0

package/dist/_types/@internal_ai-v6/dist/index.d.ts

@@ -234,6 +234,7 @@ declare namespace _ai_sdk_provider_utils {
         DataContent,
         DelayedPromise,
         DownloadError,
+        EMBEDDING_MODEL_MAX_INPUT_BYTES_PER_CALL as EXPERIMENTAL_EMBEDDING_MODEL_MAX_INPUT_BYTES_PER_CALL,
         FetchFunction,
         FilePart,
         FlexibleSchema,
@@ -379,6 +380,38 @@ export declare class AISDKError extends Error {
     protected static hasMarker(error: unknown, marker: string): boolean;
 }
 
+/**
+ * Custom error class for AI SDK related errors.
+ * @extends Error
+ */
+declare class AISDKError_2 extends Error {
+    private readonly [symbol$d_2];
+    /**
+     * The underlying cause of the error, if any.
+     */
+    readonly cause?: unknown;
+    /**
+     * Creates an AI SDK Error.
+     *
+     * @param {Object} params - The parameters for creating the error.
+     * @param {string} params.name - The name of the error.
+     * @param {string} params.message - The error message.
+     * @param {unknown} [params.cause] - The underlying cause of the error.
+     */
+    constructor({ name, message, cause, }: {
+        name: string;
+        message: string;
+        cause?: unknown;
+    });
+    /**
+     * Checks if the given error is an AI SDK Error.
+     * @param {unknown} error - The error to check.
+     * @returns {boolean} True if the error is an AI SDK Error, false otherwise.
+     */
+    static isInstance(error: unknown): error is AISDKError_2;
+    protected static hasMarker(error: unknown, marker: string): boolean;
+}
+
 export declare class APICallError extends AISDKError {
     private readonly [symbol$c];
     readonly url: string;
@@ -403,6 +436,30 @@ export declare class APICallError extends AISDKError {
     static isInstance(error: unknown): error is APICallError;
 }
 
+declare class APICallError_2 extends AISDKError_2 {
+    private readonly [symbol$c_2];
+    readonly url: string;
+    readonly requestBodyValues: unknown;
+    readonly statusCode?: number;
+    readonly responseHeaders?: Record<string, string>;
+    readonly responseBody?: string;
+    readonly isRetryable: boolean;
+    readonly data?: unknown;
+    constructor({ message, url, requestBodyValues, statusCode, responseHeaders, responseBody, cause, isRetryable, // server error
+        data, }: {
+        message: string;
+        url: string;
+        requestBodyValues: unknown;
+        statusCode?: number;
+        responseHeaders?: Record<string, string>;
+        responseBody?: string;
+        cause?: unknown;
+        isRetryable?: boolean;
+        data?: unknown;
+    });
+    static isInstance(error: unknown): error is APICallError_2;
+}
+
 export declare function asSchema<OBJECT>(schema: FlexibleSchema<OBJECT> | undefined): Schema<OBJECT>;
 
 /**
@@ -926,7 +983,7 @@ export declare function convertFileListToFileUIParts(files: FileList | undefined
  * If the file is base64 data, it returns a data URI with the base64 data.
  * If the file is a Uint8Array, it converts it to base64 and returns a data URI.
  */
-declare function convertImageModelFileToDataUri(file: ImageModelV3File): string;
+declare function convertImageModelFileToDataUri(file: ImageModelV3File_2): string;
 
 declare function convertToBase64(value: string | Uint8Array): string;
 
@@ -1094,7 +1151,7 @@ declare const createJsonErrorResponseHandler: <T>({ errorSchema, errorToMessage,
     errorSchema: FlexibleSchema<T>;
     errorToMessage: (error: T) => string;
     isRetryable?: (response: Response, error?: T) => boolean;
-}) => ResponseHandler<APICallError>;
+}) => ResponseHandler<APICallError_2>;
 
 declare const createJsonResponseHandler: <T>(responseSchema: FlexibleSchema<T>) => ResponseHandler<T>;
 
@@ -1139,7 +1196,7 @@ declare function createProviderToolFactoryWithOutputSchema<INPUT, OUTPUT, ARGS e
     supportsDeferredResults?: boolean;
 }): ProviderToolFactoryWithOutputSchema<INPUT, OUTPUT, ARGS>;
 
-declare const createStatusCodeErrorResponseHandler: () => ResponseHandler<APICallError>;
+declare const createStatusCodeErrorResponseHandler: () => ResponseHandler<APICallError_2>;
 
 /**
  * Creates a Response object from a text stream.
@@ -1165,7 +1222,7 @@ declare function createToolNameMapping({ tools, providerToolNames, resolveProvid
     /**
      * Tools that were passed to the language model.
      */
-    tools: Array<LanguageModelV3FunctionTool | LanguageModelV3ProviderTool> | undefined;
+    tools: Array<LanguageModelV3FunctionTool_2 | LanguageModelV3ProviderTool_2> | undefined;
     /**
      * Maps the provider tool ids to the provider tool names.
      */
@@ -1174,7 +1231,7 @@ declare function createToolNameMapping({ tools, providerToolNames, resolveProvid
      * Optional resolver for provider tool names that cannot be represented as
      * static id -> name mappings (e.g. dynamic provider names).
      */
-    resolveProviderToolName?: (tool: LanguageModelV3ProviderTool) => string | undefined;
+    resolveProviderToolName?: (tool: LanguageModelV3ProviderTool_2) => string | undefined;
 }): ToolNameMapping;
 
 export declare type CreateUIMessage<UI_MESSAGE extends UIMessage> = Omit<UI_MESSAGE, 'id' | 'role'> & {
@@ -1450,7 +1507,7 @@ declare function downloadBlob(url: string, options?: {
     abortSignal?: AbortSignal;
 }): Promise<Blob>;
 
-export declare class DownloadError extends AISDKError {
+export declare class DownloadError extends AISDKError_2 {
     private readonly [symbol_2];
     readonly url: string;
     readonly statusCode?: number;
@@ -1472,7 +1529,7 @@ export declare function dynamicTool(tool: {
     description?: string;
     title?: string;
     providerOptions?: ProviderOptions;
-    metadata?: JSONObject;
+    metadata?: JSONObject_2;
     inputSchema: FlexibleSchema<unknown>;
     execute: ToolExecuteFunction<unknown, unknown>;
     /**
@@ -1699,6 +1756,14 @@ export declare function embed({ model: modelArg, value, providerOptions, maxRetr
  */
 export declare type Embedding = EmbeddingModelV3Embedding;
 
+/**
+ * Symbol for exposing the UTF-8 input byte budget of an embedding model.
+ *
+ * This capability is experimental and intentionally lives outside the versioned
+ * embedding model specification.
+ */
+declare const EMBEDDING_MODEL_MAX_INPUT_BYTES_PER_CALL: unique symbol;
+
 /**
  * Embedding model that is used by the AI SDK.
  */
@@ -2814,6 +2879,11 @@ declare type FetchFunction = typeof globalThis.fetch;
  * The returned response is the final (non-redirect) response. The caller is
  * responsible for checking `response.ok` and reading the body.
  *
+ * On Node.js, the default fetch resolves every hostname through a validating
+ * lookup hook and passes those exact addresses to the connector, preventing
+ * hostname-to-private-IP and DNS-rebinding bypasses. Other runtimes should
+ * constrain egress at the network layer when handling untrusted URLs.
+ *
  * @throws DownloadError if a hop is unsafe, the redirect limit is exceeded, or
  * a redirect cannot be validated on a non-browser runtime.
  */
@@ -4492,6 +4562,42 @@ declare type ImageModelV3File = {
     providerOptions?: SharedV3ProviderMetadata;
 };
 
+/**
+ * An image file that can be used for image editing or variation generation.
+ */
+declare type ImageModelV3File_2 = {
+    type: 'file';
+    /**
+     * The IANA media type of the file, e.g. `image/png`. Any string is supported.
+     *
+     * @see https://www.iana.org/assignments/media-types/media-types.xhtml
+     */
+    mediaType: string;
+    /**
+     * Generated file data as base64 encoded strings or binary data.
+     *
+     * The file data should be returned without any unnecessary conversion.
+     * If the API returns base64 encoded strings, the file data should be returned
+     * as base64 encoded strings. If the API returns binary data, the file data should
+     * be returned as binary data.
+     */
+    data: string | Uint8Array;
+    /**
+     * Optional provider-specific metadata for the file part.
+     */
+    providerOptions?: SharedV3ProviderMetadata_2;
+} | {
+    type: 'url';
+    /**
+     * The URL of the image file.
+     */
+    url: string;
+    /**
+     * Optional provider-specific metadata for the file part.
+     */
+    providerOptions?: SharedV3ProviderMetadata_2;
+};
+
 /**
  * Middleware for ImageModelV3.
  * This type defines the structure for middleware that can be used to modify
@@ -4675,11 +4781,11 @@ export declare type InferUITools<TOOLS extends ToolSet> = {
 };
 
 declare function injectJsonInstructionIntoMessages({ messages, schema, schemaPrefix, schemaSuffix, }: {
-    messages: LanguageModelV3Prompt;
+    messages: LanguageModelV3Prompt_2;
     schema?: JSONSchema7;
     schemaPrefix?: string;
     schemaSuffix?: string;
-}): LanguageModelV3Prompt;
+}): LanguageModelV3Prompt_2;
 
 export declare class InvalidArgumentError extends AISDKError {
     private readonly [symbol$i];
@@ -4904,10 +5010,16 @@ declare type Job = () => Promise<void>;
 
 declare type JSONArray = JSONValue_2[];
 
+declare type JSONArray_2 = JSONValue_3[];
+
 declare type JSONObject = {
     [key: string]: JSONValue_2 | undefined;
 };
 
+declare type JSONObject_2 = {
+    [key: string]: JSONValue_3 | undefined;
+};
+
 export declare class JSONParseError extends AISDKError {
     private readonly [symbol$7];
     readonly text: string;
@@ -4918,6 +5030,16 @@ export declare class JSONParseError extends AISDKError {
     static isInstance(error: unknown): error is JSONParseError;
 }
 
+declare class JSONParseError_2 extends AISDKError_2 {
+    private readonly [symbol$7_2];
+    readonly text: string;
+    constructor({ text, cause }: {
+        text: string;
+        cause: unknown;
+    });
+    static isInstance(error: unknown): error is JSONParseError_2;
+}
+
 /**
  * Create a schema using a JSON Schema.
  *
@@ -4947,6 +5069,12 @@ export declare type JSONValue = JSONValue_2;
  */
 declare type JSONValue_2 = null | string | number | boolean | JSONObject | JSONArray;
 
+/**
+ * A JSON value can be a string, number, boolean, object, array, or null.
+ * JSON values can be serialized and deserialized by the JSON.stringify and JSON.parse methods.
+ */
+declare type JSONValue_3 = null | string | number | boolean | JSONObject_2 | JSONArray_2;
+
 declare const KNOWN_MODEL_TYPES: readonly ["embedding", "image", "language", "reranking", "speech", "transcription", "video"];
 
 declare type KnownModelType = (typeof KNOWN_MODEL_TYPES)[number];
@@ -5969,6 +6097,11 @@ declare type LanguageModelV3Content = LanguageModelV3Text | LanguageModelV3Reaso
  */
 declare type LanguageModelV3DataContent = Uint8Array | string | URL;
 
+/**
+ * Data content. Can be a Uint8Array, base64 encoded data as a string or a URL.
+ */
+declare type LanguageModelV3DataContent_2 = Uint8Array | string | URL;
+
 /**
  * A file that has been generated by the model.
  * Generated files as base64 encoded strings or binary data.
@@ -6026,6 +6159,42 @@ declare interface LanguageModelV3FilePart {
     providerOptions?: SharedV3ProviderOptions;
 }
 
+/**
+ * File content part of a prompt. It contains a file.
+ */
+declare interface LanguageModelV3FilePart_2 {
+    type: 'file';
+    /**
+     * Optional filename of the file.
+     */
+    filename?: string;
+    /**
+     * File data. Can be a Uint8Array, base64 encoded data as a string or a URL.
+     */
+    data: LanguageModelV3DataContent_2;
+    /**
+     * The original URL string before it was parsed into a URL.
+     *
+     * This is available when parsing changes the string and a provider needs to
+     * preserve an opaque non-HTTP URI exactly.
+     */
+    originalUrl?: string;
+    /**
+     * IANA media type of the file.
+     *
+     * Can support wildcards, e.g. `image/*` (in which case the provider needs to take appropriate action).
+     *
+     * @see https://www.iana.org/assignments/media-types/media-types.xhtml
+     */
+    mediaType: string;
+    /**
+     * Additional provider-specific options. They are passed through
+     * to the provider from the AI SDK and enable provider-specific
+     * functionality that can be fully encapsulated in the provider.
+     */
+    providerOptions?: SharedV3ProviderOptions_2;
+}
+
 /**
  * Reason why a language model finished generating a response.
  *
@@ -6099,6 +6268,52 @@ declare type LanguageModelV3FunctionTool = {
     providerOptions?: SharedV3ProviderOptions;
 };
 
+/**
+ * A tool has a name, a description, and a set of parameters.
+ *
+ * Note: this is **not** the user-facing tool definition. The AI SDK methods will
+ * map the user-facing tool definitions to this format.
+ */
+declare type LanguageModelV3FunctionTool_2 = {
+    /**
+     * The type of the tool (always 'function').
+     */
+    type: 'function';
+    /**
+     * The name of the tool. Unique within this model call.
+     */
+    name: string;
+    /**
+     * A description of the tool. The language model uses this to understand the
+     * tool's purpose and to provide better completion suggestions.
+     */
+    description?: string;
+    /**
+     * The parameters that the tool expects. The language model uses this to
+     * understand the tool's input requirements and to provide matching suggestions.
+     */
+    inputSchema: JSONSchema7;
+    /**
+     * An optional list of input examples that show the language
+     * model what the input should look like.
+     */
+    inputExamples?: Array<{
+        input: JSONObject_2;
+    }>;
+    /**
+     * Strict mode setting for the tool.
+     *
+     * Providers that support strict mode will use this setting to determine
+     * how the input should be generated. Strict mode will always produce
+     * valid inputs, but it might limit what input schemas are supported.
+     */
+    strict?: boolean;
+    /**
+     * The provider-specific options for the tool.
+     */
+    providerOptions?: SharedV3ProviderOptions_2;
+};
+
 /**
  * The result of a language model doGenerate call.
  */
@@ -6170,6 +6385,27 @@ declare type LanguageModelV3Message = ({
     providerOptions?: SharedV3ProviderOptions;
 };
 
+declare type LanguageModelV3Message_2 = ({
+    role: 'system';
+    content: string;
+} | {
+    role: 'user';
+    content: Array<LanguageModelV3TextPart_2 | LanguageModelV3FilePart_2>;
+} | {
+    role: 'assistant';
+    content: Array<LanguageModelV3TextPart_2 | LanguageModelV3FilePart_2 | LanguageModelV3ReasoningPart_2 | LanguageModelV3ToolCallPart_2 | LanguageModelV3ToolResultPart_2>;
+} | {
+    role: 'tool';
+    content: Array<LanguageModelV3ToolResultPart_2 | LanguageModelV3ToolApprovalResponsePart_2>;
+}) & {
+    /**
+     * Additional provider-specific options. They are passed through
+     * to the provider from the AI SDK and enable provider-specific
+     * functionality that can be fully encapsulated in the provider.
+     */
+    providerOptions?: SharedV3ProviderOptions_2;
+};
+
 /**
  * Experimental middleware for LanguageModelV3.
  * This type defines the structure for middleware that can be used to modify
@@ -6259,6 +6495,17 @@ declare type LanguageModelV3Middleware = {
  */
 declare type LanguageModelV3Prompt = Array<LanguageModelV3Message>;
 
+/**
+ * A prompt is a list of messages.
+ *
+ * Note: Not all models and prompt formats support multi-modal inputs and
+ * tool calls. The validation happens at runtime.
+ *
+ * Note: This is not a user-facing prompt. The AI SDK methods will map the
+ * user-facing prompt types such as chat or instruction prompts to this format.
+ */
+declare type LanguageModelV3Prompt_2 = Array<LanguageModelV3Message_2>;
+
 /**
  * The configuration of a provider tool.
  *
@@ -6285,6 +6532,32 @@ declare type LanguageModelV3ProviderTool = {
     args: Record<string, unknown>;
 };
 
+/**
+ * The configuration of a provider tool.
+ *
+ * Provider tools are tools that are specific to a certain provider.
+ * The input and output schemas are defined be the provider, and
+ * some of the tools are also executed on the provider systems.
+ */
+declare type LanguageModelV3ProviderTool_2 = {
+    /**
+     * The type of the tool (always 'provider').
+     */
+    type: 'provider';
+    /**
+     * The ID of the tool. Should follow the format `<provider-id>.<unique-tool-name>`.
+     */
+    id: `${string}.${string}`;
+    /**
+     * The name of the tool. Unique within this model call.
+     */
+    name: string;
+    /**
+     * The arguments for configuring the tool. Must match the expected arguments defined by the provider for this tool.
+     */
+    args: Record<string, unknown>;
+};
+
 /**
  * Reasoning that the model has generated.
  */
@@ -6314,6 +6587,23 @@ declare interface LanguageModelV3ReasoningPart {
     providerOptions?: SharedV3ProviderOptions;
 }
 
+/**
+ * Reasoning content part of a prompt. It contains a string of reasoning text.
+ */
+declare interface LanguageModelV3ReasoningPart_2 {
+    type: 'reasoning';
+    /**
+     * The reasoning text.
+     */
+    text: string;
+    /**
+     * Additional provider-specific options. They are passed through
+     * to the provider from the AI SDK and enable provider-specific
+     * functionality that can be fully encapsulated in the provider.
+     */
+    providerOptions?: SharedV3ProviderOptions_2;
+}
+
 declare interface LanguageModelV3ResponseMetadata {
     /**
      * ID for the generated response, if the provider sends one.
@@ -6501,13 +6791,30 @@ declare interface LanguageModelV3TextPart {
 }
 
 /**
- * Tool approval request emitted by a provider for a provider-executed tool call.
- *
- * This is used for flows where the provider executes the tool (e.g. MCP tools)
- * but requires an explicit user approval before continuing.
+ * Text content part of a prompt. It contains a string of text.
  */
-declare type LanguageModelV3ToolApprovalRequest = {
-    type: 'tool-approval-request';
+declare interface LanguageModelV3TextPart_2 {
+    type: 'text';
+    /**
+     * The text content.
+     */
+    text: string;
+    /**
+     * Additional provider-specific options. They are passed through
+     * to the provider from the AI SDK and enable provider-specific
+     * functionality that can be fully encapsulated in the provider.
+     */
+    providerOptions?: SharedV3ProviderOptions_2;
+}
+
+/**
+ * Tool approval request emitted by a provider for a provider-executed tool call.
+ *
+ * This is used for flows where the provider executes the tool (e.g. MCP tools)
+ * but requires an explicit user approval before continuing.
+ */
+declare type LanguageModelV3ToolApprovalRequest = {
+    type: 'tool-approval-request';
     /**
      * ID of the approval request. This ID is referenced by the subsequent
      * tool-approval-response (tool message) to approve or deny execution.
@@ -6549,6 +6856,32 @@ declare interface LanguageModelV3ToolApprovalResponsePart {
     providerOptions?: SharedV3ProviderOptions;
 }
 
+/**
+ * Tool approval response content part of a prompt. It contains the user's
+ * decision to approve or deny a provider-executed tool call.
+ */
+declare interface LanguageModelV3ToolApprovalResponsePart_2 {
+    type: 'tool-approval-response';
+    /**
+     * ID of the approval request that this response refers to.
+     */
+    approvalId: string;
+    /**
+     * Whether the approval was granted (true) or denied (false).
+     */
+    approved: boolean;
+    /**
+     * Optional reason for approval or denial.
+     */
+    reason?: string;
+    /**
+     * Additional provider-specific options. They are passed through
+     * to the provider from the AI SDK and enable provider-specific
+     * functionality that can be fully encapsulated in the provider.
+     */
+    providerOptions?: SharedV3ProviderOptions_2;
+}
+
 /**
  * Tool calls that the model has generated.
  */
@@ -6613,6 +6946,36 @@ declare interface LanguageModelV3ToolCallPart {
     providerOptions?: SharedV3ProviderOptions;
 }
 
+/**
+ * Tool call content part of a prompt. It contains a tool call (usually generated by the AI model).
+ */
+declare interface LanguageModelV3ToolCallPart_2 {
+    type: 'tool-call';
+    /**
+     * ID of the tool call. This ID is used to match the tool call with the tool result.
+     */
+    toolCallId: string;
+    /**
+     * Name of the tool that is being called.
+     */
+    toolName: string;
+    /**
+     * Arguments of the tool call. This is a JSON-serializable object that matches the tool's input schema.
+     */
+    input: unknown;
+    /**
+     * Whether the tool call will be executed by the provider.
+     * If this flag is not set or is false, the tool call will be executed by the client.
+     */
+    providerExecuted?: boolean;
+    /**
+     * Additional provider-specific options. They are passed through
+     * to the provider from the AI SDK and enable provider-specific
+     * functionality that can be fully encapsulated in the provider.
+     */
+    providerOptions?: SharedV3ProviderOptions_2;
+}
+
 declare type LanguageModelV3ToolChoice = {
     type: 'auto';
 } | {
@@ -6831,6 +7194,171 @@ declare type LanguageModelV3ToolResultOutput = {
     }>;
 };
 
+/**
+ * Result of a tool call.
+ */
+declare type LanguageModelV3ToolResultOutput_2 = {
+    /**
+     * Text tool output that should be directly sent to the API.
+     */
+    type: 'text';
+    value: string;
+    /**
+     * Provider-specific options.
+     */
+    providerOptions?: SharedV3ProviderOptions_2;
+} | {
+    type: 'json';
+    value: JSONValue_3;
+    /**
+     * Provider-specific options.
+     */
+    providerOptions?: SharedV3ProviderOptions_2;
+} | {
+    /**
+     * Type when the user has denied the execution of the tool call.
+     */
+    type: 'execution-denied';
+    /**
+     * Optional reason for the execution denial.
+     */
+    reason?: string;
+    /**
+     * Provider-specific options.
+     */
+    providerOptions?: SharedV3ProviderOptions_2;
+} | {
+    type: 'error-text';
+    value: string;
+    /**
+     * Provider-specific options.
+     */
+    providerOptions?: SharedV3ProviderOptions_2;
+} | {
+    type: 'error-json';
+    value: JSONValue_3;
+    /**
+     * Provider-specific options.
+     */
+    providerOptions?: SharedV3ProviderOptions_2;
+} | {
+    type: 'content';
+    value: Array<{
+        type: 'text';
+        /**
+         * Text content.
+         */
+        text: string;
+        /**
+         * Provider-specific options.
+         */
+        providerOptions?: SharedV3ProviderOptions_2;
+    } | {
+        type: 'file-data';
+        /**
+         * Base-64 encoded media data.
+         */
+        data: string;
+        /**
+         * IANA media type.
+         * @see https://www.iana.org/assignments/media-types/media-types.xhtml
+         */
+        mediaType: string;
+        /**
+         * Optional filename of the file.
+         */
+        filename?: string;
+        /**
+         * Provider-specific options.
+         */
+        providerOptions?: SharedV3ProviderOptions_2;
+    } | {
+        type: 'file-url';
+        /**
+         * URL of the file.
+         */
+        url: string;
+        /**
+         * Provider-specific options.
+         */
+        providerOptions?: SharedV3ProviderOptions_2;
+    } | {
+        type: 'file-id';
+        /**
+         * ID of the file.
+         *
+         * If you use multiple providers, you need to
+         * specify the provider specific ids using
+         * the Record option. The key is the provider
+         * name, e.g. 'openai' or 'anthropic'.
+         */
+        fileId: string | Record<string, string>;
+        /**
+         * Provider-specific options.
+         */
+        providerOptions?: SharedV3ProviderOptions_2;
+    } | {
+        /**
+         * Images that are referenced using base64 encoded data.
+         */
+        type: 'image-data';
+        /**
+         * Base-64 encoded image data.
+         */
+        data: string;
+        /**
+         * IANA media type.
+         * @see https://www.iana.org/assignments/media-types/media-types.xhtml
+         */
+        mediaType: string;
+        /**
+         * Provider-specific options.
+         */
+        providerOptions?: SharedV3ProviderOptions_2;
+    } | {
+        /**
+         * Images that are referenced using a URL.
+         */
+        type: 'image-url';
+        /**
+         * URL of the image.
+         */
+        url: string;
+        /**
+         * Provider-specific options.
+         */
+        providerOptions?: SharedV3ProviderOptions_2;
+    } | {
+        /**
+         * Images that are referenced using a provider file id.
+         */
+        type: 'image-file-id';
+        /**
+         * Image that is referenced using a provider file id.
+         *
+         * If you use multiple providers, you need to
+         * specify the provider specific ids using
+         * the Record option. The key is the provider
+         * name, e.g. 'openai' or 'anthropic'.
+         */
+        fileId: string | Record<string, string>;
+        /**
+         * Provider-specific options.
+         */
+        providerOptions?: SharedV3ProviderOptions_2;
+    } | {
+        /**
+         * Custom content part. This can be used to implement
+         * provider-specific content parts.
+         */
+        type: 'custom';
+        /**
+         * Provider-specific options.
+         */
+        providerOptions?: SharedV3ProviderOptions_2;
+    }>;
+};
+
 /**
  * Tool result content part of a prompt. It contains the result of the tool call with the matching ID.
  */
@@ -6856,6 +7384,31 @@ declare interface LanguageModelV3ToolResultPart {
     providerOptions?: SharedV3ProviderOptions;
 }
 
+/**
+ * Tool result content part of a prompt. It contains the result of the tool call with the matching ID.
+ */
+declare interface LanguageModelV3ToolResultPart_2 {
+    type: 'tool-result';
+    /**
+     * ID of the tool call that this result is associated with.
+     */
+    toolCallId: string;
+    /**
+     * Name of the tool that generated this result.
+     */
+    toolName: string;
+    /**
+     * Result of the tool call.
+     */
+    output: LanguageModelV3ToolResultOutput_2;
+    /**
+     * Additional provider-specific options. They are passed through
+     * to the provider from the AI SDK and enable provider-specific
+     * functionality that can be fully encapsulated in the provider.
+     */
+    providerOptions?: SharedV3ProviderOptions_2;
+}
+
 /**
  * Usage information for a language model call.
  */
@@ -7072,7 +7625,7 @@ export declare class MessageConversionError extends AISDKError {
 }
 
 export declare class MissingToolResultsError extends AISDKError {
-    private readonly [symbol$d_2];
+    private readonly [symbol$d_3];
     readonly toolCallIds: string[];
     constructor({ toolCallIds }: {
         toolCallIds: string[];
@@ -7108,7 +7661,7 @@ export declare class NoContentGeneratedError extends AISDKError {
  * - The model generated a response that could not be parsed.
  */
 export declare class NoImageGeneratedError extends AISDKError {
-    private readonly [symbol$c_2];
+    private readonly [symbol$c_3];
     /**
      * The response metadata for each call.
      */
@@ -7246,7 +7799,7 @@ export declare class NoTranscriptGeneratedError extends AISDKError {
 }
 
 export declare class NoVideoGeneratedError extends AISDKError {
-    private readonly [symbol$7_2];
+    private readonly [symbol$7_3];
     readonly responses: Array<VideoModelResponseMetadata>;
     constructor({ message, cause, responses, }: {
         message?: string;
@@ -7716,7 +8269,7 @@ declare const parallelSearchToolFactory: _ai_sdk_provider_utils.ProviderToolFact
 declare function parseJSON(options: {
     text: string;
     schema?: undefined;
-}): Promise<JSONValue_2>;
+}): Promise<JSONValue_3>;
 
 /**
  * Parses a JSON string into a strongly-typed object using the provided schema.
@@ -7756,7 +8309,7 @@ declare type ParseResult<T> = {
     rawValue: unknown;
 } | {
     success: false;
-    error: JSONParseError | TypeValidationError;
+    error: JSONParseError_2 | TypeValidationError_2;
     rawValue: unknown;
 };
 
@@ -7972,7 +8525,7 @@ declare const postFormDataToApi: <T>({ url, headers, formData, failedResponseHan
     url: string;
     headers?: Record<string, string | undefined>;
     formData: FormData;
-    failedResponseHandler: ResponseHandler<APICallError>;
+    failedResponseHandler: ResponseHandler<APICallError_2>;
     successfulResponseHandler: ResponseHandler<T>;
     abortSignal?: AbortSignal;
     fetch?: FetchFunction;
@@ -7986,7 +8539,7 @@ declare const postJsonToApi: <T>({ url, headers, body, failedResponseHandler, su
     url: string;
     headers?: Record<string, string | undefined>;
     body: unknown;
-    failedResponseHandler: ResponseHandler<APICallError>;
+    failedResponseHandler: ResponseHandler<APICallError_2>;
     successfulResponseHandler: ResponseHandler<T>;
     abortSignal?: AbortSignal;
     fetch?: FetchFunction;
@@ -8246,7 +8799,7 @@ export declare type ProviderMetadata = SharedV3ProviderMetadata;
  * They are passed through to the provider from the AI SDK and enable
  * provider-specific functionality that can be fully encapsulated in the provider.
  */
-declare type ProviderOptions = SharedV3ProviderOptions;
+declare type ProviderOptions = SharedV3ProviderOptions_2;
 
 export declare interface ProviderRegistryProvider<PROVIDERS extends Record<string, ProviderV3> = Record<string, ProviderV3>, SEPARATOR extends string = ':'> {
     languageModel<KEY extends keyof PROVIDERS>(id: KEY extends string ? `${KEY & string}${SEPARATOR}${ExtractLiteralUnion<Parameters<NonNullable<PROVIDERS[KEY]['languageModel']>>[0]>}` : never): LanguageModelV3;
@@ -8814,7 +9367,7 @@ declare type RetryDelayProvider = ({ error, exponentialBackoffDelay, }: {
 }) => number;
 
 export declare class RetryError extends AISDKError {
-    private readonly [symbol$1_2];
+    private readonly [symbol$1_3];
     readonly reason: RetryErrorReason_2;
     readonly lastError: unknown;
     readonly errors: Array<unknown>;
@@ -8860,7 +9413,7 @@ declare const retryWithExponentialBackoff: ({ maxRetries, initialDelayInMs, back
 declare function safeParseJSON(options: {
     text: string;
     schema?: undefined;
-}): Promise<ParseResult<JSONValue_2>>;
+}): Promise<ParseResult<JSONValue_3>>;
 
 /**
  * Safely parses a JSON string into a strongly-typed object, using a provided schema to validate the object.
@@ -8888,14 +9441,14 @@ declare function safeParseJSON<T>(options: {
 declare function safeValidateTypes<OBJECT>({ value, schema, context, }: {
     value: unknown;
     schema: FlexibleSchema<OBJECT>;
-    context?: TypeValidationContext;
+    context?: TypeValidationContext_2;
 }): Promise<{
     success: true;
     value: OBJECT;
     rawValue: unknown;
 } | {
     success: false;
-    error: TypeValidationError;
+    error: TypeValidationError_2;
     rawValue: unknown;
 }>;
 
@@ -9030,6 +9583,29 @@ declare type SharedV3Headers = Record<string, string>;
  */
 declare type SharedV3ProviderMetadata = Record<string, JSONObject>;
 
+/**
+ * Additional provider-specific metadata.
+ * Metadata are additional outputs from the provider.
+ * They are passed through to the provider from the AI SDK
+ * and enable provider-specific functionality
+ * that can be fully encapsulated in the provider.
+ *
+ * This enables us to quickly ship provider-specific functionality
+ * without affecting the core AI SDK.
+ *
+ * The outer record is keyed by the provider name, and the inner
+ * record is keyed by the provider-specific metadata key.
+ *
+ * ```ts
+ * {
+ *   "anthropic": {
+ *     "cacheControl": { "type": "ephemeral" }
+ *   }
+ * }
+ * ```
+ */
+declare type SharedV3ProviderMetadata_2 = Record<string, JSONObject_2>;
+
 /**
  * Additional provider-specific options.
  * Options are additional input to the provider.
@@ -9053,6 +9629,29 @@ declare type SharedV3ProviderMetadata = Record<string, JSONObject>;
  */
 declare type SharedV3ProviderOptions = Record<string, JSONObject>;
 
+/**
+ * Additional provider-specific options.
+ * Options are additional input to the provider.
+ * They are passed through to the provider from the AI SDK
+ * and enable provider-specific functionality
+ * that can be fully encapsulated in the provider.
+ *
+ * This enables us to quickly ship provider-specific functionality
+ * without affecting the core AI SDK.
+ *
+ * The outer record is keyed by the provider name, and the inner
+ * record is keyed by the provider-specific metadata key.
+ *
+ * ```ts
+ * {
+ *   "anthropic": {
+ *     "cacheControl": { "type": "ephemeral" }
+ *   }
+ * }
+ * ```
+ */
+declare type SharedV3ProviderOptions_2 = Record<string, JSONObject_2>;
+
 /**
  * Warning from the model.
  *
@@ -10951,6 +11550,8 @@ declare const symbol$1: unique symbol;
 
 declare const symbol$1_2: unique symbol;
 
+declare const symbol$1_3: unique symbol;
+
 declare const symbol$2: unique symbol;
 
 declare const symbol$2_2: unique symbol;
@@ -10975,6 +11576,8 @@ declare const symbol$7: unique symbol;
 
 declare const symbol$7_2: unique symbol;
 
+declare const symbol$7_3: unique symbol;
+
 declare const symbol$8: unique symbol;
 
 declare const symbol$8_2: unique symbol;
@@ -10993,10 +11596,14 @@ declare const symbol$c: unique symbol;
 
 declare const symbol$c_2: unique symbol;
 
+declare const symbol$c_3: unique symbol;
+
 declare const symbol$d: unique symbol;
 
 declare const symbol$d_2: unique symbol;
 
+declare const symbol$d_3: unique symbol;
+
 declare const symbol$e: unique symbol;
 
 declare const symbol$f: unique symbol;
@@ -11249,7 +11856,7 @@ export declare type TimeoutConfiguration = number | {
  *
  * The tool can also contain an optional execute function for the actual execution function of the tool.
  */
-export declare type Tool<INPUT extends JSONValue_2 | unknown | never = any, OUTPUT extends JSONValue_2 | unknown | never = any> = {
+export declare type Tool<INPUT extends JSONValue_3 | unknown | never = any, OUTPUT extends JSONValue_3 | unknown | never = any> = {
     /**
      * An optional description of what the tool does.
      * Will be used by the language model to decide whether to use the tool.
@@ -11275,7 +11882,7 @@ export declare type Tool<INPUT extends JSONValue_2 | unknown | never = any, OUTP
      * and UI message parts. This is useful for sources of dynamic tools (e.g.
      * an MCP server) to identify themselves.
      */
-    metadata?: JSONObject;
+    metadata?: JSONObject_2;
     /**
      * The schema of the input that the tool expects.
      * The language model will use this to generate the input.
@@ -11896,7 +12503,7 @@ declare type ToolResultOutput = {
     providerOptions?: ProviderOptions;
 } | {
     type: 'json';
-    value: JSONValue_2;
+    value: JSONValue_3;
     /**
      * Provider-specific options.
      */
@@ -11923,7 +12530,7 @@ declare type ToolResultOutput = {
     providerOptions?: ProviderOptions;
 } | {
     type: 'error-json';
-    value: JSONValue_2;
+    value: JSONValue_3;
     /**
      * Provider-specific options.
      */
@@ -12551,6 +13158,21 @@ declare interface TypeValidationContext {
     entityId?: string;
 }
 
+declare interface TypeValidationContext_2 {
+    /**
+     * Field path in dot notation (e.g., "message.metadata", "message.parts[3].data")
+     */
+    field?: string;
+    /**
+     * Entity name (e.g., tool name, data type name)
+     */
+    entityName?: string;
+    /**
+     * Entity identifier (e.g., message ID, tool call ID)
+     */
+    entityId?: string;
+}
+
 export declare class TypeValidationError extends AISDKError {
     private readonly [symbol$1];
     readonly value: unknown;
@@ -12579,6 +13201,34 @@ export declare class TypeValidationError extends AISDKError {
     }): TypeValidationError;
 }
 
+declare class TypeValidationError_2 extends AISDKError_2 {
+    private readonly [symbol$1_2];
+    readonly value: unknown;
+    readonly context?: TypeValidationContext_2;
+    constructor({ value, cause, context, }: {
+        value: unknown;
+        cause: unknown;
+        context?: TypeValidationContext_2;
+    });
+    static isInstance(error: unknown): error is TypeValidationError_2;
+    /**
+     * Wraps an error into a TypeValidationError.
+     * If the cause is already a TypeValidationError with the same value and context, it returns the cause.
+     * Otherwise, it creates a new TypeValidationError.
+     *
+     * @param {Object} params - The parameters for wrapping the error.
+     * @param {unknown} params.value - The value that failed validation.
+     * @param {unknown} params.cause - The original error or cause of the validation failure.
+     * @param {TypeValidationContext} params.context - Optional context about what is being validated.
+     * @returns {TypeValidationError} A TypeValidationError instance.
+     */
+    static wrap({ value, cause, context, }: {
+        value: unknown;
+        cause: unknown;
+        context?: TypeValidationContext_2;
+    }): TypeValidationError_2;
+}
+
 export declare const UI_MESSAGE_STREAM_HEADERS: {
     'content-type': string;
     'cache-control': string;
@@ -13131,9 +13781,8 @@ export declare const userModelMessageSchema: z.ZodType<UserModelMessage>;
  * Validates that a URL is safe to download from, blocking private/internal addresses
  * to prevent SSRF attacks.
  *
- * Note: this performs string/literal-IP checks only. It does not resolve DNS, so a
- * hostname that resolves to a private address is not blocked here (see callers, which
- * should additionally constrain egress at the network layer when handling untrusted URLs).
+ * Note: this function performs string/literal-IP checks only. The Node.js
+ * download fetch additionally validates and pins DNS results at connect time.
  *
  * @param url - The URL string to validate.
  * @throws DownloadError if the URL is unsafe.
@@ -13153,7 +13802,7 @@ declare function validateDownloadUrl(url: string): void;
 declare function validateTypes<OBJECT>({ value, schema, context, }: {
     value: unknown;
     schema: FlexibleSchema<OBJECT>;
-    context?: TypeValidationContext;
+    context?: TypeValidationContext_2;
 }): Promise<OBJECT>;
 
 /**
@@ -13625,5 +14274,5 @@ export declare function zodSchema<OBJECT>(zodSchema: z4.core.$ZodType<OBJECT, an
 }): Schema<OBJECT>;
 
 export { }
-export { GatewayProviderSettings as GatewayProviderSettings, GatewayProvider as GatewayProvider, LazySchema as LazySchema, ZodSchema as ZodSchema, StandardSchema as StandardSchema, ValidationResult as ValidationResult, ParseResult as ParseResult, ProviderOptions as ProviderOptions, ReasoningPart as ReasoningPart, ToolOutputProperties as ToolOutputProperties, ToolResultOutput as ToolResultOutput, ToolNeedsApprovalFunction as ToolNeedsApprovalFunction, TypeValidationContext as TypeValidationContext, EmbeddingModelV2 as EmbeddingModelV2, EmbeddingModelV3Embedding as EmbeddingModelV3Embedding, EmbeddingModelV3Middleware as EmbeddingModelV3Middleware, ImageModelV2 as ImageModelV2, ImageModelV3ProviderMetadata as ImageModelV3ProviderMetadata, ImageModelV2ProviderMetadata as ImageModelV2ProviderMetadata, ImageModelV3Middleware as ImageModelV3Middleware, GlobalProviderModelId as GlobalProviderModelId, LanguageModelV2 as LanguageModelV2, SharedV3Warning as SharedV3Warning, LanguageModelV3Middleware as LanguageModelV3Middleware, SharedV3ProviderMetadata as SharedV3ProviderMetadata, SpeechModelV2 as SpeechModelV2, TranscriptionModelV2 as TranscriptionModelV2, ImageModelV3Usage as ImageModelV3Usage, DeepPartialInternal as DeepPartialInternal, AttributeValue as AttributeValue, Tracer as Tracer, BaseToolCall as BaseToolCall, Source as Source, PrepareStepCallSettings as PrepareStepCallSettings, ResponseMessage as ResponseMessage, LanguageModelV3ToolCall as LanguageModelV3ToolCall, GenerateTextIncludeSettings as GenerateTextIncludeSettings, ValueOf as ValueOf, asUITool as asUITool, _ai_sdk_provider_utils as _ai_sdk_provider_utils, DataUIMessageChunk as DataUIMessageChunk, InferElementOutput as InferElementOutput, ConsumeStreamOptions as ConsumeStreamOptions, StreamTextIncludeSettings as StreamTextIncludeSettings, StreamTextOnAbortCallback as StreamTextOnAbortCallback, CallbackModelInfo as CallbackModelInfo, LanguageModelV3ToolChoice as LanguageModelV3ToolChoice, Listener as Listener, MaybePromiseLike as MaybePromiseLike, Output_2 as Output_2, InferAgentTools as InferAgentTools, UIMessageStreamResponseInit as UIMessageStreamResponseInit, getOriginalFetch as getOriginalFetch, InferUIMessageTools as InferUIMessageTools, InferUIMessageToolCall as InferUIMessageToolCall, UIDataTypesToSchemas as UIDataTypesToSchemas, InferUIMessageData as InferUIMessageData, InferUIMessageMetadata as InferUIMessageMetadata, Resolvable as Resolvable, FetchFunction as FetchFunction, SingleRequestTextStreamPart as SingleRequestTextStreamPart, RetryErrorReason_2 as RetryErrorReason_2, GenerateImagePrompt as GenerateImagePrompt, JSONValue_2 as JSONValue_2, Job as Job, StreamObjectOnErrorCallback as StreamObjectOnErrorCallback, VideoModelResponseMetadata as VideoModelResponseMetadata, VideoModelProviderMetadata as VideoModelProviderMetadata, VideoModel as VideoModel, VideoModelV3FrameType as VideoModelV3FrameType, EmbeddingModelV3CallOptions as EmbeddingModelV3CallOptions, LanguageModelV3CallOptions as LanguageModelV3CallOptions, JSONObject as JSONObject, LanguageModelV3 as LanguageModelV3, EmbeddingModelV3 as EmbeddingModelV3, ImageModelV3 as ImageModelV3, TranscriptionModelV3 as TranscriptionModelV3, SpeechModelV3 as SpeechModelV3, RerankingModelV3 as RerankingModelV3, VideoModelV3 as VideoModelV3, ProviderV2 as ProviderV2, ExtractModelId as ExtractModelId, ExtractLiteralUnion as ExtractLiteralUnion, ProviderV3 as ProviderV3 };
-export { schemaSymbol, symbol$1, symbol$1_2, symbol$2, symbol$2_2, symbol$3, symbol$3_2, symbol$4, symbol$4_2, symbol$5, symbol$5_2, symbol$6, symbol$6_2, symbol$7, symbol$7_2, symbol$8, symbol$8_2, symbol$9, symbol$9_2, symbol$a, symbol$b, symbol$b_2, symbol$c, symbol$c_2, symbol$d, symbol$d_2, symbol$e, symbol$f, symbol$g, symbol$h, symbol$i, symbol$j, symbol$k, symbol, symbol_2, symbol_3 };
+export { GatewayProviderSettings as GatewayProviderSettings, GatewayProvider as GatewayProvider, AISDKError_2 as AISDKError_2, LazySchema as LazySchema, ZodSchema as ZodSchema, StandardSchema as StandardSchema, ValidationResult as ValidationResult, ParseResult as ParseResult, ProviderOptions as ProviderOptions, ReasoningPart as ReasoningPart, JSONValue_3 as JSONValue_3, ToolOutputProperties as ToolOutputProperties, JSONObject_2 as JSONObject_2, ToolResultOutput as ToolResultOutput, ToolNeedsApprovalFunction as ToolNeedsApprovalFunction, TypeValidationContext as TypeValidationContext, EmbeddingModelV2 as EmbeddingModelV2, EmbeddingModelV3Embedding as EmbeddingModelV3Embedding, EmbeddingModelV3Middleware as EmbeddingModelV3Middleware, ImageModelV2 as ImageModelV2, ImageModelV3ProviderMetadata as ImageModelV3ProviderMetadata, ImageModelV2ProviderMetadata as ImageModelV2ProviderMetadata, ImageModelV3Middleware as ImageModelV3Middleware, GlobalProviderModelId as GlobalProviderModelId, LanguageModelV2 as LanguageModelV2, SharedV3Warning as SharedV3Warning, LanguageModelV3Middleware as LanguageModelV3Middleware, SharedV3ProviderMetadata as SharedV3ProviderMetadata, SpeechModelV2 as SpeechModelV2, TranscriptionModelV2 as TranscriptionModelV2, ImageModelV3Usage as ImageModelV3Usage, DeepPartialInternal as DeepPartialInternal, AttributeValue as AttributeValue, Tracer as Tracer, BaseToolCall as BaseToolCall, Source as Source, PrepareStepCallSettings as PrepareStepCallSettings, ResponseMessage as ResponseMessage, LanguageModelV3ToolCall as LanguageModelV3ToolCall, GenerateTextIncludeSettings as GenerateTextIncludeSettings, ValueOf as ValueOf, asUITool as asUITool, _ai_sdk_provider_utils as _ai_sdk_provider_utils, DataUIMessageChunk as DataUIMessageChunk, InferElementOutput as InferElementOutput, ConsumeStreamOptions as ConsumeStreamOptions, StreamTextIncludeSettings as StreamTextIncludeSettings, StreamTextOnAbortCallback as StreamTextOnAbortCallback, CallbackModelInfo as CallbackModelInfo, LanguageModelV3ToolChoice as LanguageModelV3ToolChoice, Listener as Listener, MaybePromiseLike as MaybePromiseLike, Output_2 as Output_2, InferAgentTools as InferAgentTools, UIMessageStreamResponseInit as UIMessageStreamResponseInit, getOriginalFetch as getOriginalFetch, InferUIMessageTools as InferUIMessageTools, InferUIMessageToolCall as InferUIMessageToolCall, UIDataTypesToSchemas as UIDataTypesToSchemas, InferUIMessageData as InferUIMessageData, InferUIMessageMetadata as InferUIMessageMetadata, Resolvable as Resolvable, FetchFunction as FetchFunction, SingleRequestTextStreamPart as SingleRequestTextStreamPart, RetryErrorReason_2 as RetryErrorReason_2, GenerateImagePrompt as GenerateImagePrompt, JSONValue_2 as JSONValue_2, Job as Job, StreamObjectOnErrorCallback as StreamObjectOnErrorCallback, VideoModelResponseMetadata as VideoModelResponseMetadata, VideoModelProviderMetadata as VideoModelProviderMetadata, VideoModel as VideoModel, VideoModelV3FrameType as VideoModelV3FrameType, EmbeddingModelV3CallOptions as EmbeddingModelV3CallOptions, LanguageModelV3CallOptions as LanguageModelV3CallOptions, JSONObject as JSONObject, LanguageModelV3 as LanguageModelV3, EmbeddingModelV3 as EmbeddingModelV3, ImageModelV3 as ImageModelV3, TranscriptionModelV3 as TranscriptionModelV3, SpeechModelV3 as SpeechModelV3, RerankingModelV3 as RerankingModelV3, VideoModelV3 as VideoModelV3, ProviderV2 as ProviderV2, ExtractModelId as ExtractModelId, ExtractLiteralUnion as ExtractLiteralUnion, ProviderV3 as ProviderV3 };
+export { EMBEDDING_MODEL_MAX_INPUT_BYTES_PER_CALL, schemaSymbol, symbol$1, symbol$1_2, symbol$1_3, symbol$2, symbol$2_2, symbol$3, symbol$3_2, symbol$4, symbol$4_2, symbol$5, symbol$5_2, symbol$6, symbol$6_2, symbol$7, symbol$7_2, symbol$7_3, symbol$8, symbol$8_2, symbol$9, symbol$9_2, symbol$a, symbol$b, symbol$b_2, symbol$c, symbol$c_2, symbol$c_3, symbol$d, symbol$d_2, symbol$d_3, symbol$e, symbol$f, symbol$g, symbol$h, symbol$i, symbol$j, symbol$k, symbol, symbol_2, symbol_3 };