ai 4.1.7 → 4.1.9

package/CHANGELOG.md

@@ -1,5 +1,21 @@
 # ai
 
+## 4.1.9
+
+### Patch Changes
+
+- 3a602ca: chore (core): rename CoreTool to Tool
+- Updated dependencies [3a602ca]
+  - @ai-sdk/provider-utils@2.1.5
+  - @ai-sdk/ui-utils@1.1.6
+  - @ai-sdk/react@1.1.6
+
+## 4.1.8
+
+### Patch Changes
+
+- 92f5f36: feat (core): add extractReasoningMiddleware
+
 ## 4.1.7
 
 ### Patch Changes

package/dist/index.d.mts

@@ -1,5 +1,5 @@
 import { IDGenerator } from '@ai-sdk/provider-utils';
-export { ToolCall as CoreToolCall, ToolResult as CoreToolResult, IDGenerator, createIdGenerator, generateId } from '@ai-sdk/provider-utils';
+export { CoreToolCall, CoreToolResult, IDGenerator, ToolCall, ToolResult, createIdGenerator, generateId } from '@ai-sdk/provider-utils';
 import { DataStreamString, ToolInvocation, Attachment, Schema, DeepPartial, Message, JSONValue as JSONValue$1, AssistantMessage, DataMessage } from '@ai-sdk/ui-utils';
 export { AssistantMessage, AssistantStatus, Attachment, ChatRequest, ChatRequestOptions, CreateMessage, DataMessage, DataStreamPart, DeepPartial, IdGenerator, JSONValue, Message, RequestOptions, Schema, ToolInvocation, UseAssistantOptions, formatAssistantStreamPart, formatDataStreamPart, jsonSchema, parseAssistantStreamPart, parseDataStreamPart, processDataStream, processTextStream } from '@ai-sdk/ui-utils';
 import { JSONValue, EmbeddingModelV1, EmbeddingModelV1Embedding, ImageModelV1, ImageModelV1CallWarning, LanguageModelV1, LanguageModelV1FinishReason, LanguageModelV1LogProbs, LanguageModelV1CallWarning, LanguageModelV1ProviderMetadata, LanguageModelV1CallOptions, AISDKError, LanguageModelV1FunctionToolCall, JSONSchema7, NoSuchModelError } from '@ai-sdk/provider';
@@ -150,10 +150,14 @@ Tool choice for the generation. It supports the following settings:
 - `none`: the model must not call tools
 - `{ type: 'tool', toolName: string (typed) }`: the model must call the specified tool
  */
