rae-playwright-mcp 0.0.1 → 0.0.2

package/lib/mcp/browser/browserContextFactory.js

@@ -0,0 +1,343 @@
+"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 browserContextFactory_exports = {};
+__export(browserContextFactory_exports, {
+  SharedContextFactory: () => SharedContextFactory,
+  contextFactory: () => contextFactory,
+  identityBrowserContextFactory: () => identityBrowserContextFactory
+});
+module.exports = __toCommonJS(browserContextFactory_exports);
+var import_crypto = __toESM(require("crypto"));
+var import_fs = __toESM(require("fs"));
+var import_net = __toESM(require("net"));
+var import_os = __toESM(require("os"));
+var import_path = __toESM(require("path"));
+var playwright = __toESM(require("playwright-core"));
+var import_registry = require("playwright-core/lib/server/registry/index");
+var import_server = require("playwright-core/lib/server");
+var import_log = require("../log");
+var import_config = require("./config");
+var import_server2 = require("../sdk/server");
+function contextFactory(config) {
+  if (config.sharedBrowserContext)
+    return SharedContextFactory.create(config);
+  if (config.browser.remoteEndpoint)
+    return new RemoteContextFactory(config);
+  if (config.browser.cdpEndpoint)
+    return new CdpContextFactory(config);
+  if (config.browser.isolated)
+    return new IsolatedContextFactory(config);
+  return new PersistentContextFactory(config);
+}
+function identityBrowserContextFactory(browserContext) {
+  return {
+    createContext: async (clientInfo, abortSignal, toolName) => {
+      return {
+        browserContext,
+        close: async () => {
+        }
+      };
+    }
+  };
+}
+class BaseContextFactory {
+  constructor(name, config) {
+    this._logName = name;
+    this.config = config;
+  }
+  async _obtainBrowser(clientInfo) {
+    if (this._browserPromise)
+      return this._browserPromise;
+    (0, import_log.testDebug)(`obtain browser (${this._logName})`);
+    this._browserPromise = this._doObtainBrowser(clientInfo);
+    void this._browserPromise.then((browser) => {
+      browser.on("disconnected", () => {
+        this._browserPromise = void 0;
+      });
+    }).catch(() => {
+      this._browserPromise = void 0;
+    });
+    return this._browserPromise;
+  }
+  async _doObtainBrowser(clientInfo) {
+    throw new Error("Not implemented");
+  }
+  async createContext(clientInfo) {
+    (0, import_log.testDebug)(`create browser context (${this._logName})`);
+    const browser = await this._obtainBrowser(clientInfo);
+    const harDir = await computeHarDir(clientInfo, this.config.runId);
+    const browserContext = await this._doCreateContext(browser, harDir);
+    await addInitScript(browserContext, this.config.browser.initScript);
+    return {
+      browserContext,
+      close: (afterClose) => this._closeBrowserContext(browserContext, browser, afterClose)
+    };
+  }
+  async _doCreateContext(browser, harDir) {
+    throw new Error("Not implemented");
+  }
+  async _closeBrowserContext(browserContext, browser, afterClose) {
+    (0, import_log.testDebug)(`close browser context (${this._logName})`);
+    if (browser.contexts().length === 1)
+      this._browserPromise = void 0;
+    await browserContext.close().catch(import_log.logUnhandledError);
+    await afterClose();
+    if (browser.contexts().length === 0) {
+      (0, import_log.testDebug)(`close browser (${this._logName})`);
+      await browser.close().catch(import_log.logUnhandledError);
+    }
+  }
+}
+class IsolatedContextFactory extends BaseContextFactory {
+  constructor(config) {
+    super("isolated", config);
+  }
+  async _doObtainBrowser(clientInfo) {
+    await injectCdpPort(this.config.browser);
+    const browserType = playwright[this.config.browser.browserName];
+    const tracesDir = await computeTracesDir(this.config, clientInfo);
+    if (tracesDir && this.config.saveTrace)
+      await startTraceServer(this.config, tracesDir);
+    return browserType.launch({
+      tracesDir,
+      ...this.config.browser.launchOptions,
+      handleSIGINT: false,
+      handleSIGTERM: false
+    }).catch((error) => {
+      if (error.message.includes("Executable doesn't exist"))
+        throw new Error(`Browser specified in your config is not installed. Either install it (likely) or change the config.`);
+      throw error;
+    });
+  }
+  async _doCreateContext(browser, harDir) {
+    return browser.newContext(browserContextOptionsFromConfig(this.config, harDir));
+  }
+}
+class CdpContextFactory extends BaseContextFactory {
+  constructor(config) {
+    super("cdp", config);
+  }
+  async _doObtainBrowser() {
+    return playwright.chromium.connectOverCDP(this.config.browser.cdpEndpoint, { headers: this.config.browser.cdpHeaders });
+  }
+  async _doCreateContext(browser, harDir) {
+    if (this.config.browser.isolated) {
+      return await browser.newContext(browserContextOptionsFromConfig(this.config, harDir));
+    }
+    return browser.contexts()[0];
+  }
+}
+class RemoteContextFactory extends BaseContextFactory {
+  constructor(config) {
+    super("remote", config);
+  }
+  async _doObtainBrowser() {
+    const url = new URL(this.config.browser.remoteEndpoint);
+    url.searchParams.set("browser", this.config.browser.browserName);
+    if (this.config.browser.launchOptions)
+      url.searchParams.set("launch-options", JSON.stringify(this.config.browser.launchOptions));
+    return playwright[this.config.browser.browserName].connect(String(url));
+  }
+  async _doCreateContext(browser, harDir) {
+    return browser.newContext(browserContextOptionsFromConfig(this.config, harDir));
+  }
+}
+class PersistentContextFactory {
+  constructor(config) {
+    this.name = "persistent";
+    this.description = "Create a new persistent browser context";
+    this._userDataDirs = /* @__PURE__ */ new Set();
+    this.config = config;
+  }
+  async createContext(clientInfo) {
+    await injectCdpPort(this.config.browser);
+    (0, import_log.testDebug)("create browser context (persistent)");
+    const userDataDir = this.config.browser.userDataDir ?? await this._createUserDataDir(clientInfo);
+    const tracesDir = await computeTracesDir(this.config, clientInfo);
+    if (tracesDir && this.config.saveTrace)
+      await startTraceServer(this.config, tracesDir);
+    const harDir = await computeHarDir(clientInfo, this.config.runId);
+    this._userDataDirs.add(userDataDir);
+    (0, import_log.testDebug)("lock user data dir", userDataDir);
+    const browserType = playwright[this.config.browser.browserName];
+    for (let i = 0; i < 5; i++) {
+      const launchOptions = {
+        tracesDir,
+        ...this.config.browser.launchOptions,
+        ...browserContextOptionsFromConfig(this.config, harDir),
+        handleSIGINT: false,
+        handleSIGTERM: false,
+        ignoreDefaultArgs: [
+          "--disable-extensions"
+        ],
+        assistantMode: true
+      };
+      try {
+        const browserContext = await browserType.launchPersistentContext(userDataDir, launchOptions);
+        await addInitScript(browserContext, this.config.browser.initScript);
+        const close = (afterClose) => this._closeBrowserContext(browserContext, userDataDir, afterClose);
+        return { browserContext, close };
+      } catch (error) {
+        if (error.message.includes("Executable doesn't exist"))
+          throw new Error(`Browser specified in your config is not installed. Either install it (likely) or change the config.`);
+        if (error.message.includes("ProcessSingleton") || error.message.includes("Invalid URL")) {
+          await new Promise((resolve) => setTimeout(resolve, 1e3));
+          continue;
+        }
+        throw error;
+      }
+    }
+    throw new Error(`Browser is already in use for ${userDataDir}, use --isolated to run multiple instances of the same browser`);
+  }
+  async _closeBrowserContext(browserContext, userDataDir, afterClose) {
+    (0, import_log.testDebug)("close browser context (persistent)");
+    (0, import_log.testDebug)("release user data dir", userDataDir);
+    await browserContext.close().catch(() => {
+    });
+    await afterClose();
+    this._userDataDirs.delete(userDataDir);
+    if (process.env.PWMCP_PROFILES_DIR_FOR_TEST && userDataDir.startsWith(process.env.PWMCP_PROFILES_DIR_FOR_TEST))
+      await import_fs.default.promises.rm(userDataDir, { recursive: true }).catch(import_log.logUnhandledError);
+    (0, import_log.testDebug)("close browser context complete (persistent)");
+  }
+  async _createUserDataDir(clientInfo) {
+    const dir = process.env.PWMCP_PROFILES_DIR_FOR_TEST ?? import_registry.registryDirectory;
+    const browserToken = this.config.browser.launchOptions?.channel ?? this.config.browser?.browserName;
+    const rootPath = (0, import_server2.firstRootPath)(clientInfo);
+    const rootPathToken = rootPath ? `-${createHash(rootPath)}` : "";
+    const result = import_path.default.join(dir, `mcp-${browserToken}${rootPathToken}`);
+    await import_fs.default.promises.mkdir(result, { recursive: true });
+    return result;
+  }
+}
+async function injectCdpPort(browserConfig) {
+  if (browserConfig.browserName === "chromium")
+    browserConfig.launchOptions.cdpPort = await findFreePort();
+}
+async function findFreePort() {
+  return new Promise((resolve, reject) => {
+    const server = import_net.default.createServer();
+    server.listen(0, () => {
+      const { port } = server.address();
+      server.close(() => resolve(port));
+    });
+    server.on("error", reject);
+  });
+}
+async function startTraceServer(config, tracesDir) {
+  if (!config.saveTrace)
+    return;
+  const server = await (0, import_server.startTraceViewerServer)();
+  const urlPrefix = server.urlPrefix("human-readable");
+  const url = urlPrefix + "/trace/index.html?trace=" + tracesDir + "/trace.json";
+  console.error("\nTrace viewer listening on " + url);
+}
+function createHash(data) {
+  return import_crypto.default.createHash("sha256").update(data).digest("hex").slice(0, 7);
+}
+async function addInitScript(browserContext, initScript) {
+  for (const scriptPath of initScript ?? [])
+    await browserContext.addInitScript({ path: import_path.default.resolve(scriptPath) });
+}
+class SharedContextFactory {
+  static create(config) {
+    if (SharedContextFactory._instance)
+      throw new Error("SharedContextFactory already exists");
+    const baseConfig = { ...config, sharedBrowserContext: false };
+    const baseFactory = contextFactory(baseConfig);
+    SharedContextFactory._instance = new SharedContextFactory(baseFactory);
+    return SharedContextFactory._instance;
+  }
+  constructor(baseFactory) {
+    this._baseFactory = baseFactory;
+  }
+  async createContext(clientInfo, abortSignal, toolName) {
+    if (!this._contextPromise) {
+      (0, import_log.testDebug)("create shared browser context");
+      this._contextPromise = this._baseFactory.createContext(clientInfo, abortSignal, toolName);
+    }
+    const { browserContext } = await this._contextPromise;
+    (0, import_log.testDebug)(`shared context client connected`);
+    return {
+      browserContext,
+      close: async () => {
+        (0, import_log.testDebug)(`shared context client disconnected`);
+      }
+    };
+  }
+  static async dispose() {
+    await SharedContextFactory._instance?._dispose();
+  }
+  async _dispose() {
+    const contextPromise = this._contextPromise;
+    this._contextPromise = void 0;
+    if (!contextPromise)
+      return;
+    const { close } = await contextPromise;
+    await close(async () => {
+    });
+  }
+}
+async function computeTracesDir(config, clientInfo) {
+  if (!config.saveTrace && !config.capabilities?.includes("tracing"))
+    return;
+  return await (0, import_config.outputFile)(config, clientInfo, `traces`, { origin: "code", reason: "Collecting trace" });
+}
+async function computeHarDir(clientInfo, runId) {
+  const finalRunId = runId || import_crypto.default.randomUUID();
+  const harDir = import_path.default.join(import_os.default.homedir(), ".reverse-api-engineer", "runs", "testing-playwright", finalRunId);
+  await import_fs.default.promises.mkdir(harDir, { recursive: true });
+  const harPath = import_path.default.join(harDir, "network.har");
+  console.error(`HAR recording enabled. HAR file will be saved to: ${harPath}`);
+  return harDir;
+}
+function browserContextOptionsFromConfig(config, harDir) {
+  const result = { ...config.browser.contextOptions };
+  if (config.saveVideo) {
+    result.recordVideo = {
+      dir: (0, import_config.tmpDir)(),
+      size: config.saveVideo
+    };
+  }
+  if (harDir) {
+    result.recordHar = {
+      path: import_path.default.join(harDir, "network.har"),
+      content: "attach",
+      mode: "full"
+    };
+  }
+  return result;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  SharedContextFactory,
+  contextFactory,
+  identityBrowserContextFactory
+});
+//# sourceMappingURL=browserContextFactory.js.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/mcp/browser/browserContextFactory.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 crypto from 'crypto';\nimport fs from 'fs';\nimport net from 'net';\nimport os from 'os';\nimport path from 'path';\n\nimport * as playwright from 'playwright-core';\nimport { registryDirectory } from 'playwright-core/lib/server/registry/index';\nimport { startTraceViewerServer } from 'playwright-core/lib/server';\nimport { logUnhandledError, testDebug } from '../log';\nimport { outputFile, tmpDir } from './config';\nimport { firstRootPath } from '../sdk/server';\n\nimport type { FullConfig } from './config';\nimport type { LaunchOptions, BrowserContextOptions } from '../../../../playwright-core/src/client/types';\nimport type { ClientInfo } from '../sdk/server';\n\nexport function contextFactory(config: FullConfig): BrowserContextFactory {\n  if (config.sharedBrowserContext)\n    return SharedContextFactory.create(config);\n  if (config.browser.remoteEndpoint)\n    return new RemoteContextFactory(config);\n  if (config.browser.cdpEndpoint)\n    return new CdpContextFactory(config);\n  if (config.browser.isolated)\n    return new IsolatedContextFactory(config);\n  return new PersistentContextFactory(config);\n}\n\nexport type BrowserContextFactoryResult = {\n  browserContext: playwright.BrowserContext;\n  close: (afterClose: () => Promise<void>) => Promise<void>;\n};\n\nexport interface BrowserContextFactory {\n  createContext(clientInfo: ClientInfo, abortSignal: AbortSignal, toolName: string | undefined): Promise<BrowserContextFactoryResult>;\n}\n\nexport function identityBrowserContextFactory(browserContext: playwright.BrowserContext): BrowserContextFactory {\n  return {\n    createContext: async (clientInfo: ClientInfo, abortSignal: AbortSignal, toolName: string | undefined) => {\n      return {\n        browserContext,\n        close: async () => { }\n      };\n    }\n  };\n}\n\nclass BaseContextFactory implements BrowserContextFactory {\n  readonly config: FullConfig;\n  private _logName: string;\n  protected _browserPromise: Promise<playwright.Browser> | undefined;\n\n  constructor(name: string, config: FullConfig) {\n    this._logName = name;\n    this.config = config;\n  }\n\n  protected async _obtainBrowser(clientInfo: ClientInfo): Promise<playwright.Browser> {\n    if (this._browserPromise)\n      return this._browserPromise;\n    testDebug(`obtain browser (${this._logName})`);\n    this._browserPromise = this._doObtainBrowser(clientInfo);\n    void this._browserPromise.then(browser => {\n      browser.on('disconnected', () => {\n        this._browserPromise = undefined;\n      });\n    }).catch(() => {\n      this._browserPromise = undefined;\n    });\n    return this._browserPromise;\n  }\n\n  protected async _doObtainBrowser(clientInfo: ClientInfo): Promise<playwright.Browser> {\n    throw new Error('Not implemented');\n  }\n\n  async createContext(clientInfo: ClientInfo): Promise<BrowserContextFactoryResult> {\n    testDebug(`create browser context (${this._logName})`);\n    const browser = await this._obtainBrowser(clientInfo);\n    const harDir = await computeHarDir(clientInfo, this.config.runId);\n    const browserContext = await this._doCreateContext(browser, harDir);\n    await addInitScript(browserContext, this.config.browser.initScript);\n    return {\n      browserContext,\n      close: (afterClose: () => Promise<void>) => this._closeBrowserContext(browserContext, browser, afterClose)\n    };\n  }\n\n  protected async _doCreateContext(browser: playwright.Browser, harDir: string): Promise<playwright.BrowserContext> {\n    throw new Error('Not implemented');\n  }\n\n  private async _closeBrowserContext(browserContext: playwright.BrowserContext, browser: playwright.Browser, afterClose: () => Promise<void>) {\n    testDebug(`close browser context (${this._logName})`);\n    if (browser.contexts().length === 1)\n      this._browserPromise = undefined;\n    await browserContext.close().catch(logUnhandledError);\n    await afterClose();\n    if (browser.contexts().length === 0) {\n      testDebug(`close browser (${this._logName})`);\n      await browser.close().catch(logUnhandledError);\n    }\n  }\n}\n\nclass IsolatedContextFactory extends BaseContextFactory {\n  constructor(config: FullConfig) {\n    super('isolated', config);\n  }\n\n  protected override async _doObtainBrowser(clientInfo: ClientInfo): Promise<playwright.Browser> {\n    await injectCdpPort(this.config.browser);\n    const browserType = playwright[this.config.browser.browserName];\n    const tracesDir = await computeTracesDir(this.config, clientInfo);\n    if (tracesDir && this.config.saveTrace)\n      await startTraceServer(this.config, tracesDir);\n    return browserType.launch({\n      tracesDir,\n      ...this.config.browser.launchOptions,\n      handleSIGINT: false,\n      handleSIGTERM: false,\n    }).catch(error => {\n      if (error.message.includes('Executable doesn\\'t exist'))\n        throw new Error(`Browser specified in your config is not installed. Either install it (likely) or change the config.`);\n      throw error;\n    });\n  }\n\n  protected override async _doCreateContext(browser: playwright.Browser, harDir: string): Promise<playwright.BrowserContext> {\n    return browser.newContext(browserContextOptionsFromConfig(this.config, harDir));\n  }\n}\n\nclass CdpContextFactory extends BaseContextFactory {\n  constructor(config: FullConfig) {\n    super('cdp', config);\n  }\n\n  protected override async _doObtainBrowser(): Promise<playwright.Browser> {\n    return playwright.chromium.connectOverCDP(this.config.browser.cdpEndpoint!, { headers: this.config.browser.cdpHeaders });\n  }\n\n  protected override async _doCreateContext(browser: playwright.Browser, harDir: string): Promise<playwright.BrowserContext> {\n    if (this.config.browser.isolated) {\n      return await browser.newContext(browserContextOptionsFromConfig(this.config, harDir));\n    }\n    return browser.contexts()[0];\n  }\n}\n\nclass RemoteContextFactory extends BaseContextFactory {\n  constructor(config: FullConfig) {\n    super('remote', config);\n  }\n\n  protected override async _doObtainBrowser(): Promise<playwright.Browser> {\n    const url = new URL(this.config.browser.remoteEndpoint!);\n    url.searchParams.set('browser', this.config.browser.browserName);\n    if (this.config.browser.launchOptions)\n      url.searchParams.set('launch-options', JSON.stringify(this.config.browser.launchOptions));\n    return playwright[this.config.browser.browserName].connect(String(url));\n  }\n\n  protected override async _doCreateContext(browser: playwright.Browser, harDir: string): Promise<playwright.BrowserContext> {\n    return browser.newContext(browserContextOptionsFromConfig(this.config, harDir));\n  }\n}\n\nclass PersistentContextFactory implements BrowserContextFactory {\n  readonly config: FullConfig;\n  readonly name = 'persistent';\n  readonly description = 'Create a new persistent browser context';\n\n  private _userDataDirs = new Set<string>();\n\n  constructor(config: FullConfig) {\n    this.config = config;\n  }\n\n  async createContext(clientInfo: ClientInfo): Promise<BrowserContextFactoryResult> {\n    await injectCdpPort(this.config.browser);\n    testDebug('create browser context (persistent)');\n    const userDataDir = this.config.browser.userDataDir ?? await this._createUserDataDir(clientInfo);\n    const tracesDir = await computeTracesDir(this.config, clientInfo);\n    if (tracesDir && this.config.saveTrace)\n      await startTraceServer(this.config, tracesDir);\n    const harDir = await computeHarDir(clientInfo, this.config.runId);\n\n    this._userDataDirs.add(userDataDir);\n    testDebug('lock user data dir', userDataDir);\n\n    const browserType = playwright[this.config.browser.browserName];\n    for (let i = 0; i < 5; i++) {\n      const launchOptions: LaunchOptions & BrowserContextOptions = {\n        tracesDir,\n        ...this.config.browser.launchOptions,\n        ...browserContextOptionsFromConfig(this.config, harDir),\n        handleSIGINT: false,\n        handleSIGTERM: false,\n        ignoreDefaultArgs: [\n          '--disable-extensions',\n        ],\n        assistantMode: true,\n      };\n      try {\n        const browserContext = await browserType.launchPersistentContext(userDataDir, launchOptions);\n        await addInitScript(browserContext, this.config.browser.initScript);\n        const close = (afterClose: () => Promise<void>) => this._closeBrowserContext(browserContext, userDataDir, afterClose);\n        return { browserContext, close };\n      } catch (error: any) {\n        if (error.message.includes('Executable doesn\\'t exist'))\n          throw new Error(`Browser specified in your config is not installed. Either install it (likely) or change the config.`);\n        if (error.message.includes('ProcessSingleton') || error.message.includes('Invalid URL')) {\n          // User data directory is already in use, try again.\n          await new Promise(resolve => setTimeout(resolve, 1000));\n          continue;\n        }\n        throw error;\n      }\n    }\n    throw new Error(`Browser is already in use for ${userDataDir}, use --isolated to run multiple instances of the same browser`);\n  }\n\n  private async _closeBrowserContext(browserContext: playwright.BrowserContext, userDataDir: string, afterClose: () => Promise<void>) {\n    testDebug('close browser context (persistent)');\n    testDebug('release user data dir', userDataDir);\n    await browserContext.close().catch(() => { });\n    await afterClose();\n    this._userDataDirs.delete(userDataDir);\n    if (process.env.PWMCP_PROFILES_DIR_FOR_TEST && userDataDir.startsWith(process.env.PWMCP_PROFILES_DIR_FOR_TEST))\n      await fs.promises.rm(userDataDir, { recursive: true }).catch(logUnhandledError);\n    testDebug('close browser context complete (persistent)');\n  }\n\n  private async _createUserDataDir(clientInfo: ClientInfo) {\n    const dir = process.env.PWMCP_PROFILES_DIR_FOR_TEST ?? registryDirectory;\n    const browserToken = this.config.browser.launchOptions?.channel ?? this.config.browser?.browserName;\n    // Hesitant putting hundreds of files into the user's workspace, so using it for hashing instead.\n    const rootPath = firstRootPath(clientInfo);\n    const rootPathToken = rootPath ? `-${createHash(rootPath)}` : '';\n    const result = path.join(dir, `mcp-${browserToken}${rootPathToken}`);\n    await fs.promises.mkdir(result, { recursive: true });\n    return result;\n  }\n}\n\nasync function injectCdpPort(browserConfig: FullConfig['browser']) {\n  if (browserConfig.browserName === 'chromium')\n    (browserConfig.launchOptions as any).cdpPort = await findFreePort();\n}\n\nasync function findFreePort(): Promise<number> {\n  return new Promise((resolve, reject) => {\n    const server = net.createServer();\n    server.listen(0, () => {\n      const { port } = server.address() as net.AddressInfo;\n      server.close(() => resolve(port));\n    });\n    server.on('error', reject);\n  });\n}\n\nasync function startTraceServer(config: FullConfig, tracesDir: string): Promise<string | undefined> {\n  if (!config.saveTrace)\n    return;\n\n  const server = await startTraceViewerServer();\n  const urlPrefix = server.urlPrefix('human-readable');\n  const url = urlPrefix + '/trace/index.html?trace=' + tracesDir + '/trace.json';\n  // eslint-disable-next-line no-console\n  console.error('\\nTrace viewer listening on ' + url);\n}\n\nfunction createHash(data: string): string {\n  return crypto.createHash('sha256').update(data).digest('hex').slice(0, 7);\n}\n\nasync function addInitScript(browserContext: playwright.BrowserContext, initScript: string[] | undefined) {\n  for (const scriptPath of initScript ?? [])\n    await browserContext.addInitScript({ path: path.resolve(scriptPath) });\n}\n\nexport class SharedContextFactory implements BrowserContextFactory {\n  private _contextPromise: Promise<BrowserContextFactoryResult> | undefined;\n  private _baseFactory: BrowserContextFactory;\n  private static _instance: SharedContextFactory | undefined;\n\n  static create(config: FullConfig) {\n    if (SharedContextFactory._instance)\n      throw new Error('SharedContextFactory already exists');\n    const baseConfig = { ...config, sharedBrowserContext: false };\n    const baseFactory = contextFactory(baseConfig);\n    SharedContextFactory._instance = new SharedContextFactory(baseFactory);\n    return SharedContextFactory._instance;\n  }\n\n  private constructor(baseFactory: BrowserContextFactory) {\n    this._baseFactory = baseFactory;\n  }\n\n  async createContext(clientInfo: ClientInfo, abortSignal: AbortSignal, toolName: string | undefined): Promise<{ browserContext: playwright.BrowserContext, close: () => Promise<void> }> {\n    if (!this._contextPromise) {\n      testDebug('create shared browser context');\n      this._contextPromise = this._baseFactory.createContext(clientInfo, abortSignal, toolName);\n    }\n\n    const { browserContext } = await this._contextPromise;\n    testDebug(`shared context client connected`);\n    return {\n      browserContext,\n      close: async () => {\n        testDebug(`shared context client disconnected`);\n      },\n    };\n  }\n\n  static async dispose() {\n    await SharedContextFactory._instance?._dispose();\n  }\n\n  private async _dispose() {\n    const contextPromise = this._contextPromise;\n    this._contextPromise = undefined;\n    if (!contextPromise)\n      return;\n    const { close } = await contextPromise;\n    await close(async () => { });\n  }\n}\n\nasync function computeTracesDir(config: FullConfig, clientInfo: ClientInfo): Promise<string | undefined> {\n  if (!config.saveTrace && !config.capabilities?.includes('tracing'))\n    return;\n  return await outputFile(config, clientInfo, `traces`, { origin: 'code', reason: 'Collecting trace' });\n}\n\nasync function computeHarDir(clientInfo: ClientInfo, runId?: string): Promise<string> {\n  const finalRunId = runId || crypto.randomUUID();\n  const harDir = path.join(os.homedir(), '.reverse-api-engineer', 'runs', 'testing-playwright', finalRunId);\n  await fs.promises.mkdir(harDir, { recursive: true });\n  const harPath = path.join(harDir, 'network.har');\n  // eslint-disable-next-line no-console\n  console.error(`HAR recording enabled. HAR file will be saved to: ${harPath}`);\n  return harDir;\n}\n\nfunction browserContextOptionsFromConfig(config: FullConfig, harDir?: string): playwright.BrowserContextOptions {\n  const result = { ...config.browser.contextOptions };\n  if (config.saveVideo) {\n    result.recordVideo = {\n      dir: tmpDir(),\n      size: config.saveVideo,\n    };\n  }\n  if (harDir) {\n    result.recordHar = {\n      path: path.join(harDir, 'network.har'),\n      content: 'attach',\n      mode: 'full',\n    };\n  }\n  return result;\n}\n"],
+  "mappings": "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",
+  "names": ["import_server", "fs", "path", "net", "crypto", "os"]
+}

