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

package/.docs/organized/code-examples/a2a.md

@@ -180,13 +180,15 @@ import { Agent } from '@mastra/core/agent';
 import { openai } from '@ai-sdk/openai';
 
 export const myAgent = new Agent({
-  name: 'myAgent',
+  id: 'my-agent',
+  name: 'My Agent',
   instructions: 'My Agent Instructions',
   model: openai('gpt-4o'),
 });
 
 export const contentCreatorAgent = new Agent({
-  name: 'contentCreatorAgent',
+  id: 'content-creator-agent',
+  name: 'Content Creator Agent',
   instructions: 'Create engaging content',
   model: openai('gpt-4o'),
 });

package/.docs/organized/code-examples/agui.md

@@ -42,13 +42,14 @@ import { Memory } from '@mastra/memory';
 import { LibSQLStore } from '@mastra/libsql';
 
 export const weatherAgent = new Agent({
+  id: 'weather-agent',
   name: 'Weather Agent',
   instructions: `
       You are a helpful weather assistant that provides accurate weather information.
 
       Your primary function is to help users get weather details for specific locations. When responding:
       - Always ask for a location if none is provided
-      - If the location name isn’t in English, please translate it
+      - If the location name isn't in English, please translate it
       - If giving a location with multiple parts (e.g. "New York, NY"), use the most relevant part (e.g. "New York")
       - Include relevant details like humidity, wind conditions, and precipitation
       - Keep responses concise but informative
@@ -57,6 +58,7 @@ export const weatherAgent = new Agent({
 
   memory: new Memory({
     storage: new LibSQLStore({
+      id: 'agui-storage',
       url: 'file:../mastra.db', // path is relative to the .mastra/output directory
     }),
     options: {
@@ -77,11 +79,11 @@ import { Mastra } from '@mastra/core/mastra';
 import { PinoLogger } from '@mastra/loggers';
 import { LibSQLStore } from '@mastra/libsql';
 import { registerCopilotKit } from '@ag-ui/mastra';
-import { RuntimeContext } from '@mastra/core/runtime-context';
+import { RequestContext } from '@mastra/core/request-context';
 import { weatherAgent } from './agents';
 import { myNetwork } from './network';
 
-type WeatherRuntimeContext = {
+type WeatherRequestContext = {
   'user-id': string;
   'temperature-scale': 'celsius' | 'fahrenheit';
   location: string;
@@ -93,7 +95,8 @@ export const mastra = new Mastra({
     myNetwork,
   },
   storage: new LibSQLStore({
-    // stores telemetry, evals, ... into memory storage, if it needs to persist, change to file:../mastra.db
+    id: 'agui-storage',
+    // stores observability, evals, ... into memory storage, if it needs to persist, change to file:../mastra.db
     url: ':memory:',
   }),
   logger: new PinoLogger({
@@ -107,13 +110,13 @@ export const mastra = new Mastra({
       allowHeaders: ['*'],
     },
     apiRoutes: [
-      registerCopilotKit<WeatherRuntimeContext>({
+      registerCopilotKit<WeatherRequestContext>({
         path: '/copilotkit',
         resourceId: 'weatherAgent',
-        setContext: (c, runtimeContext) => {
-          runtimeContext.set('user-id', c.req.header('X-User-ID') || 'anonymous');
-          runtimeContext.set('temperature-scale', 'celsius');
-          runtimeContext.set('location', c.req.header('X-User-Location') || 'unknown');
+        setContext: (c, requestContext) => {
+          requestContext.set('user-id', c.req.header('X-User-ID') || 'anonymous');
+          requestContext.set('temperature-scale', 'celsius');
+          requestContext.set('location', c.req.header('X-User-Location') || 'unknown');
         },
       }),
     ],

package/.docs/organized/code-examples/ai-sdk-useChat.md

@@ -33,13 +33,14 @@ import { Agent } from '@mastra/core/agent';
 import { weatherTool } from '../tools';
 
 export const weatherAgent = new Agent({
+  id: 'weather-agent',
   name: 'Weather Agent',
   instructions: `
       You are a helpful weather assistant that provides accurate weather information.
 
       Your primary function is to help users get weather details for specific locations. When responding:
       - Always ask for a location if none is provided
-      - If the location name isn’t in English, please translate it
+      - If the location name isn't in English, please translate it
       - If giving a location with multiple parts (e.g. "New York, NY"), use the most relevant part (e.g. "New York")
       - Include relevant details like humidity, wind conditions, and precipitation
       - Keep responses concise but informative
@@ -110,8 +111,8 @@ export const weatherTool = createTool({
     conditions: z.string(),
     location: z.string(),
   }),
-  execute: async ({ context }) => {
-    return await getWeather(context.location);
+  execute: async input => {
+    return await getWeather(inputData.location);
   },
 });
 
@@ -188,6 +189,7 @@ import { z } from 'zod';
 const llm = anthropic('claude-3-5-sonnet-20241022');
 
 const agent = new Agent({
+  id: 'weather-agent',
   name: 'Weather Agent',
   model: llm,
   instructions: `
@@ -241,21 +243,15 @@ const fetchWeather = new Step({
   inputSchema: z.object({
     city: z.string().describe('The city to get the weather for'),
   }),
-  execute: async ({ context }) => {
-    const triggerData = context?.getStepResult<{ city: string }>('trigger');
-
-    if (!triggerData) {
-      throw new Error('Trigger data not found');
-    }
-
-    const geocodingUrl = `https://geocoding-api.open-meteo.com/v1/search?name=${encodeURIComponent(triggerData.city)}&count=1`;
+  execute: async (inputData, context) => {
+    const geocodingUrl = `https://geocoding-api.open-meteo.com/v1/search?name=${encodeURIComponent(inputData.city)}&count=1`;
     const geocodingResponse = await fetch(geocodingUrl);
     const geocodingData = (await geocodingResponse.json()) as {
       results: { latitude: number; longitude: number; name: string }[];
     };
 
     if (!geocodingData.results?.[0]) {
-      throw new Error(`Location '${triggerData.city}' not found`);
+      throw new Error(`Location '${inputData.city}' not found`);
     }
 
     const { latitude, longitude, name } = geocodingData.results[0];
@@ -300,15 +296,13 @@ const planActivities = new Step({
   id: 'plan-activities',
   description: 'Suggests activities based on weather conditions',
   inputSchema: forecastSchema,
-  execute: async ({ context }) => {
-    const forecast = context?.getStepResult<z.infer<typeof forecastSchema>>('fetch-weather');
-
-    if (!forecast || forecast.length === 0) {
+  execute: async (inputData, context) => {
+    if (!inputData || inputData.length === 0) {
       throw new Error('Forecast data not found');
     }
 
-    const prompt = `Based on the following weather forecast for ${forecast[0]?.location}, suggest appropriate activities:
-      ${JSON.stringify(forecast, null, 2)}
+    const prompt = `Based on the following weather forecast for ${inputData[0]?.location}, suggest appropriate activities:
+      ${JSON.stringify(inputData, null, 2)}
       `;
 
     const response = await agent.stream([

package/.docs/organized/code-examples/ai-sdk-v5.md

@@ -44,6 +44,7 @@ import { LibSQLStore } from "@mastra/libsql";
 
 export const memory = new Memory({
   storage: new LibSQLStore({
+    id: "ai-sdk-v5-storage",
     url: `file:./mastra.db`,
   }),
   options: {
@@ -56,6 +57,7 @@ export const memory = new Memory({
 });
 
 export const weatherAgent = new Agent({
+  id: "weather-agent",
   name: "Weather Agent",
   instructions: `
       You are a helpful weather assistant that provides accurate weather information.
@@ -134,8 +136,8 @@ export const weatherTool = createTool({
     conditions: z.string(),
     location: z.string(),
   }),
-  execute: async ({ context }) => {
-    return await getWeather(context.location);
+  execute: async (inputData) => {
+    return await getWeather(inputData.location);
   },
 });
 

package/.docs/organized/code-examples/bird-checker-with-express.md

@@ -177,7 +177,8 @@ import { anthropic } from '@ai-sdk/anthropic';
 import { Agent } from '@mastra/core/agent';
 
 export const birdCheckerAgent = new Agent({
-  name: 'Bird checker',
+  id: 'bird-checker',
+  name: 'Bird Checker',
   instructions:
     'You can view an image and figure out if it is a bird or not. You can also figure out the species of the bird and where the picture was taken.',
   model: anthropic('claude-3-haiku-20240307'),
@@ -188,7 +189,7 @@ export const birdCheckerAgent = new Agent({
 ### mastra/index.ts
 ```typescript
 import { PinoLogger } from '@mastra/loggers';
-import { Mastra } from '@mastra/core';
+import { Mastra } from '@mastra/core/mastra';
 
 import { birdCheckerAgent } from './agents/agent';
 
@@ -215,8 +216,8 @@ export const getRandomImageTool = createTool({
   inputSchema: z.object({
     query: z.enum(['wildlife', 'feathers', 'flying', 'birds']),
   }),
-  execute: async ({ context }) => {
-    return getRandomImage(context);
+  execute: async input => {
+    return getRandomImage(input);
   },
 });
 

package/.docs/organized/code-examples/bird-checker-with-nextjs-and-eval.md

@@ -307,7 +307,8 @@ import { anthropic } from "@ai-sdk/anthropic";
 import { Agent } from "@mastra/core/agent";
 
 export const birdAgent = new Agent({
-  name: "birdAgent",
+  id: "bird-agent",
+  name: "Bird Agent",
   instructions:
     "You can view an image and figure out if it is a bird or not. You can also figure out the species of the bird and where the picture was taken.",
   model: anthropic("claude-3-haiku-20240307"),
@@ -339,8 +340,8 @@ export const getRandomImageTool = createTool({
   inputSchema: z.object({
     query: z.enum(["wildlife", "feathers", "flying", "birds"]),
   }),
-  execute: async ({ context }) => {
-    return getRandomImage(context);
+  execute: async (inputData) => {
+    return getRandomImage(input);
   },
 });
 

package/.docs/organized/code-examples/bird-checker-with-nextjs.md

@@ -202,7 +202,8 @@ import { anthropic } from "@ai-sdk/anthropic";
 import { Agent } from "@mastra/core/agent";
 
 export const birdAgent = new Agent({
-  name: "Bird checker",
+  id: "bird-checker",
+  name: "Bird Checker",
   instructions:
     "You can view an image and figure out if it is a bird or not. You can also figure out the species of the bird and where the picture was taken.",
   model: anthropic("claude-3-haiku-20240307"),
@@ -233,8 +234,8 @@ export const getRandomImageTool = createTool({
   inputSchema: z.object({
     query: z.enum(["wildlife", "feathers", "flying", "birds"]),
   }),
-  execute: async ({ context }) => {
-    return getRandomImage(context);
+  execute: async (inputData) => {
+    return getRandomImage(input);
   },
 });
 

package/.docs/organized/code-examples/client-side-tools.md

@@ -32,6 +32,7 @@ import { openai } from '@ai-sdk/openai';
 import { Agent } from '@mastra/core/agent';
 
 export const agent = new Agent({
+  id: 'test-agent',
   name: 'Test Agent',
   instructions: 'You are a browser client agent. You execute tools in the browser.',
   model: openai('gpt-4o'),

package/.docs/organized/code-examples/crypto-chatbot.md

@@ -37,7 +37,7 @@
     "geist": "^1.3.1",
     "lucide-react": "^0.503.0",
     "next": "^15.4.7",
-    "next-auth": "4.24.11",
+    "next-auth": "4.24.12",
     "next-themes": "^0.4.6",
     "orderedmap": "^2.1.1",
     "pg": "^8.14.1",

package/.docs/organized/code-examples/experimental-auth-weather-agent.md

@@ -29,12 +29,13 @@ import { Agent } from '@mastra/core/agent';
 import { weatherTool } from '../tools';
 
 export const weatherAgent = new Agent({
+  id: 'weather-agent',
   name: 'Weather Agent',
   instructions: `You are a helpful weather assistant that provides accurate weather information.
 
 Your primary function is to help users get weather details for specific locations. When responding:
 - Always ask for a location if none is provided
-- If the location name isn’t in English, please translate it
+- If the location name isn't in English, please translate it
 - If giving a location with multiple parts (e.g. "New York, NY"), use the most relevant part (e.g. "New York")
 - Include relevant details like humidity, wind conditions, and precipitation
 - Keep responses concise but informative
@@ -83,19 +84,17 @@ export const authConfig = getAuthProvider();
 
 ### mastra/index.ts
 ```typescript
-import { Mastra } from '@mastra/core';
+import { Mastra } from '@mastra/core/mastra';
 
 import { weatherAgent } from './agents';
-import { weatherWorkflow as legacyWeatherWorkflow } from './workflows';
-import { weatherWorkflow } from './workflows/new-workflow';
+import { weatherWorkflow } from './workflows';
 import { authConfig } from './auth';
 
 export const mastra = new Mastra({
   agents: { weatherAgent },
-  legacy_workflows: { legacyWeatherWorkflow },
   workflows: { weatherWorkflow },
   server: {
-    experimental_auth: authConfig,
+    auth: authConfig,
   },
 });
 
@@ -133,8 +132,8 @@ export const weatherTool = createTool({
     conditions: z.string(),
     location: z.string(),
   }),
-  execute: async ({ context }) => {
-    return await getWeather(context.location);
+  execute: async input => {
+    return await getWeather(inputData.location);
   },
 });
 
@@ -203,181 +202,13 @@ function getWeatherCondition(code: number): string {
 
 ### mastra/workflows/index.ts
 ```typescript
-import { openai } from '@ai-sdk/openai';
-import { Agent } from '@mastra/core/agent';
-import { Step, Workflow } from '@mastra/core/workflows';
-import { z } from 'zod';
-
-const agent = new Agent({
-  name: 'Weather Agent',
-  instructions: `
-        You are a local activities and travel expert who excels at weather-based planning. Analyze the weather data and provide practical activity recommendations.
-        For each day in the forecast, structure your response exactly as follows:
-        📅 [Day, Month Date, Year]
-        ═══════════════════════════
-        🌡️ WEATHER SUMMARY
-        • Conditions: [brief description]
-        • Temperature: [X°C/Y°F to A°C/B°F]
-        • Precipitation: [X% chance]
-        🌅 MORNING ACTIVITIES
-        Outdoor:
-        • [Activity Name] - [Brief description including specific location/route]
-          Best timing: [specific time range]
-          Note: [relevant weather consideration]
-        🌞 AFTERNOON ACTIVITIES
-        Outdoor:
-        • [Activity Name] - [Brief description including specific location/route]
-          Best timing: [specific time range]
-          Note: [relevant weather consideration]
-        🏠 INDOOR ALTERNATIVES
-        • [Activity Name] - [Brief description including specific venue]
-          Ideal for: [weather condition that would trigger this alternative]
-        ⚠️ SPECIAL CONSIDERATIONS
-        • [Any relevant weather warnings, UV index, wind conditions, etc.]
-        Guidelines:
-        - Suggest 2-3 time-specific outdoor activities per day
-        - Include 1-2 indoor backup options
-        - For precipitation >50%, lead with indoor activities
-        - All activities must be specific to the location
-        - Include specific venues, trails, or locations
-        - Consider activity intensity based on temperature
-        - Keep descriptions concise but informative
-        Maintain this exact formatting for consistency, using the emoji and section headers as shown.
-      `,
-  model: openai('gpt-4o'),
-});
-
-const fetchWeather = new Step({
-  id: 'fetch-weather',
-  description: 'Fetches weather forecast for a given city',
-  inputSchema: z.object({
-    city: z.string().describe('The city to get the weather for'),
-  }),
-  execute: async ({ context }) => {
-    const triggerData = context?.getStepResult<{ city: string }>('trigger');
-
-    if (!triggerData) {
-      throw new Error('Trigger data not found');
-    }
-
-    const geocodingUrl = `https://geocoding-api.open-meteo.com/v1/search?name=${encodeURIComponent(triggerData.city)}&count=1`;
-    const geocodingResponse = await fetch(geocodingUrl);
-    const geocodingData = await geocodingResponse.json();
-
-    if (!geocodingData.results?.[0]) {
-      throw new Error(`Location '${triggerData.city}' not found`);
-    }
-
-    const { latitude, longitude, name } = geocodingData.results[0];
-
-    const weatherUrl = `https://api.open-meteo.com/v1/forecast?latitude=${latitude}&longitude=${longitude}&daily=temperature_2m_max,temperature_2m_min,precipitation_probability_mean,weathercode&timezone=auto`;
-    const response = await fetch(weatherUrl);
-    const data = await response.json();
-
-    const forecast = data.daily.time.map((date: string, index: number) => ({
-      date,
-      maxTemp: data.daily.temperature_2m_max[index],
-      minTemp: data.daily.temperature_2m_min[index],
-      precipitationChance: data.daily.precipitation_probability_mean[index],
-      condition: getWeatherCondition(data.daily.weathercode[index]),
-      location: name,
-    }));
-
-    return forecast;
-  },
-});
-
-const forecastSchema = z.array(
-  z.object({
-    date: z.string(),
-    maxTemp: z.number(),
-    minTemp: z.number(),
-    precipitationChance: z.number(),
-    condition: z.string(),
-    location: z.string(),
-  }),
-);
-
-const planActivities = new Step({
-  id: 'plan-activities',
-  description: 'Suggests activities based on weather conditions',
-  inputSchema: forecastSchema,
-  execute: async ({ context, mastra }) => {
-    const forecast = context?.getStepResult<z.infer<typeof forecastSchema>>('fetch-weather');
-
-    if (!forecast) {
-      throw new Error('Forecast data not found');
-    }
-
-    const prompt = `Based on the following weather forecast for ${forecast[0].location}, suggest appropriate activities:
-      ${JSON.stringify(forecast, null, 2)}
-      `;
-
-    const response = await agent.stream([
-      {
-        role: 'user',
-        content: prompt,
-      },
-    ]);
-
-    let activitiesText = '';
-
-    for await (const chunk of response.textStream) {
-      process.stdout.write(chunk);
-      activitiesText += chunk;
-    }
-
-    return {
-      activities: activitiesText,
-    };
-  },
-});
-
-function getWeatherCondition(code: number): string {
-  const conditions: Record<number, string> = {
-    0: 'Clear sky',
-    1: 'Mainly clear',
-    2: 'Partly cloudy',
-    3: 'Overcast',
-    45: 'Foggy',
-    48: 'Depositing rime fog',
-    51: 'Light drizzle',
-    53: 'Moderate drizzle',
-    55: 'Dense drizzle',
-    61: 'Slight rain',
-    63: 'Moderate rain',
-    65: 'Heavy rain',
-    71: 'Slight snow fall',
-    73: 'Moderate snow fall',
-    75: 'Heavy snow fall',
-    95: 'Thunderstorm',
-  };
-  return conditions[code] || 'Unknown';
-}
-
-const weatherWorkflow = new Workflow({
-  name: 'weather-workflow',
-  triggerSchema: z.object({
-    city: z.string().describe('The city to get the weather for'),
-  }),
-})
-  .step(fetchWeather)
-  .then(planActivities);
-
-weatherWorkflow.commit();
-
-export { weatherWorkflow };
-
-```
-
-### mastra/workflows/new-workflow.ts
-```typescript
 import { Agent } from '@mastra/core/agent';
 import { createStep, createWorkflow } from '@mastra/core/workflows';
 import { z } from 'zod';
 import { openai } from '@ai-sdk/openai';
 
 const agent = new Agent({
+  id: 'weather-agent',
   name: 'Weather Agent',
   model: openai('gpt-4o'),
   instructions: `

package/.docs/organized/code-examples/fireworks-r1.md

@@ -122,9 +122,9 @@ if (!process.env.FIREWORKS_API_KEY) {
 }
 
 export const agent = new Agent({
+  id: 'example-agent',
+  name: 'Example Agent',
   model: fireworks(`accounts/fireworks/models/deepseek-r1`),
-
-  name: 'Example agent',
   instructions: `You are a helpful and intelligent AI agent.`,
   memory: new Memory(),
 });

package/.docs/organized/code-examples/heads-up-game.md

@@ -3,19 +3,19 @@
 {
   "name": "example-headsup",
   "engines": {
-    "node": ">=20.9.0"
+    "node": ">=22.13.0"
   },
   "dependencies": {
     "@ai-sdk/openai": "^1.3.23",
-    "@mastra/core": "^0.21.1",
-    "@mastra/libsql": "^0.15.2",
-    "@mastra/loggers": "^0.10.16",
-    "@mastra/memory": "^0.15.7",
+    "@mastra/core": "^0.23.1",
+    "@mastra/libsql": "^0.16.1",
+    "@mastra/loggers": "^0.10.18",
+    "@mastra/memory": "^0.15.9",
     "zod": "^3.25.76"
   },
   "devDependencies": {
     "@types/node": "^24.3.0",
-    "mastra": "^0.17.0",
+    "mastra": "^0.17.5",
     "typescript": "^5.9.2"
   }
 }
@@ -29,6 +29,7 @@ import { Memory } from '@mastra/memory';
 import { LibSQLVector } from '@mastra/libsql';
 
 export const famousPersonAgent = new Agent({
+  id: 'famous-person-generator',
   name: 'Famous Person Generator',
   instructions: `You are a famous person generator for a "Heads Up" guessing game.
 
@@ -67,6 +68,7 @@ import { openai } from '@ai-sdk/openai';
 import { Agent } from '@mastra/core/agent';
 
 export const gameAgent = new Agent({
+  id: 'game-agent',
   name: 'Game Agent',
   instructions: `You are a helpful game assistant for a "Heads Up" guessing game.
 
@@ -111,7 +113,8 @@ export const mastra = new Mastra({
   workflows: { headsUpWorkflow },
   agents: { famousPersonAgent, gameAgent, guessVerifierAgent },
   storage: new LibSQLStore({
-    // stores telemetry, evals, ... into file storage for persistence across playground refreshes
+    id: 'heads-up-game-storage',
+    // stores observability, evals, ... into file storage for persistence across playground refreshes
     url: 'file:../mastra.db',
   }),
   logger: new PinoLogger({

package/.docs/organized/code-examples/mcp-configuration.md

@@ -34,6 +34,7 @@ import './mastra/tools/sse';
 
 console.log(chalk.blue(`Creating agent`));
 export const stockWeatherAgent = new Agent({
+  id: 'stock-weather-agent',
   name: 'Stock + Weather Agent',
   instructions:
     'You are a helpful assistant that provides current stock prices. When asked about a stock, use the stock price tool to fetch the stock price. You also love to check the weather when your stock market buddies ask you what the weather is.',
@@ -56,7 +57,7 @@ const mcp = new MCPClient({
   },
 });
 
-const toolsets = await mcp.getToolsets();
+const toolsets = await mcp.listToolsets();
 
 console.log({ toolsets });
 
@@ -110,18 +111,19 @@ const mcp = new MCPClient({
 });
 
 export const stockWeatherAgent = new Agent({
+  id: 'stock-weather-agent',
   name: 'Stock + Weather Agent',
   instructions:
     'You are a helpful assistant that provides current stock prices. When asked about a stock, use the stock price tool to fetch the stock price. You also love to check the weather when your stock market buddies ask you what the weather is.',
   model: openai('gpt-4o'),
-  tools: await mcp.getTools(),
+  tools: await mcp.listTools(),
 });
 
 ```
 
 ### mastra/index.ts
 ```typescript
-import { Mastra } from '@mastra/core';
+import { Mastra } from '@mastra/core/mastra';
 
 import { stockWeatherAgent } from './agents';
 

package/.docs/organized/code-examples/mcp-registry-registry.md

@@ -28,17 +28,18 @@ const mcp = new MCPClient({
 });
 
 export const mcpRegistryAgent = new Agent({
+  id: 'mcp-registry-agent',
   name: 'MCP Registry Agent',
   instructions: `You are a helpful assistant that provides information about MCP registries. You can search for registries by ID, tag, or name.`,
   model: openai('gpt-4o'),
-  tools: await mcp.getTools(),
+  tools: await mcp.listTools(),
 });
 
 ```
 
 ### mastra/index.ts
 ```typescript
-import { Mastra } from '@mastra/core';
+import { Mastra } from '@mastra/core/mastra';
 import { PinoLogger } from '@mastra/loggers';
 import { mcpRegistryAgent } from './agents/index';
 

package/.docs/organized/code-examples/memory-per-resource-example.md

@@ -166,6 +166,7 @@ import { LibSQLStore } from '@mastra/libsql';
 
 // Create LibSQL storage for persistent per-resource working memory
 const storage = new LibSQLStore({
+  id: 'memory-demo-storage',
   url: 'file:./memory-demo.db',
 });
 
@@ -175,7 +176,7 @@ export const memory = new Memory({
     lastMessages: 5,
     workingMemory: {
       enabled: true,
-      scope: 'resource', // 🆕 NEW: Per-resource working memory!
+      scope: 'resource', // Default: Per-resource working memory persists across all threads
       template: `# User Profile
 - **Name**: 
 - **Location**: 
@@ -189,6 +190,7 @@ export const memory = new Memory({
 });
 
 export const assistantAgent = new Agent({
+  id: 'personal-assistant',
   name: 'Personal Assistant',
   instructions: `You are a helpful personal assistant with persistent memory across ALL conversations.
 
@@ -212,7 +214,7 @@ When you first meet someone, ask for their name and learn about them. In subsequ
 
 ### mastra/index.ts
 ```typescript
-import { Mastra } from '@mastra/core';
+import { Mastra } from '@mastra/core/mastra';
 import { assistantAgent } from './agents';
 
 export const mastra = new Mastra({