@mastra/core 1.25.0-alpha.1 → 1.25.0-alpha.2

package/dist/docs/references/docs-agents-adding-voice.md

@@ -343,7 +343,7 @@ Mastra supports multiple voice providers for text-to-speech (TTS) and speech-to-
 
 ## Next steps
 
-- [Voice API Reference](https://mastra.ai/reference/voice/mastra-voice) - Detailed API documentation for voice capabilities
-- [Text to Speech Examples](https://github.com/mastra-ai/voice-examples/tree/main/text-to-speech) - Interactive story generator and other TTS implementations
-- [Speech to Text Examples](https://github.com/mastra-ai/voice-examples/tree/main/speech-to-text) - Voice memo app and other STT implementations
-- [Speech to Speech Examples](https://github.com/mastra-ai/voice-examples/tree/main/speech-to-speech) - Real-time voice conversation with call analysis
+- [Voice API Reference](https://mastra.ai/reference/voice/mastra-voice): Detailed API documentation for voice capabilities
+- [Text to Speech Examples](https://github.com/mastra-ai/voice-examples/tree/main/text-to-speech): Interactive story generator and other TTS implementations
+- [Speech to Text Examples](https://github.com/mastra-ai/voice-examples/tree/main/speech-to-text): Voice memo app and other STT implementations
+- [Speech to Speech Examples](https://github.com/mastra-ai/voice-examples/tree/main/speech-to-speech): Real-time voice conversation with call analysis

package/dist/docs/references/docs-evals-custom-scorers.md

@@ -515,5 +515,5 @@ console.log('Reason:', result.reason)
 
 **Examples and Resources:**
 
-- [createScorer API Reference](https://mastra.ai/reference/evals/create-scorer) - Complete technical documentation
-- [Built-in Scorers Source Code](https://github.com/mastra-ai/mastra/tree/main/packages/evals/src/scorers) - Real implementations for reference
+- [createScorer API Reference](https://mastra.ai/reference/evals/create-scorer): Complete technical documentation
+- [Built-in Scorers Source Code](https://github.com/mastra-ai/mastra/tree/main/packages/evals/src/scorers): Real implementations for reference

package/dist/docs/references/docs-memory-memory-processors.md

@@ -307,8 +307,8 @@ Both scenarios are safe - guardrails prevent inappropriate content from being pe
 
 ## Related documentation
 
-- [Processors](https://mastra.ai/docs/agents/processors) - General processor concepts and custom processor creation
-- [Guardrails](https://mastra.ai/docs/agents/guardrails) - Security and validation processors
-- [Memory Overview](https://mastra.ai/docs/memory/overview) - Memory types and configuration
+- [Processors](https://mastra.ai/docs/agents/processors): General processor concepts and custom processor creation
+- [Guardrails](https://mastra.ai/docs/agents/guardrails): Security and validation processors
+- [Memory Overview](https://mastra.ai/docs/memory/overview): Memory types and configuration
 
 When creating custom processors avoid mutating the input `messages` array or its objects directly.

package/dist/docs/references/docs-memory-observational-memory.md

@@ -157,7 +157,7 @@ With retrieval mode enabled, OM:
 - Registers a `recall` tool the agent can call to:
 
   - Page through the raw messages behind any observation group range
-  - Search by semantic similarity (`mode: "search"` with a `query` string) — requires `vector: true`
+  - Search by semantic similarity (`mode: "search"` with a `query` string); requires `vector: true`
   - List all threads (`mode: "threads"`), browse other threads (`threadId`), and search across all threads (default `scope: 'resource'`)
   - When `scope: 'thread'`: restrict browsing and search to the current thread only
 

package/dist/docs/references/docs-memory-working-memory.md

@@ -397,4 +397,4 @@ const response = await agent.generate('What do you know about me?', {
 
 - [Working memory with template](https://github.com/mastra-ai/mastra/tree/main/examples/memory-with-template)
 - [Working memory with schema](https://github.com/mastra-ai/mastra/tree/main/examples/memory-with-schema)
-- [Per-resource working memory](https://github.com/mastra-ai/mastra/tree/main/examples/memory-per-resource-example) - Complete example showing resource-scoped memory persistence
+- [Per-resource working memory](https://github.com/mastra-ai/mastra/tree/main/examples/memory-per-resource-example): Complete example showing resource-scoped memory persistence

package/dist/docs/references/docs-server-custom-adapters.md

@@ -373,8 +373,8 @@ app.listen(4111)
 
 ## Related
 
-- [Server Adapters](https://mastra.ai/docs/server/server-adapters) - Overview and shared concepts
-- [Hono Adapter](https://mastra.ai/reference/server/hono-adapter) - Reference implementation
-- [Express Adapter](https://mastra.ai/reference/server/express-adapter) - Reference implementation
-- [MastraServer Reference](https://mastra.ai/reference/server/mastra-server) - Full API reference
-- [createRoute() Reference](https://mastra.ai/reference/server/create-route) - Creating type-safe custom routes
+- [Server Adapters](https://mastra.ai/docs/server/server-adapters): Overview and shared concepts
+- [Hono Adapter](https://mastra.ai/reference/server/hono-adapter): Reference implementation
+- [Express Adapter](https://mastra.ai/reference/server/express-adapter): Reference implementation
+- [MastraServer Reference](https://mastra.ai/reference/server/mastra-server): Full API reference
+- [createRoute() Reference](https://mastra.ai/reference/server/create-route): Creating type-safe custom routes

package/dist/docs/references/docs-server-custom-api-routes.md

@@ -318,6 +318,6 @@ export const mastra = new Mastra({
 
 ## Related
 
-- [registerApiRoute() Reference](https://mastra.ai/reference/server/register-api-route) - Full API reference
-- [Server Middleware](https://mastra.ai/docs/server/middleware) - Global middleware configuration
-- [Mastra Server](https://mastra.ai/docs/server/mastra-server) - Server configuration options
+- [registerApiRoute() Reference](https://mastra.ai/reference/server/register-api-route): Full API reference
+- [Server Middleware](https://mastra.ai/docs/server/middleware): Global middleware configuration
+- [Mastra Server](https://mastra.ai/docs/server/mastra-server): Server configuration options

package/dist/docs/references/docs-server-middleware.md

@@ -235,30 +235,6 @@ This is useful when you want to restrict operations to a specific thread that yo
 }
 ```
 
-### Special Mastra headers
-
-When integrating with Mastra Cloud or custom clients the following headers can be inspected by middleware to tailor behavior:
-
-```typescript
-{
-  handler: async (c, next) => {
-    const isFromMastraCloud = c.req.header('x-mastra-cloud') === 'true';
-    const clientType = c.req.header('x-mastra-client-type');
-    const isStudio =
-      c.req.header('x-studio') === 'true';
-
-    if (isFromMastraCloud) {
-      // Special handling
-    }
-    await next();
-  },
-}
-```
-
-- `x-mastra-cloud`: request originates from Mastra Cloud
-- `x-mastra-client-type`: identifies the client SDK, e.g. `js` or `python`
-- `x-studio`: request triggered from Studio
-
 # Related
 
 - [Request Context](https://mastra.ai/docs/server/request-context)

package/dist/docs/references/docs-studio-observability.md

@@ -87,7 +87,7 @@ export const mastra = new Mastra({
         serviceName: 'mastra',
         exporters: [
           new DefaultExporter(), // Persists traces to storage for Mastra Studio
-          new CloudExporter(), // Sends observability data to Mastra platform (if MASTRA_CLOUD_ACCESS_TOKEN is set)
+          new CloudExporter(), // Sends observability data to hosted Mastra Studio (if MASTRA_CLOUD_ACCESS_TOKEN is set)
         ],
         spanOutputProcessors: [
           new SensitiveDataFilter(), // Redacts sensitive data like passwords, tokens, keys

package/dist/docs/references/docs-voice-speech-to-text.md

@@ -28,13 +28,13 @@ const voice = new OpenAIVoice()
 
 Mastra supports several Speech-to-Text providers, each with their own capabilities and strengths:
 
-- [**OpenAI**](https://mastra.ai/reference/voice/openai) - High-accuracy transcription with Whisper models
-- [**Azure**](https://mastra.ai/reference/voice/azure) - Microsoft's speech recognition with enterprise-grade reliability
-- [**ElevenLabs**](https://mastra.ai/reference/voice/elevenlabs) - Advanced speech recognition with support for multiple languages
-- [**Google**](https://mastra.ai/reference/voice/google) - Google's speech recognition with extensive language support
-- [**Cloudflare**](https://mastra.ai/reference/voice/cloudflare) - Edge-optimized speech recognition for low-latency applications
-- [**Deepgram**](https://mastra.ai/reference/voice/deepgram) - AI-powered speech recognition with high accuracy for various accents
-- [**Sarvam**](https://mastra.ai/reference/voice/sarvam) - Specialized in Indic languages and accents
+- [**OpenAI**](https://mastra.ai/reference/voice/openai): High-accuracy transcription with Whisper models
+- [**Azure**](https://mastra.ai/reference/voice/azure): Microsoft's speech recognition with enterprise-grade reliability
+- [**ElevenLabs**](https://mastra.ai/reference/voice/elevenlabs): Advanced speech recognition with support for multiple languages
+- [**Google**](https://mastra.ai/reference/voice/google): Google's speech recognition with extensive language support
+- [**Cloudflare**](https://mastra.ai/reference/voice/cloudflare): Edge-optimized speech recognition for low-latency applications
+- [**Deepgram**](https://mastra.ai/reference/voice/deepgram): AI-powered speech recognition with high accuracy for various accents
+- [**Sarvam**](https://mastra.ai/reference/voice/sarvam): Specialized in Indic languages and accents
 
 Each provider is implemented as a separate package that you can install as needed:
 

package/dist/docs/references/docs-voice-text-to-speech.md

@@ -33,16 +33,16 @@ const voice = new OpenAIVoice()
 
 Mastra supports a wide range of Text-to-Speech providers, each with their own unique capabilities and voice options. You can choose the provider that best suits your application's needs:
 
-- [**OpenAI**](https://mastra.ai/reference/voice/openai) - High-quality voices with natural intonation and expression
-- [**Azure**](https://mastra.ai/reference/voice/azure) - Microsoft's speech service with a wide range of voices and languages
-- [**ElevenLabs**](https://mastra.ai/reference/voice/elevenlabs) - Ultra-realistic voices with emotion and fine-grained control
-- [**PlayAI**](https://mastra.ai/reference/voice/playai) - Specialized in natural-sounding voices with various styles
-- [**Google**](https://mastra.ai/reference/voice/google) - Google's speech synthesis with multilingual support
-- [**Cloudflare**](https://mastra.ai/reference/voice/cloudflare) - Edge-optimized speech synthesis for low-latency applications
-- [**Deepgram**](https://mastra.ai/reference/voice/deepgram) - AI-powered speech technology with high accuracy
-- [**Speechify**](https://mastra.ai/reference/voice/speechify) - Text-to-speech optimized for readability and accessibility
-- [**Sarvam**](https://mastra.ai/reference/voice/sarvam) - Specialized in Indic languages and accents
-- [**Murf**](https://mastra.ai/reference/voice/murf) - Studio-quality voice overs with customizable parameters
+- [**OpenAI**](https://mastra.ai/reference/voice/openai): High-quality voices with natural intonation and expression
+- [**Azure**](https://mastra.ai/reference/voice/azure): Microsoft's speech service with a wide range of voices and languages
+- [**ElevenLabs**](https://mastra.ai/reference/voice/elevenlabs): Ultra-realistic voices with emotion and fine-grained control
+- [**PlayAI**](https://mastra.ai/reference/voice/playai): Specialized in natural-sounding voices with various styles
+- [**Google**](https://mastra.ai/reference/voice/google): Google's speech synthesis with multilingual support
+- [**Cloudflare**](https://mastra.ai/reference/voice/cloudflare): Edge-optimized speech synthesis for low-latency applications
+- [**Deepgram**](https://mastra.ai/reference/voice/deepgram): AI-powered speech technology with high accuracy
+- [**Speechify**](https://mastra.ai/reference/voice/speechify): Text-to-speech optimized for readability and accessibility
+- [**Sarvam**](https://mastra.ai/reference/voice/sarvam): Specialized in Indic languages and accents
+- [**Murf**](https://mastra.ai/reference/voice/murf): Studio-quality voice overs with customizable parameters
 
 Each provider is implemented as a separate package that you can install as needed:
 

package/dist/docs/references/docs-workspace-filesystem.md

@@ -18,10 +18,10 @@ A filesystem provider handles all file operations for a workspace:
 
 Available providers:
 
-- [`LocalFilesystem`](https://mastra.ai/reference/workspace/local-filesystem) - Stores files in a directory on disk
-- [`S3Filesystem`](https://mastra.ai/reference/workspace/s3-filesystem) - Stores files in Amazon S3 or S3-compatible storage (R2, MinIO)
-- [`GCSFilesystem`](https://mastra.ai/reference/workspace/gcs-filesystem) - Stores files in Google Cloud Storage
-- [`AgentFSFilesystem`](https://mastra.ai/reference/workspace/agentfs-filesystem) - Stores files in a Turso/SQLite database via AgentFS
+- [`LocalFilesystem`](https://mastra.ai/reference/workspace/local-filesystem): Stores files in a directory on disk
+- [`S3Filesystem`](https://mastra.ai/reference/workspace/s3-filesystem): Stores files in Amazon S3 or S3-compatible storage (R2, MinIO)
+- [`GCSFilesystem`](https://mastra.ai/reference/workspace/gcs-filesystem): Stores files in Google Cloud Storage
+- [`AgentFSFilesystem`](https://mastra.ai/reference/workspace/agentfs-filesystem): Stores files in a Turso/SQLite database via AgentFS
 
 > **Tip:** `LocalFilesystem` is the simplest way to get started as it requires no external services. For cloud storage, use `S3Filesystem` or `GCSFilesystem`. For database-backed storage without external services, use `AgentFSFilesystem`.
 

package/dist/docs/references/docs-workspace-skills.md

@@ -181,9 +181,9 @@ const workspace = new Workspace({
 
 `VersionedSkillSource` accepts three parameters:
 
-- **`versionTree`** (`SkillVersionTree`) — A manifest mapping relative file paths to blob entries (`{ entries: Record<string, { blobHash, size, mimeType?, encoding? }> }`).
-- **`blobStore`** (`BlobStore`) — A content-addressable blob store instance that holds the actual file contents referenced by hash.
-- **`versionCreatedAt`** (`Date`) — The timestamp when this skill version was published. Used as the modification time for all files in the version.
+- **`versionTree`** (`SkillVersionTree`): A manifest mapping relative file paths to blob entries (`{ entries: Record<string, { blobHash, size, mimeType?, encoding? }> }`).
+- **`blobStore`** (`BlobStore`): A content-addressable blob store instance that holds the actual file contents referenced by hash.
+- **`versionCreatedAt`** (`Date`): The timestamp when this skill version was published. Used as the modification time for all files in the version.
 
 When `skillSource` is provided, it's used instead of the workspace filesystem for skill discovery.
 

package/dist/docs/references/guides-agent-frameworks-ai-sdk.md

@@ -134,7 +134,7 @@ const { text } = await generateText({
 
 ## Related
 
-- [`withMastra()`](https://mastra.ai/reference/ai-sdk/with-mastra) - API reference for `withMastra()`
-- [Processors](https://mastra.ai/docs/agents/processors) - Learn about input and output processors
-- [Memory](https://mastra.ai/docs/memory/overview) - Overview of Mastra's memory system
-- [AI SDK UI](https://mastra.ai/guides/build-your-ui/ai-sdk-ui) - Using AI SDK UI hooks with Mastra agents, workflows, and networks
+- [`withMastra()`](https://mastra.ai/reference/ai-sdk/with-mastra): API reference for `withMastra()`
+- [Processors](https://mastra.ai/docs/agents/processors): Learn about input and output processors
+- [Memory](https://mastra.ai/docs/memory/overview): Overview of Mastra's memory system
+- [AI SDK UI](https://mastra.ai/guides/build-your-ui/ai-sdk-ui): Using AI SDK UI hooks with Mastra agents, workflows, and networks

package/dist/docs/references/reference-agents-channels.md

@@ -159,6 +159,6 @@ type InlineLinkEntry =
 
 ## Related
 
-- [Channels guide](https://mastra.ai/docs/agents/channels) — concepts, quickstart, and platform setup
-- [Agent class](https://mastra.ai/reference/agents/agent) — constructor parameters and methods
-- [Chat SDK adapters](https://chat-sdk.dev/adapters) — adapter configuration and platform setup
+- [Channels guide](https://mastra.ai/docs/agents/channels): Concepts, quickstart, and platform setup
+- [Agent class](https://mastra.ai/reference/agents/agent): Constructor parameters and methods
+- [Chat SDK adapters](https://chat-sdk.dev/adapters): Adapter configuration and platform setup

package/dist/docs/references/reference-core-addGateway.md

@@ -35,8 +35,8 @@ Void. The gateway is added to the internal registry.
 
 ## Related
 
-- [Mastra.getGateway()](https://mastra.ai/reference/core/getGateway) - Get gateway by registration key
-- [Mastra.getGatewayById()](https://mastra.ai/reference/core/getGatewayById) - Get gateway by ID
-- [Mastra.listGateways()](https://mastra.ai/reference/core/listGateways) - List all gateways
-- [MastraModelGateway](https://mastra.ai/reference/core/mastra-model-gateway) - Gateway base class
-- [Custom Gateways Guide](https://mastra.ai/models/gateways/custom-gateways) - Creating custom gateways
+- [Mastra.getGateway()](https://mastra.ai/reference/core/getGateway): Get gateway by registration key
+- [Mastra.getGatewayById()](https://mastra.ai/reference/core/getGatewayById): Get gateway by ID
+- [Mastra.listGateways()](https://mastra.ai/reference/core/listGateways): List all gateways
+- [MastraModelGateway](https://mastra.ai/reference/core/mastra-model-gateway): Gateway base class
+- [Custom Gateways Guide](https://mastra.ai/models/gateways/custom-gateways): Creating custom gateways

package/dist/docs/references/reference-core-getGateway.md

@@ -31,8 +31,8 @@ Throws an error if no gateway is found with the specified key.
 
 ## Related
 
-- [Mastra.getGatewayById()](https://mastra.ai/reference/core/getGatewayById) - Get gateway by ID
-- [Mastra.listGateways()](https://mastra.ai/reference/core/listGateways) - List all gateways
-- [Mastra.addGateway()](https://mastra.ai/reference/core/addGateway) - Add a gateway
-- [MastraModelGateway](https://mastra.ai/reference/core/mastra-model-gateway) - Gateway base class
-- [Custom Gateways Guide](https://mastra.ai/models/gateways/custom-gateways) - Creating custom gateways
+- [Mastra.getGatewayById()](https://mastra.ai/reference/core/getGatewayById): Get gateway by ID
+- [Mastra.listGateways()](https://mastra.ai/reference/core/listGateways): List all gateways
+- [Mastra.addGateway()](https://mastra.ai/reference/core/addGateway): Add a gateway
+- [MastraModelGateway](https://mastra.ai/reference/core/mastra-model-gateway): Gateway base class
+- [Custom Gateways Guide](https://mastra.ai/models/gateways/custom-gateways): Creating custom gateways

package/dist/docs/references/reference-core-getGatewayById.md

@@ -34,8 +34,8 @@ console.log(gateway.name) // 'My Custom Gateway'
 
 ## Related
 
-- [Mastra.getGateway()](https://mastra.ai/reference/core/getGateway) - Get gateway by registration key
-- [Mastra.listGateways()](https://mastra.ai/reference/core/listGateways) - List all gateways
-- [Mastra.addGateway()](https://mastra.ai/reference/core/addGateway) - Add a gateway
-- [MastraModelGateway](https://mastra.ai/reference/core/mastra-model-gateway) - Gateway base class
-- [Custom Gateways Guide](https://mastra.ai/models/gateways/custom-gateways) - Creating custom gateways
+- [Mastra.getGateway()](https://mastra.ai/reference/core/getGateway): Get gateway by registration key
+- [Mastra.listGateways()](https://mastra.ai/reference/core/listGateways): List all gateways
+- [Mastra.addGateway()](https://mastra.ai/reference/core/addGateway): Add a gateway
+- [MastraModelGateway](https://mastra.ai/reference/core/mastra-model-gateway): Gateway base class
+- [Custom Gateways Guide](https://mastra.ai/models/gateways/custom-gateways): Creating custom gateways

package/dist/docs/references/reference-core-getMCPServer.md

@@ -38,8 +38,8 @@ const serverById = mastra.getMCPServerById('my-mcp-server')
 
 ## Related methods
 
-- [Mastra.getMCPServerById()](https://mastra.ai/reference/core/getMCPServerById) - Retrieve an MCP server by its intrinsic `id` property
-- [Mastra.listMCPServers()](https://mastra.ai/reference/core/listMCPServers) - List all registered MCP servers
+- [Mastra.getMCPServerById()](https://mastra.ai/reference/core/getMCPServerById): Retrieve an MCP server by its intrinsic `id` property
+- [Mastra.listMCPServers()](https://mastra.ai/reference/core/listMCPServers): List all registered MCP servers
 
 ## See also
 

package/dist/docs/references/reference-core-getMCPServerById.md

@@ -46,8 +46,8 @@ const serverByKey = mastra.getMCPServer('customKey')
 
 ## Related methods
 
-- [Mastra.getMCPServer()](https://mastra.ai/reference/core/getMCPServer) - Retrieve an MCP server by its registry key
-- [Mastra.listMCPServers()](https://mastra.ai/reference/core/listMCPServers) - List all registered MCP servers
+- [Mastra.getMCPServer()](https://mastra.ai/reference/core/getMCPServer): Retrieve an MCP server by its registry key
+- [Mastra.listMCPServers()](https://mastra.ai/reference/core/listMCPServers): List all registered MCP servers
 
 ## See also
 

package/dist/docs/references/reference-core-getScorer.md

@@ -49,6 +49,6 @@ try {
 
 ## Related
 
-- [listScorers()](https://mastra.ai/reference/core/listScorers) - Get all registered scorers
-- [getScorerById()](https://mastra.ai/reference/core/getScorerById) - Get a scorer by its id property
-- [Custom Scorers](https://mastra.ai/docs/evals/custom-scorers) - Learn how to create custom scorers
+- [listScorers()](https://mastra.ai/reference/core/listScorers): Get all registered scorers
+- [getScorerById()](https://mastra.ai/reference/core/getScorerById): Get a scorer by its id property
+- [Custom Scorers](https://mastra.ai/docs/evals/custom-scorers): Learn how to create custom scorers

package/dist/docs/references/reference-core-getScorerById.md

@@ -49,6 +49,6 @@ try {
 
 ## Related
 
-- [getScorer()](https://mastra.ai/reference/core/getScorer) - Get a scorer by its registration key
-- [listScorers()](https://mastra.ai/reference/core/listScorers) - Get all registered scorers
-- [createScorer()](https://mastra.ai/reference/evals/create-scorer) - Learn how to create scorers with ids
+- [getScorer()](https://mastra.ai/reference/core/getScorer): Get a scorer by its registration key
+- [listScorers()](https://mastra.ai/reference/core/listScorers): Get all registered scorers
+- [createScorer()](https://mastra.ai/reference/evals/create-scorer): Learn how to create scorers with ids

package/dist/docs/references/reference-core-listGateways.md

@@ -33,8 +33,8 @@ None.
 
 ## Related
 
-- [Mastra.getGateway()](https://mastra.ai/reference/core/getGateway) - Get gateway by registration key
-- [Mastra.getGatewayById()](https://mastra.ai/reference/core/getGatewayById) - Get gateway by ID
-- [Mastra.addGateway()](https://mastra.ai/reference/core/addGateway) - Add a gateway
-- [MastraModelGateway](https://mastra.ai/reference/core/mastra-model-gateway) - Gateway base class
-- [Custom Gateways Guide](https://mastra.ai/models/gateways/custom-gateways) - Creating custom gateways
+- [Mastra.getGateway()](https://mastra.ai/reference/core/getGateway): Get gateway by registration key
+- [Mastra.getGatewayById()](https://mastra.ai/reference/core/getGatewayById): Get gateway by ID
+- [Mastra.addGateway()](https://mastra.ai/reference/core/addGateway): Add a gateway
+- [MastraModelGateway](https://mastra.ai/reference/core/mastra-model-gateway): Gateway base class
+- [Custom Gateways Guide](https://mastra.ai/models/gateways/custom-gateways): Creating custom gateways

package/dist/docs/references/reference-core-listMCPServers.md

@@ -46,8 +46,8 @@ This method doesn't accept any parameters.
 
 ## Related methods
 
-- [Mastra.getMCPServer()](https://mastra.ai/reference/core/getMCPServer) - Retrieve an MCP server by its registry key
-- [Mastra.getMCPServerById()](https://mastra.ai/reference/core/getMCPServerById) - Retrieve an MCP server by its intrinsic `id` property
+- [Mastra.getMCPServer()](https://mastra.ai/reference/core/getMCPServer): Retrieve an MCP server by its registry key
+- [Mastra.getMCPServerById()](https://mastra.ai/reference/core/getMCPServerById): Retrieve an MCP server by its intrinsic `id` property
 
 ## See also
 

package/dist/docs/references/reference-core-listScorers.md

@@ -24,6 +24,6 @@ This method takes no parameters.
 
 ## Related
 
-- [getScorer()](https://mastra.ai/reference/core/getScorer) - Get a specific scorer by key
-- [getScorerById()](https://mastra.ai/reference/core/getScorerById) - Get a scorer by its id property
-- [Scorers Overview](https://mastra.ai/docs/evals/overview) - Learn about creating and using scorers
+- [getScorer()](https://mastra.ai/reference/core/getScorer): Get a specific scorer by key
+- [getScorerById()](https://mastra.ai/reference/core/getScorerById): Get a scorer by its id property
+- [Scorers Overview](https://mastra.ai/docs/evals/overview): Learn about creating and using scorers

package/dist/docs/references/reference-core-mastra-model-gateway.md

@@ -148,8 +148,8 @@ Examples:
 
 ## Related
 
-- [Custom Gateways Guide](https://mastra.ai/models/gateways/custom-gateways) - Complete guide to creating custom gateways
-- [Mastra.addGateway()](https://mastra.ai/reference/core/addGateway) - Add a gateway to Mastra
-- [Mastra.getGateway()](https://mastra.ai/reference/core/getGateway) - Get gateway by registration key
-- [Mastra.getGatewayById()](https://mastra.ai/reference/core/getGatewayById) - Get gateway by ID
-- [Mastra.listGateways()](https://mastra.ai/reference/core/listGateways) - List all gateways
+- [Custom Gateways Guide](https://mastra.ai/models/gateways/custom-gateways): Complete guide to creating custom gateways
+- [Mastra.addGateway()](https://mastra.ai/reference/core/addGateway): Add a gateway to Mastra
+- [Mastra.getGateway()](https://mastra.ai/reference/core/getGateway): Get gateway by registration key
+- [Mastra.getGatewayById()](https://mastra.ai/reference/core/getGatewayById): Get gateway by ID
+- [Mastra.listGateways()](https://mastra.ai/reference/core/listGateways): List all gateways

package/dist/docs/references/reference-evals-context-precision.md

@@ -191,6 +191,6 @@ Choose the right scorer for your needs:
 
 ## Related
 
-- [Answer Relevancy Scorer](https://mastra.ai/reference/evals/answer-relevancy) - Evaluates if answers address the question
-- [Faithfulness Scorer](https://mastra.ai/reference/evals/faithfulness) - Measures answer groundedness in context
-- [Custom Scorers](https://mastra.ai/docs/evals/custom-scorers) - Creating your own evaluation metrics
+- [Answer Relevancy Scorer](https://mastra.ai/reference/evals/answer-relevancy): Evaluates if answers address the question
+- [Faithfulness Scorer](https://mastra.ai/reference/evals/faithfulness): Measures answer groundedness in context
+- [Custom Scorers](https://mastra.ai/docs/evals/custom-scorers): Creating your own evaluation metrics

package/dist/docs/references/reference-evals-mastra-scorer.md

@@ -73,10 +73,10 @@ const result = await scorer.run({
 
 When you call `.run()`, the MastraScorer executes the defined steps in this order:
 
-1. **preprocess** (optional) - Extracts or transforms data
-2. **analyze** (optional) - Processes the input/output and preprocessed data
-3. **generateScore** (required) - Computes the numerical score
-4. **generateReason** (optional) - Provides explanation for the score
+1. **preprocess** (optional): Extracts or transforms data
+2. **analyze** (optional): Processes the input/output and preprocessed data
+3. **generateScore** (required): Computes the numerical score
+4. **generateReason** (optional): Provides explanation for the score
 
 Each step receives the results from previous steps, allowing you to build complex evaluation pipelines.
 

package/dist/docs/references/reference-evals-run-evals.md

@@ -246,9 +246,9 @@ const result = await runEvals({
 
 ## Related
 
-- [createScorer()](https://mastra.ai/reference/evals/create-scorer) - Create custom scorers for experiments
-- [MastraScorer](https://mastra.ai/reference/evals/mastra-scorer) - Learn about scorer structure and methods
-- [Trajectory Accuracy](https://mastra.ai/reference/evals/trajectory-accuracy) - Built-in trajectory evaluation scorers
-- [Scorer Utilities](https://mastra.ai/reference/evals/scorer-utils) - Helper functions for extracting trajectory data
-- [Custom Scorers](https://mastra.ai/docs/evals/custom-scorers) - Guide to building evaluation logic
-- [Scorers Overview](https://mastra.ai/docs/evals/overview) - Understanding scorer concepts
+- [createScorer()](https://mastra.ai/reference/evals/create-scorer): Create custom scorers for experiments
+- [MastraScorer](https://mastra.ai/reference/evals/mastra-scorer): Learn about scorer structure and methods
+- [Trajectory Accuracy](https://mastra.ai/reference/evals/trajectory-accuracy): Built-in trajectory evaluation scorers
+- [Scorer Utilities](https://mastra.ai/reference/evals/scorer-utils): Helper functions for extracting trajectory data
+- [Custom Scorers](https://mastra.ai/docs/evals/custom-scorers): Guide to building evaluation logic
+- [Scorers Overview](https://mastra.ai/docs/evals/overview): Understanding scorer concepts

package/dist/docs/references/reference-evals-scorer-utils.md

@@ -333,10 +333,10 @@ const trajectory = extractTrajectoryFromTrace(traceData.spans, rootSpanId)
 
 **Parameters:**
 
-- `spans` (`SpanRecord[]`) — Array of span records from a trace query.
-- `rootSpanId` (`string`, optional) — Span ID to use as the starting point. When omitted, uses spans with no parent.
+- `spans` (`SpanRecord[]`): Array of span records from a trace query.
+- `rootSpanId` (`string`, optional): Span ID to use as the starting point. When omitted, uses spans with no parent.
 
-**Returns:** `Trajectory` — Contains `steps: TrajectoryStep[]` with recursive `children` and `totalDurationMs`.
+**Returns:** `Trajectory`: Contains `steps: TrajectoryStep[]` with recursive `children` and `totalDurationMs`.
 
 #### Span type mapping
 

package/dist/docs/references/reference-evals-trajectory-accuracy.md

@@ -622,6 +622,6 @@ const result = await runEvals({
 
 ## Related
 
-- [runEvals reference](https://mastra.ai/reference/evals/run-evals) — Pipeline that extracts trajectories and passes them to scorers
-- [MastraScorer reference](https://mastra.ai/reference/evals/mastra-scorer) — Base scorer interface
-- [Scorer utils](https://mastra.ai/reference/evals/scorer-utils) — Utility functions including `extractTrajectory` and `compareTrajectories`
+- [runEvals reference](https://mastra.ai/reference/evals/run-evals): Pipeline that extracts trajectories and passes them to scorers
+- [MastraScorer reference](https://mastra.ai/reference/evals/mastra-scorer): Base scorer interface
+- [Scorer utils](https://mastra.ai/reference/evals/scorer-utils): Utility functions including `extractTrajectory` and `compareTrajectories`

package/dist/docs/references/reference-observability-tracing-bridges-otel.md

@@ -126,6 +126,6 @@ This format ensures compatibility with all OTEL-compatible backends and collecto
 
 ## Related
 
-- [OtelBridge Guide](https://mastra.ai/docs/observability/tracing/bridges/otel) - Setup guide with examples
-- [Tracing Overview](https://mastra.ai/docs/observability/tracing/overview) - General tracing concepts
-- [OtelExporter Reference](https://mastra.ai/reference/observability/tracing/exporters/otel) - OTEL exporter for sending traces
+- [OtelBridge Guide](https://mastra.ai/docs/observability/tracing/bridges/otel): Setup guide with examples
+- [Tracing Overview](https://mastra.ai/docs/observability/tracing/overview): General tracing concepts
+- [OtelExporter Reference](https://mastra.ai/reference/observability/tracing/exporters/otel): OTEL exporter for sending traces

package/dist/docs/references/reference-observability-tracing-configuration.md

@@ -189,21 +189,21 @@ Shuts down all observability instances and clears the registry.
 
 ### Documentation
 
-- [Tracing Overview](https://mastra.ai/docs/observability/tracing/overview) - Concepts and usage guide
-- [Sampling Strategies](https://mastra.ai/docs/observability/tracing/overview) - Sampling configuration details
-- [Multi-Config Setup](https://mastra.ai/docs/observability/tracing/overview) - Using multiple configurations
+- [Tracing Overview](https://mastra.ai/docs/observability/tracing/overview): Concepts and usage guide
+- [Sampling Strategies](https://mastra.ai/docs/observability/tracing/overview): Sampling configuration details
+- [Multi-Config Setup](https://mastra.ai/docs/observability/tracing/overview): Using multiple configurations
 
 ### Reference
 
-- [Tracing Classes](https://mastra.ai/reference/observability/tracing/instances) - Core tracing classes
-- [Interfaces](https://mastra.ai/reference/observability/tracing/interfaces) - Type definitions
-- [Spans Reference](https://mastra.ai/reference/observability/tracing/spans) - Span lifecycle
+- [Tracing Classes](https://mastra.ai/reference/observability/tracing/instances): Core tracing classes
+- [Interfaces](https://mastra.ai/reference/observability/tracing/interfaces): Type definitions
+- [Spans Reference](https://mastra.ai/reference/observability/tracing/spans): Span lifecycle
 
 ### Exporters
 
-- [DefaultExporter](https://mastra.ai/reference/observability/tracing/exporters/default-exporter) - Storage configuration
-- [CloudExporter](https://mastra.ai/reference/observability/tracing/exporters/cloud-exporter) - Cloud setup
-- [Braintrust](https://mastra.ai/reference/observability/tracing/exporters/braintrust) - Braintrust integration
-- [Langfuse](https://mastra.ai/reference/observability/tracing/exporters/langfuse) - Langfuse integration
-- [LangSmith](https://mastra.ai/reference/observability/tracing/exporters/langsmith) - LangSmith integration
-- [Span filtering](https://mastra.ai/reference/observability/tracing/span-filtering) - Selectively exclude spans
+- [DefaultExporter](https://mastra.ai/reference/observability/tracing/exporters/default-exporter): Storage configuration
+- [CloudExporter](https://mastra.ai/reference/observability/tracing/exporters/cloud-exporter): Cloud setup
+- [Braintrust](https://mastra.ai/reference/observability/tracing/exporters/braintrust): Braintrust integration
+- [Langfuse](https://mastra.ai/reference/observability/tracing/exporters/langfuse): Langfuse integration
+- [LangSmith](https://mastra.ai/reference/observability/tracing/exporters/langsmith): LangSmith integration
+- [Span filtering](https://mastra.ai/reference/observability/tracing/span-filtering): Selectively exclude spans

package/dist/docs/references/reference-observability-tracing-exporters-console-exporter.md

@@ -119,17 +119,17 @@ const exporterWithLogger = new ConsoleExporter({
 
 ### Documentation
 
-- [Tracing Overview](https://mastra.ai/docs/observability/tracing/overview) - Complete guide
-- [Exporters](https://mastra.ai/docs/observability/tracing/overview) - Exporter concepts
+- [Tracing Overview](https://mastra.ai/docs/observability/tracing/overview): Complete guide
+- [Exporters](https://mastra.ai/docs/observability/tracing/overview): Exporter concepts
 
 ### Other Exporters
 
-- [DefaultExporter](https://mastra.ai/reference/observability/tracing/exporters/default-exporter) - Storage persistence
-- [CloudExporter](https://mastra.ai/reference/observability/tracing/exporters/cloud-exporter) - Mastra Cloud
-- [Langfuse](https://mastra.ai/reference/observability/tracing/exporters/langfuse) - Langfuse integration
-- [Braintrust](https://mastra.ai/reference/observability/tracing/exporters/braintrust) - Braintrust integration
+- [DefaultExporter](https://mastra.ai/reference/observability/tracing/exporters/default-exporter): Storage persistence
+- [CloudExporter](https://mastra.ai/reference/observability/tracing/exporters/cloud-exporter): Mastra platform
+- [Langfuse](https://mastra.ai/reference/observability/tracing/exporters/langfuse): Langfuse integration
+- [Braintrust](https://mastra.ai/reference/observability/tracing/exporters/braintrust): Braintrust integration
 
 ### Reference
 
-- [Configuration](https://mastra.ai/reference/observability/tracing/configuration) - Configuration options
-- [Interfaces](https://mastra.ai/reference/observability/tracing/interfaces) - Type definitions
+- [Configuration](https://mastra.ai/reference/observability/tracing/configuration): Configuration options
+- [Interfaces](https://mastra.ai/reference/observability/tracing/interfaces): Type definitions

package/dist/docs/references/reference-observability-tracing-instances.md

@@ -95,13 +95,13 @@ class CustomObservabilityInstance extends BaseObservabilityInstance {
 
 ### Documentation
 
-- [Tracing Overview](https://mastra.ai/docs/observability/tracing/overview) - Concepts and usage guide
-- [Configuration Reference](https://mastra.ai/reference/observability/tracing/configuration) - Configuration options
-- [Interfaces Reference](https://mastra.ai/reference/observability/tracing/interfaces) - Type definitions
-- [Spans Reference](https://mastra.ai/reference/observability/tracing/spans) - Span lifecycle and methods
+- [Tracing Overview](https://mastra.ai/docs/observability/tracing/overview): Concepts and usage guide
+- [Configuration Reference](https://mastra.ai/reference/observability/tracing/configuration): Configuration options
+- [Interfaces Reference](https://mastra.ai/reference/observability/tracing/interfaces): Type definitions
+- [Spans Reference](https://mastra.ai/reference/observability/tracing/spans): Span lifecycle and methods
 
 ### Exporters
 
-- [DefaultExporter](https://mastra.ai/reference/observability/tracing/exporters/default-exporter) - Storage persistence
-- [CloudExporter](https://mastra.ai/reference/observability/tracing/exporters/cloud-exporter) - Mastra Cloud integration
-- [ConsoleExporter](https://mastra.ai/reference/observability/tracing/exporters/console-exporter) - Debug output
+- [DefaultExporter](https://mastra.ai/reference/observability/tracing/exporters/default-exporter): Storage persistence
+- [CloudExporter](https://mastra.ai/reference/observability/tracing/exporters/cloud-exporter): Mastra platform integration
+- [ConsoleExporter](https://mastra.ai/reference/observability/tracing/exporters/console-exporter): Debug output

package/dist/docs/references/reference-observability-tracing-interfaces.md

@@ -735,12 +735,12 @@ enum InternalSpans {
 
 ### Documentation
 
-- [Tracing Overview](https://mastra.ai/docs/observability/tracing/overview) - Complete guide to Tracing
-- [Creating Child Spans](https://mastra.ai/docs/observability/tracing/overview) - Working with span hierarchies
-- [Adding Custom Metadata](https://mastra.ai/docs/observability/tracing/overview) - Enriching traces
+- [Tracing Overview](https://mastra.ai/docs/observability/tracing/overview): Complete guide to Tracing
+- [Creating Child Spans](https://mastra.ai/docs/observability/tracing/overview): Working with span hierarchies
+- [Adding Custom Metadata](https://mastra.ai/docs/observability/tracing/overview): Enriching traces
 
 ### Reference
 
-- [Configuration](https://mastra.ai/reference/observability/tracing/configuration) - Registry and configuration
-- [Tracing Classes](https://mastra.ai/reference/observability/tracing/instances) - Core implementations
-- [Spans Reference](https://mastra.ai/reference/observability/tracing/spans) - Span lifecycle methods
+- [Configuration](https://mastra.ai/reference/observability/tracing/configuration): Registry and configuration
+- [Tracing Classes](https://mastra.ai/reference/observability/tracing/instances): Core implementations
+- [Spans Reference](https://mastra.ai/reference/observability/tracing/spans): Span lifecycle methods