@convex-dev/agent 0.0.17-alpha.0 → 0.1.0-alpha.0

package/dist/commonjs/client/index.d.ts

@@ -1,7 +1,6 @@
 import type { EmbeddingModelV1, LanguageModelV1 } from "@ai-sdk/provider";
 import type { CoreMessage, DeepPartial, GenerateObjectResult, GenerateTextResult, JSONValue, RepairTextFunction, Schema, StepResult, StreamObjectResult, StreamTextResult, TelemetrySettings, Tool, ToolChoice, ToolExecutionOptions, ToolSet, UIMessage } from "ai";
 import { generateObject, generateText, streamObject, streamText } from "ai";
-import { Infer } from "convex/values";
 import { z } from "zod";
 import { Mounts } from "../component/_generated/api.js";
 import { type VectorDimension } from "../component/vector/tables.js";
@@ -9,9 +8,13 @@ import { type AIMessageWithoutId } from "../mapping.js";
 import { extractText, isTool } from "../shared.js";
 import { type CallSettings, type MessageWithMetadata as InnerMessageWithMetadata, type ProviderMetadata, type ProviderOptions, type SearchOptions, type Usage } from "../validators.js";
 import type { OpaqueIds, RunActionCtx, RunMutationCtx, RunQueryCtx, UseApi } from "./types.js";
+import type { MessageDoc, ThreadDoc } from "../component/schema.js";
+export { vMessageDoc, vThreadDoc } from "../component/schema.js";
 export { extractText, isTool };
-export type { Usage, ProviderMetadata };
-export { paginationResultValidator, vContextOptions, vUsage, vProviderMetadata, vUserMessage, vAssistantMessage, vToolMessage, vStorageOptions, vSystemMessage, vMessage, } from "../validators.js";
+export type { Usage, ProviderMetadata, MessageDoc, ThreadDoc };
+export { 
+/** @deprecated Use vPaginationResult instead. */
+paginationResultValidator, paginationResultValidator as vPaginationResult, vContextOptions, vUsage, vProviderMetadata, vUserMessage, vAssistantMessage, vToolMessage, vStorageOptions, vSystemMessage, vMessage, } from "../validators.js";
 /**
  * Options to configure what messages are fetched as context,
  * automatically with thread.generateText, or directly via search.
@@ -242,11 +245,11 @@ export declare class Agent<AgentTools extends ToolSet> {
          */
         userId?: string;
         /**
-         * The title of the thread. Not currently used.
+         * The title of the thread. Not currently used for anything.
          */
         title?: string;
         /**
-         * The summary of the thread. Not currently used.
+         * The summary of the thread. Not currently used for anything.
          */
         summary?: string;
         /**
@@ -279,11 +282,11 @@ export declare class Agent<AgentTools extends ToolSet> {
          */
         userId?: string;
         /**
-         * The title of the thread. Not currently used.
+         * The title of the thread. Not currently used for anything.
          */
         title?: string;
         /**
-         * The summary of the thread. Not currently used.
+         * The summary of the thread. Not currently used for anything.
          */
         summary?: string;
         /**
@@ -343,11 +346,11 @@ export declare class Agent<AgentTools extends ToolSet> {
         threadId: string | undefined;
         messages: CoreMessage[];
         /**
-         * If provided, it will search for messages before this message.
-         * Note: if this is far in the past, the search results may be more
+         * 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.
          */
