@mastra/mcp-docs-server 1.2.15-alpha.20 → 1.2.15-alpha.21

package/.docs/{reference/workspace/vercel-sandbox.md → integrations/sandboxes/vercel.md}

@@ -1,12 +1,14 @@
 > Discover all available pages from the documentation index: https://mastra.ai/llms.txt
 
-# VercelSandbox
+# Vercel sandboxes
+
+## Vercel Sandbox
 
 Executes commands inside [Vercel Sandbox](https://vercel.com/docs/vercel-sandbox) which is an ephemeral [Firecracker](https://firecracker-microvm.github.io/) MicroVM running Amazon Linux 2023. Provides a persistent in-session filesystem, `sudo` access, exposed ports, and background processes. For interface details, see the [WorkspaceSandbox interface](https://mastra.ai/reference/workspace/sandbox).
 
-> **Note:** This is distinct from [`VercelServerlessSandbox`](https://mastra.ai/reference/workspace/vercel-serverless), which runs commands as stateless Vercel serverless **Functions**. `VercelSandbox` runs a full Linux MicroVM with a persistent filesystem and long-running processes.
+> **Note:** This is distinct from [`VercelServerlessSandbox`](#vercel-serverless-sandbox), which runs commands as stateless Vercel serverless **Functions**. `VercelSandbox` runs a full Linux MicroVM with a persistent filesystem and long-running processes.
 
-## Installation
+### Installation
 
 **npm**:
 
@@ -32,7 +34,7 @@ yarn add @mastra/vercel
 bun add @mastra/vercel
 ```
 
-## Authentication
+### Authentication
 
 The `@vercel/sandbox` SDK uses a Vercel OIDC token automatically when no explicit credentials are provided. If you provide `token`, `teamId`, or `projectId`, provide all three values together.
 
@@ -67,7 +69,7 @@ new VercelSandbox({
 })
 ```
 
-## Usage
+### Usage
 
 Add a `VercelSandbox` to a workspace and assign it to an agent:
 
@@ -96,7 +98,7 @@ const response = await agent.generate('Print "Hello, world!" and show the Node.j
 console.log(response.text)
 ```
 
-### Resources and exposed ports
+#### Resources and exposed ports
 
 Allocate vCPUs (2048 MB of memory per vCPU) and expose ports to reach network services running inside the sandbox:
 
@@ -115,7 +117,7 @@ const { metadata } = sandbox.getInfo()
 console.log(metadata?.domains) // { 3000: 'https://....vercel.run' }
 ```
 
-### Streaming output
+#### Streaming output
 
 Stream command output in real time via `onStdout` and `onStderr` callbacks:
 
@@ -128,7 +130,7 @@ await sandbox.executeCommand('sh', ['-c', 'for i in 1 2 3; do echo "line $i"; sl
 
 Both callbacks are optional and can be used independently.
 
-## Constructor parameters
+### Constructor parameters
 
 **id** (`string`): Unique identifier for this sandbox instance. (Default: `Auto-generated`)
 
@@ -160,7 +162,7 @@ Both callbacks are optional and can be used independently.
 
 **onDestroy** (`SandboxLifecycleHook`): Lifecycle hook called before the sandbox is destroyed.
 
-## Properties
+### Properties
 
 **id** (`string`): Sandbox instance identifier.
 
@@ -174,7 +176,7 @@ Both callbacks are optional and can be used independently.
 
 **processes** (`VercelSandboxProcessManager`): Background process manager. See SandboxProcessManager reference.
 
-## Background processes
+### Background processes
 
 `VercelSandbox` includes a process manager for spawning and managing background processes. Each spawned process runs as a detached command inside the MicroVM, with output streamed through the command logs.
 
@@ -195,11 +197,138 @@ See the [`SandboxProcessManager` reference](https://mastra.ai/reference/workspac
 
 > **Note:** The Vercel Sandbox SDK doesn't expose a stdin channel for running commands, so `handle.sendStdin()` throws. Filesystem mounting (FUSE) is also not supported by this provider.
 
-## Limits
+### Limits
 
 - Up to 32 vCPUs, with 2048 MB of memory per vCPU.
 - Up to 15 exposed ports.
 - The filesystem is ephemeral. It's persisted only within the session and lost when the sandbox stops.
 - Maximum runtime is plan-dependent (45 minutes on Hobby, up to 24 hours on Pro and Enterprise), with a default of 5 minutes.
 
-See the [Vercel Sandbox documentation](https://vercel.com/docs/vercel-sandbox) for current limits and pricing.
+See the [Vercel Sandbox documentation](https://vercel.com/docs/vercel-sandbox) for current limits and pricing.
+
+## Vercel Serverless Sandbox
+
+`VercelServerlessSandbox` executes commands as [Vercel](https://vercel.com) serverless functions. It provides globally distributed, zero-infrastructure execution with automatic scaling. For interface details, see the [WorkspaceSandbox interface](https://mastra.ai/reference/workspace/sandbox).
+
+> **Warning:** `VercelServerlessSandbox` is stateless. It doesn't provide a persistent filesystem, interactive shell, or long-running background processes. Only `/tmp` is writable, and it's ephemeral between invocations.
+
+> **Note:** For a full Linux MicroVM with a persistent filesystem, `sudo` access, exposed ports, and background processes, use [`VercelSandbox`](#vercel-sandbox), which is backed by the [Vercel Sandbox](https://vercel.com/docs/vercel-sandbox) product.
+
+### Installation
+
+**npm**:
+
+```bash
+npm install @mastra/vercel
+```
+
+**pnpm**:
+
+```bash
+pnpm add @mastra/vercel
+```
+
+**Yarn**:
+
+```bash
+yarn add @mastra/vercel
+```
+
+**Bun**:
+
+```bash
+bun add @mastra/vercel
+```
+
+### Usage
+
+Add a `VercelServerlessSandbox` to a workspace and assign it to an agent:
+
+```typescript
+import { Agent } from '@mastra/core/agent'
+import { Workspace } from '@mastra/core/workspace'
+import { VercelServerlessSandbox } from '@mastra/vercel'
+
+const workspace = new Workspace({
+  sandbox: new VercelServerlessSandbox({
+    token: process.env.VERCEL_TOKEN,
+  }),
+})
+
+const agent = new Agent({
+  id: 'dev-agent',
+  name: 'dev-agent',
+  instructions: 'You are a coding assistant working in this workspace.',
+  model: 'anthropic/claude-sonnet-4-6',
+  workspace,
+})
+```
+
+#### Team-scoped deployment with custom resources
+
+```typescript
+const workspace = new Workspace({
+  sandbox: new VercelServerlessSandbox({
+    token: process.env.VERCEL_TOKEN,
+    teamId: 'team_abc123',
+    regions: ['iad1', 'sfo1'],
+    maxDuration: 120,
+    memory: 3008,
+    env: {
+      NODE_ENV: 'production',
+    },
+  }),
+})
+```
+
+### Constructor parameters
+
+**token** (`string`): Vercel API token. Falls back to VERCEL\_TOKEN environment variable.
+
+**teamId** (`string`): Vercel team ID for team-scoped deployments.
+
+**projectName** (`string`): Existing Vercel project name. Auto-generated if omitted.
+
+**regions** (`string[]`): Deployment regions. (Default: `['iad1']`)
+
+**maxDuration** (`number`): Function maximum duration in seconds. (Default: `60`)
+
+**memory** (`number`): Function memory in MB. (Default: `1024`)
+
+**env** (`Record<string, string>`): Environment variables baked into the deployed function source. These are embedded at deploy time, not set dynamically.
+
+**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.
+
+**onStart** (`SandboxLifecycleHook`): Lifecycle hook called after the sandbox reaches running status.
+
+**onStop** (`SandboxLifecycleHook`): Lifecycle hook called before the sandbox stops.
+
+**onDestroy** (`SandboxLifecycleHook`): Lifecycle hook called before the sandbox is destroyed.
+
+### Properties
+
+**id** (`string`): Unique identifier for this sandbox instance.
+
+**name** (`'VercelServerlessSandbox'`): Human-readable name.
+
+**provider** (`'vercel-serverless'`): Provider type identifier.
+
+**status** (`ProviderStatus`): Current lifecycle status: 'pending', 'starting', 'running', 'stopping', 'stopped', 'destroying', 'destroyed', or 'error'.
+
+### Limitations
+
+`VercelServerlessSandbox` uses serverless functions under the hood, which means:
+
+- **No persistent filesystem**: Files written to `/tmp` are ephemeral and cleared between invocations.
+- **No interactive shell**: Commands run via `/bin/sh -c` with no stdin streaming.
+- **No background processes**: No process manager, PIDs, or long-running tasks.
+- **No mounting**: Cloud storage mounting (S3, GCS) isn't supported.
+- **Timeout limits**: Maximum execution time is bounded by `maxDuration` (default 60s).
+
+### Related
+
+- [WorkspaceSandbox interface](https://mastra.ai/reference/workspace/sandbox)
+- [Workspace class](https://mastra.ai/reference/workspace/workspace-class)
+- [E2B sandbox](https://mastra.ai/integrations/sandboxes/e2b): Full-featured cloud sandbox with persistent filesystem and process management

package/.docs/{reference → integrations}/tools/brightdata.md

@@ -1,6 +1,6 @@
 > Discover all available pages from the documentation index: https://mastra.ai/llms.txt
 
-# Bright Data tools
+# Bright Data
 
 The `@mastra/brightdata` package wraps the [Bright Data SDK](https://github.com/brightdata/bright-data-sdk-node) as Mastra-compatible tools. It exposes factory functions for web search and web fetch. Each function returns a tool created with [`createTool()`](https://mastra.ai/reference/tools/create-tool) that includes full Zod input/output schemas.
 

package/.docs/{reference → integrations}/tools/perplexity.md

@@ -1,6 +1,6 @@
 > Discover all available pages from the documentation index: https://mastra.ai/llms.txt
 
-# Perplexity tools
+# Perplexity
 
 The `@mastra/perplexity` package wraps the [Perplexity Search API](https://docs.perplexity.ai/docs/search/quickstart) as a Mastra-compatible tool. It exposes a factory function that returns a tool created with [`createTool()`](https://mastra.ai/reference/tools/create-tool) and full Zod input/output schemas.
 

package/.docs/{reference → integrations}/tools/tavily.md

@@ -1,6 +1,6 @@
 > Discover all available pages from the documentation index: https://mastra.ai/llms.txt
 
-# Tavily tools
+# Tavily
 
 The `@mastra/tavily` package wraps the [Tavily](https://app.tavily.com) API as Mastra-compatible tools. It exposes factory functions for search, extract, crawl, and map. Each function returns a tool created with [`createTool()`](https://mastra.ai/reference/tools/create-tool) that includes full Zod input/output schemas.
 

package/.docs/{reference → integrations}/voice/aws-nova-sonic.md

@@ -1,6 +1,6 @@
 > Discover all available pages from the documentation index: https://mastra.ai/llms.txt
 
-# AWS Nova Sonic voice
+# AWS Nova Sonic
 
 The `NovaSonicVoice` class provides real-time speech-to-speech capabilities backed by [AWS Bedrock Nova 2 Sonic](https://docs.aws.amazon.com/nova/latest/userguide/speech.html). It opens a bidirectional stream to the model and emits events for assistant audio, transcribed text, tool calls, turn boundaries, and interruptions.
 

package/.docs/{reference → integrations}/voice/cloudflare.md

@@ -80,6 +80,6 @@ Returns an array of available voice options, where each node contains:
 
 If you need speech-to-text capabilities in addition to text-to-speech, consider using one of these providers:
 
-- [OpenAI](https://mastra.ai/reference/voice/openai): Provides both TTS and STT
-- [Google](https://mastra.ai/reference/voice/google): Provides both TTS and STT
-- [Azure](https://mastra.ai/reference/voice/azure): Provides both TTS and STT
+- [OpenAI](https://mastra.ai/integrations/voice/openai): Provides both TTS and STT
+- [Google](https://mastra.ai/integrations/voice/google): Provides both TTS and STT
+- [Azure](https://mastra.ai/integrations/voice/azure): Provides both TTS and STT