@mastra/mcp-docs-server 1.2.4 → 1.2.5-alpha.3

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)`)
 

package/CHANGELOG.md

@@ -1,5 +1,20 @@
 # @mastra/mcp-docs-server
 
+## 1.2.5-alpha.2
+
+### Patch Changes
+
+- Updated dependencies [[`3ffb8b7`](https://github.com/mastra-ai/mastra/commit/3ffb8b720e90f5e6977129ec1f6707d43c2bebe0), [`5ea76a7`](https://github.com/mastra-ai/mastra/commit/5ea76a723d966c72da9aa3ab30ae20276e049765), [`6445560`](https://github.com/mastra-ai/mastra/commit/6445560327045d20b239585fc63fed72e9ce36ec), [`911281c`](https://github.com/mastra-ai/mastra/commit/911281c57893ba2630428bf88d0cd0c5101ce76f), [`a2ba369`](https://github.com/mastra-ai/mastra/commit/a2ba369e796dfab610f41c6875965b488272fa55), [`ae51e81`](https://github.com/mastra-ai/mastra/commit/ae51e818825582d42500338dfc1929a082eff0ba), [`6f304ef`](https://github.com/mastra-ai/mastra/commit/6f304ef319e99725e884bdb8d3193c001b6e5964)]:
+  - @mastra/core@1.50.0-alpha.1
+  - @mastra/mcp@1.13.1-alpha.0
+
+## 1.2.5-alpha.0
+
+### Patch Changes
+
+- Updated dependencies [[`6ef59fe`](https://github.com/mastra-ai/mastra/commit/6ef59fef1da52ed8da5fbb2a892c71cf4fb6c739), [`e2b9f33`](https://github.com/mastra-ai/mastra/commit/e2b9f33456fd638eca555f9466c6519d8d049666)]:
+  - @mastra/core@1.50.0-alpha.0
+
 ## 1.2.4
 
 ### Patch Changes

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mastra/mcp-docs-server",
-  "version": "1.2.4",
+  "version": "1.2.5-alpha.3",
   "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.49.0",
-    "@mastra/mcp": "^1.13.0"
+    "@mastra/core": "1.50.0-alpha.1",
+    "@mastra/mcp": "^1.13.1-alpha.0"
   },
   "devDependencies": {
     "@hono/node-server": "^1.19.11",
@@ -45,9 +45,9 @@
     "tsx": "^4.22.4",
     "typescript": "^6.0.3",
     "vitest": "4.1.8",
-    "@internal/lint": "0.0.111",
     "@internal/types-builder": "0.0.86",
-    "@mastra/core": "1.49.0"
+    "@internal/lint": "0.0.111",
+    "@mastra/core": "1.50.0-alpha.1"
   },
   "homepage": "https://mastra.ai",
   "repository": {