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

package/.docs/organized/changelogs/%40mastra%2Fagent-builder.md

@@ -1,5 +1,13 @@
 # @mastra/agent-builder
 
+## 1.0.0-beta.10
+
+### Patch Changes
+
+- 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)]:
+  - @mastra/core@1.0.0-beta.19
+  - @mastra/memory@1.0.0-beta.10
+
 ## 1.0.0-beta.9
 
 ### Patch Changes
@@ -490,13 +498,5 @@
 - Updated dependencies [5397eb4]
 - Updated dependencies [376913a]
 - Updated dependencies [c9f4e4a]
-- Updated dependencies [0acbc80]
-- Updated dependencies [38020d5]
-  - @mastra/core@0.16.0
-  - @mastra/memory@0.14.4
-
-## 0.0.2-alpha.1
-
-### Patch Changes
 
-... 140 more lines hidden. See full changelog in package directory.
+... 148 more lines hidden. See full changelog in package directory.

package/.docs/organized/changelogs/%40mastra%2Fai-sdk.md

@@ -1,5 +1,21 @@
 # @mastra/ai-sdk
 
+## 1.0.0-beta.12
+
+### Patch Changes
+
+- Fix data chunk property filtering to only include type, data, and id properties ([#11477](https://github.com/mastra-ai/mastra/pull/11477))
+
+  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.
+
+  Now, all locations that handle `DataChunkType` properly destructure and return only the allowed properties:
+  - `type` (required): The chunk type identifier starting with "data-"
+  - `data` (required): The actual data payload
+  - `id` (optional): An optional identifier for the chunk
+
+- 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)]:
+  - @mastra/core@1.0.0-beta.19
+
 ## 1.0.0-beta.11
 
 ### Patch Changes
@@ -483,20 +499,4 @@
 
 ### Patch Changes
 
