@one2x/playwright 1.57.0-alpha.1

package/lib/mcp/browser/tools/mouse.js

@@ -0,0 +1,107 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var mouse_exports = {};
+__export(mouse_exports, {
+  default: () => mouse_default
+});
+module.exports = __toCommonJS(mouse_exports);
+var import_bundle = require("../../sdk/bundle");
+var import_tool = require("./tool");
+const elementSchema = import_bundle.z.object({
+  element: import_bundle.z.string().describe("Human-readable element description used to obtain permission to interact with the element")
+});
+const mouseMove = (0, import_tool.defineTabTool)({
+  capability: "vision",
+  schema: {
+    name: "browser_mouse_move_xy",
+    title: "Move mouse",
+    description: "Move mouse to a given position",
+    inputSchema: elementSchema.extend({
+      x: import_bundle.z.number().describe("X coordinate"),
+      y: import_bundle.z.number().describe("Y coordinate")
+    }),
+    type: "input"
+  },
+  handle: async (tab, params, response) => {
+    response.addCode(`// Move mouse to (${params.x}, ${params.y})`);
+    response.addCode(`await page.mouse.move(${params.x}, ${params.y});`);
+    await tab.waitForCompletion(async () => {
+      await tab.page.mouse.move(params.x, params.y);
+    });
+  }
+});
+const mouseClick = (0, import_tool.defineTabTool)({
+  capability: "vision",
+  schema: {
+    name: "browser_mouse_click_xy",
+    title: "Click",
+    description: "Click left mouse button at a given position",
+    inputSchema: elementSchema.extend({
+      x: import_bundle.z.number().describe("X coordinate"),
+      y: import_bundle.z.number().describe("Y coordinate")
+    }),
+    type: "input"
+  },
+  handle: async (tab, params, response) => {
+    response.setIncludeSnapshot();
+    response.addCode(`// Click mouse at coordinates (${params.x}, ${params.y})`);
+    response.addCode(`await page.mouse.move(${params.x}, ${params.y});`);
+    response.addCode(`await page.mouse.down();`);
+    response.addCode(`await page.mouse.up();`);
+    await tab.waitForCompletion(async () => {
+      await tab.page.mouse.move(params.x, params.y);
+      await tab.page.mouse.down();
+      await tab.page.mouse.up();
+    });
+  }
+});
+const mouseDrag = (0, import_tool.defineTabTool)({
+  capability: "vision",
+  schema: {
+    name: "browser_mouse_drag_xy",
+    title: "Drag mouse",
+    description: "Drag left mouse button to a given position",
+    inputSchema: elementSchema.extend({
+      startX: import_bundle.z.number().describe("Start X coordinate"),
+      startY: import_bundle.z.number().describe("Start Y coordinate"),
+      endX: import_bundle.z.number().describe("End X coordinate"),
+      endY: import_bundle.z.number().describe("End Y coordinate")
+    }),
+    type: "input"
+  },
+  handle: async (tab, params, response) => {
+    response.setIncludeSnapshot();
+    response.addCode(`// Drag mouse from (${params.startX}, ${params.startY}) to (${params.endX}, ${params.endY})`);
+    response.addCode(`await page.mouse.move(${params.startX}, ${params.startY});`);
+    response.addCode(`await page.mouse.down();`);
+    response.addCode(`await page.mouse.move(${params.endX}, ${params.endY});`);
+    response.addCode(`await page.mouse.up();`);
+    await tab.waitForCompletion(async () => {
+      await tab.page.mouse.move(params.startX, params.startY);
+      await tab.page.mouse.down();
+      await tab.page.mouse.move(params.endX, params.endY);
+      await tab.page.mouse.up();
+    });
+  }
+});
+var mouse_default = [
+  mouseMove,
+  mouseClick,
+  mouseDrag
+];

