ai 5.0.36 → 5.0.37

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # ai
 
+## 5.0.37
+
+### Patch Changes
+
+- d6785d7: feat (ai): add tool and agent helpers
+
 ## 5.0.36
 
 ### Patch Changes

package/dist/index.d.mts

@@ -1491,40 +1491,48 @@ type DataUIPart<DATA_TYPES extends UIDataTypes> = ValueOf<{
         data: DATA_TYPES[NAME];
     };
 }>;
+type asUITool<TOOL extends UITool | Tool> = TOOL extends Tool ? InferUITool<TOOL> : TOOL;
+/**
+ * A UI tool invocation contains all the information needed to render a tool invocation in the UI.
+ * It can be derived from a tool without knowing the tool name, and can be used to define
+ * UI components for the tool.
+ */
+type UIToolInvocation<TOOL extends UITool | Tool> = {
+    toolCallId: string;
+} & ({
+    state: 'input-streaming';
+    input: DeepPartial<asUITool<TOOL>['input']> | undefined;
+    providerExecuted?: boolean;
+    output?: never;
+    errorText?: never;
+} | {
+    state: 'input-available';
+    input: asUITool<TOOL>['input'];
+    providerExecuted?: boolean;
+    output?: never;
+    errorText?: never;
+    callProviderMetadata?: ProviderMetadata;
+} | {
+    state: 'output-available';
+    input: asUITool<TOOL>['input'];
+    output: asUITool<TOOL>['output'];
+    errorText?: never;
+    providerExecuted?: boolean;
+    callProviderMetadata?: ProviderMetadata;
+    preliminary?: boolean;
+} | {
+    state: 'output-error';
+    input: asUITool<TOOL>['input'] | undefined;
+    rawInput?: unknown;
+    output?: never;
+    errorText: string;
+    providerExecuted?: boolean;
+    callProviderMetadata?: ProviderMetadata;
+});
 type ToolUIPart<TOOLS extends UITools = UITools> = ValueOf<{
     [NAME in keyof TOOLS & string]: {
         type: `tool-${NAME}`;
-        toolCallId: string;
-    } & ({
-        state: 'input-streaming';
-        input: DeepPartial<TOOLS[NAME]['input']> | undefined;
-        providerExecuted?: boolean;
-        output?: never;
-        errorText?: never;
-    } | {
-        state: 'input-available';
-        input: TOOLS[NAME]['input'];
-        providerExecuted?: boolean;
-        output?: never;
-        errorText?: never;
-        callProviderMetadata?: ProviderMetadata;
-    } | {
-        state: 'output-available';
-        input: TOOLS[NAME]['input'];
-        output: TOOLS[NAME]['output'];
-        errorText?: never;
-        providerExecuted?: boolean;
-        callProviderMetadata?: ProviderMetadata;
-        preliminary?: boolean;
-    } | {
-        state: 'output-error';
-        input: TOOLS[NAME]['input'] | undefined;
-        rawInput?: unknown;
-        output?: never;
-        errorText: string;
-        providerExecuted?: boolean;
-        callProviderMetadata?: ProviderMetadata;
-    });
+    } & UIToolInvocation<TOOLS[NAME]>;
 }>;
 type DynamicToolUIPart = {
     type: 'dynamic-tool';
@@ -2142,6 +2150,7 @@ type AgentSettings<TOOLS extends ToolSet, OUTPUT = never, OUTPUT_PARTIAL = never
 declare class Agent<TOOLS extends ToolSet, OUTPUT = never, OUTPUT_PARTIAL = never> {
     private readonly settings;
     constructor(settings: AgentSettings<TOOLS, OUTPUT, OUTPUT_PARTIAL>);
+    get tools(): TOOLS;
     generate(options: Prompt & {
         /**
   Additional provider-specific metadata. They are passed through
@@ -2170,7 +2179,18 @@ declare class Agent<TOOLS extends ToolSet, OUTPUT = never, OUTPUT_PARTIAL = neve
            */
         providerOptions?: ProviderOptions;
     }): StreamTextResult<TOOLS, OUTPUT_PARTIAL>;
+    /**
+     * Creates a response object that streams UI messages to the client.
+     */
+    respond(options: {
+        messages: UIMessage<never, never, InferUITools<TOOLS>>[];
+    }): Response;
 }
+type InferAgentTools<AGENT> = AGENT extends Agent<infer TOOLS, any, any> ? TOOLS : never;
+/**
+ * Infer the UI message type of an agent.
+ */
+type InferAgentUIMessage<AGENT> = UIMessage<never, never, InferUITools<InferAgentTools<AGENT>>>;
 
 /**
 The result of an `embed` call.
@@ -4455,4 +4475,4 @@ declare global {
     var AI_SDK_LOG_WARNINGS: LogWarningsFunction | undefined | false;
 }
 
-export { AbstractChat, AsyncIterableStream, CallSettings, CallWarning, ChatInit, ChatOnDataCallback, ChatOnErrorCallback, ChatOnFinishCallback, ChatOnToolCallCallback, ChatRequestOptions, ChatState, ChatStatus, ChatTransport, ChunkDetector, CompletionRequestOptions, CoreAssistantMessage, CoreMessage, CoreSystemMessage, CoreToolMessage, CoreUserMessage, CreateUIMessage, DataUIPart, DeepPartial, DefaultChatTransport, DownloadError, DynamicToolCall, DynamicToolError, DynamicToolResult, DynamicToolUIPart, EmbedManyResult, EmbedResult, Embedding, EmbeddingModel, EmbeddingModelUsage, ErrorHandler, Agent as Experimental_Agent, AgentSettings as Experimental_AgentSettings, DownloadFunction as Experimental_DownloadFunction, GenerateImageResult as Experimental_GenerateImageResult, GeneratedFile as Experimental_GeneratedImage, LogWarningsFunction as Experimental_LogWarningsFunction, SpeechResult as Experimental_SpeechResult, TranscriptionResult as Experimental_TranscriptionResult, Warning as Experimental_Warning, FileUIPart, FinishReason, GenerateObjectResult, GenerateTextOnStepFinishCallback, GenerateTextResult, GeneratedAudioFile, GeneratedFile, HttpChatTransport, HttpChatTransportInitOptions, ImageModel, ImageGenerationWarning as ImageModelCallWarning, ImageModelProviderMetadata, ImageModelResponseMetadata, InferUIDataParts, InferUIMessageChunk, InferUITool, InferUITools, InvalidArgumentError, InvalidDataContentError, InvalidMessageRoleError, InvalidStreamPartError, InvalidToolInputError, JSONRPCError, JSONRPCMessage, JSONRPCNotification, JSONRPCRequest, JSONRPCResponse, JSONValue, JsonToSseTransformStream, LanguageModel, LanguageModelMiddleware, LanguageModelRequestMetadata, LanguageModelResponseMetadata, LanguageModelUsage, MCPClientError, MCPTransport, MessageConversionError, NoImageGeneratedError, NoObjectGeneratedError, NoOutputGeneratedError, NoOutputSpecifiedError, NoSuchProviderError, NoSuchToolError, ObjectStreamPart, output as Output, PrepareReconnectToStreamRequest, PrepareSendMessagesRequest, PrepareStepFunction, PrepareStepResult, Prompt, Provider, ProviderMetadata, ProviderRegistryProvider, ReasoningUIPart, RepairTextFunction, RetryError, SerialJobExecutor, SourceDocumentUIPart, SourceUrlUIPart, SpeechModel, SpeechModelResponseMetadata, SpeechWarning, StaticToolCall, StaticToolError, StaticToolResult, StepResult, StepStartUIPart, StopCondition, StreamObjectOnFinishCallback, StreamObjectResult, StreamTextOnChunkCallback, StreamTextOnErrorCallback, StreamTextOnFinishCallback, StreamTextOnStepFinishCallback, StreamTextResult, StreamTextTransform, TelemetrySettings, TextStreamChatTransport, TextStreamPart, TextUIPart, ToolCallRepairError, ToolCallRepairFunction, ToolChoice, ToolSet, ToolUIPart, TranscriptionModel, TranscriptionModelResponseMetadata, TranscriptionWarning, TypedToolCall, TypedToolError, TypedToolResult, UIDataPartSchemas, UIDataTypes, UIMessage, UIMessageChunk, UIMessagePart, UIMessageStreamOnFinishCallback, UIMessageStreamOptions, UIMessageStreamWriter, UITool, UITools, UI_MESSAGE_STREAM_HEADERS, UnsupportedModelVersionError, UseCompletionOptions, assistantModelMessageSchema, callCompletionApi, consumeStream, convertFileListToFileUIParts, convertToCoreMessages, convertToModelMessages, coreAssistantMessageSchema, coreMessageSchema, coreSystemMessageSchema, coreToolMessageSchema, coreUserMessageSchema, cosineSimilarity, createProviderRegistry, createTextStreamResponse, createUIMessageStream, createUIMessageStreamResponse, customProvider, defaultSettingsMiddleware, embed, embedMany, MCPClient as experimental_MCPClient, MCPClientConfig as experimental_MCPClientConfig, createMCPClient as experimental_createMCPClient, experimental_createProviderRegistry, experimental_customProvider, generateImage as experimental_generateImage, generateSpeech as experimental_generateSpeech, transcribe as experimental_transcribe, extractReasoningMiddleware, generateObject, generateText, getTextFromDataUrl, getToolName, getToolOrDynamicToolName, hasToolCall, isDeepEqualData, isToolOrDynamicToolUIPart, isToolUIPart, lastAssistantMessageIsCompleteWithToolCalls, modelMessageSchema, parsePartialJson, pipeTextStreamToResponse, pipeUIMessageStreamToResponse, readUIMessageStream, simulateReadableStream, simulateStreamingMiddleware, smoothStream, stepCountIs, streamObject, streamText, systemModelMessageSchema, toolModelMessageSchema, userModelMessageSchema, validateUIMessages, wrapLanguageModel, wrapProvider };
+export { AbstractChat, AsyncIterableStream, CallSettings, CallWarning, ChatInit, ChatOnDataCallback, ChatOnErrorCallback, ChatOnFinishCallback, ChatOnToolCallCallback, ChatRequestOptions, ChatState, ChatStatus, ChatTransport, ChunkDetector, CompletionRequestOptions, CoreAssistantMessage, CoreMessage, CoreSystemMessage, CoreToolMessage, CoreUserMessage, CreateUIMessage, DataUIPart, DeepPartial, DefaultChatTransport, DownloadError, DynamicToolCall, DynamicToolError, DynamicToolResult, DynamicToolUIPart, EmbedManyResult, EmbedResult, Embedding, EmbeddingModel, EmbeddingModelUsage, ErrorHandler, Agent as Experimental_Agent, AgentSettings as Experimental_AgentSettings, DownloadFunction as Experimental_DownloadFunction, GenerateImageResult as Experimental_GenerateImageResult, GeneratedFile as Experimental_GeneratedImage, InferAgentUIMessage as Experimental_InferAgentUIMessage, LogWarningsFunction as Experimental_LogWarningsFunction, SpeechResult as Experimental_SpeechResult, TranscriptionResult as Experimental_TranscriptionResult, Warning as Experimental_Warning, FileUIPart, FinishReason, GenerateObjectResult, GenerateTextOnStepFinishCallback, GenerateTextResult, GeneratedAudioFile, GeneratedFile, HttpChatTransport, HttpChatTransportInitOptions, ImageModel, ImageGenerationWarning as ImageModelCallWarning, ImageModelProviderMetadata, ImageModelResponseMetadata, InferUIDataParts, InferUIMessageChunk, InferUITool, InferUITools, InvalidArgumentError, InvalidDataContentError, InvalidMessageRoleError, InvalidStreamPartError, InvalidToolInputError, JSONRPCError, JSONRPCMessage, JSONRPCNotification, JSONRPCRequest, JSONRPCResponse, JSONValue, JsonToSseTransformStream, LanguageModel, LanguageModelMiddleware, LanguageModelRequestMetadata, LanguageModelResponseMetadata, LanguageModelUsage, MCPClientError, MCPTransport, MessageConversionError, NoImageGeneratedError, NoObjectGeneratedError, NoOutputGeneratedError, NoOutputSpecifiedError, NoSuchProviderError, NoSuchToolError, ObjectStreamPart, output as Output, PrepareReconnectToStreamRequest, PrepareSendMessagesRequest, PrepareStepFunction, PrepareStepResult, Prompt, Provider, ProviderMetadata, ProviderRegistryProvider, ReasoningUIPart, RepairTextFunction, RetryError, SerialJobExecutor, SourceDocumentUIPart, SourceUrlUIPart, SpeechModel, SpeechModelResponseMetadata, SpeechWarning, StaticToolCall, StaticToolError, StaticToolResult, StepResult, StepStartUIPart, StopCondition, StreamObjectOnFinishCallback, StreamObjectResult, StreamTextOnChunkCallback, StreamTextOnErrorCallback, StreamTextOnFinishCallback, StreamTextOnStepFinishCallback, StreamTextResult, StreamTextTransform, TelemetrySettings, TextStreamChatTransport, TextStreamPart, TextUIPart, ToolCallRepairError, ToolCallRepairFunction, ToolChoice, ToolSet, ToolUIPart, TranscriptionModel, TranscriptionModelResponseMetadata, TranscriptionWarning, TypedToolCall, TypedToolError, TypedToolResult, UIDataPartSchemas, UIDataTypes, UIMessage, UIMessageChunk, UIMessagePart, UIMessageStreamOnFinishCallback, UIMessageStreamOptions, UIMessageStreamWriter, UITool, UIToolInvocation, UITools, UI_MESSAGE_STREAM_HEADERS, UnsupportedModelVersionError, UseCompletionOptions, assistantModelMessageSchema, callCompletionApi, consumeStream, convertFileListToFileUIParts, convertToCoreMessages, convertToModelMessages, coreAssistantMessageSchema, coreMessageSchema, coreSystemMessageSchema, coreToolMessageSchema, coreUserMessageSchema, cosineSimilarity, createProviderRegistry, createTextStreamResponse, createUIMessageStream, createUIMessageStreamResponse, customProvider, defaultSettingsMiddleware, embed, embedMany, MCPClient as experimental_MCPClient, MCPClientConfig as experimental_MCPClientConfig, createMCPClient as experimental_createMCPClient, experimental_createProviderRegistry, experimental_customProvider, generateImage as experimental_generateImage, generateSpeech as experimental_generateSpeech, transcribe as experimental_transcribe, extractReasoningMiddleware, generateObject, generateText, getTextFromDataUrl, getToolName, getToolOrDynamicToolName, hasToolCall, isDeepEqualData, isToolOrDynamicToolUIPart, isToolUIPart, lastAssistantMessageIsCompleteWithToolCalls, modelMessageSchema, parsePartialJson, pipeTextStreamToResponse, pipeUIMessageStreamToResponse, readUIMessageStream, simulateReadableStream, simulateStreamingMiddleware, smoothStream, stepCountIs, streamObject, streamText, systemModelMessageSchema, toolModelMessageSchema, userModelMessageSchema, validateUIMessages, wrapLanguageModel, wrapProvider };

package/dist/index.d.ts

@@ -1491,40 +1491,48 @@ type DataUIPart<DATA_TYPES extends UIDataTypes> = ValueOf<{
         data: DATA_TYPES[NAME];
     };
 }>;
+type asUITool<TOOL extends UITool | Tool> = TOOL extends Tool ? InferUITool<TOOL> : TOOL;
+/**
+ * A UI tool invocation contains all the information needed to render a tool invocation in the UI.
+ * It can be derived from a tool without knowing the tool name, and can be used to define
+ * UI components for the tool.
+ */
+type UIToolInvocation<TOOL extends UITool | Tool> = {
+    toolCallId: string;
+} & ({
+    state: 'input-streaming';
+    input: DeepPartial<asUITool<TOOL>['input']> | undefined;
+    providerExecuted?: boolean;
+    output?: never;
+    errorText?: never;
+} | {
+    state: 'input-available';
+    input: asUITool<TOOL>['input'];
+    providerExecuted?: boolean;
+    output?: never;
+    errorText?: never;
+    callProviderMetadata?: ProviderMetadata;
+} | {
+    state: 'output-available';
+    input: asUITool<TOOL>['input'];
+    output: asUITool<TOOL>['output'];
+    errorText?: never;
+    providerExecuted?: boolean;
+    callProviderMetadata?: ProviderMetadata;
+    preliminary?: boolean;
+} | {
+    state: 'output-error';
+    input: asUITool<TOOL>['input'] | undefined;
+    rawInput?: unknown;
+    output?: never;
+    errorText: string;
+    providerExecuted?: boolean;
+    callProviderMetadata?: ProviderMetadata;
+});
 type ToolUIPart<TOOLS extends UITools = UITools> = ValueOf<{
     [NAME in keyof TOOLS & string]: {
         type: `tool-${NAME}`;
-        toolCallId: string;
-    } & ({
-        state: 'input-streaming';
-        input: DeepPartial<TOOLS[NAME]['input']> | undefined;
-        providerExecuted?: boolean;
-        output?: never;
-        errorText?: never;
-    } | {
-        state: 'input-available';
-        input: TOOLS[NAME]['input'];
-        providerExecuted?: boolean;
-        output?: never;
-        errorText?: never;
-        callProviderMetadata?: ProviderMetadata;
-    } | {
-        state: 'output-available';
-        input: TOOLS[NAME]['input'];
-        output: TOOLS[NAME]['output'];
-        errorText?: never;
-        providerExecuted?: boolean;
-        callProviderMetadata?: ProviderMetadata;
-        preliminary?: boolean;
-    } | {
-        state: 'output-error';
-        input: TOOLS[NAME]['input'] | undefined;
-        rawInput?: unknown;
-        output?: never;
-        errorText: string;
-        providerExecuted?: boolean;
-        callProviderMetadata?: ProviderMetadata;
-    });
+    } & UIToolInvocation<TOOLS[NAME]>;
 }>;
 type DynamicToolUIPart = {
     type: 'dynamic-tool';
@@ -2142,6 +2150,7 @@ type AgentSettings<TOOLS extends ToolSet, OUTPUT = never, OUTPUT_PARTIAL = never
 declare class Agent<TOOLS extends ToolSet, OUTPUT = never, OUTPUT_PARTIAL = never> {
     private readonly settings;
     constructor(settings: AgentSettings<TOOLS, OUTPUT, OUTPUT_PARTIAL>);
+    get tools(): TOOLS;
     generate(options: Prompt & {
         /**
   Additional provider-specific metadata. They are passed through
@@ -2170,7 +2179,18 @@ declare class Agent<TOOLS extends ToolSet, OUTPUT = never, OUTPUT_PARTIAL = neve
            */
         providerOptions?: ProviderOptions;
     }): StreamTextResult<TOOLS, OUTPUT_PARTIAL>;
+    /**
+     * Creates a response object that streams UI messages to the client.
+     */
+    respond(options: {
+        messages: UIMessage<never, never, InferUITools<TOOLS>>[];
+    }): Response;
 }
+type InferAgentTools<AGENT> = AGENT extends Agent<infer TOOLS, any, any> ? TOOLS : never;
+/**
+ * Infer the UI message type of an agent.
+ */
+type InferAgentUIMessage<AGENT> = UIMessage<never, never, InferUITools<InferAgentTools<AGENT>>>;
 
 /**
 The result of an `embed` call.
@@ -4455,4 +4475,4 @@ declare global {
     var AI_SDK_LOG_WARNINGS: LogWarningsFunction | undefined | false;
 }
 
-export { AbstractChat, AsyncIterableStream, CallSettings, CallWarning, ChatInit, ChatOnDataCallback, ChatOnErrorCallback, ChatOnFinishCallback, ChatOnToolCallCallback, ChatRequestOptions, ChatState, ChatStatus, ChatTransport, ChunkDetector, CompletionRequestOptions, CoreAssistantMessage, CoreMessage, CoreSystemMessage, CoreToolMessage, CoreUserMessage, CreateUIMessage, DataUIPart, DeepPartial, DefaultChatTransport, DownloadError, DynamicToolCall, DynamicToolError, DynamicToolResult, DynamicToolUIPart, EmbedManyResult, EmbedResult, Embedding, EmbeddingModel, EmbeddingModelUsage, ErrorHandler, Agent as Experimental_Agent, AgentSettings as Experimental_AgentSettings, DownloadFunction as Experimental_DownloadFunction, GenerateImageResult as Experimental_GenerateImageResult, GeneratedFile as Experimental_GeneratedImage, LogWarningsFunction as Experimental_LogWarningsFunction, SpeechResult as Experimental_SpeechResult, TranscriptionResult as Experimental_TranscriptionResult, Warning as Experimental_Warning, FileUIPart, FinishReason, GenerateObjectResult, GenerateTextOnStepFinishCallback, GenerateTextResult, GeneratedAudioFile, GeneratedFile, HttpChatTransport, HttpChatTransportInitOptions, ImageModel, ImageGenerationWarning as ImageModelCallWarning, ImageModelProviderMetadata, ImageModelResponseMetadata, InferUIDataParts, InferUIMessageChunk, InferUITool, InferUITools, InvalidArgumentError, InvalidDataContentError, InvalidMessageRoleError, InvalidStreamPartError, InvalidToolInputError, JSONRPCError, JSONRPCMessage, JSONRPCNotification, JSONRPCRequest, JSONRPCResponse, JSONValue, JsonToSseTransformStream, LanguageModel, LanguageModelMiddleware, LanguageModelRequestMetadata, LanguageModelResponseMetadata, LanguageModelUsage, MCPClientError, MCPTransport, MessageConversionError, NoImageGeneratedError, NoObjectGeneratedError, NoOutputGeneratedError, NoOutputSpecifiedError, NoSuchProviderError, NoSuchToolError, ObjectStreamPart, output as Output, PrepareReconnectToStreamRequest, PrepareSendMessagesRequest, PrepareStepFunction, PrepareStepResult, Prompt, Provider, ProviderMetadata, ProviderRegistryProvider, ReasoningUIPart, RepairTextFunction, RetryError, SerialJobExecutor, SourceDocumentUIPart, SourceUrlUIPart, SpeechModel, SpeechModelResponseMetadata, SpeechWarning, StaticToolCall, StaticToolError, StaticToolResult, StepResult, StepStartUIPart, StopCondition, StreamObjectOnFinishCallback, StreamObjectResult, StreamTextOnChunkCallback, StreamTextOnErrorCallback, StreamTextOnFinishCallback, StreamTextOnStepFinishCallback, StreamTextResult, StreamTextTransform, TelemetrySettings, TextStreamChatTransport, TextStreamPart, TextUIPart, ToolCallRepairError, ToolCallRepairFunction, ToolChoice, ToolSet, ToolUIPart, TranscriptionModel, TranscriptionModelResponseMetadata, TranscriptionWarning, TypedToolCall, TypedToolError, TypedToolResult, UIDataPartSchemas, UIDataTypes, UIMessage, UIMessageChunk, UIMessagePart, UIMessageStreamOnFinishCallback, UIMessageStreamOptions, UIMessageStreamWriter, UITool, UITools, UI_MESSAGE_STREAM_HEADERS, UnsupportedModelVersionError, UseCompletionOptions, assistantModelMessageSchema, callCompletionApi, consumeStream, convertFileListToFileUIParts, convertToCoreMessages, convertToModelMessages, coreAssistantMessageSchema, coreMessageSchema, coreSystemMessageSchema, coreToolMessageSchema, coreUserMessageSchema, cosineSimilarity, createProviderRegistry, createTextStreamResponse, createUIMessageStream, createUIMessageStreamResponse, customProvider, defaultSettingsMiddleware, embed, embedMany, MCPClient as experimental_MCPClient, MCPClientConfig as experimental_MCPClientConfig, createMCPClient as experimental_createMCPClient, experimental_createProviderRegistry, experimental_customProvider, generateImage as experimental_generateImage, generateSpeech as experimental_generateSpeech, transcribe as experimental_transcribe, extractReasoningMiddleware, generateObject, generateText, getTextFromDataUrl, getToolName, getToolOrDynamicToolName, hasToolCall, isDeepEqualData, isToolOrDynamicToolUIPart, isToolUIPart, lastAssistantMessageIsCompleteWithToolCalls, modelMessageSchema, parsePartialJson, pipeTextStreamToResponse, pipeUIMessageStreamToResponse, readUIMessageStream, simulateReadableStream, simulateStreamingMiddleware, smoothStream, stepCountIs, streamObject, streamText, systemModelMessageSchema, toolModelMessageSchema, userModelMessageSchema, validateUIMessages, wrapLanguageModel, wrapProvider };
+export { AbstractChat, AsyncIterableStream, CallSettings, CallWarning, ChatInit, ChatOnDataCallback, ChatOnErrorCallback, ChatOnFinishCallback, ChatOnToolCallCallback, ChatRequestOptions, ChatState, ChatStatus, ChatTransport, ChunkDetector, CompletionRequestOptions, CoreAssistantMessage, CoreMessage, CoreSystemMessage, CoreToolMessage, CoreUserMessage, CreateUIMessage, DataUIPart, DeepPartial, DefaultChatTransport, DownloadError, DynamicToolCall, DynamicToolError, DynamicToolResult, DynamicToolUIPart, EmbedManyResult, EmbedResult, Embedding, EmbeddingModel, EmbeddingModelUsage, ErrorHandler, Agent as Experimental_Agent, AgentSettings as Experimental_AgentSettings, DownloadFunction as Experimental_DownloadFunction, GenerateImageResult as Experimental_GenerateImageResult, GeneratedFile as Experimental_GeneratedImage, InferAgentUIMessage as Experimental_InferAgentUIMessage, LogWarningsFunction as Experimental_LogWarningsFunction, SpeechResult as Experimental_SpeechResult, TranscriptionResult as Experimental_TranscriptionResult, Warning as Experimental_Warning, FileUIPart, FinishReason, GenerateObjectResult, GenerateTextOnStepFinishCallback, GenerateTextResult, GeneratedAudioFile, GeneratedFile, HttpChatTransport, HttpChatTransportInitOptions, ImageModel, ImageGenerationWarning as ImageModelCallWarning, ImageModelProviderMetadata, ImageModelResponseMetadata, InferUIDataParts, InferUIMessageChunk, InferUITool, InferUITools, InvalidArgumentError, InvalidDataContentError, InvalidMessageRoleError, InvalidStreamPartError, InvalidToolInputError, JSONRPCError, JSONRPCMessage, JSONRPCNotification, JSONRPCRequest, JSONRPCResponse, JSONValue, JsonToSseTransformStream, LanguageModel, LanguageModelMiddleware, LanguageModelRequestMetadata, LanguageModelResponseMetadata, LanguageModelUsage, MCPClientError, MCPTransport, MessageConversionError, NoImageGeneratedError, NoObjectGeneratedError, NoOutputGeneratedError, NoOutputSpecifiedError, NoSuchProviderError, NoSuchToolError, ObjectStreamPart, output as Output, PrepareReconnectToStreamRequest, PrepareSendMessagesRequest, PrepareStepFunction, PrepareStepResult, Prompt, Provider, ProviderMetadata, ProviderRegistryProvider, ReasoningUIPart, RepairTextFunction, RetryError, SerialJobExecutor, SourceDocumentUIPart, SourceUrlUIPart, SpeechModel, SpeechModelResponseMetadata, SpeechWarning, StaticToolCall, StaticToolError, StaticToolResult, StepResult, StepStartUIPart, StopCondition, StreamObjectOnFinishCallback, StreamObjectResult, StreamTextOnChunkCallback, StreamTextOnErrorCallback, StreamTextOnFinishCallback, StreamTextOnStepFinishCallback, StreamTextResult, StreamTextTransform, TelemetrySettings, TextStreamChatTransport, TextStreamPart, TextUIPart, ToolCallRepairError, ToolCallRepairFunction, ToolChoice, ToolSet, ToolUIPart, TranscriptionModel, TranscriptionModelResponseMetadata, TranscriptionWarning, TypedToolCall, TypedToolError, TypedToolResult, UIDataPartSchemas, UIDataTypes, UIMessage, UIMessageChunk, UIMessagePart, UIMessageStreamOnFinishCallback, UIMessageStreamOptions, UIMessageStreamWriter, UITool, UIToolInvocation, UITools, UI_MESSAGE_STREAM_HEADERS, UnsupportedModelVersionError, UseCompletionOptions, assistantModelMessageSchema, callCompletionApi, consumeStream, convertFileListToFileUIParts, convertToCoreMessages, convertToModelMessages, coreAssistantMessageSchema, coreMessageSchema, coreSystemMessageSchema, coreToolMessageSchema, coreUserMessageSchema, cosineSimilarity, createProviderRegistry, createTextStreamResponse, createUIMessageStream, createUIMessageStreamResponse, customProvider, defaultSettingsMiddleware, embed, embedMany, MCPClient as experimental_MCPClient, MCPClientConfig as experimental_MCPClientConfig, createMCPClient as experimental_createMCPClient, experimental_createProviderRegistry, experimental_customProvider, generateImage as experimental_generateImage, generateSpeech as experimental_generateSpeech, transcribe as experimental_transcribe, extractReasoningMiddleware, generateObject, generateText, getTextFromDataUrl, getToolName, getToolOrDynamicToolName, hasToolCall, isDeepEqualData, isToolOrDynamicToolUIPart, isToolUIPart, lastAssistantMessageIsCompleteWithToolCalls, modelMessageSchema, parsePartialJson, pipeTextStreamToResponse, pipeUIMessageStreamToResponse, readUIMessageStream, simulateReadableStream, simulateStreamingMiddleware, smoothStream, stepCountIs, streamObject, streamText, systemModelMessageSchema, toolModelMessageSchema, userModelMessageSchema, validateUIMessages, wrapLanguageModel, wrapProvider };

package/dist/index.js

@@ -5747,17 +5747,217 @@ var DefaultStreamTextResult = class {
   }
 };
 
+// src/ui/convert-to-model-messages.ts
+function convertToModelMessages(messages, options) {
+  const modelMessages = [];
+  if (options == null ? void 0 : options.ignoreIncompleteToolCalls) {
+    messages = messages.map((message) => ({
+      ...message,
+      parts: message.parts.filter(
+        (part) => !isToolOrDynamicToolUIPart(part) || part.state !== "input-streaming" && part.state !== "input-available"
+      )
+    }));
+  }
+  for (const message of messages) {
+    switch (message.role) {
+      case "system": {
+        const textParts = message.parts.filter((part) => part.type === "text");
+        const providerMetadata = textParts.reduce((acc, part) => {
+          if (part.providerMetadata != null) {
+            return { ...acc, ...part.providerMetadata };
+          }
+          return acc;
+        }, {});
+        modelMessages.push({
+          role: "system",
+          content: textParts.map((part) => part.text).join(""),
+          ...Object.keys(providerMetadata).length > 0 ? { providerOptions: providerMetadata } : {}
+        });
+        break;
+      }
+      case "user": {
+        modelMessages.push({
+          role: "user",
+          content: message.parts.filter(
+            (part) => part.type === "text" || part.type === "file"
+          ).map((part) => {
+            switch (part.type) {
+              case "text":
+                return {
+                  type: "text",
+                  text: part.text,
+                  ...part.providerMetadata != null ? { providerOptions: part.providerMetadata } : {}
+                };
+              case "file":
+                return {
+                  type: "file",
+                  mediaType: part.mediaType,
+                  filename: part.filename,
+                  data: part.url,
+                  ...part.providerMetadata != null ? { providerOptions: part.providerMetadata } : {}
+                };
+              default:
+                return part;
+            }
+          })
+        });
+        break;
+      }
+      case "assistant": {
+        if (message.parts != null) {
+          let processBlock2 = function() {
+            var _a17, _b;
+            if (block.length === 0) {
+              return;
+            }
+            const content = [];
+            for (const part of block) {
+              if (part.type === "text") {
+                content.push({
+                  type: "text",
+                  text: part.text,
+                  ...part.providerMetadata != null ? { providerOptions: part.providerMetadata } : {}
+                });
+              } else if (part.type === "file") {
+                content.push({
+                  type: "file",
+                  mediaType: part.mediaType,
+                  filename: part.filename,
+                  data: part.url
+                });
+              } else if (part.type === "reasoning") {
+                content.push({
+                  type: "reasoning",
+                  text: part.text,
+                  providerOptions: part.providerMetadata
+                });
+              } else if (part.type === "dynamic-tool") {
+                const toolName = part.toolName;
+                if (part.state !== "input-streaming") {
+                  content.push({
+                    type: "tool-call",
+                    toolCallId: part.toolCallId,
+                    toolName,
+                    input: part.input,
+                    ...part.callProviderMetadata != null ? { providerOptions: part.callProviderMetadata } : {}
+                  });
+                }
+              } else if (isToolUIPart(part)) {
+                const toolName = getToolName(part);
+                if (part.state !== "input-streaming") {
+                  content.push({
+                    type: "tool-call",
+                    toolCallId: part.toolCallId,
+                    toolName,
+                    input: part.state === "output-error" ? (_a17 = part.input) != null ? _a17 : part.rawInput : part.input,
+                    providerExecuted: part.providerExecuted,
+                    ...part.callProviderMetadata != null ? { providerOptions: part.callProviderMetadata } : {}
+                  });
+                  if (part.providerExecuted === true && (part.state === "output-available" || part.state === "output-error")) {
+                    content.push({
+                      type: "tool-result",
+                      toolCallId: part.toolCallId,
+                      toolName,
+                      output: createToolModelOutput({
+                        output: part.state === "output-error" ? part.errorText : part.output,
+                        tool: (_b = options == null ? void 0 : options.tools) == null ? void 0 : _b[toolName],
+                        errorMode: part.state === "output-error" ? "json" : "none"
+                      })
+                    });
+                  }
+                }
+              } else {
+                const _exhaustiveCheck = part;
+                throw new Error(`Unsupported part: ${_exhaustiveCheck}`);
+              }
+            }
+            modelMessages.push({
+              role: "assistant",
+              content
+            });
+            const toolParts = block.filter(
+              (part) => isToolUIPart(part) && part.providerExecuted !== true || part.type === "dynamic-tool"
+            );
+            if (toolParts.length > 0) {
+              modelMessages.push({
+                role: "tool",
+                content: toolParts.map((toolPart) => {
+                  var _a18;
+                  switch (toolPart.state) {
+                    case "output-error":
+                    case "output-available": {
+                      const toolName = toolPart.type === "dynamic-tool" ? toolPart.toolName : getToolName(toolPart);
+                      return {
+                        type: "tool-result",
+                        toolCallId: toolPart.toolCallId,
+                        toolName,
+                        output: createToolModelOutput({
+                          output: toolPart.state === "output-error" ? toolPart.errorText : toolPart.output,
+                          tool: (_a18 = options == null ? void 0 : options.tools) == null ? void 0 : _a18[toolName],
+                          errorMode: toolPart.state === "output-error" ? "text" : "none"
+                        })
+                      };
+                    }
+                    default: {
+                      return null;
+                    }
+                  }
+                }).filter(
+                  (output) => output != null
+                )
+              });
+            }
+            block = [];
+          };
+          var processBlock = processBlock2;
+          let block = [];
+          for (const part of message.parts) {
+            if (part.type === "text" || part.type === "reasoning" || part.type === "file" || part.type === "dynamic-tool" || isToolUIPart(part)) {
+              block.push(part);
+            } else if (part.type === "step-start") {
+              processBlock2();
+            }
+          }
+          processBlock2();
+          break;
+        }
+        break;
+      }
+      default: {
+        const _exhaustiveCheck = message.role;
+        throw new MessageConversionError({
+          originalMessage: message,
+          message: `Unsupported role: ${_exhaustiveCheck}`
+        });
+      }
+    }
+  }
+  return modelMessages;
+}
+var convertToCoreMessages = convertToModelMessages;
+
 // src/agent/agent.ts
 var Agent = class {
   constructor(settings) {
     this.settings = settings;
   }
+  get tools() {
+    return this.settings.tools;
+  }
   async generate(options) {
     return generateText({ ...this.settings, ...options });
   }
   stream(options) {
     return streamText({ ...this.settings, ...options });
   }
+  /**
+   * Creates a response object that streams UI messages to the client.
+   */
+  respond(options) {
+    return this.stream({
+      prompt: convertToModelMessages(options.messages)
+    }).toUIMessageStreamResponse();
+  }
 };
 
 // src/embed/embed.ts
