@mastra/s3vectors 1.0.0-beta.1 → 1.0.0-beta.3
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/CHANGELOG.md +27 -0
- package/dist/docs/README.md +32 -0
- package/dist/docs/SKILL.md +33 -0
- package/dist/docs/SOURCE_MAP.json +6 -0
- package/dist/docs/rag/01-vector-databases.md +638 -0
- package/dist/docs/rag/02-retrieval.md +549 -0
- package/dist/docs/vectors/01-reference.md +221 -0
- package/dist/index.cjs +14 -13
- package/dist/index.cjs.map +1 -1
- package/dist/index.js +14 -13
- package/dist/index.js.map +1 -1
- package/dist/vector/index.d.ts.map +1 -1
- package/package.json +7 -7
|
@@ -0,0 +1,221 @@
|
|
|
1
|
+
# Vectors API Reference
|
|
2
|
+
|
|
3
|
+
> API reference for vectors - 1 entries
|
|
4
|
+
|
|
5
|
+
|
|
6
|
+
---
|
|
7
|
+
|
|
8
|
+
## Reference: Amazon S3 Vectors Store
|
|
9
|
+
|
|
10
|
+
> Documentation for the S3Vectors class in Mastra, which provides vector search using Amazon S3 Vectors (Preview).
|
|
11
|
+
|
|
12
|
+
> ⚠️ Amazon S3 Vectors is a Preview service.
|
|
13
|
+
> Preview features may change or be removed without notice and are not covered by AWS SLAs.
|
|
14
|
+
> Behavior, limits, and regional availability can change at any time.
|
|
15
|
+
> This library may introduce breaking changes to stay aligned with AWS.
|
|
16
|
+
|
|
17
|
+
The `S3Vectors` class provides vector search using [Amazon S3 Vectors (Preview)](https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-vectors.html). It stores vectors in **vector buckets** and performs similarity search in **vector indexes**, with JSON-based metadata filters.
|
|
18
|
+
|
|
19
|
+
## Installation
|
|
20
|
+
|
|
21
|
+
```bash
|
|
22
|
+
npm install @mastra/s3vectors@beta
|
|
23
|
+
```
|
|
24
|
+
|
|
25
|
+
## Usage Example
|
|
26
|
+
|
|
27
|
+
```typescript
|
|
28
|
+
import { S3Vectors } from "@mastra/s3vectors";
|
|
29
|
+
|
|
30
|
+
const store = new S3Vectors({
|
|
31
|
+
vectorBucketName: process.env.S3_VECTORS_BUCKET_NAME!, // e.g. "my-vector-bucket"
|
|
32
|
+
clientConfig: {
|
|
33
|
+
region: process.env.AWS_REGION!, // credentials use the default AWS provider chain
|
|
34
|
+
},
|
|
35
|
+
// Optional: mark large/long-text fields as non-filterable at index creation time
|
|
36
|
+
nonFilterableMetadataKeys: ["content"],
|
|
37
|
+
});
|
|
38
|
+
|
|
39
|
+
// Create an index (names are normalized: "_" → "-" and lowercased)
|
|
40
|
+
await store.createIndex({
|
|
41
|
+
indexName: "my_index",
|
|
42
|
+
dimension: 1536,
|
|
43
|
+
metric: "cosine", // "euclidean" also supported; "dotproduct" is NOT supported
|
|
44
|
+
});
|
|
45
|
+
|
|
46
|
+
// Upsert vectors (ids auto-generated if omitted). Date values in metadata are serialized to epoch ms.
|
|
47
|
+
const ids = await store.upsert({
|
|
48
|
+
indexName: "my_index",
|
|
49
|
+
vectors: [
|
|
50
|
+
[0.1, 0.2 /* … */],
|
|
51
|
+
[0.3, 0.4 /* … */],
|
|
52
|
+
],
|
|
53
|
+
metadata: [
|
|
54
|
+
{
|
|
55
|
+
text: "doc1",
|
|
56
|
+
genre: "documentary",
|
|
57
|
+
year: 2023,
|
|
58
|
+
createdAt: new Date("2024-01-01"),
|
|
59
|
+
},
|
|
60
|
+
{ text: "doc2", genre: "comedy", year: 2021 },
|
|
61
|
+
],
|
|
62
|
+
});
|
|
63
|
+
|
|
64
|
+
// Query with metadata filters (implicit AND is canonicalized)
|
|
65
|
+
const results = await store.query({
|
|
66
|
+
indexName: "my-index",
|
|
67
|
+
queryVector: [0.1, 0.2 /* … */],
|
|
68
|
+
topK: 10, // Service-side limits may apply (commonly 30)
|
|
69
|
+
filter: { genre: { $in: ["documentary", "comedy"] }, year: { $gte: 2020 } },
|
|
70
|
+
includeVector: false, // set true to include raw vectors (may trigger a secondary fetch)
|
|
71
|
+
});
|
|
72
|
+
|
|
73
|
+
// Clean up resources (closes the underlying HTTP handler)
|
|
74
|
+
await store.disconnect();
|
|
75
|
+
```
|
|
76
|
+
|
|
77
|
+
## Constructor Options
|
|
78
|
+
|
|
79
|
+
## Methods
|
|
80
|
+
|
|
81
|
+
### createIndex()
|
|
82
|
+
|
|
83
|
+
Creates a new vector index in the configured vector bucket. If the index already exists, the call validates the schema and becomes a no-op (existing metric and dimension are preserved).
|
|
84
|
+
|
|
85
|
+
### upsert()
|
|
86
|
+
|
|
87
|
+
Adds or replaces vectors (full-record put). If `ids` are not provided, UUIDs are generated.
|
|
88
|
+
|
|
89
|
+
### query()
|
|
90
|
+
|
|
91
|
+
Searches for nearest neighbors with optional metadata filtering.
|
|
92
|
+
|
|
93
|
+
> **Scoring:** Results include `score = 1/(1 + distance)` so that higher is better while preserving the underlying distance ranking.
|
|
94
|
+
|
|
95
|
+
### describeIndex()
|
|
96
|
+
|
|
97
|
+
Returns information about the index.
|
|
98
|
+
|
|
99
|
+
Returns:
|
|
100
|
+
|
|
101
|
+
```typescript
|
|
102
|
+
interface IndexStats {
|
|
103
|
+
dimension: number;
|
|
104
|
+
count: number; // computed via ListVectors pagination (O(n))
|
|
105
|
+
metric: "cosine" | "euclidean";
|
|
106
|
+
}
|
|
107
|
+
```
|
|
108
|
+
|
|
109
|
+
### deleteIndex()
|
|
110
|
+
|
|
111
|
+
Deletes an index and its data.
|
|
112
|
+
|
|
113
|
+
### listIndexes()
|
|
114
|
+
|
|
115
|
+
Lists all indexes in the configured vector bucket.
|
|
116
|
+
|
|
117
|
+
Returns: `Promise<string[]>`
|
|
118
|
+
|
|
119
|
+
### updateVector()
|
|
120
|
+
|
|
121
|
+
Updates a vector or metadata for a specific ID within an index.
|
|
122
|
+
|
|
123
|
+
### deleteVector()
|
|
124
|
+
|
|
125
|
+
Deletes a specific vector by ID.
|
|
126
|
+
|
|
127
|
+
### disconnect()
|
|
128
|
+
|
|
129
|
+
Closes the underlying AWS SDK HTTP handler to free sockets.
|
|
130
|
+
|
|
131
|
+
## Response Types
|
|
132
|
+
|
|
133
|
+
Query results are returned in this format:
|
|
134
|
+
|
|
135
|
+
```typescript
|
|
136
|
+
interface QueryResult {
|
|
137
|
+
id: string;
|
|
138
|
+
score: number; // 1/(1 + distance)
|
|
139
|
+
metadata: Record<string, any>;
|
|
140
|
+
vector?: number[]; // Only included if includeVector is true
|
|
141
|
+
}
|
|
142
|
+
```
|
|
143
|
+
|
|
144
|
+
## Filter Syntax
|
|
145
|
+
|
|
146
|
+
S3 Vectors supports a strict subset of operators and value types. The Mastra filter translator:
|
|
147
|
+
|
|
148
|
+
- **Canonicalizes implicit AND**: `{a:1,b:2}` → `{ $and: [{a:1},{b:2}] }`.
|
|
149
|
+
- **Normalizes Date values** to epoch ms for numeric comparisons and array elements.
|
|
150
|
+
- **Disallows Date** in equality positions (`field: value` or `$eq/$ne`); equality values must be **string | number | boolean**.
|
|
151
|
+
- **Rejects** null/undefined for equality; **array equality** is not supported (use `$in`/`$nin`).
|
|
152
|
+
- Only **`$and` / `$or`** are allowed as top-level logical operators.
|
|
153
|
+
- Logical operators must contain **field conditions** (not direct operators).
|
|
154
|
+
|
|
155
|
+
**Supported operators:**
|
|
156
|
+
|
|
157
|
+
- **Logical:** `$and`, `$or` (non-empty arrays)
|
|
158
|
+
- **Basic:** `$eq`, `$ne` (string | number | boolean)
|
|
159
|
+
- **Numeric:** `$gt`, `$gte`, `$lt`, `$lte` (number or `Date` → epoch ms)
|
|
160
|
+
- **Array:** `$in`, `$nin` (non-empty arrays of string | number | boolean; `Date` → epoch ms)
|
|
161
|
+
- **Element:** `$exists` (boolean)
|
|
162
|
+
|
|
163
|
+
**Unsupported / disallowed (rejected):** `$not`, `$nor`, `$regex`, `$all`, `$elemMatch`, `$size`, `$text`, etc.
|
|
164
|
+
|
|
165
|
+
**Examples:**
|
|
166
|
+
|
|
167
|
+
```typescript
|
|
168
|
+
// Implicit AND
|
|
169
|
+
{ genre: { $in: ["documentary", "comedy"] }, year: { $gte: 2020 } }
|
|
170
|
+
|
|
171
|
+
// Explicit logicals and ranges
|
|
172
|
+
{
|
|
173
|
+
$and: [
|
|
174
|
+
{ price: { $gte: 100, $lte: 1000 } },
|
|
175
|
+
{ $or: [{ stock: { $gt: 0 } }, { preorder: true }] }
|
|
176
|
+
]
|
|
177
|
+
}
|
|
178
|
+
|
|
179
|
+
// Dates in range (converted to epoch ms)
|
|
180
|
+
{ timestamp: { $gt: new Date("2024-01-01T00:00:00Z") } }
|
|
181
|
+
```
|
|
182
|
+
|
|
183
|
+
> **Non-filterable keys:** If you set `nonFilterableMetadataKeys` at index creation, those keys are stored but **cannot** be used in filters.
|
|
184
|
+
|
|
185
|
+
## Error Handling
|
|
186
|
+
|
|
187
|
+
The store throws typed errors that can be caught:
|
|
188
|
+
|
|
189
|
+
```typescript
|
|
190
|
+
try {
|
|
191
|
+
await store.query({
|
|
192
|
+
indexName: "index-name",
|
|
193
|
+
queryVector: queryVector,
|
|
194
|
+
});
|
|
195
|
+
} catch (error) {
|
|
196
|
+
if (error instanceof VectorStoreError) {
|
|
197
|
+
console.log(error.code); // 'connection_failed' | 'invalid_dimension' | etc
|
|
198
|
+
console.log(error.details); // Additional error context
|
|
199
|
+
}
|
|
200
|
+
}
|
|
201
|
+
```
|
|
202
|
+
|
|
203
|
+
## Environment Variables
|
|
204
|
+
|
|
205
|
+
Typical environment variables when wiring your app:
|
|
206
|
+
|
|
207
|
+
- `S3_VECTORS_BUCKET_NAME`: Your S3 **vector bucket** name (used to populate `vectorBucketName`).
|
|
208
|
+
- `AWS_REGION`: AWS region for the S3 Vectors bucket.
|
|
209
|
+
- **AWS credentials**: via the standard AWS SDK provider chain (`AWS_ACCESS_KEY_ID`, `AWS_SECRET_ACCESS_KEY`, `AWS_PROFILE`, etc.).
|
|
210
|
+
|
|
211
|
+
## Best Practices
|
|
212
|
+
|
|
213
|
+
- Choose the metric (`cosine` or `euclidean`) to match your embedding model; `dotproduct` is not supported.
|
|
214
|
+
- Keep **filterable** metadata small and structured (string/number/boolean). Store large text (e.g., `content`) as **non-filterable**.
|
|
215
|
+
- Use **dotted paths** for nested metadata and explicit `$and`/`$or` for complex logic.
|
|
216
|
+
- Avoid calling `describeIndex()` on hot paths—`count` is computed with paginated `ListVectors` (**O(n)**).
|
|
217
|
+
- Use `includeVector: true` only when you need raw vectors.
|
|
218
|
+
|
|
219
|
+
## Related
|
|
220
|
+
|
|
221
|
+
- [Metadata Filters](../rag/metadata-filters)
|
package/dist/index.cjs
CHANGED
|
@@ -2,6 +2,7 @@
|
|
|
2
2
|
|
|
3
3
|
var clientS3vectors = require('@aws-sdk/client-s3vectors');
|
|
4
4
|
var error = require('@mastra/core/error');
|
|
5
|
+
var storage = require('@mastra/core/storage');
|
|
5
6
|
var vector = require('@mastra/core/vector');
|
|
6
7
|
var uuid = require('uuid');
|
|
7
8
|
var filter = require('@mastra/core/vector/filter');
|
|
@@ -182,7 +183,7 @@ var S3Vectors = class _S3Vectors extends vector.MastraVector {
|
|
|
182
183
|
if (!opts?.vectorBucketName) {
|
|
183
184
|
throw new error.MastraError(
|
|
184
185
|
{
|
|
185
|
-
id: "
|
|
186
|
+
id: storage.createVectorErrorId("S3VECTORS", "INITIALIZATION", "MISSING_BUCKET_NAME"),
|
|
186
187
|
domain: error.ErrorDomain.STORAGE,
|
|
187
188
|
category: error.ErrorCategory.USER
|
|
188
189
|
},
|
|
@@ -209,7 +210,7 @@ var S3Vectors = class _S3Vectors extends vector.MastraVector {
|
|
|
209
210
|
} catch (error$1) {
|
|
210
211
|
throw new error.MastraError(
|
|
211
212
|
{
|
|
212
|
-
id: "
|
|
213
|
+
id: storage.createVectorErrorId("S3VECTORS", "DISCONNECT", "FAILED"),
|
|
213
214
|
domain: error.ErrorDomain.STORAGE,
|
|
214
215
|
category: error.ErrorCategory.THIRD_PARTY
|
|
215
216
|
},
|
|
@@ -237,7 +238,7 @@ var S3Vectors = class _S3Vectors extends vector.MastraVector {
|
|
|
237
238
|
} catch (error$1) {
|
|
238
239
|
throw new error.MastraError(
|
|
239
240
|
{
|
|
240
|
-
id: "
|
|
241
|
+
id: storage.createVectorErrorId("S3VECTORS", "CREATE_INDEX", "INVALID_ARGS"),
|
|
241
242
|
domain: error.ErrorDomain.STORAGE,
|
|
242
243
|
category: error.ErrorCategory.USER,
|
|
243
244
|
details: { indexName, dimension, metric }
|
|
@@ -264,7 +265,7 @@ var S3Vectors = class _S3Vectors extends vector.MastraVector {
|
|
|
264
265
|
}
|
|
265
266
|
throw new error.MastraError(
|
|
266
267
|
{
|
|
267
|
-
id: "
|
|
268
|
+
id: storage.createVectorErrorId("S3VECTORS", "CREATE_INDEX", "FAILED"),
|
|
268
269
|
domain: error.ErrorDomain.STORAGE,
|
|
269
270
|
category: error.ErrorCategory.THIRD_PARTY,
|
|
270
271
|
details: { indexName, dimension, metric }
|
|
@@ -303,7 +304,7 @@ var S3Vectors = class _S3Vectors extends vector.MastraVector {
|
|
|
303
304
|
} catch (error$1) {
|
|
304
305
|
throw new error.MastraError(
|
|
305
306
|
{
|
|
306
|
-
id: "
|
|
307
|
+
id: storage.createVectorErrorId("S3VECTORS", "UPSERT", "FAILED"),
|
|
307
308
|
domain: error.ErrorDomain.STORAGE,
|
|
308
309
|
category: error.ErrorCategory.THIRD_PARTY,
|
|
309
310
|
details: { indexName }
|
|
@@ -385,7 +386,7 @@ var S3Vectors = class _S3Vectors extends vector.MastraVector {
|
|
|
385
386
|
} catch (error$1) {
|
|
386
387
|
throw new error.MastraError(
|
|
387
388
|
{
|
|
388
|
-
id: "
|
|
389
|
+
id: storage.createVectorErrorId("S3VECTORS", "QUERY", "FAILED"),
|
|
389
390
|
domain: error.ErrorDomain.STORAGE,
|
|
390
391
|
category: error.ErrorCategory.THIRD_PARTY,
|
|
391
392
|
details: { indexName }
|
|
@@ -420,7 +421,7 @@ var S3Vectors = class _S3Vectors extends vector.MastraVector {
|
|
|
420
421
|
} catch (error$1) {
|
|
421
422
|
throw new error.MastraError(
|
|
422
423
|
{
|
|
423
|
-
id: "
|
|
424
|
+
id: storage.createVectorErrorId("S3VECTORS", "LIST_INDEXES", "FAILED"),
|
|
424
425
|
domain: error.ErrorDomain.STORAGE,
|
|
425
426
|
category: error.ErrorCategory.THIRD_PARTY
|
|
426
427
|
},
|
|
@@ -446,7 +447,7 @@ var S3Vectors = class _S3Vectors extends vector.MastraVector {
|
|
|
446
447
|
} catch (error$1) {
|
|
447
448
|
throw new error.MastraError(
|
|
448
449
|
{
|
|
449
|
-
id: "
|
|
450
|
+
id: storage.createVectorErrorId("S3VECTORS", "DESCRIBE_INDEX", "FAILED"),
|
|
450
451
|
domain: error.ErrorDomain.STORAGE,
|
|
451
452
|
category: error.ErrorCategory.THIRD_PARTY,
|
|
452
453
|
details: { indexName }
|
|
@@ -468,7 +469,7 @@ var S3Vectors = class _S3Vectors extends vector.MastraVector {
|
|
|
468
469
|
} catch (error$1) {
|
|
469
470
|
throw new error.MastraError(
|
|
470
471
|
{
|
|
471
|
-
id: "
|
|
472
|
+
id: storage.createVectorErrorId("S3VECTORS", "DELETE_INDEX", "FAILED"),
|
|
472
473
|
domain: error.ErrorDomain.STORAGE,
|
|
473
474
|
category: error.ErrorCategory.THIRD_PARTY,
|
|
474
475
|
details: { indexName }
|
|
@@ -491,7 +492,7 @@ var S3Vectors = class _S3Vectors extends vector.MastraVector {
|
|
|
491
492
|
async updateVector({ indexName, id, update }) {
|
|
492
493
|
if (!id) {
|
|
493
494
|
throw new error.MastraError({
|
|
494
|
-
id: "
|
|
495
|
+
id: storage.createVectorErrorId("S3VECTORS", "UPDATE_VECTOR", "INVALID_ARGS"),
|
|
495
496
|
domain: error.ErrorDomain.STORAGE,
|
|
496
497
|
category: error.ErrorCategory.USER,
|
|
497
498
|
text: "id is required for S3Vectors updateVector",
|
|
@@ -528,7 +529,7 @@ var S3Vectors = class _S3Vectors extends vector.MastraVector {
|
|
|
528
529
|
} catch (error$1) {
|
|
529
530
|
throw new error.MastraError(
|
|
530
531
|
{
|
|
531
|
-
id: "
|
|
532
|
+
id: storage.createVectorErrorId("S3VECTORS", "UPDATE_VECTOR", "FAILED"),
|
|
532
533
|
domain: error.ErrorDomain.STORAGE,
|
|
533
534
|
category: error.ErrorCategory.THIRD_PARTY,
|
|
534
535
|
details: {
|
|
@@ -560,7 +561,7 @@ var S3Vectors = class _S3Vectors extends vector.MastraVector {
|
|
|
560
561
|
} catch (error$1) {
|
|
561
562
|
throw new error.MastraError(
|
|
562
563
|
{
|
|
563
|
-
id: "
|
|
564
|
+
id: storage.createVectorErrorId("S3VECTORS", "DELETE_VECTOR", "FAILED"),
|
|
564
565
|
domain: error.ErrorDomain.STORAGE,
|
|
565
566
|
category: error.ErrorCategory.THIRD_PARTY,
|
|
566
567
|
details: {
|
|
@@ -574,7 +575,7 @@ var S3Vectors = class _S3Vectors extends vector.MastraVector {
|
|
|
574
575
|
}
|
|
575
576
|
async deleteVectors({ indexName, filter, ids }) {
|
|
576
577
|
throw new error.MastraError({
|
|
577
|
-
id: "
|
|
578
|
+
id: storage.createVectorErrorId("S3VECTORS", "DELETE_VECTORS", "NOT_SUPPORTED"),
|
|
578
579
|
text: "deleteVectors is not yet implemented for S3Vectors vector store",
|
|
579
580
|
domain: error.ErrorDomain.STORAGE,
|
|
580
581
|
category: error.ErrorCategory.SYSTEM,
|
package/dist/index.cjs.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"sources":["../src/vector/filter.ts","../src/vector/index.ts","../src/vector/prompt.ts"],"names":["BaseFilterTranslator","MastraVector","MastraError","ErrorDomain","ErrorCategory","S3VectorsClient","error","CreateIndexCommand","uuidv4","PutVectorsCommand","QueryVectorsCommand","GetVectorsCommand","ListIndexesCommand","DeleteIndexCommand","DeleteVectorsCommand","GetIndexCommand","ListVectorsCommand"],"mappings":"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","file":"index.cjs","sourcesContent":["import { BaseFilterTranslator } from '@mastra/core/vector/filter';\nimport type {\n VectorFilter,\n LogicalOperatorValueMap,\n OperatorSupport,\n QueryOperator,\n OperatorValueMap,\n BlacklistedRootOperators,\n} from '@mastra/core/vector/filter';\n\n/**\n * S3 Vectors supports a strict subset of operators and value types.\n *\n * - logical: `$and`, `$or` (non-empty arrays)\n * - basic: `$eq`, `$ne` (string | number | boolean)\n * - numeric: `$gt`, `$gte`, `$lt`, `$lte` (number)\n * - array: `$in`, `$nin` (non-empty arrays of string | number | boolean)\n * - element: `$exists` (boolean)\n */\ntype S3VectorsOperatorValueMap = Pick<\n OperatorValueMap,\n '$eq' | '$ne' | '$gt' | '$gte' | '$lt' | '$lte' | '$in' | '$nin' | '$exists'\n>;\n\ntype S3VectorsLogicalOperatorValueMap = Pick<LogicalOperatorValueMap, '$and' | '$or'>;\n\ntype S3VectorsBlacklisted = BlacklistedRootOperators;\n\ntype S3VectorsFieldValue = string | number | boolean;\n\n/**\n * High-level filter type accepted by this translator.\n * @remarks\n * Field values are limited to string/number/boolean at equality positions.\n */\nexport type S3VectorsFilter = VectorFilter<\n keyof S3VectorsOperatorValueMap,\n S3VectorsOperatorValueMap,\n S3VectorsLogicalOperatorValueMap,\n S3VectorsBlacklisted,\n S3VectorsFieldValue\n>;\n\n/**\n * Translates a high-level filter into the S3 Vectors filter shape.\n *\n * @remarks\n * - Canonicalizes **implicit AND** (e.g. `{a:1,b:2}`) into explicit `{$and:[{a:1},{b:2}]}` in any\n * non-field context that lacks `$and/$or`.\n * - Normalizes `Date` values to epoch milliseconds where allowed (numeric comparisons and array elements).\n * - Disallows `Date` at equality positions (including implicit equality).\n * - Validates shapes using the base class after translation.\n */\nexport class S3VectorsFilterTranslator extends BaseFilterTranslator<S3VectorsFilter> {\n /** @inheritdoc */\n protected override getSupportedOperators(): OperatorSupport {\n return {\n logical: ['$and', '$or'],\n basic: ['$eq', '$ne'],\n numeric: ['$gt', '$gte', '$lt', '$lte'],\n array: ['$in', '$nin'],\n element: ['$exists'],\n };\n }\n\n /**\n * Translates and validates a filter.\n * @param filter - Input filter; may be `undefined`, `null`, or `{}` (all treated as empty).\n * @returns The translated filter (or the original value if empty).\n */\n translate(filter?: S3VectorsFilter): any {\n if (this.isEmpty(filter)) return filter;\n // Perform translation (including Date → number normalization) before base shape validation.\n const translated = this.translateNode(filter as any, false);\n this.validateFilter(translated as any);\n return translated;\n }\n\n /**\n * Recursively translates a node.\n * @param node - Current node to translate.\n * @param inFieldValue - When `true`, the node is the value of a field (i.e., equality context).\n * @remarks\n * - In a **field-value** context, only primitives or operator objects are allowed.\n * - In a **non-field** context (root / logical branches), operator keys are processed;\n * plain keys become field equalities and are validated.\n * - Implicit AND is canonicalized in non-field contexts when multiple non-logical keys exist.\n */\n private translateNode(node: any, inFieldValue = false): any {\n // Primitive or Date (normalize when in a field-equality context)\n if (this.isPrimitive(node) || node instanceof Date) {\n return inFieldValue ? this.validateAndNormalizePrimitive(node) : node;\n }\n\n // Arrays are not allowed as direct equality values\n if (Array.isArray(node)) {\n if (inFieldValue) {\n throw new Error('Array equality is not supported in S3 Vectors. Use $in / $nin operators.');\n }\n return node;\n }\n\n // Object\n const entries = Object.entries(node as Record<string, any>);\n\n if (inFieldValue) {\n if (entries.length === 0) {\n throw new Error('Invalid equality value. Only string, number, or boolean are supported by S3 Vectors');\n }\n const allOperatorKeys = entries.every(([k]) => this.isOperator(k));\n if (!allOperatorKeys) {\n // Disallow shapes like: { field: { a:1, b:2 } }\n throw new Error('Invalid equality value. Only string, number, or boolean are supported by S3 Vectors');\n }\n const opEntries = entries.map(([key, value]) => [key, this.translateOperatorValue(key as QueryOperator, value)]);\n return Object.fromEntries(opEntries);\n }\n\n // Root / filter context\n const translatedEntries = entries.map(([key, value]) => {\n if (this.isOperator(key)) {\n return [key, this.translateOperatorValue(key as QueryOperator, value)];\n }\n return [key, this.translateNode(value, true)];\n });\n const obj = Object.fromEntries(translatedEntries);\n\n // Canonicalize implicit AND → explicit $and (if no $and/$or present and multiple non-logical keys)\n const keys = Object.keys(obj);\n const hasLogical = keys.some(k => k === '$and' || k === '$or');\n if (!hasLogical) {\n const nonLogical = keys.filter(k => k !== '$and' && k !== '$or');\n if (nonLogical.length > 1) {\n return { $and: nonLogical.map(k => ({ [k]: obj[k] })) };\n }\n }\n\n return obj;\n }\n\n /**\n * Translates a single operator and validates its value.\n * @param operator - One of the supported query operators.\n * @param value - Operator value to normalize/validate.\n */\n private translateOperatorValue(operator: QueryOperator, value: any): any {\n // Logical operators\n if (operator === '$and' || operator === '$or') {\n if (!Array.isArray(value) || value.length === 0) {\n throw new Error(`Value for logical operator ${operator} must be a non-empty array`);\n }\n return value.map(item => this.translateNode(item));\n }\n\n // Equality / inequality (Date is not allowed)\n if (operator === '$eq' || operator === '$ne') {\n if (value instanceof Date) {\n throw new Error('Invalid equality value. Only string, number, or boolean are supported by S3 Vectors');\n }\n return this.toPrimitiveForS3(value, operator);\n }\n\n // Numeric comparisons: require number; allow Date by converting to epoch ms\n if (operator === '$gt' || operator === '$gte' || operator === '$lt' || operator === '$lte') {\n const n = this.toNumberForRange(value, operator);\n return n;\n }\n\n // Array operators: non-empty arrays of primitives (Date converted to number)\n if (operator === '$in' || operator === '$nin') {\n if (!Array.isArray(value) || value.length === 0) {\n throw new Error(`Value for array operator ${operator} must be a non-empty array`);\n }\n return value.map(v => this.toPrimitiveForS3(v, operator));\n }\n\n // Existence check\n if (operator === '$exists') {\n if (typeof value !== 'boolean') {\n throw new Error(`Value for $exists operator must be a boolean`);\n }\n return value;\n }\n\n throw new Error(`Unsupported operator: ${operator}`);\n }\n\n /**\n * Normalizes a value to an S3-accepted primitive.\n * @param value - String | Number | Boolean | Date.\n * @param operatorForMessage - Operator name used in error messages.\n * @returns The normalized primitive; `Date` becomes epoch milliseconds.\n * @throws If the value is not a supported primitive or is null/undefined.\n */\n private toPrimitiveForS3(value: any, operatorForMessage: string): string | number | boolean {\n if (value === null || value === undefined) {\n // Error message for equality matches tests\n if (operatorForMessage === 'equality') {\n throw new Error('S3 Vectors does not support null/undefined for equality');\n }\n throw new Error(`Value for ${operatorForMessage} must be string, number, or boolean`);\n }\n if (value instanceof Date) {\n return value.getTime();\n }\n const t = typeof value;\n if (t === 'string' || t === 'boolean') return value;\n if (t === 'number') return Object.is(value, -0) ? 0 : value;\n throw new Error(`Value for ${operatorForMessage} must be string, number, or boolean`);\n }\n\n /**\n * Ensures a numeric value for range operators; allows `Date` by converting to epoch ms.\n * @param value - Candidate value.\n * @param operatorForMessage - Operator name used in error messages.\n * @throws If the value is not a number (or a Date).\n */\n private toNumberForRange(value: any, operatorForMessage: string): number {\n if (value instanceof Date) return value.getTime();\n if (typeof value === 'number' && !Number.isNaN(value)) return Object.is(value, -0) ? 0 : value;\n throw new Error(`Value for ${operatorForMessage} must be a number`);\n }\n\n /**\n * Validates and normalizes a primitive used in field equality (implicit `$eq`).\n * @param value - Candidate equality value.\n * @throws If the value is a `Date` or not a supported primitive.\n */\n private validateAndNormalizePrimitive(value: any): S3VectorsFieldValue {\n if (value instanceof Date) {\n throw new Error('Invalid equality value. Only string, number, or boolean are supported by S3 Vectors');\n }\n return this.toPrimitiveForS3(value, 'equality') as S3VectorsFieldValue;\n }\n\n /**\n * Determines whether a filter is considered empty.\n * @param filter - Input filter.\n */\n protected override isEmpty(filter: any): boolean {\n return filter === undefined || filter === null || (typeof filter === 'object' && Object.keys(filter).length === 0);\n }\n}\n","import {\n S3VectorsClient,\n CreateIndexCommand,\n DeleteIndexCommand,\n ListIndexesCommand,\n GetIndexCommand,\n PutVectorsCommand,\n QueryVectorsCommand,\n GetVectorsCommand,\n DeleteVectorsCommand,\n ListVectorsCommand,\n} from '@aws-sdk/client-s3vectors';\nimport type { S3VectorsClientConfig } from '@aws-sdk/client-s3vectors';\nimport { MastraError, ErrorDomain, ErrorCategory } from '@mastra/core/error';\nimport { MastraVector } from '@mastra/core/vector';\nimport type {\n QueryResult,\n IndexStats,\n CreateIndexParams,\n UpsertVectorParams,\n DeleteVectorsParams,\n QueryVectorParams,\n DescribeIndexParams,\n DeleteIndexParams,\n DeleteVectorParams,\n UpdateVectorParams,\n} from '@mastra/core/vector';\nimport { v4 as uuidv4 } from 'uuid';\nimport { S3VectorsFilterTranslator } from './filter';\nimport type { S3VectorsFilter } from './filter';\n\n/**\n * Options for the S3Vectors store.\n * @property vectorBucketName - Target S3 Vectors bucket name.\n * @property clientConfig - AWS SDK client options (e.g., region/credentials).\n * @property nonFilterableMetadataKeys - Metadata keys that must not be filterable (forwarded to S3 Vectors).\n */\nexport interface S3VectorsOptions {\n vectorBucketName: string;\n clientConfig?: S3VectorsClientConfig;\n nonFilterableMetadataKeys?: string[];\n}\n\ntype S3DistanceMetric = 'cosine' | 'euclidean';\ntype MastraMetric = NonNullable<CreateIndexParams['metric']>;\ntype SupportedMastraMetric = Exclude<MastraMetric, 'dotproduct'>;\n\n/**\n * Vector store backed by Amazon S3 Vectors.\n *\n * @remarks\n * - Supports `cosine` and `euclidean` distance metrics.\n * - Filters must use explicit logical operators (`$and` / `$or`). The attached translator\n * canonicalizes implicit AND (e.g., `{a:1,b:2}` → `{ $and: [{a:1},{b:2}] }`) where permitted by spec.\n * - Methods wrap AWS errors in `MastraError` with domain/category metadata.\n */\nexport class S3Vectors extends MastraVector<S3VectorsFilter> {\n private readonly client: S3VectorsClient;\n private readonly vectorBucketName: string;\n private readonly nonFilterableMetadataKeys?: string[];\n private readonly filterTranslator = new S3VectorsFilterTranslator();\n\n private static readonly METRIC_MAP: Record<SupportedMastraMetric, S3DistanceMetric> = {\n cosine: 'cosine',\n euclidean: 'euclidean',\n } as const;\n\n constructor(opts: S3VectorsOptions & { id: string }) {\n super({ id: opts.id });\n if (!opts?.vectorBucketName) {\n throw new MastraError(\n {\n id: 'STORAGE_S3VECTORS_VECTOR_MISSING_BUCKET_NAME',\n domain: ErrorDomain.STORAGE,\n category: ErrorCategory.USER,\n },\n new Error('vectorBucketName is required'),\n );\n }\n this.vectorBucketName = opts.vectorBucketName;\n this.nonFilterableMetadataKeys = opts.nonFilterableMetadataKeys;\n this.client = new S3VectorsClient({ ...(opts.clientConfig ?? {}) });\n }\n\n /**\n * No-op to satisfy the base interface.\n *\n * @remarks The AWS SDK manages HTTP per request; no persistent connection is needed.\n */\n async connect(): Promise<void> {}\n\n /**\n * Closes the underlying AWS SDK HTTP handler to free sockets.\n */\n async disconnect(): Promise<void> {\n try {\n this.client.destroy();\n } catch (error) {\n throw new MastraError(\n {\n id: 'STORAGE_S3VECTORS_VECTOR_DISCONNECT_FAILED',\n domain: ErrorDomain.STORAGE,\n category: ErrorCategory.THIRD_PARTY,\n },\n error,\n );\n }\n }\n\n /**\n * Creates an index or validates an existing one.\n *\n * @param params.indexName - Logical index name; normalized internally.\n * @param params.dimension - Vector dimension (must be a positive integer).\n * @param params.metric - Distance metric (`cosine` | `euclidean`). Defaults to `cosine`.\n * @throws {MastraError} If arguments are invalid or AWS returns an error.\n * @remarks\n * On `ConflictException`, we verify the existing index schema via the parent implementation\n * and return if it matches.\n */\n async createIndex({ indexName, dimension, metric = 'cosine' }: CreateIndexParams): Promise<void> {\n indexName = normalizeIndexName(indexName);\n\n let s3Metric: S3DistanceMetric;\n try {\n assertPositiveInteger(dimension, 'dimension');\n s3Metric = S3Vectors.toS3Metric(metric);\n } catch (error) {\n throw new MastraError(\n {\n id: 'STORAGE_S3VECTORS_VECTOR_CREATE_INDEX_INVALID_ARGS',\n domain: ErrorDomain.STORAGE,\n category: ErrorCategory.USER,\n details: { indexName, dimension, metric },\n },\n error,\n );\n }\n\n try {\n const input: any = {\n ...this.bucketParams(),\n indexName,\n dataType: 'float32',\n dimension,\n distanceMetric: s3Metric,\n };\n if (this.nonFilterableMetadataKeys?.length) {\n input.metadataConfiguration = { nonFilterableMetadataKeys: this.nonFilterableMetadataKeys };\n }\n\n await this.client.send(new CreateIndexCommand(input));\n } catch (error: any) {\n if (error?.name === 'ConflictException') {\n await this.validateExistingIndex(indexName, dimension, metric);\n return;\n }\n throw new MastraError(\n {\n id: 'STORAGE_S3VECTORS_VECTOR_CREATE_INDEX_FAILED',\n domain: ErrorDomain.STORAGE,\n category: ErrorCategory.THIRD_PARTY,\n details: { indexName, dimension, metric },\n },\n error,\n );\n }\n }\n\n /**\n * Upserts vectors in bulk.\n *\n * @param params.indexName - Index to write to.\n * @param params.vectors - Array of vectors; each must match the index dimension.\n * @param params.metadata - Optional metadata per vector; `Date` values are normalized to epoch ms.\n * @param params.ids - Optional explicit IDs; if omitted, UUIDs are generated.\n * @returns Array of IDs used for the upsert (explicit or generated).\n * @throws {MastraError} If validation fails or AWS returns an error.\n */\n async upsert({ indexName, vectors, metadata, ids }: UpsertVectorParams): Promise<string[]> {\n indexName = normalizeIndexName(indexName);\n try {\n const { dimension } = await this.getIndexInfo(indexName);\n validateVectorDimensions(vectors, dimension);\n\n const generatedIds = ids ?? vectors.map(() => uuidv4());\n\n const putInput = {\n ...this.bucketParams(),\n indexName,\n vectors: vectors.map((vec, i) => ({\n key: generatedIds[i],\n data: { float32: vec },\n metadata: normalizeMetadata(metadata?.[i]),\n })),\n };\n\n await this.client.send(new PutVectorsCommand(putInput));\n return generatedIds;\n } catch (error) {\n throw new MastraError(\n {\n id: 'STORAGE_S3VECTORS_VECTOR_UPSERT_FAILED',\n domain: ErrorDomain.STORAGE,\n category: ErrorCategory.THIRD_PARTY,\n details: { indexName },\n },\n error,\n );\n }\n }\n\n /**\n * Queries nearest neighbors.\n *\n * @param params.indexName - Target index.\n * @param params.queryVector - Query vector (non-empty float32 array).\n * @param params.topK - Number of neighbors to return (positive integer). Defaults to 10.\n * @param params.filter - Metadata filter using explicit `$and`/`$or` (translator canonicalizes implicit AND).\n * @param params.includeVector - If `true`, fetches missing vector data in a second call.\n * @returns Results sorted by `score` descending.\n * @throws {MastraError} If validation fails or AWS returns an error.\n * @remarks\n * `score = 1/(1+distance)` (monotonic transform), so ranking matches the underlying distance.\n */\n async query({\n indexName,\n queryVector,\n topK = 10,\n filter,\n includeVector = false,\n }: QueryVectorParams<S3VectorsFilter>): Promise<QueryResult[]> {\n indexName = normalizeIndexName(indexName);\n\n try {\n if (!Array.isArray(queryVector) || queryVector.length === 0) {\n throw new Error('queryVector must be a non-empty float32 array');\n }\n assertPositiveInteger(topK, 'topK');\n\n const translated = this.transformFilter(filter);\n\n const out = await this.client.send(\n new QueryVectorsCommand({\n ...this.bucketParams(),\n indexName,\n topK,\n queryVector: { float32: queryVector },\n filter: translated && Object.keys(translated).length > 0 ? (translated as any) : undefined,\n returnMetadata: true,\n returnDistance: true,\n }),\n );\n\n const vectors = (out.vectors ?? []).filter(v => !!v?.key);\n\n // If includeVector is requested and some results lack data, fetch only the missing ones.\n let dataMap: Record<string, number[] | undefined> | undefined;\n if (includeVector) {\n const missingKeys = vectors.filter(v => !v.data?.float32 && v.key).map(v => v.key!) as string[];\n\n if (missingKeys.length > 0) {\n const got = await this.client.send(\n new GetVectorsCommand({\n ...this.bucketParams(),\n indexName,\n keys: missingKeys,\n returnData: true,\n returnMetadata: false,\n }),\n );\n dataMap = {};\n for (const g of got.vectors ?? []) {\n if (g.key) dataMap[g.key] = g.data?.float32 as number[] | undefined;\n }\n }\n }\n\n return vectors.map(v => {\n const id = v.key!;\n const score = S3Vectors.distanceToScore(v.distance ?? 0);\n\n const result: QueryResult = { id, score };\n\n const md = v.metadata as Record<string, unknown> | undefined;\n if (md !== undefined) result.metadata = md;\n\n if (includeVector) {\n const vec = (v.data?.float32 as number[] | undefined) ?? dataMap?.[id];\n if (vec !== undefined) result.vector = vec;\n }\n\n return result;\n });\n } catch (error) {\n throw new MastraError(\n {\n id: 'STORAGE_S3VECTORS_VECTOR_QUERY_FAILED',\n domain: ErrorDomain.STORAGE,\n category: ErrorCategory.THIRD_PARTY,\n details: { indexName },\n },\n error,\n );\n }\n }\n\n /**\n * Lists indexes within the configured bucket.\n *\n * @returns Array of index names.\n * @throws {MastraError} On AWS errors.\n */\n async listIndexes(): Promise<string[]> {\n try {\n const names: string[] = [];\n let nextToken: string | undefined;\n\n do {\n const out = await this.client.send(\n new ListIndexesCommand({\n ...this.bucketParams(),\n nextToken,\n } as any),\n );\n for (const idx of out.indexes ?? []) {\n if (idx.indexName) names.push(idx.indexName);\n }\n nextToken = out.nextToken;\n } while (nextToken);\n\n return names;\n } catch (error) {\n throw new MastraError(\n {\n id: 'STORAGE_S3VECTORS_VECTOR_LIST_INDEXES_FAILED',\n domain: ErrorDomain.STORAGE,\n category: ErrorCategory.THIRD_PARTY,\n },\n error,\n );\n }\n }\n\n /**\n * Returns index attributes.\n *\n * @param params.indexName - Index name.\n * @returns Object containing `dimension`, `metric`, and `count`.\n * @throws {MastraError} On AWS errors.\n * @remarks\n * `count` is computed via `ListVectors` pagination and may be costly (O(n)).\n */\n async describeIndex({ indexName }: DescribeIndexParams): Promise<IndexStats> {\n indexName = normalizeIndexName(indexName);\n try {\n const { dimension, metric } = await this.getIndexInfo(indexName);\n const count = await this.countVectors(indexName);\n return { dimension, metric, count };\n } catch (error) {\n throw new MastraError(\n {\n id: 'STORAGE_S3VECTORS_VECTOR_DESCRIBE_INDEX_FAILED',\n domain: ErrorDomain.STORAGE,\n category: ErrorCategory.THIRD_PARTY,\n details: { indexName },\n },\n error,\n );\n }\n }\n\n /**\n * Deletes an index.\n *\n * @param params.indexName - Index name.\n * @throws {MastraError} On AWS errors.\n */\n async deleteIndex({ indexName }: DeleteIndexParams): Promise<void> {\n indexName = normalizeIndexName(indexName);\n try {\n await this.client.send(new DeleteIndexCommand({ ...this.bucketParams(), indexName } as any));\n } catch (error) {\n throw new MastraError(\n {\n id: 'STORAGE_S3VECTORS_VECTOR_DELETE_INDEX_FAILED',\n domain: ErrorDomain.STORAGE,\n category: ErrorCategory.THIRD_PARTY,\n details: { indexName },\n },\n error,\n );\n }\n }\n\n /**\n * Updates (replaces) a vector and/or its metadata by ID.\n *\n * @param params.indexName - Target index.\n * @param params.id - Vector ID.\n * @param params.update.vector - New vector; if omitted, the existing vector is reused.\n * @param params.update.metadata - New metadata, merged with current metadata.\n * @throws {MastraError} If the vector does not exist and `update.vector` is omitted, or on AWS error.\n * @remarks\n * S3 Vectors `PutVectors` is replace-all; we `Get` the current item, merge, then `Put`.\n */\n async updateVector({ indexName, id, update }: UpdateVectorParams): Promise<void> {\n if (!id) {\n throw new MastraError({\n id: 'STORAGE_S3VECTORS_VECTOR_UPDATE_VECTOR_INVALID_ARGS',\n domain: ErrorDomain.STORAGE,\n category: ErrorCategory.USER,\n text: 'id is required for S3Vectors updateVector',\n details: { indexName },\n });\n }\n\n indexName = normalizeIndexName(indexName);\n try {\n if (!update.vector && !update.metadata) {\n throw new Error('No updates provided');\n }\n\n const got = await this.client.send(\n new GetVectorsCommand({\n ...this.bucketParams(),\n indexName,\n keys: [id],\n returnData: true,\n returnMetadata: true,\n }),\n );\n const current = (got.vectors ?? [])[0];\n\n const newVector: number[] | undefined = update.vector ?? (current?.data?.float32 as number[] | undefined);\n if (!newVector) {\n throw new Error(`Vector \"${id}\" not found. Provide update.vector to create it.`);\n }\n\n const newMetadata =\n update.metadata !== undefined\n ? normalizeMetadata(update.metadata)\n : ((current?.metadata as Record<string, any>) ?? {});\n\n await this.client.send(\n new PutVectorsCommand({\n ...this.bucketParams(),\n indexName,\n vectors: [{ key: id, data: { float32: newVector }, metadata: newMetadata }],\n }),\n );\n } catch (error) {\n throw new MastraError(\n {\n id: 'STORAGE_S3VECTORS_VECTOR_UPDATE_VECTOR_FAILED',\n domain: ErrorDomain.STORAGE,\n category: ErrorCategory.THIRD_PARTY,\n details: {\n indexName,\n ...(id && { id }),\n },\n },\n error,\n );\n }\n }\n\n /**\n * Deletes a vector by ID.\n *\n * @param params.indexName - Target index.\n * @param params.id - Vector ID to delete.\n * @throws {MastraError} On AWS errors.\n */\n async deleteVector({ indexName, id }: DeleteVectorParams): Promise<void> {\n indexName = normalizeIndexName(indexName);\n try {\n await this.client.send(\n new DeleteVectorsCommand({\n ...this.bucketParams(),\n indexName,\n keys: [id],\n }),\n );\n } catch (error) {\n throw new MastraError(\n {\n id: 'STORAGE_S3VECTORS_VECTOR_DELETE_VECTOR_FAILED',\n domain: ErrorDomain.STORAGE,\n category: ErrorCategory.THIRD_PARTY,\n details: {\n indexName,\n ...(id && { id }),\n },\n },\n error,\n );\n }\n }\n\n async deleteVectors({ indexName, filter, ids }: DeleteVectorsParams): Promise<void> {\n throw new MastraError({\n id: 'STORAGE_S3VECTORS_VECTOR_DELETE_VECTORS_NOT_SUPPORTED',\n text: 'deleteVectors is not yet implemented for S3Vectors vector store',\n domain: ErrorDomain.STORAGE,\n category: ErrorCategory.SYSTEM,\n details: {\n indexName,\n ...(filter && { filter: JSON.stringify(filter) }),\n ...(ids && { idsCount: ids.length }),\n },\n });\n }\n\n // -------- internal helpers --------\n\n /**\n * Returns shared bucket parameters for AWS SDK calls.\n * @internal\n */\n private bucketParams(): { vectorBucketName: string } {\n return { vectorBucketName: this.vectorBucketName };\n }\n\n /**\n * Retrieves index dimension/metric via `GetIndex`.\n * @internal\n * @throws {Error} If the index does not exist.\n * @returns `{ dimension, metric }`, where `metric` includes `'dotproduct'` to satisfy Mastra types (S3 never returns it).\n */\n private async getIndexInfo(\n indexName: string,\n ): Promise<{ dimension: number; metric: 'cosine' | 'euclidean' | 'dotproduct' }> {\n const out = await this.client.send(new GetIndexCommand({ ...this.bucketParams(), indexName } as any));\n const idx = out.index;\n if (!idx) throw new Error(`Index \"${indexName}\" not found`);\n const metric = (idx.distanceMetric as S3DistanceMetric) ?? 'cosine';\n return {\n dimension: idx.dimension ?? 0,\n metric,\n };\n }\n\n /**\n * Pages through `ListVectors` and counts total items.\n * @internal\n * @remarks O(n). Avoid calling on hot paths.\n */\n private async countVectors(indexName: string): Promise<number> {\n let total = 0;\n let nextToken: string | undefined;\n\n do {\n const out = await this.client.send(\n new ListVectorsCommand({\n ...this.bucketParams(),\n indexName,\n maxResults: 1000,\n nextToken,\n returnData: false,\n returnMetadata: false,\n }),\n );\n total += (out.vectors ?? []).length;\n nextToken = out.nextToken;\n } while (nextToken);\n\n return total;\n }\n\n /**\n * Translates a high-level filter to the S3 Vectors filter shape.\n * @internal\n * @remarks Implicit AND is canonicalized by the translator where permitted by spec.\n */\n private transformFilter(filter?: S3VectorsFilter): any {\n if (!filter) return undefined;\n return this.filterTranslator.translate(filter);\n }\n\n /**\n * Converts a Mastra metric to an S3 metric.\n * @internal\n * @throws {Error} If the metric is not supported by S3 Vectors.\n */\n private static toS3Metric(metric: MastraMetric): S3DistanceMetric {\n const m = S3Vectors.METRIC_MAP[metric as SupportedMastraMetric];\n if (!m) {\n throw new Error(`Invalid metric: \"${metric}\". S3 Vectors supports only: cosine, euclidean`);\n }\n return m;\n }\n\n /**\n * Monotonic transform from distance (smaller is better) to score (larger is better).\n * @returns Number in (0, 1], preserving ranking.\n */\n private static distanceToScore(distance: number): number {\n return 1 / (1 + distance);\n }\n}\n\n// --- module-private utilities (not exported) ---\n\n/**\n * Ensures a value is a positive integer.\n * @throws {Error} If the value is not a positive integer.\n * @internal\n */\nfunction assertPositiveInteger(value: number, name: string): void {\n if (!Number.isInteger(value) || value <= 0) {\n throw new Error(`${name} must be a positive integer`);\n }\n}\n\n/**\n * Validates that all vectors match the required dimension.\n * @throws {Error} If any vector length differs from `dimension`.\n * @internal\n */\nfunction validateVectorDimensions(vectors: number[][], dimension: number): void {\n if (!Array.isArray(vectors) || vectors.length === 0) {\n throw new Error('No vectors provided for validation');\n }\n for (let i = 0; i < vectors.length; i++) {\n const len = vectors[i]?.length;\n if (len !== dimension) {\n throw new Error(`Vector at index ${i} has invalid dimension ${len}. Expected ${dimension} dimensions.`);\n }\n }\n}\n\n/**\n * Normalizes metadata values for S3 Vectors: `Date` → epoch ms.\n * @internal\n */\nfunction normalizeMetadata(meta: Record<string, any> | undefined): Record<string, any> {\n if (!meta) return {};\n const out: Record<string, any> = {};\n for (const [k, v] of Object.entries(meta)) {\n out[k] = v instanceof Date ? v.getTime() : v;\n }\n return out;\n}\n\n/**\n * Normalizes an index name to this store's canonical form (underscore → hyphen, lowercase).\n * @internal\n * @throws {TypeError} If the provided name is not a string.\n */\nfunction normalizeIndexName(str: string) {\n if (typeof str !== 'string') {\n throw new TypeError('Index name must be a string');\n }\n return str.replace(/_/g, '-').toLowerCase();\n}\n","/**\n * Vector store specific prompt that details supported operators and examples.\n * This prompt helps users construct valid filters for Amazon S3 Vectors.\n */\nexport const S3VECTORS_PROMPT = `When querying Amazon S3 Vectors, 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 (non-empty arrays of string | number | boolean):\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 (can be implicit or explicit)\n Implicit Example: { \"price\": { \"$gt\": 100 }, \"category\": \"electronics\" }\n Explicit Example: { \"$and\": [{ \"price\": { \"$gt\": 100 } }, { \"category\": \"electronics\" }] }\n- $or: Logical OR\n Example: { \"$or\": [{ \"price\": { \"$lt\": 50 } }, { \"category\": \"books\" }] }\n\nElement Operators:\n- $exists: Check if field exists\n Example: { \"rating\": { \"$exists\": true } }\n\nUnsupported / Disallowed Operators (REJECT if present):\n- $not, $nor, $regex, $all, $elemMatch, $size, $text (and any operator not listed as supported)\n\nRestrictions:\n- Only logical operators ($and, $or) can be used at the top level\n- Empty arrays for $and / $or / $in / $nin are NOT allowed\n- Nested fields are supported using dot notation\n- Multiple conditions on the same field are supported\n- At least one key-value pair is required in filter object\n- Empty objects and undefined values are treated as no filter\n- Invalid types in comparison operators will throw errors\n- All non-logical operators must be used within a field condition\n Valid: { \"field\": { \"$gt\": 100 } }\n Valid: { \"$and\": [...] }\n Invalid: { \"$gt\": 100 }\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- Equality values must be string, number, or boolean (arrays and objects are not allowed for equality)\n- Filters operate only on filterable metadata keys; using a non-filterable key will fail\n- Filterable metadata values are primitives (string/number/boolean) or arrays of primitives; large/long-text fields should be non-filterable and are not usable in filters\n\nExample Complex Query:\n{\n \"$and\": [\n { \"category\": { \"$in\": [\"electronics\", \"computers\"] } },\n { \"price\": { \"$gte\": 100, \"$lte\": 1000 } },\n { \"$or\": [\n { \"stock\": { \"$gt\": 0 } },\n { \"preorder\": true }\n ] }\n ]\n}`;\n"]}
|
|
1
|
+
{"version":3,"sources":["../src/vector/filter.ts","../src/vector/index.ts","../src/vector/prompt.ts"],"names":["BaseFilterTranslator","MastraVector","MastraError","createVectorErrorId","ErrorDomain","ErrorCategory","S3VectorsClient","error","CreateIndexCommand","uuidv4","PutVectorsCommand","QueryVectorsCommand","GetVectorsCommand","ListIndexesCommand","DeleteIndexCommand","DeleteVectorsCommand","GetIndexCommand","ListVectorsCommand"],"mappings":"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","file":"index.cjs","sourcesContent":["import { BaseFilterTranslator } from '@mastra/core/vector/filter';\nimport type {\n VectorFilter,\n LogicalOperatorValueMap,\n OperatorSupport,\n QueryOperator,\n OperatorValueMap,\n BlacklistedRootOperators,\n} from '@mastra/core/vector/filter';\n\n/**\n * S3 Vectors supports a strict subset of operators and value types.\n *\n * - logical: `$and`, `$or` (non-empty arrays)\n * - basic: `$eq`, `$ne` (string | number | boolean)\n * - numeric: `$gt`, `$gte`, `$lt`, `$lte` (number)\n * - array: `$in`, `$nin` (non-empty arrays of string | number | boolean)\n * - element: `$exists` (boolean)\n */\ntype S3VectorsOperatorValueMap = Pick<\n OperatorValueMap,\n '$eq' | '$ne' | '$gt' | '$gte' | '$lt' | '$lte' | '$in' | '$nin' | '$exists'\n>;\n\ntype S3VectorsLogicalOperatorValueMap = Pick<LogicalOperatorValueMap, '$and' | '$or'>;\n\ntype S3VectorsBlacklisted = BlacklistedRootOperators;\n\ntype S3VectorsFieldValue = string | number | boolean;\n\n/**\n * High-level filter type accepted by this translator.\n * @remarks\n * Field values are limited to string/number/boolean at equality positions.\n */\nexport type S3VectorsFilter = VectorFilter<\n keyof S3VectorsOperatorValueMap,\n S3VectorsOperatorValueMap,\n S3VectorsLogicalOperatorValueMap,\n S3VectorsBlacklisted,\n S3VectorsFieldValue\n>;\n\n/**\n * Translates a high-level filter into the S3 Vectors filter shape.\n *\n * @remarks\n * - Canonicalizes **implicit AND** (e.g. `{a:1,b:2}`) into explicit `{$and:[{a:1},{b:2}]}` in any\n * non-field context that lacks `$and/$or`.\n * - Normalizes `Date` values to epoch milliseconds where allowed (numeric comparisons and array elements).\n * - Disallows `Date` at equality positions (including implicit equality).\n * - Validates shapes using the base class after translation.\n */\nexport class S3VectorsFilterTranslator extends BaseFilterTranslator<S3VectorsFilter> {\n /** @inheritdoc */\n protected override getSupportedOperators(): OperatorSupport {\n return {\n logical: ['$and', '$or'],\n basic: ['$eq', '$ne'],\n numeric: ['$gt', '$gte', '$lt', '$lte'],\n array: ['$in', '$nin'],\n element: ['$exists'],\n };\n }\n\n /**\n * Translates and validates a filter.\n * @param filter - Input filter; may be `undefined`, `null`, or `{}` (all treated as empty).\n * @returns The translated filter (or the original value if empty).\n */\n translate(filter?: S3VectorsFilter): any {\n if (this.isEmpty(filter)) return filter;\n // Perform translation (including Date → number normalization) before base shape validation.\n const translated = this.translateNode(filter as any, false);\n this.validateFilter(translated as any);\n return translated;\n }\n\n /**\n * Recursively translates a node.\n * @param node - Current node to translate.\n * @param inFieldValue - When `true`, the node is the value of a field (i.e., equality context).\n * @remarks\n * - In a **field-value** context, only primitives or operator objects are allowed.\n * - In a **non-field** context (root / logical branches), operator keys are processed;\n * plain keys become field equalities and are validated.\n * - Implicit AND is canonicalized in non-field contexts when multiple non-logical keys exist.\n */\n private translateNode(node: any, inFieldValue = false): any {\n // Primitive or Date (normalize when in a field-equality context)\n if (this.isPrimitive(node) || node instanceof Date) {\n return inFieldValue ? this.validateAndNormalizePrimitive(node) : node;\n }\n\n // Arrays are not allowed as direct equality values\n if (Array.isArray(node)) {\n if (inFieldValue) {\n throw new Error('Array equality is not supported in S3 Vectors. Use $in / $nin operators.');\n }\n return node;\n }\n\n // Object\n const entries = Object.entries(node as Record<string, any>);\n\n if (inFieldValue) {\n if (entries.length === 0) {\n throw new Error('Invalid equality value. Only string, number, or boolean are supported by S3 Vectors');\n }\n const allOperatorKeys = entries.every(([k]) => this.isOperator(k));\n if (!allOperatorKeys) {\n // Disallow shapes like: { field: { a:1, b:2 } }\n throw new Error('Invalid equality value. Only string, number, or boolean are supported by S3 Vectors');\n }\n const opEntries = entries.map(([key, value]) => [key, this.translateOperatorValue(key as QueryOperator, value)]);\n return Object.fromEntries(opEntries);\n }\n\n // Root / filter context\n const translatedEntries = entries.map(([key, value]) => {\n if (this.isOperator(key)) {\n return [key, this.translateOperatorValue(key as QueryOperator, value)];\n }\n return [key, this.translateNode(value, true)];\n });\n const obj = Object.fromEntries(translatedEntries);\n\n // Canonicalize implicit AND → explicit $and (if no $and/$or present and multiple non-logical keys)\n const keys = Object.keys(obj);\n const hasLogical = keys.some(k => k === '$and' || k === '$or');\n if (!hasLogical) {\n const nonLogical = keys.filter(k => k !== '$and' && k !== '$or');\n if (nonLogical.length > 1) {\n return { $and: nonLogical.map(k => ({ [k]: obj[k] })) };\n }\n }\n\n return obj;\n }\n\n /**\n * Translates a single operator and validates its value.\n * @param operator - One of the supported query operators.\n * @param value - Operator value to normalize/validate.\n */\n private translateOperatorValue(operator: QueryOperator, value: any): any {\n // Logical operators\n if (operator === '$and' || operator === '$or') {\n if (!Array.isArray(value) || value.length === 0) {\n throw new Error(`Value for logical operator ${operator} must be a non-empty array`);\n }\n return value.map(item => this.translateNode(item));\n }\n\n // Equality / inequality (Date is not allowed)\n if (operator === '$eq' || operator === '$ne') {\n if (value instanceof Date) {\n throw new Error('Invalid equality value. Only string, number, or boolean are supported by S3 Vectors');\n }\n return this.toPrimitiveForS3(value, operator);\n }\n\n // Numeric comparisons: require number; allow Date by converting to epoch ms\n if (operator === '$gt' || operator === '$gte' || operator === '$lt' || operator === '$lte') {\n const n = this.toNumberForRange(value, operator);\n return n;\n }\n\n // Array operators: non-empty arrays of primitives (Date converted to number)\n if (operator === '$in' || operator === '$nin') {\n if (!Array.isArray(value) || value.length === 0) {\n throw new Error(`Value for array operator ${operator} must be a non-empty array`);\n }\n return value.map(v => this.toPrimitiveForS3(v, operator));\n }\n\n // Existence check\n if (operator === '$exists') {\n if (typeof value !== 'boolean') {\n throw new Error(`Value for $exists operator must be a boolean`);\n }\n return value;\n }\n\n throw new Error(`Unsupported operator: ${operator}`);\n }\n\n /**\n * Normalizes a value to an S3-accepted primitive.\n * @param value - String | Number | Boolean | Date.\n * @param operatorForMessage - Operator name used in error messages.\n * @returns The normalized primitive; `Date` becomes epoch milliseconds.\n * @throws If the value is not a supported primitive or is null/undefined.\n */\n private toPrimitiveForS3(value: any, operatorForMessage: string): string | number | boolean {\n if (value === null || value === undefined) {\n // Error message for equality matches tests\n if (operatorForMessage === 'equality') {\n throw new Error('S3 Vectors does not support null/undefined for equality');\n }\n throw new Error(`Value for ${operatorForMessage} must be string, number, or boolean`);\n }\n if (value instanceof Date) {\n return value.getTime();\n }\n const t = typeof value;\n if (t === 'string' || t === 'boolean') return value;\n if (t === 'number') return Object.is(value, -0) ? 0 : value;\n throw new Error(`Value for ${operatorForMessage} must be string, number, or boolean`);\n }\n\n /**\n * Ensures a numeric value for range operators; allows `Date` by converting to epoch ms.\n * @param value - Candidate value.\n * @param operatorForMessage - Operator name used in error messages.\n * @throws If the value is not a number (or a Date).\n */\n private toNumberForRange(value: any, operatorForMessage: string): number {\n if (value instanceof Date) return value.getTime();\n if (typeof value === 'number' && !Number.isNaN(value)) return Object.is(value, -0) ? 0 : value;\n throw new Error(`Value for ${operatorForMessage} must be a number`);\n }\n\n /**\n * Validates and normalizes a primitive used in field equality (implicit `$eq`).\n * @param value - Candidate equality value.\n * @throws If the value is a `Date` or not a supported primitive.\n */\n private validateAndNormalizePrimitive(value: any): S3VectorsFieldValue {\n if (value instanceof Date) {\n throw new Error('Invalid equality value. Only string, number, or boolean are supported by S3 Vectors');\n }\n return this.toPrimitiveForS3(value, 'equality') as S3VectorsFieldValue;\n }\n\n /**\n * Determines whether a filter is considered empty.\n * @param filter - Input filter.\n */\n protected override isEmpty(filter: any): boolean {\n return filter === undefined || filter === null || (typeof filter === 'object' && Object.keys(filter).length === 0);\n }\n}\n","import {\n S3VectorsClient,\n CreateIndexCommand,\n DeleteIndexCommand,\n ListIndexesCommand,\n GetIndexCommand,\n PutVectorsCommand,\n QueryVectorsCommand,\n GetVectorsCommand,\n DeleteVectorsCommand,\n ListVectorsCommand,\n} from '@aws-sdk/client-s3vectors';\nimport type { S3VectorsClientConfig } from '@aws-sdk/client-s3vectors';\nimport { MastraError, ErrorDomain, ErrorCategory } from '@mastra/core/error';\nimport { createVectorErrorId } from '@mastra/core/storage';\nimport { MastraVector } from '@mastra/core/vector';\nimport type {\n QueryResult,\n IndexStats,\n CreateIndexParams,\n UpsertVectorParams,\n DeleteVectorsParams,\n QueryVectorParams,\n DescribeIndexParams,\n DeleteIndexParams,\n DeleteVectorParams,\n UpdateVectorParams,\n} from '@mastra/core/vector';\nimport { v4 as uuidv4 } from 'uuid';\nimport { S3VectorsFilterTranslator } from './filter';\nimport type { S3VectorsFilter } from './filter';\n\n/**\n * Options for the S3Vectors store.\n * @property vectorBucketName - Target S3 Vectors bucket name.\n * @property clientConfig - AWS SDK client options (e.g., region/credentials).\n * @property nonFilterableMetadataKeys - Metadata keys that must not be filterable (forwarded to S3 Vectors).\n */\nexport interface S3VectorsOptions {\n vectorBucketName: string;\n clientConfig?: S3VectorsClientConfig;\n nonFilterableMetadataKeys?: string[];\n}\n\ntype S3DistanceMetric = 'cosine' | 'euclidean';\ntype MastraMetric = NonNullable<CreateIndexParams['metric']>;\ntype SupportedMastraMetric = Exclude<MastraMetric, 'dotproduct'>;\n\n/**\n * Vector store backed by Amazon S3 Vectors.\n *\n * @remarks\n * - Supports `cosine` and `euclidean` distance metrics.\n * - Filters must use explicit logical operators (`$and` / `$or`). The attached translator\n * canonicalizes implicit AND (e.g., `{a:1,b:2}` → `{ $and: [{a:1},{b:2}] }`) where permitted by spec.\n * - Methods wrap AWS errors in `MastraError` with domain/category metadata.\n */\nexport class S3Vectors extends MastraVector<S3VectorsFilter> {\n private readonly client: S3VectorsClient;\n private readonly vectorBucketName: string;\n private readonly nonFilterableMetadataKeys?: string[];\n private readonly filterTranslator = new S3VectorsFilterTranslator();\n\n private static readonly METRIC_MAP: Record<SupportedMastraMetric, S3DistanceMetric> = {\n cosine: 'cosine',\n euclidean: 'euclidean',\n } as const;\n\n constructor(opts: S3VectorsOptions & { id: string }) {\n super({ id: opts.id });\n if (!opts?.vectorBucketName) {\n throw new MastraError(\n {\n id: createVectorErrorId('S3VECTORS', 'INITIALIZATION', 'MISSING_BUCKET_NAME'),\n domain: ErrorDomain.STORAGE,\n category: ErrorCategory.USER,\n },\n new Error('vectorBucketName is required'),\n );\n }\n this.vectorBucketName = opts.vectorBucketName;\n this.nonFilterableMetadataKeys = opts.nonFilterableMetadataKeys;\n this.client = new S3VectorsClient({ ...(opts.clientConfig ?? {}) });\n }\n\n /**\n * No-op to satisfy the base interface.\n *\n * @remarks The AWS SDK manages HTTP per request; no persistent connection is needed.\n */\n async connect(): Promise<void> {}\n\n /**\n * Closes the underlying AWS SDK HTTP handler to free sockets.\n */\n async disconnect(): Promise<void> {\n try {\n this.client.destroy();\n } catch (error) {\n throw new MastraError(\n {\n id: createVectorErrorId('S3VECTORS', 'DISCONNECT', 'FAILED'),\n domain: ErrorDomain.STORAGE,\n category: ErrorCategory.THIRD_PARTY,\n },\n error,\n );\n }\n }\n\n /**\n * Creates an index or validates an existing one.\n *\n * @param params.indexName - Logical index name; normalized internally.\n * @param params.dimension - Vector dimension (must be a positive integer).\n * @param params.metric - Distance metric (`cosine` | `euclidean`). Defaults to `cosine`.\n * @throws {MastraError} If arguments are invalid or AWS returns an error.\n * @remarks\n * On `ConflictException`, we verify the existing index schema via the parent implementation\n * and return if it matches.\n */\n async createIndex({ indexName, dimension, metric = 'cosine' }: CreateIndexParams): Promise<void> {\n indexName = normalizeIndexName(indexName);\n\n let s3Metric: S3DistanceMetric;\n try {\n assertPositiveInteger(dimension, 'dimension');\n s3Metric = S3Vectors.toS3Metric(metric);\n } catch (error) {\n throw new MastraError(\n {\n id: createVectorErrorId('S3VECTORS', 'CREATE_INDEX', 'INVALID_ARGS'),\n domain: ErrorDomain.STORAGE,\n category: ErrorCategory.USER,\n details: { indexName, dimension, metric },\n },\n error,\n );\n }\n\n try {\n const input: any = {\n ...this.bucketParams(),\n indexName,\n dataType: 'float32',\n dimension,\n distanceMetric: s3Metric,\n };\n if (this.nonFilterableMetadataKeys?.length) {\n input.metadataConfiguration = { nonFilterableMetadataKeys: this.nonFilterableMetadataKeys };\n }\n\n await this.client.send(new CreateIndexCommand(input));\n } catch (error: any) {\n if (error?.name === 'ConflictException') {\n await this.validateExistingIndex(indexName, dimension, metric);\n return;\n }\n throw new MastraError(\n {\n id: createVectorErrorId('S3VECTORS', 'CREATE_INDEX', 'FAILED'),\n domain: ErrorDomain.STORAGE,\n category: ErrorCategory.THIRD_PARTY,\n details: { indexName, dimension, metric },\n },\n error,\n );\n }\n }\n\n /**\n * Upserts vectors in bulk.\n *\n * @param params.indexName - Index to write to.\n * @param params.vectors - Array of vectors; each must match the index dimension.\n * @param params.metadata - Optional metadata per vector; `Date` values are normalized to epoch ms.\n * @param params.ids - Optional explicit IDs; if omitted, UUIDs are generated.\n * @returns Array of IDs used for the upsert (explicit or generated).\n * @throws {MastraError} If validation fails or AWS returns an error.\n */\n async upsert({ indexName, vectors, metadata, ids }: UpsertVectorParams): Promise<string[]> {\n indexName = normalizeIndexName(indexName);\n try {\n const { dimension } = await this.getIndexInfo(indexName);\n validateVectorDimensions(vectors, dimension);\n\n const generatedIds = ids ?? vectors.map(() => uuidv4());\n\n const putInput = {\n ...this.bucketParams(),\n indexName,\n vectors: vectors.map((vec, i) => ({\n key: generatedIds[i],\n data: { float32: vec },\n metadata: normalizeMetadata(metadata?.[i]),\n })),\n };\n\n await this.client.send(new PutVectorsCommand(putInput));\n return generatedIds;\n } catch (error) {\n throw new MastraError(\n {\n id: createVectorErrorId('S3VECTORS', 'UPSERT', 'FAILED'),\n domain: ErrorDomain.STORAGE,\n category: ErrorCategory.THIRD_PARTY,\n details: { indexName },\n },\n error,\n );\n }\n }\n\n /**\n * Queries nearest neighbors.\n *\n * @param params.indexName - Target index.\n * @param params.queryVector - Query vector (non-empty float32 array).\n * @param params.topK - Number of neighbors to return (positive integer). Defaults to 10.\n * @param params.filter - Metadata filter using explicit `$and`/`$or` (translator canonicalizes implicit AND).\n * @param params.includeVector - If `true`, fetches missing vector data in a second call.\n * @returns Results sorted by `score` descending.\n * @throws {MastraError} If validation fails or AWS returns an error.\n * @remarks\n * `score = 1/(1+distance)` (monotonic transform), so ranking matches the underlying distance.\n */\n async query({\n indexName,\n queryVector,\n topK = 10,\n filter,\n includeVector = false,\n }: QueryVectorParams<S3VectorsFilter>): Promise<QueryResult[]> {\n indexName = normalizeIndexName(indexName);\n\n try {\n if (!Array.isArray(queryVector) || queryVector.length === 0) {\n throw new Error('queryVector must be a non-empty float32 array');\n }\n assertPositiveInteger(topK, 'topK');\n\n const translated = this.transformFilter(filter);\n\n const out = await this.client.send(\n new QueryVectorsCommand({\n ...this.bucketParams(),\n indexName,\n topK,\n queryVector: { float32: queryVector },\n filter: translated && Object.keys(translated).length > 0 ? (translated as any) : undefined,\n returnMetadata: true,\n returnDistance: true,\n }),\n );\n\n const vectors = (out.vectors ?? []).filter(v => !!v?.key);\n\n // If includeVector is requested and some results lack data, fetch only the missing ones.\n let dataMap: Record<string, number[] | undefined> | undefined;\n if (includeVector) {\n const missingKeys = vectors.filter(v => !v.data?.float32 && v.key).map(v => v.key!) as string[];\n\n if (missingKeys.length > 0) {\n const got = await this.client.send(\n new GetVectorsCommand({\n ...this.bucketParams(),\n indexName,\n keys: missingKeys,\n returnData: true,\n returnMetadata: false,\n }),\n );\n dataMap = {};\n for (const g of got.vectors ?? []) {\n if (g.key) dataMap[g.key] = g.data?.float32 as number[] | undefined;\n }\n }\n }\n\n return vectors.map(v => {\n const id = v.key!;\n const score = S3Vectors.distanceToScore(v.distance ?? 0);\n\n const result: QueryResult = { id, score };\n\n const md = v.metadata as Record<string, unknown> | undefined;\n if (md !== undefined) result.metadata = md;\n\n if (includeVector) {\n const vec = (v.data?.float32 as number[] | undefined) ?? dataMap?.[id];\n if (vec !== undefined) result.vector = vec;\n }\n\n return result;\n });\n } catch (error) {\n throw new MastraError(\n {\n id: createVectorErrorId('S3VECTORS', 'QUERY', 'FAILED'),\n domain: ErrorDomain.STORAGE,\n category: ErrorCategory.THIRD_PARTY,\n details: { indexName },\n },\n error,\n );\n }\n }\n\n /**\n * Lists indexes within the configured bucket.\n *\n * @returns Array of index names.\n * @throws {MastraError} On AWS errors.\n */\n async listIndexes(): Promise<string[]> {\n try {\n const names: string[] = [];\n let nextToken: string | undefined;\n\n do {\n const out = await this.client.send(\n new ListIndexesCommand({\n ...this.bucketParams(),\n nextToken,\n } as any),\n );\n for (const idx of out.indexes ?? []) {\n if (idx.indexName) names.push(idx.indexName);\n }\n nextToken = out.nextToken;\n } while (nextToken);\n\n return names;\n } catch (error) {\n throw new MastraError(\n {\n id: createVectorErrorId('S3VECTORS', 'LIST_INDEXES', 'FAILED'),\n domain: ErrorDomain.STORAGE,\n category: ErrorCategory.THIRD_PARTY,\n },\n error,\n );\n }\n }\n\n /**\n * Returns index attributes.\n *\n * @param params.indexName - Index name.\n * @returns Object containing `dimension`, `metric`, and `count`.\n * @throws {MastraError} On AWS errors.\n * @remarks\n * `count` is computed via `ListVectors` pagination and may be costly (O(n)).\n */\n async describeIndex({ indexName }: DescribeIndexParams): Promise<IndexStats> {\n indexName = normalizeIndexName(indexName);\n try {\n const { dimension, metric } = await this.getIndexInfo(indexName);\n const count = await this.countVectors(indexName);\n return { dimension, metric, count };\n } catch (error) {\n throw new MastraError(\n {\n id: createVectorErrorId('S3VECTORS', 'DESCRIBE_INDEX', 'FAILED'),\n domain: ErrorDomain.STORAGE,\n category: ErrorCategory.THIRD_PARTY,\n details: { indexName },\n },\n error,\n );\n }\n }\n\n /**\n * Deletes an index.\n *\n * @param params.indexName - Index name.\n * @throws {MastraError} On AWS errors.\n */\n async deleteIndex({ indexName }: DeleteIndexParams): Promise<void> {\n indexName = normalizeIndexName(indexName);\n try {\n await this.client.send(new DeleteIndexCommand({ ...this.bucketParams(), indexName } as any));\n } catch (error) {\n throw new MastraError(\n {\n id: createVectorErrorId('S3VECTORS', 'DELETE_INDEX', 'FAILED'),\n domain: ErrorDomain.STORAGE,\n category: ErrorCategory.THIRD_PARTY,\n details: { indexName },\n },\n error,\n );\n }\n }\n\n /**\n * Updates (replaces) a vector and/or its metadata by ID.\n *\n * @param params.indexName - Target index.\n * @param params.id - Vector ID.\n * @param params.update.vector - New vector; if omitted, the existing vector is reused.\n * @param params.update.metadata - New metadata, merged with current metadata.\n * @throws {MastraError} If the vector does not exist and `update.vector` is omitted, or on AWS error.\n * @remarks\n * S3 Vectors `PutVectors` is replace-all; we `Get` the current item, merge, then `Put`.\n */\n async updateVector({ indexName, id, update }: UpdateVectorParams): Promise<void> {\n if (!id) {\n throw new MastraError({\n id: createVectorErrorId('S3VECTORS', 'UPDATE_VECTOR', 'INVALID_ARGS'),\n domain: ErrorDomain.STORAGE,\n category: ErrorCategory.USER,\n text: 'id is required for S3Vectors updateVector',\n details: { indexName },\n });\n }\n\n indexName = normalizeIndexName(indexName);\n try {\n if (!update.vector && !update.metadata) {\n throw new Error('No updates provided');\n }\n\n const got = await this.client.send(\n new GetVectorsCommand({\n ...this.bucketParams(),\n indexName,\n keys: [id],\n returnData: true,\n returnMetadata: true,\n }),\n );\n const current = (got.vectors ?? [])[0];\n\n const newVector: number[] | undefined = update.vector ?? (current?.data?.float32 as number[] | undefined);\n if (!newVector) {\n throw new Error(`Vector \"${id}\" not found. Provide update.vector to create it.`);\n }\n\n const newMetadata =\n update.metadata !== undefined\n ? normalizeMetadata(update.metadata)\n : ((current?.metadata as Record<string, any>) ?? {});\n\n await this.client.send(\n new PutVectorsCommand({\n ...this.bucketParams(),\n indexName,\n vectors: [{ key: id, data: { float32: newVector }, metadata: newMetadata }],\n }),\n );\n } catch (error) {\n throw new MastraError(\n {\n id: createVectorErrorId('S3VECTORS', 'UPDATE_VECTOR', 'FAILED'),\n domain: ErrorDomain.STORAGE,\n category: ErrorCategory.THIRD_PARTY,\n details: {\n indexName,\n ...(id && { id }),\n },\n },\n error,\n );\n }\n }\n\n /**\n * Deletes a vector by ID.\n *\n * @param params.indexName - Target index.\n * @param params.id - Vector ID to delete.\n * @throws {MastraError} On AWS errors.\n */\n async deleteVector({ indexName, id }: DeleteVectorParams): Promise<void> {\n indexName = normalizeIndexName(indexName);\n try {\n await this.client.send(\n new DeleteVectorsCommand({\n ...this.bucketParams(),\n indexName,\n keys: [id],\n }),\n );\n } catch (error) {\n throw new MastraError(\n {\n id: createVectorErrorId('S3VECTORS', 'DELETE_VECTOR', 'FAILED'),\n domain: ErrorDomain.STORAGE,\n category: ErrorCategory.THIRD_PARTY,\n details: {\n indexName,\n ...(id && { id }),\n },\n },\n error,\n );\n }\n }\n\n async deleteVectors({ indexName, filter, ids }: DeleteVectorsParams): Promise<void> {\n throw new MastraError({\n id: createVectorErrorId('S3VECTORS', 'DELETE_VECTORS', 'NOT_SUPPORTED'),\n text: 'deleteVectors is not yet implemented for S3Vectors vector store',\n domain: ErrorDomain.STORAGE,\n category: ErrorCategory.SYSTEM,\n details: {\n indexName,\n ...(filter && { filter: JSON.stringify(filter) }),\n ...(ids && { idsCount: ids.length }),\n },\n });\n }\n\n // -------- internal helpers --------\n\n /**\n * Returns shared bucket parameters for AWS SDK calls.\n * @internal\n */\n private bucketParams(): { vectorBucketName: string } {\n return { vectorBucketName: this.vectorBucketName };\n }\n\n /**\n * Retrieves index dimension/metric via `GetIndex`.\n * @internal\n * @throws {Error} If the index does not exist.\n * @returns `{ dimension, metric }`, where `metric` includes `'dotproduct'` to satisfy Mastra types (S3 never returns it).\n */\n private async getIndexInfo(\n indexName: string,\n ): Promise<{ dimension: number; metric: 'cosine' | 'euclidean' | 'dotproduct' }> {\n const out = await this.client.send(new GetIndexCommand({ ...this.bucketParams(), indexName } as any));\n const idx = out.index;\n if (!idx) throw new Error(`Index \"${indexName}\" not found`);\n const metric = (idx.distanceMetric as S3DistanceMetric) ?? 'cosine';\n return {\n dimension: idx.dimension ?? 0,\n metric,\n };\n }\n\n /**\n * Pages through `ListVectors` and counts total items.\n * @internal\n * @remarks O(n). Avoid calling on hot paths.\n */\n private async countVectors(indexName: string): Promise<number> {\n let total = 0;\n let nextToken: string | undefined;\n\n do {\n const out = await this.client.send(\n new ListVectorsCommand({\n ...this.bucketParams(),\n indexName,\n maxResults: 1000,\n nextToken,\n returnData: false,\n returnMetadata: false,\n }),\n );\n total += (out.vectors ?? []).length;\n nextToken = out.nextToken;\n } while (nextToken);\n\n return total;\n }\n\n /**\n * Translates a high-level filter to the S3 Vectors filter shape.\n * @internal\n * @remarks Implicit AND is canonicalized by the translator where permitted by spec.\n */\n private transformFilter(filter?: S3VectorsFilter): any {\n if (!filter) return undefined;\n return this.filterTranslator.translate(filter);\n }\n\n /**\n * Converts a Mastra metric to an S3 metric.\n * @internal\n * @throws {Error} If the metric is not supported by S3 Vectors.\n */\n private static toS3Metric(metric: MastraMetric): S3DistanceMetric {\n const m = S3Vectors.METRIC_MAP[metric as SupportedMastraMetric];\n if (!m) {\n throw new Error(`Invalid metric: \"${metric}\". S3 Vectors supports only: cosine, euclidean`);\n }\n return m;\n }\n\n /**\n * Monotonic transform from distance (smaller is better) to score (larger is better).\n * @returns Number in (0, 1], preserving ranking.\n */\n private static distanceToScore(distance: number): number {\n return 1 / (1 + distance);\n }\n}\n\n// --- module-private utilities (not exported) ---\n\n/**\n * Ensures a value is a positive integer.\n * @throws {Error} If the value is not a positive integer.\n * @internal\n */\nfunction assertPositiveInteger(value: number, name: string): void {\n if (!Number.isInteger(value) || value <= 0) {\n throw new Error(`${name} must be a positive integer`);\n }\n}\n\n/**\n * Validates that all vectors match the required dimension.\n * @throws {Error} If any vector length differs from `dimension`.\n * @internal\n */\nfunction validateVectorDimensions(vectors: number[][], dimension: number): void {\n if (!Array.isArray(vectors) || vectors.length === 0) {\n throw new Error('No vectors provided for validation');\n }\n for (let i = 0; i < vectors.length; i++) {\n const len = vectors[i]?.length;\n if (len !== dimension) {\n throw new Error(`Vector at index ${i} has invalid dimension ${len}. Expected ${dimension} dimensions.`);\n }\n }\n}\n\n/**\n * Normalizes metadata values for S3 Vectors: `Date` → epoch ms.\n * @internal\n */\nfunction normalizeMetadata(meta: Record<string, any> | undefined): Record<string, any> {\n if (!meta) return {};\n const out: Record<string, any> = {};\n for (const [k, v] of Object.entries(meta)) {\n out[k] = v instanceof Date ? v.getTime() : v;\n }\n return out;\n}\n\n/**\n * Normalizes an index name to this store's canonical form (underscore → hyphen, lowercase).\n * @internal\n * @throws {TypeError} If the provided name is not a string.\n */\nfunction normalizeIndexName(str: string) {\n if (typeof str !== 'string') {\n throw new TypeError('Index name must be a string');\n }\n return str.replace(/_/g, '-').toLowerCase();\n}\n","/**\n * Vector store specific prompt that details supported operators and examples.\n * This prompt helps users construct valid filters for Amazon S3 Vectors.\n */\nexport const S3VECTORS_PROMPT = `When querying Amazon S3 Vectors, 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 (non-empty arrays of string | number | boolean):\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 (can be implicit or explicit)\n Implicit Example: { \"price\": { \"$gt\": 100 }, \"category\": \"electronics\" }\n Explicit Example: { \"$and\": [{ \"price\": { \"$gt\": 100 } }, { \"category\": \"electronics\" }] }\n- $or: Logical OR\n Example: { \"$or\": [{ \"price\": { \"$lt\": 50 } }, { \"category\": \"books\" }] }\n\nElement Operators:\n- $exists: Check if field exists\n Example: { \"rating\": { \"$exists\": true } }\n\nUnsupported / Disallowed Operators (REJECT if present):\n- $not, $nor, $regex, $all, $elemMatch, $size, $text (and any operator not listed as supported)\n\nRestrictions:\n- Only logical operators ($and, $or) can be used at the top level\n- Empty arrays for $and / $or / $in / $nin are NOT allowed\n- Nested fields are supported using dot notation\n- Multiple conditions on the same field are supported\n- At least one key-value pair is required in filter object\n- Empty objects and undefined values are treated as no filter\n- Invalid types in comparison operators will throw errors\n- All non-logical operators must be used within a field condition\n Valid: { \"field\": { \"$gt\": 100 } }\n Valid: { \"$and\": [...] }\n Invalid: { \"$gt\": 100 }\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- Equality values must be string, number, or boolean (arrays and objects are not allowed for equality)\n- Filters operate only on filterable metadata keys; using a non-filterable key will fail\n- Filterable metadata values are primitives (string/number/boolean) or arrays of primitives; large/long-text fields should be non-filterable and are not usable in filters\n\nExample Complex Query:\n{\n \"$and\": [\n { \"category\": { \"$in\": [\"electronics\", \"computers\"] } },\n { \"price\": { \"$gte\": 100, \"$lte\": 1000 } },\n { \"$or\": [\n { \"stock\": { \"$gt\": 0 } },\n { \"preorder\": true }\n ] }\n ]\n}`;\n"]}
|