@mastra/convex 1.0.6-alpha.0 → 1.0.6
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
CHANGED
|
@@ -1,5 +1,14 @@
|
|
|
1
1
|
# @mastra/convex
|
|
2
2
|
|
|
3
|
+
## 1.0.6
|
|
4
|
+
|
|
5
|
+
### Patch Changes
|
|
6
|
+
|
|
7
|
+
- Improved semantic recall performance for large message histories. Semantic recall no longer loads entire threads when only the recalled messages are needed, eliminating delays that previously scaled with total message count. (Fixes #11702) ([#14022](https://github.com/mastra-ai/mastra/pull/14022))
|
|
8
|
+
|
|
9
|
+
- Updated dependencies [[`4f71b43`](https://github.com/mastra-ai/mastra/commit/4f71b436a4a6b8839842d8da47b57b84509af56c), [`a070277`](https://github.com/mastra-ai/mastra/commit/a07027766ce195ba74d0783116d894cbab25d44c), [`b628b91`](https://github.com/mastra-ai/mastra/commit/b628b9128b372c0f54214d902b07279f03443900), [`332c014`](https://github.com/mastra-ai/mastra/commit/332c014e076b81edf7fe45b58205882726415e90), [`6b63153`](https://github.com/mastra-ai/mastra/commit/6b63153878ea841c0f4ce632ba66bb33e57e9c1b), [`4246e34`](https://github.com/mastra-ai/mastra/commit/4246e34cec9c26636d0965942268e6d07c346671), [`b8837ee`](https://github.com/mastra-ai/mastra/commit/b8837ee77e2e84197609762bfabd8b3da326d30c), [`866cc2c`](https://github.com/mastra-ai/mastra/commit/866cc2cb1f0e3b314afab5194f69477fada745d1), [`5d950f7`](https://github.com/mastra-ai/mastra/commit/5d950f7bf426a215a1808f0abef7de5c8336ba1c), [`28c85b1`](https://github.com/mastra-ai/mastra/commit/28c85b184fc32b40f7f160483c982da6d388ecbd), [`e9a08fb`](https://github.com/mastra-ai/mastra/commit/e9a08fbef1ada7e50e961e2f54f55e8c10b4a45c), [`1d0a8a8`](https://github.com/mastra-ai/mastra/commit/1d0a8a8acf33203d5744fc429b090ad8598aa8ed), [`631ffd8`](https://github.com/mastra-ai/mastra/commit/631ffd82fed108648b448b28e6a90e38c5f53bf5), [`6bcbf8a`](https://github.com/mastra-ai/mastra/commit/6bcbf8a6774d5a53b21d61db8a45ce2593ca1616), [`aae2295`](https://github.com/mastra-ai/mastra/commit/aae2295838a2d329ad6640829e87934790ffe5b8), [`aa61f29`](https://github.com/mastra-ai/mastra/commit/aa61f29ff8095ce46a4ae16e46c4d8c79b2b685b), [`7ff3714`](https://github.com/mastra-ai/mastra/commit/7ff37148515439bb3be009a60e02c3e363299760), [`18c3a90`](https://github.com/mastra-ai/mastra/commit/18c3a90c9e48cf69500e308affeb8eba5860b2af), [`41d79a1`](https://github.com/mastra-ai/mastra/commit/41d79a14bd8cb6de1e2565fd0a04786bae2f211b), [`f35487b`](https://github.com/mastra-ai/mastra/commit/f35487bb2d46c636e22aa71d90025613ae38235a), [`6dc2192`](https://github.com/mastra-ai/mastra/commit/6dc21921aef0f0efab15cd0805fa3d18f277a76f), [`eeb3a3f`](https://github.com/mastra-ai/mastra/commit/eeb3a3f43aca10cf49479eed2a84b7d9ecea02ba), [`e673376`](https://github.com/mastra-ai/mastra/commit/e6733763ad1321aa7e5ae15096b9c2104f93b1f3), [`05f8d90`](https://github.com/mastra-ai/mastra/commit/05f8d9009290ce6aa03428b3add635268615db85), [`b2204c9`](https://github.com/mastra-ai/mastra/commit/b2204c98a42848bbfb6f0440f005dc2b6354f1cd), [`a1bf1e3`](https://github.com/mastra-ai/mastra/commit/a1bf1e385ed4c0ef6f11b56c5887442970d127f2), [`b6f647a`](https://github.com/mastra-ai/mastra/commit/b6f647ae2388e091f366581595feb957e37d5b40), [`0c57b8b`](https://github.com/mastra-ai/mastra/commit/0c57b8b0a69a97b5a4ae3f79be6c610f29f3cf7b), [`b081f27`](https://github.com/mastra-ai/mastra/commit/b081f272cf411716e1d6bd72ceac4bcee2657b19), [`4b8da97`](https://github.com/mastra-ai/mastra/commit/4b8da97a5ce306e97869df6c39535d9069e563db), [`0c09eac`](https://github.com/mastra-ai/mastra/commit/0c09eacb1926f64cfdc9ae5c6d63385cf8c9f72c), [`6b9b93d`](https://github.com/mastra-ai/mastra/commit/6b9b93d6f459d1ba6e36f163abf62a085ddb3d64), [`31b6067`](https://github.com/mastra-ai/mastra/commit/31b6067d0cc3ab10e1b29c36147f3b5266bc714a), [`797ac42`](https://github.com/mastra-ai/mastra/commit/797ac4276de231ad2d694d9aeca75980f6cd0419), [`0bc289e`](https://github.com/mastra-ai/mastra/commit/0bc289e2d476bf46c5b91c21969e8d0c6864691c), [`9b75a06`](https://github.com/mastra-ai/mastra/commit/9b75a06e53ebb0b950ba7c1e83a0142047185f46), [`4c3a1b1`](https://github.com/mastra-ai/mastra/commit/4c3a1b122ea083e003d71092f30f3b31680b01c0), [`256df35`](https://github.com/mastra-ai/mastra/commit/256df3571d62beb3ad4971faa432927cc140e603), [`85cc3b3`](https://github.com/mastra-ai/mastra/commit/85cc3b3b6f32ae4b083c26498f50d5b250ba944b), [`97ea28c`](https://github.com/mastra-ai/mastra/commit/97ea28c746e9e4147d56047bbb1c4a92417a3fec), [`d567299`](https://github.com/mastra-ai/mastra/commit/d567299cf81e02bd9d5221d4bc05967d6c224161), [`716ffe6`](https://github.com/mastra-ai/mastra/commit/716ffe68bed81f7c2690bc8581b9e140f7bf1c3d), [`8296332`](https://github.com/mastra-ai/mastra/commit/8296332de21c16e3dfc3d0b2d615720a6dc88f2f), [`4df2116`](https://github.com/mastra-ai/mastra/commit/4df211619dd922c047d396ca41cd7027c8c4c8e7), [`2219c1a`](https://github.com/mastra-ai/mastra/commit/2219c1acbd21da116da877f0036ffb985a9dd5a3), [`17c4145`](https://github.com/mastra-ai/mastra/commit/17c4145166099354545582335b5252bdfdfd908b)]:
|
|
10
|
+
- @mastra/core@1.11.0
|
|
11
|
+
|
|
3
12
|
## 1.0.6-alpha.0
|
|
4
13
|
|
|
5
14
|
### Patch Changes
|
package/dist/docs/SKILL.md
CHANGED
|
@@ -3,7 +3,7 @@ name: mastra-convex
|
|
|
3
3
|
description: Documentation for @mastra/convex. Use when working with @mastra/convex APIs, configuration, or implementation.
|
|
4
4
|
metadata:
|
|
5
5
|
package: "@mastra/convex"
|
|
6
|
-
version: "1.0.6
|
|
6
|
+
version: "1.0.6"
|
|
7
7
|
---
|
|
8
8
|
|
|
9
9
|
## When to use
|
|
@@ -16,8 +16,8 @@ Read the individual reference documents for detailed explanations and code examp
|
|
|
16
16
|
|
|
17
17
|
### Reference
|
|
18
18
|
|
|
19
|
-
- [Reference: Convex
|
|
20
|
-
- [Reference: Convex
|
|
19
|
+
- [Reference: Convex storage](references/reference-storage-convex.md) - Documentation for the Convex storage implementation in Mastra.
|
|
20
|
+
- [Reference: Convex vector store](references/reference-vectors-convex.md) - Documentation for the ConvexVector class in Mastra, which provides vector search using Convex.
|
|
21
21
|
|
|
22
22
|
|
|
23
23
|
Read [assets/SOURCE_MAP.json](assets/SOURCE_MAP.json) for source code references.
|
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
# Convex
|
|
1
|
+
# Convex storage
|
|
2
2
|
|
|
3
3
|
The Convex storage implementation provides a serverless storage solution using [Convex](https://convex.dev), a full-stack TypeScript development platform with real-time sync and automatic caching.
|
|
4
4
|
|
|
@@ -32,7 +32,7 @@ yarn add @mastra/convex@latest
|
|
|
32
32
|
bun add @mastra/convex@latest
|
|
33
33
|
```
|
|
34
34
|
|
|
35
|
-
## Convex
|
|
35
|
+
## Convex setup
|
|
36
36
|
|
|
37
37
|
Before using `ConvexStore`, you need to set up the Convex schema and storage handler in your Convex project.
|
|
38
38
|
|
|
@@ -103,7 +103,7 @@ const storage = new ConvexStore({
|
|
|
103
103
|
|
|
104
104
|
**storageFunction** (`string`): Path to the storage mutation function (default: 'mastra/storage:handle') (Default: `mastra/storage:handle`)
|
|
105
105
|
|
|
106
|
-
## Constructor
|
|
106
|
+
## Constructor examples
|
|
107
107
|
|
|
108
108
|
```ts
|
|
109
109
|
import { ConvexStore } from '@mastra/convex'
|
|
@@ -124,7 +124,7 @@ const storeCustom = new ConvexStore({
|
|
|
124
124
|
})
|
|
125
125
|
```
|
|
126
126
|
|
|
127
|
-
## Additional
|
|
127
|
+
## Additional notes
|
|
128
128
|
|
|
129
129
|
### Schema Management
|
|
130
130
|
|
|
@@ -148,7 +148,7 @@ All typed tables include:
|
|
|
148
148
|
|
|
149
149
|
This design ensures compatibility with Mastra's storage contract while leveraging Convex's automatic indexing and real-time capabilities.
|
|
150
150
|
|
|
151
|
-
### Environment
|
|
151
|
+
### Environment variables
|
|
152
152
|
|
|
153
153
|
Set these environment variables for your deployment:
|
|
154
154
|
|
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
# Convex
|
|
1
|
+
# Convex vector store
|
|
2
2
|
|
|
3
3
|
The ConvexVector class provides vector storage and similarity search using [Convex](https://convex.dev). It stores embeddings inside Convex and performs cosine similarity search.
|
|
4
4
|
|
|
@@ -28,11 +28,11 @@ yarn add @mastra/convex@latest
|
|
|
28
28
|
bun add @mastra/convex@latest
|
|
29
29
|
```
|
|
30
30
|
|
|
31
|
-
## Convex
|
|
31
|
+
## Convex setup
|
|
32
32
|
|
|
33
33
|
Before using `ConvexVector`, you need to set up the Convex schema and storage handler. See [Convex Storage Setup](https://mastra.ai/reference/storage/convex) for setup instructions.
|
|
34
34
|
|
|
35
|
-
## Constructor
|
|
35
|
+
## Constructor options
|
|
36
36
|
|
|
37
37
|
**deploymentUrl** (`string`): Convex deployment URL (e.g., https\://your-project.convex.cloud)
|
|
38
38
|
|
|
@@ -40,7 +40,7 @@ Before using `ConvexVector`, you need to set up the Convex schema and storage ha
|
|
|
40
40
|
|
|
41
41
|
**storageFunction** (`string`): Path to the storage mutation function (Default: `mastra/storage:handle`)
|
|
42
42
|
|
|
43
|
-
## Constructor
|
|
43
|
+
## Constructor examples
|
|
44
44
|
|
|
45
45
|
### Basic Configuration
|
|
46
46
|
|
|
@@ -67,7 +67,7 @@ const vectorStore = new ConvexVector({
|
|
|
67
67
|
|
|
68
68
|
## Methods
|
|
69
69
|
|
|
70
|
-
### createIndex()
|
|
70
|
+
### `createIndex()`
|
|
71
71
|
|
|
72
72
|
**indexName** (`string`): Name of the index to create
|
|
73
73
|
|
|
@@ -82,7 +82,7 @@ await vectorStore.createIndex({
|
|
|
82
82
|
})
|
|
83
83
|
```
|
|
84
84
|
|
|
85
|
-
### upsert()
|
|
85
|
+
### `upsert()`
|
|
86
86
|
|
|
87
87
|
**indexName** (`string`): Name of the index to upsert vectors into
|
|
88
88
|
|
|
@@ -101,7 +101,7 @@ await vectorStore.upsert({
|
|
|
101
101
|
});
|
|
102
102
|
```
|
|
103
103
|
|
|
104
|
-
### query()
|
|
104
|
+
### `query()`
|
|
105
105
|
|
|
106
106
|
**indexName** (`string`): Name of the index to query
|
|
107
107
|
|
|
@@ -122,7 +122,7 @@ const results = await vectorStore.query({
|
|
|
122
122
|
});
|
|
123
123
|
```
|
|
124
124
|
|
|
125
|
-
### listIndexes()
|
|
125
|
+
### `listIndexes()`
|
|
126
126
|
|
|
127
127
|
Returns an array of index names as strings.
|
|
128
128
|
|
|
@@ -131,7 +131,7 @@ const indexes = await vectorStore.listIndexes()
|
|
|
131
131
|
// ["my_vectors", "embeddings", ...]
|
|
132
132
|
```
|
|
133
133
|
|
|
134
|
-
### describeIndex()
|
|
134
|
+
### `describeIndex()`
|
|
135
135
|
|
|
136
136
|
**indexName** (`string`): Name of the index to describe
|
|
137
137
|
|
|
@@ -145,7 +145,7 @@ interface IndexStats {
|
|
|
145
145
|
}
|
|
146
146
|
```
|
|
147
147
|
|
|
148
|
-
### deleteIndex()
|
|
148
|
+
### `deleteIndex()`
|
|
149
149
|
|
|
150
150
|
**indexName** (`string`): Name of the index to delete
|
|
151
151
|
|
|
@@ -155,7 +155,7 @@ Deletes the index and all its vectors.
|
|
|
155
155
|
await vectorStore.deleteIndex({ indexName: 'my_vectors' })
|
|
156
156
|
```
|
|
157
157
|
|
|
158
|
-
### updateVector()
|
|
158
|
+
### `updateVector()`
|
|
159
159
|
|
|
160
160
|
Update a single vector by ID or by metadata filter. Either `id` or `filter` must be provided, but not both.
|
|
161
161
|
|
|
@@ -188,7 +188,7 @@ await vectorStore.updateVector({
|
|
|
188
188
|
})
|
|
189
189
|
```
|
|
190
190
|
|
|
191
|
-
### deleteVector()
|
|
191
|
+
### `deleteVector()`
|
|
192
192
|
|
|
193
193
|
**indexName** (`string`): Name of the index containing the vector
|
|
194
194
|
|
|
@@ -198,7 +198,7 @@ await vectorStore.updateVector({
|
|
|
198
198
|
await vectorStore.deleteVector({ indexName: 'my_vectors', id: 'vector123' })
|
|
199
199
|
```
|
|
200
200
|
|
|
201
|
-
### deleteVectors()
|
|
201
|
+
### `deleteVectors()`
|
|
202
202
|
|
|
203
203
|
Delete multiple vectors by IDs or by metadata filter. Either `ids` or `filter` must be provided, but not both.
|
|
204
204
|
|
|
@@ -222,7 +222,7 @@ await vectorStore.deleteVectors({
|
|
|
222
222
|
})
|
|
223
223
|
```
|
|
224
224
|
|
|
225
|
-
## Response
|
|
225
|
+
## Response types
|
|
226
226
|
|
|
227
227
|
Query results are returned in this format:
|
|
228
228
|
|
|
@@ -235,7 +235,7 @@ interface QueryResult {
|
|
|
235
235
|
}
|
|
236
236
|
```
|
|
237
237
|
|
|
238
|
-
## Metadata
|
|
238
|
+
## Metadata filtering
|
|
239
239
|
|
|
240
240
|
ConvexVector supports metadata filtering with various operators:
|
|
241
241
|
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@mastra/convex",
|
|
3
|
-
"version": "1.0.6
|
|
3
|
+
"version": "1.0.6",
|
|
4
4
|
"description": "Convex provider for Mastra - includes both storage and vector adapters plus Convex server helpers",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"main": "dist/index.js",
|
|
@@ -51,10 +51,10 @@
|
|
|
51
51
|
"tsup": "^8.5.1",
|
|
52
52
|
"typescript": "^5.9.3",
|
|
53
53
|
"vitest": "4.0.18",
|
|
54
|
-
"@internal/storage-test-utils": "0.0.
|
|
55
|
-
"@internal/lint": "0.0.
|
|
56
|
-
"@internal/types-builder": "0.0.
|
|
57
|
-
"@mastra/core": "1.11.0
|
|
54
|
+
"@internal/storage-test-utils": "0.0.63",
|
|
55
|
+
"@internal/lint": "0.0.67",
|
|
56
|
+
"@internal/types-builder": "0.0.42",
|
|
57
|
+
"@mastra/core": "1.11.0"
|
|
58
58
|
},
|
|
59
59
|
"peerDependencies": {
|
|
60
60
|
"@mastra/core": ">=1.0.0-0 <2.0.0-0"
|