@ai-sdk/provider-utils 4.0.25 → 4.0.26

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ai-sdk/provider-utils",
-  "version": "4.0.25",
+  "version": "4.0.26",
   "license": "Apache-2.0",
   "sideEffects": false,
   "main": "./dist/index.js",

package/src/types/tool.ts

@@ -1,4 +1,4 @@
-import type { JSONValue } from '@ai-sdk/provider';
+import type { JSONValue, SharedV3ProviderMetadata } from '@ai-sdk/provider';
 import type { FlexibleSchema } from '../schema';
 import type { ToolResultOutput } from './content-part';
 import type { ModelMessage } from './model-message';
@@ -128,6 +128,17 @@ export type Tool<
    */
   providerOptions?: ProviderOptions;
 
+  /**
+   * Optional metadata about the tool itself (e.g. its source).
+   *
+   * Unlike `providerOptions`, this metadata is not sent to the language
+   * model. Instead, it is propagated onto the resulting tool call's
+   * `providerMetadata` so consumers can read it from tool call / result
+   * parts and UI message parts. This is useful for sources of dynamic
+   * tools (e.g. an MCP server) to identify themselves.
+   */
+  providerMetadata?: SharedV3ProviderMetadata;
+
   /**
    * The schema of the input that the tool expects.
    * The language model will use this to generate the input.
@@ -288,6 +299,7 @@ export function dynamicTool(tool: {
   description?: string;
   title?: string;
   providerOptions?: ProviderOptions;
+  providerMetadata?: SharedV3ProviderMetadata;
   inputSchema: FlexibleSchema<unknown>;
   execute: ToolExecuteFunction<unknown, unknown>;