@mastra/mcp-docs-server 1.2.12-alpha.0 → 1.2.12-alpha.3

package/.docs/reference/tools/create-code-mode.md

@@ -45,7 +45,7 @@ export const shopAgent = new Agent({
   id: 'shop-assistant',
   name: 'shop-assistant',
   instructions: ['You are a helpful shopping assistant.', instructions],
-  model: 'openai/gpt-5.5',
+  model: 'openai/gpt-5.6-sol',
   tools: { execute_typescript: tool },
 })
 ```
@@ -56,13 +56,13 @@ export const shopAgent = new Agent({
 
 **config.tools** (`ToolsInput`): Tools exposed to the generated code as external\_\<id> functions. Only these tools can be called.
 
-**config.sandbox** (`WorkspaceSandbox`): Sandbox used to execute the generated code. Required unless the agent runs in a workspace that provides a sandbox. Pass new LocalSandbox() to run on the host explicitly.
+**config.sandbox** (`WorkspaceSandbox`): Sandbox used to execute the generated code. Required unless the agent runs in a workspace that provides a sandbox, or the transport provides its own execution boundary (such as IsolatedVmCodeModeTransport). Pass new LocalSandbox() to run on the host explicitly.
 
 **config.timeout** (`number`): Execution timeout in milliseconds.
 
 **config.id** (`string`): The generated tool id.
 
-**transport** (`CodeModeTransport`): Optional transport implementation used to run the generated code in the sandbox. The default transport uses stdio JSON-RPC over the workspace sandbox process API.
+**transport** (`CodeModeTransport`): Optional transport implementation used to run the generated code in the sandbox. The default transport uses stdio JSON-RPC over the workspace sandbox process API. Transports that declare requiresSandbox: false (such as IsolatedVmCodeModeTransport) run without a sandbox.
 
 ## Returns
 

package/.docs/reference/tools/isolated-vm-transport.md

@@ -0,0 +1,74 @@
+> Discover all available pages from the documentation index: https://mastra.ai/llms.txt
+
+# IsolatedVmCodeModeTransport
+
+> **Beta:** This feature is in beta. Breaking changes may occur without a major version bump until the API is stable.
+
+The `IsolatedVmCodeModeTransport` class runs [Code mode](https://mastra.ai/docs/agents/code-mode) programs in an in-process V8 isolate, backed by [isolated-vm](https://github.com/laverdet/isolated-vm). The isolate is the execution boundary, so no workspace sandbox is required: the program has no filesystem, network, process, or module access. Its only capabilities are the `external_*` functions, which call back into the real tools on the host.
+
+Compared to the default `StdioCodeModeTransport`, this transport spawns no processes and writes no temp files, which makes it a good fit for serverless and multi-tenant hosts where OS-level sandboxing isn't available.
+
+## Installation
+
+**npm**:
+
+```bash
+npm install @mastra/isolated-vm
+```
+
+**pnpm**:
+
+```bash
+pnpm add @mastra/isolated-vm
+```
+
+**Yarn**:
+
+```bash
+yarn add @mastra/isolated-vm
+```
+
+**Bun**:
+
+```bash
+bun add @mastra/isolated-vm
+```
+
+`isolated-vm` is a native addon. It ships prebuilt binaries for common platforms, so installation usually needs no extra setup. A C++ toolchain is only needed on platforms without a matching prebuild, where it falls back to compiling from source.
+
+On Node.js 20 and later, the host process must be started with the `--no-node-snapshot` flag, otherwise creating an isolate crashes the process. The constructor throws an error when the flag is missing. Pass the flag when starting your server, or set it through `NODE_OPTIONS`:
+
+```bash
+NODE_OPTIONS=--no-node-snapshot npm run dev
+```
+
+## Usage
+
+Pass the transport as the second argument to `createCodeMode()`. No `sandbox` is needed:
+
+```typescript
+import { createCodeMode } from '@mastra/core/tools'
+import { IsolatedVmCodeModeTransport } from '@mastra/isolated-vm'
+
+const { tool, instructions } = createCodeMode(
+  { tools: { getTopProducts, getProductRatings } },
+  new IsolatedVmCodeModeTransport({ memoryLimitMb: 128 }),
+)
+```
+
+## Constructor parameters
+
+**options** (`IsolatedVmCodeModeTransportOptions`): Configuration for the isolate.
+
+**options.memoryLimitMb** (`number`): V8 isolate heap limit in MiB. A program that exceeds the limit is terminated and the tool returns an error result.
+
+## How it works
+
+Each run creates a fresh isolate with its own heap. TypeScript is stripped on the host with esbuild, then the program is evaluated inside the isolate. Every `external_*` call crosses the isolate boundary as JSON strings in both directions, so no host object references leak into model-authored code. The allow-list, tool validation, request context, and tracing all run on the host, the same as with other transports.
+
+The `timeout` configured on `createCodeMode()` applies to both asynchronous hangs and synchronous infinite loops, and the isolate is disposed after every run.
+
+## Related
+
+- [Code mode](https://mastra.ai/docs/agents/code-mode)
+- [createCodeMode() reference](https://mastra.ai/reference/tools/create-code-mode)

package/.docs/reference/tools/mcp-client.md

@@ -1013,7 +1013,7 @@ const agent = new Agent({
   id: 'multi-tool-agent',
   name: 'Multi-tool Agent',
   instructions: 'You have access to multiple tool servers.',
-  model: 'openai/gpt-5.5',
+  model: 'openai/gpt-5.6-sol',
   tools: await mcp.listTools(),
 })
 
@@ -1064,7 +1064,7 @@ const agent = new Agent({
   id: 'multi-tool-agent',
   name: 'Multi-tool Agent',
   instructions: 'You help users check stocks and weather.',
-  model: 'openai/gpt-5.5',
+  model: 'openai/gpt-5.6-sol',
 })
 
 // Later, configure MCP with user-specific settings

package/.docs/reference/tools/mcp-server.md

@@ -24,7 +24,7 @@ const myAgent = new Agent({
   name: 'MyExampleAgent',
   description: 'A generalist to help with basic questions.',
   instructions: 'You are a helpful assistant.',
-  model: 'openai/gpt-5.5',
+  model: 'openai/gpt-5.6-sol',
 })
 
 const weatherTool = createTool({

package/.docs/reference/tools/vector-query-tool.md

@@ -144,7 +144,7 @@ const queryTool = createVectorQueryTool({
   indexName: 'documentation',
   model: new ModelRouterEmbeddingModel('openai/text-embedding-3-small'),
   reranker: {
-    model: 'openai/gpt-5.5',
+    model: 'openai/gpt-5.6-sol',
     options: {
       weights: {
         semantic: 0.5, // Semantic relevance weight

package/.docs/reference/vectors/libsql.md

@@ -279,7 +279,7 @@ export const libsqlAgent = new Agent({
   name: 'libSQL Agent',
   instructions:
     'You are an AI agent with the ability to automatically recall memories from previous interactions.',
-  model: 'openai/gpt-5.5',
+  model: 'openai/gpt-5.6-sol',
   memory: new Memory({
     storage: new LibSQLStore({
       id: 'libsql-agent-storage',

package/.docs/reference/vectors/mongodb.md

@@ -470,7 +470,7 @@ export const mongodbAgent = new Agent({
   name: 'mongodb-agent',
   instructions:
     'You are an AI agent with the ability to automatically recall memories from previous interactions.',
-  model: 'openai/gpt-5.5',
+  model: 'openai/gpt-5.6-sol',
   memory: new Memory({
     storage: new MongoDBStore({
       id: 'mongodb-storage',
@@ -535,7 +535,7 @@ export const mongodbVoyageAgent = new Agent({
   id: 'mongodb-voyage-agent',
   name: 'MongoDB VoyageAI Agent',
   instructions: 'You are an AI agent with semantic recall powered by VoyageAI and MongoDB.',
-  model: 'openai/gpt-5.5',
+  model: 'openai/gpt-5.6-sol',
   memory: new Memory({
     storage: new MongoDBStore({
       id: 'mongodb-storage',

package/.docs/reference/vectors/pg.md

@@ -403,7 +403,7 @@ export const pgAgent = new Agent({
   name: 'PG Agent',
   instructions:
     'You are an AI agent with the ability to automatically recall memories from previous interactions.',
-  model: 'openai/gpt-5.5',
+  model: 'openai/gpt-5.6-sol',
   memory: new Memory({
     storage: new PostgresStore({
       id: 'pg-agent-storage',

package/.docs/reference/vectors/upstash.md

@@ -267,7 +267,7 @@ export const upstashAgent = new Agent({
   name: 'Upstash Agent',
   instructions:
     'You are an AI agent with the ability to automatically recall memories from previous interactions.',
-  model: 'openai/gpt-5.5',
+  model: 'openai/gpt-5.6-sol',
   memory: new Memory({
     storage: new UpstashStore({
       id: 'upstash-agent-storage',

package/.docs/reference/voice/voice.addInstructions.md

@@ -23,7 +23,7 @@ const agent = new Agent({
   id: 'customer-support-agent',
   name: 'Customer Support Agent',
   instructions: 'You are a helpful customer support agent for a software company.',
-  model: 'openai/gpt-5.5',
+  model: 'openai/gpt-5.6-sol',
   voice,
 })
 

package/.docs/reference/workers/overview.md

@@ -0,0 +1,85 @@
+> Discover all available pages from the documentation index: https://mastra.ai/llms.txt
+
+# Workers
+
+For usage patterns and deployment topologies, see [Workers](https://mastra.ai/docs/deployment/workers).
+
+## Environment variables
+
+### `MASTRA_WORKERS`
+
+Controls which workers start in the current process.
+
+| Value                       | Behavior                                                              |
+| --------------------------- | --------------------------------------------------------------------- |
+| _(not set)_                 | Default workers are auto-created based on configuration               |
+| `"false"`                   | Disables all event processing. The process only serves HTTP requests. |
+| `"orchestration"`           | Only the orchestration worker starts                                  |
+| `"scheduler"`               | Only the scheduler worker starts                                      |
+| `"backgroundTasks"`         | Only the background task worker starts                                |
+| `"orchestration,scheduler"` | Multiple workers (comma-separated)                                    |
+
+Use this to run different worker types in separate containers from the same build artifact.
+
+### `MASTRA_STEP_EXECUTION_URL`
+
+The base URL of the API server, used by the orchestration worker to execute workflow steps remotely. Required when the orchestration worker runs in a separate process from the API.
+
+```text
+MASTRA_STEP_EXECUTION_URL=http://api:4111/api
+```
+
+The orchestration worker sends step execution requests to:
+
+```text
+${MASTRA_STEP_EXECUTION_URL}/workflows/:workflowId/runs/:runId/steps/execute
+```
+
+### `MASTRA_WORKER_AUTH_TOKEN`
+
+A bearer token sent by the orchestration worker when calling the API's step execution endpoint. The API's configured auth provider must recognize this token. See [Worker authentication](https://mastra.ai/docs/server/auth/workers).
+
+```text
+MASTRA_WORKER_AUTH_TOKEN=sk-worker-secret-token
+```
+
+## Worker types
+
+### OrchestrationWorker
+
+Processes workflow events from the PubSub `workflows` topic. Requires a pull-capable PubSub like `@mastra/redis-streams` or `@mastra/google-cloud-pubsub` configured with a pull subscription.
+
+- **Name**: `orchestration`
+- **PubSub topic**: `workflows`
+- **Consumer group**: `mastra-orchestration`
+
+### SchedulerWorker
+
+Polls storage for due cron schedules and publishes `workflow.start` events.
+
+- **Name**: `scheduler`
+- **Single instance only**: Run exactly one instance to avoid duplicate fires
+
+### BackgroundTaskWorker
+
+Executes background tool calls dispatched by agents.
+
+- **Name**: `backgroundTasks`
+- **PubSub topic**: `background-tasks`
+- **Consumer group**: `background-task-workers`
+- **Supports multiple replicas**: Instances share the consumer group
+
+## Supported storage backends
+
+A deployment running all worker types requires a storage backend that implements the `workflows`, `backgroundTasks`, and `schedules` domains. The `schedules` domain is specifically required by the SchedulerWorker. If you don't use scheduled workflows, backends without it can still support orchestration and background tasks. The following backends support all three:
+
+| Backend    | Package                                                          |
+| ---------- | ---------------------------------------------------------------- |
+| PostgreSQL | [`@mastra/pg`](https://mastra.ai/reference/storage/postgresql)   |
+| LibSQL     | [`@mastra/libsql`](https://mastra.ai/reference/storage/libsql)   |
+| MySQL      | `@mastra/mysql`                                                  |
+| MongoDB    | [`@mastra/mongodb`](https://mastra.ai/reference/storage/mongodb) |
+| Spanner    | [`@mastra/spanner`](https://mastra.ai/reference/storage/spanner) |
+| Convex     | [`@mastra/convex`](https://mastra.ai/reference/storage/convex)   |
+
+Other storage backends (Upstash, DynamoDB, Cloudflare D1, ClickHouse, Redis) support workflows and some worker features, but are missing the `schedules` domain. They can still be used for orchestration and background task workers if you don't deploy the scheduler.

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

@@ -48,7 +48,7 @@ const workspace = new Workspace({
 const agent = new Agent({
   id: 'file-agent',
   name: 'file-agent',
-  model: 'openai/gpt-5.5',
+  model: 'openai/gpt-5.6-sol',
   workspace,
 })
 ```

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

