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

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

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.',