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

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';
 

package/.docs/organized/code-examples/openapi-spec-writer.md

@@ -101,7 +101,8 @@ import { Agent } from "@mastra/core/agent";
 import { openai } from "@ai-sdk/openai";
 
 export const agentOne = new Agent({
-  name: "openapi-spec-gen-agent",
+  id: "openapi-spec-gen-agent",
+  name: "OpenAPI Spec Generator Agent",
   instructions:
     "You are an expert Open API spec writer. You can take markdown documentation and extract all the information you can to generate an amazing Open API spec. You are also able to merge multiple fragmented Open API specs from the same source into a single compliant spec.",
   model: openai("gpt-3.5-turbo"),
@@ -112,7 +113,7 @@ export const agentOne = new Agent({
 ### mastra/index.ts
 ```typescript
 import { PinoLogger } from "@mastra/loggers";
-import { Mastra } from "@mastra/core/mastra";
+import { Mastra } from "@mastra/core";
 import { UpstashTransport } from "@mastra/loggers/upstash";
 import { agentOne } from "./agents";
 import { makePRToMastraWorkflow, openApiSpecGenWorkflow } from "./workflows";
@@ -129,16 +130,6 @@ export const mastra = new Mastra({
     },
   }),
   agents: { "openapi-spec-gen-agent": agentOne },
-  telemetry: {
-    serviceName: "mastra-vnext",
-    sampling: {
-      type: "always_on",
-    },
-    enabled: true,
-    export: {
-      type: "otlp",
-    },
-  },
   workflows: {
     openApiSpecGenWorkflow,
     makePRToMastraWorkflow,
@@ -194,16 +185,16 @@ export const siteCrawlTool = createTool({
     ),
     entityType: z.string(),
   }),
-  execute: async ({ context }) => {
+  execute: async (inputData) => {
     const client = await firecrawl.getApiClient();
 
-    console.log("Starting crawl", context.url);
+    console.log("Starting crawl", inputData.url);
 
     const res = await client.crawlUrls({
       body: {
-        url: context.url,
-        limit: context.limit || 3,
-        includePaths: [context.pathRegex],
+        url: inputData.url,
+        limit: inputData.limit || 3,
+        includePaths: [inputData.pathRegex],
         scrapeOptions: {
           formats: ["markdown"],
           includeTags: ["main"],
@@ -243,7 +234,7 @@ export const siteCrawlTool = createTool({
       });
     }
 
-    const entityType = `CRAWL_${context.url}`;
+    const entityType = `CRAWL_${inputData.url}`;
 
     return {
       success: true,
@@ -270,17 +261,17 @@ export const generateSpecTool = createTool({
     mergedSpec: z.string(),
   }),
   description: "Generate a spec from a website",
-  execute: async ({ context, runId, mastra }) => {
+  execute: async (inputData, context) => {
     const crawledData =
-      context?.steps?.["site-crawl"]?.status === "success"
-        ? context?.steps?.["site-crawl"]?.output?.crawlData
+      context?.workflow?.state?.steps?.["site-crawl"]?.status === "success"
+        ? context?.workflow?.state?.steps?.["site-crawl"]?.output?.crawlData
         : [];
 
     if (!crawledData) {
       throw new Error("No crawled data found");
     }
 
-    const agent = mastra?.agents?.["openapi-spec-gen-agent"];
+    const agent = context?.mastra?.agents?.["openapi-spec-gen-agent"];
 
     if (!agent) {
       throw new Error("Agent not found");
@@ -292,7 +283,7 @@ export const generateSpecTool = createTool({
     for (const d of crawledData) {
       const data = await agent.generate(
         `I wrote another page of docs, turn this into an Open API spec: ${d.data.markdown}`,
-        { runId }
+        { runId: context?.workflow?.runId }
       );
 
       openapiResponses.push(data.text);
@@ -307,7 +298,7 @@ export const generateSpecTool = createTool({
         .map((r) => r)
         .join("\n\n")} - merge them into a single spec,
           `,
-      { runId }
+      { runId: context?.workflow?.runId }
     );
 
     mergedSpecAnswer = mergedSpec.text
@@ -338,18 +329,18 @@ export const addToGitHubTool = createTool({
     pr_url: z.string().optional(),
   }),
   description: "Commit the spec to GitHub",
-  execute: async ({ context, runId, mastra }) => {
+  execute: async (inputData, context) => {
     const client = await github.getApiClient();
 
-    const content = context.yaml;
-    const integrationName = context.integration_name.toLowerCase();
+    const content = inputData.yaml;
+    const integrationName = inputData.integration_name.toLowerCase();
 
-    console.log("Writing to Github for", context.integration_name);
-    const agent = mastra?.agents?.["openapi-spec-gen-agent"];
+    console.log("Writing to Github for", inputData.integration_name);
+    const agent = context?.mastra?.agents?.["openapi-spec-gen-agent"];
 
     const d = await agent?.generate(
       `Can you take this text blob and format it into proper YAML? ${content}`,
-      { runId }
+      { runId: context?.workflow?.runId }
     );
 
     if (!d) {
@@ -373,12 +364,12 @@ export const addToGitHubTool = createTool({
       const mainRef = await client.gitGetRef({
         path: {
           ref: "heads/main",
-          owner: context.owner,
-          repo: context.repo,
+          owner: inputData.owner,
+          repo: inputData.repo,
         },
       });
 
-      console.log({ context, mainRef });
+      console.log({ input, mainRef });
 
       const mainSha = mainRef.data?.object?.sha;
 
@@ -395,8 +386,8 @@ export const addToGitHubTool = createTool({
             sha: mainSha,
           },
           path: {
-            owner: context.owner,
-            repo: context.repo,
+            owner: inputData.owner,
+            repo: inputData.repo,
           },
         });
 
@@ -404,13 +395,13 @@ export const addToGitHubTool = createTool({
           console.log({ path, content });
           await client.reposCreateOrUpdateFileContents({
             body: {
-              message: `Add open api spec from ${context.site_url}`,
+              message: `Add open api spec from ${inputData.site_url}`,
               content,
               branch: branchName,
             },
             path: {
-              owner: context.owner,
-              repo: context.repo,
+              owner: inputData.owner,
+              repo: inputData.repo,
               path,
             },
           });
@@ -418,13 +409,13 @@ export const addToGitHubTool = createTool({
 
         const pullData = await client.pullsCreate({
           body: {
-            title: `Add open api spec from ${context.site_url} for ${integrationName}`,
+            title: `Add open api spec from ${inputData.site_url} for ${integrationName}`,
             head: branchName,
             base: "main",
           },
           path: {
-            owner: context.owner,
-            repo: context.repo,
+            owner: inputData.owner,
+            repo: inputData.repo,
           },
         });
 

package/.docs/organized/code-examples/quick-start.md

@@ -42,7 +42,7 @@ const main = async () => {
 
     console.log(res.species);
 
-    const run = await mastra.getWorkflow('logCatWorkflow').createRunAsync();
+    const run = await mastra.getWorkflow('logCatWorkflow').createRun();
     const { start } = run;
 
     await start({ triggerData: { name: res.species } });
@@ -58,10 +58,11 @@ main();
 ### mastra/agents/agent.ts
 ```typescript
 import { openai } from '@ai-sdk/openai';
-import { Agent } from '@mastra/core';
+import { Agent } from '@mastra/core/agent';
 
 export const catOne = new Agent({
-  name: 'cat-one',
+  id: 'cat-one',
+  name: 'Cat One',
   instructions:
     'You are a feline expert with comprehensive knowledge of all cat species, from domestic breeds to wild big cats. As a lifelong cat specialist, you understand their behavior, biology, social structures, and evolutionary history in great depth. If you are asked for a specie name, do not return a paragraph, a succint two or three letter name of the species will suffice.',
   model: openai('gpt-4o'),
@@ -71,7 +72,7 @@ export const catOne = new Agent({
 
 ### mastra/index.ts
 ```typescript
-import { Mastra } from '@mastra/core';
+import { Mastra } from '@mastra/core/mastra';
 import { PinoLogger } from '@mastra/loggers';
 import { catOne } from './agents/agent';
 import { logCatWorkflow as legacy_catWorkflow } from './legacy-workflows';
@@ -93,34 +94,6 @@ export const mastra = new Mastra({
 
 ```
 
-### mastra/legacy-workflows/index.ts
-```typescript
-import { LegacyWorkflow as Workflow, LegacyStep as Step } from '@mastra/core/workflows/legacy';
-import { z } from 'zod';
-
-const logCatName = new Step({
-  id: 'logCatName',
-  outputSchema: z.object({
-    rawText: z.string(),
-  }),
-  execute: async ({ context }) => {
-    const name = context?.getStepResult<{ name: string }>('trigger')?.name;
-    console.log(`Hello, ${name} 🐈`);
-    return { rawText: `Hello ${name}` };
-  },
-});
-
-export const logCatWorkflow = new Workflow({
-  name: 'log-cat-workflow',
-  triggerSchema: z.object({
-    name: z.string(),
-  }),
-});
-
-logCatWorkflow.step(logCatName).commit();
-
-```
-
 ### mastra/workflows/index.ts
 ```typescript
 import { createWorkflow, createStep } from '@mastra/core/workflows';

package/.docs/organized/code-examples/stock-price-tool.md

@@ -43,6 +43,7 @@ import { Agent } from '@mastra/core/agent';
 import { stockPrices } from '../tools/stock-price';
 
 export const stockAgent = new Agent({
+  id: 'stock-agent',
   name: 'Stock 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.',
@@ -56,7 +57,7 @@ export const stockAgent = new Agent({
 
 ### mastra/index.ts
 ```typescript
-import { Mastra } from '@mastra/core';
+import { Mastra } from '@mastra/core/mastra';
 
 import { stockAgent } from './agents';
 
@@ -82,11 +83,11 @@ export const stockPrices = createTool({
     symbol: z.string(),
   }),
   description: `Fetches the last day's closing stock price for a given symbol`,
-  execute: async ({ context }) => {
-    console.log('Using tool to fetch stock price for', context.symbol);
+  execute: async input => {
+    console.log('Using tool to fetch stock price for', inputData.symbol);
     return {
-      symbol: context.symbol,
-      currentPrice: await getStockPrice(context.symbol),
+      symbol: inputData.symbol,
+      currentPrice: await getStockPrice(inputData.symbol),
     };
   },
 });

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

@@ -28,17 +28,19 @@ import { weatherTool } from '../tools';
 
 // const memory = new Memory({
 //   storage: new LibSQLStore({
+//     id: 'weather-agent-storage',
 //     url: 'file:../mastra.db', // Or your database URL
 //   }),
 // });
 
 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
@@ -56,7 +58,8 @@ Use the weatherTool to fetch current weather data.`,
 });
 
 export const weatherReporterAgent = new Agent({
-  name: 'weatherExplainerAgent',
+  id: 'weatherExplainerAgent',
+  name: 'Weather Explainer Agent',
   model: openai('gpt-4o'),
   instructions: `
   You are a weather explainer. You have access to input that will help you get weather-specific activities for any city. 
@@ -68,7 +71,7 @@ export const weatherReporterAgent = new Agent({
 
 ### mastra/index.ts
 ```typescript
-import { Mastra } from '@mastra/core';
+import { Mastra } from '@mastra/core/mastra';
 import { LibSQLStore } from '@mastra/libsql';
 
 import { weatherAgent, weatherReporterAgent } from './agents';
@@ -77,6 +80,7 @@ import { weatherWorkflow, weatherWorkflow2 } from './workflows/new-workflow';
 
 export const mastra = new Mastra({
   storage: new LibSQLStore({
+    id: 'weather-agent-storage',
     url: 'file:./mastra.db',
   }),
   agents: { weatherAgent, weatherReporterAgent },
@@ -118,8 +122,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);
   },
 });
 
@@ -190,10 +194,11 @@ function getWeatherCondition(code: number): string {
 ```typescript
 import { openai } from '@ai-sdk/openai';
 import { Agent } from '@mastra/core/agent';
-import { LegacyStep, LegacyWorkflow } from '@mastra/core/workflows/legacy';
+import { createStep, createWorkflow } from '@mastra/core/workflows';
 import { z } from 'zod';
 
 const agent = new Agent({
+  id: 'weather-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.
@@ -232,14 +237,14 @@ const agent = new Agent({
   model: openai('gpt-4o'),
 });
 
-const fetchWeather = new LegacyStep({
+const fetchWeather = createStep({
   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');
+  execute: async (inputData, context) => {
+    const triggerData = context?.workflow?.state?.getStepResult<{ city: string }>('trigger');
 
     if (!triggerData) {
       throw new Error('Trigger data not found');
@@ -283,12 +288,12 @@ const forecastSchema = z.array(
   }),
 );
 
-const planActivities = new LegacyStep({
+const planActivities = createStep({
   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');
+  execute: async (inputData, context) => {
+    const forecast = context?.workflow?.state?.getStepResult<z.infer<typeof forecastSchema>>('fetch-weather');
 
     if (!forecast) {
       throw new Error('Forecast data not found');
@@ -340,16 +345,15 @@ function getWeatherCondition(code: number): string {
   return conditions[code] || 'Unknown';
 }
 
-const weatherWorkflow = new LegacyWorkflow({
+const weatherWorkflow = createWorkflow({
   name: 'weather-workflow',
   triggerSchema: z.object({
     city: z.string().describe('The city to get the weather for'),
   }),
 })
   .step(fetchWeather)
-  .then(planActivities);
-
-weatherWorkflow.commit();
+  .then(planActivities)
+  .commit();
 
 export { weatherWorkflow };
 
@@ -365,6 +369,7 @@ import { weatherTool } from '../tools';
 import { weatherReporterAgent } from '../agents';
 
 const agent = new Agent({
+  id: 'weather-agent',
   name: 'Weather Agent',
   model: openai('gpt-4o'),
   instructions: `