@convex-dev/agent 0.0.11 → 0.0.13

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

@@ -504,1062 +504,294 @@ export declare class Agent<AgentTools extends ToolSet> {
     }): Promise<void>;
     mergedContextOptions(opts: ContextOptions): ContextOptions;
     searchOptionsWithDefaults(contextOptions: ContextOptions, messages: CoreMessage[]): Promise<SearchOptions>;
+    /**
+     * Create a mutation that creates a thread so you can call it from a Workflow.
+     * e.g.
+     * ```ts
+     * // in convex/foo.ts
+     * export const createThread = weatherAgent.createThreadMutation();
+     *
+     * const workflow = new WorkflowManager(components.workflow);
+     * export const myWorkflow = workflow.define({
+     *   args: {},
+     *   handler: async (step) => {
+     *     const { threadId } = await step.runMutation(internal.foo.createThread);
+     *     // use the threadId to generate text, object, etc.
+     *   },
+     * });
+     * ```
+     * @returns A mutation that creates a thread.
+     */
+    createThreadMutation(): import("convex/server").RegisteredMutation<"internal", {
+        userId?: string | undefined;
+        title?: string | undefined;
+        summary?: string | undefined;
+        parentThreadIds?: string[] | undefined;
+    }, Promise<{
+        threadId: string;
+    }>>;
     /**
      * Create an action out of this agent so you can call it from workflows or other actions
      * without a wrapping function.
-     * Note: currently this is not well typed. The return type of the action is always `any`.
      * @param spec Configuration for the agent acting as an action, including
      *   {@link ContextOptions} and maxSteps.
      */
