@convex-dev/agent 0.6.0-alpha.0 → 0.6.0-beta.0

package/dist/client/streaming.d.ts

@@ -5,6 +5,7 @@ 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;
@@ -12,12 +13,11 @@ export declare const vStreamMessagesReturnValue: import("convex/values").VObject
             provider?: string | undefined;
             providerOptions?: Record<string, Record<string, any>> | undefined;
             format?: "UIMessageChunk" | "TextStreamPart" | undefined;
-            status: "streaming" | "finished" | "aborted";
             order: number;
             stepOrder: number;
+            status: "streaming" | "finished" | "aborted";
             streamId: string;
         }[];
-        kind: "list";
     } | {
         kind: "deltas";
         deltas: {
@@ -28,8 +28,8 @@ export declare const vStreamMessagesReturnValue: import("convex/values").VObject
         }[];
     } | undefined;
     page: {
-        id?: string | undefined;
         userId?: string | undefined;
+        id?: string | undefined;
         embeddingId?: string | undefined;
         fileIds?: string[] | undefined;
         error?: string | undefined;
@@ -186,9 +186,9 @@ export declare const vStreamMessagesReturnValue: import("convex/values").VObject
                 toolCallId: string;
                 toolName: string;
             } | {
-                title?: string | undefined;
                 providerOptions?: Record<string, Record<string, any>> | undefined;
                 providerMetadata?: Record<string, Record<string, any>> | undefined;
+                title?: string | undefined;
                 id: string;
                 type: "source";
                 url: string;
@@ -198,10 +198,10 @@ export declare const vStreamMessagesReturnValue: import("convex/values").VObject
                 providerMetadata?: Record<string, Record<string, any>> | undefined;
                 filename?: string | undefined;
                 id: string;
-                title: string;
                 type: "source";
                 mediaType: string;
                 sourceType: "document";
+                title: string;
             } | {
                 providerOptions?: Record<string, Record<string, any>> | undefined;
                 providerMetadata?: Record<string, Record<string, any>> | undefined;
@@ -317,10 +317,10 @@ export declare const vStreamMessagesReturnValue: import("convex/values").VObject
             totalTokens: number;
         } | undefined;
         sources?: ({
-            title?: string | undefined;
             type?: "source" | undefined;
             providerOptions?: Record<string, Record<string, any>> | undefined;
             providerMetadata?: Record<string, Record<string, any>> | undefined;
+            title?: string | undefined;
             id: string;
             url: string;
             sourceType: "url";
@@ -329,10 +329,10 @@ export declare const vStreamMessagesReturnValue: import("convex/values").VObject
             providerMetadata?: Record<string, Record<string, any>> | undefined;
             filename?: string | undefined;
             id: string;
-            title: string;
             type: "source";
             mediaType: string;
             sourceType: "document";
+            title: string;
         })[] | undefined;
         warnings?: ({
             details?: string | undefined;
@@ -346,7 +346,7 @@ export declare const vStreamMessagesReturnValue: import("convex/values").VObject
             type: "other";
             message: string;
         })[] | undefined;
-        finishReason?: "error" | "length" | "other" | "stop" | "content-filter" | "tool-calls" | "unknown" | undefined;
+        finishReason?: "length" | "error" | "other" | "stop" | "content-filter" | "tool-calls" | "unknown" | undefined;
         reasoningDetails?: ({
             providerOptions?: Record<string, Record<string, any>> | undefined;
             providerMetadata?: Record<string, Record<string, any>> | undefined;
@@ -361,18 +361,19 @@ export declare const vStreamMessagesReturnValue: import("convex/values").VObject
             type: "redacted";
             data: string;
         })[] | undefined;
-        status: "pending" | "success" | "failed";
-        order: number;
+        _id: string;
         _creationTime: number;
         threadId: string;
+        order: number;
         stepOrder: number;
+        status: "pending" | "success" | "failed";
         tool: boolean;
