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

package/.docs/models/providers/alibaba-cn.md

@@ -2,7 +2,7 @@
 
 # ![Alibaba (China) logo](https://models.dev/logos/alibaba-cn.svg)Alibaba (China)
 
-Access 83 Alibaba (China) models through Mastra's model router. Authentication is handled automatically using the `DASHSCOPE_API_KEY` environment variable.
+Access 84 Alibaba (China) models through Mastra's model router. Authentication is handled automatically using the `DASHSCOPE_API_KEY` environment variable.
 
 Learn more in the [Alibaba (China) documentation](https://www.alibabacloud.com/help/en/model-studio/models).
 
@@ -51,6 +51,7 @@ for await (const chunk of stream) {
 | `alibaba-cn/deepseek-v4-pro`                    | 1.0M    |       |           |       |       |       | $0.43      | $0.87       |
 | `alibaba-cn/glm-5`                              | 203K    |       |           |       |       |       | $0.86      | $3          |
 | `alibaba-cn/glm-5.1`                            | 203K    |       |           |       |       |       | $0.87      | $3          |
+| `alibaba-cn/glm-5.2`                            | 1.0M    |       |           |       |       |       | $1         | $4          |
 | `alibaba-cn/kimi-k2-thinking`                   | 262K    |       |           |       |       |       | $0.57      | $2          |
 | `alibaba-cn/kimi-k2.5`                          | 262K    |       |           |       |       |       | $0.57      | $2          |
 | `alibaba-cn/kimi-k2.6`                          | 262K    |       |           |       |       |       | $0.93      | $4          |

package/.docs/models/providers/friendli.md

@@ -2,7 +2,7 @@
 
 # ![Friendli logo](https://models.dev/logos/friendli.svg)Friendli
 
-Access 7 Friendli models through Mastra's model router. Authentication is handled automatically using the `FRIENDLI_TOKEN` environment variable.
+Access 6 Friendli models through Mastra's model router. Authentication is handled automatically using the `FRIENDLI_TOKEN` environment variable.
 
 Learn more in the [Friendli documentation](https://friendli.ai/docs/guides/serverless_endpoints/introduction).
 
@@ -40,7 +40,6 @@ for await (const chunk of stream) {
 | `friendli/google/gemma-4-31B-it`              | 262K    |       |           |       |       |       | $0.14      | $0.40       |
 | `friendli/MiniMaxAI/MiniMax-M2.5`             | 197K    |       |           |       |       |       | $0.30      | $1          |
 | `friendli/Qwen/Qwen3-235B-A22B-Instruct-2507` | 262K    |       |           |       |       |       | $0.20      | $0.80       |
-| `friendli/zai-org/GLM-5`                      | 203K    |       |           |       |       |       | $1         | $3          |
 | `friendli/zai-org/GLM-5.1`                    | 203K    |       |           |       |       |       | $1         | $4          |
 | `friendli/zai-org/GLM-5.2`                    | 1.0M    |       |           |       |       |       | $1         | $4          |
 

package/.docs/models/providers/kenari.md

@@ -0,0 +1,95 @@
+> Discover all available pages from the documentation index: https://mastra.ai/llms.txt
+
+# ![Kenari logo](https://models.dev/logos/kenari.svg)Kenari
+
+Access 23 Kenari models through Mastra's model router. Authentication is handled automatically using the `KENARI_API_KEY` environment variable.
+
+Learn more in the [Kenari documentation](https://kenari.id/docs).
+
+```bash
+KENARI_API_KEY=your-api-key
+```
+
+```typescript
+import { Agent } from "@mastra/core/agent";
+
+const agent = new Agent({
+  id: "my-agent",
+  name: "My Agent",
+  instructions: "You are a helpful assistant",
+  model: "kenari/claude-opus-4-7"
+});
+
+// Generate a response
+const response = await agent.generate("Hello!");
+
+// Stream a response
+const stream = await agent.stream("Tell me a story");
+for await (const chunk of stream) {
+  console.log(chunk);
+}
+```
+
+> **Info:** Mastra uses the OpenAI-compatible `/chat/completions` endpoint. Some provider-specific features may not be available. Check the [Kenari documentation](https://kenari.id/docs) for details.
+
+## Models
+
+| Model                           | Context | Tools | Reasoning | Image | Audio | Video | Input $/1M | Output $/1M |
+| ------------------------------- | ------- | ----- | --------- | ----- | ----- | ----- | ---------- | ----------- |
+| `kenari/claude-opus-4-7`        | 1.0M    |       |           |       |       |       | —          | —           |
+| `kenari/claude-opus-4-8`        | 1.0M    |       |           |       |       |       | —          | —           |
+| `kenari/claude-sonnet-4-6`      | 1.0M    |       |           |       |       |       | —          | —           |
+| `kenari/deepseek-v4-flash`      | 1.0M    |       |           |       |       |       | —          | —           |
+| `kenari/deepseek-v4-flash:free` | 1.0M    |       |           |       |       |       | —          | —           |
+| `kenari/deepseek-v4-pro`        | 1.0M    |       |           |       |       |       | —          | —           |
+| `kenari/deepseek-v4-pro:free`   | 1.0M    |       |           |       |       |       | —          | —           |
+| `kenari/gemma-4-31b-it`         | 262K    |       |           |       |       |       | —          | —           |
+| `kenari/glm-5-1`                | 200K    |       |           |       |       |       | —          | —           |
+| `kenari/glm-5-2`                | 1.0M    |       |           |       |       |       | —          | —           |
+| `kenari/gpt-5-4-mini`           | 400K    |       |           |       |       |       | —          | —           |
+| `kenari/gpt-5-5`                | 1.1M    |       |           |       |       |       | —          | —           |
+| `kenari/gpt-image-2`            | 272K    |       |           |       |       |       | —          | —           |
+| `kenari/gpt-oss-120b`           | 131K    |       |           |       |       |       | —          | —           |
+| `kenari/gpt-oss-20b`            | 131K    |       |           |       |       |       | —          | —           |
+| `kenari/grok-4-3`               | 1.0M    |       |           |       |       |       | —          | —           |
+| `kenari/grok-build-0-1`         | 256K    |       |           |       |       |       | —          | —           |
+| `kenari/kimi-k2-6`              | 262K    |       |           |       |       |       | —          | —           |
+| `kenari/kimi-k2-7-code`         | 262K    |       |           |       |       |       | —          | —           |
+| `kenari/mimo-v2-5`              | 1.0M    |       |           |       |       |       | —          | —           |
+| `kenari/mimo-v2-5-pro`          | 1.0M    |       |           |       |       |       | —          | —           |
+| `kenari/minimax-m3`             | 512K    |       |           |       |       |       | —          | —           |
+| `kenari/qwen3-7-plus`           | 1.0M    |       |           |       |       |       | —          | —           |
+
+## Advanced configuration
+
+### Custom headers
+
+```typescript
+const agent = new Agent({
+  id: "custom-agent",
+  name: "custom-agent",
+  model: {
+    url: "https://kenari.id/v1",
+    id: "kenari/claude-opus-4-7",
+    apiKey: process.env.KENARI_API_KEY,
+    headers: {
+      "X-Custom-Header": "value"
+    }
+  }
+});
+```
+
+### Dynamic model selection
+
+```typescript
+const agent = new Agent({
+  id: "dynamic-agent",
+  name: "Dynamic Agent",
+  model: ({ requestContext }) => {
+    const useAdvanced = requestContext.task === "complex";
+    return useAdvanced
+      ? "kenari/qwen3-7-plus"
+      : "kenari/claude-opus-4-7";
+  }
+});
+```

package/.docs/models/providers/nvidia.md

@@ -2,7 +2,7 @@
 
 # ![Nvidia logo](https://models.dev/logos/nvidia.svg)Nvidia
 
-Access 84 Nvidia models through Mastra's model router. Authentication is handled automatically using the `NVIDIA_API_KEY` environment variable.
+Access 83 Nvidia models through Mastra's model router. Authentication is handled automatically using the `NVIDIA_API_KEY` environment variable.
 
 Learn more in the [Nvidia documentation](https://docs.api.nvidia.com/nim/).
 
@@ -119,7 +119,6 @@ for await (const chunk of stream) {
 | `nvidia/stepfun-ai/step-3.5-flash`                     | 256K    |       |           |       |       |       | —          | —           |
 | `nvidia/stepfun-ai/step-3.7-flash`                     | 256K    |       |           |       |       |       | —          | —           |
 | `nvidia/upstage/solar-10_7b-instruct`                  | 128K    |       |           |       |       |       | —          | —           |
-| `nvidia/z-ai/glm-5.1`                                  | 131K    |       |           |       |       |       | —          | —           |
 
 ## Advanced configuration
 
@@ -149,7 +148,7 @@ const agent = new Agent({
   model: ({ requestContext }) => {
     const useAdvanced = requestContext.task === "complex";
     return useAdvanced
-      ? "nvidia/z-ai/glm-5.1"
+      ? "nvidia/upstage/solar-10_7b-instruct"
       : "nvidia/abacusai/dracarys-llama-3_1-70b-instruct";
   }
 });

package/.docs/models/providers/tencent-token-plan.md

@@ -17,7 +17,7 @@ const agent = new Agent({
   id: "my-agent",
   name: "My Agent",
   instructions: "You are a helpful assistant",
-  model: "tencent-token-plan/hy3-preview"
+  model: "tencent-token-plan/hy3"
 });
 
 // Generate a response
@@ -34,9 +34,9 @@ for await (const chunk of stream) {
 
 ## Models
 
-| Model                            | Context | Tools | Reasoning | Image | Audio | Video | Input $/1M | Output $/1M |
-| -------------------------------- | ------- | ----- | --------- | ----- | ----- | ----- | ---------- | ----------- |
-| `tencent-token-plan/hy3-preview` | 256K    |       |           |       |       |       | —          | —           |
+| Model                    | Context | Tools | Reasoning | Image | Audio | Video | Input $/1M | Output $/1M |
+| ------------------------ | ------- | ----- | --------- | ----- | ----- | ----- | ---------- | ----------- |
+| `tencent-token-plan/hy3` | 256K    |       |           |       |       |       | —          | —           |
 
 ## Advanced configuration
 
@@ -48,7 +48,7 @@ const agent = new Agent({
   name: "custom-agent",
   model: {
     url: "https://api.lkeap.cloud.tencent.com/plan/v3",
-    id: "tencent-token-plan/hy3-preview",
+    id: "tencent-token-plan/hy3",
     apiKey: process.env.TENCENT_TOKEN_PLAN_API_KEY,
     headers: {
       "X-Custom-Header": "value"
@@ -66,8 +66,8 @@ const agent = new Agent({
   model: ({ requestContext }) => {
     const useAdvanced = requestContext.task === "complex";
     return useAdvanced
-      ? "tencent-token-plan/hy3-preview"
-      : "tencent-token-plan/hy3-preview";
+      ? "tencent-token-plan/hy3"
+      : "tencent-token-plan/hy3";
   }
 });
 ```

package/.docs/models/providers/tencent-tokenhub.md

@@ -2,7 +2,7 @@
 
 # ![Tencent TokenHub logo](https://models.dev/logos/tencent-tokenhub.svg)Tencent TokenHub
 
-Access 1 Tencent TokenHub model through Mastra's model router. Authentication is handled automatically using the `TENCENT_TOKENHUB_API_KEY` environment variable.
+Access 2 Tencent TokenHub models through Mastra's model router. Authentication is handled automatically using the `TENCENT_TOKENHUB_API_KEY` environment variable.
 
 Learn more in the [Tencent TokenHub documentation](https://cloud.tencent.com/document/product/1823/130050).
 
@@ -17,7 +17,7 @@ const agent = new Agent({
   id: "my-agent",
   name: "My Agent",
   instructions: "You are a helpful assistant",
-  model: "tencent-tokenhub/hy3-preview"
+  model: "tencent-tokenhub/hy3"
 });
 
 // Generate a response
@@ -36,6 +36,7 @@ for await (const chunk of stream) {
 
 | Model                          | Context | Tools | Reasoning | Image | Audio | Video | Input $/1M | Output $/1M |
 | ------------------------------ | ------- | ----- | --------- | ----- | ----- | ----- | ---------- | ----------- |
+| `tencent-tokenhub/hy3`         | 256K    |       |           |       |       |       | —          | —           |
 | `tencent-tokenhub/hy3-preview` | 256K    |       |           |       |       |       | —          | —           |
 
 ## Advanced configuration
@@ -48,7 +49,7 @@ const agent = new Agent({
   name: "custom-agent",
   model: {
     url: "https://tokenhub.tencentmaas.com/v1",
-    id: "tencent-tokenhub/hy3-preview",
+    id: "tencent-tokenhub/hy3",
     apiKey: process.env.TENCENT_TOKENHUB_API_KEY,
     headers: {
       "X-Custom-Header": "value"
@@ -67,7 +68,7 @@ const agent = new Agent({
     const useAdvanced = requestContext.task === "complex";
     return useAdvanced
       ? "tencent-tokenhub/hy3-preview"
-      : "tencent-tokenhub/hy3-preview";
+      : "tencent-tokenhub/hy3";
   }
 });
 ```

package/.docs/models/providers.md

@@ -57,6 +57,7 @@ Direct access to individual AI model providers. Each provider offers unique mode
 - [Inference](https://mastra.ai/models/providers/inference)
 - [IO.NET](https://mastra.ai/models/providers/io-net)
 - [Jiekou.AI](https://mastra.ai/models/providers/jiekou)
+- [Kenari](https://mastra.ai/models/providers/kenari)
 - [Kilo Gateway](https://mastra.ai/models/providers/kilo)
 - [Kimi For Coding](https://mastra.ai/models/providers/kimi-for-coding)
 - [KUAE Cloud Coding Plan](https://mastra.ai/models/providers/kuae-cloud-coding-plan)
@@ -113,6 +114,7 @@ Direct access to individual AI model providers. Each provider offers unique mode
 - [submodel](https://mastra.ai/models/providers/submodel)
 - [Synthetic](https://mastra.ai/models/providers/synthetic)
 - [Tencent Coding Plan (China)](https://mastra.ai/models/providers/tencent-coding-plan)
+- [Tencent Token Plan](https://mastra.ai/models/providers/tencent-token-plan)
 - [Tencent TokenHub](https://mastra.ai/models/providers/tencent-tokenhub)
 - [The Grid AI](https://mastra.ai/models/providers/the-grid-ai)
 - [Tinfoil](https://mastra.ai/models/providers/tinfoil)

package/.docs/reference/acp/acp-agent.md

@@ -54,7 +54,7 @@ export const claudeCodeAgent = new AcpAgent({
 
 **id** (`string`): Unique identifier for the subagent.
 
-**name** (`string`): Display name used during agent delegation. Defaults to \`id\`.
+**name** (`string`): Display name used during agent delegation. Defaults to id.
 
 **description** (`string`): Description shown to the model when it can delegate to this subagent.
 
@@ -66,19 +66,19 @@ export const claudeCodeAgent = new AcpAgent({
 
 **cwd** (`string`): Working directory for the ACP process and ACP session. Also used as the default local filesystem base path. (Default: `process.cwd()`)
 
-**session** (`Partial<NewSessionRequest>`): ACP session creation options. Defaults to \`cwd\` or \`process.cwd()\` and an empty MCP server list.
+**session** (`Partial<NewSessionRequest>`): ACP session creation options. Defaults to cwd or process.cwd() and an empty MCP server list.
 
 **initialize** (`Partial<InitializeRequest>`): ACP initialization options. Defaults to Mastra client information, the current ACP protocol version, and read/write filesystem capabilities.
 
 **authMethodId** (`string`): ACP authentication method ID to invoke after initialization and before session creation.
 
-**persistSession** (`boolean`): Whether to keep the ACP process and session alive after each prompt. Set to \`false\` to stop the process after each prompt completes. (Default: `true`)
+**persistSession** (`boolean`): Whether to keep the ACP process and session alive after each prompt. Set to false to stop the process after each prompt completes. (Default: `true`)
 
 **onPermissionRequest** (`(request: RequestPermissionRequest) => Promise<RequestPermissionResponse>`): Callback invoked when the ACP agent requests permission. Defaults to selecting the first permission option, or cancelling when no option is available.
 
-**workspace** (`Workspace`): Workspace used for ACP file read and write requests. Defaults to a \`Workspace\` backed by \`LocalFilesystem\` at \`cwd\` or \`process.cwd()\`.
+**workspace** (`Workspace`): Workspace used for ACP file read and write requests. Defaults to a Workspace backed by LocalFilesystem at cwd or process.cwd().
 
-**model** (`ModelId`): Model ID to select after ACP session creation using the ACP \`session/set\_model\` method.
+**model** (`ModelId`): Model ID to select after ACP session creation using the ACP session/set\_model method.
 
 ## Properties
 

package/.docs/reference/acp/create-acp-tool.md

@@ -47,19 +47,19 @@ export const codeSupervisor = new Agent({
 
 **cwd** (`string`): Working directory for the ACP process and ACP session. Also used as the default local filesystem base path. (Default: `process.cwd()`)
 
-**session** (`Partial<NewSessionRequest>`): ACP session creation options. Defaults to \`cwd\` or \`process.cwd()\` and an empty MCP server list.
+**session** (`Partial<NewSessionRequest>`): ACP session creation options. Defaults to cwd or process.cwd() and an empty MCP server list.
 
 **initialize** (`Partial<InitializeRequest>`): ACP initialization options. Defaults to Mastra client information, the current ACP protocol version, and read/write filesystem capabilities.
 
 **authMethodId** (`string`): ACP authentication method ID to invoke after initialization and before session creation.
 
-**persistSession** (`boolean`): Whether the ACP connection created for a tool execution disconnects after the prompt. Set to \`false\` to stop the process after each prompt completes. (Default: `true`)
+**persistSession** (`boolean`): Whether the ACP connection created for a tool execution disconnects after the prompt. Set to false to stop the process after each prompt completes. (Default: `true`)
 
 **onPermissionRequest** (`(request: RequestPermissionRequest) => Promise<RequestPermissionResponse>`): Callback invoked when the ACP agent requests permission. Defaults to selecting the first permission option, or cancelling when no option is available.
 
-**workspace** (`Workspace`): Workspace option from the shared ACP connection options. During tool execution, \`createACPTool()\` passes the current Mastra workspace from the execution context when one is available; otherwise the ACP connection falls back to a local filesystem workspace. Use \`AcpAgent\` when you need to provide an explicit workspace instance.
+**workspace** (`Workspace`): Workspace option from the shared ACP connection options. During tool execution, createACPTool() passes the current Mastra workspace from the execution context when one is available; otherwise the ACP connection falls back to a local filesystem workspace. Use AcpAgent when you need to provide an explicit workspace instance.
 
-**model** (`ModelId`): Model ID to select after ACP session creation using the ACP \`session/set\_model\` method.
+**model** (`ModelId`): Model ID to select after ACP session creation using the ACP session/set\_model method.
 
 ## Input schema
 
@@ -79,7 +79,7 @@ export const codeSupervisor = new Agent({
 
 ### Resume payload
 
-**optionId** (`string`): Permission option ID to select when resuming with \`outcome: "selected"\`.
+**optionId** (`string`): Permission option ID to select when resuming with outcome: "selected".
 
 **outcome** (`"selected" | "cancelled"`): Permission decision used to continue or cancel the ACP request.
 

package/.docs/reference/agent-controller/agent-controller-class.md

@@ -52,7 +52,7 @@ await agentController.sendMessage({ content: 'Hello!' })
 
 **id** (`string`): Unique identifier for this agentController instance.
 
-**resourceId** (`string`): Resource ID for grouping threads (e.g., project identifier). Threads are scoped to this resource ID. Defaults to \`id\`.
+**resourceId** (`string`): Resource ID for grouping threads (e.g., project identifier). Threads are scoped to this resource ID. Defaults to id.
 
 **storage** (`MastraCompositeStore`): Storage backend for persistence (threads, messages, state).
 
@@ -62,35 +62,35 @@ await agentController.sendMessage({ content: 'Hello!' })
 
 **memory** (`MastraMemory`): Memory configuration shared across all modes. Propagated to mode agents that don't have their own memory.
 
-**modes** (`AgentControllerMode[]`): Available agent modes. At least one mode is required. When a top-level \`agent\` is provided, each mode layers its own instructions and tool overrides on top of the shared agent.
+**modes** (`AgentControllerMode[]`): Available agent modes. At least one mode is required. When a top-level agent is provided, each mode layers its own instructions and tool overrides on top of the shared agent.
 
-**modes.id** (`string`): Unique identifier for this mode (e.g., \`"plan"\`, \`"build"\`).
+**modes.id** (`string`): Unique identifier for this mode (e.g., "plan", "build").
 
 **modes.name** (`string`): Human-readable name for display.
 
-**modes.default** (`boolean`): Whether this is the default mode when the agentController starts. Deprecated in favor of \`metadata.default\` or the top-level \`defaultModeId\`.
+**modes.default** (`boolean`): Whether this is the default mode when the agentController starts. Deprecated in favor of metadata.default or the top-level defaultModeId.
 
-**modes.defaultModelId** (`string`): Default model ID for this mode (e.g., \`"anthropic/claude-sonnet-4-20250514"\`). Used when no per-mode model has been explicitly selected.
+**modes.defaultModelId** (`string`): Default model ID for this mode (e.g., "anthropic/claude-sonnet-4-20250514"). Used when no per-mode model has been explicitly selected.
 
 **modes.description** (`string`): Description surfaced in mode pickers and Studio UI.
 
 **modes.instructions** (`string`): Additional instructions layered above the backing agent's own instructions for this mode.
 
-**modes.transitionsTo** (`string`): Target mode ID to switch to on \`submit\_plan\` approval. Must reference another mode's \`id\`.
+**modes.transitionsTo** (`string`): Target mode ID to switch to on submit\_plan approval. Must reference another mode's id.
 
-**modes.metadata** (`Record<string, unknown>`): Arbitrary metadata. \`metadata.default === true\` marks the default mode when \`defaultModeId\` is unset.
+**modes.metadata** (`Record<string, unknown>`): Arbitrary metadata. metadata.default === true marks the default mode when defaultModeId is unset.
 
-**modes.tools** (`ToolsInput`): Replaces the backing agent's tools for this mode. Mutually exclusive with \`additionalTools\`.
+**modes.tools** (`ToolsInput`): Replaces the backing agent's tools for this mode. Mutually exclusive with additionalTools.
 
-**modes.additionalTools** (`ToolsInput`): Tools layered on top of the backing agent's tools. Mutually exclusive with \`tools\`.
+**modes.additionalTools** (`ToolsInput`): Tools layered on top of the backing agent's tools. Mutually exclusive with tools.
 
-**modes.availableTools** (`string[]`): Per-mode tool visibility allowlist. When set, only tools whose final exposed names appear in this list are visible to the model and executable during this mode's runs. \`undefined\` = all tools visible; \`\[]\` = no tools. Per-tool and per-category \`deny\` rules take precedence over this list. Workspace tools use the same list — reference them by exposed names (\`view\`, \`write\_file\`, etc.).
+**modes.availableTools** (`string[]`): Per-mode tool visibility allowlist. When set, only tools whose final exposed names appear in this list are visible to the model and executable during this mode's runs. undefined = all tools visible; \[] = no tools. Per-tool and per-category deny rules take precedence over this list. Workspace tools use the same list — reference them by exposed names (view, write\_file, etc.).
 
-**modes.agent** (`Agent`): The agent for this mode. Deprecated in favor of the top-level \`agent\` config with mode-level overrides.
+**modes.agent** (`Agent`): The agent for this mode. Deprecated in favor of the top-level agent config with mode-level overrides.
 
 **agent** (`Agent`): Shared backing agent that each mode forks and decorates. When provided, modes layer instructions and tool overrides on top of this agent instead of providing their own.
 
-**defaultModeId** (`string`): Default mode to enter when a thread has no persisted mode. Takes precedence over \`metadata.default\` on individual modes.
+**defaultModeId** (`string`): Default mode to enter when a thread has no persisted mode. Takes precedence over metadata.default on individual modes.
 
 **instructions** (`string`): Base instructions shared across all modes. Appended to the backing agent's instructions.
 
@@ -100,9 +100,9 @@ await agentController.sendMessage({ content: 'Hello!' })
 
 **browser** (`MastraBrowser | ((ctx) => MastraBrowser)`): Browser automation instance or a dynamic factory function. When omitted, each session created via createSession can provide its own browser.
 
-**subagents** (`AgentControllerSubagent[]`): Subagent definitions. When provided, the agentController creates a built-in \`subagent\` tool that parent agents can call to spawn focused subagents.
+**subagents** (`AgentControllerSubagent[]`): Subagent definitions. When provided, the agentController creates a built-in subagent tool that parent agents can call to spawn focused subagents.
 
-**subagents.id** (`string`): Unique identifier for this subagent type (e.g., \`"explore"\`, \`"execute"\`).
+**subagents.id** (`string`): Unique identifier for this subagent type (e.g., "explore", "execute").
 
 **subagents.name** (`string`): Human-readable name shown in tool output.
 
@@ -112,43 +112,43 @@ await agentController.sendMessage({ content: 'Hello!' })
 
 **subagents.tools** (`ToolsInput`): Tools this subagent has direct access to.
 
-**subagents.allowedAgentControllerTools** (`string[]`): Tool IDs from the agentController's shared \`tools\` config. Merged with \`tools\` above to let subagents use a subset of agentController tools.
+**subagents.allowedAgentControllerTools** (`string[]`): Tool IDs from the agentController's shared tools config. Merged with tools above to let subagents use a subset of agentController tools.
 
 **subagents.allowedWorkspaceTools** (`string[]`): Workspace tool names the subagent is allowed to use. Uses the exposed names (after any renames via workspace tool config). When set, workspace tools not in this list are hidden from the model. Non-workspace tools are never affected. When omitted, all workspace tools are visible.
 
 **subagents.defaultModelId** (`string`): Default model ID for this subagent type.
 
-**subagents.maxSteps** (`number`): Optional maximum number of steps for the spawned subagent. Defaults to \`50\` when omitted.
+**subagents.maxSteps** (`number`): Optional maximum number of steps for the spawned subagent. Defaults to 50 when omitted.
 
 **subagents.stopWhen** (`LoopOptions['stopWhen']`): Optional stop condition for the spawned subagent.
 
-**subagents.forked** (`boolean`): When \`true\`, calls to this subagent default to forked mode: the subagent runs on a clone of the parent thread, reusing the parent agent’s instructions, tools, and model so the prompt-cache prefix stays intact. Requires \`memory\` to be configured. The subagent definition’s own \`instructions\`, \`tools\`, \`allowedAgentControllerTools\`, \`allowedWorkspaceTools\`, \`defaultModelId\`, \`maxSteps\`, and \`stopWhen\` are ignored in forked mode. Callers can still override per-invocation via \`forked: false\` in the \`subagent\` tool input. See the \[Forked subagents]\(#forked-subagents) section below for full semantics.
+**subagents.forked** (`boolean`): When true, calls to this subagent default to forked mode: the subagent runs on a clone of the parent thread, reusing the parent agent’s instructions, tools, and model so the prompt-cache prefix stays intact. Requires memory to be configured. The subagent definition’s own instructions, tools, allowedAgentControllerTools, allowedWorkspaceTools, defaultModelId, maxSteps, and stopWhen are ignored in forked mode. Callers can still override per-invocation via forked: false in the subagent tool input. See the Forked subagents section below for full semantics.
 
-**resolveModel** (`(modelId: string) => MastraLanguageModel`): Converts a model ID string (e.g., \`"anthropic/claude-sonnet-4"\`) to a language model instance. Used by subagents and observational memory model resolution.
+**resolveModel** (`(modelId: string) => MastraLanguageModel`): Converts a model ID string (e.g., "anthropic/claude-sonnet-4") to a language model instance. Used by subagents and observational memory model resolution.
 
 **omConfig** (`AgentControllerOMConfig`): Default configuration for observational memory (observer/reflector model IDs and thresholds).
 
-**disableBuiltinTools** (`BuiltinToolId[]`): Built-in tool IDs to remove from the \`controllerBuiltIn\` toolset. Valid values are \`ask\_user\`, \`submit\_plan\`, \`task\_write\`, \`task\_update\`, \`task\_complete\`, \`task\_check\`, and \`subagent\`.
+**disableBuiltinTools** (`BuiltinToolId[]`): Built-in tool IDs to remove from the controllerBuiltIn toolset. Valid values are ask\_user, submit\_plan, task\_write, task\_update, task\_complete, task\_check, and subagent.
 
-**intervalHandlers** (`IntervalHandler[]`): Periodic background tasks started during \`init()\`. Use for gateway sync, cache refresh, and similar tasks.
+**intervalHandlers** (`IntervalHandler[]`): Periodic background tasks started during init(). Use for gateway sync, cache refresh, and similar tasks.
 
 **idGenerator** (`() => string`): Custom ID generator for AgentController-managed IDs such as threads and mode-run identifiers. (Default: `timestamp + random string`)
 
-**modelAuthChecker** (`ModelAuthChecker`): Custom auth checker for model providers. Return \`true\`/\`false\` to override the default environment variable check, or \`undefined\` to fall back to defaults.
+**modelAuthChecker** (`ModelAuthChecker`): Custom auth checker for model providers. Return true/false to override the default environment variable check, or undefined to fall back to defaults.
 
-**modelUseCountProvider** (`ModelUseCountProvider`): Provides per-model use counts for sorting and display in \`listAvailableModels()\`.
+**modelUseCountProvider** (`ModelUseCountProvider`): Provides per-model use counts for sorting and display in listAvailableModels().
 
-**modelUseCountTracker** (`ModelUseCountTracker`): Callback invoked when a model is selected via \`session.model.switch()\`. Use to track and persist model usage for ranking.
+**modelUseCountTracker** (`ModelUseCountTracker`): Callback invoked when a model is selected via session.model.switch(). Use to track and persist model usage for ranking.
 
-**customModelCatalogProvider** (`CustomModelCatalogProvider`): Catalog hook for additional models (e.g., user-defined custom providers). Returned entries are merged into \`listAvailableModels()\`.
+**customModelCatalogProvider** (`CustomModelCatalogProvider`): Catalog hook for additional models (e.g., user-defined custom providers). Returned entries are merged into listAvailableModels().
 
-**gateways** (`MastraModelGatewayInterface[]`): Model gateways registered on the internal Mastra instance. Apps that need gateway-backed model resolution should also provide \`resolveModel\`.
+**gateways** (`MastraModelGatewayInterface[]`): Model gateways registered on the internal Mastra instance. Apps that need gateway-backed model resolution should also provide resolveModel.
 
-**toolCategoryResolver** (`(toolName: string) => ToolCategory | null`): Maps tool names to permission categories (\`'read'\`, \`'edit'\`, \`'execute'\`, \`'mcp'\`, \`'other'\`). Used by the permission system to resolve category-level policies.
+**toolCategoryResolver** (`(toolName: string) => ToolCategory | null`): Maps tool names to permission categories ('read', 'edit', 'execute', 'mcp', 'other'). Used by the permission system to resolve category-level policies.
 
 **pubsub** (`PubSub`): PubSub instance used by the internal Mastra instance and mode agents for event coordination.
 
-**threadLock** (`{ acquire, release }`): Thread locking callbacks to prevent concurrent access from multiple processes. \`acquire\` should throw if the lock is held.
+**threadLock** (`{ acquire, release }`): Thread locking callbacks to prevent concurrent access from multiple processes. acquire should throw if the lock is held.
 
 **observability** (`ObservabilityEntrypoint`): Observability entrypoint for tracing, scoring, and feedback. When provided, the internal Mastra instance produces trace spans for agent runs.