@convex-dev/agent 0.1.3 → 0.1.4

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (108) hide show
  1. package/dist/commonjs/client/index.d.ts +6 -5
  2. package/dist/commonjs/client/index.d.ts.map +1 -1
  3. package/dist/commonjs/client/index.js +37 -11
  4. package/dist/commonjs/client/index.js.map +1 -1
  5. package/dist/commonjs/client/streaming.d.ts +2 -2
  6. package/dist/commonjs/client/streaming.d.ts.map +1 -1
  7. package/dist/commonjs/client/streaming.js +2 -1
  8. package/dist/commonjs/client/streaming.js.map +1 -1
  9. package/dist/commonjs/component/messages.d.ts +3 -3
  10. package/dist/commonjs/component/messages.d.ts.map +1 -1
  11. package/dist/commonjs/component/messages.js +16 -14
  12. package/dist/commonjs/component/messages.js.map +1 -1
  13. package/dist/commonjs/component/streams.d.ts.map +1 -1
  14. package/dist/commonjs/component/streams.js +1 -4
  15. package/dist/commonjs/component/streams.js.map +1 -1
  16. package/dist/commonjs/component/users.d.ts +3 -0
  17. package/dist/commonjs/component/users.d.ts.map +1 -1
  18. package/dist/commonjs/component/users.js +11 -1
  19. package/dist/commonjs/component/users.js.map +1 -1
  20. package/dist/commonjs/component/vector/index.d.ts +3 -1
  21. package/dist/commonjs/component/vector/index.d.ts.map +1 -1
  22. package/dist/commonjs/component/vector/index.js +6 -2
  23. package/dist/commonjs/component/vector/index.js.map +1 -1
  24. package/dist/commonjs/react/deltas.d.ts +29 -0
  25. package/dist/commonjs/react/deltas.d.ts.map +1 -0
  26. package/dist/commonjs/react/deltas.js +267 -0
  27. package/dist/commonjs/react/deltas.js.map +1 -0
  28. package/dist/commonjs/react/index.d.ts +4 -49
  29. package/dist/commonjs/react/index.d.ts.map +1 -1
  30. package/dist/commonjs/react/index.js +15 -446
  31. package/dist/commonjs/react/index.js.map +1 -1
  32. package/dist/commonjs/react/optimisticallySendMessage.d.ts +8 -0
  33. package/dist/commonjs/react/optimisticallySendMessage.d.ts.map +1 -0
  34. package/dist/commonjs/react/optimisticallySendMessage.js +40 -0
  35. package/dist/commonjs/react/optimisticallySendMessage.js.map +1 -0
  36. package/dist/commonjs/react/toUIMessages.d.ts.map +1 -1
  37. package/dist/commonjs/react/toUIMessages.js +4 -2
  38. package/dist/commonjs/react/toUIMessages.js.map +1 -1
  39. package/dist/commonjs/react/types.d.ts +26 -0
  40. package/dist/commonjs/react/types.d.ts.map +1 -0
  41. package/dist/commonjs/react/types.js +2 -0
  42. package/dist/commonjs/react/types.js.map +1 -0
  43. package/dist/commonjs/react/useSmoothText.d.ts +20 -0
  44. package/dist/commonjs/react/useSmoothText.d.ts.map +1 -0
  45. package/dist/commonjs/react/useSmoothText.js +50 -0
  46. package/dist/commonjs/react/useSmoothText.js.map +1 -0
  47. package/dist/esm/client/index.d.ts +6 -5
  48. package/dist/esm/client/index.d.ts.map +1 -1
  49. package/dist/esm/client/index.js +37 -11
  50. package/dist/esm/client/index.js.map +1 -1
  51. package/dist/esm/client/streaming.d.ts +2 -2
  52. package/dist/esm/client/streaming.d.ts.map +1 -1
  53. package/dist/esm/client/streaming.js +2 -1
  54. package/dist/esm/client/streaming.js.map +1 -1
  55. package/dist/esm/component/messages.d.ts +3 -3
  56. package/dist/esm/component/messages.d.ts.map +1 -1
  57. package/dist/esm/component/messages.js +16 -14
  58. package/dist/esm/component/messages.js.map +1 -1
  59. package/dist/esm/component/streams.d.ts.map +1 -1
  60. package/dist/esm/component/streams.js +1 -4
  61. package/dist/esm/component/streams.js.map +1 -1
  62. package/dist/esm/component/users.d.ts +3 -0
  63. package/dist/esm/component/users.d.ts.map +1 -1
  64. package/dist/esm/component/users.js +11 -1
  65. package/dist/esm/component/users.js.map +1 -1
  66. package/dist/esm/component/vector/index.d.ts +3 -1
  67. package/dist/esm/component/vector/index.d.ts.map +1 -1
  68. package/dist/esm/component/vector/index.js +6 -2
  69. package/dist/esm/component/vector/index.js.map +1 -1
  70. package/dist/esm/react/deltas.d.ts +29 -0
  71. package/dist/esm/react/deltas.d.ts.map +1 -0
  72. package/dist/esm/react/deltas.js +267 -0
  73. package/dist/esm/react/deltas.js.map +1 -0
  74. package/dist/esm/react/index.d.ts +4 -49
  75. package/dist/esm/react/index.d.ts.map +1 -1
  76. package/dist/esm/react/index.js +15 -446
  77. package/dist/esm/react/index.js.map +1 -1
  78. package/dist/esm/react/optimisticallySendMessage.d.ts +8 -0
  79. package/dist/esm/react/optimisticallySendMessage.d.ts.map +1 -0
  80. package/dist/esm/react/optimisticallySendMessage.js +40 -0
  81. package/dist/esm/react/optimisticallySendMessage.js.map +1 -0
  82. package/dist/esm/react/toUIMessages.d.ts.map +1 -1
  83. package/dist/esm/react/toUIMessages.js +4 -2
  84. package/dist/esm/react/toUIMessages.js.map +1 -1
  85. package/dist/esm/react/types.d.ts +26 -0
  86. package/dist/esm/react/types.d.ts.map +1 -0
  87. package/dist/esm/react/types.js +2 -0
  88. package/dist/esm/react/types.js.map +1 -0
  89. package/dist/esm/react/useSmoothText.d.ts +20 -0
  90. package/dist/esm/react/useSmoothText.d.ts.map +1 -0
  91. package/dist/esm/react/useSmoothText.js +50 -0
  92. package/dist/esm/react/useSmoothText.js.map +1 -0
  93. package/package.json +4 -1
  94. package/src/client/index.ts +41 -23
  95. package/src/client/streaming.ts +3 -2
  96. package/src/component/_generated/api.d.ts +2 -2
  97. package/src/component/messages.ts +26 -15
  98. package/src/component/streams.ts +3 -4
  99. package/src/component/users.ts +12 -0
  100. package/src/component/vector/index.ts +9 -3
  101. package/src/react/deltas.test.ts +298 -0
  102. package/src/react/deltas.ts +340 -0
  103. package/src/react/index.ts +26 -589
  104. package/src/react/optimisticallySendMessage.ts +46 -0
  105. package/src/react/toUIMessages.test.ts +301 -0
  106. package/src/react/toUIMessages.ts +6 -2
  107. package/src/react/types.ts +52 -0
  108. package/src/react/useSmoothText.ts +76 -0
