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

package/.docs/raw/auth/auth0.mdx

@@ -8,7 +8,7 @@ import TabItem from "@theme/TabItem";
 
 # MastraAuthAuth0 Class
 
-The `MastraAuthAuth0` class provides authentication for Mastra using Auth0. It verifies incoming requests using Auth0-issued JWT tokens and integrates with the Mastra server using the `experimental_auth` option.
+The `MastraAuthAuth0` class provides authentication for Mastra using Auth0. It verifies incoming requests using Auth0-issued JWT tokens and integrates with the Mastra server using the `auth` option.
 
 ## Prerequisites
 
@@ -41,13 +41,13 @@ npm install @mastra/auth-auth0@latest
 ### Basic usage with environment variables
 
 ```typescript {2,7} title="src/mastra/index.ts" showLineNumbers copy
-import { Mastra } from "@mastra/core/mastra";
+import { Mastra } from "@mastra/core";
 import { MastraAuthAuth0 } from "@mastra/auth-auth0";
 
 export const mastra = new Mastra({
   // ..
   server: {
-    experimental_auth: new MastraAuthAuth0(),
+    auth: new MastraAuthAuth0(),
   },
 });
 ```
@@ -55,13 +55,13 @@ export const mastra = new Mastra({
 ### Custom configuration
 
 ```typescript {2,7-10} title="src/mastra/index.ts" showLineNumbers copy
-import { Mastra } from "@mastra/core/mastra";
+import { Mastra } from "@mastra/core";
 import { MastraAuthAuth0 } from "@mastra/auth-auth0";
 
 export const mastra = new Mastra({
   // ..
   server: {
-    experimental_auth: new MastraAuthAuth0({
+    auth: new MastraAuthAuth0({
       domain: process.env.AUTH0_DOMAIN,
       audience: process.env.AUTH0_AUDIENCE,
     }),
@@ -93,7 +93,7 @@ const auth0Provider = new MastraAuthAuth0({
 });
 ```
 
-> See the [MastraAuthAuth0](/reference/auth/auth0) API reference for all available configuration options.
+> See the [MastraAuthAuth0](/reference/v1/auth/auth0) API reference for all available configuration options.
 
 ## Client-side setup
 
@@ -153,7 +153,7 @@ export const useAuth0Token = () => {
 
 ## Configuring `MastraClient`
 
-When `experimental_auth` is enabled, all requests made with `MastraClient` must include a valid Auth0 access token in the `Authorization` header:
+When `auth` is enabled, all requests made with `MastraClient` must include a valid Auth0 access token in the `Authorization` header:
 
 ```typescript title="lib/mastra/mastra-client.ts" showLineNumbers copy
 import { MastraClient } from "@mastra/client-js";
@@ -170,7 +170,7 @@ export const createMastraClient = (accessToken: string) => {
 
 > **Note:** The access token must be prefixed with `Bearer` in the Authorization header.
 
-> See [Mastra Client SDK](/docs/server-db/mastra-client) for more configuration options.
+> See [Mastra Client SDK](/docs/v1/server-db/mastra-client) for more configuration options.
 
 ### Making authenticated requests
 

package/.docs/raw/auth/clerk.mdx

@@ -8,7 +8,7 @@ import TabItem from "@theme/TabItem";
 
 # MastraAuthClerk Class
 
-The `MastraAuthClerk` class provides authentication for Mastra using Clerk. It verifies incoming requests using Clerk's authentication system and integrates with the Mastra server using the `experimental_auth` option.
+The `MastraAuthClerk` class provides authentication for Mastra using Clerk. It verifies incoming requests using Clerk's authentication system and integrates with the Mastra server using the `auth` option.
 
 ## Prerequisites
 
@@ -33,13 +33,13 @@ npm install @mastra/auth-clerk@latest
 ## Usage example
 
 ```typescript {2,7-11} title="src/mastra/index.ts" showLineNumbers copy
-import { Mastra } from "@mastra/core/mastra";
+import { Mastra } from "@mastra/core";
 import { MastraAuthClerk } from "@mastra/auth-clerk";
 
 export const mastra = new Mastra({
   // ..
   server: {
-    experimental_auth: new MastraAuthClerk({
+    auth: new MastraAuthClerk({
       publishableKey: process.env.CLERK_PUBLISHABLE_KEY,
       secretKey: process.env.CLERK_SECRET_KEY,
       jwksUri: process.env.CLERK_JWKS_URI,
@@ -50,7 +50,7 @@ export const mastra = new Mastra({
 
 > **Note:** The default `authorizeUser` method allows all authenticated users. To customize user authorization, provide a custom `authorizeUser` function when constructing the provider.
 
-> See the [MastraAuthClerk](/reference/auth/clerk) API reference for all available configuration options.
+> See the [MastraAuthClerk](/reference/v1/auth/clerk) API reference for all available configuration options.
 
 ## Client-side setup
 
@@ -79,7 +79,7 @@ export const useClerkAuth = () => {
 
 ## Configuring `MastraClient`
 
-When `experimental_auth` is enabled, all requests made with `MastraClient` must include a valid Clerk access token in the `Authorization` header:
+When `auth` is enabled, all requests made with `MastraClient` must include a valid Clerk access token in the `Authorization` header:
 
 ```typescript {6} title="lib/mastra/mastra-client.ts" showLineNumbers copy
 import { MastraClient } from "@mastra/client-js";
@@ -93,7 +93,7 @@ export const mastraClient = new MastraClient({
 ```
 
 > **Note:** The access token must be prefixed with `Bearer` in the Authorization header.
-> See [Mastra Client SDK](/docs/server-db/mastra-client) for more configuration options.
+> See [Mastra Client SDK](/docs/v1/server-db/mastra-client) for more configuration options.
 
 ### Making authenticated requests
 

package/.docs/raw/auth/firebase.mdx

@@ -8,7 +8,7 @@ import TabItem from "@theme/TabItem";
 
 # MastraAuthFirebase Class
 
-The `MastraAuthFirebase` class provides authentication for Mastra using Firebase Authentication. It verifies incoming requests using Firebase ID tokens and integrates with the Mastra server using the `experimental_auth` option.
+The `MastraAuthFirebase` class provides authentication for Mastra using Firebase Authentication. It verifies incoming requests using Firebase ID tokens and integrates with the Mastra server using the `auth` option.
 
 ## Prerequisites
 
@@ -43,14 +43,14 @@ npm install @mastra/auth-firebase@latest
 If you set the required environment variables (`FIREBASE_SERVICE_ACCOUNT` and `FIRESTORE_DATABASE_ID`), you can initialize `MastraAuthFirebase` without any constructor arguments. The class will automatically read these environment variables as configuration:
 
 ```typescript {2,7} title="src/mastra/index.ts" showLineNumbers copy
-import { Mastra } from "@mastra/core/mastra";
+import { Mastra } from "@mastra/core";
 import { MastraAuthFirebase } from "@mastra/auth-firebase";
 
 // Automatically uses FIREBASE_SERVICE_ACCOUNT and FIRESTORE_DATABASE_ID env vars
 export const mastra = new Mastra({
   // ..
   server: {
-    experimental_auth: new MastraAuthFirebase(),
+    auth: new MastraAuthFirebase(),
   },
 });
 ```
@@ -58,13 +58,13 @@ export const mastra = new Mastra({
 ### Custom configuration
 
 ```typescript {2,7-10} title="src/mastra/index.ts" showLineNumbers copy
-import { Mastra } from "@mastra/core/mastra";
+import { Mastra } from "@mastra/core";
 import { MastraAuthFirebase } from "@mastra/auth-firebase";
 
 export const mastra = new Mastra({
   // ..
   server: {
-    experimental_auth: new MastraAuthFirebase({
+    auth: new MastraAuthFirebase({
       serviceAccount: "/path/to/service-account.json",
       databaseId: "your-database-id",
     }),
@@ -106,7 +106,7 @@ const firebaseAuth = new MastraAuthFirebase({
 });
 ```
 
-> See the [MastraAuthFirebase](/reference/auth/firebase) API reference for all available configuration options.
+> See the [MastraAuthFirebase](/reference/v1/auth/firebase) API reference for all available configuration options.
 
 ## Client-side setup
 
@@ -173,7 +173,7 @@ export const signOutUser = async () => {
 
 ## Configuring `MastraClient`
 
-When `experimental_auth` is enabled, all requests made with `MastraClient` must include a valid Firebase ID token in the `Authorization` header:
+When `auth` is enabled, all requests made with `MastraClient` must include a valid Firebase ID token in the `Authorization` header:
 
 ```typescript {6} title="lib/mastra/mastra-client.ts" showLineNumbers copy
 import { MastraClient } from "@mastra/client-js";
@@ -190,7 +190,7 @@ export const createMastraClient = (idToken: string) => {
 
 > **Note:** The ID token must be prefixed with `Bearer` in the Authorization header.
 
-> See [Mastra Client SDK](/docs/server-db/mastra-client) for more configuration options.
+> See [Mastra Client SDK](/docs/v1/server-db/mastra-client) for more configuration options.
 
 ### Making authenticated requests
 

package/.docs/raw/auth/index.mdx

@@ -11,9 +11,9 @@ You can start with simple shared secret JWT authentication and switch to provide
 
 ## Available providers
 
-- [JSON Web Token (JWT)](/docs/auth/jwt)
-- [Clerk](/docs/auth/clerk)
-- [Supabase](/docs/auth/supabase)
-- [Firebase](/docs/auth/firebase)
-- [WorkOS](/docs/auth/workos)
-- [Auth0](/docs/auth/auth0)
+- [JSON Web Token (JWT)](/docs/v1/auth/jwt)
+- [Clerk](/docs/v1/auth/clerk)
+- [Supabase](/docs/v1/auth/supabase)
+- [Firebase](/docs/v1/auth/firebase)
+- [WorkOS](/docs/v1/auth/workos)
+- [Auth0](/docs/v1/auth/auth0)

package/.docs/raw/auth/jwt.mdx

@@ -8,7 +8,7 @@ import TabItem from "@theme/TabItem";
 
 # MastraJwtAuth Class
 
-The `MastraJwtAuth` class provides a lightweight authentication mechanism for Mastra using JSON Web Tokens (JWTs). It verifies incoming requests based on a shared secret and integrates with the Mastra server using the `experimental_auth` option.
+The `MastraJwtAuth` class provides a lightweight authentication mechanism for Mastra using JSON Web Tokens (JWTs). It verifies incoming requests based on a shared secret and integrates with the Mastra server using the `auth` option.
 
 ## Installation
 
@@ -21,24 +21,24 @@ npm install @mastra/auth@latest
 ## Usage example
 
 ```typescript {2,7-9} title="src/mastra/index.ts" showLineNumbers copy
-import { Mastra } from "@mastra/core/mastra";
+import { Mastra } from "@mastra/core";
 import { MastraJwtAuth } from "@mastra/auth";
 
 export const mastra = new Mastra({
   // ..
   server: {
-    experimental_auth: new MastraJwtAuth({
+    auth: new MastraJwtAuth({
       secret: process.env.MASTRA_JWT_SECRET,
     }),
   },
 });
 ```
 
-> See the [MastraJwtAuth](/reference/auth/jwt) API reference for all available configuration options.
+> See the [MastraJwtAuth](/reference/v1/auth/jwt) API reference for all available configuration options.
 
 ## Configuring `MastraClient`
 
-When `experimental_auth` is enabled, all requests made with `MastraClient` must include a valid JWT in the `Authorization` header:
+When `auth` is enabled, all requests made with `MastraClient` must include a valid JWT in the `Authorization` header:
 
 ```typescript {6} title="lib/mastra/mastra-client.ts" showLineNumbers copy
 import { MastraClient } from "@mastra/client-js";
@@ -51,7 +51,7 @@ export const mastraClient = new MastraClient({
 });
 ```
 
-> See [Mastra Client SDK](/docs/server-db/mastra-client) for more configuration options.
+> See [Mastra Client SDK](/docs/v1/server-db/mastra-client) for more configuration options.
 
 ### Making authenticated requests
 

package/.docs/raw/auth/supabase.mdx

@@ -8,7 +8,7 @@ import TabItem from "@theme/TabItem";
 
 # MastraAuthSupabase Class
 
-The `MastraAuthSupabase` class provides authentication for Mastra using Supabase Auth. It verifies incoming requests using Supabase's authentication system and integrates with the Mastra server using the `experimental_auth` option.
+The `MastraAuthSupabase` class provides authentication for Mastra using Supabase Auth. It verifies incoming requests using Supabase's authentication system and integrates with the Mastra server using the `auth` option.
 
 ## Prerequisites
 
@@ -32,13 +32,13 @@ npm install @mastra/auth-supabase@latest
 ## Usage example
 
 ```typescript {2,7-9} title="src/mastra/index.ts" showLineNumbers copy
-import { Mastra } from "@mastra/core/mastra";
+import { Mastra } from "@mastra/core";
 import { MastraAuthSupabase } from "@mastra/auth-supabase";
 
 export const mastra = new Mastra({
   // ..
   server: {
-    experimental_auth: new MastraAuthSupabase({
+    auth: new MastraAuthSupabase({
       url: process.env.SUPABASE_URL,
       anonKey: process.env.SUPABASE_ANON_KEY,
     }),
@@ -48,7 +48,7 @@ export const mastra = new Mastra({
 
 > **Note:** The default `authorizeUser` method checks the `isAdmin` column in the `users` table in the `public` schema. To customize user authorization, provide a custom `authorizeUser` function when constructing the provider.
 
-> See the [MastraAuthSupabase](/reference/auth/supabase) API reference for all available configuration options.
+> See the [MastraAuthSupabase](/reference/v1/auth/supabase) API reference for all available configuration options.
 
 ## Client-side setup
 
@@ -75,7 +75,7 @@ const accessToken = authTokenResponse.data?.session?.access_token;
 
 ## Configuring `MastraClient`
 
-When `experimental_auth` is enabled, all requests made with `MastraClient` must include a valid Supabase access token in the `Authorization` header:
+When `auth` is enabled, all requests made with `MastraClient` must include a valid Supabase access token in the `Authorization` header:
 
 ```typescript {6} title="lib/mastra/mastra-client.ts" showLineNumbers copy
 import { MastraClient } from "@mastra/client-js";
@@ -90,14 +90,14 @@ export const mastraClient = new MastraClient({
 
 > **Note:** The access token must be prefixed with `Bearer` in the Authorization header.
 
-> See [Mastra Client SDK](/docs/server-db/mastra-client) for more configuration options.
+> See [Mastra Client SDK](/docs/v1/server-db/mastra-client) for more configuration options.
 
 ### Making authenticated requests
 
 Once `MastraClient` is configured with the Supabase access token, you can send authenticated requests:
 
 <Tabs>
-  <TabItem value="react" label="React">
+    <TabItem value="react" label="React">
     ```tsx title="src/components/test-agent.tsx" showLineNumbers copy
     import { mastraClient } from "../../lib/mastra-client";
 

package/.docs/raw/auth/workos.mdx

@@ -8,7 +8,7 @@ import TabItem from "@theme/TabItem";
 
 # MastraAuthWorkos Class
 
-The `MastraAuthWorkos` class provides authentication for Mastra using WorkOS. It verifies incoming requests using WorkOS access tokens and integrates with the Mastra server using the `experimental_auth` option.
+The `MastraAuthWorkos` class provides authentication for Mastra using WorkOS. It verifies incoming requests using WorkOS access tokens and integrates with the Mastra server using the `auth` option.
 
 ## Prerequisites
 
@@ -41,13 +41,13 @@ npm install @mastra/auth-workos@latest
 ### Basic usage with environment variables
 
 ```typescript {2,7} title="src/mastra/index.ts" showLineNumbers copy
-import { Mastra } from "@mastra/core/mastra";
+import { Mastra } from "@mastra/core";
 import { MastraAuthWorkos } from "@mastra/auth-workos";
 
 export const mastra = new Mastra({
   // ..
   server: {
-    experimental_auth: new MastraAuthWorkos(),
+    auth: new MastraAuthWorkos(),
   },
 });
 ```
@@ -55,13 +55,13 @@ export const mastra = new Mastra({
 ### Custom configuration
 
 ```typescript {2,7-10} title="src/mastra/index.ts" showLineNumbers copy
-import { Mastra } from "@mastra/core/mastra";
+import { Mastra } from "@mastra/core";
 import { MastraAuthWorkos } from "@mastra/auth-workos";
 
 export const mastra = new Mastra({
   // ..
   server: {
-    experimental_auth: new MastraAuthWorkos({
+    auth: new MastraAuthWorkos({
       apiKey: process.env.WORKOS_API_KEY,
       clientId: process.env.WORKOS_CLIENT_ID,
     }),
@@ -94,7 +94,7 @@ const workosAuth = new MastraAuthWorkos({
 });
 ```
 
-> See the [MastraAuthWorkos](/reference/auth/workos) API reference for all available configuration options.
+> See the [MastraAuthWorkos](/reference/v1/auth/workos) API reference for all available configuration options.
 
 ## Client-side setup
 
@@ -135,7 +135,7 @@ export const authenticateWithWorkos = async (
 
 ## Configuring `MastraClient`
 
-When `experimental_auth` is enabled, all requests made with `MastraClient` must include a valid WorkOS access token in the `Authorization` header:
+When `auth` is enabled, all requests made with `MastraClient` must include a valid WorkOS access token in the `Authorization` header:
 
 ```typescript title="lib/mastra/mastra-client.ts" showLineNumbers copy
 import { MastraClient } from "@mastra/client-js";
@@ -152,7 +152,7 @@ export const createMastraClient = (accessToken: string) => {
 
 > **Note:** The access token must be prefixed with `Bearer` in the Authorization header.
 
-> See [Mastra Client SDK](/docs/server-db/mastra-client) for more configuration options.
+> See [Mastra Client SDK](/docs/v1/server-db/mastra-client) for more configuration options.
 
 ### Making authenticated requests
 

package/.docs/raw/community/contributing-templates.mdx

@@ -13,8 +13,8 @@ The Mastra community plays a vital role in creating templates that showcase inno
 
 Before creating a template, ensure you understand:
 
-- [Templates Reference](/reference/templates/overview) - Technical requirements and conventions
-- [Project Structure](/docs/getting-started/project-structure) - Standard Mastra project organization
+- [Templates Reference](/reference/v1/templates/overview) - Technical requirements and conventions
+- [Project Structure](/docs/v1/getting-started/project-structure) - Standard Mastra project organization
 - Community guidelines and quality standards
 
 ### 2. Develop Your Template
@@ -56,7 +56,7 @@ Templates must meet these quality benchmarks:
 
 ### 1. Prepare Your Template
 
-Ensure your template meets all requirements outlined in the [Templates Reference](/reference/templates/overview):
+Ensure your template meets all requirements outlined in the [Templates Reference](/reference/v1/templates/overview):
 
 - Proper project structure in `src/mastra/` directory
 - Standard TypeScript configuration

package/.docs/raw/community/discord.mdx

@@ -9,4 +9,4 @@ The Discord server has over 1000 members and serves as the main discussion forum
 
 ## Discord MCP Bot
 
-In addition to community members, we have an (experimental!) Discord bot that can also help answer questions. It uses [Model Context Protocol (MCP)](/docs/tools-mcp/mcp-overview). You can ask it a question with `/ask` (either in public channels or DMs) and clear history (in DMs only) with `/cleardm`.
+In addition to community members, we have an (experimental!) Discord bot that can also help answer questions. It uses [Model Context Protocol (MCP)](/docs/v1/tools-mcp/mcp-overview). You can ask it a question with `/ask` (either in public channels or DMs) and clear history (in DMs only) with `/cleardm`.

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/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/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

@@ -16,7 +16,7 @@ Deploy your Mastra applications to Amazon EC2 (Elastic Cloud Compute).
 This guide assumes your Mastra application has been created using the default
 `npx create-mastra@latest` 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)