@cotestdev/mcp_playwright 0.0.24 → 0.0.26

package/lib/mcp/browser/browserContextFactory.js

@@ -90,22 +90,21 @@ class BaseContextFactory {
   async createContext(clientInfo) {
     (0, import_log.testDebug)(`create browser context (${this._logName})`);
     const browser = await this._obtainBrowser(clientInfo);
-    const browserContext = await this._doCreateContext(browser);
+    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);
@@ -133,8 +132,8 @@ class IsolatedContextFactory extends BaseContextFactory {
       throw error;
     });
   }
-  async _doCreateContext(browser) {
-    return browser.newContext(browserContextOptionsFromConfig(this.config));
+  async _doCreateContext(browser, clientInfo) {
+    return browser.newContext(await browserContextOptionsFromConfig(this.config, clientInfo));
   }
 }
 class CdpContextFactory extends BaseContextFactory {
@@ -184,7 +183,7 @@ class PersistentContextFactory {
       const launchOptions = {
         tracesDir,
         ...this.config.browser.launchOptions,
-        ...browserContextOptionsFromConfig(this.config),
+        ...await browserContextOptionsFromConfig(this.config, clientInfo),
         handleSIGINT: false,
         handleSIGTERM: false,
         ignoreDefaultArgs: [
@@ -195,7 +194,7 @@ class PersistentContextFactory {
       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"))
@@ -209,12 +208,11 @@ 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);
@@ -294,8 +292,7 @@ class SharedContextFactory {
     if (!contextPromise)
       return;
     const { close } = await contextPromise;
-    await close(async () => {
-    });
+    await close();
   }
 }
 async function computeTracesDir(config, clientInfo) {
@@ -303,11 +300,12 @@ async function computeTracesDir(config, clientInfo) {
     return;
   return await (0, import_config.outputFile)(config, clientInfo, `traces`, { origin: "code", reason: "Collecting trace" });
 }
-function browserContextOptionsFromConfig(config) {
+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", reason: "Saving video" });
     result.recordVideo = {
-      dir: (0, import_config.tmpDir)(),
+      dir,
       size: config.saveVideo
     };
   }

package/lib/mcp/browser/config.js

@@ -40,8 +40,7 @@ __export(config_exports, {
   resolutionParser: () => resolutionParser,
   resolveCLIConfig: () => resolveCLIConfig,
   resolveConfig: () => resolveConfig,
-  semicolonSeparatedList: () => semicolonSeparatedList,
-  tmpDir: () => tmpDir
+  semicolonSeparatedList: () => semicolonSeparatedList
 });
 module.exports = __toCommonJS(config_exports);
 var import_fs = __toESM(require("fs"));
@@ -187,6 +186,7 @@ function configFromCLIOptions(cliOptions) {
       allowedOrigins: cliOptions.allowedOrigins,
       blockedOrigins: cliOptions.blockedOrigins
     },
+    allowUnrestrictedFileAccess: cliOptions.allowUnrestrictedFileAccess,
     saveSession: cliOptions.saveSession,
     saveTrace: cliOptions.saveTrace,
     saveVideo: cliOptions.saveVideo,
@@ -207,6 +207,7 @@ 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);
@@ -413,6 +414,5 @@ function sanitizeForFilePath(s) {
   resolutionParser,
   resolveCLIConfig,
   resolveConfig,
-  semicolonSeparatedList,
-  tmpDir
+  semicolonSeparatedList
 });

package/lib/mcp/browser/context.js

@@ -32,14 +32,14 @@ __export(context_exports, {
   InputRecorder: () => InputRecorder
 });
 module.exports = __toCommonJS(context_exports);
-var import_fs = __toESM(require("fs"));
 var import_utilsBundle = require("playwright-core/lib/utilsBundle");
 var import_utils = require("playwright-core/lib/utils");
 var import_playwright_core = require("playwright-core");
+var import_url = require("url");
+var import_os = __toESM(require("os"));
 var import_log = require("../log");
 var import_tab = require("./tab");
 var import_config = require("./config");
-var import_utils2 = require("./tools/utils");
 const testDebug = (0, import_utilsBundle.debug)("pw:mcp:test");
 class Context {
   constructor(options) {
@@ -138,27 +138,7 @@ class Context {
     await promise.then(async ({ browserContext, close }) => {
       if (this.config.saveTrace)
         await browserContext.tracing.stop();
-      const videos = this.config.saveVideo ? browserContext.pages().map((page) => page.video()).filter((video) => !!video) : [];
-      await close(async () => {
-        for (const video of videos) {
-          const name = await this.outputFile((0, import_utils2.dateAsFileName)("webm"), { origin: "code", reason: "Saving video" });
-          const p = await video.path();
-          if (import_fs.default.existsSync(p)) {
-            try {
-              await import_fs.default.promises.rename(p, name);
-            } catch (e) {
-              if (e.code !== "EXDEV")
-                (0, import_log.logUnhandledError)(e);
-              try {
-                await import_fs.default.promises.copyFile(p, name);
-                await import_fs.default.promises.unlink(p);
-              } catch (e2) {
-                (0, import_log.logUnhandledError)(e2);
-              }
-            }
-          }
-        }
-      });
+      await close();
     });
   }
   async dispose() {
@@ -197,6 +177,10 @@ class Context {
       import_playwright_core.selectors.setTestIdAttribute(this.config.testIdAttribute);
     const result = await this._browserContextFactory.createContext(this._clientInfo, this._abortController.signal, this._runningToolName);
     const { browserContext } = result;
+    if (!this.config.allowUnrestrictedFileAccess) {
+      browserContext._setAllowedProtocols(["http:", "https:", "about:", "data:"]);
+      browserContext._setAllowedDirectories(allRootPaths(this._clientInfo));
+    }
     await this._setupRequestInterception(browserContext);
     if (this.sessionLog)
       await InputRecorder.create(this, browserContext);
@@ -222,6 +206,25 @@ class Context {
     };
   }
 }
+function allRootPaths(clientInfo) {
+  const paths = [];
+  for (const root of clientInfo.roots) {
+    const url = new URL(root.uri);
+    let rootPath;
+    try {
+      rootPath = (0, import_url.fileURLToPath)(url);
+    } catch (e) {
+      if (e.code === "ERR_INVALID_FILE_URL_PATH" && import_os.default.platform() === "win32")
+        rootPath = decodeURIComponent(url.pathname);
+    }
+    if (!rootPath)
+      continue;
+    paths.push(rootPath);
+  }
+  if (paths.length === 0)
+    paths.push(process.cwd());
+  return paths;
+}
 function originOrHostGlob(originOrHost) {
   try {
     const url = new URL(originOrHost);

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

@@ -40,7 +40,7 @@ const codeSchema = import_common.baseSchema.extend({
   code: import_mcpBundle.z.string().describe(`A Typescript function containing Playwright code to execute. It will be invoked with a single argument, page, which you can use for any page interaction. For example: \`async (page) => { await page.getByRole('button', { name: 'Submit' }).click(); return await page.title(); }\``)
 });
 const runCode = (0, import_tool.defineTabTool)({
-  capability: "extra",
+  capability: "core",
   schema: {
     name: "browser_run_code",
     title: "Run Playwright code",
@@ -73,6 +73,49 @@ const runCode = (0, import_tool.defineTabTool)({
     });
   }
 });
+const scriptSchema = import_common.baseSchema.extend({
+  code: import_mcpBundle.z.string().describe(`A Typescript function containing Playwright code to execute. It will be invoked with a single argument, page, which you can use for any page interaction. For example: \`async (page) => { await page.getByRole('button', { name: 'Submit' }).click(); return await page.title(); }\``),
+  params: import_mcpBundle.z.record(import_mcpBundle.z.any()).optional().describe("Parameters to pass to the script.")
+});
+const runScript = (0, import_tool.defineTabTool)({
+  capability: "extra",
+  schema: {
+    name: "browser_run_script",
+    title: "Run Playwright script",
+    description: "Run Playwright script",
+    inputSchema: scriptSchema,
+    type: "action"
+  },
+  handle: async (tab, params, response) => {
+    response.setIncludeSnapshot();
+    response.addCode(`await (${params.code})(page);`);
+    const __end__ = new import_utils.ManualPromise();
+    const context = {
+      page: tab.page,
+      __end__
+    };
+    if (params.params) {
+      for (const [key, value] of Object.entries(params.params))
+        context[key] = value;
+    }
+    import_vm.default.createContext(context);
+    await tab.waitForCompletion(async () => {
+      const snippet = `(async () => {
+        try {
+          const result = await (${params.code})(page);
+          __end__.resolve(JSON.stringify(result));
+        } catch (e) {
+          __end__.reject(e);
+        }
+      })()`;
+      await import_vm.default.runInContext(snippet, context);
+      const result = await __end__;
+      if (typeof result === "string")
+        response.addResult(result);
+    });
+  }
+});
 var runCode_default = [
-  runCode
+  runCode,
+  runScript
 ];

package/lib/mcp/browser/tools.js

@@ -33,13 +33,16 @@ __export(tools_exports, {
 });
 module.exports = __toCommonJS(tools_exports);
 var import_common = __toESM(require("./tools/common"));
+var import_console = __toESM(require("./tools/console"));
 var import_dialogs = __toESM(require("./tools/dialogs"));
 var import_evaluate = __toESM(require("./tools/evaluate"));
 var import_files = __toESM(require("./tools/files"));
 var import_form = __toESM(require("./tools/form"));
+var import_install = __toESM(require("./tools/install"));
 var import_keyboard = __toESM(require("./tools/keyboard"));
 var import_mouse = __toESM(require("./tools/mouse"));
 var import_navigate = __toESM(require("./tools/navigate"));
+var import_network = __toESM(require("./tools/network"));
 var import_pdf = __toESM(require("./tools/pdf"));
 var import_runCode = __toESM(require("./tools/runCode"));
 var import_snapshot = __toESM(require("./tools/snapshot"));
@@ -50,16 +53,15 @@ var import_wait = __toESM(require("./tools/wait"));
 var import_verify = __toESM(require("./tools/verify"));
 const browserTools = [
   ...import_common.default,
-  ...import_common.default,
-  // ...console,
+  ...import_console.default,
   ...import_dialogs.default,
   ...import_evaluate.default,
   ...import_files.default,
   ...import_form.default,
-  // ...install,
+  ...import_install.default,
   ...import_keyboard.default,
   ...import_navigate.default,
-  // ...network,
+  ...import_network.default,
   ...import_mouse.default,
   ...import_pdf.default,
   ...import_runCode.default,

package/lib/mcp/program.js

@@ -41,7 +41,7 @@ var import_browserContextFactory = require("./browser/browserContextFactory");
 var import_browserServerBackend = require("./browser/browserServerBackend");
 var import_extensionContextFactory = require("./extension/extensionContextFactory");
 function decorateCommand(command, version) {
-  command.option("--allowed-hosts <hosts...>", "comma-separated list of hosts this server is allowed to serve from. Defaults to the host the server is bound to. Pass '*' to disable the host check.", import_config.commaSeparatedList).option("--allowed-origins <origins>", "semicolon-separated list of TRUSTED origins to allow the browser to request. Default is to allow all.\nImportant: *does not* serve as a security boundary and *does not* affect redirects. ", import_config.semicolonSeparatedList).option("--blocked-origins <origins>", "semicolon-separated list of origins to block the browser from requesting. Blocklist is evaluated before allowlist. If used without the allowlist, requests not matching the blocklist are still allowed.\nImportant: *does not* serve as a security boundary and *does not* affect redirects.", import_config.semicolonSeparatedList).option("--block-service-workers", "block service workers").option("--browser <browser>", "browser or chrome channel to use, possible values: chrome, firefox, webkit, msedge.").option("--caps <caps>", "comma-separated list of additional capabilities to enable, possible values: vision, pdf.", import_config.commaSeparatedList).option("--cdp-endpoint <endpoint>", "CDP endpoint to connect to.").option("--cdp-header <headers...>", "CDP headers to send with the connect request, multiple can be specified.", import_config.headerParser).option("--config <path>", "path to the configuration file.").option("--console-level <level>", 'level of console messages to return: "error", "warning", "info", "debug". Each level includes the messages of more severe levels.', import_config.enumParser.bind(null, "--console-level", ["error", "warning", "info", "debug"])).option("--device <device>", 'device to emulate, for example: "iPhone 15"').option("--executable-path <path>", "path to the browser executable.").option("--extension", 'Connect to a running browser instance (Edge/Chrome only). Requires the "Playwright MCP Bridge" browser extension to be installed.').option("--grant-permissions <permissions...>", 'List of permissions to grant to the browser context, for example "geolocation", "clipboard-read", "clipboard-write".', import_config.commaSeparatedList).option("--headless", "run browser in headless mode, headed by default").option("--host <host>", "host to bind server to. Default is localhost. Use 0.0.0.0 to bind to all interfaces.").option("--ignore-https-errors", "ignore https errors").option("--init-page <path...>", "path to TypeScript file to evaluate on Playwright page object").option("--init-script <path...>", "path to JavaScript file to add as an initialization script. The script will be evaluated in every page before any of the page's scripts. Can be specified multiple times.").option("--isolated", "keep the browser profile in memory, do not save it to disk.").option("--image-responses <mode>", 'whether to send image responses to the client. Can be "allow" or "omit", Defaults to "allow".', import_config.enumParser.bind(null, "--image-responses", ["allow", "omit"])).option("--no-sandbox", "disable the sandbox for all process types that are normally sandboxed.").option("--output-dir <path>", "path to the directory for output files.").option("--port <port>", "port to listen on for SSE transport.").option("--proxy-bypass <bypass>", 'comma-separated domains to bypass proxy, for example ".com,chromium.org,.domain.com"').option("--proxy-server <proxy>", 'specify proxy server, for example "http://myproxy:3128" or "socks5://myproxy:8080"').option("--save-session", "Whether to save the Playwright MCP session into the output directory.").option("--save-trace", "Whether to save the Playwright Trace of the session into the output directory.").option("--save-video <size>", 'Whether to save the video of the session into the output directory. For example "--save-video=800x600"', import_config.resolutionParser.bind(null, "--save-video")).option("--secrets <path>", "path to a file containing secrets in the dotenv format", import_config.dotenvFileLoader).option("--shared-browser-context", "reuse the same browser context between all connected HTTP clients.").option("--snapshot-mode <mode>", 'when taking snapshots for responses, specifies the mode to use. Can be "incremental", "full", or "none". Default is incremental.').option("--storage-state <path>", "path to the storage state file for isolated sessions.").option("--test-id-attribute <attribute>", 'specify the attribute to use for test ids, defaults to "data-testid"').option("--timeout-action <timeout>", "specify action timeout in milliseconds, defaults to 5000ms", import_config.numberParser).option("--timeout-navigation <timeout>", "specify navigation timeout in milliseconds, defaults to 60000ms", import_config.numberParser).option("--user-agent <ua string>", "specify user agent string").option("--user-data-dir <path>", "path to the user data directory. If not specified, a temporary directory will be created.").option("--viewport-size <size>", 'specify browser viewport size in pixels, for example "1280x720"', import_config.resolutionParser.bind(null, "--viewport-size")).addOption(new import_utilsBundle.ProgramOption("--vision", "Legacy option, use --caps=vision instead").hideHelp()).action(async (options) => {
+  command.option("--allowed-hosts <hosts...>", "comma-separated list of hosts this server is allowed to serve from. Defaults to the host the server is bound to. Pass '*' to disable the host check.", import_config.commaSeparatedList).option("--allowed-origins <origins>", "semicolon-separated list of TRUSTED origins to allow the browser to request. Default is to allow all.\nImportant: *does not* serve as a security boundary and *does not* affect redirects. ", import_config.semicolonSeparatedList).option("--allow-unrestricted-file-access", "allow access to files outside of the workspace roots. Also allows unrestricted access to file:// URLs. By default access to file system is restricted to workspace root directories (or cwd if no roots are configured) only, and navigation to file:// URLs is blocked.").option("--blocked-origins <origins>", "semicolon-separated list of origins to block the browser from requesting. Blocklist is evaluated before allowlist. If used without the allowlist, requests not matching the blocklist are still allowed.\nImportant: *does not* serve as a security boundary and *does not* affect redirects.", import_config.semicolonSeparatedList).option("--block-service-workers", "block service workers").option("--browser <browser>", "browser or chrome channel to use, possible values: chrome, firefox, webkit, msedge.").option("--caps <caps>", "comma-separated list of additional capabilities to enable, possible values: vision, pdf.", import_config.commaSeparatedList).option("--cdp-endpoint <endpoint>", "CDP endpoint to connect to.").option("--cdp-header <headers...>", "CDP headers to send with the connect request, multiple can be specified.", import_config.headerParser).option("--config <path>", "path to the configuration file.").option("--console-level <level>", 'level of console messages to return: "error", "warning", "info", "debug". Each level includes the messages of more severe levels.', import_config.enumParser.bind(null, "--console-level", ["error", "warning", "info", "debug"])).option("--device <device>", 'device to emulate, for example: "iPhone 15"').option("--executable-path <path>", "path to the browser executable.").option("--extension", 'Connect to a running browser instance (Edge/Chrome only). Requires the "Playwright MCP Bridge" browser extension to be installed.').option("--grant-permissions <permissions...>", 'List of permissions to grant to the browser context, for example "geolocation", "clipboard-read", "clipboard-write".', import_config.commaSeparatedList).option("--headless", "run browser in headless mode, headed by default").option("--host <host>", "host to bind server to. Default is localhost. Use 0.0.0.0 to bind to all interfaces.").option("--ignore-https-errors", "ignore https errors").option("--init-page <path...>", "path to TypeScript file to evaluate on Playwright page object").option("--init-script <path...>", "path to JavaScript file to add as an initialization script. The script will be evaluated in every page before any of the page's scripts. Can be specified multiple times.").option("--isolated", "keep the browser profile in memory, do not save it to disk.").option("--image-responses <mode>", 'whether to send image responses to the client. Can be "allow" or "omit", Defaults to "allow".', import_config.enumParser.bind(null, "--image-responses", ["allow", "omit"])).option("--no-sandbox", "disable the sandbox for all process types that are normally sandboxed.").option("--output-dir <path>", "path to the directory for output files.").option("--port <port>", "port to listen on for SSE transport.").option("--proxy-bypass <bypass>", 'comma-separated domains to bypass proxy, for example ".com,chromium.org,.domain.com"').option("--proxy-server <proxy>", 'specify proxy server, for example "http://myproxy:3128" or "socks5://myproxy:8080"').option("--save-session", "Whether to save the Playwright MCP session into the output directory.").option("--save-trace", "Whether to save the Playwright Trace of the session into the output directory.").option("--save-video <size>", 'Whether to save the video of the session into the output directory. For example "--save-video=800x600"', import_config.resolutionParser.bind(null, "--save-video")).option("--secrets <path>", "path to a file containing secrets in the dotenv format", import_config.dotenvFileLoader).option("--shared-browser-context", "reuse the same browser context between all connected HTTP clients.").option("--snapshot-mode <mode>", 'when taking snapshots for responses, specifies the mode to use. Can be "incremental", "full", or "none". Default is incremental.').option("--storage-state <path>", "path to the storage state file for isolated sessions.").option("--test-id-attribute <attribute>", 'specify the attribute to use for test ids, defaults to "data-testid"').option("--timeout-action <timeout>", "specify action timeout in milliseconds, defaults to 5000ms", import_config.numberParser).option("--timeout-navigation <timeout>", "specify navigation timeout in milliseconds, defaults to 60000ms", import_config.numberParser).option("--user-agent <ua string>", "specify user agent string").option("--user-data-dir <path>", "path to the user data directory. If not specified, a temporary directory will be created.").option("--viewport-size <size>", 'specify browser viewport size in pixels, for example "1280x720"', import_config.resolutionParser.bind(null, "--viewport-size")).addOption(new import_utilsBundle.ProgramOption("--vision", "Legacy option, use --caps=vision instead").hideHelp()).action(async (options) => {
     (0, import_watchdog.setupExitWatchdog)();
     if (options.vision) {
       console.error("The --vision option is deprecated, use --caps=vision instead");

package/lib/mcp/sdk/server.js

@@ -28,6 +28,7 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 var server_exports = {};
 __export(server_exports, {
+  allRootPaths: () => allRootPaths,
   connect: () => connect,
   createServer: () => createServer,
   firstRootPath: () => firstRootPath,
@@ -175,6 +176,20 @@ function firstRootPath(clientInfo) {
     return void 0;
   }
 }
+function allRootPaths(clientInfo) {
+  const paths = [];
+  for (const root of clientInfo.roots) {
+    try {
+      const url = new URL(root.uri);
+      const path = (0, import_url.fileURLToPath)(url);
+      if (path)
+        paths.push(path);
+    } catch (error) {
+      serverDebug(error);
+    }
+  }
+  return paths;
+}
 function mergeTextParts(result) {
   const content = [];
   const testParts = [];
@@ -198,6 +213,7 @@ function mergeTextParts(result) {
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  allRootPaths,
   connect,
   createServer,
   firstRootPath,

package/lib/mcp/test/plannerTools.js

@@ -62,8 +62,10 @@ const planSchema = import_mcpBundle.z.object({
     tests: import_mcpBundle.z.array(import_mcpBundle.z.object({
       name: import_mcpBundle.z.string().describe("The name of the test"),
       file: import_mcpBundle.z.string().describe('The file the test should be saved to, for example: "tests/<suite-name>/<test-name>.spec.ts".'),
-      steps: import_mcpBundle.z.array(import_mcpBundle.z.string().describe(`The steps to be executed to perform the test. For example: 'Click on the "Submit" button'`)),
-      expectedResults: import_mcpBundle.z.array(import_mcpBundle.z.string().describe("The expected results of the steps for test to verify."))
+      steps: import_mcpBundle.z.array(import_mcpBundle.z.object({
+        perform: import_mcpBundle.z.string().optional().describe(`Action to perform. For example: 'Click on the "Submit" button'.`),
+        expect: import_mcpBundle.z.string().array().describe(`Expected result of the action where appropriate. For example: 'The page should show the "Thank you for your submission" message'`)
+      }))
     }))
   }))
 });
@@ -118,12 +120,11 @@ const saveTestPlan = (0, import_testTool.defineTestTool)({
         lines.push(`**File:** \`${test.file}\``);
         lines.push(``);
         lines.push(`**Steps:**`);
-        for (let k = 0; k < test.steps.length; k++)
-          lines.push(`  ${k + 1}. ${test.steps[k]}`);
-        lines.push(``);
-        lines.push(`**Expected Results:**`);
-        for (const result of test.expectedResults)
-          lines.push(`  - ${result}`);
+        for (let k = 0; k < test.steps.length; k++) {
+          lines.push(`  ${k + 1}. ${test.steps[k].perform ?? "-"}`);
+          for (const expect of test.steps[k].expect)
+            lines.push(`    - expect: ${expect}`);
+        }
       }
     }
     lines.push(``);

package/lib/mcp/test/testContext.js

@@ -172,7 +172,7 @@ class TestContext {
     const { testRunner, screen, claimStdio, releaseStdio } = testRunnerAndScreen;
     claimStdio();
     try {
-      const setupReporter = new import_list.default({ configDir, screen, includeTestId: true });
+      const setupReporter = new MCPListReporter({ configDir, screen, includeTestId: true });
       const { status: status2 } = await testRunner.runGlobalSetup([setupReporter]);
       if (status2 !== "passed")
         return { output: testRunnerAndScreen.output.join("\n"), status: status2 };
@@ -191,7 +191,7 @@ class TestContext {
       }
     };
     try {
-      const reporter = new import_list.default({ configDir, screen, includeTestId: true });
+      const reporter = new MCPListReporter({ configDir, screen, includeTestId: true });
       status = await Promise.race([
         testRunner.runTests(reporter, params).then((result) => result.status),
         testRunnerAndScreen.waitForTestPaused().then(() => "paused")
@@ -271,6 +271,12 @@ const bestPracticesMarkdown = `
 - NEVER! use page.waitForTimeout()
 - NEVER! use page.evaluate()
 `;
+class MCPListReporter extends import_list.default {
+  async onTestPaused() {
+    await new Promise(() => {
+    });
+  }
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   GeneratorJournal,