@@ -0,0 +1,267 @@
1
+ import { toUIMessages } from "./toUIMessages";
2
+ export { toUIMessages };
3
+ export function mergeDeltas(threadId, streamMessages, existingStreams, allDeltas) {
4
+ const newStreams = [];
5
+ // Seed the existing chunks
6
+ let changed = false;
7
+ for (const streamMessage of streamMessages) {
8
+ const deltas = allDeltas.filter((d) => d.streamId === streamMessage.streamId);
9
+ const existing = existingStreams.find((s) => s.streamId === streamMessage.streamId);
10
+ const [newStream, messageChanged] = applyDeltasToStreamMessage(threadId, streamMessage, existing, deltas);
11
+ newStreams.push(newStream);
12
+ if (messageChanged)
13
+ changed = true;
14
+ }
15
+ for (const { streamId } of existingStreams) {
16
+ if (!newStreams.find((s) => s.streamId === streamId)) {
17
+ // There's a stream that's no longer active.
18
+ changed = true;
19
+ }
20
+ }
21
+ const messages = newStreams
22
+ .map((s) => s.messages)
23
+ .flat()
24
+ .sort((a, b) => a.order - b.order || a.stepOrder - b.stepOrder);
25
+ return [messages, newStreams, changed];
26
+ }
27
+ // exported for testing
28
+ export function applyDeltasToStreamMessage(threadId, streamMessage, existing, deltas) {
29
+ let changed = false;
30
+ let cursor = existing?.cursor ?? 0;
31
+ let parts = [];
32
+ for (const delta of deltas.sort((a, b) => a.start - b.start)) {
33
+ if (delta.parts.length === 0) {
34
+ console.warn(`Got delta with no parts: ${JSON.stringify(delta)}`);
35
+ continue;
36
+ }
37
+ if (cursor !== delta.start) {
38
+ if (cursor >= delta.end) {
39
+ console.debug(`Got duplicate delta for stream ${delta.streamId} at ${delta.start}`);
40
+ continue;
41
+ }
42
+ else if (cursor < delta.start) {
43
+ console.warn(`Got delta for stream ${delta.streamId} that has a gap ${cursor} -> ${delta.start}`);
44
+ continue;
45
+ }
46
+ else {
47
+ throw new Error(`Got unexpected delta for stream ${delta.streamId}: delta: ${delta.start} -> ${delta.end} existing cursor: ${cursor}`);
48
+ }
49
+ }
50
+ changed = true;
51
+ cursor = delta.end;
52
+ parts.push(...delta.parts);
53
+ }
54
+ if (!changed) {
55
+ return [
56
+ existing ?? { streamId: streamMessage.streamId, cursor, messages: [] },
57
+ false,
58
+ ];
59
+ }
60
+ const existingMessages = existing?.messages ?? [];
61
+ let currentMessage;
62
+ if (existingMessages.length > 0) {
63
+ // replace the last message with a new one
64
+ const lastMessage = existingMessages.at(-1);
65
+ currentMessage = {
66
+ ...lastMessage,
67
+ message: cloneMessageAndContent(lastMessage.message),
68
+ };
69
+ }
70
+ else {
71
+ const newMessage = createStreamingMessage(threadId, streamMessage, parts[0], existingMessages.length);
72
+ parts = parts.slice(1);
73
+ currentMessage = newMessage;
74
+ }
75
+ const newStream = {
76
+ streamId: streamMessage.streamId,
77
+ cursor,
78
+ messages: [...existingMessages.slice(0, -1), currentMessage],
79
+ };
80
+ let lastContent = getLastContent(currentMessage);
81
+ for (const part of parts) {
82
+ let contentToAdd;
83
+ const isToolRole = part.type === "source" || part.type === "tool-result";
84
+ if (isToolRole !== (currentMessage.message.role === "tool")) {
85
+ currentMessage = createStreamingMessage(threadId, streamMessage, part, newStream.messages.length);
86
+ lastContent = getLastContent(currentMessage);
87
+ newStream.messages.push(currentMessage);
88
+ continue;
89
+ }
90
+ switch (part.type) {
91
+ case "text-delta":
92
+ currentMessage.text += part.textDelta;
93
+ if (lastContent?.type === "text") {
94
+ lastContent.text += part.textDelta;
95
+ }
96
+ else {
97
+ contentToAdd = {
98
+ type: "text",
99
+ text: part.textDelta,
100
+ };
101
+ }
102
+ break;
103
+ case "tool-call-streaming-start":
104
+ currentMessage.tool = true;
105
+ contentToAdd = {
106
+ type: "tool-call",
107
+ toolCallId: part.toolCallId,
108
+ toolName: part.toolName,
109
+ args: "",
110
+ };
111
+ break;
112
+ case "tool-call-delta":
113
+ {
114
+ currentMessage.tool = true;
115
+ if (lastContent?.type !== "tool-call") {
116
+ throw new Error("Expected last content to be a tool call");
117
+ }
118
+ if (typeof lastContent.args !== "string") {
119
+ throw new Error("Expected args to be a string");
120
+ }
121
+ lastContent.args += part.argsTextDelta;
122
+ }
123
+ break;
124
+ case "tool-call":
125
+ currentMessage.tool = true;
126
+ contentToAdd = part;
127
+ break;
128
+ case "reasoning":
129
+ if (lastContent?.type === "reasoning") {
130
+ lastContent.text += part.textDelta;
131
+ }
132
+ else {
133
+ contentToAdd = {
134
+ type: "reasoning",
135
+ text: part.textDelta,
136
+ };
137
+ }
138
+ break;
139
+ case "source":
140
+ if (!currentMessage.sources) {
141
+ currentMessage.sources = [];
142
+ }
143
+ currentMessage.sources.push(part.source);
144
+ break;
145
+ case "tool-result":
146
+ contentToAdd = part;
147
+ break;
148
+ default:
149
+ console.warn(`Received unexpected part: ${JSON.stringify(part)}`);
150
+ break;
151
+ }
152
+ if (contentToAdd) {
153
+ if (!currentMessage.message.content) {
154
+ currentMessage.message.content = [];
155
+ }
156
+ if (!Array.isArray(currentMessage.message?.content)) {
157
+ throw new Error("Expected message content to be an array");
158
+ }
159
+ // eslint-disable-next-line @typescript-eslint/no-explicit-any
160
+ currentMessage.message.content.push(contentToAdd);
161
+ lastContent = contentToAdd;
162
+ }
163
+ }
164
+ return [newStream, true];
165
+ }
166
+ function cloneMessageAndContent(message) {
167
+ return (message &&
168
+ {
169
+ ...message,
170
+ content: Array.isArray(message.content)
171
+ ? [...message.content]
172
+ : message.content,
173
+ });
174
+ }
175
+ function getLastContent(message) {
176
+ if (Array.isArray(message.message?.content)) {
177
+ return message.message.content.at(-1);
178
+ }
179
+ return undefined;
180
+ }
181
+ export function createStreamingMessage(threadId, message, part, index) {
182
+ const { streamId, ...rest } = message;
183
+ const metadata = {
184
+ _id: `${streamId}-${index}`,
185
+ _creationTime: Date.now(),
186
+ status: "pending",
187
+ threadId,
188
+ tool: false,
189
+ ...rest,
190
+ };
191
+ switch (part.type) {
192
+ case "text-delta":
193
+ return {
194
+ ...metadata,
195
+ message: {
196
+ role: "assistant",
197
+ content: [{ type: "text", text: part.textDelta }],
198
+ },
199
+ text: part.textDelta,
200
+ };
201
+ case "tool-call-streaming-start":
202
+ return {
203
+ ...metadata,
204
+ tool: true,
205
+ message: {
206
+ role: "assistant",
207
+ content: [
208
+ {
209
+ type: "tool-call",
210
+ toolName: part.toolName,
211
+ toolCallId: part.toolCallId,
212
+ args: "", // when it's a string, it's a partial call
213
+ },
214
+ ],
215
+ },
216
+ };
217
+ case "reasoning":
218
+ return {
219
+ ...metadata,
220
+ message: {
221
+ role: "assistant",
222
+ content: [{ type: "reasoning", text: part.textDelta }],
223
+ },
224
+ reasoning: part.textDelta,
225
+ };
226
+ case "source":
227
+ console.warn("Received source part first??");
228
+ return {
229
+ ...metadata,
230
+ tool: true,
231
+ message: { role: "tool", content: [] },
232
+ sources: [part.source],
233
+ };
234
+ case "tool-call":
235
+ return {
236
+ ...metadata,
237
+ tool: true,
238
+ message: { role: "assistant", content: [part] },
239
+ };
240
+ case "tool-call-delta":
241
+ console.warn("Received tool call delta part first??");
242
+ return {
243
+ ...metadata,
244
+ tool: true,
245
+ message: {
246
+ role: "assistant",
247
+ content: [
248
+ {
249
+ type: "tool-call",
250
+ toolCallId: part.toolCallId,
251
+ toolName: part.toolName,
252
+ args: part.argsTextDelta,
253
+ },
254
+ ],
255
+ },
256
+ };
257
+ case "tool-result":
258
+ return {
259
+ ...metadata,
260
+ tool: true,
261
+ message: { role: "tool", content: [part] },
262
+ };
263
+ default:
264
+ throw new Error(`Unexpected part type: ${JSON.stringify(part)}`);
265
+ }
266
+ }
267
+ //# sourceMappingURL=deltas.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"deltas.js","sourceRoot":"","sources":["../../../src/react/deltas.ts"],"names":[],"mappings":"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"}
@@ -1,12 +1,10 @@
1
- import type { BetterOmit, ErrorMessage, Expand } from "convex-helpers";
1
+ import type { ErrorMessage } from "convex-helpers";
2
2
  import { type UsePaginatedQueryResult } from "convex/react";
