@mastra/chroma 0.0.0-vnextWorkflows-20250422142014 → 0.0.0-workflow-deno-20250616130925

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.
@@ -0,0 +1,23 @@
1
+
2
+ > @mastra/chroma@0.10.3-alpha.0 build /home/runner/work/mastra/mastra/stores/chroma
3
+ > tsup src/index.ts --format esm,cjs --experimental-dts --clean --treeshake=smallest --splitting
4
+
5
+ CLI Building entry: src/index.ts
6
+ CLI Using tsconfig: tsconfig.json
7
+ CLI tsup v8.5.0
8
+ TSC Build start
9
+ TSC ⚡️ Build success in 8166ms
10
+ DTS Build start
11
+ CLI Target: es2022
12
+ Analysis will use the bundled TypeScript version 5.8.3
13
+ Writing package typings: /home/runner/work/mastra/mastra/stores/chroma/dist/_tsup-dts-rollup.d.ts
14
+ Analysis will use the bundled TypeScript version 5.8.3
15
+ Writing package typings: /home/runner/work/mastra/mastra/stores/chroma/dist/_tsup-dts-rollup.d.cts
16
+ DTS ⚡️ Build success in 8662ms
17
+ CLI Cleaning output folder
18
+ ESM Build start
19
+ CJS Build start
20
+ ESM dist/index.js 12.30 KB
21
+ ESM ⚡️ Build success in 313ms
22
+ CJS dist/index.cjs 12.35 KB
23
+ CJS ⚡️ Build success in 425ms
package/CHANGELOG.md CHANGED
@@ -1,20 +1,472 @@
1
1
  # @mastra/chroma
2
2
 
3
- ## 0.0.0-vnextWorkflows-20250422142014
3
+ ## 0.0.0-workflow-deno-20250616130925
4
4
 
5
5
  ### Patch Changes
6
6
 