package/lib/mcp/browser/tools/mouse.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/mcp/browser/tools/mouse.ts"],
+  "sourcesContent": ["/**\n * Copyright (c) Microsoft Corporation.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { z } from '../../sdk/bundle';\nimport { defineTabTool } from './tool';\n\nconst elementSchema = z.object({\n  element: z.string().describe('Human-readable element description used to obtain permission to interact with the element'),\n});\n\nconst mouseMove = defineTabTool({\n  capability: 'vision',\n  schema: {\n    name: 'browser_mouse_move_xy',\n    title: 'Move mouse',\n    description: 'Move mouse to a given position',\n    inputSchema: elementSchema.extend({\n      x: z.number().describe('X coordinate'),\n      y: z.number().describe('Y coordinate'),\n    }),\n    type: 'input',\n  },\n\n  handle: async (tab, params, response) => {\n    response.addCode(`// Move mouse to (${params.x}, ${params.y})`);\n    response.addCode(`await page.mouse.move(${params.x}, ${params.y});`);\n\n    await tab.waitForCompletion(async () => {\n      await tab.page.mouse.move(params.x, params.y);\n    });\n  },\n});\n\nconst mouseClick = defineTabTool({\n  capability: 'vision',\n  schema: {\n    name: 'browser_mouse_click_xy',\n    title: 'Click',\n    description: 'Click left mouse button at a given position',\n    inputSchema: elementSchema.extend({\n      x: z.number().describe('X coordinate'),\n      y: z.number().describe('Y coordinate'),\n    }),\n    type: 'input',\n  },\n\n  handle: async (tab, params, response) => {\n    response.setIncludeSnapshot();\n\n    response.addCode(`// Click mouse at coordinates (${params.x}, ${params.y})`);\n    response.addCode(`await page.mouse.move(${params.x}, ${params.y});`);\n    response.addCode(`await page.mouse.down();`);\n    response.addCode(`await page.mouse.up();`);\n\n    await tab.waitForCompletion(async () => {\n      await tab.page.mouse.move(params.x, params.y);\n      await tab.page.mouse.down();\n      await tab.page.mouse.up();\n    });\n  },\n});\n\nconst mouseDrag = defineTabTool({\n  capability: 'vision',\n  schema: {\n    name: 'browser_mouse_drag_xy',\n    title: 'Drag mouse',\n    description: 'Drag left mouse button to a given position',\n    inputSchema: elementSchema.extend({\n      startX: z.number().describe('Start X coordinate'),\n      startY: z.number().describe('Start Y coordinate'),\n      endX: z.number().describe('End X coordinate'),\n      endY: z.number().describe('End Y coordinate'),\n    }),\n    type: 'input',\n  },\n\n  handle: async (tab, params, response) => {\n    response.setIncludeSnapshot();\n\n    response.addCode(`// Drag mouse from (${params.startX}, ${params.startY}) to (${params.endX}, ${params.endY})`);\n    response.addCode(`await page.mouse.move(${params.startX}, ${params.startY});`);\n    response.addCode(`await page.mouse.down();`);\n    response.addCode(`await page.mouse.move(${params.endX}, ${params.endY});`);\n    response.addCode(`await page.mouse.up();`);\n\n    await tab.waitForCompletion(async () => {\n      await tab.page.mouse.move(params.startX, params.startY);\n      await tab.page.mouse.down();\n      await tab.page.mouse.move(params.endX, params.endY);\n      await tab.page.mouse.up();\n    });\n  },\n});\n\nexport default [\n  mouseMove,\n  mouseClick,\n  mouseDrag,\n];\n"],
+  "mappings": "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",
+  "names": []
+}

package/lib/mcp/browser/tools/navigate.js

@@ -0,0 +1,62 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var navigate_exports = {};
+__export(navigate_exports, {
+  default: () => navigate_default
+});
+module.exports = __toCommonJS(navigate_exports);
+var import_bundle = require("../../sdk/bundle");
+var import_tool = require("./tool");
+const navigate = (0, import_tool.defineTool)({
+  capability: "core",
+  schema: {
+    name: "browser_navigate",
+    title: "Navigate to a absolute URL",
+    description: "Navigate to a absolute URL",
+    inputSchema: import_bundle.z.object({
+      url: import_bundle.z.string().describe("The absolute URL to navigate to")
+    }),
+    type: "action"
+  },
+  handle: async (context, params, response) => {
+    const tab = await context.ensureTab();
+    await tab.navigate(params.url);
+    response.setIncludeSnapshot();
+    response.addCode(`await page.goto('${params.url}');`);
+  }
+});
+const goBack = (0, import_tool.defineTabTool)({
+  capability: "core",
+  schema: {
+    name: "browser_navigate_back",
+    title: "Go back",
+    description: "Go back to the previous page",
+    inputSchema: import_bundle.z.object({}),
+    type: "action"
+  },
+  handle: async (tab, params, response) => {
+    await tab.page.goBack();
+    response.setIncludeSnapshot();
+    response.addCode(`await page.goBack();`);
+  }
+});
+var navigate_default = [
+  navigate,
+  goBack
+];

