@mastra/mcp-docs-server 0.0.0-error-handler-fix-20251020202607 → 0.0.0-execa-dynamic-import-20260304221256

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

@@ -1,290 +0,0 @@
----
-title: "Reference: Agent.network() (Experimental) | 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 />
-
-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';
-
-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'),
-  agents: {
-    agent1,
-    agent2,
-  },
-  workflows: {
-    workflow1,
-  },
-  tools: {
-    tool1,
-    tool2,
-  },
-})
-
-await agent.network(`
-  Find me the weather in Tokyo. 
-  Based on the weather, plan an activity for me.
-`);
-```
-
-## Parameters
-
-<PropertiesTable
-  content={[
-    {
-      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.",
-    },
-    {
-      name: "options",
-      type: "MultiPrimitiveExecutionOptions",
-      isOptional: true,
-      description: "Optional configuration for the network process.",
-    },
-  ]}
-/>
-
-### Options
-
-<PropertiesTable
-  content={[
-    {
-      name: "maxSteps",
-      type: "number",
-      isOptional: true,
-      description: "Maximum number of steps to run during execution.",
-    },
-    {
-      name: "memory",
-      type: "object",
-      isOptional: true,
-      description: "Configuration for memory. This is the preferred way to manage memory.",
-      properties: [
-        {
-          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`."
-          }]
-        },
-        {
-          parameters: [{
-              name: "resource",
-              type: "string",
-              isOptional: false,
-              description: "Identifier for the user or resource associated with the thread."
-          }]
-        },
-        {
-          parameters: [{
-              name: "options",
-              type: "MemoryConfig",
-              isOptional: true,
-              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.",
-      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."
-          }]
-        }
-      ]
-    },
-    {
-      name: "tracingOptions",
-      type: "TracingOptions",
-      isOptional: true,
-      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."
-          }]
-        }
-      ]
-    },
-    {
-      name: "telemetry",
-      type: "TelemetrySettings",
-      isOptional: true,
-      description:
-        "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: "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: "functionId",
-            type: "string",
-            isOptional: true,
-            description: "Identifier for this function. Used to group telemetry data by function."
-          }]
-        }
-      ]
-    },
-    {
-      name: "modelSettings",
-      type: "CallSettings",
-      isOptional: true,
-      description:
-        "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: "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: "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: "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."
-          }]
-        },
-      ]
-    },
-    {
-      name: "runId",
-      type: "string",
-      isOptional: true,
-      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.",
-    },
-    {
-      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.",
-    },
-  ]}
-/>
-
-## Returns
-
-<PropertiesTable
-  content={[
-    {
-      name: "stream",
-      type: "MastraAgentNetworkStream<NetworkChunkType>",
-      description: "A custom stream that extends ReadableStream<NetworkChunkType> with additional network-specific properties",
-    },
-    {
-      name: "status",
-      type: "Promise<RunStatus>",
-      description: "A promise that resolves to the current workflow run status",
-    },
-    {
-      name: "result",
-      type: "Promise<WorkflowResult<TState, TOutput, TSteps>>",
-      description: "A promise that resolves to the final workflow result",
-    },
-    {
-      name: "usage",
-      type: "Promise<{ promptTokens: number; completionTokens: number; totalTokens: number }>",
-      description: "A promise that resolves to token usage statistics",
-    },
-  ]}
-/>

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

