@smoothdeploy/playwright 1.57.1 → 1.58.1-beta-1770383926000

package/lib/mcp/browser/browserContextFactory.js

@@ -29,7 +29,8 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 var browserContextFactory_exports = {};
 __export(browserContextFactory_exports, {
   SharedContextFactory: () => SharedContextFactory,
-  contextFactory: () => contextFactory
+  contextFactory: () => contextFactory,
+  identityBrowserContextFactory: () => identityBrowserContextFactory
 });
 module.exports = __toCommonJS(browserContextFactory_exports);
 var import_crypto = __toESM(require("crypto"));
@@ -53,16 +54,27 @@ function contextFactory(config) {
     return new IsolatedContextFactory(config);
   return new PersistentContextFactory(config);
 }
+function identityBrowserContextFactory(browserContext) {
+  return {
+    createContext: async (clientInfo, abortSignal, options) => {
+      return {
+        browserContext,
+        close: async () => {
+        }
+      };
+    }
+  };
+}
 class BaseContextFactory {
   constructor(name, config) {
     this._logName = name;
     this.config = config;
   }
-  async _obtainBrowser(clientInfo) {
+  async _obtainBrowser(clientInfo, options) {
     if (this._browserPromise)
       return this._browserPromise;
     (0, import_log.testDebug)(`obtain browser (${this._logName})`);
-    this._browserPromise = this._doObtainBrowser(clientInfo);
+    this._browserPromise = this._doObtainBrowser(clientInfo, options);
     void this._browserPromise.then((browser) => {
       browser.on("disconnected", () => {
         this._browserPromise = void 0;
@@ -72,28 +84,27 @@ class BaseContextFactory {
     });
     return this._browserPromise;
   }
-  async _doObtainBrowser(clientInfo) {
+  async _doObtainBrowser(clientInfo, options) {
     throw new Error("Not implemented");
   }
-  async createContext(clientInfo) {
+  async createContext(clientInfo, _, options) {
     (0, import_log.testDebug)(`create browser context (${this._logName})`);
-    const browser = await this._obtainBrowser(clientInfo);
-    const browserContext = await this._doCreateContext(browser);
+    const browser = await this._obtainBrowser(clientInfo, options);
+    const browserContext = await this._doCreateContext(browser, clientInfo);
     await addInitScript(browserContext, this.config.browser.initScript);
     return {
       browserContext,
-      close: (afterClose) => this._closeBrowserContext(browserContext, browser, afterClose)
+      close: () => this._closeBrowserContext(browserContext, browser)
     };
   }
-  async _doCreateContext(browser) {
+  async _doCreateContext(browser, clientInfo) {
     throw new Error("Not implemented");
   }
-  async _closeBrowserContext(browserContext, browser, afterClose) {
+  async _closeBrowserContext(browserContext, browser) {
     (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);
@@ -104,7 +115,7 @@ class IsolatedContextFactory extends BaseContextFactory {
   constructor(config) {
     super("isolated", config);
   }
-  async _doObtainBrowser(clientInfo) {
+  async _doObtainBrowser(clientInfo, options) {
     await injectCdpPort(this.config.browser);
     const browserType = playwright[this.config.browser.browserName];
     const tracesDir = await computeTracesDir(this.config, clientInfo);
@@ -114,15 +125,16 @@ class IsolatedContextFactory extends BaseContextFactory {
       tracesDir,
       ...this.config.browser.launchOptions,
       handleSIGINT: false,
-      handleSIGTERM: false
+      handleSIGTERM: false,
+      ...options.forceHeadless !== void 0 ? { headless: options.forceHeadless === "headless" } : {}
     }).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) {
-    return browser.newContext(this.config.browser.contextOptions);
+  async _doCreateContext(browser, clientInfo) {
+    return browser.newContext(await browserContextOptionsFromConfig(this.config, clientInfo));
   }
 }
 class CdpContextFactory extends BaseContextFactory {
@@ -130,7 +142,10 @@ class CdpContextFactory extends BaseContextFactory {
     super("cdp", config);
   }
   async _doObtainBrowser() {
-    return playwright.chromium.connectOverCDP(this.config.browser.cdpEndpoint, { headers: this.config.browser.cdpHeaders });
+    return playwright.chromium.connectOverCDP(this.config.browser.cdpEndpoint, {
+      headers: this.config.browser.cdpHeaders,
+      timeout: this.config.browser.cdpTimeout
+    });
   }
   async _doCreateContext(browser) {
     return this.config.browser.isolated ? await browser.newContext() : browser.contexts()[0];
@@ -158,7 +173,7 @@ class PersistentContextFactory {
     this._userDataDirs = /* @__PURE__ */ new Set();
     this.config = config;
   }
-  async createContext(clientInfo) {
+  async createContext(clientInfo, abortSignal, options) {
     await injectCdpPort(this.config.browser);
     (0, import_log.testDebug)("create browser context (persistent)");
     const userDataDir = this.config.browser.userDataDir ?? await this._createUserDataDir(clientInfo);
@@ -172,23 +187,29 @@ class PersistentContextFactory {
       const launchOptions = {
         tracesDir,
         ...this.config.browser.launchOptions,
-        ...this.config.browser.contextOptions,
+        ...await browserContextOptionsFromConfig(this.config, clientInfo),
         handleSIGINT: false,
         handleSIGTERM: false,
         ignoreDefaultArgs: [
           "--disable-extensions"
         ],
-        assistantMode: true
+        assistantMode: true,
+        ...options.forceHeadless !== void 0 ? { headless: options.forceHeadless === "headless" } : {}
       };
       try {
         const browserContext = await browserType.launchPersistentContext(userDataDir, launchOptions);
         await addInitScript(browserContext, this.config.browser.initScript);
-        const close = (afterClose) => this._closeBrowserContext(browserContext, userDataDir, afterClose);
+        const close = () => this._closeBrowserContext(browserContext, userDataDir);
         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")) {
+        if (error.message.includes("cannot open shared object file: No such file or directory")) {
+          const browserName = launchOptions.channel ?? this.config.browser.browserName;
+          throw new Error(`Missing system dependencies required to run browser ${browserName}. Install them with: sudo npx playwright install-deps ${browserName}`);
+        }
+        if (error.message.includes("ProcessSingleton") || // On Windows the process exits silently with code 21 when the profile is in use.
+        error.message.includes("exitCode=21")) {
           await new Promise((resolve) => setTimeout(resolve, 1e3));
           continue;
         }
@@ -197,13 +218,14 @@ class PersistentContextFactory {
     }
     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) {
+  async _closeBrowserContext(browserContext, userDataDir) {
     (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) {
@@ -257,10 +279,10 @@ class SharedContextFactory {
   constructor(baseFactory) {
     this._baseFactory = baseFactory;
   }
-  async createContext(clientInfo, abortSignal, toolName) {
+  async createContext(clientInfo, abortSignal, options) {
     if (!this._contextPromise) {
       (0, import_log.testDebug)("create shared browser context");
-      this._contextPromise = this._baseFactory.createContext(clientInfo, abortSignal, toolName);
+      this._contextPromise = this._baseFactory.createContext(clientInfo, abortSignal, options);
     }
     const { browserContext } = await this._contextPromise;
     (0, import_log.testDebug)(`shared context client connected`);
@@ -280,17 +302,28 @@ class SharedContextFactory {
     if (!contextPromise)
       return;
     const { close } = await contextPromise;
-    await close(async () => {
-    });
+    await close();
   }
 }
 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" });
+  return await (0, import_config.outputFile)(config, clientInfo, `traces`, { origin: "code", title: "Collecting trace" });
+}
+async function browserContextOptionsFromConfig(config, clientInfo) {
+  const result = { ...config.browser.contextOptions };
+  if (config.saveVideo) {
+    const dir = await (0, import_config.outputFile)(config, clientInfo, `videos`, { origin: "code", title: "Saving video" });
+    result.recordVideo = {
+      dir,
+      size: config.saveVideo
+    };
+  }
+  return result;
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   SharedContextFactory,
-  contextFactory
+  contextFactory,
+  identityBrowserContextFactory
 });

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 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 } 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\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 browserContext = await this._doCreateContext(browser);\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): 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): Promise<playwright.BrowserContext> {\n    return browser.newContext(this.config.browser.contextOptions);\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): Promise<playwright.BrowserContext> {\n    return this.config.browser.isolated ? await browser.newContext() : 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): Promise<playwright.BrowserContext> {\n    return browser.newContext();\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\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        ...this.config.browser.contextOptions,\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    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"],
+  "mappings": "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",
+  "names": ["import_server", "path", "fs", "net", "crypto"]
+}

package/lib/mcp/browser/browserServerBackend.js

@@ -47,24 +47,32 @@ class BrowserServerBackend {
   }
   async callTool(name, rawArguments) {
     const tool = this._tools.find((tool2) => tool2.schema.name === name);
-    if (!tool)
-      throw new Error(`Tool "${name}" not found`);
+    if (!tool) {
+      return {
+        content: [{ type: "text", text: `### Error
+Tool "${name}" not found` }],
+        isError: true
+      };
+    }
     const parsedArguments = tool.schema.inputSchema.parse(rawArguments || {});
     const context = this._context;
-    const response = new import_response.Response(context, name, parsedArguments);
-    response.logBegin();
+    const response = import_response.Response.create(context, name, parsedArguments);
     context.setRunningTool(name);
+    let responseObject;
     try {
       await tool.handle(context, parsedArguments, response);
-      await response.finish();
-      this._sessionLog?.logResponse(response);
+      responseObject = await response.build();
+      this._sessionLog?.logResponse(name, parsedArguments, responseObject);
     } catch (error) {
-      response.addError(String(error));
+      return {
+        content: [{ type: "text", text: `### Error
+${String(error)}` }],
+        isError: true
+      };
     } finally {
       context.setRunningTool(void 0);
     }
-    response.logEnd();
-    return response.serialize();
+    return responseObject;
   }
   serverClosed() {
     void this._context?.dispose().catch(import_log.logUnhandledError);

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    return response.serialize();\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,WAAO,SAAS,UAAU;AAAA,EAC5B;AAAA,EAEA,eAAe;AACb,SAAK,KAAK,UAAU,QAAQ,EAAE,MAAM,4BAAiB;AAAA,EACvD;AACF;",
+  "names": ["tool"]
+}

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/mcp/browser/codegen.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// adapted from:\n// - https://github.com/microsoft/playwright/blob/76ee48dc9d4034536e3ec5b2c7ce8be3b79418a8/packages/playwright-core/src/utils/isomorphic/stringUtils.ts\n// - https://github.com/microsoft/playwright/blob/76ee48dc9d4034536e3ec5b2c7ce8be3b79418a8/packages/playwright-core/src/server/codegen/javascript.ts\n\n// NOTE: this function should not be used to escape any selectors.\nexport function escapeWithQuotes(text: string, char: string = '\\'') {\n  const stringified = JSON.stringify(text);\n  const escapedText = stringified.substring(1, stringified.length - 1).replace(/\\\\\"/g, '\"');\n  if (char === '\\'')\n    return char + escapedText.replace(/[']/g, '\\\\\\'') + char;\n  if (char === '\"')\n    return char + escapedText.replace(/[\"]/g, '\\\\\"') + char;\n  if (char === '`')\n    return char + escapedText.replace(/[`]/g, '\\\\`') + char;\n  throw new Error('Invalid escape char');\n}\n\nexport function quote(text: string) {\n  return escapeWithQuotes(text, '\\'');\n}\n\nexport function formatObject(value: any, indent = '  ', mode: 'multiline' | 'oneline' = 'multiline'): string {\n  if (typeof value === 'string')\n    return quote(value);\n  if (Array.isArray(value))\n    return `[${value.map(o => formatObject(o)).join(', ')}]`;\n  if (typeof value === 'object') {\n    const keys = Object.keys(value).filter(key => value[key] !== undefined).sort();\n    if (!keys.length)\n      return '{}';\n    const tokens: string[] = [];\n    for (const key of keys)\n      tokens.push(`${key}: ${formatObject(value[key])}`);\n    if (mode === 'multiline')\n      return `{\\n${tokens.join(`,\\n${indent}`)}\\n}`;\n    return `{ ${tokens.join(', ')} }`;\n  }\n  return String(value);\n}\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAqBO,SAAS,iBAAiB,MAAc,OAAe,KAAM;AAClE,QAAM,cAAc,KAAK,UAAU,IAAI;AACvC,QAAM,cAAc,YAAY,UAAU,GAAG,YAAY,SAAS,CAAC,EAAE,QAAQ,QAAQ,GAAG;AACxF,MAAI,SAAS;AACX,WAAO,OAAO,YAAY,QAAQ,QAAQ,KAAM,IAAI;AACtD,MAAI,SAAS;AACX,WAAO,OAAO,YAAY,QAAQ,QAAQ,KAAK,IAAI;AACrD,MAAI,SAAS;AACX,WAAO,OAAO,YAAY,QAAQ,QAAQ,KAAK,IAAI;AACrD,QAAM,IAAI,MAAM,qBAAqB;AACvC;AAEO,SAAS,MAAM,MAAc;AAClC,SAAO,iBAAiB,MAAM,GAAI;AACpC;AAEO,SAAS,aAAa,OAAY,SAAS,MAAM,OAAgC,aAAqB;AAC3G,MAAI,OAAO,UAAU;AACnB,WAAO,MAAM,KAAK;AACpB,MAAI,MAAM,QAAQ,KAAK;AACrB,WAAO,IAAI,MAAM,IAAI,OAAK,aAAa,CAAC,CAAC,EAAE,KAAK,IAAI,CAAC;AACvD,MAAI,OAAO,UAAU,UAAU;AAC7B,UAAM,OAAO,OAAO,KAAK,KAAK,EAAE,OAAO,SAAO,MAAM,GAAG,MAAM,MAAS,EAAE,KAAK;AAC7E,QAAI,CAAC,KAAK;AACR,aAAO;AACT,UAAM,SAAmB,CAAC;AAC1B,eAAW,OAAO;AAChB,aAAO,KAAK,GAAG,GAAG,KAAK,aAAa,MAAM,GAAG,CAAC,CAAC,EAAE;AACnD,QAAI,SAAS;AACX,aAAO;AAAA,EAAM,OAAO,KAAK;AAAA,EAAM,MAAM,EAAE,CAAC;AAAA;AAC1C,WAAO,KAAK,OAAO,KAAK,IAAI,CAAC;AAAA,EAC/B;AACA,SAAO,OAAO,KAAK;AACrB;",
+  "names": []
+}

package/lib/mcp/browser/config.js

@@ -32,13 +32,15 @@ __export(config_exports, {
   configFromCLIOptions: () => configFromCLIOptions,
   defaultConfig: () => defaultConfig,
   dotenvFileLoader: () => dotenvFileLoader,
+  enumParser: () => enumParser,
   headerParser: () => headerParser,
   numberParser: () => numberParser,
   outputDir: () => outputDir,
   outputFile: () => outputFile,
   resolutionParser: () => resolutionParser,
   resolveCLIConfig: () => resolveCLIConfig,
-  resolveConfig: () => resolveConfig
+  resolveConfig: () => resolveConfig,
+  semicolonSeparatedList: () => semicolonSeparatedList
 });
 module.exports = __toCommonJS(config_exports);
 var import_fs = __toESM(require("fs"));
@@ -60,8 +62,19 @@ const defaultConfig = {
       viewport: null
     }
   },
+  console: {
+    level: "info"
+  },
+  network: {
+    allowedOrigins: void 0,
+    blockedOrigins: void 0
+  },
   server: {},
   saveTrace: false,
+  snapshot: {
+    mode: "incremental",
+    output: "stdout"
+  },
   timeouts: {
     action: 5e3,
     navigation: 6e4
@@ -88,6 +101,12 @@ async function validateConfig(config) {
         throw new Error(`Init script file does not exist: ${script}`);
     }
   }
+  if (config.browser.initPage) {
+    for (const page of config.browser.initPage) {
+      if (!await (0, import_util.fileExistsAsync)(page))
+        throw new Error(`Init page file does not exist: ${page}`);
+    }
+  }
   if (config.sharedBrowserContext && config.saveVideo)
     throw new Error("saveVideo is not supported when sharedBrowserContext is true");
 }
@@ -143,13 +162,6 @@ function configFromCLIOptions(cliOptions) {
     contextOptions.serviceWorkers = "block";
   if (cliOptions.grantPermissions)
     contextOptions.permissions = cliOptions.grantPermissions;
-  if (cliOptions.saveVideo) {
-    contextOptions.recordVideo = {
-      // Videos are moved to output directory on saveAs.
-      dir: tmpDir(),
-      size: cliOptions.saveVideo
-    };
-  }
   const result = {
     browser: {
       browserName,
@@ -168,11 +180,22 @@ function configFromCLIOptions(cliOptions) {
       allowedHosts: cliOptions.allowedHosts
     },
     capabilities: cliOptions.caps,
+    console: {
+      level: cliOptions.consoleLevel
+    },
+    network: {
+      allowedOrigins: cliOptions.allowedOrigins,
+      blockedOrigins: cliOptions.blockedOrigins
+    },
+    allowUnrestrictedFileAccess: cliOptions.allowUnrestrictedFileAccess,
+    codegen: cliOptions.codegen,
     saveSession: cliOptions.saveSession,
     saveTrace: cliOptions.saveTrace,
     saveVideo: cliOptions.saveVideo,
     secrets: cliOptions.secrets,
     sharedBrowserContext: cliOptions.sharedBrowserContext,
+    snapshot: cliOptions.snapshotMode ? { mode: cliOptions.snapshotMode } : void 0,
+    outputMode: cliOptions.outputMode,
     outputDir: cliOptions.outputDir,
     imageResponses: cliOptions.imageResponses,
     testIdAttribute: cliOptions.testIdAttribute,
@@ -186,12 +209,17 @@ function configFromCLIOptions(cliOptions) {
 function configFromEnv() {
   const options = {};
   options.allowedHosts = commaSeparatedList(process.env.PLAYWRIGHT_MCP_ALLOWED_HOSTNAMES);
+  options.allowedOrigins = semicolonSeparatedList(process.env.PLAYWRIGHT_MCP_ALLOWED_ORIGINS);
+  options.allowUnrestrictedFileAccess = envToBoolean(process.env.PLAYWRIGHT_MCP_ALLOW_UNRESTRICTED_FILE_ACCESS);
+  options.blockedOrigins = semicolonSeparatedList(process.env.PLAYWRIGHT_MCP_BLOCKED_ORIGINS);
   options.blockServiceWorkers = envToBoolean(process.env.PLAYWRIGHT_MCP_BLOCK_SERVICE_WORKERS);
   options.browser = envToString(process.env.PLAYWRIGHT_MCP_BROWSER);
   options.caps = commaSeparatedList(process.env.PLAYWRIGHT_MCP_CAPS);
   options.cdpEndpoint = envToString(process.env.PLAYWRIGHT_MCP_CDP_ENDPOINT);
   options.cdpHeader = headerParser(process.env.PLAYWRIGHT_MCP_CDP_HEADERS, {});
   options.config = envToString(process.env.PLAYWRIGHT_MCP_CONFIG);
+  if (process.env.PLAYWRIGHT_MCP_CONSOLE_LEVEL)
+    options.consoleLevel = enumParser("--console-level", ["error", "warning", "info", "debug"], process.env.PLAYWRIGHT_MCP_CONSOLE_LEVEL);
   options.device = envToString(process.env.PLAYWRIGHT_MCP_DEVICE);
   options.executablePath = envToString(process.env.PLAYWRIGHT_MCP_EXECUTABLE_PATH);
   options.grantPermissions = commaSeparatedList(process.env.PLAYWRIGHT_MCP_GRANT_PERMISSIONS);
@@ -205,8 +233,8 @@ function configFromEnv() {
   if (initScript)
     options.initScript = [initScript];
   options.isolated = envToBoolean(process.env.PLAYWRIGHT_MCP_ISOLATED);
-  if (process.env.PLAYWRIGHT_MCP_IMAGE_RESPONSES === "omit")
-    options.imageResponses = "omit";
+  if (process.env.PLAYWRIGHT_MCP_IMAGE_RESPONSES)
+    options.imageResponses = enumParser("--image-responses", ["allow", "omit"], process.env.PLAYWRIGHT_MCP_IMAGE_RESPONSES);
   options.sandbox = envToBoolean(process.env.PLAYWRIGHT_MCP_SANDBOX);
   options.outputDir = envToString(process.env.PLAYWRIGHT_MCP_OUTPUT_DIR);
   options.port = numberParser(process.env.PLAYWRIGHT_MCP_PORT);
@@ -242,7 +270,8 @@ function outputDir(config, clientInfo) {
 }
 async function outputFile(config, clientInfo, fileName, options) {
   const file = await resolveFile(config, clientInfo, fileName, options);
-  (0, import_utilsBundle.debug)("pw:mcp:file")(options.reason, file);
+  await import_fs.default.promises.mkdir(import_path.default.dirname(file), { recursive: true });
+  (0, import_utilsBundle.debug)("pw:mcp:file")(options.title, file);
   return file;
 }
 async function resolveFile(config, clientInfo, fileName, options) {
@@ -285,16 +314,33 @@ function mergeConfig(base, overrides) {
     ...pickDefined(base),
     ...pickDefined(overrides),
     browser,
+    console: {
+      ...pickDefined(base.console),
+      ...pickDefined(overrides.console)
+    },
+    network: {
+      ...pickDefined(base.network),
+      ...pickDefined(overrides.network)
+    },
     server: {
       ...pickDefined(base.server),
       ...pickDefined(overrides.server)
     },
+    snapshot: {
+      ...pickDefined(base.snapshot),
+      ...pickDefined(overrides.snapshot)
+    },
     timeouts: {
       ...pickDefined(base.timeouts),
       ...pickDefined(overrides.timeouts)
     }
   };
 }
+function semicolonSeparatedList(value) {
+  if (!value)
+    return void 0;
+  return value.split(";").map((v) => v.trim());
+}
 function commaSeparatedList(value) {
   if (!value)
     return void 0;
@@ -335,6 +381,11 @@ function headerParser(arg, previous) {
   result[name] = value;
   return result;
 }
+function enumParser(name, options, value) {
+  if (!options.includes(value))
+    throw new Error(`Invalid ${name}: ${value}. Valid values are: ${options.join(", ")}`);
+  return value;
+}
 function envToBoolean(value) {
   if (value === "true" || value === "1")
     return true;
@@ -358,11 +409,13 @@ function sanitizeForFilePath(s) {
   configFromCLIOptions,
   defaultConfig,
   dotenvFileLoader,
+  enumParser,
   headerParser,
   numberParser,
   outputDir,
   outputFile,
   resolutionParser,
   resolveCLIConfig,
-  resolveConfig
+  resolveConfig,
+  semicolonSeparatedList
 });

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/mcp/browser/config.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 os from 'os';\nimport path from 'path';\n\nimport { devices } from 'playwright-core';\nimport { dotenv, debug } from 'playwright-core/lib/utilsBundle';\nimport { fileExistsAsync } from '../../util';\nimport { firstRootPath } from '../sdk/server';\n\nimport type * as playwright from '../../../types/test';\nimport type { Config, ToolCapability } from '../config';\nimport type { ClientInfo } from '../sdk/server';\n\ntype ViewportSize = { width: number; height: number };\n\nexport type CLIOptions = {\n  allowedHosts?: string[];\n  blockServiceWorkers?: boolean;\n  browser?: string;\n  caps?: string[];\n  cdpEndpoint?: string;\n  cdpHeader?: Record<string, string>;\n  config?: string;\n  device?: string;\n  executablePath?: string;\n  grantPermissions?: string[];\n  headless?: boolean;\n  host?: string;\n  ignoreHttpsErrors?: boolean;\n  initScript?: string[];\n  initPage?: string[];\n  isolated?: boolean;\n  imageResponses?: 'allow' | 'omit';\n  sandbox?: boolean;\n  outputDir?: string;\n  port?: number;\n  proxyBypass?: string;\n  proxyServer?: string;\n  saveSession?: boolean;\n  saveTrace?: boolean;\n  saveVideo?: ViewportSize;\n  secrets?: Record<string, string>;\n  sharedBrowserContext?: boolean;\n  storageState?: string;\n  testIdAttribute?: string;\n  timeoutAction?: number;\n  timeoutNavigation?: number;\n  userAgent?: string;\n  userDataDir?: string;\n  viewportSize?: ViewportSize;\n};\n\nexport const defaultConfig: FullConfig = {\n  browser: {\n    browserName: 'chromium',\n    launchOptions: {\n      channel: 'chrome',\n      headless: os.platform() === 'linux' && !process.env.DISPLAY,\n      chromiumSandbox: true,\n    },\n    contextOptions: {\n      viewport: null,\n    },\n  },\n  server: {},\n  saveTrace: false,\n  timeouts: {\n    action: 5000,\n    navigation: 60000,\n  },\n};\n\ntype BrowserUserConfig = NonNullable<Config['browser']>;\n\nexport type FullConfig = Config & {\n  browser: Omit<BrowserUserConfig, 'browserName'> & {\n    browserName: 'chromium' | 'firefox' | 'webkit';\n    launchOptions: NonNullable<BrowserUserConfig['launchOptions']>;\n    contextOptions: NonNullable<BrowserUserConfig['contextOptions']>;\n  },\n  saveTrace: boolean;\n  server: NonNullable<Config['server']>,\n  timeouts: {\n    action: number;\n    navigation: number;\n  },\n};\n\nexport async function resolveConfig(config: Config): Promise<FullConfig> {\n  return mergeConfig(defaultConfig, config);\n}\n\nexport async function resolveCLIConfig(cliOptions: CLIOptions): Promise<FullConfig> {\n  const configInFile = await loadConfig(cliOptions.config);\n  const envOverrides = configFromEnv();\n  const cliOverrides = configFromCLIOptions(cliOptions);\n  let result = defaultConfig;\n  result = mergeConfig(result, configInFile);\n  result = mergeConfig(result, envOverrides);\n  result = mergeConfig(result, cliOverrides);\n  await validateConfig(result);\n  return result;\n}\n\nasync function validateConfig(config: FullConfig): Promise<void> {\n  if (config.browser.initScript) {\n    for (const script of config.browser.initScript) {\n      if (!await fileExistsAsync(script))\n        throw new Error(`Init script file does not exist: ${script}`);\n    }\n  }\n  if (config.sharedBrowserContext && config.saveVideo)\n    throw new Error('saveVideo is not supported when sharedBrowserContext is true');\n}\n\nexport function configFromCLIOptions(cliOptions: CLIOptions): Config {\n  let browserName: 'chromium' | 'firefox' | 'webkit' | undefined;\n  let channel: string | undefined;\n  switch (cliOptions.browser) {\n    case 'chrome':\n    case 'chrome-beta':\n    case 'chrome-canary':\n    case 'chrome-dev':\n    case 'chromium':\n    case 'msedge':\n    case 'msedge-beta':\n    case 'msedge-canary':\n    case 'msedge-dev':\n      browserName = 'chromium';\n      channel = cliOptions.browser;\n      break;\n    case 'firefox':\n      browserName = 'firefox';\n      break;\n    case 'webkit':\n      browserName = 'webkit';\n      break;\n  }\n\n  // Launch options\n  const launchOptions: playwright.LaunchOptions = {\n    channel,\n    executablePath: cliOptions.executablePath,\n    headless: cliOptions.headless,\n  };\n\n  // --no-sandbox was passed, disable the sandbox\n  if (cliOptions.sandbox === false)\n    launchOptions.chromiumSandbox = false;\n\n  if (cliOptions.proxyServer) {\n    launchOptions.proxy = {\n      server: cliOptions.proxyServer\n    };\n    if (cliOptions.proxyBypass)\n      launchOptions.proxy.bypass = cliOptions.proxyBypass;\n  }\n\n  if (cliOptions.device && cliOptions.cdpEndpoint)\n    throw new Error('Device emulation is not supported with cdpEndpoint.');\n\n  // Context options\n  const contextOptions: playwright.BrowserContextOptions = cliOptions.device ? devices[cliOptions.device] : {};\n  if (cliOptions.storageState)\n    contextOptions.storageState = cliOptions.storageState;\n\n  if (cliOptions.userAgent)\n    contextOptions.userAgent = cliOptions.userAgent;\n\n  if (cliOptions.viewportSize)\n    contextOptions.viewport = cliOptions.viewportSize;\n\n  if (cliOptions.ignoreHttpsErrors)\n    contextOptions.ignoreHTTPSErrors = true;\n\n  if (cliOptions.blockServiceWorkers)\n    contextOptions.serviceWorkers = 'block';\n\n  if (cliOptions.grantPermissions)\n    contextOptions.permissions = cliOptions.grantPermissions;\n\n  if (cliOptions.saveVideo) {\n    contextOptions.recordVideo = {\n      // Videos are moved to output directory on saveAs.\n      dir: tmpDir(),\n      size: cliOptions.saveVideo,\n    };\n  }\n\n  const result: Config = {\n    browser: {\n      browserName,\n      isolated: cliOptions.isolated,\n      userDataDir: cliOptions.userDataDir,\n      launchOptions,\n      contextOptions,\n      cdpEndpoint: cliOptions.cdpEndpoint,\n      cdpHeaders: cliOptions.cdpHeader,\n      initPage: cliOptions.initPage,\n      initScript: cliOptions.initScript,\n    },\n    server: {\n      port: cliOptions.port,\n      host: cliOptions.host,\n      allowedHosts: cliOptions.allowedHosts,\n    },\n    capabilities: cliOptions.caps as ToolCapability[],\n    saveSession: cliOptions.saveSession,\n    saveTrace: cliOptions.saveTrace,\n    saveVideo: cliOptions.saveVideo,\n    secrets: cliOptions.secrets,\n    sharedBrowserContext: cliOptions.sharedBrowserContext,\n    outputDir: cliOptions.outputDir,\n    imageResponses: cliOptions.imageResponses,\n    testIdAttribute: cliOptions.testIdAttribute,\n    timeouts: {\n      action: cliOptions.timeoutAction,\n      navigation: cliOptions.timeoutNavigation,\n    },\n  };\n\n  return result;\n}\n\nfunction configFromEnv(): Config {\n  const options: CLIOptions = {};\n  options.allowedHosts = commaSeparatedList(process.env.PLAYWRIGHT_MCP_ALLOWED_HOSTNAMES);\n  options.blockServiceWorkers = envToBoolean(process.env.PLAYWRIGHT_MCP_BLOCK_SERVICE_WORKERS);\n  options.browser = envToString(process.env.PLAYWRIGHT_MCP_BROWSER);\n  options.caps = commaSeparatedList(process.env.PLAYWRIGHT_MCP_CAPS);\n  options.cdpEndpoint = envToString(process.env.PLAYWRIGHT_MCP_CDP_ENDPOINT);\n  options.cdpHeader = headerParser(process.env.PLAYWRIGHT_MCP_CDP_HEADERS, {});\n  options.config = envToString(process.env.PLAYWRIGHT_MCP_CONFIG);\n  options.device = envToString(process.env.PLAYWRIGHT_MCP_DEVICE);\n  options.executablePath = envToString(process.env.PLAYWRIGHT_MCP_EXECUTABLE_PATH);\n  options.grantPermissions = commaSeparatedList(process.env.PLAYWRIGHT_MCP_GRANT_PERMISSIONS);\n  options.headless = envToBoolean(process.env.PLAYWRIGHT_MCP_HEADLESS);\n  options.host = envToString(process.env.PLAYWRIGHT_MCP_HOST);\n  options.ignoreHttpsErrors = envToBoolean(process.env.PLAYWRIGHT_MCP_IGNORE_HTTPS_ERRORS);\n  const initPage = envToString(process.env.PLAYWRIGHT_MCP_INIT_PAGE);\n  if (initPage)\n    options.initPage = [initPage];\n  const initScript = envToString(process.env.PLAYWRIGHT_MCP_INIT_SCRIPT);\n  if (initScript)\n    options.initScript = [initScript];\n  options.isolated = envToBoolean(process.env.PLAYWRIGHT_MCP_ISOLATED);\n  if (process.env.PLAYWRIGHT_MCP_IMAGE_RESPONSES === 'omit')\n    options.imageResponses = 'omit';\n  options.sandbox = envToBoolean(process.env.PLAYWRIGHT_MCP_SANDBOX);\n  options.outputDir = envToString(process.env.PLAYWRIGHT_MCP_OUTPUT_DIR);\n  options.port = numberParser(process.env.PLAYWRIGHT_MCP_PORT);\n  options.proxyBypass = envToString(process.env.PLAYWRIGHT_MCP_PROXY_BYPASS);\n  options.proxyServer = envToString(process.env.PLAYWRIGHT_MCP_PROXY_SERVER);\n  options.saveTrace = envToBoolean(process.env.PLAYWRIGHT_MCP_SAVE_TRACE);\n  options.saveVideo = resolutionParser('--save-video', process.env.PLAYWRIGHT_MCP_SAVE_VIDEO);\n  options.secrets = dotenvFileLoader(process.env.PLAYWRIGHT_MCP_SECRETS_FILE);\n  options.storageState = envToString(process.env.PLAYWRIGHT_MCP_STORAGE_STATE);\n  options.testIdAttribute = envToString(process.env.PLAYWRIGHT_MCP_TEST_ID_ATTRIBUTE);\n  options.timeoutAction = numberParser(process.env.PLAYWRIGHT_MCP_TIMEOUT_ACTION);\n  options.timeoutNavigation = numberParser(process.env.PLAYWRIGHT_MCP_TIMEOUT_NAVIGATION);\n  options.userAgent = envToString(process.env.PLAYWRIGHT_MCP_USER_AGENT);\n  options.userDataDir = envToString(process.env.PLAYWRIGHT_MCP_USER_DATA_DIR);\n  options.viewportSize = resolutionParser('--viewport-size', process.env.PLAYWRIGHT_MCP_VIEWPORT_SIZE);\n  return configFromCLIOptions(options);\n}\n\nasync function loadConfig(configFile: string | undefined): Promise<Config> {\n  if (!configFile)\n    return {};\n\n  try {\n    return JSON.parse(await fs.promises.readFile(configFile, 'utf8'));\n  } catch (error) {\n    throw new Error(`Failed to load config file: ${configFile}, ${error}`);\n  }\n}\n\nfunction tmpDir(): string {\n  return path.join(process.env.PW_TMPDIR_FOR_TEST ?? os.tmpdir(), 'playwright-mcp-output');\n}\n\nexport function outputDir(config: FullConfig, clientInfo: ClientInfo): string {\n  const rootPath = firstRootPath(clientInfo);\n  return config.outputDir\n    ?? (rootPath ? path.join(rootPath, '.playwright-mcp') : undefined)\n    ?? path.join(tmpDir(), String(clientInfo.timestamp));\n}\n\nexport async function outputFile(config: FullConfig, clientInfo: ClientInfo, fileName: string, options: { origin: 'code' | 'llm' | 'web', reason: string }): Promise<string> {\n  const file = await resolveFile(config, clientInfo, fileName, options);\n  debug('pw:mcp:file')(options.reason, file);\n  return file;\n}\n\nasync function resolveFile(config: FullConfig, clientInfo: ClientInfo, fileName: string, options: { origin: 'code' | 'llm' | 'web' }): Promise<string> {\n  const dir = outputDir(config, clientInfo);\n\n  // Trust code.\n  if (options.origin === 'code')\n    return path.resolve(dir, fileName);\n\n  // Trust llm to use valid characters in file names.\n  if (options.origin === 'llm') {\n    fileName = fileName.split('\\\\').join('/');\n    const resolvedFile = path.resolve(dir, fileName);\n    if (!resolvedFile.startsWith(path.resolve(dir) + path.sep))\n      throw new Error(`Resolved file path ${resolvedFile} is outside of the output directory ${dir}. Use relative file names to stay within the output directory.`);\n    return resolvedFile;\n  }\n\n  // Do not trust web, at all.\n  return path.join(dir, sanitizeForFilePath(fileName));\n}\n\nfunction pickDefined<T extends object>(obj: T | undefined): Partial<T> {\n  return Object.fromEntries(\n      Object.entries(obj ?? {}).filter(([_, v]) => v !== undefined)\n  ) as Partial<T>;\n}\n\nfunction mergeConfig(base: FullConfig, overrides: Config): FullConfig {\n  const browser: FullConfig['browser'] = {\n    ...pickDefined(base.browser),\n    ...pickDefined(overrides.browser),\n    browserName: overrides.browser?.browserName ?? base.browser?.browserName ?? 'chromium',\n    isolated: overrides.browser?.isolated ?? base.browser?.isolated ?? false,\n    launchOptions: {\n      ...pickDefined(base.browser?.launchOptions),\n      ...pickDefined(overrides.browser?.launchOptions),\n      ...{ assistantMode: true },\n    },\n    contextOptions: {\n      ...pickDefined(base.browser?.contextOptions),\n      ...pickDefined(overrides.browser?.contextOptions),\n    },\n  };\n\n  if (browser.browserName !== 'chromium' && browser.launchOptions)\n    delete browser.launchOptions.channel;\n\n  return {\n    ...pickDefined(base),\n    ...pickDefined(overrides),\n    browser,\n    server: {\n      ...pickDefined(base.server),\n      ...pickDefined(overrides.server),\n    },\n    timeouts: {\n      ...pickDefined(base.timeouts),\n      ...pickDefined(overrides.timeouts),\n    },\n  } as FullConfig;\n}\n\nexport function commaSeparatedList(value: string | undefined): string[] | undefined {\n  if (!value)\n    return undefined;\n  return value.split(',').map(v => v.trim());\n}\n\nexport function dotenvFileLoader(value: string | undefined): Record<string, string> | undefined {\n  if (!value)\n    return undefined;\n  return dotenv.parse(fs.readFileSync(value, 'utf8'));\n}\n\nexport function numberParser(value: string | undefined): number | undefined {\n  if (!value)\n    return undefined;\n  return +value;\n}\n\nexport function resolutionParser(name: string, value: string | undefined): ViewportSize | undefined {\n  if (!value)\n    return undefined;\n  if (value.includes('x')) {\n    const [width, height] = value.split('x').map(v => +v);\n    if (isNaN(width) || isNaN(height) || width <= 0 || height <= 0)\n      throw new Error(`Invalid resolution format: use ${name}=\"800x600\"`);\n    return { width, height };\n  }\n\n  // Legacy format\n  if (value.includes(',')) {\n    const [width, height] = value.split(',').map(v => +v);\n    if (isNaN(width) || isNaN(height) || width <= 0 || height <= 0)\n      throw new Error(`Invalid resolution format: use ${name}=\"800x600\"`);\n    return { width, height };\n  }\n\n  throw new Error(`Invalid resolution format: use ${name}=\"800x600\"`);\n}\n\nexport function headerParser(arg: string | undefined, previous?: Record<string, string>): Record<string, string> {\n  if (!arg)\n    return previous || {};\n  const result: Record<string, string> = previous || {};\n  const [name, value] = arg.split(':').map(v => v.trim());\n  result[name] = value;\n  return result;\n}\n\nfunction envToBoolean(value: string | undefined): boolean | undefined {\n  if (value === 'true' || value === '1')\n    return true;\n  if (value === 'false' || value === '0')\n    return false;\n  return undefined;\n}\n\nfunction envToString(value: string | undefined): string | undefined {\n  return value ? value.trim() : undefined;\n}\n\nfunction sanitizeForFilePath(s: string) {\n  const sanitize = (s: string) => s.replace(/[\\x00-\\x2C\\x2E-\\x2F\\x3A-\\x40\\x5B-\\x60\\x7B-\\x7F]+/g, '-');\n  const separator = s.lastIndexOf('.');\n  if (separator === -1)\n    return sanitize(s);\n  return sanitize(s.substring(0, separator)) + '.' + sanitize(s.substring(separator + 1));\n}\n"],
+  "mappings": "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",
+  "names": ["os", "fs", "path", "s"]
+}