Add SPA session validation and buglist, update migration docs

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>

node_modules/playwright/lib/mcp/test/browserBackend.js

@@ -1,9 +1,7 @@
 "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)
@@ -17,38 +15,54 @@ var __copyProps = (to, from, except, desc) => {
   }
   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 browserBackend_exports = {};
 __export(browserBackend_exports, {
-  runBrowserBackendAtEnd: () => runBrowserBackendAtEnd
+  createCustomMessageHandler: () => createCustomMessageHandler
 });
 module.exports = __toCommonJS(browserBackend_exports);
-var mcp = __toESM(require("../sdk/exports"));
-var import_globals = require("../../common/globals");
-var import_util = require("../../util");
 var import_config = require("../browser/config");
 var import_browserServerBackend = require("../browser/browserServerBackend");
 var import_tab = require("../browser/tab");
-async function runBrowserBackendAtEnd(context, errorMessage) {
-  const testInfo = (0, import_globals.currentTestInfo)();
-  if (!testInfo)
-    return;
-  const shouldPause = errorMessage ? testInfo?._pauseOnError() : testInfo?._pauseAtEnd();
-  if (!shouldPause)
-    return;
+var import_util = require("../../util");
+function createCustomMessageHandler(testInfo, context) {
+  let backend;
+  return async (data) => {
+    if (data.initialize) {
+      if (backend)
+        throw new Error("MCP backend is already initialized");
+      backend = new import_browserServerBackend.BrowserServerBackend({ ...import_config.defaultConfig, capabilities: ["testing"] }, identityFactory(context));
+      await backend.initialize(data.initialize.clientInfo);
+      const pausedMessage = await generatePausedMessage(testInfo, context);
+      return { initialize: { pausedMessage } };
+    }
+    if (data.listTools) {
+      if (!backend)
+        throw new Error("MCP backend is not initialized");
+      return { listTools: await backend.listTools() };
+    }
+    if (data.callTool) {
+      if (!backend)
+        throw new Error("MCP backend is not initialized");
+      return { callTool: await backend.callTool(data.callTool.name, data.callTool.arguments) };
+    }
+    if (data.close) {
+      backend?.serverClosed();
+      backend = void 0;
+      return { close: {} };
+    }
+    throw new Error("Unknown MCP request");
+  };
+}
+async function generatePausedMessage(testInfo, context) {
   const lines = [];
-  if (errorMessage)
-    lines.push(`### Paused on error:`, (0, import_util.stripAnsiEscapes)(errorMessage));
-  else
+  if (testInfo.errors.length) {
+    lines.push(`### Paused on error:`);
+    for (const error of testInfo.errors)
+      lines.push((0, import_util.stripAnsiEscapes)(error.message || ""));
+  } else {
     lines.push(`### Paused at end of test. ready for interaction`);
+  }
   for (let i = 0; i < context.pages().length; i++) {
     const page = context.pages()[i];
     const stateSuffix = context.pages().length > 1 ? i + 1 + " of " + context.pages().length : "state";
@@ -58,7 +72,7 @@ async function runBrowserBackendAtEnd(context, errorMessage) {
       `- Page URL: ${page.url()}`,
       `- Page Title: ${await page.title()}`.trim()
     );
-    let console = errorMessage ? await import_tab.Tab.collectConsoleMessages(page) : [];
+    let console = testInfo.errors.length ? await import_tab.Tab.collectConsoleMessages(page) : [];
     console = console.filter((msg) => !msg.type || msg.type === "error");
     if (console.length) {
       lines.push("- Console Messages:");
@@ -68,18 +82,14 @@ async function runBrowserBackendAtEnd(context, errorMessage) {
     lines.push(
       `- Page Snapshot:`,
       "```yaml",
-      await page._snapshotForAI(),
+      (await page._snapshotForAI()).full,
       "```"
     );
   }
   lines.push("");
-  if (errorMessage)
+  if (testInfo.errors.length)
     lines.push(`### Task`, `Try recovering from the error prior to continuing`);
-  const config = {
-    ...import_config.defaultConfig,
-    capabilities: ["testing"]
-  };
-  await mcp.runOnPauseBackendLoop(new import_browserServerBackend.BrowserServerBackend(config, identityFactory(context)), lines.join("\n"));
+  return lines.join("\n");
 }
 function identityFactory(browserContext) {
   return {
@@ -94,5 +104,5 @@ function identityFactory(browserContext) {
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
-  runBrowserBackendAtEnd
+  createCustomMessageHandler
 });