-        _id: string;
     }[];
     continueCursor: string;
     isDone: boolean;
 }, {
     streams: import("convex/values").VUnion<{
+        kind: "list";
         messages: {
             userId?: string | undefined;
             agentName?: string | undefined;
@@ -380,12 +381,11 @@ export declare const vStreamMessagesReturnValue: import("convex/values").VObject
             provider?: string | undefined;
             providerOptions?: Record<string, Record<string, any>> | undefined;
             format?: "UIMessageChunk" | "TextStreamPart" | undefined;
-            status: "streaming" | "finished" | "aborted";
             order: number;
             stepOrder: number;
+            status: "streaming" | "finished" | "aborted";
             streamId: string;
         }[];
-        kind: "list";
     } | {
         kind: "deltas";
         deltas: {
@@ -395,6 +395,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;
@@ -402,12 +403,11 @@ export declare const vStreamMessagesReturnValue: import("convex/values").VObject
             provider?: string | undefined;
             providerOptions?: Record<string, Record<string, any>> | undefined;
             format?: "UIMessageChunk" | "TextStreamPart" | undefined;
-            status: "streaming" | "finished" | "aborted";
             order: number;
             stepOrder: number;
+            status: "streaming" | "finished" | "aborted";
             streamId: string;
         }[];
-        kind: "list";
     }, {
         kind: import("convex/values").VLiteral<"list", "required">;
         messages: import("convex/values").VArray<{
@@ -417,9 +417,9 @@ export declare const vStreamMessagesReturnValue: import("convex/values").VObject
             provider?: string | undefined;
             providerOptions?: Record<string, Record<string, any>> | undefined;
             format?: "UIMessageChunk" | "TextStreamPart" | undefined;
-            status: "streaming" | "finished" | "aborted";
             order: number;
             stepOrder: number;
+            status: "streaming" | "finished" | "aborted";
             streamId: string;
         }[], import("convex/values").VObject<{
             userId?: string | undefined;
@@ -428,9 +428,9 @@ export declare const vStreamMessagesReturnValue: import("convex/values").VObject
             provider?: string | undefined;
             providerOptions?: Record<string, Record<string, any>> | undefined;
             format?: "UIMessageChunk" | "TextStreamPart" | undefined;
-            status: "streaming" | "finished" | "aborted";
             order: number;
             stepOrder: number;
+            status: "streaming" | "finished" | "aborted";
             streamId: string;
         }, {
             streamId: import("convex/values").VString<string, "required">;
@@ -443,8 +443,8 @@ export declare const vStreamMessagesReturnValue: import("convex/values").VObject
             model: import("convex/values").VString<string | undefined, "optional">;
             provider: import("convex/values").VString<string | undefined, "optional">;
             providerOptions: import("convex/values").VRecord<Record<string, Record<string, any>> | undefined, import("convex/values").VString<string, "required">, import("convex/values").VRecord<Record<string, any>, import("convex/values").VString<string, "required">, import("convex/values").VAny<any, "required", string>, "required", string>, "optional", string>;
-        }, "required", "status" | "userId" | "order" | "stepOrder" | "agentName" | "model" | "provider" | "providerOptions" | `providerOptions.${string}` | "format" | "streamId">, "required">;
-    }, "required", "messages" | "kind">, import("convex/values").VObject<{
+        }, "required", "userId" | "order" | "stepOrder" | "status" | "agentName" | "model" | "provider" | "providerOptions" | `providerOptions.${string}` | "streamId" | "format">, "required">;
+    }, "required", "kind" | "messages">, import("convex/values").VObject<{
         kind: "deltas";
         deltas: {
             streamId: string;
@@ -470,10 +470,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<{
-        id?: string | undefined;
         userId?: string | undefined;
+        id?: string | undefined;
         embeddingId?: string | undefined;
         fileIds?: string[] | undefined;
         error?: string | undefined;
@@ -630,9 +630,9 @@ export declare const vStreamMessagesReturnValue: import("convex/values").VObject
                 toolCallId: string;
                 toolName: string;
             } | {
-                title?: string | undefined;
                 providerOptions?: Record<string, Record<string, any>> | undefined;
                 providerMetadata?: Record<string, Record<string, any>> | undefined;
+                title?: string | undefined;
                 id: string;
                 type: "source";
                 url: string;
@@ -642,10 +642,10 @@ export declare const vStreamMessagesReturnValue: import("convex/values").VObject
                 providerMetadata?: Record<string, Record<string, any>> | undefined;
                 filename?: string | undefined;
                 id: string;
-                title: string;
                 type: "source";
                 mediaType: string;
                 sourceType: "document";
+                title: string;
             } | {
                 providerOptions?: Record<string, Record<string, any>> | undefined;
                 providerMetadata?: Record<string, Record<string, any>> | undefined;
@@ -761,10 +761,10 @@ export declare const vStreamMessagesReturnValue: import("convex/values").VObject
             totalTokens: number;
         } | undefined;
         sources?: ({
-            title?: string | undefined;
             type?: "source" | undefined;
             providerOptions?: Record<string, Record<string, any>> | undefined;
             providerMetadata?: Record<string, Record<string, any>> | undefined;
+            title?: string | undefined;
             id: string;
             url: string;
             sourceType: "url";
@@ -773,10 +773,10 @@ export declare const vStreamMessagesReturnValue: import("convex/values").VObject
             providerMetadata?: Record<string, Record<string, any>> | undefined;
             filename?: string | undefined;
             id: string;
-            title: string;
             type: "source";
             mediaType: string;
             sourceType: "document";
+            title: string;
         })[] | undefined;
         warnings?: ({
             details?: string | undefined;
@@ -790,7 +790,7 @@ export declare const vStreamMessagesReturnValue: import("convex/values").VObject
             type: "other";
             message: string;
         })[] | undefined;
-        finishReason?: "error" | "length" | "other" | "stop" | "content-filter" | "tool-calls" | "unknown" | undefined;
+        finishReason?: "length" | "error" | "other" | "stop" | "content-filter" | "tool-calls" | "unknown" | undefined;
         reasoningDetails?: ({
             providerOptions?: Record<string, Record<string, any>> | undefined;
             providerMetadata?: Record<string, Record<string, any>> | undefined;
@@ -805,16 +805,16 @@ export declare const vStreamMessagesReturnValue: import("convex/values").VObject
             type: "redacted";
             data: string;
         })[] | undefined;
-        status: "pending" | "success" | "failed";
-        order: number;
+        _id: string;
         _creationTime: number;
         threadId: string;
+        order: number;
         stepOrder: number;
+        status: "pending" | "success" | "failed";
         tool: boolean;
-        _id: string;
     }[], import("convex/values").VObject<{
-        id?: string | undefined;
         userId?: string | undefined;
+        id?: string | undefined;
         embeddingId?: string | undefined;
         fileIds?: string[] | undefined;
         error?: string | undefined;
@@ -971,9 +971,9 @@ export declare const vStreamMessagesReturnValue: import("convex/values").VObject
                 toolCallId: string;
                 toolName: string;
             } | {
-                title?: string | undefined;
                 providerOptions?: Record<string, Record<string, any>> | undefined;
                 providerMetadata?: Record<string, Record<string, any>> | undefined;
+                title?: string | undefined;
                 id: string;
                 type: "source";
                 url: string;
@@ -983,10 +983,10 @@ export declare const vStreamMessagesReturnValue: import("convex/values").VObject
                 providerMetadata?: Record<string, Record<string, any>> | undefined;
                 filename?: string | undefined;
                 id: string;
-                title: string;
                 type: "source";
                 mediaType: string;
                 sourceType: "document";
+                title: string;
             } | {
                 providerOptions?: Record<string, Record<string, any>> | undefined;
                 providerMetadata?: Record<string, Record<string, any>> | undefined;
@@ -1102,10 +1102,10 @@ export declare const vStreamMessagesReturnValue: import("convex/values").VObject
             totalTokens: number;
         } | undefined;
         sources?: ({
-            title?: string | undefined;
             type?: "source" | undefined;
             providerOptions?: Record<string, Record<string, any>> | undefined;
             providerMetadata?: Record<string, Record<string, any>> | undefined;
+            title?: string | undefined;
             id: string;
             url: string;
             sourceType: "url";
@@ -1114,10 +1114,10 @@ export declare const vStreamMessagesReturnValue: import("convex/values").VObject
             providerMetadata?: Record<string, Record<string, any>> | undefined;
             filename?: string | undefined;
             id: string;
-            title: string;
             type: "source";
             mediaType: string;
             sourceType: "document";
+            title: string;
         })[] | undefined;
         warnings?: ({
             details?: string | undefined;
@@ -1131,7 +1131,7 @@ export declare const vStreamMessagesReturnValue: import("convex/values").VObject
             type: "other";
             message: string;
         })[] | undefined;
-        finishReason?: "error" | "length" | "other" | "stop" | "content-filter" | "tool-calls" | "unknown" | undefined;
+        finishReason?: "length" | "error" | "other" | "stop" | "content-filter" | "tool-calls" | "unknown" | undefined;
         reasoningDetails?: ({
             providerOptions?: Record<string, Record<string, any>> | undefined;
             providerMetadata?: Record<string, Record<string, any>> | undefined;
@@ -1146,13 +1146,13 @@ export declare const vStreamMessagesReturnValue: import("convex/values").VObject
             type: "redacted";
             data: string;
         })[] | undefined;
-        status: "pending" | "success" | "failed";
-        order: number;
+        _id: string;
         _creationTime: number;
         threadId: string;
+        order: number;
         stepOrder: number;
+        status: "pending" | "success" | "failed";
         tool: boolean;
-        _id: string;
     }, {
         _id: import("convex/values").VString<string, "required">;
         _creationTime: import("convex/values").VFloat64<number, "required">;
@@ -1317,9 +1317,9 @@ export declare const vStreamMessagesReturnValue: import("convex/values").VObject
                 toolCallId: string;
                 toolName: string;
             } | {
-                title?: string | undefined;
                 providerOptions?: Record<string, Record<string, any>> | undefined;
                 providerMetadata?: Record<string, Record<string, any>> | undefined;
+                title?: string | undefined;
                 id: string;
                 type: "source";
                 url: string;
@@ -1329,10 +1329,10 @@ export declare const vStreamMessagesReturnValue: import("convex/values").VObject
                 providerMetadata?: Record<string, Record<string, any>> | undefined;
                 filename?: string | undefined;
                 id: string;
-                title: string;
                 type: "source";
                 mediaType: string;
                 sourceType: "document";
+                title: string;
             } | {
                 providerOptions?: Record<string, Record<string, any>> | undefined;
                 providerMetadata?: Record<string, Record<string, any>> | undefined;
@@ -1684,9 +1684,9 @@ export declare const vStreamMessagesReturnValue: import("convex/values").VObject
                 toolCallId: string;
                 toolName: string;
             } | {
-                title?: string | undefined;
                 providerOptions?: Record<string, Record<string, any>> | undefined;
                 providerMetadata?: Record<string, Record<string, any>> | undefined;
+                title?: string | undefined;
                 id: string;
                 type: "source";
                 url: string;
@@ -1696,10 +1696,10 @@ export declare const vStreamMessagesReturnValue: import("convex/values").VObject
                 providerMetadata?: Record<string, Record<string, any>> | undefined;
                 filename?: string | undefined;
                 id: string;
-                title: string;
                 type: "source";
                 mediaType: string;
                 sourceType: "document";
+                title: string;
             } | {
                 providerOptions?: Record<string, Record<string, any>> | undefined;
                 providerMetadata?: Record<string, Record<string, any>> | undefined;
@@ -1832,9 +1832,9 @@ export declare const vStreamMessagesReturnValue: import("convex/values").VObject
                 toolCallId: string;
                 toolName: string;
             } | {
-                title?: string | undefined;
                 providerOptions?: Record<string, Record<string, any>> | undefined;
                 providerMetadata?: Record<string, Record<string, any>> | undefined;
+                title?: string | undefined;
                 id: string;
                 type: "source";
                 url: string;
@@ -1844,10 +1844,10 @@ export declare const vStreamMessagesReturnValue: import("convex/values").VObject
                 providerMetadata?: Record<string, Record<string, any>> | undefined;
                 filename?: string | undefined;
                 id: string;
-                title: string;
                 type: "source";
                 mediaType: string;
                 sourceType: "document";
+                title: string;
             } | {
                 providerOptions?: Record<string, Record<string, any>> | undefined;
                 providerMetadata?: Record<string, Record<string, any>> | undefined;
@@ -1977,9 +1977,9 @@ export declare const vStreamMessagesReturnValue: import("convex/values").VObject
                 toolCallId: string;
                 toolName: string;
             } | {
-                title?: string | undefined;
                 providerOptions?: Record<string, Record<string, any>> | undefined;
                 providerMetadata?: Record<string, Record<string, any>> | undefined;
+                title?: string | undefined;
                 id: string;
                 type: "source";
                 url: string;
@@ -1989,10 +1989,10 @@ export declare const vStreamMessagesReturnValue: import("convex/values").VObject
                 providerMetadata?: Record<string, Record<string, any>> | undefined;
                 filename?: string | undefined;
                 id: string;
-                title: string;
                 type: "source";
                 mediaType: string;
                 sourceType: "document";
+                title: string;
             } | {
                 providerOptions?: Record<string, Record<string, any>> | undefined;
                 providerMetadata?: Record<string, Record<string, any>> | undefined;
@@ -2122,9 +2122,9 @@ export declare const vStreamMessagesReturnValue: import("convex/values").VObject
                 toolCallId: string;
                 toolName: string;
             } | {
-                title?: string | undefined;
                 providerOptions?: Record<string, Record<string, any>> | undefined;
                 providerMetadata?: Record<string, Record<string, any>> | undefined;
+                title?: string | undefined;
                 id: string;
                 type: "source";
                 url: string;
@@ -2134,10 +2134,10 @@ export declare const vStreamMessagesReturnValue: import("convex/values").VObject
                 providerMetadata?: Record<string, Record<string, any>> | undefined;
                 filename?: string | undefined;
                 id: string;
-                title: string;
                 type: "source";
                 mediaType: string;
                 sourceType: "document";
+                title: string;
             } | {
                 providerOptions?: Record<string, Record<string, any>> | undefined;
                 providerMetadata?: Record<string, Record<string, any>> | undefined;
@@ -2664,9 +2664,9 @@ export declare const vStreamMessagesReturnValue: import("convex/values").VObject
                     mimeType: import("convex/values").VString<string | undefined, "optional">;
                 }, "required", "type" | "mimeType" | "data">], "required", "type" | "text" | "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;
                 providerMetadata?: Record<string, Record<string, any>> | undefined;
