playwright 1.56.0-alpha-2025-10-01 → 1.56.0-beta-1759412259000

package/lib/agents/generator.md

@@ -23,7 +23,6 @@ tools:
   - playwright-test/browser_verify_text_visible
   - playwright-test/browser_verify_value
   - playwright-test/browser_wait_for
-  - playwright-test/generator_log_step
   - playwright-test/generator_read_log
   - playwright-test/generator_setup_page
   - playwright-test/generator_write_test
@@ -38,14 +37,15 @@ application behavior.
 - Run the `generator_setup_page` tool to set up page for the scenario
 - For each step and verification in the scenario, do the following:
   - Use Playwright tool to manually execute it in real-time.
-  - Immediately after each tool execution, log the step via running `generator_log_step` tool.
+  - Use the step description as the intent for each Playwright tool call.
 - Retrieve generator log via `generator_read_log`
 - Immediately after reading the test log, invoke `generator_write_test` with the generated source code
   - File should contain single test
   - File name must be fs-friendly scenario name
   - Test must be placed in a describe matching the top-level test plan item
   - Test title must match the scenario name
-  - Includes a comment with the step text before each step execution
+  - Includes a comment with the step text before each step execution. Do not duplicate comments if step requires
+    multiple actions.
 
    <example-generation>
    For following plan:

package/lib/mcp/browser/context.js

@@ -144,11 +144,19 @@ class Context {
           const name = await this.outputFile((0, import_utils.dateAsFileName)("webm"), { origin: "code", reason: "Saving video" });
           await import_fs.default.promises.mkdir(import_path.default.dirname(name), { recursive: true });
           const p = await video.path();
-          try {
-            if (import_fs.default.existsSync(p))
+          if (import_fs.default.existsSync(p)) {
+            try {
               await import_fs.default.promises.rename(p, name);
-          } catch (e) {
-            (0, import_log.logUnhandledError)(e);
+            } 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);
+              }
+            }
           }
         }
       });

package/lib/mcp/browser/response.js

@@ -19,6 +19,7 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 var response_exports = {};
 __export(response_exports, {
   Response: () => Response,
+  parseResponse: () => parseResponse,
   requestDebug: () => requestDebug
 });
 module.exports = __toCommonJS(response_exports);
@@ -179,8 +180,49 @@ function trim(text, maxLength) {
     return text;
   return text.slice(0, maxLength) + "...";
 }
+function parseSections(text) {
+  const sections = /* @__PURE__ */ new Map();
+  const sectionHeaders = text.split(/^### /m).slice(1);
+  for (const section of sectionHeaders) {
+    const firstNewlineIndex = section.indexOf("\n");
+    if (firstNewlineIndex === -1)
+      continue;
+    const sectionName = section.substring(0, firstNewlineIndex);
+    const sectionContent = section.substring(firstNewlineIndex + 1).trim();
+    sections.set(sectionName, sectionContent);
+  }
+  return sections;
+}
+function parseResponse(response) {
+  if (response.content?.[0].type !== "text")
+    return void 0;
+  const text = response.content[0].text;
+  const sections = parseSections(text);
+  const result = sections.get("Result");
+  const code = sections.get("Ran Playwright code");
+  const tabs = sections.get("Open tabs");
+  const pageState = sections.get("Page state");
+  const consoleMessages = sections.get("New console messages");
+  const modalState = sections.get("Modal state");
+  const downloads = sections.get("Downloads");
+  const codeNoFrame = code?.replace(/^```js\n/, "").replace(/\n```$/, "");
+  const isError = response.isError;
+  const attachments = response.content.slice(1);
+  return {
+    result,
+    code: codeNoFrame,
+    tabs,
+    pageState,
+    consoleMessages,
+    modalState,
+    downloads,
+    isError,
+    attachments
+  };
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   Response,
+  parseResponse,
   requestDebug
 });

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