package/lib/mcp/browser/tools/navigate.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/mcp/browser/tools/navigate.ts"],
+  "sourcesContent": ["/**\n * Copyright (c) Microsoft Corporation.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { z } from '../../sdk/bundle';\nimport { defineTool, defineTabTool } from './tool';\n\nconst navigate = defineTool({\n  capability: 'core',\n\n  schema: {\n    name: 'browser_navigate',\n    title: 'Navigate to a absolute URL',\n    description: 'Navigate to a absolute URL',\n    inputSchema: z.object({\n      url: z.string().describe('The absolute URL to navigate to'),\n    }),\n    type: 'action',\n  },\n\n  handle: async (context, params, response) => {\n    const tab = await context.ensureTab();\n    await tab.navigate(params.url);\n\n    response.setIncludeSnapshot();\n    response.addCode(`await page.goto('${params.url}');`);\n  },\n});\n\nconst goBack = defineTabTool({\n  capability: 'core',\n  schema: {\n    name: 'browser_navigate_back',\n    title: 'Go back',\n    description: 'Go back to the previous page',\n    inputSchema: z.object({}),\n    type: 'action',\n  },\n\n  handle: async (tab, params, response) => {\n    await tab.page.goBack();\n    response.setIncludeSnapshot();\n    response.addCode(`await page.goBack();`);\n  },\n});\n\nexport default [\n  navigate,\n  goBack,\n];\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAgBA,oBAAkB;AAClB,kBAA0C;AAE1C,MAAM,eAAW,wBAAW;AAAA,EAC1B,YAAY;AAAA,EAEZ,QAAQ;AAAA,IACN,MAAM;AAAA,IACN,OAAO;AAAA,IACP,aAAa;AAAA,IACb,aAAa,gBAAE,OAAO;AAAA,MACpB,KAAK,gBAAE,OAAO,EAAE,SAAS,iCAAiC;AAAA,IAC5D,CAAC;AAAA,IACD,MAAM;AAAA,EACR;AAAA,EAEA,QAAQ,OAAO,SAAS,QAAQ,aAAa;AAC3C,UAAM,MAAM,MAAM,QAAQ,UAAU;AACpC,UAAM,IAAI,SAAS,OAAO,GAAG;AAE7B,aAAS,mBAAmB;AAC5B,aAAS,QAAQ,oBAAoB,OAAO,GAAG,KAAK;AAAA,EACtD;AACF,CAAC;AAED,MAAM,aAAS,2BAAc;AAAA,EAC3B,YAAY;AAAA,EACZ,QAAQ;AAAA,IACN,MAAM;AAAA,IACN,OAAO;AAAA,IACP,aAAa;AAAA,IACb,aAAa,gBAAE,OAAO,CAAC,CAAC;AAAA,IACxB,MAAM;AAAA,EACR;AAAA,EAEA,QAAQ,OAAO,KAAK,QAAQ,aAAa;AACvC,UAAM,IAAI,KAAK,OAAO;AACtB,aAAS,mBAAmB;AAC5B,aAAS,QAAQ,sBAAsB;AAAA,EACzC;AACF,CAAC;AAED,IAAO,mBAAQ;AAAA,EACb;AAAA,EACA;AACF;",
+  "names": []
+}

package/lib/mcp/browser/tools/network.js

@@ -0,0 +1,54 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var network_exports = {};
+__export(network_exports, {
+  default: () => network_default
+});
+module.exports = __toCommonJS(network_exports);
+var import_bundle = require("../../sdk/bundle");
+var import_tool = require("./tool");
+const requests = (0, import_tool.defineTabTool)({
+  capability: "core",
+  schema: {
+    name: "browser_network_requests",
+    title: "List network requests",
+    description: "Returns all network requests since loading the page",
+    inputSchema: import_bundle.z.object({}),
+    type: "readOnly"
+  },
+  handle: async (tab, params, response) => {
+    const requests2 = await tab.requests();
+    for (const request of requests2)
+      response.addResult(await renderRequest(request));
+  }
+});
+async function renderRequest(request) {
+  const result = [];
+  result.push(`[${request.method().toUpperCase()}] ${request.url()}`);
+  const hasResponse = request._hasResponse;
+  if (hasResponse) {
+    const response = await request.response();
+    if (response)
+      result.push(`=> [${response.status()}] ${response.statusText()}`);
+  }
+  return result.join(" ");
+}
+var network_default = [
+  requests
+];

