@mastra/mcp-docs-server 1.2.23-alpha.6 → 1.2.23-alpha.9

package/.docs/docs/subagents.md

@@ -138,7 +138,7 @@ Called after a delegation finishes. Use it to inspect results or provide feedbac
 - Return `{ feedback: '...' }`: Add feedback that gets saved to the parent agent's memory and is visible to subsequent iterations
 - Return `{ resultText: '...' }`: Replace the tool result text the parent model sees for this delegation, within the current run
 
-Use `resultText` when the subagent's own result would mislead the parent immediately. For example, a subagent that stops on a tool-calls step returns empty text. The parent model reads this as a successful but empty delegation. Unlike `feedback`, which only reaches the model on the next turn, `resultText` changes what the parent reasons on right away.
+Set `resultText` when the subagent's own result would give the parent a misleading signal. For example, empty text from a subagent stopped on a tool-calls step looks like a successful but empty delegation to the parent model. Unlike `feedback` on the next turn, `resultText` affects the parent's reasoning immediately.
 
 ```typescript
 const stream = await parentAgent.stream('Research AI trends', {
@@ -196,7 +196,7 @@ await parentAgent.generate('Research AI trends', { maxSteps: 10, requestContext
 const hookErrors = requestContext.get('__mastra_delegationHookErrors') ?? []
 ```
 
-When `hookErrorStrategy` is `'throw'`, a throwing `onDelegationStart` blocks the subagent from running at all, and a throwing `messageFilter` or `onDelegationComplete` surfaces to the parent as a failed tool call. If `onDelegationComplete` throws while handling a failed delegation, the original delegation error is still what surfaces, and the hook is never re-invoked for its own failure.
+When `hookErrorStrategy` is `'throw'`, a throwing `onDelegationStart` blocks the subagent from running at all, and a throwing `messageFilter` or `onDelegationComplete` surfaces to the parent as a failed tool call. If `onDelegationComplete` throws while handling a failed delegation, the original delegation error remains the surfaced error. The hook isn't invoked again for its own failure.
 
 ## Message filtering
 

package/.docs/docs/workflows/control-flow.md

@@ -4,7 +4,7 @@
 
 # Control flow
 
-Workflows run a sequence of predefined tasks, and you can control how that flow is executed. Tasks are divided into **steps**, which can be executed in different ways depending on your requirements. They can run sequentially or in parallel, or alternatively follow different paths based on conditions.
+Workflows give you control over predefined tasks by dividing each task into **steps**. Those steps can run sequentially or in parallel, and they can follow conditional paths.
 
 Each step connects to the next in the workflow through defined schemas that keep data controlled and consistent.
 

package/.docs/docs/workflows/overview.md

@@ -4,7 +4,7 @@
 
 # Workflows
 
