@mastra/mcp-docs-server 1.2.17-alpha.19 → 1.2.17-alpha.21

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

@@ -2,7 +2,7 @@
 
 # ![Kilo Gateway logo](https://models.dev/logos/kilo.svg)Kilo Gateway
 
-Access 358 Kilo Gateway models through Mastra's model router. Authentication is handled automatically using the `KILO_API_KEY` environment variable.
+Access 360 Kilo Gateway models through Mastra's model router. Authentication is handled automatically using the `KILO_API_KEY` environment variable.
 
 Learn more in the [Kilo Gateway documentation](https://kilo.ai).
 
@@ -40,7 +40,7 @@ for await (const chunk of stream) {
 | `kilo/~anthropic/claude-haiku-latest`                           | 200K    |       |           |       |       |       | $1         | $5          |
 | `kilo/~anthropic/claude-opus-latest`                            | 1.0M    |       |           |       |       |       | $5         | $25         |
 | `kilo/~anthropic/claude-sonnet-latest`                          | 1.0M    |       |           |       |       |       | $2         | $10         |
-| `kilo/~deepseek/deepseek-v4-flash-latest`                       | 1.0M    |       |           |       |       |       | $0.08      | $0.16       |
+| `kilo/~deepseek/deepseek-v4-flash-latest`                       | 262K    |       |           |       |       |       | $0.08      | $0.15       |
 | `kilo/~google/gemini-flash-latest`                              | 1.0M    |       |           |       |       |       | $0.38      | $2          |
 | `kilo/~google/gemini-pro-latest`                                | 1.0M    |       |           |       |       |       | $2         | $12         |
 | `kilo/~moonshotai/kimi-latest`                                  | 975K    |       |           |       |       |       | $3         | $13         |
@@ -128,7 +128,7 @@ for await (const chunk of stream) {
 | `kilo/google/gemini-3.5-flash`                                  | 1.0M    |       |           |       |       |       | $2         | $9          |
 | `kilo/google/gemini-3.5-flash-lite`                             | 1.0M    |       |           |       |       |       | $0.30      | $3          |
 | `kilo/google/gemini-3.6-flash`                                  | 1.0M    |       |           |       |       |       | $0.75      | $4          |
-| `kilo/google/gemini-3.7-flash`                                  | 1.0M    |       |           |       |       |       | $0.75      | $4          |
+| `kilo/google/gemini-3.7-flash`                                  | 1.0M    |       |           |       |       |       | $2         | $8          |
 | `kilo/google/gemma-2-27b-it`                                    | 8K      |       |           |       |       |       | $0.65      | $0.65       |
 | `kilo/google/gemma-3-12b-it`                                    | 131K    |       |           |       |       |       | $0.05      | $0.15       |
 | `kilo/google/gemma-3-27b-it`                                    | 131K    |       |           |       |       |       | $0.08      | $0.16       |
@@ -154,6 +154,7 @@ for await (const chunk of stream) {
 | `kilo/kwaipilot/kat-coder-air-v2.5`                             | 256K    |       |           |       |       |       | $0.15      | $0.60       |
 | `kilo/kwaipilot/kat-coder-pro-v2`                               | 256K    |       |           |       |       |       | $0.30      | $1          |
 | `kilo/kwaipilot/kat-coder-pro-v2.5`                             | 256K    |       |           |       |       |       | $0.74      | $3          |
+| `kilo/liquid/lfm-2.5-2.6b:free`                                 | 128K    |       |           |       |       |       | —          | —           |
 | `kilo/mancer/weaver`                                            | 8K      |       |           |       |       |       | $0.50      | $0.75       |
 | `kilo/meituan/longcat-2.0`                                      | 1.0M    |       |           |       |       |       | $0.75      | $3          |
 | `kilo/meta-llama/llama-3.1-70b-instruct`                        | 131K    |       |           |       |       |       | $0.40      | $0.40       |
@@ -393,6 +394,7 @@ for await (const chunk of stream) {
 | `kilo/z-ai/glm-5-turbo`                                         | 203K    |       |           |       |       |       | $1         | $4          |
 | `kilo/z-ai/glm-5.1`                                             | 200K    |       |           |       |       |       | $1         | $4          |
 | `kilo/z-ai/glm-5.2`                                             | 1.0M    |       |           |       |       |       | $1         | $4          |
+| `kilo/z-ai/glm-5.3`                                             | 1.0M    |       |           |       |       |       | $1         | $4          |
 | `kilo/z-ai/glm-5v-turbo`                                        | 203K    |       |           |       |       |       | $1         | $4          |
 
 ## Advanced configuration

package/.docs/models/providers/llmgateway.md

@@ -55,7 +55,7 @@ for await (const chunk of stream) {
 | `llmgateway/cosmos3-super-reasoner`            | 262K    |       |           |       |       |       | $0.10      | $0.30       |
 | `llmgateway/custom`                            | 128K    |       |           |       |       |       | —          | —           |
 | `llmgateway/deepseek-v3.2`                     | 164K    |       |           |       |       |       | $0.26      | $0.38       |
-| `llmgateway/deepseek-v4-flash`                 | 1.1M    |       |           |       |       |       | $0.08      | $0.15       |
+| `llmgateway/deepseek-v4-flash`                 | 1.1M    |       |           |       |       |       | $0.05      | $0.09       |
 | `llmgateway/deepseek-v4-pro`                   | 1.1M    |       |           |       |       |       | $0.43      | $0.87       |
 | `llmgateway/ernie-4.5-vl-424b-a47b`            | 123K    |       |           |       |       |       | $0.42      | $1          |
 | `llmgateway/fugu-ultra`                        | 1.0M    |       |           |       |       |       | $5         | $30         |
@@ -176,7 +176,7 @@ for await (const chunk of stream) {
 | `llmgateway/nemotron-3-nano-30b`               | 262K    |       |           |       |       |       | $0.06      | $0.24       |
 | `llmgateway/nemotron-3-nano-omni`              | 262K    |       |           |       |       |       | $0.06      | $0.24       |
 | `llmgateway/nemotron-3-super-120b`             | 262K    |       |           |       |       |       | $0.30      | $0.90       |
-| `llmgateway/nemotron-3-ultra-550b`             | 1.0M    |       |           |       |       |       | $0.50      | $3          |
+| `llmgateway/nemotron-3-ultra-550b`             | 1.0M    |       |           |       |       |       | $0.50      | $2          |
 | `llmgateway/o1`                                | 200K    |       |           |       |       |       | $15        | $60         |
 | `llmgateway/o3`                                | 200K    |       |           |       |       |       | $2         | $8          |
 | `llmgateway/o3-mini`                           | 200K    |       |           |       |       |       | $1         | $4          |
@@ -194,7 +194,7 @@ for await (const chunk of stream) {
 | `llmgateway/qwen3-30b-a3b-instruct-2507`       | 262K    |       |           |       |       |       | $0.10      | $0.30       |
 | `llmgateway/qwen3-32b`                         | 41K     |       |           |       |       |       | $0.10      | $0.30       |
 | `llmgateway/qwen3-coder-30b-a3b-instruct`      | 262K    |       |           |       |       |       | $0.07      | $0.27       |
-| `llmgateway/qwen3-coder-480b-a35b-instruct`    | 262K    |       |           |       |       |       | $0.30      | $1          |
+| `llmgateway/qwen3-coder-480b-a35b-instruct`    | 262K    |       |           |       |       |       | $0.38      | $2          |
 | `llmgateway/qwen3-coder-flash`                 | 1.0M    |       |           |       |       |       | $0.30      | $2          |
 | `llmgateway/qwen3-coder-next`                  | 262K    |       |           |       |       |       | $0.11      | $0.68       |
 | `llmgateway/qwen3-coder-plus`                  | 1.0M    |       |           |       |       |       | $6         | $60         |

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

@@ -0,0 +1,76 @@
+> Discover all available pages from the documentation index: https://mastra.ai/llms.txt
+
+# ![SCX.ai logo](https://models.dev/logos/scx-ai.svg)SCX.ai
+
+Access 4 SCX.ai models through Mastra's model router. Authentication is handled automatically using the `SCX_API_KEY` environment variable.
+
+Learn more in the [SCX.ai documentation](https://platform.scx.ai/docs).
+
+```bash
+SCX_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: "scx-ai/GLM-5.2"
+});
+
+// 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);
+}
+```
+
+> **Note:** Mastra uses the OpenAI-compatible `/chat/completions` endpoint. Some provider-specific features may not be available. Check the [SCX.ai documentation](https://platform.scx.ai/docs) for details.
+
+## Models
+
+| Model                 | Context | Tools | Reasoning | Image | Audio | Video | Input $/1M | Output $/1M |
+| --------------------- | ------- | ----- | --------- | ----- | ----- | ----- | ---------- | ----------- |
+| `scx-ai/GLM-5.2`      | 1.0M    |       |           |       |       |       | $0.55      | $2          |
+| `scx-ai/gpt-oss-120b` | 131K    |       |           |       |       |       | $0.17      | $0.55       |
+| `scx-ai/MiniMax-M2.7` | 197K    |       |           |       |       |       | $0.48      | $2          |
+| `scx-ai/Qwen3.8-Max`  | 1.0M    |       |           |       |       |       | $2         | $5          |
+
+## Advanced configuration
+
+### Custom headers
+
+```typescript
+const agent = new Agent({
+  id: "custom-agent",
+  name: "custom-agent",
+  model: {
+    url: "https://api.scx.ai/v1",
+    id: "scx-ai/GLM-5.2",
+    apiKey: process.env.SCX_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
+      ? "scx-ai/gpt-oss-120b"
+      : "scx-ai/GLM-5.2";
+  }
+});
+```

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

@@ -2,7 +2,7 @@
 
 # ![Weights & Biases logo](https://models.dev/logos/wandb.svg)Weights & Biases
 
-Access 28 Weights & Biases models through Mastra's model router. Authentication is handled automatically using the `WANDB_API_KEY` environment variable.
+Access 29 Weights & Biases models through Mastra's model router. Authentication is handled automatically using the `WANDB_API_KEY` environment variable.
 
 Learn more in the [Weights & Biases documentation](https://docs.wandb.ai).
 
@@ -62,6 +62,7 @@ for await (const chunk of stream) {
 | `wandb/Qwen/Qwen3.5-35B-A3B`                         | 262K    |       |           |       |       |       | $0.25      | $1          |
 | `wandb/Qwen/Qwen3.6-27B`                             | 262K    |       |           |       |       |       | $0.60      | $4          |
 | `wandb/Qwen/Qwen3.6-35B-A3B`                         | 262K    |       |           |       |       |       | $0.25      | $1          |
+| `wandb/Qwen/Qwen3.8-27B`                             | 262K    |       |           |       |       |       | $0.40      | $3          |
 | `wandb/zai-org/GLM-5.1`                              | 203K    |       |           |       |       |       | $1         | $4          |
 | `wandb/zai-org/GLM-5.2`                              | 262K    |       |           |       |       |       | $0.76      | $2          |
 

package/.docs/models/providers.md

@@ -91,7 +91,6 @@ Direct access to individual AI model providers. Each provider offers unique mode
 - [LucidQuery](https://mastra.ai/models/providers/lucidquery)
 - [Lynkr](https://mastra.ai/models/providers/lynkr)
 - [Meganova](https://mastra.ai/models/providers/meganova)
-- [Merge Gateway](https://mastra.ai/models/providers/merge-gateway)
 - [Meta](https://mastra.ai/models/providers/meta)
 - [MiniMax (minimax.io)](https://mastra.ai/models/providers/minimax)
 - [MiniMax (minimaxi.com)](https://mastra.ai/models/providers/minimax-cn)
@@ -135,7 +134,7 @@ Direct access to individual AI model providers. Each provider offers unique mode
 - [Sarvam AI](https://mastra.ai/models/providers/sarvam)
 - [Scaleway](https://mastra.ai/models/providers/scaleway)
 - [SCNet Token Plan](https://mastra.ai/models/providers/scnet-token-plan)
-- [SCX.ai](https://mastra.ai/models/providers/scx)
+- [SCX.ai](https://mastra.ai/models/providers/scx-ai)
 - [SiliconFlow](https://mastra.ai/models/providers/siliconflow)
 - [SiliconFlow (China)](https://mastra.ai/models/providers/siliconflow-cn)
 - [Snowflake Cortex](https://mastra.ai/models/providers/snowflake-cortex)

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

@@ -51,7 +51,7 @@ export const mastra = new Mastra({
 
 ## Parameters
 
-**version** (`'v5' | 'v6'`): Selects the AI SDK stream contract to emit. Omit it or pass 'v5' for the existing default behavior. Pass 'v6' when your app is typed against AI SDK v6 response helpers. (Default: `'v5'`)
+**version** (`'v5' | 'v6' | 'v7'`): Selects the AI SDK stream contract to emit. Omit it or pass 'v5' for the existing default behavior. Pass 'v6' when your app is typed against AI SDK v6 response helpers. Pass 'v7' when your app is typed against AI SDK v7. (Default: `'v5'`)
 
 **path** (`string`): The route path (e.g., /chat or /chat/:agentId). Include :agentId for dynamic agent routing. (Default: `'/chat/:agentId'`)
 

package/.docs/reference/ai-sdk/handle-chat-stream.md

@@ -50,7 +50,7 @@ export async function POST(req: Request) {
 
 ## Parameters
 
-**version** (`'v5' | 'v6'`): Selects the AI SDK stream contract to emit. Omit it or pass 'v5' for the existing default behavior. Pass 'v6' when your app is typed against AI SDK v6 response helpers. (Default: `'v5'`)
+**version** (`'v5' | 'v6' | 'v7'`): Selects the AI SDK stream contract to emit. Omit it or pass 'v5' for the existing default behavior. Pass 'v6' when your app is typed against AI SDK v6 response helpers. Pass 'v7' when your app is typed against AI SDK v7. (Default: `'v5'`)
 
 **mastra** (`Mastra`): The Mastra instance containing registered agents.
 

package/.docs/reference/ai-sdk/handle-network-stream.md

@@ -34,7 +34,7 @@ export async function POST(req: Request) {
 
 ## Parameters
 
-**version** (`'v5' | 'v6'`): Selects the AI SDK stream contract to emit. Omit it or pass 'v5' for the existing default behavior. Pass 'v6' when your app is typed against AI SDK v6 response helpers. (Default: `'v5'`)
+**version** (`'v5' | 'v6' | 'v7'`): Selects the AI SDK stream contract to emit. Omit it or pass 'v5' for the existing default behavior. Pass 'v6' when your app is typed against AI SDK v6 response helpers. Pass 'v7' when your app is typed against AI SDK v7. (Default: `'v5'`)
 
 **mastra** (`Mastra`): The Mastra instance to use for agent lookup and execution.
 

package/.docs/reference/ai-sdk/handle-workflow-stream.md

@@ -36,7 +36,7 @@ export async function POST(req: Request) {
 
 ## Parameters
 
-**version** (`'v5' | 'v6'`): Selects the AI SDK stream contract to emit. Omit it or pass 'v5' for the existing default behavior. Pass 'v6' when your app is typed against AI SDK v6 response helpers. (Default: `'v5'`)
+**version** (`'v5' | 'v6' | 'v7'`): Selects the AI SDK stream contract to emit. Omit it or pass 'v5' for the existing default behavior. Pass 'v6' when your app is typed against AI SDK v6 response helpers. Pass 'v7' when your app is typed against AI SDK v7. (Default: `'v5'`)
 
 **mastra** (`Mastra`): The Mastra instance containing registered workflows.
 

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

@@ -49,7 +49,7 @@ export const mastra = new Mastra({
 
 ## Parameters
 
-**version** (`'v5' | 'v6'`): Selects the AI SDK stream contract to emit. Omit it or pass 'v5' for the existing default behavior. Pass 'v6' when your app is typed against AI SDK v6 response helpers. (Default: `'v5'`)
+**version** (`'v5' | 'v6' | 'v7'`): Selects the AI SDK stream contract to emit. Omit it or pass 'v5' for the existing default behavior. Pass 'v6' when your app is typed against AI SDK v6 response helpers. Pass 'v7' when your app is typed against AI SDK v7. (Default: `'v5'`)
 
 **path** (`string`): The route path (e.g., /network or /network/:agentId). Include :agentId for dynamic agent routing. (Default: `'/network/:agentId'`)
 

package/.docs/reference/ai-sdk/to-ai-sdk-messages.md

@@ -44,7 +44,7 @@ export default function Chat() {
 
 **messages** (`MessageListInput`): Messages to convert. Can be a string, array of strings, a single message object, or an array of message objects in any supported format.
 
-**options.version** (`'v5' | 'v6'`): Selects the AI SDK message type to return. Omit it or pass 'v5' for the existing default behavior. Pass 'v6' when your app is typed against AI SDK v6 useChat() message types.
+**options.version** (`'v5' | 'v6' | 'v7'`): Selects the AI SDK message type to return. Omit it or pass 'v5' for the existing default behavior. Pass 'v6' when your app is typed against AI SDK v6 useChat() message types. Pass 'v7' when your app is typed against AI SDK v7.
 
 ## Returns
 

package/.docs/reference/ai-sdk/to-ai-sdk-stream.md

@@ -64,7 +64,7 @@ The first parameter is the Mastra stream to convert. It can be one of:
 
 The second parameter is an options object:
 
-**version** (`'v5' | 'v6'`): Selects the AI SDK stream contract to emit. Omit it or pass 'v5' for the existing default behavior. Pass 'v6' when your app is typed against AI SDK v6 response helpers. (Default: `'v5'`)
+**version** (`'v5' | 'v6' | 'v7'`): Selects the AI SDK stream contract to emit. Omit it or pass 'v5' for the existing default behavior. Pass 'v6' when your app is typed against AI SDK v6 response helpers. Pass 'v7' when your app is typed against AI SDK v7. (Default: `'v5'`)
 
 **from** (`'agent' | 'network' | 'workflow'`): The type of Mastra stream being converted. (Default: `'agent'`)
 

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

@@ -51,7 +51,7 @@ export const mastra = new Mastra({
 
 ## Parameters
 
-**version** (`'v5' | 'v6'`): Selects the AI SDK stream contract to emit. Omit it or pass 'v5' for the existing default behavior. Pass 'v6' when your app is typed against AI SDK v6 response helpers. (Default: `'v5'`)
+**version** (`'v5' | 'v6' | 'v7'`): Selects the AI SDK stream contract to emit. Omit it or pass 'v5' for the existing default behavior. Pass 'v6' when your app is typed against AI SDK v6 response helpers. Pass 'v7' when your app is typed against AI SDK v7. (Default: `'v5'`)
 
 **path** (`string`): The route path (e.g., /workflow or /workflow/:workflowId). Include :workflowId for dynamic workflow routing. (Default: `'/api/workflows/:workflowId/stream'`)
 

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

@@ -77,6 +77,8 @@ const editor = new MastraEditor({
 
 **defaultScope** (`'per-author' | 'caller-supplied'`): Connection identity scope. Defaults to per-author. (Default: `'per-author'`)
 
+**userIdResolver** (`ComposioUserIdResolver`): Server-side resolver that derives the effective Composio userId from authenticated context fields. Used for invoker and caller-supplied execution. The exact connected account always comes from the stored connection pin.
+
 ### Tool slugs
 
 Composio tools use uppercase slug format: `GITHUB_CREATE_ISSUE`, `SLACK_SEND_MESSAGE`.
@@ -85,6 +87,111 @@ Composio tools use uppercase slug format: `GITHUB_CREATE_ISSUE`, `SLACK_SEND_MES
 
 Connections use per-author scope by default. Set `defaultScope: 'caller-supplied'` to bucket authorization by the caller identity resolved from `MASTRA_RESOURCE_ID_KEY` in request context. Ensure each authenticated request provides a stable, unique resource ID. When using `MastraAuthWorkos`, configure `mapUserToResourceId` to set this value from the authenticated user.
 
+How the provider resolves the Composio user for a tool call depends on the connection:
+
+- **Author-bound connections** (`kind: 'author'`) execute as the agent author's user against the pinned connected account.
+- **Invoker-bound connections** (`kind: 'invoker'`) execute as the authenticated invoker against the exact pinned account, which may be an account another user shared with the invoker through Composio's access control list (ACL). The user ID comes from `userIdResolver` when configured, then the authenticated user, and never from the Memory `resourceId`. Invoker resolution fails when no authenticated user or resolver result exists.
+- **Caller-supplied scope** (`scope: 'caller-supplied'`) uses `userIdResolver` when configured. Otherwise, it falls back to the legacy `resourceId` from request context for backward compatibility. When a specific connected account is pinned, execution routes to that exact account. Otherwise, Composio auto-resolves within the user's bucket.
+
+### Execute with a shared account
+
+Bob needs to run a Salesforce tool with an account that Alice shared through Composio. Keep each identity separate:
+
+| Identity          | Value                 |
+| ----------------- | --------------------- |
+| Memory resource   | `project_123`         |
+| Composio user ID  | `bob`                 |
+| Connected account | `ca_alice_salesforce` |
+
+Register the provider normally. Mastra server authentication writes the authenticated user to request context, so most applications don't need a `userIdResolver`:
+
+```typescript
+import { Mastra } from '@mastra/core/mastra'
+import { MastraEditor } from '@mastra/editor'
+import { ComposioToolProvider } from '@mastra/editor/composio'
+
+const editor = new MastraEditor({
+  toolProviders: {
+    composio: new ComposioToolProvider({
+      apiKey: process.env.COMPOSIO_API_KEY!,
+    }),
+  },
+})
+
+export const mastra = new Mastra({ editor })
+```
+
+Configure the agent with an invoker connection pinned to `ca_alice_salesforce`. When Bob invokes the agent, Mastra sends `bob` as the Composio user and the pinned account ID as the exact connected account. The Memory resource stays `project_123`. Composio then checks whether the account's ACL permits Bob to execute it.
+
+### Map application users to Composio users
+
+Use `userIdResolver` when your Composio user IDs differ from the IDs returned by Mastra authentication, or when your application must authorize the stored account pin before execution.
+
+```typescript
+type ComposioUserIdResolver = (
+  input: ComposioUserIdResolverInput,
+) => Promise<string | undefined> | string | undefined
+```
+
+**requestContext** (`RequestContext`): Live per-request context. Client-provided non-reserved entries are untrusted. Derive identity and authorize connectedAccountId only from validated, server-populated fields such as MASTRA\_USER\_KEY, read with getRaw().
+
+**toolkit** (`string`): Toolkit slug the identity is being resolved for, when known.
+
+**connectedAccountId** (`string`): Stored connection pin being resolved, when one exists. Use it to validate that the invoker may use this exact account.
+
+The resolver returns the Composio user ID, or `undefined` to use the provider's default resolution. Returning an empty string throws instead of silently falling back. The resolver can't replace the connected account.
+
+This example namespaces the Composio user by organization and asks the application's authorization layer to approve the exact account pin:
+
+```typescript
+import { MASTRA_USER_KEY } from '@mastra/server/auth'
+import { ComposioToolProvider } from '@mastra/editor/composio'
+import { canUseConnectedAccount } from './integration-authorization'
+
+type AuthenticatedUser = {
+  id: string
+  organizationId: string
+}
+
+function isAuthenticatedUser(value: unknown): value is AuthenticatedUser {
+  return (
+    typeof value === 'object' &&
+    value !== null &&
+    'id' in value &&
+    typeof value.id === 'string' &&
+    'organizationId' in value &&
+    typeof value.organizationId === 'string'
+  )
+}
+
+const composio = new ComposioToolProvider({
+  apiKey: process.env.COMPOSIO_API_KEY!,
+  userIdResolver: async ({ requestContext, toolkit, connectedAccountId }) => {
+    const user = requestContext?.getRaw(MASTRA_USER_KEY)
+    if (!isAuthenticatedUser(user)) return undefined
+
+    if (connectedAccountId) {
+      const allowed = await canUseConnectedAccount({
+        actorId: user.id,
+        organizationId: user.organizationId,
+        provider: 'composio',
+        toolkit,
+        connectedAccountId,
+      })
+      if (!allowed) {
+        throw new Error('User cannot access this connected account')
+      }
+    }
+
+    return `${user.organizationId}:${user.id}`
+  },
+})
+```
+
+Use the same namespaced ID when creating Composio connections and shared-account ACL entries. For example, Bob's Composio user ID in this setup is `acme:bob`.
+
+Throw from `userIdResolver` to deny the request. During stored-agent resolution, Mastra logs the failure and omits tools associated with that connection, so no tool call reaches Composio. Other connections continue to resolve. When calling `resolveToolsVNext()` directly, the error is returned to the caller instead.
+
 ### Connection management tools
 
 Composio provides tools for starting and monitoring authorization from an agent chat. When `allowedToolkits` is set, include `composio` to make these tools available:

package/.docs/reference/rag/retrieval.md

@@ -266,6 +266,23 @@ For detailed configuration options and advanced usage, see the [Vector Query Too
 
 Vector store prompts define query patterns and filtering capabilities for each vector database implementation. When implementing filtering, these prompts are required in the agent's instructions to specify valid operators and syntax for each vector store implementation.
 
+**MongoDB**:
+
+```ts
+import { MONGODB_PROMPT } from '@mastra/mongodb'
+
+export const ragAgent = new Agent({
+  id: 'rag-agent',
+  name: 'RAG Agent',
+  model: 'openai/gpt-5.6-sol',
+  instructions: `
+  Process queries using the provided context. Structure responses to be concise and relevant.
+  ${MONGODB_PROMPT}
+  `,
+  tools: { vectorQueryTool },
+})
+```
+
 **pgVector**:
 
 ```ts
@@ -402,23 +419,6 @@ export const ragAgent = new Agent({
 })
 ```
 
-**MongoDB**:
-
-```ts
-import { MONGODB_PROMPT } from '@mastra/mongodb'
-
-export const ragAgent = new Agent({
-  id: 'rag-agent',
-  name: 'RAG Agent',
-  model: 'openai/gpt-5.6-sol',
-  instructions: `
-  Process queries using the provided context. Structure responses to be concise and relevant.
-  ${MONGODB_PROMPT}
-  `,
-  tools: { vectorQueryTool },
-})
-```
-
 **OpenSearch**:
 
 ```ts
@@ -520,7 +520,13 @@ The weights control how different factors influence the final ranking:
 
 > **Note:** For semantic scoring to work properly during re-ranking, each result must include the text content in its `metadata.text` field.
 
-You can also use other relevance score providers like Cohere or ZeroEntropy:
+You can also use other relevance score providers like Voyage AI, Cohere, or ZeroEntropy:
+
+```ts
+import { VoyageRelevanceScorer } from '@mastra/voyageai'
+
+const relevanceProvider = new VoyageRelevanceScorer({ model: 'rerank-2.5' })
+```
 
 ```ts
 const relevanceProvider = new CohereRelevanceScorer('rerank-v3.5')
@@ -530,6 +536,8 @@ const relevanceProvider = new CohereRelevanceScorer('rerank-v3.5')
 const relevanceProvider = new ZeroEntropyRelevanceScorer('zerank-1')
 ```
 
+Voyage AI provides dedicated reranking models: `rerank-2.5` and `rerank-2.5-lite` both allow up to 32,000 tokens for the query and any single document combined, and up to 600,000 tokens across a request. `VoyageRelevanceScorer` reads `VOYAGE_API_KEY` from the environment, or accepts an `apiKey` in its config.
+
 The re-ranked results combine vector similarity with semantic understanding to improve retrieval quality.
 
 For more details about re-ranking, see the [rerank()](https://mastra.ai/reference/rag/rerankWithScorer) method.

package/.docs/reference/workspace/platform-sandbox.md

@@ -144,6 +144,15 @@ await sandbox.snapshot()
 
 Each `id` maps to one independent filesystem. Reusing the same `id` across unrelated sandboxes causes the platform to boot them from each other's checkpoint.
 
+Set `seedCheckpointName` to provide a boot-only fallback when the checkpoint for `id` doesn't exist yet. The platform restores the checkpoint for `id` first when both exist. Later snapshots continue writing to the checkpoint for `id`, so the seed remains unchanged.
+
+```typescript
+const sandbox = new PlatformSandbox({
+  id: `project-session-${sessionId}`,
+  seedCheckpointName: 'project-base',
+})
+```
+
 ### Cloning for a fleet of sandboxes
 
 `clone()` returns an independent sibling `PlatformSandbox` that inherits credentials and defaults (access token, project, environment, network isolation, timeout, instructions, env, idle timeout) with per-instance overrides. The returned sandbox is unstarted and provisions on its own `start()`, so `clone()` performs no I/O:
@@ -187,6 +196,8 @@ console.log(result.exitCode)
 
 **sandboxId** (`string`): Existing sandbox ID to reattach to instead of creating a new sandbox. When set, environmentId is not required.
 
+**seedCheckpointName** (`string`): Boot-only fallback checkpoint used when the primary recovery checkpoint for id has no stored state. Later snapshots continue writing to the checkpoint for id.
+
 **idleTimeoutMinutes** (`number`): How long the sandbox stays alive with no activity before the platform destroys it.
 
 **networkIsolation** (`'ISOLATED' | 'PRIVATE'`): Network mode. 'ISOLATED' (default) allows outbound internet only. 'PRIVATE' joins the platform environment's private network.

package/CHANGELOG.md

@@ -1,5 +1,19 @@
 # @mastra/mcp-docs-server
 
+## 1.2.17-alpha.21
+
+### Patch Changes
+
+- Updated dependencies [[`58c43d3`](https://github.com/mastra-ai/mastra/commit/58c43d3f7cb2eeaeb8ac733ae71dde822348e588)]:
+  - @mastra/core@1.60.0-alpha.14
+
+## 1.2.17-alpha.20
+
+### Patch Changes
+
+- Updated dependencies [[`c549e2f`](https://github.com/mastra-ai/mastra/commit/c549e2f40edc1cac5d9e74e82f90da22b48df084), [`c549e2f`](https://github.com/mastra-ai/mastra/commit/c549e2f40edc1cac5d9e74e82f90da22b48df084), [`2ef2f23`](https://github.com/mastra-ai/mastra/commit/2ef2f230a7aed342e7dc3b2000cd42e4c43e08a7), [`5740ec6`](https://github.com/mastra-ai/mastra/commit/5740ec60c760ffdfbfaa59d603d03b847c864e05)]:
+  - @mastra/core@1.60.0-alpha.13
+
 ## 1.2.17-alpha.19
 
 ### Patch Changes

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mastra/mcp-docs-server",
-  "version": "1.2.17-alpha.19",
+  "version": "1.2.17-alpha.21",
   "description": "MCP server for accessing Mastra.ai documentation, changelogs, and news.",
   "type": "module",
   "main": "dist/index.js",
@@ -28,8 +28,8 @@
     "jsdom": "^26.1.0",
     "local-pkg": "^1.1.2",
     "zod": "^4.4.3",
-    "@mastra/core": "1.60.0-alpha.12",
-    "@mastra/mcp": "^1.17.0-alpha.2"
+    "@mastra/mcp": "^1.17.0-alpha.2",
+    "@mastra/core": "1.60.0-alpha.14"
   },
   "devDependencies": {
     "@hono/node-server": "^2.0.0",
@@ -45,9 +45,9 @@
     "tsx": "^4.23.1",
     "typescript": "^6.0.3",
     "vitest": "4.1.10",
+    "@internal/types-builder": "0.0.98",
     "@internal/lint": "0.0.123",
-    "@mastra/core": "1.60.0-alpha.12",
-    "@internal/types-builder": "0.0.98"
+    "@mastra/core": "1.60.0-alpha.14"
   },
   "homepage": "https://mastra.ai",
   "repository": {