@@ -9638,195 +9838,6 @@ var AbstractChat = class {
   }
 };
 
-// src/ui/convert-to-model-messages.ts
-function convertToModelMessages(messages, options) {
-  const modelMessages = [];
-  if (options == null ? void 0 : options.ignoreIncompleteToolCalls) {
-    messages = messages.map((message) => ({
-      ...message,
-      parts: message.parts.filter(
-        (part) => !isToolOrDynamicToolUIPart(part) || part.state !== "input-streaming" && part.state !== "input-available"
-      )
-    }));
-  }
-  for (const message of messages) {
-    switch (message.role) {
-      case "system": {
-        const textParts = message.parts.filter((part) => part.type === "text");
-        const providerMetadata = textParts.reduce((acc, part) => {
-          if (part.providerMetadata != null) {
-            return { ...acc, ...part.providerMetadata };
-          }
-          return acc;
-        }, {});
-        modelMessages.push({
-          role: "system",
-          content: textParts.map((part) => part.text).join(""),
-          ...Object.keys(providerMetadata).length > 0 ? { providerOptions: providerMetadata } : {}
-        });
-        break;
-      }
-      case "user": {
-        modelMessages.push({
-          role: "user",
-          content: message.parts.filter(
-            (part) => part.type === "text" || part.type === "file"
-          ).map((part) => {
-            switch (part.type) {
-              case "text":
-                return {
-                  type: "text",
-                  text: part.text,
-                  ...part.providerMetadata != null ? { providerOptions: part.providerMetadata } : {}
-                };
-              case "file":
-                return {
-                  type: "file",
-                  mediaType: part.mediaType,
-                  filename: part.filename,
-                  data: part.url,
-                  ...part.providerMetadata != null ? { providerOptions: part.providerMetadata } : {}
-                };
-              default:
-                return part;
-            }
-          })
-        });
-        break;
-      }
-      case "assistant": {
-        if (message.parts != null) {
-          let processBlock2 = function() {
-            var _a17, _b;
-            if (block.length === 0) {
-              return;
-            }
-            const content = [];
-            for (const part of block) {
-              if (part.type === "text") {
-                content.push({
-                  type: "text",
-                  text: part.text,
-                  ...part.providerMetadata != null ? { providerOptions: part.providerMetadata } : {}
-                });
-              } else if (part.type === "file") {
-                content.push({
-                  type: "file",
-                  mediaType: part.mediaType,
-                  filename: part.filename,
-                  data: part.url
-                });
-              } else if (part.type === "reasoning") {
-                content.push({
-                  type: "reasoning",
-                  text: part.text,
-                  providerOptions: part.providerMetadata
-                });
-              } else if (part.type === "dynamic-tool") {
-                const toolName = part.toolName;
-                if (part.state !== "input-streaming") {
-                  content.push({
-                    type: "tool-call",
-                    toolCallId: part.toolCallId,
-                    toolName,
-                    input: part.input,
-                    ...part.callProviderMetadata != null ? { providerOptions: part.callProviderMetadata } : {}
-                  });
-                }
-              } else if (isToolUIPart(part)) {
-                const toolName = getToolName(part);
-                if (part.state !== "input-streaming") {
-                  content.push({
-                    type: "tool-call",
-                    toolCallId: part.toolCallId,
-                    toolName,
-                    input: part.state === "output-error" ? (_a17 = part.input) != null ? _a17 : part.rawInput : part.input,
-                    providerExecuted: part.providerExecuted,
-                    ...part.callProviderMetadata != null ? { providerOptions: part.callProviderMetadata } : {}
-                  });
-                  if (part.providerExecuted === true && (part.state === "output-available" || part.state === "output-error")) {
-                    content.push({
-                      type: "tool-result",
-                      toolCallId: part.toolCallId,
-                      toolName,
-                      output: createToolModelOutput({
-                        output: part.state === "output-error" ? part.errorText : part.output,
-                        tool: (_b = options == null ? void 0 : options.tools) == null ? void 0 : _b[toolName],
-                        errorMode: part.state === "output-error" ? "json" : "none"
-                      })
-                    });
-                  }
-                }
-              } else {
-                const _exhaustiveCheck = part;
-                throw new Error(`Unsupported part: ${_exhaustiveCheck}`);
-              }
-            }
-            modelMessages.push({
-              role: "assistant",
-              content
-            });
-            const toolParts = block.filter(
-              (part) => isToolUIPart(part) && part.providerExecuted !== true || part.type === "dynamic-tool"
-            );
-            if (toolParts.length > 0) {
-              modelMessages.push({
-                role: "tool",
-                content: toolParts.map((toolPart) => {
-                  var _a18;
-                  switch (toolPart.state) {
-                    case "output-error":
-                    case "output-available": {
-                      const toolName = toolPart.type === "dynamic-tool" ? toolPart.toolName : getToolName(toolPart);
-                      return {
-                        type: "tool-result",
-                        toolCallId: toolPart.toolCallId,
-                        toolName,
-                        output: createToolModelOutput({
-                          output: toolPart.state === "output-error" ? toolPart.errorText : toolPart.output,
-                          tool: (_a18 = options == null ? void 0 : options.tools) == null ? void 0 : _a18[toolName],
-                          errorMode: toolPart.state === "output-error" ? "text" : "none"
-                        })
-                      };
-                    }
-                    default: {
-                      return null;
-                    }
-                  }
-                }).filter(
-                  (output) => output != null
-                )
-              });
-            }
-            block = [];
-          };
-          var processBlock = processBlock2;
-          let block = [];
-          for (const part of message.parts) {
-            if (part.type === "text" || part.type === "reasoning" || part.type === "file" || part.type === "dynamic-tool" || isToolUIPart(part)) {
-              block.push(part);
-            } else if (part.type === "step-start") {
-              processBlock2();
-            }
-          }
-          processBlock2();
-          break;
-        }
-        break;
-      }
-      default: {
-        const _exhaustiveCheck = message.role;
-        throw new MessageConversionError({
-          originalMessage: message,
-          message: `Unsupported role: ${_exhaustiveCheck}`
-        });
-      }
-    }
-  }
-  return modelMessages;
-}
-var convertToCoreMessages = convertToModelMessages;
-
 // src/ui/last-assistant-message-is-complete-with-tool-calls.ts
 function lastAssistantMessageIsCompleteWithToolCalls({
   messages