-Workflows let you define complex sequences of tasks using clear, structured steps rather than relying on the reasoning of a single agent. They give you full control over how tasks are broken down and how data moves between them, plus what gets executed when. Workflows run using the built-in execution engine by default, or can be deployed to [workflow runners](https://mastra.ai/docs/deployment/workflow-runners) like Inngest for managed infrastructure.
+Workflows let you define complex task sequences with clear, structured steps instead of relying on one agent to reason through the entire process. You control the task breakdown along with the flow and timing of data. Workflows use the built-in execution engine by default, while managed infrastructure is available through [workflow runners](https://mastra.ai/docs/deployment/workflow-runners) such as Inngest.
 
 **For AI agents:** Run `npx mastra api workflow run start test-workflow '{"inputData":{"message":"Hello, world!"}}'` to start this workflow directly instead of writing a temporary script. The command requires a running Mastra server; start the local server with `npx mastra dev`, or pass the reachable server's base URL with `--url`. Run `npx mastra api workflow run start --schema` before constructing different input. Install Mastra's skill with `npx skills add mastra-ai/skills --skill mastra` for complete API CLI discovery, targeting, schema, authentication, and error-handling guidance.
 

package/.docs/docs/workflows/scheduled-workflows.md

@@ -44,7 +44,7 @@ A separate "register schedule" call won't happen. The scheduler reads `schedule`
 
 A workflow that declares `schedule` is auto-promoted to the **evented execution engine**. The public API (`workflow.start()`, `workflow.startAsync()`, `streamLegacy()`, `resume()`) is unchanged, `EventedWorkflow extends Workflow` and overrides each method with matching signatures. From your code, scheduled fires and manual runs are indistinguishable.
 
-The promotion has one practical implication: evented runs require a storage adapter that supports concurrent updates, for example `@mastra/libsql`. If your adapter doesn't, `createRun()` throws a clear error pointing at the `schedule` field. Switch adapters or remove the schedule.
+The promotion means evented runs require a storage adapter with concurrent-update support, such as `@mastra/libsql`; otherwise, `createRun()` throws a clear error that points to the `schedule` field. Switch adapters or remove the schedule.
 
 ## Single schedule
 

package/.docs/docs/workflows/suspend-and-resume.md

@@ -4,7 +4,7 @@
 
 # Suspend and resume
 
-Workflows can be paused at any step to collect additional data or wait for API callbacks. Pauses can also throttle costly operations or request [human-in-the-loop](https://mastra.ai/docs/workflows/human-in-the-loop) input. When a workflow is suspended, its current execution state is saved as a snapshot. You can later resume the workflow from a [specific step ID](https://mastra.ai/docs/workflows/snapshots), restoring the exact state captured in that snapshot. [Snapshots](https://mastra.ai/docs/workflows/snapshots) are stored in your configured storage provider and persist across deployments and application restarts.
+Pause a workflow at any step to collect additional data, wait for an API callback, throttle a costly operation, or request [human-in-the-loop](https://mastra.ai/docs/workflows/human-in-the-loop) input. Suspension saves the current execution state as a snapshot. Later, resume from a [specific step ID](https://mastra.ai/docs/workflows/snapshots) to restore the exact captured state. [Snapshots](https://mastra.ai/docs/workflows/snapshots) are stored in your configured storage provider and persist across deployments and application restarts.
 
 ## Pausing a workflow with `suspend()`
 
@@ -98,7 +98,7 @@ const stream = run.resume({
 })
 ```
 
-You can call `resume()` from anywhere in your application, including HTTP endpoints, event handlers, in response to [human input](https://mastra.ai/docs/workflows/human-in-the-loop), or timers.
+You can call `resume()` from anywhere in your application, such as an HTTP endpoint or event handler. Timers and code responding to [human input](https://mastra.ai/docs/workflows/human-in-the-loop) can also resume a workflow.
 
 ```typescript
 const midnight = new Date()

package/.docs/integrations/sandboxes/agentcore.md

@@ -92,6 +92,8 @@ if (!result?.success) {
 
 **accept** (`string`): Accept header used for command event streams. (Default: `application/vnd.amazon.eventstream`)
 
+**workingDirectory** (`string`): Default directory for command execution when no per-command cwd is given, applied as a shell cd prefix. A per-command cwd always wins. The path is shell-quoted, so \~ is not expanded — use an absolute path.
+
 **commandTimeout** (`number`): Default command timeout in milliseconds. (Default: `300000`)
 
 **stopSessionOnLifecycle** (`boolean`): Whether stop() and destroy() should call StopRuntimeSession. Defaults to false because AgentCore Runtime sessions are often shared with agent invocations outside the sandbox instance. (Default: `false`)

package/.docs/integrations/sandboxes/apple-container.md

@@ -53,7 +53,7 @@ const workspace = new Workspace({
     volumes: {
       '/Users/me/project': '/workspace',
     },
-    workingDir: '/workspace',
+    workingDirectory: '/workspace',
   }),
 })
 
@@ -125,7 +125,9 @@ console.log(response.text)
 
 **labels** (`Record<string, string>`): Additional container labels. Mastra labels (mastra.sandbox, mastra.sandbox.id) are always included.
 
-**workingDir** (`string`): Working directory inside the container. (Default: `'/workspace'`)
+**workingDirectory** (`string`): Working directory inside the container, used as the default for command execution when no per-command cwd is given. A per-command cwd always wins. (Default: `'/workspace'`)
+
+**workingDir** (`string`): Deprecated alias for workingDirectory. When both are set, workingDirectory wins.
 
 **timeout** (`number`): Default command timeout in milliseconds. (Default: `300000 (5 minutes)`)
 
@@ -198,7 +200,7 @@ const sandbox = new AppleContainerSandbox({
 })
 ```
 
-These options are only applied when a new container is created. If the sandbox reconnects to an existing container with the same name, destroy and recreate the sandbox to apply changed runtime options. Apple `--tmpfs` accepts container paths only, such as `/tmp`; it doesn't accept Docker-style option specs like `/tmp:rw,size=256m`. When `readonlyRootfs` is enabled, make sure `workingDir` points to a path supplied by the image or a bind mount. A writable tmpfs is also supported.
+These options are only applied when a new container is created. If the sandbox reconnects to an existing container with the same name, destroy and recreate the sandbox to apply changed runtime options. Apple `--tmpfs` accepts container paths only, such as `/tmp`; it doesn't accept Docker-style option specs like `/tmp:rw,size=256m`. When `readonlyRootfs` is enabled, make sure `workingDirectory` points to a path supplied by the image or a bind mount. A writable tmpfs is also supported.
 
 ## Security model
 

package/.docs/integrations/sandboxes/blaxel.md

@@ -83,6 +83,8 @@ const workspace = new Workspace({
 
 **env** (`Record<string, string>`): Environment variables to set in the sandbox.
 
+**workingDirectory** (`string`): Default directory for command execution when no per-command cwd is given. A per-command cwd always wins. Use an absolute path.
+
 **labels** (`Record<string, string>`): Custom labels for the sandbox.
 
 **runtimes** (`SandboxRuntime[]`): Supported runtimes. Valid values: 'node', 'python', 'bash', 'ruby', 'go', 'rust', 'java', 'cpp', 'r'. (Default: `['node', 'python', 'bash']`)

package/.docs/integrations/sandboxes/cloudflare-sandbox.md

@@ -103,7 +103,7 @@ await workspace.sandbox?.writeFiles?.([
 
 **env** (`Record<string, string>`): Environment variables applied to every command.
 
-**workingDirectory** (`string`): Working directory applied to every command.
+**workingDirectory** (`string`): Default directory for command execution when no per-command cwd is given. A per-command cwd always wins.
 
 **commandTimeout** (`number`): Default command timeout in milliseconds. (Default: `300000`)
 

package/.docs/integrations/sandboxes/daytona.md

@@ -353,6 +353,8 @@ For Daytona-specific desktop APIs (regions, compressed screenshots, screen recor
 
 **env** (`Record<string, string>`): Environment variables to set in the sandbox. (Default: `{}`)
 
+**workingDirectory** (`string`): Default directory for command execution when no per-command cwd is given. A per-command cwd always wins. When set, the sandbox skips its automatic working-directory probe; when omitted, the probe fills the workingDirectory getter after start.
+
 **labels** (`Record<string, string>`): Custom metadata labels. (Default: `{}`)
 
 **name** (`string`): Sandbox display name. (Default: `Sandbox id`)

package/.docs/integrations/sandboxes/docker.md

@@ -99,7 +99,9 @@ const agent = new Agent({
 
 **tmpfs** (`Record<string, string>`): tmpfs mount paths and options. Maps to Docker HostConfig.Tmpfs.
 
-**workingDir** (`string`): Working directory inside the container. (Default: `'/workspace'`)
+**workingDirectory** (`string`): Working directory inside the container, used as the default for command execution when no per-command cwd is given. A per-command cwd always wins. (Default: `'/workspace'`)
+
+**workingDir** (`string`): Deprecated alias for workingDirectory. When both are set, workingDirectory wins.
 
 **labels** (`Record<string, string>`): Additional container labels. Mastra labels (mastra.sandbox, mastra.sandbox.id) are always included.
 

package/.docs/integrations/sandboxes/e2b.md

@@ -68,6 +68,8 @@ const agent = new Agent({
 
 **env** (`Record<string, string>`): Environment variables to set in the sandbox
 
+**workingDirectory** (`string`): Default directory for command execution when no per-command cwd is given. A per-command cwd always wins; when neither is set, commands run from the sandbox home directory. Use an absolute path.
+
 **id** (`string`): Unique identifier for this sandbox instance (Default: `Auto-generated`)
 
 **sandboxId** (`string`): Persisted E2B provider sandbox ID to reattach to deterministically. When set, start() connects to this exact sandbox (resuming it if paused) instead of discovering by logical id metadata. Only a typed "sandbox gone" error (not found, killed, or not running) falls through to the usual logical-id lookup and create ladder; auth, quota, rate-limit, timeout, and network errors propagate without creating a new sandbox. A sandbox tagged with a different logical id is refused. Read the resolved provider ID from the sandboxId property after start.

package/.docs/integrations/sandboxes/modal.md

@@ -88,7 +88,9 @@ Get your credentials from the [Modal dashboard](https://modal.com/settings/token
 
 **env** (`Record<string, string>`): Environment variables baked into the sandbox at create time.
 
-**workdir** (`string`): Default working directory inside the sandbox.
+**workingDirectory** (`string`): Default working directory inside the sandbox, used for command execution when no per-command cwd is given. A per-command cwd always wins.
+
+**workdir** (`string`): Deprecated alias for workingDirectory. When both are set, workingDirectory wins.
 
 **tokenId** (`string`): Modal token ID. Falls back to MODAL\_TOKEN\_ID environment variable.
 

package/.docs/integrations/sandboxes/railway.md

@@ -221,6 +221,8 @@ const result = await sandbox.executeCommand('cat', ['/tmp/state.txt'])
 
 **env** (`Record<string, string>`): Environment variables baked into the sandbox, available to every command. (Default: `{}`)
 
+**workingDirectory** (`string`): Default directory for command execution when no per-command cwd is given. A per-command cwd always wins. Use an absolute path.
+
 **template** (`SandboxTemplate | (base: SandboxTemplate) => SandboxTemplate`): Provision the sandbox from a custom base image built with the Railway template builder. Accepts a builder callback or a pre-built template. Ignored when sandboxId is set.
 
 **timeout** (`number`): Default execution timeout in milliseconds applied to commands that do not specify their own timeout. Commands run until they exit when omitted.

package/.docs/integrations/sandboxes/vercel.md

@@ -156,6 +156,8 @@ Both callbacks are optional and can be used independently.
 
 **env** (`Record<string, string>`): Default environment variables inherited by all commands. (Default: `{}`)
 
+**workingDirectory** (`string`): Default directory for command execution when no per-command cwd is given. A per-command cwd always wins. Use an absolute path.
+
 **metadata** (`Record<string, unknown>`): Custom metadata surfaced via getInfo(). (Default: `{}`)
 
 **instructions** (`string | ((opts) => string)`): Override the default instructions returned by getInstructions(). Pass a string to replace them, or a function to extend the defaults.
@@ -301,6 +303,8 @@ const workspace = new Workspace({
 
 **env** (`Record<string, string>`): Environment variables baked into the deployed function source. These are embedded at deploy time, not set dynamically.
 
+**workingDirectory** (`string`): Default directory for command execution when no per-command cwd is given. A per-command cwd always wins. When omitted, commands fall back to /tmp and sandbox.workingDirectory stays undefined.
+
 **commandTimeout** (`number`): Per-invocation command timeout in milliseconds. (Default: `55000`)
 
 **instructions** (`string | ((opts) => string)`): Custom instructions that override the default instructions returned by getInstructions(). Pass a string to fully replace, or a function to extend the defaults.

package/.docs/models/gateways/vercel.md

@@ -4,7 +4,7 @@
 
 # ![Vercel logo](https://models.dev/logos/vercel.svg)Vercel
 
-Vercel aggregates models from multiple providers with enhanced features like rate limiting and failover. Access 362 models through Mastra's model router.
+Vercel aggregates models from multiple providers with enhanced features like rate limiting and failover. Access 363 models through Mastra's model router.
 
 Learn more in the [Vercel documentation](https://ai-sdk.dev/providers/ai-sdk-providers).
 
@@ -385,6 +385,7 @@ ANTHROPIC_API_KEY=ant-...
 | `voyage/voyage-law-2`                     |
 | `xiaomi/mimo-v2.5`                        |
 | `xiaomi/mimo-v2.5-pro`                    |
+| `xiaomi/mimo-v2.5-pro-ultraspeed`         |
 | `zai/glm-4.5`                             |
 | `zai/glm-4.5-air`                         |
 | `zai/glm-4.5v`                            |

package/.docs/models/providers/chutes.md

@@ -48,7 +48,7 @@ for await (const chunk of stream) {
 | `chutes/Qwen/Qwen3-32B-TEE`                     | 41K     |       |           |       |       |       | $0.10      | $0.42       |
 | `chutes/Qwen/Qwen3.5-397B-A17B-TEE`             | 262K    |       |           |       |       |       | $0.45      | $3          |
 | `chutes/Qwen/Qwen3.6-27B-TEE`                   | 262K    |       |           |       |       |       | $0.30      | $2          |
-| `chutes/Qwen/Qwen3.8-27B-TEE`                   | 262K    |       |           |       |       |       | $0.35      | $3          |
+| `chutes/Qwen/Qwen3.8-27B-TEE`                   | 262K    |       |           |       |       |       | $0.32      | $3          |
 | `chutes/unsloth/Mistral-Nemo-Instruct-2407-TEE` | 131K    |       |           |       |       |       | $0.02      | $0.10       |
 | `chutes/zai-org/GLM-5.1-TEE`                    | 203K    |       |           |       |       |       | $0.98      | $3          |
 | `chutes/zai-org/GLM-5.2-TEE`                    | 1.0M    |       |           |       |       |       | $1         | $4          |

package/.docs/models/providers/cortecs.md

@@ -4,7 +4,7 @@
 
 # ![Cortecs logo](https://models.dev/logos/cortecs.svg)Cortecs
 
-Access 112 Cortecs models through Mastra's model router. Authentication is handled automatically using the `CORTECS_API_KEY` environment variable.
+Access 111 Cortecs models through Mastra's model router. Authentication is handled automatically using the `CORTECS_API_KEY` environment variable.
 
 Learn more in the [Cortecs documentation](https://cortecs.ai).
 
@@ -56,7 +56,7 @@ for await (const chunk of stream) {
 | `cortecs/deepseek-v4-flash-0731`              | 1.0M    |       |           |       |       |       | $0.13      | $0.28       |
 | `cortecs/deepseek-v4-pro`                     | 1.0M    |       |           |       |       |       | $2         | $3          |
 | `cortecs/deepseek-v4-pro-0813`                | 1.0M    |       |           |       |       |       | $2         | $4          |
-| `cortecs/devstral-2512`                       | 262K    |       |           |       |       |       | $0.45      | $2          |
+| `cortecs/devstral-2512`                       | 256K    |       |           |       |       |       | $0.48      | $2          |
 | `cortecs/gemini-2.5-flash`                    | 1.0M    |       |           |       |       |       | $0.30      | $2          |
 | `cortecs/gemini-2.5-pro`                      | 1.0M    |       |           |       |       |       | $1         | $10         |
 | `cortecs/gemini-3.1-flash-lite`               | 1.0M    |       |           |       |       |       | $0.27      | $2          |
@@ -105,7 +105,7 @@ for await (const chunk of stream) {
 | `cortecs/minicpm-v-4.5`                       | 32K     |       |           |       |       |       | $0.65      | $1          |
 | `cortecs/minimax-m2`                          | 400K    |       |           |       |       |       | $0.35      | $1          |
 | `cortecs/minimax-m2.1`                        | 196K    |       |           |       |       |       | $0.36      | $1          |
-| `cortecs/minimax-m2.5`                        | 197K    |       |           |       |       |       | $0.30      | $1          |
+| `cortecs/minimax-m2.5`                        | 196K    |       |           |       |       |       | $0.30      | $1          |
 | `cortecs/minimax-m2.7`                        | 197K    |       |           |       |       |       | $0.67      | $3          |
 | `cortecs/minimax-m3`                          | 1.0M    |       |           |       |       |       | $0.40      | $2          |
 | `cortecs/ministral-14b-2512`                  | 256K    |       |           |       |       |       | $0.22      | $0.22       |
@@ -115,7 +115,6 @@ for await (const chunk of stream) {
 | `cortecs/mistral-7b-instruct-v0.3`            | 127K    |       |           |       |       |       | $0.11      | $0.11       |
 | `cortecs/mistral-large-2402`                  | 32K     |       |           |       |       |       | $4         | $13         |
 | `cortecs/mistral-large-2512`                  | 256K    |       |           |       |       |       | $0.56      | $2          |
-| `cortecs/mistral-medium-2508`                 | 128K    |       |           |       |       |       | $0.45      | $2          |
 | `cortecs/mistral-medium-3.5`                  | 256K    |       |           |       |       |       | $1         | $7          |
 | `cortecs/mistral-nemo-instruct-2407`          | 128K    |       |           |       |       |       | $0.14      | $0.14       |
 | `cortecs/mistral-small-2503`                  | 128K    |       |           |       |       |       | $0.11      | $0.33       |

package/.docs/models/providers/edenai.md

@@ -4,7 +4,7 @@
 
 # ![Eden AI logo](https://models.dev/logos/edenai.svg)Eden AI
 
-Access 239 Eden AI models through Mastra's model router. Authentication is handled automatically using the `EDENAI_API_KEY` environment variable.
+Access 240 Eden AI models through Mastra's model router. Authentication is handled automatically using the `EDENAI_API_KEY` environment variable.
 
 Learn more in the [Eden AI documentation](https://docs.edenai.co).
 
@@ -112,6 +112,7 @@ for await (const chunk of stream) {
 | `edenai/flexai/gpt-oss-20b`                                            | 131K    |       |           |       |       |       | $0.02      | $0.10       |
 | `edenai/flexai/Muse-Glimmer-30B`                                       | 131K    |       |           |       |       |       | $0.30      | $1          |
 | `edenai/flexai/Nemotron-3-Super-120B-A12B`                             | 262K    |       |           |       |       |       | $0.09      | $0.40       |
+| `edenai/flexai/Step-3.7-Flash`                                         | 262K    |       |           |       |       |       | $0.20      | $1          |
 | `edenai/google/gemini-2.5-flash-image`                                 | 33K     |       |           |       |       |       | $0.30      | $3          |
 | `edenai/google/gemini-3-flash-preview`                                 | 1.0M    |       |           |       |       |       | $0.50      | $3          |
 | `edenai/google/gemini-3-pro-image`                                     | 66K     |       |           |       |       |       | $2         | $12         |

package/.docs/models/providers/iteracompute.md

@@ -4,7 +4,7 @@
 
 # ![IteraCompute logo](https://models.dev/logos/iteracompute.svg)IteraCompute
 
-Access 1 IteraCompute model through Mastra's model router. Authentication is handled automatically using the `ITERACOMPUTE_API_KEY` environment variable.
+Access 2 IteraCompute models through Mastra's model router. Authentication is handled automatically using the `ITERACOMPUTE_API_KEY` environment variable.
 
 Learn more in the [IteraCompute documentation](https://iteracompute.com/docs.html).
 
@@ -19,7 +19,7 @@ const agent = new Agent({
   id: "my-agent",
   name: "My Agent",
   instructions: "You are a helpful assistant",
-  model: "iteracompute/iteracompute/qwen3.8-27b"
+  model: "iteracompute/iteracompute/ornith-1.5-35b-a3b"
 });
 
 // Generate a response
@@ -36,9 +36,10 @@ for await (const chunk of stream) {
 
 ## Models
 
-| Model                                   | Context | Tools | Reasoning | Image | Audio | Video | Input $/1M | Output $/1M |
-| --------------------------------------- | ------- | ----- | --------- | ----- | ----- | ----- | ---------- | ----------- |
-| `iteracompute/iteracompute/qwen3.8-27b` | 262K    |       |           |       |       |       | $0.35      | $3          |
+| Model                                          | Context | Tools | Reasoning | Image | Audio | Video | Input $/1M | Output $/1M |
+| ---------------------------------------------- | ------- | ----- | --------- | ----- | ----- | ----- | ---------- | ----------- |
+| `iteracompute/iteracompute/ornith-1.5-35b-a3b` | 328K    |       |           |       |       |       | $0.30      | $3          |
+| `iteracompute/iteracompute/qwen3.8-27b`        | 328K    |       |           |       |       |       | $0.30      | $3          |
 
 ## Advanced configuration
 
@@ -50,7 +51,7 @@ const agent = new Agent({
   name: "custom-agent",
   model: {
     url: "https://api.iteracompute.com/v1",
-    id: "iteracompute/iteracompute/qwen3.8-27b",
+    id: "iteracompute/iteracompute/ornith-1.5-35b-a3b",
     apiKey: process.env.ITERACOMPUTE_API_KEY,
     headers: {
       "X-Custom-Header": "value"
@@ -69,7 +70,7 @@ const agent = new Agent({
     const useAdvanced = requestContext.task === "complex";
     return useAdvanced
       ? "iteracompute/iteracompute/qwen3.8-27b"
-      : "iteracompute/iteracompute/qwen3.8-27b";
+      : "iteracompute/iteracompute/ornith-1.5-35b-a3b";
   }
 });
 ```

package/.docs/models/providers/kilo.md

@@ -150,7 +150,7 @@ for await (const chunk of stream) {
 | `kilo/kwaipilot/kat-coder-pro-v2`                               | 262K    |       |           |       |       |       | $0.30      | $1          |
 | `kilo/kwaipilot/kat-coder-pro-v2.5`                             | 262K    |       |           |       |       |       | $0.74      | $3          |
 | `kilo/liquid/lfm-2.5-2.6b:free`                                 | 66K     |       |           |       |       |       | —          | —           |
-| `kilo/mancer/weaver`                                            | 8K      |       |           |       |       |       | $0.50      | $0.75       |
+| `kilo/mancer/weaver`                                            | 8K      |       |           |       |       |       | $0.40      | $0.75       |
 | `kilo/meituan/longcat-2.0`                                      | 1.0M    |       |           |       |       |       | $0.75      | $3          |
 | `kilo/meituan/longcat-2.0-free`                                 | 1.0M    |       |           |       |       |       | —          | —           |
 | `kilo/meta-llama/llama-3.1-70b-instruct`                        | 131K    |       |           |       |       |       | $0.40      | $0.40       |
@@ -159,7 +159,7 @@ for await (const chunk of stream) {
 | `kilo/meta-llama/llama-3.2-3b-instruct`                         | 131K    |       |           |       |       |       | $0.05      | $0.33       |
 | `kilo/meta-llama/llama-3.3-70b-instruct`                        | 128K    |       |           |       |       |       | $0.10      | $0.32       |
 | `kilo/meta-llama/llama-4-maverick`                              | 128K    |       |           |       |       |       | $0.20      | $0.70       |
-| `kilo/meta-llama/llama-4-scout`                                 | 131K    |       |           |       |       |       | $0.10      | $0.30       |
+| `kilo/meta-llama/llama-4-scout`                                 | 328K    |       |           |       |       |       | $0.10      | $0.30       |
 | `kilo/meta-llama/llama-guard-4-12b`                             | 164K    |       |           |       |       |       | $0.18      | $0.18       |
 | `kilo/meta/muse-glimmer-30b`                                    | 131K    |       |           |       |       |       | $0.30      | $1          |
 | `kilo/meta/muse-spark-1.1`                                      | 1.0M    |       |           |       |       |       | $1         | $4          |
@@ -365,7 +365,7 @@ for await (const chunk of stream) {
 | `kilo/tencent/hy-mt2-1.8b`                                      | 8K      |       |           |       |       |       | $0.04      | $0.18       |
 | `kilo/tencent/hy-mt2-30b-a3b`                                   | 8K      |       |           |       |       |       | $0.07      | $0.29       |
 | `kilo/tencent/hy-mt2-7b`                                        | 8K      |       |           |       |       |       | $0.07      | $0.29       |
-| `kilo/tencent/hy3`                                              | 262K    |       |           |       |       |       | $0.08      | $0.33       |
+| `kilo/tencent/hy3`                                              | 262K    |       |           |       |       |       | $0.14      | $0.58       |
 | `kilo/tencent/hy3-preview`                                      | 262K    |       |           |       |       |       | $0.18      | $0.60       |
 | `kilo/tencent/hy4-preview`                                      | 1.0M    |       |           |       |       |       | $0.83      | $3          |
 | `kilo/thedrummer/cydonia-24b-v4.1`                              | 131K    |       |           |       |       |       | $0.30      | $0.50       |
@@ -375,7 +375,7 @@ for await (const chunk of stream) {
 | `kilo/thinkingmachines/inkling-small`                           | 524K    |       |           |       |       |       | $0.45      | $1          |
 | `kilo/thinkingmachines/inkling-small:free`                      | 1.0M    |       |           |       |       |       | —          | —           |
 | `kilo/thinkingmachines/inkling:free`                            | 1.0M    |       |           |       |       |       | —          | —           |
-| `kilo/undi95/remm-slerp-l2-13b`                                 | 6K      |       |           |       |       |       | $0.45      | $0.65       |
+| `kilo/undi95/remm-slerp-l2-13b`                                 | 6K      |       |           |       |       |       | $0.35      | $0.65       |
 | `kilo/upstage/solar-pro-3`                                      | 131K    |       |           |       |       |       | $0.15      | $0.60       |
 | `kilo/upstage/solar-pro4`                                       | 524K    |       |           |       |       |       | $0.30      | $1          |
 | `kilo/writer/palmyra-x5`                                        | 1.0M    |       |           |       |       |       | $0.60      | $6          |

package/.docs/models/providers/vancine.md

@@ -4,7 +4,7 @@
 
 # ![Vancine logo](https://models.dev/logos/vancine.svg)Vancine
 
-Access 12 Vancine models through Mastra's model router. Authentication is handled automatically using the `VANCINE_API_KEY` environment variable.
+Access 10 Vancine models through Mastra's model router. Authentication is handled automatically using the `VANCINE_API_KEY` environment variable.
 
 Learn more in the [Vancine documentation](https://vancine.com/docs).
 
@@ -19,7 +19,7 @@ const agent = new Agent({
   id: "my-agent",
   name: "My Agent",
   instructions: "You are a helpful assistant",
-  model: "vancine/LongCat-2.0"
+  model: "vancine/MiniMax-M3"
 });
 
 // Generate a response
@@ -45,8 +45,6 @@ for await (const chunk of stream) {
 | `vancine/glm-5.3-flash`                | 1.0M    |       |           |       |       |       | $0.06      | $0.20       |
 | `vancine/hy4-preview`                  | 1.0M    |       |           |       |       |       | $0.67      | $2          |
 | `vancine/kimi-k3`                      | 1.0M    |       |           |       |       |       | $2         | $12         |
-| `vancine/LongCat-2.0`                  | 1.0M    |       |           |       |       |       | $0.24      | $0.96       |
-| `vancine/mimo-v2.5-pro`                | 1.0M    |       |           |       |       |       | $0.35      | $0.70       |
 | `vancine/MiniMax-M3`                   | 1.0M    |       |           |       |       |       | $0.24      | $0.96       |
 | `vancine/qwen3.8-flash`                | 1.0M    |       |           |       |       |       | $0.12      | $0.38       |
 | `vancine/qwen3.8-max`                  | 1.0M    |       |           |       |       |       | $2         | $5          |
@@ -61,7 +59,7 @@ const agent = new Agent({
   name: "custom-agent",
   model: {
     url: "https://vancine.com/v1",
-    id: "vancine/LongCat-2.0",
+    id: "vancine/MiniMax-M3",
     apiKey: process.env.VANCINE_API_KEY,
     headers: {
       "X-Custom-Header": "value"
@@ -80,7 +78,7 @@ const agent = new Agent({
     const useAdvanced = requestContext.task === "complex";
     return useAdvanced
       ? "vancine/qwen3.8-max"
-      : "vancine/LongCat-2.0";
+      : "vancine/MiniMax-M3";
   }
 });
 ```

package/.docs/reference/agent-controller/agent-controller-class.md

@@ -200,7 +200,7 @@ Returns: `Promise<Session<TState> | undefined>`
 
 #### `onSessionCreated(listener, options?)`
 
-Subscribe to process-local notifications after `createSession()` materializes a new live session. Listener errors are isolated and don't prevent other listeners from running. Call the returned function to unsubscribe.
+Subscribe to process-local notifications after `createSession()` materializes a new live session, with isolated listener errors prevented from affecting other listeners. Call the returned function to unsubscribe.
 
 By default listeners are fire-and-forget. Pass `{ blocking: true }` to make `createSession()` await the listener before resolving the new session, so the host can prepare session state before the caller can start a run. Blocking listeners run sequentially in registration order, before fire-and-forget listeners are notified. A blocking listener must not call `createSession()` for the same `(resourceId, scope)` pair. That call would await its own hydration and deadlock.
 
@@ -225,7 +225,7 @@ Returns: `() => void`
 
 #### `onSessionDeleted(listener)`
 
-Subscribe to process-local notifications after `deleteSession()` tears down a live session. Listener errors are isolated and don't prevent other listeners from running. Call the returned function to unsubscribe.
+Subscribe to process-local notifications after `deleteSession()` tears down a live session, with isolated listener errors prevented from affecting other listeners. Call the returned function to unsubscribe.
 
 ```typescript
 const unsubscribe = controller.onSessionDeleted(session => {

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

@@ -745,7 +745,7 @@ const state = session.state.get()
 
 ### `session.state.set(updates)`
 
-Merge a partial update into the state. Updates are queued so concurrent calls apply in order, validated against the schema, and emit `state_changed` with the changed keys.
+Merge a partial update into the state. The queue applies concurrent calls in order and validates them against the schema before emitting `state_changed` with the changed keys.
 
 ```typescript
 await session.state.set({ yolo: true })
@@ -753,7 +753,7 @@ await session.state.set({ yolo: true })
 
 ### `session.state.update(updater)`
 
-Run an updater against the current snapshot and apply its result atomically within the write queue. Use this for read-modify-write changes that must see the latest state. The updater returns `updates` to merge, optional `events` to emit, and a `result` value that `update()` resolves to.
+Run an updater against the current snapshot and apply its result atomically within the write queue. Use this for read-modify-write changes that must see the latest state. The updater returns mergeable `updates` and optional `events`, plus the `result` value that `update()` resolves to.
 
 ```typescript
 const added = await session.state.update(current => ({
@@ -766,7 +766,7 @@ const added = await session.state.update(current => ({
 
 A `Session` is a live runtime object. Its event bus, arbitrary `session.state`, permission rules, permission grants, pending approvals, suspensions, follow-ups, run state, and stream state don't automatically survive controller or process recreation. The host must restore any of this state when recreating a session.
 
-With configured storage, threads, messages, and token usage persist. Thread settings restore mode and model choices. They can also restore observational memory settings and subagent model selections, including per-agent-type overrides. A chat channel can map back to stored threads, but channel-to-session and auto-approval state held by `AgentControllerChannels` remains in memory.
+Configured storage persists threads and messages along with token usage, while thread settings restore mode and model choices. Restored settings can include observational memory and subagent model selections with per-agent-type overrides. A chat channel can map back to stored threads. However, `AgentControllerChannels` keeps channel-to-session and auto-approval state in memory.
 
 ## Related
 

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

@@ -178,7 +178,7 @@ const { output, cleanup } = await durableAgent.observe(runId, {
 await output.text
 ```
 
-By default `observe()` waits indefinitely for events. If the process running the run stops unexpectedly, the run stops producing events but never emits a completion event, so the observed stream would wait forever. Pass `idleTimeoutMs` to bound that wait: after that many milliseconds of silence the stream ends. An optional `isAlive` check is consulted first. Return `true` while the run is still being worked on (for example a long-running tool call, or a run paused waiting for human input) to keep waiting. Returning `false`, or omitting `isAlive`, ends the stream with an error. A transient throw from `isAlive` is treated as "still alive", so a momentary check failure never ends a live stream.
+By default `observe()` waits indefinitely for events. If the process running the run stops unexpectedly, the run stops producing events but never emits a completion event, so the observed stream would wait forever. Pass `idleTimeoutMs` to end the stream after a bounded period of silence. Before timing out, `observe()` can consult an optional `isAlive` check. Return `true` while work continues, such as during a long-running tool call or a pause for human input. A `false` result ends the stream with an error, as does omitting `isAlive`. A transient throw from `isAlive` is treated as "still alive", so a momentary check failure never ends a live stream.
 
 ```typescript
 const { output } = await durableAgent.observe(runId, {

package/.docs/reference/agents/getDefaultGenerateOptions.md

@@ -6,7 +6,7 @@
 
 > **Warning:** **Deprecated**: This method is deprecated and only works with V1 models. For V2 models, use the new [`.getDefaultOptions()`](https://mastra.ai/reference/agents/getDefaultOptions) method instead.
 
-Agents can be configured with default generation options for controlling model behavior, output formatting and tool and workflow calls. The `.getDefaultGenerateOptionsLegacy()` method retrieves these defaults, resolving them if they're functions. These options apply to all `generateLegacy()` calls unless overridden and are useful for inspecting an agent’s unknown defaults.
+Configure agents with default generation options that control model behavior and output formatting, including tool and workflow calls. The `.getDefaultGenerateOptionsLegacy()` method retrieves these defaults and resolves any functions. These options apply to all `generateLegacy()` calls unless overridden and are useful for inspecting an agent’s unknown defaults.
 
 ## Usage example
 

package/.docs/reference/agents/listSuspendedRuns.md

@@ -6,7 +6,7 @@
 
 **Added in:** `@mastra/core@1.43.0`
 
-The `.listSuspendedRuns()` method lists suspended agent runs from workflow snapshot storage: runs waiting on a tool call requiring [approval](https://mastra.ai/docs/agents/human-in-the-loop), or on a tool that called `suspend()`. Because discovery is backed by storage rather than in-memory state, it works after a server restart and across multiple server instances.
+The `.listSuspendedRuns()` method uses workflow snapshot storage to find suspended agent runs, including runs awaiting [approval](https://mastra.ai/docs/agents/human-in-the-loop) for a tool call and runs paused by a tool that called `suspend()`. Storage-backed discovery continues to work after a server restart and across multiple server instances.
 
 Pass the returned `runId` to [`resumeStream()`](https://mastra.ai/docs/agents/human-in-the-loop), `approveToolCall()`, or `declineToolCall()` to continue the run.
 
@@ -85,7 +85,7 @@ interface AgentRunToolCall {
 
 ## Discovery scope
 
-Results are scoped to runs started by the agent you call `listSuspendedRuns()` on: snapshots persist the owning agent's id, so runs started by other agents on the same Mastra instance aren't returned. In [supervisor setups](https://mastra.ai/docs/agents/human-in-the-loop) the supervisor sees its outer run (the one to resume), while a subagent's inner run is only visible from the subagent itself. Filter by `threadId` and `resourceId` to scope results to one conversation.
+Results are scoped to the agent you call `listSuspendedRuns()` on because snapshots persist the owning agent's id. Runs started by other agents on the same Mastra instance aren't returned. In [supervisor setups](https://mastra.ai/docs/agents/human-in-the-loop), the supervisor sees its outer run to resume, while a subagent's inner run is visible only from the subagent itself. Filter by `threadId` and `resourceId` to limit results to one conversation.
 
 Run snapshots are only persisted while a run is waiting on input and are deleted when it finishes, so suspended runs are the only runs discoverable from storage. Suspended runs only survive restarts when the Mastra instance has a persistent [storage provider](https://mastra.ai/docs/storage) configured. With the default in-memory store, snapshots are lost on restart.
 

package/.docs/reference/ai-sdk/chat-route.md

@@ -4,7 +4,7 @@
 
 # chatRoute()
 
-Creates a chat route handler for streaming agent conversations using the AI SDK format. This function registers an HTTP `POST` endpoint that accepts messages, executes an agent, and streams the response back to the client in AI SDK-compatible format. You have to use it inside a [custom API route](https://mastra.ai/docs/server/custom-api-routes).
+Creates a chat route handler for streaming agent conversations in AI SDK format. The function registers an HTTP `POST` endpoint that accepts messages and executes an agent before streaming the response to the client in AI SDK-compatible format. Use it inside a [custom API route](https://mastra.ai/docs/server/custom-api-routes).
 
 Use [`handleChatStream()`](https://mastra.ai/reference/ai-sdk/handle-chat-stream) if you need a framework-agnostic handler.
 

package/.docs/reference/ai-sdk/network-route.md

@@ -6,7 +6,7 @@
 
 > **Deprecated:** Agent networks are deprecated and will be removed in a future release. Use [supervisor agents](https://mastra.ai/docs/subagents) with `agent.stream()` or `agent.generate()` instead. See the [migration guide](https://mastra.ai/reference/migrations/network-to-supervisor) to upgrade.
 
-Creates a network route handler for streaming network execution using the AI SDK format. This function registers an HTTP `POST` endpoint that accepts messages, executes an agent network, and streams the response back to the client in AI SDK-compatible format. Agent networks allow a routing agent to delegate tasks to other agents. You have to use it inside a [custom API route](https://mastra.ai/docs/server/custom-api-routes).
+Creates a network route handler for streaming network execution in AI SDK format. The function registers an HTTP `POST` endpoint that accepts messages and executes an agent network before streaming the response to the client in AI SDK-compatible format. Agent networks let a routing agent delegate tasks to other agents. Use this function inside a [custom API route](https://mastra.ai/docs/server/custom-api-routes).
 
 Use [`handleNetworkStream()`](https://mastra.ai/reference/ai-sdk/handle-network-stream) if you need a framework-agnostic handler.
 

package/.docs/reference/ai-sdk/workflow-route.md

@@ -4,7 +4,7 @@
 
 # workflowRoute()
 
-Creates a workflow route handler for streaming workflow execution using the AI SDK format. This function registers an HTTP `POST` endpoint that accepts input data, executes a workflow, and streams the response back to the client in AI SDK-compatible format. You have to use it inside a [custom API route](https://mastra.ai/docs/server/custom-api-routes).
+Creates a workflow route handler for streaming workflow execution in AI SDK format. The function registers an HTTP `POST` endpoint that accepts input data and executes a workflow before streaming the response to the client in AI SDK-compatible format. Use it inside a [custom API route](https://mastra.ai/docs/server/custom-api-routes).
 
 Use [`handleWorkflowStream()`](https://mastra.ai/reference/ai-sdk/handle-workflow-stream) if you need a framework-agnostic handler.
 

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

@@ -88,7 +88,7 @@ When `cdpUrl` is provided, `BrowserViewer` connects to the existing browser inst
 
 #### `launch(threadId?)`
 
-Launches Chrome. For `'shared'` scope, launches a single shared browser. For `'thread'` scope, launches a browser for the specified thread.
+Launches Chrome with either a single shared browser for `'shared'` scope or a browser for the specified thread when using `'thread'` scope.
 
 ```typescript
 await viewer.launch()