@@ -30,7 +30,7 @@ const close = (0, import_tool.defineTool)({
     title: "Close browser",
     description: "Close the page",
     inputSchema: import_bundle.z.object({}),
-    type: "readOnly"
+    type: "action"
   },
   handle: async (context, params, response) => {
     await context.closeBrowserContext();
@@ -48,7 +48,7 @@ const resize = (0, import_tool.defineTabTool)({
       width: import_bundle.z.number().describe("Width of the browser window"),
       height: import_bundle.z.number().describe("Height of the browser window")
     }),
-    type: "readOnly"
+    type: "action"
   },
   handle: async (tab, params, response) => {
     response.addCode(`await page.setViewportSize({ width: ${params.width}, height: ${params.height} });`);

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

@@ -34,7 +34,7 @@ const handleDialog = (0, import_tool.defineTabTool)({
       accept: import_bundle.z.boolean().describe("Whether to accept the dialog."),
       promptText: import_bundle.z.string().optional().describe("The text of the prompt in case of a prompt dialog.")
     }),
-    type: "destructive"
+    type: "action"
   },
   handle: async (tab, params, response) => {
     response.setIncludeSnapshot();

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

@@ -47,7 +47,7 @@ const evaluate = (0, import_tool.defineTabTool)({
     title: "Evaluate JavaScript",
     description: "Evaluate JavaScript expression on page or element",
     inputSchema: evaluateSchema,
-    type: "destructive"
+    type: "action"
   },
   handle: async (tab, params, response) => {
     response.setIncludeSnapshot();

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

@@ -33,7 +33,7 @@ const uploadFile = (0, import_tool.defineTabTool)({
     inputSchema: import_bundle.z.object({
       paths: import_bundle.z.array(import_bundle.z.string()).optional().describe("The absolute paths to the files to upload. Can be single file or multiple files. If omitted, file chooser is cancelled.")
     }),
-    type: "destructive"
+    type: "action"
   },
   handle: async (tab, params, response) => {
     response.setIncludeSnapshot();

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

@@ -49,7 +49,7 @@ const fillForm = (0, import_tool.defineTabTool)({
         value: import_bundle.z.string().describe("Value to fill in the field. If the field is a checkbox, the value should be `true` or `false`. If the field is a combobox, the value should be the text of the option.")
       })).describe("Fields to fill in")
     }),
-    type: "destructive"
+    type: "input"
   },
   handle: async (tab, params, response) => {
     for (const field of params.fields) {

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

@@ -42,7 +42,7 @@ const install = (0, import_tool.defineTool)({
     title: "Install the browser specified in the config",
     description: "Install the browser specified in the config. Call this if you get an error about the browser not being installed.",
     inputSchema: import_bundle.z.object({}),
-    type: "destructive"
+    type: "action"
   },
   handle: async (context, params, response) => {
     const channel = context.config.browser?.launchOptions?.channel ?? context.config.browser?.browserName ?? "chrome";

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

@@ -34,7 +34,7 @@ const pressKey = (0, import_tool.defineTabTool)({
     inputSchema: import_bundle.z.object({
       key: import_bundle.z.string().describe("Name of the key to press or a character to generate, such as `ArrowLeft` or `a`")
     }),
-    type: "destructive"
+    type: "input"
   },
   handle: async (tab, params, response) => {
     response.setIncludeSnapshot();
@@ -57,7 +57,7 @@ const type = (0, import_tool.defineTabTool)({
     title: "Type text",
     description: "Type text into editable element",
     inputSchema: typeSchema,
-    type: "destructive"
+    type: "input"
   },
   handle: async (tab, params, response) => {
     const locator = await tab.refLocator(params);

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

@@ -36,7 +36,7 @@ const mouseMove = (0, import_tool.defineTabTool)({
       x: import_bundle.z.number().describe("X coordinate"),
       y: import_bundle.z.number().describe("Y coordinate")
     }),
-    type: "readOnly"
+    type: "input"
   },
   handle: async (tab, params, response) => {
     response.addCode(`// Move mouse to (${params.x}, ${params.y})`);
@@ -56,7 +56,7 @@ const mouseClick = (0, import_tool.defineTabTool)({
       x: import_bundle.z.number().describe("X coordinate"),
       y: import_bundle.z.number().describe("Y coordinate")
     }),
-    type: "destructive"
+    type: "input"
   },
   handle: async (tab, params, response) => {
     response.setIncludeSnapshot();
@@ -83,7 +83,7 @@ const mouseDrag = (0, import_tool.defineTabTool)({
       endX: import_bundle.z.number().describe("End X coordinate"),
       endY: import_bundle.z.number().describe("End Y coordinate")
     }),
-    type: "destructive"
+    type: "input"
   },
   handle: async (tab, params, response) => {
     response.setIncludeSnapshot();

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

@@ -32,7 +32,7 @@ const navigate = (0, import_tool.defineTool)({
     inputSchema: import_bundle.z.object({
       url: import_bundle.z.string().describe("The URL to navigate to")
     }),
-    type: "destructive"
+    type: "action"
   },
   handle: async (context, params, response) => {
     const tab = await context.ensureTab();
@@ -48,7 +48,7 @@ const goBack = (0, import_tool.defineTabTool)({
     title: "Go back",
     description: "Go back to the previous page",
     inputSchema: import_bundle.z.object({}),
-    type: "readOnly"
+    type: "action"
   },
   handle: async (tab, params, response) => {
     await tab.page.goBack();

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

@@ -41,16 +41,6 @@ const screenshotSchema = import_bundle.z.object({
   element: import_bundle.z.string().optional().describe("Human-readable element description used to obtain permission to screenshot the element. If not provided, the screenshot will be taken of viewport. If element is provided, ref must be provided too."),
   ref: import_bundle.z.string().optional().describe("Exact target element reference from the page snapshot. If not provided, the screenshot will be taken of viewport. If ref is provided, element must be provided too."),
   fullPage: import_bundle.z.boolean().optional().describe("When true, takes a screenshot of the full scrollable page, instead of the currently visible viewport. Cannot be used with element screenshots.")
-}).refine((data) => {
-  return !!data.element === !!data.ref;
-}, {
-  message: "Both element and ref must be provided or neither.",
-  path: ["ref", "element"]
-}).refine((data) => {
-  return !(data.fullPage && (data.element || data.ref));
-}, {
-  message: "fullPage cannot be used with element screenshots.",
-  path: ["fullPage"]
 });
 const screenshot = (0, import_tool.defineTabTool)({
   capability: "core",
@@ -62,6 +52,10 @@ const screenshot = (0, import_tool.defineTabTool)({
     type: "readOnly"
   },
   handle: async (tab, params, response) => {
+    if (!!params.element !== !!params.ref)
+      throw new Error("Both element and ref must be provided or neither.");
+    if (params.fullPage && params.ref)
+      throw new Error("fullPage cannot be used with element screenshots.");
     const fileType = params.type || "png";
     const fileName = await tab.context.outputFile(params.filename ?? (0, import_utils.dateAsFileName)(fileType), { origin: "llm", reason: "Saving screenshot" });
     const options = {

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

@@ -66,7 +66,7 @@ const click = (0, import_tool.defineTabTool)({
     title: "Click",
     description: "Perform click on a web page",
     inputSchema: clickSchema,
-    type: "destructive"
+    type: "input"
   },
   handle: async (tab, params, response) => {
     response.setIncludeSnapshot();
@@ -101,7 +101,7 @@ const drag = (0, import_tool.defineTabTool)({
       endElement: import_bundle.z.string().describe("Human-readable target element description used to obtain the permission to interact with the element"),
       endRef: import_bundle.z.string().describe("Exact target element reference from the page snapshot")
     }),
-    type: "destructive"
+    type: "input"
   },
   handle: async (tab, params, response) => {
     response.setIncludeSnapshot();
@@ -122,7 +122,7 @@ const hover = (0, import_tool.defineTabTool)({
     title: "Hover mouse",
     description: "Hover over element on page",
     inputSchema: elementSchema,
-    type: "readOnly"
+    type: "input"
   },
   handle: async (tab, params, response) => {
     response.setIncludeSnapshot();
@@ -143,7 +143,7 @@ const selectOption = (0, import_tool.defineTabTool)({
     title: "Select option",
     description: "Select an option in a dropdown",
     inputSchema: selectOptionSchema,
-    type: "destructive"
+    type: "input"
   },
   handle: async (tab, params, response) => {
     response.setIncludeSnapshot();

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

@@ -33,7 +33,7 @@ const browserTabs = (0, import_tool.defineTool)({
       action: import_bundle.z.enum(["list", "new", "close", "select"]).describe("Operation to perform"),
       index: import_bundle.z.number().optional().describe("Tab index, used for close/select. If omitted for close, current tab is closed.")
     }),
-    type: "destructive"
+    type: "action"
   },
   handle: async (context, params, response) => {
     switch (params.action) {

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

@@ -45,7 +45,7 @@ const verifyElement = (0, import_tool.defineTabTool)({
       role: import_bundle.z.string().describe('ROLE of the element. Can be found in the snapshot like this: `- {ROLE} "Accessible Name":`'),
       accessibleName: import_bundle.z.string().describe('ACCESSIBLE_NAME of the element. Can be found in the snapshot like this: `- role "{ACCESSIBLE_NAME}"`')
     }),
-    type: "readOnly"
+    type: "assertion"
   },
   handle: async (tab, params, response) => {
     const locator = tab.page.getByRole(params.role, { name: params.accessibleName });
@@ -66,7 +66,7 @@ const verifyText = (0, import_tool.defineTabTool)({
     inputSchema: import_bundle.z.object({
       text: import_bundle.z.string().describe('TEXT to verify. Can be found in the snapshot like this: `- role "Accessible Name": {TEXT}` or like this: `- text: {TEXT}`')
     }),
-    type: "readOnly"
+    type: "assertion"
   },
   handle: async (tab, params, response) => {
     const locator = tab.page.getByText(params.text).filter({ visible: true });
@@ -89,7 +89,7 @@ const verifyList = (0, import_tool.defineTabTool)({
       ref: import_bundle.z.string().describe("Exact target element reference that points to the list"),
       items: import_bundle.z.array(import_bundle.z.string()).describe("Items to verify")
     }),
-    type: "readOnly"
+    type: "assertion"
   },
   handle: async (tab, params, response) => {
     const locator = await tab.refLocator({ ref: params.ref, element: params.element });
@@ -122,7 +122,7 @@ const verifyValue = (0, import_tool.defineTabTool)({
       ref: import_bundle.z.string().describe("Exact target element reference that points to the element"),
       value: import_bundle.z.string().describe('Value to verify. For checkbox, use "true" or "false".')
     }),
-    type: "readOnly"
+    type: "assertion"
   },
   handle: async (tab, params, response) => {
     const locator = await tab.refLocator({ ref: params.ref, element: params.element });

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

@@ -34,7 +34,7 @@ const wait = (0, import_tool.defineTool)({
       text: import_bundle.z.string().optional().describe("The text to wait for"),
       textGone: import_bundle.z.string().optional().describe("The text to wait for to disappear")
     }),
-    type: "readOnly"
+    type: "assertion"
   },
   handle: async (context, params, response) => {
     if (!params.text && !params.textGone && !params.time)

package/lib/mcp/program.js

@@ -39,9 +39,8 @@ var import_browserContextFactory = require("./browser/browserContextFactory");
 var import_proxyBackend = require("./sdk/proxyBackend");
 var import_browserServerBackend = require("./browser/browserServerBackend");
 var import_extensionContextFactory = require("./extension/extensionContextFactory");
-var import_host = require("./vscode/host");
 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 origins to allow the browser to request. Default is to allow all.", 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.", 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("--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-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".').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("--storage-state <path>", "path to the storage state file for isolated sessions.").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("--connect-tool", "Allow to switch between different browser connection methods.").hideHelp()).addOption(new import_utilsBundle.ProgramOption("--vscode", "VS Code tools.").hideHelp()).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 origins to allow the browser to request. Default is to allow all.", 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.", 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("--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-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".').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("--storage-state <path>", "path to the storage state file for isolated sessions.").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("--connect-tool", "Allow to switch between different browser connection methods.").hideHelp()).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");
@@ -60,10 +59,6 @@ function decorateCommand(command, version) {
       await mcpServer.start(serverBackendFactory, config.server);
       return;
     }
-    if (options.vscode) {
-      await (0, import_host.runVSCodeTools)(config);
-      return;
-    }
     if (options.connectTool) {
       const providers = [
         {

package/lib/mcp/sdk/bundle.js

@@ -34,6 +34,7 @@ __export(bundle_exports, {
   ListToolsRequestSchema: () => ListToolsRequestSchema,
   PingRequestSchema: () => PingRequestSchema,
   ProgressNotificationSchema: () => ProgressNotificationSchema,
+  SSEClientTransport: () => SSEClientTransport,
   SSEServerTransport: () => SSEServerTransport,
   Server: () => Server,
   StdioClientTransport: () => StdioClientTransport,
@@ -48,6 +49,7 @@ var bundle = __toESM(require("../../mcpBundleImpl"));
 const zodToJsonSchema = bundle.zodToJsonSchema;
 const Client = bundle.Client;
 const Server = bundle.Server;
+const SSEClientTransport = bundle.SSEClientTransport;
 const SSEServerTransport = bundle.SSEServerTransport;
 const StdioClientTransport = bundle.StdioClientTransport;
 const StdioServerTransport = bundle.StdioServerTransport;
@@ -67,6 +69,7 @@ const z = bundle.z;
   ListToolsRequestSchema,
   PingRequestSchema,
   ProgressNotificationSchema,
+  SSEClientTransport,
   SSEServerTransport,
   Server,
   StdioClientTransport,

package/lib/mcp/sdk/mdb.js

@@ -39,60 +39,47 @@ var import_tool = require("./tool");
 var mcpBundle = __toESM(require("./bundle"));
 var mcpServer = __toESM(require("./server"));
 var mcpHttp = __toESM(require("./http"));
-var import_server = require("./server");
 const mdbDebug = (0, import_utilsBundle.debug)("pw:mcp:mdb");
 const errorsDebug = (0, import_utilsBundle.debug)("pw:mcp:errors");
 const z = mcpBundle.z;
 class MDBBackend {
-  constructor(topLevelBackend, allowedOnPause) {
-    this._stack = [];
+  constructor(mainBackend) {
     this._progress = [];
-    this._topLevelBackend = topLevelBackend;
-    this._allowedOnPause = allowedOnPause;
+    this._mainBackend = mainBackend;
+    this._progressCallback = (params) => {
+      if (params.message)
+        this._progress.push({ type: "text", text: params.message });
+    };
   }
   async initialize(server, clientInfo) {
-    if (!this._clientInfo)
+    if (!this._clientInfo) {
       this._clientInfo = clientInfo;
+      await this._mainBackend.initialize?.(server, clientInfo);
+    }
   }
   async listTools() {
-    const client = await this._client();
-    const response = await client.listTools();
-    return response.tools;
+    return await this._mainBackend.listTools();
   }
   async callTool(name, args) {
-    await this._client();
-    if (name === pushToolsSchema.name)
-      return await this._pushTools(pushToolsSchema.inputSchema.parse(args || {}));
-    const interruptPromise = new import_utils.ManualPromise();
-    this._interruptPromise = interruptPromise;
-    if (!this._allowedOnPause.includes(name)) {
-      for (let i = 0; i < this._stack.length - 1; i++) {
-        if (this._stack[i].toolNames.includes(name))
-          break;
-        await this._stack[i].client.close().catch(errorsDebug);
-        this._stack.shift();
-      }
+    if (name === pushToolsSchema.name) {
+      await this._createOnPauseClient(pushToolsSchema.inputSchema.parse(args || {}));
+      return { content: [{ type: "text", text: "Tools pushed" }] };
     }
-    let entry;
-    for (let i = 0; i < this._stack.length; i++) {
-      if (this._stack[i].toolNames.includes(name)) {
-        entry = this._stack[i];
-        break;
-      }
-      mdbDebug("popping client from stack for ", name);
+    if (this._onPauseClient?.tools.find((tool) => tool.name === name)) {
+      const result2 = await this._onPauseClient.client.callTool({
+        name,
+        arguments: args
+      });
+      await this._mainBackend.afterCallTool?.(name, args, result2);
+      return result2;
     }
-    if (!entry)
-      throw new Error(`Tool ${name} not found in the tool stack`);
-    const client = entry.client;
+    await this._onPauseClient?.transport.terminateSession().catch(errorsDebug);
+    await this._onPauseClient?.client.close().catch(errorsDebug);
+    this._onPauseClient = void 0;
     const resultPromise = new import_utils.ManualPromise();
-    entry.resultPromise = resultPromise;
-    client.callTool({
-      name,
-      arguments: args,
-      _meta: {
-        progressToken: name + "@" + (0, import_utils.createGuid)().slice(0, 8)
-      }
-    }).then((result2) => {
+    const interruptPromise = new import_utils.ManualPromise();
+    this._interruptPromise = interruptPromise;
+    this._mainBackend.callTool(name, args, this._progressCallback).then((result2) => {
       resultPromise.resolve(result2);
     }).catch((e) => {
       resultPromise.resolve({ content: [{ type: "text", text: String(e) }], isError: true });
@@ -106,21 +93,19 @@ class MDBBackend {
     this._progress.length = 0;
     return result;
   }
-  async _client() {
-    if (!this._stack.length) {
-      const transport = await (0, import_server.wrapInProcess)(this._topLevelBackend);
-      await this._pushClient(transport);
-    }
-    return this._stack[0].client;
-  }
-  async _pushTools(params) {
-    mdbDebug("pushing tools to the stack", params.mcpUrl);
-    const transport = new mcpBundle.StreamableHTTPClientTransport(new URL(params.mcpUrl));
-    await this._pushClient(transport, params.introMessage);
-    return { content: [{ type: "text", text: "Tools pushed" }] };
+  async _createOnPauseClient(params) {
+    if (this._onPauseClient)
+      await this._onPauseClient.client.close().catch(errorsDebug);
+    this._onPauseClient = await this._createClient(params.mcpUrl);
+    this._interruptPromise?.resolve({
+      content: [{
+        type: "text",
+        text: params.introMessage || ""
+      }]
+    });
+    this._interruptPromise = void 0;
   }
-  async _pushClient(transport, introMessage) {
-    mdbDebug("pushing client to the stack");
+  async _createClient(url) {
     const client = new mcpBundle.Client({ name: "Interrupting client", version: "0.0.0" }, { capabilities: { roots: {} } });
     client.setRequestHandler(mcpBundle.ListRootsRequestSchema, () => ({ roots: this._clientInfo?.roots || [] }));
     client.setRequestHandler(mcpBundle.PingRequestSchema, () => ({}));
@@ -131,20 +116,10 @@ class MDBBackend {
           this._progress.push({ type: "text", text: message });
       }
     });
+    const transport = new mcpBundle.StreamableHTTPClientTransport(new URL(url));
     await client.connect(transport);
-    mdbDebug("connected to the new client");
     const { tools } = await client.listTools();
-    this._stack.unshift({ client, toolNames: tools.map((tool) => tool.name), resultPromise: void 0 });
-    mdbDebug("new tools added to the stack:", tools.map((tool) => tool.name));
-    mdbDebug("interrupting current call:", !!this._interruptPromise);
-    this._interruptPromise?.resolve({
-      content: [{
-        type: "text",
-        text: introMessage || ""
-      }]
-    });
-    this._interruptPromise = void 0;
-    return { content: [{ type: "text", text: "Tools pushed" }] };
+    return { client, tools, transport };
   }
 }
 const pushToolsSchema = (0, import_tool.defineToolSchema)({
@@ -157,8 +132,8 @@ const pushToolsSchema = (0, import_tool.defineToolSchema)({
   }),
   type: "readOnly"
 });
-async function runMainBackend(backendFactory, allowedOnPause, options) {
-  const mdbBackend = new MDBBackend(backendFactory.create(), allowedOnPause);
+async function runMainBackend(backendFactory, options) {
+  const mdbBackend = new MDBBackend(backendFactory.create());
   const factory = {
     ...backendFactory,
     create: () => mdbBackend

package/lib/mcp/sdk/tool.js

@@ -23,15 +23,20 @@ __export(tool_exports, {
 });
 module.exports = __toCommonJS(tool_exports);
 var import_bundle = require("../sdk/bundle");
-function toMcpTool(tool) {
+const typesWithIntent = ["action", "assertion", "input"];
+function toMcpTool(tool, options) {
+  const inputSchema = options?.addIntent && typesWithIntent.includes(tool.type) ? tool.inputSchema.extend({
+    intent: import_bundle.z.string().describe("The intent of the call, for example the test step description plan idea")
+  }) : tool.inputSchema;
+  const readOnly = tool.type === "readOnly" || tool.type === "assertion";
   return {
     name: tool.name,
     description: tool.description,
-    inputSchema: (0, import_bundle.zodToJsonSchema)(tool.inputSchema, { strictUnions: true }),
+    inputSchema: (0, import_bundle.zodToJsonSchema)(inputSchema, { strictUnions: true }),
     annotations: {
       title: tool.title,
-      readOnlyHint: tool.type === "readOnly",
-      destructiveHint: tool.type === "destructive",
+      readOnlyHint: readOnly,
+      destructiveHint: !readOnly,
       openWorldHint: true
     }
   };