@mastra/mssql 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,454 @@
1
1
  # @mastra/mssql
2
2
 
3
+ ## 1.0.0-beta.11
4
+
5
+ ### Patch Changes
6
+
7
+ - dependencies updates: ([#10197](https://github.com/mastra-ai/mastra/pull/10197))
8
+ - Updated dependency [`mssql@^12.2.0` ↗︎](https://www.npmjs.com/package/mssql/v/12.2.0) (from `^11.0.1`, in `dependencies`)
9
+ - Updated dependencies [[`08766f1`](https://github.com/mastra-ai/mastra/commit/08766f15e13ac0692fde2a8bd366c2e16e4321df), [`ae8baf7`](https://github.com/mastra-ai/mastra/commit/ae8baf7d8adcb0ff9dac11880400452bc49b33ff), [`cfabdd4`](https://github.com/mastra-ai/mastra/commit/cfabdd4aae7a726b706942d6836eeca110fb6267), [`a0e437f`](https://github.com/mastra-ai/mastra/commit/a0e437fac561b28ee719e0302d72b2f9b4c138f0), [`bec5efd`](https://github.com/mastra-ai/mastra/commit/bec5efde96653ccae6604e68c696d1bc6c1a0bf5), [`9eedf7d`](https://github.com/mastra-ai/mastra/commit/9eedf7de1d6e0022a2f4e5e9e6fe1ec468f9b43c)]:
10
+ - @mastra/core@1.0.0-beta.21
11
+
12
+ ## 1.0.0-beta.10
13
+
14
+ ### Patch Changes
15
+
16
+ - Add embedded documentation support for Mastra packages ([#11472](https://github.com/mastra-ai/mastra/pull/11472))
17
+
18
+ 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`.
19
+
20
+ Each package includes:
21
+ - **SKILL.md** - Entry point explaining the package's purpose and capabilities
22
+ - **SOURCE_MAP.json** - Machine-readable index mapping exports to types and implementation files
23
+ - **Topic folders** - Conceptual documentation organized by feature area
24
+
25
+ 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.
26
+
27
+ - Added `startExclusive` and `endExclusive` options to `dateRange` filter for message queries. ([#11479](https://github.com/mastra-ai/mastra/pull/11479))
28
+
29
+ **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.
30
+
31
+ **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.
32
+
33
+ **Example:**
34
+
35
+ ```typescript
36
+ // Get first page
37
+ const page1 = await memory.recall({
38
+ threadId: 'thread-123',
39
+ perPage: 10,
40
+ orderBy: { field: 'createdAt', direction: 'DESC' },
41
+ });
42
+
43
+ // Get next page using cursor-based pagination
44
+ const oldestMessage = page1.messages[page1.messages.length - 1];
45
+ const page2 = await memory.recall({
46
+ threadId: 'thread-123',
47
+ perPage: 10,
48
+ orderBy: { field: 'createdAt', direction: 'DESC' },
49
+ filter: {
50
+ dateRange: {
51
+ end: oldestMessage.createdAt,
52
+ endExclusive: true, // Excludes the cursor message
53
+ },
54
+ },
55
+ });
56
+ ```
57
+
58
+ - 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)]:
59
+ - @mastra/core@1.0.0-beta.20
60
+
61
+ ## 1.0.0-beta.9
62
+
63
+ ### Patch Changes
64
+
65
+ - Add storage composition to MastraStorage ([#11401](https://github.com/mastra-ai/mastra/pull/11401))
66
+
67
+ `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.
68
+
69
+ ```typescript
70
+ import { MastraStorage } from '@mastra/core/storage';
71
+ import { MemoryPG, WorkflowsPG, ScoresPG } from '@mastra/pg';
72
+ import { MemoryLibSQL } from '@mastra/libsql';
73
+
74
+ // Compose domains from different stores
75
+ const storage = new MastraStorage({
76
+ id: 'composite',
77
+ domains: {
78
+ memory: new MemoryLibSQL({ url: 'file:./local.db' }),
79
+ workflows: new WorkflowsPG({ connectionString: process.env.DATABASE_URL }),
80
+ scores: new ScoresPG({ connectionString: process.env.DATABASE_URL }),
81
+ },
82
+ });
83
+ ```
84
+
85
+ **Breaking changes:**
86
+ - `storage.supports` property no longer exists
87
+ - `StorageSupports` type is no longer exported from `@mastra/core/storage`
88
+
89
+ All stores now support the same features. For domain availability, use `getStore()`:
90
+
91
+ ```typescript
92
+ const store = await storage.getStore('memory');
93
+ if (store) {
94
+ // domain is available
95
+ }
96
+ ```
97
+
98
+ - 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)]:
99
+ - @mastra/core@1.0.0-beta.16
100
+
101
+ ## 1.0.0-beta.8
102
+
103
+ ### Minor Changes
104
+
105
+ - Introduce StorageDomain base class for composite storage support ([#11249](https://github.com/mastra-ai/mastra/pull/11249))
106
+
107
+ 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.
108
+
109
+ **Key changes:**
110
+ - Add `StorageDomain` abstract base class that all domain storage classes extend
111
+ - Add `InMemoryDB` class for shared state across in-memory domain implementations
112
+ - All storage domains now implement `dangerouslyClearAll()` for test cleanup
113
+ - Remove `operations` from public `StorageDomains` type (now internal to each adapter)
114
+ - Add flexible client/config patterns - domains accept either an existing database client or config to create one internally
115
+
116
+ **Why this matters:**
117
+
118
+ This enables composite storage where you can use different database adapters per domain:
119
+
120
+ ```typescript
121
+ import { Mastra } from '@mastra/core';
122
+ import { PostgresStore } from '@mastra/pg';
123
+ import { ClickhouseStore } from '@mastra/clickhouse';
124
+
125
+ // Use Postgres for most domains but Clickhouse for observability
126
+ const mastra = new Mastra({
127
+ storage: new PostgresStore({
128
+ connectionString: 'postgres://...',
129
+ }),
130
+ // Future: override specific domains
131
+ // observability: new ClickhouseStore({ ... }).getStore('observability'),
132
+ });
133
+ ```
134
+
135
+ **Standalone domain usage:**
136
+
137
+ Domains can now be used independently with flexible configuration:
138
+
139
+ ```typescript
140
+ import { MemoryLibSQL } from '@mastra/libsql/memory';
141
+
142
+ // Option 1: Pass config to create client internally
143
+ const memory = new MemoryLibSQL({
144
+ url: 'file:./local.db',
145
+ });
146
+
147
+ // Option 2: Pass existing client for shared connections
148
+ import { createClient } from '@libsql/client';
149
+ const client = createClient({ url: 'file:./local.db' });
150
+ const memory = new MemoryLibSQL({ client });
151
+ ```
152
+
153
+ **Breaking changes:**
154
+ - `StorageDomains` type no longer includes `operations` - access via `getStore()` instead
155
+ - Domain base classes now require implementing `dangerouslyClearAll()` method
156
+
157
+ - Refactor storage architecture to use domain-specific stores via `getStore()` pattern ([#11361](https://github.com/mastra-ai/mastra/pull/11361))
158
+
159
+ ### Summary
160
+
161
+ 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.
162
+
163
+ ### Migration Guide
164
+
165
+ All direct method calls on storage instances should be updated to use `getStore()`:
166
+
167
+ ```typescript
168
+ // Before
169
+ const thread = await storage.getThreadById({ threadId });
170
+ await storage.persistWorkflowSnapshot({ workflowName, runId, snapshot });
171
+ await storage.createSpan(span);
172
+
173
+ // After
174
+ const memory = await storage.getStore('memory');
175
+ const thread = await memory?.getThreadById({ threadId });
176
+
177
+ const workflows = await storage.getStore('workflows');
178
+ await workflows?.persistWorkflowSnapshot({ workflowName, runId, snapshot });
179
+
180
+ const observability = await storage.getStore('observability');
181
+ await observability?.createSpan(span);
182
+ ```
183
+
184
+ ### Available Domains
185
+ - **`memory`**: Thread and message operations (`getThreadById`, `saveThread`, `saveMessages`, etc.)
186
+ - **`workflows`**: Workflow state persistence (`persistWorkflowSnapshot`, `loadWorkflowSnapshot`, `getWorkflowRunById`, etc.)
187
+ - **`scores`**: Evaluation scores (`saveScore`, `listScoresByScorerId`, etc.)
188
+ - **`observability`**: Tracing and spans (`createSpan`, `updateSpan`, `getTrace`, etc.)
189
+ - **`agents`**: Stored agent configurations (`createAgent`, `getAgentById`, `listAgents`, etc.)
190
+
191
+ ### Breaking Changes
192
+ - Passthrough methods have been removed from `MastraStorage` base class
193
+ - All storage adapters now require accessing domains via `getStore()`
194
+ - The `stores` property on storage instances is now the canonical way to access domain storage
195
+
196
+ ### Internal Changes
197
+ - Each storage adapter now initializes domain-specific stores in its constructor
198
+ - Domain stores share database connections and handle their own table initialization
199
+
200
+ - Unified observability schema with entity-based span identification ([#11132](https://github.com/mastra-ai/mastra/pull/11132))
201
+
202
+ ## What changed
203
+
204
+ Spans now use a unified identification model with `entityId`, `entityType`, and `entityName` instead of separate `agentId`, `toolId`, `workflowId` fields.
205
+
206
+ **Before:**
207
+
208
+ ```typescript
209
+ // Old span structure
210
+ span.agentId; // 'my-agent'
211
+ span.toolId; // undefined
212
+ span.workflowId; // undefined
213
+ ```
214
+
215
+ **After:**
216
+
217
+ ```typescript
218
+ // New span structure
219
+ span.entityType; // EntityType.AGENT
220
+ span.entityId; // 'my-agent'
221
+ span.entityName; // 'My Agent'
222
+ ```
223
+
224
+ ## New `listTraces()` API
225
+
226
+ Query traces with filtering, pagination, and sorting:
227
+
228
+ ```typescript
229
+ const { spans, pagination } = await storage.listTraces({
230
+ filters: {
231
+ entityType: EntityType.AGENT,
232
+ entityId: 'my-agent',
233
+ userId: 'user-123',
234
+ environment: 'production',
235
+ status: TraceStatus.SUCCESS,
236
+ startedAt: { start: new Date('2024-01-01'), end: new Date('2024-01-31') },
237
+ },
238
+ pagination: { page: 0, perPage: 50 },
239
+ orderBy: { field: 'startedAt', direction: 'DESC' },
240
+ });
241
+ ```
242
+
243
+ **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`.
244
+
245
+ ## New retrieval methods
246
+ - `getSpan({ traceId, spanId })` - Get a single span
247
+ - `getRootSpan({ traceId })` - Get the root span of a trace
248
+ - `getTrace({ traceId })` - Get all spans for a trace
249
+
250
+ ## Backward compatibility
251
+
252
+ The legacy `getTraces()` method continues to work. When you pass `name: "agent run: my-agent"`, it automatically transforms to `entityId: "my-agent", entityType: AGENT`.
253
+
254
+ ## Migration
255
+
256
+ **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`.
257
+
258
+ **No action required:** Your existing code continues to work. Adopt the new fields and `listTraces()` API at your convenience.
259
+
260
+ ### Patch Changes
261
+
262
+ - Added pre-configured client support for all storage adapters. ([#11302](https://github.com/mastra-ai/mastra/pull/11302))
263
+
264
+ **What changed**
265
+
266
+ 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.
267
+
268
+ **Example**
269
+
270
+ ```typescript
271
+ import { createClient } from '@clickhouse/client';
272
+ import { ClickhouseStore } from '@mastra/clickhouse';
273
+
274
+ // Create and configure client with custom settings
275
+ const client = createClient({
276
+ url: 'http://localhost:8123',
277
+ username: 'default',
278
+ password: '',
279
+ request_timeout: 60000,
280
+ });
281
+
282
+ // Pass pre-configured client to store
283
+ const store = new ClickhouseStore({
284
+ id: 'my-store',
285
+ client,
286
+ });
287
+ ```
288
+
289
+ **Additional improvements**
290
+ - Added input validation for required connection parameters (URL, credentials) with clear error messages
291
+
292
+ - Add index configuration options to storage stores ([#11311](https://github.com/mastra-ai/mastra/pull/11311))
293
+
294
+ Storage stores now support two new configuration options for index management:
295
+ - `skipDefaultIndexes`: When `true`, default performance indexes are not created during `init()`. Useful for custom index strategies or reducing initialization time.
296
+ - `indexes`: Array of custom index definitions to create during `init()`. Indexes are routed to the appropriate domain based on table/collection name.
297
+
298
+ ```typescript
299
+ // Skip default indexes and use custom ones
300
+ const store = new PostgresStore({
301
+ connectionString: '...',
302
+ skipDefaultIndexes: true,
303
+ indexes: [{ name: 'threads_type_idx', table: 'mastra_threads', columns: ["metadata->>'type'"] }],
304
+ });
305
+
306
+ // MongoDB equivalent
307
+ const mongoStore = new MongoDBStore({
308
+ url: 'mongodb://...',
309
+ skipDefaultIndexes: true,
310
+ indexes: [{ collection: 'mastra_threads', keys: { 'metadata.type': 1 }, options: { name: 'threads_type_idx' } }],
311
+ });
312
+ ```
313
+
314
+ Domain classes (e.g., `MemoryPG`, `MemoryStorageMongoDB`) also accept these options for standalone usage.
315
+
316
+ - 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)]:
317
+ - @mastra/core@1.0.0-beta.15
318
+
319
+ ## 1.0.0-beta.7
320
+
321
+ ### Patch Changes
322
+
323
+ - Preserve error details when thrown from workflow steps ([#10992](https://github.com/mastra-ai/mastra/pull/10992))
324
+
325
+ Workflow errors now retain custom properties like `statusCode`, `responseHeaders`, and `cause` chains. This enables error-specific recovery logic in your applications.
326
+
327
+ **Before:**
328
+
329
+ ```typescript
330
+ const result = await workflow.execute({ input });
331
+ if (result.status === 'failed') {
332
+ // Custom error properties were lost
333
+ console.log(result.error); // "Step execution failed" (just a string)
334
+ }
335
+ ```
336
+
337
+ **After:**
338
+
339
+ ```typescript
340
+ const result = await workflow.execute({ input });
341
+ if (result.status === 'failed') {
342
+ // Custom properties are preserved
343
+ console.log(result.error.message); // "Step execution failed"
344
+ console.log(result.error.statusCode); // 429
345
+ console.log(result.error.cause?.name); // "RateLimitError"
346
+ }
347
+ ```
348
+
349
+ **Type change:** `WorkflowState.error` and `WorkflowRunState.error` types changed from `string | Error` to `SerializedError`.
350
+
351
+ Other changes:
352
+ - Added `UpdateWorkflowStateOptions` type for workflow state updates
353
+
354
+ - 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)]:
355
+ - @mastra/core@1.0.0-beta.12
356
+
357
+ ## 1.0.0-beta.6
358
+
359
+ ### Patch Changes
360
+
361
+ - Add delete workflow run API ([#10991](https://github.com/mastra-ai/mastra/pull/10991))
362
+
363
+ ```typescript
364
+ await workflow.deleteWorkflowRunById(runId);
365
+ ```
366
+
367
+ - 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)]:
368
+ - @mastra/core@1.0.0-beta.10
369
+
370
+ ## 1.0.0-beta.5
371
+
372
+ ### Patch Changes
373
+
374
+ - Fix saveScore not persisting ID correctly, breaking getScoreById retrieval ([#10915](https://github.com/mastra-ai/mastra/pull/10915))
375
+
376
+ **What Changed**
377
+ - saveScore now correctly returns scores that can be retrieved with getScoreById
378
+ - Validation errors now include contextual information (scorer, entity, trace details) for easier debugging
379
+
380
+ **Impact**
381
+ 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.
382
+
383
+ - 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)]:
384
+ - @mastra/core@1.0.0-beta.8
385
+
386
+ ## 1.0.0-beta.4
387
+
388
+ ### Minor Changes
389
+
390
+ - Add `disableInit` option to all storage adapters ([#10851](https://github.com/mastra-ai/mastra/pull/10851))
391
+
392
+ 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.
393
+
394
+ ```typescript
395
+ // CI/CD script - run migrations
396
+ const storage = new PostgresStore({
397
+ connectionString: DATABASE_URL,
398
+ id: 'pg-storage',
399
+ });
400
+ await storage.init();
401
+
402
+ // Runtime - skip auto-init
403
+ const storage = new PostgresStore({
404
+ connectionString: DATABASE_URL,
405
+ id: 'pg-storage',
406
+ disableInit: true,
407
+ });
408
+ ```
409
+
410
+ ### Patch Changes
411
+
412
+ - 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))
413
+
414
+ - 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)]:
415
+ - @mastra/core@1.0.0-beta.7
416
+
417
+ ## 1.0.0-beta.3
418
+
419
+ ### Patch Changes
420
+
421
+ - feat(storage): support querying messages from multiple threads ([#10663](https://github.com/mastra-ai/mastra/pull/10663))
422
+ - Fixed TypeScript errors where `threadId: string | string[]` was being passed to places expecting `Scalar` type
423
+ - Added proper multi-thread support for `listMessages` across all adapters when `threadId` is an array
424
+ - Updated `_getIncludedMessages` to look up message threadId by ID (since message IDs are globally unique)
425
+ - **upstash**: Added `msg-idx:{messageId}` index for O(1) message lookups (backwards compatible with fallback to scan for old messages, with automatic backfill)
426
+
427
+ - fix: ensure score responses match saved payloads for Mastra Stores. ([#10557](https://github.com/mastra-ai/mastra/pull/10557))
428
+
429
+ - Unify transformScoreRow functions across storage adapters ([#10648](https://github.com/mastra-ai/mastra/pull/10648))
430
+
431
+ 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:
432
+ - `preferredTimestampFields`: Preferred source fields for timestamps (PostgreSQL, Cloudflare D1)
433
+ - `convertTimestamps`: Convert timestamp strings to Date objects (MSSQL, MongoDB, ClickHouse)
434
+ - `nullValuePattern`: Skip values matching pattern (ClickHouse's `'_null_'`)
435
+ - `fieldMappings`: Map source column names to schema fields (LibSQL's `additionalLLMContext`)
436
+
437
+ 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.
438
+
439
+ - 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)]:
440
+ - @mastra/core@1.0.0-beta.6
441
+
442
+ ## 1.0.0-beta.2
443
+
444
+ ### Patch Changes
445
+
446
+ - Add restart method to workflow run that allows restarting an active workflow run ([#9750](https://github.com/mastra-ai/mastra/pull/9750))
447
+ Add status filter to `listWorkflowRuns`
448
+ Add automatic restart to restart active workflow runs when server starts
449
+ - Updated dependencies [[`2319326`](https://github.com/mastra-ai/mastra/commit/2319326f8c64e503a09bbcf14be2dd65405445e0), [`d629361`](https://github.com/mastra-ai/mastra/commit/d629361a60f6565b5bfb11976fdaf7308af858e2), [`08c31c1`](https://github.com/mastra-ai/mastra/commit/08c31c188ebccd598acaf55e888b6397d01f7eae), [`fd3d338`](https://github.com/mastra-ai/mastra/commit/fd3d338a2c362174ed5b383f1f011ad9fb0302aa), [`c30400a`](https://github.com/mastra-ai/mastra/commit/c30400a49b994b1b97256fe785eb6c906fc2b232), [`69e0a87`](https://github.com/mastra-ai/mastra/commit/69e0a878896a2da9494945d86e056a5f8f05b851), [`01f8878`](https://github.com/mastra-ai/mastra/commit/01f88783de25e4de048c1c8aace43e26373c6ea5), [`4c77209`](https://github.com/mastra-ai/mastra/commit/4c77209e6c11678808b365d545845918c40045c8), [`d827d08`](https://github.com/mastra-ai/mastra/commit/d827d0808ffe1f3553a84e975806cc989b9735dd), [`23c10a1`](https://github.com/mastra-ai/mastra/commit/23c10a1efdd9a693c405511ab2dc8a1236603162), [`676ccc7`](https://github.com/mastra-ai/mastra/commit/676ccc7fe92468d2d45d39c31a87825c89fd1ea0), [`c10398d`](https://github.com/mastra-ai/mastra/commit/c10398d5b88f1d4af556f4267ff06f1d11e89179), [`00c2387`](https://github.com/mastra-ai/mastra/commit/00c2387f5f04a365316f851e58666ac43f8c4edf), [`ad6250d`](https://github.com/mastra-ai/mastra/commit/ad6250dbdaad927e29f74a27b83f6c468b50a705), [`3a73998`](https://github.com/mastra-ai/mastra/commit/3a73998fa4ebeb7f3dc9301afe78095fc63e7999), [`e16d553`](https://github.com/mastra-ai/mastra/commit/e16d55338403c7553531cc568125c63d53653dff), [`4d59f58`](https://github.com/mastra-ai/mastra/commit/4d59f58de2d90d6e2810a19d4518e38ddddb9038), [`e1bb9c9`](https://github.com/mastra-ai/mastra/commit/e1bb9c94b4eb68b019ae275981be3feb769b5365), [`351a11f`](https://github.com/mastra-ai/mastra/commit/351a11fcaf2ed1008977fa9b9a489fc422e51cd4)]:
450
+ - @mastra/core@1.0.0-beta.3
451
+
3
452
  ## 1.0.0-beta.1
4
453
 
5
454
  ### Patch Changes
@@ -0,0 +1,31 @@
1
+ # @mastra/mssql 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
+ ├── storage/ (1 files)
26
+ ```
27
+
28
+ ## Version
29
+
30
+ Package: @mastra/mssql
31
+ Version: 1.0.0-beta.11
@@ -0,0 +1,32 @@
1
+ ---
2
+ name: mastra-mssql-docs
3
+ description: Documentation for @mastra/mssql. Includes links to type definitions and readable implementation code in dist/.
4
+ ---
5
+
6
+ # @mastra/mssql Documentation
7
+
8
+ > **Version**: 1.0.0-beta.11
9
+ > **Package**: @mastra/mssql
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
+ - [Storage](storage/) - 1 file(s)
@@ -0,0 +1,6 @@
1
+ {
2
+ "version": "1.0.0-beta.11",
3
+ "package": "@mastra/mssql",
4
+ "exports": {},
5
+ "modules": {}
6
+ }