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

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

@@ -1,34 +1,29 @@
 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 } from "ai";
+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";
 import { type AIMessageWithoutId } from "../mapping.js";
-import { type CallSettings, MessageWithMetadata, type ProviderMetadata, type ProviderOptions, type SearchOptions, type Usage } from "../validators.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 schema from "../component/schema.js";
+export { extractText, isTool };
 export type { Usage, ProviderMetadata };
-export { vUsage, vProviderMetadata, vUserMessage, vAssistantMessage, vToolMessage, vSystemMessage, vMessage, } from "../validators.js";
-export type ThreadDoc = OpaqueIds<{
-    _id: string;
-    _creationTime: number;
-} & Infer<typeof schema.tables.threads.validator>>;
-export type MessageDoc = OpaqueIds<{
-    _id: string;
-    _creationTime: number;
-} & Infer<typeof schema.tables.messages.validator>>;
+export { paginationResultValidator, 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.
  */
 export type ContextOptions = {
+    /** @deprecated Use excludeToolMessages instead. */
+    includeToolCalls?: boolean;
     /**
      * Whether to include tool messages in the context.
      * By default, tool calls and results are not included.
      */
-    includeToolCalls?: boolean;
+    excludeToolMessages?: boolean;
     /**
      * How many recent messages to include. These are added after the search
      * messages, and do not count against the search limit.
@@ -101,8 +96,9 @@ export type UsageHandler = (ctx: RunActionCtx, args: {
     model: string;
     provider: string;
 }) => void | Promise<void>;
+export type AgentComponent = UseApi<Mounts>;
 export declare class Agent<AgentTools extends ToolSet> {
-    component: UseApi<Mounts>;
+    component: AgentComponent;
     options: {
         /**
          * The name for the agent. This will be attributed on each message
@@ -166,7 +162,7 @@ export declare class Agent<AgentTools extends ToolSet> {
          */
         usageHandler?: UsageHandler;
     };
-    constructor(component: UseApi<Mounts>, options: {
+    constructor(component: AgentComponent, options: {
         /**
          * The name for the agent. This will be attributed on each message
          * created by this agent.
@@ -346,9 +342,14 @@ export declare class Agent<AgentTools extends ToolSet> {
         userId: string | undefined;
         threadId: string | undefined;
         messages: CoreMessage[];
-        parentMessageId?: string;
+        /**
+         * If provided, it will search for messages before this message.
+         * Note: if this is far in the past, the search results may be more
+         * limited, as it's post-filtering the results.
+         */
+        beforeMessageId?: string;
         contextOptions: ContextOptions | undefined;
-    }): Promise<CoreMessage[]>;
+    }): Promise<MessageDoc[]>;
     /**
      * Get the embeddings for a set of messages.
      * @param messages The messages to get the embeddings for.
@@ -381,13 +382,8 @@ export declare class Agent<AgentTools extends ToolSet> {
          */
         pending?: boolean;
         /**
-         * The message that this is responding to.
-         */
-        parentMessageId?: string;
-        /**
-         * Whether to mark all pending messages in the thread as failed.
-         * This is used to recover from a failure via a retry that wipes the slate clean.
-         * Defaults to true.
+         * If true, it will fail any pending steps.
+         * Defaults to false.
          */
         failPendingSteps?: boolean;
     }): Promise<{
@@ -405,7 +401,7 @@ export declare class Agent<AgentTools extends ToolSet> {
         /**
          * The message this step is in response to.
          */
-        messageId: string;
+        parentMessageId: string;
         /**
          * The step to save, possibly including multiple tool calls.
          */
@@ -492,7 +488,7 @@ export declare class Agent<AgentTools extends ToolSet> {
         prompt?: string;
         messages?: CoreMessage[] | AIMessageWithoutId[];
         system?: string;
-    }>(ctx: RunActionCtx | RunMutationCtx, args: T, { userId, threadId, parentMessageId, contextOptions, storageOptions, }: {
+    }>(ctx: RunActionCtx | RunMutationCtx, args: T, { userId, threadId, contextOptions, storageOptions, }: {
         userId: string | undefined;
         threadId: string | undefined;
     } & Options): Promise<{
@@ -543,7 +539,7 @@ export declare class Agent<AgentTools extends ToolSet> {
     saveObject(ctx: RunMutationCtx, args: {
         userId: string | undefined;
         threadId: string;
-        messageId: string;
+        parentMessageId: string;
         result: GenerateObjectResult<unknown>;
         metadata?: Omit<MessageWithMetadata, "message">;
     }): Promise<void>;
@@ -587,69 +583,57 @@ export declare class Agent<AgentTools extends ToolSet> {
     }): import("convex/server").RegisteredAction<"internal", {
         userId?: string | undefined;
         threadId?: string | undefined;
-        parentMessageId?: string | undefined;
         messages?: ({
-            providerOptions?: Record<string, any> | undefined;
-            experimental_providerMetadata?: Record<string, any> | undefined;
+            providerOptions?: Record<string, Record<string, any>> | undefined;
             role: "user";
             content: string | ({
-                providerOptions?: Record<string, any> | undefined;
-                experimental_providerMetadata?: Record<string, any> | undefined;
+                providerOptions?: Record<string, Record<string, any>> | undefined;
                 type: "text";
                 text: string;
             } | {
-                providerOptions?: Record<string, any> | undefined;
-                experimental_providerMetadata?: Record<string, any> | undefined;
+                providerOptions?: Record<string, Record<string, any>> | undefined;
                 mimeType?: string | undefined;
                 type: "image";
                 image: string | ArrayBuffer;
             } | {
-                providerOptions?: Record<string, any> | undefined;
-                experimental_providerMetadata?: Record<string, any> | undefined;
+                providerOptions?: Record<string, Record<string, any>> | undefined;
                 type: "file";
                 mimeType: string;
                 data: string | ArrayBuffer;
             })[];
         } | {
-            providerOptions?: Record<string, any> | undefined;
-            experimental_providerMetadata?: Record<string, any> | undefined;
+            providerOptions?: Record<string, Record<string, any>> | undefined;
             role: "assistant";
             content: string | ({
-                providerOptions?: Record<string, any> | undefined;
-                experimental_providerMetadata?: Record<string, any> | undefined;
+                providerOptions?: Record<string, Record<string, any>> | undefined;
                 type: "text";
                 text: string;
             } | {
-                providerOptions?: Record<string, any> | undefined;
-                experimental_providerMetadata?: Record<string, any> | undefined;
+                providerOptions?: Record<string, Record<string, any>> | undefined;
                 type: "file";
                 mimeType: string;
                 data: string | ArrayBuffer;
             } | {
-                providerOptions?: Record<string, any> | undefined;
-                experimental_providerMetadata?: Record<string, any> | undefined;
+                providerOptions?: Record<string, Record<string, any>> | undefined;
+                signature?: string | undefined;
                 type: "reasoning";
                 text: string;
             } | {
-                providerOptions?: Record<string, any> | undefined;
-                experimental_providerMetadata?: Record<string, any> | undefined;
+                providerOptions?: Record<string, Record<string, any>> | undefined;
                 type: "redacted-reasoning";
                 data: string;
             } | {
-                providerOptions?: Record<string, any> | undefined;
-                experimental_providerMetadata?: Record<string, any> | undefined;
+                providerOptions?: Record<string, Record<string, any>> | undefined;
                 type: "tool-call";
                 toolCallId: string;
                 toolName: string;
                 args: any;
             })[];
         } | {
-            providerOptions?: Record<string, any> | undefined;
-            experimental_providerMetadata?: Record<string, any> | undefined;
+            providerOptions?: Record<string, Record<string, any>> | undefined;
             role: "tool";
             content: {
-                providerOptions?: Record<string, any> | undefined;
-                experimental_providerMetadata?: Record<string, any> | undefined;
+                providerOptions?: Record<string, Record<string, any>> | undefined;
                 args?: any;
                 experimental_content?: ({
                     type: "text";
@@ -666,13 +650,11 @@ export declare class Agent<AgentTools extends ToolSet> {
                 result: any;
             }[];
         } | {
-            providerOptions?: Record<string, any> | undefined;
-            experimental_providerMetadata?: Record<string, any> | undefined;
+            providerOptions?: Record<string, Record<string, any>> | undefined;
             role: "system";
             content: string;
         })[] | undefined;
-        providerOptions?: Record<string, any> | undefined;
-        experimental_providerMetadata?: Record<string, any> | undefined;
+        providerOptions?: Record<string, Record<string, any>> | undefined;
         system?: string | undefined;
         headers?: Record<string, string> | undefined;
         maxTokens?: number | undefined;
@@ -691,7 +673,7 @@ export declare class Agent<AgentTools extends ToolSet> {
         experimental_continueSteps?: boolean | undefined;
         prompt?: string | undefined;
         contextOptions?: {
-            includeToolCalls?: boolean | undefined;
+            excludeToolMessages?: boolean | undefined;
             recentMessages?: number | undefined;
             searchOptions?: {
                 messageRange?: {
@@ -706,7 +688,8 @@ export declare class Agent<AgentTools extends ToolSet> {
         } | undefined;
         storageOptions?: {
             saveAllInputMessages?: boolean | undefined;
-            saveAllOutputMessages?: boolean | undefined;
+            saveAnyInputMessages?: boolean | undefined;
+            saveOutputMessages?: boolean | undefined;
         } | undefined;
     }, Promise<string>>;
     /**
@@ -724,69 +707,57 @@ export declare class Agent<AgentTools extends ToolSet> {
     }): import("convex/server").RegisteredAction<"internal", {
         userId?: string | undefined;
         threadId?: string | undefined;
-        parentMessageId?: string | undefined;
         messages?: ({
-            providerOptions?: Record<string, any> | undefined;
-            experimental_providerMetadata?: Record<string, any> | undefined;
+            providerOptions?: Record<string, Record<string, any>> | undefined;
             role: "user";
             content: string | ({
-                providerOptions?: Record<string, any> | undefined;
-                experimental_providerMetadata?: Record<string, any> | undefined;
+                providerOptions?: Record<string, Record<string, any>> | undefined;
                 type: "text";
                 text: string;
             } | {
-                providerOptions?: Record<string, any> | undefined;
-                experimental_providerMetadata?: Record<string, any> | undefined;
+                providerOptions?: Record<string, Record<string, any>> | undefined;
                 mimeType?: string | undefined;
                 type: "image";
                 image: string | ArrayBuffer;
             } | {
-                providerOptions?: Record<string, any> | undefined;
-                experimental_providerMetadata?: Record<string, any> | undefined;
+                providerOptions?: Record<string, Record<string, any>> | undefined;
                 type: "file";
                 mimeType: string;
                 data: string | ArrayBuffer;
             })[];
         } | {
-            providerOptions?: Record<string, any> | undefined;
-            experimental_providerMetadata?: Record<string, any> | undefined;
+            providerOptions?: Record<string, Record<string, any>> | undefined;
             role: "assistant";
             content: string | ({
-                providerOptions?: Record<string, any> | undefined;
-                experimental_providerMetadata?: Record<string, any> | undefined;
+                providerOptions?: Record<string, Record<string, any>> | undefined;
                 type: "text";
                 text: string;
             } | {
-                providerOptions?: Record<string, any> | undefined;
-                experimental_providerMetadata?: Record<string, any> | undefined;
+                providerOptions?: Record<string, Record<string, any>> | undefined;
                 type: "file";
                 mimeType: string;
                 data: string | ArrayBuffer;
             } | {
-                providerOptions?: Record<string, any> | undefined;
-                experimental_providerMetadata?: Record<string, any> | undefined;
+                providerOptions?: Record<string, Record<string, any>> | undefined;
+                signature?: string | undefined;
                 type: "reasoning";
                 text: string;
             } | {
-                providerOptions?: Record<string, any> | undefined;
-                experimental_providerMetadata?: Record<string, any> | undefined;
+                providerOptions?: Record<string, Record<string, any>> | undefined;
                 type: "redacted-reasoning";
                 data: string;
             } | {
-                providerOptions?: Record<string, any> | undefined;
-                experimental_providerMetadata?: Record<string, any> | undefined;
+                providerOptions?: Record<string, Record<string, any>> | undefined;
                 type: "tool-call";
                 toolCallId: string;
                 toolName: string;
                 args: any;
             })[];
         } | {
-            providerOptions?: Record<string, any> | undefined;
-            experimental_providerMetadata?: Record<string, any> | undefined;
+            providerOptions?: Record<string, Record<string, any>> | undefined;
             role: "tool";
             content: {
-                providerOptions?: Record<string, any> | undefined;
-                experimental_providerMetadata?: Record<string, any> | undefined;
+                providerOptions?: Record<string, Record<string, any>> | undefined;
                 args?: any;
                 experimental_content?: ({
                     type: "text";
@@ -803,13 +774,11 @@ export declare class Agent<AgentTools extends ToolSet> {
                 result: any;
             }[];
         } | {
-            providerOptions?: Record<string, any> | undefined;
-            experimental_providerMetadata?: Record<string, any> | undefined;
+            providerOptions?: Record<string, Record<string, any>> | undefined;
             role: "system";
             content: string;
         })[] | undefined;
-        providerOptions?: Record<string, any> | undefined;
-        experimental_providerMetadata?: Record<string, any> | undefined;
+        providerOptions?: Record<string, Record<string, any>> | undefined;
         system?: string | undefined;
         headers?: Record<string, string> | undefined;
         maxTokens?: number | undefined;
@@ -822,7 +791,7 @@ export declare class Agent<AgentTools extends ToolSet> {
         maxRetries?: number | undefined;
         prompt?: string | undefined;
         contextOptions?: {
-            includeToolCalls?: boolean | undefined;
+            excludeToolMessages?: boolean | undefined;
             recentMessages?: number | undefined;
             searchOptions?: {
                 messageRange?: {
@@ -837,128 +806,73 @@ export declare class Agent<AgentTools extends ToolSet> {
         } | undefined;
         storageOptions?: {
             saveAllInputMessages?: boolean | undefined;
-            saveAllOutputMessages?: boolean | undefined;
+            saveAnyInputMessages?: boolean | undefined;
+            saveOutputMessages?: boolean | undefined;
         } | undefined;
     }, Promise<T>>;
 }
 export declare function filterOutOrphanedToolMessages(docs: MessageDoc[]): {
-    _id: string;
-    _creationTime: number;
     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?: {
-            [x: string]: any;
-        } | undefined;
-        experimental_providerMetadata?: {
-            [x: string]: any;
-        } | undefined;
+        providerOptions?: Record<string, Record<string, any>> | undefined;
         role: "user";
         content: string | ({
-            providerOptions?: {
-                [x: string]: any;
-            } | undefined;
-            experimental_providerMetadata?: {
-                [x: string]: any;
-            } | undefined;
+            providerOptions?: Record<string, Record<string, any>> | undefined;
             type: "text";
             text: string;
         } | {
-            providerOptions?: {
-                [x: string]: any;
-            } | undefined;
-            experimental_providerMetadata?: {
-                [x: string]: any;
-            } | undefined;
+            providerOptions?: Record<string, Record<string, any>> | undefined;
             mimeType?: string | undefined;
             type: "image";
             image: string | ArrayBuffer;
         } | {
-            providerOptions?: {
-                [x: string]: any;
-            } | undefined;
-            experimental_providerMetadata?: {
-                [x: string]: any;
-            } | undefined;
+            providerOptions?: Record<string, Record<string, any>> | undefined;
             type: "file";
             mimeType: string;
             data: string | ArrayBuffer;
         })[];
     } | {
-        providerOptions?: {
-            [x: string]: any;
-        } | undefined;
-        experimental_providerMetadata?: {
-            [x: string]: any;
-        } | undefined;
+        providerOptions?: Record<string, Record<string, any>> | undefined;
         role: "assistant";
         content: string | ({
-            providerOptions?: {
-                [x: string]: any;
-            } | undefined;
-            experimental_providerMetadata?: {
-                [x: string]: any;
-            } | undefined;
+            providerOptions?: Record<string, Record<string, any>> | undefined;
             type: "text";
             text: string;
         } | {
-            providerOptions?: {
-                [x: string]: any;
-            } | undefined;
-            experimental_providerMetadata?: {
-                [x: string]: any;
-            } | undefined;
+            providerOptions?: Record<string, Record<string, any>> | undefined;
             type: "file";
             mimeType: string;
             data: string | ArrayBuffer;
         } | {
-            providerOptions?: {
-                [x: string]: any;
-            } | undefined;
-            experimental_providerMetadata?: {
-                [x: string]: any;
-            } | undefined;
+            providerOptions?: Record<string, Record<string, any>> | undefined;
+            signature?: string | undefined;
             type: "reasoning";
             text: string;
         } | {
-            providerOptions?: {
-                [x: string]: any;
-            } | undefined;
-            experimental_providerMetadata?: {
-                [x: string]: any;
-            } | undefined;
+            providerOptions?: Record<string, Record<string, any>> | undefined;
             type: "redacted-reasoning";
             data: string;
         } | {
-            providerOptions?: {
-                [x: string]: any;
-            } | undefined;
-            experimental_providerMetadata?: {
-                [x: string]: any;
-            } | undefined;
+            providerOptions?: Record<string, Record<string, any>> | undefined;
             type: "tool-call";
             toolCallId: string;
             toolName: string;
             args: any;
         })[];
     } | {
-        providerOptions?: {
-            [x: string]: any;
-        } | undefined;
-        experimental_providerMetadata?: {
-            [x: string]: any;
-        } | undefined;
+        providerOptions?: Record<string, Record<string, any>> | undefined;
         role: "tool";
         content: {
-            providerOptions?: {
-                [x: string]: any;
-            } | undefined;
-            experimental_providerMetadata?: {
-                [x: string]: any;
-            } | undefined;
+            providerOptions?: Record<string, Record<string, any>> | undefined;
             args?: any;
             experimental_content?: ({
                 type: "text";
@@ -975,41 +889,39 @@ export declare function filterOutOrphanedToolMessages(docs: MessageDoc[]): {
             result: any;
         }[];
     } | {
-        providerOptions?: {
-            [x: string]: any;
-        } | undefined;
-        experimental_providerMetadata?: {
-            [x: string]: any;
-        } | undefined;
+        providerOptions?: Record<string, Record<string, any>> | undefined;
         role: "system";
         content: string;
     } | undefined;
     text?: string | undefined;
     reasoning?: string | undefined;
-    error?: string | undefined;
-    model?: string | undefined;
-    provider?: string | undefined;
-    embeddingId?: string | undefined;
+    files?: {
+        bytes?: ArrayBuffer | undefined;
+        url?: string | undefined;
+        fileId?: string | undefined;
+        mimeType: string;
+    }[] | undefined;
     usage?: {
         promptTokens: number;
         completionTokens: number;
         totalTokens: number;
     } | undefined;
-    finishReason?: "length" | "error" | "stop" | "content-filter" | "tool-calls" | "other" | "unknown" | undefined;
-    providerMetadata?: {
-        [x: string]: any;
-    } | undefined;
+    providerMetadata?: Record<string, Record<string, any>> | undefined;
     sources?: {
         title?: string | undefined;
-        providerMetadata?: {
-            [x: string]: {
-                [x: string]: any;
-            };
-        } | undefined;
+        providerOptions?: Record<string, Record<string, any>> | undefined;
         id: string;
-        sourceType: "url";
         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";
@@ -1022,12 +934,14 @@ export declare function filterOutOrphanedToolMessages(docs: MessageDoc[]): {
         type: "other";
         message: string;
     })[] | undefined;
-    fileId?: string | undefined;
+    finishReason?: "length" | "error" | "other" | "stop" | "content-filter" | "tool-calls" | "unknown" | undefined;
     status: "pending" | "success" | "failed";
     order: number;
+    _creationTime: number;
     threadId: string;
-    tool: boolean;
     stepOrder: number;
+    tool: boolean;
+    _id: string;
 }[];
 export type ToolCtx = RunActionCtx & {
     userId?: string;
@@ -1069,10 +983,6 @@ export declare function createTool<PARAMETERS extends ToolParameters, RESULT>(t:
     execute: (args: inferParameters<PARAMETERS>, options: ToolExecutionOptions) => PromiseLike<RESULT>;
 };
 type Options = {
-    /**
-     * The parent message id to use for the tool calls.
-     */
-    parentMessageId?: string;
     /**
      * The context options to use for passing in message history to the LLM.
      */
@@ -1239,4 +1149,711 @@ 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