package/lib/mcp/browser/tools/network.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/mcp/browser/tools/network.ts"],
+  "sourcesContent": ["/**\n * Copyright (c) Microsoft Corporation.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { z } from '../../sdk/bundle';\nimport { defineTabTool } from './tool';\n\nimport type * as playwright from 'playwright-core';\nimport type { Request } from '../../../../../playwright-core/src/client/network';\n\nconst requests = defineTabTool({\n  capability: 'core',\n\n  schema: {\n    name: 'browser_network_requests',\n    title: 'List network requests',\n    description: 'Returns all network requests since loading the page',\n    inputSchema: z.object({}),\n    type: 'readOnly',\n  },\n\n  handle: async (tab, params, response) => {\n    const requests = await tab.requests();\n    for (const request of requests)\n      response.addResult(await renderRequest(request));\n  },\n});\n\nasync function renderRequest(request: playwright.Request) {\n  const result: string[] = [];\n  result.push(`[${request.method().toUpperCase()}] ${request.url()}`);\n  const hasResponse = (request as Request)._hasResponse;\n  if (hasResponse) {\n    const response = await request.response();\n    if (response)\n      result.push(`=> [${response.status()}] ${response.statusText()}`);\n  }\n  return result.join(' ');\n}\n\nexport default [\n  requests,\n];\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAgBA,oBAAkB;AAClB,kBAA8B;AAK9B,MAAM,eAAW,2BAAc;AAAA,EAC7B,YAAY;AAAA,EAEZ,QAAQ;AAAA,IACN,MAAM;AAAA,IACN,OAAO;AAAA,IACP,aAAa;AAAA,IACb,aAAa,gBAAE,OAAO,CAAC,CAAC;AAAA,IACxB,MAAM;AAAA,EACR;AAAA,EAEA,QAAQ,OAAO,KAAK,QAAQ,aAAa;AACvC,UAAMA,YAAW,MAAM,IAAI,SAAS;AACpC,eAAW,WAAWA;AACpB,eAAS,UAAU,MAAM,cAAc,OAAO,CAAC;AAAA,EACnD;AACF,CAAC;AAED,eAAe,cAAc,SAA6B;AACxD,QAAM,SAAmB,CAAC;AAC1B,SAAO,KAAK,IAAI,QAAQ,OAAO,EAAE,YAAY,CAAC,KAAK,QAAQ,IAAI,CAAC,EAAE;AAClE,QAAM,cAAe,QAAoB;AACzC,MAAI,aAAa;AACf,UAAM,WAAW,MAAM,QAAQ,SAAS;AACxC,QAAI;AACF,aAAO,KAAK,OAAO,SAAS,OAAO,CAAC,KAAK,SAAS,WAAW,CAAC,EAAE;AAAA,EACpE;AACA,SAAO,OAAO,KAAK,GAAG;AACxB;AAEA,IAAO,kBAAQ;AAAA,EACb;AACF;",
+  "names": ["requests"]
+}

package/lib/mcp/browser/tools/pdf.js

@@ -0,0 +1,59 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var pdf_exports = {};
+__export(pdf_exports, {
+  default: () => pdf_default
+});
+module.exports = __toCommonJS(pdf_exports);
+var import_bundle = require("../../sdk/bundle");
+var import_tool = require("./tool");
+var javascript = __toESM(require("../codegen"));
+var import_utils = require("./utils");
+const pdfSchema = import_bundle.z.object({
+  filename: import_bundle.z.string().optional().describe("File name to save the pdf to. Defaults to `page-{timestamp}.pdf` if not specified. Prefer relative file names to stay within the output directory.")
+});
+const pdf = (0, import_tool.defineTabTool)({
+  capability: "pdf",
+  schema: {
+    name: "browser_pdf_save",
+    title: "Save as PDF",
+    description: "Save page as PDF",
+    inputSchema: pdfSchema,
+    type: "readOnly"
+  },
+  handle: async (tab, params, response) => {
+    const fileName = await tab.context.outputFile(params.filename ?? (0, import_utils.dateAsFileName)("pdf"), { origin: "llm", reason: "Saving PDF" });
+    response.addCode(`await page.pdf(${javascript.formatObject({ path: fileName })});`);
+    response.addResult(`Saved page as ${fileName}`);
+    await tab.page.pdf({ path: fileName });
+  }
+});
+var pdf_default = [
+  pdf
+];

