@convex-dev/agent 0.7.0 → 0.7.2

package/README.md

@@ -2,11 +2,9 @@
 
 [![npm version](https://badge.fury.io/js/@convex-dev%2fagent.svg)](https://badge.fury.io/js/@convex-dev%2fagent)
 
-Convex provides powerful building blocks for building agentic AI applications,
-leveraging Components and existing Convex features.
-
-With Convex, you can separate your long-running agentic workflows from your UI,
-without the user losing reactivity and interactivity.
+Build AI agents on Convex with persistent chat threads, tool calling, streaming,
+and RAG. Long-running agent workflows stay separate from the UI while clients
+keep reactive updates.
 
 ```sh
 npm i @convex-dev/agent
@@ -17,9 +15,8 @@ npm i @convex-dev/agent
 AI Agents, built on Convex.
 [Check out the docs here](https://docs.convex.dev/agents).
 
-The Agent component is a core building block for building AI agents. It manages
-threads and messages, around which you Agents can cooperate in static or dynamic
-workflows.
+The Agent component manages threads and messages that agents can use in static
+or dynamic workflows.
 
 - [Agents](https://docs.convex.dev/agents/agent-usage) provide an abstraction
   for using LLMs to represent units of use-case-specific prompting with

package/dist/client/messages.d.ts

@@ -19,9 +19,19 @@ export declare function listMessages(ctx: QueryCtx | MutationCtx | ActionCtx, co
     excludeToolMessages?: boolean;
     statuses?: MessageStatus[];
 }): Promise<PaginationResult<MessageDoc>>;
+export type MessageOrder = number | "next";
 export type SaveMessagesArgs = {
     threadId: string;
     userId?: string | null;
+    /**
+     * Save the first message at this order. Pass `"next"` to allocate a new
+     * order after the current latest message. If the numeric order already
+     * contains messages, the message is appended at the next stepOrder.
+     * Numeric orders must be non-negative safe integers less than
+     * Number.MAX_SAFE_INTEGER.
+     * Cannot be combined with promptMessageId or pendingMessageId.
+     */
+    order?: MessageOrder;
     /**
      * The message that these messages are in response to. They will be
      * the same "order" as this message, at increasing stepOrder(s).

package/dist/client/messages.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"messages.d.ts","sourceRoot":"","sources":["../../src/client/messages.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACzE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAEnD,OAAO,EAEL,KAAK,OAAO,EACZ,KAAK,iBAAiB,EAEtB,KAAK,aAAa,EAClB,KAAK,mBAAmB,EACzB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,KAAK,EACV,cAAc,EACd,WAAW,EACX,QAAQ,EACR,SAAS,EACV,MAAM,YAAY,CAAC;AAGpB;;;;;;;;;;GAUG;AACH,wBAAsB,YAAY,CAChC,GAAG,EAAE,QAAQ,GAAG,WAAW,GAAG,SAAS,EACvC,SAAS,EAAE,cAAc,EACzB,EACE,QAAQ,EACR,cAAc,EACd,mBAAmB,EACnB,QAAQ,GACT,EAAE;IACD,QAAQ,EAAE,MAAM,CAAC;IACjB,cAAc,EAAE,iBAAiB,CAAC;IAClC,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,QAAQ,CAAC,EAAE,aAAa,EAAE,CAAC;CAC5B,GACA,OAAO,CAAC,gBAAgB,CAAC,UAAU,CAAC,CAAC,CAevC;AAED,MAAM,MAAM,gBAAgB,GAAG;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB;;;OAGG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB;;OAEG;IACH,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB;;;OAGG;IACH,QAAQ,CAAC,EAAE,IAAI,CAAC,mBAAmB,EAAE,SAAS,CAAC,EAAE,CAAC;IAClD;;;OAGG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B;;OAEG;IACH,UAAU,CAAC,EAAE,iBAAiB,CAAC;IAC/B;;OAEG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B,CAAC;AAEF;;GAEG;AACH,wBAAsB,YAAY,CAChC,GAAG,EAAE,WAAW,GAAG,SAAS,EAC5B,SAAS,EAAE,cAAc,EACzB,IAAI,EAAE,gBAAgB,GAAG;IACvB;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,GACA,OAAO,CAAC;IAAE,QAAQ,EAAE,UAAU,EAAE,CAAA;CAAE,CAAC,CA6BrC"}
+{"version":3,"file":"messages.d.ts","sourceRoot":"","sources":["../../src/client/messages.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACzE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAEnD,OAAO,EAEL,KAAK,OAAO,EACZ,KAAK,iBAAiB,EAEtB,KAAK,aAAa,EAClB,KAAK,mBAAmB,EACzB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,KAAK,EACV,cAAc,EACd,WAAW,EACX,QAAQ,EACR,SAAS,EACV,MAAM,YAAY,CAAC;AAGpB;;;;;;;;;;GAUG;AACH,wBAAsB,YAAY,CAChC,GAAG,EAAE,QAAQ,GAAG,WAAW,GAAG,SAAS,EACvC,SAAS,EAAE,cAAc,EACzB,EACE,QAAQ,EACR,cAAc,EACd,mBAAmB,EACnB,QAAQ,GACT,EAAE;IACD,QAAQ,EAAE,MAAM,CAAC;IACjB,cAAc,EAAE,iBAAiB,CAAC;IAClC,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,QAAQ,CAAC,EAAE,aAAa,EAAE,CAAC;CAC5B,GACA,OAAO,CAAC,gBAAgB,CAAC,UAAU,CAAC,CAAC,CAevC;AAED,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,MAAM,CAAC;AAE3C,MAAM,MAAM,gBAAgB,GAAG;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB;;;;;;;OAOG;IACH,KAAK,CAAC,EAAE,YAAY,CAAC;IACrB;;;OAGG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB;;OAEG;IACH,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB;;;OAGG;IACH,QAAQ,CAAC,EAAE,IAAI,CAAC,mBAAmB,EAAE,SAAS,CAAC,EAAE,CAAC;IAClD;;;OAGG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B;;OAEG;IACH,UAAU,CAAC,EAAE,iBAAiB,CAAC;IAC/B;;OAEG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B,CAAC;AAEF;;GAEG;AACH,wBAAsB,YAAY,CAChC,GAAG,EAAE,WAAW,GAAG,SAAS,EAC5B,SAAS,EAAE,cAAc,EACzB,IAAI,EAAE,gBAAgB,GAAG;IACvB;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,GACA,OAAO,CAAC;IAAE,QAAQ,EAAE,UAAU,EAAE,CAAA;CAAE,CAAC,CA8BrC"}

package/dist/client/messages.js

@@ -49,6 +49,7 @@ export async function saveMessages(ctx, component, args) {
         userId: args.userId ?? undefined,
         agentName: args.agentName,
         promptMessageId: args.promptMessageId,
+        order: args.order,
         pendingMessageId: args.pendingMessageId,
         embeddings,
         messages: args.messages.map((message, i) => parse(vMessageWithMetadata, {

package/dist/client/messages.js.map

@@ -1 +1 @@
-{"version":3,"file":"messages.js","sourceRoot":"","sources":["../../src/client/messages.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,uBAAuB,EAAE,MAAM,+BAA+B,CAAC;AACxE,OAAO,EACL,oBAAoB,GAMrB,MAAM,kBAAkB,CAAC;AAO1B,OAAO,EAAE,KAAK,EAAE,MAAM,2BAA2B,CAAC;AAElD;;;;;;;;;;GAUG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,GAAuC,EACvC,SAAyB,EACzB,EACE,QAAQ,EACR,cAAc,EACd,mBAAmB,EACnB,QAAQ,GAMT;IAED,IAAI,cAAc,CAAC,QAAQ,KAAK,CAAC,EAAE,CAAC;QAClC,OAAO;YACL,IAAI,EAAE,EAAE;YACR,MAAM,EAAE,IAAI;YACZ,cAAc,EAAE,cAAc,CAAC,MAAM,IAAI,EAAE;SAC5C,CAAC;IACJ,CAAC;IACD,OAAO,GAAG,CAAC,QAAQ,CAAC,SAAS,CAAC,QAAQ,CAAC,sBAAsB,EAAE;QAC7D,KAAK,EAAE,MAAM;QACb,QAAQ;QACR,cAAc;QACd,mBAAmB;QACnB,QAAQ;KACT,CAAC,CAAC;AACL,CAAC;AAkCD;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,GAA4B,EAC5B,SAAyB,EACzB,IAKC;IAED,IAAI,UAAsD,CAAC;IAC3D,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;QACpB,MAAM,SAAS,GAAG,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,IAAI,CAAC,EAAE,MAAM,CAAC;QAC1E,IAAI,SAAS,EAAE,CAAC;YACd,uBAAuB,CAAC,SAAS,CAAC,CAAC;YACnC,UAAU,GAAG;gBACX,KAAK,EAAE,IAAI,CAAC,UAAU,CAAC,KAAK;gBAC5B,SAAS;gBACT,OAAO,EAAE,IAAI,CAAC,UAAU,CAAC,OAAO;aACjC,CAAC;QACJ,CAAC;IACH,CAAC;IACD,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,WAAW,CAAC,SAAS,CAAC,QAAQ,CAAC,WAAW,EAAE;QACnE,QAAQ,EAAE,IAAI,CAAC,QAAQ;QACvB,MAAM,EAAE,IAAI,CAAC,MAAM,IAAI,SAAS;QAChC,SAAS,EAAE,IAAI,CAAC,SAAS;QACzB,eAAe,EAAE,IAAI,CAAC,eAAe;QACrC,gBAAgB,EAAE,IAAI,CAAC,gBAAgB;QACvC,UAAU;QACV,QAAQ,EAAE,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,CAAC,EAAE,EAAE,CACzC,KAAK,CAAC,oBAAoB,EAAE;YAC1B,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC;YACrB,OAAO;SACR,CAAC,CACH;QACD,gBAAgB,EAAE,IAAI,CAAC,gBAAgB,IAAI,KAAK;KACjD,CAAC,CAAC;IACH,OAAO,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE,CAAC;AACvC,CAAC"}
+{"version":3,"file":"messages.js","sourceRoot":"","sources":["../../src/client/messages.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,uBAAuB,EAAE,MAAM,+BAA+B,CAAC;AACxE,OAAO,EACL,oBAAoB,GAMrB,MAAM,kBAAkB,CAAC;AAO1B,OAAO,EAAE,KAAK,EAAE,MAAM,2BAA2B,CAAC;AAElD;;;;;;;;;;GAUG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,GAAuC,EACvC,SAAyB,EACzB,EACE,QAAQ,EACR,cAAc,EACd,mBAAmB,EACnB,QAAQ,GAMT;IAED,IAAI,cAAc,CAAC,QAAQ,KAAK,CAAC,EAAE,CAAC;QAClC,OAAO;YACL,IAAI,EAAE,EAAE;YACR,MAAM,EAAE,IAAI;YACZ,cAAc,EAAE,cAAc,CAAC,MAAM,IAAI,EAAE;SAC5C,CAAC;IACJ,CAAC;IACD,OAAO,GAAG,CAAC,QAAQ,CAAC,SAAS,CAAC,QAAQ,CAAC,sBAAsB,EAAE;QAC7D,KAAK,EAAE,MAAM;QACb,QAAQ;QACR,cAAc;QACd,mBAAmB;QACnB,QAAQ;KACT,CAAC,CAAC;AACL,CAAC;AA6CD;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,GAA4B,EAC5B,SAAyB,EACzB,IAKC;IAED,IAAI,UAAsD,CAAC;IAC3D,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;QACpB,MAAM,SAAS,GAAG,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,IAAI,CAAC,EAAE,MAAM,CAAC;QAC1E,IAAI,SAAS,EAAE,CAAC;YACd,uBAAuB,CAAC,SAAS,CAAC,CAAC;YACnC,UAAU,GAAG;gBACX,KAAK,EAAE,IAAI,CAAC,UAAU,CAAC,KAAK;gBAC5B,SAAS;gBACT,OAAO,EAAE,IAAI,CAAC,UAAU,CAAC,OAAO;aACjC,CAAC;QACJ,CAAC;IACH,CAAC;IACD,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,WAAW,CAAC,SAAS,CAAC,QAAQ,CAAC,WAAW,EAAE;QACnE,QAAQ,EAAE,IAAI,CAAC,QAAQ;QACvB,MAAM,EAAE,IAAI,CAAC,MAAM,IAAI,SAAS;QAChC,SAAS,EAAE,IAAI,CAAC,SAAS;QACzB,eAAe,EAAE,IAAI,CAAC,eAAe;QACrC,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,gBAAgB,EAAE,IAAI,CAAC,gBAAgB;QACvC,UAAU;QACV,QAAQ,EAAE,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,CAAC,EAAE,EAAE,CACzC,KAAK,CAAC,oBAAoB,EAAE;YAC1B,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC;YACrB,OAAO;SACR,CAAC,CACH;QACD,gBAAgB,EAAE,IAAI,CAAC,gBAAgB,IAAI,KAAK;KACjD,CAAC,CAAC;IACH,OAAO,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE,CAAC;AACvC,CAAC"}

package/dist/component/_generated/component.d.ts

@@ -89,6 +89,7 @@ export type ComponentApi<Name extends string | undefined = string | undefined> =
         useExistingFile: FunctionReference<"mutation", "internal", {
             filename?: string;
             hash: string;
+            mediaType?: string;
         }, null | {
             fileId: string;
             storageId: string;
@@ -96,9 +97,10 @@ export type ComponentApi<Name extends string | undefined = string | undefined> =
     };
     messages: {
         addMessages: FunctionReference<"mutation", "internal", {
+            abandonIfPromptMissing?: boolean;
             agentName?: string;
             embeddings?: {
-                dimension: 128 | 256 | 512 | 768 | 1024 | 1408 | 1536 | 2048 | 3072 | 4096;
+                dimension: 128 | 256 | 512 | 768 | 1024 | 1408 | 1536 | 2048 | 2560 | 3072 | 4096;
                 model: string;
                 vectors: Array<Array<number> | null>;
             };
@@ -533,6 +535,7 @@ export type ComponentApi<Name extends string | undefined = string | undefined> =
                     type: "other";
                 }>;
             }>;
+            order?: number | "next";
             pendingMessageId?: string;
             promptMessageId?: string;
             threadId: string;
@@ -3637,6 +3640,10 @@ export type ComponentApi<Name extends string | undefined = string | undefined> =
         }, boolean, Name>;
         addDelta: FunctionReference<"mutation", "internal", {
             end: number;
+            fileRefs?: Array<{
+                fileId: string;
+                url: string;
+            }>;
             parts: Array<any>;
             start: number;
             streamId: string;
@@ -3833,20 +3840,20 @@ export type ComponentApi<Name extends string | undefined = string | undefined> =
     vector: {
         index: {
             deleteBatch: FunctionReference<"mutation", "internal", {
-                ids: Array<string | string | string | string | string | string | string | string | string | string>;
+                ids: Array<string | string | string | string | string | string | string | string | string | string | string>;
             }, null, Name>;
             deleteBatchForThread: FunctionReference<"mutation", "internal", {
                 cursor?: string;
                 limit: number;
                 model: string;
                 threadId: string;
-                vectorDimension: 128 | 256 | 512 | 768 | 1024 | 1408 | 1536 | 2048 | 3072 | 4096;
+                vectorDimension: 128 | 256 | 512 | 768 | 1024 | 1408 | 1536 | 2048 | 2560 | 3072 | 4096;
             }, {
                 continueCursor: string;
                 isDone: boolean;
             }, Name>;
             insertBatch: FunctionReference<"mutation", "internal", {
-                vectorDimension: 128 | 256 | 512 | 768 | 1024 | 1408 | 1536 | 2048 | 3072 | 4096;
+                vectorDimension: 128 | 256 | 512 | 768 | 1024 | 1408 | 1536 | 2048 | 2560 | 3072 | 4096;
                 vectors: Array<{
                     messageId?: string;
                     model: string;
@@ -3855,21 +3862,21 @@ export type ComponentApi<Name extends string | undefined = string | undefined> =
                     userId?: string;
                     vector: Array<number>;
                 }>;
-            }, Array<string | string | string | string | string | string | string | string | string | string>, Name>;
+            }, Array<string | string | string | string | string | string | string | string | string | string | string>, Name>;
             paginate: FunctionReference<"query", "internal", {
                 cursor?: string;
                 limit: number;
                 table?: string;
                 targetModel: string;
-                vectorDimension: 128 | 256 | 512 | 768 | 1024 | 1408 | 1536 | 2048 | 3072 | 4096;
+                vectorDimension: 128 | 256 | 512 | 768 | 1024 | 1408 | 1536 | 2048 | 2560 | 3072 | 4096;
             }, {
                 continueCursor: string;
-                ids: Array<string | string | string | string | string | string | string | string | string | string>;
+                ids: Array<string | string | string | string | string | string | string | string | string | string | string>;
                 isDone: boolean;
             }, Name>;
             updateBatch: FunctionReference<"mutation", "internal", {
                 vectors: Array<{
-                    id: string | string | string | string | string | string | string | string | string | string;
+                    id: string | string | string | string | string | string | string | string | string | string | string;
                     model: string;
                     vector: Array<number>;
                 }>;