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

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: `

package/.docs/organized/code-examples/workflow-ai-recruiter.md

@@ -21,12 +21,13 @@
 ### mastra/index.ts
 ```typescript
 import { openai } from '@ai-sdk/openai';
-import { Mastra } from '@mastra/core';
+import { Mastra } from '@mastra/core/mastra';
 import { Agent } from '@mastra/core/agent';
 import { Step, Workflow } from '@mastra/core/workflows';
 import { z } from 'zod';
 
 const recruiter = new Agent({
+  id: 'recruiter-agent',
   name: 'Recruiter Agent',
   instructions: `You are a recruiter.`,
   model: openai('gpt-4o-mini'),
@@ -132,7 +133,7 @@ const mastra = new Mastra({
 });
 
 (async () => {
-  const run = await mastra.getWorkflow('candidateWorkflow').createRunAsync();
+  const run = await mastra.getWorkflow('candidateWorkflow').createRun();
   const { runId, start } = run;
 
   console.log('Run', runId);

package/.docs/organized/code-examples/workflow-with-inline-steps.md

@@ -17,7 +17,7 @@
 
 ### mastra/index.ts
 ```typescript
-import { Mastra } from '@mastra/core';
+import { Mastra } from '@mastra/core/mastra';
 
 import { myWorkflow } from './workflows';
 
@@ -51,8 +51,8 @@ myWorkflow
       outputSchema: z.object({
         doubledValue: z.number(),
       }),
-      execute: async ({ context }) => {
-        const doubledValue = context?.triggerData.inputValue * 2;
+      execute: async (inputData, context) => {
+        const doubledValue = context?.workflow?.state?.triggerData.inputValue * 2;
         return { doubledValue };
       },
     }),
@@ -66,21 +66,18 @@ myWorkflow
       outputSchema: z.object({
         incrementedValue: z.number(),
       }),
-      execute: async ({ context }) => {
-        if (context?.steps.stepOne.status === 'success') {
-          const incrementedValue = context?.steps.stepOne.output.doubledValue + 1;
-          return { incrementedValue };
-        }
-        return { incrementedValue: 0 };
+      execute: async (inputData, context) => {
+        const incrementedValue = inputData.valueToIncrement + 1;
+        return { incrementedValue };
       },
     }),
   )
   .then(
     new Step({
       id: 'stepThree',
-      execute: async ({ context, suspend }) => {
-        if (context?.resumeData?.confirm !== 'true') {
-          return suspend({
+      execute: async (inputData, context) => {
+        if (context?.workflow?.resumeData?.confirm !== 'true') {
+          return context?.workflow?.suspend({
             message: 'Do you accept?',
           });
         }

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

@@ -30,7 +30,8 @@ const memory = new Memory({
 });
 
 export const catOne = new Agent({
-  name: 'cat-one',
+  id: 'cat-one',
+  name: 'Cat One',
   memory,
   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.',
@@ -41,7 +42,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/index';
@@ -103,8 +104,8 @@ const stepOne = new Step({
   outputSchema: z.object({
     doubledValue: z.number(),
   }),
-  execute: async ({ context }) => {
-    const doubledValue = context.inputValue * 2;
+  execute: async inputData => {
+    const doubledValue = inputData.inputValue * 2;
     return { doubledValue };
   },
 });
@@ -118,8 +119,8 @@ const stepTwo = new Step({
   outputSchema: z.object({
     incrementedValue: z.number(),
   }),
-  execute: async ({ context }) => {
-    const incrementedValue = context.valueToIncrement + 1;
+  execute: async inputData => {
+    const incrementedValue = inputData.valueToIncrement + 1;
     return { incrementedValue };
   },
 });
@@ -133,8 +134,8 @@ const stepThree = new Step({
   outputSchema: z.object({
     squaredValue: z.number(),
   }),
-  execute: async ({ context }) => {
-    const squaredValue = context.valueToSquare * context.valueToSquare;
+  execute: async inputData => {
+    const squaredValue = inputData.valueToSquare * inputData.valueToSquare;
     return { squaredValue };
   },
 });
@@ -148,8 +149,8 @@ const stepFour = new Step({
   outputSchema: z.object({
     rootValue: z.number(),
   }),
-  execute: async ({ context }) => {
-    return { rootValue: Math.sqrt(context.valueToRoot) };
+  execute: async inputData => {
+    return { rootValue: Math.sqrt(inputData.valueToRoot) };
   },
 });
 
@@ -162,8 +163,8 @@ const stepFive = new Step({
   outputSchema: z.object({
     tripledValue: z.number(),
   }),
-  execute: async ({ context }) => {
-    const tripledValue = context.inputValue * 3;
+  execute: async inputData => {
+    const tripledValue = inputData.inputValue * 3;
     return { tripledValue };
   },
 });
@@ -177,9 +178,9 @@ const stepSix = new Step({
   outputSchema: z.object({
     rawText: z.string(),
   }),
-  execute: async ({ context }) => {
-    console.log(context.inputValue);
-    return { rawText: context.inputValue.toString() };
+  execute: async inputData => {
+    console.log(inputData.inputValue);
+    return { rawText: inputData.inputValue.toString() };
   },
 });
 

package/.docs/organized/code-examples/workflow-with-separate-steps.md

@@ -20,7 +20,7 @@
 import { mastra } from './mastra';
 
 async function main() {
-  const run = await mastra.getWorkflow('myWorkflow').createRunAsync();
+  const run = await mastra.getWorkflow('myWorkflow').createRun();
   try {
     const res = await run.start({
       inputData: {
@@ -46,7 +46,7 @@ main();
 
 ### mastra/index.ts
 ```typescript
-import { Mastra } from '@mastra/core';
+import { Mastra } from '@mastra/core/mastra';
 
 import { myWorkflow } from './workflows';
 

package/.docs/organized/code-examples/workflow-with-suspend-resume.md

@@ -24,7 +24,7 @@ async function main() {
   console.log('🚀 Starting workflow with suspend/resume example...\n');
 
   const myWorkflow = mastra.getWorkflow('myWorkflow');
-  const run = await myWorkflow.createRunAsync();
+  const run = await myWorkflow.createRun();
 
   try {
     // Start the workflow - it will suspend at stepTwo
@@ -65,7 +65,7 @@ main();
 
 ### mastra/index.ts
 ```typescript
-import { Mastra } from '@mastra/core';
+import { Mastra } from '@mastra/core/mastra';
 import { LibSQLStore } from '@mastra/libsql';
 
 import { myWorkflow } from './workflows';
@@ -75,6 +75,7 @@ export const mastra = new Mastra({
     myWorkflow,
   },
   storage: new LibSQLStore({
+    id: 'workflow-snapshots-storage',
     url: 'file:./workflow-snapshots.db',
   }),
 });