@convex-dev/agent 0.5.0-alpha.1 → 0.6.0-alpha.1

package/dist/client/index.d.ts

@@ -1,27 +1,30 @@
-import type { LanguageModelV2, EmbeddingModelV2 } from "@ai-sdk/provider";
-import type { ModelMessage, DeepPartial, GenerateObjectResult, GenerateTextResult, StepResult, StreamObjectResult, StreamTextResult, ToolSet, StopCondition, Schema } from "ai";
-import { type GenericActionCtx, type GenericDataModel, type PaginationOptions, type PaginationResult } from "convex/server";
-import type { MessageDoc, ThreadDoc } from "../component/schema.js";
+import type { JSONValue } from "@ai-sdk/provider";
+import type { FlexibleSchema, IdGenerator, InferSchema } from "@ai-sdk/provider-utils";
+import type { CallSettings, GenerateObjectResult, GenerateTextResult, LanguageModel, ModelMessage, StepResult, StopCondition, StreamTextResult, ToolSet } from "ai";
+import { streamObject } from "ai";
+import { type GenericDataModel, type PaginationOptions, type PaginationResult } from "convex/server";
 import type { threadFieldsSupportingPatch } from "../component/threads.js";
 import { type VectorDimension } from "../component/vector/tables.js";
-import { extractText, isTool } from "../shared.js";
-import { type Message, type MessageEmbeddings, type MessageStatus, type MessageWithMetadata, type ProviderMetadata, type StreamArgs, type Usage } from "../validators.js";
-import { createTool } from "./createTool.js";
-import { listMessages } from "./listMessages.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, ContextOptions, GenerationOutputMetadata, Options, OurObjectArgs, OurStreamObjectArgs, RawRequestResponseHandler, RunActionCtx, RunMutationCtx, RunQueryCtx, StorageOptions, StreamingTextArgs, SyncStreamsReturnValue, TextArgs, Thread, UsageHandler } from "./types.js";
-import type z from "zod";
+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 { vMessageDoc, vThreadDoc } from "../component/schema.js";
-export { serializeDataOrUrl, deserializeMessage, serializeMessage, } from "../mapping.js";
-export { vAssistantMessage, vContextOptions, vMessage, vPaginationResult, vProviderMetadata, vStorageOptions, vStreamArgs, vSystemMessage, vToolMessage, vUsage, vUserMessage, } from "../validators.js";
-export type { ToolCtx } from "./createTool.js";
+export { docsToModelMessages, toModelMessage, toModelMessage as deserializeMessage, guessMimeType, serializeDataOrUrl, serializeMessage, toUIFilePart, } from "../mapping.js";
+export { extractText, isTool, sorted } from "../shared.js";
+export { vAssistantMessage, vContent, vContextOptions, vMessage, vMessageDoc, vPaginationResult, vProviderMetadata, vSource, vStorageOptions, vStreamArgs, vSystemMessage, vThreadDoc, vToolMessage, vUsage, vUserMessage, type Message, type MessageDoc, type SourcePart, type ThreadDoc, type Usage, } from "../validators.js";
+export { createTool, type ToolCtx } from "./createTool.js";
+export { definePlaygroundAPI, type AgentsFn, type PlaygroundAPI, } from "./definePlaygroundAPI.js";
 export { getFile, storeFile } from "./files.js";
