@one2x/playwright 1.57.0-alpha.1

package/lib/mcp/browser/sessionLog.js

@@ -0,0 +1,160 @@
+"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 sessionLog_exports = {};
+__export(sessionLog_exports, {
+  SessionLog: () => SessionLog
+});
+module.exports = __toCommonJS(sessionLog_exports);
+var import_fs = __toESM(require("fs"));
+var import_path = __toESM(require("path"));
+var import_log = require("../log");
+var import_config = require("./config");
+class SessionLog {
+  constructor(sessionFolder) {
+    this._ordinal = 0;
+    this._pendingEntries = [];
+    this._sessionFileQueue = Promise.resolve();
+    this._folder = sessionFolder;
+    this._file = import_path.default.join(this._folder, "session.md");
+  }
+  static async create(config, clientInfo) {
+    const sessionFolder = await (0, import_config.outputFile)(config, clientInfo, `session-${Date.now()}`, { origin: "code", reason: "Saving session" });
+    await import_fs.default.promises.mkdir(sessionFolder, { recursive: true });
+    console.error(`Session: ${sessionFolder}`);
+    return new SessionLog(sessionFolder);
+  }
+  logResponse(response) {
+    const entry = {
+      timestamp: performance.now(),
+      toolCall: {
+        toolName: response.toolName,
+        toolArgs: response.toolArgs,
+        result: response.result(),
+        isError: response.isError()
+      },
+      code: response.code(),
+      tabSnapshot: response.tabSnapshot()
+    };
+    this._appendEntry(entry);
+  }
+  logUserAction(action, tab, code, isUpdate) {
+    code = code.trim();
+    if (isUpdate) {
+      const lastEntry = this._pendingEntries[this._pendingEntries.length - 1];
+      if (lastEntry?.userAction?.name === action.name) {
+        lastEntry.userAction = action;
+        lastEntry.code = code;
+        return;
+      }
+    }
+    if (action.name === "navigate") {
+      const lastEntry = this._pendingEntries[this._pendingEntries.length - 1];
+      if (lastEntry?.tabSnapshot?.url === action.url)
+        return;
+    }
+    const entry = {
+      timestamp: performance.now(),
+      userAction: action,
+      code,
+      tabSnapshot: {
+        url: tab.page.url(),
+        title: "",
+        ariaSnapshot: action.ariaSnapshot || "",
+        modalStates: [],
+        consoleMessages: [],
+        downloads: []
+      }
+    };
+    this._appendEntry(entry);
+  }
+  _appendEntry(entry) {
+    this._pendingEntries.push(entry);
+    if (this._flushEntriesTimeout)
+      clearTimeout(this._flushEntriesTimeout);
+    this._flushEntriesTimeout = setTimeout(() => this._flushEntries(), 1e3);
+  }
+  async _flushEntries() {
+    clearTimeout(this._flushEntriesTimeout);
+    const entries = this._pendingEntries;
+    this._pendingEntries = [];
+    const lines = [""];
+    for (const entry of entries) {
+      const ordinal = (++this._ordinal).toString().padStart(3, "0");
+      if (entry.toolCall) {
+        lines.push(
+          `### Tool call: ${entry.toolCall.toolName}`,
+          `- Args`,
+          "```json",
+          JSON.stringify(entry.toolCall.toolArgs, null, 2),
+          "```"
+        );
+        if (entry.toolCall.result) {
+          lines.push(
+            entry.toolCall.isError ? `- Error` : `- Result`,
+            "```",
+            entry.toolCall.result,
+            "```"
+          );
+        }
+      }
+      if (entry.userAction) {
+        const actionData = { ...entry.userAction };
+        delete actionData.ariaSnapshot;
+        delete actionData.selector;
+        delete actionData.signals;
+        lines.push(
+          `### User action: ${entry.userAction.name}`,
+          `- Args`,
+          "```json",
+          JSON.stringify(actionData, null, 2),
+          "```"
+        );
+      }
+      if (entry.code) {
+        lines.push(
+          `- Code`,
+          "```js",
+          entry.code,
+          "```"
+        );
+      }
+      if (entry.tabSnapshot) {
+        const fileName = `${ordinal}.snapshot.yml`;
+        import_fs.default.promises.writeFile(import_path.default.join(this._folder, fileName), entry.tabSnapshot.ariaSnapshot).catch(import_log.logUnhandledError);
+        lines.push(`- Snapshot: ${fileName}`);
+      }
+      lines.push("", "");
+    }
+    this._sessionFileQueue = this._sessionFileQueue.then(() => import_fs.default.promises.appendFile(this._file, lines.join("\n")));
+  }
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  SessionLog
+});