3
- import type { FunctionArgs, FunctionReference, PaginationOptions, PaginationResult } from "convex/server";
4
- import type { MessageDoc } from "../client";
5
- import type { SyncStreamsReturnValue } from "../client/types";
6
- import type { StreamArgs } from "../validators";
7
3
  import type { UIMessage } from "./toUIMessages";
8
4
  import { toUIMessages } from "./toUIMessages";
9
- import { OptimisticLocalStore } from "convex/browser";
5
+ import type { ThreadQuery, ThreadStreamQuery, ThreadMessagesArgs, ThreadMessagesResult } from "./types";
6
+ export { optimisticallySendMessage } from "./optimisticallySendMessage";
7
+ export { useSmoothText } from "./useSmoothText";
10
8
  export { toUIMessages, type UIMessage };
11
9
  /**
12
10
  * A hook that fetches messages from a thread.
@@ -77,49 +75,6 @@ export declare function useThreadMessages<Query extends ThreadQuery<any, any>>(q
77
75
  * @returns The streaming messages.
78
76
  */
79
77
  export declare function useStreamingThreadMessages<Query extends ThreadStreamQuery<any, any>>(query: Query, args: ThreadMessagesArgs<Query> | "skip"): Array<ThreadMessagesResult<Query>> | undefined;
