@tontoko/fast-playwright-mcp 0.0.7 → 0.0.8

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/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.7",
+  "version": "0.0.8",
   "publishConfig": {
     "access": "public"
   },