npm - @mastra/mcp-docs-server - Versions diffs - 1.2.16-alpha.1 → 1.2.16-alpha.4 - Mend

@mastra/mcp-docs-server 1.2.16-alpha.1 → 1.2.16-alpha.4

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (148) hide show

package/.docs/models/providers/nano-gpt.md CHANGED Viewed

@@ -2,7 +2,7 @@
 # ![NanoGPT logo](https://models.dev/logos/nano-gpt.svg)NanoGPT
-Access 622 NanoGPT models through Mastra's model router. Authentication is handled automatically using the `NANO_GPT_API_KEY` environment variable.
+Access 599 NanoGPT models through Mastra's model router. Authentication is handled automatically using the `NANO_GPT_API_KEY` environment variable.
 Learn more in the [NanoGPT documentation](https://docs.nano-gpt.com).
@@ -88,6 +88,8 @@ for await (const chunk of stream) {
 | `nano-gpt/brave`                                                 | 8K      |       |           |       |       |       | $5         | $5          |
 | `nano-gpt/brave-pro`                                             | 8K      |       |           |       |       |       | $5         | $5          |
 | `nano-gpt/brave-research`                                        | 16K     |       |           |       |       |       | $5         | $5          |
+| `nano-gpt/bytedance-seed/seed-2-1-turbo`                         | 262K    |       |           |       |       |       | $0.50      | $3          |
+| `nano-gpt/bytedance-seed/seed-2.0-code`                          | 262K    |       |           |       |       |       | $0.50      | $3          |
 | `nano-gpt/bytedance-seed/seed-2.0-lite`                          | 262K    |       |           |       |       |       | $0.25      | $2          |
 | `nano-gpt/bytedance/doubao-seed-2.1-pro`                         | 256K    |       |           |       |       |       | $1         | $5          |
 | `nano-gpt/bytedance/doubao-seed-2.1-turbo`                       | 256K    |       |           |       |       |       | $0.50      | $3          |
@@ -143,7 +145,7 @@ for await (const chunk of stream) {
 | `nano-gpt/deepseek-reasoner`                                     | 64K     |       |           |       |       |       | $0.40      | $2          |
 | `nano-gpt/deepseek-reasoner-cheaper`                             | 128K    |       |           |       |       |       | $0.40      | $2          |
 | `nano-gpt/deepseek-v3-0324`                                      | 128K    |       |           |       |       |       | $0.20      | $0.77       |
-| `nano-gpt/deepseek/deepseek-latest`                              | 1.0M    |       |           |       |       |       | $1         | $2          |
+| `nano-gpt/deepseek/deepseek-latest`                              | 1.0M    |       |           |       |       |       | $0.43      | $0.87       |
 | `nano-gpt/deepseek/deepseek-prover-v2-671b`                      | 160K    |       |           |       |       |       | $1         | $3          |
 | `nano-gpt/deepseek/deepseek-v3.2`                                | 163K    |       |           |       |       |       | $0.28      | $0.42       |
 | `nano-gpt/deepseek/deepseek-v3.2:thinking`                       | 163K    |       |           |       |       |       | $0.28      | $0.42       |
@@ -155,6 +157,8 @@ for await (const chunk of stream) {
 | `nano-gpt/deepseek/deepseek-v4-flash-latest`                     | 1.0M    |       |           |       |       |       | $0.14      | $0.28       |
 | `nano-gpt/deepseek/deepseek-v4-flash:thinking`                   | 1.0M    |       |           |       |       |       | $0.07      | $0.14       |
 | `nano-gpt/deepseek/deepseek-v4-pro`                              | 1.0M    |       |           |       |       |       | $1         | $2          |
+| `nano-gpt/deepseek/deepseek-v4-pro-0813`                         | 1.0M    |       |           |       |       |       | $0.43      | $0.87       |
+| `nano-gpt/deepseek/deepseek-v4-pro-0813:thinking`                | 1.0M    |       |           |       |       |       | $0.43      | $0.87       |
 | `nano-gpt/deepseek/deepseek-v4-pro-cheaper`                      | 1.0M    |       |           |       |       |       | $0.43      | $0.87       |
 | `nano-gpt/deepseek/deepseek-v4-pro-cheaper:thinking`             | 1.0M    |       |           |       |       |       | $0.43      | $0.87       |
 | `nano-gpt/deepseek/deepseek-v4-pro:thinking`                     | 1.0M    |       |           |       |       |       | $1         | $2          |
@@ -211,8 +215,6 @@ for await (const chunk of stream) {
 | `nano-gpt/Gemma-4-31B-Cognitive-Unshackled`                      | 262K    |       |           |       |       |       | $0.31      | $0.31       |
 | `nano-gpt/Gemma-4-31B-DarkIdol`                                  | 262K    |       |           |       |       |       | $0.31      | $0.31       |
 | `nano-gpt/Gemma-4-31B-GarnetV2`                                  | 262K    |       |           |       |       |       | $0.31      | $0.31       |
-| `nano-gpt/Gemma-4-31B-Gemopus`                                   | 262K    |       |           |       |       |       | $0.31      | $0.31       |
-| `nano-gpt/Gemma-4-31B-Musica-v1`                                 | 262K    |       |           |       |       |       | $0.31      | $0.31       |
 | `nano-gpt/Gemma-4-31B-Queen`                                     | 262K    |       |           |       |       |       | $0.31      | $0.31       |
 | `nano-gpt/gemma-4-e2b-it`                                        | 131K    |       |           |       |       |       | $0.02      | $0.10       |
 | `nano-gpt/gemma-4-e4b-it`                                        | 131K    |       |           |       |       |       | $0.04      | $0.20       |
@@ -282,6 +284,7 @@ for await (const chunk of stream) {
 | `nano-gpt/kwaipilot/kat-coder-pro-v2.5`                          | 256K    |       |           |       |       |       | $0.74      | $3          |
 | `nano-gpt/LatitudeGames/Wayfarer-Large-70B-Llama-3.3`            | 16K     |       |           |       |       |       | $0.70      | $0.70       |
 | `nano-gpt/learnlm-1.5-pro-experimental`                          | 33K     |       |           |       |       |       | $4         | $11         |
+| `nano-gpt/liquid/lfm-2.5-2.6b`                                   | 128K    |       |           |       |       |       | $0.10      | $0.20       |
 | `nano-gpt/LLM360/K2-Think`                                       | 128K    |       |           |       |       |       | $0.17      | $0.68       |
 | `nano-gpt/longcat-2.0`                                           | 1.0M    |       |           |       |       |       | $0.75      | $3          |
 | `nano-gpt/longcat-2.0:thinking`                                  | 1.0M    |       |           |       |       |       | $0.75      | $3          |
@@ -373,6 +376,8 @@ for await (const chunk of stream) {
 | `nano-gpt/nvidia/nemotron-3-super-120b-a12b:thinking`            | 262K    |       |           |       |       |       | $0.05      | $0.25       |
 | `nano-gpt/nvidia/nemotron-3-ultra-550b-a55b`                     | 1.0M    |       |           |       |       |       | $0.50      | $3          |
 | `nano-gpt/nvidia/nemotron-3-ultra-550b-a55b:thinking`            | 1.0M    |       |           |       |       |       | $0.50      | $3          |
+| `nano-gpt/nvidia/nemotron-3.5-lightning`                         | 1.0M    |       |           |       |       |       | $0.05      | $0.20       |
+| `nano-gpt/nvidia/nemotron-3.5-lightning:thinking`                | 1.0M    |       |           |       |       |       | $0.05      | $0.20       |
 | `nano-gpt/openai/gpt-3.5-turbo`                                  | 16K     |       |           |       |       |       | $0.50      | $2          |
 | `nano-gpt/openai/gpt-4-turbo`                                    | 128K    |       |           |       |       |       | $10        | $30         |
 | `nano-gpt/openai/gpt-4-turbo-preview`                            | 128K    |       |           |       |       |       | $10        | $30         |
@@ -474,36 +479,8 @@ for await (const chunk of stream) {
 | `nano-gpt/qwen3.5-122b-a10b`                                     | 131K    |       |           |       |       |       | $0.44      | $3          |
 | `nano-gpt/qwen3.5-122b-a10b:thinking`                            | 131K    |       |           |       |       |       | $0.44      | $3          |
 | `nano-gpt/qwen3.5-27b`                                           | 260K    |       |           |       |       |       | $0.27      | $2          |
-| `nano-gpt/Qwen3.5-27B-Anko`                                      | 262K    |       |           |       |       |       | $0.31      | $0.31       |
-| `nano-gpt/Qwen3.5-27B-BlueStar-Derestricted`                     | 262K    |       |           |       |       |       | $0.31      | $0.31       |
-| `nano-gpt/Qwen3.5-27B-BlueStar-Derestricted-Lite`                | 262K    |       |           |       |       |       | $0.31      | $0.31       |
-| `nano-gpt/Qwen3.5-27B-BlueStar-v2-Derestricted`                  | 262K    |       |           |       |       |       | $0.31      | $0.31       |
-| `nano-gpt/Qwen3.5-27B-BlueStar-v2-Derestricted-Lite`             | 262K    |       |           |       |       |       | $0.31      | $0.31       |
 | `nano-gpt/Qwen3.5-27B-BlueStar-v3-Derestricted`                  | 262K    |       |           |       |       |       | $0.31      | $0.31       |
-| `nano-gpt/Qwen3.5-27B-BlueStar-v3-Derestricted-Lite`             | 262K    |       |           |       |       |       | $0.31      | $0.31       |
-| `nano-gpt/Qwen3.5-27B-Derestricted`                              | 262K    |       |           |       |       |       | $0.31      | $0.31       |
-| `nano-gpt/Qwen3.5-27B-earica-Derestricted`                       | 262K    |       |           |       |       |       | $0.31      | $0.31       |
-| `nano-gpt/Qwen3.5-27B-earica-Derestricted-Lite`                  | 262K    |       |           |       |       |       | $0.31      | $0.31       |
-| `nano-gpt/Qwen3.5-27B-Infracelestial`                            | 262K    |       |           |       |       |       | $0.31      | $0.31       |
-| `nano-gpt/Qwen3.5-27B-Marvin-DPO-V2-Derestricted`                | 262K    |       |           |       |       |       | $0.31      | $0.31       |
-| `nano-gpt/Qwen3.5-27B-Marvin-DPO-V2-Derestricted-Lite`           | 262K    |       |           |       |       |       | $0.31      | $0.31       |
-| `nano-gpt/Qwen3.5-27B-Marvin-V2-Derestricted`                    | 262K    |       |           |       |       |       | $0.31      | $0.31       |
-| `nano-gpt/Qwen3.5-27B-Marvin-V2-Derestricted-Lite`               | 262K    |       |           |       |       |       | $0.31      | $0.31       |
-| `nano-gpt/Qwen3.5-27B-Musica-v1`                                 | 262K    |       |           |       |       |       | $0.31      | $0.31       |
-| `nano-gpt/Qwen3.5-27B-NaNovel-Derestricted`                      | 262K    |       |           |       |       |       | $0.31      | $0.31       |
-| `nano-gpt/Qwen3.5-27B-NaNovel-Derestricted-Lite`                 | 262K    |       |           |       |       |       | $0.31      | $0.31       |
-| `nano-gpt/Qwen3.5-27B-Omega-Evolution-v2.0-Derestricted`         | 262K    |       |           |       |       |       | $0.31      | $0.31       |
-| `nano-gpt/Qwen3.5-27B-Omega-Evolution-v2.0-Derestricted-Lite`    | 262K    |       |           |       |       |       | $0.31      | $0.31       |
-| `nano-gpt/Qwen3.5-27B-Omega-Evolution-v2.2-Derestricted`         | 262K    |       |           |       |       |       | $0.31      | $0.31       |
-| `nano-gpt/Qwen3.5-27B-Omega-Evolution-v2.2-Derestricted-Lite`    | 262K    |       |           |       |       |       | $0.31      | $0.31       |
 | `nano-gpt/Qwen3.5-27B-Queen-Derestricted`                        | 262K    |       |           |       |       |       | $0.31      | $0.31       |
-| `nano-gpt/Qwen3.5-27B-Queen-Derestricted-Lite`                   | 262K    |       |           |       |       |       | $0.31      | $0.31       |
-| `nano-gpt/Qwen3.5-27B-RpRMax-v1`                                 | 262K    |       |           |       |       |       | $0.31      | $0.31       |
-| `nano-gpt/Qwen3.5-27B-Vivid-Durian`                              | 262K    |       |           |       |       |       | $0.31      | $0.31       |
-| `nano-gpt/Qwen3.5-27B-Writer-Derestricted`                       | 262K    |       |           |       |       |       | $0.31      | $0.31       |
-| `nano-gpt/Qwen3.5-27B-Writer-Derestricted-Lite`                  | 262K    |       |           |       |       |       | $0.31      | $0.31       |
-| `nano-gpt/Qwen3.5-27B-Writer-V2-Derestricted`                    | 262K    |       |           |       |       |       | $0.31      | $0.31       |
-| `nano-gpt/Qwen3.5-27B-Writer-V2-Derestricted-Lite`               | 262K    |       |           |       |       |       | $0.31      | $0.31       |
 | `nano-gpt/qwen3.5-27b:thinking`                                  | 260K    |       |           |       |       |       | $0.27      | $2          |
 | `nano-gpt/qwen3.5-35b-a3b`                                       | 260K    |       |           |       |       |       | $0.23      | $2          |
 | `nano-gpt/qwen3.5-35b-a3b:thinking`                              | 260K    |       |           |       |       |       | $0.23      | $2          |
@@ -519,12 +496,10 @@ for await (const chunk of stream) {
 | `nano-gpt/qwen3.7-plus`                                          | 992K    |       |           |       |       |       | $0.40      | $2          |
 | `nano-gpt/qwen3.7-plus:thinking`                                 | 984K    |       |           |       |       |       | $0.40      | $2          |
 | `nano-gpt/qwen3.8-max`                                           | 991K    |       |           |       |       |       | $2         | $6          |
-| `nano-gpt/qwen3.8-max-preview`                                   | 991K    |       |           |       |       |       | $2         | $5          |
 | `nano-gpt/qwen3.8-max:thinking`                                  | 991K    |       |           |       |       |       | $2         | $6          |
 | `nano-gpt/ReadyArt/MS3.2-The-Omega-Directive-24B-Unslop-v2.0`    | 16K     |       |           |       |       |       | $0.50      | $0.50       |
 | `nano-gpt/sakana/fugu-ultra`                                     | 1.0M    |       |           |       |       |       | $5         | $32         |
 | `nano-gpt/sakana/fugu-ultra-v1.1`                                | 1.0M    |       |           |       |       |       | $5         | $32         |
-| `nano-gpt/sakana/sakana-namazu`                                  | 262K    |       |           |       |       |       | $1.00      | $4          |
 | `nano-gpt/Salesforce/Llama-xLAM-2-70b-fc-r`                      | 128K    |       |           |       |       |       | $3         | $3          |
 | `nano-gpt/Sao10K/L3-8B-Stheno-v3.2`                              | 16K     |       |           |       |       |       | $0.20      | $0.20       |
 | `nano-gpt/Sao10K/L3.1-70B-Euryale-v2.2`                          | 20K     |       |           |       |       |       | $0.31      | $0.36       |
@@ -572,6 +547,7 @@ for await (const chunk of stream) {
 | `nano-gpt/TEE/kimi-k3`                                           | 1.0M    |       |           |       |       |       | $3         | $15         |
 | `nano-gpt/TEE/llama3-3-70b`                                      | 128K    |       |           |       |       |       | $2         | $3          |
 | `nano-gpt/TEE/minimax-m2.5`                                      | 197K    |       |           |       |       |       | $0.20      | $1          |
+| `nano-gpt/TEE/muse-glimmer-30b`                                  | 131K    |       |           |       |       |       | $0.35      | $2          |
 | `nano-gpt/TEE/qwen2.5-vl-72b-instruct`                           | 66K     |       |           |       |       |       | $0.70      | $0.70       |
 | `nano-gpt/TEE/qwen3.5-122b-a10b`                                 | 262K    |       |           |       |       |       | $0.46      | $4          |
 | `nano-gpt/TEE/qwen3.5-27b`                                       | 262K    |       |           |       |       |       | $0.30      | $2          |
@@ -613,6 +589,7 @@ for await (const chunk of stream) {
 | `nano-gpt/x-ai/grok-4.20-multi-agent`                            | 2.0M    |       |           |       |       |       | $2         | $6          |
 | `nano-gpt/x-ai/grok-4.3`                                         | 1.0M    |       |           |       |       |       | $1         | $3          |
 | `nano-gpt/x-ai/grok-4.5`                                         | 500K    |       |           |       |       |       | $2         | $6          |
+| `nano-gpt/x-ai/grok-4.6`                                         | 500K    |       |           |       |       |       | $2         | $6          |
 | `nano-gpt/x-ai/grok-build-0.1`                                   | 256K    |       |           |       |       |       | $1         | $2          |
 | `nano-gpt/x-ai/grok-latest`                                      | 500K    |       |           |       |       |       | $2         | $6          |
 | `nano-gpt/xiaomi/mimo-v2.5`                                      | 1.0M    |       |           |       |       |       | $0.14      | $0.28       |

package/.docs/models/providers/opencode.md CHANGED Viewed

@@ -2,7 +2,7 @@
 # ![OpenCode Zen logo](https://models.dev/logos/opencode.svg)OpenCode Zen
-Access 88 OpenCode Zen models through Mastra's model router. Authentication is handled automatically using the `OPENCODE_API_KEY` environment variable.
+Access 89 OpenCode Zen models through Mastra's model router. Authentication is handled automatically using the `OPENCODE_API_KEY` environment variable.
 Learn more in the [OpenCode Zen documentation](https://opencode.ai/docs/zen).
@@ -80,6 +80,7 @@ for await (const chunk of stream) {
 | `opencode/gpt-5.6-sol`                 | 1.1M    |       |           |       |       |       | $5         | $30         |
 | `opencode/gpt-5.6-terra`               | 1.1M    |       |           |       |       |       | $3         | $15         |
 | `opencode/grok-4.5`                    | 500K    |       |           |       |       |       | $2         | $6          |
+| `opencode/grok-4.6`                    | 500K    |       |           |       |       |       | $2         | $6          |
 | `opencode/grok-build-0.1`              | 256K    |       |           |       |       |       | $1         | $2          |
 | `opencode/hy3-free`                    | 190K    |       |           |       |       |       | —          | —           |
 | `opencode/kimi-k2.5`                   | 262K    |       |           |       |       |       | $0.60      | $3          |

package/.docs/models/providers/tinfoil.md CHANGED Viewed

@@ -2,7 +2,7 @@
 # ![Tinfoil logo](https://models.dev/logos/tinfoil.svg)Tinfoil
-Access 7 Tinfoil models through Mastra's model router. Authentication is handled automatically using the `TINFOIL_API_KEY` environment variable.
+Access 8 Tinfoil models through Mastra's model router. Authentication is handled automatically using the `TINFOIL_API_KEY` environment variable.
 Learn more in the [Tinfoil documentation](https://docs.tinfoil.sh).
@@ -17,7 +17,7 @@ const agent = new Agent({
   id: "my-agent",
   name: "My Agent",
   instructions: "You are a helpful assistant",
-  model: "tinfoil/gemma4-31b"
+  model: "tinfoil/deepseek-v4-flash"
 });
 // Generate a response
@@ -36,12 +36,13 @@ for await (const chunk of stream) {
 | Model                            | Context | Tools | Reasoning | Image | Audio | Video | Input $/1M | Output $/1M |
 | -------------------------------- | ------- | ----- | --------- | ----- | ----- | ----- | ---------- | ----------- |
-| `tinfoil/gemma4-31b`             | 256K    |       |           |       |       |       | $0.40      | $1          |
-| `tinfoil/glm-5-2`                | 384K    |       |           |       |       |       | $2         | $5          |
+| `tinfoil/deepseek-v4-flash`      | 1.0M    |       |           |       |       |       | $0.70      | $2          |
+| `tinfoil/gemma4-31b`             | 262K    |       |           |       |       |       | $0.40      | $1          |
+| `tinfoil/glm-5-2`                | 393K    |       |           |       |       |       | $2         | $5          |
 | `tinfoil/gpt-oss-120b`           | 131K    |       |           |       |       |       | $0.15      | $0.60       |
 | `tinfoil/gpt-oss-safeguard-120b` | 131K    |       |           |       |       |       | $0.15      | $0.60       |
-| `tinfoil/kimi-k3`                | 256K    |       |           |       |       |       | $2         | $6          |
-| `tinfoil/llama3-3-70b`           | 128K    |       |           |       |       |       | $2         | $3          |
+| `tinfoil/kimi-k3`                | 262K    |       |           |       |       |       | $4         | $20         |
+| `tinfoil/llama3-3-70b`           | 131K    |       |           |       |       |       | $2         | $3          |
 | `tinfoil/nomic-embed-text`       | 8K      |       |           |       |       |       | $0.05      | —           |
 ## Advanced configuration
@@ -54,7 +55,7 @@ const agent = new Agent({
   name: "custom-agent",
   model: {
     url: "https://inference.tinfoil.sh/v1",
-    id: "tinfoil/gemma4-31b",
+    id: "tinfoil/deepseek-v4-flash",
     apiKey: process.env.TINFOIL_API_KEY,
     headers: {
       "X-Custom-Header": "value"
@@ -73,7 +74,7 @@ const agent = new Agent({
     const useAdvanced = requestContext.task === "complex";
     return useAdvanced
       ? "tinfoil/nomic-embed-text"
-      : "tinfoil/gemma4-31b";
+      : "tinfoil/deepseek-v4-flash";
   }
 });
 ```

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

@@ -2,7 +2,7 @@
 # ![xAI logo](https://models.dev/logos/xai.svg)xAI
-Access 10 xAI models through Mastra's model router. Authentication is handled automatically using the `XAI_API_KEY` environment variable.
+Access 11 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).
@@ -39,6 +39,7 @@ for await (const chunk of stream) {
 | `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-4.6`                     | 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.md CHANGED Viewed

@@ -50,6 +50,7 @@ Direct access to individual AI model providers. Each provider offers unique mode
 - [DigitalOcean](https://mastra.ai/models/providers/digitalocean)
 - [DInference](https://mastra.ai/models/providers/dinference)
 - [EBCloud](https://mastra.ai/models/providers/ebcloud)
+- [Eden AI](https://mastra.ai/models/providers/edenai)
 - [EmpirioLabs AI](https://mastra.ai/models/providers/empiriolabs)
 - [evroc](https://mastra.ai/models/providers/evroc)
 - [FastRouter](https://mastra.ai/models/providers/fastrouter)
@@ -85,6 +86,7 @@ Direct access to individual AI model providers. Each provider offers unique mode
 - [LucidQuery](https://mastra.ai/models/providers/lucidquery)
 - [Lynkr](https://mastra.ai/models/providers/lynkr)
 - [Meganova](https://mastra.ai/models/providers/meganova)
+- [Merge Gateway](https://mastra.ai/models/providers/merge-gateway)
 - [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)

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

@@ -98,7 +98,7 @@ export const claudeCodeAgent = new AcpAgent({
 #### `generate(messages, options?)`
-Sends the prompt to the ACP agent, buffers text chunks from the ACP response, and returns a Mastra subagent generate result.
+Sends the prompt to the ACP agent and buffers text chunks from the response before returning a Mastra subagent generate result.
 ```typescript
 const result = await codeAgent.generate('Inspect the repository and summarize the test setup')

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

@@ -249,7 +249,7 @@ const usage = 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 don't 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 and session `id`, plus 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()`

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

@@ -309,7 +309,7 @@ The `ResolveResourceIdContext` passed to the function:
 ## Thread ID resolution
-By default a new channel thread gets a random UUID as its internal Mastra thread id. Pass `resolveThreadId` to pick the id yourself: for example, give the thread the same id as the session it belongs to, matching how your app names threads it creates itself.
+By default a new channel thread gets a random UUID as its internal Mastra thread id. Pass `resolveThreadId` to pick the id yourself: for example, give the thread the same id as its session to match the names your app assigns to threads it creates.
 The hook runs after `resolveResourceId`, so the resolved owner is available on the context. Like `resolveResourceId` it runs only when a new thread is created: reused threads keep their stored id and never call the hook. The returned id must be unique across the memory store. If it already belongs to an existing thread, Mastra logs a warning and uses a generated id instead so the existing thread is never overwritten. Return `ctx.defaultThreadId` to keep the built-in behavior.

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

@@ -121,7 +121,7 @@ Returns: [`Promise<InngestAgentStreamResult>`](#inngestagentstreamresult)
 #### `resume(runId, resumeData, options?)`
-Resumes a suspended Inngest run, for example after a tool approval. Loads the workflow snapshot from storage, finds the suspended step, and sends a resume event to Inngest.
+Resumes a suspended Inngest run, for example after a tool approval. Loads the workflow snapshot from storage and finds the suspended step before sending a resume event to Inngest.
 ```typescript
 const { output, cleanup } = await durableAgent.resume(

package/.docs/reference/ai-sdk/overview.md CHANGED Viewed

@@ -2,7 +2,7 @@
 # AI SDK
-If you're already using the [Vercel AI SDK](https://sdk.vercel.ai) directly and want to add Mastra capabilities like [processors](https://mastra.ai/docs/agents/processors) or [memory](https://mastra.ai/docs/memory/memory-processors) without switching to the full Mastra agent API, [`withMastra()`](https://mastra.ai/reference/ai-sdk/with-mastra) lets you wrap any AI SDK model with these features. This is useful when you want to keep your existing AI SDK code but add input/output processing, conversation persistence, or content filtering.
+If you're already using the [Vercel AI SDK](https://sdk.vercel.ai) directly and want to add Mastra capabilities like [processors](https://mastra.ai/docs/agents/processors) or [memory](https://mastra.ai/docs/memory/memory-processors) without switching to the full Mastra agent API, [`withMastra()`](https://mastra.ai/reference/ai-sdk/with-mastra) lets you wrap any AI SDK model with these features. This is useful when you want to keep your existing AI SDK code but add input/output processing and conversation persistence, including content filtering.
 > **Tip:** If you want to use Mastra together with AI SDK UI (e.g. `useChat()`), visit the [AI SDK UI guide](https://mastra.ai/integrations/agentic-ui/ai-sdk-ui).

package/.docs/reference/auth/auth0.md CHANGED Viewed

@@ -26,7 +26,7 @@ export const mastra = new Mastra({
 **domain** (`string`): Your Auth0 domain (e.g., your-tenant.auth0.com). This is used to verify JWT tokens issued by your Auth0 tenant. (Default: `process.env.AUTH0_DOMAIN`)
-**audience** (`string`): Your Auth0 API identifier/audience. This ensures tokens are intended for your specific API. (Default: `process.env.AUTH0_AUDIENCE`)
+**audience** (`string`): Your Auth0 API identifier/audience, which restricts tokens to your API. (Default: `process.env.AUTH0_AUDIENCE`)
 **name** (`string`): Custom name for the auth provider instance. (Default: `"auth0"`)

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

@@ -4,7 +4,7 @@
 ## MastraAuthGoogle class
-The `MastraAuthGoogle` class provides authentication for Mastra using Google Workspace. It implements an OAuth 2.0 / OIDC login flow with encrypted session cookies, verifies Google ID tokens, and integrates with the Mastra server using the `auth` option.
+The `MastraAuthGoogle` class provides authentication for Mastra using Google Workspace. It implements an OAuth 2.0 / OIDC login flow with encrypted session cookies and verifies Google ID tokens. It integrates with the Mastra server through the `auth` option.
 ### Usage example

package/.docs/reference/browser/agent-browser.md CHANGED Viewed

@@ -46,7 +46,7 @@ then interact with elements using their refs (e.g., @e5).`,
 **screencast** (`ScreencastOptions`): Configuration for streaming browser frames to Studio.
-**recording** (`BrowserRecordingOptions`): Alpha option for adding browser recording tools. Provide outputDir to add browser\_record and browser\_record\_caption to the toolset. You can also set maxDurationMs, maxWidth, and maxHeight as defaults for every recording.
+**recording** (`BrowserRecordingOptions`): Beta option for adding browser recording tools. Provide outputDir to add browser\_record and browser\_record\_caption to the toolset. You can also set maxDurationMs, maxWidth, and maxHeight as defaults for every recording.
 **excludeTools** (`BrowserToolName[]`): Tool names to exclude from the browser toolset. Use this to disable specific tools for models that do not support certain capabilities, such as vision.
@@ -54,7 +54,7 @@ then interact with elements using their refs (e.g., @e5).`,
 `AgentBrowser` provides 16 deterministic tools for browser automation. All tools that interact with elements use refs from the accessibility tree snapshot.
-When `recording` is configured, `AgentBrowser` also adds the alpha `browser_record` and `browser_record_caption` tools. See [Browser recording (alpha)](https://mastra.ai/docs/browser/recording).
+When `recording` is configured, `AgentBrowser` also adds the Beta `browser_record` and `browser_record_caption` tools. See [Browser recording (Beta)](https://mastra.ai/docs/browser/overview).
 ### Core tools

package/.docs/reference/browser/browser-viewer.md CHANGED Viewed

@@ -2,7 +2,7 @@
 # BrowserViewer
-The `BrowserViewer` class provides browser automation for CLI-based tools. It launches Chrome via Playwright, exposes a Chrome DevTools Protocol (CDP) URL, and automatically injects it into CLI commands run through workspace tools.
+The `BrowserViewer` class provides browser automation for CLI-based tools. It launches Chrome through Playwright and exposes a Chrome DevTools Protocol (CDP) URL. It automatically injects that URL into CLI commands run through workspace tools.
 Use `BrowserViewer` when your agent drives a browser through a CLI tool like `browser-use`, `agent-browser`, or `browse`. For SDK-based browser automation, use [`AgentBrowser`](https://mastra.ai/reference/browser/agent-browser) or [`StagehandBrowser`](https://mastra.ai/reference/browser/stagehand-browser).

package/.docs/reference/browser/stagehand-browser.md CHANGED Viewed

@@ -63,7 +63,7 @@ Use stagehand_extract to get data from pages.`,
 **screencast** (`ScreencastOptions`): Configuration for streaming browser frames to Studio.
-**recording** (`BrowserRecordingOptions`): Alpha option for adding browser recording tools. Provide outputDir to add browser\_record and browser\_record\_caption to the toolset. You can also set maxDurationMs, maxWidth, and maxHeight as defaults for every recording.
+**recording** (`BrowserRecordingOptions`): Beta option for adding browser recording tools. Provide outputDir to add browser\_record and browser\_record\_caption to the toolset. You can also set maxDurationMs, maxWidth, and maxHeight as defaults for every recording.
 **excludeTools** (`StagehandToolName[]`): Tool names to exclude from the browser toolset. Use this to disable specific tools for models that do not support certain capabilities, such as vision.
@@ -71,7 +71,7 @@ Use stagehand_extract to get data from pages.`,
 `StagehandBrowser` provides 7 AI-powered tools for browser automation.
-When `recording` is configured, `StagehandBrowser` also adds the alpha `browser_record` and `browser_record_caption` tools. See [Browser recording (alpha)](https://mastra.ai/docs/browser/recording).
+When `recording` is configured, `StagehandBrowser` also adds the Beta `browser_record` and `browser_record_caption` tools. See [Browser recording (Beta)](https://mastra.ai/docs/browser/overview).
 Core tools:

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

@@ -2,7 +2,7 @@
 # ChannelProvider
-`ChannelProvider` is the interface that platform integrations implement to connect agents to a messaging platform. A provider owns the full lifecycle of an integration: app provisioning and OAuth, webhook routing and event handling, adapter creation and agent wiring, and credential management.
+`ChannelProvider` is the interface that platform integrations implement to connect agents to a messaging platform. A provider owns the full integration lifecycle. This includes app provisioning with OAuth, webhook routing with event handling, adapter creation and agent wiring, and credential management.
 Register providers on the `Mastra` constructor under `channels`, keyed by an id you choose. Each provider's routes are merged into the server's API routes automatically, and `initialize()` runs during Mastra startup.

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

@@ -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/integrations/channels/slack) 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 through the Manifest API and runs the OAuth install flow. It also 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/integrations/channels/slack) on the agent's `channels.adapters` instead.
 ## Usage example

package/.docs/reference/cli/mastra.md CHANGED Viewed

@@ -226,7 +226,7 @@ The content digest excludes `experiment-worker-manifest.json` to avoid a self-re
 The worker implements the pinned experiment companion-worker protocol version `1`. It reads strict UTF-8 NDJSON frames from standard input and requires every frame, including the last one, to end with a newline. Frames larger than 1 MiB, malformed or truncated frames, unsupported protocol or canonicalization versions, and messages that don't match the active experiment correlation are rejected as protocol failures.
-A run request must match the artifact's embedded build ID and include the ordered dataset item count and SHA-256 attestation. The worker emits contiguous sequence numbers starting at `0`, timer-driven heartbeats, awaited experiment lifecycle events, and exactly one terminal event. Cancellation must match the active protocol version, experiment ID, job ID, attempt, and idempotency key.
+A run request must match the artifact's embedded build ID and include the ordered dataset item count and SHA-256 attestation. The worker emits contiguous sequence numbers starting at `0`, timer-driven heartbeats, awaited experiment lifecycle events, and exactly one terminal event. Cancellation must match the active protocol version and experiment ID, plus the job ID, attempt, and idempotency key.
 Protocol exit codes are:
@@ -528,7 +528,7 @@ Emit machine-readable JSON.
 Provisions and attaches a managed database, then polls until it's ready. Provisioning errors are printed with the provider's error detail.
-By default the database is scoped to a single environment: pass an environment argument to pick it, or omit the argument to have the CLI pick for you. When the project has one environment, that environment is used. When it has several, the CLI prompts you to select one interactively; in non-interactive contexts (CI, `--json`) an environment argument is required. Pass `--shared` to attach a project-scoped database that's shared by every environment instead.
+By default, the database is scoped to a single environment. Pass an environment argument to select it. If you omit the argument, the CLI uses the project's only environment or prompts you when several are available. In non-interactive contexts (CI, `--json`) an environment argument is required. Pass `--shared` to attach a project-scoped database that's shared by every environment instead.
 Environment-scoped databases inherit their provider region from the environment. Shared databases accept `--region`.
@@ -797,7 +797,7 @@ Lists all environment variables for the linked project. Values are partially mas
 ### `mastra server env set`
-Sets an environment variable. The CLI reads the current map, applies the change, and uploads the result.
+Sets an environment variable. The CLI reads the current map and applies the change before uploading the result.
 ```bash
 mastra server env set <key> <value>
@@ -1226,7 +1226,7 @@ mastra api agent get <agentId>
 #### `mastra api agent run`
-Runs an agent with JSON input. Use command help to see examples for text prompts, chat messages, and memory thread options.
+Runs an agent with JSON input. Use command help to see examples for text prompts and chat messages, including memory thread options.
 ```bash
 mastra api agent run <agentId> <input>
@@ -1370,7 +1370,7 @@ mastra api thread get <threadId>
 #### `mastra api thread create`
-Creates a memory thread. Pass one JSON input object; the CLI splits fields such as `agentId` into query parameters when required by the server route.
+Creates a memory thread. Pass one JSON input object. The CLI splits fields such as `agentId` into query parameters when required by the server route.
 ```bash
 mastra api thread create <input>

package/.docs/reference/code-sdk/mount-agent-controller.md CHANGED Viewed

@@ -4,7 +4,7 @@
 > **Beta:** Breaking changes may occur without a major version bump until the API is stable.
-The `mountAgentControllerOnMastra()` function builds the Mastra Code agent controller (the coding agent behind the [`mastracode`](https://www.npmjs.com/package/mastracode) CLI, with its modes, tools, memory, and thread management) and registers it on a server-owned [Mastra](https://mastra.ai/reference/core/mastra-class) instance. Use it to serve the Mastra Code agent to your own UI (web app, editor, bot): each client creates or resumes its own isolated session through the returned [`AgentController`](https://mastra.ai/reference/agent-controller/agent-controller-class).
+The `mountAgentControllerOnMastra()` function builds the Mastra Code agent controller (the coding agent behind [Mastra Code](https://code.mastra.ai), with its modes, tools, memory, and thread management) and registers it on a server-owned [Mastra](https://mastra.ai/reference/core/mastra-class) instance. Use it to serve the Mastra Code agent to your own UI (web app, editor, bot): each client creates or resumes its own isolated session through the returned [`AgentController`](https://mastra.ai/reference/agent-controller/agent-controller-class).
 To construct the `Mastra` instance yourself (for example in a deployable entry file), use `prepareAgentControllerMount()` from the same package, which returns the constructor args plus a `finalize()` callback.

package/.docs/reference/coding-agent/build-base-prompt.md CHANGED Viewed

@@ -74,4 +74,5 @@ const prompt = buildBasePrompt({
 ## Related
-- [`createCodingAgent()`](https://mastra.ai/reference/coding-agent/create-coding-agent)
+- [`createCodingAgent()`](https://mastra.ai/reference/coding-agent/create-coding-agent)
+- [Mastra Code](https://code.mastra.ai)

package/.docs/reference/configuration.md CHANGED Viewed

@@ -801,7 +801,7 @@ export const mastra = new Mastra({
 **Type:** `(err: Error, c: Context) => Response | Promise<Response>`
-Custom error handler called when an unhandled error occurs. Use this to customize error responses, log errors to external services like Sentry, or implement custom error formatting.
+Custom error handler called when an unhandled error occurs. Use this to customize error responses or log errors to external services such as Sentry. You can also implement custom error formatting.
 This hook is supported by all server adapters. The `c` parameter provides a Hono-compatible context object: for non-Hono adapters (Koa, Express, Fastify), a shim is provided with commonly used methods like `c.json()` and `c.req.path`.
@@ -830,7 +830,7 @@ export const mastra = new Mastra({
 **Type:** `(error: ZodError, context: 'query' | 'body' | 'path') => { status: number; body: unknown } | undefined`
-Custom handler called when a request fails Zod schema validation. Use this to customize validation error responses, change the status code, or format errors to match your API standards.
+Custom handler called when a request fails Zod schema validation. Use this to customize validation error responses and change the status code, or to format errors to match your API standards.
 Return a `{ status, body }` object to override the default `400` response, or `undefined` to use the default behavior. This hook is supported by all server adapters (Hono, Express, Fastify, Koa).
@@ -886,7 +886,7 @@ export const mastra = new Mastra({
 Base path for hosting [Studio](https://mastra.ai/docs/studio/overview). Use this to host the Studio on a sub-path of your existing application instead of the root.
-This is useful when integrating with existing applications, using authentication tools like Cloudflare Zero Trust that benefit from shared domains, or managing multiple services under a single domain.
+This is useful when integrating with existing applications or authentication tools such as Cloudflare Zero Trust that benefit from shared domains. It also supports managing multiple services under one domain.
 ```typescript
 import { Mastra } from '@mastra/core'

package/.docs/reference/core/getAgentById.md CHANGED Viewed

@@ -8,7 +8,7 @@ Use `mastra.getAgentById(id)` to retrieve the code-defined agent. Use `await mas
 ## Usage example
-The following example registers an agent, retrieves it by ID, and uses the returned agent.
+The following example registers an agent and retrieves it by ID before using the returned agent.
 ```typescript
 import { Agent } from '@mastra/core/agent'

package/.docs/reference/core/getWorkflow.md CHANGED Viewed

@@ -2,7 +2,7 @@
 # Mastra.getWorkflow()
-The `.getWorkflow()` method is used to retrieve a workflow by its registration key. This method provides full TypeScript type inference for workflow input and output schemas.
+The `.getWorkflow()` method is used to retrieve a workflow by its registration key. The method provides full TypeScript type inference for workflow input and output schemas.
 ## Usage example
@@ -19,7 +19,7 @@ await run.startAsync({
 ## Type inference
-For best TypeScript support, use `getWorkflow()` with the workflow's **registration key** (the key used when adding the workflow to Mastra). This provides full type inference for:
+For best TypeScript support, use `getWorkflow()` with the workflow's **registration key** (the key used when adding the workflow to Mastra). The registration key provides full type inference for:
 - Input data schemas
 - Output data schemas

package/.docs/reference/core/mastra-class.md CHANGED Viewed

@@ -4,7 +4,7 @@
 The `Mastra` class is the central orchestrator in any Mastra application, managing agents, workflows, storage, logging, observability, and more. Typically, you create a single instance of `Mastra` to coordinate your application.
-Think of `Mastra` as a top-level registry where you register agents, workflows, tools, and other components that need to be accessible throughout your application.
+`Mastra` is the top-level registry where you register agents, workflows, tools, and other components that need to be accessible throughout your application.
 ## Usage example

package/.docs/reference/deployer/netlify.md CHANGED Viewed

@@ -50,7 +50,7 @@ export const mastra = new Mastra({
 - `target?: 'serverless' | 'edge'`: Deploy target for Netlify. Defaults to `'serverless'`.
   - `'serverless'`: Standard [Netlify Functions](https://docs.netlify.com/functions/overview/) (Node.js runtime, 60s default timeout).
-  - `'edge'`: [Netlify Edge Functions](https://docs.netlify.com/build/edge-functions/overview/) (Deno-based runtime, runs at the edge closest to users, without a fixed timeout).
+  - `'edge'`: [Netlify Edge Functions](https://docs.netlify.com/build/edge-functions/overview/) (Deno-based runtime that runs at the edge closest to users without a fixed timeout).
 ### Edge functions example

package/.docs/reference/deployer.md CHANGED Viewed

@@ -2,7 +2,7 @@
 # Deployer
-The Deployer handles the deployment of standalone Mastra applications by packaging code, managing environment files, and serving applications using the Hono framework. Concrete implementations must define the deploy method for specific deployment targets.
+The Deployer handles the deployment of standalone Mastra applications by packaging code and managing environment files while serving applications through the Hono framework. Concrete implementations must define the deploy method for specific deployment targets.
 ## Usage example

package/.docs/reference/editor/prompt-blocks.md CHANGED Viewed

@@ -2,7 +2,7 @@
 # Prompt blocks
-Prompt blocks are reusable instruction templates managed by Editor. An agent's instructions can combine inline text, embedded prompt blocks, and references to independently versioned prompt blocks.
+Prompt blocks are reusable instruction templates managed by Editor. An agent's instructions can combine inline text with embedded prompt blocks and references to independently versioned prompt blocks.
 See [Prompt blocks](https://mastra.ai/docs/editor/overview) for the Studio workflow and common uses.

package/.docs/reference/editor/tools.md CHANGED Viewed

@@ -2,7 +2,7 @@
 # Tool configuration
-Editor stores tool selections as part of an agent version. A stored configuration can add registered tools, tools from integration providers, and tools from Model Context Protocol (MCP) clients.
+Editor stores tool selections as part of an agent version. A stored configuration can add registered tools and tools from integration providers, as well as tools from Model Context Protocol (MCP) clients.
 See [Editor tools](https://mastra.ai/docs/editor/overview) for the Studio workflow and common uses.

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

@@ -67,7 +67,7 @@ The scorer evaluates completeness through linguistic element coverage analysis.
 1. Extracts key elements:
-   - Nouns and named entities
+   - Nouns and entities such as names
    - Action verbs
    - Topic-specific terms
    - Normalized word forms

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

@@ -177,7 +177,7 @@ Include in your test harness to:
 - Benchmark different models' noise resistance before deployment
 - Identify agents vulnerable to manipulation during development
-- Create detailed test coverage for various noise types
+- Create detailed test coverage for multiple noise types
 - Ensure consistent behavior across updates
 ### Security Testing

package/.docs/reference/evals/summarization.md CHANGED Viewed

@@ -2,7 +2,7 @@
 # Summarization scorer
-The `createSummarizationScorer()` function creates a scorer that evaluates a summary on two axes: whether every claim it makes is supported by the source text, and whether it preserves the information the source states. The final score is the lower of the two, so a summary can't pass by being faithful but empty, or thorough but wrong.
+The `createSummarizationScorer()` function creates a scorer that evaluates a summary on two axes: whether every claim has source-text support and whether the summary preserves the source information. The final score is the lower of the two. A summary can't pass by being faithful but empty or by being thorough but wrong.
 The summary is the agent's last message that carries text, and the source text defaults to the first user message of the run input. Pass `source` or `sourceExtractor` when the text being summarized lives somewhere else, such as a tool result.