docs: regenerate tool reference with new parameters

- maxWidth, maxHeight for take_screenshot
- maxLength, selector for take_snapshot
- Format fixes from prettier

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

Author: semikolon

README.md

@@ -335,11 +335,13 @@ This fork includes token optimization features inspired by [fast-playwright-mcp]
 Use the following parameters with `take_snapshot` to reduce token usage:
 
 **Truncation** - Limit output to a maximum number of characters:
+
 ```
 Take a snapshot with maxLength of 5000 characters
 ```
 
 **CSS Selector Filtering** - Focus on a specific part of the page:
+
 ```
 Take a snapshot with selector "#main-content"
 ```
@@ -358,15 +360,15 @@ Images are resized maintaining aspect ratio (using sharp library). This reduces
 
 ### Additional Parameters
 
-| Tool | Parameter | Description |
-|------|-----------|-------------|
-| `take_snapshot` | `maxLength` | Maximum characters (truncates with notice) |
-| `take_snapshot` | `selector` | CSS selector to limit scope |
-| `take_snapshot` | `verbose` | Include all a11y tree info (default: false) |
-| `take_screenshot` | `maxWidth` | Maximum width in pixels |
-| `take_screenshot` | `maxHeight` | Maximum height in pixels |
-| `take_screenshot` | `quality` | JPEG/WebP quality 0-100 |
-| `take_screenshot` | `format` | png, jpeg, or webp |
+| Tool              | Parameter   | Description                                 |
+| ----------------- | ----------- | ------------------------------------------- |
+| `take_snapshot`   | `maxLength` | Maximum characters (truncates with notice)  |
+| `take_snapshot`   | `selector`  | CSS selector to limit scope                 |
+| `take_snapshot`   | `verbose`   | Include all a11y tree info (default: false) |
+| `take_screenshot` | `maxWidth`  | Maximum width in pixels                     |
+| `take_screenshot` | `maxHeight` | Maximum height in pixels                    |
+| `take_screenshot` | `quality`   | JPEG/WebP quality 0-100                     |
+| `take_screenshot` | `format`    | png, jpeg, or webp                          |
 
 See `src/expectation.ts` for the full expectation schema and tool defaults.
 

docs/tool-reference.md

@@ -340,6 +340,8 @@ so returned values have to JSON-serializable.
 - **filePath** (string) _(optional)_: The absolute path, or a path relative to the current working directory, to save the screenshot to instead of attaching it to the response.
 - **format** (enum: "png", "jpeg", "webp") _(optional)_: Type of format to save the screenshot as. Default is "png"
 - **fullPage** (boolean) _(optional)_: If set to true takes a screenshot of the full page instead of the currently visible viewport. Incompatible with uid.
+- **maxHeight** (number) _(optional)_: Maximum height in pixels. Image will be resized (maintaining aspect ratio) if larger. Useful for token efficiency.
+- **maxWidth** (number) _(optional)_: Maximum width in pixels. Image will be resized (maintaining aspect ratio) if larger. Useful for token efficiency.
 - **quality** (number) _(optional)_: Compression quality for JPEG and WebP formats (0-100). Higher values mean better quality but larger file sizes. Ignored for PNG format.
 - **uid** (string) _(optional)_: The uid of an element on the page from the page content snapshot. If omitted takes a pages screenshot.
 
@@ -354,6 +356,8 @@ in the DevTools Elements panel (if any).
 **Parameters:**
 
 - **filePath** (string) _(optional)_: The absolute path, or a path relative to the current working directory, to save the snapshot to instead of attaching it to the response.
+- **maxLength** (number) _(optional)_: Maximum characters for snapshot output. If exceeded, output is truncated with a notice. Useful for token efficiency.
+- **selector** (string) _(optional)_: CSS selector to limit snapshot scope. Only the subtree rooted at the matching element will be included. Useful for focusing on specific page sections.
 - **verbose** (boolean) _(optional)_: Whether to include all possible information available in the full a11y tree. Default is false.
 
 ---

src/expectation.ts

@@ -18,7 +18,9 @@ export const snapshotOptionsSchema = zod
     selector: zod
       .string()
       .optional()
-      .describe('CSS selector to limit snapshot scope (e.g., ".main-content", "form")'),
+      .describe(
+        'CSS selector to limit snapshot scope (e.g., ".main-content", "form")',
+      ),
     maxLength: zod
       .number()
       .optional()
@@ -61,30 +63,34 @@ export const imageOptionsSchema = zod
  * Schema for expectation configuration that controls response content.
  * All options default to false for maximum token efficiency.
  */
