@convex-dev/agent 0.1.16-alpha.3 → 0.1.17
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.
- package/README.md +1 -1
- package/dist/client/definePlaygroundAPI.d.ts +620 -0
- package/dist/client/definePlaygroundAPI.d.ts.map +1 -0
- package/dist/client/definePlaygroundAPI.js +254 -0
- package/dist/client/definePlaygroundAPI.js.map +1 -0
- package/dist/client/files.js +1 -1
- package/dist/client/files.js.map +1 -1
- package/dist/client/index.d.ts +1 -0
- package/dist/client/index.d.ts.map +1 -1
- package/dist/client/index.js +2 -1
- package/dist/client/index.js.map +1 -1
- package/dist/component/messages.d.ts +1 -1
- package/dist/component/schema.d.ts.map +1 -1
- package/dist/component/users.d.ts.map +1 -1
- package/dist/component/users.js +0 -1
- package/dist/component/users.js.map +1 -1
- package/package.json +6 -5
- package/src/client/definePlaygroundAPI.ts +337 -0
- package/src/client/files.ts +1 -1
- package/src/client/index.ts +6 -1
- package/src/component/users.ts +0 -1
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"users.js","sourceRoot":"","sources":["../../src/component/users.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,kCAAkC,CAAC;AAC7D,OAAO,EAAE,MAAM,EAAE,MAAM,8BAA8B,CAAC;AACtD,OAAO,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AACrD,OAAO,EAAE,uBAAuB,EAAE,MAAM,eAAe,CAAC;AAExD,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAE/C,OAAO,EACL,MAAM,EACN,gBAAgB,EAChB,aAAa,EACb,QAAQ,EAER,KAAK,GACN,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,EAAE,4BAA4B,EAAE,MAAM,cAAc,CAAC;AAC5D,OAAO,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,aAAa,CAAC;AAExC,gDAAgD;AAChD,MAAM,CAAC,MAAM,oBAAoB,GAAG,KAAK,CAAC;IACxC,IAAI,EAAE;QACJ,cAAc,EAAE,uBAAuB;KACxC;IACD,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE;QAC3B,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,GAAG,CAAC,EAAE,EAAE,MAAM,CAAC;aACzC,KAAK,CAAC,SAAS,CAAC;aAChB,SAAS,CAAC,QAAQ,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;aAC9C,
|
|
1
|
+
{"version":3,"file":"users.js","sourceRoot":"","sources":["../../src/component/users.ts"],"names":[],"mappings":"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"}
|
package/package.json
CHANGED
|
@@ -7,7 +7,7 @@
|
|
|
7
7
|
"email": "support@convex.dev",
|
|
8
8
|
"url": "https://github.com/get-convex/agent/issues"
|
|
9
9
|
},
|
|
10
|
-
"version": "0.1.
|
|
10
|
+
"version": "0.1.17",
|
|
11
11
|
"license": "Apache-2.0",
|
|
12
12
|
"keywords": [
|
|
13
13
|
"convex",
|
|
@@ -20,7 +20,7 @@
|
|
|
20
20
|
"example": "cd example && npm run dev",
|
|
21
21
|
"dev": "run-p -r 'example' 'build:watch'",
|
|
22
22
|
"prepare": "npm run build",
|
|
23
|
-
"setup": "node setup.cjs
|
|
23
|
+
"setup": "node setup.cjs --init",
|
|
24
24
|
"dashboard": "cd example && npx convex dashboard",
|
|
25
25
|
"build:watch": "npx chokidar 'tsconfig*.json' 'src/**/*.ts' -c 'npm run build' --initial",
|
|
26
26
|
"build": "tsc --project ./tsconfig.build.json && npm run copy:dts && echo '{\\n \"type\": \"module\"\\n}' > dist/package.json",
|
|
@@ -66,7 +66,7 @@
|
|
|
66
66
|
"peerDependencies": {
|
|
67
67
|
"ai": "^4.3.16",
|
|
68
68
|
"convex": "^1.23.0",
|
|
69
|
-
"convex-helpers": "^0.1.
|
|
69
|
+
"convex-helpers": "^0.1.100",
|
|
70
70
|
"react": "^18.3.1 || ^19.0.0"
|
|
71
71
|
},
|
|
72
72
|
"peerDependenciesMeta": {
|
|
@@ -78,11 +78,11 @@
|
|
|
78
78
|
"@arethetypeswrong/cli": "^0.17.4",
|
|
79
79
|
"@edge-runtime/vm": "^5.0.0",
|
|
80
80
|
"@eslint/js": "^9.9.1",
|
|
81
|
-
"@types/node": "^
|
|
81
|
+
"@types/node": "^20.19.9",
|
|
82
82
|
"@types/react": "^19.1.1",
|
|
83
83
|
"chokidar-cli": "^3.0.0",
|
|
84
84
|
"convex": "^1.24.8",
|
|
85
|
-
"convex-helpers": "0.1.
|
|
85
|
+
"convex-helpers": "0.1.100",
|
|
86
86
|
"convex-test": "^0.0.37",
|
|
87
87
|
"cpy-cli": "^5.0.0",
|
|
88
88
|
"eslint": "^9.24.0",
|
|
@@ -93,6 +93,7 @@
|
|
|
93
93
|
"npm-run-all2": "^8.0.4",
|
|
94
94
|
"pkg-pr-new": "^0.0.53",
|
|
95
95
|
"prettier": "3.2.5",
|
|
96
|
+
"readline": "^1.3.0",
|
|
96
97
|
"typescript": "^5.8.3",
|
|
97
98
|
"typescript-eslint": "^8.29.1",
|
|
98
99
|
"vite": "^6.3.5",
|
|
@@ -0,0 +1,337 @@
|
|
|
1
|
+
import {
|
|
2
|
+
paginationOptsValidator,
|
|
3
|
+
queryGeneric,
|
|
4
|
+
mutationGeneric,
|
|
5
|
+
actionGeneric,
|
|
6
|
+
type GenericDataModel,
|
|
7
|
+
type GenericQueryCtx,
|
|
8
|
+
type ApiFromModules,
|
|
9
|
+
type GenericActionCtx,
|
|
10
|
+
} from "convex/server";
|
|
11
|
+
import {
|
|
12
|
+
vMessageDoc,
|
|
13
|
+
vThreadDoc,
|
|
14
|
+
vPaginationResult,
|
|
15
|
+
vMessage,
|
|
16
|
+
vContextOptions,
|
|
17
|
+
vStorageOptions,
|
|
18
|
+
type AgentComponent,
|
|
19
|
+
type Agent,
|
|
20
|
+
type ContextOptions,
|
|
21
|
+
} from "@convex-dev/agent";
|
|
22
|
+
import type { ToolSet } from "ai";
|
|
23
|
+
import { v } from "convex/values";
|
|
24
|
+
|
|
25
|
+
export type PlaygroundAPI = ApiFromModules<{
|
|
26
|
+
playground: ReturnType<typeof definePlaygroundAPI>;
|
|
27
|
+
}>["playground"];
|
|
28
|
+
|
|
29
|
+
export type AgentsFn<DataModel extends GenericDataModel> = (
|
|
30
|
+
ctx: GenericActionCtx<DataModel> | GenericQueryCtx<DataModel>,
|
|
31
|
+
args: { userId: string | undefined; threadId: string | undefined },
|
|
32
|
+
) => Agent<ToolSet>[] | Promise<Agent<ToolSet>[]>;
|
|
33
|
+
|
|
34
|
+
// Playground API definition
|
|
35
|
+
export function definePlaygroundAPI<DataModel extends GenericDataModel>(
|
|
36
|
+
component: AgentComponent,
|
|
37
|
+
{
|
|
38
|
+
agents: agentsOrFn,
|
|
39
|
+
userNameLookup,
|
|
40
|
+
}: {
|
|
41
|
+
agents: Agent<ToolSet>[] | AgentsFn<DataModel>;
|
|
42
|
+
userNameLookup?: (
|
|
43
|
+
ctx: GenericQueryCtx<DataModel>,
|
|
44
|
+
userId: string,
|
|
45
|
+
) => string | Promise<string>;
|
|
46
|
+
},
|
|
47
|
+
) {
|
|
48
|
+
function validateAgents(agents: Agent<ToolSet>[]) {
|
|
49
|
+
for (const agent of agents) {
|
|
50
|
+
if (!agent.options.name) {
|
|
51
|
+
console.warn(
|
|
52
|
+
`Agent has no name (instructions: ${agent.options.instructions})`,
|
|
53
|
+
);
|
|
54
|
+
}
|
|
55
|
+
}
|
|
56
|
+
}
|
|
57
|
+
|
|
58
|
+
async function validateApiKey(ctx: RunQueryCtx, apiKey: string) {
|
|
59
|
+
await ctx.runQuery(component.apiKeys.validate, { apiKey });
|
|
60
|
+
}
|
|
61
|
+
|
|
62
|
+
const isApiKeyValid = queryGeneric({
|
|
63
|
+
args: {
|
|
64
|
+
apiKey: v.string(),
|
|
65
|
+
},
|
|
66
|
+
handler: async (ctx, args) => {
|
|
67
|
+
try {
|
|
68
|
+
await validateApiKey(ctx, args.apiKey);
|
|
69
|
+
return true;
|
|
70
|
+
} catch {
|
|
71
|
+
return false;
|
|
72
|
+
}
|
|
73
|
+
},
|
|
74
|
+
returns: v.boolean(),
|
|
75
|
+
});
|
|
76
|
+
|
|
77
|
+
async function getAgents(
|
|
78
|
+
ctx: GenericActionCtx<DataModel> | GenericQueryCtx<DataModel>,
|
|
79
|
+
args: { userId: string | undefined; threadId: string | undefined },
|
|
80
|
+
) {
|
|
81
|
+
const agents = Array.isArray(agentsOrFn)
|
|
82
|
+
? agentsOrFn
|
|
83
|
+
: await agentsOrFn(ctx, args);
|
|
84
|
+
validateAgents(agents);
|
|
85
|
+
return agents.map((agent, i) => ({
|
|
86
|
+
name: agent.options.name ?? `Agent ${i} (missing 'name')`,
|
|
87
|
+
agent,
|
|
88
|
+
}));
|
|
89
|
+
}
|
|
90
|
+
|
|
91
|
+
// List all agents
|
|
92
|
+
const listAgents = queryGeneric({
|
|
93
|
+
args: {
|
|
94
|
+
apiKey: v.string(),
|
|
95
|
+
userId: v.optional(v.string()),
|
|
96
|
+
threadId: v.optional(v.string()),
|
|
97
|
+
},
|
|
98
|
+
handler: async (ctx, args) => {
|
|
99
|
+
const agents = await getAgents(ctx, {
|
|
100
|
+
userId: args.userId,
|
|
101
|
+
threadId: args.threadId,
|
|
102
|
+
});
|
|
103
|
+
await validateApiKey(ctx, args.apiKey);
|
|
104
|
+
return agents.map(({ name, agent }) => ({
|
|
105
|
+
name,
|
|
106
|
+
instructions: agent.options.instructions,
|
|
107
|
+
contextOptions: agent.options.contextOptions,
|
|
108
|
+
storageOptions: agent.options.storageOptions,
|
|
109
|
+
maxSteps: agent.options.maxSteps,
|
|
110
|
+
maxRetries: agent.options.maxRetries,
|
|
111
|
+
tools: agent.options.tools ? Object.keys(agent.options.tools) : [],
|
|
112
|
+
}));
|
|
113
|
+
},
|
|
114
|
+
});
|
|
115
|
+
|
|
116
|
+
const listUsers = queryGeneric({
|
|
117
|
+
args: {
|
|
118
|
+
apiKey: v.string(),
|
|
119
|
+
paginationOpts: paginationOptsValidator,
|
|
120
|
+
},
|
|
121
|
+
handler: async (ctx, args) => {
|
|
122
|
+
await validateApiKey(ctx, args.apiKey);
|
|
123
|
+
const users = await ctx.runQuery(component.users.listUsersWithThreads, {
|
|
124
|
+
paginationOpts: args.paginationOpts,
|
|
125
|
+
});
|
|
126
|
+
return {
|
|
127
|
+
...users,
|
|
128
|
+
page: await Promise.all(
|
|
129
|
+
users.page.map(async (userId) => ({
|
|
130
|
+
_id: userId,
|
|
131
|
+
name: userNameLookup ? await userNameLookup(ctx, userId) : userId,
|
|
132
|
+
})),
|
|
133
|
+
),
|
|
134
|
+
};
|
|
135
|
+
},
|
|
136
|
+
returns: vPaginationResult(
|
|
137
|
+
v.object({
|
|
138
|
+
_id: v.string(),
|
|
139
|
+
name: v.string(),
|
|
140
|
+
}),
|
|
141
|
+
),
|
|
142
|
+
});
|
|
143
|
+
|
|
144
|
+
// List threads for a user (query)
|
|
145
|
+
const listThreads = queryGeneric({
|
|
146
|
+
args: {
|
|
147
|
+
apiKey: v.string(),
|
|
148
|
+
userId: v.optional(v.string()),
|
|
149
|
+
paginationOpts: paginationOptsValidator,
|
|
150
|
+
},
|
|
151
|
+
handler: async (ctx, args) => {
|
|
152
|
+
await validateApiKey(ctx, args.apiKey);
|
|
153
|
+
const results = await ctx.runQuery(
|
|
154
|
+
component.threads.listThreadsByUserId,
|
|
155
|
+
{
|
|
156
|
+
userId: args.userId,
|
|
157
|
+
paginationOpts: args.paginationOpts,
|
|
158
|
+
order: "desc",
|
|
159
|
+
},
|
|
160
|
+
);
|
|
161
|
+
return {
|
|
162
|
+
...results,
|
|
163
|
+
page: await Promise.all(
|
|
164
|
+
results.page.map(async (thread) => {
|
|
165
|
+
const {
|
|
166
|
+
page: [last],
|
|
167
|
+
} = await ctx.runQuery(component.messages.listMessagesByThreadId, {
|
|
168
|
+
threadId: thread._id,
|
|
169
|
+
order: "desc",
|
|
170
|
+
paginationOpts: {
|
|
171
|
+
numItems: 1,
|
|
172
|
+
cursor: null,
|
|
173
|
+
},
|
|
174
|
+
});
|
|
175
|
+
return {
|
|
176
|
+
...thread,
|
|
177
|
+
lastAgentName: last?.agentName,
|
|
178
|
+
latestMessage: last?.text,
|
|
179
|
+
lastMessageAt: last?._creationTime,
|
|
180
|
+
};
|
|
181
|
+
}),
|
|
182
|
+
),
|
|
183
|
+
};
|
|
184
|
+
},
|
|
185
|
+
returns: vPaginationResult(
|
|
186
|
+
v.object({
|
|
187
|
+
...vThreadDoc.fields,
|
|
188
|
+
lastAgentName: v.optional(v.string()),
|
|
189
|
+
latestMessage: v.optional(v.string()),
|
|
190
|
+
lastMessageAt: v.optional(v.number()),
|
|
191
|
+
}),
|
|
192
|
+
),
|
|
193
|
+
});
|
|
194
|
+
|
|
195
|
+
// List messages for a thread (query)
|
|
196
|
+
const listMessages = queryGeneric({
|
|
197
|
+
args: {
|
|
198
|
+
apiKey: v.string(),
|
|
199
|
+
threadId: v.string(),
|
|
200
|
+
paginationOpts: paginationOptsValidator,
|
|
201
|
+
},
|
|
202
|
+
handler: async (ctx, args) => {
|
|
203
|
+
await validateApiKey(ctx, args.apiKey);
|
|
204
|
+
return ctx.runQuery(component.messages.listMessagesByThreadId, {
|
|
205
|
+
threadId: args.threadId,
|
|
206
|
+
paginationOpts: args.paginationOpts,
|
|
207
|
+
order: "desc",
|
|
208
|
+
statuses: ["success", "failed", "pending"],
|
|
209
|
+
});
|
|
210
|
+
},
|
|
211
|
+
returns: vPaginationResult(vMessageDoc),
|
|
212
|
+
});
|
|
213
|
+
|
|
214
|
+
// Create a thread (mutation)
|
|
215
|
+
const createThread = mutationGeneric({
|
|
216
|
+
args: {
|
|
217
|
+
apiKey: v.string(),
|
|
218
|
+
userId: v.string(),
|
|
219
|
+
title: v.optional(v.string()),
|
|
220
|
+
summary: v.optional(v.string()),
|
|
221
|
+
/** @deprecated Unused. */
|
|
222
|
+
agentName: v.optional(v.string()),
|
|
223
|
+
},
|
|
224
|
+
handler: async (ctx, args) => {
|
|
225
|
+
// if (args.agentName) {
|
|
226
|
+
// console.warn(
|
|
227
|
+
// "Upgrade to the latest version of @convex-dev/agent-playground"
|
|
228
|
+
// );
|
|
229
|
+
// }
|
|
230
|
+
await validateApiKey(ctx, args.apiKey);
|
|
231
|
+
const { _id } = await ctx.runMutation(component.threads.createThread, {
|
|
232
|
+
userId: args.userId,
|
|
233
|
+
title: args.title,
|
|
234
|
+
summary: args.summary,
|
|
235
|
+
});
|
|
236
|
+
return { threadId: _id };
|
|
237
|
+
},
|
|
238
|
+
returns: v.object({ threadId: v.string() }),
|
|
239
|
+
});
|
|
240
|
+
|
|
241
|
+
// Send a message (action)
|
|
242
|
+
const generateText = actionGeneric({
|
|
243
|
+
args: {
|
|
244
|
+
apiKey: v.string(),
|
|
245
|
+
agentName: v.string(),
|
|
246
|
+
userId: v.string(),
|
|
247
|
+
threadId: v.string(),
|
|
248
|
+
// Options for generateText
|
|
249
|
+
contextOptions: v.optional(vContextOptions),
|
|
250
|
+
storageOptions: v.optional(vStorageOptions),
|
|
251
|
+
// Args passed through to generateText
|
|
252
|
+
prompt: v.optional(v.string()),
|
|
253
|
+
messages: v.optional(v.array(vMessage)),
|
|
254
|
+
system: v.optional(v.string()),
|
|
255
|
+
},
|
|
256
|
+
handler: async (ctx: GenericActionCtx<DataModel>, args) => {
|
|
257
|
+
const {
|
|
258
|
+
apiKey,
|
|
259
|
+
agentName,
|
|
260
|
+
userId,
|
|
261
|
+
threadId,
|
|
262
|
+
contextOptions,
|
|
263
|
+
storageOptions,
|
|
264
|
+
system,
|
|
265
|
+
...rest
|
|
266
|
+
} = args;
|
|
267
|
+
await validateApiKey(ctx, apiKey);
|
|
268
|
+
const agents = await getAgents(ctx, {
|
|
269
|
+
userId: args.userId,
|
|
270
|
+
threadId: args.threadId,
|
|
271
|
+
});
|
|
272
|
+
const namedAgent = agents.find(({ name }) => name === agentName);
|
|
273
|
+
if (!namedAgent) throw new Error(`Unknown agent: ${agentName}`);
|
|
274
|
+
const { agent } = namedAgent;
|
|
275
|
+
const { thread } = await agent.continueThread(ctx, { threadId, userId });
|
|
276
|
+
const { messageId, text } = await thread.generateText(
|
|
277
|
+
{ ...rest, ...(system ? { system } : {}) },
|
|
278
|
+
{
|
|
279
|
+
contextOptions,
|
|
280
|
+
storageOptions,
|
|
281
|
+
},
|
|
282
|
+
);
|
|
283
|
+
return { messageId, text };
|
|
284
|
+
},
|
|
285
|
+
});
|
|
286
|
+
|
|
287
|
+
// Fetch prompt context (action)
|
|
288
|
+
const fetchPromptContext = actionGeneric({
|
|
289
|
+
args: {
|
|
290
|
+
apiKey: v.string(),
|
|
291
|
+
agentName: v.string(),
|
|
292
|
+
userId: v.optional(v.string()),
|
|
293
|
+
threadId: v.optional(v.string()),
|
|
294
|
+
messages: v.array(vMessage),
|
|
295
|
+
contextOptions: vContextOptions,
|
|
296
|
+
beforeMessageId: v.optional(v.string()),
|
|
297
|
+
},
|
|
298
|
+
handler: async (ctx, args) => {
|
|
299
|
+
await validateApiKey(ctx, args.apiKey);
|
|
300
|
+
const agents = await getAgents(ctx, {
|
|
301
|
+
userId: args.userId,
|
|
302
|
+
threadId: args.threadId,
|
|
303
|
+
});
|
|
304
|
+
const namedAgent = agents.find(({ name }) => name === args.agentName);
|
|
305
|
+
if (!namedAgent) throw new Error(`Unknown agent: ${args.agentName}`);
|
|
306
|
+
const { agent } = namedAgent;
|
|
307
|
+
const contextOptions = args.contextOptions;
|
|
308
|
+
if (args.beforeMessageId) {
|
|
309
|
+
contextOptions.recentMessages =
|
|
310
|
+
(contextOptions.recentMessages ?? 10) + 1;
|
|
311
|
+
}
|
|
312
|
+
const messages = await agent.fetchContextMessages(ctx, {
|
|
313
|
+
userId: args.userId,
|
|
314
|
+
threadId: args.threadId,
|
|
315
|
+
messages: args.messages,
|
|
316
|
+
contextOptions: args.contextOptions,
|
|
317
|
+
upToAndIncludingMessageId: args.beforeMessageId,
|
|
318
|
+
});
|
|
319
|
+
return messages.filter(
|
|
320
|
+
(m) => !args.beforeMessageId || m._id !== args.beforeMessageId,
|
|
321
|
+
);
|
|
322
|
+
},
|
|
323
|
+
});
|
|
324
|
+
|
|
325
|
+
return {
|
|
326
|
+
isApiKeyValid,
|
|
327
|
+
listUsers,
|
|
328
|
+
listThreads,
|
|
329
|
+
listMessages,
|
|
330
|
+
listAgents,
|
|
331
|
+
createThread,
|
|
332
|
+
generateText,
|
|
333
|
+
fetchPromptContext,
|
|
334
|
+
};
|
|
335
|
+
}
|
|
336
|
+
|
|
337
|
+
type RunQueryCtx = { runQuery: GenericQueryCtx<GenericDataModel>["runQuery"] };
|
package/src/client/files.ts
CHANGED
|
@@ -51,7 +51,7 @@ export async function storeFile(
|
|
|
51
51
|
sha256 ||
|
|
52
52
|
Array.from(
|
|
53
53
|
new Uint8Array(
|
|
54
|
-
await crypto.subtle.digest("SHA-256", await blob.arrayBuffer()),
|
|
54
|
+
await crypto.subtle.digest("SHA-256", await blob.slice().arrayBuffer()),
|
|
55
55
|
),
|
|
56
56
|
)
|
|
57
57
|
.map((b) => b.toString(16).padStart(2, "0"))
|
package/src/client/index.ts
CHANGED
|
@@ -114,6 +114,11 @@ export {
|
|
|
114
114
|
listMessages,
|
|
115
115
|
syncStreams,
|
|
116
116
|
};
|
|
117
|
+
export {
|
|
118
|
+
definePlaygroundAPI,
|
|
119
|
+
type PlaygroundAPI,
|
|
120
|
+
type AgentsFn,
|
|
121
|
+
} from "./definePlaygroundAPI.js";
|
|
117
122
|
export type {
|
|
118
123
|
AgentComponent,
|
|
119
124
|
ContextOptions,
|
|
@@ -625,7 +630,7 @@ export class Agent<AgentTools extends ToolSet = ToolSet> {
|
|
|
625
630
|
},
|
|
626
631
|
onStepFinish: async (step) => {
|
|
627
632
|
// console.log("onStepFinish", step);
|
|
628
|
-
if (threadId && messageId) {
|
|
633
|
+
if (threadId && messageId && saveOutputMessages) {
|
|
629
634
|
const saved = await this.saveStep(ctx, {
|
|
630
635
|
userId,
|
|
631
636
|
threadId,
|
package/src/component/users.ts
CHANGED
|
@@ -27,7 +27,6 @@ export const listUsersWithThreads = query({
|
|
|
27
27
|
const results = await stream(ctx.db, schema)
|
|
28
28
|
.query("threads")
|
|
29
29
|
.withIndex("userId", (q) => q.gt("userId", ""))
|
|
30
|
-
.filterWith(async (q) => !!q.userId)
|
|
31
30
|
.distinct(["userId"])
|
|
32
31
|
.paginate(args.paginationOpts);
|
|
33
32
|
return {
|