package/lib/mcp/browser/sessionLog.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/mcp/browser/sessionLog.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';\nimport path from 'path';\n\nimport { Response } from './response';\nimport { logUnhandledError } from '../log';\nimport { outputFile  } from './config';\n\nimport type { FullConfig } from './config';\nimport type * as actions from './actions';\nimport type { Tab, TabSnapshot } from './tab';\nimport type * as mcpServer from '../sdk/server';\n\ntype LogEntry = {\n  timestamp: number;\n  toolCall?: {\n    toolName: string;\n    toolArgs: Record<string, any>;\n    result: string;\n    isError?: boolean;\n  };\n  userAction?: actions.Action;\n  code: string;\n  tabSnapshot?: TabSnapshot;\n};\n\nexport class SessionLog {\n  private _folder: string;\n  private _file: string;\n  private _ordinal = 0;\n  private _pendingEntries: LogEntry[] = [];\n  private _sessionFileQueue = Promise.resolve();\n  private _flushEntriesTimeout: NodeJS.Timeout | undefined;\n\n  constructor(sessionFolder: string) {\n    this._folder = sessionFolder;\n    this._file = path.join(this._folder, 'session.md');\n  }\n\n  static async create(config: FullConfig, clientInfo: mcpServer.ClientInfo): Promise<SessionLog> {\n    const sessionFolder = await outputFile(config, clientInfo, `session-${Date.now()}`, { origin: 'code', reason: 'Saving session' });\n    await fs.promises.mkdir(sessionFolder, { recursive: true });\n    // eslint-disable-next-line no-console\n    console.error(`Session: ${sessionFolder}`);\n    return new SessionLog(sessionFolder);\n  }\n\n  logResponse(response: Response) {\n    const entry: LogEntry = {\n      timestamp: performance.now(),\n      toolCall: {\n        toolName: response.toolName,\n        toolArgs: response.toolArgs,\n        result: response.result(),\n        isError: response.isError(),\n      },\n      code: response.code(),\n      tabSnapshot: response.tabSnapshot(),\n    };\n    this._appendEntry(entry);\n  }\n\n  logUserAction(action: actions.Action, tab: Tab, code: string, isUpdate: boolean) {\n    code = code.trim();\n    if (isUpdate) {\n      const lastEntry = this._pendingEntries[this._pendingEntries.length - 1];\n      if (lastEntry?.userAction?.name === action.name) {\n        lastEntry.userAction = action;\n        lastEntry.code = code;\n        return;\n      }\n    }\n    if (action.name === 'navigate') {\n      // Already logged at this location.\n      const lastEntry = this._pendingEntries[this._pendingEntries.length - 1];\n      if (lastEntry?.tabSnapshot?.url === action.url)\n        return;\n    }\n    const entry: LogEntry = {\n      timestamp: performance.now(),\n      userAction: action,\n      code,\n      tabSnapshot: {\n        url: tab.page.url(),\n        title: '',\n        ariaSnapshot: action.ariaSnapshot || '',\n        modalStates: [],\n        consoleMessages: [],\n        downloads: [],\n      },\n    };\n    this._appendEntry(entry);\n  }\n\n  private _appendEntry(entry: LogEntry) {\n    this._pendingEntries.push(entry);\n    if (this._flushEntriesTimeout)\n      clearTimeout(this._flushEntriesTimeout);\n    this._flushEntriesTimeout = setTimeout(() => this._flushEntries(), 1000);\n  }\n\n  private async _flushEntries() {\n    clearTimeout(this._flushEntriesTimeout);\n    const entries = this._pendingEntries;\n    this._pendingEntries = [];\n    const lines: string[] = [''];\n\n    for (const entry of entries) {\n      const ordinal = (++this._ordinal).toString().padStart(3, '0');\n      if (entry.toolCall) {\n        lines.push(\n            `### Tool call: ${entry.toolCall.toolName}`,\n            `- Args`,\n            '```json',\n            JSON.stringify(entry.toolCall.toolArgs, null, 2),\n            '```',\n        );\n        if (entry.toolCall.result) {\n          lines.push(\n              entry.toolCall.isError ? `- Error` : `- Result`,\n              '```',\n              entry.toolCall.result,\n              '```',\n          );\n        }\n      }\n\n      if (entry.userAction) {\n        const actionData = { ...entry.userAction } as any;\n        delete actionData.ariaSnapshot;\n        delete actionData.selector;\n        delete actionData.signals;\n\n        lines.push(\n            `### User action: ${entry.userAction.name}`,\n            `- Args`,\n            '```json',\n            JSON.stringify(actionData, null, 2),\n            '```',\n        );\n      }\n\n      if (entry.code) {\n        lines.push(\n            `- Code`,\n            '```js',\n            entry.code,\n            '```');\n      }\n\n      if (entry.tabSnapshot) {\n        const fileName = `${ordinal}.snapshot.yml`;\n        fs.promises.writeFile(path.join(this._folder, fileName), entry.tabSnapshot.ariaSnapshot).catch(logUnhandledError);\n        lines.push(`- Snapshot: ${fileName}`);\n      }\n\n      lines.push('', '');\n    }\n\n    this._sessionFileQueue = this._sessionFileQueue.then(() => fs.promises.appendFile(this._file, lines.join('\\n')));\n  }\n}\n"],
+  "mappings": "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",
+  "names": ["path", "fs"]
+}