-        beforeMessageId?: string;
+        upToAndIncludingMessageId?: string;
         contextOptions: ContextOptions | undefined;
     }): Promise<MessageDoc[]>;
     /**
@@ -369,6 +372,14 @@ export declare class Agent<AgentTools extends ToolSet> {
     saveMessages(ctx: RunMutationCtx, args: {
         threadId: string;
         userId?: string;
+        /**
+         * 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: CoreMessageMaybeWithId[];
         /**
          * Metadata to save with the messages. Each element corresponds to the
@@ -390,10 +401,149 @@ export declare class Agent<AgentTools extends ToolSet> {
         lastMessageId: string;
         messageIds: string[];
     }>;
+    /**
+     * Save messages to the thread.
+     * Useful as a step in Workflows, e.g.
+     * ```ts
+     * const saveMessages = agent.asSaveMessagesMutation();
+     *
+     * const myWorkflow = workflow.define()
+     * ```
+     * @returns A mutation that can be used to save messages to the thread.
+     */
+    asSaveMessagesMutation(): import("convex/server").RegisteredMutation<"internal", {
+        userId?: string | undefined;
+        pending?: boolean | undefined;
+        promptMessageId?: string | undefined;
+        failPendingSteps?: boolean | undefined;
+        threadId: string;
+        messages: {
+            id?: string | undefined;
+            error?: string | undefined;
+            model?: string | undefined;
+            provider?: string | undefined;
+            text?: string | undefined;
+            reasoning?: string | undefined;
+            files?: {
+                data?: string | ArrayBuffer | undefined;
+                url?: string | undefined;
+                fileId?: import("convex/values").GenericId<"files"> | undefined;
+                mimeType: string;
+            }[] | undefined;
+            usage?: {
+                promptTokens: number;
+                completionTokens: number;
+                totalTokens: number;
+            } | undefined;
+            providerMetadata?: Record<string, Record<string, any>> | undefined;
+            sources?: {
+                title?: string | undefined;
+                providerOptions?: Record<string, Record<string, any>> | undefined;
+                id: string;
+                url: string;
+                sourceType: "url";
+            }[] | undefined;
+            reasoningDetails?: ({
+                signature?: string | undefined;
+                type: "text";
+                text: string;
+            } | {
+                type: "redacted";
+                data: string;
+            })[] | undefined;
+            warnings?: ({
+                details?: string | undefined;
+                type: "unsupported-setting";
+                setting: string;
+            } | {
+                details?: string | undefined;
+                type: "unsupported-tool";
+                tool: any;
+            } | {
+                type: "other";
+                message: string;
+            })[] | undefined;
+            finishReason?: "length" | "error" | "other" | "stop" | "content-filter" | "tool-calls" | "unknown" | undefined;
+            message: {
+                providerOptions?: Record<string, Record<string, any>> | undefined;
+                role: "user";
+                content: string | ({
+                    providerOptions?: Record<string, Record<string, any>> | undefined;
+                    type: "text";
+                    text: string;
+                } | {
+                    providerOptions?: Record<string, Record<string, any>> | undefined;
+                    mimeType?: string | undefined;
+                    type: "image";
+                    image: string | ArrayBuffer;
+                } | {
+                    providerOptions?: Record<string, Record<string, any>> | undefined;
+                    type: "file";
+                    mimeType: string;
+                    data: string | ArrayBuffer;
+                })[];
+            } | {
+                providerOptions?: Record<string, Record<string, any>> | undefined;
+                role: "assistant";
+                content: string | ({
+                    providerOptions?: Record<string, Record<string, any>> | undefined;
+                    type: "text";
+                    text: string;
+                } | {
+                    providerOptions?: Record<string, Record<string, any>> | undefined;
+                    type: "file";
+                    mimeType: string;
+                    data: string | ArrayBuffer;
+                } | {
+                    providerOptions?: Record<string, Record<string, any>> | undefined;
+                    signature?: string | undefined;
+                    type: "reasoning";
+                    text: string;
+                } | {
+                    providerOptions?: Record<string, Record<string, any>> | undefined;
+                    type: "redacted-reasoning";
+                    data: string;
+                } | {
+                    providerOptions?: Record<string, Record<string, any>> | 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;
+                    args?: any;
+                    experimental_content?: ({
+                        type: "text";
+                        text: string;
+                    } | {
+                        mimeType?: string | undefined;
+                        type: "image";
+                        data: string;
+                    })[] | undefined;
+                    isError?: boolean | undefined;
+                    type: "tool-result";
+                    toolCallId: string;
+                    toolName: string;
+                    result: any;
+                }[];
+            } | {
+                providerOptions?: Record<string, Record<string, any>> | undefined;
+                role: "system";
+                content: string;
+            };
+        }[];
+    }, Promise<{
+        lastMessageId: string;
+        messageIds: string[];
+    }>>;
     /**
      * Explicitly save a "step" created by the AI SDK.
      * @param ctx The ctx argument to a mutation or action.
-     * @param args What to save
+     * @param args The Step generated by the AI SDK.
      */
     saveStep<TOOLS extends ToolSet>(ctx: RunMutationCtx, args: {
         userId?: string;
@@ -401,7 +551,7 @@ export declare class Agent<AgentTools extends ToolSet> {
         /**
          * The message this step is in response to.
          */
-        parentMessageId: string;
+        promptMessageId: string;
         /**
          * The step to save, possibly including multiple tool calls.
          */
@@ -455,9 +605,7 @@ export declare class Agent<AgentTools extends ToolSet> {
          * set in the agent constructor.
          */
         usageHandler?: UsageHandler;
-        /**
-         * The tools to use for this thread. Overrides any tools passed in the agent constructor.
-         */
+        /** @deprecated Pass `tools` in the next parameter instead. This is only intended to pass through thread-default tools.  */
         tools?: ToolSet;
     }, args: TextArgs<AgentTools, TOOLS, OUTPUT, OUTPUT_PARTIAL>, options?: Options): Promise<GenerateTextResult<TOOLS extends undefined ? AgentTools : TOOLS, OUTPUT> & GenerationOutputMetadata>;
     /**
@@ -466,11 +614,6 @@ export declare class Agent<AgentTools extends ToolSet> {
      * resulting messages to the thread, if specified.
      * 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 streamText function, along with extra controls
-     * for the {@link ContextOptions} and {@link StorageOptions}.
-     * @returns The result of the streamText function.
      */
     streamText<TOOLS extends ToolSet | undefined = undefined, OUTPUT = never, PARTIAL_OUTPUT = never>(ctx: RunActionCtx, { userId, threadId, usageHandler, 
     /**
@@ -482,17 +625,31 @@ export declare class Agent<AgentTools extends ToolSet> {
         threadId?: string;
         usageHandler?: UsageHandler;
         tools?: ToolSet;
-    }, args: StreamingTextArgs<AgentTools, TOOLS, OUTPUT, PARTIAL_OUTPUT>, options?: Options): Promise<StreamTextResult<TOOLS extends undefined ? AgentTools : TOOLS, PARTIAL_OUTPUT> & GenerationOutputMetadata>;
-    saveMessagesAndFetchContext<T extends {
+    }, 
+    /**
+     * The arguments to the streamText function, similar to the ai `streamText` function.
+     */
+    args: StreamingTextArgs<AgentTools, TOOLS, OUTPUT, PARTIAL_OUTPUT>, 
+    /**
+     * The {@link ContextOptions} and {@link StorageOptions}
+     * options to use for fetching contextual messages and saving input/output messages.
+     */
+    options?: Options): Promise<StreamTextResult<TOOLS extends undefined ? AgentTools : TOOLS, PARTIAL_OUTPUT> & GenerationOutputMetadata>;
+    _saveMessagesAndFetchContext<T extends {
         id?: string;
         prompt?: string;
         messages?: CoreMessage[] | AIMessageWithoutId[];
         system?: string;
+        promptMessageId?: string;
+        model?: LanguageModelV1;
+        maxRetries?: number;
     }>(ctx: RunActionCtx | RunMutationCtx, args: T, { userId, threadId, contextOptions, storageOptions, }: {
         userId: string | undefined;
         threadId: string | undefined;
     } & Options): Promise<{
-        args: T;
+        args: T & {
+            model: LanguageModelV1;
+        };
         messageId: string | undefined;
     }>;
     /**
@@ -501,34 +658,42 @@ export declare class Agent<AgentTools extends ToolSet> {
      * resulting messages to the thread, if specified.
      * 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 generateObject function, along with extra controls
-     * for the {@link ContextOptions} and {@link StorageOptions}.
-     * @returns The result of the generateObject function.
      */
     generateObject<T>(ctx: RunActionCtx, { userId, threadId, usageHandler, }: {
         userId?: string;
         threadId?: string;
         usageHandler?: UsageHandler;
-    }, args: OurObjectArgs<T>, options?: Options): Promise<GenerateObjectResult<T> & GenerationOutputMetadata>;
+    }, 
     /**
-     * This behaves like {@link streamObject} from the "ai" package except that
+     * The arguments to the generateObject function, similar to the ai.generateObject function.
+     */
+    args: OurObjectArgs<T>, 
+    /**
+     * The {@link ContextOptions} and {@link StorageOptions}
+     * options to use for fetching contextual messages and saving input/output messages.
+     */
+    options?: Options): Promise<GenerateObjectResult<T> & 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
      * resulting messages to the thread, if specified.
      * 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 streamObject function, along with extra controls
-     * for the {@link ContextOptions} and {@link StorageOptions}.
-     * @returns The result of the streamObject function.
      */
     streamObject<T>(ctx: RunActionCtx, { userId, threadId, usageHandler, }: {
         userId?: string;
         threadId?: string;
         usageHandler?: UsageHandler;
-    }, args: OurStreamObjectArgs<T>, options?: Options): Promise<StreamObjectResult<DeepPartial<T>, T, never> & GenerationOutputMetadata>;
+    }, 
+    /**
+     * The arguments to the streamObject function, similar to the ai `streamObject` function.
+     */
+    args: OurStreamObjectArgs<T>, 
+    /**
+     * 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>;
     /**
      * Manually save the result of a generateObject call to the thread.
      * This happens automatically when using {@link generateObject} or {@link streamObject}
@@ -539,7 +704,7 @@ export declare class Agent<AgentTools extends ToolSet> {
     saveObject(ctx: RunMutationCtx, args: {
         userId: string | undefined;
         threadId: string;
-        parentMessageId: string;
+        promptMessageId: string;
         result: GenerateObjectResult<unknown>;
         metadata?: Omit<MessageWithMetadata, "message">;
     }): Promise<void>;
@@ -574,15 +739,17 @@ export declare class Agent<AgentTools extends ToolSet> {
      * Create an action out of this agent so you can call it from workflows or other actions
      * without a wrapping function.
      * @param spec Configuration for the agent acting as an action, including
-     *   {@link ContextOptions} and maxSteps.
+     *   {@link ContextOptions}, {@link StorageOptions}, and maxSteps.
      */
     asTextAction(spec?: {
-        contextOptions?: ContextOptions;
         maxSteps?: number;
+        contextOptions?: ContextOptions;
         storageOptions?: StorageOptions;
     }): import("convex/server").RegisteredAction<"internal", {
         userId?: string | undefined;
         threadId?: string | undefined;
+        providerOptions?: Record<string, Record<string, any>> | undefined;
+        system?: string | undefined;
         messages?: ({
             providerOptions?: Record<string, Record<string, any>> | undefined;
             role: "user";
@@ -654,8 +821,6 @@ export declare class Agent<AgentTools extends ToolSet> {
             role: "system";
             content: string;
         })[] | undefined;
-        providerOptions?: Record<string, Record<string, any>> | undefined;
-        system?: string | undefined;
         headers?: Record<string, string> | undefined;
         maxTokens?: number | undefined;
         temperature?: number | undefined;
@@ -707,6 +872,8 @@ export declare class Agent<AgentTools extends ToolSet> {
     }): import("convex/server").RegisteredAction<"internal", {
         userId?: string | undefined;
         threadId?: string | undefined;
+        providerOptions?: Record<string, Record<string, any>> | undefined;
+        system?: string | undefined;
         messages?: ({
             providerOptions?: Record<string, Record<string, any>> | undefined;
             role: "user";
@@ -778,8 +945,6 @@ export declare class Agent<AgentTools extends ToolSet> {
             role: "system";
             content: string;
         })[] | undefined;
-        providerOptions?: Record<string, Record<string, any>> | undefined;
-        system?: string | undefined;
         headers?: Record<string, string> | undefined;
         maxTokens?: number | undefined;
         temperature?: number | undefined;
@@ -809,13 +974,13 @@ export declare class Agent<AgentTools extends ToolSet> {
             saveAnyInputMessages?: boolean | undefined;
             saveOutputMessages?: boolean | undefined;
         } | undefined;
-    }, Promise<T>>;
+    }, Promise<{
+        object: T;
+    }>>;
 }
 export declare function filterOutOrphanedToolMessages(docs: MessageDoc[]): {
     id?: string | undefined;
     userId?: string | undefined;
-    parentMessageId?: string | undefined;
-    stepId?: string | undefined;
     embeddingId?: string | undefined;
     error?: string | undefined;
     agentName?: string | undefined;
@@ -896,7 +1061,7 @@ export declare function filterOutOrphanedToolMessages(docs: MessageDoc[]): {
     text?: string | undefined;
     reasoning?: string | undefined;
     files?: {
-        bytes?: ArrayBuffer | undefined;
+        data?: string | ArrayBuffer | undefined;
         url?: string | undefined;
         fileId?: string | undefined;
         mimeType: string;
@@ -993,6 +1158,13 @@ type Options = {
     storageOptions?: StorageOptions;
 };
 type TextArgs<AgentTools extends ToolSet, TOOLS extends ToolSet | undefined = undefined, OUTPUT = never, OUTPUT_PARTIAL = never> = Omit<Parameters<typeof generateText<TOOLS extends undefined ? AgentTools : TOOLS, OUTPUT, OUTPUT_PARTIAL>>[0], "toolChoice" | "tools" | "model"> & {
+    /**
+     * If provided, this message will be used as the "prompt" for the LLM call,
+     * instead of the prompt or messages.
+     * This is useful if you want to first save a user message, then use it as
+     * the prompt for the LLM call in another call.
+     */
+    promptMessageId?: string;
     /**
      * The model to use for the tool calls. This will override the model specified
      * in the Agent constructor.
@@ -1008,8 +1180,7 @@ type TextArgs<AgentTools extends ToolSet, TOOLS extends ToolSet | undefined = un
      * specified in the tools array. e.g. {toolName: "getWeather", type: "tool"}
      */
     toolChoice?: ToolChoice<TOOLS extends undefined ? AgentTools : TOOLS>;
-} & ContextOptions & // DEPRECATED: pass them in the subsequent parameter instead
-StorageOptions;
+};
 type StreamingTextArgs<AgentTools extends ToolSet, TOOLS extends ToolSet | undefined = undefined, OUTPUT = never, OUTPUT_PARTIAL = never> = Omit<Parameters<typeof streamText<TOOLS extends undefined ? AgentTools : TOOLS, OUTPUT, OUTPUT_PARTIAL>>[0], "toolChoice" | "tools" | "model"> & {
     /**
      * The model to use for the tool calls. This will override the model specified
@@ -1026,8 +1197,8 @@ type StreamingTextArgs<AgentTools extends ToolSet, TOOLS extends ToolSet | undef
      * specified in the tools array. e.g. {toolName: "getWeather", type: "tool"}
      */
     toolChoice?: ToolChoice<TOOLS extends undefined ? AgentTools : TOOLS>;
-} & ContextOptions & StorageOptions;
-type BaseGenerateObjectOptions = StorageOptions & ContextOptions & CallSettings & {
+};
+type BaseGenerateObjectOptions = CallSettings & {
     /**
      * The model to use for the object generation. This will override the model
      * specified in the Agent constructor.
@@ -1049,6 +1220,13 @@ type BaseGenerateObjectOptions = StorageOptions & ContextOptions & CallSettings
      * associated with and your contextOptions.
      */
     messages?: CoreMessage[];
+    /**
+     * The message to use as the "prompt" for the object generation.
+     * If this is provided, it will be used instead of the prompt or messages.
+     * This is useful if you want to first save a user message, then use it as
+     * the prompt for the object generation in another call.
+     */
+    promptMessageId?: string;
     experimental_repairText?: RepairTextFunction;
     experimental_telemetry?: TelemetrySettings;
     providerOptions?: ProviderOptions;
@@ -1149,711 +1327,6 @@ interface Thread<DefaultTools extends ToolSet> {
      */
     streamObject<T>(args: OurStreamObjectArgs<T>, options?: Options): Promise<StreamObjectResult<DeepPartial<T>, T, never> & ThreadOutputMetadata>;
 }
-export declare const vThreadDoc: import("convex/values").VObject<{
-    userId?: string | undefined;
-    title?: string | undefined;
-    summary?: string | undefined;
-    status: "active" | "archived";
-    _creationTime: number;
-    _id: string;
-}, {
-    _id: import("convex/values").VString<string, "required">;
-    _creationTime: import("convex/values").VFloat64<number, "required">;
-    userId: import("convex/values").VString<string | undefined, "optional">;
-    title: import("convex/values").VString<string | undefined, "optional">;
-    summary: import("convex/values").VString<string | undefined, "optional">;
-    status: import("convex/values").VUnion<"active" | "archived", [import("convex/values").VLiteral<"active", "required">, import("convex/values").VLiteral<"archived", "required">], "required", never>;
-}, "required", "status" | "userId" | "title" | "summary" | "_creationTime" | "_id">;
-export type ThreadDoc = Infer<typeof vThreadDoc>;
-export declare const vMessageDoc: import("convex/values").VObject<{
-    id?: string | undefined;
-    userId?: string | undefined;
-    parentMessageId?: string | undefined;
-    stepId?: string | undefined;
-    embeddingId?: string | undefined;
-    error?: string | undefined;
-    agentName?: string | undefined;
-    model?: string | undefined;
-    provider?: string | undefined;
-    providerOptions?: Record<string, Record<string, any>> | undefined;
-    message?: {
-        providerOptions?: Record<string, Record<string, any>> | undefined;
-        role: "user";
-        content: string | ({
-            providerOptions?: Record<string, Record<string, any>> | undefined;
-            type: "text";
-            text: string;
-        } | {
-            providerOptions?: Record<string, Record<string, any>> | undefined;
-            mimeType?: string | undefined;
-            type: "image";
-            image: string | ArrayBuffer;
-        } | {
-            providerOptions?: Record<string, Record<string, any>> | undefined;
-            type: "file";
-            mimeType: string;
-            data: string | ArrayBuffer;
-        })[];
-    } | {
-        providerOptions?: Record<string, Record<string, any>> | undefined;
-        role: "assistant";
-        content: string | ({
-            providerOptions?: Record<string, Record<string, any>> | undefined;
-            type: "text";
-            text: string;
-        } | {
-            providerOptions?: Record<string, Record<string, any>> | undefined;
-            type: "file";
-            mimeType: string;
-            data: string | ArrayBuffer;
-        } | {
-            providerOptions?: Record<string, Record<string, any>> | undefined;
-            signature?: string | undefined;
-            type: "reasoning";
-            text: string;
-        } | {
-            providerOptions?: Record<string, Record<string, any>> | undefined;
-            type: "redacted-reasoning";
-            data: string;
-        } | {
-            providerOptions?: Record<string, Record<string, any>> | 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;
-            args?: any;
-            experimental_content?: ({
-                type: "text";
-                text: string;
-            } | {
-                mimeType?: string | undefined;
-                type: "image";
-                data: string;
-            })[] | undefined;
-            isError?: boolean | undefined;
-            type: "tool-result";
-            toolCallId: string;
-            toolName: string;
-            result: any;
-        }[];
-    } | {
-        providerOptions?: Record<string, Record<string, any>> | undefined;
-        role: "system";
-        content: string;
-    } | undefined;
-    text?: string | undefined;
-    reasoning?: string | undefined;
-    files?: {
-        bytes?: ArrayBuffer | undefined;
-        url?: string | undefined;
-        fileId?: string | undefined;
-        mimeType: string;
-    }[] | undefined;
-    usage?: {
-        promptTokens: number;
-        completionTokens: number;
-        totalTokens: number;
-    } | undefined;
-    providerMetadata?: Record<string, Record<string, any>> | undefined;
-    sources?: {
-        title?: string | undefined;
-        providerOptions?: Record<string, Record<string, any>> | undefined;
-        id: string;
-        url: string;
-        sourceType: "url";
-    }[] | undefined;
-    reasoningDetails?: ({
-        signature?: string | undefined;
-        type: "text";
-        text: string;
-    } | {
-        type: "redacted";
-        data: string;
-    })[] | undefined;
-    warnings?: ({
-        details?: string | undefined;
-        type: "unsupported-setting";
-        setting: string;
-    } | {
-        details?: string | undefined;
-        type: "unsupported-tool";
-        tool: any;
-    } | {
-        type: "other";
-        message: string;
-    })[] | undefined;
-    finishReason?: "length" | "error" | "other" | "stop" | "content-filter" | "tool-calls" | "unknown" | undefined;
-    status: "pending" | "success" | "failed";
-    order: number;
-    _creationTime: number;
-    threadId: string;
-    stepOrder: number;
-    tool: boolean;
-    _id: string;
-}, {
-    threadId: import("convex/values").VString<string, "required">;
-    parentMessageId: import("convex/values").VString<string | undefined, "optional">;
-    stepId: import("convex/values").VString<string | undefined, "optional">;
-    embeddingId: import("convex/values").VString<string | undefined, "optional">;
-    files: import("convex/values").VArray<{
-        bytes?: ArrayBuffer | undefined;
-        url?: string | undefined;
-        fileId?: string | undefined;
-        mimeType: string;
-    }[] | undefined, import("convex/values").VObject<{
-        bytes?: ArrayBuffer | undefined;
-        url?: string | undefined;
-        fileId?: string | undefined;
-        mimeType: string;
-    }, {
-        bytes: import("convex/values").VBytes<ArrayBuffer | undefined, "optional">;
-        url: import("convex/values").VString<string | undefined, "optional">;
-        mimeType: import("convex/values").VString<string, "required">;
-        fileId: import("convex/values").VString<string | undefined, "optional">;
-    }, "required", "bytes" | "mimeType" | "url" | "fileId">, "optional">;
-    id: import("convex/values").VString<string | undefined, "optional">;
-    userId: import("convex/values").VString<string | undefined, "optional">;
-    order: import("convex/values").VFloat64<number, "required">;
-    stepOrder: import("convex/values").VFloat64<number, "required">;
-    error: import("convex/values").VString<string | undefined, "optional">;
-    status: import("convex/values").VUnion<"pending" | "success" | "failed", [import("convex/values").VLiteral<"pending", "required">, import("convex/values").VLiteral<"success", "required">, import("convex/values").VLiteral<"failed", "required">], "required", never>;
-    agentName: import("convex/values").VString<string | undefined, "optional">;
-    model: import("convex/values").VString<string | undefined, "optional">;
-    provider: import("convex/values").VString<string | undefined, "optional">;
-    providerOptions: import("convex/values").VRecord<Record<string, Record<string, any>> | undefined, import("convex/values").VString<string, "required">, import("convex/values").VRecord<Record<string, any>, import("convex/values").VString<string, "required">, import("convex/values").VAny<any, "required", string>, "required", string>, "optional", string>;
-    message: import("convex/values").VUnion<{
-        providerOptions?: Record<string, Record<string, any>> | undefined;
-        role: "user";
-        content: string | ({
-            providerOptions?: Record<string, Record<string, any>> | undefined;
-            type: "text";
-            text: string;
-        } | {
-            providerOptions?: Record<string, Record<string, any>> | undefined;
-            mimeType?: string | undefined;
-            type: "image";
-            image: string | ArrayBuffer;
-        } | {
-            providerOptions?: Record<string, Record<string, any>> | undefined;
-            type: "file";
-            mimeType: string;
-            data: string | ArrayBuffer;
-        })[];
-    } | {
-        providerOptions?: Record<string, Record<string, any>> | undefined;
-        role: "assistant";
-        content: string | ({
-            providerOptions?: Record<string, Record<string, any>> | undefined;
-            type: "text";
-            text: string;
-        } | {
-            providerOptions?: Record<string, Record<string, any>> | undefined;
-            type: "file";
-            mimeType: string;
-            data: string | ArrayBuffer;
-        } | {
-            providerOptions?: Record<string, Record<string, any>> | undefined;
-            signature?: string | undefined;
-            type: "reasoning";
-            text: string;
-        } | {
-            providerOptions?: Record<string, Record<string, any>> | undefined;
-            type: "redacted-reasoning";
-            data: string;
-        } | {
-            providerOptions?: Record<string, Record<string, any>> | 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;
-            args?: any;
-            experimental_content?: ({
-                type: "text";
-                text: string;
-            } | {
-                mimeType?: string | undefined;
-                type: "image";
-                data: string;
-            })[] | undefined;
-            isError?: boolean | undefined;
-            type: "tool-result";
-            toolCallId: string;
-            toolName: string;
-            result: any;
-        }[];
-    } | {
-        providerOptions?: Record<string, Record<string, any>> | undefined;
-        role: "system";
-        content: string;
-    } | undefined, [import("convex/values").VObject<{
-        providerOptions?: Record<string, Record<string, any>> | undefined;
-        role: "user";
-        content: string | ({
-            providerOptions?: Record<string, Record<string, any>> | undefined;
-            type: "text";
-            text: string;
-        } | {
-            providerOptions?: Record<string, Record<string, any>> | undefined;
-            mimeType?: string | undefined;
-            type: "image";
-            image: string | ArrayBuffer;
-        } | {
-            providerOptions?: Record<string, Record<string, any>> | undefined;
-            type: "file";
-            mimeType: string;
-            data: string | ArrayBuffer;
-        })[];
-    }, {
-        role: import("convex/values").VLiteral<"user", "required">;
-        content: import("convex/values").VUnion<string | ({
-            providerOptions?: Record<string, Record<string, any>> | undefined;
-            type: "text";
-            text: string;
-        } | {
-            providerOptions?: Record<string, Record<string, any>> | undefined;
-            mimeType?: string | undefined;
-            type: "image";
-            image: string | ArrayBuffer;
-        } | {
-            providerOptions?: Record<string, Record<string, any>> | undefined;
-            type: "file";
-            mimeType: string;
-            data: string | ArrayBuffer;
-        })[], [import("convex/values").VString<string, "required">, import("convex/values").VArray<({
-            providerOptions?: Record<string, Record<string, any>> | undefined;
-            type: "text";
-            text: string;
-        } | {
-            providerOptions?: Record<string, Record<string, any>> | undefined;
-            mimeType?: string | undefined;
-            type: "image";
-            image: string | ArrayBuffer;
-        } | {
-            providerOptions?: Record<string, Record<string, any>> | undefined;
-            type: "file";
-            mimeType: string;
-            data: string | ArrayBuffer;
-        })[], import("convex/values").VUnion<{
-            providerOptions?: Record<string, Record<string, any>> | undefined;
-            type: "text";
-            text: string;
-        } | {
-            providerOptions?: Record<string, Record<string, any>> | undefined;
-            mimeType?: string | undefined;
-            type: "image";
-            image: string | ArrayBuffer;
-        } | {
-            providerOptions?: Record<string, Record<string, any>> | undefined;
-            type: "file";
-            mimeType: string;
-            data: string | ArrayBuffer;
-        }, [import("convex/values").VObject<{
-            providerOptions?: Record<string, Record<string, any>> | undefined;
-            type: "text";
-            text: string;
-        }, {
-            type: import("convex/values").VLiteral<"text", "required">;
-            text: import("convex/values").VString<string, "required">;
-            providerOptions: import("convex/values").VRecord<Record<string, Record<string, any>> | undefined, import("convex/values").VString<string, "required">, import("convex/values").VRecord<Record<string, any>, import("convex/values").VString<string, "required">, import("convex/values").VAny<any, "required", string>, "required", string>, "optional", string>;
-        }, "required", "type" | "providerOptions" | "text" | `providerOptions.${string}`>, import("convex/values").VObject<{
-            providerOptions?: Record<string, Record<string, any>> | undefined;
-            mimeType?: string | undefined;
-            type: "image";
-            image: string | ArrayBuffer;
-        }, {
-            type: import("convex/values").VLiteral<"image", "required">;
-            image: import("convex/values").VUnion<string | ArrayBuffer, [import("convex/values").VString<string, "required">, import("convex/values").VBytes<ArrayBuffer, "required">], "required", never>;
-            mimeType: import("convex/values").VString<string | undefined, "optional">;
-            providerOptions: import("convex/values").VRecord<Record<string, Record<string, any>> | undefined, import("convex/values").VString<string, "required">, import("convex/values").VRecord<Record<string, any>, import("convex/values").VString<string, "required">, import("convex/values").VAny<any, "required", string>, "required", string>, "optional", string>;
-        }, "required", "type" | "providerOptions" | `providerOptions.${string}` | "image" | "mimeType">, import("convex/values").VObject<{
-            providerOptions?: Record<string, Record<string, any>> | undefined;
-            type: "file";
-            mimeType: string;
-            data: string | ArrayBuffer;
-        }, {
-            type: import("convex/values").VLiteral<"file", "required">;
-            data: import("convex/values").VUnion<string | ArrayBuffer, [import("convex/values").VString<string, "required">, import("convex/values").VBytes<ArrayBuffer, "required">], "required", never>;
-            mimeType: import("convex/values").VString<string, "required">;
-            providerOptions: import("convex/values").VRecord<Record<string, Record<string, any>> | undefined, import("convex/values").VString<string, "required">, import("convex/values").VRecord<Record<string, any>, import("convex/values").VString<string, "required">, import("convex/values").VAny<any, "required", string>, "required", string>, "optional", string>;
-        }, "required", "type" | "providerOptions" | `providerOptions.${string}` | "mimeType" | "data">], "required", "type" | "providerOptions" | "text" | `providerOptions.${string}` | "image" | "mimeType" | "data">, "required">], "required", never>;
-        providerOptions: import("convex/values").VRecord<Record<string, Record<string, any>> | undefined, import("convex/values").VString<string, "required">, import("convex/values").VRecord<Record<string, any>, import("convex/values").VString<string, "required">, import("convex/values").VAny<any, "required", string>, "required", string>, "optional", string>;
-    }, "required", "providerOptions" | "role" | `providerOptions.${string}` | "content">, import("convex/values").VObject<{
-        providerOptions?: Record<string, Record<string, any>> | undefined;
-        role: "assistant";
-        content: string | ({
-            providerOptions?: Record<string, Record<string, any>> | undefined;
-            type: "text";
-            text: string;
-        } | {
-            providerOptions?: Record<string, Record<string, any>> | undefined;
-            type: "file";
-            mimeType: string;
-            data: string | ArrayBuffer;
-        } | {
-            providerOptions?: Record<string, Record<string, any>> | undefined;
-            signature?: string | undefined;
-            type: "reasoning";
-            text: string;
-        } | {
-            providerOptions?: Record<string, Record<string, any>> | undefined;
-            type: "redacted-reasoning";
-            data: string;
-        } | {
-            providerOptions?: Record<string, Record<string, any>> | undefined;
-            type: "tool-call";
-            toolCallId: string;
-            toolName: string;
-            args: any;
-        })[];
-    }, {
-        role: import("convex/values").VLiteral<"assistant", "required">;
-        content: import("convex/values").VUnion<string | ({
-            providerOptions?: Record<string, Record<string, any>> | undefined;
-            type: "text";
-            text: string;
-        } | {
-            providerOptions?: Record<string, Record<string, any>> | undefined;
-            type: "file";
-            mimeType: string;
-            data: string | ArrayBuffer;
-        } | {
-            providerOptions?: Record<string, Record<string, any>> | undefined;
-            signature?: string | undefined;
-            type: "reasoning";
-            text: string;
-        } | {
-            providerOptions?: Record<string, Record<string, any>> | undefined;
-            type: "redacted-reasoning";
-            data: string;
-        } | {
-            providerOptions?: Record<string, Record<string, any>> | undefined;
-            type: "tool-call";
-            toolCallId: string;
-            toolName: string;
-            args: any;
-        })[], [import("convex/values").VString<string, "required">, import("convex/values").VArray<({
-            providerOptions?: Record<string, Record<string, any>> | undefined;
-            type: "text";
-            text: string;
-        } | {
-            providerOptions?: Record<string, Record<string, any>> | undefined;
-            type: "file";
-            mimeType: string;
-            data: string | ArrayBuffer;
-        } | {
-            providerOptions?: Record<string, Record<string, any>> | undefined;
-            signature?: string | undefined;
-            type: "reasoning";
-            text: string;
-        } | {
-            providerOptions?: Record<string, Record<string, any>> | undefined;
-            type: "redacted-reasoning";
-            data: string;
-        } | {
-            providerOptions?: Record<string, Record<string, any>> | undefined;
-            type: "tool-call";
-            toolCallId: string;
-            toolName: string;
-            args: any;
-        })[], import("convex/values").VUnion<{
-            providerOptions?: Record<string, Record<string, any>> | undefined;
-            type: "text";
-            text: string;
-        } | {
-            providerOptions?: Record<string, Record<string, any>> | undefined;
-            type: "file";
-            mimeType: string;
-            data: string | ArrayBuffer;
-        } | {
-            providerOptions?: Record<string, Record<string, any>> | undefined;
-            signature?: string | undefined;
-            type: "reasoning";
-            text: string;
-        } | {
-            providerOptions?: Record<string, Record<string, any>> | undefined;
-            type: "redacted-reasoning";
-            data: string;
-        } | {
-            providerOptions?: Record<string, Record<string, any>> | undefined;
-            type: "tool-call";
-            toolCallId: string;
-            toolName: string;
-            args: any;
-        }, [import("convex/values").VObject<{
-            providerOptions?: Record<string, Record<string, any>> | undefined;
-            type: "text";
-            text: string;
-        }, {
-            type: import("convex/values").VLiteral<"text", "required">;
-            text: import("convex/values").VString<string, "required">;
-            providerOptions: import("convex/values").VRecord<Record<string, Record<string, any>> | undefined, import("convex/values").VString<string, "required">, import("convex/values").VRecord<Record<string, any>, import("convex/values").VString<string, "required">, import("convex/values").VAny<any, "required", string>, "required", string>, "optional", string>;
-        }, "required", "type" | "providerOptions" | "text" | `providerOptions.${string}`>, import("convex/values").VObject<{
-            providerOptions?: Record<string, Record<string, any>> | undefined;
-            type: "file";
-            mimeType: string;
-            data: string | ArrayBuffer;
-        }, {
-            type: import("convex/values").VLiteral<"file", "required">;
-            data: import("convex/values").VUnion<string | ArrayBuffer, [import("convex/values").VString<string, "required">, import("convex/values").VBytes<ArrayBuffer, "required">], "required", never>;
-            mimeType: import("convex/values").VString<string, "required">;
-            providerOptions: import("convex/values").VRecord<Record<string, Record<string, any>> | undefined, import("convex/values").VString<string, "required">, import("convex/values").VRecord<Record<string, any>, import("convex/values").VString<string, "required">, import("convex/values").VAny<any, "required", string>, "required", string>, "optional", string>;
-        }, "required", "type" | "providerOptions" | `providerOptions.${string}` | "mimeType" | "data">, import("convex/values").VObject<{
-            providerOptions?: Record<string, Record<string, any>> | undefined;
-            signature?: string | undefined;
-            type: "reasoning";
-            text: string;
-        }, {
-            type: import("convex/values").VLiteral<"reasoning", "required">;
-            text: import("convex/values").VString<string, "required">;
-            signature: import("convex/values").VString<string | undefined, "optional">;
-            providerOptions: import("convex/values").VRecord<Record<string, Record<string, any>> | undefined, import("convex/values").VString<string, "required">, import("convex/values").VRecord<Record<string, any>, import("convex/values").VString<string, "required">, import("convex/values").VAny<any, "required", string>, "required", string>, "optional", string>;
-        }, "required", "type" | "providerOptions" | "text" | `providerOptions.${string}` | "signature">, import("convex/values").VObject<{
-            providerOptions?: Record<string, Record<string, any>> | undefined;
-            type: "redacted-reasoning";
-            data: string;
-        }, {
-            type: import("convex/values").VLiteral<"redacted-reasoning", "required">;
-            data: import("convex/values").VString<string, "required">;
-            providerOptions: import("convex/values").VRecord<Record<string, Record<string, any>> | undefined, import("convex/values").VString<string, "required">, import("convex/values").VRecord<Record<string, any>, import("convex/values").VString<string, "required">, import("convex/values").VAny<any, "required", string>, "required", string>, "optional", string>;
-        }, "required", "type" | "providerOptions" | `providerOptions.${string}` | "data">, import("convex/values").VObject<{
-            providerOptions?: Record<string, Record<string, any>> | undefined;
-            type: "tool-call";
-            toolCallId: string;
-            toolName: string;
-            args: any;
-        }, {
-            type: import("convex/values").VLiteral<"tool-call", "required">;
-            toolCallId: import("convex/values").VString<string, "required">;
-            toolName: import("convex/values").VString<string, "required">;
-            args: import("convex/values").VAny<any, "required", string>;
-            providerOptions: import("convex/values").VRecord<Record<string, Record<string, any>> | undefined, import("convex/values").VString<string, "required">, import("convex/values").VRecord<Record<string, any>, import("convex/values").VString<string, "required">, import("convex/values").VAny<any, "required", string>, "required", string>, "optional", string>;
-        }, "required", "type" | "providerOptions" | `providerOptions.${string}` | "toolCallId" | "toolName" | "args" | `args.${string}`>], "required", "type" | "providerOptions" | "text" | `providerOptions.${string}` | "mimeType" | "data" | "signature" | "toolCallId" | "toolName" | "args" | `args.${string}`>, "required">], "required", never>;
-        providerOptions: import("convex/values").VRecord<Record<string, Record<string, any>> | undefined, import("convex/values").VString<string, "required">, import("convex/values").VRecord<Record<string, any>, import("convex/values").VString<string, "required">, import("convex/values").VAny<any, "required", string>, "required", string>, "optional", string>;
-    }, "required", "providerOptions" | "role" | `providerOptions.${string}` | "content">, import("convex/values").VObject<{
-        providerOptions?: Record<string, Record<string, any>> | undefined;
-        role: "tool";
-        content: {
-            providerOptions?: Record<string, Record<string, any>> | undefined;
-            args?: any;
-            experimental_content?: ({
-                type: "text";
-                text: string;
-            } | {
-                mimeType?: string | undefined;
-                type: "image";
-                data: string;
-            })[] | undefined;
-            isError?: boolean | undefined;
-            type: "tool-result";
-            toolCallId: string;
-            toolName: string;
-            result: any;
-        }[];
-    }, {
-        role: import("convex/values").VLiteral<"tool", "required">;
-        content: import("convex/values").VArray<{
-            providerOptions?: Record<string, Record<string, any>> | undefined;
-            args?: any;
-            experimental_content?: ({
-                type: "text";
-                text: string;
-            } | {
-                mimeType?: string | undefined;
-                type: "image";
-                data: string;
-            })[] | undefined;
-            isError?: boolean | undefined;
-            type: "tool-result";
-            toolCallId: string;
-            toolName: string;
-            result: any;
-        }[], import("convex/values").VObject<{
-            providerOptions?: Record<string, Record<string, any>> | undefined;
-            args?: any;
-            experimental_content?: ({
-                type: "text";
-                text: string;
-            } | {
-                mimeType?: string | undefined;
-                type: "image";
-                data: string;
-            })[] | undefined;
-            isError?: boolean | undefined;
-            type: "tool-result";
-            toolCallId: string;
-            toolName: string;
-            result: any;
-        }, {
-            type: import("convex/values").VLiteral<"tool-result", "required">;
-            toolCallId: import("convex/values").VString<string, "required">;
-            toolName: import("convex/values").VString<string, "required">;
-            result: import("convex/values").VAny<any, "required", string>;
-            args: import("convex/values").VAny<any, "optional", string>;
-            experimental_content: import("convex/values").VArray<({
-                type: "text";
-                text: string;
-            } | {
-                mimeType?: string | undefined;
-                type: "image";
-                data: string;
-            })[] | undefined, import("convex/values").VUnion<{
-                type: "text";
-                text: string;
-            } | {
-                mimeType?: string | undefined;
-                type: "image";
-                data: string;
-            }, [import("convex/values").VObject<{
-                type: "text";
-                text: string;
-            }, {
-                type: import("convex/values").VLiteral<"text", "required">;
-                text: import("convex/values").VString<string, "required">;
-            }, "required", "type" | "text">, import("convex/values").VObject<{
-                mimeType?: string | undefined;
-                type: "image";
-                data: string;
-            }, {
-                type: import("convex/values").VLiteral<"image", "required">;
-                data: import("convex/values").VString<string, "required">;
-                mimeType: import("convex/values").VString<string | undefined, "optional">;
-            }, "required", "type" | "mimeType" | "data">], "required", "type" | "text" | "mimeType" | "data">, "optional">;
-            isError: import("convex/values").VBoolean<boolean | undefined, "optional">;
-            providerOptions: import("convex/values").VRecord<Record<string, Record<string, any>> | undefined, import("convex/values").VString<string, "required">, import("convex/values").VRecord<Record<string, any>, import("convex/values").VString<string, "required">, import("convex/values").VAny<any, "required", string>, "required", string>, "optional", string>;
-        }, "required", "type" | "providerOptions" | `providerOptions.${string}` | "toolCallId" | "toolName" | "args" | `args.${string}` | "result" | "experimental_content" | "isError" | `result.${string}`>, "required">;
-        providerOptions: import("convex/values").VRecord<Record<string, Record<string, any>> | undefined, import("convex/values").VString<string, "required">, import("convex/values").VRecord<Record<string, any>, import("convex/values").VString<string, "required">, import("convex/values").VAny<any, "required", string>, "required", string>, "optional", string>;
-    }, "required", "providerOptions" | "role" | `providerOptions.${string}` | "content">, import("convex/values").VObject<{
-        providerOptions?: Record<string, Record<string, any>> | undefined;
-        role: "system";
-        content: string;
-    }, {
-        role: import("convex/values").VLiteral<"system", "required">;
-        content: import("convex/values").VString<string, "required">;
-        providerOptions: import("convex/values").VRecord<Record<string, Record<string, any>> | undefined, import("convex/values").VString<string, "required">, import("convex/values").VRecord<Record<string, any>, import("convex/values").VString<string, "required">, import("convex/values").VAny<any, "required", string>, "required", string>, "optional", string>;
-    }, "required", "providerOptions" | "role" | `providerOptions.${string}` | "content">], "optional", "providerOptions" | "role" | `providerOptions.${string}` | "content">;
-    tool: import("convex/values").VBoolean<boolean, "required">;
-    text: import("convex/values").VString<string | undefined, "optional">;
-    usage: import("convex/values").VObject<{
-        promptTokens: number;
-        completionTokens: number;
-        totalTokens: number;
-    } | undefined, {
-        promptTokens: import("convex/values").VFloat64<number, "required">;
-        completionTokens: import("convex/values").VFloat64<number, "required">;
-        totalTokens: import("convex/values").VFloat64<number, "required">;
-    }, "optional", "promptTokens" | "completionTokens" | "totalTokens">;
-    providerMetadata: import("convex/values").VRecord<Record<string, Record<string, any>> | undefined, import("convex/values").VString<string, "required">, import("convex/values").VRecord<Record<string, any>, import("convex/values").VString<string, "required">, import("convex/values").VAny<any, "required", string>, "required", string>, "optional", string>;
-    sources: import("convex/values").VArray<{
-        title?: string | undefined;
-        providerOptions?: Record<string, Record<string, any>> | undefined;
-        id: string;
-        url: string;
-        sourceType: "url";
-    }[] | undefined, import("convex/values").VObject<{
-        title?: string | undefined;
-        providerOptions?: Record<string, Record<string, any>> | undefined;
-        id: string;
-        url: string;
-        sourceType: "url";
-    }, {
-        sourceType: import("convex/values").VLiteral<"url", "required">;
-        id: import("convex/values").VString<string, "required">;
-        url: import("convex/values").VString<string, "required">;
-        title: import("convex/values").VString<string | undefined, "optional">;
-        providerOptions: import("convex/values").VRecord<Record<string, Record<string, any>> | undefined, import("convex/values").VString<string, "required">, import("convex/values").VRecord<Record<string, any>, import("convex/values").VString<string, "required">, import("convex/values").VAny<any, "required", string>, "required", string>, "optional", string>;
-    }, "required", "id" | "title" | "providerOptions" | `providerOptions.${string}` | "url" | "sourceType">, "optional">;
-    reasoning: import("convex/values").VString<string | undefined, "optional">;
-    reasoningDetails: import("convex/values").VArray<({
-        signature?: string | undefined;
-        type: "text";
-        text: string;
-    } | {
-        type: "redacted";
-        data: string;
-    })[] | undefined, import("convex/values").VUnion<{
-        signature?: string | undefined;
-        type: "text";
-        text: string;
-    } | {
-        type: "redacted";
-        data: string;
-    }, [import("convex/values").VObject<{
-        signature?: string | undefined;
-        type: "text";
-        text: string;
-    }, {
-        type: import("convex/values").VLiteral<"text", "required">;
-        text: import("convex/values").VString<string, "required">;
-        signature: import("convex/values").VString<string | undefined, "optional">;
-    }, "required", "type" | "text" | "signature">, import("convex/values").VObject<{
-        type: "redacted";
-        data: string;
-    }, {
-        type: import("convex/values").VLiteral<"redacted", "required">;
-        data: import("convex/values").VString<string, "required">;
-    }, "required", "type" | "data">], "required", "type" | "text" | "data" | "signature">, "optional">;
-    warnings: import("convex/values").VArray<({
-        details?: string | undefined;
-        type: "unsupported-setting";
-        setting: string;
-    } | {
-        details?: string | undefined;
-        type: "unsupported-tool";
-        tool: any;
-    } | {
-        type: "other";
-        message: string;
-    })[] | undefined, import("convex/values").VUnion<{
-        details?: string | undefined;
-        type: "unsupported-setting";
-        setting: string;
-    } | {
-        details?: string | undefined;
-        type: "unsupported-tool";
-        tool: any;
-    } | {
-        type: "other";
-        message: string;
-    }, [import("convex/values").VObject<{
-        details?: string | undefined;
-        type: "unsupported-setting";
-        setting: string;
-    }, {
-        type: import("convex/values").VLiteral<"unsupported-setting", "required">;
-        setting: import("convex/values").VString<string, "required">;
-        details: import("convex/values").VString<string | undefined, "optional">;
-    }, "required", "type" | "setting" | "details">, import("convex/values").VObject<{
-        details?: string | undefined;
-        type: "unsupported-tool";
-        tool: any;
-    }, {
-        type: import("convex/values").VLiteral<"unsupported-tool", "required">;
-        tool: import("convex/values").VAny<any, "required", string>;
-        details: import("convex/values").VString<string | undefined, "optional">;
-    }, "required", "type" | "tool" | "details" | `tool.${string}`>, import("convex/values").VObject<{
-        type: "other";
-        message: string;
-    }, {
-        type: import("convex/values").VLiteral<"other", "required">;
-        message: import("convex/values").VString<string, "required">;
-    }, "required", "type" | "message">], "required", "type" | "message" | "tool" | "setting" | "details" | `tool.${string}`>, "optional">;
-    finishReason: import("convex/values").VUnion<"length" | "error" | "other" | "stop" | "content-filter" | "tool-calls" | "unknown" | undefined, [import("convex/values").VLiteral<"stop", "required">, import("convex/values").VLiteral<"length", "required">, import("convex/values").VLiteral<"content-filter", "required">, import("convex/values").VLiteral<"tool-calls", "required">, import("convex/values").VLiteral<"error", "required">, import("convex/values").VLiteral<"other", "required">, import("convex/values").VLiteral<"unknown", "required">], "optional", never>;
-    _id: import("convex/values").VString<string, "required">;
-    _creationTime: import("convex/values").VFloat64<number, "required">;
-}, "required", "id" | "status" | "userId" | "order" | "_creationTime" | "threadId" | "parentMessageId" | "stepId" | "stepOrder" | "embeddingId" | "error" | "agentName" | "model" | "provider" | "providerOptions" | "message" | "text" | `providerOptions.${string}` | "reasoning" | "tool" | "files" | "usage" | "providerMetadata" | "sources" | "reasoningDetails" | "warnings" | "finishReason" | "message.providerOptions" | "message.role" | `message.providerOptions.${string}` | "message.content" | "usage.promptTokens" | "usage.completionTokens" | "usage.totalTokens" | `providerMetadata.${string}` | "_id">;
-export type MessageDoc = Infer<typeof vMessageDoc>;
 type MessageWithMetadata = OpaqueIds<InnerMessageWithMetadata>;
 export declare function toUIMessages(messages: MessageDoc[]): UIMessage[];
 //# sourceMappingURL=index.d.ts.map