@convex-dev/agent
Version:
A agent component for Convex.
1,145 lines • 164 kB
TypeScript
import type { Doc, Id } from "./_generated/dataModel.js";
import { type MutationCtx, type QueryCtx } from "./_generated/server.js";
export declare function deleteMessage(ctx: MutationCtx, messageDoc: Doc<"messages">): Promise<void>;
export declare const deleteByIds: import("convex/server").RegisteredMutation<"public", {
messageIds: import("convex/values").GenericId<"messages">[];
}, Promise<import("convex/values").GenericId<"messages">[]>>;
export declare const messageStatuses: ("pending" | "success" | "failed")[];
export declare const deleteByOrder: import("convex/server").RegisteredMutation<"public", {
endStepOrder?: number | undefined;
startStepOrder?: number | undefined;
threadId: import("convex/values").GenericId<"threads">;
startOrder: number;
endOrder: number;
}, Promise<{
isDone: boolean;
lastOrder?: number;
lastStepOrder?: number;
}>>;
export declare const addMessages: import("convex/server").RegisteredMutation<"public", {
userId?: string | undefined;
agentName?: string | undefined;
promptMessageId?: import("convex/values").GenericId<"messages"> | undefined;
embeddings?: {
model: string;
dimension: 128 | 256 | 512 | 768 | 1024 | 1408 | 1536 | 2048 | 3072 | 4096;
vectors: (number[] | null)[];
} | undefined;
failPendingSteps?: boolean | undefined;
finishStreamId?: import("convex/values").GenericId<"streamingMessages"> | undefined;
hideFromUserIdSearch?: boolean | undefined;
pendingMessageId?: import("convex/values").GenericId<"messages"> | undefined;
threadId: import("convex/values").GenericId<"threads">;
messages: {
status?: "pending" | "success" | "failed" | undefined;
fileIds?: import("convex/values").GenericId<"files">[] | undefined;
error?: string | undefined;
model?: string | undefined;
provider?: string | undefined;
text?: string | undefined;
providerMetadata?: Record<string, Record<string, any>> | undefined;
reasoning?: string | undefined;
usage?: {
reasoningTokens?: number | undefined;
cachedInputTokens?: number | undefined;
promptTokens: number;
completionTokens: number;
totalTokens: number;
} | undefined;
sources?: ({
title?: string | undefined;
type?: "source" | undefined;
providerOptions?: Record<string, Record<string, any>> | undefined;
providerMetadata?: Record<string, Record<string, any>> | undefined;
id: string;
url: string;
sourceType: "url";
} | {
providerOptions?: Record<string, Record<string, any>> | undefined;
providerMetadata?: Record<string, Record<string, any>> | undefined;
filename?: string | undefined;
id: string;
title: string;
type: "source";
mediaType: string;
sourceType: "document";
})[] | undefined;
warnings?: ({
details?: string | undefined;
type: "unsupported-setting";
setting: string;
} | {
details?: string | undefined;
type: "unsupported-tool";
tool: any;
} | {
type: "other";
message: string;
})[] | undefined;
finishReason?: "error" | "length" | "other" | "stop" | "content-filter" | "tool-calls" | "unknown" | undefined;
reasoningDetails?: ({
providerOptions?: Record<string, Record<string, any>> | undefined;
providerMetadata?: Record<string, Record<string, any>> | undefined;
signature?: string | undefined;
type: "reasoning";
text: string;
} | {
signature?: string | undefined;
type: "text";
text: string;
} | {
type: "redacted";
data: string;
})[] | undefined;
message: {
providerOptions?: Record<string, Record<string, any>> | undefined;
role: "user";
content: string | ({
providerOptions?: Record<string, Record<string, any>> | undefined;
providerMetadata?: Record<string, Record<string, any>> | undefined;
type: "text";
text: string;
} | {
providerOptions?: Record<string, Record<string, any>> | undefined;
mediaType?: string | undefined;
mimeType?: string | undefined;
type: "image";
image: string | ArrayBuffer;
} | {
providerOptions?: Record<string, Record<string, any>> | undefined;
providerMetadata?: Record<string, Record<string, any>> | undefined;
mediaType?: string | undefined;
mimeType?: string | undefined;
filename?: string | undefined;
type: "file";
data: string | ArrayBuffer;
})[];
} | {
providerOptions?: Record<string, Record<string, any>> | undefined;
role: "assistant";
content: string | ({
providerOptions?: Record<string, Record<string, any>> | undefined;
providerMetadata?: Record<string, Record<string, any>> | undefined;
type: "text";
text: string;
} | {
providerOptions?: Record<string, Record<string, any>> | undefined;
providerMetadata?: Record<string, Record<string, any>> | undefined;
mediaType?: string | undefined;
mimeType?: string | undefined;
filename?: string | undefined;
type: "file";
data: string | ArrayBuffer;
} | {
providerOptions?: Record<string, Record<string, any>> | undefined;
providerMetadata?: Record<string, Record<string, any>> | undefined;
signature?: string | undefined;
type: "reasoning";
text: string;
} | {
providerOptions?: Record<string, Record<string, any>> | undefined;
providerMetadata?: Record<string, Record<string, any>> | undefined;
type: "redacted-reasoning";
data: string;
} | {
providerOptions?: Record<string, Record<string, any>> | undefined;
providerMetadata?: Record<string, Record<string, any>> | undefined;
args?: any;
providerExecuted?: boolean | undefined;
type: "tool-call";
toolCallId: string;
toolName: string;
input: any;
} | {
providerOptions?: Record<string, Record<string, any>> | undefined;
providerMetadata?: Record<string, Record<string, any>> | undefined;
input?: any;
providerExecuted?: boolean | undefined;
type: "tool-call";
toolCallId: string;
toolName: string;
args: any;
} | {
providerOptions?: Record<string, Record<string, any>> | undefined;
providerMetadata?: Record<string, Record<string, any>> | undefined;
args?: any;
providerExecuted?: boolean | undefined;
output?: {
providerOptions?: Record<string, Record<string, any>> | undefined;
type: "text";
value: string;
} | {
providerOptions?: Record<string, Record<string, any>> | undefined;
type: "json";
value: any;
} | {
providerOptions?: Record<string, Record<string, any>> | undefined;
type: "error-text";
value: string;
} | {
providerOptions?: Record<string, Record<string, any>> | undefined;
type: "error-json";
value: any;
} | {
providerOptions?: Record<string, Record<string, any>> | undefined;
reason?: string | undefined;
type: "execution-denied";
} | {
type: "content";
value: ({
providerOptions?: Record<string, Record<string, any>> | undefined;
type: "text";
text: string;
} | {
type: "media";
mediaType: string;
data: string;
} | {
providerOptions?: Record<string, Record<string, any>> | undefined;
filename?: string | undefined;
type: "file-data";
mediaType: string;
data: string;
} | {
providerOptions?: Record<string, Record<string, any>> | undefined;
type: "file-url";
url: string;
} | {
providerOptions?: Record<string, Record<string, any>> | undefined;
type: "file-id";
fileId: string | Record<string, string>;
} | {
providerOptions?: Record<string, Record<string, any>> | undefined;
type: "image-data";
mediaType: string;
data: string;
} | {
providerOptions?: Record<string, Record<string, any>> | undefined;
type: "image-url";
url: string;
} | {
providerOptions?: Record<string, Record<string, any>> | undefined;
type: "image-file-id";
fileId: string | Record<string, string>;
} | {
providerOptions?: Record<string, Record<string, any>> | undefined;
type: "custom";
})[];
} | undefined;
result?: any;
isError?: boolean | undefined;
experimental_content?: ({
type: "text";
text: string;
} | {
mimeType?: string | undefined;
type: "image";
data: string;
})[] | undefined;
type: "tool-result";
toolCallId: string;
toolName: string;
} | {
title?: string | undefined;
providerOptions?: Record<string, Record<string, any>> | undefined;
providerMetadata?: Record<string, Record<string, any>> | undefined;
id: string;
type: "source";
url: string;
sourceType: "url";
} | {
providerOptions?: Record<string, Record<string, any>> | undefined;
providerMetadata?: Record<string, Record<string, any>> | undefined;
filename?: string | undefined;
id: string;
title: string;
type: "source";
mediaType: string;
sourceType: "document";
} | {
providerOptions?: Record<string, Record<string, any>> | undefined;
providerMetadata?: Record<string, Record<string, any>> | undefined;
type: "tool-approval-request";
toolCallId: string;
approvalId: string;
})[];
} | {
providerOptions?: Record<string, Record<string, any>> | undefined;
role: "tool";
content: ({
providerOptions?: Record<string, Record<string, any>> | undefined;
providerMetadata?: Record<string, Record<string, any>> | undefined;
args?: any;
providerExecuted?: boolean | undefined;
output?: {
providerOptions?: Record<string, Record<string, any>> | undefined;
type: "text";
value: string;
} | {
providerOptions?: Record<string, Record<string, any>> | undefined;
type: "json";
value: any;
} | {
providerOptions?: Record<string, Record<string, any>> | undefined;
type: "error-text";
value: string;
} | {
providerOptions?: Record<string, Record<string, any>> | undefined;
type: "error-json";
value: any;
} | {
providerOptions?: Record<string, Record<string, any>> | undefined;
reason?: string | undefined;
type: "execution-denied";
} | {
type: "content";
value: ({
providerOptions?: Record<string, Record<string, any>> | undefined;
type: "text";
text: string;
} | {
type: "media";
mediaType: string;
data: string;
} | {
providerOptions?: Record<string, Record<string, any>> | undefined;
filename?: string | undefined;
type: "file-data";
mediaType: string;
data: string;
} | {
providerOptions?: Record<string, Record<string, any>> | undefined;
type: "file-url";
url: string;
} | {
providerOptions?: Record<string, Record<string, any>> | undefined;
type: "file-id";
fileId: string | Record<string, string>;
} | {
providerOptions?: Record<string, Record<string, any>> | undefined;
type: "image-data";
mediaType: string;
data: string;
} | {
providerOptions?: Record<string, Record<string, any>> | undefined;
type: "image-url";
url: string;
} | {
providerOptions?: Record<string, Record<string, any>> | undefined;
type: "image-file-id";
fileId: string | Record<string, string>;
} | {
providerOptions?: Record<string, Record<string, any>> | undefined;
type: "custom";
})[];
} | undefined;
result?: any;
isError?: boolean | undefined;
experimental_content?: ({
type: "text";
text: string;
} | {
mimeType?: string | undefined;
type: "image";
data: string;
})[] | undefined;
type: "tool-result";
toolCallId: string;
toolName: string;
} | {
providerOptions?: Record<string, Record<string, any>> | undefined;
providerMetadata?: Record<string, Record<string, any>> | undefined;
providerExecuted?: boolean | undefined;
reason?: string | undefined;
type: "tool-approval-response";
approvalId: string;
approved: boolean;
})[];
} | {
providerOptions?: Record<string, Record<string, any>> | undefined;
role: "system";
content: string;
};
}[];
}, Promise<{
messages: {
id?: string | undefined;
userId?: string | undefined;
embeddingId?: string | undefined;
fileIds?: 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;
providerMetadata?: Record<string, Record<string, any>> | undefined;
type: "text";
text: string;
} | {
providerOptions?: Record<string, Record<string, any>> | undefined;
mediaType?: string | undefined;
mimeType?: string | undefined;
type: "image";
image: string | ArrayBuffer;
} | {
providerOptions?: Record<string, Record<string, any>> | undefined;
providerMetadata?: Record<string, Record<string, any>> | undefined;
mediaType?: string | undefined;
mimeType?: string | undefined;
filename?: string | undefined;
type: "file";
data: string | ArrayBuffer;
})[];
} | {
providerOptions?: Record<string, Record<string, any>> | undefined;
role: "assistant";
content: string | ({
providerOptions?: Record<string, Record<string, any>> | undefined;
providerMetadata?: Record<string, Record<string, any>> | undefined;
type: "text";
text: string;
} | {
providerOptions?: Record<string, Record<string, any>> | undefined;
providerMetadata?: Record<string, Record<string, any>> | undefined;
mediaType?: string | undefined;
mimeType?: string | undefined;
filename?: string | undefined;
type: "file";
data: string | ArrayBuffer;
} | {
providerOptions?: Record<string, Record<string, any>> | undefined;
providerMetadata?: Record<string, Record<string, any>> | undefined;
signature?: string | undefined;
type: "reasoning";
text: string;
} | {
providerOptions?: Record<string, Record<string, any>> | undefined;
providerMetadata?: Record<string, Record<string, any>> | undefined;
type: "redacted-reasoning";
data: string;
} | {
providerOptions?: Record<string, Record<string, any>> | undefined;
providerMetadata?: Record<string, Record<string, any>> | undefined;
args?: any;
providerExecuted?: boolean | undefined;
type: "tool-call";
toolCallId: string;
toolName: string;
input: any;
} | {
providerOptions?: Record<string, Record<string, any>> | undefined;
providerMetadata?: Record<string, Record<string, any>> | undefined;
input?: any;
providerExecuted?: boolean | undefined;
type: "tool-call";
toolCallId: string;
toolName: string;
args: any;
} | {
providerOptions?: Record<string, Record<string, any>> | undefined;
providerMetadata?: Record<string, Record<string, any>> | undefined;
args?: any;
providerExecuted?: boolean | undefined;
output?: {
providerOptions?: Record<string, Record<string, any>> | undefined;
type: "text";
value: string;
} | {
providerOptions?: Record<string, Record<string, any>> | undefined;
type: "json";
value: any;
} | {
providerOptions?: Record<string, Record<string, any>> | undefined;
type: "error-text";
value: string;
} | {
providerOptions?: Record<string, Record<string, any>> | undefined;
type: "error-json";
value: any;
} | {
providerOptions?: Record<string, Record<string, any>> | undefined;
reason?: string | undefined;
type: "execution-denied";
} | {
type: "content";
value: ({
providerOptions?: Record<string, Record<string, any>> | undefined;
type: "text";
text: string;
} | {
type: "media";
mediaType: string;
data: string;
} | {
providerOptions?: Record<string, Record<string, any>> | undefined;
filename?: string | undefined;
type: "file-data";
mediaType: string;
data: string;
} | {
providerOptions?: Record<string, Record<string, any>> | undefined;
type: "file-url";
url: string;
} | {
providerOptions?: Record<string, Record<string, any>> | undefined;
type: "file-id";
fileId: string | Record<string, string>;
} | {
providerOptions?: Record<string, Record<string, any>> | undefined;
type: "image-data";
mediaType: string;
data: string;
} | {
providerOptions?: Record<string, Record<string, any>> | undefined;
type: "image-url";
url: string;
} | {
providerOptions?: Record<string, Record<string, any>> | undefined;
type: "image-file-id";
fileId: string | Record<string, string>;
} | {
providerOptions?: Record<string, Record<string, any>> | undefined;
type: "custom";
})[];
} | undefined;
result?: any;
isError?: boolean | undefined;
experimental_content?: ({
type: "text";
text: string;
} | {
mimeType?: string | undefined;
type: "image";
data: string;
})[] | undefined;
type: "tool-result";
toolCallId: string;
toolName: string;
} | {
title?: string | undefined;
providerOptions?: Record<string, Record<string, any>> | undefined;
providerMetadata?: Record<string, Record<string, any>> | undefined;
id: string;
type: "source";
url: string;
sourceType: "url";
} | {
providerOptions?: Record<string, Record<string, any>> | undefined;
providerMetadata?: Record<string, Record<string, any>> | undefined;
filename?: string | undefined;
id: string;
title: string;
type: "source";
mediaType: string;
sourceType: "document";
} | {
providerOptions?: Record<string, Record<string, any>> | undefined;
providerMetadata?: Record<string, Record<string, any>> | undefined;
type: "tool-approval-request";
toolCallId: string;
approvalId: string;
})[];
} | {
providerOptions?: Record<string, Record<string, any>> | undefined;
role: "tool";
content: ({
providerOptions?: Record<string, Record<string, any>> | undefined;
providerMetadata?: Record<string, Record<string, any>> | undefined;
args?: any;
providerExecuted?: boolean | undefined;
output?: {
providerOptions?: Record<string, Record<string, any>> | undefined;
type: "text";
value: string;
} | {
providerOptions?: Record<string, Record<string, any>> | undefined;
type: "json";
value: any;
} | {
providerOptions?: Record<string, Record<string, any>> | undefined;
type: "error-text";
value: string;
} | {
providerOptions?: Record<string, Record<string, any>> | undefined;
type: "error-json";
value: any;
} | {
providerOptions?: Record<string, Record<string, any>> | undefined;
reason?: string | undefined;
type: "execution-denied";
} | {
type: "content";
value: ({
providerOptions?: Record<string, Record<string, any>> | undefined;
type: "text";
text: string;
} | {
type: "media";
mediaType: string;
data: string;
} | {
providerOptions?: Record<string, Record<string, any>> | undefined;
filename?: string | undefined;
type: "file-data";
mediaType: string;
data: string;
} | {
providerOptions?: Record<string, Record<string, any>> | undefined;
type: "file-url";
url: string;
} | {
providerOptions?: Record<string, Record<string, any>> | undefined;
type: "file-id";
fileId: string | Record<string, string>;
} | {
providerOptions?: Record<string, Record<string, any>> | undefined;
type: "image-data";
mediaType: string;
data: string;
} | {
providerOptions?: Record<string, Record<string, any>> | undefined;
type: "image-url";
url: string;
} | {
providerOptions?: Record<string, Record<string, any>> | undefined;
type: "image-file-id";
fileId: string | Record<string, string>;
} | {
providerOptions?: Record<string, Record<string, any>> | undefined;
type: "custom";
})[];
} | undefined;
result?: any;
isError?: boolean | undefined;
experimental_content?: ({
type: "text";
text: string;
} | {
mimeType?: string | undefined;
type: "image";
data: string;
})[] | undefined;
type: "tool-result";
toolCallId: string;
toolName: string;
} | {
providerOptions?: Record<string, Record<string, any>> | undefined;
providerMetadata?: Record<string, Record<string, any>> | undefined;
providerExecuted?: boolean | undefined;
reason?: string | undefined;
type: "tool-approval-response";
approvalId: string;
approved: boolean;
})[];
} | {
providerOptions?: Record<string, Record<string, any>> | undefined;
role: "system";
content: string;
} | undefined;
text?: string | undefined;
providerMetadata?: Record<string, Record<string, any>> | undefined;
reasoning?: string | undefined;
usage?: {
reasoningTokens?: number | undefined;
cachedInputTokens?: number | undefined;
promptTokens: number;
completionTokens: number;
totalTokens: number;
} | undefined;
sources?: ({
title?: string | undefined;
type?: "source" | undefined;
providerOptions?: Record<string, Record<string, any>> | undefined;
providerMetadata?: Record<string, Record<string, any>> | undefined;
id: string;
url: string;
sourceType: "url";
} | {
providerOptions?: Record<string, Record<string, any>> | undefined;
providerMetadata?: Record<string, Record<string, any>> | undefined;
filename?: string | undefined;
id: string;
title: string;
type: "source";
mediaType: string;
sourceType: "document";
})[] | undefined;
warnings?: ({
details?: string | undefined;
type: "unsupported-setting";
setting: string;
} | {
details?: string | undefined;
type: "unsupported-tool";
tool: any;
} | {
type: "other";
message: string;
})[] | undefined;
finishReason?: "error" | "length" | "other" | "stop" | "content-filter" | "tool-calls" | "unknown" | undefined;
reasoningDetails?: ({
providerOptions?: Record<string, Record<string, any>> | undefined;
providerMetadata?: Record<string, Record<string, any>> | undefined;
signature?: string | undefined;
type: "reasoning";
text: string;
} | {
signature?: string | undefined;
type: "text";
text: string;
} | {
type: "redacted";
data: string;
})[] | undefined;
status: "pending" | "success" | "failed";
order: number;
_creationTime: number;
threadId: string;
stepOrder: number;
tool: boolean;
_id: string;
}[];
}>>;
export declare function getMaxMessage(ctx: QueryCtx, threadId: Id<"threads">, order?: number): Promise<{
_id: import("convex/values").GenericId<"messages">;
_creationTime: number;
id?: string | undefined;
userId?: string | undefined;
embeddingId?: import("convex/values").GenericId<"embeddings_128" | "embeddings_256" | "embeddings_512" | "embeddings_768" | "embeddings_1024" | "embeddings_1408" | "embeddings_1536" | "embeddings_2048" | "embeddings_3072" | "embeddings_4096"> | undefined;
fileIds?: import("convex/values").GenericId<"files">[] | undefined;
files?: any[] | 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;
providerMetadata?: Record<string, Record<string, any>> | undefined;
type: "text";
text: string;
} | {
providerOptions?: Record<string, Record<string, any>> | undefined;
mediaType?: string | undefined;
mimeType?: string | undefined;
type: "image";
image: string | ArrayBuffer;
} | {
providerOptions?: Record<string, Record<string, any>> | undefined;
providerMetadata?: Record<string, Record<string, any>> | undefined;
mediaType?: string | undefined;
mimeType?: string | undefined;
filename?: string | undefined;
type: "file";
data: string | ArrayBuffer;
})[];
} | {
providerOptions?: Record<string, Record<string, any>> | undefined;
role: "assistant";
content: string | ({
providerOptions?: Record<string, Record<string, any>> | undefined;
providerMetadata?: Record<string, Record<string, any>> | undefined;
type: "text";
text: string;
} | {
providerOptions?: Record<string, Record<string, any>> | undefined;
providerMetadata?: Record<string, Record<string, any>> | undefined;
mediaType?: string | undefined;
mimeType?: string | undefined;
filename?: string | undefined;
type: "file";
data: string | ArrayBuffer;
} | {
providerOptions?: Record<string, Record<string, any>> | undefined;
providerMetadata?: Record<string, Record<string, any>> | undefined;
signature?: string | undefined;
type: "reasoning";
text: string;
} | {
providerOptions?: Record<string, Record<string, any>> | undefined;
providerMetadata?: Record<string, Record<string, any>> | undefined;
type: "redacted-reasoning";
data: string;
} | {
providerOptions?: Record<string, Record<string, any>> | undefined;
providerMetadata?: Record<string, Record<string, any>> | undefined;
args?: any;
providerExecuted?: boolean | undefined;
type: "tool-call";
toolCallId: string;
toolName: string;
input: any;
} | {
providerOptions?: Record<string, Record<string, any>> | undefined;
providerMetadata?: Record<string, Record<string, any>> | undefined;
input?: any;
providerExecuted?: boolean | undefined;
type: "tool-call";
toolCallId: string;
toolName: string;
args: any;
} | {
providerOptions?: Record<string, Record<string, any>> | undefined;
providerMetadata?: Record<string, Record<string, any>> | undefined;
args?: any;
providerExecuted?: boolean | undefined;
output?: {
providerOptions?: Record<string, Record<string, any>> | undefined;
type: "text";
value: string;
} | {
providerOptions?: Record<string, Record<string, any>> | undefined;
type: "json";
value: any;
} | {
providerOptions?: Record<string, Record<string, any>> | undefined;
type: "error-text";
value: string;
} | {
providerOptions?: Record<string, Record<string, any>> | undefined;
type: "error-json";
value: any;
} | {
providerOptions?: Record<string, Record<string, any>> | undefined;
reason?: string | undefined;
type: "execution-denied";
} | {
type: "content";
value: ({
providerOptions?: Record<string, Record<string, any>> | undefined;
type: "text";
text: string;
} | {
type: "media";
mediaType: string;
data: string;
} | {
providerOptions?: Record<string, Record<string, any>> | undefined;
filename?: string | undefined;
type: "file-data";
mediaType: string;
data: string;
} | {
providerOptions?: Record<string, Record<string, any>> | undefined;
type: "file-url";
url: string;
} | {
providerOptions?: Record<string, Record<string, any>> | undefined;
type: "file-id";
fileId: string | Record<string, string>;
} | {
providerOptions?: Record<string, Record<string, any>> | undefined;
type: "image-data";
mediaType: string;
data: string;
} | {
providerOptions?: Record<string, Record<string, any>> | undefined;
type: "image-url";
url: string;
} | {
providerOptions?: Record<string, Record<string, any>> | undefined;
type: "image-file-id";
fileId: string | Record<string, string>;
} | {
providerOptions?: Record<string, Record<string, any>> | undefined;
type: "custom";
})[];
} | undefined;
result?: any;
isError?: boolean | undefined;
experimental_content?: ({
type: "text";
text: string;
} | {
mimeType?: string | undefined;
type: "image";
data: string;
})[] | undefined;
type: "tool-result";
toolCallId: string;
toolName: string;
} | {
title?: string | undefined;
providerOptions?: Record<string, Record<string, any>> | undefined;
providerMetadata?: Record<string, Record<string, any>> | undefined;
id: string;
type: "source";
url: string;
sourceType: "url";
} | {
providerOptions?: Record<string, Record<string, any>> | undefined;
providerMetadata?: Record<string, Record<string, any>> | undefined;
filename?: string | undefined;
id: string;
title: string;
type: "source";
mediaType: string;
sourceType: "document";
} | {
providerOptions?: Record<string, Record<string, any>> | undefined;
providerMetadata?: Record<string, Record<string, any>> | undefined;
type: "tool-approval-request";
toolCallId: string;
approvalId: string;
})[];
} | {
providerOptions?: Record<string, Record<string, any>> | undefined;
role: "tool";
content: ({
providerOptions?: Record<string, Record<string, any>> | undefined;
providerMetadata?: Record<string, Record<string, any>> | undefined;
args?: any;
providerExecuted?: boolean | undefined;
output?: {
providerOptions?: Record<string, Record<string, any>> | undefined;
type: "text";
value: string;
} | {
providerOptions?: Record<string, Record<string, any>> | undefined;
type: "json";
value: any;
} | {
providerOptions?: Record<string, Record<string, any>> | undefined;
type: "error-text";
value: string;
} | {
providerOptions?: Record<string, Record<string, any>> | undefined;
type: "error-json";
value: any;
} | {
providerOptions?: Record<string, Record<string, any>> | undefined;
reason?: string | undefined;
type: "execution-denied";
} | {
type: "content";
value: ({
providerOptions?: Record<string, Record<string, any>> | undefined;
type: "text";
text: string;
} | {
type: "media";
mediaType: string;
data: string;
} | {
providerOptions?: Record<string, Record<string, any>> | undefined;
filename?: string | undefined;
type: "file-data";
mediaType: string;
data: string;
} | {
providerOptions?: Record<string, Record<string, any>> | undefined;
type: "file-url";
url: string;
} | {
providerOptions?: Record<string, Record<string, any>> | undefined;
type: "file-id";
fileId: string | Record<string, string>;
} | {
providerOptions?: Record<string, Record<string, any>> | undefined;
type: "image-data";
mediaType: string;
data: string;
} | {
providerOptions?: Record<string, Record<string, any>> | undefined;
type: "image-url";
url: string;
} | {
providerOptions?: Record<string, Record<string, any>> | undefined;
type: "image-file-id";
fileId: string | Record<string, string>;
} | {
providerOptions?: Record<string, Record<string, any>> | undefined;
type: "custom";
})[];
} | undefined;
result?: any;
isError?: boolean | undefined;
experimental_content?: ({
type: "text";
text: string;
} | {
mimeType?: string | undefined;
type: "image";
data: string;
})[] | undefined;
type: "tool-result";
toolCallId: string;
toolName: string;
} | {
providerOptions?: Record<string, Record<string, any>> | undefined;
providerMetadata?: Record<string, Record<string, any>> | undefined;
providerExecuted?: boolean | undefined;
reason?: string | undefined;
type: "tool-approval-response";
approvalId: string;
approved: boolean;
})[];
} | {
providerOptions?: Record<string, Record<string, any>> | undefined;
role: "system";
content: string;
} | undefined;
text?: string | undefined;
providerMetadata?: Record<string, Record<string, any>> | undefined;
reasoning?: string | undefined;
usage?: {
reasoningTokens?: number | undefined;
cachedInputTokens?: number | undefined;
promptTokens: number;
completionTokens: number;
totalTokens: number;
} | undefined;
sources?: ({
title?: string | undefined;
type?: "source" | undefined;
providerOptions?: Record<string, Record<string, any>> | undefined;
providerMetadata?: Record<string, Record<string, any>> | undefined;
id: string;
url: string;
sourceType: "url";
} | {
providerOptions?: Record<string, Record<string, any>> | undefined;
providerMetadata?: Record<string, Record<string, any>> | undefined;
filename?: string | undefined;
id: string;
title: string;
type: "source";
mediaType: string;
sourceType: "document";
})[] | undefined;
warnings?: ({
details?: string | undefined;
type: "unsupported-setting";
setting: string;
} | {
details?: string | undefined;
type: "unsupported-tool";
tool: any;
} | {
type: "other";
message: string;
})[] | undefined;
finishReason?: "error" | "length" | "other" | "stop" | "content-filter" | "tool-calls" | "unknown" | undefined;
reasoningDetails?: ({
providerOptions?: Record<string, Record<string, any>> | undefined;
providerMetadata?: Record<string, Record<string, any>> | undefined;
signature?: string | undefined;
type: "reasoning";
text: string;
} | {
signature?: string | undefined;
type: "text";
text: string;
} | {
type: "redacted";
data: string;
})[] | undefined;
parentMessageId?: import("convex/values").GenericId<"messages"> | undefined;
stepId?: string | undefined;
status: "pending" | "success" | "failed";
order: number;
threadId: import("convex/values").GenericId<"threads">;
stepOrder: number;
tool: boolean;
} | null>;
export declare const finalizeMessage: import("convex/server").RegisteredMutation<"public", {
result: {
status: "success";
} | {
status: "failed";
error: string;
};
messageId: import("convex/values").GenericId<"messages">;
}, Promise<void>>;
export declare const updateMessage: import("convex/server").RegisteredMutation<"public", {
messageId: import("convex/values").GenericId<"messages">;
patch: {
status?: "pending" | "success" | "failed" | undefined;
fileIds?: import("convex/values").GenericId<"files">[] | undefined;
error?: 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;
providerMetadata?: Record<string, Record<string, any>> | undefined;
type: "text";
text: string;
} | {
providerOptions?: Record<string, Record<string, any>> | undefined;
mediaType?: string | undefined;
mimeType?: string | undefined;
type: "image";
image: string | ArrayBuffer;
} | {
providerOptions?: Record<string, Record<string, any>> | undefined;
providerMetadata?: Record<string, Record<string, any>> | undefined;
mediaType?: string | undefined;
mimeType?: string | undefined;
filename?: string | undefined;
type: "file";
data: string | ArrayBuffer;
})[];
} | {
providerOptions?: Record<string, Record<string, any>> | undefined;
role: "assistant";
content: string | ({
providerOptions?: Record<string, Record<string, any>> | undefined;
providerMetadata?: Record<string, Record<string, any>> | undefined;
type: "text";
text: string;
} | {
providerOptions?: Record<string, Record<string, any>> | undefined;
providerMetadata?: Record<string, Record<string, any>> | undefined;
mediaType?: string | undefined;
mimeType?: string | undefined;
filename?: string | undefined;
type: "file";
data: string | ArrayBuffer;
} | {
providerOptions?: Record<string, Record<string, any>> | undefined;
providerMetadata?: Record<string, Record<string, any>> | undefined;
signature?: string | undefined;
type: "reasoning";
text: string;
} | {
providerOptions?: Record<string, Record<string, any>> | undefined;
providerMetadata?: Record<string, Record<string, any>> | undefined;
type: "redacted-reasoning";
data: string;
} | {
providerOptions?: Record<string, Record<string, any>> | undefined;
providerMetadata?: Record<string, Record<string, any>> | undefined;
args?: any;
providerExecuted?: boolean | undefined;
type: "tool-call";
toolCallId: string;
toolName: string;
input: any;
} | {
providerOptions?: Record<string, Record<string, any>> | undefined;
providerMetadata?: Record<string, Record<string, any>> | undefined;
input?: any;
providerExecuted?: boolean | undefined;
type: "tool-call";
toolCallId: string;
toolName: string;
args: any;
} | {
providerOptions?: Record<string, Record<string, any>> | undefined;
providerMetadata?: Record<string, Record<string, any>> | undefined;
args?: any;
providerExecuted?: boolean | undefined;
output?: {
providerOptions?: Record<string, Record<st