-    asAction(spec?: {
+    asTextAction(spec?: {
         contextOptions?: ContextOptions;
         maxSteps?: number;
     }): import("convex/server").RegisteredAction<"internal", {
         userId?: string | undefined;
         threadId?: string | undefined;
         parentMessageId?: string | undefined;
-        maxRetries?: number | undefined;
-        createThread?: {
-            userId?: string | undefined;
-            title?: string | undefined;
-            summary?: string | undefined;
-            parentThreadIds?: string[] | undefined;
-        } | undefined;
-        contextOptions?: {
-            includeToolCalls?: boolean | undefined;
-            recentMessages?: number | undefined;
-            searchOptions?: {
-                messageRange?: {
-                    before: number;
-                    after: number;
-                } | undefined;
-                textSearch?: boolean | undefined;
-                vectorSearch?: boolean | undefined;
-                limit: number;
-            } | undefined;
-            searchOtherThreads?: boolean | undefined;
-        } | undefined;
-        storageOptions?: {
-            saveAllInputMessages?: boolean | undefined;
-            saveAllOutputMessages?: boolean | undefined;
-        } | undefined;
-        generateText?: {
-            messages?: ({
-                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;
+        messages?: ({
             providerOptions?: Record<string, any> | undefined;
             experimental_providerMetadata?: Record<string, any> | undefined;
-            system?: string | undefined;
-            headers?: Record<string, string> | undefined;
-            maxTokens?: number | undefined;
-            temperature?: number | undefined;
-            topP?: number | undefined;
-            topK?: number | undefined;
-            presencePenalty?: number | undefined;
-            frequencyPenalty?: number | undefined;
-            seed?: number | undefined;
-            maxRetries?: number | undefined;
-            toolChoice?: "required" | "auto" | "none" | {
-                type: "tool";
-                toolName: string;
-            } | undefined;
-            maxSteps?: number | undefined;
-            experimental_continueSteps?: boolean | undefined;
-            prompt?: string | undefined;
-        } | undefined;
-        streamText?: {
-            messages?: ({
-                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: "user";
+            content: string | ({
                 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;
-                })[];
+                type: "text";
+                text: string;
             } | {
                 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;
-                }[];
+                mimeType?: string | undefined;
+                type: "image";
+                image: string | ArrayBuffer;
             } | {
                 providerOptions?: Record<string, any> | undefined;
                 experimental_providerMetadata?: Record<string, any> | undefined;
-                role: "system";
-                content: string;
-            })[] | undefined;
+                type: "file";
+                mimeType: string;
+                data: string | ArrayBuffer;
+            })[];
+        } | {
             providerOptions?: Record<string, any> | undefined;
             experimental_providerMetadata?: Record<string, any> | undefined;
-            system?: string | undefined;
-            headers?: Record<string, string> | undefined;
-            maxTokens?: number | undefined;
-            temperature?: number | undefined;
-            topP?: number | undefined;
-            topK?: number | undefined;
-            presencePenalty?: number | undefined;
-            frequencyPenalty?: number | undefined;
-            seed?: number | undefined;
-            maxRetries?: number | undefined;
-            toolChoice?: "required" | "auto" | "none" | {
-                type: "tool";
-                toolName: string;
-            } | undefined;
-            maxSteps?: number | undefined;
-            experimental_continueSteps?: boolean | undefined;
-            prompt?: string | undefined;
-        } | undefined;
-        generateObject?: {
-            messages?: ({
-                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;
-                })[];
-            } | {
+            role: "assistant";
+            content: string | ({
                 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;
-                }[];
+                type: "text";
+                text: string;
             } | {
                 providerOptions?: Record<string, any> | undefined;
                 experimental_providerMetadata?: Record<string, any> | undefined;
-                role: "system";
-                content: string;
-            })[] | undefined;
-            providerOptions?: Record<string, any> | undefined;
-            experimental_providerMetadata?: Record<string, any> | undefined;
-            system?: string | undefined;
-            headers?: Record<string, string> | undefined;
-            maxTokens?: number | undefined;
-            temperature?: number | undefined;
-            topP?: number | undefined;
-            topK?: number | undefined;
-            presencePenalty?: number | undefined;
-            frequencyPenalty?: number | undefined;
-            seed?: number | undefined;
-            maxRetries?: number | undefined;
-            prompt?: string | undefined;
-            output?: "object" | undefined;
-            schemaName?: string | undefined;
-            schemaDescription?: string | undefined;
-            mode?: "tool" | "auto" | "json" | undefined;
-            schema: any;
-        } | {
-            messages?: ({
-                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;
-                })[];
+                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;
-                })[];
+                type: "reasoning";
+                text: string;
             } | {
                 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;
-                }[];
+                type: "redacted-reasoning";
+                data: string;
             } | {
                 providerOptions?: Record<string, any> | undefined;
                 experimental_providerMetadata?: Record<string, any> | undefined;
-                role: "system";
-                content: string;
-            })[] | undefined;
-            providerOptions?: Record<string, any> | undefined;
-            experimental_providerMetadata?: Record<string, any> | undefined;
-            system?: string | undefined;
-            headers?: Record<string, string> | undefined;
-            maxTokens?: number | undefined;
-            temperature?: number | undefined;
-            topP?: number | undefined;
-            topK?: number | undefined;
-            presencePenalty?: number | undefined;
-            frequencyPenalty?: number | undefined;
-            seed?: number | undefined;
-            maxRetries?: number | undefined;
-            prompt?: string | undefined;
-            output?: "array" | undefined;
-            schemaName?: string | undefined;
-            schemaDescription?: string | undefined;
-            mode?: "tool" | "auto" | "json" | undefined;
-            schema: any;
+                type: "tool-call";
+                toolCallId: string;
+                toolName: string;
+                args: any;
+            })[];
         } | {
-            messages?: ({
-                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;
             providerOptions?: Record<string, any> | undefined;
             experimental_providerMetadata?: Record<string, any> | undefined;
-            system?: string | undefined;
-            headers?: Record<string, string> | undefined;
-            maxTokens?: number | undefined;
-            temperature?: number | undefined;
-            topP?: number | undefined;
-            topK?: number | undefined;
-            presencePenalty?: number | undefined;
-            frequencyPenalty?: number | undefined;
-            seed?: number | undefined;
-            maxRetries?: number | undefined;
-            prompt?: string | undefined;
-            output?: "enum" | undefined;
-            mode?: "tool" | "auto" | "json" | undefined;
-            enum: string[];
-        } | {
-            messages?: ({
+            role: "tool";
+            content: {
                 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;
+                args?: any;
+                experimental_content?: ({
                     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;
+                })[] | undefined;
+                isError?: boolean | undefined;
+                type: "tool-result";
+                toolCallId: string;
+                toolName: string;
+                result: any;
+            }[];
+        } | {
             providerOptions?: Record<string, any> | undefined;
             experimental_providerMetadata?: Record<string, any> | undefined;
-            system?: string | undefined;
-            headers?: Record<string, string> | undefined;
-            maxTokens?: number | undefined;
-            temperature?: number | undefined;
-            topP?: number | undefined;
-            topK?: number | undefined;
-            presencePenalty?: number | undefined;
-            frequencyPenalty?: number | undefined;
-            seed?: number | undefined;
-            maxRetries?: number | undefined;
-            prompt?: string | undefined;
-            mode?: "json" | undefined;
-            output: "no-schema";
+            role: "system";
+            content: string;
+        })[] | undefined;
+        providerOptions?: Record<string, any> | undefined;
+        experimental_providerMetadata?: Record<string, any> | undefined;
+        system?: string | undefined;
+        headers?: Record<string, string> | undefined;
+        maxTokens?: number | undefined;
+        temperature?: number | undefined;
+        topP?: number | undefined;
+        topK?: number | undefined;
+        presencePenalty?: number | undefined;
+        frequencyPenalty?: number | undefined;
+        seed?: number | undefined;
+        maxRetries?: number | undefined;
+        toolChoice?: "required" | "auto" | "none" | {
+            type: "tool";
+            toolName: string;
         } | undefined;
-        streamObject?: {
-            messages?: ({
-                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;
-                })[];
-            } | {
+        maxSteps?: number | undefined;
+        experimental_continueSteps?: boolean | undefined;
+        prompt?: string | undefined;
+        contextOptions?: {
+            includeToolCalls?: boolean | undefined;
+            recentMessages?: number | undefined;
+            searchOptions?: {
+                messageRange?: {
+                    before: number;
+                    after: number;
+                } | undefined;
+                textSearch?: boolean | undefined;
+                vectorSearch?: boolean | undefined;
+                limit: number;
+            } | undefined;
+            searchOtherThreads?: boolean | undefined;
+        } | undefined;
+        storageOptions?: {
+            saveAllInputMessages?: boolean | undefined;
+            saveAllOutputMessages?: boolean | undefined;
+        } | undefined;
+    }, Promise<string>>;
+    /**
+     * Create an action that generates an object out of this agent so you can call
+     * it from workflows or other actions without a wrapping function.
+     * @param spec Configuration for the agent acting as an action, including
+     * the normal parameters to {@link generateObject}, plus {@link ContextOptions}
+     * and maxSteps.
+     */
+    asObjectAction<T>(spec: OurObjectArgs<T> & {
+        maxSteps?: number;
+    }): import("convex/server").RegisteredAction<"internal", {
+        userId?: string | undefined;
+        threadId?: string | undefined;
+        parentMessageId?: string | undefined;
+        messages?: ({
+            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;
-                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;
-                })[];
+                type: "text";
+                text: string;
             } | {
                 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;
-                }[];
+                mimeType?: string | undefined;
+                type: "image";
+                image: string | ArrayBuffer;
             } | {
                 providerOptions?: Record<string, any> | undefined;
                 experimental_providerMetadata?: Record<string, any> | undefined;
-                role: "system";
-                content: string;
-            })[] | undefined;
+                type: "file";
+                mimeType: string;
+                data: string | ArrayBuffer;
+            })[];
+        } | {
             providerOptions?: Record<string, any> | undefined;
             experimental_providerMetadata?: Record<string, any> | undefined;
-            system?: string | undefined;
-            headers?: Record<string, string> | undefined;
-            maxTokens?: number | undefined;
-            temperature?: number | undefined;
-            topP?: number | undefined;
-            topK?: number | undefined;
-            presencePenalty?: number | undefined;
-            frequencyPenalty?: number | undefined;
-            seed?: number | undefined;
-            maxRetries?: number | undefined;
-            prompt?: string | undefined;
-            output?: "object" | undefined;
-            schemaName?: string | undefined;
-            schemaDescription?: string | undefined;
-            mode?: "tool" | "auto" | "json" | undefined;
-            schema: any;
-        } | {
-            messages?: ({
-                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;
-                })[];
-            } | {
+            role: "assistant";
+            content: string | ({
                 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;
-                }[];
+                type: "text";
+                text: string;
             } | {
                 providerOptions?: Record<string, any> | undefined;
                 experimental_providerMetadata?: Record<string, any> | undefined;
-                role: "system";
-                content: string;
-            })[] | undefined;
-            providerOptions?: Record<string, any> | undefined;
-            experimental_providerMetadata?: Record<string, any> | undefined;
-            system?: string | undefined;
-            headers?: Record<string, string> | undefined;
-            maxTokens?: number | undefined;
-            temperature?: number | undefined;
-            topP?: number | undefined;
-            topK?: number | undefined;
-            presencePenalty?: number | undefined;
-            frequencyPenalty?: number | undefined;
-            seed?: number | undefined;
-            maxRetries?: number | undefined;
-            prompt?: string | undefined;
-            output?: "array" | undefined;
-            schemaName?: string | undefined;
-            schemaDescription?: string | undefined;
-            mode?: "tool" | "auto" | "json" | undefined;
-            schema: any;
-        } | {
-            messages?: ({
-                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;
-                })[];
+                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;
-                })[];
+                type: "reasoning";
+                text: string;
             } | {
                 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;
-                }[];
+                type: "redacted-reasoning";
+                data: string;
             } | {
                 providerOptions?: Record<string, any> | undefined;
                 experimental_providerMetadata?: Record<string, any> | undefined;
-                role: "system";
-                content: string;
-            })[] | undefined;
+                type: "tool-call";
+                toolCallId: string;
+                toolName: string;
+                args: any;
+            })[];
+        } | {
             providerOptions?: Record<string, any> | undefined;
             experimental_providerMetadata?: Record<string, any> | undefined;
-            system?: string | undefined;
-            headers?: Record<string, string> | undefined;
-            maxTokens?: number | undefined;
-            temperature?: number | undefined;
-            topP?: number | undefined;
-            topK?: number | undefined;
-            presencePenalty?: number | undefined;
-            frequencyPenalty?: number | undefined;
-            seed?: number | undefined;
-            maxRetries?: number | undefined;
-            prompt?: string | undefined;
-            output?: "enum" | undefined;
-            mode?: "tool" | "auto" | "json" | undefined;
-            enum: string[];
-        } | {
-            messages?: ({
+            role: "tool";
+            content: {
                 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;
+                args?: any;
+                experimental_content?: ({
                     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;
+                })[] | undefined;
+                isError?: boolean | undefined;
+                type: "tool-result";
+                toolCallId: string;
+                toolName: string;
+                result: any;
+            }[];
+        } | {
             providerOptions?: Record<string, any> | undefined;
             experimental_providerMetadata?: Record<string, any> | undefined;
-            system?: string | undefined;
-            headers?: Record<string, string> | undefined;
-            maxTokens?: number | undefined;
-            temperature?: number | undefined;
-            topP?: number | undefined;
-            topK?: number | undefined;
-            presencePenalty?: number | undefined;
-            frequencyPenalty?: number | undefined;
-            seed?: number | undefined;
-            maxRetries?: number | undefined;
-            prompt?: string | undefined;
-            mode?: "json" | undefined;
-            output: "no-schema";
+            role: "system";
+            content: string;
+        })[] | undefined;
+        providerOptions?: Record<string, any> | undefined;
+        experimental_providerMetadata?: Record<string, any> | undefined;
+        system?: string | undefined;
+        headers?: Record<string, string> | undefined;
+        maxTokens?: number | undefined;
+        temperature?: number | undefined;
+        topP?: number | undefined;
+        topK?: number | undefined;
+        presencePenalty?: number | undefined;
+        frequencyPenalty?: number | undefined;
+        seed?: number | undefined;
+        maxRetries?: number | undefined;
+        prompt?: string | undefined;
+        contextOptions?: {
+            includeToolCalls?: boolean | undefined;
+            recentMessages?: number | undefined;
+            searchOptions?: {
+                messageRange?: {
+                    before: number;
+                    after: number;
+                } | undefined;
+                textSearch?: boolean | undefined;
+                vectorSearch?: boolean | undefined;
+                limit: number;
+            } | undefined;
+            searchOtherThreads?: boolean | undefined;
+        } | undefined;
+        storageOptions?: {
+            saveAllInputMessages?: boolean | undefined;
+            saveAllOutputMessages?: boolean | undefined;
         } | undefined;
-    }, Promise<any>>;
+    }, Promise<T>>;
 }
 export type ToolCtx = RunActionCtx & {
     userId?: string;