@convex-dev/agent 0.6.4 → 0.7.0-alpha.0

package/dist/{client → vercel/client}/streaming.d.ts

@@ -1,10 +1,11 @@
 import { type AsyncIterableStream, type ChunkDetector, type StreamTextTransform, type TextStreamPart, type ToolSet, type UIMessageChunk } from "ai";
-import { type ProviderOptions, type StreamArgs, type StreamMessage } from "../validators.js";
+import { type ProviderOptions, type StreamArgs, type StreamMessage } from "../../validators.js";
 import type { ActionCtx, AgentComponent, MutationCtx, QueryCtx, SyncStreamsReturnValue } from "./types.js";
 export declare const vStreamMessagesReturnValue: import("convex/values").VObject<{
     splitCursor?: string | null | undefined;
     pageStatus?: "SplitRecommended" | "SplitRequired" | null | undefined;
     streams?: {
+        kind: "list";
         messages: {
             userId?: string | undefined;
             agentName?: string | undefined;
@@ -17,7 +18,6 @@ export declare const vStreamMessagesReturnValue: import("convex/values").VObject
             stepOrder: number;
             streamId: string;
         }[];
-        kind: "list";
     } | {
         kind: "deltas";
         deltas: {
@@ -28,6 +28,8 @@ export declare const vStreamMessagesReturnValue: import("convex/values").VObject
         }[];
     } | undefined;
     page: {
+        text?: string | undefined;
+        reasoning?: string | undefined;
         id?: string | undefined;
         userId?: string | undefined;
         embeddingId?: string | undefined;
@@ -43,14 +45,17 @@ export declare const vStreamMessagesReturnValue: import("convex/values").VObject
             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;
@@ -58,7 +63,10 @@ export declare const vStreamMessagesReturnValue: import("convex/values").VObject
                 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;
@@ -66,8 +74,8 @@ export declare const vStreamMessagesReturnValue: import("convex/values").VObject
             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;
@@ -75,32 +83,51 @@ export declare const vStreamMessagesReturnValue: import("convex/values").VObject
                 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;
@@ -134,8 +161,26 @@ export declare const vStreamMessagesReturnValue: import("convex/values").VObject
                     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;
@@ -148,17 +193,26 @@ export declare const vStreamMessagesReturnValue: import("convex/values").VObject
                         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";
@@ -175,8 +229,8 @@ export declare const vStreamMessagesReturnValue: import("convex/values").VObject
                 result?: any;
                 isError?: boolean | undefined;
                 experimental_content?: ({
-                    type: "text";
                     text: string;
+                    type: "text";
                 } | {
                     mimeType?: string | undefined;
                     type: "image";
@@ -205,6 +259,8 @@ export declare const vStreamMessagesReturnValue: import("convex/values").VObject
             } | {
                 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;
@@ -241,8 +297,26 @@ export declare const vStreamMessagesReturnValue: import("convex/values").VObject
                     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;
@@ -255,17 +329,26 @@ export declare const vStreamMessagesReturnValue: import("convex/values").VObject
                         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";
@@ -282,8 +365,8 @@ export declare const vStreamMessagesReturnValue: import("convex/values").VObject
                 result?: any;
                 isError?: boolean | undefined;
                 experimental_content?: ({
-                    type: "text";
                     text: string;
+                    type: "text";
                 } | {
                     mimeType?: string | undefined;
                     type: "image";
@@ -306,15 +389,17 @@ export declare const vStreamMessagesReturnValue: import("convex/values").VObject
             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;
@@ -335,13 +420,25 @@ export declare const vStreamMessagesReturnValue: import("convex/values").VObject
             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;
@@ -351,28 +448,29 @@ export declare const vStreamMessagesReturnValue: import("convex/values").VObject
             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;
     }[];
     continueCursor: string;
     isDone: boolean;
 }, {
     streams: import("convex/values").VUnion<{
+        kind: "list";
         messages: {
             userId?: string | undefined;
             agentName?: string | undefined;
@@ -385,7 +483,6 @@ export declare const vStreamMessagesReturnValue: import("convex/values").VObject
             stepOrder: number;
             streamId: string;
         }[];
-        kind: "list";
     } | {
         kind: "deltas";
         deltas: {
@@ -395,6 +492,7 @@ export declare const vStreamMessagesReturnValue: import("convex/values").VObject
             parts: any[];
         }[];
     } | undefined, [import("convex/values").VObject<{
+        kind: "list";
         messages: {
             userId?: string | undefined;
             agentName?: string | undefined;
@@ -407,7 +505,6 @@ export declare const vStreamMessagesReturnValue: import("convex/values").VObject
             stepOrder: number;
             streamId: string;
         }[];
-        kind: "list";
     }, {
         kind: import("convex/values").VLiteral<"list", "required">;
         messages: import("convex/values").VArray<{
@@ -444,7 +541,7 @@ export declare const vStreamMessagesReturnValue: import("convex/values").VObject
             provider: import("convex/values").VString<string | undefined, "optional">;
             providerOptions: import("convex/values").VRecord<Record<string, Record<string, any>> | undefined, import("convex/values").VString<string, "required">, import("convex/values").VRecord<Record<string, any>, import("convex/values").VString<string, "required">, import("convex/values").VAny<any, "required", string>, "required", string>, "optional", string>;
         }, "required", "status" | "userId" | "order" | "stepOrder" | "agentName" | "model" | "provider" | "providerOptions" | `providerOptions.${string}` | "format" | "streamId">, "required">;
-    }, "required", "messages" | "kind">, import("convex/values").VObject<{
+    }, "required", "kind" | "messages">, import("convex/values").VObject<{
         kind: "deltas";
         deltas: {
             streamId: string;
@@ -470,8 +567,10 @@ export declare const vStreamMessagesReturnValue: import("convex/values").VObject
             end: import("convex/values").VFloat64<number, "required">;
             parts: import("convex/values").VArray<any[], import("convex/values").VAny<any, "required", string>, "required">;
         }, "required", "streamId" | "start" | "end" | "parts">, "required">;
-    }, "required", "kind" | "deltas">], "optional", "messages" | "kind" | "deltas">;
+    }, "required", "kind" | "deltas">], "optional", "kind" | "messages" | "deltas">;
     page: import("convex/values").VArray<{
+        text?: string | undefined;
+        reasoning?: string | undefined;
         id?: string | undefined;
         userId?: string | undefined;
         embeddingId?: string | undefined;
@@ -487,14 +586,17 @@ export declare const vStreamMessagesReturnValue: import("convex/values").VObject
             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;
@@ -502,7 +604,10 @@ export declare const vStreamMessagesReturnValue: import("convex/values").VObject
                 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;
@@ -510,8 +615,8 @@ export declare const vStreamMessagesReturnValue: import("convex/values").VObject
             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;
@@ -519,32 +624,51 @@ export declare const vStreamMessagesReturnValue: import("convex/values").VObject
                 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;
@@ -578,8 +702,26 @@ export declare const vStreamMessagesReturnValue: import("convex/values").VObject
                     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;
@@ -592,17 +734,26 @@ export declare const vStreamMessagesReturnValue: import("convex/values").VObject
                         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";
@@ -619,8 +770,8 @@ export declare const vStreamMessagesReturnValue: import("convex/values").VObject
                 result?: any;
                 isError?: boolean | undefined;
                 experimental_content?: ({
-                    type: "text";
                     text: string;
+                    type: "text";
                 } | {
                     mimeType?: string | undefined;
                     type: "image";
@@ -649,6 +800,8 @@ export declare const vStreamMessagesReturnValue: import("convex/values").VObject
             } | {
                 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;
@@ -685,8 +838,26 @@ export declare const vStreamMessagesReturnValue: import("convex/values").VObject
                     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;
@@ -699,17 +870,26 @@ export declare const vStreamMessagesReturnValue: import("convex/values").VObject
                         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";
@@ -726,8 +906,8 @@ export declare const vStreamMessagesReturnValue: import("convex/values").VObject
                 result?: any;
                 isError?: boolean | undefined;
                 experimental_content?: ({
-                    type: "text";
                     text: string;
+                    type: "text";
                 } | {
                     mimeType?: string | undefined;
                     type: "image";
@@ -750,15 +930,17 @@ export declare const vStreamMessagesReturnValue: import("convex/values").VObject
             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;
@@ -779,13 +961,25 @@ export declare const vStreamMessagesReturnValue: import("convex/values").VObject
             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;
@@ -795,24 +989,26 @@ export declare const vStreamMessagesReturnValue: import("convex/values").VObject
             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;
     }[], import("convex/values").VObject<{
+        text?: string | undefined;
+        reasoning?: string | undefined;
         id?: string | undefined;
         userId?: string | undefined;
         embeddingId?: string | undefined;
@@ -828,14 +1024,17 @@ export declare const vStreamMessagesReturnValue: import("convex/values").VObject
             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;
@@ -843,7 +1042,10 @@ export declare const vStreamMessagesReturnValue: import("convex/values").VObject
                 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;
@@ -851,8 +1053,8 @@ export declare const vStreamMessagesReturnValue: import("convex/values").VObject
             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;
@@ -860,32 +1062,51 @@ export declare const vStreamMessagesReturnValue: import("convex/values").VObject
                 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;
@@ -919,8 +1140,26 @@ export declare const vStreamMessagesReturnValue: import("convex/values").VObject
                     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;
@@ -933,17 +1172,26 @@ export declare const vStreamMessagesReturnValue: import("convex/values").VObject
                         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";
@@ -960,8 +1208,8 @@ export declare const vStreamMessagesReturnValue: import("convex/values").VObject
                 result?: any;
                 isError?: boolean | undefined;
                 experimental_content?: ({
-                    type: "text";
                     text: string;
+                    type: "text";
                 } | {
                     mimeType?: string | undefined;
                     type: "image";
@@ -990,6 +1238,8 @@ export declare const vStreamMessagesReturnValue: import("convex/values").VObject
             } | {
                 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;
@@ -1026,8 +1276,26 @@ export declare const vStreamMessagesReturnValue: import("convex/values").VObject
                     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;
@@ -1040,17 +1308,26 @@ export declare const vStreamMessagesReturnValue: import("convex/values").VObject
                         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";
@@ -1067,8 +1344,8 @@ export declare const vStreamMessagesReturnValue: import("convex/values").VObject
                 result?: any;
                 isError?: boolean | undefined;
                 experimental_content?: ({
-                    type: "text";
                     text: string;
+                    type: "text";
                 } | {
                     mimeType?: string | undefined;
                     type: "image";
@@ -1091,15 +1368,17 @@ export declare const vStreamMessagesReturnValue: import("convex/values").VObject
             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;
@@ -1120,13 +1399,25 @@ export declare const vStreamMessagesReturnValue: import("convex/values").VObject
             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;
@@ -1136,22 +1427,22 @@ export declare const vStreamMessagesReturnValue: import("convex/values").VObject
             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;
     }, {
         _id: import("convex/values").VString<string, "required">;
@@ -1174,14 +1465,17 @@ export declare const vStreamMessagesReturnValue: import("convex/values").VObject
             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;
@@ -1189,7 +1483,10 @@ export declare const vStreamMessagesReturnValue: import("convex/values").VObject
                 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;
@@ -1197,8 +1494,8 @@ export declare const vStreamMessagesReturnValue: import("convex/values").VObject
             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;
@@ -1206,32 +1503,51 @@ export declare const vStreamMessagesReturnValue: import("convex/values").VObject
                 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;
@@ -1265,8 +1581,26 @@ export declare const vStreamMessagesReturnValue: import("convex/values").VObject
                     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;
@@ -1279,17 +1613,26 @@ export declare const vStreamMessagesReturnValue: import("convex/values").VObject
                         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";
@@ -1306,8 +1649,8 @@ export declare const vStreamMessagesReturnValue: import("convex/values").VObject
                 result?: any;
                 isError?: boolean | undefined;
                 experimental_content?: ({
-                    type: "text";
                     text: string;
+                    type: "text";
                 } | {
                     mimeType?: string | undefined;
                     type: "image";
@@ -1336,6 +1679,8 @@ export declare const vStreamMessagesReturnValue: import("convex/values").VObject
             } | {
                 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;
@@ -1372,8 +1717,26 @@ export declare const vStreamMessagesReturnValue: import("convex/values").VObject
                     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;
@@ -1386,17 +1749,26 @@ export declare const vStreamMessagesReturnValue: import("convex/values").VObject
                         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";
@@ -1413,8 +1785,8 @@ export declare const vStreamMessagesReturnValue: import("convex/values").VObject
                 result?: any;
                 isError?: boolean | undefined;
                 experimental_content?: ({
-                    type: "text";
                     text: string;
+                    type: "text";
                 } | {
                     mimeType?: string | undefined;
                     type: "image";
@@ -1442,14 +1814,17 @@ export declare const vStreamMessagesReturnValue: import("convex/values").VObject
             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;
@@ -1457,21 +1832,27 @@ export declare const vStreamMessagesReturnValue: import("convex/values").VObject
                 mimeType?: string | undefined;
                 filename?: string | undefined;
                 type: "file";
-                data: string | ArrayBuffer;
+                data: string | ArrayBuffer | {
+                    type: "reference";
+                    reference: Record<string, string>;
+                };
             })[];
         }, {
             role: import("convex/values").VLiteral<"user", "required">;
             content: import("convex/values").VUnion<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;
@@ -1479,18 +1860,24 @@ export declare const vStreamMessagesReturnValue: import("convex/values").VObject
                 mimeType?: string | undefined;
                 filename?: string | undefined;
                 type: "file";
-                data: string | ArrayBuffer;
+                data: string | ArrayBuffer | {
+                    type: "reference";
+                    reference: Record<string, string>;
+                };
             })[], [import("convex/values").VString<string, "required">, import("convex/values").VArray<({
                 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;
@@ -1498,18 +1885,24 @@ export declare const vStreamMessagesReturnValue: import("convex/values").VObject
                 mimeType?: string | undefined;
                 filename?: string | undefined;
                 type: "file";
-                data: string | ArrayBuffer;
+                data: string | ArrayBuffer | {
+                    type: "reference";
+                    reference: Record<string, string>;
+                };
             })[], import("convex/values").VUnion<{
                 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;
@@ -1517,46 +1910,73 @@ export declare const vStreamMessagesReturnValue: import("convex/values").VObject
                 mimeType?: string | undefined;
                 filename?: string | undefined;
                 type: "file";
-                data: string | ArrayBuffer;
+                data: string | ArrayBuffer | {
+                    type: "reference";
+                    reference: Record<string, string>;
+                };
             }, [import("convex/values").VObject<{
                 providerOptions?: Record<string, Record<string, any>> | undefined;
                 providerMetadata?: Record<string, Record<string, any>> | undefined;
-                type: "text";
                 text: string;
+                type: "text";
             }, {
                 type: import("convex/values").VLiteral<"text", "required">;
                 text: import("convex/values").VString<string, "required">;
                 providerOptions: import("convex/values").VRecord<Record<string, Record<string, any>> | undefined, import("convex/values").VString<string, "required">, import("convex/values").VRecord<Record<string, any>, import("convex/values").VString<string, "required">, import("convex/values").VAny<any, "required", string>, "required", string>, "optional", string>;
                 providerMetadata: import("convex/values").VRecord<Record<string, Record<string, any>> | undefined, import("convex/values").VString<string, "required">, import("convex/values").VRecord<Record<string, any>, import("convex/values").VString<string, "required">, import("convex/values").VAny<any, "required", string>, "required", string>, "optional", string>;
-            }, "required", "type" | "providerOptions" | "text" | "providerMetadata" | `providerOptions.${string}` | `providerMetadata.${string}`>, import("convex/values").VObject<{
+            }, "required", "text" | "type" | "providerOptions" | "providerMetadata" | `providerOptions.${string}` | `providerMetadata.${string}`>, import("convex/values").VObject<{
                 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>;
+                };
             }, {
                 type: import("convex/values").VLiteral<"image", "required">;
-                image: import("convex/values").VUnion<string | ArrayBuffer, [import("convex/values").VString<string, "required">, import("convex/values").VBytes<ArrayBuffer, "required">], "required", never>;
+                image: import("convex/values").VUnion<string | ArrayBuffer | {
+                    type: "reference";
+                    reference: Record<string, string>;
+                }, [import("convex/values").VString<string, "required">, import("convex/values").VBytes<ArrayBuffer, "required">, import("convex/values").VObject<{
+                    type: "reference";
+                    reference: Record<string, string>;
+                }, {
+                    type: import("convex/values").VLiteral<"reference", "required">;
+                    reference: import("convex/values").VRecord<Record<string, string>, import("convex/values").VString<string, "required">, import("convex/values").VString<string, "required">, "required", string>;
+                }, "required", "type" | "reference" | `reference.${string}`>], "required", "type" | "reference" | `reference.${string}`>;
                 mediaType: import("convex/values").VString<string | undefined, "optional">;
                 mimeType: import("convex/values").VString<string | undefined, "optional">;
                 providerOptions: import("convex/values").VRecord<Record<string, Record<string, any>> | undefined, import("convex/values").VString<string, "required">, import("convex/values").VRecord<Record<string, any>, import("convex/values").VString<string, "required">, import("convex/values").VAny<any, "required", string>, "required", string>, "optional", string>;
-            }, "required", "type" | "providerOptions" | `providerOptions.${string}` | "image" | "mediaType" | "mimeType">, import("convex/values").VObject<{
+            }, "required", "type" | "providerOptions" | `providerOptions.${string}` | "image" | "mediaType" | "mimeType" | "image.type" | "image.reference" | `image.reference.${string}`>, import("convex/values").VObject<{
                 providerOptions?: Record<string, Record<string, any>> | undefined;
                 providerMetadata?: Record<string, Record<string, any>> | undefined;
                 mediaType?: string | undefined;
                 mimeType?: string | undefined;
                 filename?: string | undefined;
                 type: "file";
-                data: string | ArrayBuffer;
+                data: string | ArrayBuffer | {
+                    type: "reference";
+                    reference: Record<string, string>;
+                };
             }, {
                 type: import("convex/values").VLiteral<"file", "required">;
-                data: import("convex/values").VUnion<string | ArrayBuffer, [import("convex/values").VString<string, "required">, import("convex/values").VBytes<ArrayBuffer, "required">], "required", never>;
+                data: import("convex/values").VUnion<string | ArrayBuffer | {
+                    type: "reference";
+                    reference: Record<string, string>;
+                }, [import("convex/values").VString<string, "required">, import("convex/values").VBytes<ArrayBuffer, "required">, import("convex/values").VObject<{
+                    type: "reference";
+                    reference: Record<string, string>;
+                }, {
+                    type: import("convex/values").VLiteral<"reference", "required">;
+                    reference: import("convex/values").VRecord<Record<string, string>, import("convex/values").VString<string, "required">, import("convex/values").VString<string, "required">, "required", string>;
+                }, "required", "type" | "reference" | `reference.${string}`>], "required", "type" | "reference" | `reference.${string}`>;
                 filename: import("convex/values").VString<string | undefined, "optional">;
                 mediaType: import("convex/values").VString<string | undefined, "optional">;
                 mimeType: import("convex/values").VString<string | undefined, "optional">;
                 providerOptions: import("convex/values").VRecord<Record<string, Record<string, any>> | undefined, import("convex/values").VString<string, "required">, import("convex/values").VRecord<Record<string, any>, import("convex/values").VString<string, "required">, import("convex/values").VAny<any, "required", string>, "required", string>, "optional", string>;
                 providerMetadata: import("convex/values").VRecord<Record<string, Record<string, any>> | undefined, import("convex/values").VString<string, "required">, import("convex/values").VRecord<Record<string, any>, import("convex/values").VString<string, "required">, import("convex/values").VAny<any, "required", string>, "required", string>, "optional", string>;
-            }, "required", "type" | "providerOptions" | "providerMetadata" | `providerOptions.${string}` | `providerMetadata.${string}` | "mediaType" | "mimeType" | "data" | "filename">], "required", "type" | "providerOptions" | "text" | "providerMetadata" | `providerOptions.${string}` | `providerMetadata.${string}` | "image" | "mediaType" | "mimeType" | "data" | "filename">, "required">], "required", never>;
+            }, "required", "type" | "providerOptions" | "providerMetadata" | `providerOptions.${string}` | `providerMetadata.${string}` | "mediaType" | "mimeType" | "data" | "filename" | "data.type" | "data.reference" | `data.reference.${string}`>], "required", "text" | "type" | "providerOptions" | "providerMetadata" | `providerOptions.${string}` | `providerMetadata.${string}` | "image" | "mediaType" | "mimeType" | "image.type" | "image.reference" | `image.reference.${string}` | "data" | "filename" | "data.type" | "data.reference" | `data.reference.${string}`>, "required">], "required", never>;
             providerOptions: import("convex/values").VRecord<Record<string, Record<string, any>> | undefined, import("convex/values").VString<string, "required">, import("convex/values").VRecord<Record<string, any>, import("convex/values").VString<string, "required">, import("convex/values").VAny<any, "required", string>, "required", string>, "optional", string>;
         }, "required", "providerOptions" | "role" | `providerOptions.${string}` | "content">, import("convex/values").VObject<{
             providerOptions?: Record<string, Record<string, any>> | undefined;
@@ -1564,8 +1984,8 @@ export declare const vStreamMessagesReturnValue: import("convex/values").VObject
             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;
@@ -1573,32 +1993,51 @@ export declare const vStreamMessagesReturnValue: import("convex/values").VObject
                 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;
@@ -1632,8 +2071,26 @@ export declare const vStreamMessagesReturnValue: import("convex/values").VObject
                     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;
@@ -1646,17 +2103,26 @@ export declare const vStreamMessagesReturnValue: import("convex/values").VObject
                         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";
@@ -1673,8 +2139,8 @@ export declare const vStreamMessagesReturnValue: import("convex/values").VObject
                 result?: any;
                 isError?: boolean | undefined;
                 experimental_content?: ({
-                    type: "text";
                     text: string;
+                    type: "text";
                 } | {
                     mimeType?: string | undefined;
                     type: "image";
@@ -1703,6 +2169,8 @@ export declare const vStreamMessagesReturnValue: import("convex/values").VObject
             } | {
                 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;
@@ -1712,8 +2180,8 @@ export declare const vStreamMessagesReturnValue: import("convex/values").VObject
             content: import("convex/values").VUnion<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;
@@ -1721,32 +2189,51 @@ export declare const vStreamMessagesReturnValue: import("convex/values").VObject
                 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;
@@ -1780,8 +2267,26 @@ export declare const vStreamMessagesReturnValue: import("convex/values").VObject
                     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;
@@ -1794,17 +2299,26 @@ export declare const vStreamMessagesReturnValue: import("convex/values").VObject
                         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";
@@ -1821,8 +2335,8 @@ export declare const vStreamMessagesReturnValue: import("convex/values").VObject
                 result?: any;
                 isError?: boolean | undefined;
                 experimental_content?: ({
-                    type: "text";
                     text: string;
+                    type: "text";
                 } | {
                     mimeType?: string | undefined;
                     type: "image";
@@ -1851,14 +2365,16 @@ export declare const vStreamMessagesReturnValue: import("convex/values").VObject
             } | {
                 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;
             })[], [import("convex/values").VString<string, "required">, import("convex/values").VArray<({
                 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;
@@ -1866,32 +2382,51 @@ export declare const vStreamMessagesReturnValue: import("convex/values").VObject
                 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;
@@ -1925,8 +2460,26 @@ export declare const vStreamMessagesReturnValue: import("convex/values").VObject
                     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;
@@ -1939,17 +2492,26 @@ export declare const vStreamMessagesReturnValue: import("convex/values").VObject
                         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";
@@ -1966,8 +2528,8 @@ export declare const vStreamMessagesReturnValue: import("convex/values").VObject
                 result?: any;
                 isError?: boolean | undefined;
                 experimental_content?: ({
-                    type: "text";
                     text: string;
+                    type: "text";
                 } | {
                     mimeType?: string | undefined;
                     type: "image";
@@ -1996,14 +2558,16 @@ export declare const vStreamMessagesReturnValue: import("convex/values").VObject
             } | {
                 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;
             })[], import("convex/values").VUnion<{
                 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;
@@ -2011,32 +2575,51 @@ export declare const vStreamMessagesReturnValue: import("convex/values").VObject
                 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;
@@ -2070,8 +2653,26 @@ export declare const vStreamMessagesReturnValue: import("convex/values").VObject
                     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;
@@ -2084,17 +2685,26 @@ export declare const vStreamMessagesReturnValue: import("convex/values").VObject
                         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";
@@ -2111,8 +2721,8 @@ export declare const vStreamMessagesReturnValue: import("convex/values").VObject
                 result?: any;
                 isError?: boolean | undefined;
                 experimental_content?: ({
-                    type: "text";
                     text: string;
+                    type: "text";
                 } | {
                     mimeType?: string | undefined;
                     type: "image";
@@ -2141,48 +2751,86 @@ export declare const vStreamMessagesReturnValue: import("convex/values").VObject
             } | {
                 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;
             }, [import("convex/values").VObject<{
                 providerOptions?: Record<string, Record<string, any>> | undefined;
                 providerMetadata?: Record<string, Record<string, any>> | undefined;
-                type: "text";
                 text: string;
+                type: "text";
             }, {
                 type: import("convex/values").VLiteral<"text", "required">;
                 text: import("convex/values").VString<string, "required">;
                 providerOptions: import("convex/values").VRecord<Record<string, Record<string, any>> | undefined, import("convex/values").VString<string, "required">, import("convex/values").VRecord<Record<string, any>, import("convex/values").VString<string, "required">, import("convex/values").VAny<any, "required", string>, "required", string>, "optional", string>;
                 providerMetadata: import("convex/values").VRecord<Record<string, Record<string, any>> | undefined, import("convex/values").VString<string, "required">, import("convex/values").VRecord<Record<string, any>, import("convex/values").VString<string, "required">, import("convex/values").VAny<any, "required", string>, "required", string>, "optional", string>;
-            }, "required", "type" | "providerOptions" | "text" | "providerMetadata" | `providerOptions.${string}` | `providerMetadata.${string}`>, import("convex/values").VObject<{
+            }, "required", "text" | "type" | "providerOptions" | "providerMetadata" | `providerOptions.${string}` | `providerMetadata.${string}`>, import("convex/values").VObject<{
                 providerOptions?: Record<string, Record<string, any>> | undefined;
                 providerMetadata?: Record<string, Record<string, any>> | undefined;
                 mediaType?: string | undefined;
                 mimeType?: string | undefined;
                 filename?: string | undefined;
                 type: "file";
-                data: string | ArrayBuffer;
+                data: string | ArrayBuffer | {
+                    type: "reference";
+                    reference: Record<string, string>;
+                };
             }, {
                 type: import("convex/values").VLiteral<"file", "required">;
-                data: import("convex/values").VUnion<string | ArrayBuffer, [import("convex/values").VString<string, "required">, import("convex/values").VBytes<ArrayBuffer, "required">], "required", never>;
+                data: import("convex/values").VUnion<string | ArrayBuffer | {
+                    type: "reference";
+                    reference: Record<string, string>;
+                }, [import("convex/values").VString<string, "required">, import("convex/values").VBytes<ArrayBuffer, "required">, import("convex/values").VObject<{
+                    type: "reference";
+                    reference: Record<string, string>;
+                }, {
+                    type: import("convex/values").VLiteral<"reference", "required">;
+                    reference: import("convex/values").VRecord<Record<string, string>, import("convex/values").VString<string, "required">, import("convex/values").VString<string, "required">, "required", string>;
+                }, "required", "type" | "reference" | `reference.${string}`>], "required", "type" | "reference" | `reference.${string}`>;
                 filename: import("convex/values").VString<string | undefined, "optional">;
                 mediaType: import("convex/values").VString<string | undefined, "optional">;
                 mimeType: import("convex/values").VString<string | undefined, "optional">;
                 providerOptions: import("convex/values").VRecord<Record<string, Record<string, any>> | undefined, import("convex/values").VString<string, "required">, import("convex/values").VRecord<Record<string, any>, import("convex/values").VString<string, "required">, import("convex/values").VAny<any, "required", string>, "required", string>, "optional", string>;
                 providerMetadata: import("convex/values").VRecord<Record<string, Record<string, any>> | undefined, import("convex/values").VString<string, "required">, import("convex/values").VRecord<Record<string, any>, import("convex/values").VString<string, "required">, import("convex/values").VAny<any, "required", string>, "required", string>, "optional", string>;
-            }, "required", "type" | "providerOptions" | "providerMetadata" | `providerOptions.${string}` | `providerMetadata.${string}` | "mediaType" | "mimeType" | "data" | "filename">, import("convex/values").VObject<{
+            }, "required", "type" | "providerOptions" | "providerMetadata" | `providerOptions.${string}` | `providerMetadata.${string}` | "mediaType" | "mimeType" | "data" | "filename" | "data.type" | "data.reference" | `data.reference.${string}`>, import("convex/values").VObject<{
                 providerOptions?: Record<string, Record<string, any>> | undefined;
                 providerMetadata?: Record<string, Record<string, any>> | undefined;
                 signature?: string | undefined;
-                type: "reasoning";
                 text: string;
+                type: "reasoning";
             }, {
                 type: import("convex/values").VLiteral<"reasoning", "required">;
                 text: import("convex/values").VString<string, "required">;
                 signature: import("convex/values").VString<string | undefined, "optional">;
                 providerOptions: import("convex/values").VRecord<Record<string, Record<string, any>> | undefined, import("convex/values").VString<string, "required">, import("convex/values").VRecord<Record<string, any>, import("convex/values").VString<string, "required">, import("convex/values").VAny<any, "required", string>, "required", string>, "optional", string>;
                 providerMetadata: import("convex/values").VRecord<Record<string, Record<string, any>> | undefined, import("convex/values").VString<string, "required">, import("convex/values").VRecord<Record<string, any>, import("convex/values").VString<string, "required">, import("convex/values").VAny<any, "required", string>, "required", string>, "optional", string>;
-            }, "required", "type" | "providerOptions" | "text" | "providerMetadata" | `providerOptions.${string}` | `providerMetadata.${string}` | "signature">, import("convex/values").VObject<{
+            }, "required", "text" | "type" | "providerOptions" | "providerMetadata" | `providerOptions.${string}` | `providerMetadata.${string}` | "signature">, import("convex/values").VObject<{
+                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;
+            }, {
+                type: import("convex/values").VLiteral<"reasoning-file", "required">;
+                url: import("convex/values").VString<string | undefined, "optional">;
+                data: import("convex/values").VUnion<string | ArrayBuffer | undefined, [import("convex/values").VString<string, "required">, import("convex/values").VBytes<ArrayBuffer, "required">], "optional", never>;
+                mediaType: import("convex/values").VString<string, "required">;
+                providerOptions: import("convex/values").VRecord<Record<string, Record<string, any>> | undefined, import("convex/values").VString<string, "required">, import("convex/values").VRecord<Record<string, any>, import("convex/values").VString<string, "required">, import("convex/values").VAny<any, "required", string>, "required", string>, "optional", string>;
+                providerMetadata: import("convex/values").VRecord<Record<string, Record<string, any>> | undefined, import("convex/values").VString<string, "required">, import("convex/values").VRecord<Record<string, any>, import("convex/values").VString<string, "required">, import("convex/values").VAny<any, "required", string>, "required", string>, "optional", string>;
+            }, "required", "type" | "providerOptions" | "providerMetadata" | `providerOptions.${string}` | `providerMetadata.${string}` | "mediaType" | "data" | "url">, import("convex/values").VObject<{
+                providerOptions?: Record<string, Record<string, any>> | undefined;
+                providerMetadata?: Record<string, Record<string, any>> | undefined;
+                type: "custom";
+                kind: string;
+            }, {
+                type: import("convex/values").VLiteral<"custom", "required">;
+                kind: import("convex/values").VString<string, "required">;
+                providerOptions: import("convex/values").VRecord<Record<string, Record<string, any>> | undefined, import("convex/values").VString<string, "required">, import("convex/values").VRecord<Record<string, any>, import("convex/values").VString<string, "required">, import("convex/values").VAny<any, "required", string>, "required", string>, "optional", string>;
+                providerMetadata: import("convex/values").VRecord<Record<string, Record<string, any>> | undefined, import("convex/values").VString<string, "required">, import("convex/values").VRecord<Record<string, any>, import("convex/values").VString<string, "required">, import("convex/values").VAny<any, "required", string>, "required", string>, "optional", string>;
+            }, "required", "type" | "providerOptions" | "providerMetadata" | `providerOptions.${string}` | `providerMetadata.${string}` | "kind">, import("convex/values").VObject<{
                 providerOptions?: Record<string, Record<string, any>> | undefined;
                 providerMetadata?: Record<string, Record<string, any>> | undefined;
                 type: "redacted-reasoning";
@@ -2193,28 +2841,34 @@ export declare const vStreamMessagesReturnValue: import("convex/values").VObject
                 providerOptions: import("convex/values").VRecord<Record<string, Record<string, any>> | undefined, import("convex/values").VString<string, "required">, import("convex/values").VRecord<Record<string, any>, import("convex/values").VString<string, "required">, import("convex/values").VAny<any, "required", string>, "required", string>, "optional", string>;
                 providerMetadata: import("convex/values").VRecord<Record<string, Record<string, any>> | undefined, import("convex/values").VString<string, "required">, import("convex/values").VRecord<Record<string, any>, import("convex/values").VString<string, "required">, import("convex/values").VAny<any, "required", string>, "required", string>, "optional", string>;
             }, "required", "type" | "providerOptions" | "providerMetadata" | `providerOptions.${string}` | `providerMetadata.${string}` | "data">, import("convex/values").VUnion<{
+                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;
                 args: any;
             }, [import("convex/values").VObject<{
+                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;
@@ -2226,13 +2880,17 @@ export declare const vStreamMessagesReturnValue: import("convex/values").VObject
                 input: import("convex/values").VAny<any, "required", string>;
                 args: import("convex/values").VAny<any, "optional", string>;
                 providerExecuted: import("convex/values").VBoolean<boolean | undefined, "optional">;
+                title: import("convex/values").VString<string | undefined, "optional">;
+                toolMetadata: import("convex/values").VRecord<Record<string, any> | undefined, import("convex/values").VString<string, "required">, import("convex/values").VAny<any, "required", string>, "optional", string>;
                 providerOptions: import("convex/values").VRecord<Record<string, Record<string, any>> | undefined, import("convex/values").VString<string, "required">, import("convex/values").VRecord<Record<string, any>, import("convex/values").VString<string, "required">, import("convex/values").VAny<any, "required", string>, "required", string>, "optional", string>;
                 providerMetadata: import("convex/values").VRecord<Record<string, Record<string, any>> | undefined, import("convex/values").VString<string, "required">, import("convex/values").VRecord<Record<string, any>, import("convex/values").VString<string, "required">, import("convex/values").VAny<any, "required", string>, "required", string>, "optional", string>;
-            }, "required", "type" | "providerOptions" | "providerMetadata" | `providerOptions.${string}` | `providerMetadata.${string}` | "toolCallId" | "toolName" | "input" | "args" | "providerExecuted" | `input.${string}` | `args.${string}`>, import("convex/values").VObject<{
+            }, "required", "title" | "type" | "providerOptions" | "providerMetadata" | `providerOptions.${string}` | `providerMetadata.${string}` | "toolCallId" | "toolName" | "input" | "args" | "providerExecuted" | "toolMetadata" | `input.${string}` | `args.${string}` | `toolMetadata.${string}`>, import("convex/values").VObject<{
+                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;
@@ -2244,9 +2902,11 @@ export declare const vStreamMessagesReturnValue: import("convex/values").VObject
                 args: import("convex/values").VAny<any, "required", string>;
                 input: import("convex/values").VAny<any, "optional", string>;
                 providerExecuted: import("convex/values").VBoolean<boolean | undefined, "optional">;
+                title: import("convex/values").VString<string | undefined, "optional">;
+                toolMetadata: import("convex/values").VRecord<Record<string, any> | undefined, import("convex/values").VString<string, "required">, import("convex/values").VAny<any, "required", string>, "optional", string>;
                 providerOptions: import("convex/values").VRecord<Record<string, Record<string, any>> | undefined, import("convex/values").VString<string, "required">, import("convex/values").VRecord<Record<string, any>, import("convex/values").VString<string, "required">, import("convex/values").VAny<any, "required", string>, "required", string>, "optional", string>;
                 providerMetadata: import("convex/values").VRecord<Record<string, Record<string, any>> | undefined, import("convex/values").VString<string, "required">, import("convex/values").VRecord<Record<string, any>, import("convex/values").VString<string, "required">, import("convex/values").VAny<any, "required", string>, "required", string>, "optional", string>;
-            }, "required", "type" | "providerOptions" | "providerMetadata" | `providerOptions.${string}` | `providerMetadata.${string}` | "toolCallId" | "toolName" | "input" | "args" | "providerExecuted" | `input.${string}` | `args.${string}`>], "required", "type" | "providerOptions" | "providerMetadata" | `providerOptions.${string}` | `providerMetadata.${string}` | "toolCallId" | "toolName" | "input" | "args" | "providerExecuted" | `input.${string}` | `args.${string}`>, import("convex/values").VObject<{
+            }, "required", "title" | "type" | "providerOptions" | "providerMetadata" | `providerOptions.${string}` | `providerMetadata.${string}` | "toolCallId" | "toolName" | "input" | "args" | "providerExecuted" | "toolMetadata" | `input.${string}` | `args.${string}` | `toolMetadata.${string}`>], "required", "title" | "type" | "providerOptions" | "providerMetadata" | `providerOptions.${string}` | `providerMetadata.${string}` | "toolCallId" | "toolName" | "input" | "args" | "providerExecuted" | "toolMetadata" | `input.${string}` | `args.${string}` | `toolMetadata.${string}`>, import("convex/values").VObject<{
                 providerOptions?: Record<string, Record<string, any>> | undefined;
                 providerMetadata?: Record<string, Record<string, any>> | undefined;
                 args?: any;
@@ -2275,8 +2935,26 @@ export declare const vStreamMessagesReturnValue: import("convex/values").VObject
                     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;
@@ -2289,17 +2967,26 @@ export declare const vStreamMessagesReturnValue: import("convex/values").VObject
                         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";
@@ -2316,8 +3003,8 @@ export declare const vStreamMessagesReturnValue: import("convex/values").VObject
                 result?: any;
                 isError?: boolean | undefined;
                 experimental_content?: ({
-                    type: "text";
                     text: string;
+                    type: "text";
                 } | {
                     mimeType?: string | undefined;
                     type: "image";
@@ -2354,8 +3041,26 @@ export declare const vStreamMessagesReturnValue: import("convex/values").VObject
                     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;
@@ -2368,17 +3073,26 @@ export declare const vStreamMessagesReturnValue: import("convex/values").VObject
                         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";
@@ -2435,8 +3149,26 @@ export declare const vStreamMessagesReturnValue: import("convex/values").VObject
                     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;
@@ -2449,17 +3181,26 @@ export declare const vStreamMessagesReturnValue: import("convex/values").VObject
                         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";
@@ -2476,8 +3217,26 @@ export declare const vStreamMessagesReturnValue: import("convex/values").VObject
                     type: import("convex/values").VLiteral<"content", "required">;
                     value: import("convex/values").VArray<({
                         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;
@@ -2490,17 +3249,26 @@ export declare const vStreamMessagesReturnValue: import("convex/values").VObject
                         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";
@@ -2514,8 +3282,26 @@ export declare const vStreamMessagesReturnValue: import("convex/values").VObject
                         type: "custom";
                     })[], import("convex/values").VUnion<{
                         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;
@@ -2528,17 +3314,26 @@ export declare const vStreamMessagesReturnValue: import("convex/values").VObject
                         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";
@@ -2552,13 +3347,73 @@ export declare const vStreamMessagesReturnValue: import("convex/values").VObject
                         type: "custom";
                     }, [import("convex/values").VObject<{
                         providerOptions?: Record<string, Record<string, any>> | undefined;
-                        type: "text";
                         text: string;
+                        type: "text";
                     }, {
                         type: import("convex/values").VLiteral<"text", "required">;
                         text: import("convex/values").VString<string, "required">;
                         providerOptions: import("convex/values").VRecord<Record<string, Record<string, any>> | undefined, import("convex/values").VString<string, "required">, import("convex/values").VRecord<Record<string, any>, import("convex/values").VString<string, "required">, import("convex/values").VAny<any, "required", string>, "required", string>, "optional", string>;
-                    }, "required", "type" | "providerOptions" | "text" | `providerOptions.${string}`>, import("convex/values").VObject<{
+                    }, "required", "text" | "type" | "providerOptions" | `providerOptions.${string}`>, import("convex/values").VObject<{
+                        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: import("convex/values").VLiteral<"file", "required">;
+                        data: import("convex/values").VUnion<{
+                            type: "reference";
+                            reference: Record<string, string>;
+                        } | {
+                            type: "url";
+                            url: string;
+                        } | {
+                            type: "data";
+                            data: string | ArrayBuffer;
+                        } | {
+                            text: string;
+                            type: "text";
+                        }, [import("convex/values").VObject<{
+                            type: "url";
+                            url: string;
+                        }, {
+                            type: import("convex/values").VLiteral<"url", "required">;
+                            url: import("convex/values").VString<string, "required">;
+                        }, "required", "type" | "url">, import("convex/values").VObject<{
+                            type: "reference";
+                            reference: Record<string, string>;
+                        }, {
+                            type: import("convex/values").VLiteral<"reference", "required">;
+                            reference: import("convex/values").VRecord<Record<string, string>, import("convex/values").VString<string, "required">, import("convex/values").VString<string, "required">, "required", string>;
+                        }, "required", "type" | "reference" | `reference.${string}`>, import("convex/values").VObject<{
+                            type: "data";
+                            data: string | ArrayBuffer;
+                        }, {
+                            type: import("convex/values").VLiteral<"data", "required">;
+                            data: import("convex/values").VUnion<string | ArrayBuffer, [import("convex/values").VString<string, "required">, import("convex/values").VBytes<ArrayBuffer, "required">], "required", never>;
+                        }, "required", "type" | "data">, import("convex/values").VObject<{
+                            text: string;
+                            type: "text";
+                        }, {
+                            type: import("convex/values").VLiteral<"text", "required">;
+                            text: import("convex/values").VString<string, "required">;
+                        }, "required", "text" | "type">], "required", "text" | "type" | "reference" | `reference.${string}` | "data" | "url">;
+                        mediaType: import("convex/values").VString<string, "required">;
+                        filename: import("convex/values").VString<string | undefined, "optional">;
+                        providerOptions: import("convex/values").VRecord<Record<string, Record<string, any>> | undefined, import("convex/values").VString<string, "required">, import("convex/values").VRecord<Record<string, any>, import("convex/values").VString<string, "required">, import("convex/values").VAny<any, "required", string>, "required", string>, "optional", string>;
+                    }, "required", "type" | "providerOptions" | `providerOptions.${string}` | "mediaType" | "data" | "filename" | "data.type" | "data.reference" | `data.reference.${string}` | "data.text" | "data.data" | "data.url">, import("convex/values").VObject<{
                         type: "media";
                         mediaType: string;
                         data: string;
@@ -2580,13 +3435,15 @@ export declare const vStreamMessagesReturnValue: import("convex/values").VObject
                         providerOptions: import("convex/values").VRecord<Record<string, Record<string, any>> | undefined, import("convex/values").VString<string, "required">, import("convex/values").VRecord<Record<string, any>, import("convex/values").VString<string, "required">, import("convex/values").VAny<any, "required", string>, "required", string>, "optional", string>;
                     }, "required", "type" | "providerOptions" | `providerOptions.${string}` | "mediaType" | "data" | "filename">, import("convex/values").VObject<{
                         providerOptions?: Record<string, Record<string, any>> | undefined;
+                        mediaType?: string | undefined;
                         type: "file-url";
                         url: string;
                     }, {
                         type: import("convex/values").VLiteral<"file-url", "required">;
                         url: import("convex/values").VString<string, "required">;
+                        mediaType: import("convex/values").VString<string | undefined, "optional">;
                         providerOptions: import("convex/values").VRecord<Record<string, Record<string, any>> | undefined, import("convex/values").VString<string, "required">, import("convex/values").VRecord<Record<string, any>, import("convex/values").VString<string, "required">, import("convex/values").VAny<any, "required", string>, "required", string>, "optional", string>;
-                    }, "required", "type" | "providerOptions" | `providerOptions.${string}` | "url">, import("convex/values").VObject<{
+                    }, "required", "type" | "providerOptions" | `providerOptions.${string}` | "mediaType" | "url">, import("convex/values").VObject<{
                         providerOptions?: Record<string, Record<string, any>> | undefined;
                         type: "file-id";
                         fileId: string | Record<string, string>;
@@ -2595,6 +3452,14 @@ export declare const vStreamMessagesReturnValue: import("convex/values").VObject
                         fileId: import("convex/values").VUnion<string | Record<string, string>, [import("convex/values").VString<string, "required">, import("convex/values").VRecord<Record<string, string>, import("convex/values").VString<string, "required">, import("convex/values").VString<string, "required">, "required", string>], "required", string>;
                         providerOptions: import("convex/values").VRecord<Record<string, Record<string, any>> | undefined, import("convex/values").VString<string, "required">, import("convex/values").VRecord<Record<string, any>, import("convex/values").VString<string, "required">, import("convex/values").VAny<any, "required", string>, "required", string>, "optional", string>;
                     }, "required", "type" | "providerOptions" | `providerOptions.${string}` | "fileId" | `fileId.${string}`>, import("convex/values").VObject<{
+                        providerOptions?: Record<string, Record<string, any>> | undefined;
+                        type: "file-reference";
+                        providerReference: Record<string, string>;
+                    }, {
+                        type: import("convex/values").VLiteral<"file-reference", "required">;
+                        providerReference: import("convex/values").VRecord<Record<string, string>, import("convex/values").VString<string, "required">, import("convex/values").VString<string, "required">, "required", string>;
+                        providerOptions: import("convex/values").VRecord<Record<string, Record<string, any>> | undefined, import("convex/values").VString<string, "required">, import("convex/values").VRecord<Record<string, any>, import("convex/values").VString<string, "required">, import("convex/values").VAny<any, "required", string>, "required", string>, "optional", string>;
+                    }, "required", "type" | "providerOptions" | `providerOptions.${string}` | "providerReference" | `providerReference.${string}`>, import("convex/values").VObject<{
                         providerOptions?: Record<string, Record<string, any>> | undefined;
                         type: "image-data";
                         mediaType: string;
@@ -2605,6 +3470,14 @@ export declare const vStreamMessagesReturnValue: import("convex/values").VObject
                         mediaType: import("convex/values").VString<string, "required">;
                         providerOptions: import("convex/values").VRecord<Record<string, Record<string, any>> | undefined, import("convex/values").VString<string, "required">, import("convex/values").VRecord<Record<string, any>, import("convex/values").VString<string, "required">, import("convex/values").VAny<any, "required", string>, "required", string>, "optional", string>;
                     }, "required", "type" | "providerOptions" | `providerOptions.${string}` | "mediaType" | "data">, import("convex/values").VObject<{
+                        providerOptions?: Record<string, Record<string, any>> | undefined;
+                        type: "image-file-reference";
+                        providerReference: Record<string, string>;
+                    }, {
+                        type: import("convex/values").VLiteral<"image-file-reference", "required">;
+                        providerReference: import("convex/values").VRecord<Record<string, string>, import("convex/values").VString<string, "required">, import("convex/values").VString<string, "required">, "required", string>;
+                        providerOptions: import("convex/values").VRecord<Record<string, Record<string, any>> | undefined, import("convex/values").VString<string, "required">, import("convex/values").VRecord<Record<string, any>, import("convex/values").VString<string, "required">, import("convex/values").VAny<any, "required", string>, "required", string>, "optional", string>;
+                    }, "required", "type" | "providerOptions" | `providerOptions.${string}` | "providerReference" | `providerReference.${string}`>, import("convex/values").VObject<{
                         providerOptions?: Record<string, Record<string, any>> | undefined;
                         type: "image-url";
                         url: string;
@@ -2626,7 +3499,7 @@ export declare const vStreamMessagesReturnValue: import("convex/values").VObject
                     }, {
                         type: import("convex/values").VLiteral<"custom", "required">;
                         providerOptions: import("convex/values").VRecord<Record<string, Record<string, any>> | undefined, import("convex/values").VString<string, "required">, import("convex/values").VRecord<Record<string, any>, import("convex/values").VString<string, "required">, import("convex/values").VAny<any, "required", string>, "required", string>, "optional", string>;
-                    }, "required", "type" | "providerOptions" | `providerOptions.${string}`>], "required", "type" | "providerOptions" | "text" | `providerOptions.${string}` | "mediaType" | "data" | "filename" | "url" | "fileId" | `fileId.${string}`>, "required">;
+                    }, "required", "type" | "providerOptions" | `providerOptions.${string}`>], "required", "text" | "type" | "providerOptions" | `providerOptions.${string}` | "mediaType" | "data" | "filename" | "data.type" | "data.reference" | `data.reference.${string}` | "url" | "data.text" | "data.data" | "data.url" | "fileId" | `fileId.${string}` | "providerReference" | `providerReference.${string}`>, "required">;
                 }, "required", "type" | "value">], "optional", "type" | "providerOptions" | `providerOptions.${string}` | "value" | `value.${string}` | "reason">;
                 providerOptions: import("convex/values").VRecord<Record<string, Record<string, any>> | undefined, import("convex/values").VString<string, "required">, import("convex/values").VRecord<Record<string, any>, import("convex/values").VString<string, "required">, import("convex/values").VAny<any, "required", string>, "required", string>, "optional", string>;
                 providerMetadata: import("convex/values").VRecord<Record<string, Record<string, any>> | undefined, import("convex/values").VString<string, "required">, import("convex/values").VRecord<Record<string, any>, import("convex/values").VString<string, "required">, import("convex/values").VAny<any, "required", string>, "required", string>, "optional", string>;
@@ -2635,26 +3508,26 @@ export declare const vStreamMessagesReturnValue: import("convex/values").VObject
                 isError: import("convex/values").VBoolean<boolean | undefined, "optional">;
                 args: import("convex/values").VAny<any, "optional", string>;
                 experimental_content: import("convex/values").VArray<({
-                    type: "text";
                     text: string;
+                    type: "text";
                 } | {
                     mimeType?: string | undefined;
                     type: "image";
                     data: string;
                 })[] | undefined, import("convex/values").VUnion<{
-                    type: "text";
                     text: string;
+                    type: "text";
                 } | {
                     mimeType?: string | undefined;
                     type: "image";
                     data: string;
                 }, [import("convex/values").VObject<{
-                    type: "text";
                     text: string;
+                    type: "text";
                 }, {
                     type: import("convex/values").VLiteral<"text", "required">;
                     text: import("convex/values").VString<string, "required">;
-                }, "required", "type" | "text">, import("convex/values").VObject<{
+                }, "required", "text" | "type">, import("convex/values").VObject<{
                     mimeType?: string | undefined;
                     type: "image";
                     data: string;
@@ -2662,7 +3535,7 @@ export declare const vStreamMessagesReturnValue: import("convex/values").VObject
                     type: import("convex/values").VLiteral<"image", "required">;
                     data: import("convex/values").VString<string, "required">;
                     mimeType: import("convex/values").VString<string | undefined, "optional">;
-                }, "required", "type" | "mimeType" | "data">], "required", "type" | "text" | "mimeType" | "data">, "optional">;
+                }, "required", "type" | "mimeType" | "data">], "required", "text" | "type" | "mimeType" | "data">, "optional">;
             }, "required", "type" | "providerOptions" | "providerMetadata" | `providerOptions.${string}` | `providerMetadata.${string}` | "toolCallId" | "toolName" | "args" | "providerExecuted" | `args.${string}` | "output" | "result" | "isError" | "experimental_content" | "output.type" | "output.providerOptions" | `output.providerOptions.${string}` | "output.value" | `output.value.${string}` | "output.reason" | `result.${string}`>, import("convex/values").VUnion<{
                 title?: string | undefined;
                 providerOptions?: Record<string, Record<string, any>> | undefined;
@@ -2717,6 +3590,8 @@ export declare const vStreamMessagesReturnValue: import("convex/values").VObject
             }, "required", "id" | "title" | "type" | "providerOptions" | "providerMetadata" | `providerOptions.${string}` | `providerMetadata.${string}` | "mediaType" | "filename" | "sourceType">], "required", "id" | "title" | "type" | "providerOptions" | "providerMetadata" | `providerOptions.${string}` | `providerMetadata.${string}` | "mediaType" | "filename" | "url" | "sourceType">, import("convex/values").VObject<{
                 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;
@@ -2724,9 +3599,11 @@ export declare const vStreamMessagesReturnValue: import("convex/values").VObject
                 type: import("convex/values").VLiteral<"tool-approval-request", "required">;
                 approvalId: import("convex/values").VString<string, "required">;
                 toolCallId: import("convex/values").VString<string, "required">;
+                isAutomatic: import("convex/values").VBoolean<boolean | undefined, "optional">;
+                signature: import("convex/values").VString<string | undefined, "optional">;
                 providerMetadata: import("convex/values").VRecord<Record<string, Record<string, any>> | undefined, import("convex/values").VString<string, "required">, import("convex/values").VRecord<Record<string, any>, import("convex/values").VString<string, "required">, import("convex/values").VAny<any, "required", string>, "required", string>, "optional", string>;
                 providerOptions: import("convex/values").VRecord<Record<string, Record<string, any>> | undefined, import("convex/values").VString<string, "required">, import("convex/values").VRecord<Record<string, any>, import("convex/values").VString<string, "required">, import("convex/values").VAny<any, "required", string>, "required", string>, "optional", string>;
-            }, "required", "type" | "providerOptions" | "providerMetadata" | `providerOptions.${string}` | `providerMetadata.${string}` | "toolCallId" | "approvalId">], "required", "id" | "title" | "type" | "providerOptions" | "text" | "providerMetadata" | `providerOptions.${string}` | `providerMetadata.${string}` | "mediaType" | "mimeType" | "data" | "filename" | "signature" | "toolCallId" | "toolName" | "input" | "args" | "providerExecuted" | `input.${string}` | `args.${string}` | "output" | "url" | "result" | "isError" | "experimental_content" | "output.type" | "output.providerOptions" | `output.providerOptions.${string}` | "output.value" | `output.value.${string}` | "output.reason" | `result.${string}` | "sourceType" | "approvalId">, "required">], "required", never>;
+            }, "required", "type" | "providerOptions" | "providerMetadata" | `providerOptions.${string}` | `providerMetadata.${string}` | "signature" | "toolCallId" | "approvalId" | "isAutomatic">], "required", "text" | "id" | "title" | "type" | "providerOptions" | "providerMetadata" | `providerOptions.${string}` | `providerMetadata.${string}` | "mediaType" | "mimeType" | "data" | "filename" | "data.type" | "data.reference" | `data.reference.${string}` | "signature" | "url" | "kind" | "toolCallId" | "toolName" | "input" | "args" | "providerExecuted" | "toolMetadata" | `input.${string}` | `args.${string}` | `toolMetadata.${string}` | "output" | "result" | "isError" | "experimental_content" | "output.type" | "output.providerOptions" | `output.providerOptions.${string}` | "output.value" | `output.value.${string}` | "output.reason" | `result.${string}` | "sourceType" | "approvalId" | "isAutomatic">, "required">], "required", never>;
             providerOptions: import("convex/values").VRecord<Record<string, Record<string, any>> | undefined, import("convex/values").VString<string, "required">, import("convex/values").VRecord<Record<string, any>, import("convex/values").VString<string, "required">, import("convex/values").VAny<any, "required", string>, "required", string>, "optional", string>;
         }, "required", "providerOptions" | "role" | `providerOptions.${string}` | "content">, import("convex/values").VObject<{
             providerOptions?: Record<string, Record<string, any>> | undefined;
@@ -2760,8 +3637,26 @@ export declare const vStreamMessagesReturnValue: import("convex/values").VObject
                     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;
@@ -2774,17 +3669,26 @@ export declare const vStreamMessagesReturnValue: import("convex/values").VObject
                         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";
@@ -2801,8 +3705,8 @@ export declare const vStreamMessagesReturnValue: import("convex/values").VObject
                 result?: any;
                 isError?: boolean | undefined;
                 experimental_content?: ({
-                    type: "text";
                     text: string;
+                    type: "text";
                 } | {
                     mimeType?: string | undefined;
                     type: "image";
@@ -2851,8 +3755,26 @@ export declare const vStreamMessagesReturnValue: import("convex/values").VObject
                     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;
@@ -2865,17 +3787,26 @@ export declare const vStreamMessagesReturnValue: import("convex/values").VObject
                         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";
@@ -2892,8 +3823,8 @@ export declare const vStreamMessagesReturnValue: import("convex/values").VObject
                 result?: any;
                 isError?: boolean | undefined;
                 experimental_content?: ({
-                    type: "text";
                     text: string;
+                    type: "text";
                 } | {
                     mimeType?: string | undefined;
                     type: "image";
@@ -2939,8 +3870,26 @@ export declare const vStreamMessagesReturnValue: import("convex/values").VObject
                     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;
@@ -2953,17 +3902,26 @@ export declare const vStreamMessagesReturnValue: import("convex/values").VObject
                         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";
@@ -2980,8 +3938,8 @@ export declare const vStreamMessagesReturnValue: import("convex/values").VObject
                 result?: any;
                 isError?: boolean | undefined;
                 experimental_content?: ({
-                    type: "text";
                     text: string;
+                    type: "text";
                 } | {
                     mimeType?: string | undefined;
                     type: "image";
@@ -3027,8 +3985,26 @@ export declare const vStreamMessagesReturnValue: import("convex/values").VObject
                     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;
@@ -3041,17 +4017,26 @@ export declare const vStreamMessagesReturnValue: import("convex/values").VObject
                         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";
@@ -3068,8 +4053,8 @@ export declare const vStreamMessagesReturnValue: import("convex/values").VObject
                 result?: any;
                 isError?: boolean | undefined;
                 experimental_content?: ({
-                    type: "text";
                     text: string;
+                    type: "text";
                 } | {
                     mimeType?: string | undefined;
                     type: "image";
@@ -3106,8 +4091,26 @@ export declare const vStreamMessagesReturnValue: import("convex/values").VObject
                     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;
@@ -3120,17 +4123,26 @@ export declare const vStreamMessagesReturnValue: import("convex/values").VObject
                         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";
@@ -3187,8 +4199,26 @@ export declare const vStreamMessagesReturnValue: import("convex/values").VObject
                     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;
@@ -3201,17 +4231,26 @@ export declare const vStreamMessagesReturnValue: import("convex/values").VObject
                         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";
@@ -3228,8 +4267,26 @@ export declare const vStreamMessagesReturnValue: import("convex/values").VObject
                     type: import("convex/values").VLiteral<"content", "required">;
                     value: import("convex/values").VArray<({
                         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;
@@ -3242,17 +4299,26 @@ export declare const vStreamMessagesReturnValue: import("convex/values").VObject
                         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";
@@ -3266,8 +4332,26 @@ export declare const vStreamMessagesReturnValue: import("convex/values").VObject
                         type: "custom";
                     })[], import("convex/values").VUnion<{
                         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;
@@ -3280,17 +4364,26 @@ export declare const vStreamMessagesReturnValue: import("convex/values").VObject
                         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";
@@ -3304,13 +4397,73 @@ export declare const vStreamMessagesReturnValue: import("convex/values").VObject
                         type: "custom";
                     }, [import("convex/values").VObject<{
                         providerOptions?: Record<string, Record<string, any>> | undefined;
-                        type: "text";
                         text: string;
+                        type: "text";
                     }, {
                         type: import("convex/values").VLiteral<"text", "required">;
                         text: import("convex/values").VString<string, "required">;
                         providerOptions: import("convex/values").VRecord<Record<string, Record<string, any>> | undefined, import("convex/values").VString<string, "required">, import("convex/values").VRecord<Record<string, any>, import("convex/values").VString<string, "required">, import("convex/values").VAny<any, "required", string>, "required", string>, "optional", string>;
-                    }, "required", "type" | "providerOptions" | "text" | `providerOptions.${string}`>, import("convex/values").VObject<{
+                    }, "required", "text" | "type" | "providerOptions" | `providerOptions.${string}`>, import("convex/values").VObject<{
+                        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: import("convex/values").VLiteral<"file", "required">;
+                        data: import("convex/values").VUnion<{
+                            type: "reference";
+                            reference: Record<string, string>;
+                        } | {
+                            type: "url";
+                            url: string;
+                        } | {
+                            type: "data";
+                            data: string | ArrayBuffer;
+                        } | {
+                            text: string;
+                            type: "text";
+                        }, [import("convex/values").VObject<{
+                            type: "url";
+                            url: string;
+                        }, {
+                            type: import("convex/values").VLiteral<"url", "required">;
+                            url: import("convex/values").VString<string, "required">;
+                        }, "required", "type" | "url">, import("convex/values").VObject<{
+                            type: "reference";
+                            reference: Record<string, string>;
+                        }, {
+                            type: import("convex/values").VLiteral<"reference", "required">;
+                            reference: import("convex/values").VRecord<Record<string, string>, import("convex/values").VString<string, "required">, import("convex/values").VString<string, "required">, "required", string>;
+                        }, "required", "type" | "reference" | `reference.${string}`>, import("convex/values").VObject<{
+                            type: "data";
+                            data: string | ArrayBuffer;
+                        }, {
+                            type: import("convex/values").VLiteral<"data", "required">;
+                            data: import("convex/values").VUnion<string | ArrayBuffer, [import("convex/values").VString<string, "required">, import("convex/values").VBytes<ArrayBuffer, "required">], "required", never>;
+                        }, "required", "type" | "data">, import("convex/values").VObject<{
+                            text: string;
+                            type: "text";
+                        }, {
+                            type: import("convex/values").VLiteral<"text", "required">;
+                            text: import("convex/values").VString<string, "required">;
+                        }, "required", "text" | "type">], "required", "text" | "type" | "reference" | `reference.${string}` | "data" | "url">;
+                        mediaType: import("convex/values").VString<string, "required">;
+                        filename: import("convex/values").VString<string | undefined, "optional">;
+                        providerOptions: import("convex/values").VRecord<Record<string, Record<string, any>> | undefined, import("convex/values").VString<string, "required">, import("convex/values").VRecord<Record<string, any>, import("convex/values").VString<string, "required">, import("convex/values").VAny<any, "required", string>, "required", string>, "optional", string>;
+                    }, "required", "type" | "providerOptions" | `providerOptions.${string}` | "mediaType" | "data" | "filename" | "data.type" | "data.reference" | `data.reference.${string}` | "data.text" | "data.data" | "data.url">, import("convex/values").VObject<{
                         type: "media";
                         mediaType: string;
                         data: string;
@@ -3332,13 +4485,15 @@ export declare const vStreamMessagesReturnValue: import("convex/values").VObject
                         providerOptions: import("convex/values").VRecord<Record<string, Record<string, any>> | undefined, import("convex/values").VString<string, "required">, import("convex/values").VRecord<Record<string, any>, import("convex/values").VString<string, "required">, import("convex/values").VAny<any, "required", string>, "required", string>, "optional", string>;
                     }, "required", "type" | "providerOptions" | `providerOptions.${string}` | "mediaType" | "data" | "filename">, import("convex/values").VObject<{
                         providerOptions?: Record<string, Record<string, any>> | undefined;
+                        mediaType?: string | undefined;
                         type: "file-url";
                         url: string;
                     }, {
                         type: import("convex/values").VLiteral<"file-url", "required">;
                         url: import("convex/values").VString<string, "required">;
+                        mediaType: import("convex/values").VString<string | undefined, "optional">;
                         providerOptions: import("convex/values").VRecord<Record<string, Record<string, any>> | undefined, import("convex/values").VString<string, "required">, import("convex/values").VRecord<Record<string, any>, import("convex/values").VString<string, "required">, import("convex/values").VAny<any, "required", string>, "required", string>, "optional", string>;
-                    }, "required", "type" | "providerOptions" | `providerOptions.${string}` | "url">, import("convex/values").VObject<{
+                    }, "required", "type" | "providerOptions" | `providerOptions.${string}` | "mediaType" | "url">, import("convex/values").VObject<{
                         providerOptions?: Record<string, Record<string, any>> | undefined;
                         type: "file-id";
                         fileId: string | Record<string, string>;
@@ -3347,6 +4502,14 @@ export declare const vStreamMessagesReturnValue: import("convex/values").VObject
                         fileId: import("convex/values").VUnion<string | Record<string, string>, [import("convex/values").VString<string, "required">, import("convex/values").VRecord<Record<string, string>, import("convex/values").VString<string, "required">, import("convex/values").VString<string, "required">, "required", string>], "required", string>;
                         providerOptions: import("convex/values").VRecord<Record<string, Record<string, any>> | undefined, import("convex/values").VString<string, "required">, import("convex/values").VRecord<Record<string, any>, import("convex/values").VString<string, "required">, import("convex/values").VAny<any, "required", string>, "required", string>, "optional", string>;
                     }, "required", "type" | "providerOptions" | `providerOptions.${string}` | "fileId" | `fileId.${string}`>, import("convex/values").VObject<{
+                        providerOptions?: Record<string, Record<string, any>> | undefined;
+                        type: "file-reference";
+                        providerReference: Record<string, string>;
+                    }, {
+                        type: import("convex/values").VLiteral<"file-reference", "required">;
+                        providerReference: import("convex/values").VRecord<Record<string, string>, import("convex/values").VString<string, "required">, import("convex/values").VString<string, "required">, "required", string>;
+                        providerOptions: import("convex/values").VRecord<Record<string, Record<string, any>> | undefined, import("convex/values").VString<string, "required">, import("convex/values").VRecord<Record<string, any>, import("convex/values").VString<string, "required">, import("convex/values").VAny<any, "required", string>, "required", string>, "optional", string>;
+                    }, "required", "type" | "providerOptions" | `providerOptions.${string}` | "providerReference" | `providerReference.${string}`>, import("convex/values").VObject<{
                         providerOptions?: Record<string, Record<string, any>> | undefined;
                         type: "image-data";
                         mediaType: string;
@@ -3357,6 +4520,14 @@ export declare const vStreamMessagesReturnValue: import("convex/values").VObject
                         mediaType: import("convex/values").VString<string, "required">;
                         providerOptions: import("convex/values").VRecord<Record<string, Record<string, any>> | undefined, import("convex/values").VString<string, "required">, import("convex/values").VRecord<Record<string, any>, import("convex/values").VString<string, "required">, import("convex/values").VAny<any, "required", string>, "required", string>, "optional", string>;
                     }, "required", "type" | "providerOptions" | `providerOptions.${string}` | "mediaType" | "data">, import("convex/values").VObject<{
+                        providerOptions?: Record<string, Record<string, any>> | undefined;
+                        type: "image-file-reference";
+                        providerReference: Record<string, string>;
+                    }, {
+                        type: import("convex/values").VLiteral<"image-file-reference", "required">;
+                        providerReference: import("convex/values").VRecord<Record<string, string>, import("convex/values").VString<string, "required">, import("convex/values").VString<string, "required">, "required", string>;
+                        providerOptions: import("convex/values").VRecord<Record<string, Record<string, any>> | undefined, import("convex/values").VString<string, "required">, import("convex/values").VRecord<Record<string, any>, import("convex/values").VString<string, "required">, import("convex/values").VAny<any, "required", string>, "required", string>, "optional", string>;
+                    }, "required", "type" | "providerOptions" | `providerOptions.${string}` | "providerReference" | `providerReference.${string}`>, import("convex/values").VObject<{
                         providerOptions?: Record<string, Record<string, any>> | undefined;
                         type: "image-url";
                         url: string;
@@ -3378,7 +4549,7 @@ export declare const vStreamMessagesReturnValue: import("convex/values").VObject
                     }, {
                         type: import("convex/values").VLiteral<"custom", "required">;
                         providerOptions: import("convex/values").VRecord<Record<string, Record<string, any>> | undefined, import("convex/values").VString<string, "required">, import("convex/values").VRecord<Record<string, any>, import("convex/values").VString<string, "required">, import("convex/values").VAny<any, "required", string>, "required", string>, "optional", string>;
-                    }, "required", "type" | "providerOptions" | `providerOptions.${string}`>], "required", "type" | "providerOptions" | "text" | `providerOptions.${string}` | "mediaType" | "data" | "filename" | "url" | "fileId" | `fileId.${string}`>, "required">;
+                    }, "required", "type" | "providerOptions" | `providerOptions.${string}`>], "required", "text" | "type" | "providerOptions" | `providerOptions.${string}` | "mediaType" | "data" | "filename" | "data.type" | "data.reference" | `data.reference.${string}` | "url" | "data.text" | "data.data" | "data.url" | "fileId" | `fileId.${string}` | "providerReference" | `providerReference.${string}`>, "required">;
                 }, "required", "type" | "value">], "optional", "type" | "providerOptions" | `providerOptions.${string}` | "value" | `value.${string}` | "reason">;
                 providerOptions: import("convex/values").VRecord<Record<string, Record<string, any>> | undefined, import("convex/values").VString<string, "required">, import("convex/values").VRecord<Record<string, any>, import("convex/values").VString<string, "required">, import("convex/values").VAny<any, "required", string>, "required", string>, "optional", string>;
                 providerMetadata: import("convex/values").VRecord<Record<string, Record<string, any>> | undefined, import("convex/values").VString<string, "required">, import("convex/values").VRecord<Record<string, any>, import("convex/values").VString<string, "required">, import("convex/values").VAny<any, "required", string>, "required", string>, "optional", string>;
@@ -3387,26 +4558,26 @@ export declare const vStreamMessagesReturnValue: import("convex/values").VObject
                 isError: import("convex/values").VBoolean<boolean | undefined, "optional">;
                 args: import("convex/values").VAny<any, "optional", string>;
                 experimental_content: import("convex/values").VArray<({
-                    type: "text";
                     text: string;
+                    type: "text";
                 } | {
                     mimeType?: string | undefined;
                     type: "image";
                     data: string;
                 })[] | undefined, import("convex/values").VUnion<{
-                    type: "text";
                     text: string;
+                    type: "text";
                 } | {
                     mimeType?: string | undefined;
                     type: "image";
                     data: string;
                 }, [import("convex/values").VObject<{
-                    type: "text";
                     text: string;
+                    type: "text";
                 }, {
                     type: import("convex/values").VLiteral<"text", "required">;
                     text: import("convex/values").VString<string, "required">;
-                }, "required", "type" | "text">, import("convex/values").VObject<{
+                }, "required", "text" | "type">, import("convex/values").VObject<{
                     mimeType?: string | undefined;
                     type: "image";
                     data: string;
@@ -3414,7 +4585,7 @@ export declare const vStreamMessagesReturnValue: import("convex/values").VObject
                     type: import("convex/values").VLiteral<"image", "required">;
                     data: import("convex/values").VString<string, "required">;
                     mimeType: import("convex/values").VString<string | undefined, "optional">;
-                }, "required", "type" | "mimeType" | "data">], "required", "type" | "text" | "mimeType" | "data">, "optional">;
+                }, "required", "type" | "mimeType" | "data">], "required", "text" | "type" | "mimeType" | "data">, "optional">;
             }, "required", "type" | "providerOptions" | "providerMetadata" | `providerOptions.${string}` | `providerMetadata.${string}` | "toolCallId" | "toolName" | "args" | "providerExecuted" | `args.${string}` | "output" | "result" | "isError" | "experimental_content" | "output.type" | "output.providerOptions" | `output.providerOptions.${string}` | "output.value" | `output.value.${string}` | "output.reason" | `result.${string}`>, import("convex/values").VObject<{
                 providerOptions?: Record<string, Record<string, any>> | undefined;
                 providerMetadata?: Record<string, Record<string, any>> | undefined;
@@ -3445,18 +4616,26 @@ export declare const vStreamMessagesReturnValue: import("convex/values").VObject
         tool: import("convex/values").VBoolean<boolean, "required">;
         text: import("convex/values").VString<string | undefined, "optional">;
         usage: import("convex/values").VObject<{
+            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, {
-            promptTokens: import("convex/values").VFloat64<number, "required">;
-            completionTokens: import("convex/values").VFloat64<number, "required">;
-            totalTokens: import("convex/values").VFloat64<number, "required">;
+            promptTokens: import("convex/values").VFloat64<number | undefined, "optional">;
+            completionTokens: import("convex/values").VFloat64<number | undefined, "optional">;
+            totalTokens: import("convex/values").VFloat64<number | undefined, "optional">;
             reasoningTokens: import("convex/values").VFloat64<number | undefined, "optional">;
             cachedInputTokens: import("convex/values").VFloat64<number | undefined, "optional">;
-        }, "optional", "promptTokens" | "completionTokens" | "totalTokens" | "reasoningTokens" | "cachedInputTokens">;
+            nonCachedInputTokens: import("convex/values").VFloat64<number | undefined, "optional">;
+            cacheWriteInputTokens: import("convex/values").VFloat64<number | undefined, "optional">;
+            textOutputTokens: import("convex/values").VFloat64<number | undefined, "optional">;
+            raw: import("convex/values").VRecord<Record<string, any> | undefined, import("convex/values").VString<string, "required">, import("convex/values").VAny<any, "required", string>, "optional", string>;
+        }, "optional", "promptTokens" | "completionTokens" | "totalTokens" | "reasoningTokens" | "cachedInputTokens" | "nonCachedInputTokens" | "cacheWriteInputTokens" | "textOutputTokens" | "raw" | `raw.${string}`>;
         providerMetadata: import("convex/values").VRecord<Record<string, Record<string, any>> | undefined, import("convex/values").VString<string, "required">, import("convex/values").VRecord<Record<string, any>, import("convex/values").VString<string, "required">, import("convex/values").VAny<any, "required", string>, "required", string>, "optional", string>;
         sources: import("convex/values").VArray<({
             title?: string | undefined;
@@ -3528,28 +4707,76 @@ export declare const vStreamMessagesReturnValue: import("convex/values").VObject
             providerMetadata: import("convex/values").VRecord<Record<string, Record<string, any>> | undefined, import("convex/values").VString<string, "required">, import("convex/values").VRecord<Record<string, any>, import("convex/values").VString<string, "required">, import("convex/values").VAny<any, "required", string>, "required", string>, "optional", string>;
         }, "required", "id" | "title" | "type" | "providerOptions" | "providerMetadata" | `providerOptions.${string}` | `providerMetadata.${string}` | "mediaType" | "filename" | "sourceType">], "required", "id" | "title" | "type" | "providerOptions" | "providerMetadata" | `providerOptions.${string}` | `providerMetadata.${string}` | "mediaType" | "filename" | "url" | "sourceType">, "optional">;
         warnings: import("convex/values").VArray<({
+            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;
         })[] | undefined, import("convex/values").VUnion<{
+            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;
         }, [import("convex/values").VObject<{
+            details?: string | undefined;
+            type: "unsupported";
+            feature: string;
+        }, {
+            type: import("convex/values").VLiteral<"unsupported", "required">;
+            feature: import("convex/values").VString<string, "required">;
+            details: import("convex/values").VString<string | undefined, "optional">;
+        }, "required", "type" | "feature" | "details">, import("convex/values").VObject<{
+            details?: string | undefined;
+            type: "compatibility";
+            feature: string;
+        }, {
+            type: import("convex/values").VLiteral<"compatibility", "required">;
+            feature: import("convex/values").VString<string, "required">;
+            details: import("convex/values").VString<string | undefined, "optional">;
+        }, "required", "type" | "feature" | "details">, import("convex/values").VObject<{
+            type: "deprecated";
+            message: string;
+            setting: string;
+        }, {
+            type: import("convex/values").VLiteral<"deprecated", "required">;
+            setting: import("convex/values").VString<string, "required">;
+            message: import("convex/values").VString<string, "required">;
+        }, "required", "type" | "message" | "setting">, import("convex/values").VObject<{
             details?: string | undefined;
             type: "unsupported-setting";
             setting: string;
@@ -3557,33 +4784,33 @@ export declare const vStreamMessagesReturnValue: import("convex/values").VObject
             type: import("convex/values").VLiteral<"unsupported-setting", "required">;
             setting: import("convex/values").VString<string, "required">;
             details: import("convex/values").VString<string | undefined, "optional">;
-        }, "required", "type" | "setting" | "details">, import("convex/values").VObject<{
+        }, "required", "type" | "details" | "setting">, import("convex/values").VObject<{
             details?: string | undefined;
-            type: "unsupported-tool";
             tool: any;
+            type: "unsupported-tool";
         }, {
             type: import("convex/values").VLiteral<"unsupported-tool", "required">;
             tool: import("convex/values").VAny<any, "required", string>;
             details: import("convex/values").VString<string | undefined, "optional">;
-        }, "required", "type" | "tool" | "details" | `tool.${string}`>, import("convex/values").VObject<{
+        }, "required", "tool" | "type" | "details" | `tool.${string}`>, import("convex/values").VObject<{
             type: "other";
             message: string;
         }, {
             type: import("convex/values").VLiteral<"other", "required">;
             message: import("convex/values").VString<string, "required">;
-        }, "required", "type" | "message">], "required", "type" | "message" | "tool" | "setting" | "details" | `tool.${string}`>, "optional">;
+        }, "required", "type" | "message">], "required", "tool" | "type" | "message" | "feature" | "details" | "setting" | `tool.${string}`>, "optional">;
         finishReason: import("convex/values").VUnion<"error" | "length" | "other" | "stop" | "content-filter" | "tool-calls" | "unknown" | undefined, [import("convex/values").VLiteral<"stop", "required">, import("convex/values").VLiteral<"length", "required">, import("convex/values").VLiteral<"content-filter", "required">, import("convex/values").VLiteral<"tool-calls", "required">, import("convex/values").VLiteral<"error", "required">, import("convex/values").VLiteral<"other", "required">, import("convex/values").VLiteral<"unknown", "required">], "optional", never>;
         reasoning: import("convex/values").VString<string | undefined, "optional">;
         reasoningDetails: import("convex/values").VArray<({
             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;
@@ -3591,12 +4818,12 @@ export declare const vStreamMessagesReturnValue: import("convex/values").VObject
             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;
@@ -3604,36 +4831,36 @@ export declare const vStreamMessagesReturnValue: import("convex/values").VObject
             providerOptions?: Record<string, Record<string, any>> | undefined;
             providerMetadata?: Record<string, Record<string, any>> | undefined;
             signature?: string | undefined;
-            type: "reasoning";
             text: string;
+            type: "reasoning";
         }, {
             type: import("convex/values").VLiteral<"reasoning", "required">;
             text: import("convex/values").VString<string, "required">;
             signature: import("convex/values").VString<string | undefined, "optional">;
             providerOptions: import("convex/values").VRecord<Record<string, Record<string, any>> | undefined, import("convex/values").VString<string, "required">, import("convex/values").VRecord<Record<string, any>, import("convex/values").VString<string, "required">, import("convex/values").VAny<any, "required", string>, "required", string>, "optional", string>;
             providerMetadata: import("convex/values").VRecord<Record<string, Record<string, any>> | undefined, import("convex/values").VString<string, "required">, import("convex/values").VRecord<Record<string, any>, import("convex/values").VString<string, "required">, import("convex/values").VAny<any, "required", string>, "required", string>, "optional", string>;
-        }, "required", "type" | "providerOptions" | "text" | "providerMetadata" | `providerOptions.${string}` | `providerMetadata.${string}` | "signature">, import("convex/values").VObject<{
+        }, "required", "text" | "type" | "providerOptions" | "providerMetadata" | `providerOptions.${string}` | `providerMetadata.${string}` | "signature">, import("convex/values").VObject<{
             signature?: string | undefined;
-            type: "text";
             text: string;
+            type: "text";
         }, {
             type: import("convex/values").VLiteral<"text", "required">;
             text: import("convex/values").VString<string, "required">;
             signature: import("convex/values").VString<string | undefined, "optional">;
-        }, "required", "type" | "text" | "signature">, import("convex/values").VObject<{
+        }, "required", "text" | "type" | "signature">, import("convex/values").VObject<{
             type: "redacted";
             data: string;
         }, {
             type: import("convex/values").VLiteral<"redacted", "required">;
             data: import("convex/values").VString<string, "required">;
-        }, "required", "type" | "data">], "required", "type" | "providerOptions" | "text" | "providerMetadata" | `providerOptions.${string}` | `providerMetadata.${string}` | "data" | "signature">, "optional">;
+        }, "required", "type" | "data">], "required", "text" | "type" | "providerOptions" | "providerMetadata" | `providerOptions.${string}` | `providerMetadata.${string}` | "data" | "signature">, "optional">;
         id: import("convex/values").VString<string | undefined, "optional">;
-    }, "required", "id" | "status" | "userId" | "order" | "_creationTime" | "threadId" | "stepOrder" | "embeddingId" | "fileIds" | "error" | "agentName" | "model" | "provider" | "providerOptions" | "message" | "text" | "providerMetadata" | `providerOptions.${string}` | `providerMetadata.${string}` | "reasoning" | "tool" | "usage" | "sources" | "warnings" | "finishReason" | "reasoningDetails" | "message.providerOptions" | "message.role" | `message.providerOptions.${string}` | "message.content" | "usage.promptTokens" | "usage.completionTokens" | "usage.totalTokens" | "usage.reasoningTokens" | "usage.cachedInputTokens" | "_id">, "required">;
+    }, "required", "tool" | "text" | "reasoning" | "id" | "status" | "userId" | "order" | "_creationTime" | "threadId" | "stepOrder" | "embeddingId" | "fileIds" | "error" | "agentName" | "model" | "provider" | "providerOptions" | "message" | "providerMetadata" | `providerOptions.${string}` | `providerMetadata.${string}` | "usage" | "sources" | "warnings" | "finishReason" | "reasoningDetails" | "message.providerOptions" | "message.role" | `message.providerOptions.${string}` | "message.content" | "usage.promptTokens" | "usage.completionTokens" | "usage.totalTokens" | "usage.reasoningTokens" | "usage.cachedInputTokens" | "usage.nonCachedInputTokens" | "usage.cacheWriteInputTokens" | "usage.textOutputTokens" | "usage.raw" | `usage.raw.${string}` | "_id">, "required">;
     continueCursor: import("convex/values").VString<string, "required">;
     isDone: import("convex/values").VBoolean<boolean, "required">;
     splitCursor: import("convex/values").VUnion<string | null | undefined, [import("convex/values").VString<string, "required">, import("convex/values").VNull<null, "required">], "optional", never>;
     pageStatus: import("convex/values").VUnion<"SplitRecommended" | "SplitRequired" | null | undefined, [import("convex/values").VLiteral<"SplitRecommended", "required">, import("convex/values").VLiteral<"SplitRequired", "required">, import("convex/values").VNull<null, "required">], "optional", never>;
-}, "required", "page" | "continueCursor" | "isDone" | "splitCursor" | "pageStatus" | "streams" | "streams.messages" | "streams.kind" | "streams.deltas">;
+}, "required", "page" | "continueCursor" | "isDone" | "splitCursor" | "pageStatus" | "streams" | "streams.kind" | "streams.messages" | "streams.deltas">;
 /**
  * A function that handles fetching stream deltas, used with the React hooks
  * `useThreadMessages` or `useStreamingThreadMessages`.