@one2x/playwright 1.57.0-alpha.1

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

@@ -0,0 +1,312 @@
+"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 snapshot_exports = {};
+__export(snapshot_exports, {
+  default: () => snapshot_default,
+  elementSchema: () => elementSchema
+});
+module.exports = __toCommonJS(snapshot_exports);
+var import_bundle = require("../../sdk/bundle");
+var import_tool = require("./tool");
+var javascript = __toESM(require("../codegen"));
+var import_utils = require("./utils");
+var import_actionRetry = require("./actionRetry");
+const snapshot = (0, import_tool.defineTool)({
+  capability: "core",
+  schema: {
+    name: "browser_snapshot",
+    title: "Page snapshot",
+    description: "Capture accessibility snapshot of the current page, this is better than screenshot",
+    inputSchema: import_bundle.z.object({}),
+    type: "readOnly"
+  },
+  handle: async (context, params, response) => {
+    await context.ensureTab();
+    response.setIncludeSnapshot("full");
+  }
+});
+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"),
+  ref: import_bundle.z.string().describe("Exact target element reference from the page snapshot")
+});
+const clickSchema = elementSchema.extend({
+  doubleClick: import_bundle.z.boolean().optional().describe("Whether to perform a double click instead of a single click"),
+  button: import_bundle.z.enum(["left", "right", "middle"]).optional().describe("Button to click, defaults to left"),
+  modifiers: import_bundle.z.array(import_bundle.z.enum(["Alt", "Control", "ControlOrMeta", "Meta", "Shift"])).optional().describe("Modifier keys to press")
+});
+const click = (0, import_tool.defineTabTool)({
+  capability: "core",
+  schema: {
+    name: "browser_click",
+    title: "Click",
+    description: "Perform click on a web page",
+    inputSchema: clickSchema,
+    type: "input"
+  },
+  handle: async (tab, params, response) => {
+    response.setIncludeSnapshot();
+    const { locator, resolved } = await tab.refLocator(params);
+    const options = {
+      button: params.button,
+      modifiers: params.modifiers
+    };
+    let usedAllowIntercept = false;
+    await tab.waitForCompletion(async () => {
+      const result = await (0, import_actionRetry.retryWithAllowIntercept)(
+        async (opts) => {
+          if (params.doubleClick)
+            await locator.dblclick(opts);
+          else
+            await locator.click(opts);
+        },
+        options
+      );
+      usedAllowIntercept = result.usedAllowIntercept;
+    });
+    const finalOptions = usedAllowIntercept ? { ...options, allowIntercept: true } : options;
+    const formatted = javascript.formatObject(finalOptions, " ", "oneline");
+    const optionsAttr = formatted !== "{}" ? formatted : "";
+    if (params.doubleClick)
+      response.addCode(`await page.${resolved}.dblclick(${optionsAttr});`);
+    else
+      response.addCode(`await page.${resolved}.click(${optionsAttr});`);
+  }
+});
+const drag = (0, import_tool.defineTabTool)({
+  capability: "core",
+  schema: {
+    name: "browser_drag",
+    title: "Drag mouse",
+    description: "Perform drag and drop between two elements",
+    inputSchema: import_bundle.z.object({
+      startElement: import_bundle.z.string().describe("Human-readable source element description used to obtain the permission to interact with the element"),
+      startRef: import_bundle.z.string().describe("Exact source element reference from the page snapshot"),
+      endElement: import_bundle.z.string().describe("Human-readable target element description used to obtain the permission to interact with the element"),
+      endRef: import_bundle.z.string().describe("Exact target element reference from the page snapshot")
+    }),
+    type: "input"
+  },
+  handle: async (tab, params, response) => {
+    response.setIncludeSnapshot();
+    const [start, end] = await tab.refLocators([
+      { ref: params.startRef, element: params.startElement },
+      { ref: params.endRef, element: params.endElement }
+    ]);
+    let usedAllowIntercept = false;
+    await tab.waitForCompletion(async () => {
+      const result = await (0, import_actionRetry.retryWithAllowIntercept)(
+        async (opts) => await start.locator.dragTo(end.locator, opts),
+        {}
+      );
+      usedAllowIntercept = result.usedAllowIntercept;
+    });
+    const optionsAttr = usedAllowIntercept ? ", { allowIntercept: true }" : "";
+    response.addCode(`await page.${start.resolved}.dragTo(page.${end.resolved}${optionsAttr});`);
+  }
+});
+const hover = (0, import_tool.defineTabTool)({
+  capability: "core",
+  schema: {
+    name: "browser_hover",
+    title: "Hover mouse",
+    description: "Hover over element on page",
+    inputSchema: elementSchema,
+    type: "input"
+  },
+  handle: async (tab, params, response) => {
+    response.setIncludeSnapshot();
+    const { locator, resolved } = await tab.refLocator(params);
+    let usedAllowIntercept = false;
+    await tab.waitForCompletion(async () => {
+      const result = await (0, import_actionRetry.retryWithAllowIntercept)(
+        async (opts) => await locator.hover(opts),
+        {}
+      );
+      usedAllowIntercept = result.usedAllowIntercept;
+    });
+    const optionsAttr = usedAllowIntercept ? "{ allowIntercept: true }" : "";
+    response.addCode(`await page.${resolved}.hover(${optionsAttr});`);
+  }
+});
+const selectOptionSchema = elementSchema.extend({
+  values: import_bundle.z.array(import_bundle.z.string()).describe("Array of values to select in the dropdown. This can be a single value or multiple values.")
+});
+const selectOption = (0, import_tool.defineTabTool)({
+  capability: "core",
+  schema: {
+    name: "browser_select_option",
+    title: "Select option",
+    description: "Select an option in a dropdown",
+    inputSchema: selectOptionSchema,
+    type: "input"
+  },
+  handle: async (tab, params, response) => {
+    response.setIncludeSnapshot();
+    const { locator, resolved } = await tab.refLocator(params);
+    response.addCode(`await page.${resolved}.selectOption(${javascript.formatObject(params.values)});`);
+    await tab.waitForCompletion(async () => {
+      await locator.selectOption(params.values);
+    });
+  }
+});
+const pickLocator = (0, import_tool.defineTabTool)({
+  capability: "testing",
+  schema: {
+    name: "browser_generate_locator",
+    title: "Create locator for element",
+    description: "Generate locator for the given element to use in tests",
+    inputSchema: elementSchema,
+    type: "readOnly"
+  },
+  handle: async (tab, params, response) => {
+    const { resolved } = await tab.refLocator(params);
+    response.addResult(resolved);
+  }
+});
+const elementInspect = (0, import_tool.defineTool)({
+  capability: "core",
+  schema: {
+    name: "browser_element_inspect",
+    title: "Inspect element for testing",
+    description: "Get element details for generating test assertions - returns suggested selector, HTML, and computed styles",
+    inputSchema: elementSchema,
+    type: "readOnly"
+  },
+  handle: async (context, params, response) => {
+    await context.ensureTab();
+    const tab = context.currentTabOrDie();
+    const { locator } = await tab.refLocator(params);
+    let elementDetails;
+    const suggestedSelectors = (await (0, import_utils.generateLocators)(locator)).map((s) => `\`page.${s}\``).join("\n");
+    try {
+      elementDetails = await locator.evaluate((element) => {
+        const computedStyle = window.getComputedStyle(element);
+        return {
+          outerHTML: element.outerHTML,
+          tagName: element.tagName.toLowerCase(),
+          computedStyles: {
+            display: computedStyle.display,
+            visibility: computedStyle.visibility,
+            opacity: computedStyle.opacity,
+            position: computedStyle.position,
+            width: computedStyle.width,
+            height: computedStyle.height,
+            backgroundColor: computedStyle.backgroundColor,
+            color: computedStyle.color,
+            fontSize: computedStyle.fontSize,
+            fontFamily: computedStyle.fontFamily,
+            textAlign: computedStyle.textAlign,
+            border: computedStyle.border,
+            borderRadius: computedStyle.borderRadius,
+            margin: computedStyle.margin,
+            padding: computedStyle.padding,
+            overflow: computedStyle.overflow,
+            zIndex: computedStyle.zIndex,
+            transform: computedStyle.transform
+          },
+          attributes: Array.from(element.attributes).reduce((acc, attr) => {
+            acc[attr.name] = attr.value;
+            return acc;
+          }, {}),
+          textContent: element.textContent?.trim() || "",
+          innerText: element.innerText?.trim() || "",
+          value: element.value || void 0,
+          checked: element.checked || void 0,
+          disabled: element.disabled || void 0,
+          readonly: element.readOnly || void 0,
+          bounds: element.getBoundingClientRect()
+        };
+      });
+    } catch (error) {
+      response.addResult(`Error inspecting element "${params.element}": ${error instanceof Error ? error.message : String(error)}
+
+This typically happens when:
+1. The element reference is no longer valid (element was removed)
+2. The page has navigated since the snapshot was taken
+3. The element is not accessible
+
+Try capturing a new snapshot with browser_snapshot and using the updated element reference.`);
+      return;
+    }
+    let result = `
+**Element:** ${params.element}
+**Suggested Playwright Selector:**
+${suggestedSelectors}
+
+**HTML:**
+\`\`\`html
+${elementDetails.outerHTML}
+\`\`\`
+
+**Key Computed Styles:**
+- Display: ${elementDetails.computedStyles.display}
+- Visibility: ${elementDetails.computedStyles.visibility}
+- Opacity: ${elementDetails.computedStyles.opacity}
+- Position: ${elementDetails.computedStyles.position}
+- Width: ${elementDetails.computedStyles.width}
+- Height: ${elementDetails.computedStyles.height}
+- Background Color: ${elementDetails.computedStyles.backgroundColor}
+- Color: ${elementDetails.computedStyles.color}
+
+**Element Properties:**
+- Tag: ${elementDetails.tagName}
+- Text Content: "${elementDetails.textContent}"
+- Inner Text: "${elementDetails.innerText}"`;
+    if (elementDetails.value !== void 0) {
+      result += `
+- Value: "${elementDetails.value}"`;
+    }
+    if (elementDetails.checked !== void 0) {
+      result += `
+- Checked: ${elementDetails.checked}`;
+    }
+    if (elementDetails.disabled !== void 0) {
+      result += `
+- Disabled: ${elementDetails.disabled}`;
+    }
+    if (elementDetails.readonly !== void 0) {
+      result += `
+- Read Only: ${elementDetails.readonly}`;
+    }
+    response.addResult(result);
+  }
+});
+var snapshot_default = [
+  snapshot,
+  click,
+  drag,
+  hover,
+  selectOption,
+  pickLocator,
+  elementInspect
+];
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  elementSchema
+});

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/mcp/browser/tools/snapshot.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, defineTool } from './tool';\nimport * as javascript from '../codegen';\nimport { generateLocators } from './utils';\nimport { retryWithAllowIntercept } from './actionRetry';\n\nconst snapshot = defineTool({\n  capability: 'core',\n  schema: {\n    name: 'browser_snapshot',\n    title: 'Page snapshot',\n    description: 'Capture accessibility snapshot of the current page, this is better than screenshot',\n    inputSchema: z.object({}),\n    type: 'readOnly',\n  },\n\n  handle: async (context, params, response) => {\n    await context.ensureTab();\n    response.setIncludeSnapshot('full');\n  },\n});\n\nexport const elementSchema = z.object({\n  element: z.string().describe('Human-readable element description used to obtain permission to interact with the element'),\n  ref: z.string().describe('Exact target element reference from the page snapshot'),\n});\n\nconst clickSchema = elementSchema.extend({\n  doubleClick: z.boolean().optional().describe('Whether to perform a double click instead of a single click'),\n  button: z.enum(['left', 'right', 'middle']).optional().describe('Button to click, defaults to left'),\n  modifiers: z.array(z.enum(['Alt', 'Control', 'ControlOrMeta', 'Meta', 'Shift'])).optional().describe('Modifier keys to press'),\n});\n\nconst click = defineTabTool({\n  capability: 'core',\n  schema: {\n    name: 'browser_click',\n    title: 'Click',\n    description: 'Perform click on a web page',\n    inputSchema: clickSchema,\n    type: 'input',\n  },\n\n  handle: async (tab, params, response) => {\n    response.setIncludeSnapshot();\n\n    const { locator, resolved } = await tab.refLocator(params);\n    const options = {\n      button: params.button,\n      modifiers: params.modifiers,\n    };\n\n    let usedAllowIntercept = false;\n    await tab.waitForCompletion(async () => {\n      const result = await retryWithAllowIntercept(\n        async (opts) => {\n          if (params.doubleClick)\n            await locator.dblclick(opts);\n          else\n            await locator.click(opts);\n        },\n        options\n      );\n      usedAllowIntercept = result.usedAllowIntercept;\n    });\n\n    const finalOptions = usedAllowIntercept ? { ...options, allowIntercept: true } : options;\n    const formatted = javascript.formatObject(finalOptions, ' ', 'oneline');\n    const optionsAttr = formatted !== '{}' ? formatted : '';\n\n    if (params.doubleClick)\n      response.addCode(`await page.${resolved}.dblclick(${optionsAttr});`);\n    else\n      response.addCode(`await page.${resolved}.click(${optionsAttr});`);\n  },\n});\n\nconst drag = defineTabTool({\n  capability: 'core',\n  schema: {\n    name: 'browser_drag',\n    title: 'Drag mouse',\n    description: 'Perform drag and drop between two elements',\n    inputSchema: z.object({\n      startElement: z.string().describe('Human-readable source element description used to obtain the permission to interact with the element'),\n      startRef: z.string().describe('Exact source element reference from the page snapshot'),\n      endElement: z.string().describe('Human-readable target element description used to obtain the permission to interact with the element'),\n      endRef: z.string().describe('Exact target element reference from the page snapshot'),\n    }),\n    type: 'input',\n  },\n\n  handle: async (tab, params, response) => {\n    response.setIncludeSnapshot();\n\n    const [start, end] = await tab.refLocators([\n      { ref: params.startRef, element: params.startElement },\n      { ref: params.endRef, element: params.endElement },\n    ]);\n\n    let usedAllowIntercept = false;\n    await tab.waitForCompletion(async () => {\n      const result = await retryWithAllowIntercept(\n        async (opts) => await start.locator.dragTo(end.locator, opts),\n        {}\n      );\n      usedAllowIntercept = result.usedAllowIntercept;\n    });\n\n    const optionsAttr = usedAllowIntercept ? ', { allowIntercept: true }' : '';\n    response.addCode(`await page.${start.resolved}.dragTo(page.${end.resolved}${optionsAttr});`);\n  },\n});\n\nconst hover = defineTabTool({\n  capability: 'core',\n  schema: {\n    name: 'browser_hover',\n    title: 'Hover mouse',\n    description: 'Hover over element on page',\n    inputSchema: elementSchema,\n    type: 'input',\n  },\n\n  handle: async (tab, params, response) => {\n    response.setIncludeSnapshot();\n\n    const { locator, resolved } = await tab.refLocator(params);\n\n    let usedAllowIntercept = false;\n    await tab.waitForCompletion(async () => {\n      const result = await retryWithAllowIntercept(\n        async (opts) => await locator.hover(opts),\n        {}\n      );\n      usedAllowIntercept = result.usedAllowIntercept;\n    });\n\n    const optionsAttr = usedAllowIntercept ? '{ allowIntercept: true }' : '';\n    response.addCode(`await page.${resolved}.hover(${optionsAttr});`);\n  },\n});\n\nconst selectOptionSchema = elementSchema.extend({\n  values: z.array(z.string()).describe('Array of values to select in the dropdown. This can be a single value or multiple values.'),\n});\n\nconst selectOption = defineTabTool({\n  capability: 'core',\n  schema: {\n    name: 'browser_select_option',\n    title: 'Select option',\n    description: 'Select an option in a dropdown',\n    inputSchema: selectOptionSchema,\n    type: 'input',\n  },\n\n  handle: async (tab, params, response) => {\n    response.setIncludeSnapshot();\n\n    const { locator, resolved } = await tab.refLocator(params);\n    response.addCode(`await page.${resolved}.selectOption(${javascript.formatObject(params.values)});`);\n\n    await tab.waitForCompletion(async () => {\n      await locator.selectOption(params.values);\n    });\n  },\n});\n\nconst pickLocator = defineTabTool({\n  capability: 'testing',\n  schema: {\n    name: 'browser_generate_locator',\n    title: 'Create locator for element',\n    description: 'Generate locator for the given element to use in tests',\n    inputSchema: elementSchema,\n    type: 'readOnly',\n  },\n\n  handle: async (tab, params, response) => {\n    const { resolved } = await tab.refLocator(params);\n    response.addResult(resolved);\n  },\n});\n\nconst elementInspect = defineTool({\n  capability: 'core',\n  schema: {\n    name: 'browser_element_inspect',\n    title: 'Inspect element for testing',\n    description: 'Get element details for generating test assertions - returns suggested selector, HTML, and computed styles',\n    inputSchema: elementSchema,\n    type: 'readOnly',\n  },\n\n  handle: async (context, params, response) => {\n    await context.ensureTab();\n    const tab = context.currentTabOrDie();\n\n    const { locator } = await tab.refLocator(params);\n\n    let elementDetails: any;\n    const suggestedSelectors = (await generateLocators(locator)).map(s => `\\`page.${s}\\``).join('\\n');\n\n    try {\n      elementDetails = await locator.evaluate(element => {\n        const computedStyle = window.getComputedStyle(element);\n        return {\n          outerHTML: element.outerHTML,\n          tagName: element.tagName.toLowerCase(),\n          computedStyles: {\n            display: computedStyle.display,\n            visibility: computedStyle.visibility,\n            opacity: computedStyle.opacity,\n            position: computedStyle.position,\n            width: computedStyle.width,\n            height: computedStyle.height,\n            backgroundColor: computedStyle.backgroundColor,\n            color: computedStyle.color,\n            fontSize: computedStyle.fontSize,\n            fontFamily: computedStyle.fontFamily,\n            textAlign: computedStyle.textAlign,\n            border: computedStyle.border,\n            borderRadius: computedStyle.borderRadius,\n            margin: computedStyle.margin,\n            padding: computedStyle.padding,\n            overflow: computedStyle.overflow,\n            zIndex: computedStyle.zIndex,\n            transform: computedStyle.transform,\n          },\n          attributes: Array.from(element.attributes).reduce((acc, attr) => {\n            acc[attr.name] = attr.value;\n            return acc;\n          }, {} as Record<string, string>),\n          textContent: element.textContent?.trim() || '',\n          innerText: (element as HTMLElement).innerText?.trim() || '',\n          value: (element as HTMLInputElement).value || undefined,\n          checked: (element as HTMLInputElement).checked || undefined,\n          disabled: (element as HTMLInputElement).disabled || undefined,\n          readonly: (element as HTMLInputElement).readOnly || undefined,\n          bounds: element.getBoundingClientRect(),\n        };\n      });\n    } catch (error) {\n      response.addResult(`Error inspecting element \"${params.element}\": ${error instanceof Error ? error.message : String(error)}\n\nThis typically happens when:\n1. The element reference is no longer valid (element was removed)\n2. The page has navigated since the snapshot was taken\n3. The element is not accessible\n\nTry capturing a new snapshot with browser_snapshot and using the updated element reference.`);\n      return;\n    }\n    let result = `\n**Element:** ${params.element}\n**Suggested Playwright Selector:**\n${suggestedSelectors}\n\n**HTML:**\n\\`\\`\\`html\n${elementDetails.outerHTML}\n\\`\\`\\`\n\n**Key Computed Styles:**\n- Display: ${elementDetails.computedStyles.display}\n- Visibility: ${elementDetails.computedStyles.visibility}\n- Opacity: ${elementDetails.computedStyles.opacity}\n- Position: ${elementDetails.computedStyles.position}\n- Width: ${elementDetails.computedStyles.width}\n- Height: ${elementDetails.computedStyles.height}\n- Background Color: ${elementDetails.computedStyles.backgroundColor}\n- Color: ${elementDetails.computedStyles.color}\n\n**Element Properties:**\n- Tag: ${elementDetails.tagName}\n- Text Content: \"${elementDetails.textContent}\"\n- Inner Text: \"${elementDetails.innerText}\"`;\n    if (elementDetails.value !== undefined) {\n      result += `\\n- Value: \"${elementDetails.value}\"`;\n    }\n    if (elementDetails.checked !== undefined) {\n      result += `\\n- Checked: ${elementDetails.checked}`;\n    }\n    if (elementDetails.disabled !== undefined) {\n      result += `\\n- Disabled: ${elementDetails.disabled}`;\n    }\n    if (elementDetails.readonly !== undefined) {\n      result += `\\n- Read Only: ${elementDetails.readonly}`;\n    }\n    response.addResult(result);\n  },\n});\n\nexport default [\n  snapshot,\n  click,\n  drag,\n  hover,\n  selectOption,\n  pickLocator,\n  elementInspect,\n];\n"],
+  "mappings": "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",
+  "names": []
+}

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

