@mastra/mcp-docs-server 1.2.5-alpha.1 → 1.2.5-alpha.5

package/.docs/reference/voice/voice.on.md

@@ -50,7 +50,7 @@ voice.on('error', ({ message, code, details }) => {
 
 ## Parameters
 
-**event** (`string`): Name of the event to listen for. See the \[Voice Events]\(./voice.events) documentation for a list of available events.
+**event** (`string`): Name of the event to listen for. See the Voice Events documentation for a list of available events.
 
 **callback** (`function`): Callback function that will be called when the event occurs. The callback signature depends on the specific event.
 

package/.docs/reference/workflows/run-methods/resume.md

@@ -28,7 +28,7 @@ if (result.status === 'suspended') {
 
 **retryCount** (`number`): Optional retry count for nested workflow execution
 
-**forEachIndex** (`number`): Target a specific iteration of a suspended \`.foreach()\` step. Pass the zero-based index of the iteration you want to resume; other iterations remain suspended. Omit this field to resume all suspended iterations of the step with the same \`resumeData\`.
+**forEachIndex** (`number`): Target a specific iteration of a suspended .foreach() step. Pass the zero-based index of the iteration you want to resume; other iterations remain suspended. Omit this field to resume all suspended iterations of the step with the same resumeData.
 
 **tracingContext** (`TracingContext`): Tracing context for creating child spans and adding metadata. Automatically injected when using Mastra's tracing system.
 

package/.docs/reference/workflows/run-methods/timeTravel.md

@@ -159,4 +159,4 @@ const result = await run.timeTravel({
 - [Workflows overview](https://mastra.ai/docs/workflows/overview)
 - [Workflow.createRun()](https://mastra.ai/reference/workflows/workflow-methods/create-run)
 - [Snapshots](https://mastra.ai/docs/workflows/snapshots)
-- [Suspend & Resume](https://mastra.ai/docs/workflows/suspend-and-resume)
+- [Suspend and Resume](https://mastra.ai/docs/workflows/suspend-and-resume)

package/.docs/reference/workspace/agentcore-runtime-sandbox.md

@@ -94,13 +94,13 @@ if (!result?.success) {
 
 **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`)
+**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`)
 
-**stopClientToken** (`string`): Client token used when \`StopRuntimeSession\` is called. (Default: `Generated UUID`)
+**stopClientToken** (`string`): Client token used when StopRuntimeSession is called. (Default: `Generated UUID`)
 
 **client** (`BedrockAgentCoreClient`): Preconfigured AWS SDK client. Use this for custom credentials, retry behavior, or tests.
 
-**instructions** (`string | ((opts) => string)`): Custom instructions that override the default instructions returned by \`getInstructions()\`. Pass a string to replace the defaults, or a function to extend them.
+**instructions** (`string | ((opts) => string)`): Custom instructions that override the default instructions returned by getInstructions(). Pass a string to replace the defaults, or a function to extend them.
 
 ## Properties
 
@@ -110,7 +110,7 @@ if (!result?.success) {
 
 **provider** (`'agentcore'`): Provider type identifier.
 
-**status** (`ProviderStatus`): Current lifecycle status: \`'pending'\`, \`'starting'\`, \`'running'\`, \`'stopping'\`, \`'stopped'\`, \`'destroying'\`, \`'destroyed'\`, or \`'error'\`.
+**status** (`ProviderStatus`): Current lifecycle status: 'pending', 'starting', 'running', 'stopping', 'stopped', 'destroying', 'destroyed', or 'error'.
 
 **runtimeSessionId** (`string`): AgentCore Runtime session ID used for command execution.
 

package/.docs/reference/workspace/agentfs-filesystem.md

@@ -86,7 +86,7 @@ const filesystem = new AgentFSFilesystem({
 
 You must provide at least one of `agentId`, `path`, or `agent`.
 
-**agentId** (`string`): Agent ID — creates database at \`.agentfs/\<agentId>.db\`
+**agentId** (`string`): Agent ID — creates database at .agentfs/\<agentId>.db
 
 **path** (`string`): Explicit database file path (alternative to agentId)
 

package/.docs/reference/workspace/apple-container-sandbox.md

@@ -73,7 +73,7 @@ console.log(response.text)
 
 **id** (`string`): Unique identifier for this sandbox instance. (Default: `Auto-generated`)
 
-**name** (`string`): Apple container name passed to \`container run --name\`. Characters outside \`\[a-zA-Z0-9\_.-]\` are replaced with \`-\` and the result is prefixed if it would not start with an alphanumeric character. (Default: `` The sandbox `id` ``)
+**name** (`string`): Apple container name passed to container run --name. Characters outside \[a-zA-Z0-9\_.-] are replaced with - and the result is prefixed if it would not start with an alphanumeric character. (Default: `` The sandbox `id` ``)
 
 **image** (`string`): OCI image to use for the container. (Default: `'node:22-slim'`)
 
@@ -83,13 +83,13 @@ console.log(response.text)
 
 **volumes** (`Record<string, string>`): Host-to-container bind mounts. Keys are host paths, values are container paths.
 
-**mounts** (`string[]`): Raw \`container run --mount\` specs.
+**mounts** (`string[]`): Raw container run --mount specs.
 
 **network** (`string`): Apple container network attachment spec.
 
-**publishedPorts** (`string[]`): Port publish specs passed as \`--publish\`.
+**publishedPorts** (`string[]`): Port publish specs passed as --publish.
 
-**publishedSockets** (`string[]`): Socket publish specs passed as \`--publish-socket\`.
+**publishedSockets** (`string[]`): Socket publish specs passed as --publish-socket.
 
 **cpus** (`number | string`): Number of CPUs to allocate.
 
@@ -115,7 +115,7 @@ console.log(response.text)
 
 **capDrop** (`string[]`): Linux capabilities to drop.
 
-**tmpfs** (`string[]`): tmpfs destination paths passed as \`--tmpfs\`, for example \`/tmp\`.
+**tmpfs** (`string[]`): tmpfs destination paths passed as --tmpfs, for example /tmp.
 
 **dns** (`string[]`): DNS nameserver IPs.
 

package/.docs/reference/workspace/archil-filesystem.md

@@ -95,17 +95,17 @@ const filesystem = new ArchilFilesystem({
 
 ## Constructor parameters
 
-**diskId** (`string`): Existing Archil disk ID (e.g. "dsk-0123456789abcdef"). Mutually exclusive with \`createDiskOptions\`.
+**diskId** (`string`): Existing Archil disk ID (e.g. "dsk-0123456789abcdef"). Mutually exclusive with createDiskOptions.
 
-**createDiskOptions** (`CreateDiskRequest`): Options for creating a new disk on init. Mutually exclusive with \`diskId\`.
+**createDiskOptions** (`CreateDiskRequest`): Options for creating a new disk on init. Mutually exclusive with diskId.
 
-**apiKey** (`string`): Archil API key. Falls back to \`ARCHIL\_API\_KEY\` environment variable.
+**apiKey** (`string`): Archil API key. Falls back to ARCHIL\_API\_KEY environment variable.
 
-**region** (`string`): Archil region (e.g. "aws-us-east-1"). Falls back to \`ARCHIL\_REGION\` environment variable.
+**region** (`string`): Archil region (e.g. "aws-us-east-1"). Falls back to ARCHIL\_REGION environment variable.
 
 **baseUrl** (`string`): Custom Archil control-plane URL (for testing or self-hosted deployments).
 
-**s3BaseUrl** (`string`): Custom S3-compatible API URL. Falls back to \`ARCHIL\_S3\_BASE\_URL\` environment variable.
+**s3BaseUrl** (`string`): Custom S3-compatible API URL. Falls back to ARCHIL\_S3\_BASE\_URL environment variable.
 
 **id** (`string`): Unique identifier for this filesystem instance. (Default: `Auto-generated`)
 

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

@@ -101,7 +101,7 @@ const workspace = new Workspace({
 
 **instance** (`SandboxInstance`): The underlying Blaxel SandboxInstance for direct access to Blaxel APIs. Throws SandboxNotReadyError if the sandbox has not been started.
 
-**processes** (`BlaxelProcessManager`): Background process manager. See \[SandboxProcessManager reference]\(/reference/workspace/process-manager).
+**processes** (`BlaxelProcessManager`): Background process manager. See SandboxProcessManager reference.
 
 ## Background processes
 

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

@@ -321,7 +321,7 @@ const workspace = new Workspace({
 
 **instance** (`Sandbox`): The underlying Daytona Sandbox instance. Throws SandboxNotReadyError if the sandbox has not been started.
 
-**processes** (`DaytonaProcessManager`): Background process manager. See \[SandboxProcessManager reference]\(/reference/workspace/process-manager).
+**processes** (`DaytonaProcessManager`): Background process manager. See SandboxProcessManager reference.
 
 ## Background processes
 

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

@@ -61,7 +61,7 @@ const agent = new Agent({
 
 **id** (`string`): Unique identifier for this sandbox instance. Used for label-based reconnection. (Default: `Auto-generated`)
 
-**name** (`string`): Container display name passed to Docker as \`--name\`. Characters outside \`\[a-zA-Z0-9\_.-]\` are replaced with \`-\` and the result is prefixed if it would not start with an alphanumeric character. (Default: `` The sandbox `id` ``)
+**name** (`string`): Container display name passed to Docker as --name. Characters outside \[a-zA-Z0-9\_.-] are replaced with - and the result is prefixed if it would not start with an alphanumeric character. (Default: `` The sandbox `id` ``)
 
 **image** (`string`): Docker image to use for the container. (Default: `'node:22-slim'`)
 
@@ -121,7 +121,7 @@ const agent = new Agent({
 
 **container** (`Container`): The underlying dockerode Container instance. Throws SandboxNotReadyError if the sandbox has not been started.
 
-**processes** (`DockerProcessManager`): Background process manager. See \[SandboxProcessManager reference]\(/reference/workspace/process-manager).
+**processes** (`DockerProcessManager`): Background process manager. See SandboxProcessManager reference.
 
 ## Background processes
 

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

@@ -76,7 +76,7 @@ const agent = new Agent({
 
 **metadata** (`Record<string, unknown>`): Custom metadata attached to the sandbox instance.
 
-**instructions** (`string | ((opts: { defaultInstructions: string; requestContext?: RequestContext }) => string)`): Custom instructions returned by \`getInstructions()\`. A string fully replaces the defaults; a function receives the defaults and can extend or customize them per-request. Pass an empty string to suppress instructions entirely.
+**instructions** (`string | ((opts: { defaultInstructions: string; requestContext?: RequestContext }) => string)`): Custom instructions returned by getInstructions(). A string fully replaces the defaults; a function receives the defaults and can extend or customize them per-request. Pass an empty string to suppress instructions entirely.
 
 ## Properties
 
@@ -88,7 +88,7 @@ const agent = new Agent({
 
 **status** (`ProviderStatus`): 'pending' | 'initializing' | 'ready' | 'starting' | 'running' | 'stopping' | 'stopped' | 'destroying' | 'destroyed' | 'error'
 
-**processes** (`E2BProcessManager`): Background process manager. See \[SandboxProcessManager reference]\(/reference/workspace/process-manager).
+**processes** (`E2BProcessManager`): Background process manager. See SandboxProcessManager reference.
 
 ## Background processes
 

package/.docs/reference/workspace/files-sdk-filesystem.md

@@ -105,7 +105,7 @@ All write operations (`writeFile`, `appendFile`, `deleteFile`, `copyFile`, `move
 
 ## Constructor parameters
 
-**files** (`Files`): A pre-configured FilesSDK \`Files\` instance bound to the adapter and credentials you want to use.
+**files** (`Files`): A pre-configured FilesSDK Files instance bound to the adapter and credentials you want to use.
 
 **id** (`string`): Unique identifier for this filesystem instance. (Default: `Auto-generated`)
 

package/.docs/reference/workspace/filesystem.md

@@ -263,7 +263,7 @@ const instructions = filesystem.getInstructions?.()
 
 **Parameters:**
 
-**opts.requestContext** (`RequestContext`): Forwarded to the \`instructions\` function if one was provided in the constructor.
+**opts.requestContext** (`RequestContext`): Forwarded to the instructions function if one was provided in the constructor.
 
 **Returns:** `string`
 

package/.docs/reference/workspace/local-filesystem.md

@@ -38,9 +38,9 @@ const response = await agent.generate('List all files in the workspace')
 
 **id** (`string`): Unique identifier for this filesystem instance (Default: `Auto-generated`)
 
-**contained** (`boolean`): When true, all file operations are restricted to stay within basePath. Prevents path traversal attacks and symlink escapes. See \[containment]\(/docs/workspace/filesystem#containment). (Default: `true`)
+**contained** (`boolean`): When true, all file operations are restricted to stay within basePath. Prevents path traversal attacks and symlink escapes. See containment. (Default: `true`)
 
-**allowedPaths** (`string[]`): Additional directories the agent can access outside of \`basePath\`. (Default: `[]`)
+**allowedPaths** (`string[]`): Additional directories the agent can access outside of basePath. (Default: `[]`)
 
 **instructions** (`string | ((opts: { defaultInstructions: string; requestContext?: RequestContext }) => string)`): Custom instructions that override the default instructions returned by getInstructions(). Pass a string to fully replace them, or a function to extend them with access to the current requestContext for per-request customization.
 
@@ -302,7 +302,7 @@ const instructions = filesystem.getInstructions({ requestContext })
 
 **Parameters:**
 
-**opts.requestContext** (`RequestContext`): Forwarded to the \`instructions\` function if one was provided in the constructor.
+**opts.requestContext** (`RequestContext`): Forwarded to the instructions function if one was provided in the constructor.
 
 **Returns:** `string`
 

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

@@ -84,7 +84,7 @@ Configuration options for native OS sandboxing (used with `isolation: 'seatbelt'
 
 **workingDirectory** (`string`): The configured working directory
 
-**processes** (`LocalProcessManager`): Background process manager. See \[SandboxProcessManager reference]\(/reference/workspace/process-manager).
+**processes** (`LocalProcessManager`): Background process manager. See SandboxProcessManager reference.
 
 ## Path Resolution
 

package/.docs/reference/workspace/mesa-filesystem.md

@@ -65,7 +65,7 @@ const agent = new Agent({
 
 ## Constructor parameters
 
-**apiKey** (`string`): Mesa API key. Falls back to \`MESA\_API\_KEY\` when omitted.
+**apiKey** (`string`): Mesa API key. Falls back to MESA\_API\_KEY when omitted.
 
 **org** (`string`): Mesa org slug. When omitted, the Mesa SDK resolves the default org.
 
@@ -81,9 +81,9 @@ const agent = new Agent({
 
 **id** (`string`): Filesystem instance identifier.
 
-**name** (`string`): Provider name (\`'MesaFilesystem'\`).
+**name** (`string`): Provider name ('MesaFilesystem').
 
-**provider** (`string`): Provider identifier (\`'mesa'\`).
+**provider** (`string`): Provider identifier ('mesa').
 
 **readOnly** (`boolean | undefined`): Whether write operations are blocked.
 

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

@@ -114,7 +114,7 @@ Get your credentials from the [Modal dashboard](https://modal.com/settings/token
 
 **modal** (`Sandbox`): The underlying Modal Sandbox instance. Throws SandboxNotReadyError if the sandbox has not been started.
 
-**processes** (`ModalProcessManager`): Background process manager. See \[SandboxProcessManager reference]\(/reference/workspace/process-manager).
+**processes** (`ModalProcessManager`): Background process manager. See SandboxProcessManager reference.
 
 ## Sandbox lifecycle
 

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

@@ -188,7 +188,7 @@ const result = await sandbox.executeCommand('cat', ['/tmp/state.txt'])
 
 **railway** (`Sandbox`): The underlying Railway Sandbox instance for direct SDK access. Throws SandboxNotReadyError if the sandbox has not been started.
 
-**processes** (`RailwayProcessManager`): Background process manager. See \[SandboxProcessManager reference]\(/reference/workspace/process-manager).
+**processes** (`RailwayProcessManager`): Background process manager. See SandboxProcessManager reference.
 
 ## Methods
 

package/.docs/reference/workspace/s3-filesystem.md

@@ -164,13 +164,13 @@ Tigris uses virtual-hosted-style addressing, so `forcePathStyle` must be set to
 
 **region** (`string`): AWS region (use 'auto' for R2)
 
-**credentials** (`AwsCredentialIdentity | AwsCredentialIdentityProvider`): AWS credentials or credential provider function. Accepts static credentials or a provider that auto-refreshes (e.g. \`fromNodeProviderChain()\` from \`@aws-sdk/credential-providers\`). Takes precedence over \`accessKeyId\`/\`secretAccessKey\`/\`sessionToken\`. When all credential options are omitted, the SDK default credential provider chain is used.
+**credentials** (`AwsCredentialIdentity | AwsCredentialIdentityProvider`): AWS credentials or credential provider function. Accepts static credentials or a provider that auto-refreshes (e.g. fromNodeProviderChain() from @aws-sdk/credential-providers). Takes precedence over accessKeyId/secretAccessKey/sessionToken. When all credential options are omitted, the SDK default credential provider chain is used.
 
-**accessKeyId** (`string`): AWS access key ID. When omitted along with \`secretAccessKey\` and \`credentials\`, the SDK default credential provider chain is used.
+**accessKeyId** (`string`): AWS access key ID. When omitted along with secretAccessKey and credentials, the SDK default credential provider chain is used.
 
-**secretAccessKey** (`string`): AWS secret access key. When omitted along with \`accessKeyId\` and \`credentials\`, the SDK default credential provider chain is used.
+**secretAccessKey** (`string`): AWS secret access key. When omitted along with accessKeyId and credentials, the SDK default credential provider chain is used.
 
-**sessionToken** (`string`): AWS session token for static temporary credentials. Use with \`accessKeyId\`/\`secretAccessKey\` only when passing a complete temporary credential set manually. For auto-refreshing SSO, AssumeRole, or container credentials, use the \`credentials\` provider parameter or the SDK default credential provider chain.
+**sessionToken** (`string`): AWS session token for static temporary credentials. Use with accessKeyId/secretAccessKey only when passing a complete temporary credential set manually. For auto-refreshing SSO, AssumeRole, or container credentials, use the credentials provider parameter or the SDK default credential provider chain.
 
 **endpoint** (`string`): Custom endpoint URL for S3-compatible storage (R2, MinIO, Tigris, etc.)
 

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

@@ -85,7 +85,7 @@ const instructions = sandbox.getInstructions?.()
 
 **Parameters:**
 
-**opts.requestContext** (`RequestContext`): Forwarded to the \`instructions\` function if one was provided in the constructor.
+**opts.requestContext** (`RequestContext`): Forwarded to the instructions function if one was provided in the constructor.
 
 **Returns:** `string`
 

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

@@ -1,12 +1,12 @@
 > Discover all available pages from the documentation index: https://mastra.ai/llms.txt
 
-# VercelMicroVMSandbox
+# VercelSandbox
 
-Executes commands inside [Vercel Sandbox](https://vercel.com/docs/vercel-sandbox) — 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.
+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.
 
 > **Info:** For interface details, see the [WorkspaceSandbox interface](https://mastra.ai/reference/workspace/sandbox).
 
-> **Note:** This is distinct from [`VercelSandbox`](https://mastra.ai/reference/workspace/vercel), which runs commands as stateless Vercel serverless **Functions**. `VercelMicroVMSandbox` runs a full Linux MicroVM with a persistent filesystem and long-running processes.
+> **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.
 
 ## Installation
 
@@ -36,7 +36,7 @@ bun add @mastra/vercel
 
 ## Authentication
 
-The `@vercel/sandbox` SDK uses a Vercel OIDC token automatically when available.
+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.
 
 **OIDC (recommended)**:
 
@@ -62,7 +62,7 @@ VERCEL_PROJECT_ID=your-project-id
 **Constructor**:
 
 ```typescript
-new VercelMicroVMSandbox({
+new VercelSandbox({
   token: 'your-token',
   teamId: 'your-team-id',
   projectId: 'your-project-id',
@@ -71,15 +71,15 @@ new VercelMicroVMSandbox({
 
 ## Usage
 
-Add a `VercelMicroVMSandbox` to a workspace and assign it to an agent:
+Add a `VercelSandbox` to a workspace and assign it to an agent:
 
 ```typescript
 import { Agent } from '@mastra/core/agent'
 import { Workspace } from '@mastra/core/workspace'
-import { VercelMicroVMSandbox } from '@mastra/vercel'
+import { VercelSandbox } from '@mastra/vercel'
 
 const workspace = new Workspace({
-  sandbox: new VercelMicroVMSandbox({
+  sandbox: new VercelSandbox({
     runtime: 'node24',
     timeout: 600_000,
   }),
@@ -103,14 +103,14 @@ console.log(response.text)
 Allocate vCPUs (2048 MB of memory per vCPU) and expose ports to reach network services running inside the sandbox:
 
 ```typescript
-const sandbox = new VercelMicroVMSandbox({
+const sandbox = new VercelSandbox({
   runtime: 'node24',
   resources: { vcpus: 4 },
   ports: [3000],
 })
 
 const workspace = new Workspace({ sandbox })
-await sandbox._start()
+await sandbox.start()
 
 // The public HTTPS domain for an exposed port is available via getInfo()
 const { metadata } = sandbox.getInfo()
@@ -156,26 +156,32 @@ Both callbacks are optional and can be used independently.
 
 **instructions** (`string | ((opts) => string)`): Override the default instructions returned by getInstructions(). Pass a string to replace them, 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`): Sandbox instance identifier.
 
-**name** (`string`): Provider name ('VercelMicroVMSandbox').
+**name** (`'VercelSandbox'`): Human-readable name.
 
-**provider** (`string`): Provider identifier ('vercel-microvm').
+**provider** (`'vercel-sandbox'`): Provider type identifier.
 
 **status** (`ProviderStatus`): 'pending' | 'starting' | 'running' | 'stopping' | 'stopped' | 'destroying' | 'destroyed' | 'error'
 
 **sandbox** (`Sandbox`): The underlying @vercel/sandbox Sandbox instance. Throws SandboxNotReadyError if the sandbox has not been started.
 
-**processes** (`VercelMicroVMProcessManager`): Background process manager. See \[SandboxProcessManager reference]\(/reference/workspace/process-manager).
+**processes** (`VercelSandboxProcessManager`): Background process manager. See SandboxProcessManager reference.
 
 ## Background processes
 
-`VercelMicroVMSandbox` 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.
+`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.
 
 ```typescript
-const sandbox = new VercelMicroVMSandbox({ runtime: 'node24', ports: [3000] })
+const sandbox = new VercelSandbox({ runtime: 'node24', ports: [3000] })
 await sandbox.start()
 
 const handle = await sandbox.processes.spawn('node server.js', {

package/.docs/reference/workspace/{vercel.md → vercel-serverless.md}

@@ -1,14 +1,14 @@
 > Discover all available pages from the documentation index: https://mastra.ai/llms.txt
 
-# VercelSandbox
+# VercelServerlessSandbox
 
-Executes commands as [Vercel](https://vercel.com) serverless functions. Provides globally-distributed, zero-infrastructure execution with automatic scaling.
+Executes commands as [Vercel](https://vercel.com) serverless functions. Provides globally distributed, zero-infrastructure execution with automatic scaling.
 
 > **Info:** For interface details, see [WorkspaceSandbox interface](https://mastra.ai/reference/workspace/sandbox).
 
-> **Warning:** VercelSandbox is stateless. No persistent filesystem, no interactive shell, and no support for long-running or background processes exist. Only `/tmp` is writable and is ephemeral between invocations.
+> **Warning:** VercelServerlessSandbox is stateless. It doesn't provide a persistent filesystem, interactive shell, or long-running background processes. Only `/tmp` is writable, and it is ephemeral between invocations.
 
-> **Note:** For a full Linux MicroVM with a persistent filesystem, `sudo` access, exposed ports, and background processes, use [`VercelMicroVMSandbox`](https://mastra.ai/reference/workspace/vercel-microvm-sandbox), which is backed by the [Vercel Sandbox](https://vercel.com/docs/vercel-sandbox) product.
+> **Note:** For a full Linux MicroVM with a persistent filesystem, `sudo` access, exposed ports, and background processes, use [`VercelSandbox`](https://mastra.ai/reference/workspace/vercel-sandbox), which is backed by the [Vercel Sandbox](https://vercel.com/docs/vercel-sandbox) product.
 
 ## Installation
 
@@ -38,15 +38,15 @@ bun add @mastra/vercel
 
 ## Usage
 
-Add a `VercelSandbox` to a workspace and assign it to an agent:
+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 { VercelSandbox } from '@mastra/vercel'
+import { VercelServerlessSandbox } from '@mastra/vercel'
 
 const workspace = new Workspace({
-  sandbox: new VercelSandbox({
+  sandbox: new VercelServerlessSandbox({
     token: process.env.VERCEL_TOKEN,
   }),
 })
@@ -54,6 +54,7 @@ const workspace = new Workspace({
 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,
 })
@@ -63,7 +64,7 @@ const agent = new Agent({
 
 ```typescript
 const workspace = new Workspace({
-  sandbox: new VercelSandbox({
+  sandbox: new VercelServerlessSandbox({
     token: process.env.VERCEL_TOKEN,
     teamId: 'team_abc123',
     regions: ['iad1', 'sfo1'],
@@ -78,7 +79,7 @@ const workspace = new Workspace({
 
 ## Constructor parameters
 
-**token** (`string`): Vercel API token. Falls back to \`VERCEL\_TOKEN\` environment variable.
+**token** (`string`): Vercel API token. Falls back to VERCEL\_TOKEN environment variable.
 
 **teamId** (`string`): Vercel team ID for team-scoped deployments.
 
@@ -94,21 +95,27 @@ const workspace = new Workspace({
 
 **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.
+**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** (`'VercelSandbox'`): Human-readable name.
+**name** (`'VercelServerlessSandbox'`): Human-readable name.
 
-**provider** (`'vercel'`): Provider type identifier.
+**provider** (`'vercel-serverless'`): Provider type identifier.
 
-**status** (`ProviderStatus`): Current lifecycle status: \`'pending'\`, \`'starting'\`, \`'running'\`, \`'stopping'\`, \`'stopped'\`, \`'destroying'\`, \`'destroyed'\`, or \`'error'\`.
+**status** (`ProviderStatus`): Current lifecycle status: 'pending', 'starting', 'running', 'stopping', 'stopped', 'destroying', 'destroyed', or 'error'.
 
 ## Limitations
 
-VercelSandbox uses serverless functions under the hood, which means:
+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.

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

@@ -31,19 +31,19 @@ const workspace = new Workspace({
 
 **name** (`string`): Human-readable name (Default: `workspace-{id}`)
 
-**filesystem** (`WorkspaceFilesystem | WorkspaceFilesystemResolver`): Filesystem provider instance, or a resolver function that receives \`requestContext\` and returns a filesystem per request. See \[dynamic filesystem]\(/docs/workspace/filesystem#dynamic-filesystem).
+**filesystem** (`WorkspaceFilesystem | WorkspaceFilesystemResolver`): Filesystem provider instance, or a resolver function that receives requestContext and returns a filesystem per request. See dynamic filesystem.
 
-**sandbox** (`WorkspaceSandbox | WorkspaceSandboxResolver`): Sandbox provider instance, or a resolver function that receives \`requestContext\` and returns a sandbox per request. See \[dynamic sandbox]\(/docs/workspace/sandbox#dynamic-sandbox).
+**sandbox** (`WorkspaceSandbox | WorkspaceSandboxResolver`): Sandbox provider instance, or a resolver function that receives requestContext and returns a sandbox per request. See dynamic sandbox.
 
-**instructions.dynamicSandbox** (`'placeholder' | 'resolve' | (({ requestContext }) => string)`): Controls how a resolver-backed \`sandbox\` contributes to workspace instructions. \`'placeholder'\` (default) emits stable text without calling the resolver. \`'resolve'\` calls the resolver and uses the sandbox's own instructions. A function returns custom text without resolving. Has no effect on a static sandbox. (Default: `'placeholder'`)
+**instructions.dynamicSandbox** (`'placeholder' | 'resolve' | (({ requestContext }) => string)`): Controls how a resolver-backed sandbox contributes to workspace instructions. 'placeholder' (default) emits stable text without calling the resolver. 'resolve' calls the resolver and uses the sandbox's own instructions. A function returns custom text without resolving. Has no effect on a static sandbox. (Default: `'placeholder'`)
 
-**sandboxCacheKey** (`({ requestContext }) => string | undefined`): Stable cache key for a resolver-backed \`sandbox\`. When set, resolved sandboxes are memoized per key instead of per \`RequestContext\` instance, so background-process tools reach the same sandbox across follow-up requests. Has no effect on a static sandbox.
+**sandboxCacheKey** (`({ requestContext }) => string | undefined`): Stable cache key for a resolver-backed sandbox. When set, resolved sandboxes are memoized per key instead of per RequestContext instance, so background-process tools reach the same sandbox across follow-up requests. Has no effect on a static sandbox.
 
 **bm25** (`boolean | BM25Config`): Enable BM25 keyword search. Pass true for defaults or a config object. (Default: `undefined`)
 
 **vectorStore** (`MastraVector`): Vector store for semantic search
 
-**embedder** (`Embedder`): Function that turns text into vectors. Required when \`vectorStore\` is set. Accepts either a single-text function \`(text: string) => Promise\<number\[]>\` or a batch-capable function \`(texts: string\[]) => Promise\<number\[]\[]>\` that has a \`batch: true\` property and an optional \`maxBatchSize\`. See \[Batch embedding]\(/docs/workspace/search#batch-embedding).
+**embedder** (`Embedder`): Function that turns text into vectors. Required when vectorStore is set. Accepts either a single-text function (text: string) => Promise\<number\[]> or a batch-capable function (texts: string\[]) => Promise\<number\[]\[]> that has a batch: true property and an optional maxBatchSize. See Batch embedding.
 
 **autoIndexPaths** (`string[]`): Paths or glob patterns to auto-index on init(). Supports glob patterns like '\*\*/\*.md' for selective indexing.
 
@@ -61,7 +61,7 @@ const workspace = new Workspace({
 
 **tools.requireApproval** (`boolean`): Whether the tool requires user approval before execution
 
-**tools.name** (`string`): Custom name to expose this tool as. Replaces the default \`mastra\_workspace\_\*\` name. The config key must still use the original \`WORKSPACE\_TOOLS\` constant.
+**tools.name** (`string`): Custom name to expose this tool as. Replaces the default mastra\_workspace\_\* name. The config key must still use the original WORKSPACE\_TOOLS constant.
 
 **tools.requireReadBeforeWrite** (`boolean`): For write tools: require reading the file first to prevent overwrites
 
@@ -144,9 +144,9 @@ const workspace = new Workspace({
 })
 ```
 
-**beforeToolCall** (`(context: WorkspaceToolHookContext) => void | WorkspaceToolBeforeHookResult | Promise<void | WorkspaceToolBeforeHookResult>`): Runs before a workspace tool executes. Receives \`{ toolName, workspaceToolName, input, context }\`. Return \`{ proceed: false, output }\` to skip the tool call and use \`output\` as its result.
+**beforeToolCall** (`(context: WorkspaceToolHookContext) => void | WorkspaceToolBeforeHookResult | Promise<void | WorkspaceToolBeforeHookResult>`): Runs before a workspace tool executes. Receives { toolName, workspaceToolName, input, context }. Return { proceed: false, output } to skip the tool call and use output as its result.
 
-**afterToolCall** (`(context: WorkspaceToolAfterHookContext) => void | Promise<void>`): Runs after a workspace tool executes. Receives \`{ toolName, workspaceToolName, input, context, output, error }\`. \`output\` is undefined when the tool throws, and \`error\` is set instead.
+**afterToolCall** (`(context: WorkspaceToolAfterHookContext) => void | Promise<void>`): Runs after a workspace tool executes. Receives { toolName, workspaceToolName, input, context, output, error }. output is undefined when the tool throws, and error is set instead.
 
 If the owning agent also defines [tool hooks](https://mastra.ai/reference/agents/agent), workspace hooks run inside the agent hook wrapper: agent `beforeToolCall` runs first, then workspace `beforeToolCall`, then the tool, then workspace `afterToolCall`, then agent `afterToolCall`.
 
@@ -158,9 +158,9 @@ If the owning agent also defines [tool hooks](https://mastra.ai/reference/agents
 
 **status** (`WorkspaceStatus`): 'pending' | 'initializing' | 'ready' | 'paused' | 'error' | 'destroying' | 'destroyed'
 
-**filesystem** (`WorkspaceFilesystem | undefined`): The static filesystem provider. Returns \`undefined\` when a resolver function is configured — use \`hasFilesystemConfig()\` to check availability.
+**filesystem** (`WorkspaceFilesystem | undefined`): The static filesystem provider. Returns undefined when a resolver function is configured — use hasFilesystemConfig() to check availability.
 
-**sandbox** (`WorkspaceSandbox | undefined`): The static sandbox provider. Returns \`undefined\` when a resolver function is configured — use \`hasSandboxConfig()\` to check availability.
+**sandbox** (`WorkspaceSandbox | undefined`): The static sandbox provider. Returns undefined when a resolver function is configured — use hasSandboxConfig() to check availability.
 
 **skills** (`WorkspaceSkills | undefined`): Skills interface for accessing SKILL.md files
 
@@ -250,9 +250,9 @@ const info = await workspace.getInfo({ resolveDynamicProviders: false })
 
 **options.includeFileCount** (`boolean`): Whether to count total files. This can be slow for large workspaces.
 
-**options.requestContext** (`RequestContext`): Passed to dynamic provider resolvers when \`resolveDynamicProviders\` is enabled.
+**options.requestContext** (`RequestContext`): Passed to dynamic provider resolvers when resolveDynamicProviders is enabled.
 
-**options.resolveDynamicProviders** (`boolean`): Whether to invoke dynamic provider resolvers. Set to \`false\` when you only need metadata and want resolver-backed providers reported as \`dynamic\`. (Default: `true`)
+**options.resolveDynamicProviders** (`boolean`): Whether to invoke dynamic provider resolvers. Set to false when you only need metadata and want resolver-backed providers reported as dynamic. (Default: `true`)
 
 #### `getInstructions(opts?)`
 
@@ -270,7 +270,7 @@ const instructions = workspace.getInstructions({ requestContext })
 
 **Parameters:**
 
-**opts.requestContext** (`RequestContext`): Forwarded to the \`instructions\` function on the filesystem or sandbox provider, if one is configured.
+**opts.requestContext** (`RequestContext`): Forwarded to the instructions function on the filesystem or sandbox provider, if one is configured.
 
 **Returns:** `string`
 
@@ -284,7 +284,7 @@ const instructions = await workspace.getInstructionsAsync({ requestContext })
 
 **Parameters:**
 
-**opts.requestContext** (`RequestContext`): Passed to the dynamic filesystem resolver, and to the dynamic sandbox resolver when \`instructions.dynamicSandbox\` is \`'resolve'\`.
+**opts.requestContext** (`RequestContext`): Passed to the dynamic filesystem resolver, and to the dynamic sandbox resolver when instructions.dynamicSandbox is 'resolve'.
 
 **Returns:** `Promise<string>`
 
@@ -425,7 +425,7 @@ With a static filesystem, write tools (`write_file`, `edit_file`, `delete`, `mkd
 
 The `read_file` tool accepts `mediaTypes` and `maxMediaBytes` options to control which mime types are surfaced to the model as native media parts and how large those files can be:
 
-**mediaTypes** (`string[] | ((mimeType: string) => boolean) | false`): Which mime types to surface to the model as media parts (file/image parts) rather than as text. Accepts an array of globs (e.g. \`\['image/\*']\`), a custom predicate function, or \`false\` to disable media detection. Defaults to the cross-provider-safe intersection of image formats plus PDF. Only applies when the caller doesn't pass an explicit \`encoding\`. (Default: `['image/png', 'image/jpeg', 'image/webp', 'application/pdf']`)
+**mediaTypes** (`string[] | ((mimeType: string) => boolean) | false`): Which mime types to surface to the model as media parts (file/image parts) rather than as text. Accepts an array of globs (e.g. \['image/\*']), a custom predicate function, or false to disable media detection. Defaults to the cross-provider-safe intersection of image formats plus PDF. Only applies when the caller doesn't pass an explicit encoding. (Default: `['image/png', 'image/jpeg', 'image/webp', 'application/pdf']`)
 
 **maxMediaBytes** (`number`): Maximum file size (in bytes) to inline as a media part. Files larger than this fall back to metadata-only output rather than being fully base64-encoded into context and persisted in storage on rehydration. (Default: `10 * 1024 * 1024 (10 MiB)`)