package/lib/mcp/browser/tools/pdf.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/mcp/browser/tools/pdf.ts"],
+  "sourcesContent": ["/**\n * Copyright (c) Microsoft Corporation.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { z } from '../../sdk/bundle';\nimport { defineTabTool } from './tool';\nimport * as javascript from '../codegen';\nimport { dateAsFileName } from './utils';\n\nconst pdfSchema = z.object({\n  filename: z.string().optional().describe('File name to save the pdf to. Defaults to `page-{timestamp}.pdf` if not specified. Prefer relative file names to stay within the output directory.'),\n});\n\nconst pdf = defineTabTool({\n  capability: 'pdf',\n\n  schema: {\n    name: 'browser_pdf_save',\n    title: 'Save as PDF',\n    description: 'Save page as PDF',\n    inputSchema: pdfSchema,\n    type: 'readOnly',\n  },\n\n  handle: async (tab, params, response) => {\n    const fileName = await tab.context.outputFile(params.filename ?? dateAsFileName('pdf'), { origin: 'llm', reason: 'Saving PDF' });\n    response.addCode(`await page.pdf(${javascript.formatObject({ path: fileName })});`);\n    response.addResult(`Saved page as ${fileName}`);\n    await tab.page.pdf({ path: fileName });\n  },\n});\n\nexport default [\n  pdf,\n];\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAgBA,oBAAkB;AAClB,kBAA8B;AAC9B,iBAA4B;AAC5B,mBAA+B;AAE/B,MAAM,YAAY,gBAAE,OAAO;AAAA,EACzB,UAAU,gBAAE,OAAO,EAAE,SAAS,EAAE,SAAS,oJAAoJ;AAC/L,CAAC;AAED,MAAM,UAAM,2BAAc;AAAA,EACxB,YAAY;AAAA,EAEZ,QAAQ;AAAA,IACN,MAAM;AAAA,IACN,OAAO;AAAA,IACP,aAAa;AAAA,IACb,aAAa;AAAA,IACb,MAAM;AAAA,EACR;AAAA,EAEA,QAAQ,OAAO,KAAK,QAAQ,aAAa;AACvC,UAAM,WAAW,MAAM,IAAI,QAAQ,WAAW,OAAO,gBAAY,6BAAe,KAAK,GAAG,EAAE,QAAQ,OAAO,QAAQ,aAAa,CAAC;AAC/H,aAAS,QAAQ,kBAAkB,WAAW,aAAa,EAAE,MAAM,SAAS,CAAC,CAAC,IAAI;AAClF,aAAS,UAAU,iBAAiB,QAAQ,EAAE;AAC9C,UAAM,IAAI,KAAK,IAAI,EAAE,MAAM,SAAS,CAAC;AAAA,EACvC;AACF,CAAC;AAED,IAAO,cAAQ;AAAA,EACb;AACF;",
+  "names": []
+}

package/lib/mcp/browser/tools/screenshot.js