@@ -0,0 +1,67 @@
+"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 tabs_exports = {};
+__export(tabs_exports, {
+  default: () => tabs_default
+});
+module.exports = __toCommonJS(tabs_exports);
+var import_bundle = require("../../sdk/bundle");
+var import_tool = require("./tool");
+const browserTabs = (0, import_tool.defineTool)({
+  capability: "core-tabs",
+  schema: {
+    name: "browser_tabs",
+    title: "Manage tabs",
+    description: "List, create, close, or select a browser tab.",
+    inputSchema: import_bundle.z.object({
+      action: import_bundle.z.enum(["list", "new", "close", "select"]).describe("Operation to perform"),
+      index: import_bundle.z.number().optional().describe("Tab index, used for close/select. If omitted for close, current tab is closed.")
+    }),
+    type: "action"
+  },
+  handle: async (context, params, response) => {
+    switch (params.action) {
+      case "list": {
+        await context.ensureTab();
+        response.setIncludeTabs();
+        return;
+      }
+      case "new": {
+        await context.newTab();
+        response.setIncludeTabs();
+        return;
+      }
+      case "close": {
+        await context.closeTab(params.index);
+        response.setIncludeSnapshot("full");
+        return;
+      }
+      case "select": {
+        if (params.index === void 0)
+          throw new Error("Tab index is required");
+        await context.selectTab(params.index);
+        response.setIncludeSnapshot("full");
+        return;
+      }
+    }
+  }
+});
+var tabs_default = [
+  browserTabs
+];

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/mcp/browser/tools/tabs.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 } from './tool';\n\nconst browserTabs = defineTool({\n  capability: 'core-tabs',\n\n  schema: {\n    name: 'browser_tabs',\n    title: 'Manage tabs',\n    description: 'List, create, close, or select a browser tab.',\n    inputSchema: z.object({\n      action: z.enum(['list', 'new', 'close', 'select']).describe('Operation to perform'),\n      index: z.number().optional().describe('Tab index, used for close/select. If omitted for close, current tab is closed.'),\n    }),\n    type: 'action',\n  },\n\n  handle: async (context, params, response) => {\n    switch (params.action) {\n      case 'list': {\n        await context.ensureTab();\n        response.setIncludeTabs();\n        return;\n      }\n      case 'new': {\n        await context.newTab();\n        response.setIncludeTabs();\n        return;\n      }\n      case 'close': {\n        await context.closeTab(params.index);\n        response.setIncludeSnapshot('full');\n        return;\n      }\n      case 'select': {\n        if (params.index === undefined)\n          throw new Error('Tab index is required');\n        await context.selectTab(params.index);\n        response.setIncludeSnapshot('full');\n        return;\n      }\n    }\n  },\n});\n\nexport default [\n  browserTabs,\n];\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAgBA,oBAAkB;AAClB,kBAA2B;AAE3B,MAAM,kBAAc,wBAAW;AAAA,EAC7B,YAAY;AAAA,EAEZ,QAAQ;AAAA,IACN,MAAM;AAAA,IACN,OAAO;AAAA,IACP,aAAa;AAAA,IACb,aAAa,gBAAE,OAAO;AAAA,MACpB,QAAQ,gBAAE,KAAK,CAAC,QAAQ,OAAO,SAAS,QAAQ,CAAC,EAAE,SAAS,sBAAsB;AAAA,MAClF,OAAO,gBAAE,OAAO,EAAE,SAAS,EAAE,SAAS,gFAAgF;AAAA,IACxH,CAAC;AAAA,IACD,MAAM;AAAA,EACR;AAAA,EAEA,QAAQ,OAAO,SAAS,QAAQ,aAAa;AAC3C,YAAQ,OAAO,QAAQ;AAAA,MACrB,KAAK,QAAQ;AACX,cAAM,QAAQ,UAAU;AACxB,iBAAS,eAAe;AACxB;AAAA,MACF;AAAA,MACA,KAAK,OAAO;AACV,cAAM,QAAQ,OAAO;AACrB,iBAAS,eAAe;AACxB;AAAA,MACF;AAAA,MACA,KAAK,SAAS;AACZ,cAAM,QAAQ,SAAS,OAAO,KAAK;AACnC,iBAAS,mBAAmB,MAAM;AAClC;AAAA,MACF;AAAA,MACA,KAAK,UAAU;AACb,YAAI,OAAO,UAAU;AACnB,gBAAM,IAAI,MAAM,uBAAuB;AACzC,cAAM,QAAQ,UAAU,OAAO,KAAK;AACpC,iBAAS,mBAAmB,MAAM;AAClC;AAAA,MACF;AAAA,IACF;AAAA,EACF;AACF,CAAC;AAED,IAAO,eAAQ;AAAA,EACb;AACF;",
+  "names": []
+}

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

