@treegress.com/treegress-browser-mcp 0.0.56-treegress.3

package/README.md

@@ -0,0 +1,68 @@
+# @treegress.com/treegress-browser-mcp
+
+MCP server package for the Treegress browser stack.
+
+This package currently wraps the Playwright MCP runtime and resolves `playwright-core`
+from the published `@treegress.com/treegress-browser-core` package.
+
+`@treegress.com/treegress-browser-mcp` and `@treegress.com/treegress-browser-core` are intended to be released together.
+
+- `@treegress.com/treegress-browser-mcp` uses a pinned `@treegress.com/treegress-browser-core` version
+- If you change runtime behavior in `@treegress.com/treegress-browser-core`, update the pinned core dependency in this package and publish a new MCP version as well
+- If you change MCP-only behavior or packaging, you may only need a new `@treegress.com/treegress-browser-mcp` release
+
+## Cursor setup
+
+You do not need a global install.
+
+Create `.cursor/mcp.json` in the root of the project where you want to use the MCP server:
+
+```json
+{
+  "mcpServers": {
+    "treegress-browser": {
+      "type": "stdio",
+      "command": "npx",
+      "args": [
+        "-y",
+        "@treegress.com/treegress-browser-mcp@latest",
+        "--snapshot-engine",
+        "dom"
+      ]
+    }
+  }
+}
+```
+
+Notes:
+
+- Requires `Node.js 18+`
+- `@treegress.com/treegress-browser-core` is installed automatically as a dependency
+- Global `npm i -g` is not required
+- `--snapshot-engine dom` enables the Treegress custom DOM snapshot path
+
+## Build and publish
+
+Publish `@treegress.com/treegress-browser-core` first, then update the pinned core dependency in
+`packages/playwright-mcp/package.json` before publishing this package.
+
+Whenever the two packages need to stay aligned, treat the release as a coordinated pair: new core version first, then a new MCP version that points to it.
+
+Prepare the package tarball:
+
+```bash
+mkdir -p /tmp/treegress-release-artifacts
+mkdir -p /tmp/treegress-npm-cache
+
+cd <treegress-browser-mcp-repo>/packages/playwright-mcp
+npm_config_cache=/tmp/treegress-npm-cache npm pack --dry-run
+npm_config_cache=/tmp/treegress-npm-cache npm pack --pack-destination /tmp/treegress-release-artifacts
+```
+
+Publish to npmjs:
+
+```bash
+cd <treegress-browser-mcp-repo>/packages/playwright-mcp
+npm_config_cache=/tmp/treegress-npm-cache npm publish --access public
+npm view @treegress.com/treegress-browser-mcp version
+```

package/cli.js

