@mastra/mcp-docs-server 1.2.13-alpha.9 → 1.2.13

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

@@ -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.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[1m]` | 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
 

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/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
@@ -199,6 +199,71 @@ Custom output directory. Defaults to `.mastra/output`.
 
 Enable debug logging during the build.
 
+## `mastra experiment build`
+
+Builds a standalone companion worker that runs experiments without exposing an HTTP server. The worker loads your exported `Mastra` instance and accepts versioned newline-delimited JSON (NDJSON) protocol messages on standard input. It writes protocol events to standard output.
+
+```bash
+mastra experiment build [options]
+```
+
+The command writes the worker to `.mastra/experiment-worker` by default. The directory contains the executable entry point, production dependencies, and `experiment-worker-manifest.json`. Treat standard output as protocol-only output. Worker diagnostics are written to standard error.
+
+### Artifact contract
+
+`experiment-worker-manifest.json` identifies the artifact as `mastra-experiment-worker` version `1` and provides:
+
+- The CLI version, creation time, and unique build ID embedded in the executable.
+- Supported protocol and dataset canonicalization versions.
+- The executable, arguments, and working directory required to launch the worker.
+- The dependency manifest and generated lockfile paths.
+- A sorted SHA-256 digest for each artifact file.
+- A SHA-256 content digest derived from those file paths and digests.
+
+The content digest excludes `experiment-worker-manifest.json` to avoid a self-referential digest. Package the manifest with the rest of the directory. Use an outer package digest when the manifest itself must be attested.
+
+### Protocol contract
+
+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.
+
+Protocol exit codes are:
+
+| Code | Meaning                    |
+| ---- | -------------------------- |
+| `0`  | Completed                  |
+| `10` | Completed with item errors |
+| `20` | Fatal failure              |
+| `21` | Retryable failure          |
+| `30` | Cancelled                  |
+| `31` | Timed out                  |
+| `70` | Protocol failure           |
+
+### Packet field handling
+
+The worker passes target identity, ordered inline dataset items, scorer IDs, concurrency, timeout, experiment metadata, request context, tool mocks, and cancellation to `runExperiment`. Scorer versions and artifact provenance are retained as experiment metadata. Scorer code provenance is enforced by artifact admission rather than runtime scorer lookup.
+
+Version `1` uses deterministic undeclared-tool denial. Non-empty network allowlists and secret references are rejected with a policy failure because network enforcement and secret materialization belong to the process sandbox. Dataset item source and expected-trajectory fields are preserved as item metadata when passed to `runExperiment`.
+
+### Flags
+
+#### `--dir`
+
+Path to your Mastra source directory. Defaults to `src/mastra`.
+
+#### `--root`
+
+Project root directory. Defaults to the current directory.
+
+#### `--output-dir`
+
+Custom artifact directory. Relative paths are resolved from the project root. Defaults to `.mastra/experiment-worker`.
+
+#### `--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`.

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.
 

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.

package/.docs/reference/editor/browser-provider.md

@@ -54,7 +54,7 @@ export const myBrowserProvider: BrowserProvider<{ apiKey: string }> = {
 }
 ```
 
