@mastra/mcp-docs-server 0.13.37 → 0.13.38

package/.docs/raw/reference/agents/network.mdx

@@ -1,29 +1,30 @@
 ---
-title: "Reference: Agent.network() (Experimental) | Agents | Mastra Docs"
+title: "Reference: Agent.network() | Agents | Mastra Docs"
 description: "Documentation for the `Agent.network()` method in Mastra agents, which enables multi-agent collaboration and routing."
 ---
 
-import { NetworkCallout } from "@/components/network-callout.tsx"
-
 # Agent.network()
 
-<NetworkCallout />
+:::caution Experimental Feature
+This is an experimental API that may change in future versions. The `network()` method enables multi-agent collaboration and workflow orchestration. Use with caution in production environments.
+:::
 
 The `.network()` method enables multi-agent collaboration and routing. This method accepts messages and optional execution options.
 
 ## Usage example
 
 ```typescript copy
-import { Agent } from '@mastra/core/agent';
-import { openai } from '@ai-sdk/openai';
-import { agent1, agent2 } from './agents';
-import { workflow1 } from './workflows';
-import { tool1, tool2 } from './tools';
+import { Agent } from "@mastra/core/agent";
+import { openai } from "@ai-sdk/openai";
+import { agent1, agent2 } from "./agents";
+import { workflow1 } from "./workflows";
+import { tool1, tool2 } from "./tools";
 
 const agent = new Agent({
-  name: 'network-agent',
-  instructions: 'You are a network agent that can help users with a variety of tasks.',
-  model: openai('gpt-4o'),
+  name: "network-agent",
+  instructions:
+    "You are a network agent that can help users with a variety of tasks.",
+  model: openai("gpt-4o"),
   agents: {
     agent1,
     agent2,
@@ -35,7 +36,7 @@ const agent = new Agent({
     tool1,
     tool2,
   },
-})
+});
 
 await agent.network(`
   Find me the weather in Tokyo. 
