@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
@@ -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-alpha.0"
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 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.
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,5 +1,5 @@
1
1
  {
2
- "version": "1.0.6-alpha.0",
2
+ "version": "1.0.6",
3
3
  "package": "@mastra/convex",
4
4
  "exports": {
5
5
  "mastraStorage": {
@@ -1,4 +1,4 @@
1
- # Convex Storage
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 Setup
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 Examples
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 Notes
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 Variables
151
+ ### Environment variables
152
152
 
153
153
  Set these environment variables for your deployment:
154
154
 
@@ -1,4 +1,4 @@
1
- # Convex Vector Store
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 Setup
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 Options
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 Examples
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 Types
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 Filtering
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-alpha.0",
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.62",
55
- "@internal/lint": "0.0.66",
56
- "@internal/types-builder": "0.0.41",
57
- "@mastra/core": "1.11.0-alpha.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"