@mastra/mcp-docs-server 1.0.0-beta.25 → 1.0.0-beta.27

package/.docs/raw/reference/cli/mastra.mdx

@@ -228,29 +228,45 @@ Do not include example code. Useful when using the `--default` flag.
 
 Configure your code editor with Mastra's MCP server. Choose from: `"cursor" | "cursor-global" | "windsurf" | "vscode"`.
 
+## `mastra migrate`
+
+Runs database migrations to update your storage schema. This command is useful when upgrading Mastra versions that include storage schema changes.
+
+The command bundles your project, connects to your configured storage backend, and executes any pending migrations. Currently supports:
+
+- **Duplicate spans migration**: Removes duplicate `(traceId, spanId)` entries and adds a unique constraint to ensure data integrity.
+
+```bash
+mastra migrate
+```
+
+See the [Storage migration guide](/guides/v1/migrations/upgrade-to-v1/storage#duplicate-spans-migration) for details on when migrations are needed.
+
+It accepts [common flags][common-flags].
+
 ## Common flags
 
 ### `--dir`
 
-**Available in:** `dev`, `build`, `lint`
+**Available in:** `dev`, `build`, `lint`, `migrate`
 
 The path to your Mastra folder. Defaults to `src/mastra`.
 
 ### `--debug`
 
-**Available in:** `dev`, `build`
+**Available in:** `dev`, `build`, `migrate`
 
 Enable verbose logging for Mastra's internals. Defaults to `false`.
 
 ### `--env`
 
-**Available in:** `dev`, `start`, `studio`
+**Available in:** `dev`, `start`, `studio`, `migrate`
 
 Custom environment variables file to include. By default, includes `.env.development`, `.env.local`, and `.env`.
 
 ### `--root`
 
-**Available in:** `dev`, `build`, `lint`
+**Available in:** `dev`, `build`, `lint`, `migrate`
 
 Path to your root folder. Defaults to `process.cwd()`.
 

package/.docs/raw/reference/configuration.mdx

@@ -307,7 +307,7 @@ export const mastra = new Mastra({
 
 ### storage
 
-**Type:** `MastraStorage`
+**Type:** `MastraCompositeStore`
 
 Storage provider for persisting application data. Used by memory, workflows, traces, and other components that require persistence. Mastra supports multiple database backends including PostgreSQL, MongoDB, libSQL, and more.
 

package/.docs/raw/reference/core/getStorage.mdx

@@ -25,7 +25,7 @@ This method does not accept any parameters.
   content={[
     {
       name: "storage",
-      type: "MastraStorage | undefined",
+      type: "MastraCompositeStore | undefined",
       description:
         "The configured storage instance, or undefined if no storage has been configured.",
     },

package/.docs/raw/reference/core/mastra-class.mdx

@@ -59,7 +59,7 @@ Visit the [Configuration reference](/reference/v1/configuration) for detailed do
     },
     {
       name: "storage",
-      type: "MastraStorage",
+      type: "MastraCompositeStore",
       description: "Storage engine instance for persisting data",
       isOptional: true,
     },

package/.docs/raw/reference/core/setStorage.mdx

@@ -7,7 +7,7 @@ packages:
 
 # Mastra.setStorage()
 
-The `.setStorage()` method is used to set the storage instance for the Mastra instance. This method accepts a single `MastraStorage` parameter.
+The `.setStorage()` method is used to set the storage instance for the Mastra instance. This method accepts a single `MastraCompositeStore` parameter.
 
 ## Usage example
 
@@ -26,7 +26,7 @@ mastra.setStorage(
   content={[
     {
       name: "storage",
-      type: "MastraStorage",
+      type: "MastraCompositeStore",
       description: "The storage instance to set for the Mastra instance.",
     },
   ]}

package/.docs/raw/reference/memory/memory-class.mdx

@@ -40,7 +40,7 @@ export const agent = new Agent({
   content={[
     {
       name: "storage",
-      type: "MastraStorage",
+      type: "MastraCompositeStore",
       description:
         'Storage implementation for persisting memory data. Defaults to `new DefaultStorage({ config: { url: "file:memory.db" } })` if not provided.',
       isOptional: true,

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

@@ -10,11 +10,11 @@ packages:
 
 # Composite Storage
 
-`MastraStorage` can compose storage domains from different providers. Use it when you need different databases for different purposes. For example, use LibSQL for memory and PostgreSQL for workflows.
+`MastraCompositeStore` can compose storage domains from different providers. Use it when you need different databases for different purposes. For example, use LibSQL for memory and PostgreSQL for workflows.
 
 ## Installation
 
-`MastraStorage` is included in `@mastra/core`:
+`MastraCompositeStore` is included in `@mastra/core`:
 
 ```bash
 npm install @mastra/core@beta
@@ -45,13 +45,13 @@ Mastra organizes storage into five specialized domains, each handling a specific
 Import domain classes directly from each store package and compose them:
 
 ```typescript title="src/mastra/index.ts"
-import { MastraStorage } from "@mastra/core/storage";
+import { MastraCompositeStore } from "@mastra/core/storage";
 import { WorkflowsPG, ScoresPG } from "@mastra/pg";
 import { MemoryLibSQL } from "@mastra/libsql";
 import { Mastra } from "@mastra/core";
 
 export const mastra = new Mastra({
-  storage: new MastraStorage({
+  storage: new MastraCompositeStore({
     id: "composite",
     domains: {
       memory: new MemoryLibSQL({ url: "file:./local.db" }),
@@ -67,7 +67,7 @@ export const mastra = new Mastra({
 Use `default` to specify a fallback storage, then override specific domains:
 
 ```typescript title="src/mastra/index.ts"
-import { MastraStorage } from "@mastra/core/storage";
+import { MastraCompositeStore } from "@mastra/core/storage";
 import { PostgresStore } from "@mastra/pg";
 import { MemoryLibSQL } from "@mastra/libsql";
 import { Mastra } from "@mastra/core";
@@ -78,7 +78,7 @@ const pgStore = new PostgresStore({
 });
 
 export const mastra = new Mastra({
-  storage: new MastraStorage({
+  storage: new MastraCompositeStore({
     id: "composite",
     default: pgStore,
     domains: {
@@ -100,7 +100,7 @@ export const mastra = new Mastra({
     },
     {
       name: "default",
-      type: "MastraStorage",
+      type: "MastraCompositeStore",
       description:
         "Default storage adapter. Domains not explicitly specified in `domains` will use this storage's domains as fallbacks.",
       isOptional: true,
@@ -154,14 +154,14 @@ export const mastra = new Mastra({
 
 ## Initialization
 
-`MastraStorage` initializes each configured domain independently. When passed to the Mastra class, `init()` is called automatically:
+`MastraCompositeStore` initializes each configured domain independently. When passed to the Mastra class, `init()` is called automatically:
 
 ```typescript title="src/mastra/index.ts"
-import { MastraStorage } from "@mastra/core/storage";
+import { MastraCompositeStore } from "@mastra/core/storage";
 import { MemoryPG, WorkflowsPG, ScoresPG } from "@mastra/pg";
 import { Mastra } from "@mastra/core";
 
-const storage = new MastraStorage({
+const storage = new MastraCompositeStore({
   id: "composite",
   domains: {
     memory: new MemoryPG({ connectionString: process.env.DATABASE_URL }),
@@ -178,10 +178,10 @@ export const mastra = new Mastra({
 If using storage directly, call `init()` explicitly:
 
 ```typescript
-import { MastraStorage } from "@mastra/core/storage";
+import { MastraCompositeStore } from "@mastra/core/storage";
 import { MemoryPG } from "@mastra/pg";
 
-const storage = new MastraStorage({
+const storage = new MastraCompositeStore({
   id: "composite",
   domains: {
     memory: new MemoryPG({ connectionString: process.env.DATABASE_URL }),
@@ -202,11 +202,11 @@ const thread = await memoryStore?.getThreadById({ threadId: "..." });
 Use a local database for development while keeping production data in a managed service:
 
 ```typescript
-import { MastraStorage } from "@mastra/core/storage";
+import { MastraCompositeStore } from "@mastra/core/storage";
 import { MemoryPG, WorkflowsPG, ScoresPG } from "@mastra/pg";
 import { MemoryLibSQL } from "@mastra/libsql";
 
-const storage = new MastraStorage({
+const storage = new MastraCompositeStore({
   id: "composite",
   domains: {
     // Use local SQLite for development, PostgreSQL for production
@@ -225,11 +225,11 @@ const storage = new MastraStorage({
 Use a time-series database for traces while keeping other data in PostgreSQL:
 
 ```typescript
-import { MastraStorage } from "@mastra/core/storage";
+import { MastraCompositeStore } from "@mastra/core/storage";
 import { MemoryPG, WorkflowsPG, ScoresPG } from "@mastra/pg";
 import { ObservabilityStorageClickhouse } from "@mastra/clickhouse";
 
-const storage = new MastraStorage({
+const storage = new MastraCompositeStore({
   id: "composite",
   domains: {
     memory: new MemoryPG({ connectionString: process.env.DATABASE_URL }),

package/CHANGELOG.md

@@ -1,5 +1,19 @@
 # @mastra/mcp-docs-server
 
+## 1.0.0-beta.27
+
+### Patch Changes
+
+- Updated dependencies [[`50fd320`](https://github.com/mastra-ai/mastra/commit/50fd320003d0d93831c230ef531bef41f5ba7b3a)]:
+  - @mastra/core@1.0.0-beta.27
+
+## 1.0.0-beta.26
+
+### Patch Changes
+
+- Updated dependencies [[`026b848`](https://github.com/mastra-ai/mastra/commit/026b8483fbf5b6d977be8f7e6aac8d15c75558ac), [`ffa553a`](https://github.com/mastra-ai/mastra/commit/ffa553a3edc1bd17d73669fba66d6b6f4ac10897)]:
+  - @mastra/core@1.0.0-beta.26
+
 ## 1.0.0-beta.25
 
 ### Patch Changes

package/dist/stdio.js

@@ -191,7 +191,7 @@ function getUpgradeToV1Messages(area) {
    - If "${area}" doesn't end with 's', try adding 's' (e.g., "agent" \u2192 "agents")
 4. If the guide exists, walk me through the changes step by step
 5. If neither form exists, list available migration guides in "upgrade-to-v1/" and suggest which ones might be relevant to "${area}"
-6. After you find the guide, collect all the codemod calls to run to codemods. These callouts are marked with ":::tip[Codemod]" in the docs. Run the codemods with "npx @mastra/codemod@beta <codemod-name> <path>" to automate all those changes. Afterwards, help me with any remaining manual changes needed.`
+6. After you find the guide, collect all the codemod calls to run to codemods. These callouts are marked with ":::tip[Codemod]" in the docs. Run the codemods with "npx @mastra/codemod@latest <codemod-name> <path>" to automate all those changes. Afterwards, help me with any remaining manual changes needed.`
         }
       }
     ];
@@ -207,7 +207,7 @@ function getUpgradeToV1Messages(area) {
 2. First, list all available migration guides with path: "upgrade-to-v1/"
 2. Give me a high-level overview of what changed in each area
 3. Find relevant migration areas to focus on based on my project's codebase and confirm the list with me
-4. After the areas are confirmed, check the migration guides for callouts to codemods. These callouts are marked with ":::tip[Codemod]" in the docs. Run the codemods with "npx @mastra/codemod@beta v1" to automate all those changes. Afterwards, help me with any remaining manual changes needed.
+4. After the areas are confirmed, check the migration guides for callouts to codemods. These callouts are marked with ":::tip[Codemod]" in the docs. Run the codemods with "npx @mastra/codemod@latest v1" to automate all those changes. Afterwards, help me with any remaining manual changes needed.
 
 After the areas are confirmed, we'll go through each one systematically.`
       }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mastra/mcp-docs-server",
-  "version": "1.0.0-beta.25",
+  "version": "1.0.0-beta.27",
   "description": "MCP server for accessing Mastra.ai documentation, changelogs, and news.",
   "type": "module",
   "main": "dist/index.js",
@@ -29,7 +29,7 @@
     "jsdom": "^26.1.0",
     "local-pkg": "^1.1.2",
     "zod": "^3.25.76",
-    "@mastra/core": "1.0.0-beta.25",
+    "@mastra/core": "1.0.0-beta.27",
     "@mastra/mcp": "^1.0.0-beta.10"
   },
   "devDependencies": {
@@ -47,7 +47,7 @@
     "typescript": "^5.9.3",
     "vitest": "4.0.16",
     "@internal/lint": "0.0.53",
-    "@mastra/core": "1.0.0-beta.25"
+    "@mastra/core": "1.0.0-beta.27"
   },
   "homepage": "https://mastra.ai",
   "repository": {