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

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

@@ -1,5 +1,5 @@
 import type { EmbeddingModelV1, LanguageModelV1 } from "@ai-sdk/provider";
-import type { CoreMessage, DeepPartial, GenerateObjectResult, GenerateTextResult, JSONValue, RepairTextFunction, Schema, StepResult, StreamObjectResult, StreamTextResult, TelemetrySettings, Tool, ToolChoice, ToolExecutionOptions, ToolSet } from "ai";
+import type { CoreMessage, DeepPartial, GenerateObjectResult, GenerateTextResult, JSONValue, RepairTextFunction, Schema, StepResult, StreamObjectResult, StreamTextResult, TelemetrySettings, Tool, ToolChoice, ToolExecutionOptions, ToolSet, UIMessage } from "ai";
 import { generateObject, generateText, streamObject, streamText } from "ai";
 import { Infer } from "convex/values";
 import { z } from "zod";
@@ -7,808 +7,84 @@ import { Mounts } from "../component/_generated/api.js";
 import { type VectorDimension } from "../component/vector/tables.js";
 import { type AIMessageWithoutId } from "../mapping.js";
 import { extractText, isTool } from "../shared.js";
-import { type CallSettings, MessageWithMetadata, type ProviderMetadata, type ProviderOptions, type SearchOptions, type Usage } from "../validators.js";
-import type { RunActionCtx, RunMutationCtx, RunQueryCtx, UseApi } from "./types.js";
+import { type CallSettings, type MessageWithMetadata as InnerMessageWithMetadata, type ProviderMetadata, type ProviderOptions, type SearchOptions, type Usage } from "../validators.js";
+import type { OpaqueIds, RunActionCtx, RunMutationCtx, RunQueryCtx, UseApi } from "./types.js";
 export { extractText, isTool };
 export type { Usage, ProviderMetadata };