@@ -0,0 +1,106 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var screenshot_exports = {};
+__export(screenshot_exports, {
+  default: () => screenshot_default,
+  scaleImageToFitMessage: () => scaleImageToFitMessage
+});
+module.exports = __toCommonJS(screenshot_exports);
+var import_fs = __toESM(require("fs"));
+var import_utils = require("playwright-core/lib/utils");
+var import_utilsBundle = require("playwright-core/lib/utilsBundle");
+var import_bundle = require("../../sdk/bundle");
+var import_tool = require("./tool");
+var javascript = __toESM(require("../codegen"));
+var import_utils2 = require("./utils");
+const screenshotSchema = import_bundle.z.object({
+  type: import_bundle.z.enum(["png", "jpeg"]).default("png").describe("Image format for the screenshot. Default is png."),
+  filename: import_bundle.z.string().optional().describe("File name to save the screenshot to. Defaults to `page-{timestamp}.{png|jpeg}` if not specified. Prefer relative file names to stay within the output directory."),
+  element: import_bundle.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: import_bundle.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."),
+  fullPage: import_bundle.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.")
+});
+const screenshot = (0, import_tool.defineTabTool)({
+  capability: "core",
+  schema: {
+    name: "browser_take_screenshot",
+    title: "Take a screenshot",
+    description: `Take a screenshot of the current page. You can't perform actions based on the screenshot, use browser_snapshot for actions.`,
+    inputSchema: screenshotSchema,
+    type: "readOnly"
+  },
+  handle: async (tab, params, response) => {
+    if (!!params.element !== !!params.ref)
+      throw new Error("Both element and ref must be provided or neither.");
+    if (params.fullPage && params.ref)
+      throw new Error("fullPage cannot be used with element screenshots.");
+    const fileType = params.type || "png";
+    const fileName = await tab.context.outputFile(params.filename || (0, import_utils2.dateAsFileName)(fileType), { origin: "llm", reason: "Saving screenshot" });
+    const options = {
+      type: fileType,
+      quality: fileType === "png" ? void 0 : 90,
+      scale: "css",
+      ...params.fullPage !== void 0 && { fullPage: params.fullPage }
+    };
+    const isElementScreenshot = params.element && params.ref;
+    const screenshotTarget = isElementScreenshot ? params.element : params.fullPage ? "full page" : "viewport";
+    response.addCode(`// Screenshot ${screenshotTarget} and save it as ${fileName}`);
+    const ref = params.ref ? await tab.refLocator({ element: params.element || "", ref: params.ref }) : null;
+    if (ref)
+      response.addCode(`await page.${ref.resolved}.screenshot(${javascript.formatObject(options)});`);
+    else
+      response.addCode(`await page.screenshot(${javascript.formatObject(options)});`);
+    const buffer = ref ? await ref.locator.screenshot(options) : await tab.page.screenshot(options);
+    await (0, import_utils.mkdirIfNeeded)(fileName);
+    await import_fs.default.promises.writeFile(fileName, buffer);
+    response.addResult(`Took the ${screenshotTarget} screenshot and saved it as ${fileName}`);
+    response.addImage({
+      contentType: fileType === "png" ? "image/png" : "image/jpeg",
+      data: scaleImageToFitMessage(buffer, fileType)
+    });
+  }
+});
+function scaleImageToFitMessage(buffer, imageType) {
+  const image = imageType === "png" ? import_utilsBundle.PNG.sync.read(buffer) : import_utilsBundle.jpegjs.decode(buffer, { maxMemoryUsageInMB: 512 });
+  const pixels = image.width * image.height;
+  const shrink = Math.min(1568 / image.width, 1568 / image.height, Math.sqrt(1.15 * 1024 * 1024 / pixels));
+  if (shrink > 1)
+    return buffer;
+  const width = image.width * shrink | 0;
+  const height = image.height * shrink | 0;
+  const scaledImage = (0, import_utils.scaleImageToSize)(image, { width, height });
+  return imageType === "png" ? import_utilsBundle.PNG.sync.write(scaledImage) : import_utilsBundle.jpegjs.encode(scaledImage, 80).data;
+}
+var screenshot_default = [
+  screenshot
+];
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  scaleImageToFitMessage
+});

