@mastra/mcp-docs-server 1.1.35-alpha.6 → 1.1.35

package/.docs/models/providers/sarvam.md

@@ -0,0 +1,72 @@
+# ![Sarvam AI logo](https://models.dev/logos/sarvam.svg)Sarvam AI
+
+Access 2 Sarvam AI models through Mastra's model router. Authentication is handled automatically using the `SARVAM_API_KEY` environment variable.
+
+Learn more in the [Sarvam AI documentation](https://docs.sarvam.ai).
+
+```bash
+SARVAM_API_KEY=your-api-key
+```
+
+```typescript
+import { Agent } from "@mastra/core/agent";
+
+const agent = new Agent({
+  id: "my-agent",
+  name: "My Agent",
+  instructions: "You are a helpful assistant",
+  model: "sarvam/sarvam-105b"
+});
+
+// Generate a response
+const response = await agent.generate("Hello!");
+
+// Stream a response
+const stream = await agent.stream("Tell me a story");
+for await (const chunk of stream) {
+  console.log(chunk);
+}
+```
+
+> **Info:** Mastra uses the OpenAI-compatible `/chat/completions` endpoint. Some provider-specific features may not be available. Check the [Sarvam AI documentation](https://docs.sarvam.ai) for details.
+
+## Models
+
+| Model                | Context | Tools | Reasoning | Image | Audio | Video | Input $/1M | Output $/1M |
+| -------------------- | ------- | ----- | --------- | ----- | ----- | ----- | ---------- | ----------- |
+| `sarvam/sarvam-105b` | 131K    |       |           |       |       |       | —          | —           |
+| `sarvam/sarvam-30b`  | 66K     |       |           |       |       |       | —          | —           |
+
+## Advanced configuration
+
+### Custom headers
+
+```typescript
+const agent = new Agent({
+  id: "custom-agent",
+  name: "custom-agent",
+  model: {
+    url: "https://api.sarvam.ai/v1",
+    id: "sarvam/sarvam-105b",
+    apiKey: process.env.SARVAM_API_KEY,
+    headers: {
+      "X-Custom-Header": "value"
+    }
+  }
+});
+```
+
+### Dynamic model selection
+
+```typescript
+const agent = new Agent({
+  id: "dynamic-agent",
+  name: "Dynamic Agent",
+  model: ({ requestContext }) => {
+    const useAdvanced = requestContext.task === "complex";
+    return useAdvanced
+      ? "sarvam/sarvam-30b"
+      : "sarvam/sarvam-105b";
+  }
+});
+```

package/.docs/models/providers/wafer.ai.md

@@ -1,6 +1,6 @@
 # ![Wafer logo](https://models.dev/logos/wafer.ai.svg)Wafer
 
-Access 3 Wafer models through Mastra's model router. Authentication is handled automatically using the `WAFER_API_KEY` environment variable.
+Access 4 Wafer models through Mastra's model router. Authentication is handled automatically using the `WAFER_API_KEY` environment variable.
 
 Learn more in the [Wafer documentation](https://docs.wafer.ai/wafer-pass).
 
@@ -36,6 +36,7 @@ for await (const chunk of stream) {
 | ---------------------------- | ------- | ----- | --------- | ----- | ----- | ----- | ---------- | ----------- |
 | `wafer.ai/DeepSeek-V4-Pro`   | 1.0M    |       |           |       |       |       | —          | —           |
 | `wafer.ai/GLM-5.1`           | 203K    |       |           |       |       |       | —          | —           |
+| `wafer.ai/MiniMax-M2.7`      | 205K    |       |           |       |       |       | —          | —           |
 | `wafer.ai/Qwen3.5-397B-A17B` | 262K    |       |           |       |       |       | —          | —           |
 
 ## Advanced configuration

package/.docs/models/providers/xiaomi-token-plan-ams.md

@@ -1,6 +1,6 @@
 # ![Xiaomi Token Plan (Europe) logo](https://models.dev/logos/xiaomi-token-plan-ams.svg)Xiaomi Token Plan (Europe)
 
-Access 5 Xiaomi Token Plan (Europe) models through Mastra's model router. Authentication is handled automatically using the `XIAOMI_API_KEY` environment variable.
+Access 6 Xiaomi Token Plan (Europe) models through Mastra's model router. Authentication is handled automatically using the `XIAOMI_API_KEY` environment variable.
 
 Learn more in the [Xiaomi Token Plan (Europe) documentation](https://platform.xiaomimimo.com/#/docs).
 
@@ -15,7 +15,7 @@ const agent = new Agent({
   id: "my-agent",
   name: "My Agent",
   instructions: "You are a helpful assistant",
-  model: "xiaomi-token-plan-ams/mimo-v2-omni"
+  model: "xiaomi-token-plan-ams/mimo-v2-flash"
 });
 
 // Generate a response
@@ -34,7 +34,8 @@ for await (const chunk of stream) {
 
 | Model                                 | Context | Tools | Reasoning | Image | Audio | Video | Input $/1M | Output $/1M |
 | ------------------------------------- | ------- | ----- | --------- | ----- | ----- | ----- | ---------- | ----------- |
-| `xiaomi-token-plan-ams/mimo-v2-omni`  | 256K    |       |           |       |       |       | —          | —           |
+| `xiaomi-token-plan-ams/mimo-v2-flash` | 262K    |       |           |       |       |       | —          | —           |
+| `xiaomi-token-plan-ams/mimo-v2-omni`  | 262K    |       |           |       |       |       | —          | —           |
 | `xiaomi-token-plan-ams/mimo-v2-pro`   | 1.0M    |       |           |       |       |       | —          | —           |
 | `xiaomi-token-plan-ams/mimo-v2-tts`   | 8K      |       |           |       |       |       | —          | —           |
 | `xiaomi-token-plan-ams/mimo-v2.5`     | 1.0M    |       |           |       |       |       | —          | —           |
@@ -50,7 +51,7 @@ const agent = new Agent({
   name: "custom-agent",
   model: {
     url: "https://token-plan-ams.xiaomimimo.com/v1",
-    id: "xiaomi-token-plan-ams/mimo-v2-omni",
+    id: "xiaomi-token-plan-ams/mimo-v2-flash",
     apiKey: process.env.XIAOMI_API_KEY,
     headers: {
       "X-Custom-Header": "value"
@@ -69,7 +70,7 @@ const agent = new Agent({
     const useAdvanced = requestContext.task === "complex";
     return useAdvanced
       ? "xiaomi-token-plan-ams/mimo-v2.5-pro"
-      : "xiaomi-token-plan-ams/mimo-v2-omni";
+      : "xiaomi-token-plan-ams/mimo-v2-flash";
   }
 });
 ```

package/.docs/models/providers/xiaomi-token-plan-cn.md

@@ -1,6 +1,6 @@
 # ![Xiaomi Token Plan (China) logo](https://models.dev/logos/xiaomi-token-plan-cn.svg)Xiaomi Token Plan (China)
 
-Access 5 Xiaomi Token Plan (China) models through Mastra's model router. Authentication is handled automatically using the `XIAOMI_API_KEY` environment variable.
+Access 6 Xiaomi Token Plan (China) models through Mastra's model router. Authentication is handled automatically using the `XIAOMI_API_KEY` environment variable.
 
 Learn more in the [Xiaomi Token Plan (China) documentation](https://platform.xiaomimimo.com/#/docs).
 
@@ -15,7 +15,7 @@ const agent = new Agent({
   id: "my-agent",
   name: "My Agent",
   instructions: "You are a helpful assistant",
-  model: "xiaomi-token-plan-cn/mimo-v2-omni"
+  model: "xiaomi-token-plan-cn/mimo-v2-flash"
 });
 
 // Generate a response
@@ -34,7 +34,8 @@ for await (const chunk of stream) {
 
 | Model                                | Context | Tools | Reasoning | Image | Audio | Video | Input $/1M | Output $/1M |
 | ------------------------------------ | ------- | ----- | --------- | ----- | ----- | ----- | ---------- | ----------- |
-| `xiaomi-token-plan-cn/mimo-v2-omni`  | 256K    |       |           |       |       |       | —          | —           |
+| `xiaomi-token-plan-cn/mimo-v2-flash` | 262K    |       |           |       |       |       | —          | —           |
+| `xiaomi-token-plan-cn/mimo-v2-omni`  | 262K    |       |           |       |       |       | —          | —           |
 | `xiaomi-token-plan-cn/mimo-v2-pro`   | 1.0M    |       |           |       |       |       | —          | —           |
 | `xiaomi-token-plan-cn/mimo-v2-tts`   | 8K      |       |           |       |       |       | —          | —           |
 | `xiaomi-token-plan-cn/mimo-v2.5`     | 1.0M    |       |           |       |       |       | —          | —           |
@@ -50,7 +51,7 @@ const agent = new Agent({
   name: "custom-agent",
   model: {
     url: "https://token-plan-cn.xiaomimimo.com/v1",
-    id: "xiaomi-token-plan-cn/mimo-v2-omni",
+    id: "xiaomi-token-plan-cn/mimo-v2-flash",
     apiKey: process.env.XIAOMI_API_KEY,
     headers: {
       "X-Custom-Header": "value"
@@ -69,7 +70,7 @@ const agent = new Agent({
     const useAdvanced = requestContext.task === "complex";
     return useAdvanced
       ? "xiaomi-token-plan-cn/mimo-v2.5-pro"
-      : "xiaomi-token-plan-cn/mimo-v2-omni";
+      : "xiaomi-token-plan-cn/mimo-v2-flash";
   }
 });
 ```

package/.docs/models/providers/xiaomi-token-plan-sgp.md

@@ -1,6 +1,6 @@
 # ![Xiaomi Token Plan (Singapore) logo](https://models.dev/logos/xiaomi-token-plan-sgp.svg)Xiaomi Token Plan (Singapore)
 
-Access 5 Xiaomi Token Plan (Singapore) models through Mastra's model router. Authentication is handled automatically using the `XIAOMI_API_KEY` environment variable.
+Access 6 Xiaomi Token Plan (Singapore) models through Mastra's model router. Authentication is handled automatically using the `XIAOMI_API_KEY` environment variable.
 
 Learn more in the [Xiaomi Token Plan (Singapore) documentation](https://platform.xiaomimimo.com/#/docs).
 
@@ -15,7 +15,7 @@ const agent = new Agent({
   id: "my-agent",
   name: "My Agent",
   instructions: "You are a helpful assistant",
-  model: "xiaomi-token-plan-sgp/mimo-v2-omni"
+  model: "xiaomi-token-plan-sgp/mimo-v2-flash"
 });
 
 // Generate a response
@@ -34,7 +34,8 @@ for await (const chunk of stream) {
 
 | Model                                 | Context | Tools | Reasoning | Image | Audio | Video | Input $/1M | Output $/1M |
 | ------------------------------------- | ------- | ----- | --------- | ----- | ----- | ----- | ---------- | ----------- |
-| `xiaomi-token-plan-sgp/mimo-v2-omni`  | 256K    |       |           |       |       |       | —          | —           |
+| `xiaomi-token-plan-sgp/mimo-v2-flash` | 262K    |       |           |       |       |       | —          | —           |
+| `xiaomi-token-plan-sgp/mimo-v2-omni`  | 262K    |       |           |       |       |       | —          | —           |
 | `xiaomi-token-plan-sgp/mimo-v2-pro`   | 1.0M    |       |           |       |       |       | —          | —           |
 | `xiaomi-token-plan-sgp/mimo-v2-tts`   | 8K      |       |           |       |       |       | —          | —           |
 | `xiaomi-token-plan-sgp/mimo-v2.5`     | 1.0M    |       |           |       |       |       | —          | —           |
@@ -50,7 +51,7 @@ const agent = new Agent({
   name: "custom-agent",
   model: {
     url: "https://token-plan-sgp.xiaomimimo.com/v1",
-    id: "xiaomi-token-plan-sgp/mimo-v2-omni",
+    id: "xiaomi-token-plan-sgp/mimo-v2-flash",
     apiKey: process.env.XIAOMI_API_KEY,
     headers: {
       "X-Custom-Header": "value"
@@ -69,7 +70,7 @@ const agent = new Agent({
     const useAdvanced = requestContext.task === "complex";
     return useAdvanced
       ? "xiaomi-token-plan-sgp/mimo-v2.5-pro"
-      : "xiaomi-token-plan-sgp/mimo-v2-omni";
+      : "xiaomi-token-plan-sgp/mimo-v2-flash";
   }
 });
 ```

package/.docs/models/providers.md

@@ -26,11 +26,13 @@ Direct access to individual AI model providers. Each provider offers unique mode
 - [Cloudflare Workers AI](https://mastra.ai/models/providers/cloudflare-workers-ai)
 - [Cortecs](https://mastra.ai/models/providers/cortecs)
 - [D.Run (China)](https://mastra.ai/models/providers/drun)
+- [Databricks](https://mastra.ai/models/providers/databricks)
 - [Deep Infra](https://mastra.ai/models/providers/deepinfra)
 - [DigitalOcean](https://mastra.ai/models/providers/digitalocean)
 - [DInference](https://mastra.ai/models/providers/dinference)
 - [evroc](https://mastra.ai/models/providers/evroc)
 - [FastRouter](https://mastra.ai/models/providers/fastrouter)
+- [Fireworks (Firepass)](https://mastra.ai/models/providers/firepass)
 - [Fireworks AI](https://mastra.ai/models/providers/fireworks-ai)
 - [Friendli](https://mastra.ai/models/providers/friendli)
 - [FrogBot](https://mastra.ai/models/providers/frogbot)
@@ -45,7 +47,6 @@ Direct access to individual AI model providers. Each provider offers unique mode
 - [Jiekou.AI](https://mastra.ai/models/providers/jiekou)
 - [Kilo Gateway](https://mastra.ai/models/providers/kilo)
 - [Kimi For Coding](https://mastra.ai/models/providers/kimi-for-coding)
-- [Kiro](https://mastra.ai/models/providers/kiro)
 - [KUAE Cloud Coding Plan](https://mastra.ai/models/providers/kuae-cloud-coding-plan)
 - [Llama](https://mastra.ai/models/providers/llama)
 - [LLM Gateway](https://mastra.ai/models/providers/llmgateway)
@@ -80,6 +81,7 @@ Direct access to individual AI model providers. Each provider offers unique mode
 - [Qiniu](https://mastra.ai/models/providers/qiniu-ai)
 - [Regolo AI](https://mastra.ai/models/providers/regolo-ai)
 - [Requesty](https://mastra.ai/models/providers/requesty)
+- [Sarvam AI](https://mastra.ai/models/providers/sarvam)
 - [Scaleway](https://mastra.ai/models/providers/scaleway)
 - [SiliconFlow](https://mastra.ai/models/providers/siliconflow)
 - [SiliconFlow (China)](https://mastra.ai/models/providers/siliconflow-cn)

package/.docs/reference/agents/agent.md

@@ -94,6 +94,89 @@ export const agent = new Agent({
 })
 ```
 
+## Thread signals
+
+Use Agent signals to send real-time context into a memory thread. Signals are useful when a user adds input while an agent is already streaming, or when another process needs to add structured context to the thread.
+
+A `user-message` signal represents user input. When the target thread is running, Mastra delivers the signal into the active agent loop. When the thread is idle, Mastra starts a stream with the signal as the first input by default.
+
+```typescript
+const subscription = await agent.subscribeToThread({
+  resourceId: 'user-123',
+  threadId: 'thread-abc',
+})
+
+void (async () => {
+  for await (const chunk of subscription.stream) {
+    console.log(chunk)
+  }
+})()
+
+agent.sendSignal(
+  { type: 'user-message', contents: 'Use the latest customer note too.' },
+  {
+    resourceId: 'user-123',
+    threadId: 'thread-abc',
+    ifIdle: {
+      streamOptions: {
+        maxSteps: 3,
+      },
+    },
+  },
+)
+```
+
+Use a custom signal type for contextual messages that should reach the model as XML-wrapped context instead of normal user input:
+
+```typescript
+agent.sendSignal(
+  {
+    type: 'system-reminder',
+    contents: 'Continue from the previous tool result.',
+    attributes: { reminderType: 'tool-result' },
+  },
+  { resourceId: 'user-123', threadId: 'thread-abc' },
+)
+```
+
+### `sendSignal(signal, options)`
+
+Sends a signal to an active run or memory thread.
+
+**signal** (`{ type: 'user-message'; contents: MessageListInput } | { type: string; contents: string }`): \`user-message\` signals are treated as user input. Other signal types are converted to XML context before the next model call.
+
+**options.runId** (`string`): Run ID to target directly. Use this when you already know the active run ID.
+
+**options.resourceId** (`string`): Resource ID for the memory thread. Required with \`threadId\` for thread-targeted signals.
+
+**options.threadId** (`string`): Thread ID to target. Required with \`resourceId\` for thread-targeted signals.
+
+**options.ifActive.behavior** (`'deliver' | 'persist' | 'discard'`): Controls what happens when the target thread is active. Defaults to \`deliver\`.
+
+**options.ifIdle.behavior** (`'wake' | 'persist' | 'discard'`): Controls what happens when the target thread is idle. Defaults to \`wake\`.
+
+**options.ifIdle.streamOptions** (`AgentExecutionOptions`): Options for the stream that starts when \`ifIdle.behavior\` is \`wake\`. Mastra uses the top-level \`resourceId\` and \`threadId\` for memory context.
+
+Returns `{ accepted: true, runId: string, signal: CreatedAgentSignal, persisted?: Promise<void> }`. `persisted` is only present for `persist` behavior and resolves when Mastra finishes writing the signal to memory.
+
+### `subscribeToThread(options)`
+
+Subscribes to raw stream chunks for a memory thread. Use this before calling `sendSignal()` when you need to render stream output, observe signal echoes, or abort the active run.
+
+**options.resourceId** (`string`): Resource ID for the memory thread.
+
+**options.threadId** (`string`): Thread ID to subscribe to.
+
+Returns an `AgentThreadSubscription` object with these members:
+
+**stream** (`AsyncIterable<AgentChunkType>`): Raw agent stream chunks for the subscribed thread.
+
+**activeRunId** (`() => string | null`): Returns the active run ID for the thread, or \`null\` when no run is active.
+
+**abort** (`() => boolean`): Aborts the active run for the thread. Returns \`true\` when a run was aborted.
+
+**unsubscribe** (`() => void`): Stops the subscription without aborting the active run.
+
 ## Constructor parameters
 
 **id** (`string`): Unique identifier for the agent. Defaults to \`name\` if not provided.
@@ -110,6 +193,8 @@ export const agent = new Agent({
 
 **tools** (`ToolsInput | ({ requestContext: RequestContext }) => ToolsInput | Promise<ToolsInput>`): Tools that the agent can access. Can be provided statically or resolved dynamically.
 
+**transform** (`ToolPayloadTransformPolicy`): Shared policy for transforming tool payloads before display streams or user-visible transcript messages receive them. Use per-tool \`transform\` on \`createTool()\` for tool-local rules.
+
 **workflows** (`Record<string, Workflow> | ({ requestContext: RequestContext }) => Record<string, Workflow> | Promise<Record<string, Workflow>>`): Workflows that the agent can execute. Can be static or dynamically resolved.
 
 **defaultOptions** (`AgentExecutionOptions | ({ requestContext: RequestContext }) => AgentExecutionOptions | Promise<AgentExecutionOptions>`): Default options used when calling \`stream()\` and \`generate()\`.

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

@@ -44,22 +44,25 @@ then interact with elements using their refs (e.g., @e5).`,
 
 **screencast** (`ScreencastOptions`): Configuration for streaming browser frames to Studio.
 
+**excludeTools** (`BrowserToolName[]`): Tool names to exclude from the browser toolset. Use this to disable specific tools for models that do not support certain capabilities, such as vision.
+
 ## Tools
 
-`AgentBrowser` provides 15 deterministic tools for browser automation. All tools that interact with elements use refs from the accessibility tree snapshot.
+`AgentBrowser` provides 16 deterministic tools for browser automation. All tools that interact with elements use refs from the accessibility tree snapshot.
 
 ### Core tools
 
-| Tool               | Description                                       |
-| ------------------ | ------------------------------------------------- |
-| `browser_goto`     | Navigate to a URL                                 |
-| `browser_snapshot` | Get accessibility tree snapshot with element refs |
-| `browser_click`    | Click an element by ref                           |
-| `browser_type`     | Type text into an element                         |
-| `browser_press`    | Press keyboard keys                               |
-| `browser_select`   | Select option from dropdown                       |
-| `browser_scroll`   | Scroll the page or element                        |
-| `browser_close`    | Close the browser                                 |
+| Tool                 | Description                                                                           |
+| -------------------- | ------------------------------------------------------------------------------------- |
+| `browser_goto`       | Navigate to a URL                                                                     |
+| `browser_snapshot`   | Get accessibility tree snapshot with element refs                                     |
+| `browser_click`      | Click an element by ref                                                               |
+| `browser_type`       | Type text into an element                                                             |
+| `browser_press`      | Press keyboard keys                                                                   |
+| `browser_select`     | Select option from dropdown                                                           |
+| `browser_scroll`     | Scroll the page or element                                                            |
+| `browser_screenshot` | Capture a screenshot as PNG (viewport by default; set `fullPage: true` for full page) |
+| `browser_close`      | Close the browser                                                                     |
 
 ### Extended tools
 
@@ -73,6 +76,14 @@ then interact with elements using their refs (e.g., @e5).`,
 | `browser_drag`     | Drag and drop elements                          |
 | `browser_evaluate` | Execute JavaScript in the page (escape hatch)   |
 
+To exclude specific tools, pass `excludeTools` in the constructor:
+
+```typescript
+const browser = new AgentBrowser({
+  excludeTools: ['browser_screenshot'],
+})
+```
+
 ## Tool reference
 
 ### `browser_goto`
@@ -339,6 +350,21 @@ Execute JavaScript in the page context. Use as an escape hatch when other tools
 | `script`      | `string`  | JavaScript to execute (required)        |
 | `returnValue` | `boolean` | Whether to return the result (optional) |
 
+### `browser_screenshot`
+
+Capture a screenshot of the current page as PNG (viewport by default; set `fullPage: true` for full-page capture). Returns image content that vision-capable models can interpret directly. Use `browser_snapshot` when you only need text or structured data.
+
+```text
+// Viewport only (default)
+
+// Full scrollable page
+{ "fullPage": true }
+```
+
+| Parameter  | Type      | Description                                                                              |
+| ---------- | --------- | ---------------------------------------------------------------------------------------- |
+| `fullPage` | `boolean` | Capture the full scrollable page instead of just the viewport (optional, default: false) |
+
 ### `browser_close`
 
 Close the browser and clean up resources.

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

@@ -61,18 +61,29 @@ Use stagehand_extract to get data from pages.`,
 
 **screencast** (`ScreencastOptions`): Configuration for streaming browser frames to Studio.
 
+**excludeTools** (`StagehandToolName[]`): Tool names to exclude from the browser toolset. Use this to disable specific tools for models that do not support certain capabilities, such as vision.
+
 ## Tools
 
-`StagehandBrowser` provides 6 AI-powered tools for browser automation:
+`StagehandBrowser` provides 7 AI-powered tools for browser automation:
+
+| Tool                   | Description                                                                           |
+| ---------------------- | ------------------------------------------------------------------------------------- |
+| `stagehand_act`        | Perform actions using natural language instructions                                   |
+| `stagehand_extract`    | Extract structured data from pages                                                    |
+| `stagehand_observe`    | Discover actionable elements on a page                                                |
+| `stagehand_navigate`   | Navigate to a URL                                                                     |
+| `stagehand_tabs`       | Manage browser tabs                                                                   |
+| `stagehand_screenshot` | Capture a screenshot as PNG (viewport by default; set `fullPage: true` for full page) |
+| `stagehand_close`      | Close the browser                                                                     |
 
-| Tool                 | Description                                         |
-| -------------------- | --------------------------------------------------- |
-| `stagehand_act`      | Perform actions using natural language instructions |
-| `stagehand_extract`  | Extract structured data from pages                  |
-| `stagehand_observe`  | Discover actionable elements on a page              |
-| `stagehand_navigate` | Navigate to a URL                                   |
-| `stagehand_tabs`     | Manage browser tabs                                 |
-| `stagehand_close`    | Close the browser                                   |
+To exclude specific tools, pass `excludeTools` in the constructor:
+
+```typescript
+const browser = new StagehandBrowser({
+  excludeTools: ['stagehand_screenshot'],
+})
+```
 
 ## Tool reference
 
@@ -224,6 +235,21 @@ Manage browser tabs.
 { "action": "close", "index": 1 }
 ```
 
+### `stagehand_screenshot`
+
+Capture a screenshot of the current page as PNG (viewport by default; set `fullPage: true` for full-page capture). Returns image content that vision-capable models can interpret directly. Use `stagehand_observe` or `stagehand_extract` when you only need text or structured data.
+
+```text
+// Viewport only (default)
+
+// Full scrollable page
+{ "fullPage": true }
+```
+
+| Parameter  | Type      | Description                                                                              |
+| ---------- | --------- | ---------------------------------------------------------------------------------------- |
+| `fullPage` | `boolean` | Capture the full scrollable page instead of just the viewport (optional, default: false) |
+
 ### `stagehand_close`
 
 Close the browser and clean up resources.