package/lib/mcp/browser/tab.js

@@ -0,0 +1,280 @@
+"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 tab_exports = {};
+__export(tab_exports, {
+  Tab: () => Tab,
+  TabEvents: () => TabEvents,
+  renderModalStates: () => renderModalStates
+});
+module.exports = __toCommonJS(tab_exports);
+var import_events = require("events");
+var import_utils = require("playwright-core/lib/utils");
+var import_utils2 = require("./tools/utils");
+var import_log = require("../log");
+var import_dialogs = require("./tools/dialogs");
+var import_files = require("./tools/files");
+const TabEvents = {
+  modalState: "modalState"
+};
+class Tab extends import_events.EventEmitter {
+  constructor(context, page, onPageClose) {
+    super();
+    this._lastTitle = "about:blank";
+    this._consoleMessages = [];
+    this._recentConsoleMessages = [];
+    this._requests = /* @__PURE__ */ new Set();
+    this._modalStates = [];
+    this._downloads = [];
+    this.context = context;
+    this.page = page;
+    this._onPageClose = onPageClose;
+    page.on("console", (event) => this._handleConsoleMessage(messageToConsoleMessage(event)));
+    page.on("pageerror", (error) => this._handleConsoleMessage(pageErrorToConsoleMessage(error)));
+    page.on("request", (request) => this._requests.add(request));
+    page.on("close", () => this._onClose());
+    page.on("filechooser", (chooser) => {
+      this.setModalState({
+        type: "fileChooser",
+        description: "File chooser",
+        fileChooser: chooser,
+        clearedBy: import_files.uploadFile.schema.name
+      });
+    });
+    page.on("dialog", (dialog) => this._dialogShown(dialog));
+    page.on("download", (download) => {
+      void this._downloadStarted(download);
+    });
+    page.setDefaultNavigationTimeout(this.context.config.timeouts.navigation);
+    page.setDefaultTimeout(this.context.config.timeouts.action);
+    page[tabSymbol] = this;
+    this._initializedPromise = this._initialize();
+  }
+  static forPage(page) {
+    return page[tabSymbol];
+  }
+  static async collectConsoleMessages(page) {
+    const result = [];
+    const messages = await page.consoleMessages().catch(() => []);
+    for (const message of messages)
+      result.push(messageToConsoleMessage(message));
+    const errors = await page.pageErrors().catch(() => []);
+    for (const error of errors)
+      result.push(pageErrorToConsoleMessage(error));
+    return result;
+  }
+  async _initialize() {
+    for (const message of await Tab.collectConsoleMessages(this.page))
+      this._handleConsoleMessage(message);
+    const requests = await this.page.requests().catch(() => []);
+    for (const request of requests)
+      this._requests.add(request);
+  }
+  modalStates() {
+    return this._modalStates;
+  }
+  setModalState(modalState) {
+    this._modalStates.push(modalState);
+    this.emit(TabEvents.modalState, modalState);
+  }
+  clearModalState(modalState) {
+    this._modalStates = this._modalStates.filter((state) => state !== modalState);
+  }
+  modalStatesMarkdown() {
+    return renderModalStates(this.context, this.modalStates());
+  }
+  _dialogShown(dialog) {
+    this.setModalState({
+      type: "dialog",
+      description: `"${dialog.type()}" dialog with message "${dialog.message()}"`,
+      dialog,
+      clearedBy: import_dialogs.handleDialog.schema.name
+    });
+  }
+  async _downloadStarted(download) {
+    const entry = {
+      download,
+      finished: false,
+      outputFile: await this.context.outputFile(download.suggestedFilename(), { origin: "web", reason: "Saving download" })
+    };
+    this._downloads.push(entry);
+    await download.saveAs(entry.outputFile);
+    entry.finished = true;
+  }
+  _clearCollectedArtifacts() {
+    this._consoleMessages.length = 0;
+    this._recentConsoleMessages.length = 0;
+    this._requests.clear();
+  }
+  _handleConsoleMessage(message) {
+    this._consoleMessages.push(message);
+    this._recentConsoleMessages.push(message);
+  }
+  _onClose() {
+    this._clearCollectedArtifacts();
+    this._onPageClose(this);
+  }
+  async updateTitle() {
+    await this._raceAgainstModalStates(async () => {
+      this._lastTitle = await (0, import_utils2.callOnPageNoTrace)(this.page, (page) => page.title());
+    });
+  }
+  lastTitle() {
+    return this._lastTitle;
+  }
+  isCurrentTab() {
+    return this === this.context.currentTab();
+  }
+  async waitForLoadState(state, options) {
+    await (0, import_utils2.callOnPageNoTrace)(this.page, (page) => page.waitForLoadState(state, options).catch(import_log.logUnhandledError));
+  }
+  async navigate(url) {
+    this._clearCollectedArtifacts();
+    const downloadEvent = (0, import_utils2.callOnPageNoTrace)(this.page, (page) => page.waitForEvent("download").catch(import_log.logUnhandledError));
+    try {
+      await this.page.goto(url, { waitUntil: "domcontentloaded" });
+    } catch (_e) {
+      const e = _e;
+      const mightBeDownload = e.message.includes("net::ERR_ABORTED") || e.message.includes("Download is starting");
+      if (!mightBeDownload)
+        throw e;
+      const download = await Promise.race([
+        downloadEvent,
+        new Promise((resolve) => setTimeout(resolve, 3e3))
+      ]);
+      if (!download)
+        throw e;
+      await new Promise((resolve) => setTimeout(resolve, 500));
+      return;
+    }
+    await this.waitForLoadState("load", { timeout: 5e3 });
+  }
+  async consoleMessages(type) {
+    await this._initializedPromise;
+    return this._consoleMessages.filter((message) => type ? message.type === type : true);
+  }
+  async requests() {
+    await this._initializedPromise;
+    return this._requests;
+  }
+  async captureSnapshot(mode) {
+    let tabSnapshot;
+    const modalStates = await this._raceAgainstModalStates(async () => {
+      const snapshot = await this.page._snapshotForAI({ mode, track: "response" });
+      tabSnapshot = {
+        url: this.page.url(),
+        title: await this.page.title(),
+        ariaSnapshot: snapshot,
+        modalStates: [],
+        consoleMessages: [],
+        downloads: this._downloads
+      };
+    });
+    if (tabSnapshot) {
+      tabSnapshot.consoleMessages = this._recentConsoleMessages;
+      this._recentConsoleMessages = [];
+    }
+    return tabSnapshot ?? {
+      url: this.page.url(),
+      title: "",
+      ariaSnapshot: "",
+      modalStates,
+      consoleMessages: [],
+      downloads: []
+    };
+  }
+  _javaScriptBlocked() {
+    return this._modalStates.some((state) => state.type === "dialog");
+  }
+  async _raceAgainstModalStates(action) {
+    if (this.modalStates().length)
+      return this.modalStates();
+    const promise = new import_utils.ManualPromise();
+    const listener = (modalState) => promise.resolve([modalState]);
+    this.once(TabEvents.modalState, listener);
+    return await Promise.race([
+      action().then(() => {
+        this.off(TabEvents.modalState, listener);
+        return [];
+      }),
+      promise
+    ]);
+  }
+  async waitForCompletion(callback) {
+    await this._raceAgainstModalStates(() => (0, import_utils2.waitForCompletion)(this, callback));
+  }
+  async refLocator(params) {
+    return (await this.refLocators([params]))[0];
+  }
+  async refLocators(params) {
+    return Promise.all(params.map(async (param) => {
+      try {
+        const locator = this.page.locator(`aria-ref=${param.ref}`).describe(param.element);
+        const { resolvedSelector } = await locator._resolveSelector();
+        return { locator, resolved: (0, import_utils.asLocator)("javascript", resolvedSelector) };
+      } catch (e) {
+        throw new Error(`Ref ${param.ref} not found in the current page snapshot. Try capturing new snapshot.`);
+      }
+    }));
+  }
+  async waitForTimeout(time) {
+    if (this._javaScriptBlocked()) {
+      await new Promise((f) => setTimeout(f, time));
+      return;
+    }
+    await (0, import_utils2.callOnPageNoTrace)(this.page, (page) => {
+      return page.evaluate(() => new Promise((f) => setTimeout(f, 1e3)));
+    });
+  }
+}
+function messageToConsoleMessage(message) {
+  return {
+    type: message.type(),
+    text: message.text(),
+    toString: () => `[${message.type().toUpperCase()}] ${message.text()} @ ${message.location().url}:${message.location().lineNumber}`
+  };
+}
+function pageErrorToConsoleMessage(errorOrValue) {
+  if (errorOrValue instanceof Error) {
+    return {
+      type: "error",
+      text: errorOrValue.message,
+      toString: () => errorOrValue.stack || errorOrValue.message
+    };
+  }
+  return {
+    type: "error",
+    text: String(errorOrValue),
+    toString: () => String(errorOrValue)
+  };
+}
+function renderModalStates(context, modalStates) {
+  const result = ["### Modal state"];
+  if (modalStates.length === 0)
+    result.push("- There is no modal state present");
+  for (const state of modalStates)
+    result.push(`- [${state.description}]: can be handled by the "${state.clearedBy}" tool`);
+  return result;
+}
+const tabSymbol = Symbol("tabSymbol");
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  Tab,
+  TabEvents,
+  renderModalStates
+});

