@mastra/mcp-docs-server 1.2.7-alpha.14 → 1.2.7-alpha.18

package/.docs/models/providers/openai.md

@@ -142,7 +142,7 @@ const response = await agent.generate("Hello!", {
 
 **conversation** (`string | null | undefined`)
 
-**include** (`("file_search_call.results" | "message.output_text.logprobs" | "reasoning.encrypted_content")[] | null | undefined`)
+**include** (`("web_search_call.results" | "file_search_call.results" | "message.output_text.logprobs" | "reasoning.encrypted_content")[] | null | undefined`)
 
 **instructions** (`string | null | undefined`)
 
@@ -158,18 +158,26 @@ const response = await agent.generate("Hello!", {
 
 **promptCacheKey** (`string | null | undefined`)
 
+**promptCacheOptions** (`{ mode?: "explicit" | "implicit" | undefined; ttl?: "30m" | undefined; } | undefined`)
+
 **promptCacheRetention** (`"in_memory" | "24h" | null | undefined`)
 
 **reasoningEffort** (`string | null | undefined`)
 
+**reasoningMode** (`"standard" | "pro" | undefined`)
+
+**reasoningContext** (`"auto" | "current_turn" | "all_turns" | undefined`)
+
 **reasoningSummary** (`string | null | undefined`)
 
 **safetyIdentifier** (`string | null | undefined`)
 
-**serviceTier** (`"default" | "auto" | "flex" | "priority" | null | undefined`)
+**serviceTier** (`"auto" | "default" | "flex" | "priority" | null | undefined`)
 
 **store** (`boolean | null | undefined`): Controls whether OpenAI stores your API requests for model training. Required to be "false" if your organization has zero data retention enabled. See: https\://platform.openai.com/docs/guides/your-data#zero-data-retention
 
+**passThroughUnsupportedFiles** (`boolean | undefined`)
+
 **strictJsonSchema** (`boolean | null | undefined`)
 
 **textVerbosity** (`"low" | "medium" | "high" | null | undefined`)

package/.docs/models/providers/snowflake-cortex.md

@@ -2,7 +2,7 @@
 
 # ![Snowflake Cortex logo](https://models.dev/logos/snowflake-cortex.svg)Snowflake Cortex
 
-Access 18 Snowflake Cortex models through Mastra's model router. Authentication is handled automatically using the `SNOWFLAKE_CORTEX_PAT` environment variable. Configure `SNOWFLAKE_ACCOUNT` as well.
+Access 21 Snowflake Cortex models through Mastra's model router. Authentication is handled automatically using the `SNOWFLAKE_CORTEX_PAT` environment variable. Configure `SNOWFLAKE_ACCOUNT` as well.
 
 Learn more in the [Snowflake Cortex documentation](https://docs.snowflake.com/en/user-guide/snowflake-cortex/cortex-rest-api).
 
@@ -54,6 +54,9 @@ for await (const chunk of stream) {
 | `snowflake-cortex/openai-gpt-5.2`         | 400K    |       |           |       |       |       | —          | —           |
 | `snowflake-cortex/openai-gpt-5.4`         | 1.1M    |       |           |       |       |       | —          | —           |
 | `snowflake-cortex/openai-gpt-5.5`         | 1.1M    |       |           |       |       |       | —          | —           |
+| `snowflake-cortex/openai-gpt-5.6-luna`    | 1.1M    |       |           |       |       |       | —          | —           |
+| `snowflake-cortex/openai-gpt-5.6-sol`     | 1.1M    |       |           |       |       |       | —          | —           |
+| `snowflake-cortex/openai-gpt-5.6-terra`   | 1.1M    |       |           |       |       |       | —          | —           |
 | `snowflake-cortex/snowflake-llama3.3-70b` | 128K    |       |           |       |       |       | —          | —           |
 
 ## Advanced configuration

package/.docs/models/providers/stepfun-ai-step-plan.md

@@ -0,0 +1,75 @@
+> Discover all available pages from the documentation index: https://mastra.ai/llms.txt
+
+# ![StepFun Step Plan (Global) logo](https://models.dev/logos/stepfun-ai-step-plan.svg)StepFun Step Plan (Global)
+
+Access 3 StepFun Step Plan (Global) models through Mastra's model router. Authentication is handled automatically using the `STEPFUN_API_KEY` environment variable.
+
+Learn more in the [StepFun Step Plan (Global) documentation](https://platform.stepfun.ai/docs/en/step-plan/integrations/reasoning-api).
+
+```bash
+STEPFUN_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: "stepfun-ai-step-plan/step-3.5-flash"
+});
+
+// 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 [StepFun Step Plan (Global) documentation](https://platform.stepfun.ai/docs/en/step-plan/integrations/reasoning-api) for details.
+
+## Models
+
+| Model                                      | Context | Tools | Reasoning | Image | Audio | Video | Input $/1M | Output $/1M |
+| ------------------------------------------ | ------- | ----- | --------- | ----- | ----- | ----- | ---------- | ----------- |
+| `stepfun-ai-step-plan/step-3.5-flash`      | 256K    |       |           |       |       |       | —          | —           |
+| `stepfun-ai-step-plan/step-3.5-flash-2603` | 256K    |       |           |       |       |       | —          | —           |
+| `stepfun-ai-step-plan/step-3.7-flash`      | 256K    |       |           |       |       |       | —          | —           |
+
+## Advanced configuration
+
+### Custom headers
+
+```typescript
+const agent = new Agent({
+  id: "custom-agent",
+  name: "custom-agent",
+  model: {
+    url: "https://api.stepfun.ai/step_plan/v1",
+    id: "stepfun-ai-step-plan/step-3.5-flash",
+    apiKey: process.env.STEPFUN_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
+      ? "stepfun-ai-step-plan/step-3.7-flash"
+      : "stepfun-ai-step-plan/step-3.5-flash";
+  }
+});
+```

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

@@ -1,10 +1,10 @@
 > Discover all available pages from the documentation index: https://mastra.ai/llms.txt
 
-# ![StepFun AI logo](https://models.dev/logos/stepfun-ai.svg)StepFun AI
+# ![StepFun (Global) logo](https://models.dev/logos/stepfun-ai.svg)StepFun (Global)
 
-Access 8 StepFun AI models through Mastra's model router. Authentication is handled automatically using the `STEPFUN_API_KEY` environment variable.
+Access 8 StepFun (Global) models through Mastra's model router. Authentication is handled automatically using the `STEPFUN_API_KEY` environment variable.
 
-Learn more in the [StepFun AI documentation](https://platform.stepfun.ai/docs/en/step-plan/integrations/open-code).
+Learn more in the [StepFun (Global) documentation](https://platform.stepfun.ai/docs/en/overview/concept).
 
 ```bash
 STEPFUN_API_KEY=your-api-key
@@ -30,7 +30,7 @@ for await (const chunk of stream) {
 }
 ```
 
-> **Info:** Mastra uses the OpenAI-compatible `/chat/completions` endpoint. Some provider-specific features may not be available. Check the [StepFun AI documentation](https://platform.stepfun.ai/docs/en/step-plan/integrations/open-code) for details.
+> **Info:** Mastra uses the OpenAI-compatible `/chat/completions` endpoint. Some provider-specific features may not be available. Check the [StepFun (Global) documentation](https://platform.stepfun.ai/docs/en/overview/concept) for details.
 
 ## Models
 
@@ -40,7 +40,7 @@ for await (const chunk of stream) {
 | `stepfun-ai/step-2-16k`          | 16K     |       |           |       |       |       | $5         | $16         |
 | `stepfun-ai/step-3.5-flash`      | 256K    |       |           |       |       |       | $0.10      | $0.30       |
 | `stepfun-ai/step-3.5-flash-2603` | 256K    |       |           |       |       |       | $0.10      | $0.30       |
-| `stepfun-ai/step-3.7-flash`      | 256K    |       |           |       |       |       | $0.20      | $1          |
+| `stepfun-ai/step-3.7-flash`      | 256K    |       |           |       |       |       | $0.18      | $1          |
 | `stepfun-ai/step-tts-2`          | —       |       |           |       |       |       | —          | —           |
 | `stepfun-ai/stepaudio-2.5-asr`   | —       |       |           |       |       |       | —          | —           |
 | `stepfun-ai/stepaudio-2.5-tts`   | —       |       |           |       |       |       | —          | —           |
@@ -54,7 +54,7 @@ const agent = new Agent({
   id: "custom-agent",
   name: "custom-agent",
   model: {
-    url: "https://api.stepfun.ai/step_plan/v1",
+    url: "https://api.stepfun.ai/v1",
     id: "stepfun-ai/step-1-32k",
     apiKey: process.env.STEPFUN_API_KEY,
     headers: {

package/.docs/models/providers/stepfun-step-plan.md

@@ -0,0 +1,76 @@
+> Discover all available pages from the documentation index: https://mastra.ai/llms.txt
+
+# ![StepFun Step Plan (China) logo](https://models.dev/logos/stepfun-step-plan.svg)StepFun Step Plan (China)
+
+Access 4 StepFun Step Plan (China) models through Mastra's model router. Authentication is handled automatically using the `STEPFUN_API_KEY` environment variable.
+
+Learn more in the [StepFun Step Plan (China) documentation](https://platform.stepfun.com/docs/zh/step-plan/integrations/reasoning-api).
+
+```bash
+STEPFUN_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: "stepfun-step-plan/step-3.5-flash"
+});
+
+// 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 [StepFun Step Plan (China) documentation](https://platform.stepfun.com/docs/zh/step-plan/integrations/reasoning-api) for details.
+
+## Models
+
+| Model                                   | Context | Tools | Reasoning | Image | Audio | Video | Input $/1M | Output $/1M |
+| --------------------------------------- | ------- | ----- | --------- | ----- | ----- | ----- | ---------- | ----------- |
+| `stepfun-step-plan/step-3.5-flash`      | 256K    |       |           |       |       |       | —          | —           |
+| `stepfun-step-plan/step-3.5-flash-2603` | 256K    |       |           |       |       |       | —          | —           |
+| `stepfun-step-plan/step-3.7-flash`      | 256K    |       |           |       |       |       | —          | —           |
+| `stepfun-step-plan/step-router-v1`      | 256K    |       |           |       |       |       | —          | —           |
+
+## Advanced configuration
+
+### Custom headers
+
+```typescript
+const agent = new Agent({
+  id: "custom-agent",
+  name: "custom-agent",
+  model: {
+    url: "https://api.stepfun.com/step_plan/v1",
+    id: "stepfun-step-plan/step-3.5-flash",
+    apiKey: process.env.STEPFUN_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
+      ? "stepfun-step-plan/step-router-v1"
+      : "stepfun-step-plan/step-3.5-flash";
+  }
+});
+```

package/.docs/models/providers/stepfun.md

@@ -1,10 +1,10 @@
 > Discover all available pages from the documentation index: https://mastra.ai/llms.txt
 
-# ![StepFun logo](https://models.dev/logos/stepfun.svg)StepFun
+# ![StepFun (China) logo](https://models.dev/logos/stepfun.svg)StepFun (China)
 
-Access 8 StepFun models through Mastra's model router. Authentication is handled automatically using the `STEPFUN_API_KEY` environment variable.
+Access 8 StepFun (China) models through Mastra's model router. Authentication is handled automatically using the `STEPFUN_API_KEY` environment variable.
 
-Learn more in the [StepFun documentation](https://platform.stepfun.com/docs/zh/overview/concept).
+Learn more in the [StepFun (China) documentation](https://platform.stepfun.com/docs/zh/overview/concept).
 
 ```bash
 STEPFUN_API_KEY=your-api-key
@@ -30,7 +30,7 @@ for await (const chunk of stream) {
 }
 ```
 
-> **Info:** Mastra uses the OpenAI-compatible `/chat/completions` endpoint. Some provider-specific features may not be available. Check the [StepFun documentation](https://platform.stepfun.com/docs/zh/overview/concept) for details.
+> **Info:** Mastra uses the OpenAI-compatible `/chat/completions` endpoint. Some provider-specific features may not be available. Check the [StepFun (China) documentation](https://platform.stepfun.com/docs/zh/overview/concept) for details.
 
 ## Models
 
@@ -40,7 +40,7 @@ for await (const chunk of stream) {
 | `stepfun/step-2-16k`          | 16K     |       |           |       |       |       | $5         | $16         |
 | `stepfun/step-3.5-flash`      | 256K    |       |           |       |       |       | $0.10      | $0.30       |
 | `stepfun/step-3.5-flash-2603` | 256K    |       |           |       |       |       | $0.10      | $0.30       |
-| `stepfun/step-3.7-flash`      | 256K    |       |           |       |       |       | $0.20      | $1          |
+| `stepfun/step-3.7-flash`      | 256K    |       |           |       |       |       | $0.18      | $1          |
 | `stepfun/step-tts-2`          | —       |       |           |       |       |       | —          | —           |
 | `stepfun/stepaudio-2.5-asr`   | —       |       |           |       |       |       | —          | —           |
 | `stepfun/stepaudio-2.5-tts`   | —       |       |           |       |       |       | —          | —           |

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

@@ -93,7 +93,7 @@ const response = await agent.generate("Hello!", {
 
 ### Available Options
 
-**reasoningEffort** (`"low" | "high" | undefined`)
+**reasoningEffort** (`"none" | "low" | "medium" | "high" | undefined`)
 
 **logprobs** (`boolean | undefined`)
 

package/.docs/models/providers.md

@@ -44,6 +44,7 @@ Direct access to individual AI model providers. Each provider offers unique mode
 - [Deep Infra](https://mastra.ai/models/providers/deepinfra)
 - [DigitalOcean](https://mastra.ai/models/providers/digitalocean)
 - [DInference](https://mastra.ai/models/providers/dinference)
+- [EBCloud](https://mastra.ai/models/providers/ebcloud)
 - [EmpirioLabs AI](https://mastra.ai/models/providers/empiriolabs)
 - [evroc](https://mastra.ai/models/providers/evroc)
 - [FastRouter](https://mastra.ai/models/providers/fastrouter)
@@ -74,6 +75,7 @@ Direct access to individual AI model providers. Each provider offers unique mode
 - [LMStudio](https://mastra.ai/models/providers/lmstudio)
 - [LongCat](https://mastra.ai/models/providers/longcat)
 - [LucidQuery](https://mastra.ai/models/providers/lucidquery)
+- [Lynkr](https://mastra.ai/models/providers/lynkr)
 - [Meganova](https://mastra.ai/models/providers/meganova)
 - [Meta](https://mastra.ai/models/providers/meta)
 - [MiniMax (minimax.io)](https://mastra.ai/models/providers/minimax)
@@ -118,8 +120,10 @@ Direct access to individual AI model providers. Each provider offers unique mode
 - [SiliconFlow (China)](https://mastra.ai/models/providers/siliconflow-cn)
 - [Snowflake Cortex](https://mastra.ai/models/providers/snowflake-cortex)
 - [STACKIT](https://mastra.ai/models/providers/stackit)
-- [StepFun](https://mastra.ai/models/providers/stepfun)
-- [StepFun AI](https://mastra.ai/models/providers/stepfun-ai)
+- [StepFun (China)](https://mastra.ai/models/providers/stepfun)
+- [StepFun (Global)](https://mastra.ai/models/providers/stepfun-ai)
+- [StepFun Step Plan (China)](https://mastra.ai/models/providers/stepfun-step-plan)
+- [StepFun Step Plan (Global)](https://mastra.ai/models/providers/stepfun-ai-step-plan)
 - [Subconscious](https://mastra.ai/models/providers/subconscious)
 - [submodel](https://mastra.ai/models/providers/submodel)
 - [Synthetic](https://mastra.ai/models/providers/synthetic)

package/.docs/reference/coding-agent/create-coding-agent.md

@@ -38,7 +38,7 @@ const agent = createCodingAgent({
 
 **signals** (`SignalProvider[]`): Signal providers for the agent. When omitted, defaults to a single TaskSignalProvider.
 
-**errorProcessors** (`Processor[]`): Error processors for the agent. When omitted, defaults to the ECONNRESET/bad-request retry stack plus PrefillErrorHandler and ProviderHistoryCompat.
+**errorProcessors** (`Processor[]`): Error processors for the agent. When omitted, defaults to unknown stream-error retries with specialized ECONNRESET and bad-request policies, plus PrefillErrorHandler and ProviderHistoryCompat.
 
 **goal** (`AgentGoalConfig`): Goal configuration. When provided without a prompt, the prompt defaults to DEFAULT\_GOAL\_JUDGE\_PROMPT.
 
@@ -54,7 +54,7 @@ The factory only fills a default when you don't provide the corresponding field.
 | ----------------- | ---------------------------------------------------------------------------------------------------------------------------------------------- |
 | `workspace`       | A [`Workspace`](https://mastra.ai/reference/workspace/workspace-class) backed by `LocalFilesystem` and `LocalSandbox` rooted at the base path. |
 | `signals`         | A single [`TaskSignalProvider`](https://mastra.ai/reference/signals/task-signal-provider).                                                     |
-| `errorProcessors` | ECONNRESET and bad-request retry processors plus `PrefillErrorHandler` and `ProviderHistoryCompat`.                                            |
+| `errorProcessors` | Unknown stream-error retries with specialized ECONNRESET and bad-request policies, plus `PrefillErrorHandler` and `ProviderHistoryCompat`.     |
 | `goal.prompt`     | `DEFAULT_GOAL_JUDGE_PROMPT` (only when a `goal` is configured).                                                                                |
 
 ### Workspace
@@ -85,12 +85,13 @@ const agent = createCodingAgent({
 
 ### Error processors
 
-The default error processors apply a retry policy for transient failures:
+The default [`StreamErrorRetryProcessor`](https://mastra.ai/reference/processors/stream-error-retry-processor) applies these retry policies:
 
+- Unknown errors left unmatched by provider metadata or a specific matcher retry up to twice with a `3000ms` delay. Known authorization failures surface immediately.
 - Network resets (`ECONNRESET` / `socket hang up`) retry up to twice with exponential backoff (`1000ms * 2^retryCount`, capped at `30000ms`).
 - Bad-request errors retry once after `2000ms`.
 
-`PrefillErrorHandler` and `ProviderHistoryCompat` are also included for provider compatibility.
+Specific network-reset and bad-request policies take precedence over the unknown-error policy. Passing `errorProcessors` replaces the default processor stack. `PrefillErrorHandler` and `ProviderHistoryCompat` are also included for provider compatibility.
 
 ## Related
 

package/.docs/reference/evals/run-evals.md

@@ -56,9 +56,9 @@ result.thresholdResults // [{ id, passed, averageScore, threshold }]
 
 **data** (`RunEvalsDataItem[]`): Array of test cases with input data and optional ground truth.
 
-**scorers** (`ScorerEntry[] | AgentScorerConfig | WorkflowScorerConfig`): Scorers to use. Each entry is either a bare MastraScorer or { scorer, threshold } for threshold tracking. An AgentScorerConfig object separates agent-level and trajectory scorers. A WorkflowScorerConfig object specifies scorers for the workflow, individual steps, and trajectory.
+**scorers** (`ScorerEntry[] | AgentScorerConfig | WorkflowScorerConfig`): Scorers to use. Each entry is either a bare MastraScorer or { scorer, threshold } for threshold tracking. An AgentScorerConfig object separates agent-level and trajectory scorers. A WorkflowScorerConfig object specifies scorers for the workflow, individual steps, and trajectory. Optional when at least one gate is provided (gate-only runs).
 
-**gates** (`MastraScorer[]`): Scorers that must score 1.0 for the run to pass. If any gate averages below 1.0 across data items, the verdict is failed. Gates run before regular scorers on each data item.
+**gates** (`MastraScorer[]`): Scorers that must score 1.0 for the run to pass. If any gate averages below 1.0 across data items, the verdict is failed. Gates run before regular scorers on each data item. When provided, scorers may be omitted.
 
 **targetOptions** (`AgentExecutionOptions | WorkflowRunOptions`): Options forwarded to the target during execution. For agents: options passed to agent.generate() (e.g. maxSteps, modelSettings, instructions). For workflows: options passed to run.start() (e.g. perStep, outputOptions, initialState).
 

package/.docs/reference/mastra-platform/api.md

@@ -107,4 +107,4 @@ The root URL for the endpoints below is: `/v1/gateway`
 
 ## Gateway proxy endpoints
 
-Visit the [Memory Gateway documentation](https://gateway.mastra.ai/docs) for more details.
+Visit the [Gateway documentation](https://gateway.mastra.ai/docs) for more details.

package/.docs/reference/observability/metrics/automatic-metrics.md

@@ -23,13 +23,13 @@ If metrics aren't available, see [troubleshooting](#troubleshooting).
 
 Duration metrics record execution time in milliseconds, calculated from the span's start and end timestamps. Each duration metric includes a `status` label set to `ok` or `error`, derived from the span's status.
 
-| Metric name                    | Span type                    | Description                                             |
-| ------------------------------ | ---------------------------- | ------------------------------------------------------- |
-| `mastra_agent_duration_ms`     | `AGENT_RUN`                  | Execution time of an agent run                          |
-| `mastra_tool_duration_ms`      | `TOOL_CALL`, `MCP_TOOL_CALL` | Execution time of a tool call, including MCP tool calls |
-| `mastra_workflow_duration_ms`  | `WORKFLOW_RUN`               | Execution time of a workflow run                        |
-| `mastra_model_duration_ms`     | `MODEL_GENERATION`           | Execution time of a model generation                    |
-| `mastra_processor_duration_ms` | `PROCESSOR_RUN`              | Execution time of a processor run                       |
+| Metric name                    | Span type                                          | Description                                                                   |
+| ------------------------------ | -------------------------------------------------- | ----------------------------------------------------------------------------- |
+| `mastra_agent_duration_ms`     | `AGENT_RUN`                                        | Execution time of an agent run                                                |
+| `mastra_tool_duration_ms`      | `TOOL_CALL`, `MCP_TOOL_CALL`, `PROVIDER_TOOL_CALL` | Execution time of a tool call, including MCP and provider-executed tool calls |
+| `mastra_workflow_duration_ms`  | `WORKFLOW_RUN`                                     | Execution time of a workflow run                                              |
+| `mastra_model_duration_ms`     | `MODEL_GENERATION`                                 | Execution time of a model generation                                          |
+| `mastra_processor_duration_ms` | `PROCESSOR_RUN`                                    | Execution time of a processor run                                             |
 
 ## Token usage metrics
 
@@ -124,7 +124,7 @@ When you spot a spike in latency or token usage on the Metrics dashboard, correl
 ### Duration metrics are missing
 
 - **Span has timestamps**: Duration is calculated from `startTime` and `endTime`. If either is missing, the metric is skipped.
-- **Span type maps to a metric**: Only `AGENT_RUN`, `TOOL_CALL`, `MCP_TOOL_CALL`, `WORKFLOW_RUN`, `MODEL_GENERATION`, and `PROCESSOR_RUN` spans produce duration metrics.
+- **Span type maps to a metric**: Only `AGENT_RUN`, `TOOL_CALL`, `MCP_TOOL_CALL`, `PROVIDER_TOOL_CALL`, `WORKFLOW_RUN`, `MODEL_GENERATION`, and `PROCESSOR_RUN` spans produce duration metrics.
 
 ### Token metrics are missing
 

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

@@ -92,6 +92,7 @@ const exporter = new BraintrustExporter({
 | `MODEL_CHUNK`               | `llm`           |
 | `TOOL_CALL`                 | `tool`          |
 | `MCP_TOOL_CALL`             | `tool`          |
+| `PROVIDER_TOOL_CALL`        | `tool`          |
 | `WORKFLOW_CONDITIONAL_EVAL` | `function`      |
 | `WORKFLOW_WAIT_EVENT`       | `function`      |
 | All others                  | `task`          |

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

@@ -95,15 +95,16 @@ const exporter = new DatadogExporter({
 
 Mastra span types are mapped to Datadog LLM Observability span kinds:
 
-| Mastra SpanType    | Datadog Kind |
-| ------------------ | ------------ |
-| `AGENT_RUN`        | `agent`      |
-| `MODEL_GENERATION` | `workflow`   |
-| `MODEL_STEP`       | `llm`        |
-| `TOOL_CALL`        | `tool`       |
-| `MCP_TOOL_CALL`    | `tool`       |
-| `WORKFLOW_RUN`     | `workflow`   |
-| All other types    | `task`       |
+| Mastra SpanType      | Datadog Kind |
+| -------------------- | ------------ |
+| `AGENT_RUN`          | `agent`      |
+| `MODEL_GENERATION`   | `workflow`   |
+| `MODEL_STEP`         | `llm`        |
+| `TOOL_CALL`          | `tool`       |
+| `MCP_TOOL_CALL`      | `tool`       |
+| `PROVIDER_TOOL_CALL` | `tool`       |
+| `WORKFLOW_RUN`       | `workflow`   |
+| All other types      | `task`       |
 
 All unmapped span types (including `MODEL_CHUNK`, `WORKFLOW_STEP`, `GENERIC`, and future span types) automatically default to `task`.
 

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

@@ -73,13 +73,14 @@ const exporter = new LangSmithExporter({
 
 ## Span type mapping
 
-| Span Type          | LangSmith Type |
-| ------------------ | -------------- |
-| `MODEL_GENERATION` | `llm`          |
-| `MODEL_CHUNK`      | `llm`          |
-| `TOOL_CALL`        | `tool`         |
-| `MCP_TOOL_CALL`    | `tool`         |
-| All others         | `chain`        |
+| Span Type            | LangSmith Type |
+| -------------------- | -------------- |
+| `MODEL_GENERATION`   | `llm`          |
+| `MODEL_CHUNK`        | `llm`          |
+| `TOOL_CALL`          | `tool`         |
+| `MCP_TOOL_CALL`      | `tool`         |
+| `PROVIDER_TOOL_CALL` | `tool`         |
+| All others           | `chain`        |
 
 ## `withLangsmithMetadata`
 

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

@@ -80,15 +80,16 @@ const exporter = new PosthogExporter({
 
 ## Span type mapping
 
-| Mastra Span Type    | PostHog Event Type |
-| ------------------- | ------------------ |
-| `MODEL_GENERATION`  | `$ai_generation`   |
-| `MODEL_STEP`        | `$ai_generation`   |
-| `MODEL_CHUNK`       | `$ai_span`         |
-| `TOOL_CALL`         | `$ai_span`         |
-| `MCP_TOOL_CALL`     | `$ai_span`         |
-| `PROCESSOR_RUN`     | `$ai_span`         |
-| `AGENT_RUN`         | `$ai_span`         |
-| `WORKFLOW_RUN`      | `$ai_span`         |
-| All other workflows | `$ai_span`         |
-| `GENERIC`           | `$ai_span`         |
+| Mastra Span Type     | PostHog Event Type |
+| -------------------- | ------------------ |
+| `MODEL_GENERATION`   | `$ai_generation`   |
+| `MODEL_STEP`         | `$ai_generation`   |
+| `MODEL_CHUNK`        | `$ai_span`         |
+| `TOOL_CALL`          | `$ai_span`         |
+| `MCP_TOOL_CALL`      | `$ai_span`         |
+| `PROVIDER_TOOL_CALL` | `$ai_span`         |
+| `PROCESSOR_RUN`      | `$ai_span`         |
+| `AGENT_RUN`          | `$ai_span`         |
+| `WORKFLOW_RUN`       | `$ai_span`         |
+| All other workflows  | `$ai_span`         |
+| `GENERIC`            | `$ai_span`         |

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

@@ -117,6 +117,7 @@ Mastra span types are mapped to Sentry operations:
 | `MODEL_CHUNK`               | _(skipped)_            |
 | `TOOL_CALL`                 | `gen_ai.execute_tool`  |
 | `MCP_TOOL_CALL`             | `gen_ai.execute_tool`  |
+| `PROVIDER_TOOL_CALL`        | `gen_ai.execute_tool`  |
 | `WORKFLOW_RUN`              | `workflow.run`         |
 | `WORKFLOW_STEP`             | `workflow.step`        |
 | `WORKFLOW_CONDITIONAL`      | `workflow.conditional` |

package/.docs/reference/observability/tracing/interfaces.md

@@ -46,6 +46,7 @@ interface SpanTypeMap {
   MODEL_CHUNK: ModelChunkAttributes
   TOOL_CALL: ToolCallAttributes
   CLIENT_TOOL_CALL: ClientToolCallAttributes
+  PROVIDER_TOOL_CALL: ProviderToolCallAttributes
   MCP_TOOL_CALL: MCPToolCallAttributes
   PROCESSOR_RUN: ProcessorRunAttributes
   WORKFLOW_STEP: WorkflowStepAttributes
@@ -314,6 +315,14 @@ enum SpanType {
    */
   CLIENT_TOOL_CALL = 'client_tool_call',
 
+  /**
+   * Provider-executed (server-side) tool span. Reconstructed from
+   * tool-call and tool-result stream chunks for tools the model
+   * provider executes (e.g. Anthropic code execution, server-side
+   * web search). Opened on tool-call chunk, closed on tool-result.
+   */
+  PROVIDER_TOOL_CALL = 'provider_tool_call',
+
   /** Workflow run - root span for workflow processes */
   WORKFLOW_RUN = 'workflow_run',
 

package/.docs/reference/processors/stream-error-retry-processor.md

@@ -35,6 +35,31 @@ When the error is retryable, the processor returns `{ retry: true }`. It doesn't
 
 When `delayMs` is set, the processor waits before signaling a retry. This is useful for transient network errors like `ECONNRESET` where immediately retrying is likely to fail again. The delay can be a fixed number of milliseconds or a function evaluated with the error args (for example, to implement exponential backoff).
 
+## Retry unknown errors
+
+Set `retryUnknownErrors` to retry errors that don't match provider metadata, the built-in OpenAI matcher, or a custom matcher. Unknown-error retries use the processor-level `maxRetries` and `delayMs` values. Known authorization failures, including HTTP `401` and `403` responses, aren't retried:
+
+```typescript
+import { Agent } from '@mastra/core/agent'
+import { StreamErrorRetryProcessor } from '@mastra/core/processors'
+
+export const agent = new Agent({
+  id: 'resilient-agent',
+  name: 'Resilient agent',
+  instructions: 'You are a helpful assistant.',
+  model: 'openai/gpt-5',
+  errorProcessors: [
+    new StreamErrorRetryProcessor({
+      retryUnknownErrors: true,
+      maxRetries: 2,
+      delayMs: 3000,
+    }),
+  ],
+})
+```
+
+Specific matcher policies still take precedence over the unknown-error values. The option defaults to `false`, so unknown errors aren't retried unless you enable it.
+
 ## Delaying retries
 
 Use `delayMs` with a custom matcher to retry transient network resets with a wait:

package/.docs/reference/server/register-api-route.md

@@ -28,7 +28,7 @@ registerApiRoute("/items/:itemId", { ... })
 
 **handler** (`Handler`): Route handler function receiving Hono Context. Use either handler or createHandler, not both.
 
-**createHandler** (`(c: Context) => Promise<Handler>`): Async factory function to create the handler. Use either handler or createHandler, not both.
+**createHandler** (`({ mastra }: { mastra: Mastra }) => Promise<ApiRouteHandler>`): Async factory that receives the Mastra instance and returns the route handler. Runs once at server startup, so it can perform one-time setup. Use either handler or createHandler, not both.
 
 **middleware** (`MiddlewareHandler | MiddlewareHandler[]`): Route-specific middleware functions
 
@@ -229,12 +229,13 @@ For routes that need async initialization:
 ```typescript
 registerApiRoute('/dynamic', {
   method: 'GET',
-  createHandler: async c => {
-    // Perform async setup
+  createHandler: async ({ mastra }) => {
+    // Perform one-time async setup
     const config = await loadConfig()
+    const agent = mastra.getAgent('weatherAgent')
 
     return async c => {
-      return c.json({ config })
+      return c.json({ config, agent: agent.name })
     }
   },
 })

package/.docs/reference/templates/overview.md

@@ -15,7 +15,7 @@ Mastra templates are pre-built project structures that demonstrate specific use
 
 The following templates demonstrate Gateway-first Mastra applications:
 
-- `template-docs-expert`: Answers documentation questions with Mastra Gateway web search, citations, memory, and structured responses.
+- `template-docs-expert`: Answers documentation questions with Gateway web search, citations, memory, and structured responses.
 - `template-browser-agent`: Uses AgentBrowser to browse, inspect, and interact with web pages.
 - `template-meeting-notes`: Turns Zoom transcripts or uploaded transcripts into structured notes with decisions and action items.
 - `template-company-knowledge`: Indexes Linear and Notion content into pgvector and answers internal knowledge questions.

package/CHANGELOG.md

@@ -1,5 +1,19 @@
 # @mastra/mcp-docs-server
 
+## 1.2.7-alpha.17
+
+### Patch Changes
+
+- Updated dependencies [[`bd6d240`](https://github.com/mastra-ai/mastra/commit/bd6d2402db93dddaef0721667e7e8a030e7c6e16), [`0111486`](https://github.com/mastra-ai/mastra/commit/01114867612593eef5cfa2fda6a1194dfedda841), [`96a3749`](https://github.com/mastra-ai/mastra/commit/96a37492235f5b8076b3e3177d83ed5a5e44a640), [`3e26c87`](https://github.com/mastra-ai/mastra/commit/3e26c87de0c5bc2583b795ce6ca5889b6b161acb), [`a5008f2`](https://github.com/mastra-ai/mastra/commit/a5008f22ae710ad9402ea9f2547d8c02f74d384b)]:
+  - @mastra/core@1.51.0-alpha.8
+
+## 1.2.7-alpha.15
+
+### Patch Changes
+
+- Updated dependencies [[`25e7c12`](https://github.com/mastra-ai/mastra/commit/25e7c126a770069ae7fb7ecf1d2adb40e017b009), [`1ce5121`](https://github.com/mastra-ai/mastra/commit/1ce512155d122bb21f47d98383e82ffbf84b39e8), [`3cfc47a`](https://github.com/mastra-ai/mastra/commit/3cfc47a6b89940aadd0f46fb01ae9624a73a865d), [`2bb7817`](https://github.com/mastra-ai/mastra/commit/2bb78176112fde628483de2830528f7eee911e56), [`51d9870`](https://github.com/mastra-ai/mastra/commit/51d987032c689c2855374d0f244f5d654da809d1), [`5cab274`](https://github.com/mastra-ai/mastra/commit/5cab2744250e22d12fefa7b32637dce224233cee), [`7fa27d3`](https://github.com/mastra-ai/mastra/commit/7fa27d3b6f5ed68cd34e454a4d3ad9c482a0cfbc), [`a58dcbb`](https://github.com/mastra-ai/mastra/commit/a58dcbb546d7e1d65ebdc1f39e55f0908fcd9391), [`153bd3b`](https://github.com/mastra-ai/mastra/commit/153bd3b396bdfed6b74cf43de12db8fd2d83c04a), [`07bb863`](https://github.com/mastra-ai/mastra/commit/07bb8631919c6f7cf377dccd45b096e0f17fbed0), [`8a586ec`](https://github.com/mastra-ai/mastra/commit/8a586eca9a4914f31dff6140d0d45ac375b00669), [`3927473`](https://github.com/mastra-ai/mastra/commit/392747323ddb10c643d12be7b9ae913159dfaeed), [`dce50dc`](https://github.com/mastra-ai/mastra/commit/dce50dc9a1c1fcd0f427bb5f6250ec74910cb04b), [`634caff`](https://github.com/mastra-ai/mastra/commit/634caff29a9200ad058b67d53f96d9e5832fb8a2)]:
+  - @mastra/core@1.51.0-alpha.7
+
 ## 1.2.7-alpha.13
 
 ### Patch Changes