package/lib/mcp/browser/browserServerBackend.js

@@ -0,0 +1,78 @@
+"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 browserServerBackend_exports = {};
+__export(browserServerBackend_exports, {
+  BrowserServerBackend: () => BrowserServerBackend
+});
+module.exports = __toCommonJS(browserServerBackend_exports);
+var import_context = require("./context");
+var import_log = require("../log");
+var import_response = require("./response");
+var import_sessionLog = require("./sessionLog");
+var import_tools = require("./tools");
+var import_tool = require("../sdk/tool");
+class BrowserServerBackend {
+  constructor(config, factory) {
+    this._config = config;
+    this._browserContextFactory = factory;
+    this._tools = (0, import_tools.filteredTools)(config);
+  }
+  async initialize(clientInfo) {
+    this._sessionLog = this._config.saveSession ? await import_sessionLog.SessionLog.create(this._config, clientInfo) : void 0;
+    this._context = new import_context.Context({
+      config: this._config,
+      browserContextFactory: this._browserContextFactory,
+      sessionLog: this._sessionLog,
+      clientInfo
+    });
+  }
+  async listTools() {
+    return this._tools.map((tool) => (0, import_tool.toMcpTool)(tool.schema));
+  }
+  async callTool(name, rawArguments) {
+    const tool = this._tools.find((tool2) => tool2.schema.name === name);
+    if (!tool)
+      throw new Error(`Tool "${name}" not found`);
+    const parsedArguments = tool.schema.inputSchema.parse(rawArguments || {});
+    const context = this._context;
+    const response = new import_response.Response(context, name, parsedArguments);
+    response.logBegin();
+    context.setRunningTool(name);
+    try {
+      await tool.handle(context, parsedArguments, response);
+      await response.finish();
+      this._sessionLog?.logResponse(response);
+    } catch (error) {
+      response.addError(String(error));
+    } finally {
+      context.setRunningTool(void 0);
+    }
+    response.logEnd();
+    const _meta = rawArguments?._meta;
+    return response.serialize({ _meta });
+  }
+  serverClosed() {
+    void this._context?.dispose().catch(import_log.logUnhandledError);
+  }
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  BrowserServerBackend
+});
+//# sourceMappingURL=browserServerBackend.js.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/mcp/browser/browserServerBackend.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 { FullConfig } from './config';\nimport { Context } from './context';\nimport { logUnhandledError } from '../log';\nimport { Response } from './response';\nimport { SessionLog } from './sessionLog';\nimport { filteredTools } from './tools';\nimport { toMcpTool } from '../sdk/tool';\n\nimport type { Tool } from './tools/tool';\nimport type { BrowserContextFactory } from './browserContextFactory';\nimport type * as mcpServer from '../sdk/server';\nimport type { ServerBackend } from '../sdk/server';\n\nexport class BrowserServerBackend implements ServerBackend {\n  private _tools: Tool[];\n  private _context: Context | undefined;\n  private _sessionLog: SessionLog | undefined;\n  private _config: FullConfig;\n  private _browserContextFactory: BrowserContextFactory;\n\n  constructor(config: FullConfig, factory: BrowserContextFactory) {\n    this._config = config;\n    this._browserContextFactory = factory;\n    this._tools = filteredTools(config);\n  }\n\n  async initialize(clientInfo: mcpServer.ClientInfo): Promise<void> {\n    this._sessionLog = this._config.saveSession ? await SessionLog.create(this._config, clientInfo) : undefined;\n    this._context = new Context({\n      config: this._config,\n      browserContextFactory: this._browserContextFactory,\n      sessionLog: this._sessionLog,\n      clientInfo,\n    });\n  }\n\n  async listTools(): Promise<mcpServer.Tool[]> {\n    return this._tools.map(tool => toMcpTool(tool.schema));\n  }\n\n  async callTool(name: string, rawArguments: mcpServer.CallToolRequest['params']['arguments']) {\n    const tool = this._tools.find(tool => tool.schema.name === name)!;\n    if (!tool)\n      throw new Error(`Tool \"${name}\" not found`);\n    const parsedArguments = tool.schema.inputSchema.parse(rawArguments || {});\n    const context = this._context!;\n    const response = new Response(context, name, parsedArguments);\n    response.logBegin();\n    context.setRunningTool(name);\n    try {\n      await tool.handle(context, parsedArguments, response);\n      await response.finish();\n      this._sessionLog?.logResponse(response);\n    } catch (error: any) {\n      response.addError(String(error));\n    } finally {\n      context.setRunningTool(undefined);\n    }\n    response.logEnd();\n    const _meta = rawArguments?._meta as object | undefined;\n    return response.serialize({ _meta });\n  }\n\n  serverClosed() {\n    void this._context?.dispose().catch(logUnhandledError);\n  }\n}\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAiBA,qBAAwB;AACxB,iBAAkC;AAClC,sBAAyB;AACzB,wBAA2B;AAC3B,mBAA8B;AAC9B,kBAA0B;AAOnB,MAAM,qBAA8C;AAAA,EAOzD,YAAY,QAAoB,SAAgC;AAC9D,SAAK,UAAU;AACf,SAAK,yBAAyB;AAC9B,SAAK,aAAS,4BAAc,MAAM;AAAA,EACpC;AAAA,EAEA,MAAM,WAAW,YAAiD;AAChE,SAAK,cAAc,KAAK,QAAQ,cAAc,MAAM,6BAAW,OAAO,KAAK,SAAS,UAAU,IAAI;AAClG,SAAK,WAAW,IAAI,uBAAQ;AAAA,MAC1B,QAAQ,KAAK;AAAA,MACb,uBAAuB,KAAK;AAAA,MAC5B,YAAY,KAAK;AAAA,MACjB;AAAA,IACF,CAAC;AAAA,EACH;AAAA,EAEA,MAAM,YAAuC;AAC3C,WAAO,KAAK,OAAO,IAAI,cAAQ,uBAAU,KAAK,MAAM,CAAC;AAAA,EACvD;AAAA,EAEA,MAAM,SAAS,MAAc,cAAgE;AAC3F,UAAM,OAAO,KAAK,OAAO,KAAK,CAAAA,UAAQA,MAAK,OAAO,SAAS,IAAI;AAC/D,QAAI,CAAC;AACH,YAAM,IAAI,MAAM,SAAS,IAAI,aAAa;AAC5C,UAAM,kBAAkB,KAAK,OAAO,YAAY,MAAM,gBAAgB,CAAC,CAAC;AACxE,UAAM,UAAU,KAAK;AACrB,UAAM,WAAW,IAAI,yBAAS,SAAS,MAAM,eAAe;AAC5D,aAAS,SAAS;AAClB,YAAQ,eAAe,IAAI;AAC3B,QAAI;AACF,YAAM,KAAK,OAAO,SAAS,iBAAiB,QAAQ;AACpD,YAAM,SAAS,OAAO;AACtB,WAAK,aAAa,YAAY,QAAQ;AAAA,IACxC,SAAS,OAAY;AACnB,eAAS,SAAS,OAAO,KAAK,CAAC;AAAA,IACjC,UAAE;AACA,cAAQ,eAAe,MAAS;AAAA,IAClC;AACA,aAAS,OAAO;AAChB,UAAM,QAAQ,cAAc;AAC5B,WAAO,SAAS,UAAU,EAAE,MAAM,CAAC;AAAA,EACrC;AAAA,EAEA,eAAe;AACb,SAAK,KAAK,UAAU,QAAQ,EAAE,MAAM,4BAAiB;AAAA,EACvD;AACF;",
+  "names": ["tool"]
+}