@mastra/mcp-docs-server 1.2.4-alpha.1 → 1.2.4-alpha.6

package/.docs/reference/evals/completeness.md

@@ -1,3 +1,5 @@
+> Discover all available pages from the documentation index: https://mastra.ai/llms.txt
+
 # Completeness scorer
 
 The `createCompletenessScorer()` function evaluates how thoroughly an LLM's output covers the key elements present in the input. It analyzes nouns, verbs, topics, and terms to determine coverage and provides a detailed completeness score.

package/.docs/reference/evals/content-similarity.md

@@ -1,3 +1,5 @@
+> Discover all available pages from the documentation index: https://mastra.ai/llms.txt
+
 # Content similarity scorer
 
 The `createContentSimilarityScorer()` function measures the textual similarity between two strings, providing a score that indicates how closely they match. It supports configurable options for case sensitivity and whitespace handling.

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

@@ -1,3 +1,5 @@
+> Discover all available pages from the documentation index: https://mastra.ai/llms.txt
+
 # Context precision scorer
 
 The `createContextPrecisionScorer()` function creates a scorer that evaluates how relevant and well-positioned retrieved context pieces are for generating expected outputs. It uses **Mean Average Precision (MAP)** to reward systems that place relevant context earlier in the sequence.

package/.docs/reference/evals/context-relevance.md

@@ -1,3 +1,5 @@
+> Discover all available pages from the documentation index: https://mastra.ai/llms.txt
+
 # Context relevance scorer
 
 The `createContextRelevanceScorerLLM()` function creates a scorer that evaluates how relevant and useful provided context was for generating agent responses. It uses weighted relevance levels and applies penalties for unused high-relevance context and missing information.

package/.docs/reference/evals/create-scorer.md

@@ -1,3 +1,5 @@
+> Discover all available pages from the documentation index: https://mastra.ai/llms.txt
+
 # createScorer
 
 Mastra provides a unified `createScorer` factory that allows you to define custom scorers for evaluating input/output pairs. You can use either native JavaScript functions or LLM-based prompt objects for each evaluation step. Custom scorers can be added to Agents and Workflow steps.

package/.docs/reference/evals/faithfulness.md

@@ -1,3 +1,5 @@
+> Discover all available pages from the documentation index: https://mastra.ai/llms.txt
+
 # Faithfulness scorer
 
 The `createFaithfulnessScorer()` function evaluates how factually accurate an LLM's output is compared to the provided context. It extracts claims from the output and verifies them against the context, making it essential to measure RAG pipeline responses' reliability.

package/.docs/reference/evals/filter-run.md

@@ -1,3 +1,5 @@
+> Discover all available pages from the documentation index: https://mastra.ai/llms.txt
+
 # filterRun()
 
 Creates a `prepareRun` function from declarative options. Pass the result to `createScorer()` to filter messages, limit context size, and drop unnecessary fields before the scorer pipeline runs.

package/.docs/reference/evals/hallucination.md

@@ -1,3 +1,5 @@
+> Discover all available pages from the documentation index: https://mastra.ai/llms.txt
+
 # Hallucination scorer
 
 The `createHallucinationScorer()` function evaluates whether an LLM generates factually correct information by comparing its output against the provided context. This scorer measures hallucination by identifying direct contradictions between the context and the output.
