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

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({

package/.docs/organized/code-examples/memory-todo-agent.md

@@ -128,6 +128,7 @@ const memory = new Memory({
 });
 
 export const todoAgent = new Agent({
+  id: 'todo-agent',
   name: 'TODO Agent',
   instructions:
     'You are a helpful todolist AI agent. Help the user manage their todolist. If there is no list yet ask them what to add! If there is a list always print it out when the chat starts. For each item add emojis, dates, titles (with an index number starting at 1), descriptions, and statuses. For each piece of info add an emoji to the left of it. Also support subtask lists with bullet points inside a box. Help the user timebox each task by asking them how long it will take. You MUST save the todolist in every response message by printing out <working_memory> blocks. If you do not save it in working_memory you will forget - you only have access to one previous message at any time. The user is expecting you to save your memory in every interaction. If the user expresses any preference on how the list should be displayed, save that info in working_memory so you know how to format it later.',

package/.docs/organized/code-examples/memory-with-context.md

@@ -134,6 +134,7 @@ const memory = new Memory({
 });
 
 export const memoryAgent = new Agent({
+  id: 'memory-agent',
   name: 'Memory Agent',
   instructions: 'You are a helpful AI agent, looking to assist however you can.',
   model: openai('gpt-4o-mini'),
@@ -144,7 +145,7 @@ export const memoryAgent = new Agent({
 
 ### mastra/index.ts
 ```typescript
-import { Mastra } from '@mastra/core';
+import { Mastra } from '@mastra/core/mastra';
 
 import { memoryAgent } from './agents';
 

package/.docs/organized/code-examples/memory-with-libsql.md

@@ -160,7 +160,8 @@ const memory = new Memory({
 });
 
 export const chefAgent = new Agent({
-  name: 'chefAgent',
+  id: 'chef-agent',
+  name: 'Chef Agent',
   instructions:
     'You are Michel, a practical and experienced home chef who helps people cook great meals with whatever ingredients they have available. Your first priority is understanding what ingredients and equipment the user has access to, then suggesting achievable recipes. You explain cooking steps clearly and offer substitutions when needed, maintaining a friendly and encouraging tone throughout.',
   model: openai('gpt-4o'),
@@ -168,6 +169,7 @@ export const chefAgent = new Agent({
 });
 
 export const memoryAgent = new Agent({
+  id: 'memory-agent',
   name: 'Memory Agent',
   instructions:
     "You are an AI agent with the ability to automatically recall memories from previous interactions. You may have conversations that last hours, days, months, or years. If you don't know it already you should ask for the users name and some info about them.",
@@ -179,7 +181,7 @@ export const memoryAgent = new Agent({
 
 ### mastra/index.ts
 ```typescript
-import { Mastra } from '@mastra/core';
+import { Mastra } from '@mastra/core/mastra';
 
 import { chefAgent, memoryAgent } from './agents';
 

package/.docs/organized/code-examples/memory-with-mongodb.md

@@ -176,7 +176,8 @@ export const memory = new Memory({
 });
 
 export const chefAgent = new Agent({
-  name: 'chefAgent',
+  id: 'chef-agent',
+  name: 'Chef Agent',
   instructions:
     'You are Michel, a practical and experienced home chef who helps people cook great meals with whatever ingredients they have available. Your first priority is understanding what ingredients and equipment the user has access to, then suggesting achievable recipes. You explain cooking steps clearly and offer substitutions when needed, maintaining a friendly and encouraging tone throughout.',
   model: openai('gpt-4o'),
@@ -184,6 +185,7 @@ export const chefAgent = new Agent({
 });
 
 export const memoryAgent = new Agent({
+  id: 'memory-agent',
   name: 'Memory Agent',
   instructions:
     "You are an AI agent with the ability to automatically recall memories from previous interactions. You may have conversations that last hours, days, months, or years. If you don't know it already you should ask for the users name and some info about them.",
@@ -195,7 +197,7 @@ export const memoryAgent = new Agent({
 
 ### mastra/index.ts
 ```typescript
-import { Mastra } from '@mastra/core';
+import { Mastra } from '@mastra/core/mastra';
 
 import 'dotenv/config';
 

package/.docs/organized/code-examples/memory-with-pg.md

@@ -179,7 +179,8 @@ export const memory = new Memory({
 });
 
 export const chefAgent = new Agent({
-  name: 'chefAgent',
+  id: 'chef-agent',
+  name: 'Chef Agent',
   instructions:
     'You are Michel, a practical and experienced home chef who helps people cook great meals with whatever ingredients they have available. Your first priority is understanding what ingredients and equipment the user has access to, then suggesting achievable recipes. You explain cooking steps clearly and offer substitutions when needed, maintaining a friendly and encouraging tone throughout.',
   model: openai('gpt-4o'),
@@ -187,6 +188,7 @@ export const chefAgent = new Agent({
 });
 
 export const memoryAgent = new Agent({
+  id: 'memory-agent',
   name: 'Memory Agent',
   instructions:
     "You are an AI agent with the ability to automatically recall memories from previous interactions. You may have conversations that last hours, days, months, or years. If you don't know it already you should ask for the users name and some info about them.",
@@ -198,7 +200,7 @@ export const memoryAgent = new Agent({
 
 ### mastra/index.ts
 ```typescript
-import { Mastra } from '@mastra/core';
+import { Mastra } from '@mastra/core/mastra';
 
 import 'dotenv/config';
 

package/.docs/organized/code-examples/memory-with-processors.md

@@ -25,7 +25,7 @@ import Readline from 'readline';
 
 import { openai } from '@ai-sdk/openai';
 import { Agent } from '@mastra/core/agent';
-import type { CoreMessage } from '@mastra/core';
+import type { CoreMessage } from '@mastra/core/llm';
 import { MemoryProcessor, MemoryProcessorOpts } from '@mastra/core/memory';
 import { Memory } from '@mastra/memory';
 
@@ -65,6 +65,7 @@ class ForgetfulProcessor extends MemoryProcessor {
 
 // Interviewer agent that accidentally forgets your name all the time
 const agent = new Agent({
+  id: 'forgetful-job-interviewer',
   name: 'Forgetful Job Interviewer',
   instructions:
     "You are a professional job interviewer for a technology company. Conduct insightful interviews by asking relevant questions about skills, experience, and problem-solving abilities. Respond to candidate answers and ask follow-up questions. Keep the interview professional and engaging. Remember details the candidate shares earlier in the conversation. Sometimes you forget things by accident. The system will show you if you forgot. Don't be embarassed, you can admit when you forget something, you'll know when you do because there will be a message wrapped in <forgetten> tags. Don't refer to the user by their name, it comes across as too eager",
@@ -137,9 +138,9 @@ while (true) {
 ### mastra/agents/index.ts
 ```typescript
 import { openai } from '@ai-sdk/openai';
-import { createTool } from '@mastra/core';
+import { createTool } from '@mastra/core/tools';
 import { Agent } from '@mastra/core/agent';
-import type { CoreMessage } from '@mastra/core';
+import type { CoreMessage } from '@mastra/core/llm';
 import { MemoryProcessor, MemoryProcessorOpts } from '@mastra/core/memory';
 import { Memory } from '@mastra/memory';
 import { TokenLimiter, ToolCallFilter } from '@mastra/memory/processors';
@@ -196,9 +197,9 @@ const searchTool = createTool({
   inputSchema: z.object({
     query: z.string().describe('The search query'),
   }),
-  execute: async ({ context: { query } }) => {
+  execute: async input => {
     // Simulate web search results
-    return `Search results for "${query}": 
+    return `Search results for "${inputData.query}":
     1. Top result with important information
     2. Secondary information related to the query
     3. Additional context that might be helpful`;
@@ -207,6 +208,7 @@ const searchTool = createTool({
 
 // Technical support agent with token limiting
 export const supportAgent = new Agent({
+  id: 'technical-support',
   name: 'Technical Support',
   instructions:
     'You are a technical support agent who helps users solve software problems. You provide clear, step-by-step instructions and ask clarifying questions when needed. You remember details from earlier in the conversation. Your goal is to efficiently resolve user issues.',
@@ -231,6 +233,7 @@ const interviewMemory = new Memory({
 
 // Interviewer agent that filters out tool calls and sensitive content
 export const interviewerAgent = new Agent({
+  id: 'forgetful-job-interviewer',
   name: 'Forgetful Job Interviewer',
   instructions:
     "You are a professional job interviewer for a technology company. Conduct insightful interviews by asking relevant questions about skills, experience, and problem-solving abilities. Respond to candidate answers and ask follow-up questions. Keep the interview professional and engaging. Remember details the candidate shares earlier in the conversation. Sometimes you forget things by accident. The system will show you if you forgot. Don't be embarrassed, you can admit when you forget something, you'll know when you do because there will be a message wrapped in <forgetten> tags. Don't refer to the user by their name, it comes across as too eager",
@@ -242,7 +245,7 @@ export const interviewerAgent = new Agent({
 
 ### mastra/index.ts
 ```typescript
-import { Mastra } from '@mastra/core';
+import { Mastra } from '@mastra/core/mastra';
 
 import { supportAgent, interviewerAgent } from './agents';
 
@@ -256,7 +259,7 @@ export const mastra = new Mastra({
 ```typescript
 import 'dotenv/config';
 import { openai } from '@ai-sdk/openai';
-import { Mastra } from '@mastra/core';
+import { Mastra } from '@mastra/core/mastra';
 import { PinoLogger } from '@mastra/loggers';
 import { createTool } from '@mastra/core/tools';
 import { Agent } from '@mastra/core/agent';
@@ -340,6 +343,7 @@ const memory = new Memory({
 
 // Create an agent with the test tool
 const tokenTestAgent = new Agent({
+  id: 'token-test-agent',
   name: 'Token Test Agent',
   instructions: 'You help test token limiting by calling tools that return large amounts of data.',
   model: openai('gpt-4o-mini'),
@@ -447,7 +451,7 @@ import { openai } from '@ai-sdk/openai';
 import { Agent } from '@mastra/core/agent';
 import { Memory } from '@mastra/memory';
 import { TokenLimiter } from '@mastra/memory/processors';
-import { Mastra } from '@mastra/core';
+import { Mastra } from '@mastra/core/mastra';
 import { PinoLogger } from '@mastra/loggers';
 
 const memory = new Memory({
@@ -459,6 +463,7 @@ const memory = new Memory({
 });
 
 const techSupport = new Agent({
+  id: 'technical-support',
   name: 'Technical Support',
   instructions:
     'You are a technical support agent who helps users solve software problems. You provide concise, short, instructions and ask clarifying questions when needed. You remember details from earlier in the conversation. Your goal is to efficiently resolve user issues. Make sure you provide concise responses without tons of text',

package/.docs/organized/code-examples/memory-with-upstash.md

@@ -203,7 +203,7 @@ main();
 ### mastra/agents/index.ts
 ```typescript
 import { openai } from '@ai-sdk/openai';
-import { Agent } from '@mastra/core';
+import { Agent } from '@mastra/core/agent';
 import { Memory } from '@mastra/memory';
 import { PgVector } from '@mastra/pg';
 import { UpstashStore } from '@mastra/upstash';
@@ -224,7 +224,8 @@ const memory = new Memory({
 });
 
 export const chefAgent = new Agent({
-  name: 'chefAgent',
+  id: 'chef-agent',
+  name: 'Chef Agent',
   memory,
   instructions:
     'You are Michel, a practical and experienced home chef who helps people cook great meals with whatever ingredients they have available. Your first priority is understanding what ingredients and equipment the user has access to, then suggesting achievable recipes. You explain cooking steps clearly and offer substitutions when needed, maintaining a friendly and encouraging tone throughout.',
@@ -232,6 +233,7 @@ export const chefAgent = new Agent({
 });
 
 export const memoryAgent = new Agent({
+  id: 'memory-agent',
   name: 'Memory Agent',
   memory,
   instructions:
@@ -243,7 +245,7 @@ export const memoryAgent = new Agent({
 
 ### mastra/index.ts
 ```typescript
-import { Mastra } from '@mastra/core';
+import { Mastra } from '@mastra/core/mastra';
 
 import { chefAgent, memoryAgent } from './agents';