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

package/.docs/models/providers/opencode.md

@@ -1,6 +1,6 @@
 # ![OpenCode Zen logo](https://models.dev/logos/opencode.svg)OpenCode Zen
 
-Access 38 OpenCode Zen models through Mastra's model router. Authentication is handled automatically using the `OPENCODE_API_KEY` environment variable.
+Access 39 OpenCode Zen models through Mastra's model router. Authentication is handled automatically using the `OPENCODE_API_KEY` environment variable.
 
 Learn more in the [OpenCode Zen documentation](https://opencode.ai/docs/zen).
 
@@ -63,6 +63,7 @@ for await (const chunk of stream) {
 | `opencode/gpt-5.4-mini`          | 400K    |       |           |       |       |       | $0.75      | $5          |
 | `opencode/gpt-5.4-nano`          | 400K    |       |           |       |       |       | $0.20      | $1          |
 | `opencode/gpt-5.4-pro`           | 1.1M    |       |           |       |       |       | $30        | $180        |
+| `opencode/hy3-preview-free`      | 256K    |       |           |       |       |       | —          | —           |
 | `opencode/kimi-k2.5`             | 262K    |       |           |       |       |       | $0.60      | $3          |
 | `opencode/kimi-k2.6`             | 262K    |       |           |       |       |       | $0.95      | $4          |
 | `opencode/ling-2.6-flash-free`   | 262K    |       |           |       |       |       | —          | —           |

package/.docs/models/providers/poe.md

@@ -1,6 +1,6 @@
 # ![Poe logo](https://models.dev/logos/poe.svg)Poe
 
-Access 118 Poe models through Mastra's model router. Authentication is handled automatically using the `POE_API_KEY` environment variable.
+Access 119 Poe models through Mastra's model router. Authentication is handled automatically using the `POE_API_KEY` environment variable.
 
 Learn more in the [Poe documentation](https://creator.poe.com/docs/external-applications/openai-compatible-api).
 
@@ -126,6 +126,7 @@ for await (const chunk of stream) {
 | `poe/openai/gpt-image-1`               | 128K    |       |           |       |       |       | —          | —           |
 | `poe/openai/gpt-image-1-mini`          | —       |       |           |       |       |       | —          | —           |
 | `poe/openai/gpt-image-1.5`             | 128K    |       |           |       |       |       | —          | —           |
+| `poe/openai/gpt-image-2`               | —       |       |           |       |       |       | $5         | $32         |
 | `poe/openai/o1`                        | 200K    |       |           |       |       |       | $14        | $54         |
 | `poe/openai/o1-pro`                    | 200K    |       |           |       |       |       | $140       | $540        |
 | `poe/openai/o3`                        | 200K    |       |           |       |       |       | $2         | $7          |

package/.docs/models/providers/siliconflow-cn.md

@@ -1,6 +1,6 @@
 # ![SiliconFlow (China) logo](https://models.dev/logos/siliconflow-cn.svg)SiliconFlow (China)
 
-Access 79 SiliconFlow (China) models through Mastra's model router. Authentication is handled automatically using the `SILICONFLOW_CN_API_KEY` environment variable.
+Access 81 SiliconFlow (China) models through Mastra's model router. Authentication is handled automatically using the `SILICONFLOW_CN_API_KEY` environment variable.
 
 Learn more in the [SiliconFlow (China) documentation](https://cloud.siliconflow.com/models).
 
@@ -61,7 +61,8 @@ for await (const chunk of stream) {
 | `siliconflow-cn/Pro/MiniMaxAI/MiniMax-M2.5`               | 192K    |       |           |       |       |       | $0.30      | $1          |
 | `siliconflow-cn/Pro/moonshotai/Kimi-K2-Instruct-0905`     | 262K    |       |           |       |       |       | $0.40      | $2          |
 | `siliconflow-cn/Pro/moonshotai/Kimi-K2-Thinking`          | 262K    |       |           |       |       |       | $0.55      | $3          |
-| `siliconflow-cn/Pro/moonshotai/Kimi-K2.5`                 | 262K    |       |           |       |       |       | $0.55      | $3          |
+| `siliconflow-cn/Pro/moonshotai/Kimi-K2.5`                 | 262K    |       |           |       |       |       | $0.45      | $2          |
+| `siliconflow-cn/Pro/moonshotai/Kimi-K2.6`                 | 262K    |       |           |       |       |       | $0.95      | $4          |
 | `siliconflow-cn/Pro/zai-org/GLM-4.7`                      | 205K    |       |           |       |       |       | $0.60      | $2          |
 | `siliconflow-cn/Pro/zai-org/GLM-5`                        | 205K    |       |           |       |       |       | $1         | $3          |
 | `siliconflow-cn/Pro/zai-org/GLM-5.1`                      | 205K    |       |           |       |       |       | $1         | $4          |
@@ -101,6 +102,7 @@ for await (const chunk of stream) {
 | `siliconflow-cn/Qwen/Qwen3.5-397B-A17B`                   | 262K    |       |           |       |       |       | $0.29      | $2          |
 | `siliconflow-cn/Qwen/Qwen3.5-4B`                          | 262K    |       |           |       |       |       | —          | —           |
 | `siliconflow-cn/Qwen/Qwen3.5-9B`                          | 262K    |       |           |       |       |       | $0.22      | $2          |
+| `siliconflow-cn/Qwen/Qwen3.6-35B-A3B`                     | 262K    |       |           |       |       |       | $0.23      | $2          |
 | `siliconflow-cn/Qwen/QwQ-32B`                             | 131K    |       |           |       |       |       | $0.15      | $0.58       |
 | `siliconflow-cn/stepfun-ai/Step-3.5-Flash`                | 262K    |       |           |       |       |       | $0.10      | $0.30       |
 | `siliconflow-cn/tencent/Hunyuan-A13B-Instruct`            | 131K    |       |           |       |       |       | $0.14      | $0.57       |

package/.docs/models/providers/siliconflow.md

@@ -1,6 +1,6 @@
 # ![SiliconFlow logo](https://models.dev/logos/siliconflow.svg)SiliconFlow
 
-Access 73 SiliconFlow models through Mastra's model router. Authentication is handled automatically using the `SILICONFLOW_API_KEY` environment variable.
+Access 74 SiliconFlow models through Mastra's model router. Authentication is handled automatically using the `SILICONFLOW_API_KEY` environment variable.
 
 Learn more in the [SiliconFlow documentation](https://cloud.siliconflow.com/models).
 
@@ -54,7 +54,8 @@ for await (const chunk of stream) {
 | `siliconflow/moonshotai/Kimi-K2-Instruct`              | 131K    |       |           |       |       |       | $0.58      | $2          |
 | `siliconflow/moonshotai/Kimi-K2-Instruct-0905`         | 262K    |       |           |       |       |       | $0.40      | $2          |
 | `siliconflow/moonshotai/Kimi-K2-Thinking`              | 262K    |       |           |       |       |       | $0.55      | $3          |
-| `siliconflow/moonshotai/Kimi-K2.5`                     | 262K    |       |           |       |       |       | $0.55      | $3          |
+| `siliconflow/moonshotai/Kimi-K2.5`                     | 262K    |       |           |       |       |       | $0.45      | $2          |
+| `siliconflow/moonshotai/Kimi-K2.6`                     | 262K    |       |           |       |       |       | $0.95      | $4          |
 | `siliconflow/nex-agi/DeepSeek-V3.1-Nex-N1`             | 131K    |       |           |       |       |       | $0.50      | $2          |
 | `siliconflow/openai/gpt-oss-120b`                      | 131K    |       |           |       |       |       | $0.05      | $0.45       |
 | `siliconflow/openai/gpt-oss-20b`                       | 131K    |       |           |       |       |       | $0.04      | $0.18       |

package/.docs/models/providers/togetherai.md

@@ -1,6 +1,6 @@
 # ![Together AI logo](https://models.dev/logos/togetherai.svg)Together AI
 
-Access 15 Together AI models through Mastra's model router. Authentication is handled automatically using the `TOGETHER_API_KEY` environment variable.
+Access 16 Together AI models through Mastra's model router. Authentication is handled automatically using the `TOGETHER_API_KEY` environment variable.
 
 Learn more in the [Together AI documentation](https://docs.together.ai/docs/serverless-models).
 
@@ -41,6 +41,7 @@ for await (const chunk of stream) {
 | `togetherai/MiniMaxAI/MiniMax-M2.5`                  | 205K    |       |           |       |       |       | $0.30      | $1          |
 | `togetherai/MiniMaxAI/MiniMax-M2.7`                  | 203K    |       |           |       |       |       | $0.30      | $1          |
 | `togetherai/moonshotai/Kimi-K2.5`                    | 262K    |       |           |       |       |       | $0.50      | $3          |
+| `togetherai/moonshotai/Kimi-K2.6`                    | 262K    |       |           |       |       |       | $1         | $5          |
 | `togetherai/openai/gpt-oss-120b`                     | 131K    |       |           |       |       |       | $0.15      | $0.60       |
 | `togetherai/Qwen/Qwen3-235B-A22B-Instruct-2507-tput` | 262K    |       |           |       |       |       | $0.20      | $0.60       |
 | `togetherai/Qwen/Qwen3-Coder-480B-A35B-Instruct-FP8` | 262K    |       |           |       |       |       | $2         | $2          |

package/.docs/reference/agents/generate.md

@@ -218,7 +218,7 @@ const response = await agent.generate('Help me organize my day', {
 
 **options.memory.resource** (`string`): Resource identifier for organizing conversations by user, session, or context.
 
-**options.memory.options** (`MemoryConfig`): Additional memory configuration options including lastMessages, readOnly, semanticRecall, and workingMemory.
+**options.memory.options** (`MemoryConfig`): Additional memory configuration options including lastMessages, readOnly, semanticRecall, workingMemory, and filterIncompleteToolCalls.
 
 **options.onFinish** (`LoopConfig['onFinish']`): Callback fired when generation completes.
 

package/.docs/reference/browser/browser-viewer.md

@@ -0,0 +1,228 @@
+# BrowserViewer
+
+The `BrowserViewer` class provides browser automation for CLI-based tools. It launches Chrome via Playwright, exposes a Chrome DevTools Protocol (CDP) URL, and automatically injects it into CLI commands run through workspace tools.
+
+Use `BrowserViewer` when your agent drives a browser through a CLI tool like `browser-use`, `agent-browser`, or `browse`. For SDK-based browser automation, use [`AgentBrowser`](https://mastra.ai/reference/browser/agent-browser) or [`StagehandBrowser`](https://mastra.ai/reference/browser/stagehand-browser).
+
+## Usage example
+
+```typescript
+import { Workspace, LocalSandbox } from '@mastra/core/workspace'
+import { BrowserViewer } from '@mastra/browser-viewer'
+import { Agent } from '@mastra/core/agent'
+
+const workspace = new Workspace({
+  sandbox: new LocalSandbox({
+    workingDirectory: './workspace',
+  }),
+  browser: new BrowserViewer({
+    cli: 'browser-use',
+    headless: false,
+  }),
+})
+
+const browserAgent = new Agent({
+  id: 'browser-agent',
+  model: 'openai/gpt-5.4',
+  workspace,
+  instructions: 'You are a web automation assistant.',
+})
+```
+
+### Connecting to an existing browser
+
+```typescript
+const viewer = new BrowserViewer({
+  cli: 'browser-use',
+  cdpUrl: 'ws://127.0.0.1:9222/devtools/browser/abc123',
+})
+```
+
+When `cdpUrl` is provided, `BrowserViewer` connects to the existing browser instead of launching a new one. Scope defaults to `'shared'`.
+
+## Constructor parameters
+
+**cli** (`'agent-browser' | 'browser-use' | 'browse-cli'`): Which CLI the agent uses for browser automation. The CLI connects to Chrome via the CDP URL.
+
+**headless** (`boolean`): Whether to run Chrome in headless mode. (Default: `true`)
+
+**cdpUrl** (`string | (() => string | Promise<string>)`): CDP WebSocket URL for connecting to an existing browser instead of launching one.
+
+**cdpPort** (`number`): Port for Chrome remote debugging. Only used when launching Chrome (not when connecting via cdpUrl). (Default: `0 (auto-assign)`)
+
+**scope** (`'shared' | 'thread'`): Browser instance scope. 'thread' gives each thread its own browser. 'shared' shares one browser across all threads. Defaults to 'shared' when cdpUrl is provided. (Default: `'thread'`)
+
+**viewport** (`{ width: number; height: number }`): Browser viewport dimensions. (Default: `{ width: 1280, height: 720 }`)
+
+**executablePath** (`string`): Path to a Chrome executable. Uses Playwright's bundled Chromium by default.
+
+**onLaunch** (`(args: { browser: MastraBrowser }) => void | Promise<void>`): Callback invoked after the browser is ready.
+
+**onClose** (`(args: { browser: MastraBrowser }) => void | Promise<void>`): Callback invoked before the browser closes.
+
+**screencast** (`ScreencastOptions`): Configuration for streaming browser frames to Studio.
+
+## Properties
+
+**id** (`string`): Unique identifier for this browser instance. Generated as 'browser-viewer-{timestamp}'.
+
+**name** (`string`): 'BrowserViewer'
+
+**provider** (`string`): 'browser-viewer'
+
+**providerType** (`'cli'`): Always 'cli'. Distinguishes BrowserViewer from SDK-based providers like AgentBrowser.
+
+**cli** (`'agent-browser' | 'browser-use' | 'browse-cli'`): The CLI provider this instance is configured for.
+
+**status** (`BrowserStatus`): Current browser status: 'pending', 'launching', 'ready', 'error', 'closing', or 'closed'.
+
+## Methods
+
+### Lifecycle
+
+#### `launch(threadId?)`
+
+Launches Chrome. For `'shared'` scope, launches a single shared browser. For `'thread'` scope, launches a browser for the specified thread.
+
+```typescript
+await viewer.launch()
+await viewer.launch('thread-123')
+```
+
+#### `ensureReady()`
+
+Ensures the browser is launched and ready. For `'thread'` scope, creates a new browser for the current thread if needed.
+
+```typescript
+await viewer.ensureReady()
+```
+
+#### `isBrowserRunning(threadId?)`
+
+Checks if a browser is running. For `'thread'` scope, checks the specified thread.
+
+```typescript
+const running = viewer.isBrowserRunning()
+const threadRunning = viewer.isBrowserRunning('thread-123')
+```
+
+Returns: `boolean`
+
+#### `close()`
+
+Closes all browser instances and cleans up resources.
+
+```typescript
+await viewer.close()
+```
+
+### CDP access
+
+#### `getCdpUrl(threadId?)`
+
+Returns the CDP WebSocket URL for the current or specified thread. CLI tools use this URL to connect to the managed browser.
+
+```typescript
+const cdpUrl = viewer.getCdpUrl()
+// => 'ws://127.0.0.1:52481/devtools/browser/abc...'
+```
+
+Returns: `string | null`
+
+#### `connectToExternalCdp(cdpUrl, threadId?)`
+
+Connects to an external browser via CDP URL for screencast. Use this when the agent provides its own browser endpoint (for example, a cloud browser service). BrowserViewer connects for screencast without managing the browser lifecycle.
+
+```typescript
+await viewer.connectToExternalCdp('wss://cloud.example.com/session', 'thread-123')
+```
+
+### Screencast
+
+#### `startScreencast(options?)`
+
+Starts streaming browser frames. Returns a `ScreencastStream` that emits frame events. Handles tab switching automatically by creating fresh CDP sessions when tabs change.
+
+```typescript
+const stream = await viewer.startScreencast({
+  format: 'jpeg',
+  quality: 80,
+})
+
+stream.on('frame', frame => {
+  console.log('Frame received:', frame.data.length, 'bytes')
+})
+
+stream.on('stop', reason => {
+  console.log('Screencast stopped:', reason)
+})
+```
+
+Returns: `Promise<ScreencastStream>`
+
+### Input injection
+
+#### `injectMouseEvent(params, threadId?)`
+
+Injects a mouse event into the browser via CDP. Used by Studio for live interaction.
+
+```typescript
+await viewer.injectMouseEvent({
+  type: 'mousePressed',
+  x: 100,
+  y: 200,
+  button: 'left',
+  clickCount: 1,
+})
+```
+
+#### `injectKeyboardEvent(params, threadId?)`
+
+Injects a keyboard event into the browser via CDP. Used by Studio for live interaction.
+
+```typescript
+await viewer.injectKeyboardEvent({
+  type: 'keyDown',
+  key: 'Enter',
+  code: 'Enter',
+})
+```
+
+## Supported CLIs
+
+Each CLI must be installed separately. Each also publishes a [skill](https://mastra.ai/docs/workspace/skills) that teaches the agent its commands and workflows. When a CLI command runs through `workspace_execute_command`, Mastra detects it and injects the CDP URL automatically using the correct flag.
+
+Unlike SDK providers, `BrowserViewer` does not provide agent tools. The agent uses CLI commands through `workspace_execute_command` instead.
+
+### [agent-browser](https://www.npmjs.com/package/agent-browser)
+
+Config value: `'agent-browser'` · CDP flag: `--cdp`
+
+```bash
+npm install -g agent-browser
+npx skills add vercel-labs/agent-browser
+```
+
+### [browser-use](https://pypi.org/project/browser-use/)
+
+Config value: `'browser-use'` · CDP flag: `--cdp-url`
+
+```bash
+pip install browser-use
+npx skills add browser-use/browser-use --skill browser-use
+```
+
+### [browse-cli](https://www.npmjs.com/package/@browserbasehq/browse-cli) (command: `browse`)
+
+Config value: `'browse-cli'` · CDP flag: `--ws`
+
+```bash
+npm install -g @browserbasehq/browse-cli
+npx skills add browserbase/skills
+```
+
+## Related
+
+- [BrowserViewer guide](https://mastra.ai/docs/browser/browser-viewer) — setup and usage walkthrough
+- [MastraBrowser](https://mastra.ai/reference/browser/mastra-browser) — base class API reference
+- [Workspace overview](https://mastra.ai/docs/workspace/overview) — workspace configuration

package/.docs/reference/browser/mastra-browser.md

@@ -6,6 +6,7 @@ You don't instantiate `MastraBrowser` directly. Instead, use a provider implemen
 
 - [`AgentBrowser`](https://mastra.ai/reference/browser/agent-browser): Deterministic browser automation using refs
 - [`StagehandBrowser`](https://mastra.ai/reference/browser/stagehand-browser): AI-powered browser automation using natural language
+- [`BrowserViewer`](https://mastra.ai/reference/browser/browser-viewer): CLI-based browser automation with CDP URL injection
 
 ## Usage example
 
@@ -33,7 +34,7 @@ export const browserAgent = new Agent({
 
 **viewport** (`{ width: number; height: number }`): Browser viewport dimensions. Controls the size of the browser window. (Default: `{ width: 1280, height: 720 }`)
 
-**timeout** (`number`): Default timeout in milliseconds for browser operations. (Default: `10000`)
+**timeout** (`number`): Default timeout in milliseconds. Each provider defines its own semantics and default. See the provider reference for details.
 
 **cdpUrl** (`string | (() => string | Promise<string>)`): CDP WebSocket URL, HTTP endpoint, or sync/async provider function. When provided, connects to an existing browser instead of launching a new one. HTTP endpoints are resolved to WebSocket internally. Can't be used with scope: 'thread' (automatically uses shared scope).
 

package/.docs/reference/browser/stagehand-browser.md

@@ -52,7 +52,7 @@ Use stagehand_extract to get data from pages.`,
 
 **scope** (`'shared' | 'thread'`): Browser instance scope across threads. (Default: `'thread' (or 'shared' when cdpUrl is provided)`)
 
-**timeout** (`number`): Default timeout in milliseconds for browser operations. (Default: `10000`)
+**timeout** (`number`): Default timeout in milliseconds for Stagehand operations. (Default: `30000`)
 
 **onLaunch** (`(args: { browser: MastraBrowser }) => void | Promise<void>`): Callback invoked after the browser is ready.
 

package/.docs/reference/index.md

@@ -41,6 +41,7 @@ The Reference section provides documentation of Mastra's API, including paramete
 - [Supabase](https://mastra.ai/reference/auth/supabase)
 - [WorkOS](https://mastra.ai/reference/auth/workos)
 - [AgentBrowser](https://mastra.ai/reference/browser/agent-browser)
+- [BrowserViewer](https://mastra.ai/reference/browser/browser-viewer)
 - [MastraBrowser Class](https://mastra.ai/reference/browser/mastra-browser)
 - [StagehandBrowser](https://mastra.ai/reference/browser/stagehand-browser)
 - [create-mastra](https://mastra.ai/reference/cli/create-mastra)
@@ -291,6 +292,7 @@ The Reference section provides documentation of Mastra's API, including paramete
 - [GCSFilesystem](https://mastra.ai/reference/workspace/gcs-filesystem)
 - [LocalFilesystem](https://mastra.ai/reference/workspace/local-filesystem)
 - [LocalSandbox](https://mastra.ai/reference/workspace/local-sandbox)
+- [ModalSandbox](https://mastra.ai/reference/workspace/modal-sandbox)
 - [S3Filesystem](https://mastra.ai/reference/workspace/s3-filesystem)
 - [SandboxProcessManager](https://mastra.ai/reference/workspace/process-manager)
 - [VercelSandbox](https://mastra.ai/reference/workspace/vercel)