-Once registered, admins can pin the provider as a Builder default via [`BuilderAgentDefaults.browser`](https://mastra.ai/reference/editor/agent-builder/builder-agent-defaults):
+Once registered, admins can pin the provider as a Builder default via [`BuilderAgentDefaults.browser`](https://agent-builder.mastra.ai/reference/builder-agent-defaults):
 
 ```typescript
 new MastraEditor({
@@ -72,6 +72,6 @@ new MastraEditor({
 
 ## Related
 
-- [Browser](https://mastra.ai/docs/agent-builder/browser): Concept and worked examples.
+- [Browser](https://agent-builder.mastra.ai/browser): Concept and worked examples.
 - [StorageBrowserRef](https://mastra.ai/reference/editor/storage-browser-ref): Stored configuration consumed by `createBrowser`.
 - [MastraEditor class](https://mastra.ai/reference/editor/mastra-editor): Provider registry.

package/.docs/reference/editor/filesystem-provider.md

@@ -58,7 +58,7 @@ Once registered, admins can reference the provider from an inline workspace conf
 
 ## Related
 
-- [Workspace](https://mastra.ai/docs/agent-builder/workspace): Concept and worked examples.
+- [Workspace](https://agent-builder.mastra.ai/workspace): Concept and worked examples.
 - [StorageWorkspaceRef](https://mastra.ai/reference/editor/storage-workspace-ref): Stored configuration consumed by `createFilesystem`.
 - [SandboxProvider](https://mastra.ai/reference/editor/sandbox-provider): Sibling provider for command execution.
 - [MastraEditor class](https://mastra.ai/reference/editor/mastra-editor): Provider registry.

package/.docs/reference/editor/mastra-editor.md

@@ -4,24 +4,17 @@
 
 The `MastraEditor` class sets up the editor system. Pass it to the `Mastra` constructor to turn on editor features like prompt blocks, agent code override, versioning, and tool providers.
 
-See the [Editor overview](https://mastra.ai/docs/editor/overview) for an introduction to what the editor does.
+See [Editor](https://mastra.ai/docs/editor/overview) for an introduction to what the editor does.
 
 ## Usage example
 
 ```typescript
 import { Mastra } from '@mastra/core'
 import { MastraEditor } from '@mastra/editor'
-import { ComposioToolProvider } from '@mastra/editor/providers/composio'
 
 export const mastra = new Mastra({
   agents: {/* your agents */},
-  editor: new MastraEditor({
-    toolProviders: {
-      composio: new ComposioToolProvider({
-        apiKey: process.env.COMPOSIO_API_KEY!,
-      }),
-    },
-  }),
+  editor: new MastraEditor(),
 })
 ```
 
@@ -43,7 +36,7 @@ export const mastra = new Mastra({
 
 **builder** (`AgentBuilderOptions`): Agent Builder configuration. See the AgentBuilderOptions reference. Omit or set enabled: false to disable the Builder.
 
-**source** (`'code' | 'db'`): Where agent overrides are stored. With 'db', overrides live in the configured storage backend and Studio shows the save and publish flow. With 'code', overrides live as per-agent JSON files on disk (routed through a local FilesystemStore) and Studio shows filesystem actions. See the Editor overview for the difference. (Default: `'db'`)
+**source** (`'code' | 'db'`): Where agent overrides are stored. With 'db', overrides live in the configured storage backend and Studio shows the save and publish flow. With 'code', overrides live as per-agent JSON files on disk (routed through a local FilesystemStore) and Studio shows filesystem actions. See Editor storage options for the difference. (Default: `'db'`)
 
 **codePath** (`string`): Directory used by the 'code' source for per-agent JSON files. Ignored when source is not 'code'. (Default: `'./mastra/editor/'`)
 
@@ -59,12 +52,12 @@ Each provider field above takes a record keyed by provider id. See the per-provi
 
 ## Agent Builder
 
-The `builder` field enables the [Agent Builder](https://mastra.ai/docs/agent-builder/overview), a browser-based UI for creating and editing stored agents. See:
+The `builder` field enables the [Agent Builder](https://agent-builder.mastra.ai/), a browser-based UI for creating and editing stored agents. See:
 
-- [Agent Builder overview](https://mastra.ai/docs/agent-builder/overview): Concepts and getting started.
-- [AgentBuilderOptions](https://mastra.ai/reference/editor/agent-builder/agent-builder-options): Full options schema.
-- [BuilderAgentDefaults](https://mastra.ai/reference/editor/agent-builder/builder-agent-defaults): Admin-pinned defaults for new agents.
-- [builder.configuration.agent.models](https://mastra.ai/reference/editor/agent-builder/builder-models): Model allowlist and default model.
+- [Agent Builder overview](https://agent-builder.mastra.ai/): Concepts and getting started.
+- [AgentBuilderOptions](https://agent-builder.mastra.ai/reference/agent-builder-options): Full options schema.
+- [BuilderAgentDefaults](https://agent-builder.mastra.ai/reference/builder-agent-defaults): Admin-pinned defaults for new agents.
+- [builder.configuration.agent.models](https://agent-builder.mastra.ai/reference/builder-models): Model allowlist and default model.
 
 ### Registering the Builder agent
 
@@ -85,7 +78,7 @@ export const mastra = new Mastra({
 
 The key name (`builderAgent`) is conventional. Any key works. The `@mastra/editor/ee` subpath is gated by the Mastra Enterprise Edition license at runtime.
 
-See the [Agent Builder overview](https://mastra.ai/docs/agent-builder/overview) for the full setup checklist.
+See the [Agent Builder overview](https://agent-builder.mastra.ai/#prerequisites) for the full setup checklist.
 
 ## Namespaces
 
@@ -99,7 +92,7 @@ All namespaces extend a shared CRUD base class, so they expose the same `create`
 
 **agent.getById** (`(id: string, options?: GetByIdOptions) => Promise<Agent | null>`): Return a hydrated Agent instance for a stored agent. Pass options with versionId, versionNumber, or status ("draft" | "published" | "archived") to target a specific version. Default version requests are cached.
 
-**agent.update** (`(input: StorageUpdateAgentInput) => Promise<Agent>`): Partially update a stored agent. Creates a new draft version with the provided snapshot fields (instructions, tools, memory, and so on) and invalidates the cache. Set memory to null to disable memory.
+**agent.update** (`(input: StorageUpdateAgentInput) => Promise<Agent>`): Partially update a stored agent. Creates a version from the provided snapshot fields, assigns it to activeVersionId, and invalidates the cache. Set memory to null to disable memory.
 
 **agent.delete** (`(id: string) => Promise<void>`): Delete a stored agent and remove it from the Mastra runtime registry.
 
@@ -179,6 +172,24 @@ All namespaces extend a shared CRUD base class, so they expose the same `create`
 
 **scorer.clearCache** (`(id?: string) => void`): Clear the in-memory cache for one scorer or all scorers.
 
+### Agent namespace examples
+
+Create a stored override for an existing code-defined agent:
+
+```typescript
+import { mastra } from '../mastra'
+
+const editor = mastra.getEditor()!
+
+await editor.agent.create({
+  id: 'support-agent',
+  instructions: 'You are a friendly support agent for Acme.',
+  tools: {
+    search_kb: { description: 'Search the Acme knowledge base' },
+  },
+})
+```
+
 ## Methods
 
 ### Provider access
@@ -225,4 +236,6 @@ Returns the configured source (`'code'` or `'db'`), or `undefined` when the edit
 const source = mastra.getEditor()?.getSource()
 ```
 
-Returns: `'code' | 'db' | undefined`
+Returns: `'code' | 'db' | undefined`
+
+When `source` is omitted, Editor uses the configured database storage even though `getSource()` returns `undefined`. See [Editor storage options](https://mastra.ai/docs/editor/overview) for the storage workflows and [code-source versioning](https://mastra.ai/reference/editor/versioning) for activation and Git history behavior.