ai 6.0.174 → 6.0.176

package/dist/internal/index.js

@@ -152,7 +152,7 @@ function detectMediaType({
 var import_provider_utils2 = require("@ai-sdk/provider-utils");
 
 // src/version.ts
-var VERSION = true ? "6.0.174" : "0.0.0-test";
+var VERSION = true ? "6.0.176" : "0.0.0-test";
 
 // src/util/download/download.ts
 var download = async ({

package/dist/internal/index.mjs

@@ -131,7 +131,7 @@ import {
 } from "@ai-sdk/provider-utils";
 
 // src/version.ts
-var VERSION = true ? "6.0.174" : "0.0.0-test";
+var VERSION = true ? "6.0.176" : "0.0.0-test";
 
 // src/util/download/download.ts
 var download = async ({

package/docs/02-foundations/02-providers-and-models.mdx

@@ -115,6 +115,7 @@ Here are the capabilities of popular models:
 | [xAI Grok](/providers/ai-sdk-providers/xai)        | `grok-3`                                    | <Cross size={18} /> | <Check size={18} /> | <Check size={18} /> | <Check size={18} /> |
 | [xAI Grok](/providers/ai-sdk-providers/xai)        | `grok-3-mini`                               | <Cross size={18} /> | <Check size={18} /> | <Check size={18} /> | <Check size={18} /> |
 | [Vercel](/providers/ai-sdk-providers/vercel)       | `v0-1.0-md`                                 | <Check size={18} /> | <Check size={18} /> | <Check size={18} /> | <Check size={18} /> |
+| [OpenAI](/providers/ai-sdk-providers/openai)       | `gpt-5.5`                                   | <Check size={18} /> | <Check size={18} /> | <Check size={18} /> | <Check size={18} /> |
 | [OpenAI](/providers/ai-sdk-providers/openai)       | `gpt-5.4-pro`                               | <Check size={18} /> | <Check size={18} /> | <Check size={18} /> | <Check size={18} /> |
 | [OpenAI](/providers/ai-sdk-providers/openai)       | `gpt-5.4`                                   | <Check size={18} /> | <Check size={18} /> | <Check size={18} /> | <Check size={18} /> |
 | [OpenAI](/providers/ai-sdk-providers/openai)       | `gpt-5.4-mini`                              | <Check size={18} /> | <Check size={18} /> | <Check size={18} /> | <Check size={18} /> |
@@ -142,7 +143,9 @@ Here are the capabilities of popular models:
 | [Mistral](/providers/ai-sdk-providers/mistral)     | `pixtral-large-latest`                      | <Check size={18} /> | <Check size={18} /> | <Check size={18} /> | <Check size={18} /> |
 | [Mistral](/providers/ai-sdk-providers/mistral)     | `mistral-large-latest`                      | <Cross size={18} /> | <Check size={18} /> | <Check size={18} /> | <Check size={18} /> |
 | [Mistral](/providers/ai-sdk-providers/mistral)     | `mistral-medium-latest`                     | <Cross size={18} /> | <Check size={18} /> | <Check size={18} /> | <Check size={18} /> |
+| [Mistral](/providers/ai-sdk-providers/mistral)     | `mistral-medium-3`                          | <Cross size={18} /> | <Check size={18} /> | <Check size={18} /> | <Check size={18} /> |
 | [Mistral](/providers/ai-sdk-providers/mistral)     | `mistral-medium-2505`                       | <Cross size={18} /> | <Check size={18} /> | <Check size={18} /> | <Check size={18} /> |
+| [Mistral](/providers/ai-sdk-providers/mistral)     | `mistral-medium-3.5`                        | <Cross size={18} /> | <Check size={18} /> | <Check size={18} /> | <Check size={18} /> |
 | [Mistral](/providers/ai-sdk-providers/mistral)     | `mistral-small-latest`                      | <Cross size={18} /> | <Check size={18} /> | <Check size={18} /> | <Check size={18} /> |
 | [Mistral](/providers/ai-sdk-providers/mistral)     | `pixtral-12b-2409`                          | <Check size={18} /> | <Check size={18} /> | <Check size={18} /> | <Check size={18} /> |
 | [DeepSeek](/providers/ai-sdk-providers/deepseek)   | `deepseek-chat`                             | <Cross size={18} /> | <Check size={18} /> | <Check size={18} /> | <Check size={18} /> |

package/docs/07-reference/01-ai-sdk-core/20-tool.mdx

@@ -170,11 +170,11 @@ export const weatherTool = tool({
                 'Additional provider-specific metadata. They are passed through to the provider from the AI SDK and enable provider-specific functionality that can be fully encapsulated in the provider.',
             },
             {
-              name: 'providerMetadata',
+              name: 'metadata',
               isOptional: true,
-              type: 'ProviderMetadata',
+              type: 'JSONObject',
               description:
-                "Optional metadata about the tool itself (e.g. its source). It is propagated onto the resulting tool call's providerMetadata so consumers can read it from tool call/result parts and UI message parts. Useful for sources of dynamic tools (e.g. an MCP server) to identify themselves.",
+                "Optional metadata about the tool itself (e.g. its source). It is propagated onto the resulting tool call's toolMetadata so consumers can read it from tool call/result parts and UI message parts. Useful for sources of dynamic tools (e.g. an MCP server) to identify themselves.",
             },
             {
               name: 'type',

package/docs/07-reference/01-ai-sdk-core/22-dynamic-tool.mdx

@@ -154,11 +154,11 @@ export const customTool = dynamicTool({
               description: 'Additional provider-specific metadata.'
             },
             {
-              name: 'providerMetadata',
+              name: 'metadata',
               isOptional: true,
-              type: 'ProviderMetadata',
+              type: 'JSONObject',
               description:
-                "Optional metadata about the tool itself (e.g. its source). It is propagated onto the resulting tool call's providerMetadata so consumers can read it from tool call/result parts and UI message parts. Useful for sources of dynamic tools (e.g. an MCP server) to identify themselves."
+                "Optional metadata about the tool itself (e.g. its source). It is propagated onto the resulting tool call's toolMetadata so consumers can read it from tool call/result parts and UI message parts. Useful for sources of dynamic tools (e.g. an MCP server) to identify themselves."
             }
           ]
         }

package/docs/07-reference/01-ai-sdk-core/23-create-mcp-client.mdx

@@ -119,11 +119,19 @@ It currently does not support accepting notifications from an MCP server, and cu
                 },
               ],
             },
+            {
+              name: 'clientName',
+              type: 'string',
+              isOptional: true,
+              description:
+                'Client name. Defaults to "ai-sdk-mcp-client".',
+            },
             {
               name: 'name',
               type: 'string',
               isOptional: true,
-              description: 'Client name. Defaults to "ai-sdk-mcp-client"',
+              description:
+                'Deprecated. Use `clientName` instead. Defaults to "ai-sdk-mcp-client".',
             },
             {
               name: 'version',

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ai",
-  "version": "6.0.174",
+  "version": "6.0.176",
   "description": "AI SDK by Vercel - build apps like ChatGPT, Claude, Gemini, and more with a single interface for any model using the Vercel AI Gateway or go direct to OpenAI, Anthropic, Google, or any other model provider.",
   "license": "Apache-2.0",
   "sideEffects": false,
@@ -45,9 +45,9 @@
   },
   "dependencies": {
     "@opentelemetry/api": "1.9.0",
-    "@ai-sdk/gateway": "3.0.109",
+    "@ai-sdk/gateway": "3.0.111",
     "@ai-sdk/provider": "3.0.10",
-    "@ai-sdk/provider-utils": "4.0.26"
+    "@ai-sdk/provider-utils": "4.0.27"
   },
   "devDependencies": {
     "@edge-runtime/vm": "^5.0.0",

package/src/generate-text/execute-tool-call.ts

@@ -148,6 +148,9 @@ export async function executeToolCall<TOOLS extends ToolSet>({
           ...(toolCall.providerMetadata != null
             ? { providerMetadata: toolCall.providerMetadata }
             : {}),
+          ...(toolCall.toolMetadata != null
+            ? { toolMetadata: toolCall.toolMetadata }
+            : {}),
         } as TypedToolError<TOOLS>;
       }
 
@@ -191,6 +194,9 @@ export async function executeToolCall<TOOLS extends ToolSet>({
         ...(toolCall.providerMetadata != null
           ? { providerMetadata: toolCall.providerMetadata }
           : {}),
+        ...(toolCall.toolMetadata != null
+          ? { toolMetadata: toolCall.toolMetadata }
+          : {}),
       } as TypedToolResult<TOOLS>;
     },
   });

package/src/generate-text/generate-text.ts

@@ -1486,6 +1486,9 @@ function asContent<TOOLS extends ToolSet>({
               ...(part.providerMetadata != null
                 ? { providerMetadata: part.providerMetadata }
                 : {}),
+              ...(tool?.metadata != null
+                ? { toolMetadata: tool.metadata }
+                : {}),
             } as TypedToolError<TOOLS>);
           } else {
             contentParts.push({
@@ -1499,6 +1502,9 @@ function asContent<TOOLS extends ToolSet>({
               ...(part.providerMetadata != null
                 ? { providerMetadata: part.providerMetadata }
                 : {}),
+              ...(tool?.metadata != null
+                ? { toolMetadata: tool.metadata }
+                : {}),
             } as TypedToolResult<TOOLS>);
           }
           break;
@@ -1516,6 +1522,9 @@ function asContent<TOOLS extends ToolSet>({
             ...(part.providerMetadata != null
               ? { providerMetadata: part.providerMetadata }
               : {}),
+            ...(toolCall.toolMetadata != null
+              ? { toolMetadata: toolCall.toolMetadata }
+              : {}),
           } as TypedToolError<TOOLS>);
         } else {
           contentParts.push({
@@ -1529,6 +1538,9 @@ function asContent<TOOLS extends ToolSet>({
             ...(part.providerMetadata != null
               ? { providerMetadata: part.providerMetadata }
               : {}),
+            ...(toolCall.toolMetadata != null
+              ? { toolMetadata: toolCall.toolMetadata }
+              : {}),
           } as TypedToolResult<TOOLS>);
         }
         break;

package/src/generate-text/parse-tool-call.ts

@@ -9,31 +9,10 @@ import {
 import { InvalidToolInputError } from '../error/invalid-tool-input-error';
 import { NoSuchToolError } from '../error/no-such-tool-error';
 import { ToolCallRepairError } from '../error/tool-call-repair-error';
-import type { ProviderMetadata } from '../types';
 import type { DynamicToolCall, TypedToolCall } from './tool-call';
 import type { ToolCallRepairFunction } from './tool-call-repair-function';
 import type { ToolSet } from './tool-set';
 
-/**
- * Merge the tool's static `providerMetadata` (e.g. an MCP server name)
- * with the `providerMetadata` returned by the language model on the tool
- * call. Model-supplied metadata wins on conflicting top-level namespaces.
- */
-function mergeToolProviderMetadata(
-  toolMetadata: ProviderMetadata | undefined,
-  callMetadata: ProviderMetadata | undefined,
-): ProviderMetadata | undefined {
-  if (toolMetadata == null) {
-    return callMetadata;
-  }
-
-  if (callMetadata == null) {
-    return toolMetadata;
-  }
-
-  return { ...toolMetadata, ...callMetadata };
-}
-
 export async function parseToolCall<TOOLS extends ToolSet>({
   toolCall,
   tools,
@@ -102,6 +81,7 @@ export async function parseToolCall<TOOLS extends ToolSet>({
     // use parsed input when possible
     const parsedInput = await safeParseJSON({ text: toolCall.input });
     const input = parsedInput.success ? parsedInput.value : toolCall.input;
+    const tool = tools?.[toolCall.toolName];
 
     // TODO AI SDK 6: special invalid tool call parts
     return {
@@ -112,12 +92,10 @@ export async function parseToolCall<TOOLS extends ToolSet>({
       dynamic: true,
       invalid: true,
       error,
-      title: tools?.[toolCall.toolName]?.title,
+      title: tool?.title,
       providerExecuted: toolCall.providerExecuted,
-      providerMetadata: mergeToolProviderMetadata(
-        tools?.[toolCall.toolName]?.providerMetadata,
-        toolCall.providerMetadata,
-      ),
+      providerMetadata: toolCall.providerMetadata,
+      ...(tool?.metadata != null ? { toolMetadata: tool.metadata } : {}),
     };
   }
 }
@@ -189,11 +167,6 @@ async function doParseToolCall<TOOLS extends ToolSet>({
     });
   }
 
-  const mergedProviderMetadata = mergeToolProviderMetadata(
-    tool.providerMetadata,
-    toolCall.providerMetadata,
-  );
-
   return tool.type === 'dynamic'
     ? {
         type: 'tool-call',
@@ -201,7 +174,8 @@ async function doParseToolCall<TOOLS extends ToolSet>({
         toolName: toolCall.toolName,
         input: parseResult.value,
         providerExecuted: toolCall.providerExecuted,
-        providerMetadata: mergedProviderMetadata,
+        providerMetadata: toolCall.providerMetadata,
+        ...(tool.metadata != null ? { toolMetadata: tool.metadata } : {}),
         dynamic: true,
         title: tool.title,
       }
@@ -211,7 +185,8 @@ async function doParseToolCall<TOOLS extends ToolSet>({
         toolName,
         input: parseResult.value,
         providerExecuted: toolCall.providerExecuted,
-        providerMetadata: mergedProviderMetadata,
+        providerMetadata: toolCall.providerMetadata,
+        ...(tool.metadata != null ? { toolMetadata: tool.metadata } : {}),
         title: tool.title,
       };
 }

package/src/generate-text/run-tools-transformation.ts

@@ -295,6 +295,9 @@ export function runToolsTransformation<TOOLS extends ToolSet>({
                 error: getErrorMessage(toolCall.error!),
                 dynamic: true,
                 title: toolCall.title,
+                ...(toolCall.toolMetadata != null
+                  ? { toolMetadata: toolCall.toolMetadata }
+                  : {}),
               });
               break;
             }
@@ -382,6 +385,7 @@ export function runToolsTransformation<TOOLS extends ToolSet>({
 
         case 'tool-result': {
           const toolName = chunk.toolName as keyof TOOLS & string;
+          const toolCall = toolCallsByToolCallId.get(chunk.toolCallId);
 
           if (chunk.isError) {
             toolResultsStreamController!.enqueue({
@@ -395,6 +399,9 @@ export function runToolsTransformation<TOOLS extends ToolSet>({
               ...(chunk.providerMetadata != null
                 ? { providerMetadata: chunk.providerMetadata }
                 : {}),
+              ...(toolCall?.toolMetadata != null
+                ? { toolMetadata: toolCall.toolMetadata }
+                : {}),
             } as TypedToolError<TOOLS>);
           } else {
             controller.enqueue({
@@ -408,6 +415,9 @@ export function runToolsTransformation<TOOLS extends ToolSet>({
               ...(chunk.providerMetadata != null
                 ? { providerMetadata: chunk.providerMetadata }
                 : {}),
+              ...(toolCall?.toolMetadata != null
+                ? { toolMetadata: toolCall.toolMetadata }
+                : {}),
             } as TypedToolResult<TOOLS>);
           }
           break;

package/src/generate-text/stream-text-result.ts

@@ -1,3 +1,4 @@
+import type { JSONObject } from '@ai-sdk/provider';
 import type { IdGenerator } from '@ai-sdk/provider-utils';
 import type { ServerResponse } from 'node:http';
 import type {
@@ -409,6 +410,7 @@ export type TextStreamPart<TOOLS extends ToolSet> =
       id: string;
       toolName: string;
       providerMetadata?: ProviderMetadata;
+      toolMetadata?: JSONObject;
       providerExecuted?: boolean;
       dynamic?: boolean;
       title?: string;

package/src/generate-text/stream-text.ts

@@ -2537,6 +2537,9 @@ class DefaultStreamTextResult<
                 ...(part.providerMetadata != null
                   ? { providerMetadata: part.providerMetadata }
                   : {}),
+                ...(part.toolMetadata != null
+                  ? { toolMetadata: part.toolMetadata }
+                  : {}),
                 ...(dynamic != null ? { dynamic } : {}),
                 ...(part.title != null ? { title: part.title } : {}),
               });
@@ -2567,6 +2570,9 @@ class DefaultStreamTextResult<
                   ...(part.providerMetadata != null
                     ? { providerMetadata: part.providerMetadata }
                     : {}),
+                  ...(part.toolMetadata != null
+                    ? { toolMetadata: part.toolMetadata }
+                    : {}),
                   ...(dynamic != null ? { dynamic } : {}),
                   errorText: onError(part.error),
                   ...(part.title != null ? { title: part.title } : {}),
@@ -2583,6 +2589,9 @@ class DefaultStreamTextResult<
                   ...(part.providerMetadata != null
                     ? { providerMetadata: part.providerMetadata }
                     : {}),
+                  ...(part.toolMetadata != null
+                    ? { toolMetadata: part.toolMetadata }
+                    : {}),
                   ...(dynamic != null ? { dynamic } : {}),
                   ...(part.title != null ? { title: part.title } : {}),
                 });
@@ -2613,6 +2622,9 @@ class DefaultStreamTextResult<
                 ...(part.providerMetadata != null
                   ? { providerMetadata: part.providerMetadata }
                   : {}),
+                ...(part.toolMetadata != null
+                  ? { toolMetadata: part.toolMetadata }
+                  : {}),
                 ...(part.preliminary != null
                   ? { preliminary: part.preliminary }
                   : {}),
@@ -2638,6 +2650,9 @@ class DefaultStreamTextResult<
                 ...(part.providerMetadata != null
                   ? { providerMetadata: part.providerMetadata }
                   : {}),
+                ...(part.toolMetadata != null
+                  ? { toolMetadata: part.toolMetadata }
+                  : {}),
                 ...(dynamic != null ? { dynamic } : {}),
               });
               break;

package/src/generate-text/tool-call.ts

@@ -1,3 +1,4 @@
+import type { JSONObject } from '@ai-sdk/provider';
 import type { Tool } from '@ai-sdk/provider-utils';
 import type { ProviderMetadata } from '../types';
 import type { ValueOf } from '../util/value-of';
@@ -8,6 +9,7 @@ type BaseToolCall = {
   toolCallId: string;
   providerExecuted?: boolean;
   providerMetadata?: ProviderMetadata;
+  toolMetadata?: JSONObject;
 };
 
 export type StaticToolCall<TOOLS extends ToolSet> = ValueOf<{

package/src/generate-text/tool-error.ts

@@ -1,3 +1,4 @@
+import type { JSONObject } from '@ai-sdk/provider';
 import type { InferToolInput } from '@ai-sdk/provider-utils';
 import type { ProviderMetadata } from '../types';
 import type { ValueOf } from '../util/value-of';
@@ -12,6 +13,7 @@ export type StaticToolError<TOOLS extends ToolSet> = ValueOf<{
     error: unknown;
     providerExecuted?: boolean;
     providerMetadata?: ProviderMetadata;
+    toolMetadata?: JSONObject;
     dynamic?: false | undefined;
     title?: string;
   };
@@ -25,6 +27,7 @@ export type DynamicToolError = {
   error: unknown;
   providerExecuted?: boolean;
   providerMetadata?: ProviderMetadata;
+  toolMetadata?: JSONObject;
   dynamic: true;
   title?: string;
 };

package/src/generate-text/tool-result.ts

@@ -1,3 +1,4 @@
+import type { JSONObject } from '@ai-sdk/provider';
 import type { InferToolInput, InferToolOutput } from '@ai-sdk/provider-utils';
 import type { ProviderMetadata } from '../types';
 import type { ValueOf } from '../../src/util/value-of';
@@ -12,6 +13,7 @@ export type StaticToolResult<TOOLS extends ToolSet> = ValueOf<{
     output: InferToolOutput<TOOLS[NAME]>;
     providerExecuted?: boolean;
     providerMetadata?: ProviderMetadata;
+    toolMetadata?: JSONObject;
     dynamic?: false | undefined;
     preliminary?: boolean;
     title?: string;
@@ -26,6 +28,7 @@ export type DynamicToolResult = {
   output: unknown;
   providerExecuted?: boolean;
   providerMetadata?: ProviderMetadata;
+  toolMetadata?: JSONObject;
   dynamic: true;
   preliminary?: boolean;
   title?: string;

package/src/ui/process-ui-message-stream.ts

@@ -1,4 +1,4 @@
-import { TypeValidationContext } from '@ai-sdk/provider';
+import { TypeValidationContext, type JSONObject } from '@ai-sdk/provider';
 import { validateTypes, type FlexibleSchema } from '@ai-sdk/provider-utils';
 import { UIMessageStreamError } from '../error/ui-message-stream-error';
 import type { ProviderMetadata } from '../types';
@@ -42,6 +42,7 @@ export type StreamingUIMessageState<UI_MESSAGE extends UIMessage> = {
       toolName: string;
       dynamic?: boolean;
       title?: string;
+      toolMetadata?: JSONObject;
     }
   >;
   finishReason?: FinishReason;
@@ -126,6 +127,7 @@ export function processUIMessageStream<UI_MESSAGE extends UIMessage>({
               toolCallId: string;
               providerExecuted?: boolean;
               title?: string;
+              toolMetadata?: JSONObject;
             } & (
               | {
                   state: 'input-streaming';
@@ -176,6 +178,9 @@ export function processUIMessageStream<UI_MESSAGE extends UIMessage>({
               if (options.title !== undefined) {
                 anyPart.title = options.title;
               }
+              if (options.toolMetadata !== undefined) {
+                anyPart.toolMetadata = options.toolMetadata;
+              }
               // once providerExecuted is set, it stays for streaming
               anyPart.providerExecuted =
                 anyOptions.providerExecuted ?? part.providerExecuted;
@@ -203,6 +208,9 @@ export function processUIMessageStream<UI_MESSAGE extends UIMessage>({
                 toolCallId: options.toolCallId,
                 state: options.state,
                 title: options.title,
+                ...(options.toolMetadata !== undefined
+                  ? { toolMetadata: options.toolMetadata }
+                  : {}),
                 input: anyOptions.input,
                 output: anyOptions.output,
                 rawInput: anyOptions.rawInput,
@@ -231,6 +239,7 @@ export function processUIMessageStream<UI_MESSAGE extends UIMessage>({
               toolCallId: string;
               providerExecuted?: boolean;
               title?: string;
+              toolMetadata?: JSONObject;
             } & (
               | {
                   state: 'input-streaming';
@@ -277,6 +286,9 @@ export function processUIMessageStream<UI_MESSAGE extends UIMessage>({
               if (options.title !== undefined) {
                 anyPart.title = options.title;
               }
+              if (options.toolMetadata !== undefined) {
+                anyPart.toolMetadata = options.toolMetadata;
+              }
               // once providerExecuted is set, it stays for streaming
               anyPart.providerExecuted =
                 anyOptions.providerExecuted ?? part.providerExecuted;
@@ -310,6 +322,9 @@ export function processUIMessageStream<UI_MESSAGE extends UIMessage>({
                 preliminary: anyOptions.preliminary,
                 providerExecuted: anyOptions.providerExecuted,
                 title: options.title,
+                ...(options.toolMetadata !== undefined
+                  ? { toolMetadata: options.toolMetadata }
+                  : {}),
                 ...(anyOptions.providerMetadata != null &&
                 (options.state === 'output-available' ||
                   options.state === 'output-error')
@@ -503,6 +518,7 @@ export function processUIMessageStream<UI_MESSAGE extends UIMessage>({
                 index: toolInvocations.length,
                 dynamic: chunk.dynamic,
                 title: chunk.title,
+                toolMetadata: chunk.toolMetadata,
               };
 
               if (chunk.dynamic) {
@@ -513,6 +529,7 @@ export function processUIMessageStream<UI_MESSAGE extends UIMessage>({
                   input: undefined,
                   providerExecuted: chunk.providerExecuted,
                   title: chunk.title,
+                  toolMetadata: chunk.toolMetadata,
                   providerMetadata: chunk.providerMetadata,
                 });
               } else {
@@ -523,6 +540,7 @@ export function processUIMessageStream<UI_MESSAGE extends UIMessage>({
                   input: undefined,
                   providerExecuted: chunk.providerExecuted,
                   title: chunk.title,
+                  toolMetadata: chunk.toolMetadata,
                   providerMetadata: chunk.providerMetadata,
                 });
               }
@@ -556,6 +574,7 @@ export function processUIMessageStream<UI_MESSAGE extends UIMessage>({
                   state: 'input-streaming',
                   input: partialArgs,
                   title: partialToolCall.title,
+                  toolMetadata: partialToolCall.toolMetadata,
                 });
               } else {
                 updateToolPart({
@@ -564,6 +583,7 @@ export function processUIMessageStream<UI_MESSAGE extends UIMessage>({
                   state: 'input-streaming',
                   input: partialArgs,
                   title: partialToolCall.title,
+                  toolMetadata: partialToolCall.toolMetadata,
                 });
               }
 
@@ -581,6 +601,7 @@ export function processUIMessageStream<UI_MESSAGE extends UIMessage>({
                   providerExecuted: chunk.providerExecuted,
                   providerMetadata: chunk.providerMetadata,
                   title: chunk.title,
+                  toolMetadata: chunk.toolMetadata,
                 });
               } else {
                 updateToolPart({
@@ -591,6 +612,7 @@ export function processUIMessageStream<UI_MESSAGE extends UIMessage>({
                   providerExecuted: chunk.providerExecuted,
                   providerMetadata: chunk.providerMetadata,
                   title: chunk.title,
+                  toolMetadata: chunk.toolMetadata,
                 });
               }
 
@@ -629,6 +651,7 @@ export function processUIMessageStream<UI_MESSAGE extends UIMessage>({
                   errorText: chunk.errorText,
                   providerExecuted: chunk.providerExecuted,
                   providerMetadata: chunk.providerMetadata,
+                  toolMetadata: chunk.toolMetadata,
                 });
               } else {
                 updateToolPart({
@@ -640,6 +663,7 @@ export function processUIMessageStream<UI_MESSAGE extends UIMessage>({
                   errorText: chunk.errorText,
                   providerExecuted: chunk.providerExecuted,
                   providerMetadata: chunk.providerMetadata,
+                  toolMetadata: chunk.toolMetadata,
                 });
               }
 
@@ -676,6 +700,7 @@ export function processUIMessageStream<UI_MESSAGE extends UIMessage>({
                   providerExecuted: chunk.providerExecuted,
                   providerMetadata: chunk.providerMetadata,
                   title: toolInvocation.title,
+                  toolMetadata: toolInvocation.toolMetadata,
                 });
               } else {
                 updateToolPart({
@@ -688,6 +713,7 @@ export function processUIMessageStream<UI_MESSAGE extends UIMessage>({
                   preliminary: chunk.preliminary,
                   providerMetadata: chunk.providerMetadata,
                   title: toolInvocation.title,
+                  toolMetadata: toolInvocation.toolMetadata,
                 });
               }
 
@@ -708,6 +734,7 @@ export function processUIMessageStream<UI_MESSAGE extends UIMessage>({
                   providerExecuted: chunk.providerExecuted,
                   providerMetadata: chunk.providerMetadata,
                   title: toolInvocation.title,
+                  toolMetadata: toolInvocation.toolMetadata,
                 });
               } else {
                 updateToolPart({
@@ -720,6 +747,7 @@ export function processUIMessageStream<UI_MESSAGE extends UIMessage>({
                   providerExecuted: chunk.providerExecuted,
                   providerMetadata: chunk.providerMetadata,
                   title: toolInvocation.title,
+                  toolMetadata: toolInvocation.toolMetadata,
                 });
               }
 

package/src/ui/ui-messages.ts

@@ -1,3 +1,4 @@
+import type { JSONObject } from '@ai-sdk/provider';
 import type {
   InferToolInput,
   InferToolOutput,
@@ -222,6 +223,7 @@ export type UIToolInvocation<TOOL extends UITool | Tool> = {
    */
   toolCallId: string;
   title?: string;
+  toolMetadata?: JSONObject;
 
   /**
    * Whether the tool call was executed by the provider.
@@ -329,6 +331,7 @@ export type DynamicToolUIPart = {
    */
   toolCallId: string;
   title?: string;
+  toolMetadata?: JSONObject;
 
   /**
    * Whether the tool call was executed by the provider.