@@ -0,0 +1,49 @@
+"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 tool_exports = {};
+__export(tool_exports, {
+  defineTabTool: () => defineTabTool,
+  defineTool: () => defineTool
+});
+module.exports = __toCommonJS(tool_exports);
+function defineTool(tool) {
+  return tool;
+}
+function defineTabTool(tool) {
+  return {
+    ...tool,
+    handle: async (context, params, response) => {
+      const tab = await context.ensureTab();
+      const modalStates = tab.modalStates().map((state) => state.type);
+      if (tool.clearsModalState && !modalStates.includes(tool.clearsModalState))
+        response.addError(`Error: The tool "${tool.schema.name}" can only be used when there is related modal state present.
+` + tab.modalStatesMarkdown().join("\n"));
+      else if (!tool.clearsModalState && modalStates.length)
+        response.addError(`Error: Tool "${tool.schema.name}" does not handle the modal state.
+` + tab.modalStatesMarkdown().join("\n"));
+      else
+        return tool.handle(tab, params, response);
+    }
+  };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  defineTabTool,
+  defineTool
+});

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/mcp/browser/tools/tool.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 type { z } from 'zod';\nimport type { Context } from '../context';\nimport type * as playwright from 'playwright-core';\nimport type { ToolCapability } from '../../config';\nimport type { Tab } from '../tab';\nimport type { Response } from '../response';\nimport type { ToolSchema } from '../../sdk/tool';\n\nexport type FileUploadModalState = {\n  type: 'fileChooser';\n  description: string;\n  fileChooser: playwright.FileChooser;\n  clearedBy: string;\n};\n\nexport type DialogModalState = {\n  type: 'dialog';\n  description: string;\n  dialog: playwright.Dialog;\n  clearedBy: string;\n};\n\nexport type ModalState = FileUploadModalState | DialogModalState;\n\nexport type Tool<Input extends z.Schema = z.Schema> = {\n  capability: ToolCapability;\n  schema: ToolSchema<Input>;\n  handle: (context: Context, params: z.output<Input>, response: Response) => Promise<void>;\n};\n\nexport function defineTool<Input extends z.Schema>(tool: Tool<Input>): Tool<Input> {\n  return tool;\n}\n\nexport type TabTool<Input extends z.Schema = z.Schema> = {\n  capability: ToolCapability;\n  schema: ToolSchema<Input>;\n  clearsModalState?: ModalState['type'];\n  handle: (tab: Tab, params: z.output<Input>, response: Response) => Promise<void>;\n};\n\nexport function defineTabTool<Input extends z.Schema>(tool: TabTool<Input>): Tool<Input> {\n  return {\n    ...tool,\n    handle: async (context, params, response) => {\n      const tab = await context.ensureTab();\n      const modalStates = tab.modalStates().map(state => state.type);\n      if (tool.clearsModalState && !modalStates.includes(tool.clearsModalState))\n        response.addError(`Error: The tool \"${tool.schema.name}\" can only be used when there is related modal state present.\\n` + tab.modalStatesMarkdown().join('\\n'));\n      else if (!tool.clearsModalState && modalStates.length)\n        response.addError(`Error: Tool \"${tool.schema.name}\" does not handle the modal state.\\n` + tab.modalStatesMarkdown().join('\\n'));\n      else\n        return tool.handle(tab, params, response);\n    },\n  };\n}\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AA8CO,SAAS,WAAmC,MAAgC;AACjF,SAAO;AACT;AASO,SAAS,cAAsC,MAAmC;AACvF,SAAO;AAAA,IACL,GAAG;AAAA,IACH,QAAQ,OAAO,SAAS,QAAQ,aAAa;AAC3C,YAAM,MAAM,MAAM,QAAQ,UAAU;AACpC,YAAM,cAAc,IAAI,YAAY,EAAE,IAAI,WAAS,MAAM,IAAI;AAC7D,UAAI,KAAK,oBAAoB,CAAC,YAAY,SAAS,KAAK,gBAAgB;AACtE,iBAAS,SAAS,oBAAoB,KAAK,OAAO,IAAI;AAAA,IAAoE,IAAI,oBAAoB,EAAE,KAAK,IAAI,CAAC;AAAA,eACvJ,CAAC,KAAK,oBAAoB,YAAY;AAC7C,iBAAS,SAAS,gBAAgB,KAAK,OAAO,IAAI;AAAA,IAAyC,IAAI,oBAAoB,EAAE,KAAK,IAAI,CAAC;AAAA;AAE/H,eAAO,KAAK,OAAO,KAAK,QAAQ,QAAQ;AAAA,IAC5C;AAAA,EACF;AACF;",
+  "names": []
+}

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