-type CoreToolChoice<TOOLS extends Record<string, unknown>> = 'auto' | 'none' | 'required' | {
+type ToolChoice<TOOLS extends Record<string, unknown>> = 'auto' | 'none' | 'required' | {
     type: 'tool';
     toolName: keyof TOOLS;
 };
+/**
+ * @deprecated Use `ToolChoice` instead.
+ */
+type CoreToolChoice<TOOLS extends Record<string, unknown>> = ToolChoice<TOOLS>;
 
 type LanguageModelRequestMetadata = {
     /**
@@ -1356,6 +1360,16 @@ Callback that is called when the LLM response and the final object validation ar
     };
 }): StreamObjectResult<JSONValue, JSONValue, never>;
 
+/**
+ * Appends a client message to the messages array.
+ * If the last message in the array has the same id as the new message, it will be replaced.
+ * Otherwise, the new message will be appended.
+ */
+declare function appendClientMessage({ messages, message, }: {
+    messages: Message[];
+    message: Message;
+}): Message[];
+
 type Parameters = z.ZodTypeAny | Schema<any>;
 type inferParameters<PARAMETERS extends Parameters> = PARAMETERS extends Schema<any> ? PARAMETERS['_type'] : PARAMETERS extends z.ZodTypeAny ? z.infer<PARAMETERS> : never;
 interface ToolExecutionOptions {
@@ -1379,7 +1393,7 @@ 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 CoreTool<PARAMETERS extends Parameters = any, RESULT = any> = {
+type Tool<PARAMETERS extends Parameters = any, RESULT = any> = {
     /**
   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.
@@ -1421,30 +1435,24 @@ The arguments for configuring the tool. Must match the expected arguments define
      */
     args: Record<string, unknown>;
 });
+/**
+ * @deprecated Use `Tool` instead.
+ */
+type CoreTool<PARAMETERS extends Parameters = any, RESULT = any> = Tool<PARAMETERS, RESULT>;
 /**
 Helper function for inferring the execute args of a tool.
  */
-declare function tool<PARAMETERS extends Parameters, RESULT>(tool: CoreTool<PARAMETERS, RESULT> & {
+declare function tool<PARAMETERS extends Parameters, RESULT>(tool: Tool<PARAMETERS, RESULT> & {
     execute: (args: inferParameters<PARAMETERS>, options: ToolExecutionOptions) => PromiseLike<RESULT>;
-}): CoreTool<PARAMETERS, RESULT> & {
+}): Tool<PARAMETERS, RESULT> & {
     execute: (args: inferParameters<PARAMETERS>, options: ToolExecutionOptions) => PromiseLike<RESULT>;
 };
-declare function tool<PARAMETERS extends Parameters, RESULT>(tool: CoreTool<PARAMETERS, RESULT> & {
+declare function tool<PARAMETERS extends Parameters, RESULT>(tool: Tool<PARAMETERS, RESULT> & {
     execute?: undefined;
-}): CoreTool<PARAMETERS, RESULT> & {
+}): Tool<PARAMETERS, RESULT> & {
     execute: undefined;
 };
 
-/**
- * Appends a client message to the messages array.
- * If the last message in the array has the same id as the new message, it will be replaced.
- * Otherwise, the new message will be appended.
- */
-declare function appendClientMessage({ messages, message, }: {
-    messages: Message[];
-    message: Message;
-}): Message[];
-
 /**
 Create a union of the given object's values, and optionally specify which keys to get the values from.
 
@@ -1487,7 +1495,9 @@ onlyBar('bar');
 */
 type ValueOf<ObjectType, ValueType extends keyof ObjectType = keyof ObjectType> = ObjectType[ValueType];
 
-type ToolCallUnion<TOOLS extends Record<string, CoreTool>> = ValueOf<{
+type ToolSet = Record<string, Tool>;
+
+type ToolCallUnion<TOOLS extends ToolSet> = ValueOf<{
     [NAME in keyof TOOLS]: {
         type: 'tool-call';
         toolCallId: string;
@@ -1495,17 +1505,21 @@ type ToolCallUnion<TOOLS extends Record<string, CoreTool>> = ValueOf<{
         args: inferParameters<TOOLS[NAME]['parameters']>;
     };
 }>;
-type ToolCallArray<TOOLS extends Record<string, CoreTool>> = Array<ToolCallUnion<TOOLS>>;
+/**
+ * @deprecated Use `ToolCallUnion` instead.
+ */
+type CoreToolCallUnion<TOOLS extends ToolSet> = ToolCallUnion<ToolSet>;
+type ToolCallArray<TOOLS extends ToolSet> = Array<ToolCallUnion<TOOLS>>;
 
-type ToToolsWithExecute<TOOLS extends Record<string, CoreTool>> = {
+type ToToolsWithExecute<TOOLS extends ToolSet> = {
     [K in keyof TOOLS as TOOLS[K] extends {
         execute: any;
     } ? K : never]: TOOLS[K];
 };
-type ToToolsWithDefinedExecute<TOOLS extends Record<string, CoreTool>> = {
+type ToToolsWithDefinedExecute<TOOLS extends ToolSet> = {
     [K in keyof TOOLS as TOOLS[K]['execute'] extends undefined ? never : K]: TOOLS[K];
 };
-type ToToolResultObject<TOOLS extends Record<string, CoreTool>> = ValueOf<{
+type ToToolResultObject<TOOLS extends ToolSet> = ValueOf<{
     [NAME in keyof TOOLS]: {
         type: 'tool-result';
         toolCallId: string;
@@ -1514,8 +1528,12 @@ type ToToolResultObject<TOOLS extends Record<string, CoreTool>> = ValueOf<{
         result: Awaited<ReturnType<Exclude<TOOLS[NAME]['execute'], undefined>>>;
     };
 }>;
-type ToolResultUnion<TOOLS extends Record<string, CoreTool>> = ToToolResultObject<ToToolsWithDefinedExecute<ToToolsWithExecute<TOOLS>>>;
-type ToolResultArray<TOOLS extends Record<string, CoreTool>> = Array<ToolResultUnion<TOOLS>>;
+type ToolResultUnion<TOOLS extends ToolSet> = ToToolResultObject<ToToolsWithDefinedExecute<ToToolsWithExecute<TOOLS>>>;
+/**
+ * @deprecated Use `ToolResultUnion` instead.
+ */
+type CoreToolResultUnion<TOOLS extends ToolSet> = ToolResultUnion<TOOLS>;
+type ToolResultArray<TOOLS extends ToolSet> = Array<ToolResultUnion<TOOLS>>;
 
 /**
 A message that was generated during the generation process.
@@ -1530,7 +1548,7 @@ Message ID generated by the AI SDK.
 /**
  * The result of a single step in the generation process.
  */
-type StepResult<TOOLS extends Record<string, CoreTool>> = {
+type StepResult<TOOLS extends ToolSet> = {
     /**
   The generated text.
   */
@@ -1613,7 +1631,7 @@ declare function appendResponseMessages({ messages, responseMessages, }: {
 Converts an array of messages from useChat into an array of CoreMessages that can be used
 with the AI core functions (e.g. `streamText`).
  */
-declare function convertToCoreMessages<TOOLS extends Record<string, CoreTool> = never>(messages: Array<UIMessage>, options?: {
+declare function convertToCoreMessages<TOOLS extends ToolSet = never>(messages: Array<UIMessage>, options?: {
     tools?: TOOLS;
 }): CoreMessage[];
 
@@ -1621,7 +1639,7 @@ declare function convertToCoreMessages<TOOLS extends Record<string, CoreTool> =
 The result of a `generateText` call.
 It contains the generated text, the tool calls that were made during the generation, and the results of the tool calls.
  */
-interface GenerateTextResult<TOOLS extends Record<string, CoreTool>, OUTPUT> {
+interface GenerateTextResult<TOOLS extends ToolSet, OUTPUT> {
     /**
   The generated text.
        */
@@ -1771,7 +1789,7 @@ declare class NoSuchToolError extends AISDKError {
  * @param options.parameterSchema - A function that returns the JSON Schema for a tool.
  * @param options.error - The error that occurred while parsing the tool call.
  */
-type ToolCallRepairFunction<TOOLS extends Record<string, CoreTool>> = (options: {
+type ToolCallRepairFunction<TOOLS extends ToolSet> = (options: {
     system: string | undefined;
     messages: CoreMessage[];
     toolCall: LanguageModelV1FunctionToolCall;
@@ -1829,7 +1847,7 @@ If set and supported by the model, calls will generate deterministic results.
 @returns
 A result object that contains the generated text, the results of the tool calls, and additional information.
  */
-declare function generateText<TOOLS extends Record<string, CoreTool>, OUTPUT = never, OUTPUT_PARTIAL = never>({ model, tools, toolChoice, system, prompt, messages, maxRetries: maxRetriesArg, abortSignal, headers, maxSteps, experimental_generateMessageId: generateMessageId, experimental_output: output, experimental_continueSteps: continueSteps, experimental_telemetry: telemetry, experimental_providerMetadata: providerMetadata, experimental_activeTools: activeTools, experimental_repairToolCall: repairToolCall, _internal: { generateId, currentDate, }, onStepFinish, ...settings }: CallSettings & Prompt & {
+declare function generateText<TOOLS extends ToolSet, OUTPUT = never, OUTPUT_PARTIAL = never>({ model, tools, toolChoice, system, prompt, messages, maxRetries: maxRetriesArg, abortSignal, headers, maxSteps, experimental_generateMessageId: generateMessageId, experimental_output: output, experimental_continueSteps: continueSteps, experimental_telemetry: telemetry, experimental_providerMetadata: providerMetadata, experimental_activeTools: activeTools, experimental_repairToolCall: repairToolCall, _internal: { generateId, currentDate, }, onStepFinish, ...settings }: CallSettings & Prompt & {
     /**
 The language model to use.
      */
@@ -1841,7 +1859,7 @@ The tools that the model can call. The model needs to support calling tools.
     /**
 The tool choice strategy. Default: 'auto'.
      */
-    toolChoice?: CoreToolChoice<TOOLS>;
+    toolChoice?: ToolChoice<TOOLS>;
     /**
 Maximum number of sequential LLM calls (steps), e.g. when you use tool calls. Must be at least 1.
 
@@ -1916,7 +1934,7 @@ declare class StreamData {
 /**
 A result object for accessing different stream types and additional information.
  */
-interface StreamTextResult<TOOLS extends Record<string, CoreTool>, PARTIAL_OUTPUT> {
+interface StreamTextResult<TOOLS extends ToolSet, PARTIAL_OUTPUT> {
     /**
   Warnings from the model provider (e.g. unsupported settings) for the first step.
        */
@@ -2087,7 +2105,7 @@ interface StreamTextResult<TOOLS extends Record<string, CoreTool>, PARTIAL_OUTPU
        */
     toTextStreamResponse(init?: ResponseInit): Response;
 }
-type TextStreamPart<TOOLS extends Record<string, CoreTool>> = {
+type TextStreamPart<TOOLS extends ToolSet> = {
     type: 'text-delta';
     textDelta: string;
 } | {
@@ -2148,7 +2166,7 @@ type TextStreamPart<TOOLS extends Record<string, CoreTool>> = {
  *
  * @returns A transform stream that smooths text streaming output.
  */
-declare function smoothStream<TOOLS extends Record<string, CoreTool>>({ delayInMs, chunking, _internal: { delay }, }?: {
+declare function smoothStream<TOOLS extends ToolSet>({ delayInMs, chunking, _internal: { delay }, }?: {
     delayInMs?: number | null;
     chunking?: 'word' | 'line' | RegExp;
     /**
@@ -2167,7 +2185,7 @@ A transformation that is applied to the stream.
 @param stopStream - A function that stops the source stream.
 @param tools - The tools that are accessible to and can be called by the model. The model needs to support calling tools.
  */
-type StreamTextTransform<TOOLS extends Record<string, CoreTool>> = (options: {
+type StreamTextTransform<TOOLS extends ToolSet> = (options: {
     tools: TOOLS;
     stopStream: () => void;
 }) => TransformStream<TextStreamPart<TOOLS>, TextStreamPart<TOOLS>>;
@@ -2219,7 +2237,7 @@ If set and supported by the model, calls will generate deterministic results.
 @return
 A result object for accessing different stream types and additional information.
  */
-declare function streamText<TOOLS extends Record<string, CoreTool>, OUTPUT = never, PARTIAL_OUTPUT = never>({ model, tools, toolChoice, system, prompt, messages, maxRetries, abortSignal, headers, maxSteps, experimental_generateMessageId: generateMessageId, experimental_output: output, experimental_continueSteps: continueSteps, experimental_telemetry: telemetry, experimental_providerMetadata: providerMetadata, experimental_toolCallStreaming, toolCallStreaming, experimental_activeTools: activeTools, experimental_repairToolCall: repairToolCall, experimental_transform: transform, onChunk, onFinish, onStepFinish, _internal: { now, generateId, currentDate, }, ...settings }: CallSettings & Prompt & {
+declare function streamText<TOOLS extends ToolSet, OUTPUT = never, PARTIAL_OUTPUT = never>({ model, tools, toolChoice, system, prompt, messages, maxRetries, abortSignal, headers, maxSteps, experimental_generateMessageId: generateMessageId, experimental_output: output, experimental_continueSteps: continueSteps, experimental_telemetry: telemetry, experimental_providerMetadata: providerMetadata, experimental_toolCallStreaming, toolCallStreaming, experimental_activeTools: activeTools, experimental_repairToolCall: repairToolCall, experimental_transform: transform, onChunk, onFinish, onStepFinish, _internal: { now, generateId, currentDate, }, ...settings }: CallSettings & Prompt & {
     /**
 The language model to use.
      */
@@ -2231,7 +2249,7 @@ The tools that the model can call. The model needs to support calling tools.
     /**
 The tool choice strategy. Default: 'auto'.
      */
-    toolChoice?: CoreToolChoice<TOOLS>;
+    toolChoice?: ToolChoice<TOOLS>;
     /**
 Maximum number of sequential LLM calls (steps), e.g. when you use tool calls. Must be at least 1.
 
@@ -2387,6 +2405,18 @@ declare const experimental_wrapLanguageModel: ({ model, middleware: { transformP
     providerId?: string;
 }) => LanguageModelV1;
 
+/**
+ * Extract an XML-tagged reasoning section from the generated text and exposes it
+ * as a `reasoning` property on the result.
+ *
+ * @param tagName - The name of the XML tag to extract reasoning from.
+ * @param separator - The separator to use between reasoning and text sections.
+ */
+declare function extractReasoningMiddleware({ tagName, separator, }: {
+    tagName: string;
+    separator?: string;
+}): Experimental_LanguageModelV1Middleware;
+
 /**
  * Creates a custom provider with specified language models, text embedding models, and an optional fallback provider.
  *
@@ -2768,4 +2798,4 @@ declare namespace llamaindexAdapter {
   };
 }
 
-export { AssistantContent, AssistantResponse, CallWarning, CoreAssistantMessage, CoreMessage, CoreSystemMessage, CoreTool, ToolCallUnion as CoreToolCallUnion, CoreToolChoice, CoreToolMessage, ToolResultUnion as CoreToolResultUnion, CoreUserMessage, DataContent, DataStreamWriter, DownloadError, EmbedManyResult, EmbedResult, Embedding, EmbeddingModel, EmbeddingModelUsage, GenerateImageResult as Experimental_GenerateImageResult, GeneratedImage as Experimental_GeneratedImage, Experimental_LanguageModelV1Middleware, FilePart, FinishReason, GenerateObjectResult, GenerateTextResult, ImageModel, ImageGenerationWarning as ImageModelCallWarning, ImageModelResponseMetadata, ImagePart, InvalidArgumentError, InvalidDataContentError, InvalidMessageRoleError, InvalidToolArgumentsError, langchainAdapter as LangChainAdapter, LanguageModel, LanguageModelRequestMetadata, LanguageModelResponseMetadata, LanguageModelUsage, llamaindexAdapter as LlamaIndexAdapter, LogProbs, MessageConversionError, NoImageGeneratedError, NoObjectGeneratedError, NoOutputSpecifiedError, NoSuchProviderError, NoSuchToolError, ObjectStreamPart, output as Output, Provider, ProviderMetadata, RetryError, StepResult, StreamData, StreamObjectResult, StreamTextResult, StreamTextTransform, TelemetrySettings, TextPart, TextStreamPart, ToolCallPart, ToolCallRepairError, ToolCallRepairFunction, ToolContent, ToolExecutionError, ToolExecutionOptions, ToolResultPart, UserContent, appendClientMessage, appendResponseMessages, convertToCoreMessages, coreAssistantMessageSchema, coreMessageSchema, coreSystemMessageSchema, coreToolMessageSchema, coreUserMessageSchema, cosineSimilarity, createDataStream, createDataStreamResponse, embed, embedMany, experimental_createProviderRegistry, experimental_customProvider, generateImage as experimental_generateImage, experimental_wrapLanguageModel, generateObject, generateText, pipeDataStreamToResponse, simulateReadableStream, smoothStream, streamObject, streamText, tool };
+export { AssistantContent, AssistantResponse, CallWarning, CoreAssistantMessage, CoreMessage, CoreSystemMessage, CoreTool, CoreToolCallUnion, CoreToolChoice, CoreToolMessage, CoreToolResultUnion, CoreUserMessage, DataContent, DataStreamWriter, DownloadError, EmbedManyResult, EmbedResult, Embedding, EmbeddingModel, EmbeddingModelUsage, GenerateImageResult as Experimental_GenerateImageResult, GeneratedImage as Experimental_GeneratedImage, Experimental_LanguageModelV1Middleware, FilePart, FinishReason, GenerateObjectResult, GenerateTextResult, ImageModel, ImageGenerationWarning as ImageModelCallWarning, ImageModelResponseMetadata, ImagePart, InvalidArgumentError, InvalidDataContentError, InvalidMessageRoleError, InvalidToolArgumentsError, langchainAdapter as LangChainAdapter, LanguageModel, LanguageModelRequestMetadata, LanguageModelResponseMetadata, LanguageModelUsage, llamaindexAdapter as LlamaIndexAdapter, LogProbs, MessageConversionError, NoImageGeneratedError, NoObjectGeneratedError, NoOutputSpecifiedError, NoSuchProviderError, NoSuchToolError, ObjectStreamPart, output as Output, Provider, ProviderMetadata, RetryError, StepResult, StreamData, StreamObjectResult, StreamTextResult, StreamTextTransform, TelemetrySettings, TextPart, TextStreamPart, Tool, ToolCallPart, ToolCallRepairError, ToolCallRepairFunction, ToolCallUnion, ToolChoice, ToolContent, ToolExecutionError, ToolExecutionOptions, ToolResultPart, ToolResultUnion, ToolSet, UserContent, appendClientMessage, appendResponseMessages, convertToCoreMessages, coreAssistantMessageSchema, coreMessageSchema, coreSystemMessageSchema, coreToolMessageSchema, coreUserMessageSchema, cosineSimilarity, createDataStream, createDataStreamResponse, embed, embedMany, experimental_createProviderRegistry, experimental_customProvider, generateImage as experimental_generateImage, experimental_wrapLanguageModel, extractReasoningMiddleware, generateObject, generateText, pipeDataStreamToResponse, simulateReadableStream, smoothStream, streamObject, streamText, tool };

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 import { IDGenerator } from '@ai-sdk/provider-utils';
-export { ToolCall as CoreToolCall, ToolResult as CoreToolResult, IDGenerator, createIdGenerator, generateId } from '@ai-sdk/provider-utils';
+export { CoreToolCall, CoreToolResult, IDGenerator, ToolCall, ToolResult, createIdGenerator, generateId } from '@ai-sdk/provider-utils';
 import { DataStreamString, ToolInvocation, Attachment, Schema, DeepPartial, Message, JSONValue as JSONValue$1, AssistantMessage, DataMessage } from '@ai-sdk/ui-utils';
 export { AssistantMessage, AssistantStatus, Attachment, ChatRequest, ChatRequestOptions, CreateMessage, DataMessage, DataStreamPart, DeepPartial, IdGenerator, JSONValue, Message, RequestOptions, Schema, ToolInvocation, UseAssistantOptions, formatAssistantStreamPart, formatDataStreamPart, jsonSchema, parseAssistantStreamPart, parseDataStreamPart, processDataStream, processTextStream } from '@ai-sdk/ui-utils';
 import { JSONValue, EmbeddingModelV1, EmbeddingModelV1Embedding, ImageModelV1, ImageModelV1CallWarning, LanguageModelV1, LanguageModelV1FinishReason, LanguageModelV1LogProbs, LanguageModelV1CallWarning, LanguageModelV1ProviderMetadata, LanguageModelV1CallOptions, AISDKError, LanguageModelV1FunctionToolCall, JSONSchema7, NoSuchModelError } from '@ai-sdk/provider';
@@ -150,10 +150,14 @@ Tool choice for the generation. It supports the following settings:
 - `none`: the model must not call tools
 - `{ type: 'tool', toolName: string (typed) }`: the model must call the specified tool
  */
-type CoreToolChoice<TOOLS extends Record<string, unknown>> = 'auto' | 'none' | 'required' | {
+type ToolChoice<TOOLS extends Record<string, unknown>> = 'auto' | 'none' | 'required' | {
     type: 'tool';
     toolName: keyof TOOLS;
 };
+/**
+ * @deprecated Use `ToolChoice` instead.
+ */
+type CoreToolChoice<TOOLS extends Record<string, unknown>> = ToolChoice<TOOLS>;
 
 type LanguageModelRequestMetadata = {
     /**
@@ -1356,6 +1360,16 @@ Callback that is called when the LLM response and the final object validation ar
     };
 }): StreamObjectResult<JSONValue, JSONValue, never>;
 
+/**
+ * Appends a client message to the messages array.
+ * If the last message in the array has the same id as the new message, it will be replaced.
+ * Otherwise, the new message will be appended.
+ */
+declare function appendClientMessage({ messages, message, }: {
+    messages: Message[];
+    message: Message;
+}): Message[];
+
 type Parameters = z.ZodTypeAny | Schema<any>;
 type inferParameters<PARAMETERS extends Parameters> = PARAMETERS extends Schema<any> ? PARAMETERS['_type'] : PARAMETERS extends z.ZodTypeAny ? z.infer<PARAMETERS> : never;
 interface ToolExecutionOptions {
@@ -1379,7 +1393,7 @@ 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 CoreTool<PARAMETERS extends Parameters = any, RESULT = any> = {
+type Tool<PARAMETERS extends Parameters = any, RESULT = any> = {
     /**
   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.
@@ -1421,30 +1435,24 @@ The arguments for configuring the tool. Must match the expected arguments define
      */
     args: Record<string, unknown>;
 });
+/**
+ * @deprecated Use `Tool` instead.
+ */
+type CoreTool<PARAMETERS extends Parameters = any, RESULT = any> = Tool<PARAMETERS, RESULT>;
 /**
 Helper function for inferring the execute args of a tool.
  */
-declare function tool<PARAMETERS extends Parameters, RESULT>(tool: CoreTool<PARAMETERS, RESULT> & {
+declare function tool<PARAMETERS extends Parameters, RESULT>(tool: Tool<PARAMETERS, RESULT> & {
     execute: (args: inferParameters<PARAMETERS>, options: ToolExecutionOptions) => PromiseLike<RESULT>;
-}): CoreTool<PARAMETERS, RESULT> & {
+}): Tool<PARAMETERS, RESULT> & {
     execute: (args: inferParameters<PARAMETERS>, options: ToolExecutionOptions) => PromiseLike<RESULT>;
 };
-declare function tool<PARAMETERS extends Parameters, RESULT>(tool: CoreTool<PARAMETERS, RESULT> & {
+declare function tool<PARAMETERS extends Parameters, RESULT>(tool: Tool<PARAMETERS, RESULT> & {
     execute?: undefined;
-}): CoreTool<PARAMETERS, RESULT> & {
+}): Tool<PARAMETERS, RESULT> & {
     execute: undefined;
 };
 
-/**
- * Appends a client message to the messages array.
- * If the last message in the array has the same id as the new message, it will be replaced.
- * Otherwise, the new message will be appended.
- */
-declare function appendClientMessage({ messages, message, }: {
-    messages: Message[];
-    message: Message;
-}): Message[];
-
 /**
 Create a union of the given object's values, and optionally specify which keys to get the values from.
 
@@ -1487,7 +1495,9 @@ onlyBar('bar');
 */
 type ValueOf<ObjectType, ValueType extends keyof ObjectType = keyof ObjectType> = ObjectType[ValueType];
 
-type ToolCallUnion<TOOLS extends Record<string, CoreTool>> = ValueOf<{
+type ToolSet = Record<string, Tool>;
+
+type ToolCallUnion<TOOLS extends ToolSet> = ValueOf<{
     [NAME in keyof TOOLS]: {
         type: 'tool-call';
         toolCallId: string;
@@ -1495,17 +1505,21 @@ type ToolCallUnion<TOOLS extends Record<string, CoreTool>> = ValueOf<{
         args: inferParameters<TOOLS[NAME]['parameters']>;
     };
 }>;
-type ToolCallArray<TOOLS extends Record<string, CoreTool>> = Array<ToolCallUnion<TOOLS>>;
+/**
+ * @deprecated Use `ToolCallUnion` instead.
+ */
+type CoreToolCallUnion<TOOLS extends ToolSet> = ToolCallUnion<ToolSet>;
+type ToolCallArray<TOOLS extends ToolSet> = Array<ToolCallUnion<TOOLS>>;
 
-type ToToolsWithExecute<TOOLS extends Record<string, CoreTool>> = {
+type ToToolsWithExecute<TOOLS extends ToolSet> = {
     [K in keyof TOOLS as TOOLS[K] extends {
         execute: any;
     } ? K : never]: TOOLS[K];
 };
-type ToToolsWithDefinedExecute<TOOLS extends Record<string, CoreTool>> = {
+type ToToolsWithDefinedExecute<TOOLS extends ToolSet> = {
     [K in keyof TOOLS as TOOLS[K]['execute'] extends undefined ? never : K]: TOOLS[K];
 };
-type ToToolResultObject<TOOLS extends Record<string, CoreTool>> = ValueOf<{
+type ToToolResultObject<TOOLS extends ToolSet> = ValueOf<{
     [NAME in keyof TOOLS]: {
         type: 'tool-result';
         toolCallId: string;
@@ -1514,8 +1528,12 @@ type ToToolResultObject<TOOLS extends Record<string, CoreTool>> = ValueOf<{
         result: Awaited<ReturnType<Exclude<TOOLS[NAME]['execute'], undefined>>>;
     };
 }>;
-type ToolResultUnion<TOOLS extends Record<string, CoreTool>> = ToToolResultObject<ToToolsWithDefinedExecute<ToToolsWithExecute<TOOLS>>>;
-type ToolResultArray<TOOLS extends Record<string, CoreTool>> = Array<ToolResultUnion<TOOLS>>;
+type ToolResultUnion<TOOLS extends ToolSet> = ToToolResultObject<ToToolsWithDefinedExecute<ToToolsWithExecute<TOOLS>>>;
+/**
+ * @deprecated Use `ToolResultUnion` instead.
+ */
+type CoreToolResultUnion<TOOLS extends ToolSet> = ToolResultUnion<TOOLS>;
+type ToolResultArray<TOOLS extends ToolSet> = Array<ToolResultUnion<TOOLS>>;
 
 /**
 A message that was generated during the generation process.
@@ -1530,7 +1548,7 @@ Message ID generated by the AI SDK.
 /**
  * The result of a single step in the generation process.
  */
-type StepResult<TOOLS extends Record<string, CoreTool>> = {
+type StepResult<TOOLS extends ToolSet> = {
     /**
   The generated text.
   */
@@ -1613,7 +1631,7 @@ declare function appendResponseMessages({ messages, responseMessages, }: {
 Converts an array of messages from useChat into an array of CoreMessages that can be used
 with the AI core functions (e.g. `streamText`).
  */
-declare function convertToCoreMessages<TOOLS extends Record<string, CoreTool> = never>(messages: Array<UIMessage>, options?: {
+declare function convertToCoreMessages<TOOLS extends ToolSet = never>(messages: Array<UIMessage>, options?: {
     tools?: TOOLS;
 }): CoreMessage[];
 
@@ -1621,7 +1639,7 @@ declare function convertToCoreMessages<TOOLS extends Record<string, CoreTool> =
 The result of a `generateText` call.
 It contains the generated text, the tool calls that were made during the generation, and the results of the tool calls.
  */
-interface GenerateTextResult<TOOLS extends Record<string, CoreTool>, OUTPUT> {
+interface GenerateTextResult<TOOLS extends ToolSet, OUTPUT> {
     /**
   The generated text.
        */
@@ -1771,7 +1789,7 @@ declare class NoSuchToolError extends AISDKError {
  * @param options.parameterSchema - A function that returns the JSON Schema for a tool.
  * @param options.error - The error that occurred while parsing the tool call.
  */
-type ToolCallRepairFunction<TOOLS extends Record<string, CoreTool>> = (options: {
+type ToolCallRepairFunction<TOOLS extends ToolSet> = (options: {
     system: string | undefined;
     messages: CoreMessage[];
     toolCall: LanguageModelV1FunctionToolCall;
@@ -1829,7 +1847,7 @@ If set and supported by the model, calls will generate deterministic results.
 @returns
 A result object that contains the generated text, the results of the tool calls, and additional information.
  */
-declare function generateText<TOOLS extends Record<string, CoreTool>, OUTPUT = never, OUTPUT_PARTIAL = never>({ model, tools, toolChoice, system, prompt, messages, maxRetries: maxRetriesArg, abortSignal, headers, maxSteps, experimental_generateMessageId: generateMessageId, experimental_output: output, experimental_continueSteps: continueSteps, experimental_telemetry: telemetry, experimental_providerMetadata: providerMetadata, experimental_activeTools: activeTools, experimental_repairToolCall: repairToolCall, _internal: { generateId, currentDate, }, onStepFinish, ...settings }: CallSettings & Prompt & {
+declare function generateText<TOOLS extends ToolSet, OUTPUT = never, OUTPUT_PARTIAL = never>({ model, tools, toolChoice, system, prompt, messages, maxRetries: maxRetriesArg, abortSignal, headers, maxSteps, experimental_generateMessageId: generateMessageId, experimental_output: output, experimental_continueSteps: continueSteps, experimental_telemetry: telemetry, experimental_providerMetadata: providerMetadata, experimental_activeTools: activeTools, experimental_repairToolCall: repairToolCall, _internal: { generateId, currentDate, }, onStepFinish, ...settings }: CallSettings & Prompt & {
     /**
 The language model to use.
      */
@@ -1841,7 +1859,7 @@ The tools that the model can call. The model needs to support calling tools.
     /**
 The tool choice strategy. Default: 'auto'.
      */
-    toolChoice?: CoreToolChoice<TOOLS>;
+    toolChoice?: ToolChoice<TOOLS>;
     /**
 Maximum number of sequential LLM calls (steps), e.g. when you use tool calls. Must be at least 1.
 
@@ -1916,7 +1934,7 @@ declare class StreamData {
 /**
 A result object for accessing different stream types and additional information.
  */
-interface StreamTextResult<TOOLS extends Record<string, CoreTool>, PARTIAL_OUTPUT> {
+interface StreamTextResult<TOOLS extends ToolSet, PARTIAL_OUTPUT> {
     /**
   Warnings from the model provider (e.g. unsupported settings) for the first step.
        */
@@ -2087,7 +2105,7 @@ interface StreamTextResult<TOOLS extends Record<string, CoreTool>, PARTIAL_OUTPU
        */
     toTextStreamResponse(init?: ResponseInit): Response;
 }
-type TextStreamPart<TOOLS extends Record<string, CoreTool>> = {
+type TextStreamPart<TOOLS extends ToolSet> = {
     type: 'text-delta';
     textDelta: string;
 } | {
@@ -2148,7 +2166,7 @@ type TextStreamPart<TOOLS extends Record<string, CoreTool>> = {
  *
  * @returns A transform stream that smooths text streaming output.
  */
-declare function smoothStream<TOOLS extends Record<string, CoreTool>>({ delayInMs, chunking, _internal: { delay }, }?: {
+declare function smoothStream<TOOLS extends ToolSet>({ delayInMs, chunking, _internal: { delay }, }?: {
     delayInMs?: number | null;
     chunking?: 'word' | 'line' | RegExp;
     /**
@@ -2167,7 +2185,7 @@ A transformation that is applied to the stream.
 @param stopStream - A function that stops the source stream.
 @param tools - The tools that are accessible to and can be called by the model. The model needs to support calling tools.
  */
-type StreamTextTransform<TOOLS extends Record<string, CoreTool>> = (options: {
+type StreamTextTransform<TOOLS extends ToolSet> = (options: {
     tools: TOOLS;
     stopStream: () => void;
 }) => TransformStream<TextStreamPart<TOOLS>, TextStreamPart<TOOLS>>;
@@ -2219,7 +2237,7 @@ If set and supported by the model, calls will generate deterministic results.
 @return
 A result object for accessing different stream types and additional information.
  */
-declare function streamText<TOOLS extends Record<string, CoreTool>, OUTPUT = never, PARTIAL_OUTPUT = never>({ model, tools, toolChoice, system, prompt, messages, maxRetries, abortSignal, headers, maxSteps, experimental_generateMessageId: generateMessageId, experimental_output: output, experimental_continueSteps: continueSteps, experimental_telemetry: telemetry, experimental_providerMetadata: providerMetadata, experimental_toolCallStreaming, toolCallStreaming, experimental_activeTools: activeTools, experimental_repairToolCall: repairToolCall, experimental_transform: transform, onChunk, onFinish, onStepFinish, _internal: { now, generateId, currentDate, }, ...settings }: CallSettings & Prompt & {
+declare function streamText<TOOLS extends ToolSet, OUTPUT = never, PARTIAL_OUTPUT = never>({ model, tools, toolChoice, system, prompt, messages, maxRetries, abortSignal, headers, maxSteps, experimental_generateMessageId: generateMessageId, experimental_output: output, experimental_continueSteps: continueSteps, experimental_telemetry: telemetry, experimental_providerMetadata: providerMetadata, experimental_toolCallStreaming, toolCallStreaming, experimental_activeTools: activeTools, experimental_repairToolCall: repairToolCall, experimental_transform: transform, onChunk, onFinish, onStepFinish, _internal: { now, generateId, currentDate, }, ...settings }: CallSettings & Prompt & {
     /**
 The language model to use.
      */
@@ -2231,7 +2249,7 @@ The tools that the model can call. The model needs to support calling tools.
     /**
 The tool choice strategy. Default: 'auto'.
      */
-    toolChoice?: CoreToolChoice<TOOLS>;
+    toolChoice?: ToolChoice<TOOLS>;
     /**
 Maximum number of sequential LLM calls (steps), e.g. when you use tool calls. Must be at least 1.
 
@@ -2387,6 +2405,18 @@ declare const experimental_wrapLanguageModel: ({ model, middleware: { transformP
     providerId?: string;
 }) => LanguageModelV1;
 
+/**
+ * Extract an XML-tagged reasoning section from the generated text and exposes it
+ * as a `reasoning` property on the result.
+ *
+ * @param tagName - The name of the XML tag to extract reasoning from.
+ * @param separator - The separator to use between reasoning and text sections.
+ */
+declare function extractReasoningMiddleware({ tagName, separator, }: {
+    tagName: string;
+    separator?: string;
+}): Experimental_LanguageModelV1Middleware;
+
 /**
  * Creates a custom provider with specified language models, text embedding models, and an optional fallback provider.
  *
@@ -2768,4 +2798,4 @@ declare namespace llamaindexAdapter {
   };
 }
 
-export { AssistantContent, AssistantResponse, CallWarning, CoreAssistantMessage, CoreMessage, CoreSystemMessage, CoreTool, ToolCallUnion as CoreToolCallUnion, CoreToolChoice, CoreToolMessage, ToolResultUnion as CoreToolResultUnion, CoreUserMessage, DataContent, DataStreamWriter, DownloadError, EmbedManyResult, EmbedResult, Embedding, EmbeddingModel, EmbeddingModelUsage, GenerateImageResult as Experimental_GenerateImageResult, GeneratedImage as Experimental_GeneratedImage, Experimental_LanguageModelV1Middleware, FilePart, FinishReason, GenerateObjectResult, GenerateTextResult, ImageModel, ImageGenerationWarning as ImageModelCallWarning, ImageModelResponseMetadata, ImagePart, InvalidArgumentError, InvalidDataContentError, InvalidMessageRoleError, InvalidToolArgumentsError, langchainAdapter as LangChainAdapter, LanguageModel, LanguageModelRequestMetadata, LanguageModelResponseMetadata, LanguageModelUsage, llamaindexAdapter as LlamaIndexAdapter, LogProbs, MessageConversionError, NoImageGeneratedError, NoObjectGeneratedError, NoOutputSpecifiedError, NoSuchProviderError, NoSuchToolError, ObjectStreamPart, output as Output, Provider, ProviderMetadata, RetryError, StepResult, StreamData, StreamObjectResult, StreamTextResult, StreamTextTransform, TelemetrySettings, TextPart, TextStreamPart, ToolCallPart, ToolCallRepairError, ToolCallRepairFunction, ToolContent, ToolExecutionError, ToolExecutionOptions, ToolResultPart, UserContent, appendClientMessage, appendResponseMessages, convertToCoreMessages, coreAssistantMessageSchema, coreMessageSchema, coreSystemMessageSchema, coreToolMessageSchema, coreUserMessageSchema, cosineSimilarity, createDataStream, createDataStreamResponse, embed, embedMany, experimental_createProviderRegistry, experimental_customProvider, generateImage as experimental_generateImage, experimental_wrapLanguageModel, generateObject, generateText, pipeDataStreamToResponse, simulateReadableStream, smoothStream, streamObject, streamText, tool };
+export { AssistantContent, AssistantResponse, CallWarning, CoreAssistantMessage, CoreMessage, CoreSystemMessage, CoreTool, CoreToolCallUnion, CoreToolChoice, CoreToolMessage, CoreToolResultUnion, CoreUserMessage, DataContent, DataStreamWriter, DownloadError, EmbedManyResult, EmbedResult, Embedding, EmbeddingModel, EmbeddingModelUsage, GenerateImageResult as Experimental_GenerateImageResult, GeneratedImage as Experimental_GeneratedImage, Experimental_LanguageModelV1Middleware, FilePart, FinishReason, GenerateObjectResult, GenerateTextResult, ImageModel, ImageGenerationWarning as ImageModelCallWarning, ImageModelResponseMetadata, ImagePart, InvalidArgumentError, InvalidDataContentError, InvalidMessageRoleError, InvalidToolArgumentsError, langchainAdapter as LangChainAdapter, LanguageModel, LanguageModelRequestMetadata, LanguageModelResponseMetadata, LanguageModelUsage, llamaindexAdapter as LlamaIndexAdapter, LogProbs, MessageConversionError, NoImageGeneratedError, NoObjectGeneratedError, NoOutputSpecifiedError, NoSuchProviderError, NoSuchToolError, ObjectStreamPart, output as Output, Provider, ProviderMetadata, RetryError, StepResult, StreamData, StreamObjectResult, StreamTextResult, StreamTextTransform, TelemetrySettings, TextPart, TextStreamPart, Tool, ToolCallPart, ToolCallRepairError, ToolCallRepairFunction, ToolCallUnion, ToolChoice, ToolContent, ToolExecutionError, ToolExecutionOptions, ToolResultPart, ToolResultUnion, ToolSet, UserContent, appendClientMessage, appendResponseMessages, convertToCoreMessages, coreAssistantMessageSchema, coreMessageSchema, coreSystemMessageSchema, coreToolMessageSchema, coreUserMessageSchema, cosineSimilarity, createDataStream, createDataStreamResponse, embed, embedMany, experimental_createProviderRegistry, experimental_customProvider, generateImage as experimental_generateImage, experimental_wrapLanguageModel, extractReasoningMiddleware, generateObject, generateText, pipeDataStreamToResponse, simulateReadableStream, smoothStream, streamObject, streamText, tool };