@@ -0,0 +1,25 @@
+#!/usr/bin/env node
+/**
+ * Copyright (c) Microsoft Corporation.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+const { program } = require('playwright-core/lib/utilsBundle');
+const { decorateMCPCommand, decorateCommand } = require('./mcp/program');
+
+const packageJSON = require('./package.json');
+const p = program.version('Version ' + packageJSON.version).name('Playwright MCP');
+const decorate = decorateMCPCommand || decorateCommand;
+decorate(p, packageJSON.version);
+void program.parseAsync(process.argv);

package/config.d.ts

@@ -0,0 +1,223 @@
+/**
+ * Copyright (c) Microsoft Corporation.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+import type * as playwright from 'playwright';
+
+export type ToolCapability = 'core' | 'core-tabs' | 'core-install' | 'vision' | 'pdf' | 'testing' | 'tracing';
+
+export type Config = {
+  /**
+   * The browser to use.
+   */
+  browser?: {
+    /**
+     * The type of browser to use.
+     */
+    browserName?: 'chromium' | 'firefox' | 'webkit';
+
+    /**
+     * Keep the browser profile in memory, do not save it to disk.
+     */
+    isolated?: boolean;
+
+    /**
+     * Path to a user data directory for browser profile persistence.
+     * Temporary directory is created by default.
+     */
+    userDataDir?: string;
+
+    /**
+     * Launch options passed to
+     * @see https://playwright.dev/docs/api/class-browsertype#browser-type-launch-persistent-context
+     *
+     * This is useful for settings options like `channel`, `headless`, `executablePath`, etc.
+     */
+    launchOptions?: playwright.LaunchOptions;
+
+    /**
+     * Context options for the browser context.
+     *
+     * This is useful for settings options like `viewport`.
+     */
+    contextOptions?: playwright.BrowserContextOptions;
+
+    /**
+     * Chrome DevTools Protocol endpoint to connect to an existing browser instance in case of Chromium family browsers.
+     */
+    cdpEndpoint?: string;
+
+    /**
+     * CDP headers to send with the connect request.
+     */
+    cdpHeaders?: Record<string, string>;
+
+    /**
+     * Timeout in milliseconds for connecting to CDP endpoint. Defaults to 30000 (30 seconds). Pass 0 to disable timeout.
+     */
+    cdpTimeout?: number;
+
+    /**
+     * Remote endpoint to connect to an existing Playwright server.
+     */
+    remoteEndpoint?: string;
+
+    /**
+     * Paths to TypeScript files to add as initialization scripts for Playwright page.
+     */
+    initPage?: string[];
+
+    /**
+     * Paths to JavaScript files to add as initialization scripts.
+     * The scripts will be evaluated in every page before any of the page's scripts.
+     */
+    initScript?: string[];
+  },
+
+  server?: {
+    /**
+     * The port to listen on for SSE or MCP transport.
+     */
+    port?: number;
+
+    /**
+     * The host to bind the server to. Default is localhost. Use 0.0.0.0 to bind to all interfaces.
+     */
+    host?: string;
+
+    /**
+     * The hosts this server is allowed to serve from. Defaults to the host server is bound to.
+     * This is not for CORS, but rather for the DNS rebinding protection.
+     */
+    allowedHosts?: string[];
+  },
+
+  /**
+   * List of enabled tool capabilities. Possible values:
+   *   - 'core': Core browser automation features.
+   *   - 'pdf': PDF generation and manipulation.
+   *   - 'vision': Coordinate-based interactions.
+   */
+  capabilities?: ToolCapability[];
+
+  /**
+   * Whether to save the Playwright session into the output directory.
+   */
+  saveSession?: boolean;
+
+  /**
+   * Whether to save the Playwright trace of the session into the output directory.
+   */
+  saveTrace?: boolean;
+
+  /**
+   * If specified, saves the Playwright video of the session into the output directory.
+   */
+  saveVideo?: {
+    width: number;
+    height: number;
+  };
+
+  /**
+   * Reuse the same browser context between all connected HTTP clients.
+   */
+  sharedBrowserContext?: boolean;
+
+  /**
+   * Secrets are used to prevent LLM from getting sensitive data while
+   * automating scenarios such as authentication.
+   * Prefer the browser.contextOptions.storageState over secrets file as a more secure alternative.
+   */
+  secrets?: Record<string, string>;
+
+  /**
+   * The directory to save output files.
+   */
+  outputDir?: string;
+
+  console?: {
+    /**
+     * The level of console messages to return. Each level includes the messages of more severe levels. Defaults to "info".
+     */
+    level?: 'error' | 'warning' | 'info' | 'debug';
+  },
+
+  network?: {
+    /**
+     * List of origins to allow the browser to request. Default is to allow all. Origins matching both `allowedOrigins` and `blockedOrigins` will be blocked.
+     */
+    allowedOrigins?: string[];
+
+    /**
+     * List of origins to block the browser to request. Origins matching both `allowedOrigins` and `blockedOrigins` will be blocked.
+     */
+    blockedOrigins?: string[];
+  };
+
+  /**
+   * Specify the attribute to use for test ids, defaults to "data-testid".
+   */
+  testIdAttribute?: string;
+
+  timeouts?: {
+    /*
+     * Configures default action timeout: https://playwright.dev/docs/api/class-page#page-set-default-timeout. Defaults to 5000ms.
+     */
+    action?: number;
+
+    /*
+     * Configures default navigation timeout: https://playwright.dev/docs/api/class-page#page-set-default-navigation-timeout. Defaults to 60000ms.
+     */
+    navigation?: number;
+  };
+
+  /**
+   * Whether to send image responses to the client. Can be "allow", "omit", or "auto". Defaults to "auto", which sends images if the client can display them.
+   */
+  imageResponses?: 'allow' | 'omit';
+
+  snapshot?: {
+    /**
+     * When taking snapshots for responses, specifies the mode to use.
+     */
+    mode?: 'incremental' | 'full' | 'none';
+    /**
+     * Snapshot engine used to resolve element references.
+     * "aria" uses the built-in aria-ref engine.
+     * "dom" uses the playwright-core custom-dom backend.
+     */
+    engine?: 'aria' | 'dom';
+    /**
+     * Path to a DOM serializer module used only by the historical/debug-only
+     * local DOM engine retained in this fork.
+     */
+    domSerializerPath?: string;
+    /**
+     * Historical/debug-only local DOM engine: allow fallback to aria-ref
+     * resolution.
+     */
+    domFallbackToAria?: boolean;
+    /**
+     * Historical/debug-only local DOM engine: disable strict uniqueness check.
+     */
+    domNonstrict?: boolean;
+  }
+
+  /**
+   * Whether to allow file uploads from anywhere on the file system.
+   * By default (false), file uploads are restricted to paths within the MCP roots only.
+   */
+  allowUnrestrictedFileAccess?: boolean;
+};