-export { filterOutOrphanedToolMessages, fetchContextMessages, } from "./search.js";
-export { abortStream, listStreams, syncStreams } from "./streaming.js";
-export { createTool, extractText, isTool, listMessages };
-export { definePlaygroundAPI, type PlaygroundAPI, type AgentsFn, } from "./definePlaygroundAPI.js";
-export type { AgentComponent, ContextOptions, MessageDoc, ProviderMetadata, RawRequestResponseHandler, StorageOptions, StreamArgs, SyncStreamsReturnValue, Thread, ThreadDoc, Usage, UsageHandler, };
+export { listMessages, listUIMessages, saveMessage, saveMessages, type SaveMessageArgs, type SaveMessagesArgs, } from "./messages.js";
+export { mockModel } from "./mockModel.js";
+export { fetchContextMessages, filterOutOrphanedToolMessages, fetchContextWithPrompt, generateAndSaveEmbeddings, embedMessages, embedMany, } from "./search.js";
+export { startGeneration } from "./start.js";
+export { DEFAULT_STREAMING_OPTIONS, DeltaStreamer, abortStream, compressUIMessageChunks, listStreams, syncStreams, vStreamMessagesReturnValue, } from "./streaming.js";
+export { createThread, getThreadMetadata, searchThreadTitles, updateThreadMetadata, } from "./threads.js";
+export type { ContextHandler } from "./types.js";
+export { toUIMessages, fromUIMessages, type UIMessage } from "../UIMessages.js";
+export type { AgentComponent, Config, ContextOptions, ProviderMetadata, RawRequestResponseHandler, StorageOptions, StreamArgs, SyncStreamsReturnValue, Thread, UsageHandler, };
 export declare class Agent<
 /**
  * You can require that all `ctx` args to generateText & streamText
@@ -44,31 +47,20 @@ export declare class Agent<
  */
 CustomCtx extends object = object, AgentTools extends ToolSet = any> {
     component: AgentComponent;
-    options: {
+    options: Config & {
         /**
          * The name for the agent. This will be attributed on each message
          * created by this agent.
          */
-        name?: string;
+        name: string;
         /**
          * The LLM model to use for generating / streaming text and objects.
          * e.g.
          * import { openai } from "@ai-sdk/openai"
          * const myAgent = new Agent(components.agent, {
-         *   chat: openai.chat("gpt-4o-mini"),
+         *   languageModel: openai.chat("gpt-4o-mini"),
          */
-        chat: LanguageModelV2;
-        /**
-         * The model to use for text embeddings. Optional.
-         * If specified, it will use this for generating vector embeddings
-         * of chats, and can opt-in to doing vector search for automatic context
-         * on generateText, etc.
-         * e.g.
-         * import { openai } from "@ai-sdk/openai"
-         * const myAgent = new Agent(components.agent, {
-         *   textEmbedding: openai.embedding("text-embedding-3-small")
-         */
-        textEmbedding?: EmbeddingModelV2<string>;
+        languageModel: LanguageModel;
         /**
          * The default system prompt to put in each request.
          * Override per-prompt by passing the "system" parameter.
@@ -81,62 +73,26 @@ CustomCtx extends object = object, AgentTools extends ToolSet = any> {
          * (import { createTool } from "@convex-dev/agent")
          */
         tools?: AgentTools;
-        /**
-         * Options to determine what messages are included as context in message
-         * generation. To disable any messages automatically being added, pass:
-         * { recentMessages: 0 }
-         */
-        contextOptions?: ContextOptions;
-        /**
-         * Determines whether messages are automatically stored when passed as
-         * arguments or generated.
-         */
-        storageOptions?: StorageOptions;
         /**
          * When generating or streaming text with tools available, this
-         * determines when to stop. Defaults to stepCountIs(1).
-         */
-        stopWhen?: StopCondition<AgentTools> | Array<StopCondition<AgentTools>>;
-        /**
-         * The maximum number of calls to make to an LLM in case it fails.
-         * This can be overridden at each generate/stream callsite.
-         */
-        maxRetries?: number;
-        /**
-         * The usage handler to use for this agent.
-         */
-        usageHandler?: UsageHandler;
-        /**
-         * Called for each LLM request/response, so you can do things like
-         * log the raw request body or response headers to a table, or logs.
+         * determines when to stop. Defaults to the AI SDK default.
          */
-        rawRequestResponseHandler?: RawRequestResponseHandler;
+        stopWhen?: StopCondition<NoInfer<AgentTools>> | Array<StopCondition<NoInfer<AgentTools>>>;
     };
-    constructor(component: AgentComponent, options: {
+    constructor(component: AgentComponent, options: Config & {
         /**
          * The name for the agent. This will be attributed on each message
          * created by this agent.
          */
-        name?: string;
+        name: string;
         /**
          * The LLM model to use for generating / streaming text and objects.
          * e.g.
          * import { openai } from "@ai-sdk/openai"
          * const myAgent = new Agent(components.agent, {
-         *   chat: openai.chat("gpt-4o-mini"),
+         *   languageModel: openai.chat("gpt-4o-mini"),
          */
-        chat: LanguageModelV2;
-        /**
-         * The model to use for text embeddings. Optional.
-         * If specified, it will use this for generating vector embeddings
-         * of chats, and can opt-in to doing vector search for automatic context
-         * on generateText, etc.
-         * e.g.
-         * import { openai } from "@ai-sdk/openai"
-         * const myAgent = new Agent(components.agent, {
-         *   textEmbedding: openai.embedding("text-embedding-3-small")
-         */
-        textEmbedding?: EmbeddingModelV2<string>;
+        languageModel: LanguageModel;
         /**
          * The default system prompt to put in each request.
          * Override per-prompt by passing the "system" parameter.
@@ -149,37 +105,17 @@ CustomCtx extends object = object, AgentTools extends ToolSet = any> {
          * (import { createTool } from "@convex-dev/agent")
          */
         tools?: AgentTools;
-        /**
-         * Options to determine what messages are included as context in message
-         * generation. To disable any messages automatically being added, pass:
-         * { recentMessages: 0 }
-         */
-        contextOptions?: ContextOptions;
-        /**
-         * Determines whether messages are automatically stored when passed as
-         * arguments or generated.
-         */
-        storageOptions?: StorageOptions;
         /**
          * When generating or streaming text with tools available, this
-         * determines when to stop. Defaults to stepCountIs(1).
-         */
-        stopWhen?: StopCondition<AgentTools> | Array<StopCondition<AgentTools>>;
-        /**
-         * The maximum number of calls to make to an LLM in case it fails.
-         * This can be overridden at each generate/stream callsite.
-         */
-        maxRetries?: number;
-        /**
-         * The usage handler to use for this agent.
-         */
-        usageHandler?: UsageHandler;
-        /**
-         * Called for each LLM request/response, so you can do things like
-         * log the raw request body or response headers to a table, or logs.
+         * determines when to stop. Defaults to the AI SDK default.
          */
-        rawRequestResponseHandler?: RawRequestResponseHandler;
+        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
@@ -190,7 +126,7 @@ CustomCtx extends object = object, AgentTools extends ToolSet = any> {
      * @param args The thread metadata.
      * @returns The threadId of the new thread and the thread object.
      */
-    createThread<ThreadTools extends ToolSet | undefined = undefined>(ctx: RunActionCtx & CustomCtx, args?: {
+    createThread(ctx: ActionCtx & CustomCtx, args?: {
         /**
          * The userId to associate with the thread. If not provided, the thread will be
          * anonymous.
@@ -204,19 +140,9 @@ CustomCtx extends object = object, AgentTools extends ToolSet = any> {
          * The summary of the thread. Not currently used for anything.
          */
         summary?: string;
-        /**
-         * The usage handler to use for this thread. Overrides any handler
-         * set in the agent constructor.
-         */
-        usageHandler?: UsageHandler;
-        /**
-         * The tools to use for this thread.
-         * Overrides any tools passed in the agent constructor.
-         */
-        tools?: ThreadTools;
     }): Promise<{
         threadId: string;
-        thread: Thread<ThreadTools extends undefined ? AgentTools : ThreadTools>;
+        thread: Thread<AgentTools>;
     }>;
     /**
      * Start a new thread with the agent. This will have a fresh history, though if
@@ -227,7 +153,7 @@ CustomCtx extends object = object, AgentTools extends ToolSet = any> {
      * @param args The thread metadata.
      * @returns The threadId of the new thread.
      */
-    createThread<ThreadTools extends ToolSet | undefined = undefined>(ctx: RunMutationCtx, args?: {
+    createThread(ctx: MutationCtx, args?: {
         /**
          * The userId to associate with the thread. If not provided, the thread will be
          * anonymous.
@@ -241,16 +167,6 @@ CustomCtx extends object = object, AgentTools extends ToolSet = any> {
          * The summary of the thread. Not currently used for anything.
          */
         summary?: string;
-        /**
-         * The usage handler to use for this thread. Overrides any handler
-         * set in the agent constructor.
-         */
-        usageHandler?: UsageHandler;
-        /**
-         * The tools to use for this thread.
-         * Overrides any tools passed in the agent constructor.
-         */
-        tools?: ThreadTools;
     }): Promise<{
         threadId: string;
     }>;
@@ -262,7 +178,7 @@ CustomCtx extends object = object, AgentTools extends ToolSet = any> {
      * @param { threadId, userId }: the thread and user to associate the messages with.
      * @returns Functions bound to the userId and threadId on a `{thread}` object.
      */
-    continueThread<ThreadTools extends ToolSet | undefined = undefined>(ctx: ActionCtx & CustomCtx, args: {
+    continueThread(ctx: ActionCtx & CustomCtx, args: {
         /**
          * The associated thread created by {@link createThread}
          */
@@ -272,29 +188,58 @@ CustomCtx extends object = object, AgentTools extends ToolSet = any> {
          * relevant messages from the same user as context for the LLM calls.
          */
         userId?: string | null;
+    }): Promise<{
+        thread: Thread<AgentTools>;
+    }>;
+    start<TOOLS extends ToolSet | undefined, T extends {
+        _internal?: {
+            generateId?: IdGenerator;
+        };
+    }>(ctx: ActionCtx & CustomCtx, 
+    /**
+     * These are the arguments you'll pass to the LLM call such as
+     * `generateText` or `streamText`. This function will look up the context
+     * and provide functions to save the steps, abort the generation, and more.
+     * The type of the arguments returned infers from the type of the arguments
+     * you pass here.
+     */
+    args: T & AgentPrompt & {
         /**
-         * The usage handler to use for this thread. Overrides any handler
-         * set in the agent constructor.
+         * The tools to use for the tool calls. This will override tools specified
+         * in the Agent constructor or createThread / continueThread.
          */
-        usageHandler?: UsageHandler;
+        tools?: TOOLS;
         /**
-         * The tools to use for this thread.
-         * Overrides any tools passed in the agent constructor.
+         * The abort signal to be passed to the LLM call. If triggered, it will
+         * mark the pending message as failed. If the generation is asynchronously
+         * aborted, it will trigger this signal when detected.
          */
-        tools?: ThreadTools;
+        abortSignal?: AbortSignal;
+        stopWhen?: StopCondition<TOOLS extends undefined ? AgentTools : TOOLS> | Array<StopCondition<TOOLS extends undefined ? AgentTools : TOOLS>>;
+    }, options?: Options & {
+        userId?: string | null;
+        threadId?: string;
     }): Promise<{
-        thread: Thread<ThreadTools extends undefined ? AgentTools : ThreadTools>;
+        args: T & {
+            system?: string;
+            model: LanguageModel;
+            prompt?: never;
+            messages: ModelMessage[];
+            tools?: TOOLS extends undefined ? AgentTools : TOOLS;
+        } & CallSettings;
+        order: number;
+        stepOrder: number;
+        userId: string | undefined;
+        promptMessageId: string | undefined;
+        updateModel: (model: LanguageModel | undefined) => void;
+        save: <TOOLS extends ToolSet>(toSave: {
+            step: StepResult<TOOLS>;
+        } | {
+            object: GenerateObjectResult<unknown>;
+        }, createPendingMessage?: boolean) => Promise<void>;
+        fail: (reason: string) => Promise<void>;
+        getSavedMessages: () => MessageDoc[];
     }>;
-    /**
-     * Search for threads by title, paginated.
-     * @param ctx The context passed from the query/mutation/action.
-     * @returns The threads matching the search, paginated.
-     */
-    searchThreadTitles(ctx: RunQueryCtx, { userId, query, limit, }: {
-        userId?: string | undefined;
-        query: string;
-        limit?: number;
-    }): Promise<ThreadDoc[]>;
     /**
      * This behaves like {@link generateText} from the "ai" package except that
      * it add context based on the userId and threadId and saves the input and
@@ -302,22 +247,21 @@ 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).
      * @param ctx The context passed from the action function calling this.
-     * @param { userId, threadId }: The user and thread to associate the message with
-     * @param args The arguments to the generateText function, along with extra controls
-     * for the {@link ContextOptions} and {@link StorageOptions}.
+     * @param scope: The user and thread to associate the message with
+     * @param generateTextArgs The arguments to the generateText function, along
+     * with {@link AgentPrompt} options, such as promptMessageId.
+     * @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, { userId: argsUserId, threadId, usageHandler, tools: threadTools, }: {
+    generateText<TOOLS extends ToolSet | undefined = undefined, OUTPUT extends Output<any, any, any> = never>(ctx: ActionCtx & CustomCtx, threadOpts: {
         userId?: string | null;
         threadId?: string;
-        /**
-         * The usage handler to use for this thread. Overrides any handler
-         * set in the agent constructor.
-         */
-        usageHandler?: UsageHandler;
-        /** Note: to get better type inference, pass tools in the next arg */
-        tools?: ToolSet;
-    }, args: TextArgs<AgentTools, TOOLS, OUTPUT, OUTPUT_PARTIAL>, options?: Options): Promise<GenerateTextResult<TOOLS extends undefined ? AgentTools : TOOLS, OUTPUT> & GenerationOutputMetadata>;
+    }, 
+    /**
+     * 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>, 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
@@ -325,18 +269,15 @@ 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, { userId: argsUserId, threadId, usageHandler, 
-    /** Note: to get better type inference, pass tools in the next arg */
-    tools: threadTools, }: {
+    streamText<TOOLS extends ToolSet | undefined = undefined, OUTPUT extends Output<any, any, any> = never>(ctx: ActionCtx & CustomCtx, threadOpts: {
         userId?: string | null;
         threadId?: string;
-        usageHandler?: UsageHandler;
-        tools?: ToolSet;
     }, 
     /**
-     * The arguments to the streamText function, similar to the ai `streamText` function.
+     * The arguments to the streamText function, similar to the ai sdk's
+     * {@link streamText} function, along with Agent prompt options.
      */
-    args: 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.
@@ -353,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
@@ -361,20 +302,20 @@ 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).
      */
-    generateObject<T>(ctx: ActionCtx, { userId: argsUserId, threadId, usageHandler, }: {
+    generateObject<SCHEMA extends FlexibleSchema<unknown> = FlexibleSchema<JSONValue>, OUTPUT extends ObjectMode = InferSchema<SCHEMA> extends string ? "enum" : "object", RESULT = OUTPUT extends "array" ? Array<InferSchema<SCHEMA>> : InferSchema<SCHEMA>>(ctx: ActionCtx & CustomCtx, threadOpts: {
         userId?: string | null;
         threadId?: string;
-        usageHandler?: UsageHandler;
     }, 
     /**
-     * The arguments to the generateObject function, similar to the ai.generateObject function.
+     * The arguments to the generateObject function, similar to the ai sdk's
+     * {@link generateObject} function, along with Agent prompt options.
      */
-    args: OurObjectArgs<T>, 
+    generateObjectArgs: AgentPrompt & GenerateObjectArgs<SCHEMA, OUTPUT, RESULT>, 
     /**
      * The {@link ContextOptions} and {@link StorageOptions}
      * options to use for fetching contextual messages and saving input/output messages.
      */
-    options?: Options): Promise<GenerateObjectResult<T> & GenerationOutputMetadata>;
+    options?: Options): Promise<GenerateObjectResult<RESULT> & GenerationOutputMetadata>;
     /**
      * This behaves like `streamObject` from the "ai" package except that
      * it add context based on the userId and threadId and saves the input and
@@ -382,20 +323,20 @@ 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).
      */
-    streamObject<T extends z.Schema | Schema>(ctx: ActionCtx, { userId: argsUserId, threadId, usageHandler, }: {
+    streamObject<SCHEMA extends FlexibleSchema<unknown> = FlexibleSchema<JSONValue>, OUTPUT extends ObjectMode = InferSchema<SCHEMA> extends string ? "enum" : "object", RESULT = OUTPUT extends "array" ? Array<InferSchema<SCHEMA>> : InferSchema<SCHEMA>>(ctx: ActionCtx & CustomCtx, threadOpts: {
         userId?: string | null;
         threadId?: string;
-        usageHandler?: UsageHandler;
     }, 
     /**
-     * The arguments to the streamObject function, similar to the ai `streamObject` function.
+     * The arguments to the streamObject function, similar to the ai sdk's
+     * {@link streamObject} function, along with Agent prompt options.
      */
-    args: OurStreamObjectArgs<T>, 
+    streamObjectArgs: AgentPrompt & StreamObjectArgs<SCHEMA, OUTPUT, RESULT>, 
     /**
      * The {@link ContextOptions} and {@link StorageOptions}
      * options to use for fetching contextual messages and saving input/output messages.
      */
-    options?: Options): Promise<StreamObjectResult<DeepPartial<T>, T, never> & GenerationOutputMetadata>;
+    options?: Options): Promise<ReturnType<typeof streamObject<SCHEMA, OUTPUT, RESULT>> & GenerationOutputMetadata>;
     /**
      * Save a message to the thread.
      * @param ctx A ctx object from a mutation or action.
@@ -403,7 +344,7 @@ CustomCtx extends object = object, AgentTools extends ToolSet = any> {
      * You can pass extra metadata alongside the message, e.g. associated fileIds.
      * @returns The messageId of the saved message.
      */
-    saveMessage(ctx: RunMutationCtx, args: SaveMessageArgs & {
+    saveMessage(ctx: MutationCtx | ActionCtx, args: SaveMessageArgs & {
         /**
          * If true, it will not generate embeddings for the message.
          * Useful if you're saving messages in a mutation where you can't run `fetch`.
@@ -414,8 +355,8 @@ CustomCtx extends object = object, AgentTools extends ToolSet = any> {
     }): Promise<{
         messageId: string;
         message: {
-            id?: string | undefined;
             userId?: string | undefined;
+            id?: string | undefined;
             embeddingId?: string | undefined;
             fileIds?: string[] | undefined;
             error?: string | undefined;
@@ -428,18 +369,22 @@ CustomCtx extends object = object, AgentTools extends ToolSet = any> {
                 role: "user";
                 content: string | ({
                     providerOptions?: Record<string, Record<string, any>> | undefined;
+                    providerMetadata?: Record<string, Record<string, any>> | undefined;
                     type: "text";
                     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;
                 })[];
             } | {
@@ -447,39 +392,221 @@ CustomCtx extends object = object, AgentTools extends ToolSet = any> {
                 role: "assistant";
                 content: string | ({
                     providerOptions?: Record<string, Record<string, any>> | undefined;
+                    providerMetadata?: Record<string, Record<string, any>> | undefined;
                     type: "text";
                     text: string;
                 } | {
                     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;
+                    providerMetadata?: Record<string, Record<string, any>> | undefined;
                     signature?: string | undefined;
-                    state?: "streaming" | "done" | undefined;
                     type: "reasoning";
                     text: string;
                 } | {
                     providerOptions?: Record<string, Record<string, any>> | undefined;
+                    providerMetadata?: Record<string, Record<string, any>> | undefined;
                     type: "redacted-reasoning";
                     data: string;
                 } | {
                     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;
                     toolName: string;
                     args: any;
+                } | {
+                    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;
+                    isError?: boolean | undefined;
+                    experimental_content?: ({
+                        type: "text";
+                        text: string;
+                    } | {
+                        mimeType?: string | undefined;
+                        type: "image";
+                        data: string;
+                    })[] | undefined;
+                    type: "tool-result";
+                    toolCallId: string;
+                    toolName: string;
+                } | {
+                    providerOptions?: Record<string, Record<string, any>> | undefined;
+                    providerMetadata?: Record<string, Record<string, any>> | undefined;
+                    title?: string | undefined;
+                    type: "source";
+                    id: string;
+                    url: string;
+                    sourceType: "url";
+                } | {
+                    providerOptions?: Record<string, Record<string, any>> | undefined;
+                    providerMetadata?: Record<string, Record<string, any>> | undefined;
+                    filename?: string | undefined;
+                    type: "source";
+                    id: string;
+                    mediaType: string;
+                    sourceType: "document";
+                    title: string;
+                } | {
+                    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;
                     isError?: boolean | undefined;
                     experimental_content?: ({
                         type: "text";
@@ -492,14 +619,22 @@ CustomCtx extends object = object, AgentTools extends ToolSet = any> {
                     type: "tool-result";
                     toolCallId: string;
                     toolName: string;
-                    result: any;
-                }[];
+                } | {
+                    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";
                 content: string;
             } | undefined;
             text?: string | undefined;
+            providerMetadata?: Record<string, Record<string, any>> | undefined;
             reasoning?: string | undefined;
             usage?: {
                 reasoningTokens?: number | undefined;
@@ -508,36 +643,23 @@ CustomCtx extends object = object, AgentTools extends ToolSet = any> {
                 completionTokens: number;
                 totalTokens: number;
             } | undefined;
-            providerMetadata?: Record<string, Record<string, any>> | undefined;
             sources?: ({
-                title?: string | undefined;
                 type?: "source" | undefined;
                 providerOptions?: Record<string, Record<string, any>> | undefined;
-                url?: string | undefined;
+                providerMetadata?: Record<string, Record<string, any>> | undefined;
+                title?: string | undefined;
                 id: string;
+                url: string;
                 sourceType: "url";
             } | {
-                filename?: string | undefined;
+                providerOptions?: Record<string, Record<string, any>> | undefined;
                 providerMetadata?: Record<string, Record<string, any>> | undefined;
-                id: string;
-                title: string;
+                filename?: string | undefined;
                 type: "source";
-                sourceType: "document";
+                id: string;
                 mediaType: string;
-            })[] | undefined;
-            reasoningDetails?: ({
-                providerOptions?: Record<string, Record<string, any>> | undefined;
-                signature?: string | undefined;
-                state?: "streaming" | "done" | undefined;
-                type: "reasoning";
-                text: string;
-            } | {
-                signature?: string | undefined;
-                type: "text";
-                text: string;
-            } | {
-                type: "redacted";
-                data: string;
+                sourceType: "document";
+                title: string;
             })[] | undefined;
             warnings?: ({
                 details?: string | undefined;
@@ -552,12 +674,26 @@ CustomCtx extends object = object, AgentTools extends ToolSet = any> {
                 message: string;
             })[] | undefined;
             finishReason?: "length" | "error" | "other" | "stop" | "content-filter" | "tool-calls" | "unknown" | undefined;
+            reasoningDetails?: ({
+                providerOptions?: Record<string, Record<string, any>> | undefined;
+                providerMetadata?: Record<string, Record<string, any>> | undefined;
+                signature?: string | undefined;
+                type: "reasoning";
+                text: string;
+            } | {
+                signature?: string | undefined;
+                type: "text";
+                text: string;
+            } | {
+                type: "redacted";
+                data: string;
+            })[] | undefined;
             _id: string;
             _creationTime: number;
-            status: "pending" | "success" | "failed";
-            order: number;
             threadId: string;
+            order: number;
             stepOrder: number;
+            status: "pending" | "success" | "failed";
             tool: boolean;
         };
     }>;
@@ -569,7 +705,7 @@ CustomCtx extends object = object, AgentTools extends ToolSet = any> {
      * @param args The messages and context to save
      * @returns
      */
-    saveMessages(ctx: RunMutationCtx | RunActionCtx, args: SaveMessagesArgs & {
+    saveMessages(ctx: MutationCtx | ActionCtx, args: SaveMessagesArgs & {
         /**
          * Skip generating embeddings for the messages. Useful if you're
          * saving messages in a mutation where you can't run `fetch`.
@@ -578,7 +714,6 @@ CustomCtx extends object = object, AgentTools extends ToolSet = any> {
          */
         skipEmbeddings?: boolean;
     }): Promise<{
-        lastMessageId: string;
         messages: MessageDoc[];
     }>;
     /**
@@ -591,7 +726,7 @@ CustomCtx extends object = object, AgentTools extends ToolSet = any> {
      * @param args.statuses What statuses to include. All by default.
      * @returns The MessageDoc's in a format compatible with usePaginatedQuery.
      */
-    listMessages(ctx: RunQueryCtx, args: {
+    listMessages(ctx: QueryCtx | MutationCtx | ActionCtx, args: {
         threadId: string;
         paginationOpts: PaginationOptions;
         excludeToolMessages?: boolean;
@@ -605,7 +740,7 @@ CustomCtx extends object = object, AgentTools extends ToolSet = any> {
      * @param args.streamArgs The stream arguments with per-stream cursors.
      * @returns The deltas for each stream from their existing cursor.
      */
-    syncStreams(ctx: RunQueryCtx, args: {
+    syncStreams(ctx: QueryCtx | MutationCtx | ActionCtx, args: {
         threadId: string;
         streamArgs: StreamArgs | undefined;
         includeStatuses?: ("streaming" | "finished" | "aborted")[];
@@ -618,14 +753,25 @@ CustomCtx extends object = object, AgentTools extends ToolSet = any> {
      * @param args The associated thread, user, message
      * @returns
      */
-    fetchContextMessages(ctx: RunQueryCtx | RunActionCtx, args: {
+    fetchContextMessages(ctx: QueryCtx | MutationCtx | ActionCtx, args: {
         userId: string | undefined;
         threadId: string | undefined;
-        messages: (ModelMessage | Message)[];
         /**
-         * If provided, it will search for messages up to and including this message.
-         * Note: if this is far in the past, text and vector search results may be more
-         * limited, as it's post-filtering the results.
+         * If targetMessageId is not provided, this text will be used
+         * for text and vector search
+         */
+        searchText?: string;
+        /**
+         * If provided, it will use this message for text/vector search (if enabled)
+         * and will only fetch messages up to (and including) this message's "order"
+         */
+        targetMessageId?: string;
+        /**
+         * @deprecated use searchText and targetMessageId instead
+         */
+        messages?: (ModelMessage | Message)[];
+        /**
+         * @deprecated use targetMessageId instead
          */
         upToAndIncludingMessageId?: string;
         contextOptions: ContextOptions | undefined;
@@ -636,7 +782,7 @@ CustomCtx extends object = object, AgentTools extends ToolSet = any> {
      * @param args.threadId The thread to get the metadata for.
      * @returns The metadata for the thread.
      */
-    getThreadMetadata(ctx: RunQueryCtx, args: {
+    getThreadMetadata(ctx: QueryCtx | MutationCtx | ActionCtx, args: {
         threadId: string;
     }): Promise<ThreadDoc>;
     /**
@@ -646,7 +792,7 @@ CustomCtx extends object = object, AgentTools extends ToolSet = any> {
      * @param args.patch The patch to apply to the thread.
      * @returns The updated thread metadata.
      */
-    updateThreadMetadata(ctx: RunMutationCtx, args: {
+    updateThreadMetadata(ctx: MutationCtx | ActionCtx, args: {
         threadId: string;
         patch: Partial<Pick<ThreadDoc, (typeof threadFieldsSupportingPatch)[number]>>;
     }): Promise<ThreadDoc>;
@@ -655,7 +801,7 @@ CustomCtx extends object = object, AgentTools extends ToolSet = any> {
      * @param messages The messages to get the embeddings for.
      * @returns The embeddings for the messages.
      */
-    generateEmbeddings(ctx: RunActionCtx, { userId, threadId, }: {
+    generateEmbeddings(ctx: ActionCtx, args: {
         userId: string | undefined;
         threadId: string | undefined;
     }, messages: (ModelMessage | Message)[]): Promise<{
@@ -670,10 +816,56 @@ CustomCtx extends object = object, AgentTools extends ToolSet = any> {
      * @param ctx The ctx parameter to an action.
      * @param args The messageIds to generate embeddings for.
      */
-    generateAndSaveEmbeddings(ctx: RunActionCtx, args: {
+    generateAndSaveEmbeddings(ctx: ActionCtx, args: {
         messageIds: string[];
     }): Promise<void>;
-    _generateAndSaveEmbeddings(ctx: RunActionCtx, messages: MessageDoc[]): Promise<void>;
+    /**
+     * Approve a tool call that requires human approval.
+     * Saves a `tool-approval-response` message to the thread.
+     * After calling this, call `agent.streamText` or `agent.generateText`
+     * with `promptMessageId` set to the returned `messageId` to continue
+     * generation — the AI SDK will automatically execute the approved tool.
+     *
+     * The approval response is attached to the same generation order as the
+     * original approval request, preserving tool_call/tool_result adjacency in
+     * the continuation context even if newer thread messages exist.
+     *
+     * @param ctx A ctx object from a mutation.
+     * @param args.threadId The thread containing the tool call.
+     * @param args.approvalId The approval ID from the tool-approval-request part.
+     * @param args.reason Optional reason for approval.
+     * @returns The messageId of the saved approval response message.
+     */
+    approveToolCall(ctx: MutationCtx, args: {
+        threadId: string;
+        approvalId: string;
+        reason?: string;
+    }): Promise<{
+        messageId: string;
+    }>;
+    /**
+     * Deny a tool call that requires human approval.
+     * Saves a `tool-approval-response` message to the thread.
+     * After calling this, call `agent.streamText` or `agent.generateText`
+     * with `promptMessageId` set to the returned `messageId` to continue
+     * generation — the AI SDK will automatically create an `execution-denied`
+     * result and let the model respond accordingly.
+     *
+     * @param ctx A ctx object from a mutation.
+     * @param args.threadId The thread containing the tool call.
+     * @param args.approvalId The approval ID from the tool-approval-request part.
+     * @param args.reason Optional reason for denial.
+     * @returns The messageId of the saved denial response message.
+     */
+    denyToolCall(ctx: MutationCtx, args: {
+        threadId: string;
+        approvalId: string;
+        reason?: string;
+    }): Promise<{
+        messageId: string;
+    }>;
+    private respondToToolCallApproval;
+    private getApprovalRequestMessageId;
     /**
      * Explicitly save a "step" created by the AI SDK.
      * @param ctx The ctx argument to a mutation or action.
@@ -702,7 +894,6 @@ CustomCtx extends object = object, AgentTools extends ToolSet = any> {
         provider?: string;
     }): Promise<{
         messages: MessageDoc[];
-        pending?: MessageDoc;
     }>;
     /**
      * Manually save the result of a generateObject call to the thread.
@@ -719,7 +910,9 @@ CustomCtx extends object = object, AgentTools extends ToolSet = any> {
         provider: string | undefined;
         result: GenerateObjectResult<unknown>;
         metadata?: Omit<MessageWithMetadata, "message">;
-    }): Promise<void>;
+    }): Promise<{
+        messages: MessageDoc[];
+    }>;
     /**
      * Commit or rollback a message that was pending.
      * This is done automatically when saving messages by default.
@@ -728,14 +921,13 @@ CustomCtx extends object = object, AgentTools extends ToolSet = any> {
      * @param args What message to save. Generally the parent message sent into
      *   the generateText call.
      */
-    completeMessage(ctx: RunMutationCtx, args: {
-        threadId: string;
+    finalizeMessage(ctx: MutationCtx | ActionCtx, args: {
         messageId: string;
         result: {
-            kind: "error";
+            status: "failed";
             error: string;
         } | {
-            kind: "success";
+            status: "success";
         };
     }): Promise<void>;
     /**
@@ -743,14 +935,12 @@ CustomCtx extends object = object, AgentTools extends ToolSet = any> {
      * @param ctx The ctx argument to your mutation or action.
      * @param args The message fields to update.
      */
-    updateMessage(ctx: RunMutationCtx, args: {
+    updateMessage(ctx: MutationCtx | ActionCtx, args: {
         /** The id of the message to update. */
         messageId: string;
         patch: {
             /** The message to replace the existing message. */
-            message: (ModelMessage & {
-                id?: string;
-            }) | Message;
+            message: ModelMessage | Message;
             /** The status to set on the message. */
             status: "success" | "error";
             /** The error message to set on the message. */
@@ -774,7 +964,7 @@ CustomCtx extends object = object, AgentTools extends ToolSet = any> {
      * @param ctx The ctx argument to your mutation or action.
      * @param args The ids of the messages to delete.
      */
-    deleteMessages(ctx: RunMutationCtx, args: {
+    deleteMessages(ctx: MutationCtx | ActionCtx, args: {
         messageIds: string[];
     }): Promise<void>;
     /**
@@ -783,7 +973,7 @@ CustomCtx extends object = object, AgentTools extends ToolSet = any> {
      * @param ctx The ctx argument to your mutation or action.
      * @param args The id of the message to delete.
      */
-    deleteMessage(ctx: RunMutationCtx, args: {
+    deleteMessage(ctx: MutationCtx | ActionCtx, args: {
         messageId: string;
     }): Promise<void>;
     /**
@@ -823,7 +1013,7 @@ CustomCtx extends object = object, AgentTools extends ToolSet = any> {
      * @param ctx The ctx argument to your mutation or action.
      * @param args The range of messages to delete.
      */
-    deleteMessageRange(ctx: RunMutationCtx, args: {
+    deleteMessageRange(ctx: MutationCtx | ActionCtx, args: {
         threadId: string;
         startOrder: number;
         startStepOrder?: number;
@@ -841,7 +1031,7 @@ CustomCtx extends object = object, AgentTools extends ToolSet = any> {
      * @param ctx The ctx argument to your mutation or action.
      * @param args The id of the thread to delete and optionally the page size to use for the delete.
      */
-    deleteThreadAsync(ctx: RunMutationCtx, args: {
+    deleteThreadAsync(ctx: MutationCtx | ActionCtx, args: {
         threadId: string;
         pageSize?: number;
     }): Promise<void>;
@@ -852,53 +1042,10 @@ CustomCtx extends object = object, AgentTools extends ToolSet = any> {
      * @param ctx The ctx argument to your action.
      * @param args The id of the thread to delete and optionally the page size to use for the delete.
      */
-    deleteThreadSync(ctx: RunActionCtx, args: {
+    deleteThreadSync(ctx: ActionCtx, args: {
         threadId: string;
         pageSize?: number;
     }): Promise<void>;
-    _saveMessagesAndFetchContext<T extends {
-        id?: string;
-        prompt?: string | (ModelMessage | Message)[];
-        messages?: (ModelMessage | Message)[];
-        system?: string;
-        promptMessageId?: string;
-        model?: LanguageModelV2;
-        maxRetries?: number;
-    }>(ctx: RunActionCtx, args: T, { userId: argsUserId, threadId, contextOptions, storageOptions, }: {
-        userId: string | undefined;
-        threadId: string | undefined;
-    } & Options): Promise<{
-        args: T & {
-            model: LanguageModelV2;
-        };
-        userId: string | undefined;
-        messageId: string | undefined;
-        order: number | undefined;
-        stepOrder: number | undefined;
-    }>;
-    doEmbed(ctx: RunActionCtx, options: {
-        userId: string | undefined;
-        threadId: string | undefined;
-        values: string[];
-        abortSignal?: AbortSignal;
-        headers?: Record<string, string>;
-    }): Promise<{
-        embeddings: number[][];
-    }>;
-    /**
-     * Process messages to inline file and image URLs that point to localhost
-     * by converting them to base64. This solves the problem of LLMs not being
-     * able to access localhost URLs.
-     */
-    private _inlineMessagesFiles;
-    /**
-     * Check if a URL points to localhost
-     */
-    private _isLocalhostUrl;
-    /**
-     * Download a file from a URL
-     */
-    private _downloadFile;
     /**
      * WORKFLOW UTILITIES
      */
@@ -933,23 +1080,7 @@ CustomCtx extends object = object, AgentTools extends ToolSet = any> {
      * @param spec Configuration for the agent acting as an action, including
      *   {@link ContextOptions}, {@link StorageOptions}, and {@link stopWhen}.
      */
-    asTextAction<DataModel extends GenericDataModel>(spec?: {
-        /**
-         * When to stop generating text.
-         * Defaults to the {@link Agent["options"].stopWhen} option.
-         */
-        stopWhen?: StopCondition<AgentTools> | Array<StopCondition<AgentTools>>;
-        /**
-         * The {@link ContextOptions} to use for fetching contextual messages and
-         * saving input/output messages.
-         * Defaults to the {@link Agent.contextOptions} option.
-         */
-        contextOptions?: ContextOptions;
-        /**
-         * The {@link StorageOptions} to use for saving input/output messages.
-         * Defaults to the {@link Agent.storageOptions} option.
-         */
-        storageOptions?: StorageOptions;
+    asTextAction<DataModel extends GenericDataModel>(spec: MaybeCustomCtx<CustomCtx, DataModel, AgentTools> & {
         /**
          * Whether to stream the text.
          * If false, it will generate the text in a single call. (default)
@@ -958,51 +1089,38 @@ CustomCtx extends object = object, AgentTools extends ToolSet = any> {
          * defaults if you pass true.
          */
         stream?: boolean | StreamingOptions;
-    } & (CustomCtx extends Record<string, unknown> ? {
         /**
-         * If you have a custom ctx that you use with the Agent
-         * (e.g. new Agent<{ orgId: string }>(...))
-         * you need to provide this function to add any extra fields.
-         * e.g.
-         * ```ts
-         * const myAgent = new Agent<{ orgId: string }>(...);
-         * const myAction = myAgent.asTextAction({
-         *   customCtx: (ctx: ActionCtx, target, llmArgs) => {
-         *     const orgId = await lookupOrgId(ctx, target.threadId);
-         *     return { orgId };
-         *   },
-         * });
-         * ```
-         * Then, in your tools, you can
+         * When to stop generating text.
+         * Defaults to the {@link Agent["options"].stopWhen} option.
          */
-        customCtx: (ctx: GenericActionCtx<DataModel>, target: {
-            userId?: string | undefined;
-            threadId?: string | undefined;
-        }, llmArgs: TextArgs<AgentTools>) => CustomCtx;
-    } : {
-        customCtx?: never;
-    })): import("convex/server").RegisteredAction<"internal", {
+        stopWhen?: StopCondition<AgentTools> | Array<StopCondition<AgentTools>>;
+    } & Options, overrides?: CallSettings): import("convex/server").RegisteredAction<"internal", {
         userId?: string | undefined;
         threadId?: string | undefined;
         providerOptions?: Record<string, Record<string, any>> | undefined;
         system?: string | undefined;
+        prompt?: string | undefined;
         messages?: ({
             providerOptions?: Record<string, Record<string, any>> | undefined;
             role: "user";
             content: string | ({
                 providerOptions?: Record<string, Record<string, any>> | undefined;
+                providerMetadata?: Record<string, Record<string, any>> | undefined;
                 type: "text";
                 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;
             })[];
         } | {
@@ -1010,82 +1128,270 @@ CustomCtx extends object = object, AgentTools extends ToolSet = any> {
             role: "assistant";
             content: string | ({
                 providerOptions?: Record<string, Record<string, any>> | undefined;
+                providerMetadata?: Record<string, Record<string, any>> | undefined;
                 type: "text";
                 text: string;
             } | {
                 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;
+                providerMetadata?: Record<string, Record<string, any>> | undefined;
                 signature?: string | undefined;
-                state?: "streaming" | "done" | undefined;
                 type: "reasoning";
                 text: string;
             } | {
                 providerOptions?: Record<string, Record<string, any>> | undefined;
+                providerMetadata?: Record<string, Record<string, any>> | undefined;
                 type: "redacted-reasoning";
                 data: string;
             } | {
                 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;
                 toolName: string;
                 args: any;
-            })[];
-        } | {
-            providerOptions?: Record<string, Record<string, any>> | undefined;
-            role: "tool";
-            content: {
+            } | {
                 providerOptions?: Record<string, Record<string, any>> | undefined;
+                providerMetadata?: Record<string, Record<string, any>> | undefined;
                 args?: any;
                 providerExecuted?: boolean | undefined;
-                isError?: boolean | undefined;
-                experimental_content?: ({
+                output?: {
+                    providerOptions?: Record<string, Record<string, any>> | undefined;
                     type: "text";
-                    text: string;
+                    value: string;
                 } | {
-                    mimeType?: string | undefined;
-                    type: "image";
-                    data: string;
-                })[] | undefined;
-                type: "tool-result";
-                toolCallId: string;
-                toolName: string;
-                result: any;
-            }[];
-        } | {
+                    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;
+                isError?: boolean | undefined;
+                experimental_content?: ({
+                    type: "text";
+                    text: string;
+                } | {
+                    mimeType?: string | undefined;
+                    type: "image";
+                    data: string;
+                })[] | undefined;
+                type: "tool-result";
+                toolCallId: string;
+                toolName: string;
+            } | {
+                providerOptions?: Record<string, Record<string, any>> | undefined;
+                providerMetadata?: Record<string, Record<string, any>> | undefined;
+                title?: string | undefined;
+                type: "source";
+                id: string;
+                url: string;
+                sourceType: "url";
+            } | {
+                providerOptions?: Record<string, Record<string, any>> | undefined;
+                providerMetadata?: Record<string, Record<string, any>> | undefined;
+                filename?: string | undefined;
+                type: "source";
+                id: string;
+                mediaType: string;
+                sourceType: "document";
+                title: string;
+            } | {
+                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: ({
+                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;
+                isError?: boolean | undefined;
+                experimental_content?: ({
+                    type: "text";
+                    text: string;
+                } | {
+                    mimeType?: string | undefined;
+                    type: "image";
+                    data: string;
+                })[] | undefined;
+                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";
             content: string;
         })[] | undefined;
-        headers?: Record<string, string> | undefined;
-        maxTokens?: number | undefined;
-        temperature?: number | undefined;
-        topP?: number | undefined;
-        topK?: number | undefined;
-        presencePenalty?: number | undefined;
-        frequencyPenalty?: number | undefined;
-        seed?: number | undefined;
-        maxRetries?: number | undefined;
-        stream?: boolean | undefined;
-        toolChoice?: "required" | "none" | "auto" | {
+        toolChoice?: "none" | "required" | "auto" | {
             type: "tool";
             toolName: string;
         } | undefined;
-        maxSteps?: number | undefined;
-        experimental_continueSteps?: boolean | undefined;
-        prompt?: string | undefined;
         promptMessageId?: string | undefined;
+        callSettings?: {
+            maxOutputTokens?: number | undefined;
+            temperature?: number | undefined;
+            topP?: number | undefined;
+            topK?: number | undefined;
+            presencePenalty?: number | undefined;
+            frequencyPenalty?: number | undefined;
+            stopSequences?: string[] | undefined;
+            seed?: number | undefined;
+            maxRetries?: number | undefined;
+            headers?: Record<string, string> | undefined;
+        } | undefined;
         contextOptions?: {
             excludeToolMessages?: boolean | undefined;
             recentMessages?: number | undefined;
             searchOptions?: {
-                textSearch?: boolean | undefined;
                 vectorSearch?: boolean | undefined;
+                textSearch?: boolean | undefined;
                 vectorScoreThreshold?: number | undefined;
                 messageRange?: {
                     before: number;
@@ -1098,18 +1404,16 @@ CustomCtx extends object = object, AgentTools extends ToolSet = any> {
         storageOptions?: {
             saveMessages?: "all" | "none" | "promptAndOutput" | undefined;
         } | undefined;
+        maxSteps?: number | undefined;
+        stream?: boolean | undefined;
+        experimental_continueSteps?: boolean | undefined;
     }, Promise<{
         text: string;
-        messageId: string | undefined;
-        order: number | undefined;
-        finishReason: import("@ai-sdk/provider").LanguageModelV2FinishReason;
-        warnings: Promise<import("@ai-sdk/provider").LanguageModelV2CallWarning[] | undefined>;
-    } | {
-        text: string;
-        messageId: string | undefined;
+        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[];
     }>>;
     /**
      * Create an action that generates an object out of this agent so you can call
@@ -1118,31 +1422,33 @@ CustomCtx extends object = object, AgentTools extends ToolSet = any> {
      * the normal parameters to {@link generateObject}, plus {@link ContextOptions}
      * and stopWhen.
      */
-    asObjectAction<T>(spec: OurObjectArgs<T>, options?: {
-        contextOptions?: ContextOptions;
-        storageOptions?: StorageOptions;
-    }): import("convex/server").RegisteredAction<"internal", {
+    asObjectAction<T, DataModel extends GenericDataModel>(objectArgs: GenerateObjectArgs<FlexibleSchema<T>> & Partial<AgentPrompt>, options?: Options & MaybeCustomCtx<CustomCtx, DataModel, AgentTools>): import("convex/server").RegisteredAction<"internal", {
         userId?: string | undefined;
         threadId?: string | undefined;
         providerOptions?: Record<string, Record<string, any>> | undefined;
         system?: string | undefined;
+        prompt?: string | undefined;
         messages?: ({
             providerOptions?: Record<string, Record<string, any>> | undefined;
             role: "user";
             content: string | ({
                 providerOptions?: Record<string, Record<string, any>> | undefined;
+                providerMetadata?: Record<string, Record<string, any>> | undefined;
                 type: "text";
                 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;
             })[];
         } | {
@@ -1150,39 +1456,221 @@ CustomCtx extends object = object, AgentTools extends ToolSet = any> {
             role: "assistant";
             content: string | ({
                 providerOptions?: Record<string, Record<string, any>> | undefined;
+                providerMetadata?: Record<string, Record<string, any>> | undefined;
                 type: "text";
                 text: string;
             } | {
                 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;
+                providerMetadata?: Record<string, Record<string, any>> | undefined;
                 signature?: string | undefined;
-                state?: "streaming" | "done" | undefined;
                 type: "reasoning";
                 text: string;
             } | {
                 providerOptions?: Record<string, Record<string, any>> | undefined;
+                providerMetadata?: Record<string, Record<string, any>> | undefined;
                 type: "redacted-reasoning";
                 data: string;
             } | {
                 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;
                 toolName: string;
                 args: any;
+            } | {
+                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;
+                isError?: boolean | undefined;
+                experimental_content?: ({
+                    type: "text";
+                    text: string;
+                } | {
+                    mimeType?: string | undefined;
+                    type: "image";
+                    data: string;
+                })[] | undefined;
+                type: "tool-result";
+                toolCallId: string;
+                toolName: string;
+            } | {
+                providerOptions?: Record<string, Record<string, any>> | undefined;
+                providerMetadata?: Record<string, Record<string, any>> | undefined;
+                title?: string | undefined;
+                type: "source";
+                id: string;
+                url: string;
+                sourceType: "url";
+            } | {
+                providerOptions?: Record<string, Record<string, any>> | undefined;
+                providerMetadata?: Record<string, Record<string, any>> | undefined;
+                filename?: string | undefined;
+                type: "source";
+                id: string;
+                mediaType: string;
+                sourceType: "document";
+                title: string;
+            } | {
+                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;
                 isError?: boolean | undefined;
                 experimental_content?: ({
                     type: "text";
@@ -1195,30 +1683,39 @@ CustomCtx extends object = object, AgentTools extends ToolSet = any> {
                 type: "tool-result";
                 toolCallId: string;
                 toolName: string;
-                result: any;
-            }[];
+            } | {
+                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";
             content: string;
         })[] | undefined;
-        headers?: Record<string, string> | undefined;
-        maxTokens?: number | undefined;
-        temperature?: number | undefined;
-        topP?: number | undefined;
-        topK?: number | undefined;
-        presencePenalty?: number | undefined;
-        frequencyPenalty?: number | undefined;
-        seed?: number | undefined;
-        maxRetries?: number | undefined;
-        prompt?: string | undefined;
         promptMessageId?: string | undefined;
+        callSettings?: {
+            maxOutputTokens?: number | undefined;
+            temperature?: number | undefined;
+            topP?: number | undefined;
+            topK?: number | undefined;
+            presencePenalty?: number | undefined;
+            frequencyPenalty?: number | undefined;
+            stopSequences?: string[] | undefined;
+            seed?: number | undefined;
+            maxRetries?: number | undefined;
+            headers?: Record<string, string> | undefined;
+        } | undefined;
         contextOptions?: {
             excludeToolMessages?: boolean | undefined;
             recentMessages?: number | undefined;
             searchOptions?: {
-                textSearch?: boolean | undefined;
                 vectorSearch?: boolean | undefined;
+                textSearch?: boolean | undefined;
                 vectorScoreThreshold?: number | undefined;
                 messageRange?: {
                     before: number;
@@ -1233,44 +1730,32 @@ CustomCtx extends object = object, AgentTools extends ToolSet = any> {
         } | undefined;
     }, Promise<{
         object: T;
-        messageId: string | undefined;
+        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[];
     }>>;
     /**
-     * Save messages to the thread.
-     * Useful as a step in Workflows, e.g.
-     * ```ts
-     * const saveMessages = agent.asSaveMessagesMutation();
-     *
-     * const myWorkflow = workflow.define({
-     *   args: {...},
-     *   handler: async (step, args) => {
-     *     // do things to create (but not save)messages
-     *     const { messageIds } = await step.runMutation(internal.foo.saveMessages, {
-     *       threadId: args.threadId,
-     *       messages: args.messages,
-     *     });
-     *     // ...
-     *   },
-     * })
-     * ```
-     * @returns A mutation that can be used to save messages to the thread.
+     * @deprecated Use {@link saveMessages} directly instead.
      */
     asSaveMessagesMutation(): import("convex/server").RegisteredMutation<"internal", {
         userId?: string | undefined;
-        pending?: boolean | undefined;
         promptMessageId?: string | undefined;
+        embeddings?: {
+            model: string;
+            vectors: (number[] | null)[];
+        } | undefined;
         failPendingSteps?: boolean | undefined;
         threadId: string;
         messages: {
-            id?: string | undefined;
             fileIds?: string[] | undefined;
             error?: string | undefined;
+            status?: "pending" | "success" | "failed" | undefined;
             model?: string | undefined;
             provider?: string | undefined;
             text?: string | undefined;
+            providerMetadata?: Record<string, Record<string, any>> | undefined;
             reasoning?: string | undefined;
             usage?: {
                 reasoningTokens?: number | undefined;
@@ -1279,36 +1764,23 @@ CustomCtx extends object = object, AgentTools extends ToolSet = any> {
                 completionTokens: number;
                 totalTokens: number;
             } | undefined;
-            providerMetadata?: Record<string, Record<string, any>> | undefined;
             sources?: ({
-                title?: string | undefined;
                 type?: "source" | undefined;
                 providerOptions?: Record<string, Record<string, any>> | undefined;
-                url?: string | undefined;
+                providerMetadata?: Record<string, Record<string, any>> | undefined;
+                title?: string | undefined;
                 id: string;
+                url: string;
                 sourceType: "url";
             } | {
-                filename?: string | undefined;
+                providerOptions?: Record<string, Record<string, any>> | undefined;
                 providerMetadata?: Record<string, Record<string, any>> | undefined;
-                id: string;
-                title: string;
+                filename?: string | undefined;
                 type: "source";
-                sourceType: "document";
+                id: string;
                 mediaType: string;
-            })[] | undefined;
-            reasoningDetails?: ({
-                providerOptions?: Record<string, Record<string, any>> | undefined;
-                signature?: string | undefined;
-                state?: "streaming" | "done" | undefined;
-                type: "reasoning";
-                text: string;
-            } | {
-                signature?: string | undefined;
-                type: "text";
-                text: string;
-            } | {
-                type: "redacted";
-                data: string;
+                sourceType: "document";
+                title: string;
             })[] | undefined;
             warnings?: ({
                 details?: string | undefined;
@@ -1323,23 +1795,41 @@ CustomCtx extends object = object, AgentTools extends ToolSet = any> {
                 message: string;
             })[] | undefined;
             finishReason?: "length" | "error" | "other" | "stop" | "content-filter" | "tool-calls" | "unknown" | undefined;
+            reasoningDetails?: ({
+                providerOptions?: Record<string, Record<string, any>> | undefined;
+                providerMetadata?: Record<string, Record<string, any>> | undefined;
+                signature?: string | undefined;
+                type: "reasoning";
+                text: string;
+            } | {
+                signature?: string | undefined;
+                type: "text";
+                text: string;
+            } | {
+                type: "redacted";
+                data: string;
+            })[] | undefined;
             message: {
                 providerOptions?: Record<string, Record<string, any>> | undefined;
                 role: "user";
                 content: string | ({
                     providerOptions?: Record<string, Record<string, any>> | undefined;
+                    providerMetadata?: Record<string, Record<string, any>> | undefined;
                     type: "text";
                     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;
                 })[];
             } | {
@@ -1347,39 +1837,221 @@ CustomCtx extends object = object, AgentTools extends ToolSet = any> {
                 role: "assistant";
                 content: string | ({
                     providerOptions?: Record<string, Record<string, any>> | undefined;
+                    providerMetadata?: Record<string, Record<string, any>> | undefined;
                     type: "text";
                     text: string;
                 } | {
                     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;
+                    providerMetadata?: Record<string, Record<string, any>> | undefined;
                     signature?: string | undefined;
-                    state?: "streaming" | "done" | undefined;
                     type: "reasoning";
                     text: string;
                 } | {
                     providerOptions?: Record<string, Record<string, any>> | undefined;
+                    providerMetadata?: Record<string, Record<string, any>> | undefined;
                     type: "redacted-reasoning";
                     data: string;
                 } | {
                     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;
                     toolName: string;
                     args: any;
+                } | {
+                    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;
+                    isError?: boolean | undefined;
+                    experimental_content?: ({
+                        type: "text";
+                        text: string;
+                    } | {
+                        mimeType?: string | undefined;
+                        type: "image";
+                        data: string;
+                    })[] | undefined;
+                    type: "tool-result";
+                    toolCallId: string;
+                    toolName: string;
+                } | {
+                    providerOptions?: Record<string, Record<string, any>> | undefined;
+                    providerMetadata?: Record<string, Record<string, any>> | undefined;
+                    title?: string | undefined;
+                    type: "source";
+                    id: string;
+                    url: string;
+                    sourceType: "url";
+                } | {
+                    providerOptions?: Record<string, Record<string, any>> | undefined;
+                    providerMetadata?: Record<string, Record<string, any>> | undefined;
+                    filename?: string | undefined;
+                    type: "source";
+                    id: string;
+                    mediaType: string;
+                    sourceType: "document";
+                    title: string;
+                } | {
+                    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;
                     isError?: boolean | undefined;
                     experimental_content?: ({
                         type: "text";
@@ -1392,8 +2064,15 @@ CustomCtx extends object = object, AgentTools extends ToolSet = any> {
                     type: "tool-result";
                     toolCallId: string;
                     toolName: string;
-                    result: any;
-                }[];
+                } | {
+                    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";
@@ -1402,552 +2081,11 @@ CustomCtx extends object = object, AgentTools extends ToolSet = any> {
         }[];
     }, Promise<{
         lastMessageId: string;
-        messageIds: string[];
+        messages: {
+            _id: string;
+            order: number;
+            stepOrder: number;
+        }[];
     }>>;
 }
-/**
- * Create a thread to store messages with an Agent.
- * @param ctx The context from a mutation or action.
- * @param component The Agent component, usually `components.agent`.
- * @param args The associated thread metadata.
- * @returns The id of the created thread.
- */
-export declare function createThread(ctx: RunMutationCtx, component: AgentComponent, args?: {
-    userId?: string | null;
-    title?: string;
-    summary?: string;
-}): Promise<string>;
-/**
- * Get the metadata for a thread.
- * @param ctx A ctx object from a query, mutation, or action.
- * @param args.threadId The thread to get the metadata for.
- * @returns The metadata for the thread.
- */
-export declare function getThreadMetadata(ctx: RunQueryCtx, component: AgentComponent, args: {
-    threadId: string;
-}): Promise<ThreadDoc>;
-type SaveMessagesArgs = {
-    threadId: string;
-    userId?: string | null;
-    /**
-     * The message that these messages are in response to. They will be
-     * the same "order" as this message, at increasing stepOrder(s).
-     */
-    promptMessageId?: string;
-    /**
-     * The messages to save.
-     */
-    messages: ((ModelMessage & {
-        id?: string | undefined;
-    }) | Message)[];
-    /**
-     * Metadata to save with the messages. Each element corresponds to the
-     * message at the same index.
-     */
-    metadata?: Omit<MessageWithMetadata, "message">[];
-    /**
-     * If false, it will "commit" the messages immediately.
-     * If true, it will mark them as pending until the final step has finished.
-     * Defaults to false.
-     */
-    pending?: boolean;
-    /**
-     * If true, it will fail any pending steps.
-     * Defaults to false.
-     */
-    failPendingSteps?: boolean;
-    /**
-     * The embeddings to save with the messages.
-     */
-    embeddings?: Omit<MessageEmbeddings, "dimension">;
-};
-/**
- * Explicitly save messages associated with the thread (& user if provided)
- */
-export declare function saveMessages(ctx: RunMutationCtx, component: AgentComponent, args: SaveMessagesArgs & {
-    /**
-     * The agent name to associate with the messages.
-     */
-    agentName?: string;
-}): Promise<{
-    lastMessageId: string;
-    messages: {
-        _creationTime: number;
-        _id: string;
-        agentName?: string | undefined;
-        embeddingId?: string | undefined;
-        error?: string | undefined;
-        fileIds?: string[] | undefined;
-        finishReason?: "stop" | "length" | "content-filter" | "tool-calls" | "error" | "other" | "unknown" | undefined;
-        id?: string | undefined;
-        message?: {
-            content: string | ({
-                providerOptions?: {
-                    [x: string]: {
-                        [x: string]: any;
-                    };
-                } | undefined;
-                text: string;
-                type: "text";
-            } | {
-                image: string | ArrayBuffer;
-                mimeType?: string | undefined;
-                providerOptions?: {
-                    [x: string]: {
-                        [x: string]: any;
-                    };
-                } | undefined;
-                type: "image";
-            } | {
-                data: string | ArrayBuffer;
-                filename?: string | undefined;
-                mimeType: string;
-                providerOptions?: {
-                    [x: string]: {
-                        [x: string]: any;
-                    };
-                } | undefined;
-                type: "file";
-            })[];
-            providerOptions?: {
-                [x: string]: {
-                    [x: string]: any;
-                };
-            } | undefined;
-            role: "user";
-        } | {
-            content: string | ({
-                providerOptions?: {
-                    [x: string]: {
-                        [x: string]: any;
-                    };
-                } | undefined;
-                text: string;
-                type: "text";
-            } | {
-                data: string | ArrayBuffer;
-                filename?: string | undefined;
-                mimeType: string;
-                providerOptions?: {
-                    [x: string]: {
-                        [x: string]: any;
-                    };
-                } | undefined;
-                type: "file";
-            } | {
-                providerOptions?: {
-                    [x: string]: {
-                        [x: string]: any;
-                    };
-                } | undefined;
-                signature?: string | undefined;
-                state?: "streaming" | "done" | undefined;
-                text: string;
-                type: "reasoning";
-            } | {
-                data: string;
-                providerOptions?: {
-                    [x: string]: {
-                        [x: string]: any;
-                    };
-                } | undefined;
-                type: "redacted-reasoning";
-            } | {
-                args: any;
-                providerExecuted?: boolean | undefined;
-                providerOptions?: {
-                    [x: string]: {
-                        [x: string]: any;
-                    };
-                } | undefined;
-                toolCallId: string;
-                toolName: string;
-                type: "tool-call";
-            })[];
-            providerOptions?: {
-                [x: string]: {
-                    [x: string]: any;
-                };
-            } | undefined;
-            role: "assistant";
-        } | {
-            content: {
-                args?: any;
-                experimental_content?: ({
-                    text: string;
-                    type: "text";
-                } | {
-                    data: string;
-                    mimeType?: string | undefined;
-                    type: "image";
-                })[] | undefined;
-                isError?: boolean | undefined;
-                providerExecuted?: boolean | undefined;
-                providerOptions?: {
-                    [x: string]: {
-                        [x: string]: any;
-                    };
-                } | undefined;
-                result: any;
-                toolCallId: string;
-                toolName: string;
-                type: "tool-result";
-            }[];
-            providerOptions?: {
-                [x: string]: {
-                    [x: string]: any;
-                };
-            } | undefined;
-            role: "tool";
-        } | {
-            content: string;
-            providerOptions?: {
-                [x: string]: {
-                    [x: string]: any;
-                };
-            } | undefined;
-            role: "system";
-        } | undefined;
-        model?: string | undefined;
-        order: number;
-        provider?: string | undefined;
-        providerMetadata?: {
-            [x: string]: {
-                [x: string]: any;
-            };
-        } | undefined;
-        providerOptions?: {
-            [x: string]: {
-                [x: string]: any;
-            };
-        } | undefined;
-        reasoning?: string | undefined;
-        reasoningDetails?: ({
-            providerOptions?: {
-                [x: string]: {
-                    [x: string]: any;
-                };
-            } | undefined;
-            signature?: string | undefined;
-            state?: "streaming" | "done" | undefined;
-            text: string;
-            type: "reasoning";
-        } | {
-            signature?: string | undefined;
-            text: string;
-            type: "text";
-        } | {
-            data: string;
-            type: "redacted";
-        })[] | undefined;
-        sources?: ({
-            id: string;
-            providerOptions?: {
-                [x: string]: {
-                    [x: string]: any;
-                };
-            } | undefined;
-            sourceType: "url";
-            title?: string | undefined;
-            type?: "source" | undefined;
-            url?: string | undefined;
-        } | {
-            filename?: string | undefined;
-            id: string;
-            mediaType: string;
-            providerMetadata?: {
-                [x: string]: {
-                    [x: string]: any;
-                };
-            } | undefined;
-            sourceType: "document";
-            title: string;
-            type: "source";
-        })[] | undefined;
-        status: "pending" | "success" | "failed";
-        stepOrder: number;
-        text?: string | undefined;
-        threadId: string;
-        tool: boolean;
-        usage?: {
-            cachedInputTokens?: number | undefined;
-            completionTokens: number;
-            promptTokens: number;
-            reasoningTokens?: number | undefined;
-            totalTokens: number;
-        } | undefined;
-        userId?: string | undefined;
-        warnings?: ({
-            details?: string | undefined;
-            setting: string;
-            type: "unsupported-setting";
-        } | {
-            details?: string | undefined;
-            tool: any;
-            type: "unsupported-tool";
-        } | {
-            message: string;
-            type: "other";
-        })[] | undefined;
-    }[];
-}>;
-type SaveMessageArgs = {
-    threadId: string;
-    userId?: string | null;
-    /**
-     * Metadata to save with the messages. Each element corresponds to the
-     * message at the same index.
-     */
-    metadata?: Omit<MessageWithMetadata, "message">;
-    /**
-     * The embedding to save with the message.
-     */
-    embedding?: {
-        vector: number[];
-        model: string;
-    };
-} & ({
-    prompt?: undefined;
-    /**
-     * The message to save.
-     */
-    message: ModelMessage | Message;
-} | {
-    prompt: string;
-    message?: undefined;
-});
-/**
- * Save a message to the thread.
- * @param ctx A ctx object from a mutation or action.
- * @param args The message and what to associate it with (user / thread)
- * You can pass extra metadata alongside the message, e.g. associated fileIds.
- * @returns The messageId of the saved message.
- */
-export declare function saveMessage(ctx: RunMutationCtx, component: AgentComponent, args: SaveMessageArgs & {
-    /**
-     * The agent name to associate with the message.
-     */
-    agentName?: string;
-}): Promise<{
-    messageId: string;
-    message: {
-        _creationTime: number;
-        _id: string;
-        agentName?: string | undefined;
-        embeddingId?: string | undefined;
-        error?: string | undefined;
-        fileIds?: string[] | undefined;
-        finishReason?: "stop" | "length" | "content-filter" | "tool-calls" | "error" | "other" | "unknown" | undefined;
-        id?: string | undefined;
-        message?: {
-            content: string | ({
-                providerOptions?: {
-                    [x: string]: {
-                        [x: string]: any;
-                    };
-                } | undefined;
-                text: string;
-                type: "text";
-            } | {
-                image: string | ArrayBuffer;
-                mimeType?: string | undefined;
-                providerOptions?: {
-                    [x: string]: {
-                        [x: string]: any;
-                    };
-                } | undefined;
-                type: "image";
-            } | {
-                data: string | ArrayBuffer;
-                filename?: string | undefined;
-                mimeType: string;
-                providerOptions?: {
-                    [x: string]: {
-                        [x: string]: any;
-                    };
-                } | undefined;
-                type: "file";
-            })[];
-            providerOptions?: {
-                [x: string]: {
-                    [x: string]: any;
-                };
-            } | undefined;
-            role: "user";
-        } | {
-            content: string | ({
-                providerOptions?: {
-                    [x: string]: {
-                        [x: string]: any;
-                    };
-                } | undefined;
-                text: string;
-                type: "text";
-            } | {
-                data: string | ArrayBuffer;
-                filename?: string | undefined;
-                mimeType: string;
-                providerOptions?: {
-                    [x: string]: {
-                        [x: string]: any;
-                    };
-                } | undefined;
-                type: "file";
-            } | {
-                providerOptions?: {
-                    [x: string]: {
-                        [x: string]: any;
-                    };
-                } | undefined;
-                signature?: string | undefined;
-                state?: "streaming" | "done" | undefined;
-                text: string;
-                type: "reasoning";
-            } | {
-                data: string;
-                providerOptions?: {
-                    [x: string]: {
-                        [x: string]: any;
-                    };
-                } | undefined;
-                type: "redacted-reasoning";
-            } | {
-                args: any;
-                providerExecuted?: boolean | undefined;
-                providerOptions?: {
-                    [x: string]: {
-                        [x: string]: any;
-                    };
-                } | undefined;
-                toolCallId: string;
-                toolName: string;
-                type: "tool-call";
-            })[];
-            providerOptions?: {
-                [x: string]: {
-                    [x: string]: any;
-                };
-            } | undefined;
-            role: "assistant";
-        } | {
-            content: {
-                args?: any;
-                experimental_content?: ({
-                    text: string;
-                    type: "text";
-                } | {
-                    data: string;
-                    mimeType?: string | undefined;
-                    type: "image";
-                })[] | undefined;
-                isError?: boolean | undefined;
-                providerExecuted?: boolean | undefined;
-                providerOptions?: {
-                    [x: string]: {
-                        [x: string]: any;
-                    };
-                } | undefined;
-                result: any;
-                toolCallId: string;
-                toolName: string;
-                type: "tool-result";
-            }[];
-            providerOptions?: {
-                [x: string]: {
-                    [x: string]: any;
-                };
-            } | undefined;
-            role: "tool";
-        } | {
-            content: string;
-            providerOptions?: {
-                [x: string]: {
-                    [x: string]: any;
-                };
-            } | undefined;
-            role: "system";
-        } | undefined;
-        model?: string | undefined;
-        order: number;
-        provider?: string | undefined;
-        providerMetadata?: {
-            [x: string]: {
-                [x: string]: any;
-            };
-        } | undefined;
-        providerOptions?: {
-            [x: string]: {
-                [x: string]: any;
-            };
-        } | undefined;
-        reasoning?: string | undefined;
-        reasoningDetails?: ({
-            providerOptions?: {
-                [x: string]: {
-                    [x: string]: any;
-                };
-            } | undefined;
-            signature?: string | undefined;
-            state?: "streaming" | "done" | undefined;
-            text: string;
-            type: "reasoning";
-        } | {
-            signature?: string | undefined;
-            text: string;
-            type: "text";
-        } | {
-            data: string;
-            type: "redacted";
-        })[] | undefined;
-        sources?: ({
-            id: string;
-            providerOptions?: {
-                [x: string]: {
-                    [x: string]: any;
-                };
-            } | undefined;
-            sourceType: "url";
-            title?: string | undefined;
-            type?: "source" | undefined;
-            url?: string | undefined;
-        } | {
-            filename?: string | undefined;
-            id: string;
-            mediaType: string;
-            providerMetadata?: {
-                [x: string]: {
-                    [x: string]: any;
-                };
-            } | undefined;
-            sourceType: "document";
-            title: string;
-            type: "source";
-        })[] | undefined;
-        status: "pending" | "success" | "failed";
-        stepOrder: number;
-        text?: string | undefined;
-        threadId: string;
-        tool: boolean;
-        usage?: {
-            cachedInputTokens?: number | undefined;
-            completionTokens: number;
-            promptTokens: number;
-            reasoningTokens?: number | undefined;
-            totalTokens: number;
-        } | undefined;
-        userId?: string | undefined;
-        warnings?: ({
-            details?: string | undefined;
-            setting: string;
-            type: "unsupported-setting";
-        } | {
-            details?: string | undefined;
-            tool: any;
-            type: "unsupported-tool";
-        } | {
-            message: string;
-            type: "other";
-        })[] | undefined;
-    };
-}>;
 //# sourceMappingURL=index.d.ts.map