-export { vUsage, vProviderMetadata, vUserMessage, vAssistantMessage, vToolMessage, vSystemMessage, vMessage, } from "../validators.js";
-export declare const vThreadDoc: import("convex/values").VObject<{
-    userId?: string | undefined;
-    title?: string | undefined;
-    summary?: string | undefined;
-    status: "active" | "archived";
-    _creationTime: number;
-    _id: string;
-}, {
-    _id: import("convex/values").VString<string, "required">;
-    _creationTime: import("convex/values").VFloat64<number, "required">;
-    userId: import("convex/values").VString<string | undefined, "optional">;
-    title: import("convex/values").VString<string | undefined, "optional">;
-    summary: import("convex/values").VString<string | undefined, "optional">;
-    status: import("convex/values").VUnion<"active" | "archived", [import("convex/values").VLiteral<"active", "required">, import("convex/values").VLiteral<"archived", "required">], "required", never>;
-}, "required", "status" | "userId" | "title" | "summary" | "_creationTime" | "_id">;
-export type ThreadDoc = Infer<typeof vThreadDoc>;
-export declare const vMessageDoc: import("convex/values").VObject<{
-    id?: string | undefined;
-    userId?: string | undefined;
-    parentMessageId?: string | undefined;
-    stepId?: string | undefined;
-    agentName?: string | undefined;
-    message?: {
-        providerOptions?: Record<string, any> | undefined;
-        experimental_providerMetadata?: Record<string, any> | undefined;
-        role: "user";
-        content: string | ({
-            providerOptions?: Record<string, any> | undefined;
-            experimental_providerMetadata?: Record<string, any> | undefined;
-            type: "text";
-            text: string;
-        } | {
-            providerOptions?: Record<string, any> | undefined;
-            experimental_providerMetadata?: Record<string, any> | undefined;
-            mimeType?: string | undefined;
-            type: "image";
-            image: string | ArrayBuffer;
-        } | {
-            providerOptions?: Record<string, any> | undefined;
-            experimental_providerMetadata?: Record<string, any> | undefined;
-            type: "file";
-            mimeType: string;
-            data: string | ArrayBuffer;
-        })[];
-    } | {
-        providerOptions?: Record<string, any> | undefined;
-        experimental_providerMetadata?: Record<string, any> | undefined;
-        role: "assistant";
-        content: string | ({
-            providerOptions?: Record<string, any> | undefined;
-            experimental_providerMetadata?: Record<string, any> | undefined;
-            type: "text";
-            text: string;
-        } | {
-            providerOptions?: Record<string, any> | undefined;
-            experimental_providerMetadata?: Record<string, any> | undefined;
-            type: "file";
-            mimeType: string;
-            data: string | ArrayBuffer;
-        } | {
-            providerOptions?: Record<string, any> | undefined;
-            experimental_providerMetadata?: Record<string, any> | undefined;
-            type: "reasoning";
-            text: string;
-        } | {
-            providerOptions?: Record<string, any> | undefined;
-            experimental_providerMetadata?: Record<string, any> | undefined;
-            type: "redacted-reasoning";
-            data: string;
-        } | {
-            providerOptions?: Record<string, any> | undefined;
-            experimental_providerMetadata?: Record<string, any> | undefined;
-            type: "tool-call";
-            toolCallId: string;
-            toolName: string;
-            args: any;
-        })[];
-    } | {
-        providerOptions?: Record<string, any> | undefined;
-        experimental_providerMetadata?: Record<string, any> | undefined;
-        role: "tool";
-        content: {
-            providerOptions?: Record<string, any> | undefined;
-            experimental_providerMetadata?: Record<string, any> | undefined;
-            args?: any;
-            experimental_content?: ({
-                type: "text";
-                text: string;
-            } | {
-                mimeType?: string | undefined;
-                type: "image";
-                data: string;
-            })[] | undefined;
-            isError?: boolean | undefined;
-            type: "tool-result";
-            toolCallId: string;
-            toolName: string;
-            result: any;
-        }[];
-    } | {
-        providerOptions?: Record<string, any> | undefined;
-        experimental_providerMetadata?: Record<string, any> | undefined;
-        role: "system";
-        content: string;
-    } | undefined;
-    text?: string | undefined;
-    reasoning?: string | undefined;
-    error?: string | undefined;
-    model?: string | undefined;
-    provider?: string | undefined;
-    embeddingId?: string | undefined;
-    usage?: {
-        promptTokens: number;
-        completionTokens: number;
-        totalTokens: number;
-    } | undefined;
-    finishReason?: "length" | "error" | "stop" | "content-filter" | "tool-calls" | "other" | "unknown" | undefined;
-    providerMetadata?: Record<string, any> | undefined;
-    sources?: {
-        title?: string | undefined;
-        providerMetadata?: Record<string, Record<string, any>> | undefined;
-        id: string;
-        sourceType: "url";
-        url: string;
-    }[] | undefined;
-    warnings?: ({
-        details?: string | undefined;
-        type: "unsupported-setting";
-        setting: string;
-    } | {
-        details?: string | undefined;
-        type: "unsupported-tool";
-        tool: any;
-    } | {
-        type: "other";
-        message: string;
-    })[] | undefined;
-    fileId?: string | undefined;
-    status: "pending" | "success" | "failed";
-    order: number;
-    _creationTime: number;
-    threadId: string;
-    tool: boolean;
-    stepOrder: number;
-    _id: string;
-}, {
-    threadId: import("convex/values").VString<string, "required">;
-    parentMessageId: import("convex/values").VString<string | undefined, "optional">;
-    stepId: import("convex/values").VString<string | undefined, "optional">;
-    embeddingId: import("convex/values").VString<string | undefined, "optional">;
-    fileId: import("convex/values").VString<string | undefined, "optional">;
-    id: import("convex/values").VString<string | undefined, "optional">;
-    userId: import("convex/values").VString<string | undefined, "optional">;
-    agentName: import("convex/values").VString<string | undefined, "optional">;
-    message: import("convex/values").VUnion<{
-        providerOptions?: Record<string, any> | undefined;
-        experimental_providerMetadata?: Record<string, any> | undefined;
-        role: "user";
-        content: string | ({
-            providerOptions?: Record<string, any> | undefined;
-            experimental_providerMetadata?: Record<string, any> | undefined;
-            type: "text";
-            text: string;
-        } | {
-            providerOptions?: Record<string, any> | undefined;
-            experimental_providerMetadata?: Record<string, any> | undefined;
-            mimeType?: string | undefined;
-            type: "image";
-            image: string | ArrayBuffer;
-        } | {
-            providerOptions?: Record<string, any> | undefined;
-            experimental_providerMetadata?: Record<string, any> | undefined;
-            type: "file";
-            mimeType: string;
-            data: string | ArrayBuffer;
-        })[];
-    } | {
-        providerOptions?: Record<string, any> | undefined;
-        experimental_providerMetadata?: Record<string, any> | undefined;
-        role: "assistant";
-        content: string | ({
-            providerOptions?: Record<string, any> | undefined;
-            experimental_providerMetadata?: Record<string, any> | undefined;
-            type: "text";
-            text: string;
-        } | {
-            providerOptions?: Record<string, any> | undefined;
-            experimental_providerMetadata?: Record<string, any> | undefined;
-            type: "file";
-            mimeType: string;
-            data: string | ArrayBuffer;
-        } | {
-            providerOptions?: Record<string, any> | undefined;
-            experimental_providerMetadata?: Record<string, any> | undefined;
-            type: "reasoning";
-            text: string;
-        } | {
-            providerOptions?: Record<string, any> | undefined;
-            experimental_providerMetadata?: Record<string, any> | undefined;
-            type: "redacted-reasoning";
-            data: string;
-        } | {
-            providerOptions?: Record<string, any> | undefined;
-            experimental_providerMetadata?: Record<string, any> | undefined;
-            type: "tool-call";
-            toolCallId: string;
-            toolName: string;
-            args: any;
-        })[];
-    } | {
-        providerOptions?: Record<string, any> | undefined;
-        experimental_providerMetadata?: Record<string, any> | undefined;
-        role: "tool";
-        content: {
-            providerOptions?: Record<string, any> | undefined;
-            experimental_providerMetadata?: Record<string, any> | undefined;
-            args?: any;
-            experimental_content?: ({
-                type: "text";
-                text: string;
-            } | {
-                mimeType?: string | undefined;
-                type: "image";
-                data: string;
-            })[] | undefined;
-            isError?: boolean | undefined;
-            type: "tool-result";
-            toolCallId: string;
-            toolName: string;
-            result: any;
-        }[];
-    } | {
-        providerOptions?: Record<string, any> | undefined;
-        experimental_providerMetadata?: Record<string, any> | undefined;
-        role: "system";
-        content: string;
-    } | undefined, [import("convex/values").VObject<{
-        providerOptions?: Record<string, any> | undefined;
-        experimental_providerMetadata?: Record<string, any> | undefined;
-        role: "user";
-        content: string | ({
-            providerOptions?: Record<string, any> | undefined;
-            experimental_providerMetadata?: Record<string, any> | undefined;
-            type: "text";
-            text: string;
-        } | {
-            providerOptions?: Record<string, any> | undefined;
-            experimental_providerMetadata?: Record<string, any> | undefined;
-            mimeType?: string | undefined;
-            type: "image";
-            image: string | ArrayBuffer;
-        } | {
-            providerOptions?: Record<string, any> | undefined;
-            experimental_providerMetadata?: Record<string, any> | undefined;
-            type: "file";
-            mimeType: string;
-            data: string | ArrayBuffer;
-        })[];
-    }, {
-        role: import("convex/values").VLiteral<"user", "required">;
-        content: import("convex/values").VUnion<string | ({
-            providerOptions?: Record<string, any> | undefined;
-            experimental_providerMetadata?: Record<string, any> | undefined;
-            type: "text";
-            text: string;
-        } | {
-            providerOptions?: Record<string, any> | undefined;
-            experimental_providerMetadata?: Record<string, any> | undefined;
-            mimeType?: string | undefined;
-            type: "image";
-            image: string | ArrayBuffer;
-        } | {
-            providerOptions?: Record<string, any> | undefined;
-            experimental_providerMetadata?: Record<string, any> | undefined;
-            type: "file";
-            mimeType: string;
-            data: string | ArrayBuffer;
-        })[], [import("convex/values").VString<string, "required">, import("convex/values").VArray<({
-            providerOptions?: Record<string, any> | undefined;
-            experimental_providerMetadata?: Record<string, any> | undefined;
-            type: "text";
-            text: string;
-        } | {
-            providerOptions?: Record<string, any> | undefined;
-            experimental_providerMetadata?: Record<string, any> | undefined;
-            mimeType?: string | undefined;
-            type: "image";
-            image: string | ArrayBuffer;
-        } | {
-            providerOptions?: Record<string, any> | undefined;
-            experimental_providerMetadata?: Record<string, any> | undefined;
-            type: "file";
-            mimeType: string;
-            data: string | ArrayBuffer;
-        })[], import("convex/values").VUnion<{
-            providerOptions?: Record<string, any> | undefined;
-            experimental_providerMetadata?: Record<string, any> | undefined;
-            type: "text";
-            text: string;
-        } | {
-            providerOptions?: Record<string, any> | undefined;
-            experimental_providerMetadata?: Record<string, any> | undefined;
-            mimeType?: string | undefined;
-            type: "image";
-            image: string | ArrayBuffer;
-        } | {
-            providerOptions?: Record<string, any> | undefined;
-            experimental_providerMetadata?: Record<string, any> | undefined;
-            type: "file";
-            mimeType: string;
-            data: string | ArrayBuffer;
-        }, [import("convex/values").VObject<{
-            providerOptions?: Record<string, any> | undefined;
-            experimental_providerMetadata?: Record<string, any> | undefined;
-            type: "text";
-            text: string;
-        }, {
-            type: import("convex/values").VLiteral<"text", "required">;
-            text: import("convex/values").VString<string, "required">;
-            providerOptions: import("convex/values").VRecord<Record<string, any> | undefined, import("convex/values").VString<string, "required">, import("convex/values").VAny<any, "required", string>, "optional", string>;
-            experimental_providerMetadata: import("convex/values").VRecord<Record<string, any> | undefined, import("convex/values").VString<string, "required">, import("convex/values").VAny<any, "required", string>, "optional", string>;
-        }, "required", "type" | "text" | "providerOptions" | "experimental_providerMetadata" | `providerOptions.${string}` | `experimental_providerMetadata.${string}`>, import("convex/values").VObject<{
-            providerOptions?: Record<string, any> | undefined;
-            experimental_providerMetadata?: Record<string, any> | undefined;
-            mimeType?: string | undefined;
-            type: "image";
-            image: string | ArrayBuffer;
-        }, {
-            type: import("convex/values").VLiteral<"image", "required">;
-            image: import("convex/values").VUnion<string | ArrayBuffer, [import("convex/values").VString<string, "required">, import("convex/values").VBytes<ArrayBuffer, "required">], "required", never>;
-            mimeType: import("convex/values").VString<string | undefined, "optional">;
-            providerOptions: import("convex/values").VRecord<Record<string, any> | undefined, import("convex/values").VString<string, "required">, import("convex/values").VAny<any, "required", string>, "optional", string>;
-            experimental_providerMetadata: import("convex/values").VRecord<Record<string, any> | undefined, import("convex/values").VString<string, "required">, import("convex/values").VAny<any, "required", string>, "optional", string>;
-        }, "required", "type" | "providerOptions" | "experimental_providerMetadata" | `providerOptions.${string}` | `experimental_providerMetadata.${string}` | "image" | "mimeType">, import("convex/values").VObject<{
-            providerOptions?: Record<string, any> | undefined;
-            experimental_providerMetadata?: Record<string, any> | undefined;
-            type: "file";
-            mimeType: string;
-            data: string | ArrayBuffer;
-        }, {
-            type: import("convex/values").VLiteral<"file", "required">;
-            data: import("convex/values").VUnion<string | ArrayBuffer, [import("convex/values").VString<string, "required">, import("convex/values").VBytes<ArrayBuffer, "required">], "required", never>;
-            mimeType: import("convex/values").VString<string, "required">;
-            providerOptions: import("convex/values").VRecord<Record<string, any> | undefined, import("convex/values").VString<string, "required">, import("convex/values").VAny<any, "required", string>, "optional", string>;
-            experimental_providerMetadata: import("convex/values").VRecord<Record<string, any> | undefined, import("convex/values").VString<string, "required">, import("convex/values").VAny<any, "required", string>, "optional", string>;
-        }, "required", "type" | "providerOptions" | "experimental_providerMetadata" | `providerOptions.${string}` | `experimental_providerMetadata.${string}` | "mimeType" | "data">], "required", "type" | "text" | "providerOptions" | "experimental_providerMetadata" | `providerOptions.${string}` | `experimental_providerMetadata.${string}` | "image" | "mimeType" | "data">, "required">], "required", never>;
-        providerOptions: import("convex/values").VRecord<Record<string, any> | undefined, import("convex/values").VString<string, "required">, import("convex/values").VAny<any, "required", string>, "optional", string>;
-        experimental_providerMetadata: import("convex/values").VRecord<Record<string, any> | undefined, import("convex/values").VString<string, "required">, import("convex/values").VAny<any, "required", string>, "optional", string>;
-    }, "required", "role" | "providerOptions" | "experimental_providerMetadata" | `providerOptions.${string}` | `experimental_providerMetadata.${string}` | "content">, import("convex/values").VObject<{
-        providerOptions?: Record<string, any> | undefined;
-        experimental_providerMetadata?: Record<string, any> | undefined;
-        role: "assistant";
-        content: string | ({
-            providerOptions?: Record<string, any> | undefined;
-            experimental_providerMetadata?: Record<string, any> | undefined;
-            type: "text";
-            text: string;
-        } | {
-            providerOptions?: Record<string, any> | undefined;
-            experimental_providerMetadata?: Record<string, any> | undefined;
-            type: "file";
-            mimeType: string;
-            data: string | ArrayBuffer;
-        } | {
-            providerOptions?: Record<string, any> | undefined;
-            experimental_providerMetadata?: Record<string, any> | undefined;
-            type: "reasoning";
-            text: string;
-        } | {
-            providerOptions?: Record<string, any> | undefined;
-            experimental_providerMetadata?: Record<string, any> | undefined;
-            type: "redacted-reasoning";
-            data: string;
-        } | {
-            providerOptions?: Record<string, any> | undefined;
-            experimental_providerMetadata?: Record<string, any> | undefined;
-            type: "tool-call";
-            toolCallId: string;
-            toolName: string;
-            args: any;
-        })[];
-    }, {
-        role: import("convex/values").VLiteral<"assistant", "required">;
-        content: import("convex/values").VUnion<string | ({
-            providerOptions?: Record<string, any> | undefined;
-            experimental_providerMetadata?: Record<string, any> | undefined;
-            type: "text";
-            text: string;
-        } | {
-            providerOptions?: Record<string, any> | undefined;
-            experimental_providerMetadata?: Record<string, any> | undefined;
-            type: "file";
-            mimeType: string;
-            data: string | ArrayBuffer;
-        } | {
-            providerOptions?: Record<string, any> | undefined;
-            experimental_providerMetadata?: Record<string, any> | undefined;
-            type: "reasoning";
-            text: string;
-        } | {
-            providerOptions?: Record<string, any> | undefined;
-            experimental_providerMetadata?: Record<string, any> | undefined;
-            type: "redacted-reasoning";
-            data: string;
-        } | {
-            providerOptions?: Record<string, any> | undefined;
-            experimental_providerMetadata?: Record<string, any> | undefined;
-            type: "tool-call";
-            toolCallId: string;
-            toolName: string;
-            args: any;
-        })[], [import("convex/values").VString<string, "required">, import("convex/values").VArray<({
-            providerOptions?: Record<string, any> | undefined;
-            experimental_providerMetadata?: Record<string, any> | undefined;
-            type: "text";
-            text: string;
-        } | {
-            providerOptions?: Record<string, any> | undefined;
-            experimental_providerMetadata?: Record<string, any> | undefined;
-            type: "file";
-            mimeType: string;
-            data: string | ArrayBuffer;
-        } | {
-            providerOptions?: Record<string, any> | undefined;
-            experimental_providerMetadata?: Record<string, any> | undefined;
-            type: "reasoning";
-            text: string;
-        } | {
-            providerOptions?: Record<string, any> | undefined;
-            experimental_providerMetadata?: Record<string, any> | undefined;
-            type: "redacted-reasoning";
-            data: string;
-        } | {
-            providerOptions?: Record<string, any> | undefined;
-            experimental_providerMetadata?: Record<string, any> | undefined;
-            type: "tool-call";
-            toolCallId: string;
-            toolName: string;
-            args: any;
-        })[], import("convex/values").VUnion<{
-            providerOptions?: Record<string, any> | undefined;
-            experimental_providerMetadata?: Record<string, any> | undefined;
-            type: "text";
-            text: string;
-        } | {
-            providerOptions?: Record<string, any> | undefined;
-            experimental_providerMetadata?: Record<string, any> | undefined;
-            type: "file";
-            mimeType: string;
-            data: string | ArrayBuffer;
-        } | {
-            providerOptions?: Record<string, any> | undefined;
-            experimental_providerMetadata?: Record<string, any> | undefined;
-            type: "reasoning";
-            text: string;
-        } | {
-            providerOptions?: Record<string, any> | undefined;
-            experimental_providerMetadata?: Record<string, any> | undefined;
-            type: "redacted-reasoning";
-            data: string;
-        } | {
-            providerOptions?: Record<string, any> | undefined;
-            experimental_providerMetadata?: Record<string, any> | undefined;
-            type: "tool-call";
-            toolCallId: string;
-            toolName: string;
-            args: any;
-        }, [import("convex/values").VObject<{
-            providerOptions?: Record<string, any> | undefined;
-            experimental_providerMetadata?: Record<string, any> | undefined;
-            type: "text";
-            text: string;
-        }, {
-            type: import("convex/values").VLiteral<"text", "required">;
-            text: import("convex/values").VString<string, "required">;
-            providerOptions: import("convex/values").VRecord<Record<string, any> | undefined, import("convex/values").VString<string, "required">, import("convex/values").VAny<any, "required", string>, "optional", string>;
-            experimental_providerMetadata: import("convex/values").VRecord<Record<string, any> | undefined, import("convex/values").VString<string, "required">, import("convex/values").VAny<any, "required", string>, "optional", string>;
-        }, "required", "type" | "text" | "providerOptions" | "experimental_providerMetadata" | `providerOptions.${string}` | `experimental_providerMetadata.${string}`>, import("convex/values").VObject<{
-            providerOptions?: Record<string, any> | undefined;
-            experimental_providerMetadata?: Record<string, any> | undefined;
-            type: "file";
-            mimeType: string;
-            data: string | ArrayBuffer;
-        }, {
-            type: import("convex/values").VLiteral<"file", "required">;
-            data: import("convex/values").VUnion<string | ArrayBuffer, [import("convex/values").VString<string, "required">, import("convex/values").VBytes<ArrayBuffer, "required">], "required", never>;
-            mimeType: import("convex/values").VString<string, "required">;
-            providerOptions: import("convex/values").VRecord<Record<string, any> | undefined, import("convex/values").VString<string, "required">, import("convex/values").VAny<any, "required", string>, "optional", string>;
-            experimental_providerMetadata: import("convex/values").VRecord<Record<string, any> | undefined, import("convex/values").VString<string, "required">, import("convex/values").VAny<any, "required", string>, "optional", string>;
-        }, "required", "type" | "providerOptions" | "experimental_providerMetadata" | `providerOptions.${string}` | `experimental_providerMetadata.${string}` | "mimeType" | "data">, import("convex/values").VObject<{
-            providerOptions?: Record<string, any> | undefined;
-            experimental_providerMetadata?: Record<string, any> | undefined;
-            type: "reasoning";
-            text: string;
-        }, {
-            type: import("convex/values").VLiteral<"reasoning", "required">;
-            text: import("convex/values").VString<string, "required">;
-            providerOptions: import("convex/values").VRecord<Record<string, any> | undefined, import("convex/values").VString<string, "required">, import("convex/values").VAny<any, "required", string>, "optional", string>;
-            experimental_providerMetadata: import("convex/values").VRecord<Record<string, any> | undefined, import("convex/values").VString<string, "required">, import("convex/values").VAny<any, "required", string>, "optional", string>;
-        }, "required", "type" | "text" | "providerOptions" | "experimental_providerMetadata" | `providerOptions.${string}` | `experimental_providerMetadata.${string}`>, import("convex/values").VObject<{
-            providerOptions?: Record<string, any> | undefined;
-            experimental_providerMetadata?: Record<string, any> | undefined;
-            type: "redacted-reasoning";
-            data: string;
-        }, {
-            type: import("convex/values").VLiteral<"redacted-reasoning", "required">;
-            data: import("convex/values").VString<string, "required">;
-            providerOptions: import("convex/values").VRecord<Record<string, any> | undefined, import("convex/values").VString<string, "required">, import("convex/values").VAny<any, "required", string>, "optional", string>;
-            experimental_providerMetadata: import("convex/values").VRecord<Record<string, any> | undefined, import("convex/values").VString<string, "required">, import("convex/values").VAny<any, "required", string>, "optional", string>;
-        }, "required", "type" | "providerOptions" | "experimental_providerMetadata" | `providerOptions.${string}` | `experimental_providerMetadata.${string}` | "data">, import("convex/values").VObject<{
-            providerOptions?: Record<string, any> | undefined;
-            experimental_providerMetadata?: Record<string, any> | undefined;
-            type: "tool-call";
-            toolCallId: string;
-            toolName: string;
-            args: any;
-        }, {
-            type: import("convex/values").VLiteral<"tool-call", "required">;
-            toolCallId: import("convex/values").VString<string, "required">;
-            toolName: import("convex/values").VString<string, "required">;
-            args: import("convex/values").VAny<any, "required", string>;
-            providerOptions: import("convex/values").VRecord<Record<string, any> | undefined, import("convex/values").VString<string, "required">, import("convex/values").VAny<any, "required", string>, "optional", string>;
-            experimental_providerMetadata: import("convex/values").VRecord<Record<string, any> | undefined, import("convex/values").VString<string, "required">, import("convex/values").VAny<any, "required", string>, "optional", string>;
-        }, "required", "type" | "providerOptions" | "experimental_providerMetadata" | `providerOptions.${string}` | `experimental_providerMetadata.${string}` | "toolCallId" | "toolName" | "args" | `args.${string}`>], "required", "type" | "text" | "providerOptions" | "experimental_providerMetadata" | `providerOptions.${string}` | `experimental_providerMetadata.${string}` | "mimeType" | "data" | "toolCallId" | "toolName" | "args" | `args.${string}`>, "required">], "required", never>;
-        providerOptions: import("convex/values").VRecord<Record<string, any> | undefined, import("convex/values").VString<string, "required">, import("convex/values").VAny<any, "required", string>, "optional", string>;
-        experimental_providerMetadata: import("convex/values").VRecord<Record<string, any> | undefined, import("convex/values").VString<string, "required">, import("convex/values").VAny<any, "required", string>, "optional", string>;
-    }, "required", "role" | "providerOptions" | "experimental_providerMetadata" | `providerOptions.${string}` | `experimental_providerMetadata.${string}` | "content">, import("convex/values").VObject<{
-        providerOptions?: Record<string, any> | undefined;
-        experimental_providerMetadata?: Record<string, any> | undefined;
-        role: "tool";
-        content: {
-            providerOptions?: Record<string, any> | undefined;
-            experimental_providerMetadata?: Record<string, any> | undefined;
-            args?: any;
-            experimental_content?: ({
-                type: "text";
-                text: string;
-            } | {
-                mimeType?: string | undefined;
-                type: "image";
-                data: string;
-            })[] | undefined;
-            isError?: boolean | undefined;
-            type: "tool-result";
-            toolCallId: string;
-            toolName: string;
-            result: any;
-        }[];
-    }, {
-        role: import("convex/values").VLiteral<"tool", "required">;
-        content: import("convex/values").VArray<{
-            providerOptions?: Record<string, any> | undefined;
-            experimental_providerMetadata?: Record<string, any> | undefined;
-            args?: any;
-            experimental_content?: ({
-                type: "text";
-                text: string;
-            } | {
-                mimeType?: string | undefined;
-                type: "image";
-                data: string;
-            })[] | undefined;
-            isError?: boolean | undefined;
-            type: "tool-result";
-            toolCallId: string;
-            toolName: string;
-            result: any;
-        }[], import("convex/values").VObject<{
-            providerOptions?: Record<string, any> | undefined;
-            experimental_providerMetadata?: Record<string, any> | undefined;
-            args?: any;
-            experimental_content?: ({
-                type: "text";
-                text: string;
-            } | {
-                mimeType?: string | undefined;
-                type: "image";
-                data: string;
-            })[] | undefined;
-            isError?: boolean | undefined;
-            type: "tool-result";
-            toolCallId: string;
-            toolName: string;
-            result: any;
-        }, {
-            type: import("convex/values").VLiteral<"tool-result", "required">;
-            toolCallId: import("convex/values").VString<string, "required">;
-            toolName: import("convex/values").VString<string, "required">;
-            result: import("convex/values").VAny<any, "required", string>;
-            args: import("convex/values").VAny<any, "optional", string>;
-            experimental_content: import("convex/values").VArray<({
-                type: "text";
-                text: string;
-            } | {
-                mimeType?: string | undefined;
-                type: "image";
-                data: string;
-            })[] | undefined, import("convex/values").VUnion<{
-                type: "text";
-                text: string;
-            } | {
-                mimeType?: string | undefined;
-                type: "image";
-                data: string;
-            }, [import("convex/values").VObject<{
-                type: "text";
-                text: string;
-            }, {
-                type: import("convex/values").VLiteral<"text", "required">;
-                text: import("convex/values").VString<string, "required">;
-            }, "required", "type" | "text">, import("convex/values").VObject<{
-                mimeType?: string | undefined;
-                type: "image";
-                data: string;
-            }, {
-                type: import("convex/values").VLiteral<"image", "required">;
-                data: import("convex/values").VString<string, "required">;
-                mimeType: import("convex/values").VString<string | undefined, "optional">;
-            }, "required", "type" | "mimeType" | "data">], "required", "type" | "text" | "mimeType" | "data">, "optional">;
-            isError: import("convex/values").VBoolean<boolean | undefined, "optional">;
-            providerOptions: import("convex/values").VRecord<Record<string, any> | undefined, import("convex/values").VString<string, "required">, import("convex/values").VAny<any, "required", string>, "optional", string>;
-            experimental_providerMetadata: import("convex/values").VRecord<Record<string, any> | undefined, import("convex/values").VString<string, "required">, import("convex/values").VAny<any, "required", string>, "optional", string>;
-        }, "required", "type" | "providerOptions" | "experimental_providerMetadata" | `providerOptions.${string}` | `experimental_providerMetadata.${string}` | "toolCallId" | "toolName" | "args" | `args.${string}` | "result" | "experimental_content" | "isError" | `result.${string}`>, "required">;
-        providerOptions: import("convex/values").VRecord<Record<string, any> | undefined, import("convex/values").VString<string, "required">, import("convex/values").VAny<any, "required", string>, "optional", string>;
-        experimental_providerMetadata: import("convex/values").VRecord<Record<string, any> | undefined, import("convex/values").VString<string, "required">, import("convex/values").VAny<any, "required", string>, "optional", string>;
-    }, "required", "role" | "providerOptions" | "experimental_providerMetadata" | `providerOptions.${string}` | `experimental_providerMetadata.${string}` | "content">, import("convex/values").VObject<{
-        providerOptions?: Record<string, any> | undefined;
-        experimental_providerMetadata?: Record<string, any> | undefined;
-        role: "system";
-        content: string;
-    }, {
-        role: import("convex/values").VLiteral<"system", "required">;
-        content: import("convex/values").VString<string, "required">;
-        providerOptions: import("convex/values").VRecord<Record<string, any> | undefined, import("convex/values").VString<string, "required">, import("convex/values").VAny<any, "required", string>, "optional", string>;
-        experimental_providerMetadata: import("convex/values").VRecord<Record<string, any> | undefined, import("convex/values").VString<string, "required">, import("convex/values").VAny<any, "required", string>, "optional", string>;
-    }, "required", "role" | "providerOptions" | "experimental_providerMetadata" | `providerOptions.${string}` | `experimental_providerMetadata.${string}` | "content">], "optional", "role" | "providerOptions" | "experimental_providerMetadata" | `providerOptions.${string}` | `experimental_providerMetadata.${string}` | "content">;
-    error: import("convex/values").VString<string | undefined, "optional">;
-    model: import("convex/values").VString<string | undefined, "optional">;
-    provider: import("convex/values").VString<string | undefined, "optional">;
-    text: import("convex/values").VString<string | undefined, "optional">;
-    tool: import("convex/values").VBoolean<boolean, "required">;
-    order: import("convex/values").VFloat64<number, "required">;
-    stepOrder: import("convex/values").VFloat64<number, "required">;
-    usage: import("convex/values").VObject<{
-        promptTokens: number;
-        completionTokens: number;
-        totalTokens: number;
-    } | undefined, {
-        promptTokens: import("convex/values").VFloat64<number, "required">;
-        completionTokens: import("convex/values").VFloat64<number, "required">;
-        totalTokens: import("convex/values").VFloat64<number, "required">;
-    }, "optional", "promptTokens" | "completionTokens" | "totalTokens">;
-    finishReason: import("convex/values").VUnion<"length" | "error" | "stop" | "content-filter" | "tool-calls" | "other" | "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>;
-    providerMetadata: import("convex/values").VRecord<Record<string, any> | undefined, import("convex/values").VString<string, "required">, import("convex/values").VAny<any, "required", string>, "optional", string>;
-    sources: import("convex/values").VArray<{
-        title?: string | undefined;
-        providerMetadata?: Record<string, Record<string, any>> | undefined;
-        id: string;
-        sourceType: "url";
-        url: string;
-    }[] | undefined, import("convex/values").VObject<{
-        title?: string | undefined;
-        providerMetadata?: Record<string, Record<string, any>> | undefined;
-        id: string;
-        sourceType: "url";
-        url: string;
-    }, {
-        sourceType: import("convex/values").VLiteral<"url", "required">;
-        id: import("convex/values").VString<string, "required">;
-        url: import("convex/values").VString<string, "required">;
-        title: import("convex/values").VString<string | undefined, "optional">;
-        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" | "providerMetadata" | "sourceType" | "url" | `providerMetadata.${string}`>, "optional">;
-    reasoning: import("convex/values").VString<string | undefined, "optional">;
-    warnings: import("convex/values").VArray<({
-        details?: string | undefined;
-        type: "unsupported-setting";
-        setting: string;
-    } | {
-        details?: string | undefined;
-        type: "unsupported-tool";
-        tool: any;
-    } | {
-        type: "other";
-        message: string;
-    })[] | undefined, import("convex/values").VUnion<{
-        details?: string | undefined;
-        type: "unsupported-setting";
-        setting: string;
-    } | {
-        details?: string | undefined;
-        type: "unsupported-tool";
-        tool: any;
-    } | {
-        type: "other";
-        message: string;
-    }, [import("convex/values").VObject<{
-        details?: string | undefined;
-        type: "unsupported-setting";
-        setting: string;
-    }, {
-        type: import("convex/values").VLiteral<"unsupported-setting", "required">;
-        setting: import("convex/values").VString<string, "required">;
-        details: import("convex/values").VString<string | undefined, "optional">;
-    }, "required", "type" | "setting" | "details">, import("convex/values").VObject<{
-        details?: string | undefined;
-        type: "unsupported-tool";
-        tool: any;
-    }, {
-        type: import("convex/values").VLiteral<"unsupported-tool", "required">;
-        tool: import("convex/values").VAny<any, "required", string>;
-        details: import("convex/values").VString<string | undefined, "optional">;
-    }, "required", "type" | "tool" | "details" | `tool.${string}`>, import("convex/values").VObject<{
-        type: "other";
-        message: string;
-    }, {
-        type: import("convex/values").VLiteral<"other", "required">;
-        message: import("convex/values").VString<string, "required">;
-    }, "required", "type" | "message">], "required", "type" | "message" | "tool" | "setting" | "details" | `tool.${string}`>, "optional">;
-    status: import("convex/values").VUnion<"pending" | "success" | "failed", [import("convex/values").VLiteral<"pending", "required">, import("convex/values").VLiteral<"success", "required">, import("convex/values").VLiteral<"failed", "required">], "required", never>;
-    _id: import("convex/values").VString<string, "required">;
-    _creationTime: import("convex/values").VFloat64<number, "required">;
-}, "required", "id" | "status" | "userId" | "order" | "_creationTime" | "threadId" | "parentMessageId" | "stepId" | "agentName" | "message" | "text" | "reasoning" | "tool" | "error" | "model" | "provider" | "embeddingId" | "stepOrder" | "usage" | "finishReason" | "providerMetadata" | "sources" | `providerMetadata.${string}` | "warnings" | "fileId" | "message.role" | "message.providerOptions" | "message.experimental_providerMetadata" | `message.providerOptions.${string}` | `message.experimental_providerMetadata.${string}` | "message.content" | "usage.promptTokens" | "usage.completionTokens" | "usage.totalTokens" | "_id">;
-export type MessageDoc = Infer<typeof vMessageDoc>;
-/**
- * Options to configure what messages are fetched as context,
- * automatically with thread.generateText, or directly via search.
- */
-export type ContextOptions = {
-    /** @deprecated Use excludeToolMessages instead. */
-    includeToolCalls?: boolean;
-    /**
-     * Whether to include tool messages in the context.
-     * By default, tool calls and results are not included.
-     */
-    excludeToolMessages?: boolean;
-    /**
-     * How many recent messages to include. These are added after the search
-     * messages, and do not count against the search limit.
-     * Default: 100
-     */
-    recentMessages?: number;
-    /**
-     * Options for searching messages.
-     */
-    searchOptions?: {
-        /**
-         * The maximum number of messages to fetch. Default is 10.
-         */
-        limit: number;
-        /**
-         * Whether to use text search to find messages. Default is false.
-         */
-        textSearch?: boolean;
-        /**
-         * Whether to use vector search to find messages. Default is false.
-         * At least one of textSearch or vectorSearch must be true.
-         */
-        vectorSearch?: boolean;
-        /**
-         * What messages around the search results to include.
-         * Default: { before: 2, after: 1 }
-         * (two before, and one after each message found in the search)
-         * Note, this is after the limit is applied.
-         * By default this will quadruple the number of messages fetched.
-         */
-        messageRange?: {
-            before: number;
-            after: number;
-        };
-    };
-    /**
-     * Whether to search across other threads for relevant messages.
-     * By default, only the current thread is searched.
-     */
-    searchOtherThreads?: boolean;
-};
-/**
- * Options to configure the automatic saving of messages
- * when generating text / objects in a thread.
- */
-export type StorageOptions = {
-    /**
-     * Defaults to false, allowing you to pass in arbitrary context that will
-     * be in addition to automatically fetched content.
-     * Pass true to have all input messages saved to the thread history.
-     */
-    saveAllInputMessages?: boolean;
-    /** Defaults to true, saving the prompt, or last message passed to generateText. */
-    saveAnyInputMessages?: boolean;
-    /** Defaults to true. Whether to save messages generated while chatting. */
-    saveOutputMessages?: boolean;
-};
-export type GenerationOutputMetadata = {
-    messageId?: string;
-};
-type CoreMessageMaybeWithId = CoreMessage & {
+export { paginationResultValidator, vContextOptions, vUsage, vProviderMetadata, vUserMessage, vAssistantMessage, vToolMessage, vStorageOptions, vSystemMessage, vMessage, } from "../validators.js";
+/**
+ * Options to configure what messages are fetched as context,
+ * automatically with thread.generateText, or directly via search.
+ */
+export type ContextOptions = {
+    /** @deprecated Use excludeToolMessages instead. */
+    includeToolCalls?: boolean;
+    /**
+     * Whether to include tool messages in the context.
+     * By default, tool calls and results are not included.
+     */
+    excludeToolMessages?: boolean;
+    /**
+     * How many recent messages to include. These are added after the search
+     * messages, and do not count against the search limit.
+     * Default: 100
+     */
+    recentMessages?: number;
+    /**
+     * Options for searching messages.
+     */
+    searchOptions?: {
+        /**
+         * The maximum number of messages to fetch. Default is 10.
+         */
+        limit: number;
+        /**
+         * Whether to use text search to find messages. Default is false.
+         */
+        textSearch?: boolean;
+        /**
+         * Whether to use vector search to find messages. Default is false.
+         * At least one of textSearch or vectorSearch must be true.
+         */
+        vectorSearch?: boolean;
+        /**
+         * What messages around the search results to include.
+         * Default: { before: 2, after: 1 }
+         * (two before, and one after each message found in the search)
+         * Note, this is after the limit is applied.
+         * By default this will quadruple the number of messages fetched.
+         */
+        messageRange?: {
+            before: number;
+            after: number;
+        };
+    };
+    /**
+     * Whether to search across other threads for relevant messages.
+     * By default, only the current thread is searched.
+     */
+    searchOtherThreads?: boolean;
+};
+/**
+ * Options to configure the automatic saving of messages
+ * when generating text / objects in a thread.
+ */
+export type StorageOptions = {
+    /**
+     * Defaults to false, allowing you to pass in arbitrary context that will
+     * be in addition to automatically fetched content.
+     * Pass true to have all input messages saved to the thread history.
+     */
+    saveAllInputMessages?: boolean;
+    /** Defaults to true, saving the prompt, or last message passed to generateText. */
+    saveAnyInputMessages?: boolean;
+    /** Defaults to true. Whether to save messages generated while chatting. */
+    saveOutputMessages?: boolean;
+};
+export type GenerationOutputMetadata = {
+    messageId?: string;
+};
+type CoreMessageMaybeWithId = CoreMessage & {
     id?: string | undefined;
 };
 export type UsageHandler = (ctx: RunActionCtx, args: {
@@ -820,8 +96,9 @@ export type UsageHandler = (ctx: RunActionCtx, args: {
     model: string;
     provider: string;
 }) => void | Promise<void>;
+export type AgentComponent = UseApi<Mounts>;
 export declare class Agent<AgentTools extends ToolSet> {
-    component: UseApi<Mounts>;
+    component: AgentComponent;
     options: {
         /**
          * The name for the agent. This will be attributed on each message
@@ -885,7 +162,7 @@ export declare class Agent<AgentTools extends ToolSet> {
          */
         usageHandler?: UsageHandler;
     };
-    constructor(component: UseApi<Mounts>, options: {
+    constructor(component: AgentComponent, options: {
         /**
          * The name for the agent. This will be attributed on each message
          * created by this agent.
@@ -1072,7 +349,7 @@ export declare class Agent<AgentTools extends ToolSet> {
          */
         beforeMessageId?: string;
         contextOptions: ContextOptions | undefined;
-    }): Promise<CoreMessage[]>;
+    }): Promise<MessageDoc[]>;
     /**
      * Get the embeddings for a set of messages.
      * @param messages The messages to get the embeddings for.
@@ -1307,67 +584,56 @@ export declare class Agent<AgentTools extends ToolSet> {
         userId?: string | undefined;
         threadId?: string | undefined;
         messages?: ({
-            providerOptions?: Record<string, any> | undefined;
-            experimental_providerMetadata?: Record<string, any> | undefined;
+            providerOptions?: Record<string, Record<string, any>> | undefined;
             role: "user";
             content: string | ({
-                providerOptions?: Record<string, any> | undefined;
-                experimental_providerMetadata?: Record<string, any> | undefined;
+                providerOptions?: Record<string, Record<string, any>> | undefined;
                 type: "text";
                 text: string;
             } | {
-                providerOptions?: Record<string, any> | undefined;
-                experimental_providerMetadata?: Record<string, any> | undefined;
+                providerOptions?: Record<string, Record<string, any>> | undefined;
                 mimeType?: string | undefined;
                 type: "image";
                 image: string | ArrayBuffer;
             } | {
-                providerOptions?: Record<string, any> | undefined;
-                experimental_providerMetadata?: Record<string, any> | undefined;
+                providerOptions?: Record<string, Record<string, any>> | undefined;
                 type: "file";
                 mimeType: string;
                 data: string | ArrayBuffer;
             })[];
         } | {
-            providerOptions?: Record<string, any> | undefined;
-            experimental_providerMetadata?: Record<string, any> | undefined;
+            providerOptions?: Record<string, Record<string, any>> | undefined;
             role: "assistant";
             content: string | ({
-                providerOptions?: Record<string, any> | undefined;
-                experimental_providerMetadata?: Record<string, any> | undefined;
+                providerOptions?: Record<string, Record<string, any>> | undefined;
                 type: "text";
                 text: string;
             } | {
-                providerOptions?: Record<string, any> | undefined;
-                experimental_providerMetadata?: Record<string, any> | undefined;
+                providerOptions?: Record<string, Record<string, any>> | undefined;
                 type: "file";
                 mimeType: string;
                 data: string | ArrayBuffer;
             } | {
-                providerOptions?: Record<string, any> | undefined;
-                experimental_providerMetadata?: Record<string, any> | undefined;
+                providerOptions?: Record<string, Record<string, any>> | undefined;
+                signature?: string | undefined;
                 type: "reasoning";
                 text: string;
             } | {
-                providerOptions?: Record<string, any> | undefined;
-                experimental_providerMetadata?: Record<string, any> | undefined;
+                providerOptions?: Record<string, Record<string, any>> | undefined;
                 type: "redacted-reasoning";
                 data: string;
             } | {
-                providerOptions?: Record<string, any> | undefined;
-                experimental_providerMetadata?: Record<string, any> | undefined;
+                providerOptions?: Record<string, Record<string, any>> | undefined;
                 type: "tool-call";
                 toolCallId: string;
                 toolName: string;
                 args: any;
             })[];
         } | {
-            providerOptions?: Record<string, any> | undefined;
-            experimental_providerMetadata?: Record<string, any> | undefined;
+            providerOptions?: Record<string, Record<string, any>> | undefined;
             role: "tool";
             content: {
-                providerOptions?: Record<string, any> | undefined;
-                experimental_providerMetadata?: Record<string, any> | undefined;
+                providerOptions?: Record<string, Record<string, any>> | undefined;
                 args?: any;
                 experimental_content?: ({
                     type: "text";
@@ -1384,13 +650,11 @@ export declare class Agent<AgentTools extends ToolSet> {
                 result: any;
             }[];
         } | {
-            providerOptions?: Record<string, any> | undefined;
-            experimental_providerMetadata?: Record<string, any> | undefined;
+            providerOptions?: Record<string, Record<string, any>> | undefined;
             role: "system";
             content: string;
         })[] | undefined;
-        providerOptions?: Record<string, any> | undefined;
-        experimental_providerMetadata?: Record<string, any> | undefined;
+        providerOptions?: Record<string, Record<string, any>> | undefined;
         system?: string | undefined;
         headers?: Record<string, string> | undefined;
         maxTokens?: number | undefined;
@@ -1409,7 +673,7 @@ export declare class Agent<AgentTools extends ToolSet> {
         experimental_continueSteps?: boolean | undefined;
         prompt?: string | undefined;
         contextOptions?: {
-            includeToolCalls?: boolean | undefined;
+            excludeToolMessages?: boolean | undefined;
             recentMessages?: number | undefined;
             searchOptions?: {
                 messageRange?: {
@@ -1424,7 +688,8 @@ export declare class Agent<AgentTools extends ToolSet> {
         } | undefined;
         storageOptions?: {
             saveAllInputMessages?: boolean | undefined;
-            saveAllOutputMessages?: boolean | undefined;
+            saveAnyInputMessages?: boolean | undefined;
+            saveOutputMessages?: boolean | undefined;
         } | undefined;
     }, Promise<string>>;
     /**
@@ -1443,67 +708,56 @@ export declare class Agent<AgentTools extends ToolSet> {
         userId?: string | undefined;
         threadId?: string | undefined;
         messages?: ({
-            providerOptions?: Record<string, any> | undefined;
-            experimental_providerMetadata?: Record<string, any> | undefined;
+            providerOptions?: Record<string, Record<string, any>> | undefined;
             role: "user";
             content: string | ({
-                providerOptions?: Record<string, any> | undefined;
-                experimental_providerMetadata?: Record<string, any> | undefined;
+                providerOptions?: Record<string, Record<string, any>> | undefined;
                 type: "text";
                 text: string;
             } | {
-                providerOptions?: Record<string, any> | undefined;
-                experimental_providerMetadata?: Record<string, any> | undefined;
+                providerOptions?: Record<string, Record<string, any>> | undefined;
                 mimeType?: string | undefined;
                 type: "image";
                 image: string | ArrayBuffer;
             } | {
-                providerOptions?: Record<string, any> | undefined;
-                experimental_providerMetadata?: Record<string, any> | undefined;
+                providerOptions?: Record<string, Record<string, any>> | undefined;
                 type: "file";
                 mimeType: string;
                 data: string | ArrayBuffer;
             })[];
         } | {
-            providerOptions?: Record<string, any> | undefined;
-            experimental_providerMetadata?: Record<string, any> | undefined;
+            providerOptions?: Record<string, Record<string, any>> | undefined;
             role: "assistant";
             content: string | ({
-                providerOptions?: Record<string, any> | undefined;
-                experimental_providerMetadata?: Record<string, any> | undefined;
+                providerOptions?: Record<string, Record<string, any>> | undefined;
                 type: "text";
                 text: string;
             } | {
-                providerOptions?: Record<string, any> | undefined;
-                experimental_providerMetadata?: Record<string, any> | undefined;
+                providerOptions?: Record<string, Record<string, any>> | undefined;
                 type: "file";
                 mimeType: string;
                 data: string | ArrayBuffer;
             } | {
-                providerOptions?: Record<string, any> | undefined;
-                experimental_providerMetadata?: Record<string, any> | undefined;
+                providerOptions?: Record<string, Record<string, any>> | undefined;
+                signature?: string | undefined;
                 type: "reasoning";
                 text: string;
             } | {
-                providerOptions?: Record<string, any> | undefined;
-                experimental_providerMetadata?: Record<string, any> | undefined;
+                providerOptions?: Record<string, Record<string, any>> | undefined;
                 type: "redacted-reasoning";
                 data: string;
             } | {
-                providerOptions?: Record<string, any> | undefined;
-                experimental_providerMetadata?: Record<string, any> | undefined;
+                providerOptions?: Record<string, Record<string, any>> | undefined;
                 type: "tool-call";
                 toolCallId: string;
                 toolName: string;
                 args: any;
             })[];
         } | {
-            providerOptions?: Record<string, any> | undefined;
-            experimental_providerMetadata?: Record<string, any> | undefined;
+            providerOptions?: Record<string, Record<string, any>> | undefined;
             role: "tool";
             content: {
-                providerOptions?: Record<string, any> | undefined;
-                experimental_providerMetadata?: Record<string, any> | undefined;
+                providerOptions?: Record<string, Record<string, any>> | undefined;
                 args?: any;
                 experimental_content?: ({
                     type: "text";
@@ -1520,13 +774,11 @@ export declare class Agent<AgentTools extends ToolSet> {
                 result: any;
             }[];
         } | {
-            providerOptions?: Record<string, any> | undefined;
-            experimental_providerMetadata?: Record<string, any> | undefined;
+            providerOptions?: Record<string, Record<string, any>> | undefined;
             role: "system";
             content: string;
         })[] | undefined;
-        providerOptions?: Record<string, any> | undefined;
-        experimental_providerMetadata?: Record<string, any> | undefined;
+        providerOptions?: Record<string, Record<string, any>> | undefined;
         system?: string | undefined;
         headers?: Record<string, string> | undefined;
         maxTokens?: number | undefined;
@@ -1539,7 +791,7 @@ export declare class Agent<AgentTools extends ToolSet> {
         maxRetries?: number | undefined;
         prompt?: string | undefined;
         contextOptions?: {
-            includeToolCalls?: boolean | undefined;
+            excludeToolMessages?: boolean | undefined;
             recentMessages?: number | undefined;
             searchOptions?: {
                 messageRange?: {
@@ -1554,10 +806,143 @@ export declare class Agent<AgentTools extends ToolSet> {
         } | undefined;
         storageOptions?: {
             saveAllInputMessages?: boolean | undefined;
-            saveAllOutputMessages?: boolean | undefined;
+            saveAnyInputMessages?: boolean | undefined;
+            saveOutputMessages?: boolean | undefined;
         } | undefined;
     }, Promise<T>>;
 }
+export declare function filterOutOrphanedToolMessages(docs: MessageDoc[]): {
+    id?: string | undefined;
+    userId?: string | undefined;
+    parentMessageId?: string | undefined;
+    stepId?: string | undefined;
+    embeddingId?: string | undefined;
+    error?: string | undefined;
+    agentName?: string | undefined;
+    model?: string | undefined;
+    provider?: string | undefined;
+    providerOptions?: Record<string, Record<string, any>> | undefined;
+    message?: {
+        providerOptions?: Record<string, Record<string, any>> | undefined;
+        role: "user";
+        content: string | ({
+            providerOptions?: Record<string, Record<string, any>> | undefined;
+            type: "text";
+            text: string;
+        } | {
+            providerOptions?: Record<string, Record<string, any>> | undefined;
+            mimeType?: string | undefined;
+            type: "image";
+            image: string | ArrayBuffer;
+        } | {
+            providerOptions?: Record<string, Record<string, any>> | undefined;
+            type: "file";
+            mimeType: string;
+            data: string | ArrayBuffer;
+        })[];
+    } | {
+        providerOptions?: Record<string, Record<string, any>> | undefined;
+        role: "assistant";
+        content: string | ({
+            providerOptions?: Record<string, Record<string, any>> | undefined;
+            type: "text";
+            text: string;
+        } | {
+            providerOptions?: Record<string, Record<string, any>> | undefined;
+            type: "file";
+            mimeType: string;
+            data: string | ArrayBuffer;
+        } | {
+            providerOptions?: Record<string, Record<string, any>> | undefined;
+            signature?: string | undefined;
+            type: "reasoning";
+            text: string;
+        } | {
+            providerOptions?: Record<string, Record<string, any>> | undefined;
+            type: "redacted-reasoning";
+            data: string;
+        } | {
+            providerOptions?: Record<string, Record<string, any>> | undefined;
+            type: "tool-call";
+            toolCallId: string;
+            toolName: string;
+            args: any;
+        })[];
+    } | {
+        providerOptions?: Record<string, Record<string, any>> | undefined;
+        role: "tool";
+        content: {
+            providerOptions?: Record<string, Record<string, any>> | undefined;
+            args?: any;
+            experimental_content?: ({
+                type: "text";
+                text: string;
+            } | {
+                mimeType?: string | undefined;
+                type: "image";
+                data: string;
+            })[] | undefined;
+            isError?: boolean | undefined;
+            type: "tool-result";
+            toolCallId: string;
+            toolName: string;
+            result: any;
+        }[];
+    } | {
+        providerOptions?: Record<string, Record<string, any>> | undefined;
+        role: "system";
+        content: string;
+    } | undefined;
+    text?: string | undefined;
+    reasoning?: string | undefined;
+    files?: {
+        bytes?: ArrayBuffer | undefined;
+        url?: string | undefined;
+        fileId?: string | undefined;
+        mimeType: string;
+    }[] | undefined;
+    usage?: {
+        promptTokens: number;
+        completionTokens: number;
+        totalTokens: number;
+    } | undefined;
+    providerMetadata?: Record<string, Record<string, any>> | undefined;
+    sources?: {
+        title?: string | undefined;
+        providerOptions?: Record<string, Record<string, any>> | undefined;
+        id: string;
+        url: string;
+        sourceType: "url";
+    }[] | undefined;
+    reasoningDetails?: ({
+        signature?: string | undefined;
+        type: "text";
+        text: string;
+    } | {
+        type: "redacted";
+        data: string;
+    })[] | undefined;
+    warnings?: ({
+        details?: string | undefined;
+        type: "unsupported-setting";
+        setting: string;
+    } | {
+        details?: string | undefined;
+        type: "unsupported-tool";
+        tool: any;
+    } | {
+        type: "other";
+        message: string;
+    })[] | undefined;
+    finishReason?: "length" | "error" | "other" | "stop" | "content-filter" | "tool-calls" | "unknown" | undefined;
+    status: "pending" | "success" | "failed";
+    order: number;
+    _creationTime: number;
+    threadId: string;
+    stepOrder: number;
+    tool: boolean;
+    _id: string;
+}[];
 export type ToolCtx = RunActionCtx & {
     userId?: string;
     threadId?: string;
@@ -1708,60 +1093,767 @@ interface Thread<DefaultTools extends ToolSet> {
      * The target threadId, from the startThread or continueThread initializers.
      */
     threadId: string;
-    /**
-     * This behaves like {@link generateText} from the "ai" package except that
-     * it add context based on the userId and threadId and saves the input and
-     * resulting messages to the thread, if specified.
-     * Use {@link continueThread} to get a version of this function already scoped
-     * to a thread (and optionally userId).
-     * @param args The arguments to the generateText function, along with extra controls
-     * for the {@link ContextOptions} and {@link StorageOptions}.
-     * @returns The result of the generateText function.
-     */
-    generateText<TOOLS extends ToolSet | undefined = undefined, OUTPUT = never, OUTPUT_PARTIAL = never>(args: TextArgs<TOOLS extends undefined ? DefaultTools : TOOLS, TOOLS, OUTPUT, OUTPUT_PARTIAL>, options?: Options): Promise<GenerateTextResult<TOOLS extends undefined ? DefaultTools : TOOLS, OUTPUT> & ThreadOutputMetadata>;
-    /**
-     * This behaves like {@link streamText} from the "ai" package except that
-     * it add context based on the userId and threadId and saves the input and
-     * resulting messages to the thread, if specified.
-     * Use {@link continueThread} to get a version of this function already scoped
-     * to a thread (and optionally userId).
-     * @param args The arguments to the streamText function, along with extra controls
-     * for the {@link ContextOptions} and {@link StorageOptions}.
-     * @returns The result of the streamText function.
-     */
-    streamText<TOOLS extends ToolSet | undefined = undefined, OUTPUT = never, PARTIAL_OUTPUT = never>(args: StreamingTextArgs<TOOLS extends undefined ? DefaultTools : TOOLS, TOOLS, OUTPUT, PARTIAL_OUTPUT>, options?: Options): Promise<StreamTextResult<TOOLS extends undefined ? DefaultTools : TOOLS, PARTIAL_OUTPUT> & ThreadOutputMetadata>;
-    /**
-     * This behaves like {@link generateObject} from the "ai" package except that
-     * it add context based on the userId and threadId and saves the input and
-     * resulting messages to the thread, if specified. This overload is for objects, arrays, and enums.
-     * Use {@link continueThread} to get a version of this function already scoped
-     * to a thread (and optionally userId).
-     * @param args The arguments to the generateObject function, along with extra controls
-     * for the {@link ContextOptions} and {@link StorageOptions}.
-     * @returns The result of the generateObject function.
-     */
-    generateObject<T>(args: OurObjectArgs<T>, options?: Options): Promise<GenerateObjectResult<T> & ThreadOutputMetadata>;
-    /**
-     * This behaves like {@link generateObject} from the "ai" package except that
-     * it add context based on the userId and threadId and saves the input and
-     * resulting messages to the thread, if specified. This overload is for when there's no schema.
-     * Use {@link continueThread} to get a version of this function already scoped
-     * to a thread (and optionally userId).
-     * @param args The arguments to the generateObject function, along with extra controls
-     * for the {@link ContextOptions} and {@link StorageOptions}.
-     * @returns The result of the generateObject function.
-     */
-    generateObject(args: GenerateObjectNoSchemaOptions, options?: Options): Promise<GenerateObjectResult<JSONValue> & ThreadOutputMetadata>;
-    /**
-     * This behaves like {@link streamObject} from the "ai" package except that
-     * it add context based on the userId and threadId and saves the input and
-     * resulting messages to the thread, if specified.
-     * Use {@link continueThread} to get a version of this function already scoped
-     * to a thread (and optionally userId).
-     * @param args The arguments to the streamObject function, along with extra controls
-     * for the {@link ContextOptions} and {@link StorageOptions}.
-     * @returns The result of the streamObject function.
-     */
-    streamObject<T>(args: OurStreamObjectArgs<T>, options?: Options): Promise<StreamObjectResult<DeepPartial<T>, T, never> & ThreadOutputMetadata>;
-}
+    /**
+     * This behaves like {@link generateText} from the "ai" package except that
+     * it add context based on the userId and threadId and saves the input and
+     * resulting messages to the thread, if specified.
+     * Use {@link continueThread} to get a version of this function already scoped
+     * to a thread (and optionally userId).
+     * @param args The arguments to the generateText function, along with extra controls
+     * for the {@link ContextOptions} and {@link StorageOptions}.
+     * @returns The result of the generateText function.
+     */
+    generateText<TOOLS extends ToolSet | undefined = undefined, OUTPUT = never, OUTPUT_PARTIAL = never>(args: TextArgs<TOOLS extends undefined ? DefaultTools : TOOLS, TOOLS, OUTPUT, OUTPUT_PARTIAL>, options?: Options): Promise<GenerateTextResult<TOOLS extends undefined ? DefaultTools : TOOLS, OUTPUT> & ThreadOutputMetadata>;
+    /**
+     * This behaves like {@link streamText} from the "ai" package except that
+     * it add context based on the userId and threadId and saves the input and
+     * resulting messages to the thread, if specified.
+     * Use {@link continueThread} to get a version of this function already scoped
+     * to a thread (and optionally userId).
+     * @param args The arguments to the streamText function, along with extra controls
+     * for the {@link ContextOptions} and {@link StorageOptions}.
+     * @returns The result of the streamText function.
+     */
+    streamText<TOOLS extends ToolSet | undefined = undefined, OUTPUT = never, PARTIAL_OUTPUT = never>(args: StreamingTextArgs<TOOLS extends undefined ? DefaultTools : TOOLS, TOOLS, OUTPUT, PARTIAL_OUTPUT>, options?: Options): Promise<StreamTextResult<TOOLS extends undefined ? DefaultTools : TOOLS, PARTIAL_OUTPUT> & ThreadOutputMetadata>;
+    /**
+     * This behaves like {@link generateObject} from the "ai" package except that
+     * it add context based on the userId and threadId and saves the input and
+     * resulting messages to the thread, if specified. This overload is for objects, arrays, and enums.
+     * Use {@link continueThread} to get a version of this function already scoped
+     * to a thread (and optionally userId).
+     * @param args The arguments to the generateObject function, along with extra controls
+     * for the {@link ContextOptions} and {@link StorageOptions}.
+     * @returns The result of the generateObject function.
+     */
+    generateObject<T>(args: OurObjectArgs<T>, options?: Options): Promise<GenerateObjectResult<T> & ThreadOutputMetadata>;
+    /**
+     * This behaves like {@link generateObject} from the "ai" package except that
+     * it add context based on the userId and threadId and saves the input and
+     * resulting messages to the thread, if specified. This overload is for when there's no schema.
+     * Use {@link continueThread} to get a version of this function already scoped
+     * to a thread (and optionally userId).
+     * @param args The arguments to the generateObject function, along with extra controls
+     * for the {@link ContextOptions} and {@link StorageOptions}.
+     * @returns The result of the generateObject function.
+     */
+    generateObject(args: GenerateObjectNoSchemaOptions, options?: Options): Promise<GenerateObjectResult<JSONValue> & ThreadOutputMetadata>;
+    /**
+     * This behaves like {@link streamObject} from the "ai" package except that
+     * it add context based on the userId and threadId and saves the input and
+     * resulting messages to the thread, if specified.
+     * Use {@link continueThread} to get a version of this function already scoped
+     * to a thread (and optionally userId).
+     * @param args The arguments to the streamObject function, along with extra controls
+     * for the {@link ContextOptions} and {@link StorageOptions}.
+     * @returns The result of the streamObject function.
+     */
+    streamObject<T>(args: OurStreamObjectArgs<T>, options?: Options): Promise<StreamObjectResult<DeepPartial<T>, T, never> & ThreadOutputMetadata>;
+}
+export declare const vThreadDoc: import("convex/values").VObject<{
+    userId?: string | undefined;
+    title?: string | undefined;
+    summary?: string | undefined;
+    status: "active" | "archived";
+    _creationTime: number;
+    _id: string;
+}, {
+    _id: import("convex/values").VString<string, "required">;
+    _creationTime: import("convex/values").VFloat64<number, "required">;
+    userId: import("convex/values").VString<string | undefined, "optional">;
+    title: import("convex/values").VString<string | undefined, "optional">;
+    summary: import("convex/values").VString<string | undefined, "optional">;
+    status: import("convex/values").VUnion<"active" | "archived", [import("convex/values").VLiteral<"active", "required">, import("convex/values").VLiteral<"archived", "required">], "required", never>;
+}, "required", "status" | "userId" | "title" | "summary" | "_creationTime" | "_id">;
+export type ThreadDoc = Infer<typeof vThreadDoc>;
+export declare const vMessageDoc: import("convex/values").VObject<{
+    id?: string | undefined;
+    userId?: string | undefined;
+    parentMessageId?: string | undefined;
+    stepId?: string | undefined;
+    embeddingId?: string | undefined;
+    error?: string | undefined;
+    agentName?: string | undefined;
+    model?: string | undefined;
+    provider?: string | undefined;
+    providerOptions?: Record<string, Record<string, any>> | undefined;
+    message?: {
+        providerOptions?: Record<string, Record<string, any>> | undefined;
+        role: "user";
+        content: string | ({
+            providerOptions?: Record<string, Record<string, any>> | undefined;
+            type: "text";
+            text: string;
+        } | {
+            providerOptions?: Record<string, Record<string, any>> | undefined;
+            mimeType?: string | undefined;
+            type: "image";
+            image: string | ArrayBuffer;
+        } | {
+            providerOptions?: Record<string, Record<string, any>> | undefined;
+            type: "file";
+            mimeType: string;
+            data: string | ArrayBuffer;
+        })[];
+    } | {
+        providerOptions?: Record<string, Record<string, any>> | undefined;
+        role: "assistant";
+        content: string | ({
+            providerOptions?: Record<string, Record<string, any>> | undefined;
+            type: "text";
+            text: string;
+        } | {
+            providerOptions?: Record<string, Record<string, any>> | undefined;
+            type: "file";
+            mimeType: string;
+            data: string | ArrayBuffer;
+        } | {
+            providerOptions?: Record<string, Record<string, any>> | undefined;
+            signature?: string | undefined;
+            type: "reasoning";
+            text: string;
+        } | {
+            providerOptions?: Record<string, Record<string, any>> | undefined;
+            type: "redacted-reasoning";
+            data: string;
+        } | {
+            providerOptions?: Record<string, Record<string, any>> | undefined;
+            type: "tool-call";
+            toolCallId: string;
+            toolName: string;
+            args: any;
+        })[];
+    } | {
+        providerOptions?: Record<string, Record<string, any>> | undefined;
+        role: "tool";
+        content: {
+            providerOptions?: Record<string, Record<string, any>> | undefined;
+            args?: any;
+            experimental_content?: ({
+                type: "text";
+                text: string;
+            } | {
+                mimeType?: string | undefined;
+                type: "image";
+                data: string;
+            })[] | undefined;
+            isError?: boolean | undefined;
+            type: "tool-result";
+            toolCallId: string;
+            toolName: string;
+            result: any;
+        }[];
+    } | {
+        providerOptions?: Record<string, Record<string, any>> | undefined;
+        role: "system";
+        content: string;
+    } | undefined;
+    text?: string | undefined;
+    reasoning?: string | undefined;
+    files?: {
+        bytes?: ArrayBuffer | undefined;
+        url?: string | undefined;
+        fileId?: string | undefined;
+        mimeType: string;
+    }[] | undefined;
+    usage?: {
+        promptTokens: number;
+        completionTokens: number;
+        totalTokens: number;
+    } | undefined;
+    providerMetadata?: Record<string, Record<string, any>> | undefined;
+    sources?: {
+        title?: string | undefined;
+        providerOptions?: Record<string, Record<string, any>> | undefined;
+        id: string;
+        url: string;
+        sourceType: "url";
+    }[] | undefined;
+    reasoningDetails?: ({
+        signature?: string | undefined;
+        type: "text";
+        text: string;
+    } | {
+        type: "redacted";
+        data: string;
+    })[] | undefined;
+    warnings?: ({
+        details?: string | undefined;
+        type: "unsupported-setting";
+        setting: string;
+    } | {
+        details?: string | undefined;
+        type: "unsupported-tool";
+        tool: any;
+    } | {
+        type: "other";
+        message: string;
+    })[] | undefined;
+    finishReason?: "length" | "error" | "other" | "stop" | "content-filter" | "tool-calls" | "unknown" | undefined;
+    status: "pending" | "success" | "failed";
+    order: number;
+    _creationTime: number;
+    threadId: string;
+    stepOrder: number;
+    tool: boolean;
+    _id: string;
+}, {
+    threadId: import("convex/values").VString<string, "required">;
+    parentMessageId: import("convex/values").VString<string | undefined, "optional">;
+    stepId: import("convex/values").VString<string | undefined, "optional">;
+    embeddingId: import("convex/values").VString<string | undefined, "optional">;
+    files: import("convex/values").VArray<{
+        bytes?: ArrayBuffer | undefined;
+        url?: string | undefined;
+        fileId?: string | undefined;
+        mimeType: string;
+    }[] | undefined, import("convex/values").VObject<{
+        bytes?: ArrayBuffer | undefined;
+        url?: string | undefined;
+        fileId?: string | undefined;
+        mimeType: string;
+    }, {
+        bytes: import("convex/values").VBytes<ArrayBuffer | undefined, "optional">;
+        url: import("convex/values").VString<string | undefined, "optional">;
+        mimeType: import("convex/values").VString<string, "required">;
+        fileId: import("convex/values").VString<string | undefined, "optional">;
+    }, "required", "bytes" | "mimeType" | "url" | "fileId">, "optional">;
+    id: import("convex/values").VString<string | undefined, "optional">;
+    userId: import("convex/values").VString<string | undefined, "optional">;
+    order: import("convex/values").VFloat64<number, "required">;
+    stepOrder: import("convex/values").VFloat64<number, "required">;
+    error: import("convex/values").VString<string | undefined, "optional">;
+    status: import("convex/values").VUnion<"pending" | "success" | "failed", [import("convex/values").VLiteral<"pending", "required">, import("convex/values").VLiteral<"success", "required">, import("convex/values").VLiteral<"failed", "required">], "required", never>;
+    agentName: import("convex/values").VString<string | undefined, "optional">;
+    model: import("convex/values").VString<string | undefined, "optional">;
+    provider: import("convex/values").VString<string | undefined, "optional">;
+    providerOptions: import("convex/values").VRecord<Record<string, Record<string, any>> | undefined, import("convex/values").VString<string, "required">, import("convex/values").VRecord<Record<string, any>, import("convex/values").VString<string, "required">, import("convex/values").VAny<any, "required", string>, "required", string>, "optional", string>;
+    message: import("convex/values").VUnion<{
+        providerOptions?: Record<string, Record<string, any>> | undefined;
+        role: "user";
+        content: string | ({
+            providerOptions?: Record<string, Record<string, any>> | undefined;
+            type: "text";
+            text: string;
+        } | {
+            providerOptions?: Record<string, Record<string, any>> | undefined;
+            mimeType?: string | undefined;
+            type: "image";
+            image: string | ArrayBuffer;
+        } | {
+            providerOptions?: Record<string, Record<string, any>> | undefined;
+            type: "file";
+            mimeType: string;
+            data: string | ArrayBuffer;
+        })[];
+    } | {
+        providerOptions?: Record<string, Record<string, any>> | undefined;
+        role: "assistant";
+        content: string | ({
+            providerOptions?: Record<string, Record<string, any>> | undefined;
+            type: "text";
+            text: string;
+        } | {
+            providerOptions?: Record<string, Record<string, any>> | undefined;
+            type: "file";
+            mimeType: string;
+            data: string | ArrayBuffer;
+        } | {
+            providerOptions?: Record<string, Record<string, any>> | undefined;
+            signature?: string | undefined;
+            type: "reasoning";
+            text: string;
+        } | {
+            providerOptions?: Record<string, Record<string, any>> | undefined;
+            type: "redacted-reasoning";
+            data: string;
+        } | {
+            providerOptions?: Record<string, Record<string, any>> | undefined;
+            type: "tool-call";
+            toolCallId: string;
+            toolName: string;
+            args: any;
+        })[];
+    } | {
+        providerOptions?: Record<string, Record<string, any>> | undefined;
+        role: "tool";
+        content: {
+            providerOptions?: Record<string, Record<string, any>> | undefined;
+            args?: any;
+            experimental_content?: ({
+                type: "text";
+                text: string;
+            } | {
+                mimeType?: string | undefined;
+                type: "image";
+                data: string;
+            })[] | undefined;
+            isError?: boolean | undefined;
+            type: "tool-result";
+            toolCallId: string;
+            toolName: string;
+            result: any;
+        }[];
+    } | {
+        providerOptions?: Record<string, Record<string, any>> | undefined;
+        role: "system";
+        content: string;
+    } | undefined, [import("convex/values").VObject<{
+        providerOptions?: Record<string, Record<string, any>> | undefined;
+        role: "user";
+        content: string | ({
+            providerOptions?: Record<string, Record<string, any>> | undefined;
+            type: "text";
+            text: string;
+        } | {
+            providerOptions?: Record<string, Record<string, any>> | undefined;
+            mimeType?: string | undefined;
+            type: "image";
+            image: string | ArrayBuffer;
+        } | {
+            providerOptions?: Record<string, Record<string, any>> | undefined;
+            type: "file";
+            mimeType: string;
+            data: string | ArrayBuffer;
+        })[];
+    }, {
+        role: import("convex/values").VLiteral<"user", "required">;
+        content: import("convex/values").VUnion<string | ({
+            providerOptions?: Record<string, Record<string, any>> | undefined;
+            type: "text";
+            text: string;
+        } | {
+            providerOptions?: Record<string, Record<string, any>> | undefined;
+            mimeType?: string | undefined;
+            type: "image";
+            image: string | ArrayBuffer;
+        } | {
+            providerOptions?: Record<string, Record<string, any>> | undefined;
+            type: "file";
+            mimeType: string;
+            data: string | ArrayBuffer;
+        })[], [import("convex/values").VString<string, "required">, import("convex/values").VArray<({
+            providerOptions?: Record<string, Record<string, any>> | undefined;
+            type: "text";
+            text: string;
+        } | {
+            providerOptions?: Record<string, Record<string, any>> | undefined;
+            mimeType?: string | undefined;
+            type: "image";
+            image: string | ArrayBuffer;
+        } | {
+            providerOptions?: Record<string, Record<string, any>> | undefined;
+            type: "file";
+            mimeType: string;
+            data: string | ArrayBuffer;
+        })[], import("convex/values").VUnion<{
+            providerOptions?: Record<string, Record<string, any>> | undefined;
+            type: "text";
+            text: string;
+        } | {
+            providerOptions?: Record<string, Record<string, any>> | undefined;
+            mimeType?: string | undefined;
+            type: "image";
+            image: string | ArrayBuffer;
+        } | {
+            providerOptions?: Record<string, Record<string, any>> | undefined;
+            type: "file";
+            mimeType: string;
+            data: string | ArrayBuffer;
+        }, [import("convex/values").VObject<{
+            providerOptions?: Record<string, Record<string, any>> | undefined;
+            type: "text";
+            text: string;
+        }, {
+            type: import("convex/values").VLiteral<"text", "required">;
+            text: import("convex/values").VString<string, "required">;
+            providerOptions: import("convex/values").VRecord<Record<string, Record<string, any>> | undefined, import("convex/values").VString<string, "required">, import("convex/values").VRecord<Record<string, any>, import("convex/values").VString<string, "required">, import("convex/values").VAny<any, "required", string>, "required", string>, "optional", string>;
+        }, "required", "type" | "providerOptions" | "text" | `providerOptions.${string}`>, import("convex/values").VObject<{
+            providerOptions?: Record<string, Record<string, any>> | undefined;
+            mimeType?: string | undefined;
+            type: "image";
+            image: string | ArrayBuffer;
+        }, {
+            type: import("convex/values").VLiteral<"image", "required">;
+            image: import("convex/values").VUnion<string | ArrayBuffer, [import("convex/values").VString<string, "required">, import("convex/values").VBytes<ArrayBuffer, "required">], "required", never>;
+            mimeType: import("convex/values").VString<string | undefined, "optional">;
+            providerOptions: import("convex/values").VRecord<Record<string, Record<string, any>> | undefined, import("convex/values").VString<string, "required">, import("convex/values").VRecord<Record<string, any>, import("convex/values").VString<string, "required">, import("convex/values").VAny<any, "required", string>, "required", string>, "optional", string>;
+        }, "required", "type" | "providerOptions" | `providerOptions.${string}` | "image" | "mimeType">, import("convex/values").VObject<{
+            providerOptions?: Record<string, Record<string, any>> | undefined;
+            type: "file";
+            mimeType: string;
+            data: string | ArrayBuffer;
+        }, {
+            type: import("convex/values").VLiteral<"file", "required">;
+            data: import("convex/values").VUnion<string | ArrayBuffer, [import("convex/values").VString<string, "required">, import("convex/values").VBytes<ArrayBuffer, "required">], "required", never>;
+            mimeType: import("convex/values").VString<string, "required">;
+            providerOptions: import("convex/values").VRecord<Record<string, Record<string, any>> | undefined, import("convex/values").VString<string, "required">, import("convex/values").VRecord<Record<string, any>, import("convex/values").VString<string, "required">, import("convex/values").VAny<any, "required", string>, "required", string>, "optional", string>;
+        }, "required", "type" | "providerOptions" | `providerOptions.${string}` | "mimeType" | "data">], "required", "type" | "providerOptions" | "text" | `providerOptions.${string}` | "image" | "mimeType" | "data">, "required">], "required", never>;
+        providerOptions: import("convex/values").VRecord<Record<string, Record<string, any>> | undefined, import("convex/values").VString<string, "required">, import("convex/values").VRecord<Record<string, any>, import("convex/values").VString<string, "required">, import("convex/values").VAny<any, "required", string>, "required", string>, "optional", string>;
+    }, "required", "providerOptions" | "role" | `providerOptions.${string}` | "content">, import("convex/values").VObject<{
+        providerOptions?: Record<string, Record<string, any>> | undefined;
+        role: "assistant";
+        content: string | ({
+            providerOptions?: Record<string, Record<string, any>> | undefined;
+            type: "text";
+            text: string;
+        } | {
+            providerOptions?: Record<string, Record<string, any>> | undefined;
+            type: "file";
+            mimeType: string;
+            data: string | ArrayBuffer;
+        } | {
+            providerOptions?: Record<string, Record<string, any>> | undefined;
+            signature?: string | undefined;
+            type: "reasoning";
+            text: string;
+        } | {
+            providerOptions?: Record<string, Record<string, any>> | undefined;
+            type: "redacted-reasoning";
+            data: string;
+        } | {
+            providerOptions?: Record<string, Record<string, any>> | undefined;
+            type: "tool-call";
+            toolCallId: string;
+            toolName: string;
+            args: any;
+        })[];
+    }, {
+        role: import("convex/values").VLiteral<"assistant", "required">;
+        content: import("convex/values").VUnion<string | ({
+            providerOptions?: Record<string, Record<string, any>> | undefined;
+            type: "text";
+            text: string;
+        } | {
+            providerOptions?: Record<string, Record<string, any>> | undefined;
+            type: "file";
+            mimeType: string;
+            data: string | ArrayBuffer;
+        } | {
+            providerOptions?: Record<string, Record<string, any>> | undefined;
+            signature?: string | undefined;
+            type: "reasoning";
+            text: string;
+        } | {
+            providerOptions?: Record<string, Record<string, any>> | undefined;
+            type: "redacted-reasoning";
+            data: string;
+        } | {
+            providerOptions?: Record<string, Record<string, any>> | undefined;
+            type: "tool-call";
+            toolCallId: string;
+            toolName: string;
+            args: any;
+        })[], [import("convex/values").VString<string, "required">, import("convex/values").VArray<({
+            providerOptions?: Record<string, Record<string, any>> | undefined;
+            type: "text";
+            text: string;
+        } | {
+            providerOptions?: Record<string, Record<string, any>> | undefined;
+            type: "file";
+            mimeType: string;
+            data: string | ArrayBuffer;
+        } | {
+            providerOptions?: Record<string, Record<string, any>> | undefined;
+            signature?: string | undefined;
+            type: "reasoning";
+            text: string;
+        } | {
+            providerOptions?: Record<string, Record<string, any>> | undefined;
+            type: "redacted-reasoning";
+            data: string;
+        } | {
+            providerOptions?: Record<string, Record<string, any>> | undefined;
+            type: "tool-call";
+            toolCallId: string;
+            toolName: string;
+            args: any;
+        })[], import("convex/values").VUnion<{
+            providerOptions?: Record<string, Record<string, any>> | undefined;
+            type: "text";
+            text: string;
+        } | {
+            providerOptions?: Record<string, Record<string, any>> | undefined;
+            type: "file";
+            mimeType: string;
+            data: string | ArrayBuffer;
+        } | {
+            providerOptions?: Record<string, Record<string, any>> | undefined;
+            signature?: string | undefined;
+            type: "reasoning";
+            text: string;
+        } | {
+            providerOptions?: Record<string, Record<string, any>> | undefined;
+            type: "redacted-reasoning";
+            data: string;
+        } | {
+            providerOptions?: Record<string, Record<string, any>> | undefined;
+            type: "tool-call";
+            toolCallId: string;
+            toolName: string;
+            args: any;
+        }, [import("convex/values").VObject<{
+            providerOptions?: Record<string, Record<string, any>> | undefined;
+            type: "text";
+            text: string;
+        }, {
+            type: import("convex/values").VLiteral<"text", "required">;
+            text: import("convex/values").VString<string, "required">;
+            providerOptions: import("convex/values").VRecord<Record<string, Record<string, any>> | undefined, import("convex/values").VString<string, "required">, import("convex/values").VRecord<Record<string, any>, import("convex/values").VString<string, "required">, import("convex/values").VAny<any, "required", string>, "required", string>, "optional", string>;
+        }, "required", "type" | "providerOptions" | "text" | `providerOptions.${string}`>, import("convex/values").VObject<{
+            providerOptions?: Record<string, Record<string, any>> | undefined;
+            type: "file";
+            mimeType: string;
+            data: string | ArrayBuffer;
+        }, {
+            type: import("convex/values").VLiteral<"file", "required">;
+            data: import("convex/values").VUnion<string | ArrayBuffer, [import("convex/values").VString<string, "required">, import("convex/values").VBytes<ArrayBuffer, "required">], "required", never>;
+            mimeType: import("convex/values").VString<string, "required">;
+            providerOptions: import("convex/values").VRecord<Record<string, Record<string, any>> | undefined, import("convex/values").VString<string, "required">, import("convex/values").VRecord<Record<string, any>, import("convex/values").VString<string, "required">, import("convex/values").VAny<any, "required", string>, "required", string>, "optional", string>;
+        }, "required", "type" | "providerOptions" | `providerOptions.${string}` | "mimeType" | "data">, import("convex/values").VObject<{
+            providerOptions?: Record<string, Record<string, any>> | undefined;
+            signature?: string | undefined;
+            type: "reasoning";
+            text: string;
+        }, {
+            type: import("convex/values").VLiteral<"reasoning", "required">;
+            text: import("convex/values").VString<string, "required">;
+            signature: import("convex/values").VString<string | undefined, "optional">;
+            providerOptions: import("convex/values").VRecord<Record<string, Record<string, any>> | undefined, import("convex/values").VString<string, "required">, import("convex/values").VRecord<Record<string, any>, import("convex/values").VString<string, "required">, import("convex/values").VAny<any, "required", string>, "required", string>, "optional", string>;
+        }, "required", "type" | "providerOptions" | "text" | `providerOptions.${string}` | "signature">, import("convex/values").VObject<{
+            providerOptions?: Record<string, Record<string, any>> | undefined;
+            type: "redacted-reasoning";
+            data: string;
+        }, {
+            type: import("convex/values").VLiteral<"redacted-reasoning", "required">;
+            data: import("convex/values").VString<string, "required">;
+            providerOptions: import("convex/values").VRecord<Record<string, Record<string, any>> | undefined, import("convex/values").VString<string, "required">, import("convex/values").VRecord<Record<string, any>, import("convex/values").VString<string, "required">, import("convex/values").VAny<any, "required", string>, "required", string>, "optional", string>;
+        }, "required", "type" | "providerOptions" | `providerOptions.${string}` | "data">, import("convex/values").VObject<{
+            providerOptions?: Record<string, Record<string, any>> | undefined;
+            type: "tool-call";
+            toolCallId: string;
+            toolName: string;
+            args: any;
+        }, {
+            type: import("convex/values").VLiteral<"tool-call", "required">;
+            toolCallId: import("convex/values").VString<string, "required">;
+            toolName: import("convex/values").VString<string, "required">;
+            args: import("convex/values").VAny<any, "required", string>;
+            providerOptions: import("convex/values").VRecord<Record<string, Record<string, any>> | undefined, import("convex/values").VString<string, "required">, import("convex/values").VRecord<Record<string, any>, import("convex/values").VString<string, "required">, import("convex/values").VAny<any, "required", string>, "required", string>, "optional", string>;
+        }, "required", "type" | "providerOptions" | `providerOptions.${string}` | "toolCallId" | "toolName" | "args" | `args.${string}`>], "required", "type" | "providerOptions" | "text" | `providerOptions.${string}` | "mimeType" | "data" | "signature" | "toolCallId" | "toolName" | "args" | `args.${string}`>, "required">], "required", never>;
+        providerOptions: import("convex/values").VRecord<Record<string, Record<string, any>> | undefined, import("convex/values").VString<string, "required">, import("convex/values").VRecord<Record<string, any>, import("convex/values").VString<string, "required">, import("convex/values").VAny<any, "required", string>, "required", string>, "optional", string>;
+    }, "required", "providerOptions" | "role" | `providerOptions.${string}` | "content">, import("convex/values").VObject<{
+        providerOptions?: Record<string, Record<string, any>> | undefined;
+        role: "tool";
+        content: {
+            providerOptions?: Record<string, Record<string, any>> | undefined;
+            args?: any;
+            experimental_content?: ({
+                type: "text";
+                text: string;
+            } | {
+                mimeType?: string | undefined;
+                type: "image";
+                data: string;
+            })[] | undefined;
+            isError?: boolean | undefined;
+            type: "tool-result";
+            toolCallId: string;
+            toolName: string;
+            result: any;
+        }[];
+    }, {
+        role: import("convex/values").VLiteral<"tool", "required">;
+        content: import("convex/values").VArray<{
+            providerOptions?: Record<string, Record<string, any>> | undefined;
+            args?: any;
+            experimental_content?: ({
+                type: "text";
+                text: string;
+            } | {
+                mimeType?: string | undefined;
+                type: "image";
+                data: string;
+            })[] | undefined;
+            isError?: boolean | undefined;
+            type: "tool-result";
+            toolCallId: string;
+            toolName: string;
+            result: any;
+        }[], import("convex/values").VObject<{
+            providerOptions?: Record<string, Record<string, any>> | undefined;
+            args?: any;
+            experimental_content?: ({
+                type: "text";
+                text: string;
+            } | {
+                mimeType?: string | undefined;
+                type: "image";
+                data: string;
+            })[] | undefined;
+            isError?: boolean | undefined;
+            type: "tool-result";
+            toolCallId: string;
+            toolName: string;
+            result: any;
+        }, {
+            type: import("convex/values").VLiteral<"tool-result", "required">;
+            toolCallId: import("convex/values").VString<string, "required">;
+            toolName: import("convex/values").VString<string, "required">;
+            result: import("convex/values").VAny<any, "required", string>;
+            args: import("convex/values").VAny<any, "optional", string>;
+            experimental_content: import("convex/values").VArray<({
+                type: "text";
+                text: string;
+            } | {
+                mimeType?: string | undefined;
+                type: "image";
+                data: string;
+            })[] | undefined, import("convex/values").VUnion<{
+                type: "text";
+                text: string;
+            } | {
+                mimeType?: string | undefined;
+                type: "image";
+                data: string;
+            }, [import("convex/values").VObject<{
+                type: "text";
+                text: string;
+            }, {
+                type: import("convex/values").VLiteral<"text", "required">;
+                text: import("convex/values").VString<string, "required">;
+            }, "required", "type" | "text">, import("convex/values").VObject<{
+                mimeType?: string | undefined;
+                type: "image";
+                data: string;
+            }, {
+                type: import("convex/values").VLiteral<"image", "required">;
+                data: import("convex/values").VString<string, "required">;
+                mimeType: import("convex/values").VString<string | undefined, "optional">;
+            }, "required", "type" | "mimeType" | "data">], "required", "type" | "text" | "mimeType" | "data">, "optional">;
+            isError: import("convex/values").VBoolean<boolean | undefined, "optional">;
+            providerOptions: import("convex/values").VRecord<Record<string, Record<string, any>> | undefined, import("convex/values").VString<string, "required">, import("convex/values").VRecord<Record<string, any>, import("convex/values").VString<string, "required">, import("convex/values").VAny<any, "required", string>, "required", string>, "optional", string>;
+        }, "required", "type" | "providerOptions" | `providerOptions.${string}` | "toolCallId" | "toolName" | "args" | `args.${string}` | "result" | "experimental_content" | "isError" | `result.${string}`>, "required">;
+        providerOptions: import("convex/values").VRecord<Record<string, Record<string, any>> | undefined, import("convex/values").VString<string, "required">, import("convex/values").VRecord<Record<string, any>, import("convex/values").VString<string, "required">, import("convex/values").VAny<any, "required", string>, "required", string>, "optional", string>;
+    }, "required", "providerOptions" | "role" | `providerOptions.${string}` | "content">, import("convex/values").VObject<{
+        providerOptions?: Record<string, Record<string, any>> | undefined;
+        role: "system";
+        content: string;
+    }, {
+        role: import("convex/values").VLiteral<"system", "required">;
+        content: import("convex/values").VString<string, "required">;
+        providerOptions: import("convex/values").VRecord<Record<string, Record<string, any>> | undefined, import("convex/values").VString<string, "required">, import("convex/values").VRecord<Record<string, any>, import("convex/values").VString<string, "required">, import("convex/values").VAny<any, "required", string>, "required", string>, "optional", string>;
+    }, "required", "providerOptions" | "role" | `providerOptions.${string}` | "content">], "optional", "providerOptions" | "role" | `providerOptions.${string}` | "content">;
+    tool: import("convex/values").VBoolean<boolean, "required">;
+    text: import("convex/values").VString<string | undefined, "optional">;
+    usage: import("convex/values").VObject<{
+        promptTokens: number;
+        completionTokens: number;
+        totalTokens: number;
+    } | undefined, {
+        promptTokens: import("convex/values").VFloat64<number, "required">;
+        completionTokens: import("convex/values").VFloat64<number, "required">;
+        totalTokens: import("convex/values").VFloat64<number, "required">;
+    }, "optional", "promptTokens" | "completionTokens" | "totalTokens">;
+    providerMetadata: import("convex/values").VRecord<Record<string, Record<string, any>> | undefined, import("convex/values").VString<string, "required">, import("convex/values").VRecord<Record<string, any>, import("convex/values").VString<string, "required">, import("convex/values").VAny<any, "required", string>, "required", string>, "optional", string>;
+    sources: import("convex/values").VArray<{
+        title?: string | undefined;
+        providerOptions?: Record<string, Record<string, any>> | undefined;
+        id: string;
+        url: string;
+        sourceType: "url";
+    }[] | undefined, import("convex/values").VObject<{
+        title?: string | undefined;
+        providerOptions?: Record<string, Record<string, any>> | undefined;
+        id: string;
+        url: string;
+        sourceType: "url";
+    }, {
+        sourceType: import("convex/values").VLiteral<"url", "required">;
+        id: import("convex/values").VString<string, "required">;
+        url: import("convex/values").VString<string, "required">;
+        title: import("convex/values").VString<string | undefined, "optional">;
+        providerOptions: import("convex/values").VRecord<Record<string, Record<string, any>> | undefined, import("convex/values").VString<string, "required">, import("convex/values").VRecord<Record<string, any>, import("convex/values").VString<string, "required">, import("convex/values").VAny<any, "required", string>, "required", string>, "optional", string>;
+    }, "required", "id" | "title" | "providerOptions" | `providerOptions.${string}` | "url" | "sourceType">, "optional">;
+    reasoning: import("convex/values").VString<string | undefined, "optional">;
+    reasoningDetails: import("convex/values").VArray<({
+        signature?: string | undefined;
+        type: "text";
+        text: string;
+    } | {
+        type: "redacted";
+        data: string;
+    })[] | undefined, import("convex/values").VUnion<{
+        signature?: string | undefined;
+        type: "text";
+        text: string;
+    } | {
+        type: "redacted";
+        data: string;
+    }, [import("convex/values").VObject<{
+        signature?: string | undefined;
+        type: "text";
+        text: string;
+    }, {
+        type: import("convex/values").VLiteral<"text", "required">;
+        text: import("convex/values").VString<string, "required">;
+        signature: import("convex/values").VString<string | undefined, "optional">;
+    }, "required", "type" | "text" | "signature">, import("convex/values").VObject<{
+        type: "redacted";
+        data: string;
+    }, {
+        type: import("convex/values").VLiteral<"redacted", "required">;
+        data: import("convex/values").VString<string, "required">;
+    }, "required", "type" | "data">], "required", "type" | "text" | "data" | "signature">, "optional">;
+    warnings: import("convex/values").VArray<({
+        details?: string | undefined;
+        type: "unsupported-setting";
+        setting: string;
+    } | {
+        details?: string | undefined;
+        type: "unsupported-tool";
+        tool: any;
+    } | {
+        type: "other";
+        message: string;
+    })[] | undefined, import("convex/values").VUnion<{
+        details?: string | undefined;
+        type: "unsupported-setting";
+        setting: string;
+    } | {
+        details?: string | undefined;
+        type: "unsupported-tool";
+        tool: any;
+    } | {
+        type: "other";
+        message: string;
+    }, [import("convex/values").VObject<{
+        details?: string | undefined;
+        type: "unsupported-setting";
+        setting: string;
+    }, {
+        type: import("convex/values").VLiteral<"unsupported-setting", "required">;
+        setting: import("convex/values").VString<string, "required">;
+        details: import("convex/values").VString<string | undefined, "optional">;
+    }, "required", "type" | "setting" | "details">, import("convex/values").VObject<{
+        details?: string | undefined;
+        type: "unsupported-tool";
+        tool: any;
+    }, {
+        type: import("convex/values").VLiteral<"unsupported-tool", "required">;
+        tool: import("convex/values").VAny<any, "required", string>;
+        details: import("convex/values").VString<string | undefined, "optional">;
+    }, "required", "type" | "tool" | "details" | `tool.${string}`>, import("convex/values").VObject<{
+        type: "other";
+        message: string;
+    }, {
+        type: import("convex/values").VLiteral<"other", "required">;
+        message: import("convex/values").VString<string, "required">;
+    }, "required", "type" | "message">], "required", "type" | "message" | "tool" | "setting" | "details" | `tool.${string}`>, "optional">;
+    finishReason: import("convex/values").VUnion<"length" | "error" | "other" | "stop" | "content-filter" | "tool-calls" | "unknown" | undefined, [import("convex/values").VLiteral<"stop", "required">, import("convex/values").VLiteral<"length", "required">, import("convex/values").VLiteral<"content-filter", "required">, import("convex/values").VLiteral<"tool-calls", "required">, import("convex/values").VLiteral<"error", "required">, import("convex/values").VLiteral<"other", "required">, import("convex/values").VLiteral<"unknown", "required">], "optional", never>;
+    _id: import("convex/values").VString<string, "required">;
+    _creationTime: import("convex/values").VFloat64<number, "required">;
+}, "required", "id" | "status" | "userId" | "order" | "_creationTime" | "threadId" | "parentMessageId" | "stepId" | "stepOrder" | "embeddingId" | "error" | "agentName" | "model" | "provider" | "providerOptions" | "message" | "text" | `providerOptions.${string}` | "reasoning" | "tool" | "files" | "usage" | "providerMetadata" | "sources" | "reasoningDetails" | "warnings" | "finishReason" | "message.providerOptions" | "message.role" | `message.providerOptions.${string}` | "message.content" | "usage.promptTokens" | "usage.completionTokens" | "usage.totalTokens" | `providerMetadata.${string}` | "_id">;
+export type MessageDoc = Infer<typeof vMessageDoc>;
+type MessageWithMetadata = OpaqueIds<InnerMessageWithMetadata>;
+export declare function toUIMessages(messages: MessageDoc[]): UIMessage[];
 //# sourceMappingURL=index.d.ts.map