@convex-dev/agent 0.6.4 → 0.7.0

package/dist/component/messages.d.ts

@@ -31,20 +31,24 @@ export declare const addMessages: import("convex/server").RegisteredMutation<"pu
     pendingMessageId?: import("convex/values").GenericId<"messages"> | undefined;
     threadId: import("convex/values").GenericId<"threads">;
     messages: {
+        text?: string | undefined;
+        reasoning?: string | undefined;
         status?: "pending" | "success" | "failed" | undefined;
         fileIds?: import("convex/values").GenericId<"files">[] | undefined;
         error?: string | undefined;
         model?: string | undefined;
         provider?: string | undefined;
-        text?: string | undefined;
         providerMetadata?: Record<string, Record<string, any>> | undefined;
-        reasoning?: string | undefined;
         usage?: {
+            promptTokens?: number | undefined;
+            completionTokens?: number | undefined;
+            totalTokens?: number | undefined;
             reasoningTokens?: number | undefined;
             cachedInputTokens?: number | undefined;
-            promptTokens: number;
-            completionTokens: number;
-            totalTokens: number;
+            nonCachedInputTokens?: number | undefined;
+            cacheWriteInputTokens?: number | undefined;
+            textOutputTokens?: number | undefined;
+            raw?: Record<string, any> | undefined;
         } | undefined;
         sources?: ({
             title?: string | undefined;
@@ -65,13 +69,25 @@ export declare const addMessages: import("convex/server").RegisteredMutation<"pu
             sourceType: "document";
         })[] | undefined;
         warnings?: ({
+            details?: string | undefined;
+            type: "unsupported";
+            feature: string;
+        } | {
+            details?: string | undefined;
+            type: "compatibility";
+            feature: string;
+        } | {
+            type: "deprecated";
+            message: string;
+            setting: string;
+        } | {
             details?: string | undefined;
             type: "unsupported-setting";
             setting: string;
         } | {
             details?: string | undefined;
-            type: "unsupported-tool";
             tool: any;
+            type: "unsupported-tool";
         } | {
             type: "other";
             message: string;
@@ -81,12 +97,12 @@ export declare const addMessages: import("convex/server").RegisteredMutation<"pu
             providerOptions?: Record<string, Record<string, any>> | undefined;
             providerMetadata?: Record<string, Record<string, any>> | undefined;
             signature?: string | undefined;
-            type: "reasoning";
             text: string;
+            type: "reasoning";
         } | {
             signature?: string | undefined;
-            type: "text";
             text: string;
+            type: "text";
         } | {
             type: "redacted";
             data: string;
@@ -97,14 +113,17 @@ export declare const addMessages: import("convex/server").RegisteredMutation<"pu
             content: string | ({
                 providerOptions?: Record<string, Record<string, any>> | undefined;
                 providerMetadata?: Record<string, Record<string, any>> | undefined;
-                type: "text";
                 text: string;
+                type: "text";
             } | {
                 providerOptions?: Record<string, Record<string, any>> | undefined;
                 mediaType?: string | undefined;
                 mimeType?: string | undefined;
                 type: "image";
-                image: string | ArrayBuffer;
+                image: string | ArrayBuffer | {
+                    type: "reference";
+                    reference: Record<string, string>;
+                };
             } | {
                 providerOptions?: Record<string, Record<string, any>> | undefined;
                 providerMetadata?: Record<string, Record<string, any>> | undefined;
@@ -112,7 +131,10 @@ export declare const addMessages: import("convex/server").RegisteredMutation<"pu
                 mimeType?: string | undefined;
                 filename?: string | undefined;
                 type: "file";
-                data: string | ArrayBuffer;
+                data: string | ArrayBuffer | {
+                    type: "reference";
+                    reference: Record<string, string>;
+                };
             })[];
         } | {
             providerOptions?: Record<string, Record<string, any>> | undefined;
@@ -120,8 +142,8 @@ export declare const addMessages: import("convex/server").RegisteredMutation<"pu
             content: string | ({
                 providerOptions?: Record<string, Record<string, any>> | undefined;
                 providerMetadata?: Record<string, Record<string, any>> | undefined;
-                type: "text";
                 text: string;
+                type: "text";
             } | {
                 providerOptions?: Record<string, Record<string, any>> | undefined;
                 providerMetadata?: Record<string, Record<string, any>> | undefined;
@@ -129,32 +151,51 @@ export declare const addMessages: import("convex/server").RegisteredMutation<"pu
                 mimeType?: string | undefined;
                 filename?: string | undefined;
                 type: "file";
-                data: string | ArrayBuffer;
+                data: string | ArrayBuffer | {
+                    type: "reference";
+                    reference: Record<string, string>;
+                };
             } | {
                 providerOptions?: Record<string, Record<string, any>> | undefined;
                 providerMetadata?: Record<string, Record<string, any>> | undefined;
                 signature?: string | undefined;
-                type: "reasoning";
                 text: string;
+                type: "reasoning";
+            } | {
+                providerOptions?: Record<string, Record<string, any>> | undefined;
+                providerMetadata?: Record<string, Record<string, any>> | undefined;
+                data?: string | ArrayBuffer | undefined;
+                url?: string | undefined;
+                type: "reasoning-file";
+                mediaType: string;
+            } | {
+                providerOptions?: Record<string, Record<string, any>> | undefined;
+                providerMetadata?: Record<string, Record<string, any>> | undefined;
+                type: "custom";
+                kind: string;
             } | {
                 providerOptions?: Record<string, Record<string, any>> | undefined;
                 providerMetadata?: Record<string, Record<string, any>> | undefined;
                 type: "redacted-reasoning";
                 data: string;
             } | {
+                title?: string | undefined;
                 providerOptions?: Record<string, Record<string, any>> | undefined;
                 providerMetadata?: Record<string, Record<string, any>> | undefined;
                 args?: any;
                 providerExecuted?: boolean | undefined;
+                toolMetadata?: Record<string, any> | undefined;
                 type: "tool-call";
                 toolCallId: string;
                 toolName: string;
                 input: any;
             } | {
+                title?: string | undefined;
                 providerOptions?: Record<string, Record<string, any>> | undefined;
                 providerMetadata?: Record<string, Record<string, any>> | undefined;
                 input?: any;
                 providerExecuted?: boolean | undefined;
+                toolMetadata?: Record<string, any> | undefined;
                 type: "tool-call";
                 toolCallId: string;
                 toolName: string;
@@ -188,8 +229,26 @@ export declare const addMessages: import("convex/server").RegisteredMutation<"pu
                     type: "content";
                     value: ({
                         providerOptions?: Record<string, Record<string, any>> | undefined;
-                        type: "text";
                         text: string;
+                        type: "text";
+                    } | {
+                        providerOptions?: Record<string, Record<string, any>> | undefined;
+                        filename?: string | undefined;
+                        type: "file";
+                        mediaType: string;
+                        data: {
+                            type: "reference";
+                            reference: Record<string, string>;
+                        } | {
+                            type: "url";
+                            url: string;
+                        } | {
+                            type: "data";
+                            data: string | ArrayBuffer;
+                        } | {
+                            text: string;
+                            type: "text";
+                        };
                     } | {
                         type: "media";
                         mediaType: string;
@@ -202,17 +261,26 @@ export declare const addMessages: import("convex/server").RegisteredMutation<"pu
                         data: string;
                     } | {
                         providerOptions?: Record<string, Record<string, any>> | undefined;
+                        mediaType?: string | undefined;
                         type: "file-url";
                         url: string;
                     } | {
                         providerOptions?: Record<string, Record<string, any>> | undefined;
                         type: "file-id";
                         fileId: string | Record<string, string>;
+                    } | {
+                        providerOptions?: Record<string, Record<string, any>> | undefined;
+                        type: "file-reference";
+                        providerReference: Record<string, string>;
                     } | {
                         providerOptions?: Record<string, Record<string, any>> | undefined;
                         type: "image-data";
                         mediaType: string;
                         data: string;
+                    } | {
+                        providerOptions?: Record<string, Record<string, any>> | undefined;
+                        type: "image-file-reference";
+                        providerReference: Record<string, string>;
                     } | {
                         providerOptions?: Record<string, Record<string, any>> | undefined;
                         type: "image-url";
@@ -229,8 +297,8 @@ export declare const addMessages: import("convex/server").RegisteredMutation<"pu
                 result?: any;
                 isError?: boolean | undefined;
                 experimental_content?: ({
-                    type: "text";
                     text: string;
+                    type: "text";
                 } | {
                     mimeType?: string | undefined;
                     type: "image";
@@ -259,6 +327,8 @@ export declare const addMessages: import("convex/server").RegisteredMutation<"pu
             } | {
                 providerOptions?: Record<string, Record<string, any>> | undefined;
                 providerMetadata?: Record<string, Record<string, any>> | undefined;
+                signature?: string | undefined;
+                isAutomatic?: boolean | undefined;
                 type: "tool-approval-request";
                 toolCallId: string;
                 approvalId: string;
@@ -295,8 +365,26 @@ export declare const addMessages: import("convex/server").RegisteredMutation<"pu
                     type: "content";
                     value: ({
                         providerOptions?: Record<string, Record<string, any>> | undefined;
-                        type: "text";
                         text: string;
+                        type: "text";
+                    } | {
+                        providerOptions?: Record<string, Record<string, any>> | undefined;
+                        filename?: string | undefined;
+                        type: "file";
+                        mediaType: string;
+                        data: {
+                            type: "reference";
+                            reference: Record<string, string>;
+                        } | {
+                            type: "url";
+                            url: string;
+                        } | {
+                            type: "data";
+                            data: string | ArrayBuffer;
+                        } | {
+                            text: string;
+                            type: "text";
+                        };
                     } | {
                         type: "media";
                         mediaType: string;
@@ -309,17 +397,26 @@ export declare const addMessages: import("convex/server").RegisteredMutation<"pu
                         data: string;
                     } | {
                         providerOptions?: Record<string, Record<string, any>> | undefined;
+                        mediaType?: string | undefined;
                         type: "file-url";
                         url: string;
                     } | {
                         providerOptions?: Record<string, Record<string, any>> | undefined;
                         type: "file-id";
                         fileId: string | Record<string, string>;
+                    } | {
+                        providerOptions?: Record<string, Record<string, any>> | undefined;
+                        type: "file-reference";
+                        providerReference: Record<string, string>;
                     } | {
                         providerOptions?: Record<string, Record<string, any>> | undefined;
                         type: "image-data";
                         mediaType: string;
                         data: string;
+                    } | {
+                        providerOptions?: Record<string, Record<string, any>> | undefined;
+                        type: "image-file-reference";
+                        providerReference: Record<string, string>;
                     } | {
                         providerOptions?: Record<string, Record<string, any>> | undefined;
                         type: "image-url";
@@ -336,8 +433,8 @@ export declare const addMessages: import("convex/server").RegisteredMutation<"pu
                 result?: any;
                 isError?: boolean | undefined;
                 experimental_content?: ({
-                    type: "text";
                     text: string;
+                    type: "text";
                 } | {
                     mimeType?: string | undefined;
                     type: "image";
@@ -363,6 +460,8 @@ export declare const addMessages: import("convex/server").RegisteredMutation<"pu
     }[];
 }, Promise<{
     messages: {
+        text?: string | undefined;
+        reasoning?: string | undefined;
         id?: string | undefined;
         userId?: string | undefined;
         embeddingId?: string | undefined;
@@ -378,14 +477,17 @@ export declare const addMessages: import("convex/server").RegisteredMutation<"pu
             content: string | ({
                 providerOptions?: Record<string, Record<string, any>> | undefined;
                 providerMetadata?: Record<string, Record<string, any>> | undefined;
-                type: "text";
                 text: string;
+                type: "text";
             } | {
                 providerOptions?: Record<string, Record<string, any>> | undefined;
                 mediaType?: string | undefined;
                 mimeType?: string | undefined;
                 type: "image";
-                image: string | ArrayBuffer;
+                image: string | ArrayBuffer | {
+                    type: "reference";
+                    reference: Record<string, string>;
+                };
             } | {
                 providerOptions?: Record<string, Record<string, any>> | undefined;
                 providerMetadata?: Record<string, Record<string, any>> | undefined;
@@ -393,7 +495,10 @@ export declare const addMessages: import("convex/server").RegisteredMutation<"pu
                 mimeType?: string | undefined;
                 filename?: string | undefined;
                 type: "file";
-                data: string | ArrayBuffer;
+                data: string | ArrayBuffer | {
+                    type: "reference";
+                    reference: Record<string, string>;
+                };
             })[];
         } | {
             providerOptions?: Record<string, Record<string, any>> | undefined;
@@ -401,8 +506,8 @@ export declare const addMessages: import("convex/server").RegisteredMutation<"pu
             content: string | ({
                 providerOptions?: Record<string, Record<string, any>> | undefined;
                 providerMetadata?: Record<string, Record<string, any>> | undefined;
-                type: "text";
                 text: string;
+                type: "text";
             } | {
                 providerOptions?: Record<string, Record<string, any>> | undefined;
                 providerMetadata?: Record<string, Record<string, any>> | undefined;
@@ -410,32 +515,51 @@ export declare const addMessages: import("convex/server").RegisteredMutation<"pu
                 mimeType?: string | undefined;
                 filename?: string | undefined;
                 type: "file";
-                data: string | ArrayBuffer;
+                data: string | ArrayBuffer | {
+                    type: "reference";
+                    reference: Record<string, string>;
+                };
             } | {
                 providerOptions?: Record<string, Record<string, any>> | undefined;
                 providerMetadata?: Record<string, Record<string, any>> | undefined;
                 signature?: string | undefined;
-                type: "reasoning";
                 text: string;
+                type: "reasoning";
+            } | {
+                providerOptions?: Record<string, Record<string, any>> | undefined;
+                providerMetadata?: Record<string, Record<string, any>> | undefined;
+                data?: string | ArrayBuffer | undefined;
+                url?: string | undefined;
+                type: "reasoning-file";
+                mediaType: string;
+            } | {
+                providerOptions?: Record<string, Record<string, any>> | undefined;
+                providerMetadata?: Record<string, Record<string, any>> | undefined;
+                type: "custom";
+                kind: string;
             } | {
                 providerOptions?: Record<string, Record<string, any>> | undefined;
                 providerMetadata?: Record<string, Record<string, any>> | undefined;
                 type: "redacted-reasoning";
                 data: string;
             } | {
+                title?: string | undefined;
                 providerOptions?: Record<string, Record<string, any>> | undefined;
                 providerMetadata?: Record<string, Record<string, any>> | undefined;
                 args?: any;
                 providerExecuted?: boolean | undefined;
+                toolMetadata?: Record<string, any> | undefined;
                 type: "tool-call";
                 toolCallId: string;
                 toolName: string;
                 input: any;
             } | {
+                title?: string | undefined;
                 providerOptions?: Record<string, Record<string, any>> | undefined;
                 providerMetadata?: Record<string, Record<string, any>> | undefined;
                 input?: any;
                 providerExecuted?: boolean | undefined;
+                toolMetadata?: Record<string, any> | undefined;
                 type: "tool-call";
                 toolCallId: string;
                 toolName: string;
@@ -469,8 +593,26 @@ export declare const addMessages: import("convex/server").RegisteredMutation<"pu
                     type: "content";
                     value: ({
                         providerOptions?: Record<string, Record<string, any>> | undefined;
-                        type: "text";
                         text: string;
+                        type: "text";
+                    } | {
+                        providerOptions?: Record<string, Record<string, any>> | undefined;
+                        filename?: string | undefined;
+                        type: "file";
+                        mediaType: string;
+                        data: {
+                            type: "reference";
+                            reference: Record<string, string>;
+                        } | {
+                            type: "url";
+                            url: string;
+                        } | {
+                            type: "data";
+                            data: string | ArrayBuffer;
+                        } | {
+                            text: string;
+                            type: "text";
+                        };
                     } | {
                         type: "media";
                         mediaType: string;
@@ -483,17 +625,26 @@ export declare const addMessages: import("convex/server").RegisteredMutation<"pu
                         data: string;
                     } | {
                         providerOptions?: Record<string, Record<string, any>> | undefined;
+                        mediaType?: string | undefined;
                         type: "file-url";
                         url: string;
                     } | {
                         providerOptions?: Record<string, Record<string, any>> | undefined;
                         type: "file-id";
                         fileId: string | Record<string, string>;
+                    } | {
+                        providerOptions?: Record<string, Record<string, any>> | undefined;
+                        type: "file-reference";
+                        providerReference: Record<string, string>;
                     } | {
                         providerOptions?: Record<string, Record<string, any>> | undefined;
                         type: "image-data";
                         mediaType: string;
                         data: string;
+                    } | {
+                        providerOptions?: Record<string, Record<string, any>> | undefined;
+                        type: "image-file-reference";
+                        providerReference: Record<string, string>;
                     } | {
                         providerOptions?: Record<string, Record<string, any>> | undefined;
                         type: "image-url";
@@ -510,8 +661,8 @@ export declare const addMessages: import("convex/server").RegisteredMutation<"pu
                 result?: any;
                 isError?: boolean | undefined;
                 experimental_content?: ({
-                    type: "text";
                     text: string;
+                    type: "text";
                 } | {
                     mimeType?: string | undefined;
                     type: "image";
@@ -540,6 +691,8 @@ export declare const addMessages: import("convex/server").RegisteredMutation<"pu
             } | {
                 providerOptions?: Record<string, Record<string, any>> | undefined;
                 providerMetadata?: Record<string, Record<string, any>> | undefined;
+                signature?: string | undefined;
+                isAutomatic?: boolean | undefined;
                 type: "tool-approval-request";
                 toolCallId: string;
                 approvalId: string;
@@ -576,8 +729,26 @@ export declare const addMessages: import("convex/server").RegisteredMutation<"pu
                     type: "content";
                     value: ({
                         providerOptions?: Record<string, Record<string, any>> | undefined;
-                        type: "text";
                         text: string;
+                        type: "text";
+                    } | {
+                        providerOptions?: Record<string, Record<string, any>> | undefined;
+                        filename?: string | undefined;
+                        type: "file";
+                        mediaType: string;
+                        data: {
+                            type: "reference";
+                            reference: Record<string, string>;
+                        } | {
+                            type: "url";
+                            url: string;
+                        } | {
+                            type: "data";
+                            data: string | ArrayBuffer;
+                        } | {
+                            text: string;
+                            type: "text";
+                        };
                     } | {
                         type: "media";
                         mediaType: string;
@@ -590,17 +761,26 @@ export declare const addMessages: import("convex/server").RegisteredMutation<"pu
                         data: string;
                     } | {
                         providerOptions?: Record<string, Record<string, any>> | undefined;
+                        mediaType?: string | undefined;
                         type: "file-url";
                         url: string;
                     } | {
                         providerOptions?: Record<string, Record<string, any>> | undefined;
                         type: "file-id";
                         fileId: string | Record<string, string>;
+                    } | {
+                        providerOptions?: Record<string, Record<string, any>> | undefined;
+                        type: "file-reference";
+                        providerReference: Record<string, string>;
                     } | {
                         providerOptions?: Record<string, Record<string, any>> | undefined;
                         type: "image-data";
                         mediaType: string;
                         data: string;
+                    } | {
+                        providerOptions?: Record<string, Record<string, any>> | undefined;
+                        type: "image-file-reference";
+                        providerReference: Record<string, string>;
                     } | {
                         providerOptions?: Record<string, Record<string, any>> | undefined;
                         type: "image-url";
@@ -617,8 +797,8 @@ export declare const addMessages: import("convex/server").RegisteredMutation<"pu
                 result?: any;
                 isError?: boolean | undefined;
                 experimental_content?: ({
-                    type: "text";
                     text: string;
+                    type: "text";
                 } | {
                     mimeType?: string | undefined;
                     type: "image";
@@ -641,15 +821,17 @@ export declare const addMessages: import("convex/server").RegisteredMutation<"pu
             role: "system";
             content: string;
         } | undefined;
-        text?: string | undefined;
         providerMetadata?: Record<string, Record<string, any>> | undefined;
-        reasoning?: string | undefined;
         usage?: {
+            promptTokens?: number | undefined;
+            completionTokens?: number | undefined;
+            totalTokens?: number | undefined;
             reasoningTokens?: number | undefined;
             cachedInputTokens?: number | undefined;
-            promptTokens: number;
-            completionTokens: number;
-            totalTokens: number;
+            nonCachedInputTokens?: number | undefined;
+            cacheWriteInputTokens?: number | undefined;
+            textOutputTokens?: number | undefined;
+            raw?: Record<string, any> | undefined;
         } | undefined;
         sources?: ({
             title?: string | undefined;
@@ -670,13 +852,25 @@ export declare const addMessages: import("convex/server").RegisteredMutation<"pu
             sourceType: "document";
         })[] | undefined;
         warnings?: ({
+            details?: string | undefined;
+            type: "unsupported";
+            feature: string;
+        } | {
+            details?: string | undefined;
+            type: "compatibility";
+            feature: string;
+        } | {
+            type: "deprecated";
+            message: string;
+            setting: string;
+        } | {
             details?: string | undefined;
             type: "unsupported-setting";
             setting: string;
         } | {
             details?: string | undefined;
-            type: "unsupported-tool";
             tool: any;
+            type: "unsupported-tool";
         } | {
             type: "other";
             message: string;
@@ -686,28 +880,30 @@ export declare const addMessages: import("convex/server").RegisteredMutation<"pu
             providerOptions?: Record<string, Record<string, any>> | undefined;
             providerMetadata?: Record<string, Record<string, any>> | undefined;
             signature?: string | undefined;
-            type: "reasoning";
             text: string;
+            type: "reasoning";
         } | {
             signature?: string | undefined;
-            type: "text";
             text: string;
+            type: "text";
         } | {
             type: "redacted";
             data: string;
         })[] | undefined;
+        tool: boolean;
         status: "pending" | "success" | "failed";
         order: number;
         _creationTime: number;
         threadId: string;
         stepOrder: number;
-        tool: boolean;
         _id: string;
     }[];
 }>>;
 export declare function getMaxMessage(ctx: QueryCtx, threadId: Id<"threads">, order?: number): Promise<{
     _id: import("convex/values").GenericId<"messages">;
     _creationTime: number;
+    text?: string | undefined;
+    reasoning?: string | undefined;
     id?: string | undefined;
     userId?: string | undefined;
     embeddingId?: import("convex/values").GenericId<"embeddings_128" | "embeddings_256" | "embeddings_512" | "embeddings_768" | "embeddings_1024" | "embeddings_1408" | "embeddings_1536" | "embeddings_2048" | "embeddings_3072" | "embeddings_4096"> | undefined;
@@ -724,14 +920,17 @@ export declare function getMaxMessage(ctx: QueryCtx, threadId: Id<"threads">, or
         content: string | ({
             providerOptions?: Record<string, Record<string, any>> | undefined;
             providerMetadata?: Record<string, Record<string, any>> | undefined;
-            type: "text";
             text: string;
+            type: "text";
         } | {
             providerOptions?: Record<string, Record<string, any>> | undefined;
             mediaType?: string | undefined;
             mimeType?: string | undefined;
             type: "image";
-            image: string | ArrayBuffer;
+            image: string | ArrayBuffer | {
+                type: "reference";
+                reference: Record<string, string>;
+            };
         } | {
             providerOptions?: Record<string, Record<string, any>> | undefined;
             providerMetadata?: Record<string, Record<string, any>> | undefined;
@@ -739,7 +938,10 @@ export declare function getMaxMessage(ctx: QueryCtx, threadId: Id<"threads">, or
             mimeType?: string | undefined;
             filename?: string | undefined;
             type: "file";
-            data: string | ArrayBuffer;
+            data: string | ArrayBuffer | {
+                type: "reference";
+                reference: Record<string, string>;
+            };
         })[];
     } | {
         providerOptions?: Record<string, Record<string, any>> | undefined;
@@ -747,8 +949,8 @@ export declare function getMaxMessage(ctx: QueryCtx, threadId: Id<"threads">, or
         content: string | ({
             providerOptions?: Record<string, Record<string, any>> | undefined;
             providerMetadata?: Record<string, Record<string, any>> | undefined;
-            type: "text";
             text: string;
+            type: "text";
         } | {
             providerOptions?: Record<string, Record<string, any>> | undefined;
             providerMetadata?: Record<string, Record<string, any>> | undefined;
@@ -756,32 +958,51 @@ export declare function getMaxMessage(ctx: QueryCtx, threadId: Id<"threads">, or
             mimeType?: string | undefined;
             filename?: string | undefined;
             type: "file";
-            data: string | ArrayBuffer;
+            data: string | ArrayBuffer | {
+                type: "reference";
+                reference: Record<string, string>;
+            };
         } | {
             providerOptions?: Record<string, Record<string, any>> | undefined;
             providerMetadata?: Record<string, Record<string, any>> | undefined;
             signature?: string | undefined;
-            type: "reasoning";
             text: string;
+            type: "reasoning";
+        } | {
+            providerOptions?: Record<string, Record<string, any>> | undefined;
+            providerMetadata?: Record<string, Record<string, any>> | undefined;
+            data?: string | ArrayBuffer | undefined;
+            url?: string | undefined;
+            type: "reasoning-file";
+            mediaType: string;
+        } | {
+            providerOptions?: Record<string, Record<string, any>> | undefined;
+            providerMetadata?: Record<string, Record<string, any>> | undefined;
+            type: "custom";
+            kind: string;
         } | {
             providerOptions?: Record<string, Record<string, any>> | undefined;
             providerMetadata?: Record<string, Record<string, any>> | undefined;
             type: "redacted-reasoning";
             data: string;
         } | {
+            title?: string | undefined;
             providerOptions?: Record<string, Record<string, any>> | undefined;
             providerMetadata?: Record<string, Record<string, any>> | undefined;
             args?: any;
             providerExecuted?: boolean | undefined;
+            toolMetadata?: Record<string, any> | undefined;
             type: "tool-call";
             toolCallId: string;
             toolName: string;
             input: any;
         } | {
+            title?: string | undefined;
             providerOptions?: Record<string, Record<string, any>> | undefined;
             providerMetadata?: Record<string, Record<string, any>> | undefined;
             input?: any;
             providerExecuted?: boolean | undefined;
+            toolMetadata?: Record<string, any> | undefined;
             type: "tool-call";
             toolCallId: string;
             toolName: string;
@@ -815,8 +1036,26 @@ export declare function getMaxMessage(ctx: QueryCtx, threadId: Id<"threads">, or
                 type: "content";
                 value: ({
                     providerOptions?: Record<string, Record<string, any>> | undefined;
-                    type: "text";
                     text: string;
+                    type: "text";
+                } | {
+                    providerOptions?: Record<string, Record<string, any>> | undefined;
+                    filename?: string | undefined;
+                    type: "file";
+                    mediaType: string;
+                    data: {
+                        type: "reference";
+                        reference: Record<string, string>;
+                    } | {
+                        type: "url";
+                        url: string;
+                    } | {
+                        type: "data";
+                        data: string | ArrayBuffer;
+                    } | {
+                        text: string;
+                        type: "text";
+                    };
                 } | {
                     type: "media";
                     mediaType: string;
@@ -829,17 +1068,26 @@ export declare function getMaxMessage(ctx: QueryCtx, threadId: Id<"threads">, or
                     data: string;
                 } | {
                     providerOptions?: Record<string, Record<string, any>> | undefined;
+                    mediaType?: string | undefined;
                     type: "file-url";
                     url: string;
                 } | {
                     providerOptions?: Record<string, Record<string, any>> | undefined;
                     type: "file-id";
                     fileId: string | Record<string, string>;
+                } | {
+                    providerOptions?: Record<string, Record<string, any>> | undefined;
+                    type: "file-reference";
+                    providerReference: Record<string, string>;
                 } | {
                     providerOptions?: Record<string, Record<string, any>> | undefined;
                     type: "image-data";
                     mediaType: string;
                     data: string;
+                } | {
+                    providerOptions?: Record<string, Record<string, any>> | undefined;
+                    type: "image-file-reference";
+                    providerReference: Record<string, string>;
                 } | {
                     providerOptions?: Record<string, Record<string, any>> | undefined;
                     type: "image-url";
@@ -856,8 +1104,8 @@ export declare function getMaxMessage(ctx: QueryCtx, threadId: Id<"threads">, or
             result?: any;
             isError?: boolean | undefined;
             experimental_content?: ({
-                type: "text";
                 text: string;
+                type: "text";
             } | {
                 mimeType?: string | undefined;
                 type: "image";
@@ -886,6 +1134,8 @@ export declare function getMaxMessage(ctx: QueryCtx, threadId: Id<"threads">, or
         } | {
             providerOptions?: Record<string, Record<string, any>> | undefined;
             providerMetadata?: Record<string, Record<string, any>> | undefined;
+            signature?: string | undefined;
+            isAutomatic?: boolean | undefined;
             type: "tool-approval-request";
             toolCallId: string;
             approvalId: string;
@@ -922,8 +1172,26 @@ export declare function getMaxMessage(ctx: QueryCtx, threadId: Id<"threads">, or
                 type: "content";
                 value: ({
                     providerOptions?: Record<string, Record<string, any>> | undefined;
-                    type: "text";
                     text: string;
+                    type: "text";
+                } | {
+                    providerOptions?: Record<string, Record<string, any>> | undefined;
+                    filename?: string | undefined;
+                    type: "file";
+                    mediaType: string;
+                    data: {
+                        type: "reference";
+                        reference: Record<string, string>;
+                    } | {
+                        type: "url";
+                        url: string;
+                    } | {
+                        type: "data";
+                        data: string | ArrayBuffer;
+                    } | {
+                        text: string;
+                        type: "text";
+                    };
                 } | {
                     type: "media";
                     mediaType: string;
@@ -936,17 +1204,26 @@ export declare function getMaxMessage(ctx: QueryCtx, threadId: Id<"threads">, or
                     data: string;
                 } | {
                     providerOptions?: Record<string, Record<string, any>> | undefined;
+                    mediaType?: string | undefined;
                     type: "file-url";
                     url: string;
                 } | {
                     providerOptions?: Record<string, Record<string, any>> | undefined;
                     type: "file-id";
                     fileId: string | Record<string, string>;
+                } | {
+                    providerOptions?: Record<string, Record<string, any>> | undefined;
+                    type: "file-reference";
+                    providerReference: Record<string, string>;
                 } | {
                     providerOptions?: Record<string, Record<string, any>> | undefined;
                     type: "image-data";
                     mediaType: string;
                     data: string;
+                } | {
+                    providerOptions?: Record<string, Record<string, any>> | undefined;
+                    type: "image-file-reference";
+                    providerReference: Record<string, string>;
                 } | {
                     providerOptions?: Record<string, Record<string, any>> | undefined;
                     type: "image-url";
@@ -963,8 +1240,8 @@ export declare function getMaxMessage(ctx: QueryCtx, threadId: Id<"threads">, or
             result?: any;
             isError?: boolean | undefined;
             experimental_content?: ({
-                type: "text";
                 text: string;
+                type: "text";
             } | {
                 mimeType?: string | undefined;
                 type: "image";
@@ -987,15 +1264,17 @@ export declare function getMaxMessage(ctx: QueryCtx, threadId: Id<"threads">, or
         role: "system";
         content: string;
     } | undefined;
-    text?: string | undefined;
     providerMetadata?: Record<string, Record<string, any>> | undefined;
-    reasoning?: string | undefined;
     usage?: {
+        promptTokens?: number | undefined;
+        completionTokens?: number | undefined;
+        totalTokens?: number | undefined;
         reasoningTokens?: number | undefined;
         cachedInputTokens?: number | undefined;
-        promptTokens: number;
-        completionTokens: number;
-        totalTokens: number;
+        nonCachedInputTokens?: number | undefined;
+        cacheWriteInputTokens?: number | undefined;
+        textOutputTokens?: number | undefined;
+        raw?: Record<string, any> | undefined;
     } | undefined;
     sources?: ({
         title?: string | undefined;
@@ -1016,13 +1295,25 @@ export declare function getMaxMessage(ctx: QueryCtx, threadId: Id<"threads">, or
         sourceType: "document";
     })[] | undefined;
     warnings?: ({
+        details?: string | undefined;
+        type: "unsupported";
+        feature: string;
+    } | {
+        details?: string | undefined;
+        type: "compatibility";
+        feature: string;
+    } | {
+        type: "deprecated";
+        message: string;
+        setting: string;
+    } | {
         details?: string | undefined;
         type: "unsupported-setting";
         setting: string;
     } | {
         details?: string | undefined;
-        type: "unsupported-tool";
         tool: any;
+        type: "unsupported-tool";
     } | {
         type: "other";
         message: string;
@@ -1032,23 +1323,23 @@ export declare function getMaxMessage(ctx: QueryCtx, threadId: Id<"threads">, or
         providerOptions?: Record<string, Record<string, any>> | undefined;
         providerMetadata?: Record<string, Record<string, any>> | undefined;
         signature?: string | undefined;
-        type: "reasoning";
         text: string;
+        type: "reasoning";
     } | {
         signature?: string | undefined;
-        type: "text";
         text: string;
+        type: "text";
     } | {
         type: "redacted";
         data: string;
     })[] | undefined;
     parentMessageId?: import("convex/values").GenericId<"messages"> | undefined;
     stepId?: string | undefined;
+    tool: boolean;
     status: "pending" | "success" | "failed";
     order: number;
     threadId: import("convex/values").GenericId<"threads">;
     stepOrder: number;
-    tool: boolean;
 } | null>;
 export declare const finalizeMessage: import("convex/server").RegisteredMutation<"public", {
     result: {
@@ -1074,14 +1365,17 @@ export declare const updateMessage: import("convex/server").RegisteredMutation<"
             content: string | ({
                 providerOptions?: Record<string, Record<string, any>> | undefined;
                 providerMetadata?: Record<string, Record<string, any>> | undefined;
-                type: "text";
                 text: string;
+                type: "text";
             } | {
                 providerOptions?: Record<string, Record<string, any>> | undefined;
                 mediaType?: string | undefined;
                 mimeType?: string | undefined;
                 type: "image";
-                image: string | ArrayBuffer;
+                image: string | ArrayBuffer | {
+                    type: "reference";
+                    reference: Record<string, string>;
+                };
             } | {
                 providerOptions?: Record<string, Record<string, any>> | undefined;
                 providerMetadata?: Record<string, Record<string, any>> | undefined;
@@ -1089,7 +1383,10 @@ export declare const updateMessage: import("convex/server").RegisteredMutation<"
                 mimeType?: string | undefined;
                 filename?: string | undefined;
                 type: "file";
-                data: string | ArrayBuffer;
+                data: string | ArrayBuffer | {
+                    type: "reference";
+                    reference: Record<string, string>;
+                };
             })[];
         } | {
             providerOptions?: Record<string, Record<string, any>> | undefined;
@@ -1097,8 +1394,8 @@ export declare const updateMessage: import("convex/server").RegisteredMutation<"
             content: string | ({
                 providerOptions?: Record<string, Record<string, any>> | undefined;
                 providerMetadata?: Record<string, Record<string, any>> | undefined;
-                type: "text";
                 text: string;
+                type: "text";
             } | {
                 providerOptions?: Record<string, Record<string, any>> | undefined;
                 providerMetadata?: Record<string, Record<string, any>> | undefined;
@@ -1106,32 +1403,51 @@ export declare const updateMessage: import("convex/server").RegisteredMutation<"
                 mimeType?: string | undefined;
                 filename?: string | undefined;
                 type: "file";
-                data: string | ArrayBuffer;
+                data: string | ArrayBuffer | {
+                    type: "reference";
+                    reference: Record<string, string>;
+                };
             } | {
                 providerOptions?: Record<string, Record<string, any>> | undefined;
                 providerMetadata?: Record<string, Record<string, any>> | undefined;
                 signature?: string | undefined;
-                type: "reasoning";
                 text: string;
+                type: "reasoning";
+            } | {
+                providerOptions?: Record<string, Record<string, any>> | undefined;
+                providerMetadata?: Record<string, Record<string, any>> | undefined;
+                data?: string | ArrayBuffer | undefined;
+                url?: string | undefined;
+                type: "reasoning-file";
+                mediaType: string;
+            } | {
+                providerOptions?: Record<string, Record<string, any>> | undefined;
+                providerMetadata?: Record<string, Record<string, any>> | undefined;
+                type: "custom";
+                kind: string;
             } | {
                 providerOptions?: Record<string, Record<string, any>> | undefined;
                 providerMetadata?: Record<string, Record<string, any>> | undefined;
                 type: "redacted-reasoning";
                 data: string;
             } | {
+                title?: string | undefined;
                 providerOptions?: Record<string, Record<string, any>> | undefined;
                 providerMetadata?: Record<string, Record<string, any>> | undefined;
                 args?: any;
                 providerExecuted?: boolean | undefined;
+                toolMetadata?: Record<string, any> | undefined;
                 type: "tool-call";
                 toolCallId: string;
                 toolName: string;
                 input: any;
             } | {
+                title?: string | undefined;
                 providerOptions?: Record<string, Record<string, any>> | undefined;
                 providerMetadata?: Record<string, Record<string, any>> | undefined;
                 input?: any;
                 providerExecuted?: boolean | undefined;
+                toolMetadata?: Record<string, any> | undefined;
                 type: "tool-call";
                 toolCallId: string;
                 toolName: string;
@@ -1165,8 +1481,26 @@ export declare const updateMessage: import("convex/server").RegisteredMutation<"
                     type: "content";
                     value: ({
                         providerOptions?: Record<string, Record<string, any>> | undefined;
-                        type: "text";
                         text: string;
+                        type: "text";
+                    } | {
+                        providerOptions?: Record<string, Record<string, any>> | undefined;
+                        filename?: string | undefined;
+                        type: "file";
+                        mediaType: string;
+                        data: {
+                            type: "reference";
+                            reference: Record<string, string>;
+                        } | {
+                            type: "url";
+                            url: string;
+                        } | {
+                            type: "data";
+                            data: string | ArrayBuffer;
+                        } | {
+                            text: string;
+                            type: "text";
+                        };
                     } | {
                         type: "media";
                         mediaType: string;
@@ -1179,17 +1513,26 @@ export declare const updateMessage: import("convex/server").RegisteredMutation<"
                         data: string;
                     } | {
                         providerOptions?: Record<string, Record<string, any>> | undefined;
+                        mediaType?: string | undefined;
                         type: "file-url";
                         url: string;
                     } | {
                         providerOptions?: Record<string, Record<string, any>> | undefined;
                         type: "file-id";
                         fileId: string | Record<string, string>;
+                    } | {
+                        providerOptions?: Record<string, Record<string, any>> | undefined;
+                        type: "file-reference";
+                        providerReference: Record<string, string>;
                     } | {
                         providerOptions?: Record<string, Record<string, any>> | undefined;
                         type: "image-data";
                         mediaType: string;
                         data: string;
+                    } | {
+                        providerOptions?: Record<string, Record<string, any>> | undefined;
+                        type: "image-file-reference";
+                        providerReference: Record<string, string>;
                     } | {
                         providerOptions?: Record<string, Record<string, any>> | undefined;
                         type: "image-url";
@@ -1206,8 +1549,8 @@ export declare const updateMessage: import("convex/server").RegisteredMutation<"
                 result?: any;
                 isError?: boolean | undefined;
                 experimental_content?: ({
-                    type: "text";
                     text: string;
+                    type: "text";
                 } | {
                     mimeType?: string | undefined;
                     type: "image";
@@ -1236,6 +1579,8 @@ export declare const updateMessage: import("convex/server").RegisteredMutation<"
             } | {
                 providerOptions?: Record<string, Record<string, any>> | undefined;
                 providerMetadata?: Record<string, Record<string, any>> | undefined;
+                signature?: string | undefined;
+                isAutomatic?: boolean | undefined;
                 type: "tool-approval-request";
                 toolCallId: string;
                 approvalId: string;
@@ -1272,8 +1617,26 @@ export declare const updateMessage: import("convex/server").RegisteredMutation<"
                     type: "content";
                     value: ({
                         providerOptions?: Record<string, Record<string, any>> | undefined;
-                        type: "text";
                         text: string;
+                        type: "text";
+                    } | {
+                        providerOptions?: Record<string, Record<string, any>> | undefined;
+                        filename?: string | undefined;
+                        type: "file";
+                        mediaType: string;
+                        data: {
+                            type: "reference";
+                            reference: Record<string, string>;
+                        } | {
+                            type: "url";
+                            url: string;
+                        } | {
+                            type: "data";
+                            data: string | ArrayBuffer;
+                        } | {
+                            text: string;
+                            type: "text";
+                        };
                     } | {
                         type: "media";
                         mediaType: string;
@@ -1286,17 +1649,26 @@ export declare const updateMessage: import("convex/server").RegisteredMutation<"
                         data: string;
                     } | {
                         providerOptions?: Record<string, Record<string, any>> | undefined;
+                        mediaType?: string | undefined;
                         type: "file-url";
                         url: string;
                     } | {
                         providerOptions?: Record<string, Record<string, any>> | undefined;
                         type: "file-id";
                         fileId: string | Record<string, string>;
+                    } | {
+                        providerOptions?: Record<string, Record<string, any>> | undefined;
+                        type: "file-reference";
+                        providerReference: Record<string, string>;
                     } | {
                         providerOptions?: Record<string, Record<string, any>> | undefined;
                         type: "image-data";
                         mediaType: string;
                         data: string;
+                    } | {
+                        providerOptions?: Record<string, Record<string, any>> | undefined;
+                        type: "image-file-reference";
+                        providerReference: Record<string, string>;
                     } | {
                         providerOptions?: Record<string, Record<string, any>> | undefined;
                         type: "image-url";
@@ -1313,8 +1685,8 @@ export declare const updateMessage: import("convex/server").RegisteredMutation<"
                 result?: any;
                 isError?: boolean | undefined;
                 experimental_content?: ({
-                    type: "text";
                     text: string;
+                    type: "text";
                 } | {
                     mimeType?: string | undefined;
                     type: "image";
@@ -1340,6 +1712,8 @@ export declare const updateMessage: import("convex/server").RegisteredMutation<"
         finishReason?: "error" | "length" | "other" | "stop" | "content-filter" | "tool-calls" | "unknown" | undefined;
     };
 }, Promise<{
+    text?: string | undefined;
+    reasoning?: string | undefined;
     id?: string | undefined;
     userId?: string | undefined;
     embeddingId?: string | undefined;
@@ -1355,14 +1729,17 @@ export declare const updateMessage: import("convex/server").RegisteredMutation<"
         content: string | ({
             providerOptions?: Record<string, Record<string, any>> | undefined;
             providerMetadata?: Record<string, Record<string, any>> | undefined;
-            type: "text";
             text: string;
+            type: "text";
         } | {
             providerOptions?: Record<string, Record<string, any>> | undefined;
             mediaType?: string | undefined;
             mimeType?: string | undefined;
             type: "image";
-            image: string | ArrayBuffer;
+            image: string | ArrayBuffer | {
+                type: "reference";
+                reference: Record<string, string>;
+            };
         } | {
             providerOptions?: Record<string, Record<string, any>> | undefined;
             providerMetadata?: Record<string, Record<string, any>> | undefined;
@@ -1370,7 +1747,10 @@ export declare const updateMessage: import("convex/server").RegisteredMutation<"
             mimeType?: string | undefined;
             filename?: string | undefined;
             type: "file";
-            data: string | ArrayBuffer;
+            data: string | ArrayBuffer | {
+                type: "reference";
+                reference: Record<string, string>;
+            };
         })[];
     } | {
         providerOptions?: Record<string, Record<string, any>> | undefined;
@@ -1378,8 +1758,8 @@ export declare const updateMessage: import("convex/server").RegisteredMutation<"
         content: string | ({
             providerOptions?: Record<string, Record<string, any>> | undefined;
             providerMetadata?: Record<string, Record<string, any>> | undefined;
-            type: "text";
             text: string;
+            type: "text";
         } | {
             providerOptions?: Record<string, Record<string, any>> | undefined;
             providerMetadata?: Record<string, Record<string, any>> | undefined;
@@ -1387,32 +1767,51 @@ export declare const updateMessage: import("convex/server").RegisteredMutation<"
             mimeType?: string | undefined;
             filename?: string | undefined;
             type: "file";
-            data: string | ArrayBuffer;
+            data: string | ArrayBuffer | {
+                type: "reference";
+                reference: Record<string, string>;
+            };
         } | {
             providerOptions?: Record<string, Record<string, any>> | undefined;
             providerMetadata?: Record<string, Record<string, any>> | undefined;
             signature?: string | undefined;
-            type: "reasoning";
             text: string;
+            type: "reasoning";
+        } | {
+            providerOptions?: Record<string, Record<string, any>> | undefined;
+            providerMetadata?: Record<string, Record<string, any>> | undefined;
+            data?: string | ArrayBuffer | undefined;
+            url?: string | undefined;
+            type: "reasoning-file";
+            mediaType: string;
+        } | {
+            providerOptions?: Record<string, Record<string, any>> | undefined;
+            providerMetadata?: Record<string, Record<string, any>> | undefined;
+            type: "custom";
+            kind: string;
         } | {
             providerOptions?: Record<string, Record<string, any>> | undefined;
             providerMetadata?: Record<string, Record<string, any>> | undefined;
             type: "redacted-reasoning";
             data: string;
         } | {
+            title?: string | undefined;
             providerOptions?: Record<string, Record<string, any>> | undefined;
             providerMetadata?: Record<string, Record<string, any>> | undefined;
             args?: any;
             providerExecuted?: boolean | undefined;
+            toolMetadata?: Record<string, any> | undefined;
             type: "tool-call";
             toolCallId: string;
             toolName: string;
             input: any;
         } | {
+            title?: string | undefined;
             providerOptions?: Record<string, Record<string, any>> | undefined;
             providerMetadata?: Record<string, Record<string, any>> | undefined;
             input?: any;
             providerExecuted?: boolean | undefined;
+            toolMetadata?: Record<string, any> | undefined;
             type: "tool-call";
             toolCallId: string;
             toolName: string;
@@ -1446,8 +1845,26 @@ export declare const updateMessage: import("convex/server").RegisteredMutation<"
                 type: "content";
                 value: ({
                     providerOptions?: Record<string, Record<string, any>> | undefined;
-                    type: "text";
                     text: string;
+                    type: "text";
+                } | {
+                    providerOptions?: Record<string, Record<string, any>> | undefined;
+                    filename?: string | undefined;
+                    type: "file";
+                    mediaType: string;
+                    data: {
+                        type: "reference";
+                        reference: Record<string, string>;
+                    } | {
+                        type: "url";
+                        url: string;
+                    } | {
+                        type: "data";
+                        data: string | ArrayBuffer;
+                    } | {
+                        text: string;
+                        type: "text";
+                    };
                 } | {
                     type: "media";
                     mediaType: string;
@@ -1460,17 +1877,26 @@ export declare const updateMessage: import("convex/server").RegisteredMutation<"
                     data: string;
                 } | {
                     providerOptions?: Record<string, Record<string, any>> | undefined;
+                    mediaType?: string | undefined;
                     type: "file-url";
                     url: string;
                 } | {
                     providerOptions?: Record<string, Record<string, any>> | undefined;
                     type: "file-id";
                     fileId: string | Record<string, string>;
+                } | {
+                    providerOptions?: Record<string, Record<string, any>> | undefined;
+                    type: "file-reference";
+                    providerReference: Record<string, string>;
                 } | {
                     providerOptions?: Record<string, Record<string, any>> | undefined;
                     type: "image-data";
                     mediaType: string;
                     data: string;
+                } | {
+                    providerOptions?: Record<string, Record<string, any>> | undefined;
+                    type: "image-file-reference";
+                    providerReference: Record<string, string>;
                 } | {
                     providerOptions?: Record<string, Record<string, any>> | undefined;
                     type: "image-url";
@@ -1487,8 +1913,8 @@ export declare const updateMessage: import("convex/server").RegisteredMutation<"
             result?: any;
             isError?: boolean | undefined;
             experimental_content?: ({
-                type: "text";
                 text: string;
+                type: "text";
             } | {
                 mimeType?: string | undefined;
                 type: "image";
@@ -1517,6 +1943,8 @@ export declare const updateMessage: import("convex/server").RegisteredMutation<"
         } | {
             providerOptions?: Record<string, Record<string, any>> | undefined;
             providerMetadata?: Record<string, Record<string, any>> | undefined;
+            signature?: string | undefined;
+            isAutomatic?: boolean | undefined;
             type: "tool-approval-request";
             toolCallId: string;
             approvalId: string;
@@ -1553,8 +1981,26 @@ export declare const updateMessage: import("convex/server").RegisteredMutation<"
                 type: "content";
                 value: ({
                     providerOptions?: Record<string, Record<string, any>> | undefined;
-                    type: "text";
                     text: string;
+                    type: "text";
+                } | {
+                    providerOptions?: Record<string, Record<string, any>> | undefined;
+                    filename?: string | undefined;
+                    type: "file";
+                    mediaType: string;
+                    data: {
+                        type: "reference";
+                        reference: Record<string, string>;
+                    } | {
+                        type: "url";
+                        url: string;
+                    } | {
+                        type: "data";
+                        data: string | ArrayBuffer;
+                    } | {
+                        text: string;
+                        type: "text";
+                    };
                 } | {
                     type: "media";
                     mediaType: string;
@@ -1567,17 +2013,26 @@ export declare const updateMessage: import("convex/server").RegisteredMutation<"
                     data: string;
                 } | {
                     providerOptions?: Record<string, Record<string, any>> | undefined;
+                    mediaType?: string | undefined;
                     type: "file-url";
                     url: string;
                 } | {
                     providerOptions?: Record<string, Record<string, any>> | undefined;
                     type: "file-id";
                     fileId: string | Record<string, string>;
+                } | {
+                    providerOptions?: Record<string, Record<string, any>> | undefined;
+                    type: "file-reference";
+                    providerReference: Record<string, string>;
                 } | {
                     providerOptions?: Record<string, Record<string, any>> | undefined;
                     type: "image-data";
                     mediaType: string;
                     data: string;
+                } | {
+                    providerOptions?: Record<string, Record<string, any>> | undefined;
+                    type: "image-file-reference";
+                    providerReference: Record<string, string>;
                 } | {
                     providerOptions?: Record<string, Record<string, any>> | undefined;
                     type: "image-url";
@@ -1594,8 +2049,8 @@ export declare const updateMessage: import("convex/server").RegisteredMutation<"
             result?: any;
             isError?: boolean | undefined;
             experimental_content?: ({
-                type: "text";
                 text: string;
+                type: "text";
             } | {
                 mimeType?: string | undefined;
                 type: "image";
@@ -1618,15 +2073,17 @@ export declare const updateMessage: import("convex/server").RegisteredMutation<"
         role: "system";
         content: string;
     } | undefined;
-    text?: string | undefined;
     providerMetadata?: Record<string, Record<string, any>> | undefined;
-    reasoning?: string | undefined;
     usage?: {
+        promptTokens?: number | undefined;
+        completionTokens?: number | undefined;
+        totalTokens?: number | undefined;
         reasoningTokens?: number | undefined;
         cachedInputTokens?: number | undefined;
-        promptTokens: number;
-        completionTokens: number;
-        totalTokens: number;
+        nonCachedInputTokens?: number | undefined;
+        cacheWriteInputTokens?: number | undefined;
+        textOutputTokens?: number | undefined;
+        raw?: Record<string, any> | undefined;
     } | undefined;
     sources?: ({
         title?: string | undefined;
@@ -1647,13 +2104,25 @@ export declare const updateMessage: import("convex/server").RegisteredMutation<"
         sourceType: "document";
     })[] | undefined;
     warnings?: ({
+        details?: string | undefined;
+        type: "unsupported";
+        feature: string;
+    } | {
+        details?: string | undefined;
+        type: "compatibility";
+        feature: string;
+    } | {
+        type: "deprecated";
+        message: string;
+        setting: string;
+    } | {
         details?: string | undefined;
         type: "unsupported-setting";
         setting: string;
     } | {
         details?: string | undefined;
-        type: "unsupported-tool";
         tool: any;
+        type: "unsupported-tool";
     } | {
         type: "other";
         message: string;
@@ -1663,22 +2132,22 @@ export declare const updateMessage: import("convex/server").RegisteredMutation<"
         providerOptions?: Record<string, Record<string, any>> | undefined;
         providerMetadata?: Record<string, Record<string, any>> | undefined;
         signature?: string | undefined;
-        type: "reasoning";
         text: string;
+        type: "reasoning";
     } | {
         signature?: string | undefined;
-        type: "text";
         text: string;
+        type: "text";
     } | {
         type: "redacted";
         data: string;
     })[] | undefined;
+    tool: boolean;
     status: "pending" | "success" | "failed";
     order: number;
     _creationTime: number;
     threadId: string;
     stepOrder: number;
-    tool: boolean;
     _id: string;
 }>>;
 export declare const cloneMessageBatch: import("convex/server").RegisteredMutation<"internal", {
@@ -1752,6 +2221,8 @@ export declare const listMessagesByThreadId: import("convex/server").RegisteredQ
     threadId: import("convex/values").GenericId<"threads">;
 }, Promise<{
     page: {
+        text?: string | undefined;
+        reasoning?: string | undefined;
         id?: string | undefined;
         userId?: string | undefined;
         embeddingId?: string | undefined;
@@ -1767,14 +2238,17 @@ export declare const listMessagesByThreadId: import("convex/server").RegisteredQ
             content: string | ({
                 providerOptions?: Record<string, Record<string, any>> | undefined;
                 providerMetadata?: Record<string, Record<string, any>> | undefined;
-                type: "text";
                 text: string;
+                type: "text";
             } | {
                 providerOptions?: Record<string, Record<string, any>> | undefined;
                 mediaType?: string | undefined;
                 mimeType?: string | undefined;
                 type: "image";
-                image: string | ArrayBuffer;
+                image: string | ArrayBuffer | {
+                    type: "reference";
+                    reference: Record<string, string>;
+                };
             } | {
                 providerOptions?: Record<string, Record<string, any>> | undefined;
                 providerMetadata?: Record<string, Record<string, any>> | undefined;
@@ -1782,7 +2256,10 @@ export declare const listMessagesByThreadId: import("convex/server").RegisteredQ
                 mimeType?: string | undefined;
                 filename?: string | undefined;
                 type: "file";
-                data: string | ArrayBuffer;
+                data: string | ArrayBuffer | {
+                    type: "reference";
+                    reference: Record<string, string>;
+                };
             })[];
         } | {
             providerOptions?: Record<string, Record<string, any>> | undefined;
@@ -1790,8 +2267,8 @@ export declare const listMessagesByThreadId: import("convex/server").RegisteredQ
             content: string | ({
                 providerOptions?: Record<string, Record<string, any>> | undefined;
                 providerMetadata?: Record<string, Record<string, any>> | undefined;
-                type: "text";
                 text: string;
+                type: "text";
             } | {
                 providerOptions?: Record<string, Record<string, any>> | undefined;
                 providerMetadata?: Record<string, Record<string, any>> | undefined;
@@ -1799,32 +2276,51 @@ export declare const listMessagesByThreadId: import("convex/server").RegisteredQ
                 mimeType?: string | undefined;
                 filename?: string | undefined;
                 type: "file";
-                data: string | ArrayBuffer;
+                data: string | ArrayBuffer | {
+                    type: "reference";
+                    reference: Record<string, string>;
+                };
             } | {
                 providerOptions?: Record<string, Record<string, any>> | undefined;
                 providerMetadata?: Record<string, Record<string, any>> | undefined;
                 signature?: string | undefined;
-                type: "reasoning";
                 text: string;
+                type: "reasoning";
+            } | {
+                providerOptions?: Record<string, Record<string, any>> | undefined;
+                providerMetadata?: Record<string, Record<string, any>> | undefined;
+                data?: string | ArrayBuffer | undefined;
+                url?: string | undefined;
+                type: "reasoning-file";
+                mediaType: string;
+            } | {
+                providerOptions?: Record<string, Record<string, any>> | undefined;
+                providerMetadata?: Record<string, Record<string, any>> | undefined;
+                type: "custom";
+                kind: string;
             } | {
                 providerOptions?: Record<string, Record<string, any>> | undefined;
                 providerMetadata?: Record<string, Record<string, any>> | undefined;
                 type: "redacted-reasoning";
                 data: string;
             } | {
+                title?: string | undefined;
                 providerOptions?: Record<string, Record<string, any>> | undefined;
                 providerMetadata?: Record<string, Record<string, any>> | undefined;
                 args?: any;
                 providerExecuted?: boolean | undefined;
+                toolMetadata?: Record<string, any> | undefined;
                 type: "tool-call";
                 toolCallId: string;
                 toolName: string;
                 input: any;
             } | {
+                title?: string | undefined;
                 providerOptions?: Record<string, Record<string, any>> | undefined;
                 providerMetadata?: Record<string, Record<string, any>> | undefined;
                 input?: any;
                 providerExecuted?: boolean | undefined;
+                toolMetadata?: Record<string, any> | undefined;
                 type: "tool-call";
                 toolCallId: string;
                 toolName: string;
@@ -1858,8 +2354,26 @@ export declare const listMessagesByThreadId: import("convex/server").RegisteredQ
                     type: "content";
                     value: ({
                         providerOptions?: Record<string, Record<string, any>> | undefined;
-                        type: "text";
                         text: string;
+                        type: "text";
+                    } | {
+                        providerOptions?: Record<string, Record<string, any>> | undefined;
+                        filename?: string | undefined;
+                        type: "file";
+                        mediaType: string;
+                        data: {
+                            type: "reference";
+                            reference: Record<string, string>;
+                        } | {
+                            type: "url";
+                            url: string;
+                        } | {
+                            type: "data";
+                            data: string | ArrayBuffer;
+                        } | {
+                            text: string;
+                            type: "text";
+                        };
                     } | {
                         type: "media";
                         mediaType: string;
@@ -1872,17 +2386,26 @@ export declare const listMessagesByThreadId: import("convex/server").RegisteredQ
                         data: string;
                     } | {
                         providerOptions?: Record<string, Record<string, any>> | undefined;
+                        mediaType?: string | undefined;
                         type: "file-url";
                         url: string;
                     } | {
                         providerOptions?: Record<string, Record<string, any>> | undefined;
                         type: "file-id";
                         fileId: string | Record<string, string>;
+                    } | {
+                        providerOptions?: Record<string, Record<string, any>> | undefined;
+                        type: "file-reference";
+                        providerReference: Record<string, string>;
                     } | {
                         providerOptions?: Record<string, Record<string, any>> | undefined;
                         type: "image-data";
                         mediaType: string;
                         data: string;
+                    } | {
+                        providerOptions?: Record<string, Record<string, any>> | undefined;
+                        type: "image-file-reference";
+                        providerReference: Record<string, string>;
                     } | {
                         providerOptions?: Record<string, Record<string, any>> | undefined;
                         type: "image-url";
@@ -1899,8 +2422,8 @@ export declare const listMessagesByThreadId: import("convex/server").RegisteredQ
                 result?: any;
                 isError?: boolean | undefined;
                 experimental_content?: ({
-                    type: "text";
                     text: string;
+                    type: "text";
                 } | {
                     mimeType?: string | undefined;
                     type: "image";
@@ -1929,6 +2452,8 @@ export declare const listMessagesByThreadId: import("convex/server").RegisteredQ
             } | {
                 providerOptions?: Record<string, Record<string, any>> | undefined;
                 providerMetadata?: Record<string, Record<string, any>> | undefined;
+                signature?: string | undefined;
+                isAutomatic?: boolean | undefined;
                 type: "tool-approval-request";
                 toolCallId: string;
                 approvalId: string;
@@ -1965,8 +2490,26 @@ export declare const listMessagesByThreadId: import("convex/server").RegisteredQ
                     type: "content";
                     value: ({
                         providerOptions?: Record<string, Record<string, any>> | undefined;
-                        type: "text";
                         text: string;
+                        type: "text";
+                    } | {
+                        providerOptions?: Record<string, Record<string, any>> | undefined;
+                        filename?: string | undefined;
+                        type: "file";
+                        mediaType: string;
+                        data: {
+                            type: "reference";
+                            reference: Record<string, string>;
+                        } | {
+                            type: "url";
+                            url: string;
+                        } | {
+                            type: "data";
+                            data: string | ArrayBuffer;
+                        } | {
+                            text: string;
+                            type: "text";
+                        };
                     } | {
                         type: "media";
                         mediaType: string;
@@ -1979,17 +2522,26 @@ export declare const listMessagesByThreadId: import("convex/server").RegisteredQ
                         data: string;
                     } | {
                         providerOptions?: Record<string, Record<string, any>> | undefined;
+                        mediaType?: string | undefined;
                         type: "file-url";
                         url: string;
                     } | {
                         providerOptions?: Record<string, Record<string, any>> | undefined;
                         type: "file-id";
                         fileId: string | Record<string, string>;
+                    } | {
+                        providerOptions?: Record<string, Record<string, any>> | undefined;
+                        type: "file-reference";
+                        providerReference: Record<string, string>;
                     } | {
                         providerOptions?: Record<string, Record<string, any>> | undefined;
                         type: "image-data";
                         mediaType: string;
                         data: string;
+                    } | {
+                        providerOptions?: Record<string, Record<string, any>> | undefined;
+                        type: "image-file-reference";
+                        providerReference: Record<string, string>;
                     } | {
                         providerOptions?: Record<string, Record<string, any>> | undefined;
                         type: "image-url";
@@ -2006,8 +2558,8 @@ export declare const listMessagesByThreadId: import("convex/server").RegisteredQ
                 result?: any;
                 isError?: boolean | undefined;
                 experimental_content?: ({
-                    type: "text";
                     text: string;
+                    type: "text";
                 } | {
                     mimeType?: string | undefined;
                     type: "image";
@@ -2030,15 +2582,17 @@ export declare const listMessagesByThreadId: import("convex/server").RegisteredQ
             role: "system";
             content: string;
         } | undefined;
-        text?: string | undefined;
         providerMetadata?: Record<string, Record<string, any>> | undefined;
-        reasoning?: string | undefined;
         usage?: {
+            promptTokens?: number | undefined;
+            completionTokens?: number | undefined;
+            totalTokens?: number | undefined;
             reasoningTokens?: number | undefined;
             cachedInputTokens?: number | undefined;
-            promptTokens: number;
-            completionTokens: number;
-            totalTokens: number;
+            nonCachedInputTokens?: number | undefined;
+            cacheWriteInputTokens?: number | undefined;
+            textOutputTokens?: number | undefined;
+            raw?: Record<string, any> | undefined;
         } | undefined;
         sources?: ({
             title?: string | undefined;
@@ -2059,13 +2613,25 @@ export declare const listMessagesByThreadId: import("convex/server").RegisteredQ
             sourceType: "document";
         })[] | undefined;
         warnings?: ({
+            details?: string | undefined;
+            type: "unsupported";
+            feature: string;
+        } | {
+            details?: string | undefined;
+            type: "compatibility";
+            feature: string;
+        } | {
+            type: "deprecated";
+            message: string;
+            setting: string;
+        } | {
             details?: string | undefined;
             type: "unsupported-setting";
             setting: string;
         } | {
             details?: string | undefined;
-            type: "unsupported-tool";
             tool: any;
+            type: "unsupported-tool";
         } | {
             type: "other";
             message: string;
@@ -2075,22 +2641,22 @@ export declare const listMessagesByThreadId: import("convex/server").RegisteredQ
             providerOptions?: Record<string, Record<string, any>> | undefined;
             providerMetadata?: Record<string, Record<string, any>> | undefined;
             signature?: string | undefined;
-            type: "reasoning";
             text: string;
+            type: "reasoning";
         } | {
             signature?: string | undefined;
-            type: "text";
             text: string;
+            type: "text";
         } | {
             type: "redacted";
             data: string;
         })[] | undefined;
+        tool: boolean;
         status: "pending" | "success" | "failed";
         order: number;
         _creationTime: number;
         threadId: string;
         stepOrder: number;
-        tool: boolean;
         _id: string;
     }[];
     isDone: boolean;
@@ -2101,6 +2667,8 @@ export declare const listMessagesByThreadId: import("convex/server").RegisteredQ
 export declare const getMessagesByIds: import("convex/server").RegisteredQuery<"public", {
     messageIds: import("convex/values").GenericId<"messages">[];
 }, Promise<({
+    text?: string | undefined;
+    reasoning?: string | undefined;
     id?: string | undefined;
     userId?: string | undefined;
     embeddingId?: string | undefined;
@@ -2116,14 +2684,17 @@ export declare const getMessagesByIds: import("convex/server").RegisteredQuery<"
         content: string | ({
             providerOptions?: Record<string, Record<string, any>> | undefined;
             providerMetadata?: Record<string, Record<string, any>> | undefined;
-            type: "text";
             text: string;
+            type: "text";
         } | {
             providerOptions?: Record<string, Record<string, any>> | undefined;
             mediaType?: string | undefined;
             mimeType?: string | undefined;
             type: "image";
-            image: string | ArrayBuffer;
+            image: string | ArrayBuffer | {
+                type: "reference";
+                reference: Record<string, string>;
+            };
         } | {
             providerOptions?: Record<string, Record<string, any>> | undefined;
             providerMetadata?: Record<string, Record<string, any>> | undefined;
@@ -2131,7 +2702,10 @@ export declare const getMessagesByIds: import("convex/server").RegisteredQuery<"
             mimeType?: string | undefined;
             filename?: string | undefined;
             type: "file";
-            data: string | ArrayBuffer;
+            data: string | ArrayBuffer | {
+                type: "reference";
+                reference: Record<string, string>;
+            };
         })[];
     } | {
         providerOptions?: Record<string, Record<string, any>> | undefined;
@@ -2139,8 +2713,8 @@ export declare const getMessagesByIds: import("convex/server").RegisteredQuery<"
         content: string | ({
             providerOptions?: Record<string, Record<string, any>> | undefined;
             providerMetadata?: Record<string, Record<string, any>> | undefined;
-            type: "text";
             text: string;
+            type: "text";
         } | {
             providerOptions?: Record<string, Record<string, any>> | undefined;
             providerMetadata?: Record<string, Record<string, any>> | undefined;
@@ -2148,32 +2722,51 @@ export declare const getMessagesByIds: import("convex/server").RegisteredQuery<"
             mimeType?: string | undefined;
             filename?: string | undefined;
             type: "file";
-            data: string | ArrayBuffer;
+            data: string | ArrayBuffer | {
+                type: "reference";
+                reference: Record<string, string>;
+            };
         } | {
             providerOptions?: Record<string, Record<string, any>> | undefined;
             providerMetadata?: Record<string, Record<string, any>> | undefined;
             signature?: string | undefined;
-            type: "reasoning";
             text: string;
+            type: "reasoning";
+        } | {
+            providerOptions?: Record<string, Record<string, any>> | undefined;
+            providerMetadata?: Record<string, Record<string, any>> | undefined;
+            data?: string | ArrayBuffer | undefined;
+            url?: string | undefined;
+            type: "reasoning-file";
+            mediaType: string;
+        } | {
+            providerOptions?: Record<string, Record<string, any>> | undefined;
+            providerMetadata?: Record<string, Record<string, any>> | undefined;
+            type: "custom";
+            kind: string;
         } | {
             providerOptions?: Record<string, Record<string, any>> | undefined;
             providerMetadata?: Record<string, Record<string, any>> | undefined;
             type: "redacted-reasoning";
             data: string;
         } | {
+            title?: string | undefined;
             providerOptions?: Record<string, Record<string, any>> | undefined;
             providerMetadata?: Record<string, Record<string, any>> | undefined;
             args?: any;
             providerExecuted?: boolean | undefined;
+            toolMetadata?: Record<string, any> | undefined;
             type: "tool-call";
             toolCallId: string;
             toolName: string;
             input: any;
         } | {
+            title?: string | undefined;
             providerOptions?: Record<string, Record<string, any>> | undefined;
             providerMetadata?: Record<string, Record<string, any>> | undefined;
             input?: any;
             providerExecuted?: boolean | undefined;
+            toolMetadata?: Record<string, any> | undefined;
             type: "tool-call";
             toolCallId: string;
             toolName: string;
@@ -2207,8 +2800,26 @@ export declare const getMessagesByIds: import("convex/server").RegisteredQuery<"
                 type: "content";
                 value: ({
                     providerOptions?: Record<string, Record<string, any>> | undefined;
-                    type: "text";
                     text: string;
+                    type: "text";
+                } | {
+                    providerOptions?: Record<string, Record<string, any>> | undefined;
+                    filename?: string | undefined;
+                    type: "file";
+                    mediaType: string;
+                    data: {
+                        type: "reference";
+                        reference: Record<string, string>;
+                    } | {
+                        type: "url";
+                        url: string;
+                    } | {
+                        type: "data";
+                        data: string | ArrayBuffer;
+                    } | {
+                        text: string;
+                        type: "text";
+                    };
                 } | {
                     type: "media";
                     mediaType: string;
@@ -2221,17 +2832,26 @@ export declare const getMessagesByIds: import("convex/server").RegisteredQuery<"
                     data: string;
                 } | {
                     providerOptions?: Record<string, Record<string, any>> | undefined;
+                    mediaType?: string | undefined;
                     type: "file-url";
                     url: string;
                 } | {
                     providerOptions?: Record<string, Record<string, any>> | undefined;
                     type: "file-id";
                     fileId: string | Record<string, string>;
+                } | {
+                    providerOptions?: Record<string, Record<string, any>> | undefined;
+                    type: "file-reference";
+                    providerReference: Record<string, string>;
                 } | {
                     providerOptions?: Record<string, Record<string, any>> | undefined;
                     type: "image-data";
                     mediaType: string;
                     data: string;
+                } | {
+                    providerOptions?: Record<string, Record<string, any>> | undefined;
+                    type: "image-file-reference";
+                    providerReference: Record<string, string>;
                 } | {
                     providerOptions?: Record<string, Record<string, any>> | undefined;
                     type: "image-url";
@@ -2248,8 +2868,8 @@ export declare const getMessagesByIds: import("convex/server").RegisteredQuery<"
             result?: any;
             isError?: boolean | undefined;
             experimental_content?: ({
-                type: "text";
                 text: string;
+                type: "text";
             } | {
                 mimeType?: string | undefined;
                 type: "image";
@@ -2278,6 +2898,8 @@ export declare const getMessagesByIds: import("convex/server").RegisteredQuery<"
         } | {
             providerOptions?: Record<string, Record<string, any>> | undefined;
             providerMetadata?: Record<string, Record<string, any>> | undefined;
+            signature?: string | undefined;
+            isAutomatic?: boolean | undefined;
             type: "tool-approval-request";
             toolCallId: string;
             approvalId: string;
@@ -2314,8 +2936,26 @@ export declare const getMessagesByIds: import("convex/server").RegisteredQuery<"
                 type: "content";
                 value: ({
                     providerOptions?: Record<string, Record<string, any>> | undefined;
-                    type: "text";
                     text: string;
+                    type: "text";
+                } | {
+                    providerOptions?: Record<string, Record<string, any>> | undefined;
+                    filename?: string | undefined;
+                    type: "file";
+                    mediaType: string;
+                    data: {
+                        type: "reference";
+                        reference: Record<string, string>;
+                    } | {
+                        type: "url";
+                        url: string;
+                    } | {
+                        type: "data";
+                        data: string | ArrayBuffer;
+                    } | {
+                        text: string;
+                        type: "text";
+                    };
                 } | {
                     type: "media";
                     mediaType: string;
@@ -2328,17 +2968,26 @@ export declare const getMessagesByIds: import("convex/server").RegisteredQuery<"
                     data: string;
                 } | {
                     providerOptions?: Record<string, Record<string, any>> | undefined;
+                    mediaType?: string | undefined;
                     type: "file-url";
                     url: string;
                 } | {
                     providerOptions?: Record<string, Record<string, any>> | undefined;
                     type: "file-id";
                     fileId: string | Record<string, string>;
+                } | {
+                    providerOptions?: Record<string, Record<string, any>> | undefined;
+                    type: "file-reference";
+                    providerReference: Record<string, string>;
                 } | {
                     providerOptions?: Record<string, Record<string, any>> | undefined;
                     type: "image-data";
                     mediaType: string;
                     data: string;
+                } | {
+                    providerOptions?: Record<string, Record<string, any>> | undefined;
+                    type: "image-file-reference";
+                    providerReference: Record<string, string>;
                 } | {
                     providerOptions?: Record<string, Record<string, any>> | undefined;
                     type: "image-url";
@@ -2355,8 +3004,8 @@ export declare const getMessagesByIds: import("convex/server").RegisteredQuery<"
             result?: any;
             isError?: boolean | undefined;
             experimental_content?: ({
-                type: "text";
                 text: string;
+                type: "text";
             } | {
                 mimeType?: string | undefined;
                 type: "image";
@@ -2379,15 +3028,17 @@ export declare const getMessagesByIds: import("convex/server").RegisteredQuery<"
         role: "system";
         content: string;
     } | undefined;
-    text?: string | undefined;
     providerMetadata?: Record<string, Record<string, any>> | undefined;
-    reasoning?: string | undefined;
     usage?: {
+        promptTokens?: number | undefined;
+        completionTokens?: number | undefined;
+        totalTokens?: number | undefined;
         reasoningTokens?: number | undefined;
         cachedInputTokens?: number | undefined;
-        promptTokens: number;
-        completionTokens: number;
-        totalTokens: number;
+        nonCachedInputTokens?: number | undefined;
+        cacheWriteInputTokens?: number | undefined;
+        textOutputTokens?: number | undefined;
+        raw?: Record<string, any> | undefined;
     } | undefined;
     sources?: ({
         title?: string | undefined;
@@ -2408,13 +3059,25 @@ export declare const getMessagesByIds: import("convex/server").RegisteredQuery<"
         sourceType: "document";
     })[] | undefined;
     warnings?: ({
+        details?: string | undefined;
+        type: "unsupported";
+        feature: string;
+    } | {
+        details?: string | undefined;
+        type: "compatibility";
+        feature: string;
+    } | {
+        type: "deprecated";
+        message: string;
+        setting: string;
+    } | {
         details?: string | undefined;
         type: "unsupported-setting";
         setting: string;
     } | {
         details?: string | undefined;
-        type: "unsupported-tool";
         tool: any;
+        type: "unsupported-tool";
     } | {
         type: "other";
         message: string;
@@ -2424,27 +3087,27 @@ export declare const getMessagesByIds: import("convex/server").RegisteredQuery<"
         providerOptions?: Record<string, Record<string, any>> | undefined;
         providerMetadata?: Record<string, Record<string, any>> | undefined;
         signature?: string | undefined;
-        type: "reasoning";
         text: string;
+        type: "reasoning";
     } | {
         signature?: string | undefined;
-        type: "text";
         text: string;
+        type: "text";
     } | {
         type: "redacted";
         data: string;
     })[] | undefined;
+    tool: boolean;
     status: "pending" | "success" | "failed";
     order: number;
     _creationTime: number;
     threadId: string;
     stepOrder: number;
-    tool: boolean;
     _id: string;
 } | null)[]>>;
 export declare const searchMessages: import("convex/server").RegisteredAction<"public", {
-    threadId?: import("convex/values").GenericId<"threads"> | undefined;
     text?: string | undefined;
+    threadId?: import("convex/values").GenericId<"threads"> | undefined;
     textSearch?: boolean | undefined;
     vectorSearch?: boolean | undefined;
     vectorScoreThreshold?: number | undefined;
@@ -2458,6 +3121,8 @@ export declare const searchMessages: import("convex/server").RegisteredAction<"p
     targetMessageId?: import("convex/values").GenericId<"messages"> | undefined;
     limit: number;
 }, Promise<{
+    text?: string | undefined;
+    reasoning?: string | undefined;
     id?: string | undefined;
     userId?: string | undefined;
     embeddingId?: string | undefined;
@@ -2473,14 +3138,17 @@ export declare const searchMessages: import("convex/server").RegisteredAction<"p
         content: string | ({
             providerOptions?: Record<string, Record<string, any>> | undefined;
             providerMetadata?: Record<string, Record<string, any>> | undefined;
-            type: "text";
             text: string;
+            type: "text";
         } | {
             providerOptions?: Record<string, Record<string, any>> | undefined;
             mediaType?: string | undefined;
             mimeType?: string | undefined;
             type: "image";
-            image: string | ArrayBuffer;
+            image: string | ArrayBuffer | {
+                type: "reference";
+                reference: Record<string, string>;
+            };
         } | {
             providerOptions?: Record<string, Record<string, any>> | undefined;
             providerMetadata?: Record<string, Record<string, any>> | undefined;
@@ -2488,7 +3156,10 @@ export declare const searchMessages: import("convex/server").RegisteredAction<"p
             mimeType?: string | undefined;
             filename?: string | undefined;
             type: "file";
-            data: string | ArrayBuffer;
+            data: string | ArrayBuffer | {
+                type: "reference";
+                reference: Record<string, string>;
+            };
         })[];
     } | {
         providerOptions?: Record<string, Record<string, any>> | undefined;
@@ -2496,8 +3167,8 @@ export declare const searchMessages: import("convex/server").RegisteredAction<"p
         content: string | ({
             providerOptions?: Record<string, Record<string, any>> | undefined;
             providerMetadata?: Record<string, Record<string, any>> | undefined;
-            type: "text";
             text: string;
+            type: "text";
         } | {
             providerOptions?: Record<string, Record<string, any>> | undefined;
             providerMetadata?: Record<string, Record<string, any>> | undefined;
@@ -2505,32 +3176,51 @@ export declare const searchMessages: import("convex/server").RegisteredAction<"p
             mimeType?: string | undefined;
             filename?: string | undefined;
             type: "file";
-            data: string | ArrayBuffer;
+            data: string | ArrayBuffer | {
+                type: "reference";
+                reference: Record<string, string>;
+            };
         } | {
             providerOptions?: Record<string, Record<string, any>> | undefined;
             providerMetadata?: Record<string, Record<string, any>> | undefined;
             signature?: string | undefined;
-            type: "reasoning";
             text: string;
+            type: "reasoning";
+        } | {
+            providerOptions?: Record<string, Record<string, any>> | undefined;
+            providerMetadata?: Record<string, Record<string, any>> | undefined;
+            data?: string | ArrayBuffer | undefined;
+            url?: string | undefined;
+            type: "reasoning-file";
+            mediaType: string;
+        } | {
+            providerOptions?: Record<string, Record<string, any>> | undefined;
+            providerMetadata?: Record<string, Record<string, any>> | undefined;
+            type: "custom";
+            kind: string;
         } | {
             providerOptions?: Record<string, Record<string, any>> | undefined;
             providerMetadata?: Record<string, Record<string, any>> | undefined;
             type: "redacted-reasoning";
             data: string;
         } | {
+            title?: string | undefined;
             providerOptions?: Record<string, Record<string, any>> | undefined;
             providerMetadata?: Record<string, Record<string, any>> | undefined;
             args?: any;
             providerExecuted?: boolean | undefined;
+            toolMetadata?: Record<string, any> | undefined;
             type: "tool-call";
             toolCallId: string;
             toolName: string;
             input: any;
         } | {
+            title?: string | undefined;
             providerOptions?: Record<string, Record<string, any>> | undefined;
             providerMetadata?: Record<string, Record<string, any>> | undefined;
             input?: any;
             providerExecuted?: boolean | undefined;
+            toolMetadata?: Record<string, any> | undefined;
             type: "tool-call";
             toolCallId: string;
             toolName: string;
@@ -2564,8 +3254,26 @@ export declare const searchMessages: import("convex/server").RegisteredAction<"p
                 type: "content";
                 value: ({
                     providerOptions?: Record<string, Record<string, any>> | undefined;
-                    type: "text";
                     text: string;
+                    type: "text";
+                } | {
+                    providerOptions?: Record<string, Record<string, any>> | undefined;
+                    filename?: string | undefined;
+                    type: "file";
+                    mediaType: string;
+                    data: {
+                        type: "reference";
+                        reference: Record<string, string>;
+                    } | {
+                        type: "url";
+                        url: string;
+                    } | {
+                        type: "data";
+                        data: string | ArrayBuffer;
+                    } | {
+                        text: string;
+                        type: "text";
+                    };
                 } | {
                     type: "media";
                     mediaType: string;
@@ -2578,17 +3286,26 @@ export declare const searchMessages: import("convex/server").RegisteredAction<"p
                     data: string;
                 } | {
                     providerOptions?: Record<string, Record<string, any>> | undefined;
+                    mediaType?: string | undefined;
                     type: "file-url";
                     url: string;
                 } | {
                     providerOptions?: Record<string, Record<string, any>> | undefined;
                     type: "file-id";
                     fileId: string | Record<string, string>;
+                } | {
+                    providerOptions?: Record<string, Record<string, any>> | undefined;
+                    type: "file-reference";
+                    providerReference: Record<string, string>;
                 } | {
                     providerOptions?: Record<string, Record<string, any>> | undefined;
                     type: "image-data";
                     mediaType: string;
                     data: string;
+                } | {
+                    providerOptions?: Record<string, Record<string, any>> | undefined;
+                    type: "image-file-reference";
+                    providerReference: Record<string, string>;
                 } | {
                     providerOptions?: Record<string, Record<string, any>> | undefined;
                     type: "image-url";
@@ -2605,8 +3322,8 @@ export declare const searchMessages: import("convex/server").RegisteredAction<"p
             result?: any;
             isError?: boolean | undefined;
             experimental_content?: ({
-                type: "text";
                 text: string;
+                type: "text";
             } | {
                 mimeType?: string | undefined;
                 type: "image";
@@ -2635,6 +3352,8 @@ export declare const searchMessages: import("convex/server").RegisteredAction<"p
         } | {
             providerOptions?: Record<string, Record<string, any>> | undefined;
             providerMetadata?: Record<string, Record<string, any>> | undefined;
+            signature?: string | undefined;
+            isAutomatic?: boolean | undefined;
             type: "tool-approval-request";
             toolCallId: string;
             approvalId: string;
@@ -2671,8 +3390,26 @@ export declare const searchMessages: import("convex/server").RegisteredAction<"p
                 type: "content";
                 value: ({
                     providerOptions?: Record<string, Record<string, any>> | undefined;
-                    type: "text";
                     text: string;
+                    type: "text";
+                } | {
+                    providerOptions?: Record<string, Record<string, any>> | undefined;
+                    filename?: string | undefined;
+                    type: "file";
+                    mediaType: string;
+                    data: {
+                        type: "reference";
+                        reference: Record<string, string>;
+                    } | {
+                        type: "url";
+                        url: string;
+                    } | {
+                        type: "data";
+                        data: string | ArrayBuffer;
+                    } | {
+                        text: string;
+                        type: "text";
+                    };
                 } | {
                     type: "media";
                     mediaType: string;
@@ -2685,17 +3422,26 @@ export declare const searchMessages: import("convex/server").RegisteredAction<"p
                     data: string;
                 } | {
                     providerOptions?: Record<string, Record<string, any>> | undefined;
+                    mediaType?: string | undefined;
                     type: "file-url";
                     url: string;
                 } | {
                     providerOptions?: Record<string, Record<string, any>> | undefined;
                     type: "file-id";
                     fileId: string | Record<string, string>;
+                } | {
+                    providerOptions?: Record<string, Record<string, any>> | undefined;
+                    type: "file-reference";
+                    providerReference: Record<string, string>;
                 } | {
                     providerOptions?: Record<string, Record<string, any>> | undefined;
                     type: "image-data";
                     mediaType: string;
                     data: string;
+                } | {
+                    providerOptions?: Record<string, Record<string, any>> | undefined;
+                    type: "image-file-reference";
+                    providerReference: Record<string, string>;
                 } | {
                     providerOptions?: Record<string, Record<string, any>> | undefined;
                     type: "image-url";
@@ -2712,8 +3458,8 @@ export declare const searchMessages: import("convex/server").RegisteredAction<"p
             result?: any;
             isError?: boolean | undefined;
             experimental_content?: ({
-                type: "text";
                 text: string;
+                type: "text";
             } | {
                 mimeType?: string | undefined;
                 type: "image";
@@ -2736,15 +3482,17 @@ export declare const searchMessages: import("convex/server").RegisteredAction<"p
         role: "system";
         content: string;
     } | undefined;
-    text?: string | undefined;
     providerMetadata?: Record<string, Record<string, any>> | undefined;
-    reasoning?: string | undefined;
     usage?: {
+        promptTokens?: number | undefined;
+        completionTokens?: number | undefined;
+        totalTokens?: number | undefined;
         reasoningTokens?: number | undefined;
         cachedInputTokens?: number | undefined;
-        promptTokens: number;
-        completionTokens: number;
-        totalTokens: number;
+        nonCachedInputTokens?: number | undefined;
+        cacheWriteInputTokens?: number | undefined;
+        textOutputTokens?: number | undefined;
+        raw?: Record<string, any> | undefined;
     } | undefined;
     sources?: ({
         title?: string | undefined;
@@ -2765,13 +3513,25 @@ export declare const searchMessages: import("convex/server").RegisteredAction<"p
         sourceType: "document";
     })[] | undefined;
     warnings?: ({
+        details?: string | undefined;
+        type: "unsupported";
+        feature: string;
+    } | {
+        details?: string | undefined;
+        type: "compatibility";
+        feature: string;
+    } | {
+        type: "deprecated";
+        message: string;
+        setting: string;
+    } | {
         details?: string | undefined;
         type: "unsupported-setting";
         setting: string;
     } | {
         details?: string | undefined;
-        type: "unsupported-tool";
         tool: any;
+        type: "unsupported-tool";
     } | {
         type: "other";
         message: string;
@@ -2781,28 +3541,30 @@ export declare const searchMessages: import("convex/server").RegisteredAction<"p
         providerOptions?: Record<string, Record<string, any>> | undefined;
         providerMetadata?: Record<string, Record<string, any>> | undefined;
         signature?: string | undefined;
-        type: "reasoning";
         text: string;
+        type: "reasoning";
     } | {
         signature?: string | undefined;
-        type: "text";
         text: string;
+        type: "text";
     } | {
         type: "redacted";
         data: string;
     })[] | undefined;
+    tool: boolean;
     status: "pending" | "success" | "failed";
     order: number;
     _creationTime: number;
     threadId: string;
     stepOrder: number;
-    tool: boolean;
     _id: string;
 }[]>>;
 export declare const _fetchSearchMessages: import("convex/server").RegisteredQuery<"internal", {
     threadId?: import("convex/values").GenericId<"threads"> | undefined;
     searchAllMessagesForUserId?: string | undefined;
     textSearchMessages?: {
+        text?: string | undefined;
+        reasoning?: string | undefined;
         id?: string | undefined;
         userId?: string | undefined;
         embeddingId?: string | undefined;
@@ -2818,14 +3580,17 @@ export declare const _fetchSearchMessages: import("convex/server").RegisteredQue
             content: string | ({
                 providerOptions?: Record<string, Record<string, any>> | undefined;
                 providerMetadata?: Record<string, Record<string, any>> | undefined;
-                type: "text";
                 text: string;
+                type: "text";
             } | {
                 providerOptions?: Record<string, Record<string, any>> | undefined;
                 mediaType?: string | undefined;
                 mimeType?: string | undefined;
                 type: "image";
-                image: string | ArrayBuffer;
+                image: string | ArrayBuffer | {
+                    type: "reference";
+                    reference: Record<string, string>;
+                };
             } | {
                 providerOptions?: Record<string, Record<string, any>> | undefined;
                 providerMetadata?: Record<string, Record<string, any>> | undefined;
@@ -2833,7 +3598,10 @@ export declare const _fetchSearchMessages: import("convex/server").RegisteredQue
                 mimeType?: string | undefined;
                 filename?: string | undefined;
                 type: "file";
-                data: string | ArrayBuffer;
+                data: string | ArrayBuffer | {
+                    type: "reference";
+                    reference: Record<string, string>;
+                };
             })[];
         } | {
             providerOptions?: Record<string, Record<string, any>> | undefined;
@@ -2841,8 +3609,8 @@ export declare const _fetchSearchMessages: import("convex/server").RegisteredQue
             content: string | ({
                 providerOptions?: Record<string, Record<string, any>> | undefined;
                 providerMetadata?: Record<string, Record<string, any>> | undefined;
-                type: "text";
                 text: string;
+                type: "text";
             } | {
                 providerOptions?: Record<string, Record<string, any>> | undefined;
                 providerMetadata?: Record<string, Record<string, any>> | undefined;
@@ -2850,32 +3618,51 @@ export declare const _fetchSearchMessages: import("convex/server").RegisteredQue
                 mimeType?: string | undefined;
                 filename?: string | undefined;
                 type: "file";
-                data: string | ArrayBuffer;
+                data: string | ArrayBuffer | {
+                    type: "reference";
+                    reference: Record<string, string>;
+                };
             } | {
                 providerOptions?: Record<string, Record<string, any>> | undefined;
                 providerMetadata?: Record<string, Record<string, any>> | undefined;
                 signature?: string | undefined;
-                type: "reasoning";
                 text: string;
+                type: "reasoning";
+            } | {
+                providerOptions?: Record<string, Record<string, any>> | undefined;
+                providerMetadata?: Record<string, Record<string, any>> | undefined;
+                data?: string | ArrayBuffer | undefined;
+                url?: string | undefined;
+                type: "reasoning-file";
+                mediaType: string;
+            } | {
+                providerOptions?: Record<string, Record<string, any>> | undefined;
+                providerMetadata?: Record<string, Record<string, any>> | undefined;
+                type: "custom";
+                kind: string;
             } | {
                 providerOptions?: Record<string, Record<string, any>> | undefined;
                 providerMetadata?: Record<string, Record<string, any>> | undefined;
                 type: "redacted-reasoning";
                 data: string;
             } | {
+                title?: string | undefined;
                 providerOptions?: Record<string, Record<string, any>> | undefined;
                 providerMetadata?: Record<string, Record<string, any>> | undefined;
                 args?: any;
                 providerExecuted?: boolean | undefined;
+                toolMetadata?: Record<string, any> | undefined;
                 type: "tool-call";
                 toolCallId: string;
                 toolName: string;
                 input: any;
             } | {
+                title?: string | undefined;
                 providerOptions?: Record<string, Record<string, any>> | undefined;
                 providerMetadata?: Record<string, Record<string, any>> | undefined;
                 input?: any;
                 providerExecuted?: boolean | undefined;
+                toolMetadata?: Record<string, any> | undefined;
                 type: "tool-call";
                 toolCallId: string;
                 toolName: string;
@@ -2909,8 +3696,26 @@ export declare const _fetchSearchMessages: import("convex/server").RegisteredQue
                     type: "content";
                     value: ({
                         providerOptions?: Record<string, Record<string, any>> | undefined;
-                        type: "text";
                         text: string;
+                        type: "text";
+                    } | {
+                        providerOptions?: Record<string, Record<string, any>> | undefined;
+                        filename?: string | undefined;
+                        type: "file";
+                        mediaType: string;
+                        data: {
+                            type: "reference";
+                            reference: Record<string, string>;
+                        } | {
+                            type: "url";
+                            url: string;
+                        } | {
+                            type: "data";
+                            data: string | ArrayBuffer;
+                        } | {
+                            text: string;
+                            type: "text";
+                        };
                     } | {
                         type: "media";
                         mediaType: string;
@@ -2923,17 +3728,26 @@ export declare const _fetchSearchMessages: import("convex/server").RegisteredQue
                         data: string;
                     } | {
                         providerOptions?: Record<string, Record<string, any>> | undefined;
+                        mediaType?: string | undefined;
                         type: "file-url";
                         url: string;
                     } | {
                         providerOptions?: Record<string, Record<string, any>> | undefined;
                         type: "file-id";
                         fileId: string | Record<string, string>;
+                    } | {
+                        providerOptions?: Record<string, Record<string, any>> | undefined;
+                        type: "file-reference";
+                        providerReference: Record<string, string>;
                     } | {
                         providerOptions?: Record<string, Record<string, any>> | undefined;
                         type: "image-data";
                         mediaType: string;
                         data: string;
+                    } | {
+                        providerOptions?: Record<string, Record<string, any>> | undefined;
+                        type: "image-file-reference";
+                        providerReference: Record<string, string>;
                     } | {
                         providerOptions?: Record<string, Record<string, any>> | undefined;
                         type: "image-url";
@@ -2950,8 +3764,8 @@ export declare const _fetchSearchMessages: import("convex/server").RegisteredQue
                 result?: any;
                 isError?: boolean | undefined;
                 experimental_content?: ({
-                    type: "text";
                     text: string;
+                    type: "text";
                 } | {
                     mimeType?: string | undefined;
                     type: "image";
@@ -2980,6 +3794,8 @@ export declare const _fetchSearchMessages: import("convex/server").RegisteredQue
             } | {
                 providerOptions?: Record<string, Record<string, any>> | undefined;
                 providerMetadata?: Record<string, Record<string, any>> | undefined;
+                signature?: string | undefined;
+                isAutomatic?: boolean | undefined;
                 type: "tool-approval-request";
                 toolCallId: string;
                 approvalId: string;
@@ -3016,8 +3832,26 @@ export declare const _fetchSearchMessages: import("convex/server").RegisteredQue
                     type: "content";
                     value: ({
                         providerOptions?: Record<string, Record<string, any>> | undefined;
-                        type: "text";
                         text: string;
+                        type: "text";
+                    } | {
+                        providerOptions?: Record<string, Record<string, any>> | undefined;
+                        filename?: string | undefined;
+                        type: "file";
+                        mediaType: string;
+                        data: {
+                            type: "reference";
+                            reference: Record<string, string>;
+                        } | {
+                            type: "url";
+                            url: string;
+                        } | {
+                            type: "data";
+                            data: string | ArrayBuffer;
+                        } | {
+                            text: string;
+                            type: "text";
+                        };
                     } | {
                         type: "media";
                         mediaType: string;
@@ -3030,17 +3864,26 @@ export declare const _fetchSearchMessages: import("convex/server").RegisteredQue
                         data: string;
                     } | {
                         providerOptions?: Record<string, Record<string, any>> | undefined;
+                        mediaType?: string | undefined;
                         type: "file-url";
                         url: string;
                     } | {
                         providerOptions?: Record<string, Record<string, any>> | undefined;
                         type: "file-id";
                         fileId: string | Record<string, string>;
+                    } | {
+                        providerOptions?: Record<string, Record<string, any>> | undefined;
+                        type: "file-reference";
+                        providerReference: Record<string, string>;
                     } | {
                         providerOptions?: Record<string, Record<string, any>> | undefined;
                         type: "image-data";
                         mediaType: string;
                         data: string;
+                    } | {
+                        providerOptions?: Record<string, Record<string, any>> | undefined;
+                        type: "image-file-reference";
+                        providerReference: Record<string, string>;
                     } | {
                         providerOptions?: Record<string, Record<string, any>> | undefined;
                         type: "image-url";
@@ -3057,8 +3900,8 @@ export declare const _fetchSearchMessages: import("convex/server").RegisteredQue
                 result?: any;
                 isError?: boolean | undefined;
                 experimental_content?: ({
-                    type: "text";
                     text: string;
+                    type: "text";
                 } | {
                     mimeType?: string | undefined;
                     type: "image";
@@ -3081,15 +3924,17 @@ export declare const _fetchSearchMessages: import("convex/server").RegisteredQue
             role: "system";
             content: string;
         } | undefined;
-        text?: string | undefined;
         providerMetadata?: Record<string, Record<string, any>> | undefined;
-        reasoning?: string | undefined;
         usage?: {
+            promptTokens?: number | undefined;
+            completionTokens?: number | undefined;
+            totalTokens?: number | undefined;
             reasoningTokens?: number | undefined;
             cachedInputTokens?: number | undefined;
-            promptTokens: number;
-            completionTokens: number;
-            totalTokens: number;
+            nonCachedInputTokens?: number | undefined;
+            cacheWriteInputTokens?: number | undefined;
+            textOutputTokens?: number | undefined;
+            raw?: Record<string, any> | undefined;
         } | undefined;
         sources?: ({
             title?: string | undefined;
@@ -3110,13 +3955,25 @@ export declare const _fetchSearchMessages: import("convex/server").RegisteredQue
             sourceType: "document";
         })[] | undefined;
         warnings?: ({
+            details?: string | undefined;
+            type: "unsupported";
+            feature: string;
+        } | {
+            details?: string | undefined;
+            type: "compatibility";
+            feature: string;
+        } | {
+            type: "deprecated";
+            message: string;
+            setting: string;
+        } | {
             details?: string | undefined;
             type: "unsupported-setting";
             setting: string;
         } | {
             details?: string | undefined;
-            type: "unsupported-tool";
             tool: any;
+            type: "unsupported-tool";
         } | {
             type: "other";
             message: string;
@@ -3126,22 +3983,22 @@ export declare const _fetchSearchMessages: import("convex/server").RegisteredQue
             providerOptions?: Record<string, Record<string, any>> | undefined;
             providerMetadata?: Record<string, Record<string, any>> | undefined;
             signature?: string | undefined;
-            type: "reasoning";
             text: string;
+            type: "reasoning";
         } | {
             signature?: string | undefined;
-            type: "text";
             text: string;
+            type: "text";
         } | {
             type: "redacted";
             data: string;
         })[] | undefined;
+        tool: boolean;
         status: "pending" | "success" | "failed";
         order: number;
         _creationTime: number;
         threadId: string;
         stepOrder: number;
-        tool: boolean;
         _id: string;
     }[] | undefined;
     beforeMessageId?: import("convex/values").GenericId<"messages"> | undefined;
@@ -3152,6 +4009,8 @@ export declare const _fetchSearchMessages: import("convex/server").RegisteredQue
     };
     embeddingIds: import("convex/values").GenericId<"embeddings_128" | "embeddings_256" | "embeddings_512" | "embeddings_768" | "embeddings_1024" | "embeddings_1408" | "embeddings_1536" | "embeddings_2048" | "embeddings_3072" | "embeddings_4096">[];
 }, Promise<{
+    text?: string | undefined;
+    reasoning?: string | undefined;
     id?: string | undefined;
     userId?: string | undefined;
     embeddingId?: string | undefined;
@@ -3167,14 +4026,17 @@ export declare const _fetchSearchMessages: import("convex/server").RegisteredQue
         content: string | ({
             providerOptions?: Record<string, Record<string, any>> | undefined;
             providerMetadata?: Record<string, Record<string, any>> | undefined;
-            type: "text";
             text: string;
+            type: "text";
         } | {
             providerOptions?: Record<string, Record<string, any>> | undefined;
             mediaType?: string | undefined;
             mimeType?: string | undefined;
             type: "image";
-            image: string | ArrayBuffer;
+            image: string | ArrayBuffer | {
+                type: "reference";
+                reference: Record<string, string>;
+            };
         } | {
             providerOptions?: Record<string, Record<string, any>> | undefined;
             providerMetadata?: Record<string, Record<string, any>> | undefined;
@@ -3182,7 +4044,10 @@ export declare const _fetchSearchMessages: import("convex/server").RegisteredQue
             mimeType?: string | undefined;
             filename?: string | undefined;
             type: "file";
-            data: string | ArrayBuffer;
+            data: string | ArrayBuffer | {
+                type: "reference";
+                reference: Record<string, string>;
+            };
         })[];
     } | {
         providerOptions?: Record<string, Record<string, any>> | undefined;
@@ -3190,8 +4055,8 @@ export declare const _fetchSearchMessages: import("convex/server").RegisteredQue
         content: string | ({
             providerOptions?: Record<string, Record<string, any>> | undefined;
             providerMetadata?: Record<string, Record<string, any>> | undefined;
-            type: "text";
             text: string;
+            type: "text";
         } | {
             providerOptions?: Record<string, Record<string, any>> | undefined;
             providerMetadata?: Record<string, Record<string, any>> | undefined;
@@ -3199,32 +4064,51 @@ export declare const _fetchSearchMessages: import("convex/server").RegisteredQue
             mimeType?: string | undefined;
             filename?: string | undefined;
             type: "file";
-            data: string | ArrayBuffer;
+            data: string | ArrayBuffer | {
+                type: "reference";
+                reference: Record<string, string>;
+            };
         } | {
             providerOptions?: Record<string, Record<string, any>> | undefined;
             providerMetadata?: Record<string, Record<string, any>> | undefined;
             signature?: string | undefined;
-            type: "reasoning";
             text: string;
+            type: "reasoning";
+        } | {
+            providerOptions?: Record<string, Record<string, any>> | undefined;
+            providerMetadata?: Record<string, Record<string, any>> | undefined;
+            data?: string | ArrayBuffer | undefined;
+            url?: string | undefined;
+            type: "reasoning-file";
+            mediaType: string;
+        } | {
+            providerOptions?: Record<string, Record<string, any>> | undefined;
+            providerMetadata?: Record<string, Record<string, any>> | undefined;
+            type: "custom";
+            kind: string;
         } | {
             providerOptions?: Record<string, Record<string, any>> | undefined;
             providerMetadata?: Record<string, Record<string, any>> | undefined;
             type: "redacted-reasoning";
             data: string;
         } | {
+            title?: string | undefined;
             providerOptions?: Record<string, Record<string, any>> | undefined;
             providerMetadata?: Record<string, Record<string, any>> | undefined;
             args?: any;
             providerExecuted?: boolean | undefined;
+            toolMetadata?: Record<string, any> | undefined;
             type: "tool-call";
             toolCallId: string;
             toolName: string;
             input: any;
         } | {
+            title?: string | undefined;
             providerOptions?: Record<string, Record<string, any>> | undefined;
             providerMetadata?: Record<string, Record<string, any>> | undefined;
             input?: any;
             providerExecuted?: boolean | undefined;
+            toolMetadata?: Record<string, any> | undefined;
             type: "tool-call";
             toolCallId: string;
             toolName: string;
@@ -3258,8 +4142,26 @@ export declare const _fetchSearchMessages: import("convex/server").RegisteredQue
                 type: "content";
                 value: ({
                     providerOptions?: Record<string, Record<string, any>> | undefined;
-                    type: "text";
                     text: string;
+                    type: "text";
+                } | {
+                    providerOptions?: Record<string, Record<string, any>> | undefined;
+                    filename?: string | undefined;
+                    type: "file";
+                    mediaType: string;
+                    data: {
+                        type: "reference";
+                        reference: Record<string, string>;
+                    } | {
+                        type: "url";
+                        url: string;
+                    } | {
+                        type: "data";
+                        data: string | ArrayBuffer;
+                    } | {
+                        text: string;
+                        type: "text";
+                    };
                 } | {
                     type: "media";
                     mediaType: string;
@@ -3272,17 +4174,26 @@ export declare const _fetchSearchMessages: import("convex/server").RegisteredQue
                     data: string;
                 } | {
                     providerOptions?: Record<string, Record<string, any>> | undefined;
+                    mediaType?: string | undefined;
                     type: "file-url";
                     url: string;
                 } | {
                     providerOptions?: Record<string, Record<string, any>> | undefined;
                     type: "file-id";
                     fileId: string | Record<string, string>;
+                } | {
+                    providerOptions?: Record<string, Record<string, any>> | undefined;
+                    type: "file-reference";
+                    providerReference: Record<string, string>;
                 } | {
                     providerOptions?: Record<string, Record<string, any>> | undefined;
                     type: "image-data";
                     mediaType: string;
                     data: string;
+                } | {
+                    providerOptions?: Record<string, Record<string, any>> | undefined;
+                    type: "image-file-reference";
+                    providerReference: Record<string, string>;
                 } | {
                     providerOptions?: Record<string, Record<string, any>> | undefined;
                     type: "image-url";
@@ -3299,8 +4210,8 @@ export declare const _fetchSearchMessages: import("convex/server").RegisteredQue
             result?: any;
             isError?: boolean | undefined;
             experimental_content?: ({
-                type: "text";
                 text: string;
+                type: "text";
             } | {
                 mimeType?: string | undefined;
                 type: "image";
@@ -3329,6 +4240,8 @@ export declare const _fetchSearchMessages: import("convex/server").RegisteredQue
         } | {
             providerOptions?: Record<string, Record<string, any>> | undefined;
             providerMetadata?: Record<string, Record<string, any>> | undefined;
+            signature?: string | undefined;
+            isAutomatic?: boolean | undefined;
             type: "tool-approval-request";
             toolCallId: string;
             approvalId: string;
@@ -3365,8 +4278,26 @@ export declare const _fetchSearchMessages: import("convex/server").RegisteredQue
                 type: "content";
                 value: ({
                     providerOptions?: Record<string, Record<string, any>> | undefined;
-                    type: "text";
                     text: string;
+                    type: "text";
+                } | {
+                    providerOptions?: Record<string, Record<string, any>> | undefined;
+                    filename?: string | undefined;
+                    type: "file";
+                    mediaType: string;
+                    data: {
+                        type: "reference";
+                        reference: Record<string, string>;
+                    } | {
+                        type: "url";
+                        url: string;
+                    } | {
+                        type: "data";
+                        data: string | ArrayBuffer;
+                    } | {
+                        text: string;
+                        type: "text";
+                    };
                 } | {
                     type: "media";
                     mediaType: string;
@@ -3379,17 +4310,26 @@ export declare const _fetchSearchMessages: import("convex/server").RegisteredQue
                     data: string;
                 } | {
                     providerOptions?: Record<string, Record<string, any>> | undefined;
+                    mediaType?: string | undefined;
                     type: "file-url";
                     url: string;
                 } | {
                     providerOptions?: Record<string, Record<string, any>> | undefined;
                     type: "file-id";
                     fileId: string | Record<string, string>;
+                } | {
+                    providerOptions?: Record<string, Record<string, any>> | undefined;
+                    type: "file-reference";
+                    providerReference: Record<string, string>;
                 } | {
                     providerOptions?: Record<string, Record<string, any>> | undefined;
                     type: "image-data";
                     mediaType: string;
                     data: string;
+                } | {
+                    providerOptions?: Record<string, Record<string, any>> | undefined;
+                    type: "image-file-reference";
+                    providerReference: Record<string, string>;
                 } | {
                     providerOptions?: Record<string, Record<string, any>> | undefined;
                     type: "image-url";
@@ -3406,8 +4346,8 @@ export declare const _fetchSearchMessages: import("convex/server").RegisteredQue
             result?: any;
             isError?: boolean | undefined;
             experimental_content?: ({
-                type: "text";
                 text: string;
+                type: "text";
             } | {
                 mimeType?: string | undefined;
                 type: "image";
@@ -3430,15 +4370,17 @@ export declare const _fetchSearchMessages: import("convex/server").RegisteredQue
         role: "system";
         content: string;
     } | undefined;
-    text?: string | undefined;
     providerMetadata?: Record<string, Record<string, any>> | undefined;
-    reasoning?: string | undefined;
     usage?: {
+        promptTokens?: number | undefined;
+        completionTokens?: number | undefined;
+        totalTokens?: number | undefined;
         reasoningTokens?: number | undefined;
         cachedInputTokens?: number | undefined;
-        promptTokens: number;
-        completionTokens: number;
-        totalTokens: number;
+        nonCachedInputTokens?: number | undefined;
+        cacheWriteInputTokens?: number | undefined;
+        textOutputTokens?: number | undefined;
+        raw?: Record<string, any> | undefined;
     } | undefined;
     sources?: ({
         title?: string | undefined;
@@ -3459,13 +4401,25 @@ export declare const _fetchSearchMessages: import("convex/server").RegisteredQue
         sourceType: "document";
     })[] | undefined;
     warnings?: ({
+        details?: string | undefined;
+        type: "unsupported";
+        feature: string;
+    } | {
+        details?: string | undefined;
+        type: "compatibility";
+        feature: string;
+    } | {
+        type: "deprecated";
+        message: string;
+        setting: string;
+    } | {
         details?: string | undefined;
         type: "unsupported-setting";
         setting: string;
     } | {
         details?: string | undefined;
-        type: "unsupported-tool";
         tool: any;
+        type: "unsupported-tool";
     } | {
         type: "other";
         message: string;
@@ -3475,31 +4429,33 @@ export declare const _fetchSearchMessages: import("convex/server").RegisteredQue
         providerOptions?: Record<string, Record<string, any>> | undefined;
         providerMetadata?: Record<string, Record<string, any>> | undefined;
         signature?: string | undefined;
-        type: "reasoning";
         text: string;
+        type: "reasoning";
     } | {
         signature?: string | undefined;
-        type: "text";
         text: string;
+        type: "text";
     } | {
         type: "redacted";
         data: string;
     })[] | undefined;
+    tool: boolean;
     status: "pending" | "success" | "failed";
     order: number;
     _creationTime: number;
     threadId: string;
     stepOrder: number;
-    tool: boolean;
     _id: string;
 }[]>>;
 export declare const textSearch: import("convex/server").RegisteredQuery<"public", {
-    threadId?: import("convex/values").GenericId<"threads"> | undefined;
     text?: string | undefined;
+    threadId?: import("convex/values").GenericId<"threads"> | undefined;
     searchAllMessagesForUserId?: string | undefined;
     targetMessageId?: import("convex/values").GenericId<"messages"> | undefined;
     limit: number;
 }, Promise<{
+    text?: string | undefined;
+    reasoning?: string | undefined;
     id?: string | undefined;
     userId?: string | undefined;
     embeddingId?: string | undefined;
@@ -3515,14 +4471,17 @@ export declare const textSearch: import("convex/server").RegisteredQuery<"public
         content: string | ({
             providerOptions?: Record<string, Record<string, any>> | undefined;
             providerMetadata?: Record<string, Record<string, any>> | undefined;
-            type: "text";
             text: string;
+            type: "text";
         } | {
             providerOptions?: Record<string, Record<string, any>> | undefined;
             mediaType?: string | undefined;
             mimeType?: string | undefined;
             type: "image";
-            image: string | ArrayBuffer;
+            image: string | ArrayBuffer | {
+                type: "reference";
+                reference: Record<string, string>;
+            };
         } | {
             providerOptions?: Record<string, Record<string, any>> | undefined;
             providerMetadata?: Record<string, Record<string, any>> | undefined;
@@ -3530,7 +4489,10 @@ export declare const textSearch: import("convex/server").RegisteredQuery<"public
             mimeType?: string | undefined;
             filename?: string | undefined;
             type: "file";
-            data: string | ArrayBuffer;
+            data: string | ArrayBuffer | {
+                type: "reference";
+                reference: Record<string, string>;
+            };
         })[];
     } | {
         providerOptions?: Record<string, Record<string, any>> | undefined;
@@ -3538,8 +4500,8 @@ export declare const textSearch: import("convex/server").RegisteredQuery<"public
         content: string | ({
             providerOptions?: Record<string, Record<string, any>> | undefined;
             providerMetadata?: Record<string, Record<string, any>> | undefined;
-            type: "text";
             text: string;
+            type: "text";
         } | {
             providerOptions?: Record<string, Record<string, any>> | undefined;
             providerMetadata?: Record<string, Record<string, any>> | undefined;
@@ -3547,32 +4509,51 @@ export declare const textSearch: import("convex/server").RegisteredQuery<"public
             mimeType?: string | undefined;
             filename?: string | undefined;
             type: "file";
-            data: string | ArrayBuffer;
+            data: string | ArrayBuffer | {
+                type: "reference";
+                reference: Record<string, string>;
+            };
         } | {
             providerOptions?: Record<string, Record<string, any>> | undefined;
             providerMetadata?: Record<string, Record<string, any>> | undefined;
             signature?: string | undefined;
-            type: "reasoning";
             text: string;
+            type: "reasoning";
+        } | {
+            providerOptions?: Record<string, Record<string, any>> | undefined;
+            providerMetadata?: Record<string, Record<string, any>> | undefined;
+            data?: string | ArrayBuffer | undefined;
+            url?: string | undefined;
+            type: "reasoning-file";
+            mediaType: string;
+        } | {
+            providerOptions?: Record<string, Record<string, any>> | undefined;
+            providerMetadata?: Record<string, Record<string, any>> | undefined;
+            type: "custom";
+            kind: string;
         } | {
             providerOptions?: Record<string, Record<string, any>> | undefined;
             providerMetadata?: Record<string, Record<string, any>> | undefined;
             type: "redacted-reasoning";
             data: string;
         } | {
+            title?: string | undefined;
             providerOptions?: Record<string, Record<string, any>> | undefined;
             providerMetadata?: Record<string, Record<string, any>> | undefined;
             args?: any;
             providerExecuted?: boolean | undefined;
+            toolMetadata?: Record<string, any> | undefined;
             type: "tool-call";
             toolCallId: string;
             toolName: string;
             input: any;
         } | {
+            title?: string | undefined;
             providerOptions?: Record<string, Record<string, any>> | undefined;
             providerMetadata?: Record<string, Record<string, any>> | undefined;
             input?: any;
             providerExecuted?: boolean | undefined;
+            toolMetadata?: Record<string, any> | undefined;
             type: "tool-call";
             toolCallId: string;
             toolName: string;
@@ -3606,8 +4587,26 @@ export declare const textSearch: import("convex/server").RegisteredQuery<"public
                 type: "content";
                 value: ({
                     providerOptions?: Record<string, Record<string, any>> | undefined;
-                    type: "text";
                     text: string;
+                    type: "text";
+                } | {
+                    providerOptions?: Record<string, Record<string, any>> | undefined;
+                    filename?: string | undefined;
+                    type: "file";
+                    mediaType: string;
+                    data: {
+                        type: "reference";
+                        reference: Record<string, string>;
+                    } | {
+                        type: "url";
+                        url: string;
+                    } | {
+                        type: "data";
+                        data: string | ArrayBuffer;
+                    } | {
+                        text: string;
+                        type: "text";
+                    };
                 } | {
                     type: "media";
                     mediaType: string;
@@ -3620,17 +4619,26 @@ export declare const textSearch: import("convex/server").RegisteredQuery<"public
                     data: string;
                 } | {
                     providerOptions?: Record<string, Record<string, any>> | undefined;
+                    mediaType?: string | undefined;
                     type: "file-url";
                     url: string;
                 } | {
                     providerOptions?: Record<string, Record<string, any>> | undefined;
                     type: "file-id";
                     fileId: string | Record<string, string>;
+                } | {
+                    providerOptions?: Record<string, Record<string, any>> | undefined;
+                    type: "file-reference";
+                    providerReference: Record<string, string>;
                 } | {
                     providerOptions?: Record<string, Record<string, any>> | undefined;
                     type: "image-data";
                     mediaType: string;
                     data: string;
+                } | {
+                    providerOptions?: Record<string, Record<string, any>> | undefined;
+                    type: "image-file-reference";
+                    providerReference: Record<string, string>;
                 } | {
                     providerOptions?: Record<string, Record<string, any>> | undefined;
                     type: "image-url";
@@ -3647,8 +4655,8 @@ export declare const textSearch: import("convex/server").RegisteredQuery<"public
             result?: any;
             isError?: boolean | undefined;
             experimental_content?: ({
-                type: "text";
                 text: string;
+                type: "text";
             } | {
                 mimeType?: string | undefined;
                 type: "image";
@@ -3677,6 +4685,8 @@ export declare const textSearch: import("convex/server").RegisteredQuery<"public
         } | {
             providerOptions?: Record<string, Record<string, any>> | undefined;
             providerMetadata?: Record<string, Record<string, any>> | undefined;
+            signature?: string | undefined;
+            isAutomatic?: boolean | undefined;
             type: "tool-approval-request";
             toolCallId: string;
             approvalId: string;
@@ -3713,8 +4723,26 @@ export declare const textSearch: import("convex/server").RegisteredQuery<"public
                 type: "content";
                 value: ({
                     providerOptions?: Record<string, Record<string, any>> | undefined;
-                    type: "text";
                     text: string;
+                    type: "text";
+                } | {
+                    providerOptions?: Record<string, Record<string, any>> | undefined;
+                    filename?: string | undefined;
+                    type: "file";
+                    mediaType: string;
+                    data: {
+                        type: "reference";
+                        reference: Record<string, string>;
+                    } | {
+                        type: "url";
+                        url: string;
+                    } | {
+                        type: "data";
+                        data: string | ArrayBuffer;
+                    } | {
+                        text: string;
+                        type: "text";
+                    };
                 } | {
                     type: "media";
                     mediaType: string;
@@ -3727,17 +4755,26 @@ export declare const textSearch: import("convex/server").RegisteredQuery<"public
                     data: string;
                 } | {
                     providerOptions?: Record<string, Record<string, any>> | undefined;
+                    mediaType?: string | undefined;
                     type: "file-url";
                     url: string;
                 } | {
                     providerOptions?: Record<string, Record<string, any>> | undefined;
                     type: "file-id";
                     fileId: string | Record<string, string>;
+                } | {
+                    providerOptions?: Record<string, Record<string, any>> | undefined;
+                    type: "file-reference";
+                    providerReference: Record<string, string>;
                 } | {
                     providerOptions?: Record<string, Record<string, any>> | undefined;
                     type: "image-data";
                     mediaType: string;
                     data: string;
+                } | {
+                    providerOptions?: Record<string, Record<string, any>> | undefined;
+                    type: "image-file-reference";
+                    providerReference: Record<string, string>;
                 } | {
                     providerOptions?: Record<string, Record<string, any>> | undefined;
                     type: "image-url";
@@ -3754,8 +4791,8 @@ export declare const textSearch: import("convex/server").RegisteredQuery<"public
             result?: any;
             isError?: boolean | undefined;
             experimental_content?: ({
-                type: "text";
                 text: string;
+                type: "text";
             } | {
                 mimeType?: string | undefined;
                 type: "image";
@@ -3778,15 +4815,17 @@ export declare const textSearch: import("convex/server").RegisteredQuery<"public
         role: "system";
         content: string;
     } | undefined;
-    text?: string | undefined;
     providerMetadata?: Record<string, Record<string, any>> | undefined;
-    reasoning?: string | undefined;
     usage?: {
+        promptTokens?: number | undefined;
+        completionTokens?: number | undefined;
+        totalTokens?: number | undefined;
         reasoningTokens?: number | undefined;
         cachedInputTokens?: number | undefined;
-        promptTokens: number;
-        completionTokens: number;
-        totalTokens: number;
+        nonCachedInputTokens?: number | undefined;
+        cacheWriteInputTokens?: number | undefined;
+        textOutputTokens?: number | undefined;
+        raw?: Record<string, any> | undefined;
     } | undefined;
     sources?: ({
         title?: string | undefined;
@@ -3807,13 +4846,25 @@ export declare const textSearch: import("convex/server").RegisteredQuery<"public
         sourceType: "document";
     })[] | undefined;
     warnings?: ({
+        details?: string | undefined;
+        type: "unsupported";
+        feature: string;
+    } | {
+        details?: string | undefined;
+        type: "compatibility";
+        feature: string;
+    } | {
+        type: "deprecated";
+        message: string;
+        setting: string;
+    } | {
         details?: string | undefined;
         type: "unsupported-setting";
         setting: string;
     } | {
         details?: string | undefined;
-        type: "unsupported-tool";
         tool: any;
+        type: "unsupported-tool";
     } | {
         type: "other";
         message: string;
@@ -3823,22 +4874,22 @@ export declare const textSearch: import("convex/server").RegisteredQuery<"public
         providerOptions?: Record<string, Record<string, any>> | undefined;
         providerMetadata?: Record<string, Record<string, any>> | undefined;
         signature?: string | undefined;
-        type: "reasoning";
         text: string;
+        type: "reasoning";
     } | {
         signature?: string | undefined;
-        type: "text";
         text: string;
+        type: "text";
     } | {
         type: "redacted";
         data: string;
     })[] | undefined;
+    tool: boolean;
     status: "pending" | "success" | "failed";
     order: number;
     _creationTime: number;
     threadId: string;
     stepOrder: number;
-    tool: boolean;
     _id: string;
 }[]>>;
 export declare const getMessageSearchFields: import("convex/server").RegisteredQuery<"public", {