@@ -22,7 +22,7 @@ const workspace = new Workspace({
 
 const agent = new Agent({
   id: 'file-agent',
-  model: 'openai/gpt-5.5',
+  model: 'openai/gpt-5.6-sol',
   workspace,
 })
 

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

@@ -26,7 +26,7 @@ const workspace = new Workspace({
 
 const agent = new Agent({
   id: 'dev-agent',
-  model: 'openai/gpt-5.5',
+  model: 'openai/gpt-5.6-sol',
   workspace,
 })
 

package/CHANGELOG.md

@@ -1,5 +1,19 @@
 # @mastra/mcp-docs-server
 
+## 1.2.12-alpha.3
+
+### Patch Changes
+
+- Updated dependencies [[`55c9e24`](https://github.com/mastra-ai/mastra/commit/55c9e248c27c1d72b5bb7e94ea6b8a3999eee49f), [`07f5b4b`](https://github.com/mastra-ai/mastra/commit/07f5b4ba9d608d88865030732e580298296adf99)]:
+  - @mastra/core@1.55.0-alpha.2
+
+## 1.2.12-alpha.1
+
+### Patch Changes
+
+- Updated dependencies [[`ba369f2`](https://github.com/mastra-ai/mastra/commit/ba369f2a0aaf998da0d6aa033d26f64f96bef8ac), [`dcfed93`](https://github.com/mastra-ai/mastra/commit/dcfed93e1e256c6abfa792cbb7ca836f5d0e8638), [`2876e15`](https://github.com/mastra-ai/mastra/commit/2876e15b4d2f616a3bc1ed3af57d546c268384ce), [`598080f`](https://github.com/mastra-ai/mastra/commit/598080f224edb3f0f5b801035b067fac50a56a03)]:
+  - @mastra/core@1.55.0-alpha.1
+
 ## 1.2.12-alpha.0
 
 ### Patch Changes

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mastra/mcp-docs-server",
-  "version": "1.2.12-alpha.0",
+  "version": "1.2.12-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/mcp": "^1.15.0",
-    "@mastra/core": "1.55.0-alpha.0"
+    "@mastra/core": "1.55.0-alpha.2",
+    "@mastra/mcp": "^1.15.0"
   },
   "devDependencies": {
     "@hono/node-server": "^1.19.14",
@@ -46,8 +46,8 @@
     "typescript": "^6.0.3",
     "vitest": "4.1.10",
     "@internal/lint": "0.0.118",
-    "@mastra/core": "1.55.0-alpha.0",
-    "@internal/types-builder": "0.0.93"
+    "@internal/types-builder": "0.0.93",
+    "@mastra/core": "1.55.0-alpha.2"
   },
   "homepage": "https://mastra.ai",
   "repository": {