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

package/.docs/models/providers/umans-ai.md

@@ -2,7 +2,7 @@
 
 # ![Umans AI logo](https://models.dev/logos/umans-ai.svg)Umans AI
 
-Access 5 Umans AI models through Mastra's model router. Authentication is handled automatically using the `UMANS_AI_API_KEY` environment variable.
+Access 7 Umans AI models through Mastra's model router. Authentication is handled automatically using the `UMANS_AI_API_KEY` environment variable.
 
 Learn more in the [Umans AI documentation](https://app.umans.ai/offers/code/docs/orgs).
 
@@ -34,13 +34,15 @@ for await (const chunk of stream) {
 
 ## Models
 
-| Model                      | Context | Tools | Reasoning | Image | Audio | Video | Input $/1M | Output $/1M |
-| -------------------------- | ------- | ----- | --------- | ----- | ----- | ----- | ---------- | ----------- |
-| `umans-ai/umans-coder`     | 262K    |       |           |       |       |       | $0.95      | $4          |
-| `umans-ai/umans-flash`     | 262K    |       |           |       |       |       | $0.15      | $1          |
-| `umans-ai/umans-glm-5.1`   | 205K    |       |           |       |       |       | $1         | $4          |
-| `umans-ai/umans-glm-5.2`   | 406K    |       |           |       |       |       | $1         | $4          |
-| `umans-ai/umans-kimi-k2.7` | 262K    |       |           |       |       |       | $0.95      | $4          |
+| Model                                   | Context | Tools | Reasoning | Image | Audio | Video | Input $/1M | Output $/1M |
+| --------------------------------------- | ------- | ----- | --------- | ----- | ----- | ----- | ---------- | ----------- |
+| `umans-ai/umans-coder`                  | 262K    |       |           |       |       |       | $0.95      | $4          |
+| `umans-ai/umans-deepseek-v4-flash-0731` | 1.0M    |       |           |       |       |       | $0.14      | $0.28       |
+| `umans-ai/umans-flash`                  | 262K    |       |           |       |       |       | $0.15      | $1          |
+| `umans-ai/umans-glm-5.1`                | 205K    |       |           |       |       |       | $1         | $4          |
+| `umans-ai/umans-glm-5.2`                | 406K    |       |           |       |       |       | $1         | $4          |
+| `umans-ai/umans-kimi-k2.7`              | 262K    |       |           |       |       |       | $0.95      | $4          |
+| `umans-ai/umans-kimi-k3`                | 1.0M    |       |           |       |       |       | $3         | $15         |
 
 ## Advanced configuration
 
@@ -70,7 +72,7 @@ const agent = new Agent({
   model: ({ requestContext }) => {
     const useAdvanced = requestContext.task === "complex";
     return useAdvanced
-      ? "umans-ai/umans-kimi-k2.7"
+      ? "umans-ai/umans-kimi-k3"
       : "umans-ai/umans-coder";
   }
 });

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

@@ -2,7 +2,7 @@
 
 # ![Weights & Biases logo](https://models.dev/logos/wandb.svg)Weights & Biases
 
-Access 31 Weights & Biases models through Mastra's model router. Authentication is handled automatically using the `WANDB_API_KEY` environment variable.
+Access 27 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).
 
@@ -38,6 +38,7 @@ for await (const chunk of stream) {
 | ---------------------------------------------------- | ------- | ----- | --------- | ----- | ----- | ----- | ---------- | ----------- |
 | `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-Flash-0731`           | 262K    |       |           |       |       |       | $0.13      | $0.28       |
 | `wandb/deepseek-ai/DeepSeek-V4-Pro`                  | 1.0M    |       |           |       |       |       | $2         | $3          |
 | `wandb/google/gemma-4-31B-it`                        | 262K    |       |           |       |       |       | $0.10      | $0.34       |
 | `wandb/ibm-granite/granite-4.1-8b`                   | 131K    |       |           |       |       |       | $0.05      | $0.10       |
@@ -47,7 +48,6 @@ for await (const chunk of stream) {
 | `wandb/meta-llama/Llama-3.3-70B-Instruct`            | 128K    |       |           |       |       |       | $0.71      | $0.71       |
 | `wandb/MiniMaxAI/MiniMax-M2.5`                       | 197K    |       |           |       |       |       | $0.30      | $1          |
 | `wandb/MiniMaxAI/MiniMax-M3`                         | 262K    |       |           |       |       |       | $0.23      | $0.96       |
-| `wandb/moonshotai/Kimi-K2.5`                         | 262K    |       |           |       |       |       | $0.60      | $3          |
 | `wandb/moonshotai/Kimi-K2.6`                         | 262K    |       |           |       |       |       | $0.65      | $3          |
 | `wandb/moonshotai/Kimi-K2.7-Code`                    | 262K    |       |           |       |       |       | $0.71      | $4          |
 | `wandb/moonshotai/Kimi-K3`                           | 1.0M    |       |           |       |       |       | $3         | $15         |

package/.docs/models/providers/zai-coding-plan.md

@@ -2,7 +2,7 @@
 
 # ![Z.AI Coding Plan logo](https://models.dev/logos/zai-coding-plan.svg)Z.AI Coding Plan
 
-Access 6 Z.AI Coding Plan models through Mastra's model router. Authentication is handled automatically using the `ZHIPU_API_KEY` environment variable.
+Access 4 Z.AI Coding Plan models through Mastra's model router. Authentication is handled automatically using the `ZHIPU_API_KEY` environment variable.
 
 Learn more in the [Z.AI Coding Plan documentation](https://docs.z.ai/devpack/overview).
 
@@ -17,7 +17,7 @@ const agent = new Agent({
   id: "my-agent",
   name: "My Agent",
   instructions: "You are a helpful assistant",
-  model: "zai-coding-plan/glm-4.5-air"
+  model: "zai-coding-plan/glm-4.7"
 });
 
 // Generate a response
@@ -34,14 +34,12 @@ for await (const chunk of stream) {
 
 ## Models
 
-| Model                          | Context | Tools | Reasoning | Image | Audio | Video | Input $/1M | Output $/1M |
-| ------------------------------ | ------- | ----- | --------- | ----- | ----- | ----- | ---------- | ----------- |
-| `zai-coding-plan/glm-4.5-air`  | 131K    |       |           |       |       |       | —          | —           |
-| `zai-coding-plan/glm-4.7`      | 205K    |       |           |       |       |       | —          | —           |
-| `zai-coding-plan/glm-5-turbo`  | 200K    |       |           |       |       |       | —          | —           |
-| `zai-coding-plan/glm-5.1`      | 200K    |       |           |       |       |       | —          | —           |
-| `zai-coding-plan/glm-5.2`      | 1.0M    |       |           |       |       |       | —          | —           |
-| `zai-coding-plan/glm-5v-turbo` | 200K    |       |           |       |       |       | —          | —           |
+| Model                               | Context | Tools | Reasoning | Image | Audio | Video | Input $/1M | Output $/1M |
+| ----------------------------------- | ------- | ----- | --------- | ----- | ----- | ----- | ---------- | ----------- |
+| `zai-coding-plan/glm-4.7`           | 205K    |       |           |       |       |       | —          | —           |
+| `zai-coding-plan/glm-5-turbo`       | 200K    |       |           |       |       |       | —          | —           |
+| `zai-coding-plan/glm-5.2`           | 1.0M    |       |           |       |       |       | —          | —           |
+| `zai-coding-plan/glm-5.2-highspeed` | 1.0M    |       |           |       |       |       | —          | —           |
 
 ## Advanced configuration
 
@@ -53,7 +51,7 @@ const agent = new Agent({
   name: "custom-agent",
   model: {
     url: "https://api.z.ai/api/coding/paas/v4",
-    id: "zai-coding-plan/glm-4.5-air",
+    id: "zai-coding-plan/glm-4.7",
     apiKey: process.env.ZHIPU_API_KEY,
     headers: {
       "X-Custom-Header": "value"
@@ -71,8 +69,8 @@ const agent = new Agent({
   model: ({ requestContext }) => {
     const useAdvanced = requestContext.task === "complex";
     return useAdvanced
-      ? "zai-coding-plan/glm-5v-turbo"
-      : "zai-coding-plan/glm-4.5-air";
+      ? "zai-coding-plan/glm-5.2-highspeed"
+      : "zai-coding-plan/glm-4.7";
   }
 });
 ```

package/.docs/models/providers/zhipuai-coding-plan.md

@@ -17,7 +17,7 @@ const agent = new Agent({
   id: "my-agent",
   name: "My Agent",
   instructions: "You are a helpful assistant",
-  model: "zhipuai-coding-plan/glm-4.5-air"
+  model: "zhipuai-coding-plan/glm-4.6v"
 });
 
 // Generate a response
@@ -34,15 +34,15 @@ for await (const chunk of stream) {
 
 ## Models
 
-| Model                              | Context | Tools | Reasoning | Image | Audio | Video | Input $/1M | Output $/1M |
-| ---------------------------------- | ------- | ----- | --------- | ----- | ----- | ----- | ---------- | ----------- |
-| `zhipuai-coding-plan/glm-4.5-air`  | 131K    |       |           |       |       |       | —          | —           |
-| `zhipuai-coding-plan/glm-4.6v`     | 128K    |       |           |       |       |       | $0.30      | $0.90       |
-| `zhipuai-coding-plan/glm-4.7`      | 205K    |       |           |       |       |       | —          | —           |
-| `zhipuai-coding-plan/glm-5-turbo`  | 200K    |       |           |       |       |       | —          | —           |
-| `zhipuai-coding-plan/glm-5.1`      | 200K    |       |           |       |       |       | —          | —           |
-| `zhipuai-coding-plan/glm-5.2`      | 1.0M    |       |           |       |       |       | —          | —           |
-| `zhipuai-coding-plan/glm-5v-turbo` | 200K    |       |           |       |       |       | —          | —           |
+| Model                                   | Context | Tools | Reasoning | Image | Audio | Video | Input $/1M | Output $/1M |
+| --------------------------------------- | ------- | ----- | --------- | ----- | ----- | ----- | ---------- | ----------- |
+| `zhipuai-coding-plan/glm-4.6v`          | 128K    |       |           |       |       |       | $0.30      | $0.90       |
+| `zhipuai-coding-plan/glm-4.7`           | 205K    |       |           |       |       |       | —          | —           |
+| `zhipuai-coding-plan/glm-5-turbo`       | 200K    |       |           |       |       |       | —          | —           |
+| `zhipuai-coding-plan/glm-5.1`           | 200K    |       |           |       |       |       | —          | —           |
+| `zhipuai-coding-plan/glm-5.2`           | 1.0M    |       |           |       |       |       | —          | —           |
+| `zhipuai-coding-plan/glm-5.2-highspeed` | 1.0M    |       |           |       |       |       | —          | —           |
+| `zhipuai-coding-plan/glm-5v-turbo`      | 200K    |       |           |       |       |       | —          | —           |
 
 ## Advanced configuration
 
@@ -54,7 +54,7 @@ const agent = new Agent({
   name: "custom-agent",
   model: {
     url: "https://open.bigmodel.cn/api/coding/paas/v4",
-    id: "zhipuai-coding-plan/glm-4.5-air",
+    id: "zhipuai-coding-plan/glm-4.6v",
     apiKey: process.env.ZHIPU_API_KEY,
     headers: {
       "X-Custom-Header": "value"
@@ -73,7 +73,7 @@ const agent = new Agent({
     const useAdvanced = requestContext.task === "complex";
     return useAdvanced
       ? "zhipuai-coding-plan/glm-5v-turbo"
-      : "zhipuai-coding-plan/glm-4.5-air";
+      : "zhipuai-coding-plan/glm-4.6v";
   }
 });
 ```

package/.docs/models/providers.md

@@ -56,7 +56,6 @@ Direct access to individual AI model providers. Each provider offers unique mode
 - [FreeModel](https://mastra.ai/models/providers/freemodel)
 - [Friendli](https://mastra.ai/models/providers/friendli)
 - [FrogBot](https://mastra.ai/models/providers/frogbot)
-- [GitHub Models](https://mastra.ai/models/providers/github-models)
 - [GMI Cloud](https://mastra.ai/models/providers/gmicloud)
 - [GreenPT](https://mastra.ai/models/providers/greenpt)
 - [Helicone](https://mastra.ai/models/providers/helicone)
@@ -64,10 +63,12 @@ Direct access to individual AI model providers. Each provider offers unique mode
 - [HPC-AI](https://mastra.ai/models/providers/hpc-ai)
 - [Hugging Face](https://mastra.ai/models/providers/huggingface)
 - [iFlow](https://mastra.ai/models/providers/iflowcn)
+- [Impossibl](https://mastra.ai/models/providers/impossibl)
 - [Inception](https://mastra.ai/models/providers/inception)
 - [Inceptron](https://mastra.ai/models/providers/inceptron)
 - [Inference](https://mastra.ai/models/providers/inference)
 - [InferX](https://mastra.ai/models/providers/inferx)
+- [Infomaniak](https://mastra.ai/models/providers/infomaniak)
 - [IO.NET](https://mastra.ai/models/providers/io-net)
 - [Jiekou.AI](https://mastra.ai/models/providers/jiekou)
 - [Kenari](https://mastra.ai/models/providers/kenari)
@@ -92,6 +93,7 @@ Direct access to individual AI model providers. Each provider offers unique mode
 - [Moark](https://mastra.ai/models/providers/moark)
 - [Modal](https://mastra.ai/models/providers/modal)
 - [Model Oracle AI](https://mastra.ai/models/providers/model-oracle-ai)
+- [Modelis](https://mastra.ai/models/providers/modelis)
 - [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)
@@ -124,6 +126,7 @@ Direct access to individual AI model providers. Each provider offers unique mode
 - [Sakana AI](https://mastra.ai/models/providers/sakana)
 - [Sarvam AI](https://mastra.ai/models/providers/sarvam)
 - [Scaleway](https://mastra.ai/models/providers/scaleway)
+- [SCX.ai](https://mastra.ai/models/providers/scx)
 - [SiliconFlow](https://mastra.ai/models/providers/siliconflow)
 - [SiliconFlow (China)](https://mastra.ai/models/providers/siliconflow-cn)
 - [Snowflake Cortex](https://mastra.ai/models/providers/snowflake-cortex)
@@ -138,6 +141,7 @@ Direct access to individual AI model providers. Each provider offers unique mode
 - [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)
+- [TensorX](https://mastra.ai/models/providers/tensorx)
 - [The Grid AI](https://mastra.ai/models/providers/the-grid-ai)
 - [Thinking Machines](https://mastra.ai/models/providers/thinkingmachines)
 - [Tinfoil](https://mastra.ai/models/providers/tinfoil)

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

@@ -564,7 +564,7 @@ When you register the [`MastraEditor`](https://mastra.ai/reference/editor/mastra
 
 **editor** (`false | { instructions?: boolean; tools?: boolean | { description?: boolean } }`): Omit to allow editing instructions and tools. Set to false to lock the agent. Set instructions: true to allow instruction edits. Set tools: true to allow tool membership and description edits, or tools: { description: true } to allow only description edits.
 
-The agent's `id`, `name`, and `model` always come from code and can't be overridden through the editor. See the [Editor overview](https://mastra.ai/docs/editor/overview) for usage.
+The agent's `id`, `name`, and `model` always come from code and can't be overridden through Editor. See [Editor](https://mastra.ai/docs/editor/overview) for usage.
 
 ## Returns
 

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

@@ -174,6 +174,17 @@ const { output, cleanup } = await durableAgent.observe(runId, {
 await output.text
 ```
 
+By default `observe()` waits indefinitely for events. If the process running the run stops unexpectedly, the run stops producing events but never emits a completion event, so the observed stream would wait forever. Pass `idleTimeoutMs` to bound that wait: after that many milliseconds of silence the stream ends. An optional `isAlive` check is consulted first. Return `true` while the run is still being worked on (for example a long-running tool call, or a run paused waiting for human input) to keep waiting. Returning `false`, or omitting `isAlive`, ends the stream with an error. A transient throw from `isAlive` is treated as "still alive", so a momentary check failure never ends a live stream.
+
+```typescript
+const { output } = await durableAgent.observe(runId, {
+  idleTimeoutMs: 30_000,
+  isAlive: () => runHeartbeat.isFresh(runId),
+})
+```
+
+Ending a run on idle timeout runs the same cleanup as a run that errors (see the warning below), so its cached state is released rather than retained. Both options are opt-in. Omit them for the previous wait-indefinitely behavior.
+
 Returns: `Promise<DurableAgentStreamResult>`
 
 > **Warning:** The `cleanup()` returned by `observe()` destroys the run's registry entries and cached events. Only call it when you are done with the run. If the run is suspended and you intend to resume later, don't call `cleanup()`. Let the auto-cleanup timer handle it after the run finishes or errors. Auto-cleanup doesn't fire on suspended events.
@@ -333,7 +344,7 @@ Returns: [`Promise<DurableAgentStreamResult>`](#durableagentstreamresult)
 
 ## DurableAgentStreamResult
 
-The object returned by `stream()`, `resume()`, and `observe()`.
+The object returned by `stream()`, `resume()`, `observe()`, and `recover()`.
 
 ```typescript
 interface DurableAgentStreamResult<OUTPUT = undefined> {

package/.docs/reference/agents/generate.md

@@ -214,7 +214,7 @@ const result = await agent.generate('message for agent')
 
 **options.tracingOptions.tags** (`string[]`): Tags to apply to this trace. String labels for categorizing and filtering traces.
 
-**options.versions** (`VersionOverrides`): Per-invocation version overrides for sub-agent delegation. Merged on top of Mastra instance-level versions and propagated automatically through sub-agent calls via requestContext. Requires the editor package. See Sub-agent versioning.
+**options.versions** (`VersionOverrides`): Per-invocation version overrides for sub-agent delegation. Merged on top of Mastra instance-level versions and propagated automatically through sub-agent calls via requestContext. Requires the editor package. See Editor versioning.
 
 **options.versions.agents** (`Record<string, VersionSelector>`): A map of agent IDs to their version selectors.
 

package/.docs/reference/agents/getVoice.md

@@ -30,5 +30,5 @@ await agent.getVoice({
 
 ## Related
 
-- [Voice in Mastra](https://mastra.ai/docs/voice/overview)
+- [Voice in Mastra](https://mastra.ai/guides/voice/overview)
 - [Voice providers](https://mastra.ai/reference/voice/mastra-voice)

package/.docs/{docs/getting-started → reference}/build-with-ai.md

@@ -2,110 +2,7 @@
 
 # Build with AI
 
-AI agents may not have up-to-date knowledge about Mastra's APIs, patterns, and best practices. These resources give your AI tools direct access to current Mastra documentation, enabling them to generate accurate code and help you build faster.
-
-To give your agent access to Mastra's documentation, we recommend using **skills**. While the MCP docs server also provides this information, skills will perform better. Use the MCP docs server when you need its tools, e.g. the migration tool.
-
-## Mastra skills
-
-Agent Skills are folders of instructions, scripts, and resources that agents can discover and use to do things accurately and efficiently. Mastra skills contain setup instructions, best practices, CLI commands, and instructions on how to fetch up-to-date information from Mastra's documentation.
-
-To install all available Mastra skills, run the following command:
-
-**npm**:
-
-```bash
-npx skills add mastra-ai/skills
-```
-
-**pnpm**:
-
-```bash
-pnpm dlx skills add mastra-ai/skills
-```
-
-**Yarn**:
-
-```bash
-yarn dlx skills add mastra-ai/skills
-```
-
-**Bun**:
-
-```bash
-bun x skills add mastra-ai/skills
-```
-
-Mastra skills work with any coding agent that supports the [Skills standard](https://agentskills.io/), including Claude Code, Cursor, Codex, OpenCode, and others.
-
-They're also available on [GitHub](https://github.com/mastra-ai/skills).
-
-### Update skill
-
-To update to the latest version of the Mastra skill, run:
-
-**npm**:
-
-```bash
-npx skills update mastra
-```
-
-**pnpm**:
-
-```bash
-pnpm dlx skills update mastra
-```
-
-**Yarn**:
-
-```bash
-yarn dlx skills update mastra
-```
-
-**Bun**:
-
-```bash
-bun x skills update mastra
-```
-
-## Mastra CLI
-
-The [Mastra CLI](https://mastra.ai/reference/cli/mastra) gives your coding agent a direct line to your Mastra runtime.
-
-Agents can invoke other agents and run workflows. They can execute tools and inspect memory. They can also run evals or query traces and logs.
-
-**npm**:
-
-```bash
-npm install mastra@latest -g
-```
-
-**pnpm**:
-
-```bash
-pnpm add mastra@latest -g
-```
-
-**Yarn**:
-
-```bash
-yarn global add mastra@latest
-```
-
-**Bun**:
-
-```bash
-bun add mastra@latest --global
-```
-
-For example, your coding agent can run an agent, then pull traces to inspect the results:
-
-```bash
-mastra api --url http://localhost:4111 agent run weather-agent '{"messages":"What is the weather in London?"}'
-mastra api --url http://localhost:4111 trace list
-```
-
-Install the [Mastra skills](#mastra-skills) to teach your agent how to use the CLI. See the [CLI commands reference](https://mastra.ai/reference/cli/mastra) for the full list of available commands.
+For everyday AI-assisted development with Mastra skills and the CLI, see [Develop](https://mastra.ai/docs/getting-started/develop). This page covers other ways to give coding agents access to Mastra documentation.
 
 ## Embedded package docs
 
@@ -130,12 +27,10 @@ Examples for the [introduction page](https://mastra.ai/docs):
 - [`/docs/llms.txt`](https://mastra.ai/docs/llms.txt)
 - [`/docs.md`](https://mastra.ai/docs.md)
 
-## Mastra's documentation
-
-In addition to the [context files](#context-files) each documentation page also features a "Copy markdown" button at the top of the page. It'll copy the streamlined markdown version to your clipboard. Beside it, you'll find a dropdown menu to open the page on GitHub, in ChatGPT, Claude, and others.
-
 ## MCP docs server
 
+> **Warning:** The MCP docs server isn't recommended for everyday development. Use the [Mastra skill](https://mastra.ai/docs/getting-started/develop) instead because it's more up to date and performs better.
+
 The `@mastra/mcp-docs-server` package provides direct local access to Mastra’s full documentation via the [Model Context Protocol (MCP)](https://modelcontextprotocol.io/docs/getting-started/intro). It works with Cursor, Windsurf, Cline, Claude Code, VS Code, Codex or any tool that supports MCP.
 
 These tools are designed to help agents retrieve precise, task-specific information, whether you're adding a feature to an agent or scaffolding a new project, or alternatively exploring how something works.
@@ -144,7 +39,7 @@ If you're unable to use a local MCP server and need to connect to a remote serve
 
 ### Installation
 
-The [`create-mastra`](https://mastra.ai/reference/cli/create-mastra) command installs Mastra skills automatically. It doesn't configure the MCP docs server. Add the server manually when you need MCP-specific tools such as the migration tool.
+The [`create-mastra`](https://mastra.ai/reference/cli/create-mastra) command doesn't configure the MCP docs server. Add the server manually when you need MCP-specific tools such as the migration tool.
 
 If there are no specific instructions for your tool below, you may be able to add the MCP server with this common JSON configuration.
 
@@ -354,7 +249,7 @@ Once configured, you can ask your AI tool questions about Mastra or instruct it
 - "How does working memory behave in Mastra and how can I use it to do `[task]`? It doesn't seem to work the way I expect."
 - "I saw there are new workflow features, explain them to me and then update `[workflow]` to use them."
 
-#### Troubleshooting
+### Troubleshooting
 
 1. **Server Not Starting**
 

package/.docs/reference/cli/create-mastra.md

@@ -201,6 +201,8 @@ Invalid input is rejected before templates are fetched or files are created.
 
 **--no-git** (`boolean`): Skip automatic Git initialization and the initial commit.
 
+**--no-install** (`boolean`): Skip dependency installation.
+
 **-t, --template \[template]** (`string`): Use a template slug or public GitHub URL. Omit the value to select interactively.
 
 **--timeout \<milliseconds>** (`number`): Positive integer timeout for dependency installation. Defaults to 60000.

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

@@ -103,7 +103,7 @@ These are forwarded to the Mastra model router and will work with any `"openai/.
 
 ## `mastra factory dev`
 
-Starts a development server for [Agent Builder](https://mastra.ai/docs/agent-builder/overview) development. It uses the same dev runtime and flags as [`mastra dev`](#mastra-dev) and writes to the same `.mastra/output` directory.
+Starts a development server for [Agent Builder](https://agent-builder.mastra.ai/) development. It uses the same dev runtime and flags as [`mastra dev`](#mastra-dev) and writes to the same `.mastra/output` directory.
 
 ```bash
 npx mastra factory dev
@@ -171,7 +171,7 @@ Comma-separated list of custom arguments to pass to the Node.js process, e.g. `-
 
 ## `mastra worker build`
 
-Bundles your Mastra application for worker deployment. Produces the same output as `mastra build` — a self-contained `.mastra/output/` directory.
+Bundles your Mastra application for worker deployment. Produces the same output as `mastra build`: a self-contained `.mastra/output/` directory.
 
 ```bash
 mastra worker build [options]
@@ -179,29 +179,45 @@ mastra worker build [options]
 
 ### Flags
 
-| Flag                  | Description                                                  |
-| --------------------- | ------------------------------------------------------------ |
-| `--dir <path>`        | Path to your Mastra source directory (default: `src/mastra`) |
-| `--root <path>`       | Project root directory (default: current directory)          |
-| `--tools <paths>`     | Comma-separated tool paths to include                        |
-| `--output-dir <path>` | Custom output directory (default: `.mastra/output`)          |
-| `--debug`             | Enable debug logging                                         |
+#### `--dir`
+
+Path to your Mastra source directory. Defaults to `src/mastra`.
+
+#### `--root`
+
+Project root directory. Defaults to the current directory.
+
+#### `--tools`
+
+Comma-separated tool paths to include in the bundle.
+
+#### `--output-dir`
+
+Custom output directory. Defaults to `.mastra/output`.
+
+#### `--debug`
+
+Enable debug logging during the build.
 
 ## `mastra worker start`
 
 > **Info:** You need to run `mastra worker build` or `mastra build` before using `mastra worker start`.
 
-Starts a worker process from a previously built bundle.
+Starts a worker process from a previously built bundle. The optional `name` argument sets `MASTRA_WORKERS` in the spawned process, controlling which worker starts.
 
 ```bash
 mastra worker start [name] [options]
 ```
 
-| Argument/Flag  | Description                                                         |
-| -------------- | ------------------------------------------------------------------- |
-| `name`         | Worker name to start. Sets `MASTRA_WORKERS` in the spawned process. |
-| `--dir <path>` | Path to the build output (default: `.mastra/output`)                |
-| `--env <path>` | Path to environment file (default: `.env.production`, then `.env`)  |
+### Flags
+
+#### `--dir`
+
+Path to the build output directory. Defaults to `.mastra/output`.
+
+#### `--env`
+
+Path to the environment file. Defaults to `.env.production`, falling back to `.env`.
 
 ### Examples
 
@@ -412,12 +428,16 @@ mastra env vars pull
 mastra env vars pull <env> --output .env.staging
 ```
 
-`<env>` can be an environment name, slug, or ID, and can be omitted when the project has exactly one environment. The file is written with `0600` permissions.
+`<env>` can be an environment name, slug, or ID, and can be omitted when the project has exactly one environment. The file is written with `0600` permissions. The command stops if the output file already exists. Pass `--force` to replace it.
 
 #### `-o, --output`
 
 File to write. Defaults to `.env`.
 
+#### `-f, --force`
+
+Replace an existing output file.
+
 ### `mastra env db`
 
 Manages databases attached to a project on Mastra platform. Databases are provisioned from a managed provider (for example Turso or Neon) and inject their connection env vars into deploys automatically.

package/.docs/reference/client-js/agents.md

@@ -838,7 +838,7 @@ console.log(result.success) // true
 
 ## Version management
 
-Both `Agent` (code-defined) and `StoredAgent` instances have methods for managing configuration versions. See the [Editor overview](https://mastra.ai/docs/editor/overview) for an introduction to version management.
+Both `Agent` (code-defined) and `StoredAgent` instances have methods for managing configuration versions. See [Editor versioning](https://mastra.ai/docs/editor/overview) for lifecycle and selection behavior.
 
 ### Getting an agent with a specific version
 

package/.docs/reference/configuration.md

@@ -419,7 +419,7 @@ export const mastra = new Mastra({
 
 Text-to-speech providers for voice synthesis capabilities. Register voice providers to enable agents to convert text responses into spoken audio.
 
-Visit the [Voice documentation](https://mastra.ai/docs/voice/overview) to learn more.
+Visit the [Voice documentation](https://mastra.ai/guides/voice/overview) to learn more.
 
 > **Note:** Most users configure voice directly on agents. This top-level configuration is for defining reusable voice providers that can be shared across multiple agents.
 
@@ -440,7 +440,7 @@ export const mastra = new Mastra({
 
 Vector stores for semantic search and embeddings. Used in RAG pipelines, similarity search, and other embedding-based features. Mastra supports multiple vector databases including Pinecone, PostgreSQL with pgvector, MongoDB, and more.
 
-Visit the [RAG documentation](https://mastra.ai/docs/rag/overview) to learn more.
+Visit the [RAG documentation](https://mastra.ai/guides/rag/overview) to learn more.
 
 > **Note:** Most users create vector stores directly when building RAG pipelines. This top-level configuration is for defining reusable vector store instances that can be shared across your application.
 

package/.docs/reference/core/getEditor.md

@@ -33,5 +33,5 @@ This method doesn't accept any parameters.
 
 ## Related
 
-- [Editor overview](https://mastra.ai/docs/editor/overview)
+- [Editor](https://mastra.ai/docs/editor/overview)
 - [MastraEditor reference](https://mastra.ai/reference/editor/mastra-editor)

package/.docs/reference/core/getVector.md

@@ -20,5 +20,5 @@ mastra.getVector('testVectorStore')
 
 ## Related
 
-- [Vector stores overview](https://mastra.ai/docs/rag/vector-databases)
-- [RAG overview](https://mastra.ai/docs/rag/overview)
+- [Vector stores overview](https://mastra.ai/guides/rag/vector-databases)
+- [RAG overview](https://mastra.ai/guides/rag/overview)

package/.docs/reference/core/listVectors.md

@@ -20,5 +20,5 @@ This method doesn't accept any parameters.
 
 ## Related
 
-- [Vector stores overview](https://mastra.ai/docs/rag/vector-databases)
-- [RAG overview](https://mastra.ai/docs/rag/overview)
+- [Vector stores overview](https://mastra.ai/guides/rag/vector-databases)
+- [RAG overview](https://mastra.ai/guides/rag/overview)

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

@@ -97,7 +97,7 @@ Visit the [Configuration reference](https://mastra.ai/reference/configuration) f
 
 **notifications.dispatch.batchSize** (`number`): Maximum number of due notification records to process per dispatch run.
 
-**versions** (`VersionOverrides`): Global version overrides for sub-agent delegation. When a supervisor agent delegates to a sub-agent, these overrides determine which stored version of that sub-agent to use instead of the code-defined default. Requires the editor package to be configured. See Sub-agent versioning for details.
+**versions** (`VersionOverrides`): Global version overrides for sub-agent delegation. When a supervisor agent delegates to a sub-agent, these overrides determine which stored version of that sub-agent to use instead of the code-defined default. Requires the editor package to be configured. See Editor versioning for details.
 
 **versions.agents** (`Record<string, VersionSelector>`): A map of agent IDs to their version selectors. Each selector can target a specific version by ID or by publication status.
 
@@ -135,7 +135,7 @@ Visit the [Configuration reference](https://mastra.ai/reference/configuration) f
 
 Re-drives every orphaned `running` durable-agent run across all registered durable agents. Called automatically on boot when `recovery.durableAgents` is `'auto'`. You can also call it directly for manual recovery or from a scheduled task.
 
-Requires persistent storage — with an in-memory store there is nothing to recover after a process restart.
+Requires persistent storage. With an in-memory store, there's nothing to recover after a process restart.
 
 ```typescript
 const result = await mastra.recoverAllDurableAgents()

package/.docs/reference/datasets/startExperiment.md

@@ -79,6 +79,12 @@ console.log(`Status: ${summary2.status}`)
 
 **unmockedToolPolicy** (`'allow' | 'deny'`): Controls undeclared agent tool calls. allow executes them live. deny fails the item with TOOL\_MOCK\_NOT\_DECLARED before execution. An item-level value overrides this experiment default. (Default: `'allow'`)
 
+**persistence** (`ExperimentPersistencePolicy`): Controls whether this run writes experiment records and score records. Targets and scorers still execute, and results remain available in the returned summary.
+
+**persistence.experiments** (`'default' | 'none'`): Set to none to skip experiment creation, item results, progress, and terminal status writes.
+
+**persistence.scores** (`'default' | 'none'`): Set to none to skip score writes while still running scorers.
+
 ## Returns
 
 **result** (`Promise<ExperimentSummary>`): Summary of the completed experiment.

package/.docs/reference/datasets/startExperimentAsync.md

@@ -33,6 +33,10 @@ console.log(`Current status: ${experiment.status}`)
 
 Takes the same `StartExperimentConfig` as [`dataset.startExperiment()`](https://mastra.ai/reference/datasets/startExperiment).
 
+When `persistence.experiments` is set to `'none'`, `startExperimentAsync()` doesn't persist an experiment record, progress updates, or item results. Score persistence remains controlled separately by `persistence.scores`. Without an experiment event observer, the run is fire-and-forget, and the experiment API can't report whether it completed or failed.
+
+Use synchronous [`startExperiment()`](https://mastra.ai/reference/datasets/startExperiment) when the caller needs the returned summary. An experiment event observer can receive lifecycle events and the terminal summary.
+
 ## Returns
 
 **result** (`Promise<object>`): Immediate response with experiment ID.