@mastra/mcp-docs-server 1.0.0-beta.17 → 1.0.0-beta.19

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.
@@ -1,5 +1,13 @@
1
1
  # @mastra/agent-builder
2
2
 
3
+ ## 1.0.0-beta.10
4
+
5
+ ### Patch Changes
6
+
7
+ - Updated dependencies [[`e54953e`](https://github.com/mastra-ai/mastra/commit/e54953ed8ce1b28c0d62a19950163039af7834b4), [`7d56d92`](https://github.com/mastra-ai/mastra/commit/7d56d9213886e8353956d7d40df10045fd12b299), [`fdac646`](https://github.com/mastra-ai/mastra/commit/fdac646033a0930a1a4e00d13aa64c40bb7f1e02), [`d07b568`](https://github.com/mastra-ai/mastra/commit/d07b5687819ea8cb1dffa776d0c1765faf4aa1ae), [`68ec97d`](https://github.com/mastra-ai/mastra/commit/68ec97d4c07c6393fcf95c2481fc5d73da99f8c8), [`4aa55b3`](https://github.com/mastra-ai/mastra/commit/4aa55b383cf06043943359ea316572fd969861a7)]:
8
+ - @mastra/core@1.0.0-beta.19
9
+ - @mastra/memory@1.0.0-beta.10
10
+
3
11
  ## 1.0.0-beta.9
4
12
 
5
13
  ### Patch Changes
@@ -490,13 +498,5 @@
490
498
  - Updated dependencies [5397eb4]
491
499
  - Updated dependencies [376913a]
492
500
  - Updated dependencies [c9f4e4a]
493
- - Updated dependencies [0acbc80]
494
- - Updated dependencies [38020d5]
495
- - @mastra/core@0.16.0
496
- - @mastra/memory@0.14.4
497
-
498
- ## 0.0.2-alpha.1
499
-
500
- ### Patch Changes
501
501
 
502
- ... 140 more lines hidden. See full changelog in package directory.
502
+ ... 148 more lines hidden. See full changelog in package directory.
@@ -1,5 +1,21 @@
1
1
  # @mastra/ai-sdk
2
2
 
3
+ ## 1.0.0-beta.12
4
+
5
+ ### Patch Changes
6
+
7
+ - Fix data chunk property filtering to only include type, data, and id properties ([#11477](https://github.com/mastra-ai/mastra/pull/11477))
8
+
9
+ Previously, when `isDataChunkType` checks were performed, the entire chunk object was returned, potentially letting extra properties like `from`, `runId`, `metadata`, etc go through. This could cause issues with `useChat` and other UI components.
10
+
11
+ Now, all locations that handle `DataChunkType` properly destructure and return only the allowed properties:
12
+ - `type` (required): The chunk type identifier starting with "data-"
13
+ - `data` (required): The actual data payload
14
+ - `id` (optional): An optional identifier for the chunk
15
+
16
+ - Updated dependencies [[`e54953e`](https://github.com/mastra-ai/mastra/commit/e54953ed8ce1b28c0d62a19950163039af7834b4), [`7d56d92`](https://github.com/mastra-ai/mastra/commit/7d56d9213886e8353956d7d40df10045fd12b299), [`fdac646`](https://github.com/mastra-ai/mastra/commit/fdac646033a0930a1a4e00d13aa64c40bb7f1e02), [`d07b568`](https://github.com/mastra-ai/mastra/commit/d07b5687819ea8cb1dffa776d0c1765faf4aa1ae), [`68ec97d`](https://github.com/mastra-ai/mastra/commit/68ec97d4c07c6393fcf95c2481fc5d73da99f8c8), [`4aa55b3`](https://github.com/mastra-ai/mastra/commit/4aa55b383cf06043943359ea316572fd969861a7)]:
17
+ - @mastra/core@1.0.0-beta.19
18
+
3
19
  ## 1.0.0-beta.11
4
20
 
5
21
  ### Patch Changes
@@ -483,20 +499,4 @@
483
499
 
484
500
  ### Patch Changes
485
501
 
486
- - Update README to include more usage examples ([#8817](https://github.com/mastra-ai/mastra/pull/8817))
487
-
488
- - Updated dependencies [[`ca85c93`](https://github.com/mastra-ai/mastra/commit/ca85c932b232e6ad820c811ec176d98e68c59b0a), [`a1d40f8`](https://github.com/mastra-ai/mastra/commit/a1d40f88d4ce42c4508774ad22e38ac582157af2), [`01c4a25`](https://github.com/mastra-ai/mastra/commit/01c4a2506c514d5e861c004d3d2fb3791c6391f3), [`cce8aad`](https://github.com/mastra-ai/mastra/commit/cce8aad878a0dd98e5647680f3765caba0b1701c)]:
489
- - @mastra/core@0.21.1-alpha.0
490
-
491
- ## 0.2.0
492
-
493
- ### Minor Changes
494
-
495
- - Update peer dependencies to match core package version bump (0.20.3) ([#8672](https://github.com/mastra-ai/mastra/pull/8672))
496
-
497
- - Update peer dependencies to match core package version bump (0.20.3) ([#8614](https://github.com/mastra-ai/mastra/pull/8614))
498
-
499
- ### Patch Changes
500
-
501
-
502
- ... 278 more lines hidden. See full changelog in package directory.
502
+ ... 294 more lines hidden. See full changelog in package directory.
@@ -1,5 +1,20 @@
1
1
  # @mastra/client-js
2
2
 
3
+ ## 1.0.0-beta.19
4
+
5
+ ### Patch Changes
6
+
7
+ - Updated dependencies [[`e54953e`](https://github.com/mastra-ai/mastra/commit/e54953ed8ce1b28c0d62a19950163039af7834b4), [`7d56d92`](https://github.com/mastra-ai/mastra/commit/7d56d9213886e8353956d7d40df10045fd12b299), [`fdac646`](https://github.com/mastra-ai/mastra/commit/fdac646033a0930a1a4e00d13aa64c40bb7f1e02), [`d07b568`](https://github.com/mastra-ai/mastra/commit/d07b5687819ea8cb1dffa776d0c1765faf4aa1ae), [`70b300e`](https://github.com/mastra-ai/mastra/commit/70b300ebc631dfc0aa14e61547fef7994adb4ea6), [`68ec97d`](https://github.com/mastra-ai/mastra/commit/68ec97d4c07c6393fcf95c2481fc5d73da99f8c8), [`4aa55b3`](https://github.com/mastra-ai/mastra/commit/4aa55b383cf06043943359ea316572fd969861a7)]:
8
+ - @mastra/core@1.0.0-beta.19
9
+ - @mastra/schema-compat@1.0.0-beta.5
10
+
11
+ ## 1.0.0-beta.18
12
+
13
+ ### Patch Changes
14
+
15
+ - Updated dependencies [[`5947fcd`](https://github.com/mastra-ai/mastra/commit/5947fcdd425531f29f9422026d466c2ee3113c93)]:
16
+ - @mastra/core@1.0.0-beta.18
17
+
3
18
  ## 1.0.0-beta.17
4
19
 
5
20
  ### Patch Changes
@@ -484,19 +499,4 @@
484
499
 
485
500
  ### Major Changes
486
501
 
487
- - Moving scorers under the eval domain, api method consistency, prebuilt evals, scorers require ids. ([#9589](https://github.com/mastra-ai/mastra/pull/9589))
488
-
489
- - Update handlers to use `listWorkflowRuns` instead of `getWorkflowRuns`. Fix type names from `StoragelistThreadsByResourceIdInput/Output` to `StorageListThreadsByResourceIdInput/Output`. ([#9507](https://github.com/mastra-ai/mastra/pull/9507))
490
-
491
- - **BREAKING:** Remove `getMessagesPaginated()` and add `perPage: false` support ([#9670](https://github.com/mastra-ai/mastra/pull/9670))
492
-
493
- Removes deprecated `getMessagesPaginated()` method. The `listMessages()` API and score handlers now support `perPage: false` to fetch all records without pagination limits.
494
-
495
- **Storage changes:**
496
- - `StoragePagination.perPage` type changed from `number` to `number | false`
497
- - All storage implementations support `perPage: false`:
498
- - Memory: `listMessages()`
499
- - Scores: `listScoresBySpan()`, `listScoresByRunId()`, `listScoresByExecutionId()`
500
- - HTTP query parser accepts `"false"` string (e.g., `?perPage=false`)
501
-
502
- ... 3564 more lines hidden. See full changelog in package directory.
502
+ ... 3579 more lines hidden. See full changelog in package directory.
@@ -1,5 +1,88 @@
1
1
  # @mastra/core
2
2
 
3
+ ## 1.0.0-beta.19
4
+
5
+ ### Minor Changes
6
+
7
+ - Add embedderOptions support to Memory for AI SDK 5+ provider-specific embedding options ([#11462](https://github.com/mastra-ai/mastra/pull/11462))
8
+
9
+ With AI SDK 5+, embedding models no longer accept options in their constructor. Options like `outputDimensionality` for Google embedding models must now be passed when calling `embed()` or `embedMany()`. This change adds `embedderOptions` to Memory configuration to enable passing these provider-specific options.
10
+
11
+ You can now configure embedder options when creating Memory:
12
+
13
+ ```typescript
14
+ import { Memory } from '@mastra/core';
15
+ import { google } from '@ai-sdk/google';
16
+
17
+ // Before: No way to specify providerOptions
18
+ const memory = new Memory({
19
+ embedder: google.textEmbeddingModel('text-embedding-004'),
20
+ });
21
+
22
+ // After: Pass embedderOptions with providerOptions
23
+ const memory = new Memory({
24
+ embedder: google.textEmbeddingModel('text-embedding-004'),
25
+ embedderOptions: {
26
+ providerOptions: {
27
+ google: {
28
+ outputDimensionality: 768,
29
+ taskType: 'RETRIEVAL_DOCUMENT',
30
+ },
31
+ },
32
+ },
33
+ });
34
+ ```
35
+
36
+ This is especially important for:
37
+ - Google `text-embedding-004`: Control output dimensions (default 768)
38
+ - Google `gemini-embedding-001`: Reduce from default 3072 dimensions to avoid pgvector's 2000 dimension limit for HNSW indexes
39
+
40
+ Fixes #8248
41
+
42
+ ### Patch Changes
43
+
44
+ - Fix Anthropic API error when tool calls have empty input objects ([#11474](https://github.com/mastra-ai/mastra/pull/11474))
45
+
46
+ Fixes issue #11376 where Anthropic models would fail with error "messages.17.content.2.tool_use.input: Field required" when a tool call in a previous step had an empty object `{}` as input.
47
+
48
+ The fix adds proper reconstruction of tool call arguments when converting messages to AIV5 model format. Tool-result parts now correctly include the `input` field from the matching tool call, which is required by Anthropic's API validation.
49
+
50
+ Changes:
51
+ - Added `findToolCallArgs()` helper method to search through messages and retrieve original tool call arguments
52
+ - Enhanced `aiV5UIMessagesToAIV5ModelMessages()` to populate the `input` field on tool-result parts
53
+ - Added comprehensive test coverage for empty object inputs, parameterized inputs, and multi-turn conversations
54
+
55
+ - Fixed an issue where deprecated Groq models were shown during template creation. The model selection now filters out models marked as deprecated, displaying only active and supported models. ([#11445](https://github.com/mastra-ai/mastra/pull/11445))
56
+
57
+ - Fix AI SDK v6 (specificationVersion: "v3") model support in sub-agent calls. Previously, when a parent agent invoked a sub-agent with a v3 model through the `agents` property, the version check only matched "v2", causing v3 models to incorrectly fall back to legacy streaming methods and throw "V2 models are not supported for streamLegacy" error. ([#11452](https://github.com/mastra-ai/mastra/pull/11452))
58
+
59
+ The fix updates version checks in `listAgentTools` and `llm-mapping-step.ts` to use the centralized `supportedLanguageModelSpecifications` array which includes both v2 and v3.
60
+
61
+ Also adds missing v3 test coverage to tool-handling.test.ts to prevent regression.
62
+
63
+ - Fixed "Transforms cannot be represented in JSON Schema" error when using Zod v4 with structuredOutput ([#11466](https://github.com/mastra-ai/mastra/pull/11466))
64
+
65
+ When using schemas with `.optional()`, `.nullable()`, `.default()`, or `.nullish().default("")` patterns with `structuredOutput` and Zod v4, users would encounter an error because OpenAI schema compatibility layer adds transforms that Zod v4's native `toJSONSchema()` cannot handle.
66
+
67
+ The fix uses Mastra's transform-safe `zodToJsonSchema` function which gracefully handles transforms by using the `unrepresentable: 'any'` option.
68
+
69
+ Also exported `isZodType` utility from `@mastra/schema-compat` and updated it to detect both Zod v3 (`_def`) and Zod v4 (`_zod`) schemas.
70
+
71
+ - Improved test description in ModelsDevGateway to clearly reflect the behavior being tested ([#11460](https://github.com/mastra-ai/mastra/pull/11460))
72
+
73
+ - Updated dependencies [[`d07b568`](https://github.com/mastra-ai/mastra/commit/d07b5687819ea8cb1dffa776d0c1765faf4aa1ae), [`70b300e`](https://github.com/mastra-ai/mastra/commit/70b300ebc631dfc0aa14e61547fef7994adb4ea6)]:
74
+ - @mastra/schema-compat@1.0.0-beta.5
75
+
76
+ ## 1.0.0-beta.18
77
+
78
+ ### Patch Changes
79
+
80
+ - Fixed semantic recall fetching all thread messages instead of only matched ones. ([#11435](https://github.com/mastra-ai/mastra/pull/11435))
81
+
82
+ When using `semanticRecall` with `scope: 'thread'`, the processor was incorrectly fetching all messages from the thread instead of just the semantically matched messages with their context. This caused memory to return far more messages than expected when `topK` and `messageRange` were set to small values.
83
+
84
+ Fixes #11428
85
+
3
86
  ## 1.0.0-beta.17
4
87
 
5
88
  ### Patch Changes
@@ -415,88 +498,5 @@
415
498
  description: 'Process payment',
416
499
  inputSchema: z.object({ amount: z.number() }),
417
500
  needsApproval: async ({ amount }) => amount > 1000,
418
- execute: async ({ amount }) => {
419
- return { success: true, amount };
420
- },
421
- });
422
- ```
423
-
424
- **Mastra tools continue to work with `requireApproval`:**
425
-
426
- ```typescript
427
- import { createTool } from '@mastra/core';
428
-
429
- const deleteTool = createTool({
430
- id: 'delete-file',
431
- description: 'Delete a file',
432
- requireApproval: true,
433
- inputSchema: z.object({ path: z.string() }),
434
- execute: async ({ path }) => {
435
- return { deleted: true };
436
- },
437
- });
438
- ```
439
-
440
- - Fix stopWhen type to accept AI SDK v6 StopCondition functions like `stepCountIs()` ([#11402](https://github.com/mastra-ai/mastra/pull/11402))
441
-
442
- - Fix missing `title` field in Convex threads table schema ([#11356](https://github.com/mastra-ai/mastra/pull/11356))
443
-
444
- The Convex schema was hardcoded and out of sync with the core `TABLE_SCHEMAS`, causing errors when creating threads:
445
-
446
- ```
447
- Error: Failed to insert or update a document in table "mastra_threads"
448
- because it does not match the schema: Object contains extra field `title`
449
- that is not in the validator.
450
- ```
451
-
452
- Now the Convex schema dynamically builds from `TABLE_SCHEMAS` via a new `@mastra/core/storage/constants` export path that doesn't pull in Node.js dependencies (safe for Convex's sandboxed schema evaluation).
453
-
454
- ```typescript
455
- // Users can now import schema tables without Node.js dependency issues
456
- import { mastraThreadsTable, mastraMessagesTable } from '@mastra/convex/schema';
457
-
458
- export default defineSchema({
459
- mastra_threads: mastraThreadsTable,
460
- mastra_messages: mastraMessagesTable,
461
- });
462
- ```
463
-
464
- Fixes #11319
465
-
466
- - Added support for AI SDK v6 embedding models (specification version v3) in memory and vector modules. Fixed TypeScript error where `ModelRouterEmbeddingModel` was trying to implement a union type instead of `EmbeddingModelV2` directly. ([#11362](https://github.com/mastra-ai/mastra/pull/11362))
467
-
468
- - fix: support gs:// and s3:// cloud storage URLs in attachmentsToParts ([#11398](https://github.com/mastra-ai/mastra/pull/11398))
469
-
470
- - Add validation to detect when a function is passed as a tool instead of a tool object. Previously, passing a tool factory function (e.g., `tools: { myTool }` instead of `tools: { myTool: myTool() }`) would silently fail - the LLM would request tool calls but nothing would execute. Now throws a clear error with guidance on how to fix it. ([#11288](https://github.com/mastra-ai/mastra/pull/11288))
471
-
472
- - Fix reasoning providerMetadata leaking into text parts when using memory with OpenAI reasoning models. The runState.providerOptions is now cleared after reasoning-end to prevent text parts from inheriting the reasoning's itemId. ([#11380](https://github.com/mastra-ai/mastra/pull/11380))
473
-
474
- - Upgrade AI SDK v6 from beta to stable (6.0.1) and fix finishReason breaking change. ([#11351](https://github.com/mastra-ai/mastra/pull/11351))
475
-
476
- AI SDK v6 stable changed finishReason from a string to an object with `unified` and `raw` properties. Added `normalizeFinishReason()` helper to handle both v5 (string) and v6 (object) formats at the stream transform layer
477
-
478
- - Improve autoResumeSuspendedTools instruction for tool approval ([#11338](https://github.com/mastra-ai/mastra/pull/11338))
479
-
480
- - Add debugger-like click-through UI to workflow graph ([#11350](https://github.com/mastra-ai/mastra/pull/11350))
481
-
482
- - Add `perStep` option to workflow run methods, allowing a workflow to run just a step instead of all the workflow steps ([#11276](https://github.com/mastra-ai/mastra/pull/11276))
483
-
484
- - Fix workflow throwing error when using .map after .foreach ([#11352](https://github.com/mastra-ai/mastra/pull/11352))
485
-
486
- - Bump @ai-sdk/openai from 3.0.0-beta.102 to 3.0.1 ([#11377](https://github.com/mastra-ai/mastra/pull/11377))
487
-
488
- ## 1.0.0-beta.14
489
-
490
- ### Minor Changes
491
-
492
- - Add support for AI SDK v6 (LanguageModelV3) ([#11191](https://github.com/mastra-ai/mastra/pull/11191))
493
-
494
- Agents can now use `LanguageModelV3` models from AI SDK v6 beta providers like `@ai-sdk/openai@^3.0.0-beta`.
495
-
496
- **New features:**
497
- - Usage normalization: V3's nested usage format is normalized to Mastra's flat format with `reasoningTokens`, `cachedInputTokens`, and raw data preserved in a `raw` field
498
-
499
- **Backward compatible:** All existing V1 and V2 models continue to work unchanged.
500
-
501
501
 
502
- ... 6974 more lines hidden. See full changelog in package directory.
502
+ ... 7057 more lines hidden. See full changelog in package directory.
@@ -1,5 +1,21 @@
1
1
  # @mastra/deployer-cloud
2
2
 
3
+ ## 1.0.0-beta.19
4
+
5
+ ### Patch Changes
6
+
7
+ - Updated dependencies [[`e54953e`](https://github.com/mastra-ai/mastra/commit/e54953ed8ce1b28c0d62a19950163039af7834b4), [`d7b7b76`](https://github.com/mastra-ai/mastra/commit/d7b7b769c1a63b7a750bb0bf6fa1ebb6680eff15), [`7d56d92`](https://github.com/mastra-ai/mastra/commit/7d56d9213886e8353956d7d40df10045fd12b299), [`fdac646`](https://github.com/mastra-ai/mastra/commit/fdac646033a0930a1a4e00d13aa64c40bb7f1e02), [`d07b568`](https://github.com/mastra-ai/mastra/commit/d07b5687819ea8cb1dffa776d0c1765faf4aa1ae), [`7cb14cf`](https://github.com/mastra-ai/mastra/commit/7cb14cfe0bc52095ed7f1b447996ba8c5d002e0d), [`68ec97d`](https://github.com/mastra-ai/mastra/commit/68ec97d4c07c6393fcf95c2481fc5d73da99f8c8), [`4aa55b3`](https://github.com/mastra-ai/mastra/commit/4aa55b383cf06043943359ea316572fd969861a7)]:
8
+ - @mastra/core@1.0.0-beta.19
9
+ - @mastra/deployer@1.0.0-beta.19
10
+
11
+ ## 1.0.0-beta.18
12
+
13
+ ### Patch Changes
14
+
15
+ - Updated dependencies [[`5947fcd`](https://github.com/mastra-ai/mastra/commit/5947fcdd425531f29f9422026d466c2ee3113c93)]:
16
+ - @mastra/core@1.0.0-beta.18
17
+ - @mastra/deployer@1.0.0-beta.18
18
+
3
19
  ## 1.0.0-beta.17
4
20
 
5
21
  ### Patch Changes
@@ -483,20 +499,4 @@
483
499
  - @mastra/deployer@0.19.1-alpha.0
484
500
  - @mastra/core@0.19.1-alpha.0
485
501
 
486
- ## 0.19.0
487
-
488
- ### Patch Changes
489
-
490
- - Update peer deps ([#8154](https://github.com/mastra-ai/mastra/pull/8154))
491
-
492
- - Fix peer deps ([#8134](https://github.com/mastra-ai/mastra/pull/8134))
493
-
494
- - Update peer deps ([#8276](https://github.com/mastra-ai/mastra/pull/8276))
495
-
496
- - Updated dependencies [[`5089c84`](https://github.com/mastra-ai/mastra/commit/5089c84a2f535ad12e79b5aa524ad7d8ca5e2b4c), [`5c98f03`](https://github.com/mastra-ai/mastra/commit/5c98f03ae76d9a93cd6be206b4abb7bf186b3163), [`dc099b4`](https://github.com/mastra-ai/mastra/commit/dc099b40fb31147ba3f362f98d991892033c4c67), [`57b75b0`](https://github.com/mastra-ai/mastra/commit/57b75b01c0c64d91c50d7384c700afda89456fe8), [`4c5e65d`](https://github.com/mastra-ai/mastra/commit/4c5e65de746fbdab23eb6072cb999f4c7aeef9f3), [`504438b`](https://github.com/mastra-ai/mastra/commit/504438b961bde211071186bba63a842c4e3db879), [`57b6dd5`](https://github.com/mastra-ai/mastra/commit/57b6dd50f9e6d92c0ed3e7199e6a92752025e3a1), [`b342a68`](https://github.com/mastra-ai/mastra/commit/b342a68e1399cf1ece9ba11bda112db89d21118c), [`a7243e2`](https://github.com/mastra-ai/mastra/commit/a7243e2e58762667a6e3921e755e89d6bb0a3282), [`504438b`](https://github.com/mastra-ai/mastra/commit/504438b961bde211071186bba63a842c4e3db879), [`7fceb0a`](https://github.com/mastra-ai/mastra/commit/7fceb0a327d678e812f90f5387c5bc4f38bd039e), [`303a9c0`](https://github.com/mastra-ai/mastra/commit/303a9c0d7dd58795915979f06a0512359e4532fb), [`df64f9e`](https://github.com/mastra-ai/mastra/commit/df64f9ef814916fff9baedd861c988084e7c41de), [`370f8a6`](https://github.com/mastra-ai/mastra/commit/370f8a6480faec70fef18d72e5f7538f27004301), [`809eea0`](https://github.com/mastra-ai/mastra/commit/809eea092fa80c3f69b9eaf078d843b57fd2a88e), [`683e5a1`](https://github.com/mastra-ai/mastra/commit/683e5a1466e48b686825b2c11f84680f296138e4), [`3679378`](https://github.com/mastra-ai/mastra/commit/3679378673350aa314741dc826f837b1984149bc), [`7775bc2`](https://github.com/mastra-ai/mastra/commit/7775bc20bb1ad1ab24797fb420e4f96c65b0d8ec), [`623ffaf`](https://github.com/mastra-ai/mastra/commit/623ffaf2d969e11e99a0224633cf7b5a0815c857), [`9fc1613`](https://github.com/mastra-ai/mastra/commit/9fc16136400186648880fd990119ac15f7c02ee4), [`61f62aa`](https://github.com/mastra-ai/mastra/commit/61f62aa31bc88fe4ddf8da6240dbcfbeb07358bd), [`db1891a`](https://github.com/mastra-ai/mastra/commit/db1891a4707443720b7cd8a260dc7e1d49b3609c), [`e8f379d`](https://github.com/mastra-ai/mastra/commit/e8f379d390efa264c4e0874f9ac0cf8839b07777), [`652066b`](https://github.com/mastra-ai/mastra/commit/652066bd1efc6bb6813ba950ed1d7573e8b7d9d4), [`3e292ba`](https://github.com/mastra-ai/mastra/commit/3e292ba00837886d5d68a34cbc0d9b703c991883), [`418c136`](https://github.com/mastra-ai/mastra/commit/418c1366843d88e491bca3f87763899ce855ca29), [`ea8d386`](https://github.com/mastra-ai/mastra/commit/ea8d386cd8c5593664515fd5770c06bf2aa980ef), [`67b0f00`](https://github.com/mastra-ai/mastra/commit/67b0f005b520335c71fb85cbaa25df4ce8484a81), [`c2a4919`](https://github.com/mastra-ai/mastra/commit/c2a4919ba6797d8bdb1509e02287496eef69303e), [`c84b7d0`](https://github.com/mastra-ai/mastra/commit/c84b7d093c4657772140cbfd2b15ef72f3315ed5), [`6f67656`](https://github.com/mastra-ai/mastra/commit/6f676562276926e2982401574d1e07157579be30), [`0130986`](https://github.com/mastra-ai/mastra/commit/0130986fc62d0edcc626dd593282661dbb9af141), [`5dc8e9a`](https://github.com/mastra-ai/mastra/commit/5dc8e9a7f8472298cd3d4e8a0cf6d265529f287d)]:
497
- - @mastra/deployer@0.19.0
498
- - @mastra/core@0.19.0
499
- - @mastra/loggers@0.10.14
500
-
501
-
502
- ... 559 more lines hidden. See full changelog in package directory.
502
+ ... 575 more lines hidden. See full changelog in package directory.
@@ -1,5 +1,27 @@
1
1
  # @mastra/deployer
2
2
 
3
+ ## 1.0.0-beta.19
4
+
5
+ ### Patch Changes
6
+
7
+ - Fix npm resolving wrong @mastra/server version ([#11467](https://github.com/mastra-ai/mastra/pull/11467))
8
+
9
+ Changed `@mastra/server` dependency from `workspace:^` to `workspace:*` to prevent npm from resolving to incompatible stable versions (e.g., 1.0.3) instead of the required beta versions.
10
+
11
+ - Remove extra console log statements in node-modules-extension-resolver ([#11470](https://github.com/mastra-ai/mastra/pull/11470))
12
+
13
+ - Updated dependencies [[`e54953e`](https://github.com/mastra-ai/mastra/commit/e54953ed8ce1b28c0d62a19950163039af7834b4), [`7d56d92`](https://github.com/mastra-ai/mastra/commit/7d56d9213886e8353956d7d40df10045fd12b299), [`fdac646`](https://github.com/mastra-ai/mastra/commit/fdac646033a0930a1a4e00d13aa64c40bb7f1e02), [`d07b568`](https://github.com/mastra-ai/mastra/commit/d07b5687819ea8cb1dffa776d0c1765faf4aa1ae), [`68ec97d`](https://github.com/mastra-ai/mastra/commit/68ec97d4c07c6393fcf95c2481fc5d73da99f8c8), [`4aa55b3`](https://github.com/mastra-ai/mastra/commit/4aa55b383cf06043943359ea316572fd969861a7)]:
14
+ - @mastra/core@1.0.0-beta.19
15
+ - @mastra/server@1.0.0-beta.19
16
+
17
+ ## 1.0.0-beta.18
18
+
19
+ ### Patch Changes
20
+
21
+ - Updated dependencies [[`5947fcd`](https://github.com/mastra-ai/mastra/commit/5947fcdd425531f29f9422026d466c2ee3113c93)]:
22
+ - @mastra/core@1.0.0-beta.18
23
+ - @mastra/server@1.0.0-beta.18
24
+
3
25
  ## 1.0.0-beta.17
4
26
 
5
27
  ### Patch Changes
@@ -476,27 +498,5 @@
476
498
  ```typescript
477
499
  // Before
478
500
  await memory.listThreadsByResourceId({
479
- resourceId: 'user-123',
480
- offset: 20,
481
- limit: 10,
482
- });
483
-
484
- // After
485
- await memory.listThreadsByResourceId({
486
- resourceId: 'user-123',
487
- page: 2, // page = Math.floor(offset / limit)
488
- perPage: 10,
489
- });
490
-
491
- // Before
492
- await memory.listMessages({
493
- threadId: 'thread-456',
494
- offset: 20,
495
- limit: 10,
496
- });
497
-
498
- // After
499
- await memory.listMessages({
500
- threadId: 'thread-456',
501
501
 
502
- ... 5262 more lines hidden. See full changelog in package directory.
502
+ ... 5284 more lines hidden. See full changelog in package directory.
@@ -1,5 +1,19 @@
1
1
  # @mastra/mcp-docs-server
2
2
 
3
+ ## 1.0.0-beta.19
4
+
5
+ ### Patch Changes
6
+
7
+ - Updated dependencies [[`e54953e`](https://github.com/mastra-ai/mastra/commit/e54953ed8ce1b28c0d62a19950163039af7834b4), [`7d56d92`](https://github.com/mastra-ai/mastra/commit/7d56d9213886e8353956d7d40df10045fd12b299), [`fdac646`](https://github.com/mastra-ai/mastra/commit/fdac646033a0930a1a4e00d13aa64c40bb7f1e02), [`d07b568`](https://github.com/mastra-ai/mastra/commit/d07b5687819ea8cb1dffa776d0c1765faf4aa1ae), [`68ec97d`](https://github.com/mastra-ai/mastra/commit/68ec97d4c07c6393fcf95c2481fc5d73da99f8c8), [`4aa55b3`](https://github.com/mastra-ai/mastra/commit/4aa55b383cf06043943359ea316572fd969861a7)]:
8
+ - @mastra/core@1.0.0-beta.19
9
+
10
+ ## 1.0.0-beta.18
11
+
12
+ ### Patch Changes
13
+
14
+ - Updated dependencies [[`5947fcd`](https://github.com/mastra-ai/mastra/commit/5947fcdd425531f29f9422026d466c2ee3113c93)]:
15
+ - @mastra/core@1.0.0-beta.18
16
+
3
17
  ## 1.0.0-beta.17
4
18
 
5
19
  ### Patch Changes
@@ -484,19 +498,5 @@
484
498
 
485
499
  ## 0.13.24-alpha.0
486
500
 
487
- ### Patch Changes
488
-
489
- - Updated dependencies [[`a61f23f`](https://github.com/mastra-ai/mastra/commit/a61f23fbbca4b88b763d94f1d784c47895ed72d7), [`d1dc606`](https://github.com/mastra-ai/mastra/commit/d1dc6067b0557a71190b68d56ee15b48c26d2411), [`d3bd4d4`](https://github.com/mastra-ai/mastra/commit/d3bd4d482a685bbb67bfa89be91c90dca3fa71ad)]:
490
- - @mastra/core@0.17.2-alpha.0
491
-
492
- ## 0.13.23
493
-
494
- ### Patch Changes
495
-
496
- - Updated dependencies [[`fd00e63`](https://github.com/mastra-ai/mastra/commit/fd00e63759cbcca3473c40cac9843280b0557cff), [`ab610f6`](https://github.com/mastra-ai/mastra/commit/ab610f6f41dbfe6c9502368671485ca7a0aac09b), [`e6bda5f`](https://github.com/mastra-ai/mastra/commit/e6bda5f954ee8493ea18adc1a883f0a5b785ad9b)]:
497
- - @mastra/core@0.17.1
498
-
499
- ## 0.13.23-alpha.0
500
-
501
501
 
502
- ... 2112 more lines hidden. See full changelog in package directory.
502
+ ... 2126 more lines hidden. See full changelog in package directory.
@@ -1,5 +1,13 @@
1
1
  # @mastra/memory
2
2
 
3
+ ## 1.0.0-beta.10
4
+
5
+ ### Patch Changes
6
+
7
+ - Updated dependencies [[`e54953e`](https://github.com/mastra-ai/mastra/commit/e54953ed8ce1b28c0d62a19950163039af7834b4), [`7d56d92`](https://github.com/mastra-ai/mastra/commit/7d56d9213886e8353956d7d40df10045fd12b299), [`fdac646`](https://github.com/mastra-ai/mastra/commit/fdac646033a0930a1a4e00d13aa64c40bb7f1e02), [`d07b568`](https://github.com/mastra-ai/mastra/commit/d07b5687819ea8cb1dffa776d0c1765faf4aa1ae), [`70b300e`](https://github.com/mastra-ai/mastra/commit/70b300ebc631dfc0aa14e61547fef7994adb4ea6), [`68ec97d`](https://github.com/mastra-ai/mastra/commit/68ec97d4c07c6393fcf95c2481fc5d73da99f8c8), [`4aa55b3`](https://github.com/mastra-ai/mastra/commit/4aa55b383cf06043943359ea316572fd969861a7)]:
8
+ - @mastra/core@1.0.0-beta.19
9
+ - @mastra/schema-compat@1.0.0-beta.5
10
+
3
11
  ## 1.0.0-beta.9
4
12
 
5
13
  ### Patch Changes
@@ -490,13 +498,5 @@
490
498
  - Enforcing id required on Processor primitive ([#9591](https://github.com/mastra-ai/mastra/pull/9591))
491
499
 
492
500
  - Renamed `MastraMessageV2` to `MastraDBMessage` ([#9255](https://github.com/mastra-ai/mastra/pull/9255))
493
- Made the return format of all methods that return db messages consistent. It's always `{ messages: MastraDBMessage[] }` now, and messages can be converted after that using `@mastra/ai-sdk/ui`'s `toAISdkV4/5Messages()` function
494
-
495
- ### Minor Changes
496
-
497
- - Update peer dependencies to match core package version bump (0.22.3) ([#9486](https://github.com/mastra-ai/mastra/pull/9486))
498
-
499
- - **BREAKING CHANGE**: Memory scope defaults changed from 'thread' to 'resource' ([#8983](https://github.com/mastra-ai/mastra/pull/8983))
500
-
501
501
 
502
- ... 3604 more lines hidden. See full changelog in package directory.
502
+ ... 3612 more lines hidden. See full changelog in package directory.
@@ -1,5 +1,68 @@
1
1
  # @mastra/pg
2
2
 
3
+ ## 1.0.0-beta.11
4
+
5
+ ### Minor Changes
6
+
7
+ - Remove pg-promise dependency and use pg.Pool directly ([#11450](https://github.com/mastra-ai/mastra/pull/11450))
8
+
9
+ **BREAKING CHANGE**: This release replaces pg-promise with vanilla node-postgres (`pg`).
10
+
11
+ ### Breaking Changes
12
+ - **Removed `store.pgp`**: The pg-promise library instance is no longer exposed
13
+ - **Config change**: `{ client: pgPromiseDb }` is no longer supported. Use `{ pool: pgPool }` instead
14
+ - **Cloud SQL config**: `max` and `idleTimeoutMillis` must now be passed via `pgPoolOptions`
15
+
16
+ ### New Features
17
+ - **`store.pool`**: Exposes the underlying `pg.Pool` for direct database access or ORM integration (e.g., Drizzle)
18
+ - **`store.db`**: Provides a `DbClient` interface with methods like `one()`, `any()`, `tx()`, etc.
19
+ - **`store.db.connect()`**: Acquire a client for session-level operations
20
+
21
+ ### Migration
22
+
23
+ ```typescript
24
+ // Before (pg-promise)
25
+ import pgPromise from 'pg-promise';
26
+ const pgp = pgPromise();
27
+ const client = pgp(connectionString);
28
+ const store = new PostgresStore({ id: 'my-store', client });
29
+
30
+ // After (pg.Pool)
31
+ import { Pool } from 'pg';
32
+ const pool = new Pool({ connectionString });
33
+ const store = new PostgresStore({ id: 'my-store', pool });
34
+
35
+ // Use store.pool with any library that accepts a pg.Pool
36
+ ```
37
+
38
+ ### Patch Changes
39
+
40
+ - Added `exportSchemas()` function to generate Mastra database schema as SQL DDL without a database connection. ([#11448](https://github.com/mastra-ai/mastra/pull/11448))
41
+
42
+ **What's New**
43
+
44
+ You can now export your Mastra database schema as SQL DDL statements without connecting to a database. This is useful for:
45
+ - Generating migration scripts
46
+ - Reviewing the schema before deployment
47
+ - Creating database schemas in environments where the application doesn't have CREATE privileges
48
+
49
+ **Example**
50
+
51
+ ```typescript
52
+ import { exportSchemas } from '@mastra/pg';
53
+
54
+ // Export schema for default 'public' schema
55
+ const ddl = exportSchemas();
56
+ console.log(ddl);
57
+
58
+ // Export schema for a custom schema
59
+ const customDdl = exportSchemas('my_schema');
60
+ // Creates: CREATE SCHEMA IF NOT EXISTS "my_schema"; and all tables within it
61
+ ```
62
+
63
+ - Updated dependencies [[`e54953e`](https://github.com/mastra-ai/mastra/commit/e54953ed8ce1b28c0d62a19950163039af7834b4), [`7d56d92`](https://github.com/mastra-ai/mastra/commit/7d56d9213886e8353956d7d40df10045fd12b299), [`fdac646`](https://github.com/mastra-ai/mastra/commit/fdac646033a0930a1a4e00d13aa64c40bb7f1e02), [`d07b568`](https://github.com/mastra-ai/mastra/commit/d07b5687819ea8cb1dffa776d0c1765faf4aa1ae), [`68ec97d`](https://github.com/mastra-ai/mastra/commit/68ec97d4c07c6393fcf95c2481fc5d73da99f8c8), [`4aa55b3`](https://github.com/mastra-ai/mastra/commit/4aa55b383cf06043943359ea316572fd969861a7)]:
64
+ - @mastra/core@1.0.0-beta.19
65
+
3
66
  ## 1.0.0-beta.10
4
67
 
5
68
  ### Patch Changes
@@ -435,68 +498,5 @@
435
498
  await storage.init();
436
499
 
437
500
  // Runtime - skip auto-init
438
- const storage = new PostgresStore({
439
- connectionString: DATABASE_URL,
440
- id: 'pg-storage',
441
- disableInit: true,
442
- });
443
- ```
444
-
445
- ### Patch Changes
446
-
447
- - 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))
448
-
449
- - 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)]:
450
- - @mastra/core@1.0.0-beta.7
451
-
452
- ## 1.0.0-beta.3
453
-
454
- ### Patch Changes
455
-
456
- - fix(pg): qualify vector type to fix schema lookup ([#10786](https://github.com/mastra-ai/mastra/pull/10786))
457
-
458
- - feat(storage): support querying messages from multiple threads ([#10663](https://github.com/mastra-ai/mastra/pull/10663))
459
- - Fixed TypeScript errors where `threadId: string | string[]` was being passed to places expecting `Scalar` type
460
- - Added proper multi-thread support for `listMessages` across all adapters when `threadId` is an array
461
- - Updated `_getIncludedMessages` to look up message threadId by ID (since message IDs are globally unique)
462
- - **upstash**: Added `msg-idx:{messageId}` index for O(1) message lookups (backwards compatible with fallback to scan for old messages, with automatic backfill)
463
-
464
- - fix: ensure score responses match saved payloads for Mastra Stores. ([#10557](https://github.com/mastra-ai/mastra/pull/10557))
465
-
466
- - Unify transformScoreRow functions across storage adapters ([#10648](https://github.com/mastra-ai/mastra/pull/10648))
467
-
468
- 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:
469
- - `preferredTimestampFields`: Preferred source fields for timestamps (PostgreSQL, Cloudflare D1)
470
- - `convertTimestamps`: Convert timestamp strings to Date objects (MSSQL, MongoDB, ClickHouse)
471
- - `nullValuePattern`: Skip values matching pattern (ClickHouse's `'_null_'`)
472
- - `fieldMappings`: Map source column names to schema fields (LibSQL's `additionalLLMContext`)
473
-
474
- 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.
475
-
476
- - 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)]:
477
- - @mastra/core@1.0.0-beta.6
478
-
479
- ## 1.0.0-beta.2
480
-
481
- ### Patch Changes
482
-
483
- - Add new deleteVectors, updateVector by filter ([#10408](https://github.com/mastra-ai/mastra/pull/10408))
484
-
485
- - 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)]:
486
- - @mastra/core@1.0.0-beta.5
487
-
488
- ## 1.0.0-beta.1
489
-
490
- ### Patch Changes
491
-
492
- - Add restart method to workflow run that allows restarting an active workflow run ([#9750](https://github.com/mastra-ai/mastra/pull/9750))
493
- Add status filter to `listWorkflowRuns`
494
- Add automatic restart to restart active workflow runs when server starts
495
- - 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)]:
496
- - @mastra/core@1.0.0-beta.3
497
-
498
- ## 1.0.0-beta.0
499
-
500
- ### Major Changes
501
501
 
502
- ... 3105 more lines hidden. See full changelog in package directory.
502
+ ... 3168 more lines hidden. See full changelog in package directory.
@@ -1,5 +1,25 @@
1
1
  # @mastra/playground-ui
2
2
 
3
+ ## 7.0.0-beta.19
4
+
5
+ ### Patch Changes
6
+
7
+ - Updated dependencies [[`e54953e`](https://github.com/mastra-ai/mastra/commit/e54953ed8ce1b28c0d62a19950163039af7834b4), [`bd18eb0`](https://github.com/mastra-ai/mastra/commit/bd18eb0928b1c4f263426f45f49765b32d1ef802), [`7d56d92`](https://github.com/mastra-ai/mastra/commit/7d56d9213886e8353956d7d40df10045fd12b299), [`fdac646`](https://github.com/mastra-ai/mastra/commit/fdac646033a0930a1a4e00d13aa64c40bb7f1e02), [`d07b568`](https://github.com/mastra-ai/mastra/commit/d07b5687819ea8cb1dffa776d0c1765faf4aa1ae), [`70b300e`](https://github.com/mastra-ai/mastra/commit/70b300ebc631dfc0aa14e61547fef7994adb4ea6), [`68ec97d`](https://github.com/mastra-ai/mastra/commit/68ec97d4c07c6393fcf95c2481fc5d73da99f8c8), [`4aa55b3`](https://github.com/mastra-ai/mastra/commit/4aa55b383cf06043943359ea316572fd969861a7)]:
8
+ - @mastra/core@1.0.0-beta.19
9
+ - @mastra/ai-sdk@1.0.0-beta.12
10
+ - @mastra/schema-compat@1.0.0-beta.5
11
+ - @mastra/client-js@1.0.0-beta.19
12
+ - @mastra/react@0.1.0-beta.19
13
+
14
+ ## 7.0.0-beta.18
15
+
16
+ ### Patch Changes
17
+
18
+ - Updated dependencies [[`5947fcd`](https://github.com/mastra-ai/mastra/commit/5947fcdd425531f29f9422026d466c2ee3113c93)]:
19
+ - @mastra/core@1.0.0-beta.18
20
+ - @mastra/client-js@1.0.0-beta.18
21
+ - @mastra/react@0.1.0-beta.18
22
+
3
23
  ## 7.0.0-beta.17
4
24
 
5
25
  ### Patch Changes
@@ -478,25 +498,5 @@
478
498
 
479
499
  ### Patch Changes
480
500
 
481
- - Make MainSidebar toggle button sticky to bottom, always visible ([#9682](https://github.com/mastra-ai/mastra/pull/9682))
482
-
483
- - Removing uneeded files ([#9877](https://github.com/mastra-ai/mastra/pull/9877))
484
-
485
- - Explicitly set color of line number in CodeMirror ([#9878](https://github.com/mastra-ai/mastra/pull/9878))
486
-
487
- - Add visual styles and labels for more workflow node types ([#9777](https://github.com/mastra-ai/mastra/pull/9777))
488
-
489
- - Updated dependencies [[`910db9e`](https://github.com/mastra-ai/mastra/commit/910db9e0312888495eb5617b567f247d03303814), [`dbd9db0`](https://github.com/mastra-ai/mastra/commit/dbd9db0d5c2797a210b9098e7e3e613718e5442f), [`e7266a2`](https://github.com/mastra-ai/mastra/commit/e7266a278db02035c97a5e9cd9d1669a6b7a535d)]:
490
- - @mastra/core@1.0.0-beta.1
491
- - @mastra/client-js@1.0.0-beta.1
492
- - @mastra/react@0.1.0-beta.1
493
-
494
- ## 7.0.0-beta.0
495
-
496
- ### Major Changes
497
-
498
- - # Major Changes ([#9695](https://github.com/mastra-ai/mastra/pull/9695))
499
-
500
- ## Storage Layer
501
501
 
502
- ... 4428 more lines hidden. See full changelog in package directory.
502
+ ... 4448 more lines hidden. See full changelog in package directory.
@@ -1,5 +1,19 @@
1
1
  # @mastra/react-hooks
2
2
 
3
+ ## 0.1.0-beta.19
4
+
5
+ ### Patch Changes
6
+
7
+ - Updated dependencies:
8
+ - @mastra/client-js@1.0.0-beta.19
9
+
10
+ ## 0.1.0-beta.18
11
+
12
+ ### Patch Changes
13
+
14
+ - Updated dependencies:
15
+ - @mastra/client-js@1.0.0-beta.18
16
+
3
17
  ## 0.1.0-beta.17
4
18
 
5
19
  ### Patch Changes
@@ -484,19 +498,5 @@
484
498
 
485
499
  ### Patch Changes
486
500
 
487
- - Updated dependencies []:
488
- - @mastra/client-js@0.15.1-alpha.3
489
-
490
- ## 0.0.4-alpha.2
491
-
492
- ### Patch Changes
493
-
494
- - Updated dependencies []:
495
- - @mastra/client-js@0.15.1-alpha.2
496
-
497
- ## 0.0.4-alpha.1
498
-
499
- ### Patch Changes
500
-
501
501
 
502
- ... 86 more lines hidden. See full changelog in package directory.
502
+ ... 100 more lines hidden. See full changelog in package directory.
@@ -1,5 +1,25 @@
1
1
  # @mastra/schema-compat
2
2
 
3
+ ## 1.0.0-beta.5
4
+
5
+ ### Patch Changes
6
+
7
+ - Fixed "Transforms cannot be represented in JSON Schema" error when using Zod v4 with structuredOutput ([#11466](https://github.com/mastra-ai/mastra/pull/11466))
8
+
9
+ When using schemas with `.optional()`, `.nullable()`, `.default()`, or `.nullish().default("")` patterns with `structuredOutput` and Zod v4, users would encounter an error because OpenAI schema compatibility layer adds transforms that Zod v4's native `toJSONSchema()` cannot handle.
10
+
11
+ The fix uses Mastra's transform-safe `zodToJsonSchema` function which gracefully handles transforms by using the `unrepresentable: 'any'` option.
12
+
13
+ Also exported `isZodType` utility from `@mastra/schema-compat` and updated it to detect both Zod v3 (`_def`) and Zod v4 (`_zod`) schemas.
14
+
15
+ - fix(schema-compat): handle undefined values in optional fields for OpenAI compat layers ([#11469](https://github.com/mastra-ai/mastra/pull/11469))
16
+
17
+ When a Zod schema has nested objects with `.partial()`, the optional fields would fail validation with "expected string, received undefined" errors. This occurred because the OpenAI schema compat layer converted `.optional()` to `.nullable()`, which only accepts `null` values, not `undefined`.
18
+
19
+ Changed `.nullable()` to `.nullish()` so that optional fields now accept both `null` (when explicitly provided by the LLM) and `undefined` (when fields are omitted entirely).
20
+
21
+ Fixes #11457
22
+
3
23
  ## 1.0.0-beta.4
4
24
 
5
25
  ### Patch Changes
@@ -1,5 +1,19 @@
1
1
  # @mastra/server
2
2
 
3
+ ## 1.0.0-beta.19
4
+
5
+ ### Patch Changes
6
+
7
+ - Updated dependencies [[`e54953e`](https://github.com/mastra-ai/mastra/commit/e54953ed8ce1b28c0d62a19950163039af7834b4), [`7d56d92`](https://github.com/mastra-ai/mastra/commit/7d56d9213886e8353956d7d40df10045fd12b299), [`fdac646`](https://github.com/mastra-ai/mastra/commit/fdac646033a0930a1a4e00d13aa64c40bb7f1e02), [`d07b568`](https://github.com/mastra-ai/mastra/commit/d07b5687819ea8cb1dffa776d0c1765faf4aa1ae), [`68ec97d`](https://github.com/mastra-ai/mastra/commit/68ec97d4c07c6393fcf95c2481fc5d73da99f8c8), [`4aa55b3`](https://github.com/mastra-ai/mastra/commit/4aa55b383cf06043943359ea316572fd969861a7)]:
8
+ - @mastra/core@1.0.0-beta.19
9
+
10
+ ## 1.0.0-beta.18
11
+
12
+ ### Patch Changes
13
+
14
+ - Updated dependencies [[`5947fcd`](https://github.com/mastra-ai/mastra/commit/5947fcdd425531f29f9422026d466c2ee3113c93)]:
15
+ - @mastra/core@1.0.0-beta.18
16
+
3
17
  ## 1.0.0-beta.17
4
18
 
5
19
  ### Patch Changes
@@ -485,18 +499,4 @@
485
499
 
486
500
  ### Patch Changes
487
501
 
488
- - Unified MastraServer API with MCP transport routes ([#10644](https://github.com/mastra-ai/mastra/pull/10644))
489
-
490
- **Breaking Changes:**
491
- - Renamed `HonoServerAdapter` to `MastraServer` in `@mastra/hono`
492
- - Renamed `ExpressServerAdapter` to `MastraServer` in `@mastra/express`
493
- - Configuration now passed to constructor instead of separate method calls
494
- - Renamed base class from `ServerAdapter` to `MastraServerBase` in `@mastra/server`
495
-
496
- **New Features:**
497
- - Added MCP transport routes (HTTP and SSE) to server adapters
498
- - MCP endpoints available at `/api/mcp/:serverId/mcp` (HTTP) and `/api/mcp/:serverId/sse` (SSE)
499
- - Added `express.json()` middleware compatibility for MCP routes
500
- - Moved authentication helpers from deployer to `@mastra/server/auth`
501
-
502
- ... 4596 more lines hidden. See full changelog in package directory.
502
+ ... 4610 more lines hidden. See full changelog in package directory.
@@ -63,7 +63,7 @@ All pagination APIs now use `page` and `perPage` instead of `offset` and `limit`
63
63
  To migrate, update all pagination parameters from `offset/limit` to `page/perPage`. Note that `page` is 0-indexed.
64
64
 
65
65
  ```diff
66
- storage.listMessages({
66
+ memoryStore.listMessages({
67
67
  threadId: 'thread-123',
68
68
  - offset: 0,
69
69
  - limit: 20,
@@ -79,18 +79,20 @@ The `getMessagesPaginated()` method has been replaced with `listMessages()`. The
79
79
  To migrate, rename the method and update pagination parameters. You can now use `perPage: false` to fetch all records.
80
80
 
81
81
  ```diff
82
+ + const memoryStore = await storage.getStore('memory');
83
+ +
82
84
  // Paginated
83
85
  - const result = await storage.getMessagesPaginated({
84
- + const result = await storage.listMessages({
86
+ + const result = await memoryStore?.listMessages({
85
87
  threadId: 'thread-123',
86
88
  - offset: 0,
87
89
  - limit: 20,
88
90
  + page: 0,
89
91
  + perPage: 20,
90
92
  });
91
-
93
+
92
94
  // Fetch all records (no pagination limit)
93
- + const allMessages = await storage.listMessages({
95
+ + const allMessages = await memoryStore?.listMessages({
94
96
  + threadId: 'thread-123',
95
97
  + page: 0,
96
98
  + perPage: false,
@@ -152,11 +154,12 @@ To migrate, call `getStore()` with the domain name, then call methods on the ret
152
154
 
153
155
  The `getThreadsByResourceId()` method has been renamed to `listThreadsByResourceId()`. This change aligns with the convention that `list*` methods return collections.
154
156
 
155
- To migrate, rename the method call and update pagination parameters.
157
+ To migrate, use the memory store and rename the method call with pagination parameters.
156
158
 
157
159
  ```diff
158
160
  - const threads = await storage.getThreadsByResourceId({
159
- + const threads = await storage.listThreadsByResourceId({
161
+ + const memoryStore = await storage.getStore('memory');
162
+ + const threads = await memoryStore?.listThreadsByResourceId({
160
163
  resourceId: 'res-123',
161
164
  + page: 0,
162
165
  + perPage: 20,
@@ -177,11 +180,12 @@ npx @mastra/codemod@beta v1/storage-get-threads-by-resource .
177
180
 
178
181
  The `getWorkflowRuns()` method has been renamed to `listWorkflowRuns()`. This change aligns with the convention that `list*` methods return collections.
179
182
 
180
- To migrate, rename the method call and update pagination parameters.
183
+ To migrate, use the workflows stores, rename the method call and update pagination parameters.
181
184
 
182
185
  ```diff
183
186
  - const runs = await storage.getWorkflowRuns({
184
- + const runs = await storage.listWorkflowRuns({
187
+ + const workflowStore = await storage.getStore('workflows');
188
+ + const runs = await workflowStore?.listWorkflowRuns({
185
189
  fromDate,
186
190
  toDate,
187
191
  + page: 0,
@@ -203,11 +207,12 @@ npx @mastra/codemod@beta v1/storage-list-workflow-runs .
203
207
 
204
208
  The `getMessagesById()` method has been renamed to `listMessagesById()`. This change aligns with the convention that `list*` methods return collections.
205
209
 
206
- To migrate, rename the method call.
210
+ To migrate, use the memory store and rename the method call.
207
211
 
208
212
  ```diff
213
+ + const memoryStore = await storage.getStore('memory');
209
214
  - const result = await storage.getMessagesById({
210
- + const result = await storage.listMessagesById({
215
+ + const result = await memoryStore?.listMessagesById({
211
216
  messageIds: ['msg-1', 'msg-2'],
212
217
  });
213
218
  ```
@@ -226,20 +231,22 @@ npx @mastra/codemod@beta v1/storage-list-messages-by-id .
226
231
 
227
232
  The `getMessages()` and `saveMessages()` methods have changed signatures and return types. Format overloads have been removed, and the methods now always work with `MastraDBMessage`. This change simplifies the API by removing format variations.
228
233
 
229
- To migrate, remove format parameters and update code to work with the consistent return type.
234
+ To migrate, use the memory store, remove format parameters, and update code to work with the consistent return type.
230
235
 
231
236
  ```diff
237
+ + const memoryStore = await storage.getStore('memory');
238
+ +
232
239
  // Always returns { messages: MastraDBMessage[] }
233
240
  - const v1Messages = await storage.getMessages({ threadId, format: 'v1' });
234
241
  - const v2Messages = await storage.getMessages({ threadId, format: 'v2' });
235
- + const result = await storage.getMessages({ threadId });
236
- + const messages = result.messages; // MastraDBMessage[]
237
-
242
+ + const result = await memoryStore?.getMessages({ threadId });
243
+ + const messages = result?.messages; // MastraDBMessage[]
244
+
238
245
  // SaveMessages always uses MastraDBMessage
239
246
  - await storage.saveMessages({ messages: v1Messages, format: 'v1' });
240
247
  - await storage.saveMessages({ messages: v2Messages, format: 'v2' });
241
- + const result = await storage.saveMessages({ messages: mastraDBMessages });
242
- + const saved = result.messages; // MastraDBMessage[]
248
+ + const saveResult = await memoryStore?.saveMessages({ messages: mastraDBMessages });
249
+ + const saved = saveResult?.messages; // MastraDBMessage[]
243
250
  ```
244
251
 
245
252
  ### Vector store API from positional to named arguments
@@ -366,16 +373,17 @@ To migrate, update method names from `getScores` to `listScoresByScorerId` and r
366
373
 
367
374
  Non-paginated storage functions have been removed in favor of paginated versions. All list operations now use pagination, though you can fetch all records with `perPage: false`. This change provides consistency across the API and prevents accidental loading of large datasets.
368
375
 
369
- To migrate, use paginated methods. For fetching all records, use `perPage: false`.
376
+ To migrate, use paginated methods via domain stores. For fetching all records, use `perPage: false`.
370
377
 
371
378
  ```diff
372
379
  - // Non-paginated direct access
373
380
  - const messages = await storage.getMessages({ threadId });
374
381
 
375
- + // Use paginated methods
376
- + const result = await storage.listMessages({ threadId, page: 0, perPage: 20 });
382
+ + // Use paginated methods via domain stores
383
+ + const memoryStore = await storage.getStore('memory');
384
+ + const result = await memoryStore?.listMessages({ threadId, page: 0, perPage: 20 });
377
385
  + // Or fetch all
378
- + const allMessages = await storage.listMessages({
386
+ + const allMessages = await memoryStore?.listMessages({
379
387
  + threadId,
380
388
  + page: 0,
381
389
  + perPage: false,
@@ -22,48 +22,49 @@ export const agent = new Agent({
22
22
 
23
23
  ## Querying Messages
24
24
 
25
- Messages are stored in the `MastraDBMessage` format, which provides a consistent structure across the entire Mastra system:
25
+ Messages are stored in the `MastraDBMessage` format, which provides a consistent structure across the entire Mastra system.
26
+
27
+ Storage in Mastra uses domain-specific stores. To access message operations, first get the memory store:
28
+
29
+ ```typescript
30
+ // Get the memory store from storage
31
+ const storage = mastra.getStorage();
32
+ const memoryStore = await storage.getStore('memory');
26
33
 
27
- ```typescript
28
34
  // Get messages for a thread with pagination
29
- const result = await mastra
30
- .getStorage()
31
- .listMessages({
32
- threadId: "your-thread-id",
33
- page: 0,
34
- perPage: 50
35
- });
36
-
37
- console.log(result.messages); // MastraDBMessage[]
38
- console.log(result.total); // Total count
39
- console.log(result.hasMore); // Whether more pages exist
35
+ const result = await memoryStore?.listMessages({
36
+ threadId: "your-thread-id",
37
+ page: 0,
38
+ perPage: 50
39
+ });
40
+
41
+ console.log(result?.messages); // MastraDBMessage[]
42
+ console.log(result?.total); // Total count
43
+ console.log(result?.hasMore); // Whether more pages exist
40
44
 
41
45
  // Get messages from multiple threads at once
42
- const multiThreadResult = await mastra
43
- .getStorage()
44
- .listMessages({
45
- threadId: ["thread-1", "thread-2", "thread-3"],
46
- page: 0,
47
- perPage: 100
48
- });
46
+ const multiThreadResult = await memoryStore?.listMessages({
47
+ threadId: ["thread-1", "thread-2", "thread-3"],
48
+ page: 0,
49
+ perPage: 100
50
+ });
49
51
 
50
52
  // Get messages by their IDs
51
- const messages = await mastra
52
- .getStorage()
53
- .listMessagesById({ messageIds: messageIdArr });
53
+ const messages = await memoryStore?.listMessagesById({ messageIds: messageIdArr });
54
54
  ```
55
55
 
56
56
  The `threadId` parameter accepts either a single thread ID string or an array of thread IDs to query messages from multiple threads in a single request.
57
57
 
58
58
  All message queries return `MastraDBMessage[]` format. If you need to convert messages to AI SDK formats for UI rendering, use the conversion utilities from `@mastra/ai-sdk/ui`:
59
59
 
60
- ```typescript
60
+ ```typescript
61
61
  import { toAISdkV5Messages } from '@mastra/ai-sdk/ui';
62
62
 
63
- const result = await mastra
64
- .getStorage()
65
- .listMessages({ threadId: "your-thread-id" });
63
+ const storage = mastra.getStorage();
64
+ const memoryStore = await storage.getStore('memory');
65
+
66
+ const result = await memoryStore?.listMessages({ threadId: "your-thread-id" });
66
67
 
67
68
  // Convert to AI SDK v5 UIMessage format for UI rendering
68
- const uiMessages = toAISdkV5Messages(result.messages);
69
+ const uiMessages = toAISdkV5Messages(result?.messages ?? []);
69
70
  ```
@@ -21,6 +21,18 @@ You'll also need to install the storage adapters you want to compose:
21
21
  npm install @mastra/pg@beta @mastra/libsql@beta
22
22
  ```
23
23
 
24
+ ## Storage Domains
25
+
26
+ Mastra organizes storage into five specialized domains, each handling a specific type of data. Each domain can be backed by a different storage adapter, and domain classes are exported from each storage package.
27
+
28
+ | Domain | Description |
29
+ |--------|-------------|
30
+ | `memory` | Conversation persistence for agents. Stores threads (conversation sessions), messages, resources (user identities), and working memory (persistent context across conversations). |
31
+ | `workflows` | Workflow execution state. When workflows suspend for human input, external events, or scheduled resumption, their state is persisted here to enable resumption after server restarts. |
32
+ | `scores` | Evaluation results from Mastra's evals system. Scores and metrics are persisted here for analysis and comparison over time. |
33
+ | `observability` | Telemetry data including traces and spans. Agent interactions, tool calls, and LLM requests generate spans collected into traces for debugging and performance analysis. |
34
+ | `agents` | Agent configurations for stored agents. Enables agents to be defined and updated at runtime without code deployments. |
35
+
24
36
  ## Usage
25
37
 
26
38
  ### Basic composition
@@ -29,7 +41,7 @@ Import domain classes directly from each store package and compose them:
29
41
 
30
42
  ```typescript
31
43
  import { MastraStorage } from "@mastra/core/storage";
32
- import { MemoryPG, WorkflowsPG, ScoresPG } from "@mastra/pg";
44
+ import { WorkflowsPG, ScoresPG } from "@mastra/pg";
33
45
  import { MemoryLibSQL } from "@mastra/libsql";
34
46
  import { Mastra } from "@mastra/core";
35
47
 
@@ -161,6 +173,9 @@ const mastra = new Mastra({
161
173
  If using storage directly, call `init()` explicitly:
162
174
 
163
175
  ```typescript
176
+ import { MastraStorage } from "@mastra/core/storage";
177
+ import { MemoryPG } from "@mastra/pg";
178
+
164
179
  const storage = new MastraStorage({
165
180
  id: "composite",
166
181
  domains: {
@@ -217,6 +232,8 @@ const storage = new MastraStorage({
217
232
  scores: new ScoresPG({ connectionString: process.env.DATABASE_URL }),
218
233
  observability: new ObservabilityStorageClickhouse({
219
234
  url: process.env.CLICKHOUSE_URL,
235
+ username: process.env.CLICKHOUSE_USERNAME,
236
+ password: process.env.CLICKHOUSE_PASSWORD,
220
237
  }),
221
238
  },
222
239
  });
package/CHANGELOG.md CHANGED
@@ -1,5 +1,19 @@
1
1
  # @mastra/mcp-docs-server
2
2
 
3
+ ## 1.0.0-beta.19
4
+
5
+ ### Patch Changes
6
+
7
+ - Updated dependencies [[`e54953e`](https://github.com/mastra-ai/mastra/commit/e54953ed8ce1b28c0d62a19950163039af7834b4), [`7d56d92`](https://github.com/mastra-ai/mastra/commit/7d56d9213886e8353956d7d40df10045fd12b299), [`fdac646`](https://github.com/mastra-ai/mastra/commit/fdac646033a0930a1a4e00d13aa64c40bb7f1e02), [`d07b568`](https://github.com/mastra-ai/mastra/commit/d07b5687819ea8cb1dffa776d0c1765faf4aa1ae), [`68ec97d`](https://github.com/mastra-ai/mastra/commit/68ec97d4c07c6393fcf95c2481fc5d73da99f8c8), [`4aa55b3`](https://github.com/mastra-ai/mastra/commit/4aa55b383cf06043943359ea316572fd969861a7)]:
8
+ - @mastra/core@1.0.0-beta.19
9
+
10
+ ## 1.0.0-beta.18
11
+
12
+ ### Patch Changes
13
+
14
+ - Updated dependencies [[`5947fcd`](https://github.com/mastra-ai/mastra/commit/5947fcdd425531f29f9422026d466c2ee3113c93)]:
15
+ - @mastra/core@1.0.0-beta.18
16
+
3
17
  ## 1.0.0-beta.17
4
18
 
5
19
  ### Patch Changes
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@mastra/mcp-docs-server",
3
- "version": "1.0.0-beta.17",
3
+ "version": "1.0.0-beta.19",
4
4
  "description": "MCP server for accessing Mastra.ai documentation, changelogs, and news.",
5
5
  "type": "module",
6
6
  "main": "dist/index.js",
@@ -28,8 +28,8 @@
28
28
  "@modelcontextprotocol/sdk": "^1.17.5",
29
29
  "jsdom": "^26.1.0",
30
30
  "zod": "^3.25.76",
31
- "@mastra/mcp": "^1.0.0-beta.7",
32
- "@mastra/core": "1.0.0-beta.17"
31
+ "@mastra/core": "1.0.0-beta.19",
32
+ "@mastra/mcp": "^1.0.0-beta.7"
33
33
  },
34
34
  "devDependencies": {
35
35
  "@hono/node-server": "^1.19.6",
@@ -46,7 +46,7 @@
46
46
  "typescript": "^5.8.3",
47
47
  "vitest": "4.0.12",
48
48
  "@internal/lint": "0.0.53",
49
- "@mastra/core": "1.0.0-beta.17"
49
+ "@mastra/core": "1.0.0-beta.19"
50
50
  },
51
51
  "homepage": "https://mastra.ai",
52
52
  "repository": {