@convex-dev/agent 0.3.2 → 0.6.0-alpha.0

package/dist/client/index.d.ts

@@ -8,7 +8,7 @@ import { type VectorDimension } from "../component/vector/tables.js";
 import { type Message, type MessageDoc, type MessageStatus, type MessageWithMetadata, type ProviderMetadata, type StreamArgs, type ThreadDoc } from "../validators.js";
 import { type SaveMessageArgs, type SaveMessagesArgs } from "./messages.js";
 import { type StreamingOptions } from "./streaming.js";
-import type { ActionCtx, AgentComponent, Config, ContextOptions, GenerateObjectArgs, GenerationOutputMetadata, MaybeCustomCtx, ObjectMode, Options, RawRequestResponseHandler, MutationCtx, StorageOptions, StreamingTextArgs, StreamObjectArgs, SyncStreamsReturnValue, TextArgs, Thread, UsageHandler, QueryCtx, AgentPrompt } from "./types.js";
+import type { ActionCtx, AgentComponent, Config, ContextOptions, GenerateObjectArgs, GenerationOutputMetadata, MaybeCustomCtx, ObjectMode, Options, RawRequestResponseHandler, MutationCtx, StorageOptions, StreamingTextArgs, StreamObjectArgs, SyncStreamsReturnValue, TextArgs, Thread, UsageHandler, QueryCtx, AgentPrompt, Output } from "./types.js";
 export { stepCountIs } from "ai";
 export { docsToModelMessages, toModelMessage, toModelMessage as deserializeMessage, guessMimeType, serializeDataOrUrl, serializeMessage, toUIFilePart, } from "../mapping.js";
 export { extractText, isTool, sorted } from "../shared.js";
@@ -111,6 +111,11 @@ CustomCtx extends object = object, AgentTools extends ToolSet = any> {
          */
         stopWhen?: StopCondition<NoInfer<AgentTools>> | Array<StopCondition<NoInfer<AgentTools>>>;
     });
+    /**
+     * Get the embedding model, prioritizing embeddingModel over textEmbeddingModel.
+     * @private
+     */
+    private getEmbeddingModel;
     /**
      * Start a new thread with the agent. This will have a fresh history, though if
      * you pass in a userId you can have it search across other threads for relevant
@@ -248,7 +253,7 @@ CustomCtx extends object = object, AgentTools extends ToolSet = any> {
      * @param options Extra controls for the {@link ContextOptions} and {@link StorageOptions}.
      * @returns The result of the generateText function.
      */