-export const expectationSchema = zod.object({
-  includeSnapshot: zod
-    .boolean()
-    .optional()
-    .default(false)
-    .describe('Include accessibility tree snapshot (false saves ~40% tokens)'),
-  includeConsole: zod
-    .boolean()
-    .optional()
-    .default(false)
-    .describe('Include console messages'),
-  includeNetwork: zod
-    .boolean()
-    .optional()
-    .default(false)
-    .describe('Include network requests'),
-  includeTabs: zod
-    .boolean()
-    .optional()
-    .default(false)
-    .describe('Include tab/page information'),
-  snapshotOptions: snapshotOptionsSchema,
-  imageOptions: imageOptionsSchema,
-}).optional();
+export const expectationSchema = zod
+  .object({
+    includeSnapshot: zod
+      .boolean()
+      .optional()
+      .default(false)
+      .describe(
+        'Include accessibility tree snapshot (false saves ~40% tokens)',
+      ),
+    includeConsole: zod
+      .boolean()
+      .optional()
+      .default(false)
+      .describe('Include console messages'),
+    includeNetwork: zod
+      .boolean()
+      .optional()
+      .default(false)
+      .describe('Include network requests'),
+    includeTabs: zod
+      .boolean()
+      .optional()
+      .default(false)
+      .describe('Include tab/page information'),
+    snapshotOptions: snapshotOptionsSchema,
+    imageOptions: imageOptionsSchema,
+  })
+  .optional();
 
 export type ExpectationOptions = zod.infer<typeof expectationSchema>;
 export type SnapshotOptions = zod.infer<typeof snapshotOptionsSchema>;
@@ -328,7 +334,8 @@ export function mergeExpectations(
     return defaults;
   }
   return {
-    includeSnapshot: userExpectation.includeSnapshot ?? defaults.includeSnapshot,
+    includeSnapshot:
+      userExpectation.includeSnapshot ?? defaults.includeSnapshot,
     includeConsole: userExpectation.includeConsole ?? defaults.includeConsole,
     includeNetwork: userExpectation.includeNetwork ?? defaults.includeNetwork,
     includeTabs: userExpectation.includeTabs ?? defaults.includeTabs,

src/tools/screenshot.ts

@@ -120,7 +120,10 @@ export const screenshot = defineTool({
     }
 
     if (request.params.filePath) {
-      const file = await context.saveFile(screenshotData, request.params.filePath);
+      const file = await context.saveFile(
+        screenshotData,
+        request.params.filePath,
+      );
       response.appendResponseLine(`Saved screenshot to ${file.filename}.`);
     } else if (screenshotData.length >= 2_000_000) {
       const {filename} = await context.saveTemporaryFile(

src/utils/image-processor.ts

@@ -61,7 +61,11 @@ export async function processImage(
     // Apply format and quality options
     let outputMimeType = mimeType;
     if (options.format) {
-      const result = applyFormatConversion(image, options.format, options.quality);
+      const result = applyFormatConversion(
+        image,
+        options.format,
+        options.quality,
+      );
       image = result.image;
       outputMimeType = result.mimeType;
     } else if (options.quality) {

tests/formatters/snapshotFormatter.test.ts

@@ -318,10 +318,9 @@ describe('snapshotFormatter', () => {
         elementHandle: async () => null,
       };
 
-      const formatter = new SnapshotFormatter(
-        {root: node} as TextSnapshot,
-        {maxLength: 50},
-      );
+      const formatter = new SnapshotFormatter({root: node} as TextSnapshot, {
+        maxLength: 50,
+      });
       const formatted = formatter.toString();
 
       assert.ok(formatted.length <= 50);
@@ -337,10 +336,9 @@ describe('snapshotFormatter', () => {
         elementHandle: async () => null,
       };
 
-      const formatter = new SnapshotFormatter(
-        {root: node} as TextSnapshot,
-        {maxLength: 1000},
-      );
+      const formatter = new SnapshotFormatter({root: node} as TextSnapshot, {
+        maxLength: 1000,
+      });
       const formatted = formatter.toString();
 
       assert.ok(!formatted.includes('[truncated'));

tests/utils/image-processor.test.ts

@@ -5,7 +5,7 @@
  */
 
 import assert from 'node:assert';
-import {describe, it, before} from 'node:test';
+import {describe, it} from 'node:test';
 
 import sharp from 'sharp';
 
@@ -44,7 +44,10 @@ describe('image-processor', () => {
       assert.strictEqual(result.mimeType, 'image/png');
       assert.strictEqual(result.compressionRatio, 1.0);
       assert.strictEqual(result.originalSize.width, result.processedSize.width);
-      assert.strictEqual(result.originalSize.height, result.processedSize.height);
+      assert.strictEqual(
+        result.originalSize.height,
+        result.processedSize.height,
+      );
     });
 
     it('returns original image when empty options provided', async () => {