+                title?: string | undefined;
                 id: string;
                 type: "source";
                 url: string;
@@ -2676,14 +2676,14 @@ export declare const vStreamMessagesReturnValue: import("convex/values").VObject
                 providerMetadata?: Record<string, Record<string, any>> | undefined;
                 filename?: string | undefined;
                 id: string;
-                title: string;
                 type: "source";
                 mediaType: string;
                 sourceType: "document";
+                title: string;
             }, [import("convex/values").VObject<{
-                title?: string | undefined;
                 providerOptions?: Record<string, Record<string, any>> | undefined;
                 providerMetadata?: Record<string, Record<string, any>> | undefined;
+                title?: string | undefined;
                 id: string;
                 type: "source";
                 url: string;
@@ -2696,15 +2696,15 @@ export declare const vStreamMessagesReturnValue: import("convex/values").VObject
                 title: import("convex/values").VString<string | undefined, "optional">;
                 providerOptions: import("convex/values").VRecord<Record<string, Record<string, any>> | undefined, import("convex/values").VString<string, "required">, import("convex/values").VRecord<Record<string, any>, import("convex/values").VString<string, "required">, import("convex/values").VAny<any, "required", string>, "required", string>, "optional", string>;
                 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}` | "url" | "sourceType">, import("convex/values").VObject<{
+            }, "required", "id" | "type" | "providerOptions" | "providerMetadata" | `providerOptions.${string}` | `providerMetadata.${string}` | "url" | "sourceType" | "title">, import("convex/values").VObject<{
                 providerOptions?: Record<string, Record<string, any>> | undefined;
                 providerMetadata?: Record<string, Record<string, any>> | undefined;
                 filename?: string | undefined;
                 id: string;
-                title: string;
                 type: "source";
                 mediaType: string;
                 sourceType: "document";
+                title: string;
             }, {
                 type: import("convex/values").VLiteral<"source", "required">;
                 sourceType: import("convex/values").VLiteral<"document", "required">;
@@ -2714,7 +2714,7 @@ export declare const vStreamMessagesReturnValue: import("convex/values").VObject
                 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>;
                 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">, import("convex/values").VObject<{
+            }, "required", "id" | "type" | "providerOptions" | "providerMetadata" | `providerOptions.${string}` | `providerMetadata.${string}` | "mediaType" | "filename" | "sourceType" | "title">], "required", "id" | "type" | "providerOptions" | "providerMetadata" | `providerOptions.${string}` | `providerMetadata.${string}` | "mediaType" | "filename" | "url" | "sourceType" | "title">, import("convex/values").VObject<{
                 providerOptions?: Record<string, Record<string, any>> | undefined;
                 providerMetadata?: Record<string, Record<string, any>> | undefined;
                 type: "tool-approval-request";
@@ -2726,7 +2726,7 @@ export declare const vStreamMessagesReturnValue: import("convex/values").VObject
                 toolCallId: import("convex/values").VString<string, "required">;
                 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}` | "toolCallId" | "approvalId">], "required", "id" | "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" | "title" | "approvalId">, "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;
