@mastra/mcp-docs-server 1.1.41-alpha.0 → 1.1.42-alpha.10

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (180) hide show
  1. package/.docs/docs/agent-builder/access-control.md +97 -0
  2. package/.docs/docs/agent-builder/browser.md +61 -0
  3. package/.docs/docs/agent-builder/channels.md +76 -0
  4. package/.docs/docs/agent-builder/configuration.md +147 -0
  5. package/.docs/docs/agent-builder/deploying.md +121 -0
  6. package/.docs/docs/agent-builder/memory.md +65 -0
  7. package/.docs/docs/agent-builder/model-policy.md +48 -0
  8. package/.docs/docs/agent-builder/overview.md +97 -0
  9. package/.docs/docs/agent-builder/skill-registries.md +31 -0
  10. package/.docs/docs/agent-builder/workspace.md +60 -0
  11. package/.docs/docs/agents/a2a.md +1 -1
  12. package/.docs/docs/agents/acp.md +4 -4
  13. package/.docs/docs/agents/adding-voice.md +37 -6
  14. package/.docs/docs/agents/agent-approval.md +15 -1
  15. package/.docs/docs/agents/background-tasks.md +2 -2
  16. package/.docs/docs/agents/channels.md +3 -1
  17. package/.docs/docs/agents/code-mode.md +163 -0
  18. package/.docs/docs/agents/guardrails.md +2 -2
  19. package/.docs/docs/agents/networks.md +1 -1
  20. package/.docs/docs/agents/overview.md +1 -1
  21. package/.docs/docs/agents/processors.md +3 -3
  22. package/.docs/docs/agents/response-caching.md +1 -1
  23. package/.docs/docs/agents/sdk-agents.md +261 -0
  24. package/.docs/docs/agents/signals.md +150 -73
  25. package/.docs/docs/agents/structured-output.md +5 -5
  26. package/.docs/docs/agents/supervisor-agents.md +2 -2
  27. package/.docs/docs/agents/using-tools.md +5 -5
  28. package/.docs/docs/browser/agent-browser.md +1 -1
  29. package/.docs/docs/browser/browser-viewer.md +1 -1
  30. package/.docs/docs/browser/overview.md +1 -1
  31. package/.docs/docs/browser/stagehand.md +5 -5
  32. package/.docs/docs/editor/overview.md +70 -8
  33. package/.docs/docs/evals/custom-scorers.md +1 -1
  34. package/.docs/docs/evals/datasets/running-experiments.md +1 -1
  35. package/.docs/docs/evals/overview.md +2 -2
  36. package/.docs/docs/getting-started/manual-install.md +1 -1
  37. package/.docs/docs/mcp/mcp-apps.md +3 -3
  38. package/.docs/docs/mcp/overview.md +1 -1
  39. package/.docs/docs/memory/memory-processors.md +6 -6
  40. package/.docs/docs/memory/multi-user-threads.md +1 -1
  41. package/.docs/docs/memory/observational-memory.md +19 -0
  42. package/.docs/docs/memory/semantic-recall.md +2 -2
  43. package/.docs/docs/memory/storage.md +2 -1
  44. package/.docs/docs/memory/working-memory.md +1 -1
  45. package/.docs/docs/observability/metrics/overview.md +1 -0
  46. package/.docs/docs/observability/metrics/querying.md +292 -0
  47. package/.docs/docs/observability/tracing/exporters/langfuse.md +1 -1
  48. package/.docs/docs/observability/tracing/exporters/langsmith.md +2 -2
  49. package/.docs/docs/rag/graph-rag.md +2 -2
  50. package/.docs/docs/rag/retrieval.md +12 -12
  51. package/.docs/docs/server/auth/fga.md +4 -0
  52. package/.docs/docs/server/mastra-client.md +1 -1
  53. package/.docs/docs/server/request-context.md +3 -3
  54. package/.docs/docs/streaming/overview.md +1 -1
  55. package/.docs/docs/streaming/tool-streaming.md +1 -1
  56. package/.docs/docs/voice/overview.md +86 -24
  57. package/.docs/docs/voice/speech-to-speech.md +55 -4
  58. package/.docs/docs/voice/speech-to-text.md +1 -1
  59. package/.docs/docs/voice/text-to-speech.md +1 -1
  60. package/.docs/docs/workspace/filesystem.md +2 -2
  61. package/.docs/docs/workspace/overview.md +1 -1
  62. package/.docs/docs/workspace/sandbox.md +5 -3
  63. package/.docs/guides/build-your-ui/ai-sdk-ui.md +1 -1
  64. package/.docs/guides/deployment/inngest.md +69 -0
  65. package/.docs/guides/guide/ai-recruiter.md +1 -1
  66. package/.docs/guides/guide/chef-michel.md +1 -1
  67. package/.docs/guides/guide/code-review-bot.md +1 -1
  68. package/.docs/guides/guide/dev-assistant.md +1 -1
  69. package/.docs/guides/guide/docs-manager.md +1 -1
  70. package/.docs/guides/guide/firecrawl.md +6 -6
  71. package/.docs/guides/guide/github-actions-pr-description.md +1 -1
  72. package/.docs/guides/guide/research-assistant.md +1 -1
  73. package/.docs/guides/guide/research-coordinator.md +2 -2
  74. package/.docs/guides/guide/slack-assistant.md +1 -1
  75. package/.docs/guides/guide/stock-agent.md +2 -2
  76. package/.docs/guides/guide/whatsapp-chat-bot.md +2 -2
  77. package/.docs/guides/migrations/agentnetwork.md +4 -4
  78. package/.docs/guides/migrations/upgrade-to-v1/agent.md +1 -1
  79. package/.docs/guides/migrations/vnext-to-standard-apis.md +2 -2
  80. package/.docs/models/embeddings.md +2 -2
  81. package/.docs/reference/agents/agent.md +60 -21
  82. package/.docs/reference/agents/channels.md +48 -6
  83. package/.docs/reference/agents/generateLegacy.md +1 -1
  84. package/.docs/reference/agents/getLLM.md +2 -2
  85. package/.docs/reference/agents/getMetadata.md +2 -2
  86. package/.docs/reference/agents/network.md +1 -1
  87. package/.docs/reference/browser/agent-browser.md +1 -1
  88. package/.docs/reference/browser/browser-viewer.md +1 -1
  89. package/.docs/reference/browser/mastra-browser.md +1 -1
  90. package/.docs/reference/browser/stagehand-browser.md +5 -5
  91. package/.docs/reference/client-js/agent-builder.md +161 -0
  92. package/.docs/reference/client-js/agents.md +19 -2
  93. package/.docs/reference/client-js/mastra-client.md +4 -0
  94. package/.docs/reference/configuration.md +1 -1
  95. package/.docs/reference/editor/agent-builder/agent-builder-options.md +74 -0
  96. package/.docs/reference/editor/agent-builder/builder-agent-defaults.md +77 -0
  97. package/.docs/reference/editor/agent-builder/builder-models.md +64 -0
  98. package/.docs/reference/editor/blob-store-provider.md +59 -0
  99. package/.docs/reference/editor/browser-provider.md +75 -0
  100. package/.docs/reference/editor/filesystem-provider.md +62 -0
  101. package/.docs/reference/editor/mastra-editor.md +61 -1
  102. package/.docs/reference/editor/processor-provider.md +64 -0
  103. package/.docs/reference/editor/sandbox-provider.md +61 -0
  104. package/.docs/reference/editor/storage-browser-ref.md +80 -0
  105. package/.docs/reference/editor/storage-workspace-ref.md +93 -0
  106. package/.docs/reference/evals/answer-relevancy.md +1 -1
  107. package/.docs/reference/evals/answer-similarity.md +1 -1
  108. package/.docs/reference/evals/bias.md +1 -1
  109. package/.docs/reference/evals/context-precision.md +3 -3
  110. package/.docs/reference/evals/context-relevance.md +11 -11
  111. package/.docs/reference/evals/create-scorer.md +2 -0
  112. package/.docs/reference/evals/faithfulness.md +1 -1
  113. package/.docs/reference/evals/hallucination.md +5 -5
  114. package/.docs/reference/evals/noise-sensitivity.md +11 -11
  115. package/.docs/reference/evals/prompt-alignment.md +15 -15
  116. package/.docs/reference/evals/tool-call-accuracy.md +3 -3
  117. package/.docs/reference/evals/toxicity.md +1 -1
  118. package/.docs/reference/index.md +15 -0
  119. package/.docs/reference/memory/memory-class.md +3 -3
  120. package/.docs/reference/memory/observational-memory.md +6 -4
  121. package/.docs/reference/memory/serialized-memory-config.md +72 -0
  122. package/.docs/reference/observability/metrics/automatic-metrics.md +7 -1
  123. package/.docs/reference/observability/tracing/exporters/langfuse.md +1 -1
  124. package/.docs/reference/processors/batch-parts-processor.md +1 -1
  125. package/.docs/reference/processors/cost-guard-processor.md +1 -1
  126. package/.docs/reference/processors/language-detector.md +1 -1
  127. package/.docs/reference/processors/message-history-processor.md +1 -1
  128. package/.docs/reference/processors/moderation-processor.md +2 -2
  129. package/.docs/reference/processors/pii-detector.md +2 -2
  130. package/.docs/reference/processors/prefill-error-handler.md +2 -2
  131. package/.docs/reference/processors/processor-interface.md +2 -2
  132. package/.docs/reference/processors/prompt-injection-detector.md +1 -1
  133. package/.docs/reference/processors/regex-filter-processor.md +1 -1
  134. package/.docs/reference/processors/semantic-recall-processor.md +1 -1
  135. package/.docs/reference/processors/skill-search-processor.md +1 -1
  136. package/.docs/reference/processors/system-prompt-scrubber.md +1 -1
  137. package/.docs/reference/processors/token-limiter-processor.md +3 -3
  138. package/.docs/reference/processors/tool-call-filter.md +2 -2
  139. package/.docs/reference/processors/tool-search-processor.md +33 -2
  140. package/.docs/reference/processors/unicode-normalizer.md +1 -1
  141. package/.docs/reference/processors/working-memory-processor.md +1 -1
  142. package/.docs/reference/rag/rerank.md +1 -1
  143. package/.docs/reference/server/nestjs-adapter.md +1 -1
  144. package/.docs/reference/server/routes.md +108 -9
  145. package/.docs/reference/storage/dsql.md +1 -1
  146. package/.docs/reference/storage/mongodb.md +1 -1
  147. package/.docs/reference/storage/postgresql.md +1 -1
  148. package/.docs/reference/storage/redis.md +1 -1
  149. package/.docs/reference/storage/spanner.md +5 -0
  150. package/.docs/reference/storage/upstash.md +1 -1
  151. package/.docs/reference/streaming/agents/stream.md +1 -1
  152. package/.docs/reference/templates/overview.md +3 -3
  153. package/.docs/reference/tools/mcp-client.md +53 -2
  154. package/.docs/reference/tools/mcp-server.md +33 -1
  155. package/.docs/reference/tools/vector-query-tool.md +1 -1
  156. package/.docs/reference/vectors/libsql.md +1 -1
  157. package/.docs/reference/vectors/mongodb.md +1 -1
  158. package/.docs/reference/vectors/pg.md +3 -1
  159. package/.docs/reference/vectors/upstash.md +1 -1
  160. package/.docs/reference/voice/google-gemini-live.md +15 -2
  161. package/.docs/reference/voice/inworld-realtime.md +353 -0
  162. package/.docs/reference/voice/inworld.md +2 -0
  163. package/.docs/reference/voice/voice.addInstructions.md +1 -1
  164. package/.docs/reference/workspace/agentcore-runtime-sandbox.md +202 -0
  165. package/.docs/reference/workspace/agentfs-filesystem.md +1 -1
  166. package/.docs/reference/workspace/azure-blob-filesystem.md +1 -1
  167. package/.docs/reference/workspace/blaxel-sandbox.md +3 -0
  168. package/.docs/reference/workspace/docker-sandbox.md +4 -2
  169. package/.docs/reference/workspace/e2b-sandbox.md +9 -5
  170. package/.docs/reference/workspace/files-sdk-filesystem.md +1 -1
  171. package/.docs/reference/workspace/gcs-filesystem.md +1 -1
  172. package/.docs/reference/workspace/google-drive-filesystem.md +1 -1
  173. package/.docs/reference/workspace/local-filesystem.md +1 -1
  174. package/.docs/reference/workspace/local-sandbox.md +1 -1
  175. package/.docs/reference/workspace/modal-sandbox.md +1 -1
  176. package/.docs/reference/workspace/s3-filesystem.md +1 -1
  177. package/.docs/reference/workspace/vercel-microvm-sandbox.md +199 -0
  178. package/.docs/reference/workspace/vercel.md +2 -0
  179. package/CHANGELOG.md +72 -0
  180. package/package.json +9 -7