package/index.d.ts

@@ -0,0 +1,23 @@
+#!/usr/bin/env node
+/**
+ * Copyright (c) Microsoft Corporation.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+import type { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import type { Config } from './config';
+import type { BrowserContext } from 'playwright';
+
+export declare function createConnection(config?: Config, contextGetter?: () => Promise<BrowserContext>): Promise<Server>;
+export {};

package/index.js

@@ -0,0 +1,19 @@
+#!/usr/bin/env node
+/**
+ * Copyright (c) Microsoft Corporation.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+const { createConnection } = require('./mcp/index');
+module.exports = { createConnection };

package/mcp/browser/browserContextFactory.js

@@ -0,0 +1,332 @@
+"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_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, options) => {
+      return {
+        browserContext,
+        close: async () => {
+        }
+      };
+    }
+  };
+}
+class BaseContextFactory {
+  constructor(name, config) {
+    this._logName = name;
+    this.config = config;
+  }
+  async _obtainBrowser(clientInfo, options) {
+    if (this._browserPromise)
+      return this._browserPromise;
+    (0, import_log.testDebug)(`obtain browser (${this._logName})`);
+    this._browserPromise = this._doObtainBrowser(clientInfo, options);
+    void this._browserPromise.then((browser) => {
+      browser.on("disconnected", () => {
+        this._browserPromise = void 0;
+      });
+    }).catch(() => {
+      this._browserPromise = void 0;
+    });
+    return this._browserPromise;
+  }
+  async _doObtainBrowser(clientInfo, options) {
+    throw new Error("Not implemented");
+  }
+  async createContext(clientInfo, _, options) {
+    (0, import_log.testDebug)(`create browser context (${this._logName})`);
+    const browser = await this._obtainBrowser(clientInfo, options);
+    const browserContext = await this._doCreateContext(browser, clientInfo);
+    await addInitScript(browserContext, this.config.browser.initScript);
+    return {
+      browserContext,
+      close: () => this._closeBrowserContext(browserContext, browser)
+    };
+  }
+  async _doCreateContext(browser, clientInfo) {
+    throw new Error("Not implemented");
+  }
+  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);
+    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, options) {
+    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"))
+        throwBrowserIsNotInstalledError(this.config);
+      throw error;
+    });
+  }
+  async _doCreateContext(browser, clientInfo) {
+    return browser.newContext(await browserContextOptionsFromConfig(this.config, clientInfo));
+  }
+}
+class CdpContextFactory extends BaseContextFactory {
+  constructor(config) {
+    super("cdp", config);
+  }
+  async _doObtainBrowser() {
+    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];
+  }
+}
+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) {
+    return browser.newContext();
+  }
+}
+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, 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);
+    const tracesDir = await computeTracesDir(this.config, clientInfo);
+    if (tracesDir && this.config.saveTrace)
+      await startTraceServer(this.config, tracesDir);
+    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,
+        ...await browserContextOptionsFromConfig(this.config, clientInfo),
+        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 = () => this._closeBrowserContext(browserContext, userDataDir);
+        return { browserContext, close };
+      } catch (error) {
+        if (error.message.includes("Executable doesn't exist"))
+          throwBrowserIsNotInstalledError(this.config);
+        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 treegress-browser-core 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;
+        }
+        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) {
+    (0, import_log.testDebug)("close browser context (persistent)");
+    (0, import_log.testDebug)("release user data dir", userDataDir);
+    await browserContext.close().catch(() => {
+    });
+    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, options) {
+    if (!this._contextPromise) {
+      (0, import_log.testDebug)("create shared browser context");
+      this._contextPromise = this._baseFactory.createContext(clientInfo, abortSignal, options);
+    }
+    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 function computeTracesDir(config, clientInfo) {
+  return import_path.default.resolve((0, import_config.outputDir)(config, clientInfo), "traces");
+}
+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" });
+    result.recordVideo = {
+      dir,
+      size: config.saveVideo
+    };
+  }
+  return result;
+}
+function throwBrowserIsNotInstalledError(config) {
+  const channel = config.browser.launchOptions?.channel ?? config.browser.browserName;
+  if (config.skillMode)
+    throw new Error(`Browser "${channel}" is not installed. Run \`playwright-cli install-browser ${channel}\` to install`);
+  else
+    throw new Error(`Browser "${channel}" is not installed. Either install it (likely) or change the config.`);
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  SharedContextFactory,
+  contextFactory,
+  identityBrowserContextFactory
+});