@mastra/mcp-docs-server 1.2.7-alpha.1 → 1.2.7-alpha.12

package/.docs/models/providers/unorouter.md

@@ -0,0 +1,95 @@
+> Discover all available pages from the documentation index: https://mastra.ai/llms.txt
+
+# ![UnoRouter logo](https://models.dev/logos/unorouter.svg)UnoRouter
+
+Access 23 UnoRouter models through Mastra's model router. Authentication is handled automatically using the `UNOROUTER_API_KEY` environment variable.
+
+Learn more in the [UnoRouter documentation](https://unorouter.com/models).
+
+```bash
+UNOROUTER_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: "unorouter/claude-haiku-4-5-20251001"
+});
+
+// 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 [UnoRouter documentation](https://unorouter.com/models) for details.
+
+## Models
+
+| Model                                       | Context | Tools | Reasoning | Image | Audio | Video | Input $/1M | Output $/1M |
+| ------------------------------------------- | ------- | ----- | --------- | ----- | ----- | ----- | ---------- | ----------- |
+| `unorouter/claude-haiku-4-5-20251001`       | 200K    |       |           |       |       |       | $1         | $6          |
+| `unorouter/claude-opus-4-8`                 | 1.0M    |       |           |       |       |       | $0.42      | $2          |
+| `unorouter/claude-sonnet-5`                 | 1.0M    |       |           |       |       |       | $1         | $7          |
+| `unorouter/deepseek-v4-flash`               | 1.0M    |       |           |       |       |       | $0.06      | $0.13       |
+| `unorouter/deepseek-v4-flash:free`          | 1.0M    |       |           |       |       |       | —          | —           |
+| `unorouter/deepseek-v4-pro`                 | 1.0M    |       |           |       |       |       | $0.90      | $2          |
+| `unorouter/deepseek-v4-pro:free`            | 1.0M    |       |           |       |       |       | —          | —           |
+| `unorouter/gemini-3.5-flash`                | 1.0M    |       |           |       |       |       | $0.19      | $1          |
+| `unorouter/gemma-4-31b-it:free`             | 262K    |       |           |       |       |       | —          | —           |
+| `unorouter/glm-4.5-flash:free`              | 131K    |       |           |       |       |       | —          | —           |
+| `unorouter/glm-5.2`                         | 1.0M    |       |           |       |       |       | $2         | $5          |
+| `unorouter/glm-5.2:free`                    | 1.0M    |       |           |       |       |       | —          | —           |
+| `unorouter/gpt-5.2`                         | 400K    |       |           |       |       |       | $1         | $8          |
+| `unorouter/gpt-5.4`                         | 1.1M    |       |           |       |       |       | $2         | $11         |
+| `unorouter/gpt-5.4:free`                    | 1.1M    |       |           |       |       |       | —          | —           |
+| `unorouter/gpt-5.5`                         | 1.1M    |       |           |       |       |       | $0.19      | $1          |
+| `unorouter/gpt-5.5:free`                    | 1.1M    |       |           |       |       |       | —          | —           |
+| `unorouter/kimi-k2.6`                       | 262K    |       |           |       |       |       | $1         | $5          |
+| `unorouter/minimax-m2.7`                    | 205K    |       |           |       |       |       | $0.82      | $3          |
+| `unorouter/minimax-m2.7:free`               | 205K    |       |           |       |       |       | —          | —           |
+| `unorouter/nemotron-3-ultra-550b-a55b:free` | 1.0M    |       |           |       |       |       | —          | —           |
+| `unorouter/qwen3.5-397b-a17b:free`          | 262K    |       |           |       |       |       | —          | —           |
+| `unorouter/step-3.7-flash:free`             | 256K    |       |           |       |       |       | —          | —           |
+
+## Advanced configuration
+
+### Custom headers
+
+```typescript
+const agent = new Agent({
+  id: "custom-agent",
+  name: "custom-agent",
+  model: {
+    url: "https://api.unorouter.com/v1",
+    id: "unorouter/claude-haiku-4-5-20251001",
+    apiKey: process.env.UNOROUTER_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
+      ? "unorouter/step-3.7-flash:free"
+      : "unorouter/claude-haiku-4-5-20251001";
+  }
+});
+```

package/.docs/models/providers/wandb.md

@@ -2,7 +2,7 @@
 
 # ![Weights & Biases logo](https://models.dev/logos/wandb.svg)Weights & Biases
 
-Access 18 Weights & Biases models through Mastra's model router. Authentication is handled automatically using the `WANDB_API_KEY` environment variable.
+Access 25 Weights & Biases models through Mastra's model router. Authentication is handled automatically using the `WANDB_API_KEY` environment variable.
 
 Learn more in the [Weights & Biases documentation](https://docs.wandb.ai).
 
@@ -17,7 +17,7 @@ const agent = new Agent({
   id: "my-agent",
   name: "My Agent",
   instructions: "You are a helpful assistant",
-  model: "wandb/MiniMaxAI/MiniMax-M2.5"
+  model: "wandb/JetBrains/Mellum2-12B-A2.5B-Instruct"
 });
 
 // Generate a response
@@ -37,23 +37,30 @@ for await (const chunk of stream) {
 | Model                                                | Context | Tools | Reasoning | Image | Audio | Video | Input $/1M | Output $/1M |
 | ---------------------------------------------------- | ------- | ----- | --------- | ----- | ----- | ----- | ---------- | ----------- |
 | `wandb/deepseek-ai/DeepSeek-V3.1`                    | 161K    |       |           |       |       |       | $0.55      | $2          |
+| `wandb/deepseek-ai/DeepSeek-V4-Flash`                | 1.0M    |       |           |       |       |       | $0.14      | $0.28       |
+| `wandb/deepseek-ai/DeepSeek-V4-Pro`                  | 1.0M    |       |           |       |       |       | $2         | $3          |
+| `wandb/google/gemma-4-31B-it`                        | 262K    |       |           |       |       |       | $0.12      | $0.35       |
+| `wandb/ibm-granite/granite-4.1-8b`                   | 131K    |       |           |       |       |       | $0.05      | $0.10       |
+| `wandb/JetBrains/Mellum2-12B-A2.5B-Instruct`         | 131K    |       |           |       |       |       | $0.05      | $0.10       |
 | `wandb/meta-llama/Llama-3.1-70B-Instruct`            | 128K    |       |           |       |       |       | $0.80      | $0.80       |
 | `wandb/meta-llama/Llama-3.1-8B-Instruct`             | 128K    |       |           |       |       |       | $0.22      | $0.22       |
 | `wandb/meta-llama/Llama-3.3-70B-Instruct`            | 128K    |       |           |       |       |       | $0.71      | $0.71       |
-| `wandb/meta-llama/Llama-4-Scout-17B-16E-Instruct`    | 64K     |       |           |       |       |       | $0.17      | $0.66       |
-| `wandb/microsoft/Phi-4-mini-instruct`                | 128K    |       |           |       |       |       | $0.08      | $0.35       |
 | `wandb/MiniMaxAI/MiniMax-M2.5`                       | 197K    |       |           |       |       |       | $0.30      | $1          |
-| `wandb/moonshotai/Kimi-K2.5`                         | 262K    |       |           |       |       |       | $0.50      | $3          |
+| `wandb/moonshotai/Kimi-K2.5`                         | 262K    |       |           |       |       |       | $0.60      | $3          |
+| `wandb/moonshotai/Kimi-K2.6`                         | 262K    |       |           |       |       |       | $0.95      | $4          |
+| `wandb/moonshotai/Kimi-K2.7-Code`                    | 262K    |       |           |       |       |       | $0.94      | $4          |
 | `wandb/nvidia/NVIDIA-Nemotron-3-Super-120B-A12B-FP8` | 262K    |       |           |       |       |       | $0.20      | $0.80       |
-| `wandb/openai/gpt-oss-120b`                          | 131K    |       |           |       |       |       | $0.15      | $0.60       |
-| `wandb/openai/gpt-oss-20b`                           | 131K    |       |           |       |       |       | $0.05      | $0.20       |
+| `wandb/nvidia/NVIDIA-Nemotron-3-Ultra-550B-A55B`     | 262K    |       |           |       |       |       | $0.75      | $3          |
+| `wandb/openai/gpt-oss-120b`                          | 131K    |       |           |       |       |       | $0.04      | $0.14       |
+| `wandb/openai/gpt-oss-20b`                           | 131K    |       |           |       |       |       | $0.03      | $0.13       |
 | `wandb/OpenPipe/Qwen3-14B-Instruct`                  | 33K     |       |           |       |       |       | $0.05      | $0.22       |
-| `wandb/Qwen/Qwen3-235B-A22B-Instruct-2507`           | 262K    |       |           |       |       |       | $0.10      | $0.10       |
-| `wandb/Qwen/Qwen3-235B-A22B-Thinking-2507`           | 262K    |       |           |       |       |       | $0.10      | $0.10       |
 | `wandb/Qwen/Qwen3-30B-A3B-Instruct-2507`             | 262K    |       |           |       |       |       | $0.10      | $0.30       |
 | `wandb/Qwen/Qwen3-Coder-480B-A35B-Instruct`          | 262K    |       |           |       |       |       | $1         | $2          |
-| `wandb/zai-org/GLM-5-FP8`                            | 200K    |       |           |       |       |       | $1         | $3          |
-| `wandb/zai-org/GLM-5.1`                              | 200K    |       |           |       |       |       | $1         | $4          |
+| `wandb/Qwen/Qwen3.5-35B-A3B`                         | 262K    |       |           |       |       |       | $0.25      | $1          |
+| `wandb/Qwen/Qwen3.6-27B`                             | 262K    |       |           |       |       |       | $0.60      | $4          |
+| `wandb/Qwen/Qwen3.6-35B-A3B`                         | 262K    |       |           |       |       |       | $0.25      | $1          |
+| `wandb/zai-org/GLM-5.1`                              | 203K    |       |           |       |       |       | $1         | $4          |
+| `wandb/zai-org/GLM-5.2`                              | 262K    |       |           |       |       |       | $1         | $4          |
 
 ## Advanced configuration
 
@@ -65,7 +72,7 @@ const agent = new Agent({
   name: "custom-agent",
   model: {
     url: "https://api.inference.wandb.ai/v1",
-    id: "wandb/MiniMaxAI/MiniMax-M2.5",
+    id: "wandb/JetBrains/Mellum2-12B-A2.5B-Instruct",
     apiKey: process.env.WANDB_API_KEY,
     headers: {
       "X-Custom-Header": "value"
@@ -83,8 +90,8 @@ const agent = new Agent({
   model: ({ requestContext }) => {
     const useAdvanced = requestContext.task === "complex";
     return useAdvanced
-      ? "wandb/zai-org/GLM-5.1"
-      : "wandb/MiniMaxAI/MiniMax-M2.5";
+      ? "wandb/zai-org/GLM-5.2"
+      : "wandb/JetBrains/Mellum2-12B-A2.5B-Instruct";
   }
 });
 ```

package/.docs/models/providers/xai.md

@@ -2,7 +2,7 @@
 
 # ![xAI logo](https://models.dev/logos/xai.svg)xAI
 
-Access 8 xAI models through Mastra's model router. Authentication is handled automatically using the `XAI_API_KEY` environment variable.
+Access 9 xAI models through Mastra's model router. Authentication is handled automatically using the `XAI_API_KEY` environment variable.
 
 Learn more in the [xAI documentation](https://docs.x.ai/docs/models).
 
@@ -38,6 +38,7 @@ for await (const chunk of stream) {
 | `xai/grok-4.20-0309-reasoning`     | 1.0M    |       |           |       |       |       | $1         | $3          |
 | `xai/grok-4.20-multi-agent-0309`   | 1.0M    |       |           |       |       |       | $1         | $3          |
 | `xai/grok-4.3`                     | 1.0M    |       |           |       |       |       | $1         | $3          |
+| `xai/grok-4.5`                     | 500K    |       |           |       |       |       | $2         | $6          |
 | `xai/grok-build-0.1`               | 256K    |       |           |       |       |       | $1         | $2          |
 | `xai/grok-imagine-image`           | 8K      |       |           |       |       |       | —          | —           |
 | `xai/grok-imagine-image-quality`   | 8K      |       |           |       |       |       | —          | —           |

package/.docs/models/providers/zenifra.md

@@ -0,0 +1,73 @@
+> Discover all available pages from the documentation index: https://mastra.ai/llms.txt
+
+# ![Zenifra logo](https://models.dev/logos/zenifra.svg)Zenifra
+
+Access 1 Zenifra model through Mastra's model router. Authentication is handled automatically using the `ZENIFRA_AI_KEY` environment variable.
+
+Learn more in the [Zenifra documentation](https://docs.zenifra.com).
+
+```bash
+ZENIFRA_AI_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: "zenifra/alibaba/qwen3.6-35b-a3b"
+});
+
+// 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 [Zenifra documentation](https://docs.zenifra.com) for details.
+
+## Models
+
+| Model                             | Context | Tools | Reasoning | Image | Audio | Video | Input $/1M | Output $/1M |
+| --------------------------------- | ------- | ----- | --------- | ----- | ----- | ----- | ---------- | ----------- |
+| `zenifra/alibaba/qwen3.6-35b-a3b` | 262K    |       |           |       |       |       | $0.19      | $0.48       |
+
+## Advanced configuration
+
+### Custom headers
+
+```typescript
+const agent = new Agent({
+  id: "custom-agent",
+  name: "custom-agent",
+  model: {
+    url: "https://ai.zenifra.com/v1",
+    id: "zenifra/alibaba/qwen3.6-35b-a3b",
+    apiKey: process.env.ZENIFRA_AI_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
+      ? "zenifra/alibaba/qwen3.6-35b-a3b"
+      : "zenifra/alibaba/qwen3.6-35b-a3b";
+  }
+});
+```

package/.docs/models/providers.md

@@ -35,11 +35,13 @@ Direct access to individual AI model providers. Each provider offers unique mode
 - [Cloudflare Workers AI](https://mastra.ai/models/providers/cloudflare-workers-ai)
 - [Cortecs](https://mastra.ai/models/providers/cortecs)
 - [CrofAI](https://mastra.ai/models/providers/crof)
+- [CrossModel](https://mastra.ai/models/providers/crossmodel)
 - [D.Run (China)](https://mastra.ai/models/providers/drun)
 - [Databricks](https://mastra.ai/models/providers/databricks)
 - [Deep Infra](https://mastra.ai/models/providers/deepinfra)
 - [DigitalOcean](https://mastra.ai/models/providers/digitalocean)
 - [DInference](https://mastra.ai/models/providers/dinference)
+- [EmpirioLabs AI](https://mastra.ai/models/providers/empiriolabs)
 - [evroc](https://mastra.ai/models/providers/evroc)
 - [FastRouter](https://mastra.ai/models/providers/fastrouter)
 - [Fireworks AI](https://mastra.ai/models/providers/fireworks-ai)
@@ -69,12 +71,14 @@ Direct access to individual AI model providers. Each provider offers unique mode
 - [LongCat](https://mastra.ai/models/providers/longcat)
 - [LucidQuery](https://mastra.ai/models/providers/lucidquery)
 - [Meganova](https://mastra.ai/models/providers/meganova)
+- [Meta](https://mastra.ai/models/providers/meta)
 - [MiniMax (minimax.io)](https://mastra.ai/models/providers/minimax)
 - [MiniMax (minimaxi.com)](https://mastra.ai/models/providers/minimax-cn)
 - [MiniMax Token Plan (minimax.io)](https://mastra.ai/models/providers/minimax-coding-plan)
 - [MiniMax Token Plan (minimaxi.com)](https://mastra.ai/models/providers/minimax-cn-coding-plan)
 - [Mixlayer](https://mastra.ai/models/providers/mixlayer)
 - [Moark](https://mastra.ai/models/providers/moark)
+- [Model Oracle AI](https://mastra.ai/models/providers/model-oracle-ai)
 - [ModelScope](https://mastra.ai/models/providers/modelscope)
 - [Moonshot AI](https://mastra.ai/models/providers/moonshotai)
 - [Moonshot AI (China)](https://mastra.ai/models/providers/moonshotai-cn)
@@ -94,6 +98,7 @@ Direct access to individual AI model providers. Each provider offers unique mode
 - [OVHcloud AI Endpoints](https://mastra.ai/models/providers/ovhcloud)
 - [Perplexity](https://mastra.ai/models/providers/perplexity)
 - [Perplexity Agent](https://mastra.ai/models/providers/perplexity-agent)
+- [Pioneer](https://mastra.ai/models/providers/pioneer)
 - [Poe](https://mastra.ai/models/providers/poe)
 - [Poolside](https://mastra.ai/models/providers/poolside)
 - [Privatemode AI](https://mastra.ai/models/providers/privatemode-ai)
@@ -123,6 +128,7 @@ Direct access to individual AI model providers. Each provider offers unique mode
 - [TrustedRouter](https://mastra.ai/models/providers/trustedrouter)
 - [Umans AI](https://mastra.ai/models/providers/umans-ai)
 - [Umans AI Coding Plan](https://mastra.ai/models/providers/umans-ai-coding-plan)
+- [UnoRouter](https://mastra.ai/models/providers/unorouter)
 - [Upstage](https://mastra.ai/models/providers/upstage)
 - [Vivgrid](https://mastra.ai/models/providers/vivgrid)
 - [Vultr](https://mastra.ai/models/providers/vultr)
@@ -136,6 +142,7 @@ Direct access to individual AI model providers. Each provider offers unique mode
 - [Z.AI](https://mastra.ai/models/providers/zai)
 - [Z.AI Coding Plan](https://mastra.ai/models/providers/zai-coding-plan)
 - [Zeldoc](https://mastra.ai/models/providers/zeldoc)
+- [Zenifra](https://mastra.ai/models/providers/zenifra)
 - [ZenMux](https://mastra.ai/models/providers/zenmux)
 - [Zhipu AI](https://mastra.ai/models/providers/zhipuai)
 - [Zhipu AI Coding Plan](https://mastra.ai/models/providers/zhipuai-coding-plan)

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

@@ -174,7 +174,7 @@ await agentController.init()
 
 Create a new, fully-wired `Session` and bring it online. The session starts in the default mode with the seeded model, connects to the AgentController's shared machinery (agent, storage/lock, config catalog), and has a current thread (the most recent thread for the resource, or a freshly created one). Call `init()` once before creating sessions so shared storage is ready.
 
-The AgentController owns no session of its own — every consumer creates its own session and drives all work through it. In a server or multiplayer setting, each request, thread, or user gets its own session, isolated from every other: independent event bus, mode, model, state, and current thread.
+The AgentController owns no session of its own — every consumer creates its own session and drives all work through it. A `resourceId` maps to exactly one session per AgentController (get-or-create): calling `createSession` with the same `resourceId` returns the existing session, so reconnects resume rather than fork the conversation. Different `resourceId`s produce independent sessions with isolated event bus, mode, model, state, and current thread. Use `session.thread.create()` and `session.thread.switch()` to manage multiple conversations within one session.
 
 `id` and `ownerId` are required — they mirror `SessionRecord.id` and `SessionRecord.ownerId` and are stable for the life of the session. `resourceId` is optional and defaults to `config.resourceId` then `config.id`.
 
@@ -270,7 +270,7 @@ const mastra = agentController.getMastra()
 
 #### `getWorkspace()`
 
-Return the AgentController-level workspace if it is a static `Workspace` instance. Dynamic factory workspaces are not resolved here — use [`resolveWorkspace()`](#resolveworkspace-session-requestcontext-) to resolve a factory against a session's request context.
+Return the AgentController-level workspace if it's a static `Workspace` instance. Dynamic factory workspaces aren't resolved here — use [`resolveWorkspace()`](#resolveworkspace-session-requestcontext-) to resolve a factory against a session's request context.
 
 ```typescript
 const workspace = agentController.getWorkspace()
@@ -478,7 +478,7 @@ Responding to a pending tool approval is owned by the session — see [`session.
 
 Respond to a pending tool suspension. Interactive built-in tools such as `ask_user` and `request_access` pause through the native tool-suspension primitive, which emits a `tool_suspended` event carrying `toolCallId`, `toolName`, and `suspendPayload`. Pass `resumeData` to resume the suspended tool with the user's response.
 
-Provide `toolCallId` to select which suspension to resume. It is required when more than one tool is suspended at the same time (for example, parallel `ask_user` calls). When omitted, it resolves to the sole pending suspension.
+Provide `toolCallId` to select which suspension to resume. It's required when more than one tool is suspended at the same time (for example, parallel `ask_user` calls). When omitted, it resolves to the sole pending suspension.
 
 ```typescript
 agentController.subscribe(event => {

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

@@ -4,7 +4,7 @@
 
 > **Beta:** The `AgentController` feature is in beta stage and subject to breaking changes in minor versions until it graduates from its beta status.
 
-A `Session` owns all the state tied to a single conversation. The [`AgentController`](https://mastra.ai/reference/agent-controller/agent-controller-class) is the shared host — agents, storage, config, the thread lock, and the event bus — while the `Session` holds everything that is per-conversation: identity, the active thread binding and reads, mode and model selection, run and abort state, the live agent stream, tool suspensions, follow-ups, approvals, permission grants, token usage, and the display-state snapshot.
+A `Session` owns all the state tied to a single conversation. The [`AgentController`](https://mastra.ai/reference/agent-controller/agent-controller-class) is the shared host — agents, storage, config, the thread lock, and the event bus — while the `Session` holds everything that's per-conversation: identity, the active thread binding and reads, mode and model selection, run and abort state, the live agent stream, tool suspensions, follow-ups, approvals, permission grants, token usage, and the display-state snapshot.
 
 Access the session through `agentController.session`.
 
@@ -129,7 +129,7 @@ const usage = agentController.session.getTokenUsage()
 
 ## Identity
 
-`session.identity` owns the stable identifiers for the conversation: the resource ID, a session `id`, and an `ownerId`. The `id` and `ownerId` are stable for the life of the session and do not change when the resource ID is switched. They mirror the `id` and `ownerId` fields on `SessionRecord` in storage.
+`session.identity` owns the stable identifiers for the conversation: the resource ID, a session `id`, and an `ownerId`. The `id` and `ownerId` are stable for the life of the session and don't change when the resource ID is switched. They mirror the `id` and `ownerId` fields on `SessionRecord` in storage.
 
 ### `session.identity.getId()`
 
@@ -163,7 +163,7 @@ Return the resource ID the session was created with.
 const defaultResourceId = agentController.session.identity.getDefaultResourceId()
 ```
 
-To change the resource ID, use [`agentController.setResourceId()`](https://mastra.ai/reference/agent-controller/agent-controller-class), which also tears down the active thread. The session `id` and `ownerId` are not affected by resource switches.
+To change the resource ID, use [`agentController.setResourceId()`](https://mastra.ai/reference/agent-controller/agent-controller-class), which also tears down the active thread. The session `id` and `ownerId` aren't affected by resource switches.
 
 ## Thread
 
@@ -534,7 +534,7 @@ const displayState = agentController.session.displayState.get()
 
 ### `session.displayState.restoreTasks(tasks)`
 
-Restore the task portion of the snapshot after a UI replays persisted task tool history. This is a pure update of the snapshot and does not emit an event, so re-render explicitly after calling it.
+Restore the task portion of the snapshot after a UI replays persisted task tool history. This is a pure update of the snapshot and doesn't emit an event, so re-render explicitly after calling it.
 
 ```typescript
 agentController.session.displayState.restoreTasks(replayedTasks)

package/.docs/reference/agents/agent.md

@@ -481,7 +481,7 @@ Returns an `AgentThreadSubscription` object with these members:
 
 ## `generate()` memory options
 
-Pass `memory` when you call `agent.generate()` to choose which conversation thread the run should read from and write to. The common shape is `memory: { resource: string, thread: string }`, where `resource` identifies the owner and `thread` identifies the conversation. See [Threads and resources](https://mastra.ai/docs/memory/storage) for the concept model.
+Pass `memory` when you call `agent.generate()` to choose which conversation thread the run should read from and write to. The common shape is `memory: { resource: string, thread: string }`, where `resource` identifies the owner and `thread` identifies the conversation. See [Threads and resources](https://mastra.ai/docs/memory/message-history) for the concept model.
 
 ```typescript
 const response = await agent.generate('What did we decide about retries?', {

package/.docs/reference/agents/channels.md

@@ -4,7 +4,7 @@
 
 **Added in:** `@mastra/core@1.22.0`
 
-Channels connect agents to messaging platforms. Configure them via the `channels` property on the `Agent` constructor. The object you pass is a `ChannelConfig`. See the [Channels guide](https://mastra.ai/docs/agents/channels) for concepts and platform setup instructions.
+Channels connect agents to messaging platforms. Configure them via the `channels` property on the `Agent` constructor. The object you pass is a `ChannelConfig`. See the [Channels overview](https://mastra.ai/docs/capabilities/channels/overview) for concepts and platform setup instructions.
 
 ## Usage example
 
@@ -291,6 +291,6 @@ type InlineLinkEntry =
 
 ## Related
 
-- [Channels guide](https://mastra.ai/docs/agents/channels): Concepts, quickstart, and platform setup
+- [Channels overview](https://mastra.ai/docs/capabilities/channels/overview): Concepts, quickstart, and platform setup
 - [Agent class](https://mastra.ai/reference/agents/agent): Constructor parameters and methods
 - [Chat SDK adapters](https://chat-sdk.dev/adapters): Adapter configuration and platform setup

package/.docs/reference/agents/inngest-agent.md

@@ -165,7 +165,7 @@ const { output, cleanup } = await durableAgent.observe(runId, {
 await output.text
 ```
 
-The result from `observe()` does not include `threadId` or `resourceId`.
+The result from `observe()` doesn't include `threadId` or `resourceId`.
 
 Returns: `Promise<Omit<InngestAgentStreamResult, 'threadId' | 'resourceId'>>`
 

package/.docs/reference/agents/listSkills.md

@@ -46,7 +46,7 @@ interface SkillMetadata {
 
 ## Merging behavior
 
-When both agent-level skills and workspace skills are configured, `.listSkills()` returns the merged set. Agent-level skills take precedence on name conflicts — if both define a skill named `code-review`, only the agent-level version appears in the result.
+When both agent-level skills and workspace skills are configured, `.listSkills()` returns the merged set. Agent-level skills take precedence on name conflicts — if both define a skill named `code-review`, only the agent-level version is returned.
 
 ## Related
 

package/.docs/reference/agents/listSuspendedRuns.md

@@ -83,11 +83,11 @@ interface AgentRunToolCall {
 
 ## Discovery scope
 
-Results are scoped to runs started by the agent you call `listSuspendedRuns()` on: snapshots persist the owning agent's id, so runs started by other agents on the same Mastra instance are not returned. In [supervisor setups](https://mastra.ai/docs/agents/agent-approval) the supervisor sees its outer run — the one to resume — while a subagent's inner run is only visible from the subagent itself. Filter by `threadId` and `resourceId` to scope results to one conversation.
+Results are scoped to runs started by the agent you call `listSuspendedRuns()` on: snapshots persist the owning agent's id, so runs started by other agents on the same Mastra instance aren't returned. In [supervisor setups](https://mastra.ai/docs/agents/agent-approval) the supervisor sees its outer run — the one to resume — while a subagent's inner run is only visible from the subagent itself. Filter by `threadId` and `resourceId` to scope results to one conversation.
 
-Run snapshots are only persisted while a run is waiting on input and are deleted when it finishes, so suspended runs are the only runs discoverable from storage. Suspended runs only survive restarts when the Mastra instance has a persistent [storage provider](https://mastra.ai/docs/memory/storage) configured. With the default in-memory store, snapshots are lost on restart.
+Run snapshots are only persisted while a run is waiting on input and are deleted when it finishes, so suspended runs are the only runs discoverable from storage. Suspended runs only survive restarts when the Mastra instance has a persistent [storage provider](https://mastra.ai/docs/storage/overview) configured. With the default in-memory store, snapshots are lost on restart.
 
 ## Related
 
 - [Agent approval](https://mastra.ai/docs/agents/agent-approval)
-- [Storage](https://mastra.ai/docs/memory/storage)
+- [Storage](https://mastra.ai/docs/storage/overview)

package/.docs/reference/auth/google.md

@@ -75,7 +75,7 @@ The following environment variables are automatically used when constructor opti
 1. **Session cookie**: When SSO is enabled, reads the encrypted session cookie and decrypts it. If the session is valid and not expired, the user is authenticated.
 2. **Google ID token fallback**: If no valid session cookie is present, verifies the `Authorization` header token against Google's JWKS endpoint.
 
-After authentication, `authorizeUser` checks that the user has a valid Google user ID, the token-derived expiration has not passed, and the user's verified `hd` claim matches `allowedDomains` when domains are configured.
+After authentication, `authorizeUser` checks that the user has a valid Google user ID, the token-derived expiration hasn't passed, and the user's verified `hd` claim matches `allowedDomains` when domains are configured.
 
 ### Authentication methods
 
@@ -101,7 +101,7 @@ Returns: `Promise<GoogleUser | null>`
 
 #### `authorizeUser(user)`
 
-Returns `true` when the user has an ID, has not expired, and matches `allowedDomains` when domains are configured.
+Returns `true` when the user has an ID, hasn't expired, and matches `allowedDomains` when domains are configured.
 
 ```typescript
 const allowed = auth.authorizeUser(user)
@@ -111,7 +111,7 @@ Returns: `boolean`
 
 #### `getUser(userId)`
 
-Returns `null`. Google ID tokens are verified directly, so this provider does not perform user lookup by ID.
+Returns `null`. Google ID tokens are verified directly, so this provider doesn't perform user lookup by ID.
 
 ```typescript
 const user = await auth.getUser(userId)
@@ -348,9 +348,9 @@ Returns: `{ size: number; maxSize: number }`
 
 `MastraRBACGoogle` uses `GET https://admin.googleapis.com/admin/directory/v1/groups?userKey=...` and handles pagination. Provide a service account with domain-wide delegation for production Google Workspace deployments, or pass `accessToken` / `getAccessToken` if your application already manages Google API tokens.
 
-If `user.groups` is already an array, `MastraRBACGoogle` uses that value and does not call the Directory API. An empty `groups` array means the user has no Google group roles and resolves to `_default` permissions when `_default` is configured.
+If `user.groups` is already an array, `MastraRBACGoogle` uses that value and doesn't call the Directory API. An empty `groups` array means the user has no Google group roles and resolves to `_default` permissions when `_default` is configured.
 
-`MastraRBACGoogle` does not automatically read service-account environment variables. Pass service-account credentials through the `serviceAccount` option, or pass `accessToken` / `getAccessToken`.
+`MastraRBACGoogle` doesn't automatically read service-account environment variables. Pass service-account credentials through the `serviceAccount` option, or pass `accessToken` / `getAccessToken`.
 
 ## Related
 

package/.docs/reference/channels/channel-provider.md

@@ -64,4 +64,4 @@ const all = mastra.getChannelProviders()
 ## Related
 
 - [SlackProvider](https://mastra.ai/reference/channels/slack-provider)
-- [Channels](https://mastra.ai/docs/agents/channels)
+- [Channels](https://mastra.ai/docs/capabilities/channels/overview)

package/.docs/reference/channels/slack-provider.md

@@ -2,7 +2,7 @@
 
 # SlackProvider
 
-`SlackProvider` is the managed path for connecting agents to Slack. Register it on `Mastra.channels` and it provisions Slack apps via the Manifest API, runs the OAuth install flow, rotates configuration tokens, and routes Slack events to your agents. Use it when you want Mastra to own app creation and installation. For the lower-level path where you create the Slack app and configure scopes and webhooks yourself, use [`createSlackAdapter`](https://mastra.ai/docs/agents/channels) on the agent's `channels.adapters` instead.
+`SlackProvider` is the managed path for connecting agents to Slack. Register it on `Mastra.channels` and it provisions Slack apps via the Manifest API, runs the OAuth install flow, rotates configuration tokens, and routes Slack events to your agents. Use it when you want Mastra to own app creation and installation. For the lower-level path where you create the Slack app and configure scopes and webhooks yourself, use [`createSlackAdapter`](https://mastra.ai/docs/capabilities/channels/slack) on the agent's `channels.adapters` instead.
 
 ## Usage example
 
@@ -171,7 +171,7 @@ slack.setBaseUrl('https://abc123.trycloudflare.com')
 
 #### `initialize()`
 
-Recreates a `SlackAdapter` for each active installation in storage and injects `AgentChannels` into the corresponding agent so it receives Slack events on startup. Does not auto-provision new apps; use `connect()` to create one. Mastra calls this automatically, so you rarely call it directly.
+Recreates a `SlackAdapter` for each active installation in storage and injects `AgentChannels` into the corresponding agent so it receives Slack events on startup. Doesn't auto-provision new apps; use `connect()` to create one. Mastra calls this automatically, so you rarely call it directly.
 
 ```typescript
 await slack.initialize()
@@ -224,5 +224,5 @@ const result = await slack.connect('support-agent')
 ## Related
 
 - [ChannelProvider](https://mastra.ai/reference/channels/channel-provider): the interface `SlackProvider` implements
-- [Channels](https://mastra.ai/docs/agents/channels): concepts, platform setup, and the `createSlackAdapter` path
+- [Channels](https://mastra.ai/docs/capabilities/channels/overview): concepts, platform setup, and the `createSlackAdapter` path
 - [Channels reference](https://mastra.ai/reference/agents/channels): the `channels` config on the `Agent` constructor