-- Update README to include more usage examples ([#8817](https://github.com/mastra-ai/mastra/pull/8817))
-
-- 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)]:
-  - @mastra/core@0.21.1-alpha.0
-
-## 0.2.0
-
-### Minor Changes
-
-- Update peer dependencies to match core package version bump (0.20.3) ([#8672](https://github.com/mastra-ai/mastra/pull/8672))
-
-- Update peer dependencies to match core package version bump (0.20.3) ([#8614](https://github.com/mastra-ai/mastra/pull/8614))
-
-### Patch Changes
-
-
-... 278 more lines hidden. See full changelog in package directory.
+... 294 more lines hidden. See full changelog in package directory.

package/.docs/organized/changelogs/%40mastra%2Fclient-js.md

@@ -1,5 +1,13 @@
 # @mastra/client-js
 
+## 1.0.0-beta.19
+
+### Patch Changes
+
+- 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)]:
+  - @mastra/core@1.0.0-beta.19
+  - @mastra/schema-compat@1.0.0-beta.5
+
 ## 1.0.0-beta.18
 
 ### Patch Changes
@@ -491,12 +499,4 @@
 
 ### Major Changes
 
-- Moving scorers under the eval domain, api method consistency, prebuilt evals, scorers require ids. ([#9589](https://github.com/mastra-ai/mastra/pull/9589))
-
-- 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))
-
-- **BREAKING:** Remove `getMessagesPaginated()` and add `perPage: false` support ([#9670](https://github.com/mastra-ai/mastra/pull/9670))
-
-  Removes deprecated `getMessagesPaginated()` method. The `listMessages()` API and score handlers now support `perPage: false` to fetch all records without pagination limits.
-
-... 3571 more lines hidden. See full changelog in package directory.
+... 3579 more lines hidden. See full changelog in package directory.

package/.docs/organized/changelogs/%40mastra%2Fcore.md

@@ -1,5 +1,78 @@
 # @mastra/core
 
+## 1.0.0-beta.19
+
+### Minor Changes
+
+- Add embedderOptions support to Memory for AI SDK 5+ provider-specific embedding options ([#11462](https://github.com/mastra-ai/mastra/pull/11462))
+
+  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.
+
+  You can now configure embedder options when creating Memory:
+
+  ```typescript
+  import { Memory } from '@mastra/core';
+  import { google } from '@ai-sdk/google';
+
+  // Before: No way to specify providerOptions
+  const memory = new Memory({
+    embedder: google.textEmbeddingModel('text-embedding-004'),
+  });
+
+  // After: Pass embedderOptions with providerOptions
+  const memory = new Memory({
+    embedder: google.textEmbeddingModel('text-embedding-004'),
+    embedderOptions: {
+      providerOptions: {
+        google: {
+          outputDimensionality: 768,
+          taskType: 'RETRIEVAL_DOCUMENT',
+        },
+      },
+    },
+  });
+  ```
+
+  This is especially important for:
+  - Google `text-embedding-004`: Control output dimensions (default 768)
+  - Google `gemini-embedding-001`: Reduce from default 3072 dimensions to avoid pgvector's 2000 dimension limit for HNSW indexes
+
+  Fixes #8248
+
+### Patch Changes
+
+- Fix Anthropic API error when tool calls have empty input objects ([#11474](https://github.com/mastra-ai/mastra/pull/11474))
+
+  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.
+
+  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.
+
+  Changes:
+  - Added `findToolCallArgs()` helper method to search through messages and retrieve original tool call arguments
+  - Enhanced `aiV5UIMessagesToAIV5ModelMessages()` to populate the `input` field on tool-result parts
+  - Added comprehensive test coverage for empty object inputs, parameterized inputs, and multi-turn conversations
+
+- 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))
+
+- 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))
+
+  The fix updates version checks in `listAgentTools` and `llm-mapping-step.ts` to use the centralized `supportedLanguageModelSpecifications` array which includes both v2 and v3.
+
+  Also adds missing v3 test coverage to tool-handling.test.ts to prevent regression.
+
+- Fixed "Transforms cannot be represented in JSON Schema" error when using Zod v4 with structuredOutput ([#11466](https://github.com/mastra-ai/mastra/pull/11466))
+
+  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.
+
+  The fix uses Mastra's transform-safe `zodToJsonSchema` function which gracefully handles transforms by using the `unrepresentable: 'any'` option.
+
+  Also exported `isZodType` utility from `@mastra/schema-compat` and updated it to detect both Zod v3 (`_def`) and Zod v4 (`_zod`) schemas.
+
+- Improved test description in ModelsDevGateway to clearly reflect the behavior being tested ([#11460](https://github.com/mastra-ai/mastra/pull/11460))
+
+- Updated dependencies [[`d07b568`](https://github.com/mastra-ai/mastra/commit/d07b5687819ea8cb1dffa776d0c1765faf4aa1ae), [`70b300e`](https://github.com/mastra-ai/mastra/commit/70b300ebc631dfc0aa14e61547fef7994adb4ea6)]:
+  - @mastra/schema-compat@1.0.0-beta.5
+
 ## 1.0.0-beta.18
 
 ### Patch Changes
@@ -425,78 +498,5 @@
     description: 'Process payment',
     inputSchema: z.object({ amount: z.number() }),
     needsApproval: async ({ amount }) => amount > 1000,
-    execute: async ({ amount }) => {
-      return { success: true, amount };
-    },
-  });
-  ```
-
-  **Mastra tools continue to work with `requireApproval`:**
-
-  ```typescript
-  import { createTool } from '@mastra/core';
-
-  const deleteTool = createTool({
-    id: 'delete-file',
-    description: 'Delete a file',
-    requireApproval: true,
-    inputSchema: z.object({ path: z.string() }),
-    execute: async ({ path }) => {
-      return { deleted: true };
-    },
-  });
-  ```
-
-- Fix stopWhen type to accept AI SDK v6 StopCondition functions like `stepCountIs()` ([#11402](https://github.com/mastra-ai/mastra/pull/11402))
-
-- Fix missing `title` field in Convex threads table schema ([#11356](https://github.com/mastra-ai/mastra/pull/11356))
-
-  The Convex schema was hardcoded and out of sync with the core `TABLE_SCHEMAS`, causing errors when creating threads:
-
-  ```
-  Error: Failed to insert or update a document in table "mastra_threads"
-  because it does not match the schema: Object contains extra field `title`
-  that is not in the validator.
-  ```
-
-  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).
-
-  ```typescript
-  // Users can now import schema tables without Node.js dependency issues
-  import { mastraThreadsTable, mastraMessagesTable } from '@mastra/convex/schema';
-
-  export default defineSchema({
-    mastra_threads: mastraThreadsTable,
-    mastra_messages: mastraMessagesTable,
-  });
-  ```
-
-  Fixes #11319
-
-- 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))
-
-- fix: support gs:// and s3:// cloud storage URLs in attachmentsToParts ([#11398](https://github.com/mastra-ai/mastra/pull/11398))
-
-- 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))
-
-- 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))
-
-- 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))
-
-  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
-
-- Improve autoResumeSuspendedTools instruction for tool approval ([#11338](https://github.com/mastra-ai/mastra/pull/11338))
-
-- Add debugger-like click-through UI to workflow graph ([#11350](https://github.com/mastra-ai/mastra/pull/11350))
-
-- 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))
-
-- Fix workflow throwing error when using .map after .foreach ([#11352](https://github.com/mastra-ai/mastra/pull/11352))
-
-- Bump @ai-sdk/openai from 3.0.0-beta.102 to 3.0.1 ([#11377](https://github.com/mastra-ai/mastra/pull/11377))
-
-## 1.0.0-beta.14
-
-### Minor Changes
 
-... 6984 more lines hidden. See full changelog in package directory.
+... 7057 more lines hidden. See full changelog in package directory.

package/.docs/organized/changelogs/%40mastra%2Fdeployer-cloud.md

@@ -1,5 +1,13 @@
 # @mastra/deployer-cloud
 
+## 1.0.0-beta.19
+
+### Patch Changes
+
+- 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)]:
+  - @mastra/core@1.0.0-beta.19
+  - @mastra/deployer@1.0.0-beta.19
+
 ## 1.0.0-beta.18
 
 ### Patch Changes
@@ -491,12 +499,4 @@
   - @mastra/deployer@0.19.1-alpha.0
   - @mastra/core@0.19.1-alpha.0
 
-## 0.19.0
-
-### Patch Changes
-
-- Update peer deps ([#8154](https://github.com/mastra-ai/mastra/pull/8154))
-
-- Fix peer deps ([#8134](https://github.com/mastra-ai/mastra/pull/8134))
-
-... 567 more lines hidden. See full changelog in package directory.
+... 575 more lines hidden. See full changelog in package directory.

package/.docs/organized/changelogs/%40mastra%2Fdeployer.md

@@ -1,5 +1,19 @@
 # @mastra/deployer
 
+## 1.0.0-beta.19
+
+### Patch Changes
+
+- Fix npm resolving wrong @mastra/server version ([#11467](https://github.com/mastra-ai/mastra/pull/11467))
+
+  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.
+
+- Remove extra console log statements in node-modules-extension-resolver ([#11470](https://github.com/mastra-ai/mastra/pull/11470))
+
+- 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)]:
+  - @mastra/core@1.0.0-beta.19
+  - @mastra/server@1.0.0-beta.19
+
 ## 1.0.0-beta.18
 
 ### Patch Changes
@@ -484,19 +498,5 @@
   ```typescript
   // Before
   await memory.listThreadsByResourceId({
-    resourceId: 'user-123',
-    offset: 20,
-    limit: 10,
-  });
-
-  // After
-  await memory.listThreadsByResourceId({
-    resourceId: 'user-123',
-    page: 2, // page = Math.floor(offset / limit)
-    perPage: 10,
-  });
-
-  // Before
-  await memory.listMessages({
 
-... 5270 more lines hidden. See full changelog in package directory.
+... 5284 more lines hidden. See full changelog in package directory.

package/.docs/organized/changelogs/%40mastra%2Fmcp-docs-server.md

@@ -1,5 +1,12 @@
 # @mastra/mcp-docs-server
 
+## 1.0.0-beta.19
+
+### Patch Changes
+
+- 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)]:
+  - @mastra/core@1.0.0-beta.19
+
 ## 1.0.0-beta.18
 
 ### Patch Changes
@@ -491,12 +498,5 @@
 
 ## 0.13.24-alpha.0
 
-### Patch Changes
-
-- 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)]:
-  - @mastra/core@0.17.2-alpha.0
-
-## 0.13.23
-
 
-... 2119 more lines hidden. See full changelog in package directory.
+... 2126 more lines hidden. See full changelog in package directory.

package/.docs/organized/changelogs/%40mastra%2Fmemory.md

@@ -1,5 +1,13 @@
 # @mastra/memory
 
+## 1.0.0-beta.10
+
+### Patch Changes
+
+- 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)]:
+  - @mastra/core@1.0.0-beta.19
+  - @mastra/schema-compat@1.0.0-beta.5
+
 ## 1.0.0-beta.9
 
 ### Patch Changes
@@ -490,13 +498,5 @@
 - Enforcing id required on Processor primitive ([#9591](https://github.com/mastra-ai/mastra/pull/9591))
 
 - Renamed `MastraMessageV2` to `MastraDBMessage` ([#9255](https://github.com/mastra-ai/mastra/pull/9255))
-  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
-
-### Minor Changes
-
-- Update peer dependencies to match core package version bump (0.22.3) ([#9486](https://github.com/mastra-ai/mastra/pull/9486))
-
-- **BREAKING CHANGE**: Memory scope defaults changed from 'thread' to 'resource' ([#8983](https://github.com/mastra-ai/mastra/pull/8983))
-
 
-... 3604 more lines hidden. See full changelog in package directory.
+... 3612 more lines hidden. See full changelog in package directory.

package/.docs/organized/changelogs/%40mastra%2Fpg.md

@@ -1,5 +1,68 @@
 # @mastra/pg
 
+## 1.0.0-beta.11
+
+### Minor Changes
+
+- Remove pg-promise dependency and use pg.Pool directly ([#11450](https://github.com/mastra-ai/mastra/pull/11450))
+
+  **BREAKING CHANGE**: This release replaces pg-promise with vanilla node-postgres (`pg`).
+
+  ### Breaking Changes
+  - **Removed `store.pgp`**: The pg-promise library instance is no longer exposed
+  - **Config change**: `{ client: pgPromiseDb }` is no longer supported. Use `{ pool: pgPool }` instead
+  - **Cloud SQL config**: `max` and `idleTimeoutMillis` must now be passed via `pgPoolOptions`
+
+  ### New Features
+  - **`store.pool`**: Exposes the underlying `pg.Pool` for direct database access or ORM integration (e.g., Drizzle)
+  - **`store.db`**: Provides a `DbClient` interface with methods like `one()`, `any()`, `tx()`, etc.
+  - **`store.db.connect()`**: Acquire a client for session-level operations
+
+  ### Migration
+
+  ```typescript
+  // Before (pg-promise)
+  import pgPromise from 'pg-promise';
+  const pgp = pgPromise();
+  const client = pgp(connectionString);
+  const store = new PostgresStore({ id: 'my-store', client });
+
+  // After (pg.Pool)
+  import { Pool } from 'pg';
+  const pool = new Pool({ connectionString });
+  const store = new PostgresStore({ id: 'my-store', pool });
+
+  // Use store.pool with any library that accepts a pg.Pool
+  ```
+
+### Patch Changes
+
+- Added `exportSchemas()` function to generate Mastra database schema as SQL DDL without a database connection. ([#11448](https://github.com/mastra-ai/mastra/pull/11448))
+
+  **What's New**
+
+  You can now export your Mastra database schema as SQL DDL statements without connecting to a database. This is useful for:
+  - Generating migration scripts
+  - Reviewing the schema before deployment
+  - Creating database schemas in environments where the application doesn't have CREATE privileges
+
+  **Example**
+
+  ```typescript
+  import { exportSchemas } from '@mastra/pg';
+
+  // Export schema for default 'public' schema
+  const ddl = exportSchemas();
+  console.log(ddl);
+
+  // Export schema for a custom schema
+  const customDdl = exportSchemas('my_schema');
+  // Creates: CREATE SCHEMA IF NOT EXISTS "my_schema"; and all tables within it
+  ```
+
+- 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)]:
+  - @mastra/core@1.0.0-beta.19
+
 ## 1.0.0-beta.10
 
 ### Patch Changes
@@ -435,68 +498,5 @@
   await storage.init();
 
   // Runtime - skip auto-init
-  const storage = new PostgresStore({
-    connectionString: DATABASE_URL,
-    id: 'pg-storage',
-    disableInit: true,
-  });
-  ```
-
-### Patch Changes
-
-- 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))
-
-- 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)]:
-  - @mastra/core@1.0.0-beta.7
-
-## 1.0.0-beta.3
-
-### Patch Changes
-
-- fix(pg): qualify vector type to fix schema lookup ([#10786](https://github.com/mastra-ai/mastra/pull/10786))
-
-- feat(storage): support querying messages from multiple threads ([#10663](https://github.com/mastra-ai/mastra/pull/10663))
-  - Fixed TypeScript errors where `threadId: string | string[]` was being passed to places expecting `Scalar` type
-  - Added proper multi-thread support for `listMessages` across all adapters when `threadId` is an array
-  - Updated `_getIncludedMessages` to look up message threadId by ID (since message IDs are globally unique)
-  - **upstash**: Added `msg-idx:{messageId}` index for O(1) message lookups (backwards compatible with fallback to scan for old messages, with automatic backfill)
-
-- fix: ensure score responses match saved payloads for Mastra Stores. ([#10557](https://github.com/mastra-ai/mastra/pull/10557))
-
-- Unify transformScoreRow functions across storage adapters ([#10648](https://github.com/mastra-ai/mastra/pull/10648))
-
-  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:
-  - `preferredTimestampFields`: Preferred source fields for timestamps (PostgreSQL, Cloudflare D1)
-  - `convertTimestamps`: Convert timestamp strings to Date objects (MSSQL, MongoDB, ClickHouse)
-  - `nullValuePattern`: Skip values matching pattern (ClickHouse's `'_null_'`)
-  - `fieldMappings`: Map source column names to schema fields (LibSQL's `additionalLLMContext`)
-
-  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.
-
-- 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)]:
-  - @mastra/core@1.0.0-beta.6
-
-## 1.0.0-beta.2
-
-### Patch Changes
-
-- Add new deleteVectors, updateVector by filter ([#10408](https://github.com/mastra-ai/mastra/pull/10408))
-
-- 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)]:
-  - @mastra/core@1.0.0-beta.5
-
-## 1.0.0-beta.1
-
-### Patch Changes
-
-- Add restart method to workflow run that allows restarting an active workflow run ([#9750](https://github.com/mastra-ai/mastra/pull/9750))
-  Add status filter to `listWorkflowRuns`
-  Add automatic restart to restart active workflow runs when server starts
-- 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)]:
-  - @mastra/core@1.0.0-beta.3
-
-## 1.0.0-beta.0
-
-### Major Changes
 
-... 3105 more lines hidden. See full changelog in package directory.
+... 3168 more lines hidden. See full changelog in package directory.

package/.docs/organized/changelogs/%40mastra%2Fplayground-ui.md

@@ -1,5 +1,16 @@
 # @mastra/playground-ui
 
+## 7.0.0-beta.19
+
+### Patch Changes
+
+- 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)]:
+  - @mastra/core@1.0.0-beta.19
+  - @mastra/ai-sdk@1.0.0-beta.12
+  - @mastra/schema-compat@1.0.0-beta.5
+  - @mastra/client-js@1.0.0-beta.19
+  - @mastra/react@0.1.0-beta.19
+
 ## 7.0.0-beta.18
 
 ### Patch Changes
@@ -487,16 +498,5 @@
 
 ### Patch Changes
 
-- Make MainSidebar toggle button sticky to bottom, always visible ([#9682](https://github.com/mastra-ai/mastra/pull/9682))
-
-- Removing uneeded files ([#9877](https://github.com/mastra-ai/mastra/pull/9877))
-
-- Explicitly set color of line number in CodeMirror ([#9878](https://github.com/mastra-ai/mastra/pull/9878))
-
-- Add visual styles and labels for more workflow node types ([#9777](https://github.com/mastra-ai/mastra/pull/9777))
-
-- 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)]:
-  - @mastra/core@1.0.0-beta.1
-  - @mastra/client-js@1.0.0-beta.1
 
-... 4437 more lines hidden. See full changelog in package directory.
+... 4448 more lines hidden. See full changelog in package directory.

package/.docs/organized/changelogs/%40mastra%2Freact.md

@@ -1,5 +1,12 @@
 # @mastra/react-hooks
 
+## 0.1.0-beta.19
+
+### Patch Changes
+
+- Updated dependencies:
+  - @mastra/client-js@1.0.0-beta.19
+
 ## 0.1.0-beta.18
 
 ### Patch Changes
@@ -491,12 +498,5 @@
 
 ### Patch Changes
 
-- Updated dependencies []:
-  - @mastra/client-js@0.15.1-alpha.3
-
-## 0.0.4-alpha.2
-
-### Patch Changes
-
 
-... 93 more lines hidden. See full changelog in package directory.
+... 100 more lines hidden. See full changelog in package directory.

package/.docs/organized/changelogs/%40mastra%2Fschema-compat.md

@@ -1,5 +1,25 @@
 # @mastra/schema-compat
 
+## 1.0.0-beta.5
+
+### Patch Changes
+
+- Fixed "Transforms cannot be represented in JSON Schema" error when using Zod v4 with structuredOutput ([#11466](https://github.com/mastra-ai/mastra/pull/11466))
+
+  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.
+
+  The fix uses Mastra's transform-safe `zodToJsonSchema` function which gracefully handles transforms by using the `unrepresentable: 'any'` option.
+
+  Also exported `isZodType` utility from `@mastra/schema-compat` and updated it to detect both Zod v3 (`_def`) and Zod v4 (`_zod`) schemas.
+
+- fix(schema-compat): handle undefined values in optional fields for OpenAI compat layers ([#11469](https://github.com/mastra-ai/mastra/pull/11469))
+
+  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`.
+
+  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).
+
+  Fixes #11457
+
 ## 1.0.0-beta.4
 
 ### Patch Changes

package/.docs/organized/changelogs/%40mastra%2Fserver.md

@@ -1,5 +1,12 @@
 # @mastra/server
 
+## 1.0.0-beta.19
+
+### Patch Changes
+
+- 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)]:
+  - @mastra/core@1.0.0-beta.19
+
 ## 1.0.0-beta.18
 
 ### Patch Changes
@@ -492,11 +499,4 @@
 
 ### Patch Changes
 
-- Unified MastraServer API with MCP transport routes ([#10644](https://github.com/mastra-ai/mastra/pull/10644))
-
-  **Breaking Changes:**
-  - Renamed `HonoServerAdapter` to `MastraServer` in `@mastra/hono`
-  - Renamed `ExpressServerAdapter` to `MastraServer` in `@mastra/express`
-  - Configuration now passed to constructor instead of separate method calls
-
-... 4603 more lines hidden. See full changelog in package directory.
+... 4610 more lines hidden. See full changelog in package directory.

package/.docs/raw/guides/migrations/upgrade-to-v1/storage.mdx

@@ -63,7 +63,7 @@ All pagination APIs now use `page` and `perPage` instead of `offset` and `limit`
 To migrate, update all pagination parameters from `offset/limit` to `page/perPage`. Note that `page` is 0-indexed.
 
 ```diff
-  storage.listMessages({
+  memoryStore.listMessages({
     threadId: 'thread-123',
 -   offset: 0,
 -   limit: 20,
@@ -79,18 +79,20 @@ The `getMessagesPaginated()` method has been replaced with `listMessages()`. The
 To migrate, rename the method and update pagination parameters. You can now use `perPage: false` to fetch all records.
 
 ```diff
++ const memoryStore = await storage.getStore('memory');
++
   // Paginated
 - const result = await storage.getMessagesPaginated({
-+ const result = await storage.listMessages({
++ const result = await memoryStore?.listMessages({
     threadId: 'thread-123',
 -   offset: 0,
 -   limit: 20,
 +   page: 0,
 +   perPage: 20,
   });
-  
+
   // Fetch all records (no pagination limit)
-+ const allMessages = await storage.listMessages({
++ const allMessages = await memoryStore?.listMessages({
 +   threadId: 'thread-123',
 +   page: 0,
 +   perPage: false,
@@ -152,11 +154,12 @@ To migrate, call `getStore()` with the domain name, then call methods on the ret
 
 The `getThreadsByResourceId()` method has been renamed to `listThreadsByResourceId()`. This change aligns with the convention that `list*` methods return collections.
 
-To migrate, rename the method call and update pagination parameters.
+To migrate, use the memory store and rename the method call with pagination parameters.
 
 ```diff
 - const threads = await storage.getThreadsByResourceId({
-+ const threads = await storage.listThreadsByResourceId({
++ const memoryStore = await storage.getStore('memory');
++ const threads = await memoryStore?.listThreadsByResourceId({
     resourceId: 'res-123',
 +   page: 0,
 +   perPage: 20,
@@ -177,11 +180,12 @@ npx @mastra/codemod@beta v1/storage-get-threads-by-resource .
 
 The `getWorkflowRuns()` method has been renamed to `listWorkflowRuns()`. This change aligns with the convention that `list*` methods return collections.
 
-To migrate, rename the method call and update pagination parameters.
+To migrate, use the workflows stores, rename the method call and update pagination parameters.
 
 ```diff
 - const runs = await storage.getWorkflowRuns({
-+ const runs = await storage.listWorkflowRuns({
++ const workflowStore = await storage.getStore('workflows');
++ const runs = await workflowStore?.listWorkflowRuns({
     fromDate,
     toDate,
 +   page: 0,
@@ -203,11 +207,12 @@ npx @mastra/codemod@beta v1/storage-list-workflow-runs .
 
 The `getMessagesById()` method has been renamed to `listMessagesById()`. This change aligns with the convention that `list*` methods return collections.
 
-To migrate, rename the method call.
+To migrate, use the memory store and rename the method call.
 
 ```diff
++ const memoryStore = await storage.getStore('memory');
 - const result = await storage.getMessagesById({
-+ const result = await storage.listMessagesById({
++ const result = await memoryStore?.listMessagesById({
     messageIds: ['msg-1', 'msg-2'],
   });
 ```
@@ -226,20 +231,22 @@ npx @mastra/codemod@beta v1/storage-list-messages-by-id .
 
 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.
 
-To migrate, remove format parameters and update code to work with the consistent return type.
+To migrate, use the memory store, remove format parameters, and update code to work with the consistent return type.
 
 ```diff
++ const memoryStore = await storage.getStore('memory');
++
   // Always returns { messages: MastraDBMessage[] }
 - const v1Messages = await storage.getMessages({ threadId, format: 'v1' });
 - const v2Messages = await storage.getMessages({ threadId, format: 'v2' });
-+ const result = await storage.getMessages({ threadId });
-+ const messages = result.messages; // MastraDBMessage[]
-  
++ const result = await memoryStore?.getMessages({ threadId });
++ const messages = result?.messages; // MastraDBMessage[]
+
   // SaveMessages always uses MastraDBMessage
 - await storage.saveMessages({ messages: v1Messages, format: 'v1' });
 - await storage.saveMessages({ messages: v2Messages, format: 'v2' });
-+ const result = await storage.saveMessages({ messages: mastraDBMessages });
-+ const saved = result.messages; // MastraDBMessage[]
++ const saveResult = await memoryStore?.saveMessages({ messages: mastraDBMessages });
++ const saved = saveResult?.messages; // MastraDBMessage[]
 ```
 
 ### Vector store API from positional to named arguments
@@ -366,16 +373,17 @@ To migrate, update method names from `getScores` to `listScoresByScorerId` and r
 
 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.
 
-To migrate, use paginated methods. For fetching all records, use `perPage: false`.
+To migrate, use paginated methods via domain stores. For fetching all records, use `perPage: false`.
 
 ```diff
 - // Non-paginated direct access
 - const messages = await storage.getMessages({ threadId });
 
-+ // Use paginated methods
-+ const result = await storage.listMessages({ threadId, page: 0, perPage: 20 });
++ // Use paginated methods via domain stores
++ const memoryStore = await storage.getStore('memory');
++ const result = await memoryStore?.listMessages({ threadId, page: 0, perPage: 20 });
 + // Or fetch all
-+ const allMessages = await storage.listMessages({
++ const allMessages = await memoryStore?.listMessages({
 +   threadId,
 +   page: 0,
 +   perPage: false,

package/.docs/raw/memory/message-history.mdx

@@ -22,48 +22,49 @@ export const agent = new Agent({
 
 ## Querying Messages
 
-Messages are stored in the `MastraDBMessage` format, which provides a consistent structure across the entire Mastra system:
+Messages are stored in the `MastraDBMessage` format, which provides a consistent structure across the entire Mastra system.
+
+Storage in Mastra uses domain-specific stores. To access message operations, first get the memory store:
+
+```typescript
+// Get the memory store from storage
+const storage = mastra.getStorage();
+const memoryStore = await storage.getStore('memory');
 
-```typescript 
 // Get messages for a thread with pagination
-const result = await mastra
-  .getStorage()
-  .listMessages({
-    threadId: "your-thread-id",
-    page: 0,
-    perPage: 50
-  });
-
-console.log(result.messages); // MastraDBMessage[]
-console.log(result.total); // Total count
-console.log(result.hasMore); // Whether more pages exist
+const result = await memoryStore?.listMessages({
+  threadId: "your-thread-id",
+  page: 0,
+  perPage: 50
+});
+
+console.log(result?.messages); // MastraDBMessage[]
+console.log(result?.total); // Total count
+console.log(result?.hasMore); // Whether more pages exist
 
 // Get messages from multiple threads at once
-const multiThreadResult = await mastra
-  .getStorage()
-  .listMessages({
-    threadId: ["thread-1", "thread-2", "thread-3"],
-    page: 0,
-    perPage: 100
-  });
+const multiThreadResult = await memoryStore?.listMessages({
+  threadId: ["thread-1", "thread-2", "thread-3"],
+  page: 0,
+  perPage: 100
+});
 
 // Get messages by their IDs
-const messages = await mastra
-  .getStorage()
-  .listMessagesById({ messageIds: messageIdArr });
+const messages = await memoryStore?.listMessagesById({ messageIds: messageIdArr });
 ```
 
 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.
 
 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`:
 
-```typescript 
+```typescript
 import { toAISdkV5Messages } from '@mastra/ai-sdk/ui';
 
-const result = await mastra
-  .getStorage()
-  .listMessages({ threadId: "your-thread-id" });
+const storage = mastra.getStorage();
+const memoryStore = await storage.getStore('memory');
+
+const result = await memoryStore?.listMessages({ threadId: "your-thread-id" });
 
 // Convert to AI SDK v5 UIMessage format for UI rendering
-const uiMessages = toAISdkV5Messages(result.messages);
+const uiMessages = toAISdkV5Messages(result?.messages ?? []);
 ```

package/.docs/raw/reference/storage/composite.mdx

@@ -21,6 +21,18 @@ You'll also need to install the storage adapters you want to compose:
 npm install @mastra/pg@beta @mastra/libsql@beta
 ```
 
+## Storage Domains
+
+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.
+
+| Domain | Description |
+|--------|-------------|
+| `memory` | Conversation persistence for agents. Stores threads (conversation sessions), messages, resources (user identities), and working memory (persistent context across conversations). |
+| `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. |
+| `scores` | Evaluation results from Mastra's evals system. Scores and metrics are persisted here for analysis and comparison over time. |
+| `observability` | Telemetry data including traces and spans. Agent interactions, tool calls, and LLM requests generate spans collected into traces for debugging and performance analysis. |
+| `agents` | Agent configurations for stored agents. Enables agents to be defined and updated at runtime without code deployments. |
+
 ## Usage
 
 ### Basic composition
@@ -29,7 +41,7 @@ Import domain classes directly from each store package and compose them:
 
 ```typescript
 import { MastraStorage } from "@mastra/core/storage";
-import { MemoryPG, WorkflowsPG, ScoresPG } from "@mastra/pg";
+import { WorkflowsPG, ScoresPG } from "@mastra/pg";
 import { MemoryLibSQL } from "@mastra/libsql";
 import { Mastra } from "@mastra/core";
 
@@ -161,6 +173,9 @@ const mastra = new Mastra({
 If using storage directly, call `init()` explicitly:
 
 ```typescript
+import { MastraStorage } from "@mastra/core/storage";
+import { MemoryPG } from "@mastra/pg";
+
 const storage = new MastraStorage({
   id: "composite",
   domains: {
@@ -217,6 +232,8 @@ const storage = new MastraStorage({
     scores: new ScoresPG({ connectionString: process.env.DATABASE_URL }),
     observability: new ObservabilityStorageClickhouse({
       url: process.env.CLICKHOUSE_URL,
+      username: process.env.CLICKHOUSE_USERNAME,
+      password: process.env.CLICKHOUSE_PASSWORD,
     }),
   },
 });

package/CHANGELOG.md

@@ -1,5 +1,12 @@
 # @mastra/mcp-docs-server
 
+## 1.0.0-beta.19
+
+### Patch Changes
+
+- 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)]:
+  - @mastra/core@1.0.0-beta.19
+
 ## 1.0.0-beta.18
 
 ### Patch Changes

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mastra/mcp-docs-server",
-  "version": "1.0.0-beta.18",
+  "version": "1.0.0-beta.19",
   "description": "MCP server for accessing Mastra.ai documentation, changelogs, and news.",
   "type": "module",
   "main": "dist/index.js",
@@ -28,7 +28,7 @@
     "@modelcontextprotocol/sdk": "^1.17.5",
     "jsdom": "^26.1.0",
     "zod": "^3.25.76",
-    "@mastra/core": "1.0.0-beta.18",
+    "@mastra/core": "1.0.0-beta.19",
     "@mastra/mcp": "^1.0.0-beta.7"
   },
   "devDependencies": {
@@ -46,7 +46,7 @@
     "typescript": "^5.8.3",
     "vitest": "4.0.12",
     "@internal/lint": "0.0.53",
-    "@mastra/core": "1.0.0-beta.18"
+    "@mastra/core": "1.0.0-beta.19"
   },
   "homepage": "https://mastra.ai",
   "repository": {