@@ -3459,10 +3459,10 @@ export declare const vStreamMessagesReturnValue: import("convex/values").VObject
         }, "optional", "promptTokens" | "completionTokens" | "totalTokens" | "reasoningTokens" | "cachedInputTokens">;
         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;
             type?: "source" | undefined;
             providerOptions?: Record<string, Record<string, any>> | undefined;
             providerMetadata?: Record<string, Record<string, any>> | undefined;
+            title?: string | undefined;
             id: string;
             url: string;
             sourceType: "url";
@@ -3471,15 +3471,15 @@ export declare const vStreamMessagesReturnValue: import("convex/values").VObject
             providerMetadata?: Record<string, Record<string, any>> | undefined;
             filename?: string | undefined;
             id: string;
-            title: string;
             type: "source";
             mediaType: string;
             sourceType: "document";
+            title: string;
         })[] | undefined, import("convex/values").VUnion<{
-            title?: string | undefined;
             type?: "source" | undefined;
             providerOptions?: Record<string, Record<string, any>> | undefined;
             providerMetadata?: Record<string, Record<string, any>> | undefined;
+            title?: string | undefined;
             id: string;
             url: string;
             sourceType: "url";
@@ -3488,15 +3488,15 @@ export declare const vStreamMessagesReturnValue: import("convex/values").VObject
             providerMetadata?: Record<string, Record<string, any>> | undefined;
             filename?: string | undefined;
             id: string;
-            title: string;
             type: "source";
             mediaType: string;
             sourceType: "document";
+            title: string;
         }, [import("convex/values").VObject<{
-            title?: string | undefined;
             type?: "source" | undefined;
             providerOptions?: Record<string, Record<string, any>> | undefined;
             providerMetadata?: Record<string, Record<string, any>> | undefined;
+            title?: string | undefined;
             id: string;
             url: string;
             sourceType: "url";
@@ -3508,15 +3508,15 @@ export declare const vStreamMessagesReturnValue: import("convex/values").VObject
             title: import("convex/values").VString<string | undefined, "optional">;
             providerOptions: import("convex/values").VRecord<Record<string, Record<string, any>> | undefined, import("convex/values").VString<string, "required">, import("convex/values").VRecord<Record<string, any>, import("convex/values").VString<string, "required">, import("convex/values").VAny<any, "required", string>, "required", string>, "optional", string>;
             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}` | "url" | "sourceType">, import("convex/values").VObject<{
+        }, "required", "id" | "type" | "providerOptions" | "providerMetadata" | `providerOptions.${string}` | `providerMetadata.${string}` | "url" | "sourceType" | "title">, import("convex/values").VObject<{
             providerOptions?: Record<string, Record<string, any>> | undefined;
             providerMetadata?: Record<string, Record<string, any>> | undefined;
             filename?: string | undefined;
             id: string;
-            title: string;
             type: "source";
             mediaType: string;
             sourceType: "document";
+            title: string;
         }, {
             type: import("convex/values").VLiteral<"source", "required">;
             sourceType: import("convex/values").VLiteral<"document", "required">;
@@ -3526,7 +3526,7 @@ export declare const vStreamMessagesReturnValue: import("convex/values").VObject
             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>;
             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">;
+        }, "required", "id" | "type" | "providerOptions" | "providerMetadata" | `providerOptions.${string}` | `providerMetadata.${string}` | "mediaType" | "filename" | "sourceType" | "title">], "required", "id" | "type" | "providerOptions" | "providerMetadata" | `providerOptions.${string}` | `providerMetadata.${string}` | "mediaType" | "filename" | "url" | "sourceType" | "title">, "optional">;
         warnings: import("convex/values").VArray<({
             details?: string | undefined;
             type: "unsupported-setting";
@@ -3572,7 +3572,7 @@ export declare const vStreamMessagesReturnValue: import("convex/values").VObject
             type: import("convex/values").VLiteral<"other", "required">;
             message: import("convex/values").VString<string, "required">;
         }, "required", "type" | "message">], "required", "type" | "message" | "tool" | "setting" | "details" | `tool.${string}`>, "optional">;
-        finishReason: import("convex/values").VUnion<"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>;
+        finishReason: import("convex/values").VUnion<"length" | "error" | "other" | "stop" | "content-filter" | "tool-calls" | "unknown" | undefined, [import("convex/values").VLiteral<"stop", "required">, import("convex/values").VLiteral<"length", "required">, import("convex/values").VLiteral<"content-filter", "required">, import("convex/values").VLiteral<"tool-calls", "required">, import("convex/values").VLiteral<"error", "required">, import("convex/values").VLiteral<"other", "required">, import("convex/values").VLiteral<"unknown", "required">], "optional", never>;
         reasoning: import("convex/values").VString<string | undefined, "optional">;
         reasoningDetails: import("convex/values").VArray<({
             providerOptions?: Record<string, Record<string, any>> | undefined;
@@ -3628,12 +3628,12 @@ export declare const vStreamMessagesReturnValue: import("convex/values").VObject
             data: import("convex/values").VString<string, "required">;
         }, "required", "type" | "data">], "required", "type" | "providerOptions" | "text" | "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", "_id" | "_creationTime" | "userId" | "id" | "threadId" | "order" | "stepOrder" | "embeddingId" | "fileIds" | "error" | "status" | "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">, "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`.
@@ -3753,9 +3753,20 @@ export declare class DeltaStreamer<T> {
         providerOptions?: ProviderOptions;
         format: "UIMessageChunk" | "TextStreamPart" | undefined;
     });
-    getStreamId(): Promise<string | undefined>;
+    getStreamId(): Promise<string>;
     addParts(parts: T[]): Promise<void>;
     consumeStream(stream: AsyncIterableStream<T>): Promise<void>;
+    /**
+     * Mark the stream as being finished externally (e.g., atomically via addMessages).
+     * When called, consumeStream() will skip calling finish() since it will be
+     * handled elsewhere in the same mutation as message saving.
+     */
+    markFinishedExternally(): void;
+    /**
+     * Get the stream ID, waiting for it to be created if necessary.
+     * Useful for passing to addMessages for atomic finish.
+     */
+    getOrCreateStreamId(): Promise<string>;
     finish(): Promise<void>;
     fail(reason: string): Promise<void>;
 }