@@ -1,117 +0,0 @@
----
-title: "MastraAuthAuth0 Class"
-description: "API reference for the MastraAuthAuth0 class, which authenticates Mastra applications using Auth0 authentication."
----
-
-# MastraAuthAuth0 Class
-
-The `MastraAuthAuth0` class provides authentication for Mastra using Auth0. It verifies incoming requests using Auth0-issued JWT tokens and integrates with the Mastra server using the `experimental_auth` option.
-
-## Usage example
-
-```typescript filename="src/mastra/index.ts" showLineNumbers copy
-import { Mastra } from "@mastra/core/mastra";
-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
-    }),
-  },
-});
-```
-
-> **Note:** You can omit the constructor parameters if you have the appropriately named environment variables (`AUTH0_DOMAIN` and `AUTH0_AUDIENCE`) set. In that case, simply use `new MastraAuthAuth0()` without any arguments.
-
-## Constructor parameters
-
-<PropertiesTable
-  content={[
-    {
-      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.",
-      isOptional: true,
-      defaultValue: "process.env.AUTH0_DOMAIN"
-    },
-    {
-      name: "audience",
-      type: "string",
-      description: "Your Auth0 API identifier/audience. This ensures tokens are intended for your specific API.",
-      isOptional: true,
-      defaultValue: "process.env.AUTH0_AUDIENCE"
-    },
-    {
-      name: "name",
-      type: "string",
-      description: "Custom name for the auth provider instance.",
-      isOptional: true,
-      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.",
-      isOptional: true,
-    },
-  ]}
-/>
-
-## Environment Variables
-
-The following environment variables are automatically used when constructor options are not provided:
-
-<PropertiesTable
-  content={[
-    {
-      name: "AUTH0_DOMAIN",
-      type: "string",
-      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.",
-      isOptional: true,
-    },
-  ]}
-/>
-
-## Default Authorization Behavior
-
-By default, `MastraAuthAuth0` validates Auth0 JWT tokens and allows access to all authenticated users:
-
-1. **Token Verification**: The JWT token is verified using Auth0's public keys (JWKS)
-2. **Signature Validation**: Ensures the token was signed by your Auth0 tenant
-3. **Expiration Check**: Verifies the token has not expired
-4. **Audience Validation**: Confirms the token was issued for your specific API (audience)
-5. **Issuer Validation**: Ensures the token was issued by your Auth0 domain
-
-If all validations pass, the user is considered authorized. To implement custom authorization logic (e.g., role-based access control), provide a custom `authorizeUser` function.
-
-## Auth0 User Type
-
-The `Auth0User` type used in the `authorizeUser` function corresponds to the decoded JWT token payload, which typically includes:
-
-- `sub`: The user's unique identifier (subject)
-- `email`: The user's email address (if included in token)
-- `email_verified`: Whether the email is verified
-- `name`: The user's display name (if available)
-- `picture`: URL to the user's profile picture (if available)
-- `iss`: Token issuer (your Auth0 domain)
-- `aud`: Token audience (your API identifier)
-- `iat`: Token issued at timestamp
-- `exp`: Token expiration timestamp
-- `scope`: Granted scopes for the token
-- Custom claims and app metadata configured in your Auth0 tenant
-
-The exact properties available depend on your Auth0 configuration, scopes requested, and any custom claims you've configured.
-
-## Related
-
-[MastraAuthAuth0 Class](/docs/auth/auth0.mdx)
-

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

@@ -1,71 +0,0 @@
----
-title: "MastraAuthClerk Class"
-description: "API reference for the MastraAuthClerk class, which authenticates Mastra applications using Clerk authentication."
----
-
-# MastraAuthClerk Class
-
-The `MastraAuthClerk` class provides authentication for Mastra applications using Clerk. It verifies incoming requests with Clerk-issued JWT tokens and integrates with the Mastra server using the `experimental_auth` option.
-
-## Usage example
-
-```typescript filename="src/mastra/index.ts" showLineNumbers copy
-import { Mastra } from "@mastra/core/mastra";
-import { MastraAuthClerk } from '@mastra/auth-clerk';
-
-export const mastra = new Mastra({
-  // ..
-  server: {
-    experimental_auth: new MastraAuthClerk({
-      jwksUri: process.env.CLERK_JWKS_URI,
-      publishableKey: process.env.CLERK_PUBLISHABLE_KEY,
-      secretKey: process.env.CLERK_SECRET_KEY,
-    }),
-  },
-});
-```
-
-## Constructor parameters
-
-<PropertiesTable
-  content={[
-    {
-      name: "publishableKey",
-      type: "string",
-      description: "Your Clerk publishable key. Can be found in your Clerk Dashboard under API Keys.",
-      isOptional: true,
-      defaultValue: "process.env.CLERK_PUBLISHABLE_KEY"
-    },
-    {
-      name: "secretKey",
-      type: "string",
-      description: "Your Clerk secret key. Used for server-side authentication and token verification.",
-      isOptional: true,
-      defaultValue: "process.env.CLERK_SECRET_KEY"
-    },
-    {
-      name: "jwksUri",
-      type: "string",
-      description: "The JWKS URI from your Clerk application. Used to verify JWT signatures.",
-      isOptional: true,
-      defaultValue: "process.env.CLERK_JWKS_URI"
-    },
-    {
-      name: "name",
-      type: "string",
-      description: "Custom name for the auth provider instance.",
-      isOptional: true,
-    },
-    {
-      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.",
-      isOptional: true,
-    },
-  ]}
-/>
-
-## Related
-
-[MastraAuthClerk Class](/docs/auth/clerk.mdx)
-

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

