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

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',
   }),
 });

package/.docs/raw/agents/adding-voice.mdx

@@ -22,7 +22,8 @@ const voice = new OpenAIVoice();
 
 // Create an agent with voice capabilities
 export const agent = new Agent({
-  name: "Agent",
+  id: "voice-agent",
+  name: "Voice Agent",
   instructions: `You are a helpful assistant with both STT and TTS capabilities.`,
   model: openai("gpt-4o"),
   voice,
@@ -110,7 +111,8 @@ const voice = new OpenAIRealtimeVoice({
 
 // Create an agent with speech-to-speech voice capabilities
 export const agent = new Agent({
-  name: "Agent",
+  id: "speech-to-speech-agent",
+  name: "Speech-to-Speech Agent",
   instructions: `You are a helpful assistant with speech-to-speech capabilities.`,
   model: openai("gpt-4o"),
   tools: {
@@ -175,7 +177,7 @@ import { createReadStream } from "fs";
 import { Agent } from "@mastra/core/agent";
 import { CompositeVoice } from "@mastra/core/voice";
 import { OpenAIVoice } from "@mastra/voice-openai";
-import { Mastra } from "@mastra/core/mastra";
+import { Mastra } from "@mastra/core";
 import { openai } from "@ai-sdk/openai";
 
 // Saves an audio stream to a file in the audio directory, creating the directory if it doesn't exist.
@@ -206,14 +208,15 @@ export const convertToText = async (
 
   const chunks: Buffer[] = [];
   return new Promise((resolve, reject) => {
-    input.on("data", (chunk) => chunks.push(Buffer.from(chunk)));
-    input.on("error", reject);
-    input.on("end", () => resolve(Buffer.concat(chunks).toString("utf-8")));
+    inputData.on("data", (chunk) => chunks.push(Buffer.from(chunk)));
+    inputData.on("error", reject);
+    inputData.on("end", () => resolve(Buffer.concat(chunks).toString("utf-8")));
   });
 };
 
 export const hybridVoiceAgent = new Agent({
-  name: "hybrid-voice-agent",
+  id: "hybrid-voice-agent",
+  name: "Hybrid Voice Agent",
   model: openai("gpt-4o"),
   instructions: "You can speak and listen using different providers.",
   voice: new CompositeVoice({
@@ -223,7 +226,8 @@ export const hybridVoiceAgent = new Agent({
 });
 
 export const unifiedVoiceAgent = new Agent({
-  name: "unified-voice-agent",
+  id: "unified-voice-agent",
+  name: "Unified Voice Agent",
   instructions: "You are an agent with both STT and TTS capabilities.",
   model: openai("gpt-4o"),
   voice: new OpenAIVoice(),
@@ -268,7 +272,8 @@ import { PlayAIVoice } from "@mastra/voice-playai";
 import { openai } from "@ai-sdk/openai";
 
 export const agent = new Agent({
-  name: "Agent",
+  id: "voice-agent",
+  name: "Voice Agent",
   instructions: `You are a helpful assistant with both STT and TTS capabilities.`,
   model: openai("gpt-4o"),
 
@@ -286,16 +291,16 @@ Mastra supports multiple voice providers for text-to-speech (TTS) and speech-to-
 
 | Provider        | Package                         | Features                  | Reference                                         |
 | --------------- | ------------------------------- | ------------------------- | ------------------------------------------------- |
-| OpenAI          | `@mastra/voice-openai`          | TTS, STT                  | [Documentation](/reference/voice/openai)          |
-| OpenAI Realtime | `@mastra/voice-openai-realtime` | Realtime speech-to-speech | [Documentation](/reference/voice/openai-realtime) |
-| ElevenLabs      | `@mastra/voice-elevenlabs`      | High-quality TTS          | [Documentation](/reference/voice/elevenlabs)      |
-| PlayAI          | `@mastra/voice-playai`          | TTS                       | [Documentation](/reference/voice/playai)          |
-| Google          | `@mastra/voice-google`          | TTS, STT                  | [Documentation](/reference/voice/google)          |
-| Deepgram        | `@mastra/voice-deepgram`        | STT                       | [Documentation](/reference/voice/deepgram)        |
-| Murf            | `@mastra/voice-murf`            | TTS                       | [Documentation](/reference/voice/murf)            |
-| Speechify       | `@mastra/voice-speechify`       | TTS                       | [Documentation](/reference/voice/speechify)       |
-| Sarvam          | `@mastra/voice-sarvam`          | TTS, STT                  | [Documentation](/reference/voice/sarvam)          |
-| Azure           | `@mastra/voice-azure`           | TTS, STT                  | [Documentation](/reference/voice/mastra-voice)    |
-| Cloudflare      | `@mastra/voice-cloudflare`      | TTS                       | [Documentation](/reference/voice/mastra-voice)    |
-
-For more details on voice capabilities, see the [Voice API Reference](/reference/voice/mastra-voice).
+| OpenAI          | `@mastra/voice-openai`          | TTS, STT                  | [Documentation](/reference/v1/voice/openai)          |
+| OpenAI Realtime | `@mastra/voice-openai-realtime` | Realtime speech-to-speech | [Documentation](/reference/v1/voice/openai-realtime) |
+| ElevenLabs      | `@mastra/voice-elevenlabs`      | High-quality TTS          | [Documentation](/reference/v1/voice/elevenlabs)      |
+| PlayAI          | `@mastra/voice-playai`          | TTS                       | [Documentation](/reference/v1/voice/playai)          |
+| Google          | `@mastra/voice-google`          | TTS, STT                  | [Documentation](/reference/v1/voice/google)          |
+| Deepgram        | `@mastra/voice-deepgram`        | STT                       | [Documentation](/reference/v1/voice/deepgram)        |
+| Murf            | `@mastra/voice-murf`            | TTS                       | [Documentation](/reference/v1/voice/murf)            |
+| Speechify       | `@mastra/voice-speechify`       | TTS                       | [Documentation](/reference/v1/voice/speechify)       |
+| Sarvam          | `@mastra/voice-sarvam`          | TTS, STT                  | [Documentation](/reference/v1/voice/sarvam)          |
+| Azure           | `@mastra/voice-azure`           | TTS, STT                  | [Documentation](/reference/v1/voice/mastra-voice)    |
+| Cloudflare      | `@mastra/voice-cloudflare`      | TTS                       | [Documentation](/reference/v1/voice/mastra-voice)    |
+
+For more details on voice capabilities, see the [Voice API Reference](/reference/v1/voice/mastra-voice).

package/.docs/raw/agents/agent-memory.mdx

@@ -26,7 +26,7 @@ npm install @mastra/memory@latest @mastra/libsql@latest
 
 ## Storage providers
 
-Memory requires a storage provider to persist conversation history, including user messages and agent responses. For more details on available providers and how storage works in Mastra, see the [Storage](/docs/server-db/storage) documentation.
+Memory requires a storage provider to persist conversation history, including user messages and agent responses. For more details on available providers and how storage works in Mastra, see the [Storage](/docs/v1/server-db/storage) documentation.
 
 ## Configuring memory
 
@@ -40,6 +40,8 @@ import { Agent } from "@mastra/core/agent";
 import { Memory } from "@mastra/memory";
 
 export const memoryAgent = new Agent({
+  id: 'memory-agent',
+  name: 'Memory Agent',
   // ...
   memory: new Memory({
     options: {
@@ -51,7 +53,7 @@ export const memoryAgent = new Agent({
 
 :::note
 
-See the [Memory Class](/reference/memory/memory-class) docs for a full list of configuration options.
+See the [Memory Class](/reference/v1/memory/memory-class) docs for a full list of configuration options.
 
 :::
 
@@ -62,12 +64,13 @@ See the [Memory Class](/reference/memory/memory-class) docs for a full list of c
 Add a storage provider to your main Mastra instance to enable memory across all configured agents.
 
 ```typescript {6-8} title="src/mastra/index.ts" copy
-import { Mastra } from "@mastra/core/mastra";
+import { Mastra } from "@mastra/core";
 import { LibSQLStore } from "@mastra/libsql";
 
 export const mastra = new Mastra({
   // ..
   storage: new LibSQLStore({
+    id: 'mastra-storage',
     url: ":memory:",
   }),
 });
@@ -75,7 +78,7 @@ export const mastra = new Mastra({
 
 :::note
 
-See the [LibSQL Storage](/reference/storage/libsql) docs for a full list of configuration options.
+See the [LibSQL Storage](/reference/v1/storage/libsql) docs for a full list of configuration options.
 
 :::
 
@@ -90,9 +93,12 @@ import { Memory } from "@mastra/memory";
 import { LibSQLStore } from "@mastra/libsql";
 
 export const memoryAgent = new Agent({
+  id: 'memory-agent',
+  name: 'Memory Agent',
   // ...
   memory: new Memory({
     storage: new LibSQLStore({
+      id: 'mastra-storage',
       url: ":memory:",
     }),
   }),
@@ -108,13 +114,13 @@ Include a `memory` object with both `resource` and `thread` to track conversatio
 
 These fields tell the agent where to store and retrieve context, enabling persistent, thread-aware memory across a conversation.
 
-```typescript {3-4}
+```typescript {5-6}
 const response = await memoryAgent.generate(
   "Remember my favorite color is blue.",
   {
     memory: {
-      thread: "user-123",
-      resource: "test-123",
+      resource: "user-123",
+      thread: "conversation-123",
     },
   },
 );
@@ -125,17 +131,17 @@ To recall information stored in memory, call the agent with the same `resource`
 ```typescript {3-4}
 const response = await memoryAgent.generate("What's my favorite color?", {
   memory: {
-    thread: "user-123",
-    resource: "test-123",
+    resource: "user-123",
+    thread: "conversation-123",
   },
 });
 ```
 
 To learn more about memory see the [Memory](../memory/overview) documentation.
 
-## Using `RuntimeContext`
+## Using `RequestContext`
 
-Use [RuntimeContext](/docs/server-db/runtime-context) to access request-specific values. This lets you conditionally select different memory or storage configurations based on the context of the request.
+Use [RequestContext](/docs/v1/server-db/request-context) to access request-specific values. This lets you conditionally select different memory or storage configurations based on the context of the request.
 
 ```typescript title="src/mastra/agents/memory-agent.ts" showLineNumbers
 export type UserTier = {
@@ -151,9 +157,11 @@ const standardMemory = new Memory({
 });
 
 export const memoryAgent = new Agent({
+  id: 'memory-agent',
+  name: 'Memory Agent',
   // ...
-  memory: ({ runtimeContext }) => {
-    const userTier = runtimeContext.get("user-tier") as UserTier["user-tier"];
+  memory: ({ requestContext }) => {
+    const userTier = requestContext.get("user-tier") as UserTier["user-tier"];
 
     return userTier === "enterprise" ? premiumMemory : standardMemory;
   },
@@ -162,7 +170,7 @@ export const memoryAgent = new Agent({
 
 :::note
 
-See [Runtime Context](/docs/server-db/runtime-context) docs for more information.
+See [Request Context](/docs/v1/server-db/request-context) docs for more information.
 
 :::
 
@@ -171,4 +179,4 @@ See [Runtime Context](/docs/server-db/runtime-context) docs for more information
 - [Working Memory](../memory/working-memory)
 - [Semantic Recall](../memory/semantic-recall)
 - [Threads and Resources](../memory/threads-and-resources)
-- [Runtime Context](/docs/server-db/runtime-context)
+- [Request Context](/docs/v1/server-db/request-context)

package/.docs/raw/agents/guardrails.mdx

@@ -28,7 +28,8 @@ import { Agent } from "@mastra/core/agent";
 import { ModerationProcessor } from "@mastra/core/processors";
 
 export const moderatedAgent = new Agent({
-  name: "moderated-agent",
+  id: "moderated-agent",
+  name: "Moderated Agent",
   instructions: "You are a helpful assistant",
   model: openai("gpt-4o-mini"),
   inputProcessors: [
@@ -55,6 +56,8 @@ The `UnicodeNormalizer` is an input processor that cleans and normalizes user in
 import { UnicodeNormalizer } from "@mastra/core/processors";
 
 export const normalizedAgent = new Agent({
+  id: "normalized-agent",
+  name: "Normalized Agent",
   // ...
   inputProcessors: [
     new UnicodeNormalizer({
@@ -65,7 +68,7 @@ export const normalizedAgent = new Agent({
 });
 ```
 
-> See [UnicodeNormalizer](/reference/processors/unicode-normalizer) for a full list of configuration options.
+> See [UnicodeNormalizer](/reference/v1/processors/unicode-normalizer) for a full list of configuration options.
 
 ### Preventing prompt injection
 
@@ -75,6 +78,8 @@ The `PromptInjectionDetector` is an input processor that scans user messages for
 import { PromptInjectionDetector } from "@mastra/core/processors";
 
 export const secureAgent = new Agent({
+  id: "secure-agent",
+  name: "Secure Agent",
   // ...
   inputProcessors: [
     new PromptInjectionDetector({
@@ -87,7 +92,7 @@ export const secureAgent = new Agent({
 });
 ```
 
-> See [PromptInjectionDetector](/reference/processors/prompt-injection-detector) for a full list of configuration options.
+> See [PromptInjectionDetector](/reference/v1/processors/prompt-injection-detector) for a full list of configuration options.
 
 ### Detecting and translating language
 
@@ -97,6 +102,8 @@ The `LanguageDetector` is an input processor that detects and translates user me
 import { LanguageDetector } from "@mastra/core/processors";
 
 export const multilingualAgent = new Agent({
+  id: "multilingual-agent",
+  name: "Multilingual Agent",
   // ...
   inputProcessors: [
     new LanguageDetector({
@@ -109,7 +116,7 @@ export const multilingualAgent = new Agent({
 });
 ```
 
-> See [LanguageDetector](/reference/processors/language-detector) for a full list of configuration options.
+> See [LanguageDetector](/reference/v1/processors/language-detector) for a full list of configuration options.
 
 ## Output processors
 
@@ -123,6 +130,8 @@ The `BatchPartsProcessor` is an output processor that combines multiple stream p
 import { BatchPartsProcessor } from "@mastra/core/processors";
 
 export const batchedAgent = new Agent({
+  id: "batched-agent",
+  name: "Batched Agent",
   // ...
   outputProcessors: [
     new BatchPartsProcessor({
@@ -134,7 +143,7 @@ export const batchedAgent = new Agent({
 });
 ```
 
-> See [BatchPartsProcessor](/reference/processors/batch-parts-processor) for a full list of configuration options.
+> See [BatchPartsProcessor](/reference/v1/processors/batch-parts-processor) for a full list of configuration options.
 
 ### Limiting token usage
 
@@ -144,6 +153,8 @@ The `TokenLimiterProcessor` is an output processor that limits the number of tok
 import { TokenLimiterProcessor } from "@mastra/core/processors";
 
 export const limitedAgent = new Agent({
+  id: "limited-agent",
+  name: "Limited Agent",
   // ...
   outputProcessors: [
     new TokenLimiterProcessor({
@@ -155,7 +166,7 @@ export const limitedAgent = new Agent({
 });
 ```
 
-> See [TokenLimiterProcessor](/reference/processors/token-limiter-processor) for a full list of configuration options.
+> See [TokenLimiterProcessor](/reference/v1/processors/token-limiter-processor) for a full list of configuration options.
 
 ### Scrubbing system prompts
 
@@ -165,6 +176,8 @@ The `SystemPromptScrubber` is an output processor that detects and redacts syste
 import { SystemPromptScrubber } from "@mastra/core/processors";
 
 const scrubbedAgent = new Agent({
+  id: "scrubbed-agent",
+  name: "Scrubbed Agent",
   outputProcessors: [
     new SystemPromptScrubber({
       model: openai("gpt-4.1-nano"),
@@ -180,7 +193,7 @@ const scrubbedAgent = new Agent({
 });
 ```
 
-> See [SystemPromptScrubber](/reference/processors/system-prompt-scrubber) for a full list of configuration options.
+> See [SystemPromptScrubber](/reference/v1/processors/system-prompt-scrubber) for a full list of configuration options.
 
 ## Hybrid processors
 
@@ -194,6 +207,8 @@ The `ModerationProcessor` is a hybrid processor that detects inappropriate or ha
 import { ModerationProcessor } from "@mastra/core/processors";
 
 export const moderatedAgent = new Agent({
+  id: "moderated-agent",
+  name: "Moderated Agent",
   // ...
   inputProcessors: [
     new ModerationProcessor({
@@ -211,7 +226,7 @@ export const moderatedAgent = new Agent({
 });
 ```
 
-> See [ModerationProcessor](/reference/processors/moderation-processor) for a full list of configuration options.
+> See [ModerationProcessor](/reference/v1/processors/moderation-processor) for a full list of configuration options.
 
 ### Detecting and redacting PII
 
@@ -221,6 +236,8 @@ The `PIIDetector` is a hybrid processor that detects and removes personally iden
 import { PIIDetector } from "@mastra/core/processors";
 
 export const privateAgent = new Agent({
+  id: "private-agent",
+  name: "Private Agent",
   // ...
   inputProcessors: [
     new PIIDetector({
@@ -240,7 +257,7 @@ export const privateAgent = new Agent({
 });
 ```
 
-> See [PIIDetector](/reference/processors/pii-detector) for a full list of configuration options.
+> See [PIIDetector](/reference/v1/processors/pii-detector) for a full list of configuration options.
 
 ## Applying multiple processors
 
@@ -263,6 +280,8 @@ import {
 } from "@mastra/core/processors";
 
 export const testAgent = new Agent({
+  id: "test-agent",
+  name: "Test Agent",
   // ...
   inputProcessors: [
     new UnicodeNormalizer({
@@ -291,6 +310,8 @@ Most strategies allow the request to continue without interruption. When `block`
 import { PIIDetector } from "@mastra/core/processors";
 
 export const privateAgent = new Agent({
+  id: "private-agent",
+  name: "Private Agent",
   // ...
   inputProcessors: [
     new PIIDetector({
@@ -344,6 +365,6 @@ If the built-in processors don’t cover your needs, you can create your own by
 
 Available examples:
 
-- [Message Length Limiter](../../examples/processors/message-length-limiter)
-- [Response Length Limiter](../../examples/processors/response-length-limiter)
-- [Response Validator](../../examples/processors/response-validator)
+- [Message Length Limiter](/examples/v1/processors/message-length-limiter)
+- [Response Length Limiter](/examples/v1/processors/response-length-limiter)
+- [Response Validator](/examples/v1/processors/response-validator)

package/.docs/raw/agents/networks.mdx

@@ -36,7 +36,8 @@ import { cityWorkflow } from "../workflows/city-workflow";
 import { weatherTool } from "../tools/weather-tool";
 
 export const routingAgent = new Agent({
-  name: "routing-agent",
+  id: "routing-agent",
+  name: "Routing Agent",
   instructions: `
       You are a network of writers and researchers.
       The user will ask you to research a topic.
@@ -56,6 +57,7 @@ export const routingAgent = new Agent({
   },
   memory: new Memory({
     storage: new LibSQLStore({
+      id: 'mastra-storage',
       url: "file:../mastra.db",
     }),
   }),
@@ -72,7 +74,8 @@ Each agent in a network should include a clear `description` that explains what
 
 ```typescript title="src/mastra/agents/research-agent.ts" showLineNumbers
 export const researchAgent = new Agent({
-  name: "research-agent",
+  id: "research-agent",
+  name: "Research Agent",
   description: `This agent gathers concise research insights in bullet-point form.
     It's designed to extract key facts without generating full
     responses or narrative content.`,
@@ -82,7 +85,8 @@ export const researchAgent = new Agent({
 
 ```typescript title="src/mastra/agents/writing-agent.ts" showLineNumbers
 export const writingAgent = new Agent({
-  name: "writing-agent",
+  id: "writing-agent",
+  name: "Writing Agent",
   description: `This agent turns researched material into well-structured
     written content. It produces full-paragraph reports with no bullet points,
     suitable for use in articles, summaries, or blog posts.`,
@@ -236,4 +240,4 @@ network-execution-event-step-finish
 
 - [Agent Memory](./agent-memory)
 - [Workflows Overview](../workflows/overview)
-- [Runtime Context](/docs/server-db/runtime-context)
+- [Request Context](/docs/v1/server-db/request-context)