@@ -48,7 +48,7 @@ const workspace = new Workspace({
48
48
 
49
49
  const agent = new Agent({
50
50
  name: 'dev-agent',
51
- model: 'anthropic/claude-opus-4-6',
51
+ model: 'anthropic/claude-opus-4-7',
52
52
  workspace,
53
53
  })
54
54
  ```
@@ -71,6 +71,10 @@ const agent = new Agent({
71
71
 
72
72
  **accessToken** (`string`): Access token for authentication. Falls back to E2B\_ACCESS\_TOKEN env var.
73
73
 
74
+ **metadata** (`Record<string, unknown>`): Custom metadata attached to the sandbox instance.
75
+
76
+ **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.
77
+
74
78
  ## Properties
75
79
 
76
80
  **id** (`string`): Sandbox instance identifier
@@ -79,9 +83,7 @@ const agent = new Agent({
79
83
 
80
84
  **provider** (`string`): Provider identifier ('e2b')
81
85
 
82
- **status** (`ProviderStatus`): 'pending' | 'initializing' | 'ready' | 'error'
83
-
84
- **supportsMounting** (`boolean`): Always true - E2B sandboxes support mounting cloud filesystems
86
+ **status** (`ProviderStatus`): 'pending' | 'initializing' | 'ready' | 'starting' | 'running' | 'stopping' | 'stopped' | 'destroying' | 'destroyed' | 'error'
85
87
 
86
88
  **processes** (`E2BProcessManager`): Background process manager. See \[SandboxProcessManager reference]\(/reference/workspace/process-manager).
87
89
 
@@ -118,7 +120,7 @@ See [`SandboxProcessManager` reference](https://mastra.ai/reference/workspace/pr
118
120
 
119
121
  ## Mounting cloud storage
120
122
 
121
- E2B sandboxes can mount S3 or GCS filesystems, making cloud storage accessible as local directories inside the sandbox. This is useful for:
123
+ E2B sandboxes can mount S3, GCS, and Azure Blob filesystems, making cloud storage accessible as local directories inside the sandbox. This is useful for:
122
124
 
123
125
  - Processing large datasets stored in cloud buckets
124
126
  - Writing output files directly to cloud storage
@@ -160,6 +162,7 @@ E2B sandboxes use FUSE (Filesystem in Userspace) to mount cloud storage:
160
162
 
161
163
  - **S3/R2**: Mounted via [s3fs-fuse](https://github.com/s3fs-fuse/s3fs-fuse)
162
164
  - **GCS**: Mounted via [gcsfuse](https://github.com/GoogleCloudPlatform/gcsfuse)
165
+ - **Azure Blob**: Mounted via [blobfuse2](https://github.com/Azure/azure-storage-fuse)
163
166
 
164
167
  The E2B sandbox automatically installs the required FUSE tools when mounting is used. For best performance, pre-build a custom template with the tools installed.
165
168
 
@@ -250,4 +253,5 @@ This is optional—`gcsfuse` is installed automatically at mount time if not pre
250
253
  - [LocalSandbox reference](https://mastra.ai/reference/workspace/local-sandbox)
251
254
  - [S3Filesystem reference](https://mastra.ai/reference/workspace/s3-filesystem)
252
255
  - [GCSFilesystem reference](https://mastra.ai/reference/workspace/gcs-filesystem)
256
+ - [Azure Blob Filesystem reference](https://mastra.ai/reference/workspace/azure-blob-filesystem)
253
257
  - [Workspace overview](https://mastra.ai/docs/workspace/overview)
@@ -58,7 +58,7 @@ const workspace = new Workspace({
58
58
 
59
59
  const agent = new Agent({
60
60
  name: 'file-agent',
61
- model: 'anthropic/claude-opus-4-6',
61
+ model: 'anthropic/claude-opus-4-7',
62
62
  workspace,
63
63
  })
64
64
  ```
@@ -49,7 +49,7 @@ const workspace = new Workspace({
49
49
 
50
50
  const agent = new Agent({
51
51
  name: 'file-agent',
52
- model: 'anthropic/claude-opus-4-6',
52
+ model: 'anthropic/claude-opus-4-7',
53
53
  workspace,
54
54
  })
55
55
  ```
@@ -49,7 +49,7 @@ const workspace = new Workspace({
49
49
  const agent = new Agent({
50
50
  id: 'drive-agent',
51
51
  name: 'Drive Agent',
52
- model: '__OPENAI_MODEL_MINI__',
52
+ model: 'openai/gpt-5-mini',
53
53
  workspace,
54
54
  })
55
55
  ```
@@ -22,7 +22,7 @@ const workspace = new Workspace({
22
22
 
23
23
  const agent = new Agent({
24
24
  id: 'file-agent',
25
- model: 'openai/gpt-5.4',
25
+ model: 'openai/gpt-5.5',
26
26
  workspace,
27
27
  })
28
28
 
@@ -26,7 +26,7 @@ const workspace = new Workspace({
26
26
 
27
27
  const agent = new Agent({
28
28
  id: 'dev-agent',
29
- model: 'openai/gpt-5.4',
29
+ model: 'openai/gpt-5.5',
30
30
  workspace,
31
31
  })
32
32
 
@@ -49,7 +49,7 @@ const workspace = new Workspace({
49
49
 
50
50
  const agent = new Agent({
51
51
  id: 'dev-agent',
52
- model: 'anthropic/claude-opus-4-6',
52
+ model: 'anthropic/claude-opus-4-7',
53
53
  workspace,
54
54
  })
55
55
  ```
@@ -50,7 +50,7 @@ const workspace = new Workspace({
50
50
 
51
51
  const agent = new Agent({
52
52
  name: 'file-agent',
53
- model: 'anthropic/claude-opus-4-6',
53
+ model: 'anthropic/claude-opus-4-7',
54
54
  workspace,
55
55
  })
56
56
  ```
@@ -0,0 +1,199 @@
1
+ # VercelMicroVMSandbox
2
+
3
+ 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.
4
+
5
+ > **Info:** For interface details, see the [WorkspaceSandbox interface](https://mastra.ai/reference/workspace/sandbox).
6
+
7
+ > **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.
8
+
9
+ ## Installation
10
+
11
+ **npm**:
12
+
13
+ ```bash
14
+ npm install @mastra/vercel
15
+ ```
16
+
17
+ **pnpm**:
18
+
19
+ ```bash
20
+ pnpm add @mastra/vercel
21
+ ```
22
+
23
+ **Yarn**:
24
+
25
+ ```bash
26
+ yarn add @mastra/vercel
27
+ ```
28
+
29
+ **Bun**:
30
+
31
+ ```bash
32
+ bun add @mastra/vercel
33
+ ```
34
+
35
+ ## Authentication
36
+
37
+ The `@vercel/sandbox` SDK uses a Vercel OIDC token automatically when available.
38
+
39
+ **OIDC (recommended)**:
40
+
41
+ For local development, link the project and pull a development token:
42
+
43
+ ```bash
44
+ vercel link
45
+ vercel env pull
46
+ ```
47
+
48
+ On Vercel, authentication is handled automatically — no configuration needed.
49
+
50
+ **Access token (.env)**:
51
+
52
+ For environments without OIDC, provide all three values together:
53
+
54
+ ```bash
55
+ VERCEL_TOKEN=your-token
56
+ VERCEL_TEAM_ID=your-team-id
57
+ VERCEL_PROJECT_ID=your-project-id
58
+ ```
59
+
60
+ **Constructor**:
61
+
62
+ ```typescript
63
+ new VercelMicroVMSandbox({
64
+ token: 'your-token',
65
+ teamId: 'your-team-id',
66
+ projectId: 'your-project-id',
67
+ })
68
+ ```
69
+
70
+ ## Usage
71
+
72
+ Add a `VercelMicroVMSandbox` to a workspace and assign it to an agent:
73
+
74
+ ```typescript
75
+ import { Agent } from '@mastra/core/agent'
76
+ import { Workspace } from '@mastra/core/workspace'
77
+ import { VercelMicroVMSandbox } from '@mastra/vercel'
78
+
79
+ const workspace = new Workspace({
80
+ sandbox: new VercelMicroVMSandbox({
81
+ runtime: 'node24',
82
+ timeout: 600_000,
83
+ }),
84
+ })
85
+
86
+ const agent = new Agent({
87
+ id: 'code-agent',
88
+ name: 'Code Agent',
89
+ instructions: 'You are a coding assistant working in this workspace.',
90
+ model: 'anthropic/claude-sonnet-4-6',
91
+ workspace,
92
+ })
93
+
94
+ const response = await agent.generate('Print "Hello, world!" and show the Node.js version.')
95
+
96
+ console.log(response.text)
97
+ ```
98
+
99
+ ### Resources and exposed ports
100
+
101
+ Allocate vCPUs (2048 MB of memory per vCPU) and expose ports to reach network services running inside the sandbox:
102
+
103
+ ```typescript
104
+ const sandbox = new VercelMicroVMSandbox({
105
+ runtime: 'node24',
106
+ resources: { vcpus: 4 },
107
+ ports: [3000],
108
+ })
109
+
110
+ const workspace = new Workspace({ sandbox })
111
+ await sandbox._start()
112
+
113
+ // The public HTTPS domain for an exposed port is available via getInfo()
114
+ const { metadata } = sandbox.getInfo()
115
+ console.log(metadata?.domains) // { 3000: 'https://....vercel.run' }
116
+ ```
117
+
118
+ ### Streaming output
119
+
120
+ Stream command output in real time via `onStdout` and `onStderr` callbacks:
121
+
122
+ ```typescript
123
+ await sandbox.executeCommand('sh', ['-c', 'for i in 1 2 3; do echo "line $i"; sleep 1; done'], {
124
+ onStdout: chunk => process.stdout.write(chunk),
125
+ onStderr: chunk => process.stderr.write(chunk),
126
+ })
127
+ ```
128
+
129
+ Both callbacks are optional and can be used independently.
130
+
131
+ ## Constructor parameters
132
+
133
+ **id** (`string`): Unique identifier for this sandbox instance. (Default: `Auto-generated`)
134
+
135
+ **sandboxName** (`string`): Optional name passed to the Vercel API. Auto-generated if omitted.
136
+
137
+ **token** (`string`): Vercel API token. Falls back to the VERCEL\_TOKEN environment variable. Omit to use the OIDC token.
138
+
139
+ **teamId** (`string`): Vercel team ID. Falls back to the VERCEL\_TEAM\_ID environment variable.
140
+
141
+ **projectId** (`string`): Vercel project ID. Falls back to the VERCEL\_PROJECT\_ID environment variable.
142
+
143
+ **runtime** (`'node24' | 'node22' | 'node26' | 'python3.13'`): Sandbox runtime. (Default: `'node24'`)
144
+
145
+ **timeout** (`number`): Timeout in milliseconds before the sandbox auto-terminates. (Default: `300000 (5 minutes)`)
146
+
147
+ **resources** (`{ vcpus?: number }`): Resource allocation. Each vCPU comes with 2048 MB of memory.
148
+
149
+ **ports** (`number[]`): Ports to expose from the sandbox (up to 4). Public HTTPS domains are available via getInfo().metadata.domains.
150
+
151
+ **env** (`Record<string, string>`): Default environment variables inherited by all commands. (Default: `{}`)
152
+
153
+ **metadata** (`Record<string, unknown>`): Custom metadata surfaced via getInfo(). (Default: `{}`)
154
+
155
+ **instructions** (`string | ((opts) => string)`): Override the default instructions returned by getInstructions(). Pass a string to replace them, or a function to extend the defaults.
156
+
157
+ ## Properties
158
+
159
+ **id** (`string`): Sandbox instance identifier.
160
+
161
+ **name** (`string`): Provider name ('VercelMicroVMSandbox').
162
+
163
+ **provider** (`string`): Provider identifier ('vercel-microvm').
164
+
165
+ **status** (`ProviderStatus`): 'pending' | 'starting' | 'running' | 'stopping' | 'stopped' | 'destroying' | 'destroyed' | 'error'
166
+
167
+ **sandbox** (`Sandbox`): The underlying @vercel/sandbox Sandbox instance. Throws SandboxNotReadyError if the sandbox has not been started.
168
+
169
+ **processes** (`VercelMicroVMProcessManager`): Background process manager. See \[SandboxProcessManager reference]\(/reference/workspace/process-manager).
170
+
171
+ ## Background processes
172
+
173
+ `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.
174
+
175
+ ```typescript
176
+ const sandbox = new VercelMicroVMSandbox({ runtime: 'node24', ports: [3000] })
177
+ await sandbox.start()
178
+
179
+ const handle = await sandbox.processes.spawn('node server.js', {
180
+ env: { PORT: '3000' },
181
+ onStdout: data => console.log(data),
182
+ })
183
+
184
+ console.log(handle.stdout)
185
+ await handle.kill()
186
+ ```
187
+
188
+ See the [`SandboxProcessManager` reference](https://mastra.ai/reference/workspace/process-manager) for the full API.
189
+
190
+ > **Note:** The Vercel Sandbox SDK does not expose a stdin channel for running commands, so `handle.sendStdin()` throws. Filesystem mounting (FUSE) is also not supported by this provider.
191
+
192
+ ## Limits
193
+
194
+ - Up to 8 vCPUs, with 2048 MB of memory per vCPU.
195
+ - Up to 4 exposed ports.
196
+ - The filesystem is ephemeral — persisted only within the session and lost when the sandbox stops.
197
+ - Maximum runtime is plan-dependent (45 minutes on Hobby, up to 5 hours on Pro/Enterprise), with a default of 5 minutes.
198
+
199
+ See the [Vercel Sandbox documentation](https://vercel.com/docs/vercel-sandbox) for current limits and pricing.
@@ -6,6 +6,8 @@ Executes commands as [Vercel](https://vercel.com) serverless functions. Provides
6
6
 
7
7
  > **Warning:** VercelSandbox is stateless. There is no persistent filesystem, no interactive shell, and no support for long-running or background processes. Only `/tmp` is writable and is ephemeral between invocations.
8
8
 
9
+ > **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.
10
+
9
11
  ## Installation
10
12
 
11
13
  **npm**:
package/CHANGELOG.md CHANGED
@@ -1,5 +1,77 @@
1
1
  # @mastra/mcp-docs-server
2
2
 
3
+ ## 1.1.42-alpha.10
4
+
5
+ ### Patch Changes
6
+
7
+ - Updated dependencies [[`0c1ed1d`](https://github.com/mastra-ai/mastra/commit/0c1ed1d00c7d87b5ac99ca95896211a2fa9189fa), [`849efb9`](https://github.com/mastra-ai/mastra/commit/849efb9fca6dc976589c1f90a303fea618769109)]:
8
+ - @mastra/core@1.38.0-alpha.8
9
+ - @mastra/mcp@1.9.0-alpha.1
10
+
11
+ ## 1.1.42-alpha.9
12
+
13
+ ### Patch Changes
14
+
15
+ - Updated dependencies:
16
+ - @mastra/core@1.38.0-alpha.7
17
+
18
+ ## 1.1.42-alpha.8
19
+
20
+ ### Patch Changes
21
+
22
+ - Updated dependencies [[`19a8658`](https://github.com/mastra-ai/mastra/commit/19a86589c788ef48bb6c1b0612cc82a201857379), [`a659a77`](https://github.com/mastra-ai/mastra/commit/a659a779bdebe3a52a518c56d2260592d0240fe0), [`3332be9`](https://github.com/mastra-ai/mastra/commit/3332be9701ecd77aba840959d9a1d1ce7aef02d3)]:
23
+ - @mastra/core@1.38.0-alpha.6
24
+
25
+ ## 1.1.42-alpha.7
26
+
27
+ ### Patch Changes
28
+
29
+ - Updated dependencies [[`a18775a`](https://github.com/mastra-ai/mastra/commit/a18775a693172546ee2378d39b67d4e32895b251), [`1baf2d1`](https://github.com/mastra-ai/mastra/commit/1baf2d152c6881338ff8f114633d5316fe13dd15)]:
30
+ - @mastra/core@1.38.0-alpha.5
31
+
32
+ ## 1.1.42-alpha.6
33
+
34
+ ### Patch Changes
35
+
36
+ - Updated dependencies [[`50ed00c`](https://github.com/mastra-ai/mastra/commit/50ed00caa914a85969b33de83f26b48e328ef641), [`9283971`](https://github.com/mastra-ai/mastra/commit/928397157009b4aef4d5fdf3a0a273cb371beb55), [`0bf2d93`](https://github.com/mastra-ai/mastra/commit/0bf2d932d20e2936f2d9abb8c0a86e24fbc97ec6), [`94dfef6`](https://github.com/mastra-ai/mastra/commit/94dfef6e2bf19a88467ea3940afcbce88a433f0f), [`a122f79`](https://github.com/mastra-ai/mastra/commit/a122f79427ae225ec79c7b2ed46278da48d04b17), [`4c02027`](https://github.com/mastra-ai/mastra/commit/4c020277235eaa6b1dc957c90ad0639eef213992), [`6855012`](https://github.com/mastra-ai/mastra/commit/685501247cc4717506f3e89beed03509d63a5370), [`7fef31c`](https://github.com/mastra-ai/mastra/commit/7fef31c0d2a6d362a43a647a8a4f6ab893758a23), [`7fef31c`](https://github.com/mastra-ai/mastra/commit/7fef31c0d2a6d362a43a647a8a4f6ab893758a23)]:
37
+ - @mastra/core@1.38.0-alpha.4
38
+
39
+ ## 1.1.42-alpha.5
40
+
41
+ ### Patch Changes
42
+
43
+ - Updated dependencies [[`8ace89d`](https://github.com/mastra-ai/mastra/commit/8ace89df77f762e622d3b9f7f65ad7524350d050), [`fa63872`](https://github.com/mastra-ai/mastra/commit/fa6387280954e6b667bec5714b55ba082bc627ff), [`f07b646`](https://github.com/mastra-ai/mastra/commit/f07b64604ab7d25391179790b7fd4823df9e2dff), [`d8838ae`](https://github.com/mastra-ai/mastra/commit/d8838ae80b69780361693d27098f7f6684af12fe), [`40f9297`](https://github.com/mastra-ai/mastra/commit/40f9297003b921c62373d3e8d3a4bda76c9f6de3), [`0f0d1ba`](https://github.com/mastra-ai/mastra/commit/0f0d1ba67bfcb2204e571401662f1eceefc03357), [`8c31bcd`](https://github.com/mastra-ai/mastra/commit/8c31bcdb00e597880d5939b1b7d7566fbe5dacae), [`95b14cd`](https://github.com/mastra-ai/mastra/commit/95b14cdd820e86d97ac05fe568424c513a252e31), [`0e51c36`](https://github.com/mastra-ai/mastra/commit/0e51c362be673502ac79626a75d1416479b0b76e), [`aa36be2`](https://github.com/mastra-ai/mastra/commit/aa36be23aa513b7dc53cb8ca16b7fab8f20e43ad), [`212c635`](https://github.com/mastra-ai/mastra/commit/212c635203e61d036ab41db8ff86c3893dc795b3), [`d8838ae`](https://github.com/mastra-ai/mastra/commit/d8838ae80b69780361693d27098f7f6684af12fe), [`9aa5a73`](https://github.com/mastra-ai/mastra/commit/9aa5a73e7e110f6e9365eec69364a33d5f03bb56), [`f73c789`](https://github.com/mastra-ai/mastra/commit/f73c789e8ef21561580395d2c410119cab5848c8), [`8bd16da`](https://github.com/mastra-ai/mastra/commit/8bd16da73a4cb874d739373643dbd6a6e7f88684), [`c8630f8`](https://github.com/mastra-ai/mastra/commit/c8630f80d4f40cb5d22e60ab162b618b1907167a), [`47f71dc`](https://github.com/mastra-ai/mastra/commit/47f71dc6fbcbd12d71e21a979e676e20a02bd77d), [`50ceae2`](https://github.com/mastra-ai/mastra/commit/50ceae270878e2f8fb2b2c6c2faab09df0007c8a), [`8cdde58`](https://github.com/mastra-ai/mastra/commit/8cdde5875bbba6702d9df226f2b20232b8d75d6c), [`847ff1e`](https://github.com/mastra-ai/mastra/commit/847ff1e0d94368d94b2e173e4e0908e115568ef3), [`259d409`](https://github.com/mastra-ai/mastra/commit/259d409a514174299dbde1ff5e1121209b3ba850), [`9e16c68`](https://github.com/mastra-ai/mastra/commit/9e16c6818b6485ccb43df28aba6f3a2219d28662), [`cefca33`](https://github.com/mastra-ai/mastra/commit/cefca33ae666e69810c935fedf95a929c173d1d7), [`d00e8c5`](https://github.com/mastra-ai/mastra/commit/d00e8c50daebe5bce5bf2f48bde39c86fc3d2fe4), [`36fa7e2`](https://github.com/mastra-ai/mastra/commit/36fa7e24d14e58a1eb46147097b32f583e5b8775), [`87e9774`](https://github.com/mastra-ai/mastra/commit/87e97741c1e493cd6d62f478eb810b49bda4d57c), [`65a72e7`](https://github.com/mastra-ai/mastra/commit/65a72e70c25eedea8ff985a6624b96be2850236b), [`0f77241`](https://github.com/mastra-ai/mastra/commit/0f7724108806703799a8ba80ad0f09414afd5066), [`92ff509`](https://github.com/mastra-ai/mastra/commit/92ff5098ef8a990438ca038077021a5f7541ec1d), [`3fce5e7`](https://github.com/mastra-ai/mastra/commit/3fce5e70d011d289043e75003ef3336ed4aa43c3), [`a763592`](https://github.com/mastra-ai/mastra/commit/a763592c3db46963ef1011cfe16fe372816e775e), [`80c7737`](https://github.com/mastra-ai/mastra/commit/80c7737e32d7917b5f356957d67c169d01744fd3), [`3f1cf47`](https://github.com/mastra-ai/mastra/commit/3f1cf476f74c1e4cc2df908837e05853a5347e31)]:
44
+ - @mastra/core@1.38.0-alpha.3
45
+ - @mastra/mcp@1.9.0-alpha.0
46
+
47
+ ## 1.1.42-alpha.3
48
+
49
+ ### Patch Changes
50
+
51
+ - Updated dependencies [[`d779de3`](https://github.com/mastra-ai/mastra/commit/d779de3cd9d2e7ed8110547190e2f15e786a0e41), [`1750c97`](https://github.com/mastra-ai/mastra/commit/1750c975d6179fbf6db2813b15229d4f8f23fc55), [`0e32507`](https://github.com/mastra-ai/mastra/commit/0e32507962cdfa5569b7bda5bc6fb3dd34e40b03), [`3a081c1`](https://github.com/mastra-ai/mastra/commit/3a081c1255c5ae8c99f6dad91cc612934ef6f2bd), [`fe9eacd`](https://github.com/mastra-ai/mastra/commit/fe9eacd9545a0a9d64aad31c9fa90294a425289e), [`db79c86`](https://github.com/mastra-ai/mastra/commit/db79c86c60723d57e02f9636ca2611bd4515f194)]:
52
+ - @mastra/core@1.38.0-alpha.2
53
+
54
+ ## 1.1.42-alpha.2
55
+
56
+ ### Patch Changes
57
+
58
+ - Updated dependencies [[`49f8abc`](https://github.com/mastra-ai/mastra/commit/49f8abce8258e4f2f87bd326acfbdb641264a47c)]:
59
+ - @mastra/core@1.37.2-alpha.1
60
+
61
+ ## 1.1.42-alpha.0
62
+
63
+ ### Patch Changes
64
+
65
+ - Updated dependencies [[`07c3de7`](https://github.com/mastra-ai/mastra/commit/07c3de7f7bc418beccaea3b5e6b7f7cdda79d492)]:
66
+ - @mastra/core@1.37.2-alpha.0
67
+
68
+ ## 1.1.41
69
+
70
+ ### Patch Changes
71
+
72
+ - Updated dependencies [[`21db1a4`](https://github.com/mastra-ai/mastra/commit/21db1a4b8ac058d5a4fbe38b516cc1b81e526915)]:
73
+ - @mastra/core@1.37.1
74
+
3
75
  ## 1.1.40
4
76
 
5
77
  ### Patch Changes
package/package.json CHANGED
@@ -1,11 +1,10 @@
1
1
  {
2
2
  "name": "@mastra/mcp-docs-server",
3
- "version": "1.1.41-alpha.0",
3
+ "version": "1.1.42-alpha.10",
4
4
  "description": "MCP server for accessing Mastra.ai documentation, changelogs, and news.",
5
5
  "type": "module",
6
6
  "main": "dist/index.js",
7
7
  "types": "dist/index.d.ts",
8
- "bin": "dist/stdio.js",
9
8
  "files": [
10
9
  "dist",
11
10
  ".docs",
@@ -29,8 +28,8 @@
29
28
  "jsdom": "^26.1.0",
30
29
  "local-pkg": "^1.1.2",
31
30
  "zod": "^4.4.3",
32
- "@mastra/core": "1.37.0",
33
- "@mastra/mcp": "^1.8.1"
31
+ "@mastra/core": "1.38.0-alpha.8",
32
+ "@mastra/mcp": "^1.9.0-alpha.1"
34
33
  },
35
34
  "devDependencies": {
36
35
  "@hono/node-server": "^1.19.11",
@@ -46,9 +45,9 @@
46
45
  "tsx": "^4.21.0",
47
46
  "typescript": "^6.0.3",
48
47
  "vitest": "4.1.5",
49
- "@internal/lint": "0.0.98",
50
- "@internal/types-builder": "0.0.73",
51
- "@mastra/core": "1.37.0"
48
+ "@internal/lint": "0.0.99",
49
+ "@internal/types-builder": "0.0.74",
50
+ "@mastra/core": "1.38.0-alpha.8"
52
51
  },
53
52
  "homepage": "https://mastra.ai",
54
53
  "repository": {
@@ -68,5 +67,8 @@
68
67
  "pretest": "pnpm turbo build --filter @mastra/mcp-docs-server",
69
68
  "test": "vitest run",
70
69
  "lint": "eslint ."
70
+ },
71
+ "bin": {
72
+ "mcp-docs-server": "dist/stdio.js"
71
73
  }
72
74
  }