package/lib/mcp/browser/tools/screenshot.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/mcp/browser/tools/screenshot.ts"],
+  "sourcesContent": ["/**\n * Copyright (c) Microsoft Corporation.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport fs from 'fs';\n\nimport { mkdirIfNeeded, scaleImageToSize } from 'playwright-core/lib/utils';\nimport { jpegjs, PNG } from 'playwright-core/lib/utilsBundle';\n\nimport { z } from '../../sdk/bundle';\nimport { defineTabTool } from './tool';\nimport * as javascript from '../codegen';\nimport { dateAsFileName } from './utils';\n\nimport type * as playwright from 'playwright-core';\n\nconst screenshotSchema = z.object({\n  type: z.enum(['png', 'jpeg']).default('png').describe('Image format for the screenshot. Default is png.'),\n  filename: z.string().optional().describe('File name to save the screenshot to. Defaults to `page-{timestamp}.{png|jpeg}` if not specified. Prefer relative file names to stay within the output directory.'),\n  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.'),\n  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.'),\n  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.'),\n});\n\nconst screenshot = defineTabTool({\n  capability: 'core',\n  schema: {\n    name: 'browser_take_screenshot',\n    title: 'Take a screenshot',\n    description: `Take a screenshot of the current page. You can't perform actions based on the screenshot, use browser_snapshot for actions.`,\n    inputSchema: screenshotSchema,\n    type: 'readOnly',\n  },\n\n  handle: async (tab, params, response) => {\n    if (!!params.element !== !!params.ref)\n      throw new Error('Both element and ref must be provided or neither.');\n    if (params.fullPage && params.ref)\n      throw new Error('fullPage cannot be used with element screenshots.');\n\n    const fileType = params.type || 'png';\n    const fileName = await tab.context.outputFile(params.filename || dateAsFileName(fileType), { origin: 'llm', reason: 'Saving screenshot' });\n    const options: playwright.PageScreenshotOptions = {\n      type: fileType,\n      quality: fileType === 'png' ? undefined : 90,\n      scale: 'css',\n      ...(params.fullPage !== undefined && { fullPage: params.fullPage })\n    };\n    const isElementScreenshot = params.element && params.ref;\n\n    const screenshotTarget = isElementScreenshot ? params.element : (params.fullPage ? 'full page' : 'viewport');\n    response.addCode(`// Screenshot ${screenshotTarget} and save it as ${fileName}`);\n\n    // Only get snapshot when element screenshot is needed\n    const ref = params.ref ? await tab.refLocator({ element: params.element || '', ref: params.ref }) : null;\n\n    if (ref)\n      response.addCode(`await page.${ref.resolved}.screenshot(${javascript.formatObject(options)});`);\n    else\n      response.addCode(`await page.screenshot(${javascript.formatObject(options)});`);\n\n    const buffer = ref ? await ref.locator.screenshot(options) : await tab.page.screenshot(options);\n\n    await mkdirIfNeeded(fileName);\n    await fs.promises.writeFile(fileName, buffer);\n\n    response.addResult(`Took the ${screenshotTarget} screenshot and saved it as ${fileName}`);\n\n    response.addImage({\n      contentType: fileType === 'png' ? 'image/png' : 'image/jpeg',\n      data: scaleImageToFitMessage(buffer, fileType)\n    });\n  }\n});\n\nexport function scaleImageToFitMessage(buffer: Buffer, imageType: 'png' | 'jpeg'): Buffer {\n  // https://docs.claude.com/en/docs/build-with-claude/vision#evaluate-image-size\n  // Not more than 1.15 megapixel, linear size not more than 1568.\n\n  const image = imageType === 'png' ? PNG.sync.read(buffer) : jpegjs.decode(buffer, { maxMemoryUsageInMB: 512 });\n  const pixels = image.width * image.height;\n\n  const shrink = Math.min(1568 / image.width, 1568 / image.height, Math.sqrt(1.15 * 1024 * 1024 / pixels));\n  if (shrink > 1)\n    return buffer;\n\n  const width = image.width * shrink | 0;\n  const height = image.height * shrink | 0;\n  const scaledImage = scaleImageToSize(image, { width, height });\n  return imageType === 'png' ? PNG.sync.write(scaledImage as any) : jpegjs.encode(scaledImage, 80).data;\n}\n\nexport default [\n  screenshot,\n];\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAgBA,gBAAe;AAEf,mBAAgD;AAChD,yBAA4B;AAE5B,oBAAkB;AAClB,kBAA8B;AAC9B,iBAA4B;AAC5B,IAAAA,gBAA+B;AAI/B,MAAM,mBAAmB,gBAAE,OAAO;AAAA,EAChC,MAAM,gBAAE,KAAK,CAAC,OAAO,MAAM,CAAC,EAAE,QAAQ,KAAK,EAAE,SAAS,kDAAkD;AAAA,EACxG,UAAU,gBAAE,OAAO,EAAE,SAAS,EAAE,SAAS,kKAAkK;AAAA,EAC3M,SAAS,gBAAE,OAAO,EAAE,SAAS,EAAE,SAAS,sMAAsM;AAAA,EAC9O,KAAK,gBAAE,OAAO,EAAE,SAAS,EAAE,SAAS,qKAAqK;AAAA,EACzM,UAAU,gBAAE,QAAQ,EAAE,SAAS,EAAE,SAAS,gJAAgJ;AAC5L,CAAC;AAED,MAAM,iBAAa,2BAAc;AAAA,EAC/B,YAAY;AAAA,EACZ,QAAQ;AAAA,IACN,MAAM;AAAA,IACN,OAAO;AAAA,IACP,aAAa;AAAA,IACb,aAAa;AAAA,IACb,MAAM;AAAA,EACR;AAAA,EAEA,QAAQ,OAAO,KAAK,QAAQ,aAAa;AACvC,QAAI,CAAC,CAAC,OAAO,YAAY,CAAC,CAAC,OAAO;AAChC,YAAM,IAAI,MAAM,mDAAmD;AACrE,QAAI,OAAO,YAAY,OAAO;AAC5B,YAAM,IAAI,MAAM,mDAAmD;AAErE,UAAM,WAAW,OAAO,QAAQ;AAChC,UAAM,WAAW,MAAM,IAAI,QAAQ,WAAW,OAAO,gBAAY,8BAAe,QAAQ,GAAG,EAAE,QAAQ,OAAO,QAAQ,oBAAoB,CAAC;AACzI,UAAM,UAA4C;AAAA,MAChD,MAAM;AAAA,MACN,SAAS,aAAa,QAAQ,SAAY;AAAA,MAC1C,OAAO;AAAA,MACP,GAAI,OAAO,aAAa,UAAa,EAAE,UAAU,OAAO,SAAS;AAAA,IACnE;AACA,UAAM,sBAAsB,OAAO,WAAW,OAAO;AAErD,UAAM,mBAAmB,sBAAsB,OAAO,UAAW,OAAO,WAAW,cAAc;AACjG,aAAS,QAAQ,iBAAiB,gBAAgB,mBAAmB,QAAQ,EAAE;AAG/E,UAAM,MAAM,OAAO,MAAM,MAAM,IAAI,WAAW,EAAE,SAAS,OAAO,WAAW,IAAI,KAAK,OAAO,IAAI,CAAC,IAAI;AAEpG,QAAI;AACF,eAAS,QAAQ,cAAc,IAAI,QAAQ,eAAe,WAAW,aAAa,OAAO,CAAC,IAAI;AAAA;AAE9F,eAAS,QAAQ,yBAAyB,WAAW,aAAa,OAAO,CAAC,IAAI;AAEhF,UAAM,SAAS,MAAM,MAAM,IAAI,QAAQ,WAAW,OAAO,IAAI,MAAM,IAAI,KAAK,WAAW,OAAO;AAE9F,cAAM,4BAAc,QAAQ;AAC5B,UAAM,UAAAC,QAAG,SAAS,UAAU,UAAU,MAAM;AAE5C,aAAS,UAAU,YAAY,gBAAgB,+BAA+B,QAAQ,EAAE;AAExF,aAAS,SAAS;AAAA,MAChB,aAAa,aAAa,QAAQ,cAAc;AAAA,MAChD,MAAM,uBAAuB,QAAQ,QAAQ;AAAA,IAC/C,CAAC;AAAA,EACH;AACF,CAAC;AAEM,SAAS,uBAAuB,QAAgB,WAAmC;AAIxF,QAAM,QAAQ,cAAc,QAAQ,uBAAI,KAAK,KAAK,MAAM,IAAI,0BAAO,OAAO,QAAQ,EAAE,oBAAoB,IAAI,CAAC;AAC7G,QAAM,SAAS,MAAM,QAAQ,MAAM;AAEnC,QAAM,SAAS,KAAK,IAAI,OAAO,MAAM,OAAO,OAAO,MAAM,QAAQ,KAAK,KAAK,OAAO,OAAO,OAAO,MAAM,CAAC;AACvG,MAAI,SAAS;AACX,WAAO;AAET,QAAM,QAAQ,MAAM,QAAQ,SAAS;AACrC,QAAM,SAAS,MAAM,SAAS,SAAS;AACvC,QAAM,kBAAc,+BAAiB,OAAO,EAAE,OAAO,OAAO,CAAC;AAC7D,SAAO,cAAc,QAAQ,uBAAI,KAAK,MAAM,WAAkB,IAAI,0BAAO,OAAO,aAAa,EAAE,EAAE;AACnG;AAEA,IAAO,qBAAQ;AAAA,EACb;AACF;",
+  "names": ["import_utils", "fs"]
+}