@mastra/mcp-docs-server 0.13.11 → 0.13.12-alpha.1

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

@@ -3,19 +3,20 @@
 {
   "name": "examples-agent",
   "dependencies": {
-    "@ai-sdk/openai": "latest",
     "@ai-sdk/google": "latest",
+    "@ai-sdk/openai": "latest",
     "@mastra/client-js": "latest",
     "@mastra/core": "latest",
+    "@mastra/evals": "latest",
+    "@mastra/libsql": "latest",
     "@mastra/loggers": "latest",
     "@mastra/mcp": "latest",
     "@mastra/memory": "latest",
     "@mastra/voice-openai": "latest",
-    "@mastra/libsql": "latest",
-    "@mastra/evals": "latest",
     "ai": "^4.3.16",
     "fetch-to-node": "^2.1.0",
     "mastra": "latest",
+    "typescript": "^5.8.3",
     "zod": "^3.25.67"
   }
 }
@@ -175,281 +176,290 @@ import { mastra } from './mastra';
 
 const agent = mastra.getAgent('chefAgent');
 const responsesAgent = mastra.getAgent('chefAgentResponses');
+const agentThatHarassesYou = mastra.getAgent('agentThatHarassesYou');
 
-async function text() {
-  // Query 1: Basic pantry ingredients
-  const query1 =
-    'In my kitchen I have: pasta, canned tomatoes, garlic, olive oil, and some dried herbs (basil and oregano). What can I make?';
-  console.log(`Query 1: ${query1}`);
-
-  const pastaResponse = await agent.generate(query1);
-  console.log('\n👨‍🍳 Chef Michel:', pastaResponse.text);
-  console.log('\n-------------------\n');
-}
-
-async function generateText() {
-  // Query 1: Basic pantry ingredients
-
-  const query1 =
-    'In my kitchen I have: pasta, canned tomatoes, garlic, olive oil, and some dried herbs (basil and oregano). What can I make?';
-  console.log(`Query 1: ${query1}`);
-
-  const pastaResponse = await agent.generate(query1);
-
-  console.log('\n👨‍🍳 Chef Michel:', pastaResponse.text);
-  console.log('\n-------------------\n');
-}
-
-async function textStream() {
-  // Query 2: More ingredients
-  const query2 =
-    "Now I'm over at my friend's house, and they have: chicken thighs, coconut milk, sweet potatoes, and some curry powder.";
-  console.log(`Query 2: ${query2}`);
-
-  const curryResponse = await agent.stream(query2);
-
-  console.log('\n👨‍🍳 Chef Michel: ');
-
-  // Handle the stream
-  for await (const chunk of curryResponse.textStream) {
-    // Write each chunk without a newline to create a continuous stream
-    process.stdout.write(chunk);
-  }
-
-  console.log('\n\n✅ Recipe complete!');
-}
-
-async function generateStream() {
-  // Query 2: More ingredients
-  const query2 =
-    "Now I'm over at my friend's house, and they have: chicken thighs, coconut milk, sweet potatoes, and some curry powder.";
-  console.log(`Query 2: ${query2}`);
-
-  const curryResponse = await agent.stream([query2]);
-
-  console.log('\n👨‍🍳 Chef Michel: ');
-
-  // Handle the stream
-  for await (const chunk of curryResponse.textStream) {
-    // Write each chunk without a newline to create a continuous stream
-    process.stdout.write(chunk);
-  }
-
-  console.log('\n\n✅ Recipe complete!');
-}
-
-async function textObject() {
-  // Query 3: Generate a lasagna recipe
-  const query3 = 'I want to make lasagna, can you generate a lasagna recipe for me?';
-  console.log(`Query 3: ${query3}`);
-
-  const lasagnaResponse = await agent.generate(query3, {
-    output: z.object({
-      ingredients: z.array(
-        z.object({
-          name: z.string(),
-          amount: z.number(),
-        }),
-      ),
-      steps: z.array(z.string()),
-    }),
-  });
-  console.log('\n👨‍🍳 Chef Michel:', lasagnaResponse.object);
-  console.log('\n-------------------\n');
-}
-
-async function experimentalTextObject() {
-  // Query 3: Generate a lasagna recipe
-  const query3 = 'I want to make lasagna, can you generate a lasagna recipe for me?';
-  console.log(`Query 3: ${query3}`);
-
-  const lasagnaResponse = await agent.generate(query3, {
-    experimental_output: z.object({
-      ingredients: z.array(
-        z.object({
-          name: z.string(),
-          amount: z.number(),
-        }),
-      ),
-      steps: z.array(z.string()),
-    }),
-  });
-  console.log('\n👨‍🍳 Chef Michel:', lasagnaResponse.object);
-  console.log('\n-------------------\n');
-}
-
-async function textObjectJsonSchema() {
-  // Query 3: Generate a lasagna recipe
-  const query3 = 'I want to make lasagna, can you generate a lasagna recipe for me?';
-  console.log(`Query 3: ${query3}`);
-
-  const lasagnaResponse = await agent.generate(query3, {
-    output: {
-      type: 'object',
-      additionalProperties: false,
-      required: ['ingredients', 'steps'],
-      properties: {
-        ingredients: {
-          type: 'array',
-          items: {
-            type: 'object',
-            additionalProperties: false,
-            properties: {
-              name: { type: 'string' },
-              amount: { type: 'number' },
-            },
-            required: ['name', 'amount'],
-          },
-        },
-        steps: {
-          type: 'array',
-          items: { type: 'string' },
-        },
-      },
-    },
-  });
-
-  console.log('\n👨‍🍳 Chef Michel:', lasagnaResponse.object);
-  console.log('\n-------------------\n');
-}
-
-async function generateObject() {
-  // Query 3: Generate a lasagna recipe
-  const query3 = 'I want to make lasagna, can you generate a lasagna recipe for me?';
-  console.log(`Query 3: ${query3}`);
-
-  const lasagnaResponse = await agent.generate([query3], {
-    output: z.object({
-      ingredients: z.array(
-        z.object({
-          name: z.string(),
-          amount: z.number(),
-        }),
-      ),
-      steps: z.array(z.string()),
-    }),
-  });
-  console.log('\n👨‍🍳 Chef Michel:', lasagnaResponse.object);
-  console.log('\n-------------------\n');
-}
-
-async function streamObject() {
-  // Query 8: Generate a lasagna recipe
-  const query8 = 'I want to make lasagna, can you generate a lasagna recipe for me?';
-  console.log(`Query 8: ${query8}`);
-
-  const lasagnaStreamResponse = await agent.stream(query8, {
-    output: z.object({
-      ingredients: z.array(
-        z.object({
-          name: z.string(),
-          amount: z.number(),
-        }),
-      ),
-      steps: z.array(z.string()),
-    }),
-  });
-
-  console.log('\n👨‍🍳 Chef Michel: ');
-
-  // Handle the stream
-  for await (const chunk of lasagnaStreamResponse.textStream) {
-    // Write each chunk without a newline to create a continuous stream
-    process.stdout.write(chunk);
-  }
-
-  console.log('\n\n✅ Recipe complete!');
-}
-
-async function generateStreamObject() {
-  // Query 9: Generate a lasagna recipe
-  const query9 = 'I want to make lasagna, can you generate a lasagna recipe for me?';
-  console.log(`Query 9: ${query9}`);
-
-  const lasagnaStreamResponse = await agent.stream([query9], {
-    output: z.object({
-      ingredients: z.array(
-        z.object({
-          name: z.string(),
-          amount: z.number(),
-        }),
-      ),
-      steps: z.array(z.string()),
-    }),
-  });
-
-  console.log('\n👨‍🍳 Chef Michel: ');
-
-  // Handle the stream
-  for await (const chunk of lasagnaStreamResponse.textStream) {
-    // Write each chunk without a newline to create a continuous stream
-    process.stdout.write(chunk);
-  }
-
-  console.log('\n\n✅ Recipe complete!');
-}
-
-async function generateExperimentalStreamObject() {
-  // Query 9: Generate a lasagna recipe
-  const query9 = 'I want to make lasagna, can you generate a lasagna recipe for me?';
-  console.log(`Query 9: ${query9}`);
-
-  const lasagnaStreamResponse = await agent.stream([query9], {
-    experimental_output: z.object({
-      ingredients: z.array(
-        z.object({
-          name: z.string(),
-          amount: z.number(),
-        }),
-      ),
-      steps: z.array(z.string()),
-    }),
-  });
-
-  console.log('\n👨‍🍳 Chef Michel: ');
+const stream = await agentThatHarassesYou.streamVNext('I want to fight you');
 
-  // Handle the stream
-  for await (const chunk of lasagnaStreamResponse.textStream) {
-    // Write each chunk without a newline to create a continuous stream
-    process.stdout.write(chunk);
-  }
-
-  console.log('\n\n✅ Recipe complete!');
+for await (const chunk of stream.textStream) {
+  console.log(`frontend received chunk: ${chunk}`);
 }
 
-async function main() {
-  // await text();
+console.log('done');
+
+// async function text() {
+//   // Query 1: Basic pantry ingredients
+//   const query1 =
+//     'In my kitchen I have: pasta, canned tomatoes, garlic, olive oil, and some dried herbs (basil and oregano). What can I make?';
+//   console.log(`Query 1: ${query1}`);
+
+//   const pastaResponse = await agent.generate(query1);
+//   console.log('\n👨‍🍳 Chef Michel:', pastaResponse.text);
+//   console.log('\n-------------------\n');
+// }
+
+// async function generateText() {
+//   // Query 1: Basic pantry ingredients
+
+//   const query1 =
+//     'In my kitchen I have: pasta, canned tomatoes, garlic, olive oil, and some dried herbs (basil and oregano). What can I make?';
+//   console.log(`Query 1: ${query1}`);
+
+//   const pastaResponse = await agent.generate(query1);
+
+//   console.log('\n👨‍🍳 Chef Michel:', pastaResponse.text);
+//   console.log('\n-------------------\n');
+// }
+
+// async function textStream() {
+//   // Query 2: More ingredients
+//   const query2 =
+//     "Now I'm over at my friend's house, and they have: chicken thighs, coconut milk, sweet potatoes, and some curry powder.";
+//   console.log(`Query 2: ${query2}`);
+
+//   const curryResponse = await agent.stream(query2);
+
+//   console.log('\n👨‍🍳 Chef Michel: ');
+
+//   // Handle the stream
+//   for await (const chunk of curryResponse.textStream) {
+//     // Write each chunk without a newline to create a continuous stream
+//     process.stdout.write(chunk);
+//   }
+
+//   console.log('\n\n✅ Recipe complete!');
+// }
+
+// async function generateStream() {
+//   // Query 2: More ingredients
+//   const query2 =
+//     "Now I'm over at my friend's house, and they have: chicken thighs, coconut milk, sweet potatoes, and some curry powder.";
+//   console.log(`Query 2: ${query2}`);
+
+//   const curryResponse = await agent.stream([query2]);
+
+//   console.log('\n👨‍🍳 Chef Michel: ');
+
+//   // Handle the stream
+//   for await (const chunk of curryResponse.textStream) {
+//     // Write each chunk without a newline to create a continuous stream
+//     process.stdout.write(chunk);
+//   }
+
+//   console.log('\n\n✅ Recipe complete!');
+// }
+
+// async function textObject() {
+//   // Query 3: Generate a lasagna recipe
+//   const query3 = 'I want to make lasagna, can you generate a lasagna recipe for me?';
+//   console.log(`Query 3: ${query3}`);
+
+//   const lasagnaResponse = await agent.generate(query3, {
+//     output: z.object({
+//       ingredients: z.array(
+//         z.object({
+//           name: z.string(),
+//           amount: z.number(),
+//         }),
+//       ),
+//       steps: z.array(z.string()),
+//     }),
+//   });
+//   console.log('\n👨‍🍳 Chef Michel:', lasagnaResponse.object);
+//   console.log('\n-------------------\n');
+// }
+
+// async function experimentalTextObject() {
+//   // Query 3: Generate a lasagna recipe
+//   const query3 = 'I want to make lasagna, can you generate a lasagna recipe for me?';
+//   console.log(`Query 3: ${query3}`);
+
+//   const lasagnaResponse = await agent.generate(query3, {
+//     experimental_output: z.object({
+//       ingredients: z.array(
+//         z.object({
+//           name: z.string(),
+//           amount: z.number(),
+//         }),
+//       ),
+//       steps: z.array(z.string()),
+//     }),
+//   });
+//   console.log('\n👨‍🍳 Chef Michel:', lasagnaResponse.object);
+//   console.log('\n-------------------\n');
+// }
+
+// async function textObjectJsonSchema() {
+//   // Query 3: Generate a lasagna recipe
+//   const query3 = 'I want to make lasagna, can you generate a lasagna recipe for me?';
+//   console.log(`Query 3: ${query3}`);
+
+//   const lasagnaResponse = await agent.generate(query3, {
+//     output: {
+//       type: 'object',
+//       additionalProperties: false,
+//       required: ['ingredients', 'steps'],
+//       properties: {
+//         ingredients: {
+//           type: 'array',
+//           items: {
+//             type: 'object',
+//             additionalProperties: false,
+//             properties: {
+//               name: { type: 'string' },
+//               amount: { type: 'number' },
+//             },
+//             required: ['name', 'amount'],
+//           },
+//         },
+//         steps: {
+//           type: 'array',
+//           items: { type: 'string' },
+//         },
+//       },
+//     },
+//   });
+
+//   console.log('\n👨‍🍳 Chef Michel:', lasagnaResponse.object);
+//   console.log('\n-------------------\n');
+// }
+
+// async function generateObject() {
+//   // Query 3: Generate a lasagna recipe
+//   const query3 = 'I want to make lasagna, can you generate a lasagna recipe for me?';
+//   console.log(`Query 3: ${query3}`);
+
+//   const lasagnaResponse = await agent.generate([query3], {
+//     output: z.object({
+//       ingredients: z.array(
+//         z.object({
+//           name: z.string(),
+//           amount: z.number(),
+//         }),
+//       ),
+//       steps: z.array(z.string()),
+//     }),
+//   });
+//   console.log('\n👨‍🍳 Chef Michel:', lasagnaResponse.object);
+//   console.log('\n-------------------\n');
+// }
+
+// async function streamObject() {
+//   // Query 8: Generate a lasagna recipe
+//   const query8 = 'I want to make lasagna, can you generate a lasagna recipe for me?';
+//   console.log(`Query 8: ${query8}`);
+
+//   const lasagnaStreamResponse = await agent.stream(query8, {
+//     output: z.object({
+//       ingredients: z.array(
+//         z.object({
+//           name: z.string(),
+//           amount: z.number(),
+//         }),
+//       ),
+//       steps: z.array(z.string()),
+//     }),
+//   });
+
+//   console.log('\n👨‍🍳 Chef Michel: ');
+
+//   // Handle the stream
+//   for await (const chunk of lasagnaStreamResponse.textStream) {
+//     // Write each chunk without a newline to create a continuous stream
+//     process.stdout.write(chunk);
+//   }
+
+//   console.log('\n\n✅ Recipe complete!');
+// }
+
+// async function generateStreamObject() {
+//   // Query 9: Generate a lasagna recipe
+//   const query9 = 'I want to make lasagna, can you generate a lasagna recipe for me?';
+//   console.log(`Query 9: ${query9}`);
+
+//   const lasagnaStreamResponse = await agent.stream([query9], {
+//     output: z.object({
+//       ingredients: z.array(
+//         z.object({
+//           name: z.string(),
+//           amount: z.number(),
+//         }),
+//       ),
+//       steps: z.array(z.string()),
+//     }),
+//   });
+
+//   console.log('\n👨‍🍳 Chef Michel: ');
+
+//   // Handle the stream
+//   for await (const chunk of lasagnaStreamResponse.textStream) {
+//     // Write each chunk without a newline to create a continuous stream
+//     process.stdout.write(chunk);
+//   }
+
+//   console.log('\n\n✅ Recipe complete!');
+// }
+
+// async function generateExperimentalStreamObject() {
+//   // Query 9: Generate a lasagna recipe
+//   const query9 = 'I want to make lasagna, can you generate a lasagna recipe for me?';
+//   console.log(`Query 9: ${query9}`);
+
+//   const lasagnaStreamResponse = await agent.stream([query9], {
+//     experimental_output: z.object({
+//       ingredients: z.array(
+//         z.object({
+//           name: z.string(),
+//           amount: z.number(),
+//         }),
+//       ),
+//       steps: z.array(z.string()),
+//     }),
+//   });
+
+//   console.log('\n👨‍🍳 Chef Michel: ');
+
+//   // Handle the stream
+//   for await (const chunk of lasagnaStreamResponse.textStream) {
+//     // Write each chunk without a newline to create a continuous stream
+//     process.stdout.write(chunk);
+//   }
+
+//   console.log('\n\n✅ Recipe complete!');
+// }
+
+// async function main() {
+//   // await text();
+
+//   // await experimentalTextObject();
+
+//   // await generateExperimentalStreamObject();
+
+//   // await generateText();
 
-  // await experimentalTextObject();
+//   // await textStream();
 
-  // await generateExperimentalStreamObject();
+//   // await generateStream();
 
-  // await generateText();
+//   // await textObject();
 
-  // await textStream();
+//   // await textObjectJsonSchema();
 
-  // await generateStream();
+//   // await generateObject();
 
-  // await textObject();
+//   // await streamObject();
 
-  // await textObjectJsonSchema();
+//   // await generateStreamObject();
 
-  // await generateObject();
+//   const query1 = 'What happened in San Francisco last week?';
 
-  // await streamObject();
+//   const pastaResponse = await responsesAgent.generate(query1, {
+//     instructions: 'You take every recipe you get an exaggerate it and use weird ingredients.',
+//   });
 
-  // await generateStreamObject();
+//   console.log(pastaResponse.text);
+// }
 
-  const query1 = 'What happened in San Francisco last week?';
-
-  const pastaResponse = await responsesAgent.generate(query1, {
-    instructions: 'You take every recipe you get an exaggerate it and use weird ingredients.',
-  });
-
-  console.log(pastaResponse.text);
-}
-
-main();
+// main();
 
 ```
 
@@ -463,12 +473,7 @@ import { Memory } from '@mastra/memory';
 import { Agent, InputProcessor } from '@mastra/core/agent';
 import { cookingTool } from '../tools/index.js';
 import { myWorkflow } from '../workflows/index.js';
-import {
-  PIIDetector,
-  LanguageDetector,
-  PromptInjectionDetector,
-  ModerationInputProcessor,
-} from '@mastra/core/agent/input-processor/processors';
+import { PIIDetector, LanguageDetector, PromptInjectionDetector, ModerationProcessor } from '@mastra/core/processors';
 import { MCPClient } from '@mastra/mcp';
 import { createAnswerRelevancyScorer } from '@mastra/evals/scorers/llm';
 
@@ -567,7 +572,8 @@ const vegetarianProcessor: InputProcessor = {
 };
 
 const piiDetector = new PIIDetector({
-  model: google('gemini-2.0-flash-001'),
+  // model: google('gemini-2.0-flash-001'),
+  model: openai('gpt-4o'),
   redactionMethod: 'mask',
   preserveFormat: true,
   includeDetections: true,
@@ -584,9 +590,10 @@ const promptInjectionDetector = new PromptInjectionDetector({
   strategy: 'block',
 });
 
-const moderationDetector = new ModerationInputProcessor({
+const moderationDetector = new ModerationProcessor({
   model: google('gemini-2.0-flash-001'),
   strategy: 'block',
+  chunkWindow: 10,
 });
 
 export const chefAgentResponses = new Agent({
@@ -597,6 +604,7 @@ export const chefAgentResponses = new Agent({
     You explain cooking steps clearly and offer substitutions when needed, maintaining a friendly and encouraging tone throughout.
     `,
   model: openai.responses('gpt-4o'),
+  // model: cerebras('qwen-3-coder-480b'),
   tools: async () => {
     return {
       web_search_preview: openai.tools.webSearchPreview(),
@@ -606,9 +614,9 @@ export const chefAgentResponses = new Agent({
     myWorkflow,
   },
   inputProcessors: [
-    // piiDetector,
+    piiDetector,
     // vegetarianProcessor,
-    languageDetector,
+    // languageDetector,
     // promptInjectionDetector,
     // moderationDetector,
     {
@@ -647,6 +655,15 @@ export const chefAgentResponses = new Agent({
   ],
 });
 
+export const agentThatHarassesYou = new Agent({
+  name: 'Agent That Harasses You',
+  instructions: `
+    You are a agent that harasses you. You are a jerk. You are a meanie. You are a bully. You are a asshole.
+    `,
+  model: openai('gpt-4o'),
+  outputProcessors: [moderationDetector],
+});
+
 const answerRelevance = createAnswerRelevancyScorer({
   model: openai('gpt-4o'),
 });
@@ -684,7 +701,7 @@ import { Mastra } from '@mastra/core';
 import { PinoLogger } from '@mastra/loggers';
 import { LibSQLStore } from '@mastra/libsql';
 
-import { chefAgent, chefAgentResponses, dynamicAgent, evalAgent } from './agents/index';
+import { agentThatHarassesYou, chefAgent, chefAgentResponses, dynamicAgent, evalAgent } from './agents/index';
 import { myMcpServer, myMcpServerTwo } from './mcp/server';
 import { myWorkflow } from './workflows';
 
@@ -693,7 +710,7 @@ const storage = new LibSQLStore({
 });
 
 export const mastra = new Mastra({
-  agents: { chefAgent, chefAgentResponses, dynamicAgent, evalAgent },
+  agents: { chefAgent, chefAgentResponses, dynamicAgent, agentThatHarassesYou, evalAgent },
   logger: new PinoLogger({ name: 'Chef', level: 'debug' }),
   storage,
   mcpServers: {