7
+ - 63f6b7d: dependencies updates:
8
+ - Updated dependency [`chromadb@^2.4.6` ↗︎](https://www.npmjs.com/package/chromadb/v/2.4.6) (from `^2.2.0`, in `dependencies`)
9
+ - Updated dependencies [63f6b7d]
10
+ - Updated dependencies [ee9af57]
11
+ - Updated dependencies [36f1c36]
12
+ - Updated dependencies [10d352e]
13
+ - Updated dependencies [3ca9a67]
14
+ - Updated dependencies [53d3c37]
15
+ - Updated dependencies [577ce3a]
16
+ - Updated dependencies [9260b3a]
17
+ - @mastra/core@0.0.0-workflow-deno-20250616130925
18
+
19
+ ## 0.10.3-alpha.0
20
+
21
+ ### Patch Changes
22
+
23
+ - 63f6b7d: dependencies updates:
24
+ - Updated dependency [`chromadb@^2.4.6` ↗︎](https://www.npmjs.com/package/chromadb/v/2.4.6) (from `^2.2.0`, in `dependencies`)
25
+ - Updated dependencies [63f6b7d]
26
+ - Updated dependencies [36f1c36]
27
+ - Updated dependencies [10d352e]
28
+ - Updated dependencies [53d3c37]
29
+ - @mastra/core@0.10.6-alpha.0
30
+
31
+ ## 0.10.2
32
+
33
+ ### Patch Changes
34
+
35
+ - 66f4424: Update peerdeps
36
+ - Updated dependencies [d1ed912]
37
+ - Updated dependencies [f6fd25f]
38
+ - Updated dependencies [dffb67b]
39
+ - Updated dependencies [f1f1f1b]
40
+ - Updated dependencies [925ab94]
41
+ - Updated dependencies [f9816ae]
42
+ - Updated dependencies [82090c1]
43
+ - Updated dependencies [1b443fd]
44
+ - Updated dependencies [ce97900]
45
+ - Updated dependencies [f1309d3]
46
+ - Updated dependencies [14a2566]
47
+ - Updated dependencies [f7f8293]
48
+ - Updated dependencies [48eddb9]
49
+ - @mastra/core@0.10.4
50
+
51
+ ## 0.10.2-alpha.0
52
+
53
+ ### Patch Changes
54
+
55
+ - 66f4424: Update peerdeps
56
+
57
+ ## 0.10.1
58
+
59
+ ### Patch Changes
60
+
61
+ - f0d559f: Fix peerdeps for alpha channel
62
+ - Updated dependencies [ee77e78]
63
+ - Updated dependencies [592a2db]
64
+ - Updated dependencies [e5dc18d]
65
+ - Updated dependencies [ab5adbe]
66
+ - Updated dependencies [1e8bb40]
67
+ - Updated dependencies [1b5fc55]
68
+ - Updated dependencies [195c428]
69
+ - Updated dependencies [f73e11b]
70
+ - Updated dependencies [37643b8]
71
+ - Updated dependencies [99fd6cf]
72
+ - Updated dependencies [c5bf1ce]
73
+ - Updated dependencies [add596e]
74
+ - Updated dependencies [8dc94d8]
75
+ - Updated dependencies [ecebbeb]
76
+ - Updated dependencies [79d5145]
77
+ - Updated dependencies [12b7002]
78
+ - Updated dependencies [2901125]
79
+ - @mastra/core@0.10.2
80
+
81
+ ## 0.10.1-alpha.0
82
+
83
+ ### Patch Changes
84
+
85
+ - f0d559f: Fix peerdeps for alpha channel
86
+ - Updated dependencies [1e8bb40]
87
+ - @mastra/core@0.10.2-alpha.2
88
+
89
+ ## 0.10.0
90
+
91
+ ### Minor Changes
92
+
93
+ - 83da932: Move @mastra/core to peerdeps
94
+
95
+ ### Patch Changes
96
+
97
+ - d0ee3c6: Change all public functions and constructors in vector stores to use named args and prepare to phase out positional args
98
+ - a7292b0: BREAKING(@mastra/core, all vector stores): Vector store breaking changes (remove deprecated functions and positional arguments)
99
+ - Updated dependencies [b3a3d63]
100
+ - Updated dependencies [344f453]
101
+ - Updated dependencies [0a3ae6d]
102
+ - Updated dependencies [95911be]
103
+ - Updated dependencies [f53a6ac]
104
+ - Updated dependencies [5eb5a99]
105
+ - Updated dependencies [7e632c5]
106
+ - Updated dependencies [1e9fbfa]
107
+ - Updated dependencies [eabdcd9]
108
+ - Updated dependencies [90be034]
109
+ - Updated dependencies [99f050a]
110
+ - Updated dependencies [d0ee3c6]
111
+ - Updated dependencies [b2ae5aa]
112
+ - Updated dependencies [23f258c]
113
+ - Updated dependencies [a7292b0]
114
+ - Updated dependencies [0dcb9f0]
115
+ - Updated dependencies [2672a05]
116
+ - @mastra/core@0.10.0
117
+
118
+ ## 0.3.0-alpha.1
119
+
120
+ ### Minor Changes
121
+
122
+ - 83da932: Move @mastra/core to peerdeps
123
+
124
+ ### Patch Changes
125
+
126
+ - a7292b0: BREAKING(@mastra/core, all vector stores): Vector store breaking changes (remove deprecated functions and positional arguments)
127
+ - Updated dependencies [b3a3d63]
128
+ - Updated dependencies [344f453]
129
+ - Updated dependencies [0a3ae6d]
130
+ - Updated dependencies [95911be]
131
+ - Updated dependencies [5eb5a99]
132
+ - Updated dependencies [7e632c5]
133
+ - Updated dependencies [1e9fbfa]
134
+ - Updated dependencies [b2ae5aa]
135
+ - Updated dependencies [a7292b0]
136
+ - Updated dependencies [0dcb9f0]
137
+ - @mastra/core@0.10.0-alpha.1
138
+
139
+ ## 0.2.16-alpha.0
140
+
141
+ ### Patch Changes
142
+
143
+ - d0ee3c6: Change all public functions and constructors in vector stores to use named args and prepare to phase out positional args
144
+ - Updated dependencies [f53a6ac]
145
+ - Updated dependencies [eabdcd9]
146
+ - Updated dependencies [90be034]
147
+ - Updated dependencies [99f050a]
148
+ - Updated dependencies [d0ee3c6]
149
+ - Updated dependencies [23f258c]
150
+ - Updated dependencies [2672a05]
151
+ - @mastra/core@0.9.5-alpha.0
152
+
153
+ ## 0.2.15
154
+
155
+ ### Patch Changes
156
+
157
+ - c3bd795: [MASTRA-3358] Deprecate updateIndexById and deleteIndexById
158
+ - Updated dependencies [396be50]
159
+ - Updated dependencies [ab80e7e]
160
+ - Updated dependencies [c3bd795]
161
+ - Updated dependencies [da082f8]
162
+ - Updated dependencies [a5810ce]
163
+ - Updated dependencies [3e9c131]
164
+ - Updated dependencies [3171b5b]
165
+ - Updated dependencies [973e5ac]
166
+ - Updated dependencies [daf942f]
167
+ - Updated dependencies [0b8b868]
168
+ - Updated dependencies [9e1eff5]
169
+ - Updated dependencies [6fa1ad1]
170
+ - Updated dependencies [c28d7a0]
171
+ - Updated dependencies [edf1e88]
172
+ - @mastra/core@0.9.4
173
+
174
+ ## 0.2.15-alpha.4
175
+
176
+ ### Patch Changes
177
+
178
+ - Updated dependencies [3e9c131]
179
+ - @mastra/core@0.9.4-alpha.4
180
+
181
+ ## 0.2.15-alpha.3
182
+
183
+ ### Patch Changes
184
+
185
+ - c3bd795: [MASTRA-3358] Deprecate updateIndexById and deleteIndexById
186
+ - Updated dependencies [396be50]
187
+ - Updated dependencies [c3bd795]
188
+ - Updated dependencies [da082f8]
189
+ - Updated dependencies [a5810ce]
190
+ - @mastra/core@0.9.4-alpha.3
191
+
192
+ ## 0.2.15-alpha.2
193
+
194
+ ### Patch Changes
195
+
196
+ - Updated dependencies [3171b5b]
197
+ - Updated dependencies [973e5ac]
198
+ - Updated dependencies [9e1eff5]
199
+ - @mastra/core@0.9.4-alpha.2
200
+
201
+ ## 0.2.15-alpha.1
202
+
203
+ ### Patch Changes
204
+
205
+ - Updated dependencies [ab80e7e]
206
+ - Updated dependencies [6fa1ad1]
207
+ - Updated dependencies [c28d7a0]
208
+ - Updated dependencies [edf1e88]
209
+ - @mastra/core@0.9.4-alpha.1
210
+
211
+ ## 0.2.15-alpha.0
212
+
213
+ ### Patch Changes
214
+
215
+ - Updated dependencies [daf942f]
216
+ - Updated dependencies [0b8b868]
217
+ - @mastra/core@0.9.4-alpha.0
218
+
219
+ ## 0.2.14
220
+
221
+ ### Patch Changes
222
+
223
+ - 9cd1a46: [MASTRA-3338] update naming scheme for embedding index based on vector store rules and added duplicate index checks
224
+ - Updated dependencies [e450778]
225
+ - Updated dependencies [8902157]
226
+ - Updated dependencies [ca0dc88]
227
+ - Updated dependencies [526c570]
228
+ - Updated dependencies [d7a6a33]
229
+ - Updated dependencies [9cd1a46]
230
+ - Updated dependencies [b5d2de0]
231
+ - Updated dependencies [644f8ad]
232
+ - Updated dependencies [70dbf51]
233
+ - @mastra/core@0.9.3
234
+
235
+ ## 0.2.14-alpha.1
236
+
237
+ ### Patch Changes
238
+
239
+ - 9cd1a46: [MASTRA-3338] update naming scheme for embedding index based on vector store rules and added duplicate index checks
240
+ - Updated dependencies [e450778]
241
+ - Updated dependencies [8902157]
242
+ - Updated dependencies [ca0dc88]
243
+ - Updated dependencies [9cd1a46]
244
+ - Updated dependencies [70dbf51]
245
+ - @mastra/core@0.9.3-alpha.1
246
+
247
+ ## 0.2.14-alpha.0
248
+
249
+ ### Patch Changes
250
+
251
+ - Updated dependencies [526c570]
252
+ - Updated dependencies [b5d2de0]
253
+ - Updated dependencies [644f8ad]
254
+ - @mastra/core@0.9.3-alpha.0
255
+
256
+ ## 0.2.13
257
+
258
+ ### Patch Changes
259
+
260
+ - Updated dependencies [6052aa6]
261
+ - Updated dependencies [967b41c]
262
+ - Updated dependencies [3d2fb5c]
263
+ - Updated dependencies [26738f4]
264
+ - Updated dependencies [4155f47]
265
+ - Updated dependencies [7eeb2bc]
266
+ - Updated dependencies [b804723]
267
+ - Updated dependencies [8607972]
268
+ - Updated dependencies [ccef9f9]
269
+ - Updated dependencies [0097d50]
270
+ - Updated dependencies [7eeb2bc]
271
+ - Updated dependencies [17826a9]
272
+ - Updated dependencies [7d8b7c7]
273
+ - Updated dependencies [fba031f]
274
+ - Updated dependencies [3a5f1e1]
275
+ - Updated dependencies [51e6923]
276
+ - Updated dependencies [8398d89]
277
+ - @mastra/core@0.9.2
278
+
279
+ ## 0.2.13-alpha.6
280
+
281
+ ### Patch Changes
282
+
283
+ - Updated dependencies [6052aa6]
284
+ - Updated dependencies [7d8b7c7]
285
+ - Updated dependencies [3a5f1e1]
286
+ - Updated dependencies [8398d89]
287
+ - @mastra/core@0.9.2-alpha.6
288
+
289
+ ## 0.2.13-alpha.5
290
+
291
+ ### Patch Changes
292
+
293
+ - Updated dependencies [3d2fb5c]
294
+ - Updated dependencies [7eeb2bc]
295
+ - Updated dependencies [8607972]
296
+ - Updated dependencies [7eeb2bc]
297
+ - Updated dependencies [fba031f]
298
+ - @mastra/core@0.9.2-alpha.5
299
+
300
+ ## 0.2.13-alpha.4
301
+
302
+ ### Patch Changes
303
+
304
+ - Updated dependencies [ccef9f9]
305
+ - Updated dependencies [51e6923]
306
+ - @mastra/core@0.9.2-alpha.4
307
+
308
+ ## 0.2.13-alpha.3
309
+
310
+ ### Patch Changes
311
+
312
+ - Updated dependencies [967b41c]
313
+ - Updated dependencies [4155f47]
314
+ - Updated dependencies [17826a9]
315
+ - @mastra/core@0.9.2-alpha.3
316
+
317
+ ## 0.2.13-alpha.2
318
+
319
+ ### Patch Changes
320
+
321
+ - Updated dependencies [26738f4]
322
+ - @mastra/core@0.9.2-alpha.2
323
+
324
+ ## 0.2.13-alpha.1
325
+
326
+ ### Patch Changes
327
+
328
+ - Updated dependencies [b804723]
329
+ - @mastra/core@0.9.2-alpha.1
330
+
331
+ ## 0.2.13-alpha.0
332
+
333
+ ### Patch Changes
334
+
335
+ - Updated dependencies [0097d50]
336
+ - @mastra/core@0.9.2-alpha.0
337
+
338
+ ## 0.2.12
339
+
340
+ ### Patch Changes
341
+
342
+ - 5f826d9: Moved vector store specific prompts from @mastra/rag to be exported from the store that the prompt belongs to, ie @mastra/pg
343
+ - Updated dependencies [405b63d]
344
+ - Updated dependencies [81fb7f6]
345
+ - Updated dependencies [20275d4]
346
+ - Updated dependencies [7d1892c]
347
+ - Updated dependencies [a90a082]
348
+ - Updated dependencies [2d17c73]
349
+ - Updated dependencies [61e92f5]
350
+ - Updated dependencies [35955b0]
351
+ - Updated dependencies [6262bd5]
352
+ - Updated dependencies [c1409ef]
353
+ - Updated dependencies [3e7b69d]
354
+ - Updated dependencies [e4943b8]
355
+ - Updated dependencies [11d4485]
356
+ - Updated dependencies [479f490]
357
+ - Updated dependencies [c23a81c]
358
+ - Updated dependencies [2d4001d]
359
+ - Updated dependencies [c71013a]
360
+ - Updated dependencies [1d3b1cd]
361
+ - @mastra/core@0.9.1
362
+
363
+ ## 0.2.12-alpha.8
364
+
365
+ ### Patch Changes
366
+
367
+ - Updated dependencies [2d17c73]
368
+ - @mastra/core@0.9.1-alpha.8
369
+
370
+ ## 0.2.12-alpha.7
371
+
372
+ ### Patch Changes
373
+
374
+ - Updated dependencies [1d3b1cd]
375
+ - @mastra/core@0.9.1-alpha.7
376
+
377
+ ## 0.2.12-alpha.6
378
+
379
+ ### Patch Changes
380
+
381
+ - Updated dependencies [c23a81c]
382
+ - @mastra/core@0.9.1-alpha.6
383
+
384
+ ## 0.2.12-alpha.5
385
+
386
+ ### Patch Changes
387
+
388
+ - 5f826d9: Moved vector store specific prompts from @mastra/rag to be exported from the store that the prompt belongs to, ie @mastra/pg
389
+ - Updated dependencies [3e7b69d]
390
+ - @mastra/core@0.9.1-alpha.5
391
+
392
+ ## 0.2.12-alpha.4
393
+
394
+ ### Patch Changes
395
+
396
+ - Updated dependencies [e4943b8]
397
+ - Updated dependencies [479f490]
398
+ - @mastra/core@0.9.1-alpha.4
399
+
400
+ ## 0.2.12-alpha.3
401
+
402
+ ### Patch Changes
403
+
404
+ - Updated dependencies [6262bd5]
405
+ - @mastra/core@0.9.1-alpha.3
406
+
407
+ ## 0.2.12-alpha.2
408
+
409
+ ### Patch Changes
410
+
411
+ - Updated dependencies [405b63d]
412
+ - Updated dependencies [61e92f5]
413
+ - Updated dependencies [c71013a]
414
+ - @mastra/core@0.9.1-alpha.2
415
+
416
+ ## 0.2.12-alpha.1
417
+
418
+ ### Patch Changes
419
+
420
+ - Updated dependencies [20275d4]
421
+ - Updated dependencies [7d1892c]
422
+ - Updated dependencies [a90a082]
423
+ - Updated dependencies [35955b0]
424
+ - Updated dependencies [c1409ef]
425
+ - Updated dependencies [11d4485]
426
+ - Updated dependencies [2d4001d]
427
+ - @mastra/core@0.9.1-alpha.1
428
+
429
+ ## 0.2.12-alpha.0
430
+
431
+ ### Patch Changes
432
+
433
+ - Updated dependencies [81fb7f6]
434
+ - @mastra/core@0.9.1-alpha.0
435
+
436
+ ## 0.2.11
437
+
438
+ ### Patch Changes
439
+
440
+ - Updated dependencies [000a6d4]
7
441
  - Updated dependencies [08bb78e]
8
442
  - Updated dependencies [ed2f549]
9
443
  - Updated dependencies [7e92011]
10
444
  - Updated dependencies [9ee4293]
11
445
  - Updated dependencies [03f3cd0]
446
+ - Updated dependencies [c0f22b4]
12
447
  - Updated dependencies [71d9444]
13
448
  - Updated dependencies [157c741]
14
449
  - Updated dependencies [8a8a73b]
450
+ - Updated dependencies [0a033fa]
15
451
  - Updated dependencies [fe3ae4d]
452
+ - Updated dependencies [9c26508]
453
+ - Updated dependencies [0f4eae3]
454
+ - Updated dependencies [16a8648]
16
455
  - Updated dependencies [6f92295]
17
- - @mastra/core@0.0.0-vnextWorkflows-20250422142014
456
+ - @mastra/core@0.9.0
457
+
458
+ ## 0.2.11-alpha.8
459
+
460
+ ### Patch Changes
461
+
462
+ - Updated dependencies [000a6d4]
463
+ - Updated dependencies [ed2f549]
464
+ - Updated dependencies [c0f22b4]
465
+ - Updated dependencies [0a033fa]
466
+ - Updated dependencies [9c26508]
467
+ - Updated dependencies [0f4eae3]
468
+ - Updated dependencies [16a8648]
469
+ - @mastra/core@0.9.0-alpha.8
18
470
 
19
471
  ## 0.2.11-alpha.7
20
472
 
@@ -1,16 +1,25 @@
1
1
  import { BaseFilterTranslator } from '@mastra/core/vector/filter';
2
2
  import type { CreateIndexParams } from '@mastra/core/vector';
3
+ import type { DeleteIndexParams } from '@mastra/core/vector';
4
+ import type { DeleteVectorParams } from '@mastra/core/vector';
5
+ import type { DescribeIndexParams } from '@mastra/core/vector';
3
6
  import type { IndexStats } from '@mastra/core/vector';
4
7
  import { MastraVector } from '@mastra/core/vector';
5
8
  import type { OperatorSupport } from '@mastra/core/vector/filter';
6
- import type { ParamsToArgs } from '@mastra/core/vector';
7
9
  import type { QueryResult } from '@mastra/core/vector';
8
- import type { QueryVectorArgs } from '@mastra/core/vector';
9
10
  import type { QueryVectorParams } from '@mastra/core/vector';
10
- import type { UpsertVectorArgs } from '@mastra/core/vector';
11
+ import type { UpdateVectorParams } from '@mastra/core/vector';
11
12
  import type { UpsertVectorParams } from '@mastra/core/vector';
12
13
  import type { VectorFilter } from '@mastra/core/vector/filter';
13
14
 
15
+ /**
16
+ * Vector store specific prompt that details supported operators and examples.
17
+ * This prompt helps users construct valid filters for Chroma Vector.
18
+ */
19
+ declare const CHROMA_PROMPT = "When querying Chroma, you can ONLY use the operators listed below. Any other operators will be rejected.\nImportant: Don't explain how to construct the filter - use the specified operators and fields to search the content and return relevant results.\nIf a user tries to give an explicit operator that is not supported, reject the filter entirely and let them know that the operator is not supported.\n\nBasic Comparison Operators:\n- $eq: Exact match (default when using field: value)\n Example: { \"category\": \"electronics\" }\n- $ne: Not equal\n Example: { \"category\": { \"$ne\": \"electronics\" } }\n- $gt: Greater than\n Example: { \"price\": { \"$gt\": 100 } }\n- $gte: Greater than or equal\n Example: { \"price\": { \"$gte\": 100 } }\n- $lt: Less than\n Example: { \"price\": { \"$lt\": 100 } }\n- $lte: Less than or equal\n Example: { \"price\": { \"$lte\": 100 } }\n\nArray Operators:\n- $in: Match any value in array\n Example: { \"category\": { \"$in\": [\"electronics\", \"books\"] } }\n- $nin: Does not match any value in array\n Example: { \"category\": { \"$nin\": [\"electronics\", \"books\"] } }\n\nLogical Operators:\n- $and: Logical AND\n Example: { \"$and\": [{ \"price\": { \"$gt\": 100 } }, { \"category\": \"electronics\" }] }\n- $or: Logical OR\n Example: { \"$or\": [{ \"price\": { \"$lt\": 50 } }, { \"category\": \"books\" }] }\n\nRestrictions:\n- Regex patterns are not supported\n- Element operators are not supported\n- Only $and and $or logical operators are supported\n- Nested fields are supported using dot notation\n- Multiple conditions on the same field are supported with both implicit and explicit $and\n- Empty arrays in $in/$nin will return no results\n- If multiple top-level fields exist, they're wrapped in $and\n- Only logical operators ($and, $or) can be used at the top level\n- All other operators must be used within a field condition\n Valid: { \"field\": { \"$gt\": 100 } }\n Valid: { \"$and\": [...] }\n Invalid: { \"$gt\": 100 }\n Invalid: { \"$in\": [...] }\n- Logical operators must contain field conditions, not direct operators\n Valid: { \"$and\": [{ \"field\": { \"$gt\": 100 } }] }\n Invalid: { \"$and\": [{ \"$gt\": 100 }] }\n- Logical operators ($and, $or):\n - Can only be used at top level or nested within other logical operators\n - Can not be used on a field level, or be nested inside a field\n - Can not be used inside an operator\n - Valid: { \"$and\": [{ \"field\": { \"$gt\": 100 } }] }\n - Valid: { \"$or\": [{ \"$and\": [{ \"field\": { \"$gt\": 100 } }] }] }\n - Invalid: { \"field\": { \"$and\": [{ \"$gt\": 100 }] } }\n - Invalid: { \"field\": { \"$or\": [{ \"$gt\": 100 }] } }\n - Invalid: { \"field\": { \"$gt\": { \"$and\": [{...}] } } }\n\nExample Complex Query:\n{\n \"$and\": [\n { \"category\": { \"$in\": [\"electronics\", \"computers\"] } },\n { \"price\": { \"$gte\": 100, \"$lte\": 1000 } },\n { \"$or\": [\n { \"inStock\": true },\n { \"preorder\": true }\n ]}\n ]\n}";
20
+ export { CHROMA_PROMPT }
21
+ export { CHROMA_PROMPT as CHROMA_PROMPT_alias_1 }
22
+
14
23
  /**
15
24
  * Translator for Chroma filter queries.
16
25
  * Maintains MongoDB-compatible syntax while ensuring proper validation
@@ -23,14 +32,10 @@ export declare class ChromaFilterTranslator extends BaseFilterTranslator {
23
32
  private translateOperator;
24
33
  }
25
34
 
26
- declare type ChromaQueryArgs = [...QueryVectorArgs, VectorFilter?];
27
-
28
35
  declare interface ChromaQueryVectorParams extends QueryVectorParams {
29
36
  documentFilter?: VectorFilter;
30
37
  }
31
38
 
32
- declare type ChromaUpsertArgs = [...UpsertVectorArgs, string[]?];
33
-
34
39
  declare interface ChromaUpsertVectorParams extends UpsertVectorParams {
35
40
  documents?: string[];
36
41
  }
@@ -47,19 +52,39 @@ declare class ChromaVector extends MastraVector {
47
52
  });
48
53
  getCollection(indexName: string, throwIfNotExists?: boolean): Promise<any>;
49
54
  private validateVectorDimensions;
50
- upsert(...args: ParamsToArgs<ChromaUpsertVectorParams> | ChromaUpsertArgs): Promise<string[]>;
55
+ upsert({ indexName, vectors, metadata, ids, documents }: ChromaUpsertVectorParams): Promise<string[]>;
51
56
  private HnswSpaceMap;
52
- createIndex(...args: ParamsToArgs<CreateIndexParams>): Promise<void>;
57
+ createIndex({ indexName, dimension, metric }: CreateIndexParams): Promise<void>;
53
58
  transformFilter(filter?: VectorFilter): VectorFilter;
54
- query(...args: ParamsToArgs<ChromaQueryVectorParams> | ChromaQueryArgs): Promise<QueryResult[]>;
59
+ query({ indexName, queryVector, topK, filter, includeVector, documentFilter, }: ChromaQueryVectorParams): Promise<QueryResult[]>;
55
60
  listIndexes(): Promise<string[]>;
56
- describeIndex(indexName: string): Promise<IndexStats>;
57
- deleteIndex(indexName: string): Promise<void>;
58
- updateIndexById(indexName: string, id: string, update: {
59
- vector?: number[];
60
- metadata?: Record<string, any>;
61
- }): Promise<void>;
62
- deleteIndexById(indexName: string, id: string): Promise<void>;
61
+ /**
62
+ * Retrieves statistics about a vector index.
63
+ *
64
+ * @param {string} indexName - The name of the index to describe
65
+ * @returns A promise that resolves to the index statistics including dimension, count and metric
66
+ */
67
+ describeIndex({ indexName }: DescribeIndexParams): Promise<IndexStats>;
68
+ deleteIndex({ indexName }: DeleteIndexParams): Promise<void>;
69
+ /**
70
+ * Updates a vector by its ID with the provided vector and/or metadata.
71
+ * @param indexName - The name of the index containing the vector.
72
+ * @param id - The ID of the vector to update.
73
+ * @param update - An object containing the vector and/or metadata to update.
74
+ * @param update.vector - An optional array of numbers representing the new vector.
75
+ * @param update.metadata - An optional record containing the new metadata.
76
+ * @returns A promise that resolves when the update is complete.
77
+ * @throws Will throw an error if no updates are provided or if the update operation fails.
78
+ */
79
+ updateVector({ indexName, id, update }: UpdateVectorParams): Promise<void>;
80
+ /**
81
+ * Deletes a vector by its ID.
82
+ * @param indexName - The name of the index containing the vector.
83
+ * @param id - The ID of the vector to delete.
84
+ * @returns A promise that resolves when the deletion is complete.
85
+ * @throws Will throw an error if the deletion operation fails.
86
+ */
87
+ deleteVector({ indexName, id }: DeleteVectorParams): Promise<void>;
63
88
  }
64
89
  export { ChromaVector }
65
90
  export { ChromaVector as ChromaVector_alias_1 }
@@ -1,16 +1,25 @@
1
1
  import { BaseFilterTranslator } from '@mastra/core/vector/filter';
2
2
  import type { CreateIndexParams } from '@mastra/core/vector';
3
+ import type { DeleteIndexParams } from '@mastra/core/vector';
4
+ import type { DeleteVectorParams } from '@mastra/core/vector';
5
+ import type { DescribeIndexParams } from '@mastra/core/vector';
3
6
  import type { IndexStats } from '@mastra/core/vector';
4
7
  import { MastraVector } from '@mastra/core/vector';
5
8
  import type { OperatorSupport } from '@mastra/core/vector/filter';
6
- import type { ParamsToArgs } from '@mastra/core/vector';
7
9
  import type { QueryResult } from '@mastra/core/vector';
8
- import type { QueryVectorArgs } from '@mastra/core/vector';
9
10
  import type { QueryVectorParams } from '@mastra/core/vector';
10
- import type { UpsertVectorArgs } from '@mastra/core/vector';
11
+ import type { UpdateVectorParams } from '@mastra/core/vector';
11
12
  import type { UpsertVectorParams } from '@mastra/core/vector';
12
13
  import type { VectorFilter } from '@mastra/core/vector/filter';
13
14
 
15
+ /**
16
+ * Vector store specific prompt that details supported operators and examples.
17
+ * This prompt helps users construct valid filters for Chroma Vector.
18
+ */
19
+ declare const CHROMA_PROMPT = "When querying Chroma, you can ONLY use the operators listed below. Any other operators will be rejected.\nImportant: Don't explain how to construct the filter - use the specified operators and fields to search the content and return relevant results.\nIf a user tries to give an explicit operator that is not supported, reject the filter entirely and let them know that the operator is not supported.\n\nBasic Comparison Operators:\n- $eq: Exact match (default when using field: value)\n Example: { \"category\": \"electronics\" }\n- $ne: Not equal\n Example: { \"category\": { \"$ne\": \"electronics\" } }\n- $gt: Greater than\n Example: { \"price\": { \"$gt\": 100 } }\n- $gte: Greater than or equal\n Example: { \"price\": { \"$gte\": 100 } }\n- $lt: Less than\n Example: { \"price\": { \"$lt\": 100 } }\n- $lte: Less than or equal\n Example: { \"price\": { \"$lte\": 100 } }\n\nArray Operators:\n- $in: Match any value in array\n Example: { \"category\": { \"$in\": [\"electronics\", \"books\"] } }\n- $nin: Does not match any value in array\n Example: { \"category\": { \"$nin\": [\"electronics\", \"books\"] } }\n\nLogical Operators:\n- $and: Logical AND\n Example: { \"$and\": [{ \"price\": { \"$gt\": 100 } }, { \"category\": \"electronics\" }] }\n- $or: Logical OR\n Example: { \"$or\": [{ \"price\": { \"$lt\": 50 } }, { \"category\": \"books\" }] }\n\nRestrictions:\n- Regex patterns are not supported\n- Element operators are not supported\n- Only $and and $or logical operators are supported\n- Nested fields are supported using dot notation\n- Multiple conditions on the same field are supported with both implicit and explicit $and\n- Empty arrays in $in/$nin will return no results\n- If multiple top-level fields exist, they're wrapped in $and\n- Only logical operators ($and, $or) can be used at the top level\n- All other operators must be used within a field condition\n Valid: { \"field\": { \"$gt\": 100 } }\n Valid: { \"$and\": [...] }\n Invalid: { \"$gt\": 100 }\n Invalid: { \"$in\": [...] }\n- Logical operators must contain field conditions, not direct operators\n Valid: { \"$and\": [{ \"field\": { \"$gt\": 100 } }] }\n Invalid: { \"$and\": [{ \"$gt\": 100 }] }\n- Logical operators ($and, $or):\n - Can only be used at top level or nested within other logical operators\n - Can not be used on a field level, or be nested inside a field\n - Can not be used inside an operator\n - Valid: { \"$and\": [{ \"field\": { \"$gt\": 100 } }] }\n - Valid: { \"$or\": [{ \"$and\": [{ \"field\": { \"$gt\": 100 } }] }] }\n - Invalid: { \"field\": { \"$and\": [{ \"$gt\": 100 }] } }\n - Invalid: { \"field\": { \"$or\": [{ \"$gt\": 100 }] } }\n - Invalid: { \"field\": { \"$gt\": { \"$and\": [{...}] } } }\n\nExample Complex Query:\n{\n \"$and\": [\n { \"category\": { \"$in\": [\"electronics\", \"computers\"] } },\n { \"price\": { \"$gte\": 100, \"$lte\": 1000 } },\n { \"$or\": [\n { \"inStock\": true },\n { \"preorder\": true }\n ]}\n ]\n}";
20
+ export { CHROMA_PROMPT }
21
+ export { CHROMA_PROMPT as CHROMA_PROMPT_alias_1 }
22
+
14
23
  /**
15
24
  * Translator for Chroma filter queries.
16
25
  * Maintains MongoDB-compatible syntax while ensuring proper validation
@@ -23,14 +32,10 @@ export declare class ChromaFilterTranslator extends BaseFilterTranslator {
23
32
  private translateOperator;
24
33
  }
25
34
 
26
- declare type ChromaQueryArgs = [...QueryVectorArgs, VectorFilter?];
27
-
28
35
  declare interface ChromaQueryVectorParams extends QueryVectorParams {
29
36
  documentFilter?: VectorFilter;
30
37
  }
31
38
 
32
- declare type ChromaUpsertArgs = [...UpsertVectorArgs, string[]?];
33
-
34
39
  declare interface ChromaUpsertVectorParams extends UpsertVectorParams {
35
40
  documents?: string[];
36
41
  }
@@ -47,19 +52,39 @@ declare class ChromaVector extends MastraVector {
47
52
  });
48
53
  getCollection(indexName: string, throwIfNotExists?: boolean): Promise<any>;
49
54
  private validateVectorDimensions;
50
- upsert(...args: ParamsToArgs<ChromaUpsertVectorParams> | ChromaUpsertArgs): Promise<string[]>;
55
+ upsert({ indexName, vectors, metadata, ids, documents }: ChromaUpsertVectorParams): Promise<string[]>;
51
56
  private HnswSpaceMap;
52
- createIndex(...args: ParamsToArgs<CreateIndexParams>): Promise<void>;
57
+ createIndex({ indexName, dimension, metric }: CreateIndexParams): Promise<void>;
53
58
  transformFilter(filter?: VectorFilter): VectorFilter;
54
- query(...args: ParamsToArgs<ChromaQueryVectorParams> | ChromaQueryArgs): Promise<QueryResult[]>;
59
+ query({ indexName, queryVector, topK, filter, includeVector, documentFilter, }: ChromaQueryVectorParams): Promise<QueryResult[]>;
55
60
  listIndexes(): Promise<string[]>;
56
- describeIndex(indexName: string): Promise<IndexStats>;
57
- deleteIndex(indexName: string): Promise<void>;
58
- updateIndexById(indexName: string, id: string, update: {
59
- vector?: number[];
60
- metadata?: Record<string, any>;
61
- }): Promise<void>;
62
- deleteIndexById(indexName: string, id: string): Promise<void>;
61
+ /**
62
+ * Retrieves statistics about a vector index.
63
+ *
64
+ * @param {string} indexName - The name of the index to describe
65
+ * @returns A promise that resolves to the index statistics including dimension, count and metric
66
+ */
67
+ describeIndex({ indexName }: DescribeIndexParams): Promise<IndexStats>;
68
+ deleteIndex({ indexName }: DeleteIndexParams): Promise<void>;
69
+ /**
70
+ * Updates a vector by its ID with the provided vector and/or metadata.
71
+ * @param indexName - The name of the index containing the vector.
72
+ * @param id - The ID of the vector to update.
73
+ * @param update - An object containing the vector and/or metadata to update.
74
+ * @param update.vector - An optional array of numbers representing the new vector.
75
+ * @param update.metadata - An optional record containing the new metadata.
76
+ * @returns A promise that resolves when the update is complete.
77
+ * @throws Will throw an error if no updates are provided or if the update operation fails.
78
+ */
79
+ updateVector({ indexName, id, update }: UpdateVectorParams): Promise<void>;
80
+ /**
81
+ * Deletes a vector by its ID.
82
+ * @param indexName - The name of the index containing the vector.
83
+ * @param id - The ID of the vector to delete.
84
+ * @returns A promise that resolves when the deletion is complete.
85
+ * @throws Will throw an error if the deletion operation fails.
86
+ */
87
+ deleteVector({ indexName, id }: DeleteVectorParams): Promise<void>;
63
88
  }
64
89
  export { ChromaVector }
65
90
  export { ChromaVector as ChromaVector_alias_1 }