@@ -50,7 +51,8 @@ await agent.network(`
     {
       name: "messages",
       type: "string | string[] | CoreMessage[] | AiMessageType[] | UIMessageWithMetadata[]",
-      description: "The messages to send to the agent. Can be a single string, array of strings, or structured message objects.",
+      description:
+        "The messages to send to the agent. Can be a single string, array of strings, or structured message objects.",
     },
     {
       name: "options",
@@ -75,49 +77,63 @@ await agent.network(`
       name: "memory",
       type: "object",
       isOptional: true,
-      description: "Configuration for memory. This is the preferred way to manage memory.",
+      description:
+        "Configuration for memory. This is the preferred way to manage memory.",
       properties: [
         {
-          parameters: [{
+          parameters: [
+            {
               name: "thread",
               type: "string | { id: string; metadata?: Record<string, any>, title?: string }",
               isOptional: false,
-              description: "The conversation thread, as a string ID or an object with an `id` and optional `metadata`."
-          }]
+              description:
+                "The conversation thread, as a string ID or an object with an `id` and optional `metadata`.",
+            },
+          ],
         },
         {
-          parameters: [{
+          parameters: [
+            {
               name: "resource",
               type: "string",
               isOptional: false,
-              description: "Identifier for the user or resource associated with the thread."
-          }]
+              description:
+                "Identifier for the user or resource associated with the thread.",
+            },
+          ],
         },
         {
-          parameters: [{
+          parameters: [
+            {
               name: "options",
               type: "MemoryConfig",
               isOptional: true,
-              description: "Configuration for memory behavior, like message history and semantic recall."
-          }]
-        }
-      ]
+              description:
+                "Configuration for memory behavior, like message history and semantic recall.",
+            },
+          ],
+        },
+      ],
     },
     {
       name: "tracingContext",
       type: "TracingContext",
       isOptional: true,
-      description: "AI tracing context for creating child spans and adding metadata. Automatically injected when using Mastra's tracing system.",
+      description:
+        "AI tracing context for creating child spans and adding metadata. Automatically injected when using Mastra's tracing system.",
       properties: [
         {
-          parameters: [{
-            name: "currentSpan",
-            type: "AISpan",
-            isOptional: true,
-            description: "Current AI span for creating child spans and adding metadata. Use this to create custom child spans or update span attributes during execution."
-          }]
-        }
-      ]
+          parameters: [
+            {
+              name: "currentSpan",
+              type: "AISpan",
+              isOptional: true,
+              description:
+                "Current AI span for creating child spans and adding metadata. Use this to create custom child spans or update span attributes during execution.",
+            },
+          ],
+        },
+      ],
     },
     {
       name: "tracingOptions",
@@ -126,14 +142,17 @@ await agent.network(`
       description: "Options for AI tracing configuration.",
       properties: [
         {
-          parameters: [{
-            name: "metadata",
-            type: "Record<string, any>",
-            isOptional: true,
-            description: "Metadata to add to the root trace span. Useful for adding custom attributes like user IDs, session IDs, or feature flags."
-          }]
-        }
-      ]
+          parameters: [
+            {
+              name: "metadata",
+              type: "Record<string, any>",
+              isOptional: true,
+              description:
+                "Metadata to add to the root trace span. Useful for adding custom attributes like user IDs, session IDs, or feature flags.",
+            },
+          ],
+        },
+      ],
     },
     {
       name: "telemetry",
@@ -143,38 +162,50 @@ await agent.network(`
         "Settings for OTLP telemetry collection during streaming (not AI tracing).",
       properties: [
         {
-          parameters: [{
-            name: "isEnabled",
-            type: "boolean",
-            isOptional: true,
-            description: "Enable or disable telemetry. Disabled by default while experimental."
-          }]
+          parameters: [
+            {
+              name: "isEnabled",
+              type: "boolean",
+              isOptional: true,
+              description:
+                "Enable or disable telemetry. Disabled by default while experimental.",
+            },
+          ],
         },
         {
-          parameters: [{
-            name: "recordInputs",
-            type: "boolean",
-            isOptional: true,
-            description: "Enable or disable input recording. Enabled by default. You might want to disable input recording to avoid recording sensitive information."
-          }]
+          parameters: [
+            {
+              name: "recordInputs",
+              type: "boolean",
+              isOptional: true,
+              description:
+                "Enable or disable input recording. Enabled by default. You might want to disable input recording to avoid recording sensitive information.",
+            },
+          ],
         },
         {
-          parameters: [{
-            name: "recordOutputs",
-            type: "boolean",
-            isOptional: true,
-            description: "Enable or disable output recording. Enabled by default. You might want to disable output recording to avoid recording sensitive information."
-          }]
+          parameters: [
+            {
+              name: "recordOutputs",
+              type: "boolean",
+              isOptional: true,
+              description:
+                "Enable or disable output recording. Enabled by default. You might want to disable output recording to avoid recording sensitive information.",
+            },
+          ],
         },
         {
-          parameters: [{
-            name: "functionId",
-            type: "string",
-            isOptional: true,
-            description: "Identifier for this function. Used to group telemetry data by function."
-          }]
-        }
-      ]
+          parameters: [
+            {
+              name: "functionId",
+              type: "string",
+              isOptional: true,
+              description:
+                "Identifier for this function. Used to group telemetry data by function.",
+            },
+          ],
+        },
+      ],
     },
     {
       name: "modelSettings",
@@ -184,80 +215,103 @@ await agent.network(`
         "Model-specific settings like temperature, maxTokens, topP, etc. These are passed to the underlying language model.",
       properties: [
         {
-          parameters: [{
-            name: "temperature",
-            type: "number",
-            isOptional: true,
-            description: "Controls randomness in the model's output. Higher values (e.g., 0.8) make the output more random, lower values (e.g., 0.2) make it more focused and deterministic."
-          }]
+          parameters: [
+            {
+              name: "temperature",
+              type: "number",
+              isOptional: true,
+              description:
+                "Controls randomness in the model's output. Higher values (e.g., 0.8) make the output more random, lower values (e.g., 0.2) make it more focused and deterministic.",
+            },
+          ],
         },
         {
-          parameters: [{
-            name: "maxRetries",
-            type: "number",
-            isOptional: true,
-            description: "Maximum number of retries for failed requests."
-          }]
+          parameters: [
+            {
+              name: "maxRetries",
+              type: "number",
+              isOptional: true,
+              description: "Maximum number of retries for failed requests.",
+            },
+          ],
         },
         {
-          parameters: [{
-            name: "topP",
-            type: "number",
-            isOptional: true,
-            description: "Nucleus sampling. This is a number between 0 and 1. It is recommended to set either temperature or topP, but not both."
-          }]
+          parameters: [
+            {
+              name: "topP",
+              type: "number",
+              isOptional: true,
+              description:
+                "Nucleus sampling. This is a number between 0 and 1. It is recommended to set either temperature or topP, but not both.",
+            },
+          ],
         },
         {
-          parameters: [{
-            name: "topK",
-            type: "number",
-            isOptional: true,
-            description: "Only sample from the top K options for each subsequent token. Used to remove 'long tail' low probability responses."
-          }]
+          parameters: [
+            {
+              name: "topK",
+              type: "number",
+              isOptional: true,
+              description:
+                "Only sample from the top K options for each subsequent token. Used to remove 'long tail' low probability responses.",
+            },
+          ],
         },
         {
-          parameters: [{
-            name: "presencePenalty",
-            type: "number",
-            isOptional: true,
-            description: "Presence penalty setting. It affects the likelihood of the model to repeat information that is already in the prompt. A number between -1 (increase repetition) and 1 (maximum penalty, decrease repetition)."
-          }]
+          parameters: [
+            {
+              name: "presencePenalty",
+              type: "number",
+              isOptional: true,
+              description:
+                "Presence penalty setting. It affects the likelihood of the model to repeat information that is already in the prompt. A number between -1 (increase repetition) and 1 (maximum penalty, decrease repetition).",
+            },
+          ],
         },
         {
-          parameters: [{
-            name: "frequencyPenalty",
-            type: "number",
-            isOptional: true,
-            description: "Frequency penalty setting. It affects the likelihood of the model to repeatedly use the same words or phrases. A number between -1 (increase repetition) and 1 (maximum penalty, decrease repetition)."
-          }]
+          parameters: [
+            {
+              name: "frequencyPenalty",
+              type: "number",
+              isOptional: true,
+              description:
+                "Frequency penalty setting. It affects the likelihood of the model to repeatedly use the same words or phrases. A number between -1 (increase repetition) and 1 (maximum penalty, decrease repetition).",
+            },
+          ],
         },
         {
-          parameters: [{
-            name: "stopSequences",
-            type: "string[]",
-            isOptional: true,
-            description: "Stop sequences. If set, the model will stop generating text when one of the stop sequences is generated."
-          }]
+          parameters: [
+            {
+              name: "stopSequences",
+              type: "string[]",
+              isOptional: true,
+              description:
+                "Stop sequences. If set, the model will stop generating text when one of the stop sequences is generated.",
+            },
+          ],
         },
-      ]
+      ],
     },
     {
       name: "runId",
       type: "string",
       isOptional: true,
-      description: "Unique ID for this generation run. Useful for tracking and debugging purposes.",
+      description:
+        "Unique ID for this generation run. Useful for tracking and debugging purposes.",
     },
     {
       name: "runtimeContext",
       type: "RuntimeContext",
       isOptional: true,
-      description: "Runtime context for dependency injection and contextual information.",
+      description:
+        "Runtime context for dependency injection and contextual information.",
     },
     {
       name: "traceId",
       type: "string",
       isOptional: true,
-      description: "The trace ID associated with this execution when AI tracing is enabled. Use this to correlate logs and debug execution flow.",
+      description:
+        "The trace ID associated with this execution when AI tracing is enabled. Use this to correlate logs and debug execution flow.",
     },
   ]}
 />
@@ -269,7 +323,8 @@ await agent.network(`
     {
       name: "stream",
       type: "MastraAgentNetworkStream<NetworkChunkType>",
-      description: "A custom stream that extends ReadableStream<NetworkChunkType> with additional network-specific properties",
+      description:
+        "A custom stream that extends ReadableStream<NetworkChunkType> with additional network-specific properties",
     },
     {
       name: "status",

package/.docs/raw/reference/auth/auth0.mdx

@@ -1,5 +1,5 @@
 ---
-title: "MastraAuthAuth0 Class"
+title: "Reference: MastraAuthAuth0 Class | Auth | Mastra Docs"
 description: "API reference for the MastraAuthAuth0 class, which authenticates Mastra applications using Auth0 authentication."
 ---
 
@@ -9,16 +9,16 @@ The `MastraAuthAuth0` class provides authentication for Mastra using Auth0. It v
 
 ## Usage example
 
-```typescript filename="src/mastra/index.ts" showLineNumbers copy
+```typescript title="src/mastra/index.ts" showLineNumbers copy
 import { Mastra } from "@mastra/core/mastra";
-import { MastraAuthAuth0 } from '@mastra/auth-auth0';
+import { MastraAuthAuth0 } from "@mastra/auth-auth0";
 
 export const mastra = new Mastra({
   // ..
   server: {
     experimental_auth: new MastraAuthAuth0({
       domain: process.env.AUTH0_DOMAIN,
-      audience: process.env.AUTH0_AUDIENCE
+      audience: process.env.AUTH0_AUDIENCE,
     }),
   },
 });
@@ -33,28 +33,31 @@ export const mastra = new Mastra({
     {
       name: "domain",
       type: "string",
-      description: "Your Auth0 domain (e.g., your-tenant.auth0.com). This is used to verify JWT tokens issued by your Auth0 tenant.",
+      description:
+        "Your Auth0 domain (e.g., your-tenant.auth0.com). This is used to verify JWT tokens issued by your Auth0 tenant.",
       isOptional: true,
-      defaultValue: "process.env.AUTH0_DOMAIN"
+      defaultValue: "process.env.AUTH0_DOMAIN",
     },
     {
       name: "audience",
       type: "string",
-      description: "Your Auth0 API identifier/audience. This ensures tokens are intended for your specific API.",
+      description:
+        "Your Auth0 API identifier/audience. This ensures tokens are intended for your specific API.",
       isOptional: true,
-      defaultValue: "process.env.AUTH0_AUDIENCE"
+      defaultValue: "process.env.AUTH0_AUDIENCE",
     },
     {
       name: "name",
       type: "string",
       description: "Custom name for the auth provider instance.",
       isOptional: true,
-      defaultValue: '"auth0"'
+      defaultValue: '"auth0"',
     },
     {
       name: "authorizeUser",
       type: "(user: Auth0User) => Promise<boolean> | boolean",
-      description: "Custom authorization function to determine if a user should be granted access. Called after token verification. By default, allows all authenticated users with valid tokens.",
+      description:
+        "Custom authorization function to determine if a user should be granted access. Called after token verification. By default, allows all authenticated users with valid tokens.",
       isOptional: true,
     },
   ]}
@@ -69,13 +72,15 @@ The following environment variables are automatically used when constructor opti
     {
       name: "AUTH0_DOMAIN",
       type: "string",
-      description: "Your Auth0 domain. Can be found in your Auth0 Dashboard under Applications > Settings.",
+      description:
+        "Your Auth0 domain. Can be found in your Auth0 Dashboard under Applications > Settings.",
       isOptional: true,
     },
     {
       name: "AUTH0_AUDIENCE",
       type: "string",
-      description: "Your Auth0 API identifier. This is the identifier you set when creating an API in your Auth0 Dashboard.",
+      description:
+        "Your Auth0 API identifier. This is the identifier you set when creating an API in your Auth0 Dashboard.",
       isOptional: true,
     },
   ]}
@@ -113,5 +118,4 @@ The exact properties available depend on your Auth0 configuration, scopes reques
 
 ## Related
 
-[MastraAuthAuth0 Class](/docs/auth/auth0.mdx)
-
+[MastraAuthAuth0 Class](/docs/auth/auth0)

package/.docs/raw/reference/auth/clerk.mdx

@@ -1,5 +1,5 @@
 ---
-title: "MastraAuthClerk Class"
+title: "Reference: MastraAuthClerk Class | Auth | Mastra Docs"
 description: "API reference for the MastraAuthClerk class, which authenticates Mastra applications using Clerk authentication."
 ---
 
@@ -9,9 +9,9 @@ The `MastraAuthClerk` class provides authentication for Mastra applications usin
 
 ## Usage example
 
-```typescript filename="src/mastra/index.ts" showLineNumbers copy
+```typescript title="src/mastra/index.ts" showLineNumbers copy
 import { Mastra } from "@mastra/core/mastra";
-import { MastraAuthClerk } from '@mastra/auth-clerk';
+import { MastraAuthClerk } from "@mastra/auth-clerk";
 
 export const mastra = new Mastra({
   // ..
@@ -32,23 +32,26 @@ export const mastra = new Mastra({
     {
       name: "publishableKey",
       type: "string",
-      description: "Your Clerk publishable key. Can be found in your Clerk Dashboard under API Keys.",
+      description:
+        "Your Clerk publishable key. Can be found in your Clerk Dashboard under API Keys.",
       isOptional: true,
-      defaultValue: "process.env.CLERK_PUBLISHABLE_KEY"
+      defaultValue: "process.env.CLERK_PUBLISHABLE_KEY",
     },
     {
       name: "secretKey",
       type: "string",
-      description: "Your Clerk secret key. Used for server-side authentication and token verification.",
+      description:
+        "Your Clerk secret key. Used for server-side authentication and token verification.",
       isOptional: true,
-      defaultValue: "process.env.CLERK_SECRET_KEY"
+      defaultValue: "process.env.CLERK_SECRET_KEY",
     },
     {
       name: "jwksUri",
       type: "string",
-      description: "The JWKS URI from your Clerk application. Used to verify JWT signatures.",
+      description:
+        "The JWKS URI from your Clerk application. Used to verify JWT signatures.",
       isOptional: true,
-      defaultValue: "process.env.CLERK_JWKS_URI"
+      defaultValue: "process.env.CLERK_JWKS_URI",
     },
     {
       name: "name",
@@ -59,7 +62,8 @@ export const mastra = new Mastra({
     {
       name: "authorizeUser",
       type: "(user: User, request: HonoRequest) => Promise<boolean> | boolean",
-      description: "Custom authorization function to determine if a user should be granted access. Called after token verification. By default, allows all authenticated users.",
+      description:
+        "Custom authorization function to determine if a user should be granted access. Called after token verification. By default, allows all authenticated users.",
       isOptional: true,
     },
   ]}
@@ -67,5 +71,4 @@ export const mastra = new Mastra({
 
 ## Related
 
-[MastraAuthClerk Class](/docs/auth/clerk.mdx)
-
+[MastraAuthClerk Class](/docs/auth/clerk)