@tontoko/fast-playwright-mcp 0.0.6 → 0.0.8

package/lib/batch/batch-executor.js

@@ -42,7 +42,8 @@ class BatchExecutor {
     for (const [index, step] of steps.entries()) {
       const tool = this.toolRegistry.get(step.tool);
       if (!tool) {
-        throw new Error(`Unknown tool: ${step.tool}`);
+        const availableTools = Array.from(this.toolRegistry.keys()).filter((name) => name.startsWith("browser_") && name !== "browser_batch_execute").sort((a, b) => a.localeCompare(b)).join(",");
+        throw new Error(`Unknown tool: "${step.tool}" at step ${index}. Available tools: ${availableTools}`);
       }
       try {
         const parseResult = tool.schema.inputSchema.safeParse({

package/lib/tools/base-tool-handler.js

@@ -23,7 +23,7 @@ import { expectationSchema } from "../schemas/expectation.js";
 import { getErrorMessage } from "../utils/common-formatters.js";
 var baseElementSchema = z.object({
   element: z.string().optional().describe("Human-readable element description used to obtain permission to interact with the element"),
-  ref: z.string().optional().describe("Exact target element reference from the page snapshot")
+  ref: z.string().optional().describe('System-generated element ID from previous tool results (e.g., "rNODE-45-1"). Never use custom values.')
 });
 var baseExpectationSchema = z.object({
   expectation: expectationSchema

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"}}].`,
+    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).`,
     inputSchema: batchExecuteSchema,
     type: "destructive"
   },

package/lib/tools/evaluate.js

@@ -26,7 +26,7 @@ import { generateLocator } from "./utils.js";
 var evaluateSchema = z.object({
   function: z.string().describe("() => { /* code */ } or (element) => { /* code */ } when element is provided"),
   element: z.string().optional().describe("Human-readable element description used to obtain permission to interact with the element"),
-  ref: z.string().optional().describe("Exact target element reference from the page snapshot"),
+  ref: z.string().optional().describe('System-generated element ID from previous tool results (e.g., "rNODE-45-1"). Never use custom values.'),
   expectation: expectationSchema
 });
 var evaluate = defineTabTool({

package/lib/tools/keyboard.js

@@ -51,7 +51,7 @@ 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("Exact target element reference from the page snapshot"),
+  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."),

package/lib/tools/screenshot.js

@@ -27,7 +27,7 @@ var screenshotSchema = z.object({
   type: z.enum(["png", "jpeg"]).default("png").describe("Image format for the screenshot. Default is png."),
   filename: z.string().optional().describe("File name to save the screenshot to. Defaults to `page-{timestamp}.{png|jpeg}` if not specified."),
   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("Exact target element reference from the page snapshot. If not provided, the screenshot will be taken of viewport. If ref is provided, element 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
 }).refine((data) => {

package/lib/tools/snapshot.js

@@ -47,7 +47,7 @@ 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("Exact target element reference from the page snapshot")
+  ref: z.string().describe('System-generated element ID from previous tool results (e.g., "rNODE-45-1"). Never use custom values.')
 });
 var clickSchema = elementSchema.extend({
   doubleClick: z.boolean().optional().describe("Whether to perform a double click instead of a single click"),
@@ -93,9 +93,9 @@ var drag = defineTabTool({
     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.`,
     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("Exact source element reference from the page snapshot"),
+      startRef: z.string().describe('System-generated source element ID from previous tool results (e.g., "rNODE-45-1"). 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("Exact target element reference from the page snapshot"),
+      endRef: z.string().describe('System-generated target element ID from previous tool results (e.g., "rNODE-45-1"). Never use custom values.'),
       expectation: expectationSchema
     }),
     type: "destructive"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tontoko/fast-playwright-mcp",
-  "version": "0.0.6",
+  "version": "0.0.8",
   "publishConfig": {
     "access": "public"
   },