@mastra/memory 1.6.2-alpha.0 → 1.6.2
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 +26 -0
- package/dist/docs/SKILL.md +24 -24
- package/dist/docs/assets/SOURCE_MAP.json +1 -1
- package/dist/docs/references/docs-agents-agent-approval.md +3 -3
- package/dist/docs/references/docs-agents-agent-memory.md +1 -1
- package/dist/docs/references/docs-agents-network-approval.md +1 -1
- package/dist/docs/references/docs-agents-networks.md +1 -1
- package/dist/docs/references/docs-agents-supervisor-agents.md +3 -3
- package/dist/docs/references/docs-memory-memory-processors.md +8 -8
- package/dist/docs/references/docs-memory-message-history.md +2 -2
- package/dist/docs/references/docs-memory-observational-memory.md +5 -5
- package/dist/docs/references/docs-memory-semantic-recall.md +7 -7
- package/dist/docs/references/docs-memory-working-memory.md +14 -14
- package/dist/docs/references/reference-core-getMemory.md +1 -1
- package/dist/docs/references/reference-core-listMemory.md +1 -1
- package/dist/docs/references/reference-memory-clone-utilities.md +7 -7
- package/dist/docs/references/reference-memory-cloneThread.md +4 -4
- package/dist/docs/references/reference-memory-createThread.md +1 -1
- package/dist/docs/references/reference-memory-getThreadById.md +1 -1
- package/dist/docs/references/reference-memory-listThreads.md +3 -3
- package/dist/docs/references/reference-memory-memory-class.md +1 -1
- package/dist/docs/references/reference-memory-observational-memory.md +1 -1
- package/dist/docs/references/reference-storage-dynamodb.md +5 -5
- package/dist/docs/references/reference-storage-libsql.md +1 -1
- package/dist/docs/references/reference-storage-mongodb.md +5 -5
- package/dist/docs/references/reference-storage-postgresql.md +5 -5
- package/dist/docs/references/reference-storage-upstash.md +3 -3
- package/dist/docs/references/reference-vectors-libsql.md +15 -15
- package/dist/docs/references/reference-vectors-mongodb.md +18 -18
- package/dist/docs/references/reference-vectors-pg.md +21 -21
- package/dist/docs/references/reference-vectors-upstash.md +15 -15
- package/package.json +8 -8
|
@@ -1,8 +1,8 @@
|
|
|
1
|
-
# Upstash
|
|
1
|
+
# Upstash vector store
|
|
2
2
|
|
|
3
3
|
The UpstashVector class provides vector search using [Upstash Vector](https://upstash.com/vector), a serverless vector database service that provides vector similarity search with metadata filtering capabilities and hybrid search support.
|
|
4
4
|
|
|
5
|
-
## Constructor
|
|
5
|
+
## Constructor options
|
|
6
6
|
|
|
7
7
|
**url** (`string`): Upstash Vector database URL
|
|
8
8
|
|
|
@@ -10,7 +10,7 @@ The UpstashVector class provides vector search using [Upstash Vector](https://up
|
|
|
10
10
|
|
|
11
11
|
## Methods
|
|
12
12
|
|
|
13
|
-
### createIndex()
|
|
13
|
+
### `createIndex()`
|
|
14
14
|
|
|
15
15
|
Note: This method is a no-op for Upstash as indexes are created automatically.
|
|
16
16
|
|
|
@@ -20,7 +20,7 @@ Note: This method is a no-op for Upstash as indexes are created automatically.
|
|
|
20
20
|
|
|
21
21
|
**metric** (`'cosine' | 'euclidean' | 'dotproduct'`): Distance metric for similarity search (Default: `cosine`)
|
|
22
22
|
|
|
23
|
-
### upsert()
|
|
23
|
+
### `upsert()`
|
|
24
24
|
|
|
25
25
|
**indexName** (`string`): Name of the index to upsert into
|
|
26
26
|
|
|
@@ -32,7 +32,7 @@ Note: This method is a no-op for Upstash as indexes are created automatically.
|
|
|
32
32
|
|
|
33
33
|
**ids** (`string[]`): Optional vector IDs (auto-generated if not provided)
|
|
34
34
|
|
|
35
|
-
### query()
|
|
35
|
+
### `query()`
|
|
36
36
|
|
|
37
37
|
**indexName** (`string`): Name of the index to query
|
|
38
38
|
|
|
@@ -50,11 +50,11 @@ Note: This method is a no-op for Upstash as indexes are created automatically.
|
|
|
50
50
|
|
|
51
51
|
**queryMode** (`QueryMode`): Search mode: 'DENSE' for dense-only, 'SPARSE' for sparse-only, or 'HYBRID' for combined search
|
|
52
52
|
|
|
53
|
-
### listIndexes()
|
|
53
|
+
### `listIndexes()`
|
|
54
54
|
|
|
55
55
|
Returns an array of index names (namespaces) as strings.
|
|
56
56
|
|
|
57
|
-
### describeIndex()
|
|
57
|
+
### `describeIndex()`
|
|
58
58
|
|
|
59
59
|
**indexName** (`string`): Name of the index to describe
|
|
60
60
|
|
|
@@ -68,11 +68,11 @@ interface IndexStats {
|
|
|
68
68
|
}
|
|
69
69
|
```
|
|
70
70
|
|
|
71
|
-
### deleteIndex()
|
|
71
|
+
### `deleteIndex()`
|
|
72
72
|
|
|
73
73
|
**indexName** (`string`): Name of the index (namespace) to delete
|
|
74
74
|
|
|
75
|
-
### updateVector()
|
|
75
|
+
### `updateVector()`
|
|
76
76
|
|
|
77
77
|
**indexName** (`string`): Name of the index to update
|
|
78
78
|
|
|
@@ -86,7 +86,7 @@ The `update` object can have the following properties:
|
|
|
86
86
|
- `sparseVector` (optional): A sparse vector object with `indices` and `values` arrays for hybrid indexes.
|
|
87
87
|
- `metadata` (optional): A record of key-value pairs for metadata.
|
|
88
88
|
|
|
89
|
-
### deleteVector()
|
|
89
|
+
### `deleteVector()`
|
|
90
90
|
|
|
91
91
|
**indexName** (`string`): Name of the index from which to delete the item
|
|
92
92
|
|
|
@@ -94,7 +94,7 @@ The `update` object can have the following properties:
|
|
|
94
94
|
|
|
95
95
|
Attempts to delete an item by its ID from the specified index. Logs an error message if the deletion fails.
|
|
96
96
|
|
|
97
|
-
## Hybrid
|
|
97
|
+
## Hybrid vector search
|
|
98
98
|
|
|
99
99
|
Upstash Vector supports hybrid search that combines semantic search (dense vectors) with keyword-based search (sparse vectors) for improved relevance and accuracy.
|
|
100
100
|
|
|
@@ -182,7 +182,7 @@ await vectorStore.updateVector({
|
|
|
182
182
|
})
|
|
183
183
|
```
|
|
184
184
|
|
|
185
|
-
## Response
|
|
185
|
+
## Response types
|
|
186
186
|
|
|
187
187
|
Query results are returned in this format:
|
|
188
188
|
|
|
@@ -195,7 +195,7 @@ interface QueryResult {
|
|
|
195
195
|
}
|
|
196
196
|
```
|
|
197
197
|
|
|
198
|
-
## Error
|
|
198
|
+
## Error handling
|
|
199
199
|
|
|
200
200
|
The store throws typed errors that can be caught:
|
|
201
201
|
|
|
@@ -213,14 +213,14 @@ try {
|
|
|
213
213
|
}
|
|
214
214
|
```
|
|
215
215
|
|
|
216
|
-
## Environment
|
|
216
|
+
## Environment variables
|
|
217
217
|
|
|
218
218
|
Required environment variables:
|
|
219
219
|
|
|
220
220
|
- `UPSTASH_VECTOR_URL`: Your Upstash Vector database URL
|
|
221
221
|
- `UPSTASH_VECTOR_TOKEN`: Your Upstash Vector API token
|
|
222
222
|
|
|
223
|
-
## Usage
|
|
223
|
+
## Usage example
|
|
224
224
|
|
|
225
225
|
### Local embeddings with fastembed
|
|
226
226
|
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@mastra/memory",
|
|
3
|
-
"version": "1.6.2
|
|
3
|
+
"version": "1.6.2",
|
|
4
4
|
"description": "",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"main": "./dist/index.js",
|
|
@@ -43,7 +43,7 @@
|
|
|
43
43
|
"lru-cache": "^11.2.6",
|
|
44
44
|
"probe-image-size": "^7.2.3",
|
|
45
45
|
"xxhash-wasm": "^1.1.0",
|
|
46
|
-
"@mastra/schema-compat": "1.2.0
|
|
46
|
+
"@mastra/schema-compat": "1.2.0"
|
|
47
47
|
},
|
|
48
48
|
"devDependencies": {
|
|
49
49
|
"@ai-sdk/openai": "^1.3.24",
|
|
@@ -59,12 +59,12 @@
|
|
|
59
59
|
"typescript-eslint": "^8.51.0",
|
|
60
60
|
"vitest": "4.0.18",
|
|
61
61
|
"zod": "^4.3.6",
|
|
62
|
-
"@internal/ai-sdk-v4": "0.0.
|
|
63
|
-
"@internal/ai-sdk-v5": "0.0.
|
|
64
|
-
"@internal/
|
|
65
|
-
"@internal/lint": "0.0.
|
|
66
|
-
"@internal/
|
|
67
|
-
"@mastra/core": "1.11.0
|
|
62
|
+
"@internal/ai-sdk-v4": "0.0.14",
|
|
63
|
+
"@internal/ai-sdk-v5": "0.0.14",
|
|
64
|
+
"@internal/ai-v6": "0.0.14",
|
|
65
|
+
"@internal/lint": "0.0.67",
|
|
66
|
+
"@internal/types-builder": "0.0.42",
|
|
67
|
+
"@mastra/core": "1.11.0"
|
|
68
68
|
},
|
|
69
69
|
"peerDependencies": {
|
|
70
70
|
"@mastra/core": ">=1.4.1-0 <2.0.0-0",
|