@mastra/mcp-docs-server 0.13.39 → 1.0.0-beta.1

package/.docs/raw/course/01-first-agent/08-exporting-your-agent.md

@@ -5,7 +5,7 @@ To make your agent available to the playground, you need to export it through th
 First, import the necessary dependencies and your agent:
 
 ```typescript
-import { Mastra } from "@mastra/core/mastra";
+import { Mastra } from "@mastra/core";
 import { PinoLogger } from "@mastra/loggers";
 import { LibSQLStore } from "@mastra/libsql";
 import { financialAgent } from "./agents/financial-agent";
@@ -15,6 +15,7 @@ export const mastra = new Mastra({
     financialAgent,
   },
   storage: new LibSQLStore({
+    id: "learning-memory-storage",
     url: ":memory:",
   }),
   logger: new PinoLogger({

package/.docs/raw/course/01-first-agent/16-adding-memory-to-agent.md

@@ -5,7 +5,7 @@ Now, let's update our agent to include memory. Open your `agents/index.ts` file
 1. Import the Memory and LibSQLStore classes:
 
 ```typescript
-import { Agent } from "@mastra/core";
+import { Agent } from "@mastra/core/agent";
 import { openai } from "@ai-sdk/openai";
 import { Memory } from "@mastra/memory";
 import { LibSQLStore } from "@mastra/libsql";
