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

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
 

package/.docs/reference/server/register-api-route.md

@@ -26,13 +26,13 @@ registerApiRoute("/items/:itemId", { ... })
 
 **method** (`'GET' | 'POST' | 'PUT' | 'DELETE' | 'PATCH' | 'ALL'`): HTTP method for the route
 
-**handler** (`Handler`): Route handler function receiving Hono Context. Use either \`handler\` or \`createHandler\`, not both.
+**handler** (`Handler`): Route handler function receiving Hono Context. Use either handler or createHandler, not both.
 
-**createHandler** (`(c: Context) => Promise<Handler>`): Async factory function to create the handler. Use either \`handler\` or \`createHandler\`, not both.
+**createHandler** (`(c: Context) => Promise<Handler>`): Async factory function to create the handler. Use either handler or createHandler, not both.
 
 **middleware** (`MiddlewareHandler | MiddlewareHandler[]`): Route-specific middleware functions
 
-**cors** (`CorsOptions`): Route-specific CORS configuration. Use this when one custom route needs a different cross-origin policy from \`server.cors\`.
+**cors** (`CorsOptions`): Route-specific CORS configuration. Use this when one custom route needs a different cross-origin policy from server.cors.
 
 **openapi** (`DescribeRouteOptions`): OpenAPI metadata for Swagger UI documentation
 

package/.docs/reference/signals/create-notification-inbox-tool.md

@@ -33,7 +33,7 @@ export const supportAgent = new Agent({
 
 **options** (`object`): Tool configuration.
 
-**options.storage** (`NotificationsStorage`): Notification storage domain returned by \`storage.getStore('notifications')\`.
+**options.storage** (`NotificationsStorage`): Notification storage domain returned by storage.getStore('notifications').
 
 ## Tool input
 
@@ -43,7 +43,7 @@ The generated tool has the id `notification-inbox` and accepts these input field
 
 **threadId** (`string`): Thread ID to inspect. Defaults to the current agent thread when available.
 
-**id** (`string`): Notification ID. Required for \`markSeen\`, \`dismiss\`, and \`archive\`. Optional for \`read\`.
+**id** (`string`): Notification ID. Required for markSeen, dismiss, and archive. Optional for read.
 
 **status** (`'pending' | 'delivered' | 'seen' | 'dismissed' | 'archived' | 'discarded'`): Status filter for list, read, or search actions.
 
@@ -51,7 +51,7 @@ The generated tool has the id `notification-inbox` and accepts these input field
 
 **source** (`string`): Source filter for list, read, or search actions.
 
-**query** (`string`): Search query. Required when \`action\` is \`search\`.
+**query** (`string`): Search query. Required when action is search.
 
 **limit** (`number`): Maximum number of notifications to return. Must be a positive integer.
 

package/.docs/reference/signals/signal-provider.md

@@ -63,9 +63,9 @@ The agent calls `connect(this)`, registers any processors or tools the provider
 
 **name** (`string`): Human-readable display name for the provider.
 
-**pollInterval** (`number`): Poll interval in milliseconds. When set, the framework calls \`poll()\` on this interval. Leave \`undefined\` or \`0\` for webhook-only providers.
+**pollInterval** (`number`): Poll interval in milliseconds. When set, the framework calls poll() on this interval. Leave undefined or 0 for webhook-only providers.
 
-**isConnected** (`boolean`): Whether this provider is connected to an agent. Returns \`true\` after \`connect()\` is called. Used internally to skip re-wiring during \`Agent.\_\_fork()\`.
+**isConnected** (`boolean`): Whether this provider is connected to an agent. Returns true after connect() is called. Used internally to skip re-wiring during Agent.\_\_fork().
 
 ## Methods
 
@@ -154,9 +154,9 @@ const sub = this.subscribe(
 
 Returns: `SignalSubscription` — the created subscription, or the existing one with merged metadata.
 
-**target** (`SignalProviderTarget`): The thread to subscribe. Must include \`threadId\` and \`resourceId\`.
+**target** (`SignalProviderTarget`): The thread to subscribe. Must include threadId and resourceId.
 
-**externalResourceId** (`string`): Provider-specific identifier for the external resource (for example, \`"github:owner/repo#123"\`).
+**externalResourceId** (`string`): Provider-specific identifier for the external resource (for example, "github:owner/repo#123").
 
 **metadata** (`Record<string, unknown>`): Additional data to store with the subscription. Merged into existing metadata on duplicate subscribes.
 
@@ -352,7 +352,7 @@ await this.notify(
 
 **notification.source** (`string`): Identifier for the notification source.
 
-**notification.kind** (`string`): Type of event (for example, \`"pr-updated"\`, \`"new-message"\`).
+**notification.kind** (`string`): Type of event (for example, "pr-updated", "new-message").
 
 **notification.summary** (`string`): Human-readable summary of the event.
 
@@ -360,7 +360,7 @@ await this.notify(
 
 **notification.payload** (`unknown`): Arbitrary data attached to the notification.
 
-**target** (`SignalProviderTarget`): The thread to notify. Must include \`threadId\` and \`resourceId\`.
+**target** (`SignalProviderTarget`): The thread to notify. Must include threadId and resourceId.
 
 ## Types
 
@@ -376,7 +376,7 @@ The subscription object returned by `subscribe()`.
 
 **resourceId** (`string`): The resource owning the thread.
 
-**externalResourceId** (`string`): Provider-specific identifier for the external resource (for example, \`"github:owner/repo#123"\`).
+**externalResourceId** (`string`): Provider-specific identifier for the external resource (for example, "github:owner/repo#123").
 
 **subscribedAt** (`Date`): When the subscription was created.
 

package/.docs/reference/signals/webhook-signal-provider.md

@@ -53,7 +53,7 @@ const result = await webhookProvider.handleWebhook({
 
 **name** (`string`): Human-readable name. (Default: `'Webhook Signals'`)
 
-**extractResourceId** (`(payload: unknown) => string | string[] | undefined`): Extract the external resource ID from a webhook payload. Return \`undefined\` to skip the event. Can return an array to match multiple resources. (Default: ``Returns `payload.resource` or `payload.externalResourceId` if present``)
+**extractResourceId** (`(payload: unknown) => string | string[] | undefined`): Extract the external resource ID from a webhook payload. Return undefined to skip the event. Can return an array to match multiple resources. (Default: ``Returns `payload.resource` or `payload.externalResourceId` if present``)
 
 **buildNotification** (`(payload: unknown, subscription: SignalSubscription) => SendNotificationSignalInput`): Build the notification object from a webhook payload and the matched subscription. (Default: `` Returns `{ source: id, kind: 'webhook-event', summary, payload }` ``)
 
@@ -75,7 +75,7 @@ webhookProvider.subscribeThread(
 
 Returns: `SignalSubscription`
 
-**target** (`SignalProviderTarget`): The thread to subscribe. Must include \`threadId\` and \`resourceId\`.
+**target** (`SignalProviderTarget`): The thread to subscribe. Must include threadId and resourceId.
 
 **externalResourceId** (`string`): The external resource to monitor (for example, a repository full name).
 

package/.docs/reference/storage/clickhouse.md

@@ -174,19 +174,19 @@ The same `client` form is accepted by `ObservabilityStorageClickhouse` and `Obse
 
 **id** (`string`): Unique identifier for this storage instance.
 