package/lib/mcp/browser/tab.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/mcp/browser/tab.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 { EventEmitter } from 'events';\nimport * as playwright from 'playwright-core';\nimport { asLocator, ManualPromise } from 'playwright-core/lib/utils';\n\nimport { callOnPageNoTrace, waitForCompletion } from './tools/utils';\nimport { logUnhandledError } from '../log';\nimport { ModalState } from './tools/tool';\nimport { handleDialog } from './tools/dialogs';\nimport { uploadFile } from './tools/files';\n\nimport type { Context } from './context';\nimport type { Page } from '../../../../playwright-core/src/client/page';\nimport type { Locator } from '../../../../playwright-core/src/client/locator';\n\nexport const TabEvents = {\n  modalState: 'modalState'\n};\n\nexport type TabEventsInterface = {\n  [TabEvents.modalState]: [modalState: ModalState];\n};\n\nexport type TabSnapshot = {\n  url: string;\n  title: string;\n  ariaSnapshot: string;\n  modalStates: ModalState[];\n  consoleMessages: ConsoleMessage[];\n  downloads: { download: playwright.Download, finished: boolean, outputFile: string }[];\n};\n\nexport class Tab extends EventEmitter<TabEventsInterface> {\n  readonly context: Context;\n  readonly page: Page;\n  private _lastTitle = 'about:blank';\n  private _consoleMessages: ConsoleMessage[] = [];\n  private _recentConsoleMessages: ConsoleMessage[] = [];\n  private _requests: Set<playwright.Request> = new Set();\n  private _onPageClose: (tab: Tab) => void;\n  private _modalStates: ModalState[] = [];\n  private _downloads: { download: playwright.Download, finished: boolean, outputFile: string }[] = [];\n  private _initializedPromise: Promise<void>;\n\n  constructor(context: Context, page: playwright.Page, onPageClose: (tab: Tab) => void) {\n    super();\n    this.context = context;\n    this.page = page as Page;\n    this._onPageClose = onPageClose;\n    page.on('console', event => this._handleConsoleMessage(messageToConsoleMessage(event)));\n    page.on('pageerror', error => this._handleConsoleMessage(pageErrorToConsoleMessage(error)));\n    page.on('request', request => this._requests.add(request));\n    page.on('close', () => this._onClose());\n    page.on('filechooser', chooser => {\n      this.setModalState({\n        type: 'fileChooser',\n        description: 'File chooser',\n        fileChooser: chooser,\n        clearedBy: uploadFile.schema.name,\n      });\n    });\n    page.on('dialog', dialog => this._dialogShown(dialog));\n    page.on('download', download => {\n      void this._downloadStarted(download);\n    });\n    page.setDefaultNavigationTimeout(this.context.config.timeouts.navigation);\n    page.setDefaultTimeout(this.context.config.timeouts.action);\n    (page as any)[tabSymbol] = this;\n    this._initializedPromise = this._initialize();\n  }\n\n  static forPage(page: playwright.Page): Tab | undefined {\n    return (page as any)[tabSymbol];\n  }\n\n  static async collectConsoleMessages(page: playwright.Page): Promise<ConsoleMessage[]> {\n    const result: ConsoleMessage[] = [];\n    const messages = await page.consoleMessages().catch(() => []);\n    for (const message of messages)\n      result.push(messageToConsoleMessage(message));\n    const errors = await page.pageErrors().catch(() => []);\n    for (const error of errors)\n      result.push(pageErrorToConsoleMessage(error));\n    return result;\n  }\n\n  private async _initialize() {\n    for (const message of await Tab.collectConsoleMessages(this.page))\n      this._handleConsoleMessage(message);\n    const requests = await this.page.requests().catch(() => []);\n    for (const request of requests)\n      this._requests.add(request);\n  }\n\n  modalStates(): ModalState[] {\n    return this._modalStates;\n  }\n\n  setModalState(modalState: ModalState) {\n    this._modalStates.push(modalState);\n    this.emit(TabEvents.modalState, modalState);\n  }\n\n  clearModalState(modalState: ModalState) {\n    this._modalStates = this._modalStates.filter(state => state !== modalState);\n  }\n\n  modalStatesMarkdown(): string[] {\n    return renderModalStates(this.context, this.modalStates());\n  }\n\n  private _dialogShown(dialog: playwright.Dialog) {\n    this.setModalState({\n      type: 'dialog',\n      description: `\"${dialog.type()}\" dialog with message \"${dialog.message()}\"`,\n      dialog,\n      clearedBy: handleDialog.schema.name\n    });\n  }\n\n  private async _downloadStarted(download: playwright.Download) {\n    const entry = {\n      download,\n      finished: false,\n      outputFile: await this.context.outputFile(download.suggestedFilename(), { origin: 'web', reason: 'Saving download' })\n    };\n    this._downloads.push(entry);\n    await download.saveAs(entry.outputFile);\n    entry.finished = true;\n  }\n\n  private _clearCollectedArtifacts() {\n    this._consoleMessages.length = 0;\n    this._recentConsoleMessages.length = 0;\n    this._requests.clear();\n  }\n\n  private _handleConsoleMessage(message: ConsoleMessage) {\n    this._consoleMessages.push(message);\n    this._recentConsoleMessages.push(message);\n  }\n\n  private _onClose() {\n    this._clearCollectedArtifacts();\n    this._onPageClose(this);\n  }\n\n  async updateTitle() {\n    await this._raceAgainstModalStates(async () => {\n      this._lastTitle = await callOnPageNoTrace(this.page, page => page.title());\n    });\n  }\n\n  lastTitle(): string {\n    return this._lastTitle;\n  }\n\n  isCurrentTab(): boolean {\n    return this === this.context.currentTab();\n  }\n\n  async waitForLoadState(state: 'load', options?: { timeout?: number }): Promise<void> {\n    await callOnPageNoTrace(this.page, page => page.waitForLoadState(state, options).catch(logUnhandledError));\n  }\n\n  async navigate(url: string) {\n    this._clearCollectedArtifacts();\n\n    const downloadEvent = callOnPageNoTrace(this.page, page => page.waitForEvent('download').catch(logUnhandledError));\n    try {\n      await this.page.goto(url, { waitUntil: 'domcontentloaded' });\n    } catch (_e: unknown) {\n      const e = _e as Error;\n      const mightBeDownload =\n        e.message.includes('net::ERR_ABORTED') // chromium\n        || e.message.includes('Download is starting'); // firefox + webkit\n      if (!mightBeDownload)\n        throw e;\n      // on chromium, the download event is fired *after* page.goto rejects, so we wait a lil bit\n      const download = await Promise.race([\n        downloadEvent,\n        new Promise(resolve => setTimeout(resolve, 3000)),\n      ]);\n      if (!download)\n        throw e;\n      // Make sure other \"download\" listeners are notified first.\n      await new Promise(resolve => setTimeout(resolve, 500));\n      return;\n    }\n\n    // Cap load event to 5 seconds, the page is operational at this point.\n    await this.waitForLoadState('load', { timeout: 5000 });\n  }\n\n  async consoleMessages(type?: 'error'): Promise<ConsoleMessage[]> {\n    await this._initializedPromise;\n    return this._consoleMessages.filter(message => type ? message.type === type : true);\n  }\n\n  async requests(): Promise<Set<playwright.Request>> {\n    await this._initializedPromise;\n    return this._requests;\n  }\n\n  async captureSnapshot(mode: 'full' | 'incremental'): Promise<TabSnapshot> {\n    let tabSnapshot: TabSnapshot | undefined;\n    const modalStates = await this._raceAgainstModalStates(async () => {\n      const snapshot = await this.page._snapshotForAI({ mode, track: 'response' });\n      tabSnapshot = {\n        url: this.page.url(),\n        title: await this.page.title(),\n        ariaSnapshot: snapshot,\n        modalStates: [],\n        consoleMessages: [],\n        downloads: this._downloads,\n      };\n    });\n    if (tabSnapshot) {\n      // Assign console message late so that we did not lose any to modal state.\n      tabSnapshot.consoleMessages = this._recentConsoleMessages;\n      this._recentConsoleMessages = [];\n    }\n    return tabSnapshot ?? {\n      url: this.page.url(),\n      title: '',\n      ariaSnapshot: '',\n      modalStates,\n      consoleMessages: [],\n      downloads: [],\n    };\n  }\n\n  private _javaScriptBlocked(): boolean {\n    return this._modalStates.some(state => state.type === 'dialog');\n  }\n\n  private async _raceAgainstModalStates(action: () => Promise<void>): Promise<ModalState[]> {\n    if (this.modalStates().length)\n      return this.modalStates();\n\n    const promise = new ManualPromise<ModalState[]>();\n    const listener = (modalState: ModalState) => promise.resolve([modalState]);\n    this.once(TabEvents.modalState, listener);\n\n    return await Promise.race([\n      action().then(() => {\n        this.off(TabEvents.modalState, listener);\n        return [];\n      }),\n      promise,\n    ]);\n  }\n\n  async waitForCompletion(callback: () => Promise<void>) {\n    await this._raceAgainstModalStates(() => waitForCompletion(this, callback));\n  }\n\n  async refLocator(params: { element: string, ref: string }): Promise<{ locator: Locator, resolved: string }> {\n    return (await this.refLocators([params]))[0];\n  }\n\n  async refLocators(params: { element: string, ref: string }[]): Promise<{ locator: Locator, resolved: string }[]> {\n    return Promise.all(params.map(async param => {\n      try {\n        const locator = this.page.locator(`aria-ref=${param.ref}`).describe(param.element) as Locator;\n        const { resolvedSelector } = await locator._resolveSelector();\n        return { locator, resolved: asLocator('javascript', resolvedSelector) };\n      } catch (e) {\n        throw new Error(`Ref ${param.ref} not found in the current page snapshot. Try capturing new snapshot.`);\n      }\n    }));\n  }\n\n  async waitForTimeout(time: number) {\n    if (this._javaScriptBlocked()) {\n      await new Promise(f => setTimeout(f, time));\n      return;\n    }\n\n    await callOnPageNoTrace(this.page, page => {\n      return page.evaluate(() => new Promise(f => setTimeout(f, 1000)));\n    });\n  }\n}\n\nexport type ConsoleMessage = {\n  type: ReturnType<playwright.ConsoleMessage['type']> | undefined;\n  text: string;\n  toString(): string;\n};\n\nfunction messageToConsoleMessage(message: playwright.ConsoleMessage): ConsoleMessage {\n  return {\n    type: message.type(),\n    text: message.text(),\n    toString: () => `[${message.type().toUpperCase()}] ${message.text()} @ ${message.location().url}:${message.location().lineNumber}`,\n  };\n}\n\nfunction pageErrorToConsoleMessage(errorOrValue: Error | any): ConsoleMessage {\n  if (errorOrValue instanceof Error) {\n    return {\n      type: 'error',\n      text: errorOrValue.message,\n      toString: () => errorOrValue.stack || errorOrValue.message,\n    };\n  }\n  return {\n    type: 'error',\n    text: String(errorOrValue),\n    toString: () => String(errorOrValue),\n  };\n}\n\nexport function renderModalStates(context: Context, modalStates: ModalState[]): string[] {\n  const result: string[] = ['### Modal state'];\n  if (modalStates.length === 0)\n    result.push('- There is no modal state present');\n  for (const state of modalStates)\n    result.push(`- [${state.description}]: can be handled by the \"${state.clearedBy}\" tool`);\n  return result;\n}\n\nconst tabSymbol = Symbol('tabSymbol');\n"],
+  "mappings": "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",
+  "names": ["import_utils"]
+}

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

@@ -0,0 +1,40 @@
+"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 actionRetry_exports = {};
+__export(actionRetry_exports, {
+  retryWithAllowIntercept: () => retryWithAllowIntercept
+});
+module.exports = __toCommonJS(actionRetry_exports);
+async function retryWithAllowIntercept(action, options) {
+  try {
+    await action(options);
+    return { usedAllowIntercept: false };
+  } catch (error) {
+    if (error?.message?.includes("intercepts pointer events")) {
+      const optionsWithAllowIntercept = { ...options, allowIntercept: true };
+      await action(optionsWithAllowIntercept);
+      return { usedAllowIntercept: true };
+    }
+    throw error;
+  }
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  retryWithAllowIntercept
+});

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/mcp/browser/tools/actionRetry.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\n/**\n * Executes a locator action with automatic retry using allowIntercept option.\n *\n * First attempts the action with the provided options. If the action fails with\n * \"intercepts pointer events\" error, automatically retries with allowIntercept: true.\n *\n * @param action - Function that performs the locator action\n * @param options - Options to pass to the action\n * @returns Object indicating whether allowIntercept was used\n */\nexport async function retryWithAllowIntercept<Options extends Record<string, any>>(\n  action: (opts: Options) => Promise<void>,\n  options: Options\n): Promise<{ usedAllowIntercept: boolean }> {\n  try {\n    // First attempt without allowIntercept\n    await action(options);\n    return { usedAllowIntercept: false };\n  } catch (error: any) {\n    // Check if error is due to element being intercepted\n    if (error?.message?.includes('intercepts pointer events')) {\n      // Retry with allowIntercept enabled\n      const optionsWithAllowIntercept = { ...options, allowIntercept: true } as Options;\n      await action(optionsWithAllowIntercept);\n      return { usedAllowIntercept: true };\n    }\n    // Re-throw other errors\n    throw error;\n  }\n}\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AA0BA,eAAsB,wBACpB,QACA,SAC0C;AAC1C,MAAI;AAEF,UAAM,OAAO,OAAO;AACpB,WAAO,EAAE,oBAAoB,MAAM;AAAA,EACrC,SAAS,OAAY;AAEnB,QAAI,OAAO,SAAS,SAAS,2BAA2B,GAAG;AAEzD,YAAM,4BAA4B,EAAE,GAAG,SAAS,gBAAgB,KAAK;AACrE,YAAM,OAAO,yBAAyB;AACtC,aAAO,EAAE,oBAAoB,KAAK;AAAA,IACpC;AAEA,UAAM;AAAA,EACR;AACF;",
+  "names": []
+}

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

@@ -0,0 +1,63 @@
+"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 common_exports = {};
+__export(common_exports, {
+  default: () => common_default
+});
+module.exports = __toCommonJS(common_exports);
+var import_bundle = require("../../sdk/bundle");
+var import_tool = require("./tool");
+const close = (0, import_tool.defineTool)({
+  capability: "core",
+  schema: {
+    name: "browser_close",
+    title: "Close browser",
+    description: "Close the page",
+    inputSchema: import_bundle.z.object({}),
+    type: "action"
+  },
+  handle: async (context, params, response) => {
+    await context.closeBrowserContext();
+    response.setIncludeTabs();
+    response.addCode(`await page.close()`);
+  }
+});
+const resize = (0, import_tool.defineTabTool)({
+  capability: "core",
+  schema: {
+    name: "browser_resize",
+    title: "Resize browser window",
+    description: "Resize the browser window",
+    inputSchema: import_bundle.z.object({
+      width: import_bundle.z.number().describe("Width of the browser window"),
+      height: import_bundle.z.number().describe("Height of the browser window")
+    }),
+    type: "action"
+  },
+  handle: async (tab, params, response) => {
+    response.addCode(`await page.setViewportSize({ width: ${params.width}, height: ${params.height} });`);
+    await tab.waitForCompletion(async () => {
+      await tab.page.setViewportSize({ width: params.width, height: params.height });
+    });
+  }
+});
+var common_default = [
+  close,
+  resize
+];

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/mcp/browser/tools/common.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';\n\nconst close = defineTool({\n  capability: 'core',\n\n  schema: {\n    name: 'browser_close',\n    title: 'Close browser',\n    description: 'Close the page',\n    inputSchema: z.object({}),\n    type: 'action',\n  },\n\n  handle: async (context, params, response) => {\n    await context.closeBrowserContext();\n    response.setIncludeTabs();\n    response.addCode(`await page.close()`);\n  },\n});\n\nconst resize = defineTabTool({\n  capability: 'core',\n  schema: {\n    name: 'browser_resize',\n    title: 'Resize browser window',\n    description: 'Resize the browser window',\n    inputSchema: z.object({\n      width: z.number().describe('Width of the browser window'),\n      height: z.number().describe('Height of the browser window'),\n    }),\n    type: 'action',\n  },\n\n  handle: async (tab, params, response) => {\n    response.addCode(`await page.setViewportSize({ width: ${params.width}, height: ${params.height} });`);\n\n    await tab.waitForCompletion(async () => {\n      await tab.page.setViewportSize({ width: params.width, height: params.height });\n    });\n  },\n});\n\nexport default [\n  close,\n  resize\n];\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAgBA,oBAAkB;AAClB,kBAA0C;AAE1C,MAAM,YAAQ,wBAAW;AAAA,EACvB,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,QAAQ,oBAAoB;AAClC,aAAS,eAAe;AACxB,aAAS,QAAQ,oBAAoB;AAAA,EACvC;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;AAAA,MACpB,OAAO,gBAAE,OAAO,EAAE,SAAS,6BAA6B;AAAA,MACxD,QAAQ,gBAAE,OAAO,EAAE,SAAS,8BAA8B;AAAA,IAC5D,CAAC;AAAA,IACD,MAAM;AAAA,EACR;AAAA,EAEA,QAAQ,OAAO,KAAK,QAAQ,aAAa;AACvC,aAAS,QAAQ,uCAAuC,OAAO,KAAK,aAAa,OAAO,MAAM,MAAM;AAEpG,UAAM,IAAI,kBAAkB,YAAY;AACtC,YAAM,IAAI,KAAK,gBAAgB,EAAE,OAAO,OAAO,OAAO,QAAQ,OAAO,OAAO,CAAC;AAAA,IAC/E,CAAC;AAAA,EACH;AACF,CAAC;AAED,IAAO,iBAAQ;AAAA,EACb;AAAA,EACA;AACF;",
+  "names": []
+}