@@ -1,128 +0,0 @@
----
-title: "MastraAuthFirebase Class"
-description: "API reference for the MastraAuthFirebase class, which authenticates Mastra applications using Firebase Authentication."
----
-
-# MastraAuthFirebase Class
-
-The `MastraAuthFirebase` class provides authentication for Mastra using Firebase Authentication. It verifies incoming requests using Firebase ID tokens and integrates with the Mastra server using the `experimental_auth` option.
-
-## Usage examples
-
-### Basic usage with environment variables
-
-```typescript filename="src/mastra/index.ts" showLineNumbers copy
-import { Mastra } from "@mastra/core/mastra";
-import { MastraAuthFirebase } from '@mastra/auth-firebase';
-
-// Automatically uses FIREBASE_SERVICE_ACCOUNT and FIRESTORE_DATABASE_ID env vars
-export const mastra = new Mastra({
-  // ..
-  server: {
-    experimental_auth: new MastraAuthFirebase(),
-  },
-});
-```
-
-### Custom configuration
-
-```typescript filename="src/mastra/index.ts" showLineNumbers copy
-import { Mastra } from "@mastra/core/mastra";
-import { MastraAuthFirebase } from '@mastra/auth-firebase';
-
-export const mastra = new Mastra({
-  // ..
-  server: {
-    experimental_auth: new MastraAuthFirebase({
-      serviceAccount: "/path/to/service-account-key.json",
-      databaseId: "your-database-id"
-    }),
-  },
-});
-```
-
-## Constructor parameters
-
-<PropertiesTable
-  content={[
-    {
-      name: "serviceAccount",
-      type: "string",
-      description: "Path to the Firebase service account JSON file. This file contains the credentials needed to verify Firebase ID tokens on the server side.",
-      isOptional: true,
-      defaultValue: "process.env.FIREBASE_SERVICE_ACCOUNT"
-    },
-    {
-      name: "databaseId",
-      type: "string",
-      description: "The Firestore database ID to use. Typically '(default)' for the default database.",
-      isOptional: true,
-      defaultValue: "process.env.FIRESTORE_DATABASE_ID || process.env.FIREBASE_DATABASE_ID"
-    },
-    {
-      name: "name",
-      type: "string",
-      description: "Custom name for the auth provider instance.",
-      isOptional: true,
-      defaultValue: '"firebase"'
-    },
-    {
-      name: "authorizeUser",
-      type: "(user: FirebaseUser) => Promise<boolean> | boolean",
-      description: "Custom authorization function to determine if a user should be granted access. Called after token verification. By default, checks for the presence of a document in the 'user_access' collection keyed by the user's UID.",
-      isOptional: true,
-    },
-  ]}
-/>
-
-## Environment Variables
-
-The following environment variables are automatically used when constructor options are not provided:
-
-<PropertiesTable
-  content={[
-    {
-      name: "FIREBASE_SERVICE_ACCOUNT",
-      type: "string",
-      description: "Path to Firebase service account JSON file. Used if serviceAccount option is not provided.",
-      isOptional: true,
-    },
-    {
-      name: "FIRESTORE_DATABASE_ID",
-      type: "string",
-      description: "Firestore database ID. Primary environment variable for database configuration.",
-      isOptional: true,
-    },
-    {
-      name: "FIREBASE_DATABASE_ID",
-      type: "string",
-      description: "Alternative environment variable for Firestore database ID. Used if FIRESTORE_DATABASE_ID is not set.",
-      isOptional: true,
-    },
-  ]}
-/>
-
-## Default Authorization Behavior
-
-By default, `MastraAuthFirebase` uses Firestore to manage user access:
-
-1. After successfully verifying a Firebase ID token, the `authorizeUser` method is called
-2. It checks for the existence of a document in the `user_access` collection with the user's UID as the document ID
-3. If the document exists, the user is authorized; otherwise, access is denied
-4. The Firestore database used is determined by the `databaseId` parameter or environment variables
-
-## Firebase User Type
-
-The `FirebaseUser` type used in the `authorizeUser` function corresponds to Firebase's `DecodedIdToken` interface, which includes:
-
-- `uid`: The user's unique identifier
-- `email`: The user's email address (if available)
-- `email_verified`: Whether the email is verified
-- `name`: The user's display name (if available)
-- `picture`: URL to the user's profile picture (if available)
-- `auth_time`: When the user authenticated
-- And other standard JWT claims
-
-## Related
-
-[MastraAuthFirebase Class](/docs/auth/firebase.mdx)

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

@@ -1,41 +0,0 @@
----
-title: "MastraJwtAuth Class"
-description: "API reference for the MastraJwtAuth class, which authenticates Mastra applications using JSON Web Tokens."
----
-
-# MastraJwtAuth Class
-
-The `MastraJwtAuth` class provides a lightweight authentication mechanism for Mastra using JSON Web Tokens (JWTs). It verifies incoming requests based on a shared secret and integrates with the Mastra server using the `experimental_auth` option.
-
-## Usage example
-
-```typescript filename="src/mastra/index.ts" showLineNumbers copy
-import { Mastra } from "@mastra/core/mastra";
-import { MastraJwtAuth } from '@mastra/auth';
-
-export const mastra = new Mastra({
-  // ..
-  server: {
-    experimental_auth: new MastraJwtAuth({
-        secret: "<your-secret>"
-    }),
-  },
-});
-```
-
-## Constructor parameters
-
-<PropertiesTable
-  content={[
-    {
-      name: "secret",
-      type: "string",
-      description: "A unique string used to sign and verify JSON Web Tokens (JWTs) for authenticating incoming requests.",
-      isOptional: false,
-    },
-  ]}
-/>
-
-## Related
-
-[MastraJwtAuth](/docs/auth/jwt.mdx)