@tontoko/fast-playwright-mcp 0.0.9 → 0.1.1

package/README.md

@@ -1,4 +1,7 @@
-## Playwright MCP
+## **Fast** Playwright MCP
+
+This MCP server is a fork of the Microsoft one.
+<https://github.com/microsoft/playwright-mcp>
 
 A Model Context Protocol (MCP) server that provides browser automation capabilities using [Playwright](https://playwright.dev). This server enables LLMs to interact with web pages through structured accessibility snapshots, bypassing the need for screenshots or visually-tuned models.
 
@@ -15,10 +18,6 @@ A Model Context Protocol (MCP) server that provides browser automation capabilit
   - `includeSnapshot: false` - Skip page snapshot for minimal responses (70-80% token reduction)
   - `includeConsole: false` - Exclude console messages
   - `includeTabs: false` - Hide tab information
-- **Ultra-Compact Tool Descriptions**. One-line tool descriptions with full parameter details:
-  - 70-80% reduction in tool description tokens
-  - All expectation parameters inline without formatting overhead
-  - Smart tips for efficient usage (e.g., "Use selector to focus on specific area")
 - **Image Compression**. Screenshot tool supports `imageOptions`:
   - `format: 'jpeg'` - Use JPEG instead of PNG
   - `quality: 1-100` - Compress images (e.g., 50 for 50% quality)

package/lib/schemas/expectation.js

@@ -20,22 +20,22 @@ var __require = /* @__PURE__ */ createRequire(import.meta.url);
 // src/schemas/expectation.ts
 import { z } from "zod";
 var diffOptionsSchema = z.object({
-  enabled: z.boolean().default(false),
+  enabled: z.boolean().default(false).describe("Show only changes (saves ~80% tokens)"),
   threshold: z.number().min(0).max(1).default(0.1),
-  format: z.enum(["unified", "split", "minimal"]).default("unified"),
+  format: z.enum(["unified", "split", "minimal"]).default("unified").describe('Diff format ("minimal" for smallest output)'),
   maxDiffLines: z.number().positive().default(50),
   ignoreWhitespace: z.boolean().default(true),
   context: z.number().min(0).default(3)
 }).optional();
 var expectationSchema = z.object({
-  includeSnapshot: z.boolean().optional().default(false),
+  includeSnapshot: z.boolean().optional().default(false).describe("Include accessibility tree (false for chained actions)"),
   includeConsole: z.boolean().optional().default(false),
   includeDownloads: z.boolean().optional().default(false),
   includeTabs: z.boolean().optional().default(false),
   includeCode: z.boolean().optional().default(false),
   snapshotOptions: z.object({
-    selector: z.string().optional().describe("CSS selector to limit snapshot scope"),
-    maxLength: z.number().optional().describe("Maximum characters for snapshot"),
+    selector: z.string().optional().describe('CSS selector to limit scope (e.g., ".result", "form")'),
+    maxLength: z.number().optional().describe("Max snapshot characters"),
     format: z.enum(["aria", "text", "html"]).optional().default("aria")
   }).optional(),
   consoleOptions: z.object({

package/lib/tools/batch-execute.js

@@ -26,7 +26,7 @@ var batchExecuteTool = defineTool({
   schema: {
     name: "browser_batch_execute",
     title: "Batch Execute Browser Actions",
-    description: `Execute multiple browser actions in sequence with optimized response handling.RECOMMENDED:Use this tool instead of individual actions when performing multiple operations to significantly reduce token usage and improve performance.BY DEFAULT use for:form filling(multiple type→click),multi-step navigation,any workflow with 2+ known steps.Saves 90% tokens vs individual calls.globalExpectation:{includeSnapshot:false,snapshotOptions:{selector:"#app"},diffOptions:{enabled:true}}.Per-step override:steps[].expectation.Example:[{tool:"browser_navigate",arguments:{url:"https://example.com"}},{tool:"browser_type",arguments:{element:"username",ref:"#user",text:"john"}},{tool:"browser_click",arguments:{element:"submit",ref:"#btn"}}].Tool names must match exactly(e.g.browser_navigate,browser_click,browser_type).`,
+    description: "Execute multiple browser actions in sequence. PREFER over individual tools for 2+ operations.",
     inputSchema: batchExecuteSchema,
     type: "destructive"
   },

package/lib/tools/dialogs.js

@@ -26,11 +26,11 @@ var handleDialog = defineTabTool({
   schema: {
     name: "browser_handle_dialog",
     title: "Handle a dialog",
-    description: `Handle a dialog(alert,confirm,prompt).accept:true to accept,false to dismiss.promptText:"answer" for prompt dialogs.expectation:{includeSnapshot:true} to see page after dialog handling.USE batch_execute if dialog appears during workflow.`,
+    description: "Handle a dialog (alert, confirm, prompt)",
     inputSchema: z.object({
-      accept: z.boolean().describe("Whether to accept the dialog."),
-      promptText: z.string().optional().describe("The text of the prompt in case of a prompt dialog."),
-      expectation: expectationSchema
+      accept: z.boolean().describe("Accept (true) or dismiss (false)"),
+      promptText: z.string().optional().describe("Text for prompt dialogs"),
+      expectation: expectationSchema.describe("Page state after dialog. Use batch_execute for workflows")
     }),
     type: "destructive"
   },

package/lib/tools/evaluate.js

@@ -24,17 +24,17 @@ import { quote } from "../utils/codegen.js";
 import { defineTabTool } from "./tool.js";
 import { generateLocator } from "./utils.js";
 var evaluateSchema = z.object({
-  function: z.string().describe("() => { /* code */ } or (element) => { /* code */ } when element is provided"),
+  function: z.string().describe("JS function: () => {...} or (element) => {...}"),
   element: z.string().optional().describe("Human-readable element description used to obtain permission to interact with the element"),
   ref: z.string().optional().describe('System-generated element ID from previous tool results (e.g., "rNODE-45-1"). Never use custom values.'),
-  expectation: expectationSchema
+  expectation: expectationSchema.describe("Page state config. false for data extraction, true for DOM changes")
 });
 var evaluate = defineTabTool({
   capability: "core",
   schema: {
     name: "browser_evaluate",
     title: "Evaluate JavaScript",
-    description: "Evaluate JavaScript expression on page or element.Returns evaluation result.USE CASES:extract data,modify DOM,trigger events.expectation:{includeSnapshot:false} for data extraction,true if modifying page.element+ref to run on specific element.CONSIDER batch_execute for multiple evaluations.",
+    description: "Evaluate JavaScript expression on page or element and return result",
     inputSchema: evaluateSchema,
     type: "destructive"
   },

package/lib/tools/files.js

@@ -26,10 +26,10 @@ var uploadFile = defineTabTool({
   schema: {
     name: "browser_file_upload",
     title: "Upload files",
-    description: `Upload one or multiple files to file input.paths:["/path/file1.jpg","/path/file2.pdf"] for multiple files.expectation:{includeSnapshot:true,snapshotOptions:{selector:"form"}} to verify upload.Must be triggered after file input interaction.USE batch_execute for click→upload workflows.`,
+    description: "Upload one or multiple files to file input",
     inputSchema: z.object({
-      paths: z.array(z.string()).describe("The absolute paths to the files to upload. Can be a single file or multiple files."),
-      expectation: expectationSchema
+      paths: z.array(z.string()).describe("Absolute paths to upload (array)"),
+      expectation: expectationSchema.describe("Page state config. Use batch_execute for click→upload")
     }),
     type: "destructive"
   },

package/lib/tools/keyboard.js

@@ -30,10 +30,10 @@ var pressKey = defineTabTool({
   schema: {
     name: "browser_press_key",
     title: "Press a key",
-    description: "Press a key on the keyboard.Common keys:Enter,Escape,ArrowUp/Down/Left/Right,Tab,Backspace.expectation:{includeSnapshot:false} for navigation keys,true for content changes.CONSIDER batch_execute for multiple key presses.",
+    description: "Press a key on the keyboard",
     inputSchema: z.object({
-      key: z.string().describe("Name of the key to press or a character to generate, such as `ArrowLeft` or `a`"),
-      expectation: expectationSchema
+      key: z.string().describe("Key to press"),
+      expectation: expectationSchema.describe("Page state config. Use batch_execute for multiple keys")
     }),
     type: "destructive"
   },
@@ -51,18 +51,18 @@ var pressKey = defineTabTool({
 });
 var typeSchema = elementSchema.extend({
   element: z.string().describe("Human-readable element description used to obtain permission to interact with the element"),
-  ref: z.string().describe('System-generated element ID from previous tool results (e.g., "rNODE-45-1"). Never use custom values.'),
-  text: z.string().describe("Text to type into the element"),
-  submit: z.boolean().optional().describe("Whether to submit entered text (press Enter after)"),
-  slowly: z.boolean().optional().describe("Whether type one character at a time. Useful for triggering key handlers in the page. By default entire text is filled in at once."),
-  expectation: expectationSchema
+  ref: z.string().describe("System-generated element ID from previous tool results. Never use custom values."),
+  text: z.string(),
+  submit: z.boolean().optional().describe("Press Enter after typing if true"),
+  slowly: z.boolean().optional().describe("Type slowly for auto-complete if true"),
+  expectation: expectationSchema.describe("Page state config. Use batch_execute for forms")
 });
 var type = defineTabTool({
   capability: "core",
   schema: {
     name: "browser_type",
     title: "Type text",
-    description: `Type text into editable element.FOR FORMS:Use batch_execute to fill multiple fields efficiently.slowly:true for auto-complete fields,submit:true to press Enter after.expectation:{includeSnapshot:false} when filling multiple fields(use batch),true for final verification.snapshotOptions:{selector:"form"} to focus on form only.diffOptions:{enabled:true} shows only what changed in form.`,
+    description: "Type text into editable element",
     inputSchema: typeSchema,
     type: "destructive"
   },

package/lib/tools/mouse.js

@@ -54,11 +54,11 @@ var mouseClick = defineTabTool({
   schema: {
     name: "browser_mouse_click_xy",
     title: "Click",
-    description: "Click at specific coordinates.Requires --caps=vision.x,y:click position.expectation:{includeSnapshot:true} to verify result.PREFER browser_click with element ref over coordinates.USE batch_execute for coordinate-based workflows.",
+    description: "Click at specific coordinates",
     inputSchema: elementSchema.extend({
-      x: z.number().describe("X coordinate"),
-      y: z.number().describe("Y coordinate"),
-      expectation: expectationSchema
+      x: z.number().describe("X coordinate (requires --caps=vision)"),
+      y: z.number().describe("Y coordinate (requires --caps=vision)"),
+      expectation: expectationSchema.describe("Page state after click. Prefer element ref over coords")
     }),
     type: "destructive"
   },
@@ -81,13 +81,13 @@ var mouseDrag = defineTabTool({
   schema: {
     name: "browser_mouse_drag_xy",
     title: "Drag mouse",
-    description: `Drag from one coordinate to another.Requires --caps=vision.startX,startY→endX,endY.expectation:{includeSnapshot:true,snapshotOptions:{selector:".drop-zone"}} to verify.PREFER browser_drag with element refs over coordinates.`,
+    description: "Drag from one coordinate to another",
     inputSchema: elementSchema.extend({
-      startX: z.number().describe("Start X coordinate"),
-      startY: z.number().describe("Start Y coordinate"),
-      endX: z.number().describe("End X coordinate"),
-      endY: z.number().describe("End Y coordinate"),
-      expectation: expectationSchema
+      startX: z.number().describe("Start X (requires --caps=vision)"),
+      startY: z.number().describe("Start Y (requires --caps=vision)"),
+      endX: z.number().describe("End X"),
+      endY: z.number().describe("End Y"),
+      expectation: expectationSchema.describe("Page state after drag. Prefer element refs over coords")
     }),
     type: "destructive"
   },

package/lib/tools/navigate.js

@@ -31,10 +31,10 @@ var navigate = defineTool({
   schema: {
     name: "browser_navigate",
     title: "Navigate to a URL",
-    description: `Navigate to a URL.expectation:{includeSnapshot:true} to see what loaded,false if you know what to do next.snapshotOptions:{selector:"#content"} to focus on main content(saves 50% tokens).diffOptions:{enabled:true} when revisiting pages to see only changes.CONSIDER batch_execute for navigate→interact workflows.`,
+    description: "Navigate to a URL",
     inputSchema: z.object({
       url: z.string().describe("The URL to navigate to"),
-      expectation: expectationSchema
+      expectation: expectationSchema.describe("Page state after navigation")
     }),
     type: "destructive"
   },
@@ -48,10 +48,10 @@ var goBack = defineTabTool({
   capability: "core",
   schema: {
     name: "browser_navigate_back",
-    title: "Go back",
-    description: "Go back to previous page.expectation:{includeSnapshot:true} to see previous page,false if continuing workflow.diffOptions:{enabled:true} shows only what changed from forward page.USE batch_execute for back→interact sequences.",
+    title: "Go back to previous page",
+    description: "Go back to previous page",
     inputSchema: z.object({
-      expectation: expectationSchema
+      expectation: expectationSchema.describe("Page state after going back")
     }),
     type: "readOnly"
   },
@@ -64,10 +64,10 @@ var goForward = defineTabTool({
   capability: "core",
   schema: {
     name: "browser_navigate_forward",
-    title: "Go forward",
-    description: "Go forward to next page.expectation:{includeSnapshot:true} to see next page,false if continuing workflow.diffOptions:{enabled:true} shows only what changed from previous page.USE batch_execute for forward→interact sequences.",
+    title: "Go forward to next page",
+    description: "Go forward to next page",
     inputSchema: z.object({
-      expectation: expectationSchema
+      expectation: expectationSchema.describe("Page state after going forward")
     }),
     type: "readOnly"
   },

package/lib/tools/network.js

@@ -24,22 +24,22 @@ import {
 } from "../utils/network-filter.js";
 import { defineTabTool } from "./tool.js";
 var networkFilterSchema = z.object({
-  urlPatterns: z.array(z.string()).optional(),
-  excludeUrlPatterns: z.array(z.string()).optional(),
+  urlPatterns: z.array(z.string()).optional().describe("URL patterns to filter (supports regex)"),
+  excludeUrlPatterns: z.array(z.string()).optional().describe("URL patterns to exclude (takes precedence)"),
   statusRanges: z.array(z.object({
-    min: z.number(),
-    max: z.number()
-  })).optional(),
-  methods: z.array(z.string()).optional(),
-  maxRequests: z.number().default(20),
-  newestFirst: z.boolean().default(true)
+    min: z.number().describe("Minimum status code"),
+    max: z.number().describe("Maximum status code")
+  })).optional().describe("Status code ranges (e.g., [{min:200,max:299}])"),
+  methods: z.array(z.string()).optional().describe("HTTP methods to filter"),
+  maxRequests: z.number().default(20).describe("Max requests to return (default: 20)"),
+  newestFirst: z.boolean().default(true).describe("Order by timestamp (default: newest first)")
 });
 var requests = defineTabTool({
   capability: "core",
   schema: {
     name: "browser_network_requests",
     title: "List network requests",
-    description: 'Returns network requests since loading the page with optional filtering. urlPatterns:["api/users"] to filter by URL patterns. excludeUrlPatterns:["analytics"] to exclude specific patterns. statusRanges:[{min:200,max:299}] for success codes only. methods:["GET","POST"] to filter by HTTP method. maxRequests:10 to limit results. newestFirst:false for chronological order. Supports regex patterns for advanced filtering.',
+    description: "Returns network requests since loading the page with optional filtering",
     inputSchema: networkFilterSchema.partial(),
     type: "readOnly"
   },

package/lib/tools/screenshot.js

@@ -29,7 +29,7 @@ var screenshotSchema = z.object({
   element: z.string().optional().describe("Human-readable element description used to obtain permission to screenshot the element. If not provided, the screenshot will be taken of viewport. If element is provided, ref must be provided too."),
   ref: z.string().optional().describe('System-generated element ID from previous tool results (e.g., "rNODE-45-1"). Never use custom values. If not provided, the screenshot will be taken of viewport. If ref is provided, element must be provided too.'),
   fullPage: z.boolean().optional().describe("When true, takes a screenshot of the full scrollable page, instead of the currently visible viewport. Cannot be used with element screenshots."),
-  expectation: expectationSchema
+  expectation: expectationSchema.describe("Additional page state config")
 }).refine((data) => {
   return !!data.element === !!data.ref;
 }, {
@@ -84,7 +84,7 @@ var screenshot = defineTabTool({
   schema: {
     name: "browser_take_screenshot",
     title: "Take a screenshot",
-    description: `Take a screenshot of current page.Returns image data.expectation:{includeSnapshot:false} to avoid redundant accessibility tree(screenshot≠snapshot).imageOptions:{quality:50,format:"jpeg"} for 70% size reduction.fullPage:true for entire page,element+ref for specific element.USE CASES:visual verification,documentation,error capture.`,
+    description: "Take a screenshot of current page and return image data",
     inputSchema: screenshotSchema,
     type: "readOnly"
   },

package/lib/tools/snapshot.js

@@ -28,9 +28,9 @@ var snapshot = defineTool({
   schema: {
     name: "browser_snapshot",
     title: "Page snapshot",
-    description: `Capture accessibility snapshot of current page.AVOID calling directly - use expectation:{includeSnapshot:true} on other tools instead.USE CASES:Initial page inspection,debugging when other tools didn't capture needed info.snapshotOptions:{selector:"#content"} to focus on specific area.`,
+    description: "Capture accessibility snapshot of current page",
     inputSchema: z.object({
-      expectation: expectationSchema
+      expectation: expectationSchema.describe("Page state config")
     }),
     type: "readOnly"
   },
@@ -47,19 +47,19 @@ var snapshot = defineTool({
 });
 var elementSchema = z.object({
   element: z.string().describe("Human-readable element description used to obtain permission to interact with the element"),
-  ref: z.string().describe('System-generated element ID from previous tool results (e.g., "rNODE-45-1"). Never use custom values.')
+  ref: z.string().describe("System-generated element ID from previous tool results. Never use custom values.")
 });
 var clickSchema = elementSchema.extend({
-  doubleClick: z.boolean().optional().describe("Whether to perform a double click instead of a single click"),
-  button: z.enum(["left", "right", "middle"]).optional().describe("Button to click, defaults to left"),
-  expectation: expectationSchema
+  doubleClick: z.boolean().optional().describe("Double-click if true"),
+  button: z.enum(["left", "right", "middle"]).optional().describe("Mouse button (default: left)"),
+  expectation: expectationSchema.describe("Page state capture config. Use batch_execute for multi-clicks")
 });
 var click = defineTabTool({
   capability: "core",
   schema: {
     name: "browser_click",
-    title: "Click",
-    description: `Perform click on web page.USE batch_execute for multi-click workflows.expectation:{includeSnapshot:false} when next action follows immediately,true to verify result.diffOptions:{enabled:true,format:"minimal"} shows only changes(saves 80% tokens).snapshotOptions:{selector:".result"} to focus on result area.doubleClick:true for double-click,button:"right" for context menu.`,
+    title: "Perform click on web page",
+    description: "Perform click on web page",
     inputSchema: clickSchema,
     type: "destructive"
   },
@@ -90,13 +90,13 @@ var drag = defineTabTool({
   schema: {
     name: "browser_drag",
     title: "Drag mouse",
-    description: `Perform drag and drop between two elements.expectation:{includeSnapshot:true,snapshotOptions:{selector:".drop-zone"}} to verify drop result.diffOptions:{enabled:true} shows only what moved.CONSIDER batch_execute if part of larger workflow.`,
+    description: "Perform drag and drop between two elements",
     inputSchema: z.object({
       startElement: z.string().describe("Human-readable source element description used to obtain the permission to interact with the element"),
-      startRef: z.string().describe('System-generated source element ID from previous tool results (e.g., "rNODE-45-1"). Never use custom values.'),
+      startRef: z.string().describe("System-generated source element ID from previous tool results. Never use custom values."),
       endElement: z.string().describe("Human-readable target element description used to obtain the permission to interact with the element"),
-      endRef: z.string().describe('System-generated target element ID from previous tool results (e.g., "rNODE-45-1"). Never use custom values.'),
-      expectation: expectationSchema
+      endRef: z.string().describe("System-generated target element ID from previous tool results. Never use custom values."),
+      expectation: expectationSchema.describe("Page state after drag. Use batch_execute for workflows")
     }),
     type: "destructive"
   },
@@ -116,9 +116,9 @@ var hover = defineTabTool({
   schema: {
     name: "browser_hover",
     title: "Hover mouse",
-    description: `Hover over element on page.expectation:{includeSnapshot:true} to capture tooltips/dropdown menus,false for simple hover.snapshotOptions:{selector:".tooltip"} to focus on tooltip area.Often followed by click - use batch_execute for hover→click sequences.`,
+    description: "Hover over element on page",
     inputSchema: elementSchema.extend({
-      expectation: expectationSchema
+      expectation: expectationSchema.describe("Page state after hover. Use batch_execute for hover→click")
     }),
     type: "readOnly"
   },
@@ -131,15 +131,15 @@ var hover = defineTabTool({
   }
 });
 var selectOptionSchema = elementSchema.extend({
-  values: z.array(z.string()).describe("Array of values to select in the dropdown. This can be a single value or multiple values."),
-  expectation: expectationSchema
+  values: z.array(z.string()).describe("Values to select (array)"),
+  expectation: expectationSchema.describe("Page state after selection. Use batch_execute for forms")
 });
 var selectOption = defineTabTool({
   capability: "core",
   schema: {
     name: "browser_select_option",
     title: "Select option",
-    description: `Select option in dropdown.values:["option1","option2"] for multi-select.expectation:{includeSnapshot:false} when part of form filling(use batch),true to verify selection.snapshotOptions:{selector:"form"} for form context.USE batch_execute for form workflows with multiple selects.`,
+    description: "Select option in dropdown",
     inputSchema: selectOptionSchema,
     type: "destructive"
   },

package/lib/tools/tabs.js

@@ -26,9 +26,9 @@ var listTabs = defineTool({
   schema: {
     name: "browser_tab_list",
     title: "List tabs",
-    description: "List browser tabs.Always returns tab list with titles and URLs.expectation:{includeSnapshot:false} for just tab info,true to also see current tab content.USE before tab_select to find right tab.",
+    description: "List browser tabs with titles and URLs",
     inputSchema: z.object({
-      expectation: expectationSchema
+      expectation: expectationSchema.describe("Page state config")
     }),
     type: "readOnly"
   },
@@ -42,10 +42,10 @@ var selectTab = defineTool({
   schema: {
     name: "browser_tab_select",
     title: "Select a tab",
-    description: `Select a tab by index.expectation:{includeSnapshot:true} to see selected tab content,false if you know what's there.USE batch_execute for tab_select→interact workflows.`,
+    description: "Select a tab by index",
     inputSchema: z.object({
       index: z.number().describe("The index of the tab to select"),
-      expectation: expectationSchema
+      expectation: expectationSchema.describe("Page state after tab switch")
     }),
     type: "readOnly"
   },
@@ -59,10 +59,10 @@ var newTab = defineTool({
   schema: {
     name: "browser_tab_new",
     title: "Open a new tab",
-    description: `Open a new tab.url:"https://example.com" to navigate immediately,omit for blank tab.expectation:{includeSnapshot:true} to see new tab,false if opening for later use.CONSIDER batch_execute for new_tab→navigate→interact.`,
+    description: "Open a new tab",
     inputSchema: z.object({
-      url: z.string().optional().describe("The URL to navigate to in the new tab. If not provided, the new tab will be blank."),
-      expectation: expectationSchema
+      url: z.string().optional().describe("URL for new tab (optional)"),
+      expectation: expectationSchema.describe("Page state of new tab")
     }),
     type: "readOnly"
   },
@@ -79,10 +79,10 @@ var closeTab = defineTool({
   schema: {
     name: "browser_tab_close",
     title: "Close a tab",
-    description: "Close a tab.index:N to close specific tab,omit to close current.expectation:{includeSnapshot:false} usually sufficient,true to verify remaining tabs.USE batch_execute for multi-tab cleanup.",
+    description: "Close a tab by index or close current tab",
     inputSchema: z.object({
-      index: z.number().optional().describe("The index of the tab to close. Closes current tab if not provided."),
-      expectation: expectationSchema
+      index: z.number().optional().describe("Tab index to close (omit for current)"),
+      expectation: expectationSchema.describe("Page state after close")
     }),
     type: "destructive"
   },

package/lib/tools/wait.js

@@ -26,12 +26,12 @@ var wait = defineTool({
   schema: {
     name: "browser_wait_for",
     title: "Wait for",
-    description: `Wait for text to appear/disappear or time to pass.PREFER text-based wait over time for reliability.For loading states:wait for text:"Loading..." textGone:true.For dynamic content:wait for specific text to appear.expectation:{includeSnapshot:true,snapshotOptions:{selector:"#status"},diffOptions:{enabled:true}} shows only what changed.AVOID:fixed time waits unless necessary.`,
+    description: "Wait for text to appear or disappear or a specified time to pass",
     inputSchema: z.object({
-      time: z.number().optional().describe("The time to wait in seconds"),
-      text: z.string().optional().describe("The text to wait for"),
-      textGone: z.string().optional().describe("The text to wait for to disappear"),
-      expectation: expectationSchema
+      time: z.number().optional().describe("Wait time in seconds"),
+      text: z.string().optional(),
+      textGone: z.string().optional(),
+      expectation: expectationSchema.describe("Page state after wait")
     }),
     type: "readOnly"
   },

package/lib/types/batch.js

@@ -37,9 +37,9 @@ var batchStepSchema = z.object({
   expectation: expectationSchema.describe("Expected output configuration for this step")
 });
 var batchExecuteSchema = z.object({
-  steps: z.array(batchStepSchema).min(1).describe("Array of steps to execute in sequence"),
+  steps: z.array(batchStepSchema).min(1).describe('Array of steps to execute in sequence. Recommended for form filling (multiple type→click), multi-step navigation, any workflow with 2+ known steps. Saves 90% tokens vs individual calls. Example: [{tool:"browser_navigate",arguments:{url:"https://example.com"}},{tool:"browser_type",arguments:{element:"username",ref:"#user",text:"john"}},{tool:"browser_click",arguments:{element:"submit",ref:"#btn"}}]'),
   stopOnFirstError: z.boolean().optional().default(false).describe("Stop entire batch on first error"),
-  globalExpectation: z.preprocess(parseJsonString, expectationSchema).optional().describe("Default expectation for all steps")
+  globalExpectation: z.preprocess(parseJsonString, expectationSchema).optional().describe('Default expectation for all steps. Recommended: {includeSnapshot:false,snapshotOptions:{selector:"#app"},diffOptions:{enabled:true}}. Per-step override with steps[].expectation')
 });
 export {
   batchStepSchema,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tontoko/fast-playwright-mcp",
-  "version": "0.0.9",
+  "version": "0.1.1",
   "publishConfig": {
     "access": "public"
   },
@@ -10,7 +10,7 @@
     "type": "git",
     "url": "https://github.com/tontoko/fast-playwright-mcp"
   },
-  "homepage": "https://playwright.dev",
+  "homepage": "https://github.com/tontoko/fast-playwright-mcp",
   "engines": {
     "node": ">=18"
   },