ai 5.0.0-alpha.13 → 5.0.0-alpha.14

package/dist/internal/index.d.mts

@@ -1,6 +1,6 @@
 import { ToolResultContent, Schema } from '@ai-sdk/provider-utils';
 export { convertAsyncIteratorToReadableStream } from '@ai-sdk/provider-utils';
-import { SharedV2ProviderOptions, LanguageModelV2Prompt, JSONValue, JSONObject, LanguageModelV2FunctionTool, LanguageModelV2ProviderDefinedTool, LanguageModelV2ToolChoice } from '@ai-sdk/provider';
+import { SharedV2ProviderOptions, LanguageModelV2Prompt, JSONValue, JSONObject, LanguageModelV2FunctionTool, LanguageModelV2ProviderDefinedClientTool, LanguageModelV2ProviderDefinedServerTool, LanguageModelV2ToolChoice } from '@ai-sdk/provider';
 import * as z3 from 'zod/v3';
 import * as z4 from 'zod/v4/core';
 
@@ -126,7 +126,7 @@ interface ToolCallPart {
     /**
   Arguments of the tool call. This is a JSON-serializable object that matches the tool's input schema.
      */
-    args: unknown;
+    input: unknown;
     /**
   Additional provider-specific metadata. They are passed through
   to the provider from the AI SDK and enable provider-specific
@@ -150,7 +150,7 @@ interface ToolResultPart {
     /**
   Result of the tool call. This is a JSON-serializable object.
      */
-    result: unknown;
+    output: unknown;
     /**
   Multi-part content of the tool result. Only for tools that support multipart results.
      */
@@ -367,7 +367,7 @@ type ToolChoice<TOOLS extends Record<string, unknown>> = 'auto' | 'none' | 'requ
     toolName: Extract<keyof TOOLS, string>;
 };
 