-    generateText<TOOLS extends ToolSet | undefined = undefined, OUTPUT = never, OUTPUT_PARTIAL = never>(ctx: ActionCtx & CustomCtx, threadOpts: {
+    generateText<TOOLS extends ToolSet | undefined = undefined, OUTPUT extends Output<any, any, any> = never>(ctx: ActionCtx & CustomCtx, threadOpts: {
         userId?: string | null;
         threadId?: string;
     }, 
@@ -256,7 +261,7 @@ CustomCtx extends object = object, AgentTools extends ToolSet = any> {
      * The arguments to the generateText function, similar to the ai sdk's
      * {@link generateText} function, along with Agent prompt options.
      */
-    generateTextArgs: AgentPrompt & TextArgs<AgentTools, TOOLS, OUTPUT, OUTPUT_PARTIAL>, options?: Options): Promise<GenerateTextResult<TOOLS extends undefined ? AgentTools : TOOLS, OUTPUT> & GenerationOutputMetadata>;
+    generateTextArgs: AgentPrompt & TextArgs<AgentTools, TOOLS, OUTPUT>, options?: Options): Promise<GenerateTextResult<TOOLS extends undefined ? AgentTools : TOOLS, OUTPUT> & GenerationOutputMetadata>;
     /**
      * This behaves like {@link streamText} from the "ai" package except that
      * it add context based on the userId and threadId and saves the input and
@@ -264,7 +269,7 @@ CustomCtx extends object = object, AgentTools extends ToolSet = any> {
      * Use {@link continueThread} to get a version of this function already scoped
      * to a thread (and optionally userId).
      */
-    streamText<TOOLS extends ToolSet | undefined = undefined, OUTPUT = never, PARTIAL_OUTPUT = never>(ctx: ActionCtx & CustomCtx, threadOpts: {
+    streamText<TOOLS extends ToolSet | undefined = undefined, OUTPUT extends Output<any, any, any> = never>(ctx: ActionCtx & CustomCtx, threadOpts: {
         userId?: string | null;
         threadId?: string;
     }, 
@@ -272,7 +277,7 @@ CustomCtx extends object = object, AgentTools extends ToolSet = any> {
      * The arguments to the streamText function, similar to the ai sdk's
      * {@link streamText} function, along with Agent prompt options.
      */
-    streamTextArgs: AgentPrompt & StreamingTextArgs<AgentTools, TOOLS, OUTPUT, PARTIAL_OUTPUT>, 
+    streamTextArgs: AgentPrompt & StreamingTextArgs<AgentTools, TOOLS, OUTPUT>, 
     /**
      * The {@link ContextOptions} and {@link StorageOptions}
      * options to use for fetching contextual messages and saving input/output messages.
@@ -289,7 +294,7 @@ CustomCtx extends object = object, AgentTools extends ToolSet = any> {
          * iterating over the text, streaming it over HTTP, etc.
          */
         saveStreamDeltas?: boolean | StreamingOptions;
-    }): Promise<StreamTextResult<TOOLS extends undefined ? AgentTools : TOOLS, PARTIAL_OUTPUT> & GenerationOutputMetadata>;
+    }): Promise<StreamTextResult<TOOLS extends undefined ? AgentTools : TOOLS, OUTPUT> & GenerationOutputMetadata>;
     /**
      * This behaves like {@link generateObject} from the "ai" package except that
      * it add context based on the userId and threadId and saves the input and
@@ -369,15 +374,17 @@ CustomCtx extends object = object, AgentTools extends ToolSet = any> {
                     text: string;
                 } | {
                     providerOptions?: Record<string, Record<string, any>> | undefined;
+                    mediaType?: string | undefined;
                     mimeType?: string | undefined;
                     type: "image";
                     image: string | ArrayBuffer;
                 } | {
                     providerOptions?: Record<string, Record<string, any>> | undefined;
                     providerMetadata?: Record<string, Record<string, any>> | undefined;
+                    mediaType?: string | undefined;
+                    mimeType?: string | undefined;
                     filename?: string | undefined;
                     type: "file";
-                    mimeType: string;
                     data: string | ArrayBuffer;
                 })[];
             } | {
@@ -391,9 +398,10 @@ CustomCtx extends object = object, AgentTools extends ToolSet = any> {
                 } | {
                     providerOptions?: Record<string, Record<string, any>> | undefined;
                     providerMetadata?: Record<string, Record<string, any>> | undefined;
+                    mediaType?: string | undefined;
+                    mimeType?: string | undefined;
                     filename?: string | undefined;
                     type: "file";
-                    mimeType: string;
                     data: string | ArrayBuffer;
                 } | {
                     providerOptions?: Record<string, Record<string, any>> | undefined;
@@ -409,6 +417,16 @@ CustomCtx extends object = object, AgentTools extends ToolSet = any> {
                 } | {
                     providerOptions?: Record<string, Record<string, any>> | undefined;
                     providerMetadata?: Record<string, Record<string, any>> | undefined;
+                    args?: any;
+                    providerExecuted?: boolean | undefined;
+                    type: "tool-call";
+                    toolCallId: string;
+                    toolName: string;
+                    input: any;
+                } | {
+                    providerOptions?: Record<string, Record<string, any>> | undefined;
+                    providerMetadata?: Record<string, Record<string, any>> | undefined;
+                    input?: any;
                     providerExecuted?: boolean | undefined;
                     type: "tool-call";
                     toolCallId: string;
@@ -420,26 +438,65 @@ CustomCtx extends object = object, AgentTools extends ToolSet = any> {
                     args?: any;
                     providerExecuted?: boolean | undefined;
                     output?: {
+                        providerOptions?: Record<string, Record<string, any>> | undefined;
                         type: "text";
                         value: string;
                     } | {
+                        providerOptions?: Record<string, Record<string, any>> | undefined;
                         type: "json";
                         value: any;
                     } | {
+                        providerOptions?: Record<string, Record<string, any>> | undefined;
                         type: "error-text";
                         value: string;
                     } | {
+                        providerOptions?: Record<string, Record<string, any>> | undefined;
                         type: "error-json";
                         value: any;
+                    } | {
+                        providerOptions?: Record<string, Record<string, any>> | undefined;
+                        reason?: string | undefined;
+                        type: "execution-denied";
                     } | {
                         type: "content";
                         value: ({
+                            providerOptions?: Record<string, Record<string, any>> | undefined;
                             type: "text";
                             text: string;
                         } | {
                             type: "media";
+                            mediaType: string;
                             data: string;
+                        } | {
+                            providerOptions?: Record<string, Record<string, any>> | undefined;
+                            filename?: string | undefined;
+                            type: "file-data";
                             mediaType: string;
+                            data: string;
+                        } | {
+                            providerOptions?: Record<string, Record<string, any>> | undefined;
+                            type: "file-url";
+                            url: string;
+                        } | {
+                            providerOptions?: Record<string, Record<string, any>> | undefined;
+                            type: "file-id";
+                            fileId: string | Record<string, string>;
+                        } | {
+                            providerOptions?: Record<string, Record<string, any>> | undefined;
+                            type: "image-data";
+                            mediaType: string;
+                            data: string;
+                        } | {
+                            providerOptions?: Record<string, Record<string, any>> | undefined;
+                            type: "image-url";
+                            url: string;
+                        } | {
+                            providerOptions?: Record<string, Record<string, any>> | undefined;
+                            type: "image-file-id";
+                            fileId: string | Record<string, string>;
+                        } | {
+                            providerOptions?: Record<string, Record<string, any>> | undefined;
+                            type: "custom";
                         })[];
                     } | undefined;
                     result?: any;
@@ -461,8 +518,8 @@ CustomCtx extends object = object, AgentTools extends ToolSet = any> {
                     providerMetadata?: Record<string, Record<string, any>> | undefined;
                     id: string;
                     type: "source";
-                    sourceType: "url";
                     url: string;
+                    sourceType: "url";
                 } | {
                     providerOptions?: Record<string, Record<string, any>> | undefined;
                     providerMetadata?: Record<string, Record<string, any>> | undefined;
@@ -472,36 +529,81 @@ CustomCtx extends object = object, AgentTools extends ToolSet = any> {
                     type: "source";
                     mediaType: string;
                     sourceType: "document";
+                } | {
+                    providerOptions?: Record<string, Record<string, any>> | undefined;
+                    providerMetadata?: Record<string, Record<string, any>> | undefined;
+                    type: "tool-approval-request";
+                    toolCallId: string;
+                    approvalId: string;
                 })[];
             } | {
                 providerOptions?: Record<string, Record<string, any>> | undefined;
                 role: "tool";
-                content: {
+                content: ({
                     providerOptions?: Record<string, Record<string, any>> | undefined;
                     providerMetadata?: Record<string, Record<string, any>> | undefined;
                     args?: any;
                     providerExecuted?: boolean | undefined;
                     output?: {
+                        providerOptions?: Record<string, Record<string, any>> | undefined;
                         type: "text";
                         value: string;
                     } | {
+                        providerOptions?: Record<string, Record<string, any>> | undefined;
                         type: "json";
                         value: any;
                     } | {
+                        providerOptions?: Record<string, Record<string, any>> | undefined;
                         type: "error-text";
                         value: string;
                     } | {
+                        providerOptions?: Record<string, Record<string, any>> | undefined;
                         type: "error-json";
                         value: any;
+                    } | {
+                        providerOptions?: Record<string, Record<string, any>> | undefined;
+                        reason?: string | undefined;
+                        type: "execution-denied";
                     } | {
                         type: "content";
                         value: ({
+                            providerOptions?: Record<string, Record<string, any>> | undefined;
                             type: "text";
                             text: string;
                         } | {
                             type: "media";
+                            mediaType: string;
                             data: string;
+                        } | {
+                            providerOptions?: Record<string, Record<string, any>> | undefined;
+                            filename?: string | undefined;
+                            type: "file-data";
                             mediaType: string;
+                            data: string;
+                        } | {
+                            providerOptions?: Record<string, Record<string, any>> | undefined;
+                            type: "file-url";
+                            url: string;
+                        } | {
+                            providerOptions?: Record<string, Record<string, any>> | undefined;
+                            type: "file-id";
+                            fileId: string | Record<string, string>;
+                        } | {
+                            providerOptions?: Record<string, Record<string, any>> | undefined;
+                            type: "image-data";
+                            mediaType: string;
+                            data: string;
+                        } | {
+                            providerOptions?: Record<string, Record<string, any>> | undefined;
+                            type: "image-url";
+                            url: string;
+                        } | {
+                            providerOptions?: Record<string, Record<string, any>> | undefined;
+                            type: "image-file-id";
+                            fileId: string | Record<string, string>;
+                        } | {
+                            providerOptions?: Record<string, Record<string, any>> | undefined;
+                            type: "custom";
                         })[];
                     } | undefined;
                     result?: any;
@@ -517,7 +619,15 @@ CustomCtx extends object = object, AgentTools extends ToolSet = any> {
                     type: "tool-result";
                     toolCallId: string;
                     toolName: string;
-                }[];
+                } | {
+                    providerOptions?: Record<string, Record<string, any>> | undefined;
+                    providerMetadata?: Record<string, Record<string, any>> | undefined;
+                    providerExecuted?: boolean | undefined;
+                    reason?: string | undefined;
+                    type: "tool-approval-response";
+                    approvalId: string;
+                    approved: boolean;
+                })[];
             } | {
                 providerOptions?: Record<string, Record<string, any>> | undefined;
                 role: "system";
@@ -539,8 +649,8 @@ CustomCtx extends object = object, AgentTools extends ToolSet = any> {
                 providerOptions?: Record<string, Record<string, any>> | undefined;
                 providerMetadata?: Record<string, Record<string, any>> | undefined;
                 id: string;
-                sourceType: "url";
                 url: string;
+                sourceType: "url";
             } | {
                 providerOptions?: Record<string, Record<string, any>> | undefined;
                 providerMetadata?: Record<string, Record<string, any>> | undefined;
@@ -563,7 +673,7 @@ CustomCtx extends object = object, AgentTools extends ToolSet = any> {
                 type: "other";
                 message: string;
             })[] | undefined;
-            finishReason?: "length" | "error" | "other" | "stop" | "content-filter" | "tool-calls" | "unknown" | undefined;
+            finishReason?: "error" | "length" | "other" | "stop" | "content-filter" | "tool-calls" | "unknown" | undefined;
             reasoningDetails?: ({
                 providerOptions?: Record<string, Record<string, any>> | undefined;
                 providerMetadata?: Record<string, Record<string, any>> | undefined;
@@ -578,13 +688,13 @@ CustomCtx extends object = object, AgentTools extends ToolSet = any> {
                 type: "redacted";
                 data: string;
             })[] | undefined;
-            _id: string;
-            _creationTime: number;
             status: "pending" | "success" | "failed";
             order: number;
+            _creationTime: number;
             threadId: string;
             stepOrder: number;
             tool: boolean;
+            _id: string;
         };
     }>;
     /**
@@ -952,15 +1062,17 @@ CustomCtx extends object = object, AgentTools extends ToolSet = any> {
                 text: string;
             } | {
                 providerOptions?: Record<string, Record<string, any>> | undefined;
+                mediaType?: string | undefined;
                 mimeType?: string | undefined;
                 type: "image";
                 image: string | ArrayBuffer;
             } | {
                 providerOptions?: Record<string, Record<string, any>> | undefined;
                 providerMetadata?: Record<string, Record<string, any>> | undefined;
+                mediaType?: string | undefined;
+                mimeType?: string | undefined;
                 filename?: string | undefined;
                 type: "file";
-                mimeType: string;
                 data: string | ArrayBuffer;
             })[];
         } | {
@@ -974,9 +1086,10 @@ CustomCtx extends object = object, AgentTools extends ToolSet = any> {
             } | {
                 providerOptions?: Record<string, Record<string, any>> | undefined;
                 providerMetadata?: Record<string, Record<string, any>> | undefined;
+                mediaType?: string | undefined;
+                mimeType?: string | undefined;
                 filename?: string | undefined;
                 type: "file";
-                mimeType: string;
                 data: string | ArrayBuffer;
             } | {
                 providerOptions?: Record<string, Record<string, any>> | undefined;
@@ -992,6 +1105,16 @@ CustomCtx extends object = object, AgentTools extends ToolSet = any> {
             } | {
                 providerOptions?: Record<string, Record<string, any>> | undefined;
                 providerMetadata?: Record<string, Record<string, any>> | undefined;
+                args?: any;
+                providerExecuted?: boolean | undefined;
+                type: "tool-call";
+                toolCallId: string;
+                toolName: string;
+                input: any;
+            } | {
+                providerOptions?: Record<string, Record<string, any>> | undefined;
+                providerMetadata?: Record<string, Record<string, any>> | undefined;
+                input?: any;
                 providerExecuted?: boolean | undefined;
                 type: "tool-call";
                 toolCallId: string;
@@ -1003,26 +1126,65 @@ CustomCtx extends object = object, AgentTools extends ToolSet = any> {
                 args?: any;
                 providerExecuted?: boolean | undefined;
                 output?: {
+                    providerOptions?: Record<string, Record<string, any>> | undefined;
                     type: "text";
                     value: string;
                 } | {
+                    providerOptions?: Record<string, Record<string, any>> | undefined;
                     type: "json";
                     value: any;
                 } | {
+                    providerOptions?: Record<string, Record<string, any>> | undefined;
                     type: "error-text";
                     value: string;
                 } | {
+                    providerOptions?: Record<string, Record<string, any>> | undefined;
                     type: "error-json";
                     value: any;
+                } | {
+                    providerOptions?: Record<string, Record<string, any>> | undefined;
+                    reason?: string | undefined;
+                    type: "execution-denied";
                 } | {
                     type: "content";
                     value: ({
+                        providerOptions?: Record<string, Record<string, any>> | undefined;
                         type: "text";
                         text: string;
                     } | {
                         type: "media";
+                        mediaType: string;
                         data: string;
+                    } | {
+                        providerOptions?: Record<string, Record<string, any>> | undefined;
+                        filename?: string | undefined;
+                        type: "file-data";
                         mediaType: string;
+                        data: string;
+                    } | {
+                        providerOptions?: Record<string, Record<string, any>> | undefined;
+                        type: "file-url";
+                        url: string;
+                    } | {
+                        providerOptions?: Record<string, Record<string, any>> | undefined;
+                        type: "file-id";
+                        fileId: string | Record<string, string>;
+                    } | {
+                        providerOptions?: Record<string, Record<string, any>> | undefined;
+                        type: "image-data";
+                        mediaType: string;
+                        data: string;
+                    } | {
+                        providerOptions?: Record<string, Record<string, any>> | undefined;
+                        type: "image-url";
+                        url: string;
+                    } | {
+                        providerOptions?: Record<string, Record<string, any>> | undefined;
+                        type: "image-file-id";
+                        fileId: string | Record<string, string>;
+                    } | {
+                        providerOptions?: Record<string, Record<string, any>> | undefined;
+                        type: "custom";
                     })[];
                 } | undefined;
                 result?: any;
@@ -1044,8 +1206,8 @@ CustomCtx extends object = object, AgentTools extends ToolSet = any> {
                 providerMetadata?: Record<string, Record<string, any>> | undefined;
                 id: string;
                 type: "source";
-                sourceType: "url";
                 url: string;
+                sourceType: "url";
             } | {
                 providerOptions?: Record<string, Record<string, any>> | undefined;
                 providerMetadata?: Record<string, Record<string, any>> | undefined;
@@ -1055,36 +1217,81 @@ CustomCtx extends object = object, AgentTools extends ToolSet = any> {
                 type: "source";
                 mediaType: string;
                 sourceType: "document";
+            } | {
+                providerOptions?: Record<string, Record<string, any>> | undefined;
+                providerMetadata?: Record<string, Record<string, any>> | undefined;
+                type: "tool-approval-request";
+                toolCallId: string;
+                approvalId: string;
             })[];
         } | {
             providerOptions?: Record<string, Record<string, any>> | undefined;
             role: "tool";
-            content: {
+            content: ({
                 providerOptions?: Record<string, Record<string, any>> | undefined;
                 providerMetadata?: Record<string, Record<string, any>> | undefined;
                 args?: any;
                 providerExecuted?: boolean | undefined;
                 output?: {
+                    providerOptions?: Record<string, Record<string, any>> | undefined;
                     type: "text";
                     value: string;
                 } | {
+                    providerOptions?: Record<string, Record<string, any>> | undefined;
                     type: "json";
                     value: any;
                 } | {
+                    providerOptions?: Record<string, Record<string, any>> | undefined;
                     type: "error-text";
                     value: string;
                 } | {
+                    providerOptions?: Record<string, Record<string, any>> | undefined;
                     type: "error-json";
                     value: any;
+                } | {
+                    providerOptions?: Record<string, Record<string, any>> | undefined;
+                    reason?: string | undefined;
+                    type: "execution-denied";
                 } | {
                     type: "content";
                     value: ({
+                        providerOptions?: Record<string, Record<string, any>> | undefined;
                         type: "text";
                         text: string;
                     } | {
                         type: "media";
+                        mediaType: string;
                         data: string;
+                    } | {
+                        providerOptions?: Record<string, Record<string, any>> | undefined;
+                        filename?: string | undefined;
+                        type: "file-data";
                         mediaType: string;
+                        data: string;
+                    } | {
+                        providerOptions?: Record<string, Record<string, any>> | undefined;
+                        type: "file-url";
+                        url: string;
+                    } | {
+                        providerOptions?: Record<string, Record<string, any>> | undefined;
+                        type: "file-id";
+                        fileId: string | Record<string, string>;
+                    } | {
+                        providerOptions?: Record<string, Record<string, any>> | undefined;
+                        type: "image-data";
+                        mediaType: string;
+                        data: string;
+                    } | {
+                        providerOptions?: Record<string, Record<string, any>> | undefined;
+                        type: "image-url";
+                        url: string;
+                    } | {
+                        providerOptions?: Record<string, Record<string, any>> | undefined;
+                        type: "image-file-id";
+                        fileId: string | Record<string, string>;
+                    } | {
+                        providerOptions?: Record<string, Record<string, any>> | undefined;
+                        type: "custom";
                     })[];
                 } | undefined;
                 result?: any;
@@ -1100,7 +1307,15 @@ CustomCtx extends object = object, AgentTools extends ToolSet = any> {
                 type: "tool-result";
                 toolCallId: string;
                 toolName: string;
-            }[];
+            } | {
+                providerOptions?: Record<string, Record<string, any>> | undefined;
+                providerMetadata?: Record<string, Record<string, any>> | undefined;
+                providerExecuted?: boolean | undefined;
+                reason?: string | undefined;
+                type: "tool-approval-response";
+                approvalId: string;
+                approved: boolean;
+            })[];
         } | {
             providerOptions?: Record<string, Record<string, any>> | undefined;
             role: "system";
@@ -1149,8 +1364,8 @@ CustomCtx extends object = object, AgentTools extends ToolSet = any> {
         text: string;
         promptMessageId: string | undefined;
         order: number | undefined;
-        finishReason: import("@ai-sdk/provider").LanguageModelV2FinishReason;
-        warnings: import("@ai-sdk/provider").LanguageModelV2CallWarning[] | undefined;
+        finishReason: import("ai").FinishReason;
+        warnings: import("@ai-sdk/provider").SharedV3Warning[] | undefined;
         savedMessageIds: string[];
     }>>;
     /**
@@ -1175,15 +1390,17 @@ CustomCtx extends object = object, AgentTools extends ToolSet = any> {
                 text: string;
             } | {
                 providerOptions?: Record<string, Record<string, any>> | undefined;
+                mediaType?: string | undefined;
                 mimeType?: string | undefined;
                 type: "image";
                 image: string | ArrayBuffer;
             } | {
                 providerOptions?: Record<string, Record<string, any>> | undefined;
                 providerMetadata?: Record<string, Record<string, any>> | undefined;
+                mediaType?: string | undefined;
+                mimeType?: string | undefined;
                 filename?: string | undefined;
                 type: "file";
-                mimeType: string;
                 data: string | ArrayBuffer;
             })[];
         } | {
@@ -1197,9 +1414,10 @@ CustomCtx extends object = object, AgentTools extends ToolSet = any> {
             } | {
                 providerOptions?: Record<string, Record<string, any>> | undefined;
                 providerMetadata?: Record<string, Record<string, any>> | undefined;
+                mediaType?: string | undefined;
+                mimeType?: string | undefined;
                 filename?: string | undefined;
                 type: "file";
-                mimeType: string;
                 data: string | ArrayBuffer;
             } | {
                 providerOptions?: Record<string, Record<string, any>> | undefined;
@@ -1215,6 +1433,16 @@ CustomCtx extends object = object, AgentTools extends ToolSet = any> {
             } | {
                 providerOptions?: Record<string, Record<string, any>> | undefined;
                 providerMetadata?: Record<string, Record<string, any>> | undefined;
+                args?: any;
+                providerExecuted?: boolean | undefined;
+                type: "tool-call";
+                toolCallId: string;
+                toolName: string;
+                input: any;
+            } | {
+                providerOptions?: Record<string, Record<string, any>> | undefined;
+                providerMetadata?: Record<string, Record<string, any>> | undefined;
+                input?: any;
                 providerExecuted?: boolean | undefined;
                 type: "tool-call";
                 toolCallId: string;
@@ -1226,26 +1454,65 @@ CustomCtx extends object = object, AgentTools extends ToolSet = any> {
                 args?: any;
                 providerExecuted?: boolean | undefined;
                 output?: {
+                    providerOptions?: Record<string, Record<string, any>> | undefined;
                     type: "text";
                     value: string;
                 } | {
+                    providerOptions?: Record<string, Record<string, any>> | undefined;
                     type: "json";
                     value: any;
                 } | {
+                    providerOptions?: Record<string, Record<string, any>> | undefined;
                     type: "error-text";
                     value: string;
                 } | {
+                    providerOptions?: Record<string, Record<string, any>> | undefined;
                     type: "error-json";
                     value: any;
+                } | {
+                    providerOptions?: Record<string, Record<string, any>> | undefined;
+                    reason?: string | undefined;
+                    type: "execution-denied";
                 } | {
                     type: "content";
                     value: ({
+                        providerOptions?: Record<string, Record<string, any>> | undefined;
                         type: "text";
                         text: string;
                     } | {
                         type: "media";
+                        mediaType: string;
                         data: string;
+                    } | {
+                        providerOptions?: Record<string, Record<string, any>> | undefined;
+                        filename?: string | undefined;
+                        type: "file-data";
                         mediaType: string;
+                        data: string;
+                    } | {
+                        providerOptions?: Record<string, Record<string, any>> | undefined;
+                        type: "file-url";
+                        url: string;
+                    } | {
+                        providerOptions?: Record<string, Record<string, any>> | undefined;
+                        type: "file-id";
+                        fileId: string | Record<string, string>;
+                    } | {
+                        providerOptions?: Record<string, Record<string, any>> | undefined;
+                        type: "image-data";
+                        mediaType: string;
+                        data: string;
+                    } | {
+                        providerOptions?: Record<string, Record<string, any>> | undefined;
+                        type: "image-url";
+                        url: string;
+                    } | {
+                        providerOptions?: Record<string, Record<string, any>> | undefined;
+                        type: "image-file-id";
+                        fileId: string | Record<string, string>;
+                    } | {
+                        providerOptions?: Record<string, Record<string, any>> | undefined;
+                        type: "custom";
                     })[];
                 } | undefined;
                 result?: any;
@@ -1267,8 +1534,8 @@ CustomCtx extends object = object, AgentTools extends ToolSet = any> {
                 providerMetadata?: Record<string, Record<string, any>> | undefined;
                 id: string;
                 type: "source";
-                sourceType: "url";
                 url: string;
+                sourceType: "url";
             } | {
                 providerOptions?: Record<string, Record<string, any>> | undefined;
                 providerMetadata?: Record<string, Record<string, any>> | undefined;
@@ -1278,36 +1545,81 @@ CustomCtx extends object = object, AgentTools extends ToolSet = any> {
                 type: "source";
                 mediaType: string;
                 sourceType: "document";
+            } | {
+                providerOptions?: Record<string, Record<string, any>> | undefined;
+                providerMetadata?: Record<string, Record<string, any>> | undefined;
+                type: "tool-approval-request";
+                toolCallId: string;
+                approvalId: string;
             })[];
         } | {
             providerOptions?: Record<string, Record<string, any>> | undefined;
             role: "tool";
-            content: {
+            content: ({
                 providerOptions?: Record<string, Record<string, any>> | undefined;
                 providerMetadata?: Record<string, Record<string, any>> | undefined;
                 args?: any;
                 providerExecuted?: boolean | undefined;
                 output?: {
+                    providerOptions?: Record<string, Record<string, any>> | undefined;
                     type: "text";
                     value: string;
                 } | {
+                    providerOptions?: Record<string, Record<string, any>> | undefined;
                     type: "json";
                     value: any;
                 } | {
+                    providerOptions?: Record<string, Record<string, any>> | undefined;
                     type: "error-text";
                     value: string;
                 } | {
+                    providerOptions?: Record<string, Record<string, any>> | undefined;
                     type: "error-json";
                     value: any;
+                } | {
+                    providerOptions?: Record<string, Record<string, any>> | undefined;
+                    reason?: string | undefined;
+                    type: "execution-denied";
                 } | {
                     type: "content";
                     value: ({
+                        providerOptions?: Record<string, Record<string, any>> | undefined;
                         type: "text";
                         text: string;
                     } | {
                         type: "media";
+                        mediaType: string;
                         data: string;
+                    } | {
+                        providerOptions?: Record<string, Record<string, any>> | undefined;
+                        filename?: string | undefined;
+                        type: "file-data";
                         mediaType: string;
+                        data: string;
+                    } | {
+                        providerOptions?: Record<string, Record<string, any>> | undefined;
+                        type: "file-url";
+                        url: string;
+                    } | {
+                        providerOptions?: Record<string, Record<string, any>> | undefined;
+                        type: "file-id";
+                        fileId: string | Record<string, string>;
+                    } | {
+                        providerOptions?: Record<string, Record<string, any>> | undefined;
+                        type: "image-data";
+                        mediaType: string;
+                        data: string;
+                    } | {
+                        providerOptions?: Record<string, Record<string, any>> | undefined;
+                        type: "image-url";
+                        url: string;
+                    } | {
+                        providerOptions?: Record<string, Record<string, any>> | undefined;
+                        type: "image-file-id";
+                        fileId: string | Record<string, string>;
+                    } | {
+                        providerOptions?: Record<string, Record<string, any>> | undefined;
+                        type: "custom";
                     })[];
                 } | undefined;
                 result?: any;
@@ -1323,7 +1635,15 @@ CustomCtx extends object = object, AgentTools extends ToolSet = any> {
                 type: "tool-result";
                 toolCallId: string;
                 toolName: string;
-            }[];
+            } | {
+                providerOptions?: Record<string, Record<string, any>> | undefined;
+                providerMetadata?: Record<string, Record<string, any>> | undefined;
+                providerExecuted?: boolean | undefined;
+                reason?: string | undefined;
+                type: "tool-approval-response";
+                approvalId: string;
+                approved: boolean;
+            })[];
         } | {
             providerOptions?: Record<string, Record<string, any>> | undefined;
             role: "system";
@@ -1365,8 +1685,8 @@ CustomCtx extends object = object, AgentTools extends ToolSet = any> {
         object: T;
         promptMessageId: string | undefined;
         order: number | undefined;
-        finishReason: import("@ai-sdk/provider").LanguageModelV2FinishReason;
-        warnings: import("@ai-sdk/provider").LanguageModelV2CallWarning[] | undefined;
+        finishReason: import("ai").FinishReason;
+        warnings: import("@ai-sdk/provider").SharedV3Warning[] | undefined;
         savedMessageIds: string[];
     }>>;
     /**
@@ -1403,8 +1723,8 @@ CustomCtx extends object = object, AgentTools extends ToolSet = any> {
                 providerOptions?: Record<string, Record<string, any>> | undefined;
                 providerMetadata?: Record<string, Record<string, any>> | undefined;
                 id: string;
-                sourceType: "url";
                 url: string;
+                sourceType: "url";
             } | {
                 providerOptions?: Record<string, Record<string, any>> | undefined;
                 providerMetadata?: Record<string, Record<string, any>> | undefined;
@@ -1427,7 +1747,7 @@ CustomCtx extends object = object, AgentTools extends ToolSet = any> {
                 type: "other";
                 message: string;
             })[] | undefined;
-            finishReason?: "length" | "error" | "other" | "stop" | "content-filter" | "tool-calls" | "unknown" | undefined;
+            finishReason?: "error" | "length" | "other" | "stop" | "content-filter" | "tool-calls" | "unknown" | undefined;
             reasoningDetails?: ({
                 providerOptions?: Record<string, Record<string, any>> | undefined;
                 providerMetadata?: Record<string, Record<string, any>> | undefined;
@@ -1452,15 +1772,17 @@ CustomCtx extends object = object, AgentTools extends ToolSet = any> {
                     text: string;
                 } | {
                     providerOptions?: Record<string, Record<string, any>> | undefined;
+                    mediaType?: string | undefined;
                     mimeType?: string | undefined;
                     type: "image";
                     image: string | ArrayBuffer;
                 } | {
                     providerOptions?: Record<string, Record<string, any>> | undefined;
                     providerMetadata?: Record<string, Record<string, any>> | undefined;
+                    mediaType?: string | undefined;
+                    mimeType?: string | undefined;
                     filename?: string | undefined;
                     type: "file";
-                    mimeType: string;
                     data: string | ArrayBuffer;
                 })[];
             } | {
@@ -1474,9 +1796,10 @@ CustomCtx extends object = object, AgentTools extends ToolSet = any> {
                 } | {
                     providerOptions?: Record<string, Record<string, any>> | undefined;
                     providerMetadata?: Record<string, Record<string, any>> | undefined;
+                    mediaType?: string | undefined;
+                    mimeType?: string | undefined;
                     filename?: string | undefined;
                     type: "file";
-                    mimeType: string;
                     data: string | ArrayBuffer;
                 } | {
                     providerOptions?: Record<string, Record<string, any>> | undefined;
@@ -1492,6 +1815,16 @@ CustomCtx extends object = object, AgentTools extends ToolSet = any> {
                 } | {
                     providerOptions?: Record<string, Record<string, any>> | undefined;
                     providerMetadata?: Record<string, Record<string, any>> | undefined;
+                    args?: any;
+                    providerExecuted?: boolean | undefined;
+                    type: "tool-call";
+                    toolCallId: string;
+                    toolName: string;
+                    input: any;
+                } | {
+                    providerOptions?: Record<string, Record<string, any>> | undefined;
+                    providerMetadata?: Record<string, Record<string, any>> | undefined;
+                    input?: any;
                     providerExecuted?: boolean | undefined;
                     type: "tool-call";
                     toolCallId: string;
@@ -1503,26 +1836,65 @@ CustomCtx extends object = object, AgentTools extends ToolSet = any> {
                     args?: any;
                     providerExecuted?: boolean | undefined;
                     output?: {
+                        providerOptions?: Record<string, Record<string, any>> | undefined;
                         type: "text";
                         value: string;
                     } | {
+                        providerOptions?: Record<string, Record<string, any>> | undefined;
                         type: "json";
                         value: any;
                     } | {
+                        providerOptions?: Record<string, Record<string, any>> | undefined;
                         type: "error-text";
                         value: string;
                     } | {
+                        providerOptions?: Record<string, Record<string, any>> | undefined;
                         type: "error-json";
                         value: any;
+                    } | {
+                        providerOptions?: Record<string, Record<string, any>> | undefined;
+                        reason?: string | undefined;
+                        type: "execution-denied";
                     } | {
                         type: "content";
                         value: ({
+                            providerOptions?: Record<string, Record<string, any>> | undefined;
                             type: "text";
                             text: string;
                         } | {
                             type: "media";
+                            mediaType: string;
                             data: string;
+                        } | {
+                            providerOptions?: Record<string, Record<string, any>> | undefined;
+                            filename?: string | undefined;
+                            type: "file-data";
                             mediaType: string;
+                            data: string;
+                        } | {
+                            providerOptions?: Record<string, Record<string, any>> | undefined;
+                            type: "file-url";
+                            url: string;
+                        } | {
+                            providerOptions?: Record<string, Record<string, any>> | undefined;
+                            type: "file-id";
+                            fileId: string | Record<string, string>;
+                        } | {
+                            providerOptions?: Record<string, Record<string, any>> | undefined;
+                            type: "image-data";
+                            mediaType: string;
+                            data: string;
+                        } | {
+                            providerOptions?: Record<string, Record<string, any>> | undefined;
+                            type: "image-url";
+                            url: string;
+                        } | {
+                            providerOptions?: Record<string, Record<string, any>> | undefined;
+                            type: "image-file-id";
+                            fileId: string | Record<string, string>;
+                        } | {
+                            providerOptions?: Record<string, Record<string, any>> | undefined;
+                            type: "custom";
                         })[];
                     } | undefined;
                     result?: any;
@@ -1544,8 +1916,8 @@ CustomCtx extends object = object, AgentTools extends ToolSet = any> {
                     providerMetadata?: Record<string, Record<string, any>> | undefined;
                     id: string;
                     type: "source";
-                    sourceType: "url";
                     url: string;
+                    sourceType: "url";
                 } | {
                     providerOptions?: Record<string, Record<string, any>> | undefined;
                     providerMetadata?: Record<string, Record<string, any>> | undefined;
@@ -1555,36 +1927,81 @@ CustomCtx extends object = object, AgentTools extends ToolSet = any> {
                     type: "source";
                     mediaType: string;
                     sourceType: "document";
+                } | {
+                    providerOptions?: Record<string, Record<string, any>> | undefined;
+                    providerMetadata?: Record<string, Record<string, any>> | undefined;
+                    type: "tool-approval-request";
+                    toolCallId: string;
+                    approvalId: string;
                 })[];
             } | {
                 providerOptions?: Record<string, Record<string, any>> | undefined;
                 role: "tool";
-                content: {
+                content: ({
                     providerOptions?: Record<string, Record<string, any>> | undefined;
                     providerMetadata?: Record<string, Record<string, any>> | undefined;
                     args?: any;
                     providerExecuted?: boolean | undefined;
                     output?: {
+                        providerOptions?: Record<string, Record<string, any>> | undefined;
                         type: "text";
                         value: string;
                     } | {
+                        providerOptions?: Record<string, Record<string, any>> | undefined;
                         type: "json";
                         value: any;
                     } | {
+                        providerOptions?: Record<string, Record<string, any>> | undefined;
                         type: "error-text";
                         value: string;
                     } | {
+                        providerOptions?: Record<string, Record<string, any>> | undefined;
                         type: "error-json";
                         value: any;
+                    } | {
+                        providerOptions?: Record<string, Record<string, any>> | undefined;
+                        reason?: string | undefined;
+                        type: "execution-denied";
                     } | {
                         type: "content";
                         value: ({
+                            providerOptions?: Record<string, Record<string, any>> | undefined;
                             type: "text";
                             text: string;
                         } | {
                             type: "media";
+                            mediaType: string;
+                            data: string;
+                        } | {
+                            providerOptions?: Record<string, Record<string, any>> | undefined;
+                            filename?: string | undefined;
+                            type: "file-data";
+                            mediaType: string;
                             data: string;
+                        } | {
+                            providerOptions?: Record<string, Record<string, any>> | undefined;
+                            type: "file-url";
+                            url: string;
+                        } | {
+                            providerOptions?: Record<string, Record<string, any>> | undefined;
+                            type: "file-id";
+                            fileId: string | Record<string, string>;
+                        } | {
+                            providerOptions?: Record<string, Record<string, any>> | undefined;
+                            type: "image-data";
                             mediaType: string;
+                            data: string;
+                        } | {
+                            providerOptions?: Record<string, Record<string, any>> | undefined;
+                            type: "image-url";
+                            url: string;
+                        } | {
+                            providerOptions?: Record<string, Record<string, any>> | undefined;
+                            type: "image-file-id";
+                            fileId: string | Record<string, string>;
+                        } | {
+                            providerOptions?: Record<string, Record<string, any>> | undefined;
+                            type: "custom";
                         })[];
                     } | undefined;
                     result?: any;
@@ -1600,7 +2017,15 @@ CustomCtx extends object = object, AgentTools extends ToolSet = any> {
                     type: "tool-result";
                     toolCallId: string;
                     toolName: string;
-                }[];
+                } | {
+                    providerOptions?: Record<string, Record<string, any>> | undefined;
+                    providerMetadata?: Record<string, Record<string, any>> | undefined;
+                    providerExecuted?: boolean | undefined;
+                    reason?: string | undefined;
+                    type: "tool-approval-response";
+                    approvalId: string;
+                    approved: boolean;
+                })[];
             } | {
                 providerOptions?: Record<string, Record<string, any>> | undefined;
                 role: "system";
@@ -1610,9 +2035,9 @@ CustomCtx extends object = object, AgentTools extends ToolSet = any> {
     }, Promise<{
         lastMessageId: string;
         messages: {
-            _id: string;
             order: number;
             stepOrder: number;
+            _id: string;
         }[];
     }>>;
 }