@@ -155,6 +157,7 @@ const hallucinationScorer = createHallucinationScorer({
 })
 
 const agent = new Agent({
+  id: 'my-agent',
   name: 'my-agent',
   model: 'openai/gpt-5.5',
   instructions: 'You are a helpful assistant.',

package/.docs/reference/evals/keyword-coverage.md

@@ -1,3 +1,5 @@
+> Discover all available pages from the documentation index: https://mastra.ai/llms.txt
+
 # Keyword coverage scorer
 
 The `createKeywordCoverageScorer()` function evaluates how well an LLM's output covers the important keywords from the input. It analyzes keyword presence and matches while ignoring common words and stop words.

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

@@ -1,3 +1,5 @@
+> Discover all available pages from the documentation index: https://mastra.ai/llms.txt
+
 # MastraScorer
 
 The `MastraScorer` class is the base class for all scorers in Mastra. It provides a standard `.run()` method for evaluating input/output pairs and supports multi-step scoring workflows with preprocess → analyze → generateScore → generateReason execution flow.

package/.docs/reference/evals/noise-sensitivity.md

@@ -1,3 +1,5 @@
+> Discover all available pages from the documentation index: https://mastra.ai/llms.txt
+
 # Noise sensitivity scorer
 
 The `createNoiseSensitivityScorerLLM()` function creates a **CI/testing scorer** that evaluates how robust an agent is when exposed to irrelevant, distracting, or misleading information. Unlike live scorers that evaluate single production runs, this scorer requires predetermined test data including both baseline responses and noisy variations.

package/.docs/reference/evals/prompt-alignment.md

@@ -1,3 +1,5 @@
+> Discover all available pages from the documentation index: https://mastra.ai/llms.txt
+
 # Prompt alignment scorer
 
 The `createPromptAlignmentScorerLLM()` function creates a scorer that evaluates how well agent responses align with user prompts across multiple dimensions: intent understanding, requirement fulfillment, response completeness, and format appropriateness.
@@ -219,6 +221,7 @@ Measure how well your AI agents follow user instructions:
 
 ```typescript
 const agent = new Agent({
+  id: 'coding-assistant',
   name: 'CodingAssistant',
   instructions: 'You are a helpful coding assistant. Always provide working code examples.',
   model: 'openai/gpt-5.5',

package/.docs/reference/evals/rubric.md

@@ -1,3 +1,5 @@
+> Discover all available pages from the documentation index: https://mastra.ai/llms.txt
+
 # Rubric scorer
 
 **Added in:** `@mastra/evals@1.3.0`

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

@@ -1,3 +1,5 @@
+> Discover all available pages from the documentation index: https://mastra.ai/llms.txt
+
 # runEvals
 
 The `runEvals` function enables batch evaluation of agents and workflows by running multiple test cases against scorers concurrently. This is essential for systematic testing, performance analysis, and validation of AI systems.

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

@@ -1,3 +1,5 @@
+> Discover all available pages from the documentation index: https://mastra.ai/llms.txt
+
 # Scorer utils
 
 Mastra provides utility functions to help extract and process data from scorer run inputs and outputs. These utilities are particularly useful in the `preprocess` step of custom scorers.

package/.docs/reference/evals/textual-difference.md

@@ -1,3 +1,5 @@
+> Discover all available pages from the documentation index: https://mastra.ai/llms.txt
+
 # Textual difference scorer
 
 The `createTextualDifferenceScorer()` function uses sequence matching to measure the textual differences between two strings. It provides detailed information about changes, including the number of operations needed to transform one text into another.

package/.docs/reference/evals/tone-consistency.md

@@ -1,3 +1,5 @@
+> Discover all available pages from the documentation index: https://mastra.ai/llms.txt
+
 # Tone consistency scorer
 
 The `createToneScorer()` function evaluates the text's emotional tone and sentiment consistency. It can operate in two modes: comparing tone between input/output pairs or analyzing tone stability within a single text.

package/.docs/reference/evals/tool-call-accuracy.md

@@ -1,3 +1,5 @@
+> Discover all available pages from the documentation index: https://mastra.ai/llms.txt
+
 # Tool call accuracy scorers
 
 Mastra provides two tool call accuracy scorers for evaluating whether an LLM selects the correct tools from available options:

package/.docs/reference/evals/toxicity.md

@@ -1,3 +1,5 @@
+> Discover all available pages from the documentation index: https://mastra.ai/llms.txt
+
 # Toxicity scorer
 
 The `createToxicityScorer()` function evaluates whether an LLM's output contains racist, biased, or toxic elements. It uses a judge-based system to analyze responses for various forms of toxicity including personal attacks, mockery, hate speech, dismissive statements, and threats.

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

@@ -1,3 +1,5 @@
+> Discover all available pages from the documentation index: https://mastra.ai/llms.txt
+
 # Trajectory accuracy scorers
 
 Mastra provides two trajectory accuracy scorers for evaluating whether an agent or workflow follows an expected sequence of actions:

package/.docs/reference/index.md

@@ -1,3 +1,5 @@
+> Discover all available pages from the documentation index: https://mastra.ai/llms.txt
+
 # Reference
 
 The Reference section provides documentation of Mastra's API, including parameters, types and usage examples.
@@ -256,6 +258,7 @@ The Reference section provides documentation of Mastra's API, including paramete
 - [MSSQL Storage](https://mastra.ai/reference/storage/mssql)
 - [PostgreSQL Storage](https://mastra.ai/reference/storage/postgresql)
 - [Redis Storage](https://mastra.ai/reference/storage/redis)
+- [Retention (prune)](https://mastra.ai/reference/storage/retention)
 - [Upstash Storage](https://mastra.ai/reference/storage/upstash)
 - [ChunkType](https://mastra.ai/reference/streaming/ChunkType)
 - [MastraModelOutput](https://mastra.ai/reference/streaming/agents/MastraModelOutput)
@@ -348,6 +351,7 @@ The Reference section provides documentation of Mastra's API, including paramete
 - [.timeTravel()](https://mastra.ai/reference/workflows/run-methods/timeTravel)
 - [AgentCoreRuntimeSandbox](https://mastra.ai/reference/workspace/agentcore-runtime-sandbox)
 - [AgentFSFilesystem](https://mastra.ai/reference/workspace/agentfs-filesystem)
+- [AppleContainerSandbox](https://mastra.ai/reference/workspace/apple-container-sandbox)
 - [ArchilFilesystem](https://mastra.ai/reference/workspace/archil-filesystem)
 - [AzureBlobFilesystem](https://mastra.ai/reference/workspace/azure-blob-filesystem)
 - [BlaxelSandbox](https://mastra.ai/reference/workspace/blaxel-sandbox)
@@ -359,6 +363,7 @@ The Reference section provides documentation of Mastra's API, including paramete
 - [GoogleDriveFilesystem](https://mastra.ai/reference/workspace/google-drive-filesystem)
 - [LocalFilesystem](https://mastra.ai/reference/workspace/local-filesystem)
 - [LocalSandbox](https://mastra.ai/reference/workspace/local-sandbox)
+- [MesaFilesystem](https://mastra.ai/reference/workspace/mesa-filesystem)
 - [ModalSandbox](https://mastra.ai/reference/workspace/modal-sandbox)
 - [RailwaySandbox](https://mastra.ai/reference/workspace/railway-sandbox)
 - [S3Filesystem](https://mastra.ai/reference/workspace/s3-filesystem)

package/.docs/reference/logging/pino-logger.md

@@ -1,3 +1,5 @@
+> Discover all available pages from the documentation index: https://mastra.ai/llms.txt
+
 # PinoLogger
 
 A Logger instance is created using `new PinoLogger()` and provides methods to record events at various severity levels.

package/.docs/reference/mastra-platform/api.md

@@ -1,3 +1,5 @@
+> Discover all available pages from the documentation index: https://mastra.ai/llms.txt
+
 # API reference
 
 ## Members API

package/.docs/reference/memory/clone-utilities.md

@@ -1,3 +1,5 @@
+> Discover all available pages from the documentation index: https://mastra.ai/llms.txt
+
 # Cloned thread utilities
 
 The Memory class provides utility methods for working with cloned threads. These methods help you check clone status, retrieve clone metadata, navigate clone relationships, and track clone history.

package/.docs/reference/memory/cloneThread.md

@@ -1,3 +1,5 @@
+> Discover all available pages from the documentation index: https://mastra.ai/llms.txt
+
 # Memory.cloneThread()
 
 The `.cloneThread()` method creates a copy of an existing conversation thread, including all its messages. This enables creating divergent conversation paths from a specific point in a conversation. When semantic recall is enabled, the method also creates vector embeddings for the cloned messages.

package/.docs/reference/memory/createThread.md

@@ -1,3 +1,5 @@
+> Discover all available pages from the documentation index: https://mastra.ai/llms.txt
+
 # Memory.createThread()
 
 The `.createThread()` method creates a new conversation thread in the memory system. Each thread represents a distinct conversation or context and can contain multiple messages.

package/.docs/reference/memory/deleteMessages.md

@@ -1,3 +1,5 @@
+> Discover all available pages from the documentation index: https://mastra.ai/llms.txt
+
 # Memory.deleteMessages()
 
 The `.deleteMessages()` method deletes multiple messages by their IDs.

package/.docs/reference/memory/getThreadById.md

@@ -1,3 +1,5 @@
+> Discover all available pages from the documentation index: https://mastra.ai/llms.txt
+
 # Memory.getThreadById()
 
 The `.getThreadById()` method retrieves a specific thread by its ID.

package/.docs/reference/memory/listThreads.md

@@ -1,3 +1,5 @@
+> Discover all available pages from the documentation index: https://mastra.ai/llms.txt
+
 # Memory.listThreads()
 
 The `listThreads()` method retrieves threads with pagination support and optional filtering by `resourceId`, `metadata`, or both.

package/.docs/reference/memory/memory-class.md

@@ -1,3 +1,5 @@
+> Discover all available pages from the documentation index: https://mastra.ai/llms.txt
+
 # Memory class
 
 The `Memory` class provides a robust system for managing conversation history and thread-based message storage in Mastra. It enables persistent storage of conversations, semantic search capabilities, and efficient message retrieval. You must configure a storage provider for conversation history, and if you enable semantic recall you will also need to provide a vector store and embedder.
@@ -9,6 +11,7 @@ import { Memory } from '@mastra/memory'
 import { Agent } from '@mastra/core/agent'
 
 export const agent = new Agent({
+  id: 'test-agent',
   name: 'test-agent',
   instructions: 'You are an agent with memory.',
   model: 'openai/gpt-5.5',

package/.docs/reference/memory/observational-memory.md

@@ -1,3 +1,5 @@
+> Discover all available pages from the documentation index: https://mastra.ai/llms.txt
+
 # Observational Memory
 
 **Added in:** `@mastra/memory@1.1.0`
@@ -11,6 +13,7 @@ import { Memory } from '@mastra/memory'
 import { Agent } from '@mastra/core/agent'
 
 export const agent = new Agent({
+  id: 'my-agent',
   name: 'my-agent',
   instructions: 'You are a helpful assistant.',
   model: 'openai/gpt-5-mini',
@@ -203,6 +206,7 @@ import { Memory } from '@mastra/memory'
 import { Agent } from '@mastra/core/agent'
 
 export const agent = new Agent({
+  id: 'my-agent',
   name: 'my-agent',
   instructions: 'You are a helpful assistant.',
   model: 'openai/gpt-5-mini',
@@ -232,6 +236,7 @@ import { Memory } from '@mastra/memory'
 import { Agent } from '@mastra/core/agent'
 
 export const agent = new Agent({
+  id: 'my-agent',
   name: 'my-agent',
   instructions: 'You are a helpful assistant.',
   model: 'openai/gpt-5-mini',
@@ -261,6 +266,7 @@ import { Memory } from '@mastra/memory'
 import { Agent } from '@mastra/core/agent'
 
 export const agent = new Agent({
+  id: 'my-agent',
   name: 'my-agent',
   instructions: 'You are a helpful assistant.',
   model: 'openai/gpt-5.5',
@@ -281,6 +287,7 @@ import { Memory } from '@mastra/memory'
 import { Agent } from '@mastra/core/agent'
 
 export const agent = new Agent({
+  id: 'my-agent',
   name: 'my-agent',
   instructions: 'You are a helpful assistant.',
   model: 'openai/gpt-5.5',
@@ -308,6 +315,7 @@ import { Memory } from '@mastra/memory'
 import { Agent } from '@mastra/core/agent'
 
 export const agent = new Agent({
+  id: 'health-assistant',
   name: 'health-assistant',
   instructions: 'You are a health and wellness assistant.',
   model: 'openai/gpt-5.5',
@@ -351,6 +359,7 @@ import { Memory } from '@mastra/memory'
 import { Agent } from '@mastra/core/agent'
 
 export const agent = new Agent({
+  id: 'my-agent',
   name: 'my-agent',
   instructions: 'You are a helpful assistant.',
   model: 'openai/gpt-5-mini',
@@ -666,6 +675,7 @@ const om = new ObservationalMemory({
 })
 
 export const agent = new Agent({
+  id: 'my-agent',
   name: 'my-agent',
   instructions: 'You are a helpful assistant.',
   model: 'openai/gpt-5-mini',

package/.docs/reference/memory/recall.md

@@ -1,3 +1,5 @@
+> Discover all available pages from the documentation index: https://mastra.ai/llms.txt
+
 # Memory.recall()
 
 the `.recall()` method retrieves messages from a specific thread, with support for pagination, filtering options, and semantic search.

package/.docs/reference/memory/serialized-memory-config.md

@@ -1,3 +1,5 @@
+> Discover all available pages from the documentation index: https://mastra.ai/llms.txt
+
 # SerializedMemoryConfig
 
 `SerializedMemoryConfig` is the JSON-serializable subset of [`Memory`](https://mastra.ai/reference/memory/memory-class) configuration that lives on a stored agent record. The runtime hydrates it back into a `Memory` instance by resolving the vector and embedder IDs against the configured `Mastra` instance.

package/.docs/reference/observability/metrics/automatic-metrics.md

@@ -1,3 +1,5 @@
+> Discover all available pages from the documentation index: https://mastra.ai/llms.txt
+
 # Automatic metrics reference
 
 Mastra automatically extracts performance and usage metrics from traced execution. This page is the complete reference for every metric name, label, and context field that Mastra emits.

package/.docs/reference/observability/tracing/bridges/datadog.md

@@ -1,3 +1,5 @@
+> Discover all available pages from the documentation index: https://mastra.ai/llms.txt
+
 # DatadogBridge
 
 > **Warning:** The Datadog Bridge is currently **experimental**. APIs and configuration options may change in future releases.

package/.docs/reference/observability/tracing/bridges/otel.md

@@ -1,3 +1,5 @@
+> Discover all available pages from the documentation index: https://mastra.ai/llms.txt
+
 # OtelBridge
 
 > **Warning:** The OpenTelemetry Bridge is currently **experimental**. APIs and configuration options may change in future releases.

package/.docs/reference/observability/tracing/configuration.md

@@ -1,3 +1,5 @@
+> Discover all available pages from the documentation index: https://mastra.ai/llms.txt
+
 # Configuration
 
 ## `ObservabilityRegistryConfig`

package/.docs/reference/observability/tracing/exporters/arize.md

@@ -1,3 +1,5 @@
+> Discover all available pages from the documentation index: https://mastra.ai/llms.txt
+
 # ArizeExporter
 
 Sends Tracing data to Arize Phoenix, Arize AX, or any OpenTelemetry-compatible observability platform that supports OpenInference semantic conventions.

package/.docs/reference/observability/tracing/exporters/arthur.md

@@ -1,3 +1,5 @@
+> Discover all available pages from the documentation index: https://mastra.ai/llms.txt
+
 # ArthurExporter
 
 Sends Tracing data to [Arthur Engine](https://github.com/arthur-ai/arthur-engine) using OpenTelemetry and OpenInference semantic conventions.

package/.docs/reference/observability/tracing/exporters/braintrust.md

@@ -1,3 +1,5 @@
+> Discover all available pages from the documentation index: https://mastra.ai/llms.txt
+
 # BraintrustExporter
 
 Sends Tracing data to Braintrust for eval and observability.

package/.docs/reference/observability/tracing/exporters/cloud-exporter.md

@@ -1,3 +1,5 @@
+> Discover all available pages from the documentation index: https://mastra.ai/llms.txt
+
 # CloudExporter
 
 **Added in:** `@mastra/observability@1.8.0`. **Deprecated in `1.12.0`** in favor of [`MastraPlatformExporter`](https://mastra.ai/reference/observability/tracing/exporters/mastra-platform-exporter).

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

@@ -1,3 +1,5 @@
+> Discover all available pages from the documentation index: https://mastra.ai/llms.txt
+
 # ConsoleExporter
 
 Outputs trace events to the console for debugging and development.

package/.docs/reference/observability/tracing/exporters/datadog.md

@@ -1,3 +1,5 @@
+> Discover all available pages from the documentation index: https://mastra.ai/llms.txt
+
 # DatadogExporter
 
 Sends Tracing data to Datadog's LLM Observability product for monitoring and analytics.

package/.docs/reference/observability/tracing/exporters/default-exporter.md

@@ -1,3 +1,5 @@
+> Discover all available pages from the documentation index: https://mastra.ai/llms.txt
+
 # DefaultExporter
 
 **Deprecated in `@mastra/observability@1.12.0`** in favor of [`MastraStorageExporter`](https://mastra.ai/reference/observability/tracing/exporters/mastra-storage-exporter).

package/.docs/reference/observability/tracing/exporters/laminar.md

@@ -1,3 +1,5 @@
+> Discover all available pages from the documentation index: https://mastra.ai/llms.txt
+
 # LaminarExporter
 
 Sends Tracing data to Laminar via OTLP/HTTP (protobuf).

package/.docs/reference/observability/tracing/exporters/langfuse.md

@@ -1,3 +1,5 @@
+> Discover all available pages from the documentation index: https://mastra.ai/llms.txt
+
 # LangfuseExporter
 
 Sends Tracing data to Langfuse for observability.
@@ -102,6 +104,7 @@ const exporter = new LangfuseExporter()
 const prompt = await exporter.client.prompt.get('customer-support', { type: 'text' })
 
 const agent = new Agent({
+  id: 'support-agent',
   name: 'support-agent',
   instructions: prompt.compile(),
   model: 'openai/gpt-5.5',

package/.docs/reference/observability/tracing/exporters/langsmith.md

@@ -1,3 +1,5 @@
+> Discover all available pages from the documentation index: https://mastra.ai/llms.txt
+
 # LangSmithExporter
 
 Sends Tracing data to LangSmith for observability.

package/.docs/reference/observability/tracing/exporters/mastra-platform-exporter.md

@@ -1,3 +1,5 @@
+> Discover all available pages from the documentation index: https://mastra.ai/llms.txt
+
 # MastraPlatformExporter
 
 **Added in:** `@mastra/observability@1.12.0`. Earlier releases (`@mastra/observability@1.8.0` through `1.11.x`) export the same exporter as the deprecated `CloudExporter`.

package/.docs/reference/observability/tracing/exporters/mastra-storage-exporter.md

@@ -1,3 +1,5 @@
+> Discover all available pages from the documentation index: https://mastra.ai/llms.txt
+
 # MastraStorageExporter
 
 Persists traces to Mastra's configured storage with automatic batching and retry logic.

package/.docs/reference/observability/tracing/exporters/otel.md

@@ -1,3 +1,5 @@
+> Discover all available pages from the documentation index: https://mastra.ai/llms.txt
+
 # OtelExporter
 
 Sends traces and logs to any OpenTelemetry-compatible observability platform. Traces use the standardized GenAI semantic conventions; logs carry their original severity and message body and are correlated to traces via both the OTEL log record's native trace context and `mastra.traceId` / `mastra.spanId` attributes.

package/.docs/reference/observability/tracing/exporters/posthog.md

@@ -1,3 +1,5 @@
+> Discover all available pages from the documentation index: https://mastra.ai/llms.txt
+
 # PosthogExporter
 
 Sends Tracing data to PostHog for AI observability and analytics.

package/.docs/reference/observability/tracing/exporters/sentry.md

@@ -1,3 +1,5 @@
+> Discover all available pages from the documentation index: https://mastra.ai/llms.txt
+
 # SentryExporter
 
 Sends Tracing data to Sentry for AI tracing and monitoring using OpenTelemetry semantic conventions.

package/.docs/reference/observability/tracing/instances.md

@@ -1,3 +1,5 @@
+> Discover all available pages from the documentation index: https://mastra.ai/llms.txt
+
 # Observability Instances
 
 ## `DefaultObservabilityInstance`

package/.docs/reference/observability/tracing/interfaces.md

@@ -1,3 +1,5 @@
+> Discover all available pages from the documentation index: https://mastra.ai/llms.txt
+
 # Interfaces
 
 ## Core interfaces

package/.docs/reference/observability/tracing/processors/sensitive-data-filter.md

@@ -1,3 +1,5 @@
+> Discover all available pages from the documentation index: https://mastra.ai/llms.txt
+
 # SensitiveDataFilter
 
 A SpanOutputProcessor that redacts sensitive information from span fields.

package/.docs/reference/observability/tracing/span-filtering.md

@@ -1,3 +1,5 @@
+> Discover all available pages from the documentation index: https://mastra.ai/llms.txt
+
 # Span filtering
 
 Span filtering controls which spans are exported from an observability config. Use it to reduce noise, lower per-span costs, or keep only the spans that matter for a specific exporter or environment.

package/.docs/reference/observability/tracing/spans.md

@@ -1,3 +1,5 @@
+> Discover all available pages from the documentation index: https://mastra.ai/llms.txt
+
 # Spans
 
 ## `BaseSpan`

package/.docs/reference/processors/batch-parts-processor.md

@@ -1,3 +1,5 @@
+> Discover all available pages from the documentation index: https://mastra.ai/llms.txt
+
 # BatchPartsProcessor
 
 The `BatchPartsProcessor` is an **output processor** that batches multiple stream parts together to reduce the frequency of emissions during streaming. This processor is useful for reducing network overhead, improving user experience by consolidating small text chunks, and optimizing streaming performance by controlling when parts are emitted to the client.
@@ -41,6 +43,7 @@ import { Agent } from '@mastra/core/agent'
 import { BatchPartsProcessor } from '@mastra/core/processors'
 
 export const agent = new Agent({
+  id: 'batched-agent',
   name: 'batched-agent',
   instructions: 'You are a helpful assistant',
   model: 'openai/gpt-5.5',

package/.docs/reference/processors/cost-guard-processor.md

@@ -1,3 +1,5 @@
+> Discover all available pages from the documentation index: https://mastra.ai/llms.txt
+
 # CostGuardProcessor
 
 The `CostGuardProcessor` enforces monetary cost limits across the agentic loop, blocking or warning when a configurable cost threshold is exceeded.
@@ -55,6 +57,7 @@ costGuard.onViolation = ({ detail }) => {
 }
 
 const agent = new Agent({
+  id: 'my-agent',
   name: 'my-agent',
   model: 'openai/gpt-5-nano',
   processors: {

package/.docs/reference/processors/language-detector.md

@@ -1,3 +1,5 @@
+> Discover all available pages from the documentation index: https://mastra.ai/llms.txt
+
 # LanguageDetector
 
 The `LanguageDetector` is an **input processor** that identifies the language of input text and optionally translates it to a target language for consistent processing. This processor helps maintain language consistency by detecting the language of incoming messages and providing flexible strategies for handling multilingual content, including automatic translation to ensure all content is processed in the target language.

package/.docs/reference/processors/message-history-processor.md

@@ -1,3 +1,5 @@
+> Discover all available pages from the documentation index: https://mastra.ai/llms.txt
+
 # MessageHistory
 
 The `MessageHistory` is a **hybrid processor** that handles both retrieval and persistence of message history. On input, it fetches historical messages from storage and prepends them to the conversation. On output, it persists new messages to storage.
@@ -43,6 +45,7 @@ const storage = new PostgresStorage({
 })
 
 export const agent = new Agent({
+  id: 'memory-agent',
   name: 'memory-agent',
   instructions: 'You are a helpful assistant with conversation memory',
   model: 'openai/gpt-5.5',

package/.docs/reference/processors/moderation-processor.md

@@ -1,3 +1,5 @@
+> Discover all available pages from the documentation index: https://mastra.ai/llms.txt
+
 # ModerationProcessor
 
 The `ModerationProcessor` is a **hybrid processor** that can be used for both input and output processing to provide content moderation using an LLM to detect inappropriate content across multiple categories. This processor helps maintain content safety by evaluating messages against configurable moderation categories with flexible strategies for handling flagged content.
@@ -57,6 +59,7 @@ import { Agent } from '@mastra/core/agent'
 import { ModerationProcessor } from '@mastra/core/processors'
 
 export const agent = new Agent({
+  id: 'moderated-agent',
   name: 'moderated-agent',
   instructions: 'You are a helpful assistant',
   model: 'openai/gpt-5.5',
@@ -82,6 +85,7 @@ import { Agent } from '@mastra/core/agent'
 import { BatchPartsProcessor, ModerationProcessor } from '@mastra/core/processors'
 
 export const agent = new Agent({
+  id: 'output-moderated-agent',
   name: 'output-moderated-agent',
   instructions: 'You are a helpful assistant',
   model: 'openai/gpt-5.5',

package/.docs/reference/processors/pii-detector.md

@@ -1,3 +1,5 @@
+> Discover all available pages from the documentation index: https://mastra.ai/llms.txt
+
 # PIIDetector
 
 The `PIIDetector` is a **hybrid processor** that can be used for both input and output processing to detect and redact personally identifiable information (PII) for privacy compliance. This processor helps maintain privacy by identifying various types of PII and providing flexible strategies for handling them, including multiple redaction methods to ensure compliance with GDPR, CCPA, HIPAA, and other privacy regulations.
@@ -59,6 +61,7 @@ import { Agent } from '@mastra/core/agent'
 import { PIIDetector } from '@mastra/core/processors'
 
 export const agent = new Agent({
+  id: 'private-agent',
   name: 'private-agent',
   instructions: 'You are a helpful assistant',
   model: 'openai/gpt-5.5',
@@ -87,6 +90,7 @@ import { Agent } from '@mastra/core/agent'
 import { BatchPartsProcessor, PIIDetector } from '@mastra/core/processors'
 
 export const agent = new Agent({
+  id: 'output-pii-agent',
   name: 'output-pii-agent',
   instructions: 'You are a helpful assistant',
   model: 'openai/gpt-5.5',