@@ -24,6 +24,7 @@ export const financialAgent = new Agent({
   tools: { getTransactionsTool },
   memory: new Memory({
     storage: new LibSQLStore({
+      id: "learning-memory-storage",
       url: "file:../../memory.db", // local file-system database. Location is relative to the output directory `.mastra/output`
     }),
   }), // Add memory here

package/.docs/raw/course/02-agent-tools-mcp/02-installing-mcp.md

@@ -3,7 +3,7 @@
 First, let's install the Mastra MCP package:
 
 ```bash
-npm install @mastra/mcp@latest
+npm install @mastra/mcp@beta
 ```
 
 The `@mastra/mcp` package provides the necessary infrastructure to connect your Mastra agent to various MCP servers. This package handles the communication between your agent and the MCP servers, allowing your agent to access the tools and services provided by those servers.

package/.docs/raw/course/02-agent-tools-mcp/31-enhancing-memory-configuration.md

@@ -7,9 +7,11 @@ import { LibSQLStore, LibSQLVector } from "@mastra/libsql";
 
 const memory = new Memory({
   storage: new LibSQLStore({
+    id: "learning-memory-storage",
     url: "file:../../memory.db",
   }),
   vector: new LibSQLVector({
+    id: "learning-memory-vector",
     connectionUrl: "file:../../memory.db",
   }),
   embedder: openai.embedding("text-embedding-3-small"),

package/.docs/raw/course/03-agent-memory/03-installing-memory.md

@@ -3,7 +3,7 @@
 Let's start by installing the Mastra memory package:
 
 ```bash
-npm install @mastra/memory @mastra/libsql
+npm install @mastra/memory@beta @mastra/libsql@beta
 ```
 
 The `@mastra/memory` package provides all the functionality you need to add memory capabilities to your Mastra agents. It includes support for conversation history, semantic recall, and working memory.

package/.docs/raw/course/03-agent-memory/04-creating-basic-memory-agent.md

@@ -13,6 +13,7 @@ import { openai } from "@ai-sdk/openai";
 // Create a basic memory instance
 const memory = new Memory({
   storage: new LibSQLStore({
+    id: "learning-memory-storage",
     url: "file:../../memory.db", // relative path from the `.mastra/output` directory
   }),
 });

package/.docs/raw/course/03-agent-memory/10-storage-configuration.md

@@ -9,9 +9,8 @@ import { LibSQLStore } from "@mastra/libsql";
 const memory = new Memory({
   // Configure storage
   storage: new LibSQLStore({
-    config: {
-      url: "file:../../memory.db", // Local database. Relative to the output folder
-    },
+    id: "learning-memory-storage",
+    url: "file:../../memory.db", // Local database. Relative to the output folder
   }),
   options: {
     lastMessages: 20,

package/.docs/raw/course/03-agent-memory/13-vector-store-configuration.md

@@ -8,9 +8,11 @@ import { LibSQLStore, LibSQLVector } from "@mastra/libsql";
 
 const memory = new Memory({
   storage: new LibSQLStore({
+    id: "learning-memory-storage",
     url: "file:../../memory.db", // relative path from the `.mastra/output` directory
   }),
   vector: new LibSQLVector({
+    id: "learning-memory-vector",
     connectionUrl: "file:../../vector.db", // relative path from the `.mastra/output` directory
   }),
 });

package/.docs/raw/course/03-agent-memory/16-configuring-semantic-recall.md

@@ -11,9 +11,11 @@ import { LibSQLStore, LibSQLVector } from "@mastra/libsql";
 // Create a memory instance with semantic recall configuration
 const memory = new Memory({
   storage: new LibSQLStore({
+    id: "learning-memory-storage",
     url: "file:../../memory.db", // relative path from the `.mastra/output` directory
   }), // Storage for message history
   vector: new LibSQLVector({
+    id: "learning-memory-vector",
     connectionUrl: "file:../../vector.db", // relative path from the `.mastra/output` directory
   }), // Vector database for semantic search
   embedder: openai.embedding("text-embedding-3-small"), // Embedder for message embeddings

package/.docs/raw/course/03-agent-memory/18-advanced-configuration-semantic-recall.md

@@ -5,6 +5,7 @@ We can configure semantic recall in more detail by setting options for the `sema
 ```typescript
 const memory = new Memory({
   storage: new LibSQLStore({
+    id: "learning-memory-storage",
     url: "file:../../memory.db", // relative path from the `.mastra/output` directory
   }),
   vector: new LibSQLVector({

package/.docs/raw/course/03-agent-memory/21-configuring-working-memory.md

@@ -11,9 +11,11 @@ import { LibSQLStore, LibSQLVector } from "@mastra/libsql";
 // Create a memory instance with working memory configuration
 const memory = new Memory({
   storage: new LibSQLStore({
+    id: "learning-memory-storage",
     url: "file:../../memory.db", // relative path from the `.mastra/output` directory
   }), // Storage for message history
   vector: new LibSQLVector({
+    id: "learning-memory-vector",
     connectionUrl: "file:../../vector.db", // relative path from the `.mastra/output` directory
   }), // Vector database for semantic search
   embedder: openai.embedding("text-embedding-3-small"), // Embedder for message embeddings

package/.docs/raw/course/03-agent-memory/22-custom-working-memory-templates.md

@@ -12,6 +12,7 @@ import { openai } from "@ai-sdk/openai";
 // Create a memory instance with a custom working memory template
 const memory = new Memory({
   storage: new LibSQLStore({
+    id: "learning-memory-storage",
     url: "file:../../memory.db", // relative path from the `.mastra/output` directory
   }), // Storage for message history
   vector: new LibSQLVector({

package/.docs/raw/course/03-agent-memory/25-combining-memory-features.md

@@ -16,6 +16,7 @@ import { LibSQLStore, LibSQLVector } from "@mastra/libsql";
 // Create a comprehensive memory configuration
 const memory = new Memory({
   storage: new LibSQLStore({
+    id: "learning-memory-storage",
     url: "file:../../memory.db", // relative path from the `.mastra/output` directory
   }),
   vector: new LibSQLVector({

package/.docs/raw/course/03-agent-memory/27-creating-learning-assistant.md

@@ -12,6 +12,7 @@ import { LibSQLStore, LibSQLVector } from "@mastra/libsql";
 // Create a specialized memory configuration for the learning assistant
 const learningMemory = new Memory({
   storage: new LibSQLStore({
+    id: "learning-memory-storage",
     url: "file:../../memory.db", // relative path from the `.mastra/output` directory
   }),
   vector: new LibSQLVector({

package/.docs/raw/course/04-workflows/08-running-workflows-programmatically.md

@@ -22,7 +22,7 @@ async function runContentWorkflow() {
     }
 
     // Create a run instance
-    const run = await workflow.createRunAsync();
+    const run = await workflow.createRun();
 
     // Execute with test data
     const result = await run.start({
@@ -63,7 +63,7 @@ npx tsx src/run-workflow.ts
 ## Key Methods
 
 - **`mastra.getWorkflow(id)`**: Gets a registered workflow by ID
-- **`workflow.createRunAsync()`**: Creates a new execution instance
+- **`workflow.createRun()`**: Creates a new execution instance
 - **`run.start(inputData)`**: Executes the workflow with provided data
 
 ## Return Value

package/.docs/raw/deployment/cloud-providers/amazon-ec2.mdx

@@ -14,9 +14,9 @@ Deploy your Mastra applications to Amazon EC2 (Elastic Cloud Compute).
 
 :::note
 This guide assumes your Mastra application has been created using the default
-`npx create-mastra@latest` command.
+`npx create-mastra@beta` command.
 For more information on how to create a new Mastra application,
-refer to our [getting started guide](/docs/getting-started/installation)
+refer to our [getting started guide](/docs/v1/getting-started/installation)
 :::
 
 ## Prerequisites
@@ -26,7 +26,7 @@ refer to our [getting started guide](/docs/getting-started/installation)
 - A domain name with an A record pointing to your instance
 - A reverse proxy configured (e.g., using [nginx](https://nginx.org/))
 - SSL certificate configured (e.g., using [Let's Encrypt](https://letsencrypt.org/))
-- Node.js 18+ installed on your instance
+- Node.js 22.13.0 or later installed on your instance
 
 ## Deployment Steps
 
@@ -104,7 +104,7 @@ npm run build
 Run the application:
 
 ```bash copy
-node --import=./.mastra/output/instrumentation.mjs --env-file=".env" .mastra/output/index.mjs
+node --env-file=".env" .mastra/output/index.mjs
 ```
 
 :::note
@@ -119,7 +119,7 @@ Your Mastra application will run on port 4111 by default. Ensure your reverse pr
 
 You can now connect to your Mastra server from your client application using a `MastraClient` from the `@mastra/client-js` package.
 
-Refer to the [`MastraClient` documentation](/reference/client-js/mastra-client) for more information.
+Refer to the [`MastraClient` documentation](/reference/v1/client-js/mastra-client) for more information.
 
 ```typescript copy showLineNumbers
 import { MastraClient } from "@mastra/client-js";
@@ -131,4 +131,4 @@ const mastraClient = new MastraClient({
 
 ## Next steps
 
-- [Mastra Client SDK](/reference/client-js/mastra-client)
+- [Mastra Client SDK](/reference/v1/client-js/mastra-client)

package/.docs/raw/deployment/cloud-providers/aws-lambda.mdx

@@ -13,9 +13,9 @@ This approach allows you to run your Mastra server as a containerized Lambda fun
 
 :::note
 This guide assumes your Mastra application has been created using the default
-`npx create-mastra@latest` command.
+`npx create-mastra@beta` command.
 For more information on how to create a new Mastra application,
-refer to our [getting started guide](/docs/getting-started/installation)
+refer to our [getting started guide](/docs/v1/getting-started/installation)
 :::
 
 ## Prerequisites
@@ -44,6 +44,7 @@ Lambda functions have limitations with file system storage. Configure your Mastr
 import { LibSQLStore } from "@mastra/libsql";
 
 const storage = new LibSQLStore({
+  id: 'mastra-storage',
   url: ":memory:", // in-memory storage
 });
 ```
@@ -56,12 +57,13 @@ For persistent memory across Lambda invocations, use external storage providers
 import { LibSQLStore } from "@mastra/libsql";
 
 const storage = new LibSQLStore({
+  id: 'mastra-storage',
   url: "libsql://your-database.turso.io", // External Turso database
   authToken: process.env.TURSO_AUTH_TOKEN,
 });
 ```
 
-For more memory configuration options, see the [Memory documentation](/docs/memory/overview).
+For more memory configuration options, see the [Memory documentation](/docs/v1/memory/overview).
 
 ## Creating a Dockerfile
 
@@ -90,7 +92,7 @@ ENV READINESS_CHECK_PATH="/api"
 
 EXPOSE 8080
 
-CMD ["node", "--import=./.mastra/output/instrumentation.mjs", ".mastra/output/index.mjs"]
+CMD ["node", ".mastra/output/index.mjs"]
 ```
 
 ## Building and Deploying
@@ -214,7 +216,7 @@ Once deployed, test your Lambda function:
 2. Visit the URL in your browser to see your Mastra's server home screen
 3. Test your agents and workflows using the generated API endpoints
 
-For more information about available API endpoints, see the [Server documentation](/docs/deployment/server-deployment).
+For more information about available API endpoints, see the [Server documentation](/docs/v1/deployment/server-deployment).
 
 ## Connecting your client
 
@@ -287,6 +289,6 @@ For production deployments:
 
 ## Next steps
 
-- [Mastra Client SDK](/reference/client-js/mastra-client)
+- [Mastra Client SDK](/reference/v1/client-js/mastra-client)
 - [AWS Lambda documentation](https://docs.aws.amazon.com/lambda/)
 - [AWS Lambda Web Adapter](https://github.com/awslabs/aws-lambda-web-adapter)

package/.docs/raw/deployment/cloud-providers/azure-app-services.mdx

@@ -12,16 +12,16 @@ Deploy your Mastra applications to Azure App Services.
 
 :::note
 This guide assumes your Mastra application has been created using the default
-`npx create-mastra@latest` command.
+`npx create-mastra@beta` command.
 For more information on how to create a new Mastra application,
-refer to our [getting started guide](/docs/getting-started/installation)
+refer to our [getting started guide](/docs/v1/getting-started/installation)
 :::
 
 ## Prerequisites
 
 - An [Azure account](https://azure.microsoft.com/) with an active subscription
 - A [GitHub repository](https://github.com/) containing your Mastra application
-- Your Mastra application should be created using `npx create-mastra@latest`
+- Your Mastra application should be created using `npx create-mastra@beta`
 
 ## Deployment Steps
 
@@ -141,7 +141,7 @@ Access your deployed application:
 
 You can now connect to your Mastra server from your client application using a `MastraClient` from the `@mastra/client-js` package.
 
-Refer to the [`MastraClient` documentation](/reference/client-js/mastra-client) for more information.
+Refer to the [`MastraClient` documentation](/reference/v1/client-js/mastra-client) for more information.
 
 ```typescript copy showLineNumbers
 import { MastraClient } from "@mastra/client-js";
@@ -159,7 +159,7 @@ such as `LibSQLStore` with a file URL. Consider using cloud-based storage soluti
 
 ## Next steps
 
-- [Mastra Client SDK](/reference/client-js/mastra-client)
+- [Mastra Client SDK](/reference/v1/client-js/mastra-client)
 - [Configure custom domains](https://docs.microsoft.com/en-us/azure/app-service/app-service-web-tutorial-custom-domain)
 - [Enable HTTPS](https://docs.microsoft.com/en-us/azure/app-service/configure-ssl-bindings)
 - [Azure App Service documentation](https://docs.microsoft.com/en-us/azure/app-service/)

package/.docs/raw/deployment/cloud-providers/digital-ocean.mdx

@@ -14,7 +14,7 @@ Deploy your Mastra applications to Digital Ocean's App Platform and Droplets.
 
 :::note
 This guide assumes your Mastra application has been created using the default
-`npx create-mastra@latest` command.
+`npx create-mastra@beta` command.
 For more information on how to create a new Mastra application,
 refer to our [getting started guide](./../../getting-started/installation)
 :::
@@ -119,7 +119,7 @@ Deploy your Mastra application to Digital Ocean's Droplets.
 - A domain name with an A record pointing to your droplet
 - A reverse proxy configured (e.g., using [nginx](https://nginx.org/))
 - SSL certificate configured (e.g., using [Let's Encrypt](https://letsencrypt.org/))
-- Node.js 18+ installed on your droplet
+- Node.js 22.13.0 or later installed on your droplet
 
 ### Deployment Steps
 
@@ -201,7 +201,7 @@ npm run build
 Run the application
 
 ```bash copy
-node --import=./.mastra/output/instrumentation.mjs --env-file=".env" .mastra/output/index.mjs
+node --env-file=".env" .mastra/output/index.mjs
 ```
 
 :::note
@@ -220,7 +220,7 @@ Your Mastra application will run on port 4111 by default. Ensure your reverse pr
 
 You can now connect to your Mastra server from your client application using a `MastraClient` from the `@mastra/client-js` package.
 
-Refer to the [`MastraClient` documentation](/docs/server-db/mastra-client) for more information.
+Refer to the [`MastraClient` documentation](/docs/v1/server-db/mastra-client) for more information.
 
 ```typescript copy showLineNumbers
 import { MastraClient } from "@mastra/client-js";
@@ -232,6 +232,6 @@ const mastraClient = new MastraClient({
 
 ## Next steps
 
-- [Mastra Client SDK](/reference/client-js/mastra-client)
+- [Mastra Client SDK](/reference/v1/client-js/mastra-client)
 - [Digital Ocean App Platform documentation](https://docs.digitalocean.com/products/app-platform/)
 - [Digital Ocean Droplets documentation](https://docs.digitalocean.com/products/droplets/)

package/.docs/raw/deployment/cloud-providers/index.mdx

@@ -7,19 +7,19 @@ description: "Deploy your Mastra applications to popular cloud providers."
 
 Standalone Mastra applications can be deployed to popular cloud providers, see one of the following guides for more information:
 
-- [Amazon EC2](/docs/deployment/cloud-providers/amazon-ec2)
-- [AWS Lambda](/docs/deployment/cloud-providers/aws-lambda)
-- [Digital Ocean](/docs/deployment/cloud-providers/digital-ocean)
-- [Azure App Services](/docs/deployment/cloud-providers/azure-app-services)
+- [Amazon EC2](/docs/v1/deployment/cloud-providers/amazon-ec2)
+- [AWS Lambda](/docs/v1/deployment/cloud-providers/aws-lambda)
+- [Digital Ocean](/docs/v1/deployment/cloud-providers/digital-ocean)
+- [Azure App Services](/docs/v1/deployment/cloud-providers/azure-app-services)
 
-For self-hosted Node.js server deployment, see the [Creating A Mastra Server](/docs/deployment/server-deployment) guide.
+For self-hosted Node.js server deployment, see the [Creating A Mastra Server](/docs/v1/deployment/server-deployment) guide.
 
 ## Prerequisites
 
 Before deploying to a cloud provider, ensure you have:
 
-- A [Mastra application](/docs/getting-started/installation)
-- Node.js `v20.0` or higher
+- A [Mastra application](/docs/v1/getting-started/installation)
+- Node.js `v22.13.0` or later
 - A GitHub repository for your application (required for most CI/CD setups)
 - Domain name management access (for SSL and HTTPS)
 - Basic familiarity with server setup (e.g. Nginx, environment variables)
@@ -34,8 +34,9 @@ Specifically, ensure you've removed it from both `src/mastra/index.ts` and `src/
 export const mastra = new Mastra({
   // ...
   storage: new LibSQLStore({
+    id: 'mastra-storage',
     // [!code --]
-    // stores telemetry, evals, ... into memory storage, if it needs to persist, change to file:../mastra.db // [!code --]
+    // stores telemetry, scorer results, ... into memory storage, if it needs to persist, change to file:../mastra.db // [!code --]
     url: ":memory:", // [!code --]
   }), //[!code --]
 });
@@ -43,10 +44,12 @@ export const mastra = new Mastra({
 
 ```typescript title="src/mastra/agents/weather-agent.ts" showLineNumbers
 export const weatherAgent = new Agent({
+  id: "weather-agent",
   // ..
   memory: new Memory({
     // [!code --]
     storage: new LibSQLStore({
+      id: 'mastra-storage',
       // [!code --]
       url: "file:../mastra.db", // path is relative to the .mastra/output directory // [!code --]
     }), // [!code --]

package/.docs/raw/deployment/monorepo.mdx

@@ -66,7 +66,7 @@ Common issues to watch for when deploying Mastra in a monorepo:
 Use `transpilePackages` to compile TypeScript workspace packages or libraries. List package names exactly as they appear in each `package.json`. Use `externals` to exclude dependencies resolved at runtime, and `sourcemap` to emit readable stack traces.
 
 ```typescript title="src/mastra/index.ts" showLineNumbers copy
-import { Mastra } from "@mastra/core/mastra";
+import { Mastra } from "@mastra/core";
 
 export const mastra = new Mastra({
   // ...
@@ -78,7 +78,7 @@ export const mastra = new Mastra({
 });
 ```
 
-> See [Mastra Class](/reference/core/mastra-class) for more configuration options.
+> See [Mastra Class](/reference/v1/core/mastra-class) for more configuration options.
 
 ## Supported monorepos
 

package/.docs/raw/deployment/overview.mdx

@@ -20,7 +20,7 @@ Mastra offers multiple deployment options to suit your application's needs, from
 
 ### Runtime support
 
-- Node.js `v20.0` or higher
+- Node.js `v22.13.0` or later
 - Bun
 - Deno
 - [Cloudflare](../deployment/serverless-platforms/cloudflare-deployer)
@@ -79,4 +79,4 @@ Once your Mastra application is deployed, you'll need to configure your client t
 - Retries and error handling
 - Support for streaming responses
 
-[Client configuration guide →](/docs/server-db/mastra-client)
+[Client configuration guide →](/docs/v1/server-db/mastra-client)

package/.docs/raw/deployment/server-deployment.mdx

@@ -9,7 +9,7 @@ Mastra runs as a standard Node.js server and can be deployed across a wide range
 
 ## Default project structure
 
-The [getting started guide](/docs/getting-started/installation) scaffolds a project with sensible defaults to help you begin quickly. By default, the CLI organizes application files under the `src/mastra/` directory, resulting in a structure similar to the following:
+The [getting started guide](/docs/v1/getting-started/installation) scaffolds a project with sensible defaults to help you begin quickly. By default, the CLI organizes application files under the `src/mastra/` directory, resulting in a structure similar to the following:
 
 ```
 src/
@@ -45,7 +45,7 @@ The build process follows these steps:
 1. **Locates entry file**: Finds `index.ts` or `index.js` in your specified directory (default: `src/mastra/`).
 2. **Creates build directory**: Generates a `.mastra/` directory containing:
    - **`.build`**: Contains dependency analysis, bundled dependencies, and build configuration files.
-   - **`output`**: Contains the production-ready application bundle with `index.mjs`, `instrumentation.mjs`, and project-specific files.
+   - **`output`**: Contains the production-ready application bundle with `index.mjs` and project-specific files.
 3. **Copies static assets**: Copies the `public/` folder contents to the `output` directory for serving static files.
 4. **Bundles code**: Uses Rollup with tree shaking and source maps for optimization.
 5. **Generates server**: Creates a [Hono](https://hono.dev) HTTP server ready for deployment.
@@ -71,11 +71,3 @@ Start the HTTP server:
 ```bash copy
 node .mastra/output/index.mjs
 ```
-
-## Enable Telemetry
-
-To enable telemetry and observability, load the instrumentation file:
-
-```bash copy
-node --import=./.mastra/output/instrumentation.mjs .mastra/output/index.mjs
-```

package/.docs/raw/deployment/serverless-platforms/cloudflare-deployer.mdx

@@ -5,18 +5,18 @@ description: "Learn how to deploy a Mastra application to Cloudflare using the M
 
 # CloudflareDeployer
 
-The `CloudflareDeployer` class handles deployment of standalone Mastra applications to Cloudflare Workers. It manages configuration, deployment, and extends the base [Deployer](/reference/deployer/) class with Cloudflare specific functionality.
+The `CloudflareDeployer` class handles deployment of standalone Mastra applications to Cloudflare Workers. It manages configuration, deployment, and extends the base [Deployer](/reference/v1/deployer/) class with Cloudflare specific functionality.
 
 ## Installation
 
 ```bash copy
-npm install @mastra/deployer-cloudflare@latest
+npm install @mastra/deployer-cloudflare@beta
 ```
 
 ## Usage example
 
 ```typescript title="src/mastra/index.ts" showLineNumbers copy
-import { Mastra } from "@mastra/core/mastra";
+import { Mastra } from "@mastra/core";
 import { CloudflareDeployer } from "@mastra/deployer-cloudflare";
 
 export const mastra = new Mastra({
@@ -30,7 +30,7 @@ export const mastra = new Mastra({
 });
 ```
 
-> See the [CloudflareDeployer](/reference/deployer/cloudflare) API reference for all available configuration options.
+> See the [CloudflareDeployer](/reference/v1/deployer/cloudflare) API reference for all available configuration options.
 
 ## Manual deployment
 
@@ -83,4 +83,4 @@ The `CloudflareDeployer` automatically generates a `wrangler.json` configuration
 
 ## Next steps
 
-- [Mastra Client SDK](/reference/client-js/mastra-client)
+- [Mastra Client SDK](/reference/v1/client-js/mastra-client)

package/.docs/raw/deployment/serverless-platforms/index.mdx

@@ -7,19 +7,19 @@ description: "Build and deploy Mastra applications using platform-specific deplo
 
 Standalone Mastra applications can be deployed to popular serverless platforms using one of our deployer packages:
 
-- [Cloudflare](/docs/deployment/serverless-platforms/cloudflare-deployer)
-- [Netlify](/docs/deployment/serverless-platforms/netlify-deployer)
-- [Vercel](/docs/deployment/serverless-platforms/vercel-deployer)
+- [Cloudflare](/docs/v1/deployment/serverless-platforms/cloudflare-deployer)
+- [Netlify](/docs/v1/deployment/serverless-platforms/netlify-deployer)
+- [Vercel](/docs/v1/deployment/serverless-platforms/vercel-deployer)
 
-Deployers **aren't** required when integrating Mastra with a framework. See [Web Framework Integration](/docs/deployment/web-framework) for more information.
+Deployers **aren't** required when integrating Mastra with a framework. See [Web Framework Integration](/docs/v1/deployment/web-framework) for more information.
 
-For self-hosted Node.js server deployment, see the [Creating A Mastra Server](/docs/deployment/server-deployment) guide.
+For self-hosted Node.js server deployment, see the [Creating A Mastra Server](/docs/v1/deployment/server-deployment) guide.
 
 ## Prerequisites
 
 Before you begin, ensure you have:
 
-- Node.js `v20.0` or higher
+- Node.js `v22.13.0` or later
 - If using a platform-specific deployer:
   - An account with your chosen platform
   - Required API keys or credentials
@@ -34,8 +34,9 @@ Specifically, ensure you've removed it from both `src/mastra/index.ts` and `src/
 export const mastra = new Mastra({
   // ...
   storage: new LibSQLStore({
+    id: 'mastra-storage',
     // [!code --]
-    // stores telemetry, evals, ... into memory storage, if it needs to persist, change to file:../mastra.db // [!code --]
+    // stores telemetry, scorer results, ... into memory storage, if it needs to persist, change to file:../mastra.db // [!code --]
     url: ":memory:", // [!code --]
   }), //[!code --]
 });
@@ -43,10 +44,12 @@ export const mastra = new Mastra({
 
 ```typescript title="src/mastra/agents/weather-agent.ts" showLineNumbers
 export const weatherAgent = new Agent({
+  id: "weather-agent",
   // ..
   memory: new Memory({
     // [!code --]
     storage: new LibSQLStore({
+      id: 'mastra-storage',
       // [!code --]
       url: "file:../mastra.db", // path is relative to the .mastra/output directory // [!code --]
     }), // [!code --]

package/.docs/raw/deployment/serverless-platforms/netlify-deployer.mdx

@@ -5,18 +5,18 @@ description: "Learn how to deploy a Mastra application to Netlify using the Mast
 
 # NetlifyDeployer
 
-The `NetlifyDeployer` class handles deployment of standalone Mastra applications to Netlify. It manages configuration, deployment, and extends the base [Deployer](/reference/deployer/) class with Netlify specific functionality.
+The `NetlifyDeployer` class handles deployment of standalone Mastra applications to Netlify. It manages configuration, deployment, and extends the base [Deployer](/reference/v1/deployer/) class with Netlify specific functionality.
 
 ## Installation
 
 ```bash copy
-npm install @mastra/deployer-netlify@latest
+npm install @mastra/deployer-netlify@beta
 ```
 
 ## Usage example
 
 ```typescript title="src/mastra/index.ts" showLineNumbers copy
-import { Mastra } from "@mastra/core/mastra";
+import { Mastra } from "@mastra/core";
 import { NetlifyDeployer } from "@mastra/deployer-netlify";
 
 export const mastra = new Mastra({
@@ -25,7 +25,7 @@ export const mastra = new Mastra({
 });
 ```
 
-> See the [NetlifyDeployer](/reference/deployer/netlify) API reference for all available configuration options.
+> See the [NetlifyDeployer](/reference/v1/deployer/netlify) API reference for all available configuration options.
 
 ## Continuous integration
 
@@ -82,4 +82,4 @@ The `NetlifyDeployer` automatically generates a `config.json` configuration file
 
 ## Next steps
 
-- [Mastra Client SDK](/reference/client-js/mastra-client)
+- [Mastra Client SDK](/reference/v1/client-js/mastra-client)