@mastra/upstash 1.0.0-beta.1 → 1.0.0-beta.11

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,527 @@
1
1
  # @mastra/upstash
2
2
 
3
+ ## 1.0.0-beta.11
4
+
5
+ ### Patch Changes
6
+
7
+ - Aligned vector store configuration with underlying library APIs, giving you access to all library options directly. ([#11742](https://github.com/mastra-ai/mastra/pull/11742))
8
+
9
+ **Why this change?**
10
+
11
+ Previously, each vector store defined its own configuration types that only exposed a subset of the underlying library's options. This meant users couldn't access advanced features like authentication, SSL, compression, or custom headers without creating their own client instances. Now, the configuration types extend the library types directly, so all options are available.
12
+
13
+ **@mastra/libsql** (Breaking)
14
+
15
+ Renamed `connectionUrl` to `url` to match the `@libsql/client` API and align with LibSQLStorage.
16
+
17
+ ```typescript
18
+ // Before
19
+ new LibSQLVector({ id: 'my-vector', connectionUrl: 'file:./db.sqlite' });
20
+
21
+ // After
22
+ new LibSQLVector({ id: 'my-vector', url: 'file:./db.sqlite' });
23
+ ```
24
+
25
+ **@mastra/opensearch** (Breaking)
26
+
27
+ Renamed `url` to `node` and added support for all OpenSearch `ClientOptions` including authentication, SSL, and compression.
28
+
29
+ ```typescript
30
+ // Before
31
+ new OpenSearchVector({ id: 'my-vector', url: 'http://localhost:9200' });
32
+
33
+ // After
34
+ new OpenSearchVector({ id: 'my-vector', node: 'http://localhost:9200' });
35
+
36
+ // With authentication (now possible)
37
+ new OpenSearchVector({
38
+ id: 'my-vector',
39
+ node: 'https://localhost:9200',
40
+ auth: { username: 'admin', password: 'admin' },
41
+ ssl: { rejectUnauthorized: false },
42
+ });
43
+ ```
44
+
45
+ **@mastra/pinecone** (Breaking)
46
+
47
+ Removed `environment` parameter. Use `controllerHostUrl` instead (the actual Pinecone SDK field name). Added support for all `PineconeConfiguration` options.
48
+
49
+ ```typescript
50
+ // Before
51
+ new PineconeVector({ id: 'my-vector', apiKey: '...', environment: '...' });
52
+
53
+ // After
54
+ new PineconeVector({ id: 'my-vector', apiKey: '...' });
55
+
56
+ // With custom controller host (if needed)
57
+ new PineconeVector({ id: 'my-vector', apiKey: '...', controllerHostUrl: '...' });
58
+ ```
59
+
60
+ **@mastra/clickhouse**
61
+
62
+ Added support for all `ClickHouseClientConfigOptions` like `request_timeout`, `compression`, `keep_alive`, and `database`. Existing configurations continue to work unchanged.
63
+
64
+ **@mastra/cloudflare, @mastra/cloudflare-d1, @mastra/lance, @mastra/libsql, @mastra/mongodb, @mastra/pg, @mastra/upstash**
65
+
66
+ Improved logging by replacing `console.warn` with structured logger in workflow storage domains.
67
+
68
+ **@mastra/deployer-cloud**
69
+
70
+ Updated internal LibSQLVector configuration for compatibility with the new API.
71
+
72
+ - Updated dependencies [[`ebae12a`](https://github.com/mastra-ai/mastra/commit/ebae12a2dd0212e75478981053b148a2c246962d), [`c61a0a5`](https://github.com/mastra-ai/mastra/commit/c61a0a5de4904c88fd8b3718bc26d1be1c2ec6e7), [`69136e7`](https://github.com/mastra-ai/mastra/commit/69136e748e32f57297728a4e0f9a75988462f1a7), [`449aed2`](https://github.com/mastra-ai/mastra/commit/449aed2ba9d507b75bf93d427646ea94f734dfd1), [`eb648a2`](https://github.com/mastra-ai/mastra/commit/eb648a2cc1728f7678768dd70cd77619b448dab9), [`0131105`](https://github.com/mastra-ai/mastra/commit/0131105532e83bdcbb73352fc7d0879eebf140dc), [`9d5059e`](https://github.com/mastra-ai/mastra/commit/9d5059eae810829935fb08e81a9bb7ecd5b144a7), [`ef756c6`](https://github.com/mastra-ai/mastra/commit/ef756c65f82d16531c43f49a27290a416611e526), [`b00ccd3`](https://github.com/mastra-ai/mastra/commit/b00ccd325ebd5d9e37e34dd0a105caae67eb568f), [`3bdfa75`](https://github.com/mastra-ai/mastra/commit/3bdfa7507a91db66f176ba8221aa28dd546e464a), [`e770de9`](https://github.com/mastra-ai/mastra/commit/e770de941a287a49b1964d44db5a5763d19890a6), [`52e2716`](https://github.com/mastra-ai/mastra/commit/52e2716b42df6eff443de72360ae83e86ec23993), [`27b4040`](https://github.com/mastra-ai/mastra/commit/27b4040bfa1a95d92546f420a02a626b1419a1d6), [`610a70b`](https://github.com/mastra-ai/mastra/commit/610a70bdad282079f0c630e0d7bb284578f20151), [`8dc7f55`](https://github.com/mastra-ai/mastra/commit/8dc7f55900395771da851dc7d78d53ae84fe34ec), [`8379099`](https://github.com/mastra-ai/mastra/commit/8379099fc467af6bef54dd7f80c9bd75bf8bbddf), [`8c0ec25`](https://github.com/mastra-ai/mastra/commit/8c0ec25646c8a7df253ed1e5ff4863a0d3f1316c), [`ff4d9a6`](https://github.com/mastra-ai/mastra/commit/ff4d9a6704fc87b31a380a76ed22736fdedbba5a), [`69821ef`](https://github.com/mastra-ai/mastra/commit/69821ef806482e2c44e2197ac0b050c3fe3a5285), [`1ed5716`](https://github.com/mastra-ai/mastra/commit/1ed5716830867b3774c4a1b43cc0d82935f32b96), [`4186bdd`](https://github.com/mastra-ai/mastra/commit/4186bdd00731305726fa06adba0b076a1d50b49f), [`7aaf973`](https://github.com/mastra-ai/mastra/commit/7aaf973f83fbbe9521f1f9e7a4fd99b8de464617)]:
73
+ - @mastra/core@1.0.0-beta.22
74
+
75
+ ## 1.0.0-beta.10
76
+
77
+ ### Patch Changes
78
+
79
+ - dependencies updates: ([#11593](https://github.com/mastra-ai/mastra/pull/11593))
80
+ - Updated dependency [`@upstash/redis@^1.36.0` ↗︎](https://www.npmjs.com/package/@upstash/redis/v/1.36.0) (from `^1.35.6`, in `dependencies`)
81
+
82
+ - dependencies updates: ([#11600](https://github.com/mastra-ai/mastra/pull/11600))
83
+ - Updated dependency [`@upstash/redis@^1.36.0` ↗︎](https://www.npmjs.com/package/@upstash/redis/v/1.36.0) (from `^1.35.6`, in `dependencies`)
84
+
85
+ - Add embedded documentation support for Mastra packages ([#11472](https://github.com/mastra-ai/mastra/pull/11472))
86
+
87
+ Mastra packages now include embedded documentation in the published npm package under `dist/docs/`. This enables coding agents and AI assistants to understand and use the framework by reading documentation directly from `node_modules`.
88
+
89
+ Each package includes:
90
+ - **SKILL.md** - Entry point explaining the package's purpose and capabilities
91
+ - **SOURCE_MAP.json** - Machine-readable index mapping exports to types and implementation files
92
+ - **Topic folders** - Conceptual documentation organized by feature area
93
+
94
+ Documentation is driven by the `packages` frontmatter field in MDX files, which maps docs to their corresponding packages. CI validation ensures all docs include this field.
95
+
96
+ - Added `startExclusive` and `endExclusive` options to `dateRange` filter for message queries. ([#11479](https://github.com/mastra-ai/mastra/pull/11479))
97
+
98
+ **What changed:** The `filter.dateRange` parameter in `listMessages()` and `Memory.recall()` now supports `startExclusive` and `endExclusive` boolean options. When set to `true`, messages with timestamps exactly matching the boundary are excluded from results.
99
+
100
+ **Why this matters:** Enables cursor-based pagination for chat applications. When new messages arrive during a session, offset-based pagination can skip or duplicate messages. Using `endExclusive: true` with the oldest message's timestamp as a cursor ensures consistent pagination without gaps or duplicates.
101
+
102
+ **Example:**
103
+
104
+ ```typescript
105
+ // Get first page
106
+ const page1 = await memory.recall({
107
+ threadId: 'thread-123',
108
+ perPage: 10,
109
+ orderBy: { field: 'createdAt', direction: 'DESC' },
110
+ });
111
+
112
+ // Get next page using cursor-based pagination
113
+ const oldestMessage = page1.messages[page1.messages.length - 1];
114
+ const page2 = await memory.recall({
115
+ threadId: 'thread-123',
116
+ perPage: 10,
117
+ orderBy: { field: 'createdAt', direction: 'DESC' },
118
+ filter: {
119
+ dateRange: {
120
+ end: oldestMessage.createdAt,
121
+ endExclusive: true, // Excludes the cursor message
122
+ },
123
+ },
124
+ });
125
+ ```
126
+
127
+ - Adds thread cloning to create independent copies of conversations that can diverge. ([#11517](https://github.com/mastra-ai/mastra/pull/11517))
128
+
129
+ ```typescript
130
+ // Clone a thread
131
+ const { thread, clonedMessages } = await memory.cloneThread({
132
+ sourceThreadId: 'thread-123',
133
+ title: 'My Clone',
134
+ options: {
135
+ messageLimit: 10, // optional: only copy last N messages
136
+ },
137
+ });
138
+
139
+ // Check if a thread is a clone
140
+ if (memory.isClone(thread)) {
141
+ const source = await memory.getSourceThread(thread.id);
142
+ }
143
+
144
+ // List all clones of a thread
145
+ const clones = await memory.listClones('thread-123');
146
+ ```
147
+
148
+ Includes:
149
+ - Storage implementations for InMemory, PostgreSQL, LibSQL, Upstash
150
+ - API endpoint: `POST /api/memory/threads/:threadId/clone`
151
+ - Embeddings created for cloned messages (semantic recall)
152
+ - Clone button in playground UI Memory tab
153
+
154
+ - Updated dependencies [[`d2d3e22`](https://github.com/mastra-ai/mastra/commit/d2d3e22a419ee243f8812a84e3453dd44365ecb0), [`bc72b52`](https://github.com/mastra-ai/mastra/commit/bc72b529ee4478fe89ecd85a8be47ce0127b82a0), [`05b8bee`](https://github.com/mastra-ai/mastra/commit/05b8bee9e50e6c2a4a2bf210eca25ee212ca24fa), [`c042bd0`](https://github.com/mastra-ai/mastra/commit/c042bd0b743e0e86199d0cb83344ca7690e34a9c), [`940a2b2`](https://github.com/mastra-ai/mastra/commit/940a2b27480626ed7e74f55806dcd2181c1dd0c2), [`e0941c3`](https://github.com/mastra-ai/mastra/commit/e0941c3d7fc75695d5d258e7008fd5d6e650800c), [`0c0580a`](https://github.com/mastra-ai/mastra/commit/0c0580a42f697cd2a7d5973f25bfe7da9055038a), [`28f5f89`](https://github.com/mastra-ai/mastra/commit/28f5f89705f2409921e3c45178796c0e0d0bbb64), [`e601b27`](https://github.com/mastra-ai/mastra/commit/e601b272c70f3a5ecca610373aa6223012704892), [`3d3366f`](https://github.com/mastra-ai/mastra/commit/3d3366f31683e7137d126a3a57174a222c5801fb), [`5a4953f`](https://github.com/mastra-ai/mastra/commit/5a4953f7d25bb15ca31ed16038092a39cb3f98b3), [`eb9e522`](https://github.com/mastra-ai/mastra/commit/eb9e522ce3070a405e5b949b7bf5609ca51d7fe2), [`20e6f19`](https://github.com/mastra-ai/mastra/commit/20e6f1971d51d3ff6dd7accad8aaaae826d540ed), [`4f0b3c6`](https://github.com/mastra-ai/mastra/commit/4f0b3c66f196c06448487f680ccbb614d281e2f7), [`74c4f22`](https://github.com/mastra-ai/mastra/commit/74c4f22ed4c71e72598eacc346ba95cdbc00294f), [`81b6a8f`](https://github.com/mastra-ai/mastra/commit/81b6a8ff79f49a7549d15d66624ac1a0b8f5f971), [`e4d366a`](https://github.com/mastra-ai/mastra/commit/e4d366aeb500371dd4210d6aa8361a4c21d87034), [`a4f010b`](https://github.com/mastra-ai/mastra/commit/a4f010b22e4355a5fdee70a1fe0f6e4a692cc29e), [`73b0bb3`](https://github.com/mastra-ai/mastra/commit/73b0bb394dba7c9482eb467a97ab283dbc0ef4db), [`5627a8c`](https://github.com/mastra-ai/mastra/commit/5627a8c6dc11fe3711b3fa7a6ffd6eb34100a306), [`3ff45d1`](https://github.com/mastra-ai/mastra/commit/3ff45d10e0c80c5335a957ab563da72feb623520), [`251df45`](https://github.com/mastra-ai/mastra/commit/251df4531407dfa46d805feb40ff3fb49769f455), [`f894d14`](https://github.com/mastra-ai/mastra/commit/f894d148946629af7b1f452d65a9cf864cec3765), [`c2b9547`](https://github.com/mastra-ai/mastra/commit/c2b9547bf435f56339f23625a743b2147ab1c7a6), [`580b592`](https://github.com/mastra-ai/mastra/commit/580b5927afc82fe460dfdf9a38a902511b6b7e7f), [`58e3931`](https://github.com/mastra-ai/mastra/commit/58e3931af9baa5921688566210f00fb0c10479fa), [`08bb631`](https://github.com/mastra-ai/mastra/commit/08bb631ae2b14684b2678e3549d0b399a6f0561e), [`4fba91b`](https://github.com/mastra-ai/mastra/commit/4fba91bec7c95911dc28e369437596b152b04cd0), [`12b0cc4`](https://github.com/mastra-ai/mastra/commit/12b0cc4077d886b1a552637dedb70a7ade93528c)]:
155
+ - @mastra/core@1.0.0-beta.20
156
+
157
+ ## 1.0.0-beta.9
158
+
159
+ ### Patch Changes
160
+
161
+ - Add storage composition to MastraStorage ([#11401](https://github.com/mastra-ai/mastra/pull/11401))
162
+
163
+ `MastraStorage` can now compose storage domains from different adapters. Use it when you need different databases for different purposes - for example, PostgreSQL for memory and workflows, but a different database for observability.
164
+
165
+ ```typescript
166
+ import { MastraStorage } from '@mastra/core/storage';
167
+ import { MemoryPG, WorkflowsPG, ScoresPG } from '@mastra/pg';
168
+ import { MemoryLibSQL } from '@mastra/libsql';
169
+
170
+ // Compose domains from different stores
171
+ const storage = new MastraStorage({
172
+ id: 'composite',
173
+ domains: {
174
+ memory: new MemoryLibSQL({ url: 'file:./local.db' }),
175
+ workflows: new WorkflowsPG({ connectionString: process.env.DATABASE_URL }),
176
+ scores: new ScoresPG({ connectionString: process.env.DATABASE_URL }),
177
+ },
178
+ });
179
+ ```
180
+
181
+ **Breaking changes:**
182
+ - `storage.supports` property no longer exists
183
+ - `StorageSupports` type is no longer exported from `@mastra/core/storage`
184
+
185
+ All stores now support the same features. For domain availability, use `getStore()`:
186
+
187
+ ```typescript
188
+ const store = await storage.getStore('memory');
189
+ if (store) {
190
+ // domain is available
191
+ }
192
+ ```
193
+
194
+ - Updated dependencies [[`3d93a15`](https://github.com/mastra-ai/mastra/commit/3d93a15796b158c617461c8b98bede476ebb43e2), [`efe406a`](https://github.com/mastra-ai/mastra/commit/efe406a1353c24993280ebc2ed61dd9f65b84b26), [`119e5c6`](https://github.com/mastra-ai/mastra/commit/119e5c65008f3e5cfca954eefc2eb85e3bf40da4), [`74e504a`](https://github.com/mastra-ai/mastra/commit/74e504a3b584eafd2f198001c6a113bbec589fd3), [`e33fdbd`](https://github.com/mastra-ai/mastra/commit/e33fdbd07b33920d81e823122331b0c0bee0bb59), [`929f69c`](https://github.com/mastra-ai/mastra/commit/929f69c3436fa20dd0f0e2f7ebe8270bd82a1529), [`8a73529`](https://github.com/mastra-ai/mastra/commit/8a73529ca01187f604b1f3019d0a725ac63ae55f)]:
195
+ - @mastra/core@1.0.0-beta.16
196
+
197
+ ## 1.0.0-beta.8
198
+
199
+ ### Minor Changes
200
+
201
+ - Introduce StorageDomain base class for composite storage support ([#11249](https://github.com/mastra-ai/mastra/pull/11249))
202
+
203
+ Storage adapters now use a domain-based architecture where each domain (memory, workflows, scores, observability, agents) extends a `StorageDomain` base class with `init()` and `dangerouslyClearAll()` methods.
204
+
205
+ **Key changes:**
206
+ - Add `StorageDomain` abstract base class that all domain storage classes extend
207
+ - Add `InMemoryDB` class for shared state across in-memory domain implementations
208
+ - All storage domains now implement `dangerouslyClearAll()` for test cleanup
209
+ - Remove `operations` from public `StorageDomains` type (now internal to each adapter)
210
+ - Add flexible client/config patterns - domains accept either an existing database client or config to create one internally
211
+
212
+ **Why this matters:**
213
+
214
+ This enables composite storage where you can use different database adapters per domain:
215
+
216
+ ```typescript
217
+ import { Mastra } from '@mastra/core';
218
+ import { PostgresStore } from '@mastra/pg';
219
+ import { ClickhouseStore } from '@mastra/clickhouse';
220
+
221
+ // Use Postgres for most domains but Clickhouse for observability
222
+ const mastra = new Mastra({
223
+ storage: new PostgresStore({
224
+ connectionString: 'postgres://...',
225
+ }),
226
+ // Future: override specific domains
227
+ // observability: new ClickhouseStore({ ... }).getStore('observability'),
228
+ });
229
+ ```
230
+
231
+ **Standalone domain usage:**
232
+
233
+ Domains can now be used independently with flexible configuration:
234
+
235
+ ```typescript
236
+ import { MemoryLibSQL } from '@mastra/libsql/memory';
237
+
238
+ // Option 1: Pass config to create client internally
239
+ const memory = new MemoryLibSQL({
240
+ url: 'file:./local.db',
241
+ });
242
+
243
+ // Option 2: Pass existing client for shared connections
244
+ import { createClient } from '@libsql/client';
245
+ const client = createClient({ url: 'file:./local.db' });
246
+ const memory = new MemoryLibSQL({ client });
247
+ ```
248
+
249
+ **Breaking changes:**
250
+ - `StorageDomains` type no longer includes `operations` - access via `getStore()` instead
251
+ - Domain base classes now require implementing `dangerouslyClearAll()` method
252
+
253
+ - Refactor storage architecture to use domain-specific stores via `getStore()` pattern ([#11361](https://github.com/mastra-ai/mastra/pull/11361))
254
+
255
+ ### Summary
256
+
257
+ This release introduces a new storage architecture that replaces passthrough methods on `MastraStorage` with domain-specific storage interfaces accessed via `getStore()`. This change reduces code duplication across storage adapters and provides a cleaner, more modular API.
258
+
259
+ ### Migration Guide
260
+
261
+ All direct method calls on storage instances should be updated to use `getStore()`:
262
+
263
+ ```typescript
264
+ // Before
265
+ const thread = await storage.getThreadById({ threadId });
266
+ await storage.persistWorkflowSnapshot({ workflowName, runId, snapshot });
267
+ await storage.createSpan(span);
268
+
269
+ // After
270
+ const memory = await storage.getStore('memory');
271
+ const thread = await memory?.getThreadById({ threadId });
272
+
273
+ const workflows = await storage.getStore('workflows');
274
+ await workflows?.persistWorkflowSnapshot({ workflowName, runId, snapshot });
275
+
276
+ const observability = await storage.getStore('observability');
277
+ await observability?.createSpan(span);
278
+ ```
279
+
280
+ ### Available Domains
281
+ - **`memory`**: Thread and message operations (`getThreadById`, `saveThread`, `saveMessages`, etc.)
282
+ - **`workflows`**: Workflow state persistence (`persistWorkflowSnapshot`, `loadWorkflowSnapshot`, `getWorkflowRunById`, etc.)
283
+ - **`scores`**: Evaluation scores (`saveScore`, `listScoresByScorerId`, etc.)
284
+ - **`observability`**: Tracing and spans (`createSpan`, `updateSpan`, `getTrace`, etc.)
285
+ - **`agents`**: Stored agent configurations (`createAgent`, `getAgentById`, `listAgents`, etc.)
286
+
287
+ ### Breaking Changes
288
+ - Passthrough methods have been removed from `MastraStorage` base class
289
+ - All storage adapters now require accessing domains via `getStore()`
290
+ - The `stores` property on storage instances is now the canonical way to access domain storage
291
+
292
+ ### Internal Changes
293
+ - Each storage adapter now initializes domain-specific stores in its constructor
294
+ - Domain stores share database connections and handle their own table initialization
295
+
296
+ - Unified observability schema with entity-based span identification ([#11132](https://github.com/mastra-ai/mastra/pull/11132))
297
+
298
+ ## What changed
299
+
300
+ Spans now use a unified identification model with `entityId`, `entityType`, and `entityName` instead of separate `agentId`, `toolId`, `workflowId` fields.
301
+
302
+ **Before:**
303
+
304
+ ```typescript
305
+ // Old span structure
306
+ span.agentId; // 'my-agent'
307
+ span.toolId; // undefined
308
+ span.workflowId; // undefined
309
+ ```
310
+
311
+ **After:**
312
+
313
+ ```typescript
314
+ // New span structure
315
+ span.entityType; // EntityType.AGENT
316
+ span.entityId; // 'my-agent'
317
+ span.entityName; // 'My Agent'
318
+ ```
319
+
320
+ ## New `listTraces()` API
321
+
322
+ Query traces with filtering, pagination, and sorting:
323
+
324
+ ```typescript
325
+ const { spans, pagination } = await storage.listTraces({
326
+ filters: {
327
+ entityType: EntityType.AGENT,
328
+ entityId: 'my-agent',
329
+ userId: 'user-123',
330
+ environment: 'production',
331
+ status: TraceStatus.SUCCESS,
332
+ startedAt: { start: new Date('2024-01-01'), end: new Date('2024-01-31') },
333
+ },
334
+ pagination: { page: 0, perPage: 50 },
335
+ orderBy: { field: 'startedAt', direction: 'DESC' },
336
+ });
337
+ ```
338
+
339
+ **Available filters:** date ranges (`startedAt`, `endedAt`), entity (`entityType`, `entityId`, `entityName`), identity (`userId`, `organizationId`), correlation IDs (`runId`, `sessionId`, `threadId`), deployment (`environment`, `source`, `serviceName`), `tags`, `metadata`, and `status`.
340
+
341
+ ## New retrieval methods
342
+ - `getSpan({ traceId, spanId })` - Get a single span
343
+ - `getRootSpan({ traceId })` - Get the root span of a trace
344
+ - `getTrace({ traceId })` - Get all spans for a trace
345
+
346
+ ## Backward compatibility
347
+
348
+ The legacy `getTraces()` method continues to work. When you pass `name: "agent run: my-agent"`, it automatically transforms to `entityId: "my-agent", entityType: AGENT`.
349
+
350
+ ## Migration
351
+
352
+ **Automatic:** SQL-based stores (PostgreSQL, LibSQL, MSSQL) automatically add new columns to existing `spans` tables on initialization. Existing data is preserved with new columns set to `NULL`.
353
+
354
+ **No action required:** Your existing code continues to work. Adopt the new fields and `listTraces()` API at your convenience.
355
+
356
+ ### Patch Changes
357
+
358
+ - Added pre-configured client support for all storage adapters. ([#11302](https://github.com/mastra-ai/mastra/pull/11302))
359
+
360
+ **What changed**
361
+
362
+ All storage adapters now accept pre-configured database clients in addition to connection credentials. This allows you to customize client settings (connection pools, timeouts, interceptors) before passing them to Mastra.
363
+
364
+ **Example**
365
+
366
+ ```typescript
367
+ import { createClient } from '@clickhouse/client';
368
+ import { ClickhouseStore } from '@mastra/clickhouse';
369
+
370
+ // Create and configure client with custom settings
371
+ const client = createClient({
372
+ url: 'http://localhost:8123',
373
+ username: 'default',
374
+ password: '',
375
+ request_timeout: 60000,
376
+ });
377
+
378
+ // Pass pre-configured client to store
379
+ const store = new ClickhouseStore({
380
+ id: 'my-store',
381
+ client,
382
+ });
383
+ ```
384
+
385
+ **Additional improvements**
386
+ - Added input validation for required connection parameters (URL, credentials) with clear error messages
387
+
388
+ - Updated dependencies [[`33a4d2e`](https://github.com/mastra-ai/mastra/commit/33a4d2e4ed8af51f69256232f00c34d6b6b51d48), [`4aaa844`](https://github.com/mastra-ai/mastra/commit/4aaa844a4f19d054490f43638a990cc57bda8d2f), [`4a1a6cb`](https://github.com/mastra-ai/mastra/commit/4a1a6cb3facad54b2bb6780b00ce91d6de1edc08), [`31d13d5`](https://github.com/mastra-ai/mastra/commit/31d13d5fdc2e2380e2e3ee3ec9fb29d2a00f265d), [`4c62166`](https://github.com/mastra-ai/mastra/commit/4c621669f4a29b1f443eca3ba70b814afa286266), [`7bcbf10`](https://github.com/mastra-ai/mastra/commit/7bcbf10133516e03df964b941f9a34e9e4ab4177), [`4353600`](https://github.com/mastra-ai/mastra/commit/43536005a65988a8eede236f69122e7f5a284ba2), [`6986fb0`](https://github.com/mastra-ai/mastra/commit/6986fb064f5db6ecc24aa655e1d26529087b43b3), [`053e979`](https://github.com/mastra-ai/mastra/commit/053e9793b28e970086b0507f7f3b76ea32c1e838), [`e26dc9c`](https://github.com/mastra-ai/mastra/commit/e26dc9c3ccfec54ae3dc3e2b2589f741f9ae60a6), [`55edf73`](https://github.com/mastra-ai/mastra/commit/55edf7302149d6c964fbb7908b43babfc2b52145), [`27c0009`](https://github.com/mastra-ai/mastra/commit/27c0009777a6073d7631b0eb7b481d94e165b5ca), [`dee388d`](https://github.com/mastra-ai/mastra/commit/dee388dde02f2e63c53385ae69252a47ab6825cc), [`3f3fc30`](https://github.com/mastra-ai/mastra/commit/3f3fc3096f24c4a26cffeecfe73085928f72aa63), [`d90ea65`](https://github.com/mastra-ai/mastra/commit/d90ea6536f7aa51c6545a4e9215b55858e98e16d), [`d171e55`](https://github.com/mastra-ai/mastra/commit/d171e559ead9f52ec728d424844c8f7b164c4510), [`10c2735`](https://github.com/mastra-ai/mastra/commit/10c27355edfdad1ee2b826b897df74125eb81fb8), [`1924cf0`](https://github.com/mastra-ai/mastra/commit/1924cf06816e5e4d4d5333065ec0f4bb02a97799), [`b339816`](https://github.com/mastra-ai/mastra/commit/b339816df0984d0243d944ac2655d6ba5f809cde)]:
389
+ - @mastra/core@1.0.0-beta.15
390
+
391
+ ## 1.0.0-beta.7
392
+
393
+ ### Patch Changes
394
+
395
+ - Preserve error details when thrown from workflow steps ([#10992](https://github.com/mastra-ai/mastra/pull/10992))
396
+
397
+ Workflow errors now retain custom properties like `statusCode`, `responseHeaders`, and `cause` chains. This enables error-specific recovery logic in your applications.
398
+
399
+ **Before:**
400
+
401
+ ```typescript
402
+ const result = await workflow.execute({ input });
403
+ if (result.status === 'failed') {
404
+ // Custom error properties were lost
405
+ console.log(result.error); // "Step execution failed" (just a string)
406
+ }
407
+ ```
408
+
409
+ **After:**
410
+
411
+ ```typescript
412
+ const result = await workflow.execute({ input });
413
+ if (result.status === 'failed') {
414
+ // Custom properties are preserved
415
+ console.log(result.error.message); // "Step execution failed"
416
+ console.log(result.error.statusCode); // 429
417
+ console.log(result.error.cause?.name); // "RateLimitError"
418
+ }
419
+ ```
420
+
421
+ **Type change:** `WorkflowState.error` and `WorkflowRunState.error` types changed from `string | Error` to `SerializedError`.
422
+
423
+ Other changes:
424
+ - Added `UpdateWorkflowStateOptions` type for workflow state updates
425
+
426
+ - Updated dependencies [[`d5ed981`](https://github.com/mastra-ai/mastra/commit/d5ed981c8701c1b8a27a5f35a9a2f7d9244e695f), [`9650cce`](https://github.com/mastra-ai/mastra/commit/9650cce52a1d917ff9114653398e2a0f5c3ba808), [`932d63d`](https://github.com/mastra-ai/mastra/commit/932d63dd51be9c8bf1e00e3671fe65606c6fb9cd), [`b760b73`](https://github.com/mastra-ai/mastra/commit/b760b731aca7c8a3f041f61d57a7f125ae9cb215), [`695a621`](https://github.com/mastra-ai/mastra/commit/695a621528bdabeb87f83c2277cf2bb084c7f2b4), [`2b459f4`](https://github.com/mastra-ai/mastra/commit/2b459f466fd91688eeb2a44801dc23f7f8a887ab), [`486352b`](https://github.com/mastra-ai/mastra/commit/486352b66c746602b68a95839f830de14c7fb8c0), [`09e4bae`](https://github.com/mastra-ai/mastra/commit/09e4bae18dd5357d2ae078a4a95a2af32168ab08), [`24b76d8`](https://github.com/mastra-ai/mastra/commit/24b76d8e17656269c8ed09a0c038adb9cc2ae95a), [`243a823`](https://github.com/mastra-ai/mastra/commit/243a8239c5906f5c94e4f78b54676793f7510ae3), [`486352b`](https://github.com/mastra-ai/mastra/commit/486352b66c746602b68a95839f830de14c7fb8c0), [`c61fac3`](https://github.com/mastra-ai/mastra/commit/c61fac3add96f0dcce0208c07415279e2537eb62), [`6f14f70`](https://github.com/mastra-ai/mastra/commit/6f14f706ccaaf81b69544b6c1b75ab66a41e5317), [`09e4bae`](https://github.com/mastra-ai/mastra/commit/09e4bae18dd5357d2ae078a4a95a2af32168ab08), [`4524734`](https://github.com/mastra-ai/mastra/commit/45247343e384717a7c8404296275c56201d6470f), [`2a53598`](https://github.com/mastra-ai/mastra/commit/2a53598c6d8cfeb904a7fc74e57e526d751c8fa6), [`c7cd3c7`](https://github.com/mastra-ai/mastra/commit/c7cd3c7a187d7aaf79e2ca139de328bf609a14b4), [`847c212`](https://github.com/mastra-ai/mastra/commit/847c212caba7df0d6f2fc756b494ac3c75c3720d), [`6f941c4`](https://github.com/mastra-ai/mastra/commit/6f941c438ca5f578619788acc7608fc2e23bd176)]:
427
+ - @mastra/core@1.0.0-beta.12
428
+
429
+ ## 1.0.0-beta.6
430
+
431
+ ### Patch Changes
432
+
433
+ - Add delete workflow run API ([#10991](https://github.com/mastra-ai/mastra/pull/10991))
434
+
435
+ ```typescript
436
+ await workflow.deleteWorkflowRunById(runId);
437
+ ```
438
+
439
+ - Updated dependencies [[`edb07e4`](https://github.com/mastra-ai/mastra/commit/edb07e49283e0c28bd094a60e03439bf6ecf0221), [`b7e17d3`](https://github.com/mastra-ai/mastra/commit/b7e17d3f5390bb5a71efc112204413656fcdc18d), [`261473a`](https://github.com/mastra-ai/mastra/commit/261473ac637e633064a22076671e2e02b002214d), [`5d7000f`](https://github.com/mastra-ai/mastra/commit/5d7000f757cd65ea9dc5b05e662fd83dfd44e932), [`4f0331a`](https://github.com/mastra-ai/mastra/commit/4f0331a79bf6eb5ee598a5086e55de4b5a0ada03), [`8a000da`](https://github.com/mastra-ai/mastra/commit/8a000da0c09c679a2312f6b3aa05b2ca78ca7393)]:
440
+ - @mastra/core@1.0.0-beta.10
441
+
442
+ ## 1.0.0-beta.5
443
+
444
+ ### Patch Changes
445
+
446
+ - Fix saveScore not persisting ID correctly, breaking getScoreById retrieval ([#10915](https://github.com/mastra-ai/mastra/pull/10915))
447
+
448
+ **What Changed**
449
+ - saveScore now correctly returns scores that can be retrieved with getScoreById
450
+ - Validation errors now include contextual information (scorer, entity, trace details) for easier debugging
451
+
452
+ **Impact**
453
+ Previously, calling getScoreById after saveScore would return null because the generated ID wasn't persisted to the database. This is now fixed across all store implementations, ensuring consistent behavior and data integrity.
454
+
455
+ - Updated dependencies [[`0d41fe2`](https://github.com/mastra-ai/mastra/commit/0d41fe245355dfc66d61a0d9c85d9400aac351ff), [`6b3ba91`](https://github.com/mastra-ai/mastra/commit/6b3ba91494cc10394df96782f349a4f7b1e152cc), [`7907fd1`](https://github.com/mastra-ai/mastra/commit/7907fd1c5059813b7b870b81ca71041dc807331b)]:
456
+ - @mastra/core@1.0.0-beta.8
457
+
458
+ ## 1.0.0-beta.4
459
+
460
+ ### Minor Changes
461
+
462
+ - Add `disableInit` option to all storage adapters ([#10851](https://github.com/mastra-ai/mastra/pull/10851))
463
+
464
+ Adds a new `disableInit` config option to all storage providers that allows users to disable automatic table creation/migrations at runtime. This is useful for CI/CD pipelines where you want to run migrations during deployment with elevated credentials, then run the application with `disableInit: true` so it doesn't attempt schema changes at runtime.
465
+
466
+ ```typescript
467
+ // CI/CD script - run migrations
468
+ const storage = new PostgresStore({
469
+ connectionString: DATABASE_URL,
470
+ id: 'pg-storage',
471
+ });
472
+ await storage.init();
473
+
474
+ // Runtime - skip auto-init
475
+ const storage = new PostgresStore({
476
+ connectionString: DATABASE_URL,
477
+ id: 'pg-storage',
478
+ disableInit: true,
479
+ });
480
+ ```
481
+
482
+ ### Patch Changes
483
+
484
+ - Standardize error IDs across all storage and vector stores using centralized helper functions (`createStorageErrorId` and `createVectorErrorId`). This ensures consistent error ID patterns (`MASTRA_STORAGE_{STORE}_{OPERATION}_{STATUS}` and `MASTRA_VECTOR_{STORE}_{OPERATION}_{STATUS}`) across the codebase for better error tracking and debugging. ([#10913](https://github.com/mastra-ai/mastra/pull/10913))
485
+
486
+ - Updated dependencies [[`3076c67`](https://github.com/mastra-ai/mastra/commit/3076c6778b18988ae7d5c4c5c466366974b2d63f), [`85d7ee1`](https://github.com/mastra-ai/mastra/commit/85d7ee18ff4e14d625a8a30ec6656bb49804989b), [`c6c1092`](https://github.com/mastra-ai/mastra/commit/c6c1092f8fbf76109303f69e000e96fd1960c4ce), [`81dc110`](https://github.com/mastra-ai/mastra/commit/81dc11008d147cf5bdc8996ead1aa61dbdebb6fc), [`7aedb74`](https://github.com/mastra-ai/mastra/commit/7aedb74883adf66af38e270e4068fd42e7a37036), [`8f02d80`](https://github.com/mastra-ai/mastra/commit/8f02d800777397e4b45d7f1ad041988a8b0c6630), [`d7aad50`](https://github.com/mastra-ai/mastra/commit/d7aad501ce61646b76b4b511e558ac4eea9884d0), [`ce0a73a`](https://github.com/mastra-ai/mastra/commit/ce0a73abeaa75b10ca38f9e40a255a645d50ebfb), [`a02e542`](https://github.com/mastra-ai/mastra/commit/a02e542d23179bad250b044b17ff023caa61739f), [`a372c64`](https://github.com/mastra-ai/mastra/commit/a372c640ad1fd12e8f0613cebdc682fc156b4d95), [`8846867`](https://github.com/mastra-ai/mastra/commit/8846867ffa9a3746767618e314bebac08eb77d87), [`42a42cf`](https://github.com/mastra-ai/mastra/commit/42a42cf3132b9786feecbb8c13c583dce5b0e198), [`ae08bf0`](https://github.com/mastra-ai/mastra/commit/ae08bf0ebc6a4e4da992b711c4a389c32ba84cf4), [`21735a7`](https://github.com/mastra-ai/mastra/commit/21735a7ef306963554a69a89b44f06c3bcd85141), [`1d877b8`](https://github.com/mastra-ai/mastra/commit/1d877b8d7b536a251c1a7a18db7ddcf4f68d6f8b)]:
487
+ - @mastra/core@1.0.0-beta.7
488
+
489
+ ## 1.0.0-beta.3
490
+
491
+ ### Minor Changes
492
+
493
+ - feat(storage): support querying messages from multiple threads ([#10663](https://github.com/mastra-ai/mastra/pull/10663))
494
+ - Fixed TypeScript errors where `threadId: string | string[]` was being passed to places expecting `Scalar` type
495
+ - Added proper multi-thread support for `listMessages` across all adapters when `threadId` is an array
496
+ - Updated `_getIncludedMessages` to look up message threadId by ID (since message IDs are globally unique)
497
+ - **upstash**: Added `msg-idx:{messageId}` index for O(1) message lookups (backwards compatible with fallback to scan for old messages, with automatic backfill)
498
+
499
+ ### Patch Changes
500
+
501
+ - Unify transformScoreRow functions across storage adapters ([#10648](https://github.com/mastra-ai/mastra/pull/10648))
502
+
503
+ Added a unified `transformScoreRow` function in `@mastra/core/storage` that provides schema-driven row transformation for score data. This eliminates code duplication across 10 storage adapters while maintaining store-specific behavior through configurable options:
504
+ - `preferredTimestampFields`: Preferred source fields for timestamps (PostgreSQL, Cloudflare D1)
505
+ - `convertTimestamps`: Convert timestamp strings to Date objects (MSSQL, MongoDB, ClickHouse)
506
+ - `nullValuePattern`: Skip values matching pattern (ClickHouse's `'_null_'`)
507
+ - `fieldMappings`: Map source column names to schema fields (LibSQL's `additionalLLMContext`)
508
+
509
+ Each store adapter now uses the unified function with appropriate options, reducing ~200 lines of duplicate transformation logic while ensuring consistent behavior across all storage backends.
510
+
511
+ - Updated dependencies [[`ac0d2f4`](https://github.com/mastra-ai/mastra/commit/ac0d2f4ff8831f72c1c66c2be809706d17f65789), [`1a0d3fc`](https://github.com/mastra-ai/mastra/commit/1a0d3fc811482c9c376cdf79ee615c23bae9b2d6), [`85a628b`](https://github.com/mastra-ai/mastra/commit/85a628b1224a8f64cd82ea7f033774bf22df7a7e), [`c237233`](https://github.com/mastra-ai/mastra/commit/c23723399ccedf7f5744b3f40997b79246bfbe64), [`15f9e21`](https://github.com/mastra-ai/mastra/commit/15f9e216177201ea6e3f6d0bfb063fcc0953444f), [`ff94dea`](https://github.com/mastra-ai/mastra/commit/ff94dea935f4e34545c63bcb6c29804732698809), [`5b2ff46`](https://github.com/mastra-ai/mastra/commit/5b2ff4651df70c146523a7fca773f8eb0a2272f8), [`db41688`](https://github.com/mastra-ai/mastra/commit/db4168806d007417e2e60b4f68656dca4e5f40c9), [`5ca599d`](https://github.com/mastra-ai/mastra/commit/5ca599d0bb59a1595f19f58473fcd67cc71cef58), [`bff1145`](https://github.com/mastra-ai/mastra/commit/bff114556b3cbadad9b2768488708f8ad0e91475), [`5c8ca24`](https://github.com/mastra-ai/mastra/commit/5c8ca247094e0cc2cdbd7137822fb47241f86e77), [`e191844`](https://github.com/mastra-ai/mastra/commit/e1918444ca3f80e82feef1dad506cd4ec6e2875f), [`22553f1`](https://github.com/mastra-ai/mastra/commit/22553f11c63ee5e966a9c034a349822249584691), [`7237163`](https://github.com/mastra-ai/mastra/commit/72371635dbf96a87df4b073cc48fc655afbdce3d), [`2500740`](https://github.com/mastra-ai/mastra/commit/2500740ea23da067d6e50ec71c625ab3ce275e64), [`873ecbb`](https://github.com/mastra-ai/mastra/commit/873ecbb517586aa17d2f1e99283755b3ebb2863f), [`4f9bbe5`](https://github.com/mastra-ai/mastra/commit/4f9bbe5968f42c86f4930b8193de3c3c17e5bd36), [`02e51fe`](https://github.com/mastra-ai/mastra/commit/02e51feddb3d4155cfbcc42624fd0d0970d032c0), [`8f3fa3a`](https://github.com/mastra-ai/mastra/commit/8f3fa3a652bb77da092f913ec51ae46e3a7e27dc), [`cd29ad2`](https://github.com/mastra-ai/mastra/commit/cd29ad23a255534e8191f249593849ed29160886), [`bdf4d8c`](https://github.com/mastra-ai/mastra/commit/bdf4d8cdc656d8a2c21d81834bfa3bfa70f56c16), [`854e3da`](https://github.com/mastra-ai/mastra/commit/854e3dad5daac17a91a20986399d3a51f54bf68b), [`ce18d38`](https://github.com/mastra-ai/mastra/commit/ce18d38678c65870350d123955014a8432075fd9), [`cccf9c8`](https://github.com/mastra-ai/mastra/commit/cccf9c8b2d2dfc1a5e63919395b83d78c89682a0), [`61a5705`](https://github.com/mastra-ai/mastra/commit/61a570551278b6743e64243b3ce7d73de915ca8a), [`db70a48`](https://github.com/mastra-ai/mastra/commit/db70a48aeeeeb8e5f92007e8ede52c364ce15287), [`f0fdc14`](https://github.com/mastra-ai/mastra/commit/f0fdc14ee233d619266b3d2bbdeea7d25cfc6d13), [`db18bc9`](https://github.com/mastra-ai/mastra/commit/db18bc9c3825e2c1a0ad9a183cc9935f6691bfa1), [`9b37b56`](https://github.com/mastra-ai/mastra/commit/9b37b565e1f2a76c24f728945cc740c2b09be9da), [`41a23c3`](https://github.com/mastra-ai/mastra/commit/41a23c32f9877d71810f37e24930515df2ff7a0f), [`5d171ad`](https://github.com/mastra-ai/mastra/commit/5d171ad9ef340387276b77c2bb3e83e83332d729), [`f03ae60`](https://github.com/mastra-ai/mastra/commit/f03ae60500fe350c9d828621006cdafe1975fdd8), [`d1e74a0`](https://github.com/mastra-ai/mastra/commit/d1e74a0a293866dece31022047f5dbab65a304d0), [`39e7869`](https://github.com/mastra-ai/mastra/commit/39e7869bc7d0ee391077ce291474d8a84eedccff), [`5761926`](https://github.com/mastra-ai/mastra/commit/57619260c4a2cdd598763abbacd90de594c6bc76), [`c900fdd`](https://github.com/mastra-ai/mastra/commit/c900fdd504c41348efdffb205cfe80d48c38fa33), [`604a79f`](https://github.com/mastra-ai/mastra/commit/604a79fecf276e26a54a3fe01bb94e65315d2e0e), [`887f0b4`](https://github.com/mastra-ai/mastra/commit/887f0b4746cdbd7cb7d6b17ac9f82aeb58037ea5), [`2562143`](https://github.com/mastra-ai/mastra/commit/256214336b4faa78646c9c1776612393790d8784), [`ef11a61`](https://github.com/mastra-ai/mastra/commit/ef11a61920fa0ed08a5b7ceedd192875af119749)]:
512
+ - @mastra/core@1.0.0-beta.6
513
+
514
+ ## 1.0.0-beta.2
515
+
516
+ ### Patch Changes
517
+
518
+ - Add new deleteVectors, updateVector by filter ([#10408](https://github.com/mastra-ai/mastra/pull/10408))
519
+
520
+ - Fix message sorting in listMessages when using semantic recall (include parameter). Messages are now always sorted by createdAt instead of storage order, ensuring correct chronological ordering of conversation history. ([#10491](https://github.com/mastra-ai/mastra/pull/10491))
521
+
522
+ - Updated dependencies [[`21a15de`](https://github.com/mastra-ai/mastra/commit/21a15de369fe82aac26bb642ed7be73505475e8b), [`feb7ee4`](https://github.com/mastra-ai/mastra/commit/feb7ee4d09a75edb46c6669a3beaceec78811747), [`b0e2ea5`](https://github.com/mastra-ai/mastra/commit/b0e2ea5b52c40fae438b9e2f7baee6f0f89c5442), [`c456e01`](https://github.com/mastra-ai/mastra/commit/c456e0149e3c176afcefdbd9bb1d2c5917723725), [`ab035c2`](https://github.com/mastra-ai/mastra/commit/ab035c2ef6d8cc7bb25f06f1a38508bd9e6f126b), [`1a46a56`](https://github.com/mastra-ai/mastra/commit/1a46a566f45a3fcbadc1cf36bf86d351f264bfa3), [`3cf540b`](https://github.com/mastra-ai/mastra/commit/3cf540b9fbfea8f4fc8d3a2319a4e6c0b0cbfd52), [`1c6ce51`](https://github.com/mastra-ai/mastra/commit/1c6ce51f875915ab57fd36873623013699a2a65d), [`898a972`](https://github.com/mastra-ai/mastra/commit/898a9727d286c2510d6b702dfd367e6aaf5c6b0f), [`a97003a`](https://github.com/mastra-ai/mastra/commit/a97003aa1cf2f4022a41912324a1e77263b326b8), [`ccc141e`](https://github.com/mastra-ai/mastra/commit/ccc141ed27da0abc3a3fc28e9e5128152e8e37f4), [`fe3b897`](https://github.com/mastra-ai/mastra/commit/fe3b897c2ccbcd2b10e81b099438c7337feddf89), [`00123ba`](https://github.com/mastra-ai/mastra/commit/00123ba96dc9e5cd0b110420ebdba56d8f237b25), [`29c4309`](https://github.com/mastra-ai/mastra/commit/29c4309f818b24304c041bcb4a8f19b5f13f6b62), [`16785ce`](https://github.com/mastra-ai/mastra/commit/16785ced928f6f22638f4488cf8a125d99211799), [`de8239b`](https://github.com/mastra-ai/mastra/commit/de8239bdcb1d8c0cfa06da21f1569912a66bbc8a), [`b5e6cd7`](https://github.com/mastra-ai/mastra/commit/b5e6cd77fc8c8e64e0494c1d06cee3d84e795d1e), [`3759cb0`](https://github.com/mastra-ai/mastra/commit/3759cb064935b5f74c65ac2f52a1145f7352899d), [`651e772`](https://github.com/mastra-ai/mastra/commit/651e772eb1475fb13e126d3fcc01751297a88214), [`b61b93f`](https://github.com/mastra-ai/mastra/commit/b61b93f9e058b11dd2eec169853175d31dbdd567), [`bae33d9`](https://github.com/mastra-ai/mastra/commit/bae33d91a63fbb64d1e80519e1fc1acaed1e9013), [`c0b731f`](https://github.com/mastra-ai/mastra/commit/c0b731fb27d712dc8582e846df5c0332a6a0c5ba), [`43ca8f2`](https://github.com/mastra-ai/mastra/commit/43ca8f2c7334851cc7b4d3d2f037d8784bfbdd5f), [`2ca67cc`](https://github.com/mastra-ai/mastra/commit/2ca67cc3bb1f6a617353fdcab197d9efebe60d6f), [`9e67002`](https://github.com/mastra-ai/mastra/commit/9e67002b52c9be19936c420a489dbee9c5fd6a78), [`35edc49`](https://github.com/mastra-ai/mastra/commit/35edc49ac0556db609189641d6341e76771b81fc)]:
523
+ - @mastra/core@1.0.0-beta.5
524
+
3
525
  ## 1.0.0-beta.1
4
526
 
5
527
  ### Patch Changes
package/README.md CHANGED
@@ -161,6 +161,18 @@ The Upstash store requires the following configuration:
161
161
  - `UPSTASH_REDIS_REST_URL`: Your Upstash Redis REST URL
162
162
  - `UPSTASH_REDIS_REST_TOKEN`: Your Upstash Redis REST token
163
163
 
164
+ ## Vector Store Methods
165
+
166
+ - `createIndex({ indexName, dimension, metric? })`: Create a new namespace
167
+ - `upsert({ indexName, vectors, sparseVectors?, metadata?, ids? })`: Add or update vectors (supports hybrid search)
168
+ - `query({ indexName, queryVector, sparseQueryVector?, topK?, filter?, includeVector?, includeMetadata?, mode?, fusionAlgorithm? })`: Search for similar vectors
169
+ - `updateVector({ indexName, id?, filter?, update })`: Update a single vector by ID or metadata filter
170
+ - `deleteVector({ indexName, id })`: Delete a single vector by ID
171
+ - `deleteVectors({ indexName, ids?, filter? })`: Delete multiple vectors by IDs or metadata filter
172
+ - `listIndexes()`: List all namespaces
173
+ - `describeIndex({ indexName })`: Get namespace statistics
174
+ - `deleteIndex({ indexName })`: Delete a namespace
175
+
164
176
  ## Features
165
177
 
166
178
  - Serverless vector database and key-value store
@@ -0,0 +1,34 @@
1
+ # @mastra/upstash Documentation
2
+
3
+ > Embedded documentation for coding agents
4
+
5
+ ## Quick Start
6
+
7
+ ```bash
8
+ # Read the skill overview
9
+ cat docs/SKILL.md
10
+
11
+ # Get the source map
12
+ cat docs/SOURCE_MAP.json
13
+
14
+ # Read topic documentation
15
+ cat docs/<topic>/01-overview.md
16
+ ```
17
+
18
+ ## Structure
19
+
20
+ ```
21
+ docs/
22
+ ├── SKILL.md # Entry point
23
+ ├── README.md # This file
24
+ ├── SOURCE_MAP.json # Export index
25
+ ├── memory/ (1 files)
26
+ ├── rag/ (2 files)
27
+ ├── storage/ (1 files)
28
+ ├── vectors/ (1 files)
29
+ ```
30
+
31
+ ## Version
32
+
33
+ Package: @mastra/upstash
34
+ Version: 1.0.0-beta.11
@@ -0,0 +1,35 @@
1
+ ---
2
+ name: mastra-upstash-docs
3
+ description: Documentation for @mastra/upstash. Includes links to type definitions and readable implementation code in dist/.
4
+ ---
5
+
6
+ # @mastra/upstash Documentation
7
+
8
+ > **Version**: 1.0.0-beta.11
9
+ > **Package**: @mastra/upstash
10
+
11
+ ## Quick Navigation
12
+
13
+ Use SOURCE_MAP.json to find any export:
14
+
15
+ ```bash
16
+ cat docs/SOURCE_MAP.json
17
+ ```
18
+
19
+ Each export maps to:
20
+ - **types**: `.d.ts` file with JSDoc and API signatures
21
+ - **implementation**: `.js` chunk file with readable source
22
+ - **docs**: Conceptual documentation in `docs/`
23
+
24
+ ## Top Exports
25
+
26
+
27
+
28
+ See SOURCE_MAP.json for the complete list.
29
+
30
+ ## Available Topics
31
+
32
+ - [Memory](memory/) - 1 file(s)
33
+ - [Rag](rag/) - 2 file(s)
34
+ - [Storage](storage/) - 1 file(s)
35
+ - [Vectors](vectors/) - 1 file(s)
@@ -0,0 +1,6 @@
1
+ {
2
+ "version": "1.0.0-beta.11",
3
+ "package": "@mastra/upstash",
4
+ "exports": {},
5
+ "modules": {}
6
+ }