-type ToolParameters<T = JSONObject> = z4.$ZodType<T> | z3.Schema<T> | Schema<T>;
+type ToolInputSchema<T = JSONObject> = z4.$ZodType<T> | z3.Schema<T> | Schema<T>;
 interface ToolCallOptions {
     /**
      * The ID of the tool call. You can use it e.g. when sending tool-call related information with stream data.
@@ -390,21 +390,21 @@ This enables the language model to generate the input.
 
 The tool can also contain an optional execute function for the actual execution function of the tool.
  */
-type Tool<PARAMETERS extends JSONValue | unknown | never = any, RESULT = any> = {
+type Tool<INPUT extends JSONValue | unknown | never = any, OUTPUT = any> = {
     /**
   An optional description of what the tool does.
   Will be used by the language model to decide whether to use the tool.
-  Not used for provider-defined tools.
+  Not used for provider-defined-client tools.
      */
     description?: string;
-} & NeverOptional<PARAMETERS, {
+} & NeverOptional<INPUT, {
     /**
 The schema of the input that the tool expects. The language model will use this to generate the input.
 It is also used to validate the output of the language model.
 Use descriptions to make the input understandable for the language model.
    */
-    parameters: ToolParameters<PARAMETERS>;
-}> & NeverOptional<RESULT, {
+    inputSchema: ToolInputSchema<INPUT>;
+}> & NeverOptional<OUTPUT, {
     /**
 An async function that is called with the arguments from the tool call and produces a result.
 If not provided, the tool will not be executed automatically.
@@ -412,29 +412,29 @@ If not provided, the tool will not be executed automatically.
 @args is the input of the tool call.
 @options.abortSignal is a signal that can be used to abort the tool call.
     */
-    execute: (args: [PARAMETERS] extends [never] ? undefined : PARAMETERS, options: ToolCallOptions) => PromiseLike<RESULT>;
+    execute: (input: [INPUT] extends [never] ? undefined : INPUT, options: ToolCallOptions) => PromiseLike<OUTPUT>;
     /**
 Optional conversion function that maps the tool result to multi-part tool content for LLMs.
     */
-    experimental_toToolResultContent?: (result: RESULT) => ToolResultContent;
+    experimental_toToolResultContent?: (output: OUTPUT) => ToolResultContent;
     /**
      * Optional function that is called when the argument streaming starts.
      * Only called when the tool is used in a streaming context.
      */
-    onArgsStreamingStart?: (options: ToolCallOptions) => void | PromiseLike<void>;
+    onInputStart?: (options: ToolCallOptions) => void | PromiseLike<void>;
     /**
      * Optional function that is called when an argument streaming delta is available.
      * Only called when the tool is used in a streaming context.
      */
-    onArgsStreamingDelta?: (options: {
-        argsTextDelta: string;
+    onInputDelta?: (options: {
+        inputTextDelta: string;
     } & ToolCallOptions) => void | PromiseLike<void>;
     /**
      * Optional function that is called when a tool call can be started,
      * even if the execute function is not provided.
      */
-    onArgsAvailable?: (options: {
-        args: [PARAMETERS] extends [never] ? undefined : PARAMETERS;
+    onInputAvailable?: (options: {
+        input: [INPUT] extends [never] ? undefined : INPUT;
     } & ToolCallOptions) => void | PromiseLike<void>;
 }> & ({
     /**
@@ -443,9 +443,22 @@ Function tool.
     type?: undefined | 'function';
 } | {
     /**
-Provider-defined tool.
+Provider-defined-client tool.
  */
-    type: 'provider-defined';
+    type: 'provider-defined-client';
+    /**
+The ID of the tool. Should follow the format `<provider-name>.<tool-name>`.
+ */
+    id: `${string}.${string}`;
+    /**
+The arguments for configuring the tool. Must match the expected arguments defined by the provider for this tool.
+ */
+    args: Record<string, unknown>;
+} | {
+    /**
+Provider-defined-server tool.
+ */
+    type: 'provider-defined-server';
     /**
 The ID of the tool. Should follow the format `<provider-name>.<tool-name>`.
  */
@@ -456,14 +469,14 @@ The arguments for configuring the tool. Must match the expected arguments define
     args: Record<string, unknown>;
 });
 
-type ToolSet = Record<string, (Tool<never, never> | Tool<any, any> | Tool<any, never> | Tool<never, any>) & Pick<Tool<any, any>, 'execute' | 'onArgsAvailable' | 'onArgsStreamingStart' | 'onArgsStreamingDelta'>>;
+type ToolSet = Record<string, (Tool<never, never> | Tool<any, any> | Tool<any, never> | Tool<never, any>) & Pick<Tool<any, any>, 'execute' | 'onInputAvailable' | 'onInputStart' | 'onInputDelta'>>;
 
 declare function prepareToolsAndToolChoice<TOOLS extends ToolSet>({ tools, toolChoice, activeTools, }: {
     tools: TOOLS | undefined;
     toolChoice: ToolChoice<TOOLS> | undefined;
     activeTools: Array<keyof TOOLS> | undefined;
 }): {
-    tools: Array<LanguageModelV2FunctionTool | LanguageModelV2ProviderDefinedTool> | undefined;
+    tools: Array<LanguageModelV2FunctionTool | LanguageModelV2ProviderDefinedClientTool | LanguageModelV2ProviderDefinedServerTool> | undefined;
     toolChoice: LanguageModelV2ToolChoice | undefined;
 };
 

package/dist/internal/index.d.ts

@@ -1,6 +1,6 @@
 import { ToolResultContent, Schema } from '@ai-sdk/provider-utils';
 export { convertAsyncIteratorToReadableStream } from '@ai-sdk/provider-utils';
-import { SharedV2ProviderOptions, LanguageModelV2Prompt, JSONValue, JSONObject, LanguageModelV2FunctionTool, LanguageModelV2ProviderDefinedTool, LanguageModelV2ToolChoice } from '@ai-sdk/provider';
+import { SharedV2ProviderOptions, LanguageModelV2Prompt, JSONValue, JSONObject, LanguageModelV2FunctionTool, LanguageModelV2ProviderDefinedClientTool, LanguageModelV2ProviderDefinedServerTool, LanguageModelV2ToolChoice } from '@ai-sdk/provider';
 import * as z3 from 'zod/v3';
 import * as z4 from 'zod/v4/core';
 
@@ -126,7 +126,7 @@ interface ToolCallPart {
     /**
   Arguments of the tool call. This is a JSON-serializable object that matches the tool's input schema.
      */
-    args: unknown;
+    input: unknown;
     /**
   Additional provider-specific metadata. They are passed through
   to the provider from the AI SDK and enable provider-specific
@@ -150,7 +150,7 @@ interface ToolResultPart {
     /**
   Result of the tool call. This is a JSON-serializable object.
      */
-    result: unknown;
+    output: unknown;
     /**
   Multi-part content of the tool result. Only for tools that support multipart results.
      */
@@ -367,7 +367,7 @@ type ToolChoice<TOOLS extends Record<string, unknown>> = 'auto' | 'none' | 'requ
     toolName: Extract<keyof TOOLS, string>;
 };
 
-type ToolParameters<T = JSONObject> = z4.$ZodType<T> | z3.Schema<T> | Schema<T>;
+type ToolInputSchema<T = JSONObject> = z4.$ZodType<T> | z3.Schema<T> | Schema<T>;
 interface ToolCallOptions {
     /**
      * The ID of the tool call. You can use it e.g. when sending tool-call related information with stream data.
@@ -390,21 +390,21 @@ This enables the language model to generate the input.
 
 The tool can also contain an optional execute function for the actual execution function of the tool.
  */
-type Tool<PARAMETERS extends JSONValue | unknown | never = any, RESULT = any> = {
+type Tool<INPUT extends JSONValue | unknown | never = any, OUTPUT = any> = {
     /**
   An optional description of what the tool does.
   Will be used by the language model to decide whether to use the tool.
-  Not used for provider-defined tools.
+  Not used for provider-defined-client tools.
      */
     description?: string;
-} & NeverOptional<PARAMETERS, {
+} & NeverOptional<INPUT, {
     /**
 The schema of the input that the tool expects. The language model will use this to generate the input.
 It is also used to validate the output of the language model.
 Use descriptions to make the input understandable for the language model.
    */
-    parameters: ToolParameters<PARAMETERS>;
-}> & NeverOptional<RESULT, {
+    inputSchema: ToolInputSchema<INPUT>;
+}> & NeverOptional<OUTPUT, {
     /**
 An async function that is called with the arguments from the tool call and produces a result.
 If not provided, the tool will not be executed automatically.
@@ -412,29 +412,29 @@ If not provided, the tool will not be executed automatically.
 @args is the input of the tool call.
 @options.abortSignal is a signal that can be used to abort the tool call.
     */
-    execute: (args: [PARAMETERS] extends [never] ? undefined : PARAMETERS, options: ToolCallOptions) => PromiseLike<RESULT>;
+    execute: (input: [INPUT] extends [never] ? undefined : INPUT, options: ToolCallOptions) => PromiseLike<OUTPUT>;
     /**
 Optional conversion function that maps the tool result to multi-part tool content for LLMs.
     */
-    experimental_toToolResultContent?: (result: RESULT) => ToolResultContent;
+    experimental_toToolResultContent?: (output: OUTPUT) => ToolResultContent;
     /**
      * Optional function that is called when the argument streaming starts.
      * Only called when the tool is used in a streaming context.
      */
-    onArgsStreamingStart?: (options: ToolCallOptions) => void | PromiseLike<void>;
+    onInputStart?: (options: ToolCallOptions) => void | PromiseLike<void>;
     /**
      * Optional function that is called when an argument streaming delta is available.
      * Only called when the tool is used in a streaming context.
      */
-    onArgsStreamingDelta?: (options: {
-        argsTextDelta: string;
+    onInputDelta?: (options: {
+        inputTextDelta: string;
     } & ToolCallOptions) => void | PromiseLike<void>;
     /**
      * Optional function that is called when a tool call can be started,
      * even if the execute function is not provided.
      */
-    onArgsAvailable?: (options: {
-        args: [PARAMETERS] extends [never] ? undefined : PARAMETERS;
+    onInputAvailable?: (options: {
+        input: [INPUT] extends [never] ? undefined : INPUT;
     } & ToolCallOptions) => void | PromiseLike<void>;
 }> & ({
     /**
@@ -443,9 +443,22 @@ Function tool.
     type?: undefined | 'function';
 } | {
     /**
-Provider-defined tool.
+Provider-defined-client tool.
  */
-    type: 'provider-defined';
+    type: 'provider-defined-client';
+    /**
+The ID of the tool. Should follow the format `<provider-name>.<tool-name>`.
+ */
+    id: `${string}.${string}`;
+    /**
+The arguments for configuring the tool. Must match the expected arguments defined by the provider for this tool.
+ */
+    args: Record<string, unknown>;
+} | {
+    /**
+Provider-defined-server tool.
+ */
+    type: 'provider-defined-server';
     /**
 The ID of the tool. Should follow the format `<provider-name>.<tool-name>`.
  */
@@ -456,14 +469,14 @@ The arguments for configuring the tool. Must match the expected arguments define
     args: Record<string, unknown>;
 });
 
-type ToolSet = Record<string, (Tool<never, never> | Tool<any, any> | Tool<any, never> | Tool<never, any>) & Pick<Tool<any, any>, 'execute' | 'onArgsAvailable' | 'onArgsStreamingStart' | 'onArgsStreamingDelta'>>;
+type ToolSet = Record<string, (Tool<never, never> | Tool<any, any> | Tool<any, never> | Tool<never, any>) & Pick<Tool<any, any>, 'execute' | 'onInputAvailable' | 'onInputStart' | 'onInputDelta'>>;
 
 declare function prepareToolsAndToolChoice<TOOLS extends ToolSet>({ tools, toolChoice, activeTools, }: {
     tools: TOOLS | undefined;
     toolChoice: ToolChoice<TOOLS> | undefined;
     activeTools: Array<keyof TOOLS> | undefined;
 }): {
-    tools: Array<LanguageModelV2FunctionTool | LanguageModelV2ProviderDefinedTool> | undefined;
+    tools: Array<LanguageModelV2FunctionTool | LanguageModelV2ProviderDefinedClientTool | LanguageModelV2ProviderDefinedServerTool> | undefined;
     toolChoice: LanguageModelV2ToolChoice | undefined;
 };
 

package/dist/internal/index.js

@@ -358,7 +358,7 @@ function convertToLanguageModelMessage(message, downloadedAssets) {
                 type: "tool-call",
                 toolCallId: part.toolCallId,
                 toolName: part.toolName,
-                args: part.args,
+                input: part.input,
                 providerOptions
               };
             }
@@ -374,7 +374,7 @@ function convertToLanguageModelMessage(message, downloadedAssets) {
           type: "tool-result",
           toolCallId: part.toolCallId,
           toolName: part.toolName,
-          result: part.result,
+          output: part.output,
           content: part.experimental_content,
           isError: part.isError,
           providerOptions: part.providerOptions
@@ -514,11 +514,18 @@ function prepareToolsAndToolChoice({
             type: "function",
             name: name5,
             description: tool.description,
-            parameters: (0, import_provider_utils4.asSchema)(tool.parameters).jsonSchema
+            inputSchema: (0, import_provider_utils4.asSchema)(tool.inputSchema).jsonSchema
           };
-        case "provider-defined":
+        case "provider-defined-client":
           return {
-            type: "provider-defined",
+            type: "provider-defined-client",
+            name: name5,
+            id: tool.id,
+            args: tool.args
+          };
+        case "provider-defined-server":
+          return {
+            type: "provider-defined-server",
             name: name5,
             id: tool.id,
             args: tool.args
@@ -607,14 +614,14 @@ var toolCallPartSchema = import_zod5.z.object({
   type: import_zod5.z.literal("tool-call"),
   toolCallId: import_zod5.z.string(),
   toolName: import_zod5.z.string(),
-  args: import_zod5.z.unknown(),
+  input: import_zod5.z.unknown(),
   providerOptions: providerMetadataSchema.optional()
 });
 var toolResultPartSchema = import_zod5.z.object({
   type: import_zod5.z.literal("tool-result"),
   toolCallId: import_zod5.z.string(),
   toolName: import_zod5.z.string(),
-  result: import_zod5.z.unknown(),
+  output: import_zod5.z.unknown(),
   content: toolResultContentSchema.optional(),
   isError: import_zod5.z.boolean().optional(),
   providerOptions: providerMetadataSchema.optional()