80
- /**
81
- * A hook that smoothly displays text as it is streamed.
82
- *
83
- * @param text The text to display. Pass in the full text each time.
84
- * @param charsPerSec The number of characters to display per second.
85
- * @returns A tuple of the visible text and the state of the smooth text,
86
- * including the current cursor position and whether it's still streaming.
87
- * This allows you to decide if it's too far behind and you want to adjust
88
- * the charsPerSec or just prefer the full text.
89
- */
90
- export declare function useSmoothText(text: string, { charsPerSec, }?: {
91
- /**
92
- * The number of characters to display per second.
93
- */
94
- charsPerSec?: number;
95
- }): [string, {
96
- cursor: number;
97
- isStreaming: boolean;
98
- }];
99
- export declare function optimisticallySendMessage(query: ThreadQuery<unknown, MessageDoc>): (store: OptimisticLocalStore, args: {
100
- threadId: string;
101
- prompt: string;
102
- }) => void;
103
- type ThreadQuery<Args = unknown, M extends MessageDoc = MessageDoc> = FunctionReference<"query", "public", {
104
- threadId: string;
105
- paginationOpts: PaginationOptions;
106
- /**
107
- * If { stream: true } is passed, it will also query for stream deltas.
108
- * In order for this to work, the query must take as an argument streamArgs.
109
- */
110
- streamArgs?: StreamArgs;
111
- } & Args, PaginationResult<M> & {
112
- streams?: SyncStreamsReturnValue;
113
- }>;
114
- type ThreadStreamQuery<Args = Record<string, unknown>, M extends MessageDoc = MessageDoc> = FunctionReference<"query", "public", {
115
- threadId: string;
116
- paginationOpts: PaginationOptions;
117
- streamArgs?: StreamArgs;
118
- } & Args, PaginationResult<M> & {
119
- streams: SyncStreamsReturnValue;
120
- }>;
121
- type ThreadMessagesArgs<Query extends ThreadQuery<unknown, MessageDoc>> = Query extends ThreadQuery<unknown, MessageDoc> ? Expand<BetterOmit<FunctionArgs<Query>, "paginationOpts" | "streamArgs">> : never;
122
- type ThreadMessagesResult<Query extends ThreadQuery<unknown, MessageDoc>> = Query extends ThreadQuery<unknown, infer M> ? M : never;
123
78
  /**
124
79
  * @deprecated use useThreadMessages or useStreamingThreadMessages instead
125
80
  * Use this hook to stream text from a server action, using the
@@ -1 +1 @@
1
- {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/react/index.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/react/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,EAGL,KAAK,uBAAuB,EAE7B,MAAM,cAAc,CAAC;AAMtB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAE9C,OAAO,KAAK,EACV,WAAW,EACX,iBAAiB,EACjB,kBAAkB,EAClB,oBAAoB,EACrB,MAAM,SAAS,CAAC;AAEjB,OAAO,EAAE,yBAAyB,EAAE,MAAM,6BAA6B,CAAC;AACxE,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,YAAY,EAAE,KAAK,SAAS,EAAE,CAAC;AAExC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiDG;AACH,wBAAgB,iBAAiB,CAE/B,KAAK,SAAS,WAAW,CAAC,GAAG,EAAE,GAAG,CAAC,EAEnC,KAAK,EAAE,KAAK,EACZ,IAAI,EAAE,kBAAkB,CAAC,KAAK,CAAC,GAAG,MAAM,EACxC,OAAO,EAAE;IACP,eAAe,EAAE,MAAM,CAAC;IACxB,MAAM,CAAC,EAAE,KAAK,SAAS,iBAAiB,GACpC,OAAO,GACP,YAAY,CAAC,6IAA6I,CAAC,CAAC;CACjK,GACA,uBAAuB,CACxB,oBAAoB,CAAC,KAAK,CAAC,GAAG;IAAE,SAAS,CAAC,EAAE,OAAO,CAAA;CAAE,CACtD,CA0CA;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,0BAA0B,CAExC,KAAK,SAAS,iBAAiB,CAAC,GAAG,EAAE,GAAG,CAAC,EAEzC,KAAK,EAAE,KAAK,EACZ,IAAI,EAAE,kBAAkB,CAAC,KAAK,CAAC,GAAG,MAAM,GACvC,KAAK,CAAC,oBAAoB,CAAC,KAAK,CAAC,CAAC,GAAG,SAAS,CAoEhD;AAMD;;;;;;;;;;;GAWG;AACH,wBAAgB,gBAAgB,CAC9B,GAAG,EAAE,MAAM,EACX,QAAQ,EAAE,MAAM,GAAG,IAAI,EACvB,KAAK,CAAC,EAAE,MAAM;;;;YAOS,MAAM,oBA2C9B"}