-**url** (`string`): ClickHouse server URL (for example, \`https\://your-instance.clickhouse.cloud:8443\` or \`http\://localhost:8123\`). Required when not passing a pre-configured \`client\`.
+**url** (`string`): ClickHouse server URL (for example, https\://your-instance.clickhouse.cloud:8443 or http\://localhost:8123). Required when not passing a pre-configured client.
 
-**username** (`string`): ClickHouse username. Required when not passing a pre-configured \`client\`.
+**username** (`string`): ClickHouse username. Required when not passing a pre-configured client.
 
-**password** (`string`): ClickHouse password. Required when not passing a pre-configured \`client\`. It can be an empty string for the default user on a local instance.
+**password** (`string`): ClickHouse password. Required when not passing a pre-configured client. It can be an empty string for the default user on a local instance.
 
-**client** (`ClickHouseClient`): Pre-configured ClickHouse client from \`@clickhouse/client\`. Use this when you need custom request settings. Mutually exclusive with the credential fields above.
+**client** (`ClickHouseClient`): Pre-configured ClickHouse client from @clickhouse/client. Use this when you need custom request settings. Mutually exclusive with the credential fields above.
 
-**ttl** (`object`): Per-table TTL configuration applied at table creation time. Accepts row-level and column-level TTLs in interval units from \`NANOSECOND\` through \`YEAR\`.
+**ttl** (`object`): Per-table TTL configuration applied at table creation time. Accepts row-level and column-level TTLs in interval units from NANOSECOND through YEAR.
 
-**replication** (`{ cluster?: string; zookeeperPath?: string; replicaName?: string }`): Opt-in replicated table configuration for multi-replica ClickHouse clusters. When set, Mastra creates replicated MergeTree tables. When \`cluster\` is set, Mastra also adds \`ON CLUSTER\` to Mastra-owned data definition language (DDL).
+**replication** (`{ cluster?: string; zookeeperPath?: string; replicaName?: string }`): Opt-in replicated table configuration for multi-replica ClickHouse clusters. When set, Mastra creates replicated MergeTree tables. When cluster is set, Mastra also adds ON CLUSTER to Mastra-owned data definition language (DDL).
 
-**disableInit** (`boolean`): When \`true\`, the store does not run table creation or migrations on first use. Call \`storage.init()\` explicitly from your deployment scripts. (Default: `false`)
+**disableInit** (`boolean`): When true, the store does not run table creation or migrations on first use. Call storage.init() explicitly from your deployment scripts. (Default: `false`)
 
 `ClickhouseStore` also accepts every option from `ClickHouseClientConfigOptions` (such as `database`, `request_timeout`, `compression`, `keep_alive`, and `max_open_connections`).
 

package/.docs/reference/storage/composite.md

@@ -128,11 +128,11 @@ export const mastra = new Mastra({
 
 **id** (`string`): Unique identifier for this storage instance.
 
-**default** (`MastraCompositeStore`): Default storage adapter. Domains not explicitly specified in \`domains\` will use this storage's domains as fallbacks.
+**default** (`MastraCompositeStore`): Default storage adapter. Domains not explicitly specified in domains will use this storage's domains as fallbacks.
 
 **disableInit** (`boolean`): When true, automatic initialization is disabled. You must call init() explicitly.
 
-**domains** (`object`): Individual domain overrides. Each domain can come from a different storage adapter. These take precedence over both \`editor\` and \`default\` storage.
+**domains** (`object`): Individual domain overrides. Each domain can come from a different storage adapter. These take precedence over both editor and default storage.
 
 **domains.memory** (`MemoryStorage`): Storage for threads, messages, and resources.
 

package/.docs/reference/storage/duckdb.md

@@ -108,7 +108,7 @@ const duckdb = new DuckDBStore({ path: ':memory:' })
 
 **id** (`string`): Unique identifier for this storage instance. (Default: `'duckdb'`)
 
-**path** (`string`): Path to the DuckDB database file. Use \`:memory:\` for an ephemeral in-memory database. (Default: `'mastra.duckdb'`)
+**path** (`string`): Path to the DuckDB database file. Use :memory: for an ephemeral in-memory database. (Default: `'mastra.duckdb'`)
 
 ### Lower-level types
 

package/.docs/reference/storage/dynamodb.md

@@ -118,7 +118,7 @@ For local development, you can use [DynamoDB Local](https://docs.aws.amazon.com/
 
 **config.endpoint** (`string`): Custom endpoint for DynamoDB (e.g., 'http\://localhost:8000' for local development).
 
-**config.credentials** (`object`): AWS credentials object with \`accessKeyId\` and \`secretAccessKey\`. If not provided, the AWS SDK will attempt to source credentials from environment variables, IAM roles (e.g., for EC2/Lambda), or the shared AWS credentials file.
+**config.credentials** (`object`): AWS credentials object with accessKeyId and secretAccessKey. If not provided, the AWS SDK will attempt to source credentials from environment variables, IAM roles (e.g., for EC2/Lambda), or the shared AWS credentials file.
 
 **config.ttl** (`object`): TTL (Time To Live) configuration for automatic data expiration. Configure per entity type: thread, message, trace, eval, workflow\_snapshot, resource, score. Each entity config includes: enabled (boolean), attributeName (string, default: 'ttl'), defaultTtlSeconds (number).
 

package/.docs/reference/storage/libsql.md

@@ -91,7 +91,7 @@ storage: new LibSQLStore({
 
 ## Options
 
-**url** (`string`): Database URL. Use \`:memory:\` for in-memory database, \`file:filename.db\` for a file database, or a libSQL connection string (e.g., \`libsql://your-database.turso.io\`) for remote storage.
+**url** (`string`): Database URL. Use :memory: for in-memory database, file:filename.db for a file database, or a libSQL connection string (e.g., libsql://your-database.turso.io) for remote storage.
 
 **authToken** (`string`): Authentication token for remote libSQL databases.
 

package/.docs/reference/storage/postgresql.md

@@ -45,7 +45,7 @@ const storage = new PostgresStore({
 
 **id** (`string`): Unique identifier for this storage instance.
 
-**connectionString** (`string`): PostgreSQL connection string (e.g., postgresql://user:pass\@host:5432/dbname). Required unless using \`pool\` or individual host-based parameters (\`host\`, \`port\`, \`database\`, \`user\`, \`password\`).
+**connectionString** (`string`): PostgreSQL connection string (e.g., postgresql://user:pass\@host:5432/dbname). Required unless using pool or individual host-based parameters (host, port, database, user, password).
 
 **host** (`string`): Database server hostname or IP address. Used with other host-based parameters as an alternative to connectionString.
 
@@ -57,7 +57,7 @@ const storage = new PostgresStore({
 
 **password** (`string`): Password for the database user.
 
-**pool** (`pg.Pool`): Pre-configured pg.Pool instance. Use this to reuse an existing connection pool. When provided, Mastra will not create its own pool and will not close it when \`store.close()\` is called.
+**pool** (`pg.Pool`): Pre-configured pg.Pool instance. Use this to reuse an existing connection pool. When provided, Mastra will not create its own pool and will not close it when store.close() is called.
 
 **schemaName** (`string`): The name of the schema you want the storage to use. Defaults to 'public'.
 

package/.docs/reference/storage/redis.md

@@ -69,7 +69,7 @@ const storage = new RedisStore({
 
 **id** (`string`): Unique identifier for the storage instance
 
-**connectionString** (`string`): Redis connection URL (e.g., \`redis\://localhost:6379\` or \`redis\://:password\@localhost:6379\`)
+**connectionString** (`string`): Redis connection URL (e.g., redis\://localhost:6379 or redis\://:password\@localhost:6379)
 
 **host** (`string`): Redis host address
 
@@ -79,7 +79,7 @@ const storage = new RedisStore({
 
 **db** (`number`): Redis database number (Default: `0`)
 
-**client** (`RedisClient`): Pre-configured redis client (from the \`redis\` package) for advanced setups
+**client** (`RedisClient`): Pre-configured redis client (from the redis package) for advanced setups
 
 > **Note:** You must provide either `connectionString`, `host`, or `client`. These options are mutually exclusive.
 

package/.docs/reference/storage/retention.md

@@ -55,11 +55,11 @@ Set the `retention` field on the store config.
 
 **retention** (`RetentionConfig`): Per-domain, per-table age policies. Unset domains and tables are kept forever.
 
-**retention.\[domain]** (`Record<TableKey, TableRetentionPolicy>`): A real storage domain key (e.g. \`memory\`, \`observability\`). Maps that domain's retention-eligible table keys to their policies.
+**retention.\[domain]** (`Record<TableKey, TableRetentionPolicy>`): A real storage domain key (e.g. memory, observability). Maps that domain's retention-eligible table keys to their policies.
 
 ### TableRetentionPolicy
 
-**maxAge** (`Duration`): Maximum age to keep rows. Rows whose anchor timestamp is strictly older than \`Date.now() - maxAge\` are eligible for deletion. A number is milliseconds, or a string with a unit suffix: \`ms\`, \`s\`, \`m\`, \`h\`, \`d\`, \`w\` (e.g. \`'30d'\`, \`'12h'\`).
+**maxAge** (`Duration`): Maximum age to keep rows. Rows whose anchor timestamp is strictly older than Date.now() - maxAge are eligible for deletion. A number is milliseconds, or a string with a unit suffix: ms, s, m, h, d, w (e.g. '30d', '12h').
 
 **batchSize** (`number`): Rows deleted per batch. Each batch is its own transaction, which bounds lock duration and WAL growth on large tables. (Default: `1000`)
 
@@ -122,13 +122,13 @@ Returns: `Promise<PruneResult[]>`
 
 ##### PruneOptions
 
-**maxBatches** (`number`): Maximum delete batches per table per call. When reached, that table's result is returned with \`done: false\`.
+**maxBatches** (`number`): Maximum delete batches per table per call. When reached, that table's result is returned with done: false.
 
-**maxRows** (`number`): Maximum rows deleted per table per call. When reached, that table's result is returned with \`done: false\`.
+**maxRows** (`number`): Maximum rows deleted per table per call. When reached, that table's result is returned with done: false.
 
 **pauseMs** (`number`): Delay in milliseconds between batches, to avoid starving live traffic.
 
-**signal** (`AbortSignal`): Cooperative cancellation. The batch loop checks it between batches and stops cleanly, returning partial results with \`done: false\`.
+**signal** (`AbortSignal`): Cooperative cancellation. The batch loop checks it between batches and stops cleanly, returning partial results with done: false.
 
 ##### PruneResult