@convex-dev/agent 0.2.2-alpha.0 → 0.2.2-alpha.1

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.
@@ -1,6 +1,1215 @@
1
1
  import { type ChunkDetector, type StreamTextTransform, type TextStreamPart, type ToolSet } from "ai";
2
- import type { ProviderOptions, StreamArgs, StreamMessage } from "../validators.js";
2
+ import { type ProviderOptions, type StreamArgs, type StreamMessage } from "../validators.js";
3
3
  import type { AgentComponent, RunActionCtx, RunMutationCtx, RunQueryCtx, SyncStreamsReturnValue } from "./types.js";
4
+ export declare const vStreamMessagesReturnValue: import("convex/values").VObject<{
5
+ splitCursor?: string | null | undefined;
6
+ pageStatus?: "SplitRecommended" | "SplitRequired" | null | undefined;
7
+ streams?: {
8
+ messages: {
9
+ userId?: string | undefined;
10
+ agentName?: string | undefined;
11
+ model?: string | undefined;
12
+ provider?: string | undefined;
13
+ providerOptions?: Record<string, Record<string, any>> | undefined;
14
+ status: "streaming" | "finished" | "aborted";
15
+ order: number;
16
+ stepOrder: number;
17
+ streamId: string;
18
+ }[];
19
+ kind: "list";
20
+ } | {
21
+ kind: "deltas";
22
+ deltas: {
23
+ streamId: string;
24
+ start: number;
25
+ end: number;
26
+ parts: any[];
27
+ }[];
28
+ } | undefined;
29
+ page: {
30
+ id?: string | undefined;
31
+ userId?: string | undefined;
32
+ embeddingId?: string | undefined;
33
+ fileIds?: string[] | undefined;
34
+ error?: string | undefined;
35
+ agentName?: string | undefined;
36
+ model?: string | undefined;
37
+ provider?: string | undefined;
38
+ providerOptions?: Record<string, Record<string, any>> | undefined;
39
+ message?: {
40
+ providerOptions?: Record<string, Record<string, any>> | undefined;
41
+ role: "user";
42
+ content: string | ({
43
+ providerOptions?: Record<string, Record<string, any>> | undefined;
44
+ type: "text";
45
+ text: string;
46
+ } | {
47
+ providerOptions?: Record<string, Record<string, any>> | undefined;
48
+ mimeType?: string | undefined;
49
+ type: "image";
50
+ image: string | ArrayBuffer;
51
+ } | {
52
+ providerOptions?: Record<string, Record<string, any>> | undefined;
53
+ filename?: string | undefined;
54
+ type: "file";
55
+ mimeType: string;
56
+ data: string | ArrayBuffer;
57
+ })[];
58
+ } | {
59
+ providerOptions?: Record<string, Record<string, any>> | undefined;
60
+ role: "assistant";
61
+ content: string | ({
62
+ providerOptions?: Record<string, Record<string, any>> | undefined;
63
+ type: "text";
64
+ text: string;
65
+ } | {
66
+ providerOptions?: Record<string, Record<string, any>> | undefined;
67
+ filename?: string | undefined;
68
+ type: "file";
69
+ mimeType: string;
70
+ data: string | ArrayBuffer;
71
+ } | {
72
+ providerOptions?: Record<string, Record<string, any>> | undefined;
73
+ signature?: string | undefined;
74
+ state?: "streaming" | "done" | undefined;
75
+ type: "reasoning";
76
+ text: string;
77
+ } | {
78
+ providerOptions?: Record<string, Record<string, any>> | undefined;
79
+ type: "redacted-reasoning";
80
+ data: string;
81
+ } | {
82
+ providerOptions?: Record<string, Record<string, any>> | undefined;
83
+ providerExecuted?: boolean | undefined;
84
+ type: "tool-call";
85
+ toolCallId: string;
86
+ toolName: string;
87
+ args: any;
88
+ })[];
89
+ } | {
90
+ providerOptions?: Record<string, Record<string, any>> | undefined;
91
+ role: "tool";
92
+ content: {
93
+ providerOptions?: Record<string, Record<string, any>> | undefined;
94
+ args?: any;
95
+ providerExecuted?: boolean | undefined;
96
+ isError?: boolean | undefined;
97
+ experimental_content?: ({
98
+ type: "text";
99
+ text: string;
100
+ } | {
101
+ mimeType?: string | undefined;
102
+ type: "image";
103
+ data: string;
104
+ })[] | undefined;
105
+ type: "tool-result";
106
+ toolCallId: string;
107
+ toolName: string;
108
+ result: any;
109
+ }[];
110
+ } | {
111
+ providerOptions?: Record<string, Record<string, any>> | undefined;
112
+ role: "system";
113
+ content: string;
114
+ } | undefined;
115
+ text?: string | undefined;
116
+ reasoning?: string | undefined;
117
+ usage?: {
118
+ reasoningTokens?: number | undefined;
119
+ cachedInputTokens?: number | undefined;
120
+ promptTokens: number;
121
+ completionTokens: number;
122
+ totalTokens: number;
123
+ } | undefined;
124
+ providerMetadata?: Record<string, Record<string, any>> | undefined;
125
+ sources?: ({
126
+ title?: string | undefined;
127
+ type?: "source" | undefined;
128
+ providerOptions?: Record<string, Record<string, any>> | undefined;
129
+ id: string;
130
+ sourceType: "url";
131
+ url: string;
132
+ } | {
133
+ filename?: string | undefined;
134
+ providerMetadata?: Record<string, Record<string, any>> | undefined;
135
+ id: string;
136
+ title: string;
137
+ type: "source";
138
+ sourceType: "document";
139
+ mediaType: string;
140
+ })[] | undefined;
141
+ warnings?: ({
142
+ details?: string | undefined;
143
+ type: "unsupported-setting";
144
+ setting: string;
145
+ } | {
146
+ details?: string | undefined;
147
+ type: "unsupported-tool";
148
+ tool: any;
149
+ } | {
150
+ type: "other";
151
+ message: string;
152
+ })[] | undefined;
153
+ finishReason?: "length" | "error" | "other" | "stop" | "content-filter" | "tool-calls" | "unknown" | undefined;
154
+ reasoningDetails?: ({
155
+ providerOptions?: Record<string, Record<string, any>> | undefined;
156
+ signature?: string | undefined;
157
+ state?: "streaming" | "done" | undefined;
158
+ type: "reasoning";
159
+ text: string;
160
+ } | {
161
+ signature?: string | undefined;
162
+ type: "text";
163
+ text: string;
164
+ } | {
165
+ type: "redacted";
166
+ data: string;
167
+ })[] | undefined;
168
+ _id: string;
169
+ _creationTime: number;
170
+ status: "pending" | "success" | "failed";
171
+ order: number;
172
+ threadId: string;
173
+ stepOrder: number;
174
+ tool: boolean;
175
+ }[];
176
+ continueCursor: string;
177
+ isDone: boolean;
178
+ }, {
179
+ streams: import("convex/values").VUnion<{
180
+ messages: {
181
+ userId?: string | undefined;
182
+ agentName?: string | undefined;
183
+ model?: string | undefined;
184
+ provider?: string | undefined;
185
+ providerOptions?: Record<string, Record<string, any>> | undefined;
186
+ status: "streaming" | "finished" | "aborted";
187
+ order: number;
188
+ stepOrder: number;
189
+ streamId: string;
190
+ }[];
191
+ kind: "list";
192
+ } | {
193
+ kind: "deltas";
194
+ deltas: {
195
+ streamId: string;
196
+ start: number;
197
+ end: number;
198
+ parts: any[];
199
+ }[];
200
+ } | undefined, [import("convex/values").VObject<{
201
+ messages: {
202
+ userId?: string | undefined;
203
+ agentName?: string | undefined;
204
+ model?: string | undefined;
205
+ provider?: string | undefined;
206
+ providerOptions?: Record<string, Record<string, any>> | undefined;
207
+ status: "streaming" | "finished" | "aborted";
208
+ order: number;
209
+ stepOrder: number;
210
+ streamId: string;
211
+ }[];
212
+ kind: "list";
213
+ }, {
214
+ kind: import("convex/values").VLiteral<"list", "required">;
215
+ messages: import("convex/values").VArray<{
216
+ userId?: string | undefined;
217
+ agentName?: string | undefined;
218
+ model?: string | undefined;
219
+ provider?: string | undefined;
220
+ providerOptions?: Record<string, Record<string, any>> | undefined;
221
+ status: "streaming" | "finished" | "aborted";
222
+ order: number;
223
+ stepOrder: number;
224
+ streamId: string;
225
+ }[], import("convex/values").VObject<{
226
+ userId?: string | undefined;
227
+ agentName?: string | undefined;
228
+ model?: string | undefined;
229
+ provider?: string | undefined;
230
+ providerOptions?: Record<string, Record<string, any>> | undefined;
231
+ status: "streaming" | "finished" | "aborted";
232
+ order: number;
233
+ stepOrder: number;
234
+ streamId: string;
235
+ }, {
236
+ streamId: import("convex/values").VString<string, "required">;
237
+ status: import("convex/values").VUnion<"streaming" | "finished" | "aborted", [import("convex/values").VLiteral<"streaming", "required">, import("convex/values").VLiteral<"finished", "required">, import("convex/values").VLiteral<"aborted", "required">], "required", never>;
238
+ order: import("convex/values").VFloat64<number, "required">;
239
+ stepOrder: import("convex/values").VFloat64<number, "required">;
240
+ userId: import("convex/values").VString<string | undefined, "optional">;
241
+ agentName: import("convex/values").VString<string | undefined, "optional">;
242
+ model: import("convex/values").VString<string | undefined, "optional">;
243
+ provider: import("convex/values").VString<string | undefined, "optional">;
244
+ providerOptions: import("convex/values").VRecord<Record<string, Record<string, any>> | undefined, import("convex/values").VString<string, "required">, import("convex/values").VRecord<Record<string, any>, import("convex/values").VString<string, "required">, import("convex/values").VAny<any, "required", string>, "required", string>, "optional", string>;
245
+ }, "required", "status" | "userId" | "order" | "stepOrder" | "agentName" | "model" | "provider" | "providerOptions" | `providerOptions.${string}` | "streamId">, "required">;
246
+ }, "required", "messages" | "kind">, import("convex/values").VObject<{
247
+ kind: "deltas";
248
+ deltas: {
249
+ streamId: string;
250
+ start: number;
251
+ end: number;
252
+ parts: any[];
253
+ }[];
254
+ }, {
255
+ kind: import("convex/values").VLiteral<"deltas", "required">;
256
+ deltas: import("convex/values").VArray<{
257
+ streamId: string;
258
+ start: number;
259
+ end: number;
260
+ parts: any[];
261
+ }[], import("convex/values").VObject<{
262
+ streamId: string;
263
+ start: number;
264
+ end: number;
265
+ parts: any[];
266
+ }, {
267
+ streamId: import("convex/values").VString<string, "required">;
268
+ start: import("convex/values").VFloat64<number, "required">;
269
+ end: import("convex/values").VFloat64<number, "required">;
270
+ parts: import("convex/values").VArray<any[], import("convex/values").VAny<any, "required", string>, "required">;
271
+ }, "required", "streamId" | "start" | "end" | "parts">, "required">;
272
+ }, "required", "kind" | "deltas">], "optional", "messages" | "kind" | "deltas">;
273
+ page: import("convex/values").VArray<{
274
+ id?: string | undefined;
275
+ userId?: string | undefined;
276
+ embeddingId?: string | undefined;
277
+ fileIds?: string[] | undefined;
278
+ error?: string | undefined;
279
+ agentName?: string | undefined;
280
+ model?: string | undefined;
281
+ provider?: string | undefined;
282
+ providerOptions?: Record<string, Record<string, any>> | undefined;
283
+ message?: {
284
+ providerOptions?: Record<string, Record<string, any>> | undefined;
285
+ role: "user";
286
+ content: string | ({
287
+ providerOptions?: Record<string, Record<string, any>> | undefined;
288
+ type: "text";
289
+ text: string;
290
+ } | {
291
+ providerOptions?: Record<string, Record<string, any>> | undefined;
292
+ mimeType?: string | undefined;
293
+ type: "image";
294
+ image: string | ArrayBuffer;
295
+ } | {
296
+ providerOptions?: Record<string, Record<string, any>> | undefined;
297
+ filename?: string | undefined;
298
+ type: "file";
299
+ mimeType: string;
300
+ data: string | ArrayBuffer;
301
+ })[];
302
+ } | {
303
+ providerOptions?: Record<string, Record<string, any>> | undefined;
304
+ role: "assistant";
305
+ content: string | ({
306
+ providerOptions?: Record<string, Record<string, any>> | undefined;
307
+ type: "text";
308
+ text: string;
309
+ } | {
310
+ providerOptions?: Record<string, Record<string, any>> | undefined;
311
+ filename?: string | undefined;
312
+ type: "file";
313
+ mimeType: string;
314
+ data: string | ArrayBuffer;
315
+ } | {
316
+ providerOptions?: Record<string, Record<string, any>> | undefined;
317
+ signature?: string | undefined;
318
+ state?: "streaming" | "done" | undefined;
319
+ type: "reasoning";
320
+ text: string;
321
+ } | {
322
+ providerOptions?: Record<string, Record<string, any>> | undefined;
323
+ type: "redacted-reasoning";
324
+ data: string;
325
+ } | {
326
+ providerOptions?: Record<string, Record<string, any>> | undefined;
327
+ providerExecuted?: boolean | undefined;
328
+ type: "tool-call";
329
+ toolCallId: string;
330
+ toolName: string;
331
+ args: any;
332
+ })[];
333
+ } | {
334
+ providerOptions?: Record<string, Record<string, any>> | undefined;
335
+ role: "tool";
336
+ content: {
337
+ providerOptions?: Record<string, Record<string, any>> | undefined;
338
+ args?: any;
339
+ providerExecuted?: boolean | undefined;
340
+ isError?: boolean | undefined;
341
+ experimental_content?: ({
342
+ type: "text";
343
+ text: string;
344
+ } | {
345
+ mimeType?: string | undefined;
346
+ type: "image";
347
+ data: string;
348
+ })[] | undefined;
349
+ type: "tool-result";
350
+ toolCallId: string;
351
+ toolName: string;
352
+ result: any;
353
+ }[];
354
+ } | {
355
+ providerOptions?: Record<string, Record<string, any>> | undefined;
356
+ role: "system";
357
+ content: string;
358
+ } | undefined;
359
+ text?: string | undefined;
360
+ reasoning?: string | undefined;
361
+ usage?: {
362
+ reasoningTokens?: number | undefined;
363
+ cachedInputTokens?: number | undefined;
364
+ promptTokens: number;
365
+ completionTokens: number;
366
+ totalTokens: number;
367
+ } | undefined;
368
+ providerMetadata?: Record<string, Record<string, any>> | undefined;
369
+ sources?: ({
370
+ title?: string | undefined;
371
+ type?: "source" | undefined;
372
+ providerOptions?: Record<string, Record<string, any>> | undefined;
373
+ id: string;
374
+ sourceType: "url";
375
+ url: string;
376
+ } | {
377
+ filename?: string | undefined;
378
+ providerMetadata?: Record<string, Record<string, any>> | undefined;
379
+ id: string;
380
+ title: string;
381
+ type: "source";
382
+ sourceType: "document";
383
+ mediaType: string;
384
+ })[] | undefined;
385
+ warnings?: ({
386
+ details?: string | undefined;
387
+ type: "unsupported-setting";
388
+ setting: string;
389
+ } | {
390
+ details?: string | undefined;
391
+ type: "unsupported-tool";
392
+ tool: any;
393
+ } | {
394
+ type: "other";
395
+ message: string;
396
+ })[] | undefined;
397
+ finishReason?: "length" | "error" | "other" | "stop" | "content-filter" | "tool-calls" | "unknown" | undefined;
398
+ reasoningDetails?: ({
399
+ providerOptions?: Record<string, Record<string, any>> | undefined;
400
+ signature?: string | undefined;
401
+ state?: "streaming" | "done" | undefined;
402
+ type: "reasoning";
403
+ text: string;
404
+ } | {
405
+ signature?: string | undefined;
406
+ type: "text";
407
+ text: string;
408
+ } | {
409
+ type: "redacted";
410
+ data: string;
411
+ })[] | undefined;
412
+ _id: string;
413
+ _creationTime: number;
414
+ status: "pending" | "success" | "failed";
415
+ order: number;
416
+ threadId: string;
417
+ stepOrder: number;
418
+ tool: boolean;
419
+ }[], import("convex/values").VObject<{
420
+ id?: string | undefined;
421
+ userId?: string | undefined;
422
+ embeddingId?: string | undefined;
423
+ fileIds?: string[] | undefined;
424
+ error?: string | undefined;
425
+ agentName?: string | undefined;
426
+ model?: string | undefined;
427
+ provider?: string | undefined;
428
+ providerOptions?: Record<string, Record<string, any>> | undefined;
429
+ message?: {
430
+ providerOptions?: Record<string, Record<string, any>> | undefined;
431
+ role: "user";
432
+ content: string | ({
433
+ providerOptions?: Record<string, Record<string, any>> | undefined;
434
+ type: "text";
435
+ text: string;
436
+ } | {
437
+ providerOptions?: Record<string, Record<string, any>> | undefined;
438
+ mimeType?: string | undefined;
439
+ type: "image";
440
+ image: string | ArrayBuffer;
441
+ } | {
442
+ providerOptions?: Record<string, Record<string, any>> | undefined;
443
+ filename?: string | undefined;
444
+ type: "file";
445
+ mimeType: string;
446
+ data: string | ArrayBuffer;
447
+ })[];
448
+ } | {
449
+ providerOptions?: Record<string, Record<string, any>> | undefined;
450
+ role: "assistant";
451
+ content: string | ({
452
+ providerOptions?: Record<string, Record<string, any>> | undefined;
453
+ type: "text";
454
+ text: string;
455
+ } | {
456
+ providerOptions?: Record<string, Record<string, any>> | undefined;
457
+ filename?: string | undefined;
458
+ type: "file";
459
+ mimeType: string;
460
+ data: string | ArrayBuffer;
461
+ } | {
462
+ providerOptions?: Record<string, Record<string, any>> | undefined;
463
+ signature?: string | undefined;
464
+ state?: "streaming" | "done" | undefined;
465
+ type: "reasoning";
466
+ text: string;
467
+ } | {
468
+ providerOptions?: Record<string, Record<string, any>> | undefined;
469
+ type: "redacted-reasoning";
470
+ data: string;
471
+ } | {
472
+ providerOptions?: Record<string, Record<string, any>> | undefined;
473
+ providerExecuted?: boolean | undefined;
474
+ type: "tool-call";
475
+ toolCallId: string;
476
+ toolName: string;
477
+ args: any;
478
+ })[];
479
+ } | {
480
+ providerOptions?: Record<string, Record<string, any>> | undefined;
481
+ role: "tool";
482
+ content: {
483
+ providerOptions?: Record<string, Record<string, any>> | undefined;
484
+ args?: any;
485
+ providerExecuted?: boolean | undefined;
486
+ isError?: boolean | undefined;
487
+ experimental_content?: ({
488
+ type: "text";
489
+ text: string;
490
+ } | {
491
+ mimeType?: string | undefined;
492
+ type: "image";
493
+ data: string;
494
+ })[] | undefined;
495
+ type: "tool-result";
496
+ toolCallId: string;
497
+ toolName: string;
498
+ result: any;
499
+ }[];
500
+ } | {
501
+ providerOptions?: Record<string, Record<string, any>> | undefined;
502
+ role: "system";
503
+ content: string;
504
+ } | undefined;
505
+ text?: string | undefined;
506
+ reasoning?: string | undefined;
507
+ usage?: {
508
+ reasoningTokens?: number | undefined;
509
+ cachedInputTokens?: number | undefined;
510
+ promptTokens: number;
511
+ completionTokens: number;
512
+ totalTokens: number;
513
+ } | undefined;
514
+ providerMetadata?: Record<string, Record<string, any>> | undefined;
515
+ sources?: ({
516
+ title?: string | undefined;
517
+ type?: "source" | undefined;
518
+ providerOptions?: Record<string, Record<string, any>> | undefined;
519
+ id: string;
520
+ sourceType: "url";
521
+ url: string;
522
+ } | {
523
+ filename?: string | undefined;
524
+ providerMetadata?: Record<string, Record<string, any>> | undefined;
525
+ id: string;
526
+ title: string;
527
+ type: "source";
528
+ sourceType: "document";
529
+ mediaType: string;
530
+ })[] | undefined;
531
+ warnings?: ({
532
+ details?: string | undefined;
533
+ type: "unsupported-setting";
534
+ setting: string;
535
+ } | {
536
+ details?: string | undefined;
537
+ type: "unsupported-tool";
538
+ tool: any;
539
+ } | {
540
+ type: "other";
541
+ message: string;
542
+ })[] | undefined;
543
+ finishReason?: "length" | "error" | "other" | "stop" | "content-filter" | "tool-calls" | "unknown" | undefined;
544
+ reasoningDetails?: ({
545
+ providerOptions?: Record<string, Record<string, any>> | undefined;
546
+ signature?: string | undefined;
547
+ state?: "streaming" | "done" | undefined;
548
+ type: "reasoning";
549
+ text: string;
550
+ } | {
551
+ signature?: string | undefined;
552
+ type: "text";
553
+ text: string;
554
+ } | {
555
+ type: "redacted";
556
+ data: string;
557
+ })[] | undefined;
558
+ _id: string;
559
+ _creationTime: number;
560
+ status: "pending" | "success" | "failed";
561
+ order: number;
562
+ threadId: string;
563
+ stepOrder: number;
564
+ tool: boolean;
565
+ }, {
566
+ threadId: import("convex/values").VString<string, "required">;
567
+ embeddingId: import("convex/values").VString<string | undefined, "optional">;
568
+ fileIds: import("convex/values").VArray<string[] | undefined, import("convex/values").VString<string, "required">, "optional">;
569
+ userId: import("convex/values").VString<string | undefined, "optional">;
570
+ order: import("convex/values").VFloat64<number, "required">;
571
+ stepOrder: import("convex/values").VFloat64<number, "required">;
572
+ error: import("convex/values").VString<string | undefined, "optional">;
573
+ status: import("convex/values").VUnion<"pending" | "success" | "failed", [import("convex/values").VLiteral<"pending", "required">, import("convex/values").VLiteral<"success", "required">, import("convex/values").VLiteral<"failed", "required">], "required", never>;
574
+ agentName: import("convex/values").VString<string | undefined, "optional">;
575
+ model: import("convex/values").VString<string | undefined, "optional">;
576
+ provider: import("convex/values").VString<string | undefined, "optional">;
577
+ providerOptions: import("convex/values").VRecord<Record<string, Record<string, any>> | undefined, import("convex/values").VString<string, "required">, import("convex/values").VRecord<Record<string, any>, import("convex/values").VString<string, "required">, import("convex/values").VAny<any, "required", string>, "required", string>, "optional", string>;
578
+ message: import("convex/values").VUnion<{
579
+ providerOptions?: Record<string, Record<string, any>> | undefined;
580
+ role: "user";
581
+ content: string | ({
582
+ providerOptions?: Record<string, Record<string, any>> | undefined;
583
+ type: "text";
584
+ text: string;
585
+ } | {
586
+ providerOptions?: Record<string, Record<string, any>> | undefined;
587
+ mimeType?: string | undefined;
588
+ type: "image";
589
+ image: string | ArrayBuffer;
590
+ } | {
591
+ providerOptions?: Record<string, Record<string, any>> | undefined;
592
+ filename?: string | undefined;
593
+ type: "file";
594
+ mimeType: string;
595
+ data: string | ArrayBuffer;
596
+ })[];
597
+ } | {
598
+ providerOptions?: Record<string, Record<string, any>> | undefined;
599
+ role: "assistant";
600
+ content: string | ({
601
+ providerOptions?: Record<string, Record<string, any>> | undefined;
602
+ type: "text";
603
+ text: string;
604
+ } | {
605
+ providerOptions?: Record<string, Record<string, any>> | undefined;
606
+ filename?: string | undefined;
607
+ type: "file";
608
+ mimeType: string;
609
+ data: string | ArrayBuffer;
610
+ } | {
611
+ providerOptions?: Record<string, Record<string, any>> | undefined;
612
+ signature?: string | undefined;
613
+ state?: "streaming" | "done" | undefined;
614
+ type: "reasoning";
615
+ text: string;
616
+ } | {
617
+ providerOptions?: Record<string, Record<string, any>> | undefined;
618
+ type: "redacted-reasoning";
619
+ data: string;
620
+ } | {
621
+ providerOptions?: Record<string, Record<string, any>> | undefined;
622
+ providerExecuted?: boolean | undefined;
623
+ type: "tool-call";
624
+ toolCallId: string;
625
+ toolName: string;
626
+ args: any;
627
+ })[];
628
+ } | {
629
+ providerOptions?: Record<string, Record<string, any>> | undefined;
630
+ role: "tool";
631
+ content: {
632
+ providerOptions?: Record<string, Record<string, any>> | undefined;
633
+ args?: any;
634
+ providerExecuted?: boolean | undefined;
635
+ isError?: boolean | undefined;
636
+ experimental_content?: ({
637
+ type: "text";
638
+ text: string;
639
+ } | {
640
+ mimeType?: string | undefined;
641
+ type: "image";
642
+ data: string;
643
+ })[] | undefined;
644
+ type: "tool-result";
645
+ toolCallId: string;
646
+ toolName: string;
647
+ result: any;
648
+ }[];
649
+ } | {
650
+ providerOptions?: Record<string, Record<string, any>> | undefined;
651
+ role: "system";
652
+ content: string;
653
+ } | undefined, [import("convex/values").VObject<{
654
+ providerOptions?: Record<string, Record<string, any>> | undefined;
655
+ role: "user";
656
+ content: string | ({
657
+ providerOptions?: Record<string, Record<string, any>> | undefined;
658
+ type: "text";
659
+ text: string;
660
+ } | {
661
+ providerOptions?: Record<string, Record<string, any>> | undefined;
662
+ mimeType?: string | undefined;
663
+ type: "image";
664
+ image: string | ArrayBuffer;
665
+ } | {
666
+ providerOptions?: Record<string, Record<string, any>> | undefined;
667
+ filename?: string | undefined;
668
+ type: "file";
669
+ mimeType: string;
670
+ data: string | ArrayBuffer;
671
+ })[];
672
+ }, {
673
+ role: import("convex/values").VLiteral<"user", "required">;
674
+ content: import("convex/values").VUnion<string | ({
675
+ providerOptions?: Record<string, Record<string, any>> | undefined;
676
+ type: "text";
677
+ text: string;
678
+ } | {
679
+ providerOptions?: Record<string, Record<string, any>> | undefined;
680
+ mimeType?: string | undefined;
681
+ type: "image";
682
+ image: string | ArrayBuffer;
683
+ } | {
684
+ providerOptions?: Record<string, Record<string, any>> | undefined;
685
+ filename?: string | undefined;
686
+ type: "file";
687
+ mimeType: string;
688
+ data: string | ArrayBuffer;
689
+ })[], [import("convex/values").VString<string, "required">, import("convex/values").VArray<({
690
+ providerOptions?: Record<string, Record<string, any>> | undefined;
691
+ type: "text";
692
+ text: string;
693
+ } | {
694
+ providerOptions?: Record<string, Record<string, any>> | undefined;
695
+ mimeType?: string | undefined;
696
+ type: "image";
697
+ image: string | ArrayBuffer;
698
+ } | {
699
+ providerOptions?: Record<string, Record<string, any>> | undefined;
700
+ filename?: string | undefined;
701
+ type: "file";
702
+ mimeType: string;
703
+ data: string | ArrayBuffer;
704
+ })[], import("convex/values").VUnion<{
705
+ providerOptions?: Record<string, Record<string, any>> | undefined;
706
+ type: "text";
707
+ text: string;
708
+ } | {
709
+ providerOptions?: Record<string, Record<string, any>> | undefined;
710
+ mimeType?: string | undefined;
711
+ type: "image";
712
+ image: string | ArrayBuffer;
713
+ } | {
714
+ providerOptions?: Record<string, Record<string, any>> | undefined;
715
+ filename?: string | undefined;
716
+ type: "file";
717
+ mimeType: string;
718
+ data: string | ArrayBuffer;
719
+ }, [import("convex/values").VObject<{
720
+ providerOptions?: Record<string, Record<string, any>> | undefined;
721
+ type: "text";
722
+ text: string;
723
+ }, {
724
+ type: import("convex/values").VLiteral<"text", "required">;
725
+ text: import("convex/values").VString<string, "required">;
726
+ providerOptions: import("convex/values").VRecord<Record<string, Record<string, any>> | undefined, import("convex/values").VString<string, "required">, import("convex/values").VRecord<Record<string, any>, import("convex/values").VString<string, "required">, import("convex/values").VAny<any, "required", string>, "required", string>, "optional", string>;
727
+ }, "required", "type" | "providerOptions" | "text" | `providerOptions.${string}`>, import("convex/values").VObject<{
728
+ providerOptions?: Record<string, Record<string, any>> | undefined;
729
+ mimeType?: string | undefined;
730
+ type: "image";
731
+ image: string | ArrayBuffer;
732
+ }, {
733
+ type: import("convex/values").VLiteral<"image", "required">;
734
+ image: import("convex/values").VUnion<string | ArrayBuffer, [import("convex/values").VString<string, "required">, import("convex/values").VBytes<ArrayBuffer, "required">], "required", never>;
735
+ mimeType: import("convex/values").VString<string | undefined, "optional">;
736
+ providerOptions: import("convex/values").VRecord<Record<string, Record<string, any>> | undefined, import("convex/values").VString<string, "required">, import("convex/values").VRecord<Record<string, any>, import("convex/values").VString<string, "required">, import("convex/values").VAny<any, "required", string>, "required", string>, "optional", string>;
737
+ }, "required", "type" | "providerOptions" | `providerOptions.${string}` | "image" | "mimeType">, import("convex/values").VObject<{
738
+ providerOptions?: Record<string, Record<string, any>> | undefined;
739
+ filename?: string | undefined;
740
+ type: "file";
741
+ mimeType: string;
742
+ data: string | ArrayBuffer;
743
+ }, {
744
+ type: import("convex/values").VLiteral<"file", "required">;
745
+ data: import("convex/values").VUnion<string | ArrayBuffer, [import("convex/values").VString<string, "required">, import("convex/values").VBytes<ArrayBuffer, "required">], "required", never>;
746
+ filename: import("convex/values").VString<string | undefined, "optional">;
747
+ mimeType: import("convex/values").VString<string, "required">;
748
+ providerOptions: import("convex/values").VRecord<Record<string, Record<string, any>> | undefined, import("convex/values").VString<string, "required">, import("convex/values").VRecord<Record<string, any>, import("convex/values").VString<string, "required">, import("convex/values").VAny<any, "required", string>, "required", string>, "optional", string>;
749
+ }, "required", "type" | "providerOptions" | `providerOptions.${string}` | "mimeType" | "data" | "filename">], "required", "type" | "providerOptions" | "text" | `providerOptions.${string}` | "image" | "mimeType" | "data" | "filename">, "required">], "required", never>;
750
+ providerOptions: import("convex/values").VRecord<Record<string, Record<string, any>> | undefined, import("convex/values").VString<string, "required">, import("convex/values").VRecord<Record<string, any>, import("convex/values").VString<string, "required">, import("convex/values").VAny<any, "required", string>, "required", string>, "optional", string>;
751
+ }, "required", "providerOptions" | "role" | `providerOptions.${string}` | "content">, import("convex/values").VObject<{
752
+ providerOptions?: Record<string, Record<string, any>> | undefined;
753
+ role: "assistant";
754
+ content: string | ({
755
+ providerOptions?: Record<string, Record<string, any>> | undefined;
756
+ type: "text";
757
+ text: string;
758
+ } | {
759
+ providerOptions?: Record<string, Record<string, any>> | undefined;
760
+ filename?: string | undefined;
761
+ type: "file";
762
+ mimeType: string;
763
+ data: string | ArrayBuffer;
764
+ } | {
765
+ providerOptions?: Record<string, Record<string, any>> | undefined;
766
+ signature?: string | undefined;
767
+ state?: "streaming" | "done" | undefined;
768
+ type: "reasoning";
769
+ text: string;
770
+ } | {
771
+ providerOptions?: Record<string, Record<string, any>> | undefined;
772
+ type: "redacted-reasoning";
773
+ data: string;
774
+ } | {
775
+ providerOptions?: Record<string, Record<string, any>> | undefined;
776
+ providerExecuted?: boolean | undefined;
777
+ type: "tool-call";
778
+ toolCallId: string;
779
+ toolName: string;
780
+ args: any;
781
+ })[];
782
+ }, {
783
+ role: import("convex/values").VLiteral<"assistant", "required">;
784
+ content: import("convex/values").VUnion<string | ({
785
+ providerOptions?: Record<string, Record<string, any>> | undefined;
786
+ type: "text";
787
+ text: string;
788
+ } | {
789
+ providerOptions?: Record<string, Record<string, any>> | undefined;
790
+ filename?: string | undefined;
791
+ type: "file";
792
+ mimeType: string;
793
+ data: string | ArrayBuffer;
794
+ } | {
795
+ providerOptions?: Record<string, Record<string, any>> | undefined;
796
+ signature?: string | undefined;
797
+ state?: "streaming" | "done" | undefined;
798
+ type: "reasoning";
799
+ text: string;
800
+ } | {
801
+ providerOptions?: Record<string, Record<string, any>> | undefined;
802
+ type: "redacted-reasoning";
803
+ data: string;
804
+ } | {
805
+ providerOptions?: Record<string, Record<string, any>> | undefined;
806
+ providerExecuted?: boolean | undefined;
807
+ type: "tool-call";
808
+ toolCallId: string;
809
+ toolName: string;
810
+ args: any;
811
+ })[], [import("convex/values").VString<string, "required">, import("convex/values").VArray<({
812
+ providerOptions?: Record<string, Record<string, any>> | undefined;
813
+ type: "text";
814
+ text: string;
815
+ } | {
816
+ providerOptions?: Record<string, Record<string, any>> | undefined;
817
+ filename?: string | undefined;
818
+ type: "file";
819
+ mimeType: string;
820
+ data: string | ArrayBuffer;
821
+ } | {
822
+ providerOptions?: Record<string, Record<string, any>> | undefined;
823
+ signature?: string | undefined;
824
+ state?: "streaming" | "done" | undefined;
825
+ type: "reasoning";
826
+ text: string;
827
+ } | {
828
+ providerOptions?: Record<string, Record<string, any>> | undefined;
829
+ type: "redacted-reasoning";
830
+ data: string;
831
+ } | {
832
+ providerOptions?: Record<string, Record<string, any>> | undefined;
833
+ providerExecuted?: boolean | undefined;
834
+ type: "tool-call";
835
+ toolCallId: string;
836
+ toolName: string;
837
+ args: any;
838
+ })[], import("convex/values").VUnion<{
839
+ providerOptions?: Record<string, Record<string, any>> | undefined;
840
+ type: "text";
841
+ text: string;
842
+ } | {
843
+ providerOptions?: Record<string, Record<string, any>> | undefined;
844
+ filename?: string | undefined;
845
+ type: "file";
846
+ mimeType: string;
847
+ data: string | ArrayBuffer;
848
+ } | {
849
+ providerOptions?: Record<string, Record<string, any>> | undefined;
850
+ signature?: string | undefined;
851
+ state?: "streaming" | "done" | undefined;
852
+ type: "reasoning";
853
+ text: string;
854
+ } | {
855
+ providerOptions?: Record<string, Record<string, any>> | undefined;
856
+ type: "redacted-reasoning";
857
+ data: string;
858
+ } | {
859
+ providerOptions?: Record<string, Record<string, any>> | undefined;
860
+ providerExecuted?: boolean | undefined;
861
+ type: "tool-call";
862
+ toolCallId: string;
863
+ toolName: string;
864
+ args: any;
865
+ }, [import("convex/values").VObject<{
866
+ providerOptions?: Record<string, Record<string, any>> | undefined;
867
+ type: "text";
868
+ text: string;
869
+ }, {
870
+ type: import("convex/values").VLiteral<"text", "required">;
871
+ text: import("convex/values").VString<string, "required">;
872
+ providerOptions: import("convex/values").VRecord<Record<string, Record<string, any>> | undefined, import("convex/values").VString<string, "required">, import("convex/values").VRecord<Record<string, any>, import("convex/values").VString<string, "required">, import("convex/values").VAny<any, "required", string>, "required", string>, "optional", string>;
873
+ }, "required", "type" | "providerOptions" | "text" | `providerOptions.${string}`>, import("convex/values").VObject<{
874
+ providerOptions?: Record<string, Record<string, any>> | undefined;
875
+ filename?: string | undefined;
876
+ type: "file";
877
+ mimeType: string;
878
+ data: string | ArrayBuffer;
879
+ }, {
880
+ type: import("convex/values").VLiteral<"file", "required">;
881
+ data: import("convex/values").VUnion<string | ArrayBuffer, [import("convex/values").VString<string, "required">, import("convex/values").VBytes<ArrayBuffer, "required">], "required", never>;
882
+ filename: import("convex/values").VString<string | undefined, "optional">;
883
+ mimeType: import("convex/values").VString<string, "required">;
884
+ providerOptions: import("convex/values").VRecord<Record<string, Record<string, any>> | undefined, import("convex/values").VString<string, "required">, import("convex/values").VRecord<Record<string, any>, import("convex/values").VString<string, "required">, import("convex/values").VAny<any, "required", string>, "required", string>, "optional", string>;
885
+ }, "required", "type" | "providerOptions" | `providerOptions.${string}` | "mimeType" | "data" | "filename">, import("convex/values").VObject<{
886
+ providerOptions?: Record<string, Record<string, any>> | undefined;
887
+ signature?: string | undefined;
888
+ state?: "streaming" | "done" | undefined;
889
+ type: "reasoning";
890
+ text: string;
891
+ }, {
892
+ type: import("convex/values").VLiteral<"reasoning", "required">;
893
+ text: import("convex/values").VString<string, "required">;
894
+ signature: import("convex/values").VString<string | undefined, "optional">;
895
+ providerOptions: import("convex/values").VRecord<Record<string, Record<string, any>> | undefined, import("convex/values").VString<string, "required">, import("convex/values").VRecord<Record<string, any>, import("convex/values").VString<string, "required">, import("convex/values").VAny<any, "required", string>, "required", string>, "optional", string>;
896
+ state: import("convex/values").VUnion<"streaming" | "done" | undefined, [import("convex/values").VLiteral<"streaming", "required">, import("convex/values").VLiteral<"done", "required">], "optional", never>;
897
+ }, "required", "type" | "providerOptions" | "text" | `providerOptions.${string}` | "signature" | "state">, import("convex/values").VObject<{
898
+ providerOptions?: Record<string, Record<string, any>> | undefined;
899
+ type: "redacted-reasoning";
900
+ data: string;
901
+ }, {
902
+ type: import("convex/values").VLiteral<"redacted-reasoning", "required">;
903
+ data: import("convex/values").VString<string, "required">;
904
+ providerOptions: import("convex/values").VRecord<Record<string, Record<string, any>> | undefined, import("convex/values").VString<string, "required">, import("convex/values").VRecord<Record<string, any>, import("convex/values").VString<string, "required">, import("convex/values").VAny<any, "required", string>, "required", string>, "optional", string>;
905
+ }, "required", "type" | "providerOptions" | `providerOptions.${string}` | "data">, import("convex/values").VObject<{
906
+ providerOptions?: Record<string, Record<string, any>> | undefined;
907
+ providerExecuted?: boolean | undefined;
908
+ type: "tool-call";
909
+ toolCallId: string;
910
+ toolName: string;
911
+ args: any;
912
+ }, {
913
+ type: import("convex/values").VLiteral<"tool-call", "required">;
914
+ toolCallId: import("convex/values").VString<string, "required">;
915
+ toolName: import("convex/values").VString<string, "required">;
916
+ args: import("convex/values").VAny<any, "required", string>;
917
+ providerOptions: import("convex/values").VRecord<Record<string, Record<string, any>> | undefined, import("convex/values").VString<string, "required">, import("convex/values").VRecord<Record<string, any>, import("convex/values").VString<string, "required">, import("convex/values").VAny<any, "required", string>, "required", string>, "optional", string>;
918
+ providerExecuted: import("convex/values").VBoolean<boolean | undefined, "optional">;
919
+ }, "required", "type" | "providerOptions" | `providerOptions.${string}` | "toolCallId" | "toolName" | "args" | "providerExecuted" | `args.${string}`>], "required", "type" | "providerOptions" | "text" | `providerOptions.${string}` | "mimeType" | "data" | "filename" | "signature" | "state" | "toolCallId" | "toolName" | "args" | "providerExecuted" | `args.${string}`>, "required">], "required", never>;
920
+ providerOptions: import("convex/values").VRecord<Record<string, Record<string, any>> | undefined, import("convex/values").VString<string, "required">, import("convex/values").VRecord<Record<string, any>, import("convex/values").VString<string, "required">, import("convex/values").VAny<any, "required", string>, "required", string>, "optional", string>;
921
+ }, "required", "providerOptions" | "role" | `providerOptions.${string}` | "content">, import("convex/values").VObject<{
922
+ providerOptions?: Record<string, Record<string, any>> | undefined;
923
+ role: "tool";
924
+ content: {
925
+ providerOptions?: Record<string, Record<string, any>> | undefined;
926
+ args?: any;
927
+ providerExecuted?: boolean | undefined;
928
+ isError?: boolean | undefined;
929
+ experimental_content?: ({
930
+ type: "text";
931
+ text: string;
932
+ } | {
933
+ mimeType?: string | undefined;
934
+ type: "image";
935
+ data: string;
936
+ })[] | undefined;
937
+ type: "tool-result";
938
+ toolCallId: string;
939
+ toolName: string;
940
+ result: any;
941
+ }[];
942
+ }, {
943
+ role: import("convex/values").VLiteral<"tool", "required">;
944
+ content: import("convex/values").VArray<{
945
+ providerOptions?: Record<string, Record<string, any>> | undefined;
946
+ args?: any;
947
+ providerExecuted?: boolean | undefined;
948
+ isError?: boolean | undefined;
949
+ experimental_content?: ({
950
+ type: "text";
951
+ text: string;
952
+ } | {
953
+ mimeType?: string | undefined;
954
+ type: "image";
955
+ data: string;
956
+ })[] | undefined;
957
+ type: "tool-result";
958
+ toolCallId: string;
959
+ toolName: string;
960
+ result: any;
961
+ }[], import("convex/values").VObject<{
962
+ providerOptions?: Record<string, Record<string, any>> | undefined;
963
+ args?: any;
964
+ providerExecuted?: boolean | undefined;
965
+ isError?: boolean | undefined;
966
+ experimental_content?: ({
967
+ type: "text";
968
+ text: string;
969
+ } | {
970
+ mimeType?: string | undefined;
971
+ type: "image";
972
+ data: string;
973
+ })[] | undefined;
974
+ type: "tool-result";
975
+ toolCallId: string;
976
+ toolName: string;
977
+ result: any;
978
+ }, {
979
+ type: import("convex/values").VLiteral<"tool-result", "required">;
980
+ toolCallId: import("convex/values").VString<string, "required">;
981
+ toolName: import("convex/values").VString<string, "required">;
982
+ result: import("convex/values").VAny<any, "required", string>;
983
+ providerOptions: import("convex/values").VRecord<Record<string, Record<string, any>> | undefined, import("convex/values").VString<string, "required">, import("convex/values").VRecord<Record<string, any>, import("convex/values").VString<string, "required">, import("convex/values").VAny<any, "required", string>, "required", string>, "optional", string>;
984
+ providerExecuted: import("convex/values").VBoolean<boolean | undefined, "optional">;
985
+ isError: import("convex/values").VBoolean<boolean | undefined, "optional">;
986
+ args: import("convex/values").VAny<any, "optional", string>;
987
+ experimental_content: import("convex/values").VArray<({
988
+ type: "text";
989
+ text: string;
990
+ } | {
991
+ mimeType?: string | undefined;
992
+ type: "image";
993
+ data: string;
994
+ })[] | undefined, import("convex/values").VUnion<{
995
+ type: "text";
996
+ text: string;
997
+ } | {
998
+ mimeType?: string | undefined;
999
+ type: "image";
1000
+ data: string;
1001
+ }, [import("convex/values").VObject<{
1002
+ type: "text";
1003
+ text: string;
1004
+ }, {
1005
+ type: import("convex/values").VLiteral<"text", "required">;
1006
+ text: import("convex/values").VString<string, "required">;
1007
+ }, "required", "type" | "text">, import("convex/values").VObject<{
1008
+ mimeType?: string | undefined;
1009
+ type: "image";
1010
+ data: string;
1011
+ }, {
1012
+ type: import("convex/values").VLiteral<"image", "required">;
1013
+ data: import("convex/values").VString<string, "required">;
1014
+ mimeType: import("convex/values").VString<string | undefined, "optional">;
1015
+ }, "required", "type" | "mimeType" | "data">], "required", "type" | "text" | "mimeType" | "data">, "optional">;
1016
+ }, "required", "type" | "providerOptions" | `providerOptions.${string}` | "toolCallId" | "toolName" | "args" | "providerExecuted" | `args.${string}` | "result" | "isError" | "experimental_content" | `result.${string}`>, "required">;
1017
+ providerOptions: import("convex/values").VRecord<Record<string, Record<string, any>> | undefined, import("convex/values").VString<string, "required">, import("convex/values").VRecord<Record<string, any>, import("convex/values").VString<string, "required">, import("convex/values").VAny<any, "required", string>, "required", string>, "optional", string>;
1018
+ }, "required", "providerOptions" | "role" | `providerOptions.${string}` | "content">, import("convex/values").VObject<{
1019
+ providerOptions?: Record<string, Record<string, any>> | undefined;
1020
+ role: "system";
1021
+ content: string;
1022
+ }, {
1023
+ role: import("convex/values").VLiteral<"system", "required">;
1024
+ content: import("convex/values").VString<string, "required">;
1025
+ providerOptions: import("convex/values").VRecord<Record<string, Record<string, any>> | undefined, import("convex/values").VString<string, "required">, import("convex/values").VRecord<Record<string, any>, import("convex/values").VString<string, "required">, import("convex/values").VAny<any, "required", string>, "required", string>, "optional", string>;
1026
+ }, "required", "providerOptions" | "role" | `providerOptions.${string}` | "content">], "optional", "providerOptions" | "role" | `providerOptions.${string}` | "content">;
1027
+ tool: import("convex/values").VBoolean<boolean, "required">;
1028
+ text: import("convex/values").VString<string | undefined, "optional">;
1029
+ usage: import("convex/values").VObject<{
1030
+ reasoningTokens?: number | undefined;
1031
+ cachedInputTokens?: number | undefined;
1032
+ promptTokens: number;
1033
+ completionTokens: number;
1034
+ totalTokens: number;
1035
+ } | undefined, {
1036
+ promptTokens: import("convex/values").VFloat64<number, "required">;
1037
+ completionTokens: import("convex/values").VFloat64<number, "required">;
1038
+ totalTokens: import("convex/values").VFloat64<number, "required">;
1039
+ reasoningTokens: import("convex/values").VFloat64<number | undefined, "optional">;
1040
+ cachedInputTokens: import("convex/values").VFloat64<number | undefined, "optional">;
1041
+ }, "optional", "promptTokens" | "completionTokens" | "totalTokens" | "reasoningTokens" | "cachedInputTokens">;
1042
+ providerMetadata: import("convex/values").VRecord<Record<string, Record<string, any>> | undefined, import("convex/values").VString<string, "required">, import("convex/values").VRecord<Record<string, any>, import("convex/values").VString<string, "required">, import("convex/values").VAny<any, "required", string>, "required", string>, "optional", string>;
1043
+ sources: import("convex/values").VArray<({
1044
+ title?: string | undefined;
1045
+ type?: "source" | undefined;
1046
+ providerOptions?: Record<string, Record<string, any>> | undefined;
1047
+ id: string;
1048
+ sourceType: "url";
1049
+ url: string;
1050
+ } | {
1051
+ filename?: string | undefined;
1052
+ providerMetadata?: Record<string, Record<string, any>> | undefined;
1053
+ id: string;
1054
+ title: string;
1055
+ type: "source";
1056
+ sourceType: "document";
1057
+ mediaType: string;
1058
+ })[] | undefined, import("convex/values").VUnion<{
1059
+ title?: string | undefined;
1060
+ type?: "source" | undefined;
1061
+ providerOptions?: Record<string, Record<string, any>> | undefined;
1062
+ id: string;
1063
+ sourceType: "url";
1064
+ url: string;
1065
+ } | {
1066
+ filename?: string | undefined;
1067
+ providerMetadata?: Record<string, Record<string, any>> | undefined;
1068
+ id: string;
1069
+ title: string;
1070
+ type: "source";
1071
+ sourceType: "document";
1072
+ mediaType: string;
1073
+ }, [import("convex/values").VObject<{
1074
+ title?: string | undefined;
1075
+ type?: "source" | undefined;
1076
+ providerOptions?: Record<string, Record<string, any>> | undefined;
1077
+ id: string;
1078
+ sourceType: "url";
1079
+ url: string;
1080
+ }, {
1081
+ type: import("convex/values").VLiteral<"source" | undefined, "optional">;
1082
+ sourceType: import("convex/values").VLiteral<"url", "required">;
1083
+ id: import("convex/values").VString<string, "required">;
1084
+ url: import("convex/values").VString<string, "required">;
1085
+ title: import("convex/values").VString<string | undefined, "optional">;
1086
+ providerOptions: import("convex/values").VRecord<Record<string, Record<string, any>> | undefined, import("convex/values").VString<string, "required">, import("convex/values").VRecord<Record<string, any>, import("convex/values").VString<string, "required">, import("convex/values").VAny<any, "required", string>, "required", string>, "optional", string>;
1087
+ }, "required", "id" | "title" | "type" | "providerOptions" | `providerOptions.${string}` | "sourceType" | "url">, import("convex/values").VObject<{
1088
+ filename?: string | undefined;
1089
+ providerMetadata?: Record<string, Record<string, any>> | undefined;
1090
+ id: string;
1091
+ title: string;
1092
+ type: "source";
1093
+ sourceType: "document";
1094
+ mediaType: string;
1095
+ }, {
1096
+ type: import("convex/values").VLiteral<"source", "required">;
1097
+ sourceType: import("convex/values").VLiteral<"document", "required">;
1098
+ id: import("convex/values").VString<string, "required">;
1099
+ mediaType: import("convex/values").VString<string, "required">;
1100
+ title: import("convex/values").VString<string, "required">;
1101
+ filename: import("convex/values").VString<string | undefined, "optional">;
1102
+ providerMetadata: import("convex/values").VRecord<Record<string, Record<string, any>> | undefined, import("convex/values").VString<string, "required">, import("convex/values").VRecord<Record<string, any>, import("convex/values").VString<string, "required">, import("convex/values").VAny<any, "required", string>, "required", string>, "optional", string>;
1103
+ }, "required", "id" | "title" | "type" | "filename" | "providerMetadata" | "sourceType" | "mediaType" | `providerMetadata.${string}`>], "required", "id" | "title" | "type" | "providerOptions" | `providerOptions.${string}` | "filename" | "providerMetadata" | "sourceType" | "url" | "mediaType" | `providerMetadata.${string}`>, "optional">;
1104
+ warnings: import("convex/values").VArray<({
1105
+ details?: string | undefined;
1106
+ type: "unsupported-setting";
1107
+ setting: string;
1108
+ } | {
1109
+ details?: string | undefined;
1110
+ type: "unsupported-tool";
1111
+ tool: any;
1112
+ } | {
1113
+ type: "other";
1114
+ message: string;
1115
+ })[] | undefined, import("convex/values").VUnion<{
1116
+ details?: string | undefined;
1117
+ type: "unsupported-setting";
1118
+ setting: string;
1119
+ } | {
1120
+ details?: string | undefined;
1121
+ type: "unsupported-tool";
1122
+ tool: any;
1123
+ } | {
1124
+ type: "other";
1125
+ message: string;
1126
+ }, [import("convex/values").VObject<{
1127
+ details?: string | undefined;
1128
+ type: "unsupported-setting";
1129
+ setting: string;
1130
+ }, {
1131
+ type: import("convex/values").VLiteral<"unsupported-setting", "required">;
1132
+ setting: import("convex/values").VString<string, "required">;
1133
+ details: import("convex/values").VString<string | undefined, "optional">;
1134
+ }, "required", "type" | "setting" | "details">, import("convex/values").VObject<{
1135
+ details?: string | undefined;
1136
+ type: "unsupported-tool";
1137
+ tool: any;
1138
+ }, {
1139
+ type: import("convex/values").VLiteral<"unsupported-tool", "required">;
1140
+ tool: import("convex/values").VAny<any, "required", string>;
1141
+ details: import("convex/values").VString<string | undefined, "optional">;
1142
+ }, "required", "type" | "tool" | "details" | `tool.${string}`>, import("convex/values").VObject<{
1143
+ type: "other";
1144
+ message: string;
1145
+ }, {
1146
+ type: import("convex/values").VLiteral<"other", "required">;
1147
+ message: import("convex/values").VString<string, "required">;
1148
+ }, "required", "type" | "message">], "required", "type" | "message" | "tool" | "setting" | "details" | `tool.${string}`>, "optional">;
1149
+ finishReason: import("convex/values").VUnion<"length" | "error" | "other" | "stop" | "content-filter" | "tool-calls" | "unknown" | undefined, [import("convex/values").VLiteral<"stop", "required">, import("convex/values").VLiteral<"length", "required">, import("convex/values").VLiteral<"content-filter", "required">, import("convex/values").VLiteral<"tool-calls", "required">, import("convex/values").VLiteral<"error", "required">, import("convex/values").VLiteral<"other", "required">, import("convex/values").VLiteral<"unknown", "required">], "optional", never>;
1150
+ reasoning: import("convex/values").VString<string | undefined, "optional">;
1151
+ reasoningDetails: import("convex/values").VArray<({
1152
+ providerOptions?: Record<string, Record<string, any>> | undefined;
1153
+ signature?: string | undefined;
1154
+ state?: "streaming" | "done" | undefined;
1155
+ type: "reasoning";
1156
+ text: string;
1157
+ } | {
1158
+ signature?: string | undefined;
1159
+ type: "text";
1160
+ text: string;
1161
+ } | {
1162
+ type: "redacted";
1163
+ data: string;
1164
+ })[] | undefined, import("convex/values").VUnion<{
1165
+ providerOptions?: Record<string, Record<string, any>> | undefined;
1166
+ signature?: string | undefined;
1167
+ state?: "streaming" | "done" | undefined;
1168
+ type: "reasoning";
1169
+ text: string;
1170
+ } | {
1171
+ signature?: string | undefined;
1172
+ type: "text";
1173
+ text: string;
1174
+ } | {
1175
+ type: "redacted";
1176
+ data: string;
1177
+ }, [import("convex/values").VObject<{
1178
+ providerOptions?: Record<string, Record<string, any>> | undefined;
1179
+ signature?: string | undefined;
1180
+ state?: "streaming" | "done" | undefined;
1181
+ type: "reasoning";
1182
+ text: string;
1183
+ }, {
1184
+ type: import("convex/values").VLiteral<"reasoning", "required">;
1185
+ text: import("convex/values").VString<string, "required">;
1186
+ signature: import("convex/values").VString<string | undefined, "optional">;
1187
+ providerOptions: import("convex/values").VRecord<Record<string, Record<string, any>> | undefined, import("convex/values").VString<string, "required">, import("convex/values").VRecord<Record<string, any>, import("convex/values").VString<string, "required">, import("convex/values").VAny<any, "required", string>, "required", string>, "optional", string>;
1188
+ state: import("convex/values").VUnion<"streaming" | "done" | undefined, [import("convex/values").VLiteral<"streaming", "required">, import("convex/values").VLiteral<"done", "required">], "optional", never>;
1189
+ }, "required", "type" | "providerOptions" | "text" | `providerOptions.${string}` | "signature" | "state">, import("convex/values").VObject<{
1190
+ signature?: string | undefined;
1191
+ type: "text";
1192
+ text: string;
1193
+ }, {
1194
+ type: import("convex/values").VLiteral<"text", "required">;
1195
+ text: import("convex/values").VString<string, "required">;
1196
+ signature: import("convex/values").VString<string | undefined, "optional">;
1197
+ }, "required", "type" | "text" | "signature">, import("convex/values").VObject<{
1198
+ type: "redacted";
1199
+ data: string;
1200
+ }, {
1201
+ type: import("convex/values").VLiteral<"redacted", "required">;
1202
+ data: import("convex/values").VString<string, "required">;
1203
+ }, "required", "type" | "data">], "required", "type" | "providerOptions" | "text" | `providerOptions.${string}` | "data" | "signature" | "state">, "optional">;
1204
+ id: import("convex/values").VString<string | undefined, "optional">;
1205
+ _id: import("convex/values").VString<string, "required">;
1206
+ _creationTime: import("convex/values").VFloat64<number, "required">;
1207
+ }, "required", "_id" | "_creationTime" | "id" | "status" | "userId" | "order" | "threadId" | "stepOrder" | "embeddingId" | "fileIds" | "error" | "agentName" | "model" | "provider" | "providerOptions" | "message" | "text" | `providerOptions.${string}` | "reasoning" | "tool" | "usage" | "providerMetadata" | "sources" | `providerMetadata.${string}` | "warnings" | "finishReason" | "reasoningDetails" | "message.providerOptions" | "message.role" | `message.providerOptions.${string}` | "message.content" | "usage.promptTokens" | "usage.completionTokens" | "usage.totalTokens" | "usage.reasoningTokens" | "usage.cachedInputTokens">, "required">;
1208
+ continueCursor: import("convex/values").VString<string, "required">;
1209
+ isDone: import("convex/values").VBoolean<boolean, "required">;
1210
+ splitCursor: import("convex/values").VUnion<string | null | undefined, [import("convex/values").VString<string, "required">, import("convex/values").VNull<null, "required">], "optional", never>;
1211
+ pageStatus: import("convex/values").VUnion<"SplitRecommended" | "SplitRequired" | null | undefined, [import("convex/values").VLiteral<"SplitRecommended", "required">, import("convex/values").VLiteral<"SplitRequired", "required">, import("convex/values").VNull<null, "required">], "optional", never>;
1212
+ }, "required", "page" | "continueCursor" | "isDone" | "splitCursor" | "pageStatus" | "streams" | "streams.messages" | "streams.kind" | "streams.deltas">;
4
1213
  /**
5
1214
  * A function that handles fetching stream deltas, used with the React hooks
6
1215
  * `useThreadMessages` or `useStreamingThreadMessages`.
@@ -10,9 +1219,9 @@ import type { AgentComponent, RunActionCtx, RunMutationCtx, RunQueryCtx, SyncStr
10
1219
  * @param args.streamArgs The stream arguments with per-stream cursors.
11
1220
  * @returns The deltas for each stream from their existing cursor.
12
1221
  */
13
- export declare function syncStreams(ctx: RunQueryCtx, component: AgentComponent, args: {
1222
+ export declare function syncStreams(ctx: RunQueryCtx, component: AgentComponent, { threadId, streamArgs, includeStatuses, }: {
14
1223
  threadId: string;
15
- streamArgs: StreamArgs | undefined;
1224
+ streamArgs?: StreamArgs | undefined;
16
1225
  includeStatuses?: ("streaming" | "finished" | "aborted")[];
17
1226
  }): Promise<SyncStreamsReturnValue | undefined>;
18
1227
  export declare function abortStream(ctx: RunMutationCtx, component: AgentComponent, args: {