@@ -0,0 +1,74 @@
+"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 tracing_exports = {};
+__export(tracing_exports, {
+  default: () => tracing_default
+});
+module.exports = __toCommonJS(tracing_exports);
+var import_bundle = require("../../sdk/bundle");
+var import_tool = require("./tool");
+const tracingStart = (0, import_tool.defineTool)({
+  capability: "tracing",
+  schema: {
+    name: "browser_start_tracing",
+    title: "Start tracing",
+    description: "Start trace recording",
+    inputSchema: import_bundle.z.object({}),
+    type: "readOnly"
+  },
+  handle: async (context, params, response) => {
+    const browserContext = await context.ensureBrowserContext();
+    const tracesDir = await context.outputFile(`traces`, { origin: "code", reason: "Collecting trace" });
+    const name = "trace-" + Date.now();
+    await browserContext.tracing.start({
+      name,
+      screenshots: true,
+      snapshots: true,
+      _live: true
+    });
+    const traceLegend = `- Action log: ${tracesDir}/${name}.trace
+- Network log: ${tracesDir}/${name}.network
+- Resources with content by sha1: ${tracesDir}/resources`;
+    response.addResult(`Tracing started, saving to ${tracesDir}.
+${traceLegend}`);
+    browserContext.tracing[traceLegendSymbol] = traceLegend;
+  }
+});
+const tracingStop = (0, import_tool.defineTool)({
+  capability: "tracing",
+  schema: {
+    name: "browser_stop_tracing",
+    title: "Stop tracing",
+    description: "Stop trace recording",
+    inputSchema: import_bundle.z.object({}),
+    type: "readOnly"
+  },
+  handle: async (context, params, response) => {
+    const browserContext = await context.ensureBrowserContext();
+    await browserContext.tracing.stop();
+    const traceLegend = browserContext.tracing[traceLegendSymbol];
+    response.addResult(`Tracing stopped.
+${traceLegend}`);
+  }
+});
+var tracing_default = [
+  tracingStart,
+  tracingStop
+];
+const traceLegendSymbol = Symbol("tracesDir");

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/mcp/browser/tools/tracing.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 } from './tool';\n\nimport type { Tracing } from '../../../../../playwright-core/src/client/tracing';\n\nconst tracingStart = defineTool({\n  capability: 'tracing',\n\n  schema: {\n    name: 'browser_start_tracing',\n    title: 'Start tracing',\n    description: 'Start trace recording',\n    inputSchema: z.object({}),\n    type: 'readOnly',\n  },\n\n  handle: async (context, params, response) => {\n    const browserContext = await context.ensureBrowserContext();\n    const tracesDir = await context.outputFile(`traces`, { origin: 'code', reason: 'Collecting trace' });\n    const name = 'trace-' + Date.now();\n    await (browserContext.tracing as Tracing).start({\n      name,\n      screenshots: true,\n      snapshots: true,\n      _live: true,\n    });\n    const traceLegend = `- Action log: ${tracesDir}/${name}.trace\n- Network log: ${tracesDir}/${name}.network\n- Resources with content by sha1: ${tracesDir}/resources`;\n\n    response.addResult(`Tracing started, saving to ${tracesDir}.\\n${traceLegend}`);\n    (browserContext.tracing as any)[traceLegendSymbol] = traceLegend;\n  },\n});\n\nconst tracingStop = defineTool({\n  capability: 'tracing',\n\n  schema: {\n    name: 'browser_stop_tracing',\n    title: 'Stop tracing',\n    description: 'Stop trace recording',\n    inputSchema: z.object({}),\n    type: 'readOnly',\n  },\n\n  handle: async (context, params, response) => {\n    const browserContext = await context.ensureBrowserContext();\n    await browserContext.tracing.stop();\n    const traceLegend = (browserContext.tracing as any)[traceLegendSymbol];\n    response.addResult(`Tracing stopped.\\n${traceLegend}`);\n  },\n});\n\nexport default [\n  tracingStart,\n  tracingStop,\n];\n\nconst traceLegendSymbol = Symbol('tracesDir');\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAgBA,oBAAkB;AAClB,kBAA2B;AAI3B,MAAM,mBAAe,wBAAW;AAAA,EAC9B,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,SAAS,QAAQ,aAAa;AAC3C,UAAM,iBAAiB,MAAM,QAAQ,qBAAqB;AAC1D,UAAM,YAAY,MAAM,QAAQ,WAAW,UAAU,EAAE,QAAQ,QAAQ,QAAQ,mBAAmB,CAAC;AACnG,UAAM,OAAO,WAAW,KAAK,IAAI;AACjC,UAAO,eAAe,QAAoB,MAAM;AAAA,MAC9C;AAAA,MACA,aAAa;AAAA,MACb,WAAW;AAAA,MACX,OAAO;AAAA,IACT,CAAC;AACD,UAAM,cAAc,iBAAiB,SAAS,IAAI,IAAI;AAAA,iBACzC,SAAS,IAAI,IAAI;AAAA,oCACE,SAAS;AAEzC,aAAS,UAAU,8BAA8B,SAAS;AAAA,EAAM,WAAW,EAAE;AAC7E,IAAC,eAAe,QAAgB,iBAAiB,IAAI;AAAA,EACvD;AACF,CAAC;AAED,MAAM,kBAAc,wBAAW;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,SAAS,QAAQ,aAAa;AAC3C,UAAM,iBAAiB,MAAM,QAAQ,qBAAqB;AAC1D,UAAM,eAAe,QAAQ,KAAK;AAClC,UAAM,cAAe,eAAe,QAAgB,iBAAiB;AACrE,aAAS,UAAU;AAAA,EAAqB,WAAW,EAAE;AAAA,EACvD;AACF,CAAC;AAED,IAAO,kBAAQ;AAAA,EACb;AAAA,EACA;AACF;AAEA,MAAM,oBAAoB,OAAO,WAAW;",
+  "names": []
+}