readme links

Author: ianmacartney

README.md

@@ -9,13 +9,15 @@ AI Agent framework built on Convex.
 - Automatic storage of chat history, per-user or per-thread.
 - RAG for chat context, via hybrid text & vector search, with configuration options.
   Or use the API to query the history yourself and do it your way.
-- Opt-in search for messages from other threads (for the same specifieduser).
+- Opt-in search for messages from other threads (for the same specified user).
 - Tool calls via the AI SDK, along with Convex-specific helpers.
 - Easy workflow integration with the [Workflow component](https://convex.dev/components/workflow).
 - Reactive & realtime updates to asynchronous threads.
 - Support for streaming text and storing the result in the database.
 - Optionally filter tool calls out of the thread history.
 
+[Read the associated Stack post here](https://stack.convex.dev/ai-agents).
+
 Example usage:
 
 ```ts
@@ -31,7 +33,7 @@ const supportAgent = new Agent(components.agent, {
 export const createThread = action({
   args: { prompt: v.string() },
   handler: async (ctx, { prompt }) => {
-    const { threadId, thread } = await supportAgent.createThread(ctx, {});
+    const { threadId, thread } = await supportAgent.createThread(ctx);
     const result = await thread.generateText({ prompt });
     return { threadId, text: result.text };
   },
@@ -68,7 +70,7 @@ export const supportAgentWorkflow = workflow.define({
 });
 ```
 
-Also see the [Stack article](https://stack.convex.dev/ai-agent).
+Also see the [Stack article](https://stack.convex.dev/ai-agents).
 
 Coming soon:
 
@@ -333,7 +335,7 @@ const messages = await ctx.runQuery(components.agent.embeddings.deleteBatch, {
 ```
 
 See example usage in [example.ts](./example/convex/example.ts).
-Read more in [this Stack post](https://stack.convex.dev/ai-agent).
+Read more in [this Stack post](https://stack.convex.dev/ai-agents).
 
 ```sh
 npm i @convex-dev/agent

example/convex/ideaAgents.ts

@@ -1,4 +1,3 @@
-import { vMessageDoc } from "./../../src/component/messages";
 import { action, ActionCtx, query } from "./_generated/server";
 import { api, components } from "./_generated/api";
 import { Agent } from "@convex-dev/agent";
@@ -7,7 +6,6 @@ import { openai } from "@ai-sdk/openai";
 
 import { createTool } from "@convex-dev/agent";
 import { Doc, Id } from "./_generated/dataModel";
-import { Message } from "../../src/validators";
 import { MessageDoc } from "../../src/client/types";
 
 /**

src/client/index.ts

@@ -116,7 +116,7 @@ export class Agent<AgentTools extends ToolSet> {
    */
   async createThread(
     ctx: RunActionCtx,
-    args: {
+    args?: {
       /**
        * The userId to associate with the thread. If not provided, the thread will be
        * anonymous.
@@ -152,7 +152,7 @@ export class Agent<AgentTools extends ToolSet> {
    */
   async createThread(
     ctx: RunMutationCtx,
-    args: {
+    args?: {
       userId?: string;
       parentThreadIds?: string[];
       title?: string;
@@ -163,7 +163,7 @@ export class Agent<AgentTools extends ToolSet> {
   }>;
   async createThread(
     ctx: RunActionCtx | RunMutationCtx,
-    args: {
+    args?: {
       userId: string;
       parentThreadIds?: string[];
       title?: string;
@@ -177,18 +177,18 @@ export class Agent<AgentTools extends ToolSet> {
       this.component.messages.createThread,
       {
         defaultSystemPrompt: this.options.instructions,
-        userId: args.userId,
-        title: args.title,
-        summary: args.summary,
-        parentThreadIds: args.parentThreadIds,
+        userId: args?.userId,
+        title: args?.title,
+        summary: args?.summary,
+        parentThreadIds: args?.parentThreadIds,
       }
     );
     if (!("runAction" in ctx)) {
       return { threadId: threadDoc._id };
     }
     const { thread } = await this.continueThread(ctx, {
       threadId: threadDoc._id,
-      userId: args.userId,
+      userId: args?.userId,
     });
     return {
       threadId: threadDoc._id,