@mastra/mcp-docs-server 1.2.5-alpha.1 → 1.2.5-alpha.3

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

@@ -19,7 +19,7 @@ interface ObservabilityRegistryConfig {
 
 **configSelector** (`ConfigSelector`): Runtime configuration selector function
 
-**sensitiveDataFilter** (`boolean | SensitiveDataFilterOptions`): Controls whether a \[SensitiveDataFilter]\(/reference/observability/tracing/processors/sensitive-data-filter) is auto-applied to every configured instance. Defaults to \`true\`. Pass \`false\` to opt out, or pass a \`SensitiveDataFilterOptions\` object to customize fields, redaction token, or redaction style. If a config already includes a \`SensitiveDataFilter\` in \`spanOutputProcessors\`, it is not duplicated. Pre-instantiated instances are not modified.
+**sensitiveDataFilter** (`boolean | SensitiveDataFilterOptions`): Controls whether a SensitiveDataFilter is auto-applied to every configured instance. Defaults to true. Pass false to opt out, or pass a SensitiveDataFilterOptions object to customize fields, redaction token, or redaction style. If a config already includes a SensitiveDataFilter in spanOutputProcessors, it is not duplicated. Pre-instantiated instances are not modified.
 
 ## `ObservabilityInstanceConfig`
 
@@ -51,9 +51,9 @@ interface ObservabilityInstanceConfig {
 
 **includeInternalSpans** (`boolean`): Include spans internal to Mastra operations
 
-**excludeSpanTypes** (`SpanType[]`): Span types to exclude from export. Useful for reducing noise and costs in per-span billing platforms. See the \[Span filtering reference]\(/reference/observability/tracing/span-filtering) for details.
+**excludeSpanTypes** (`SpanType[]`): Span types to exclude from export. Useful for reducing noise and costs in per-span billing platforms. See the Span filtering reference for details.
 
-**spanFilter** (`(span: AnyExportedSpan) => boolean`): Filter function to control which spans are exported. Return true to keep, false to drop. Runs after excludeSpanTypes and spanOutputProcessors. See the \[Span filtering reference]\(/reference/observability/tracing/span-filtering) for details.
+**spanFilter** (`(span: AnyExportedSpan) => boolean`): Filter function to control which spans are exported. Return true to keep, false to drop. Runs after excludeSpanTypes and spanOutputProcessors. See the Span filtering reference for details.
 
 **requestContextKeys** (`string[]`): RequestContext keys to extract as metadata (supports dot notation)
 
@@ -67,7 +67,7 @@ interface ObservabilityInstanceConfig {
 
 **serializationOptions.maxObjectKeys** (`number`): Maximum number of keys in objects (default: 50)
 
-**logging** (`{ enabled?: boolean; level?: LogLevel }`): Controls log forwarding to observability storage. See \[Logging to observability storage]\(/docs/observability/logging#logging-to-observability-storage) for details.
+**logging** (`{ enabled?: boolean; level?: LogLevel }`): Controls log forwarding to observability storage. See Logging to observability storage for details.
 
 **logging.enabled** (`boolean`): Set to false to disable log forwarding to observability storage (default: true)
 

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

@@ -42,7 +42,7 @@ const processor = new LanguageDetector({
 
 **options.translationQuality** (`'speed' | 'quality' | 'balanced'`): Translation quality preference: 'speed' prioritizes fast translation, 'quality' prioritizes accuracy, 'balanced' balances between speed and quality
 
-**options.providerOptions** (`ProviderOptions`): Provider-specific options passed to the internal detection agent. Use this to control model behavior like reasoning effort for thinking models (e.g., \`{ openai: { reasoningEffort: 'low' } }\`)
+**options.providerOptions** (`ProviderOptions`): Provider-specific options passed to the internal detection agent. Use this to control model behavior like reasoning effort for thinking models (e.g., { openai: { reasoningEffort: 'low' } })
 
 ## Returns
 

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

@@ -38,7 +38,7 @@ const processor = new ModerationProcessor({
 
 **options.chunkWindow** (`number`): Number of previous chunks to include for context when moderating stream chunks. If set to 1, includes the previous part, etc.
 
-**options.providerOptions** (`ProviderOptions`): Provider-specific options passed to the internal moderation agent. Use this to control model behavior like reasoning effort for thinking models (e.g., \`{ openai: { reasoningEffort: 'low' } }\`)
+**options.providerOptions** (`ProviderOptions`): Provider-specific options passed to the internal moderation agent. Use this to control model behavior like reasoning effort for thinking models (e.g., { openai: { reasoningEffort: 'low' } })
 
 ## Returns
 

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

@@ -40,7 +40,7 @@ const processor = new PIIDetector({
 
 **options.preserveFormat** (`boolean`): Whether to preserve PII format during redaction. When true, maintains structure like \*\*\*-\*\*-1234 for phone numbers
 
-**options.providerOptions** (`ProviderOptions`): Provider-specific options passed to the internal detection agent. Use this to control model behavior like reasoning effort for thinking models (e.g., \`{ openai: { reasoningEffort: 'low' } }\`)
+**options.providerOptions** (`ProviderOptions`): Provider-specific options passed to the internal detection agent. Use this to control model behavior like reasoning effort for thinking models (e.g., { openai: { reasoningEffort: 'low' } })
 
 ## Returns
 

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

@@ -145,7 +145,7 @@ interface Processor<TId extends string = string, TTripwireMetadata = unknown> {
 
 **processorIndex** (`number`): Position of the processor in the combined processor list. Set at runtime by Mastra when processors are merged with memory, workspace, and per-call overrides. You do not set this yourself.
 
-**processDataParts** (`boolean`): When true, the processOutputStream method also receives \`data-\*\` chunks emitted by tools via writer.custom(). Defaults to false.
+**processDataParts** (`boolean`): When true, the processOutputStream method also receives data-\* chunks emitted by tools via writer.custom(). Defaults to false.
 
 **onViolation** (`(violation: ProcessorViolation) => void | Promise<void>`): Optional callback invoked when the processor detects a policy violation, regardless of strategy (block or warn). Use for side effects like alerting, logging to external systems, or emailing users. Errors thrown by this callback are silently caught to prevent interfering with processor logic. The violation object contains processorId, message, and a processor-specific detail field.
 
@@ -226,7 +226,7 @@ processInput?(args: ProcessInputArgs): Promise<ProcessInputResult> | ProcessInpu
 
 **messageList** (`MessageList`): Full MessageList instance for advanced message management.
 
-**abort** (`(reason?: string, options?: { retry?: boolean; metadata?: unknown }) => never`): Function to abort processing. Throws a TripWire error that stops execution. Pass \`retry: true\` to request the LLM retry the step with feedback.
+**abort** (`(reason?: string, options?: { retry?: boolean; metadata?: unknown }) => never`): Function to abort processing. Throws a TripWire error that stops execution. Pass retry: true to request the LLM retry the step with feedback.
 
 **retryCount** (`number`): Number of times processors have triggered retry for this generation. Use this to limit retry attempts. Always passed by Mastra; starts at 0.
 
@@ -301,9 +301,9 @@ processInputStep?<TTripwireMetadata = unknown>(
 
 **structuredOutput** (`StructuredOutputOptions`): Structured output configuration (schema, output mode). Return in result to modify.
 
-**abort** (`(reason?: string, options?: { retry?: boolean; metadata?: unknown }) => never`): Function to abort processing. Throws a TripWire error that stops execution. Pass \`retry: true\` to request the LLM retry the step with feedback.
+**abort** (`(reason?: string, options?: { retry?: boolean; metadata?: unknown }) => never`): Function to abort processing. Throws a TripWire error that stops execution. Pass retry: true to request the LLM retry the step with feedback.
 
-**retryCount** (`number`): Current retry attempt count from \`ProcessorContext\`. Starts at \`0\`; use to cap processor-triggered retries.
+**retryCount** (`number`): Current retry attempt count from ProcessorContext. Starts at 0; use to cap processor-triggered retries.
 
 **tracingContext** (`TracingContext`): Tracing context for observability.
 
@@ -391,15 +391,15 @@ processLLMRequest?(
 
 **state** (`Record<string, unknown>`): Per-processor state that persists across all method calls within this request.
 
-**abort** (`(reason?: string, options?: { retry?: boolean; metadata?: unknown }) => never`): Function to abort processing. Throws a TripWire error that stops execution and emits a \`tripwire\` chunk.
+**abort** (`(reason?: string, options?: { retry?: boolean; metadata?: unknown }) => never`): Function to abort processing. Throws a TripWire error that stops execution and emits a tripwire chunk.
 
-**retryCount** (`number`): Current retry attempt count from \`ProcessorContext\`. Starts at \`0\`; use to cap processor-triggered retries.
+**retryCount** (`number`): Current retry attempt count from ProcessorContext. Starts at 0; use to cap processor-triggered retries.
 
 **requestContext** (`RequestContext`): Request-scoped context with execution metadata.
 
 **tracingContext** (`TracingContext`): Tracing context for observability.
 
-**writer** (`ProcessorStreamWriter`): Stream writer for emitting custom data chunks during streaming. Use \`writer.custom()\` to send transient UI signals.
+**writer** (`ProcessorStreamWriter`): Stream writer for emitting custom data chunks during streaming. Use writer.custom() to send transient UI signals.
 
 **abortSignal** (`AbortSignal`): Signal for cancelling the operation.
 
@@ -432,7 +432,7 @@ processLLMResponse?(
 
 #### `ProcessLLMResponseArgs`
 
-**chunks** (`CachedLLMStepChunk[]`): Chunks produced by the LLM call (or replayed from cache) for this step, in stripped form (\`{ type, payload }\`).
+**chunks** (`CachedLLMStepChunk[]`): Chunks produced by the LLM call (or replayed from cache) for this step, in stripped form ({ type, payload }).
 
 **model** (`MastraLanguageModel`): The model that produced (or would have produced) the response.
 
@@ -440,9 +440,9 @@ processLLMResponse?(
 
 **steps** (`StepResult[]`): All completed steps so far, including this step.
 
-**state** (`Record<string, unknown>`): Per-processor state shared with \`processLLMRequest\` for the same step. Use this to pass data between the two hooks (e.g. a cache key).
+**state** (`Record<string, unknown>`): Per-processor state shared with processLLMRequest for the same step. Use this to pass data between the two hooks (e.g. a cache key).
 
-**fromCache** (`boolean`): When \`true\`, the response was replayed from a cache via \`processLLMRequest\` returning \`{ response }\`. Processors that write to a cache should skip writes when this is \`true\`.
+**fromCache** (`boolean`): When true, the response was replayed from a cache via processLLMRequest returning { response }. Processors that write to a cache should skip writes when this is true.
 
 **warnings** (`LanguageModelV2CallWarning[]`): Warnings reported by the language model call (e.g. unsupported settings).
 
@@ -452,7 +452,7 @@ processLLMResponse?(
 
 **abort** (`(reason?: string, options?: { retry?: boolean; metadata?: unknown }) => never`): Function to abort processing. Throws a TripWire error that stops execution.
 
-**retryCount** (`number`): Current retry attempt count. Starts at \`0\`; use to cap processor-triggered retries.
+**retryCount** (`number`): Current retry attempt count. Starts at 0; use to cap processor-triggered retries.
 
 **requestContext** (`RequestContext`): Request-scoped context with execution metadata.
 
@@ -504,7 +504,7 @@ processAPIError?(args: ProcessAPIErrorArgs): Promise<ProcessAPIErrorResult | voi
 
 **abort** (`(reason?: string, options?: { retry?: boolean; metadata?: unknown }) => never`): Function to abort processing.
 
-**writer** (`ProcessorStreamWriter`): Stream writer for emitting custom data chunks during streaming. Use \`writer.custom()\` to send transient UI signals.
+**writer** (`ProcessorStreamWriter`): Stream writer for emitting custom data chunks during streaming. Use writer.custom() to send transient UI signals.
 
 **requestContext** (`RequestContext`): Request context passed through from the agent call.
 
@@ -568,9 +568,9 @@ processOutputStream?(args: ProcessOutputStreamArgs): Promise<ChunkType | null |
 
 **state** (`Record<string, unknown>`): Mutable per-processor state that persists across every chunk and every method call within a single request. A fresh state object is created for each new generate or stream call.
 
-**abort** (`(reason?: string, options?: { retry?: boolean; metadata?: unknown }) => never`): Function to abort the stream. Throws a TripWire error that ends the stream and emits a \`tripwire\` chunk. Pass \`retry: true\` to request another LLM attempt instead of ending.
+**abort** (`(reason?: string, options?: { retry?: boolean; metadata?: unknown }) => never`): Function to abort the stream. Throws a TripWire error that ends the stream and emits a tripwire chunk. Pass retry: true to request another LLM attempt instead of ending.
 
-**retryCount** (`number`): Current retry attempt count from \`ProcessorContext\`. Starts at \`0\`; use to cap processor-triggered retries.
+**retryCount** (`number`): Current retry attempt count from ProcessorContext. Starts at 0; use to cap processor-triggered retries.
 
 **messageList** (`MessageList`): MessageList instance for accessing conversation history.
 
@@ -608,11 +608,11 @@ processOutputResult?(args: ProcessOutputResultArgs): ProcessorMessageResult;
 
 **state** (`Record<string, unknown>`): Per-processor state that persists across all method calls within this request. Shared with processOutputStream and other methods.
 
-**result** (`OutputResult`): Resolved generation result containing \`text\` (accumulated text), \`usage\` (token usage with inputTokens, outputTokens, totalTokens), \`finishReason\` (why generation ended), and \`steps\` (all LLM step results, each with toolCalls, toolResults, reasoning, sources, files, etc.).
+**result** (`OutputResult`): Resolved generation result containing text (accumulated text), usage (token usage with inputTokens, outputTokens, totalTokens), finishReason (why generation ended), and steps (all LLM step results, each with toolCalls, toolResults, reasoning, sources, files, etc.).
 
-**abort** (`(reason?: string, options?: { retry?: boolean; metadata?: unknown }) => never`): Function to abort processing. Throws a TripWire error that stops execution and emits a \`tripwire\` chunk.
+**abort** (`(reason?: string, options?: { retry?: boolean; metadata?: unknown }) => never`): Function to abort processing. Throws a TripWire error that stops execution and emits a tripwire chunk.
 
-**retryCount** (`number`): Current retry attempt count from \`ProcessorContext\`. Starts at \`0\`; use to cap processor-triggered retries.
+**retryCount** (`number`): Current retry attempt count from ProcessorContext. Starts at 0; use to cap processor-triggered retries.
 
 **tracingContext** (`TracingContext`): Tracing context for observability.
 
@@ -640,13 +640,13 @@ processOutputStep?(args: ProcessOutputStepArgs): ProcessorMessageResult;
 
 **finishReason** (`string`): The finish reason from the LLM (stop, tool-use, length, etc.).
 
-**providerMetadata** (`ProviderMetadata`): Provider-specific metadata for the finishing step (e.g. AWS Bedrock guardrail trace). Present when the model step produced provider metadata, including on content-filter blocks where \`steps\` is empty.
+**providerMetadata** (`ProviderMetadata`): Provider-specific metadata for the finishing step (e.g. AWS Bedrock guardrail trace). Present when the model step produced provider metadata, including on content-filter blocks where steps is empty.
 
 **toolCalls** (`ToolCallInfo[]`): Tool calls made in this step (if any).
 
 **text** (`string`): Generated text from this step.
 
-**usage** (`LanguageModelUsage`): Token usage for the current step (\`inputTokens\`, \`outputTokens\`, \`totalTokens\`).
+**usage** (`LanguageModelUsage`): Token usage for the current step (inputTokens, outputTokens, totalTokens).
 
 **systemMessages** (`CoreMessage[]`): All system messages for read/modify access.
 
@@ -654,7 +654,7 @@ processOutputStep?(args: ProcessOutputStepArgs): ProcessorMessageResult;
 
 **state** (`Record<string, unknown>`): Per-processor state that persists across all method calls within this request. Shared with processOutputStream and processOutputResult.
 
-**abort** (`(reason?: string, options?: { retry?: boolean; metadata?: unknown }) => never`): Function to abort processing. Pass \`retry: true\` to request the LLM retry the step.
+**abort** (`(reason?: string, options?: { retry?: boolean; metadata?: unknown }) => never`): Function to abort processing. Pass retry: true to request the LLM retry the step.
 
 **retryCount** (`number`): Number of times processors have triggered retry. Use this to limit retry attempts. Always passed by Mastra; starts at 0.
 

package/.docs/reference/processors/prompt-injection-detector.md

@@ -36,7 +36,7 @@ const processor = new PromptInjectionDetector({
 
 **options.lastMessageOnly** (`boolean`): Whether to inspect only the most recent message in the batch instead of checking every message. Use this to avoid extra LLM calls for earlier conversation history.
 
-**options.providerOptions** (`ProviderOptions`): Provider-specific options passed to the internal detection agent. Use this to control model behavior like reasoning effort for thinking models (e.g., \`{ openai: { reasoningEffort: 'low' } }\`)
+**options.providerOptions** (`ProviderOptions`): Provider-specific options passed to the internal detection agent. Use this to control model behavior like reasoning effort for thinking models (e.g., { openai: { reasoningEffort: 'low' } })
 
 ## Returns
 

package/.docs/reference/processors/response-cache.md

@@ -41,17 +41,17 @@ See [Response caching](https://mastra.ai/docs/agents/processors) for the concept
 
 ## Constructor parameters
 
-**cache** (`MastraServerCache`): The cache backend. Required. Pass any \`MastraServerCache\` implementation — \`InMemoryServerCache\` for local development, \`RedisCache\` from \`@mastra/redis\` for production, or your own subclass for a custom backend.
+**cache** (`MastraServerCache`): The cache backend. Required. Pass any MastraServerCache implementation — InMemoryServerCache for local development, RedisCache from @mastra/redis for production, or your own subclass for a custom backend.
 
 **ttl** (`number`): Time-to-live (seconds) for entries written by this processor. Defaults to 300 seconds (5 minutes), matching OpenRouter's reference implementation. (Default: `300`)
 
-**scope** (`string | null`): Tenant scope appended to the cache key. \`null\` opts out of scoping. When omitted, the processor falls back to the resource id resolved from the request context (\`MASTRA\_RESOURCE\_ID\_KEY\`) for automatic per-user isolation.
+**scope** (`string | null`): Tenant scope appended to the cache key. null opts out of scoping. When omitted, the processor falls back to the resource id resolved from the request context (MASTRA\_RESOURCE\_ID\_KEY) for automatic per-user isolation.
 
-**key** (`string | (inputs: ResponseCacheKeyInputs) => string | Promise<string>`): Override the auto-derived cache key. Pass a string to pin a key, or a function that receives \`{ agentId, scope, model, prompt, stepNumber }\` and returns a key. If the function throws, the processor falls back to the deterministic hash so the call still benefits from caching.
+**key** (`string | (inputs: ResponseCacheKeyInputs) => string | Promise<string>`): Override the auto-derived cache key. Pass a string to pin a key, or a function that receives { agentId, scope, model, prompt, stepNumber } and returns a key. If the function throws, the processor falls back to the deterministic hash so the call still benefits from caching.
 
 **bust** (`boolean`): Force a cache miss on every call: skip the read but still write on completion. Useful for explicit refresh paths. (Default: `false`)
 
-**agentId** (`string`): Logical id used in the cache key namespace. Defaults to \`'mastra-response-cache'\`. Set this to the owning agent's id when you want cache entries scoped per-agent. (Default: `'mastra-response-cache'`)
+**agentId** (`string`): Logical id used in the cache key namespace. Defaults to 'mastra-response-cache'. Set this to the owning agent's id when you want cache entries scoped per-agent. (Default: `'mastra-response-cache'`)
 
 ## Static helpers
 
@@ -84,7 +84,7 @@ The shape passed to `ResponseCache.context()` / `ResponseCache.applyContext()`.
 
 **key** (`string | (inputs: ResponseCacheKeyInputs) => string | Promise<string>`): Overrides the auto-derived cache key for this request only.
 
-**scope** (`string | null`): Overrides the tenant scope for this request only. \`null\` opts out of scoping.
+**scope** (`string | null`): Overrides the tenant scope for this request only. null opts out of scoping.
 
 **bust** (`boolean`): Skip the cache read but still write on completion.
 
@@ -96,7 +96,7 @@ The argument passed to a `key` function (constructor or per-call). All fields co
 
 **agentId** (`string`): Logical processor id used to namespace the cache key.
 
-**scope** (`string | null | undefined`): Resolved scope for this request, or \`null\` when scoping is disabled.
+**scope** (`string | null | undefined`): Resolved scope for this request, or null when scoping is disabled.
 
 **model** (`{ provider?: string; modelId?: string; specVersion?: string }`): Provider/model identity. Different models produce different responses.
 

package/.docs/reference/processors/unicode-normalizer.md

@@ -19,7 +19,7 @@ const processor = new UnicodeNormalizer({
 
 **options** (`Options`): Configuration options for Unicode text normalization
 
-**options.stripControlChars** (`boolean`): Whether to strip control characters. When enabled, removes control characters except \` \`, \` \`, \` \`
+**options.stripControlChars** (`boolean`): Whether to strip control characters. When enabled, removes control characters except , ,
 
 **options.preserveEmojis** (`boolean`): Whether to preserve emojis. When disabled, emojis may be removed if they contain control characters
 

package/.docs/reference/pubsub/base.md

@@ -137,9 +137,9 @@ await pubsub.subscribeFromOffset('my-topic', 42, event => {
 
 ## Properties
 
-**supportedModes** (`ReadonlyArray<"pull" | "push">`): Delivery modes the implementation supports. Defaults to \`\["pull"]\`.
+**supportedModes** (`ReadonlyArray<"pull" | "push">`): Delivery modes the implementation supports. Defaults to \["pull"].
 
-**supportsNativeBatching** (`boolean`): Whether the implementation honors \`options.batch\` on \`subscribe()\`. Defaults to \`false\`. Backends that integrate batching internally override this and return \`true\`.
+**supportsNativeBatching** (`boolean`): Whether the implementation honors options.batch on subscribe(). Defaults to false. Backends that integrate batching internally override this and return true.
 
 ## Types
 
@@ -163,7 +163,7 @@ await pubsub.subscribeFromOffset('my-topic', 42, event => {
 
 **group** (`string`): When set, subscribers with the same group compete for messages and each event is delivered to one member. When omitted, every subscriber receives every event.
 
-**batch** (`SubscribeBatchOptions`): Opt in to batched delivery for this subscription. When omitted, events are delivered one at a time. Honored only by backends where \`supportsNativeBatching\` is \`true\`.
+**batch** (`SubscribeBatchOptions`): Opt in to batched delivery for this subscription. When omitted, events are delivered one at a time. Honored only by backends where supportsNativeBatching is true.
 
 ### `SubscribeBatchOptions`
 
@@ -173,15 +173,15 @@ Per-subscription batching policy. The callback signature doesn't change; a batch
 
 **maxWaitMs** (`number`): Maximum time in milliseconds the oldest event may sit in the buffer. The timer starts when the buffer transitions from empty to non-empty.
 
-**minIntervalMs** (`number`): Minimum time in milliseconds between consecutive batch deliveries. Even when \`maxSize\` or \`maxWaitMs\` would fire, the buffer holds until this interval has elapsed since the last delivery.
+**minIntervalMs** (`number`): Minimum time in milliseconds between consecutive batch deliveries. Even when maxSize or maxWaitMs would fire, the buffer holds until this interval has elapsed since the last delivery.
 
-**isImmediate** (`(event: Event) => boolean`): When it returns \`true\` for an event, the buffer flushes immediately on publish, subject to \`minIntervalMs\`. A per-event escape hatch.
+**isImmediate** (`(event: Event) => boolean`): When it returns true for an event, the buffer flushes immediately on publish, subject to minIntervalMs. A per-event escape hatch.
 
-**coalesce** (`(events: Event[]) => Event[]`): Applied to the queued batch before delivery to drop superseded events. Must return a subset of its input by reference identity; returning freshly constructed \`Event\` objects is a contract violation and discards the whole batch. Ordering of kept events is preserved.
+**coalesce** (`(events: Event[]) => Event[]`): Applied to the queued batch before delivery to drop superseded events. Must return a subset of its input by reference identity; returning freshly constructed Event objects is a contract violation and discards the whole batch. Ordering of kept events is preserved.
 
 **maxBufferSize** (`number`): Maximum events the buffer may hold before overflow handling kicks in. Events flagged immediate are never dropped on overflow. (Default: `256`)
 
-**overflow** (`"drop-oldest" | "drop-newest" | "coalesce-or-drop-oldest"`): Overflow strategy when the buffer exceeds \`maxBufferSize\`. \`coalesce-or-drop-oldest\` runs \`coalesce\` first, then drops oldest if still over budget. (Default: `coalesce-or-drop-oldest`)
+**overflow** (`"drop-oldest" | "drop-newest" | "coalesce-or-drop-oldest"`): Overflow strategy when the buffer exceeds maxBufferSize. coalesce-or-drop-oldest runs coalesce first, then drops oldest if still over budget. (Default: `coalesce-or-drop-oldest`)
 
 ### `EventCallback`
 

package/.docs/reference/pubsub/caching-pubsub.md

@@ -44,7 +44,7 @@ const pubsub = withCaching(new EventEmitterPubSub(), new InMemoryServerCache())
 
 ## Properties
 
-**supportsNativeBatching** (`boolean`): Mirrors the inner pub/sub. Returns \`true\` only when the wrapped implementation supports batching.
+**supportsNativeBatching** (`boolean`): Mirrors the inner pub/sub. Returns true only when the wrapped implementation supports batching.
 
 ## Methods
 

package/.docs/reference/pubsub/event-emitter.md

@@ -47,9 +47,9 @@ const pubsub = new EventEmitterPubSub(undefined, { logger })
 
 ## Properties
 
-**supportedModes** (`ReadonlyArray<"pull" | "push">`): Returns \`\["pull", "push"]\`. The emitter can serve a pull-style worker or push events directly to listeners.
+**supportedModes** (`ReadonlyArray<"pull" | "push">`): Returns \["pull", "push"]. The emitter can serve a pull-style worker or push events directly to listeners.
 
-**supportsNativeBatching** (`boolean`): Returns \`true\`. Subscribers can opt in to batched delivery with \`options.batch\`.
+**supportsNativeBatching** (`boolean`): Returns true. Subscribers can opt in to batched delivery with options.batch.
 
 ## Methods
 

package/.docs/reference/pubsub/google-cloud-pubsub.md

@@ -51,7 +51,7 @@ export const mastra = new Mastra({
 
 ## Constructor parameters
 
-**config** (`ClientConfig`): Configuration for the Google Cloud Pub/Sub client, including credentials and project ID. See the \`@google-cloud/pubsub\` client documentation for all fields.
+**config** (`ClientConfig`): Configuration for the Google Cloud Pub/Sub client, including credentials and project ID. See the @google-cloud/pubsub client documentation for all fields.
 
 ## Methods
 

package/.docs/reference/pubsub/lease-provider.md

@@ -2,7 +2,7 @@
 
 # LeaseProvider
 
-`LeaseProvider` is the distributed leasing contract, separate from event delivery ([`PubSub`](https://mastra.ai/reference/pubsub/base)). Mastra's [signals layer](https://mastra.ai/docs/agents/signals) uses it to elect a single owner across multiple processes (for example, serverless invocations) for a given resource, most commonly a thread key. The owner is the process that wakes and runs the agent stream, so other processes route follow-up work to it instead of starting a competing run.
+`LeaseProvider` is the distributed leasing contract, separate from event delivery ([`PubSub`](https://mastra.ai/reference/pubsub/base)). Mastra's [signals layer](https://mastra.ai/docs/long-running-agents/signals) uses it to elect a single owner across multiple processes (for example, serverless invocations) for a given resource, most commonly a thread key. The owner is the process that wakes and runs the agent stream, so other processes route follow-up work to it instead of starting a competing run.
 
 Leasing is a distinct concern from pub/sub. A backend implements `LeaseProvider` only when it can genuinely coordinate a lock, such as Redis via atomic `SET`/Lua, or an in-memory map for single-process. Backends that cannot lease omit it; the signals runtime feature-detects the capability and falls back to a no-op provider, preserving single-process behavior.
 
@@ -62,7 +62,7 @@ Returns: `Promise<{ acquired: boolean; owner?: string }>`
 
 **key** (`string`): The lease key, such as a thread key.
 
-**owner** (`string`): Identifier for the owner, such as a \`runId\`. The same owner can call \`acquireLease\` idempotently to renew or release.
+**owner** (`string`): Identifier for the owner, such as a runId. The same owner can call acquireLease idempotently to renew or release.
 
 **ttlMs** (`number`): Time-to-live in milliseconds for the lease.
 
@@ -129,5 +129,5 @@ When the configured pub/sub backend does not implement `LeaseProvider`, the runt
 
 - [PubSub](https://mastra.ai/reference/pubsub/base): The event delivery contract, separate from leasing
 - [RedisStreamsPubSub](https://mastra.ai/reference/pubsub/redis-streams): The built-in backend that implements `LeaseProvider`
-- [Signals](https://mastra.ai/docs/agents/signals): The runtime that uses leasing to coordinate thread runs across processes
+- [Signals](https://mastra.ai/docs/long-running-agents/signals): The runtime that uses leasing to coordinate thread runs across processes
 - [Channels](https://mastra.ai/docs/agents/channels): Uses leasing to coordinate agent runs in serverless and multi-instance deployments

package/.docs/reference/pubsub/redis-streams.md

@@ -53,13 +53,13 @@ export const mastra = new Mastra({
 
 ## Constructor parameters
 
-**url** (`string`): Redis connection URL. Falls back to \`redisOptions.url\`. (Default: `redis://localhost:6379`)
+**url** (`string`): Redis connection URL. Falls back to redisOptions.url. (Default: `redis://localhost:6379`)
 
-**keyPrefix** (`string`): Prefix for stream keys. Each topic maps to \`\<keyPrefix>:\<topic>\`. (Default: `mastra:topic`)
+**keyPrefix** (`string`): Prefix for stream keys. Each topic maps to \<keyPrefix>:\<topic>. (Default: `mastra:topic`)
 
 **blockMs** (`number`): How long, in milliseconds, each read blocks while waiting for new events. (Default: `1000`)
 
-**redisOptions** (`RedisClientOptions`): Options passed to the underlying \`redis\` client for advanced configuration.
+**redisOptions** (`RedisClientOptions`): Options passed to the underlying redis client for advanced configuration.
 
 **maxStreamLength** (`number`): Approximate maximum number of entries kept per stream. Set to 0 to disable trimming. (Default: `10000`)
 
@@ -67,13 +67,13 @@ export const mastra = new Mastra({
 
 **reclaimIdleMs** (`number`): Minimum idle time, in milliseconds, before a pending event is eligible for reclaim. Keep this well above typical processing time to avoid double delivery. (Default: `60000`)
 
-**maxDeliveryAttempts** (`number`): Maximum times an event is redelivered through \`nack\` before it is dropped. Pass \`Infinity\` to disable the cap. (Default: `5`)
+**maxDeliveryAttempts** (`number`): Maximum times an event is redelivered through nack before it is dropped. Pass Infinity to disable the cap. (Default: `5`)
 
 **logger** (`{ debug?: Function; warn?: Function }`): Optional logger for diagnostics. When omitted, suppressed errors are silent.
 
 ## Properties
 
-**supportedModes** (`ReadonlyArray<"pull" | "push">`): Returns \`\["pull"]\`.
+**supportedModes** (`ReadonlyArray<"pull" | "push">`): Returns \["pull"].
 
 ## Methods
 
@@ -111,7 +111,7 @@ When a subscriber calls `nack`, the event is republished with an incremented `de
 
 ## Distributed leasing
 
-`RedisStreamsPubSub` implements the [`LeaseProvider`](https://mastra.ai/reference/pubsub/lease-provider) contract on top of the same Redis connection. The [signals runtime](https://mastra.ai/docs/agents/signals) uses it to elect a single owner (usually per thread key) so that across instances only one process wakes and runs the agent, and others route follow-up work to the holder. This is what makes signals work on serverless and multi-instance deployments; without a shared lease, each instance would start its own competing run.
+`RedisStreamsPubSub` implements the [`LeaseProvider`](https://mastra.ai/reference/pubsub/lease-provider) contract on top of the same Redis connection. The [signals runtime](https://mastra.ai/docs/long-running-agents/signals) uses it to elect a single owner (usually per thread key) so that across instances only one process wakes and runs the agent, and others route follow-up work to the holder. This is what makes signals work on serverless and multi-instance deployments; without a shared lease, each instance would start its own competing run.
 
 Lease keys are namespaced under the same `keyPrefix` as topics, as `<keyPrefix>:lease:<key>`. All operations are atomic: `acquireLease` uses `SET NX PX` and refreshes its own TTL idempotently, while `releaseLease`, `renewLease`, and `transferLease` use Lua scripts that check ownership before mutating, so a concurrent renewal from another owner is never clobbered.
 

package/.docs/reference/pubsub/unix-socket-pubsub.md

@@ -31,7 +31,7 @@ export const mastra = new Mastra({
 
 **socketPath** (`string`): The socket path passed to the constructor.
 
-**supportedModes** (`ReadonlyArray<"pull" | "push">`): Returns \`\["push"]\`.
+**supportedModes** (`ReadonlyArray<"pull" | "push">`): Returns \["push"].
 
 **isBroker** (`boolean`): Whether this instance currently acts as the broker.
 

package/.docs/reference/rag/chunk.md

@@ -178,9 +178,9 @@ The options documented below are passed directly at the top level of the configu
 
 **joinThreshold** (`number`): Maximum token count for merging related sections. Sections exceeding this limit individually are left intact, but smaller sections are merged with siblings or parents if the combined size stays under this threshold. (Default: `500`)
 
-**modelName** (`string`): Name of the model for tokenization. If provided, the model's underlying tokenization \`encodingName\` will be used.
+**modelName** (`string`): Name of the model for tokenization. If provided, the model's underlying tokenization encodingName will be used.
 
-**encodingName** (`string`): Name of the token encoding to use. Derived from \`modelName\` if available. (Default: `cl100k_base`)
+**encodingName** (`string`): Name of the token encoding to use. Derived from modelName if available. (Default: `cl100k_base`)
 
 **allowedSpecial** (`Set<string> | 'all'`): Set of special tokens allowed during tokenization, or 'all' to allow all special tokens
 

package/.docs/reference/server/create-route.md

@@ -22,9 +22,9 @@ function createRoute<TPath, TQuery, TBody, TResponse, TResponseType>(
 
 **method** (`'GET' | 'POST' | 'PUT' | 'DELETE' | 'PATCH' | 'ALL'`): HTTP method
 
-**path** (`string`): Route path with optional params (e.g., \`/api/items/:id\`)
+**path** (`string`): Route path with optional params (e.g., /api/items/:id)
 
-**responseType** (`'json' | 'stream'`): Response format. Internal routes may use additional types (\`datastream-response\`, \`mcp-http\`, \`mcp-sse\`).
+**responseType** (`'json' | 'stream'`): Response format. Internal routes may use additional types (datastream-response, mcp-http, mcp-sse).
 
 **handler** (`ServerRouteHandler`): Route handler function
 
@@ -48,7 +48,7 @@ function createRoute<TPath, TQuery, TBody, TResponse, TResponseType>(
 
 **deprecated** (`boolean`): Mark route as deprecated
 
-**onValidationError** (`(error: ZodError, context: 'query' | 'body' | 'path') => { status: number; body: unknown } | undefined`): Custom validation error handler for this route. Overrides the server-level \`onValidationError\` hook. Return \`{ status, body }\` to customize the response, or \`undefined\` to use the default.
+**onValidationError** (`(error: ZodError, context: 'query' | 'body' | 'path') => { status: number; body: unknown } | undefined`): Custom validation error handler for this route. Overrides the server-level onValidationError hook. Return { status, body } to customize the response, or undefined to use the default.
 
 ## Handler parameters
 

package/.docs/reference/server/express-adapter.md

@@ -60,21 +60,21 @@ app.listen(4111, () => {
 
 **mastra** (`Mastra`): Mastra instance
 
-**prefix** (`string`): Route path prefix (e.g., \`/api/v2\`) (Default: `''`)
+**prefix** (`string`): Route path prefix (e.g., /api/v2) (Default: `''`)
 
-**openapiPath** (`string`): Path to serve OpenAPI spec (e.g., \`/openapi.json\`) (Default: `''`)
+**openapiPath** (`string`): Path to serve OpenAPI spec (e.g., /openapi.json) (Default: `''`)
 
 **bodyLimitOptions** (`{ maxSize: number, onError: (err) => unknown }`): Request body size limits
 
 **streamOptions** (`{ redact?: boolean }`): Stream redaction config. When true, redacts sensitive data from streams. (Default: `{ redact: true }`)
 
-**customRouteAuthConfig** (`Map<string, boolean>`): Per-route auth overrides. Keys are \`METHOD:PATH\` (e.g., \`GET:/api/health\`). Value \`false\` makes route public, \`true\` requires auth.
+**customRouteAuthConfig** (`Map<string, boolean>`): Per-route auth overrides. Keys are METHOD:PATH (e.g., GET:/api/health). Value false makes route public, true requires auth.
 
 **tools** (`Record<string, Tool>`): Available tools for the server
 
 **taskStore** (`InMemoryTaskStore`): Task store for A2A (Agent-to-Agent) operations
 
-**mcpOptions** (`MCPOptions`): MCP transport options. Set \`serverless: true\` for stateless environments like Cloudflare Workers or Vercel Edge.
+**mcpOptions** (`MCPOptions`): MCP transport options. Set serverless: true for stateless environments like Cloudflare Workers or Vercel Edge.
 
 ## Differences from Hono
 

package/.docs/reference/server/fastify-adapter.md

@@ -61,21 +61,21 @@ app.listen({ port: 3000 }, (err, address) => {
 
 **mastra** (`Mastra`): Mastra instance
 
-**prefix** (`string`): Route path prefix (e.g., \`/api/v2\`) (Default: `''`)
+**prefix** (`string`): Route path prefix (e.g., /api/v2) (Default: `''`)
 
-**openapiPath** (`string`): Path to serve OpenAPI spec (e.g., \`/openapi.json\`) (Default: `''`)
+**openapiPath** (`string`): Path to serve OpenAPI spec (e.g., /openapi.json) (Default: `''`)
 
 **bodyLimitOptions** (`BodyLimitOptions`): Request body size limits
 
 **streamOptions** (`StreamOptions`): Stream redaction config. When true (default), redacts sensitive data (system prompts, tool definitions, API keys) from stream chunks before sending to clients. (Default: `{ redact: true }`)
 
-**customRouteAuthConfig** (`Map<string, boolean>`): Per-route auth overrides. Keys are \`METHOD:PATH\` (e.g., \`GET:/api/health\`). Value \`false\` makes route public, \`true\` requires auth.
+**customRouteAuthConfig** (`Map<string, boolean>`): Per-route auth overrides. Keys are METHOD:PATH (e.g., GET:/api/health). Value false makes route public, true requires auth.
 
 **tools** (`ToolsInput`): Available tools for the server
 
 **taskStore** (`InMemoryTaskStore`): Task store for A2A (Agent-to-Agent) operations
 
-**mcpOptions** (`MCPOptions`): MCP transport options. Set \`serverless: true\` for stateless environments like Cloudflare Workers or Vercel Edge.
+**mcpOptions** (`MCPOptions`): MCP transport options. Set serverless: true for stateless environments like Cloudflare Workers or Vercel Edge.
 
 ## Protecting raw routes
 

package/.docs/reference/server/hono-adapter.md

@@ -55,21 +55,21 @@ export default app
 
 **mastra** (`Mastra`): Mastra instance
 
-**prefix** (`string`): Route path prefix (e.g., \`/api/v2\`) (Default: `''`)
+**prefix** (`string`): Route path prefix (e.g., /api/v2) (Default: `''`)
 
-**openapiPath** (`string`): Path to serve OpenAPI spec (e.g., \`/openapi.json\`) (Default: `''`)
+**openapiPath** (`string`): Path to serve OpenAPI spec (e.g., /openapi.json) (Default: `''`)
 
 **bodyLimitOptions** (`{ maxSize: number, onError: (err) => unknown }`): Request body size limits
 
 **streamOptions** (`{ redact?: boolean }`): Stream redaction config. When true, redacts sensitive data from streams. (Default: `{ redact: true }`)
 
-**customRouteAuthConfig** (`Map<string, boolean>`): Per-route auth overrides. Keys are \`METHOD:PATH\` (e.g., \`GET:/api/health\`). Value \`false\` makes route public, \`true\` requires auth.
+**customRouteAuthConfig** (`Map<string, boolean>`): Per-route auth overrides. Keys are METHOD:PATH (e.g., GET:/api/health). Value false makes route public, true requires auth.
 
 **tools** (`Record<string, Tool>`): Available tools for the server
 
 **taskStore** (`InMemoryTaskStore`): Task store for A2A (Agent-to-Agent) operations
 
-**mcpOptions** (`MCPOptions`): MCP transport options. Set \`serverless: true\` for stateless environments like Cloudflare Workers or Vercel Edge.
+**mcpOptions** (`MCPOptions`): MCP transport options. Set serverless: true for stateless environments like Cloudflare Workers or Vercel Edge.
 
 ## Adding custom routes
 

package/.docs/reference/server/koa-adapter.md

@@ -60,21 +60,21 @@ app.listen(3000, () => {
 
 **mastra** (`Mastra`): Mastra instance
 
-**prefix** (`string`): Route path prefix (e.g., \`/api/v2\`) (Default: `''`)
+**prefix** (`string`): Route path prefix (e.g., /api/v2) (Default: `''`)
 
-**openapiPath** (`string`): Path to serve OpenAPI spec (e.g., \`/openapi.json\`) (Default: `''`)
+**openapiPath** (`string`): Path to serve OpenAPI spec (e.g., /openapi.json) (Default: `''`)
 
 **bodyLimitOptions** (`BodyLimitOptions`): Request body size limits
 
 **streamOptions** (`StreamOptions`): Stream redaction config. When true (default), redacts sensitive data (system prompts, tool definitions, API keys) from stream chunks before sending to clients. (Default: `{ redact: true }`)
 
-**customRouteAuthConfig** (`Map<string, boolean>`): Per-route auth overrides. Keys are \`METHOD:PATH\` (e.g., \`GET:/api/health\`). Value \`false\` makes route public, \`true\` requires auth.
+**customRouteAuthConfig** (`Map<string, boolean>`): Per-route auth overrides. Keys are METHOD:PATH (e.g., GET:/api/health). Value false makes route public, true requires auth.
 
 **tools** (`ToolsInput`): Available tools for the server
 
 **taskStore** (`InMemoryTaskStore`): Task store for A2A (Agent-to-Agent) operations
 
-**mcpOptions** (`MCPOptions`): MCP transport options. Set \`serverless: true\` for stateless environments like Cloudflare Workers or Vercel Edge.
+**mcpOptions** (`MCPOptions`): MCP transport options. Set serverless: true for stateless environments like Cloudflare Workers or Vercel Edge.
 
 ## Error handling
 

package/.docs/reference/server/mastra-server.md

@@ -34,7 +34,7 @@ constructor(options: MastraServerOptions<TApp>)
 
 **mastra** (`Mastra`): Mastra instance
 
-**prefix** (`string`): Route path prefix (e.g., \`/api/v2\`) (Default: `''`)
+**prefix** (`string`): Route path prefix (e.g., /api/v2) (Default: `''`)
 
 **openapiPath** (`string`): Path to serve OpenAPI spec (Default: `''`)
 

package/.docs/reference/server/nestjs-adapter.md

@@ -73,7 +73,7 @@ By default, Mastra routes mount under `/api`. Use `prefix` to change it.
 
 **mastra** (`Mastra`): Mastra instance
 
-**prefix** (`string`): Route path prefix (e.g., \`/api/v2\`) (Default: `` `/api` ``)
+**prefix** (`string`): Route path prefix (e.g., /api/v2) (Default: `` `/api` ``)
 
 **rateLimitOptions** (`{ enabled?: boolean; defaultLimit?: number; windowMs?: number; generateLimit?: number }`): Rate limiting config (enabled by default)
 
@@ -87,7 +87,7 @@ By default, Mastra routes mount under `/api`. Use `prefix` to change it.
 
 **contextOptions** (`{ strict?: boolean; logWarnings?: boolean }`): Request context parsing config
 
-**customRouteAuthConfig** (`Map<string, boolean>`): Per-route auth overrides. Keys are \`METHOD:PATH\`.
+**customRouteAuthConfig** (`Map<string, boolean>`): Per-route auth overrides. Keys are METHOD:PATH.
 
 **tools** (`Record<string, Tool>`): Registered tools for the server
 
@@ -95,7 +95,7 @@ By default, Mastra routes mount under `/api`. Use `prefix` to change it.
 
 **mcpOptions** (`{ serverless?: boolean; sessionIdGenerator?: () => string }`): MCP transport options
 
-**auth** (`{ enabled?: boolean; allowQueryApiKey?: boolean }`): Enable Mastra token auth. Disabled by default — most NestJS apps use their own auth guards. Query-string \`apiKey\` auth is opt-in for backward compatibility. (Default: `` `{ enabled: false }` ``)
+**auth** (`{ enabled?: boolean; allowQueryApiKey?: boolean }`): Enable Mastra token auth. Disabled by default — most NestJS apps use their own auth guards. Query-string apiKey auth is opt-in for backward compatibility. (Default: `` `{ enabled: false }` ``)
 
 ## Async registration