@mastra/mcp-docs-server 1.1.26-alpha.8 → 1.1.26

package/.docs/models/providers/poe.md

@@ -1,6 +1,6 @@
 # ![Poe logo](https://models.dev/logos/poe.svg)Poe
 
-Access 117 Poe models through Mastra's model router. Authentication is handled automatically using the `POE_API_KEY` environment variable.
+Access 118 Poe models through Mastra's model router. Authentication is handled automatically using the `POE_API_KEY` environment variable.
 
 Learn more in the [Poe documentation](https://creator.poe.com/docs/external-applications/openai-compatible-api).
 
@@ -41,6 +41,7 @@ for await (const chunk of stream) {
 | `poe/anthropic/claude-opus-4.1`        | 197K    |       |           |       |       |       | $13        | $64         |
 | `poe/anthropic/claude-opus-4.5`        | 197K    |       |           |       |       |       | $4         | $21         |
 | `poe/anthropic/claude-opus-4.6`        | 983K    |       |           |       |       |       | $4         | $21         |
+| `poe/anthropic/claude-opus-4.7`        | 1.0M    |       |           |       |       |       | $4         | $21         |
 | `poe/anthropic/claude-sonnet-3.7`      | 197K    |       |           |       |       |       | $3         | $13         |
 | `poe/anthropic/claude-sonnet-4`        | 983K    |       |           |       |       |       | $3         | $13         |
 | `poe/anthropic/claude-sonnet-4.5`      | 983K    |       |           |       |       |       | $3         | $13         |

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

@@ -0,0 +1,71 @@
+# ![Tencent Token Plan logo](https://models.dev/logos/tencent-token-plan.svg)Tencent Token Plan
+
+Access 1 Tencent Token Plan model through Mastra's model router. Authentication is handled automatically using the `TENCENT_TOKEN_PLAN_API_KEY` environment variable.
+
+Learn more in the [Tencent Token Plan documentation](https://cloud.tencent.com/document/product/1823/130060).
+
+```bash
+TENCENT_TOKEN_PLAN_API_KEY=your-api-key
+```
+
+```typescript
+import { Agent } from "@mastra/core/agent";
+
+const agent = new Agent({
+  id: "my-agent",
+  name: "My Agent",
+  instructions: "You are a helpful assistant",
+  model: "tencent-token-plan/hy3-preview"
+});
+
+// Generate a response
+const response = await agent.generate("Hello!");
+
+// Stream a response
+const stream = await agent.stream("Tell me a story");
+for await (const chunk of stream) {
+  console.log(chunk);
+}
+```
+
+> **Info:** Mastra uses the OpenAI-compatible `/chat/completions` endpoint. Some provider-specific features may not be available. Check the [Tencent Token Plan documentation](https://cloud.tencent.com/document/product/1823/130060) for details.
+
+## Models
+
+| Model                            | Context | Tools | Reasoning | Image | Audio | Video | Input $/1M | Output $/1M |
+| -------------------------------- | ------- | ----- | --------- | ----- | ----- | ----- | ---------- | ----------- |
+| `tencent-token-plan/hy3-preview` | 256K    |       |           |       |       |       | —          | —           |
+
+## Advanced configuration
+
+### Custom headers
+
+```typescript
+const agent = new Agent({
+  id: "custom-agent",
+  name: "custom-agent",
+  model: {
+    url: "https://api.lkeap.cloud.tencent.com/plan/v3",
+    id: "tencent-token-plan/hy3-preview",
+    apiKey: process.env.TENCENT_TOKEN_PLAN_API_KEY,
+    headers: {
+      "X-Custom-Header": "value"
+    }
+  }
+});
+```
+
+### Dynamic model selection
+
+```typescript
+const agent = new Agent({
+  id: "dynamic-agent",
+  name: "Dynamic Agent",
+  model: ({ requestContext }) => {
+    const useAdvanced = requestContext.task === "complex";
+    return useAdvanced
+      ? "tencent-token-plan/hy3-preview"
+      : "tencent-token-plan/hy3-preview";
+  }
+});
+```

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

@@ -0,0 +1,71 @@
+# ![Tencent TokenHub logo](https://models.dev/logos/tencent-tokenhub.svg)Tencent TokenHub
+
+Access 1 Tencent TokenHub model through Mastra's model router. Authentication is handled automatically using the `TENCENT_TOKENHUB_API_KEY` environment variable.
+
+Learn more in the [Tencent TokenHub documentation](https://cloud.tencent.com/document/product/1823/130050).
+
+```bash
+TENCENT_TOKENHUB_API_KEY=your-api-key
+```
+
+```typescript
+import { Agent } from "@mastra/core/agent";
+
+const agent = new Agent({
+  id: "my-agent",
+  name: "My Agent",
+  instructions: "You are a helpful assistant",
+  model: "tencent-tokenhub/hy3-preview"
+});
+
+// Generate a response
+const response = await agent.generate("Hello!");
+
+// Stream a response
+const stream = await agent.stream("Tell me a story");
+for await (const chunk of stream) {
+  console.log(chunk);
+}
+```
+
+> **Info:** Mastra uses the OpenAI-compatible `/chat/completions` endpoint. Some provider-specific features may not be available. Check the [Tencent TokenHub documentation](https://cloud.tencent.com/document/product/1823/130050) for details.
+
+## Models
+
+| Model                          | Context | Tools | Reasoning | Image | Audio | Video | Input $/1M | Output $/1M |
+| ------------------------------ | ------- | ----- | --------- | ----- | ----- | ----- | ---------- | ----------- |
+| `tencent-tokenhub/hy3-preview` | 256K    |       |           |       |       |       | —          | —           |
+
+## Advanced configuration
+
+### Custom headers
+
+```typescript
+const agent = new Agent({
+  id: "custom-agent",
+  name: "custom-agent",
+  model: {
+    url: "https://tokenhub.tencentmaas.com/v1",
+    id: "tencent-tokenhub/hy3-preview",
+    apiKey: process.env.TENCENT_TOKENHUB_API_KEY,
+    headers: {
+      "X-Custom-Header": "value"
+    }
+  }
+});
+```
+
+### Dynamic model selection
+
+```typescript
+const agent = new Agent({
+  id: "dynamic-agent",
+  name: "Dynamic Agent",
+  model: ({ requestContext }) => {
+    const useAdvanced = requestContext.task === "complex";
+    return useAdvanced
+      ? "tencent-tokenhub/hy3-preview"
+      : "tencent-tokenhub/hy3-preview";
+  }
+});
+```

package/.docs/models/providers/wafer.ai.md

@@ -0,0 +1,72 @@
+# ![Wafer logo](https://models.dev/logos/wafer.ai.svg)Wafer
+
+Access 2 Wafer models through Mastra's model router. Authentication is handled automatically using the `WAFER_API_KEY` environment variable.
+
+Learn more in the [Wafer documentation](https://docs.wafer.ai/wafer-pass).
+
+```bash
+WAFER_API_KEY=your-api-key
+```
+
+```typescript
+import { Agent } from "@mastra/core/agent";
+
+const agent = new Agent({
+  id: "my-agent",
+  name: "My Agent",
+  instructions: "You are a helpful assistant",
+  model: "wafer.ai/GLM-5.1"
+});
+
+// Generate a response
+const response = await agent.generate("Hello!");
+
+// Stream a response
+const stream = await agent.stream("Tell me a story");
+for await (const chunk of stream) {
+  console.log(chunk);
+}
+```
+
+> **Info:** Mastra uses the OpenAI-compatible `/chat/completions` endpoint. Some provider-specific features may not be available. Check the [Wafer documentation](https://docs.wafer.ai/wafer-pass) for details.
+
+## Models
+
+| Model                        | Context | Tools | Reasoning | Image | Audio | Video | Input $/1M | Output $/1M |
+| ---------------------------- | ------- | ----- | --------- | ----- | ----- | ----- | ---------- | ----------- |
+| `wafer.ai/GLM-5.1`           | 203K    |       |           |       |       |       | —          | —           |
+| `wafer.ai/Qwen3.5-397B-A17B` | 262K    |       |           |       |       |       | —          | —           |
+
+## Advanced configuration
+
+### Custom headers
+
+```typescript
+const agent = new Agent({
+  id: "custom-agent",
+  name: "custom-agent",
+  model: {
+    url: "https://pass.wafer.ai/v1",
+    id: "wafer.ai/GLM-5.1",
+    apiKey: process.env.WAFER_API_KEY,
+    headers: {
+      "X-Custom-Header": "value"
+    }
+  }
+});
+```
+
+### Dynamic model selection
+
+```typescript
+const agent = new Agent({
+  id: "dynamic-agent",
+  name: "Dynamic Agent",
+  model: ({ requestContext }) => {
+    const useAdvanced = requestContext.task === "complex";
+    return useAdvanced
+      ? "wafer.ai/Qwen3.5-397B-A17B"
+      : "wafer.ai/GLM-5.1";
+  }
+});
+```

package/.docs/models/providers/zenmux.md

@@ -1,6 +1,6 @@
 # ![ZenMux logo](https://models.dev/logos/zenmux.svg)ZenMux
 
-Access 88 ZenMux models through Mastra's model router. Authentication is handled automatically using the `ZENMUX_API_KEY` environment variable.
+Access 89 ZenMux models through Mastra's model router. Authentication is handled automatically using the `ZENMUX_API_KEY` environment variable.
 
 Learn more in the [ZenMux documentation](https://docs.zenmux.ai).
 
@@ -68,6 +68,7 @@ for await (const chunk of stream) {
 | `zenmux/moonshotai/kimi-k2-thinking`          | 262K    |       |           |       |       |       | $0.60      | $3          |
 | `zenmux/moonshotai/kimi-k2-thinking-turbo`    | 262K    |       |           |       |       |       | $1         | $8          |
 | `zenmux/moonshotai/kimi-k2.5`                 | 262K    |       |           |       |       |       | $0.58      | $3          |
+| `zenmux/moonshotai/kimi-k2.6`                 | 262K    |       |           |       |       |       | $0.95      | $4          |
 | `zenmux/openai/gpt-5`                         | 400K    |       |           |       |       |       | $1         | $10         |
 | `zenmux/openai/gpt-5-codex`                   | 400K    |       |           |       |       |       | $1         | $10         |
 | `zenmux/openai/gpt-5.1`                       | 400K    |       |           |       |       |       | $1         | $10         |

package/.docs/models/providers.md

@@ -26,6 +26,7 @@ Direct access to individual AI model providers. Each provider offers unique mode
 - [Cortecs](https://mastra.ai/models/providers/cortecs)
 - [D.Run (China)](https://mastra.ai/models/providers/drun)
 - [Deep Infra](https://mastra.ai/models/providers/deepinfra)
+- [DigitalOcean](https://mastra.ai/models/providers/digitalocean)
 - [DInference](https://mastra.ai/models/providers/dinference)
 - [evroc](https://mastra.ai/models/providers/evroc)
 - [FastRouter](https://mastra.ai/models/providers/fastrouter)
@@ -83,11 +84,14 @@ Direct access to individual AI model providers. Each provider offers unique mode
 - [submodel](https://mastra.ai/models/providers/submodel)
 - [Synthetic](https://mastra.ai/models/providers/synthetic)
 - [Tencent Coding Plan (China)](https://mastra.ai/models/providers/tencent-coding-plan)
+- [Tencent Token Plan](https://mastra.ai/models/providers/tencent-token-plan)
+- [Tencent TokenHub](https://mastra.ai/models/providers/tencent-tokenhub)
 - [The Grid AI](https://mastra.ai/models/providers/the-grid-ai)
 - [Together AI](https://mastra.ai/models/providers/togetherai)
 - [Upstage](https://mastra.ai/models/providers/upstage)
 - [Vivgrid](https://mastra.ai/models/providers/vivgrid)
 - [Vultr](https://mastra.ai/models/providers/vultr)
+- [Wafer](https://mastra.ai/models/providers/wafer.ai)
 - [Weights & Biases](https://mastra.ai/models/providers/wandb)
 - [Xiaomi](https://mastra.ai/models/providers/xiaomi)
 - [Xiaomi Token Plan (China)](https://mastra.ai/models/providers/xiaomi-token-plan-cn)

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

@@ -298,6 +298,14 @@ const response = await agent.generate('Help me organize my day', {
 
 **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]\(/docs/editor/overview#sub-agent-versioning).
+
+**options.versions.agents** (`Record<string, VersionSelector>`): A map of agent IDs to their version selectors.
+
+**options.versions.agents.versionId** (`string`): Target a specific version by ID.
+
+**options.versions.agents.status** (`'draft' | 'published'`): Target the latest version with this publication status.
+
 **options.includeRawChunks** (`boolean`): Whether to include raw chunks in the stream output. Not available on all model providers.
 
 ## Response structure

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

@@ -140,6 +140,18 @@ await run.resume({
 })
 ```
 
+When a [`.foreach()`](https://mastra.ai/reference/workflows/workflow-methods/foreach) step suspends across multiple iterations, pass `forEachIndex` (zero-based; `0` targets the first iteration) to resume one iteration at a time. Iterations you don't target remain suspended.
+
+```typescript
+await run.resume({
+  step: 'approve',
+  resumeData: { ok: true },
+  forEachIndex: 1, // resumes the second iteration
+})
+```
+
+`forEachIndex` is also supported by `resumeAsync()` and `resumeStream()`.
+
 ### `cancel()`
 
 Cancel a running workflow:

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

@@ -63,4 +63,12 @@ Visit the [Configuration reference](https://mastra.ai/reference/configuration) f
 
 **gateways** (`Record<string, MastraModelGateway>`): Custom model gateways to register for accessing AI models through alternative providers or private deployments. Structured as a key-value pair, with keys being the registry key (used for getGateway()) and values being gateway instances. (Default: `{}`)
 
-**memory** (`Record<string, MastraMemory>`): Memory instances to register. These can be referenced by stored agents and resolved at runtime. Structured as a key-value pair, with keys being the registry key and values being memory instances. (Default: `{}`)
+**memory** (`Record<string, MastraMemory>`): Memory instances to register. These can be referenced by stored agents and resolved at runtime. Structured as a key-value pair, with keys being the registry key and values being memory instances. (Default: `{}`)
+
+**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]\(/docs/editor/overview#sub-agent-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.
+
+**versions.agents.versionId** (`string`): The ID of a specific version to use.
+
+**versions.agents.status** (`'draft' | 'published'`): Select the latest version with this publication status.

package/.docs/reference/deployer/cloudflare.md

@@ -117,4 +117,17 @@ export const mastra = new Mastra({
     ],
   },
 })
-```
+```
+
+> **Keep bindings inline inside new Mastra({...}):** Mastra's Babel plugin defers `new Mastra(...)` so that `env` is available when it runs. Code outside that call evaluates at module load before `env` is populated.
+>
+> ```typescript
+> // ✅ Works — binding is inside new Mastra(), so it's deferred
+> export const mastra = new Mastra({
+>   storage: new D1Store({ binding: env.DB }),
+> })
+>
+> // ❌ Breaks — env.DB is undefined at module load
+> const storage = new D1Store({ binding: env.DB })
+> export const mastra = new Mastra({ storage })
+> ```

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

@@ -1,6 +1,6 @@
 # NetlifyDeployer
 
-The `NetlifyDeployer` class handles packaging, configuration, and deployment by adapting Mastra's output to create an optimized version of your server. It extends the base [`Deployer`](https://mastra.ai/reference/deployer) class with Netlify specific functionality. It enables you to run Mastra within Netlify functions.
+The `NetlifyDeployer` class handles packaging, configuration, and deployment by adapting Mastra's output to create an optimized version of your server. It extends the base [`Deployer`](https://mastra.ai/reference/deployer) class with Netlify-specific functionality. It enables you to run Mastra within Netlify serverless functions or edge functions.
 
 ## Installation
 
@@ -43,9 +43,31 @@ export const mastra = new Mastra({
 })
 ```
 
+## Constructor options
+
+- `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, no hard timeout).
+
+### Edge functions example
+
+```typescript
+import { Mastra } from '@mastra/core'
+import { NetlifyDeployer } from '@mastra/deployer-netlify'
+
+export const mastra = new Mastra({
+  deployer: new NetlifyDeployer({
+    target: 'edge',
+  }),
+})
+```
+
 ## Output
 
-After running `mastra build`, the deployer generates a `.netlify` folder. The build output includes all agents, tools, and workflows of your project, alongside a special `config.json` file. The `config.json` file configures the behavior of Netlify functions.
+After running `mastra build`, the deployer generates a `.netlify` folder. The build output includes all agents, tools, and workflows of your project, alongside a `config.json` file that configures the [Netlify Frameworks API](https://docs.netlify.com/build/frameworks/frameworks-api/).
+
+### Serverless output (default)
 
 ```bash
 your-project/
@@ -77,4 +99,30 @@ The `config.json` file contains:
     }
   ]
 }
+```
+
+### Edge output
+
+```bash
+your-project/
+└── .netlify/
+    └── v1/
+        ├── config.json
+        └── edge-functions/
+            ├── index.mjs
+            ├── package.json
+            └── node_modules/
+```
+
+The `config.json` file contains:
+
+```json
+{
+  "edge_functions": [
+    {
+      "function": "index",
+      "path": "/*"
+    }
+  ]
+}
 ```

package/.docs/reference/harness/harness-class.md

@@ -458,6 +458,12 @@ Respond to a pending question from the `ask_user` built-in tool.
 harness.respondToQuestion({ questionId: 'q-123', answer: 'Yes, proceed with the refactor' })
 ```
 
+For multi-select questions, pass the selected option labels as a string array.
+
+```typescript
+harness.respondToQuestion({ questionId: 'q-123', answer: ['Add tests', 'Update docs'] })
+```
+
 #### `respondToPlanApproval({ planId, response })`
 
 Respond to a pending plan approval from the `submit_plan` built-in tool. The `response` object contains `action` (`'approved'` or `'rejected'`) and an optional `feedback` string.
@@ -700,57 +706,74 @@ unsubscribe()
 
 The harness emits events through registered listeners. The following table lists the available event types:
 
-| Event type                 | Description                                                         |
-| -------------------------- | ------------------------------------------------------------------- |
-| `mode_changed`             | The active mode changed.                                            |
-| `model_changed`            | The active model changed.                                           |
-| `thread_changed`           | The active thread changed.                                          |
-| `thread_created`           | A new thread was created.                                           |
-| `thread_deleted`           | A thread was deleted.                                               |
-| `state_changed`            | Harness state was updated.                                          |
-| `agent_start`              | The agent started processing.                                       |
-| `agent_end`                | The agent finished processing.                                      |
-| `message_start`            | A new message started streaming.                                    |
-| `message_update`           | A message was updated with new content.                             |
-| `message_end`              | A message finished streaming.                                       |
-| `tool_start`               | A tool call started.                                                |
-| `tool_approval_required`   | A tool call requires user approval.                                 |
-| `tool_update`              | A tool call was updated with progress.                              |
-| `tool_end`                 | A tool call finished.                                               |
-| `tool_input_start`         | Tool input started streaming.                                       |
-| `tool_input_delta`         | Tool input received a streaming delta.                              |
-| `tool_input_end`           | Tool input finished streaming.                                      |
-| `usage_update`             | Token usage was updated.                                            |
-| `error`                    | An error occurred.                                                  |
-| `info`                     | An informational message was emitted.                               |
-| `follow_up_queued`         | A follow-up message was queued.                                     |
-| `workspace_status_changed` | The workspace status changed.                                       |
-| `workspace_ready`          | The workspace finished initializing.                                |
-| `workspace_error`          | The workspace encountered an error.                                 |
-| `om_status`                | Observational Memory status update.                                 |
-| `om_observation_start`     | An observation started.                                             |
-| `om_observation_end`       | An observation completed.                                           |
-| `om_reflection_start`      | A reflection started.                                               |
-| `om_reflection_end`        | A reflection completed.                                             |
-| `ask_question`             | The agent asked a question via the `ask_user` tool.                 |
-| `plan_approval_required`   | The agent submitted a plan for approval via the `submit_plan` tool. |
-| `plan_approved`            | A plan was approved.                                                |
-| `subagent_start`           | A subagent started processing.                                      |
-| `subagent_text_delta`      | A subagent emitted a text delta.                                    |
-| `subagent_tool_start`      | A subagent started a tool call.                                     |
-| `subagent_tool_end`        | A subagent finished a tool call.                                    |
-| `subagent_end`             | A subagent finished processing.                                     |
-| `subagent_model_changed`   | A subagent's model changed.                                         |
-| `task_updated`             | A task list was updated.                                            |
+| Event type                 | Description                                                                                         |
+| -------------------------- | --------------------------------------------------------------------------------------------------- |
+| `mode_changed`             | The active mode changed.                                                                            |
+| `model_changed`            | The active model changed.                                                                           |
+| `thread_changed`           | The active thread changed.                                                                          |
+| `thread_created`           | A new thread was created.                                                                           |
+| `thread_deleted`           | A thread was deleted.                                                                               |
+| `state_changed`            | Harness state was updated.                                                                          |
+| `agent_start`              | The agent started processing.                                                                       |
+| `agent_end`                | The agent finished processing.                                                                      |
+| `message_start`            | A new message started streaming.                                                                    |
+| `message_update`           | A message was updated with new content.                                                             |
+| `message_end`              | A message finished streaming.                                                                       |
+| `tool_start`               | A tool call started.                                                                                |
+| `tool_approval_required`   | A tool call requires user approval.                                                                 |
+| `tool_update`              | A tool call was updated with progress.                                                              |
+| `tool_end`                 | A tool call finished.                                                                               |
+| `tool_input_start`         | Tool input started streaming.                                                                       |
+| `tool_input_delta`         | Tool input received a streaming delta.                                                              |
+| `tool_input_end`           | Tool input finished streaming.                                                                      |
+| `usage_update`             | Token usage was updated.                                                                            |
+| `error`                    | An error occurred.                                                                                  |
+| `info`                     | An informational message was emitted.                                                               |
+| `follow_up_queued`         | A follow-up message was queued.                                                                     |
+| `workspace_status_changed` | The workspace status changed.                                                                       |
+| `workspace_ready`          | The workspace finished initializing.                                                                |
+| `workspace_error`          | The workspace encountered an error.                                                                 |
+| `om_status`                | Observational Memory status update.                                                                 |
+| `om_observation_start`     | An observation started.                                                                             |
+| `om_observation_end`       | An observation completed.                                                                           |
+| `om_reflection_start`      | A reflection started.                                                                               |
+| `om_reflection_end`        | A reflection completed.                                                                             |
+| `ask_question`             | The agent asked a question via the `ask_user` tool. Includes optional choices and a selection mode. |
+| `plan_approval_required`   | The agent submitted a plan for approval via the `submit_plan` tool.                                 |
+| `plan_approved`            | A plan was approved.                                                                                |
+| `subagent_start`           | A subagent started processing.                                                                      |
+| `subagent_text_delta`      | A subagent emitted a text delta.                                                                    |
+| `subagent_tool_start`      | A subagent started a tool call.                                                                     |
+| `subagent_tool_end`        | A subagent finished a tool call.                                                                    |
+| `subagent_end`             | A subagent finished processing.                                                                     |
+| `subagent_model_changed`   | A subagent's model changed.                                                                         |
+| `task_updated`             | A task list was updated.                                                                            |
 
 ## Built-in tools
 
 The harness provides built-in tools to agents in every mode:
 
-| Tool          | Description                                                                                      |
-| ------------- | ------------------------------------------------------------------------------------------------ |
-| `ask_user`    | Ask the user a question and wait for their response.                                             |
-| `submit_plan` | Submit a plan for user review and approval.                                                      |
-| `task_write`  | Create or update a structured task list for tracking progress.                                   |
-| `task_check`  | Check the completion status of the current task list.                                            |
-| `subagent`    | Spawn a focused subagent with constrained tools (only available when `subagents` is configured). |
+| Tool          | Description                                                                                                               |
+| ------------- | ------------------------------------------------------------------------------------------------------------------------- |
+| `ask_user`    | Ask the user a question and wait for their response. Supports free text, single-select choices, and multi-select choices. |
+| `submit_plan` | Submit a plan for user review and approval.                                                                               |
+| `task_write`  | Create or update a structured task list for tracking progress.                                                            |
+| `task_check`  | Check the completion status of the current task list.                                                                     |
+| `subagent`    | Spawn a focused subagent with constrained tools (only available when `subagents` is configured).                          |
+
+### `ask_user` selections
+
+The `ask_user` tool accepts `options` for choice prompts. Set `selectionMode` to `single_select` to let the user pick one option, or `multi_select` to let the user pick multiple options. When `options` are provided and `selectionMode` is omitted, the prompt defaults to `single_select`. Omit `options` for free-text questions.
+
+The following example demonstrates a multi-select response handler. The UI reads `event.selectionMode`, lets the user choose multiple options, then returns a string array with `respondToQuestion()`.
+
+```typescript
+harness.subscribe(event => {
+  if (event.type === 'ask_question' && event.selectionMode === 'multi_select') {
+    harness.respondToQuestion({
+      questionId: event.questionId,
+      answer: ['Add tests', 'Update docs'],
+    })
+  }
+})
+```

package/.docs/reference/index.md

@@ -201,6 +201,7 @@ The Reference section provides documentation of Mastra's API, including paramete
 - [MongoDB Storage](https://mastra.ai/reference/storage/mongodb)
 - [MSSQL Storage](https://mastra.ai/reference/storage/mssql)
 - [PostgreSQL Storage](https://mastra.ai/reference/storage/postgresql)
+- [Redis Storage](https://mastra.ai/reference/storage/redis)
 - [Upstash Storage](https://mastra.ai/reference/storage/upstash)
 - [ChunkType](https://mastra.ai/reference/streaming/ChunkType)
 - [MastraModelOutput](https://mastra.ai/reference/streaming/agents/MastraModelOutput)
@@ -217,6 +218,7 @@ The Reference section provides documentation of Mastra's API, including paramete
 - [createVectorQueryTool()](https://mastra.ai/reference/tools/vector-query-tool)
 - [MCPClient](https://mastra.ai/reference/tools/mcp-client)
 - [MCPServer](https://mastra.ai/reference/tools/mcp-server)
+- [Tavily Tools](https://mastra.ai/reference/tools/tavily)
 - [Amazon S3 Vector Store](https://mastra.ai/reference/vectors/s3vectors)
 - [Astra Vector Store](https://mastra.ai/reference/vectors/astra)
 - [Chroma Vector Store](https://mastra.ai/reference/vectors/chroma)

package/.docs/reference/observability/tracing/exporters/langfuse.md

@@ -16,6 +16,8 @@ interface LangfuseExporterConfig extends BaseExporterConfig {
   secretKey?: string
   baseUrl?: string
   realtime?: boolean
+  flushAt?: number
+  flushInterval?: number
   environment?: string
   release?: string
 }

package/.docs/reference/processors/prefill-error-handler.md

@@ -1,14 +1,14 @@
 # PrefillErrorHandler
 
-The `PrefillErrorHandler` is an **error processor** that handles the Anthropic "assistant message prefill" error. This error occurs when a conversation ends with an assistant message and the model doesn't support prefilling assistant responses.
+The `PrefillErrorHandler` is an **error processor** that handles assistant-response prefill errors. This error occurs when a conversation ends with an assistant message and the model rejects the request because it interprets it as prefilling the assistant response.
 
 When the error is detected, the processor appends a hidden `<system-reminder>continue</system-reminder>` user message to the conversation and signals a retry. The reminder is persisted with `metadata.systemReminder = { type: 'anthropic-prefill-processor-retry' }`, which keeps it available for retry reconstruction and raw history while standard UI-facing message conversions hide it.
 
-Add this processor to `errorProcessors` when you want Mastra to recover from Anthropic assistant message prefill errors.
+Add this processor to `errorProcessors` when you want Mastra to recover from assistant prefill rejections (for example Anthropic's "assistant message prefill" and Qwen/llama.cpp's "assistant response prefill is incompatible with `enable_thinking`" errors).
 
 ## How it works
 
-1. The LLM API call fails with a message containing "assistant message prefill"
+1. The LLM API call fails with a known assistant-prefill rejection message
 2. `PrefillErrorHandler` checks that this is the first retry attempt
 3. It appends a hidden `<system-reminder>continue</system-reminder>` user message to the `messageList`
 4. It returns `{ retry: true }` to signal the LLM call should be retried with the modified messages
@@ -17,7 +17,7 @@ The processor now reacts to the API rejection itself instead of re-checking whet
 
 ## Usage example
 
-Add `PrefillErrorHandler` to `errorProcessors` for any agent that should retry Anthropic prefill failures:
+Add `PrefillErrorHandler` to `errorProcessors` for any agent that should retry assistant-prefill failures:
 
 ```typescript
 import { Agent } from '@mastra/core/agent'
@@ -62,7 +62,7 @@ The `PrefillErrorHandler` takes no constructor parameters.
 
 **name** (`'Prefill Error Handler'`): Processor display name.
 
-**processAPIError** (`(args: ProcessAPIErrorArgs) => ProcessAPIErrorResult | void`): Handles the Anthropic prefill error by appending a hidden system reminder continue message and signaling retry. Only triggers on the first retry attempt.
+**processAPIError** (`(args: ProcessAPIErrorArgs) => ProcessAPIErrorResult | void`): Handles known assistant-prefill errors by appending a hidden system reminder continue message and signaling retry. Only triggers on the first retry attempt.
 
 ## Related