rae-playwright-mcp 0.0.1 → 0.0.2

package/lib/mcp/test/plannerTools.js

@@ -0,0 +1,145 @@
+"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 plannerTools_exports = {};
+__export(plannerTools_exports, {
+  saveTestPlan: () => saveTestPlan,
+  setupPage: () => setupPage,
+  submitTestPlan: () => submitTestPlan
+});
+module.exports = __toCommonJS(plannerTools_exports);
+var import_fs = __toESM(require("fs"));
+var import_path = __toESM(require("path"));
+var import_mcpBundle = require("playwright-core/lib/mcpBundle");
+var import_testTool = require("./testTool");
+const setupPage = (0, import_testTool.defineTestTool)({
+  schema: {
+    name: "planner_setup_page",
+    title: "Setup planner page",
+    description: "Setup the page for test planning",
+    inputSchema: import_mcpBundle.z.object({
+      project: import_mcpBundle.z.string().optional().describe('Project to use for setup. For example: "chromium", if no project is provided uses the first project in the config.'),
+      seedFile: import_mcpBundle.z.string().optional().describe('A seed file contains a single test that is used to setup the page for testing, for example: "tests/seed.spec.ts". If no seed file is provided, a default seed file is created.')
+    }),
+    type: "readOnly"
+  },
+  handle: async (context, params) => {
+    const seed = await context.getOrCreateSeedFile(params.seedFile, params.project);
+    const { output, status } = await context.runSeedTest(seed.file, seed.projectName);
+    return { content: [{ type: "text", text: output }], isError: status !== "paused" };
+  }
+});
+const planSchema = import_mcpBundle.z.object({
+  overview: import_mcpBundle.z.string().describe("A brief overview of the application to be tested"),
+  suites: import_mcpBundle.z.array(import_mcpBundle.z.object({
+    name: import_mcpBundle.z.string().describe("The name of the suite"),
+    seedFile: import_mcpBundle.z.string().describe("A seed file that was used to setup the page for testing."),
+    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."))
+    }))
+  }))
+});
+const submitTestPlan = (0, import_testTool.defineTestTool)({
+  schema: {
+    name: "planner_submit_plan",
+    title: "Submit test plan",
+    description: "Submit the test plan to the test planner",
+    inputSchema: planSchema,
+    type: "readOnly"
+  },
+  handle: async (context, params) => {
+    return {
+      content: [{
+        type: "text",
+        text: JSON.stringify(params, null, 2)
+      }]
+    };
+  }
+});
+const saveTestPlan = (0, import_testTool.defineTestTool)({
+  schema: {
+    name: "planner_save_plan",
+    title: "Save test plan as markdown file",
+    description: "Save the test plan as a markdown file",
+    inputSchema: planSchema.extend({
+      name: import_mcpBundle.z.string().describe('The name of the test plan, for example: "Test Plan".'),
+      fileName: import_mcpBundle.z.string().describe('The file to save the test plan to, for example: "spec/test.plan.md". Relative to the workspace root.')
+    }),
+    type: "readOnly"
+  },
+  handle: async (context, params) => {
+    const lines = [];
+    lines.push(`# ${params.name}`);
+    lines.push(``);
+    lines.push(`## Application Overview`);
+    lines.push(``);
+    lines.push(params.overview);
+    lines.push(``);
+    lines.push(`## Test Scenarios`);
+    for (let i = 0; i < params.suites.length; i++) {
+      lines.push(``);
+      const suite = params.suites[i];
+      lines.push(`### ${i + 1}. ${suite.name}`);
+      lines.push(``);
+      lines.push(`**Seed:** \`${suite.seedFile}\``);
+      for (let j = 0; j < suite.tests.length; j++) {
+        lines.push(``);
+        const test = suite.tests[j];
+        lines.push(`#### ${i + 1}.${j + 1}. ${test.name}`);
+        lines.push(``);
+        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}`);
+      }
+    }
+    lines.push(``);
+    await import_fs.default.promises.writeFile(import_path.default.resolve(context.rootPath, params.fileName), lines.join("\n"));
+    return {
+      content: [{
+        type: "text",
+        text: `Test plan saved to ${params.fileName}`
+      }]
+    };
+  }
+});
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  saveTestPlan,
+  setupPage,
+  submitTestPlan
+});
+//# sourceMappingURL=plannerTools.js.map

package/lib/mcp/test/plannerTools.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/mcp/test/plannerTools.ts"],
+  "sourcesContent": ["/**\n * Copyright (c) Microsoft Corporation.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport fs from 'fs';\nimport path from 'path';\n\nimport { z } from 'playwright-core/lib/mcpBundle';\nimport { defineTestTool } from './testTool';\n\nexport const setupPage = defineTestTool({\n  schema: {\n    name: 'planner_setup_page',\n    title: 'Setup planner page',\n    description: 'Setup the page for test planning',\n    inputSchema: z.object({\n      project: z.string().optional().describe('Project to use for setup. For example: \"chromium\", if no project is provided uses the first project in the config.'),\n      seedFile: z.string().optional().describe('A seed file contains a single test that is used to setup the page for testing, for example: \"tests/seed.spec.ts\". If no seed file is provided, a default seed file is created.'),\n    }),\n    type: 'readOnly',\n  },\n\n  handle: async (context, params) => {\n    const seed = await context.getOrCreateSeedFile(params.seedFile, params.project);\n    const { output, status } = await context.runSeedTest(seed.file, seed.projectName);\n    return { content: [{ type: 'text', text: output }], isError: status !== 'paused' };\n  },\n});\n\nconst planSchema = z.object({\n  overview: z.string().describe('A brief overview of the application to be tested'),\n  suites: z.array(z.object({\n    name: z.string().describe('The name of the suite'),\n    seedFile: z.string().describe('A seed file that was used to setup the page for testing.'),\n    tests: z.array(z.object({\n      name: z.string().describe('The name of the test'),\n      file: z.string().describe('The file the test should be saved to, for example: \"tests/<suite-name>/<test-name>.spec.ts\".'),\n      steps: z.array(z.string().describe(`The steps to be executed to perform the test. For example: 'Click on the \"Submit\" button'`)),\n      expectedResults: z.array(z.string().describe('The expected results of the steps for test to verify.')),\n    })),\n  })),\n});\n\nexport const submitTestPlan = defineTestTool({\n  schema: {\n    name: 'planner_submit_plan',\n    title: 'Submit test plan',\n    description: 'Submit the test plan to the test planner',\n    inputSchema: planSchema,\n    type: 'readOnly',\n  },\n\n  handle: async (context, params) => {\n    return {\n      content: [{\n        type: 'text',\n        text: JSON.stringify(params, null, 2),\n      }],\n    };\n  },\n});\n\nexport const saveTestPlan = defineTestTool({\n  schema: {\n    name: 'planner_save_plan',\n    title: 'Save test plan as markdown file',\n    description: 'Save the test plan as a markdown file',\n    inputSchema: planSchema.extend({\n      name: z.string().describe('The name of the test plan, for example: \"Test Plan\".'),\n      fileName: z.string().describe('The file to save the test plan to, for example: \"spec/test.plan.md\". Relative to the workspace root.'),\n    }),\n    type: 'readOnly',\n  },\n\n  handle: async (context, params) => {\n    const lines: string[] = [];\n    lines.push(`# ${params.name}`);\n    lines.push(``);\n    lines.push(`## Application Overview`);\n    lines.push(``);\n    lines.push(params.overview);\n    lines.push(``);\n    lines.push(`## Test Scenarios`);\n    for (let i = 0; i < params.suites.length; i++) {\n      lines.push(``);\n      const suite = params.suites[i];\n      lines.push(`### ${i + 1}. ${suite.name}`);\n      lines.push(``);\n      lines.push(`**Seed:** \\`${suite.seedFile}\\``);\n      for (let j = 0; j < suite.tests.length; j++) {\n        lines.push(``);\n        const test = suite.tests[j];\n        lines.push(`#### ${i + 1}.${j + 1}. ${test.name}`);\n        lines.push(``);\n        lines.push(`**File:** \\`${test.file}\\``);\n        lines.push(``);\n        lines.push(`**Steps:**`);\n        for (let k = 0; k < test.steps.length; k++)\n          lines.push(`  ${k + 1}. ${test.steps[k]}`);\n        lines.push(``);\n        lines.push(`**Expected Results:**`);\n        for (const result of test.expectedResults)\n          lines.push(`  - ${result}`);\n      }\n    }\n    lines.push(``);\n    await fs.promises.writeFile(path.resolve(context.rootPath, params.fileName), lines.join('\\n'));\n    return {\n      content: [{\n        type: 'text',\n        text: `Test plan saved to ${params.fileName}`,\n      }],\n    };\n  },\n});\n"],
+  "mappings": "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",
+  "names": ["fs", "path"]
+}

package/lib/mcp/test/seed.js

@@ -0,0 +1,83 @@
+"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 seed_exports = {};
+__export(seed_exports, {
+  defaultSeedFile: () => defaultSeedFile,
+  ensureSeedFile: () => ensureSeedFile,
+  findSeedFile: () => findSeedFile,
+  seedFileContent: () => seedFileContent,
+  seedProject: () => seedProject
+});
+module.exports = __toCommonJS(seed_exports);
+var import_fs = __toESM(require("fs"));
+var import_path = __toESM(require("path"));
+var import_utils = require("playwright-core/lib/utils");
+var import_projectUtils = require("../../runner/projectUtils");
+function seedProject(config, projectName) {
+  if (!projectName)
+    return (0, import_projectUtils.findTopLevelProjects)(config)[0];
+  const project = config.projects.find((p) => p.project.name === projectName);
+  if (!project)
+    throw new Error(`Project ${projectName} not found`);
+  return project;
+}
+async function findSeedFile(project) {
+  const files = await (0, import_projectUtils.collectFilesForProject)(project);
+  return files.find((file) => import_path.default.basename(file).includes("seed"));
+}
+function defaultSeedFile(project) {
+  const testDir = project.project.testDir;
+  return import_path.default.resolve(testDir, "seed.spec.ts");
+}
+async function ensureSeedFile(project) {
+  const seedFile = await findSeedFile(project);
+  if (seedFile)
+    return seedFile;
+  const seedFilePath = defaultSeedFile(project);
+  await (0, import_utils.mkdirIfNeeded)(seedFilePath);
+  await import_fs.default.promises.writeFile(seedFilePath, seedFileContent);
+  return seedFilePath;
+}
+const seedFileContent = `import { test, expect } from '@playwright/test';
+
+test.describe('Test group', () => {
+  test('seed', async ({ page }) => {
+    // generate code here.
+  });
+});
+`;
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  defaultSeedFile,
+  ensureSeedFile,
+  findSeedFile,
+  seedFileContent,
+  seedProject
+});
+//# sourceMappingURL=seed.js.map

package/lib/mcp/test/seed.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/mcp/test/seed.ts"],
+  "sourcesContent": ["/**\n * Copyright (c) Microsoft Corporation.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport fs from 'fs';\nimport path from 'path';\n\nimport { mkdirIfNeeded } from 'playwright-core/lib/utils';\nimport { collectFilesForProject, findTopLevelProjects } from '../../runner/projectUtils';\n\nimport type { FullConfigInternal, FullProjectInternal } from '../../common/config';\n\nexport function seedProject(config: FullConfigInternal, projectName?: string) {\n  if (!projectName)\n    return findTopLevelProjects(config)[0];\n  const project = config.projects.find(p => p.project.name === projectName);\n  if (!project)\n    throw new Error(`Project ${projectName} not found`);\n  return project;\n}\n\nexport async function findSeedFile(project: FullProjectInternal) {\n  const files = await collectFilesForProject(project);\n  return files.find(file => path.basename(file).includes('seed'));\n}\n\nexport function defaultSeedFile(project: FullProjectInternal) {\n  const testDir = project.project.testDir;\n  return path.resolve(testDir, 'seed.spec.ts');\n}\n\nexport async function ensureSeedFile(project: FullProjectInternal) {\n  const seedFile = await findSeedFile(project);\n  if (seedFile)\n    return seedFile;\n  const seedFilePath = defaultSeedFile(project);\n  await mkdirIfNeeded(seedFilePath);\n  await fs.promises.writeFile(seedFilePath, seedFileContent);\n  return seedFilePath;\n}\n\nexport const seedFileContent = `import { test, expect } from '@playwright/test';\n\ntest.describe('Test group', () => {\n  test('seed', async ({ page }) => {\n    // generate code here.\n  });\n});\n`;\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAgBA,gBAAe;AACf,kBAAiB;AAEjB,mBAA8B;AAC9B,0BAA6D;AAItD,SAAS,YAAY,QAA4B,aAAsB;AAC5E,MAAI,CAAC;AACH,eAAO,0CAAqB,MAAM,EAAE,CAAC;AACvC,QAAM,UAAU,OAAO,SAAS,KAAK,OAAK,EAAE,QAAQ,SAAS,WAAW;AACxE,MAAI,CAAC;AACH,UAAM,IAAI,MAAM,WAAW,WAAW,YAAY;AACpD,SAAO;AACT;AAEA,eAAsB,aAAa,SAA8B;AAC/D,QAAM,QAAQ,UAAM,4CAAuB,OAAO;AAClD,SAAO,MAAM,KAAK,UAAQ,YAAAA,QAAK,SAAS,IAAI,EAAE,SAAS,MAAM,CAAC;AAChE;AAEO,SAAS,gBAAgB,SAA8B;AAC5D,QAAM,UAAU,QAAQ,QAAQ;AAChC,SAAO,YAAAA,QAAK,QAAQ,SAAS,cAAc;AAC7C;AAEA,eAAsB,eAAe,SAA8B;AACjE,QAAM,WAAW,MAAM,aAAa,OAAO;AAC3C,MAAI;AACF,WAAO;AACT,QAAM,eAAe,gBAAgB,OAAO;AAC5C,YAAM,4BAAc,YAAY;AAChC,QAAM,UAAAC,QAAG,SAAS,UAAU,cAAc,eAAe;AACzD,SAAO;AACT;AAEO,MAAM,kBAAkB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;",
+  "names": ["path", "fs"]
+}

package/lib/mcp/test/streams.js

@@ -0,0 +1,45 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+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 __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var streams_exports = {};
+__export(streams_exports, {
+  StringWriteStream: () => StringWriteStream
+});
+module.exports = __toCommonJS(streams_exports);
+var import_stream = require("stream");
+var import_util = require("../../util");
+class StringWriteStream extends import_stream.Writable {
+  constructor(output, stdio) {
+    super();
+    this._output = output;
+    this._prefix = stdio === "stdout" ? "" : "[err] ";
+  }
+  _write(chunk, encoding, callback) {
+    let text = (0, import_util.stripAnsiEscapes)(chunk.toString());
+    if (text.endsWith("\n"))
+      text = text.slice(0, -1);
+    if (text)
+      this._output.push(this._prefix + text);
+    callback();
+  }
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  StringWriteStream
+});
+//# sourceMappingURL=streams.js.map

package/lib/mcp/test/streams.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/mcp/test/streams.ts"],
+  "sourcesContent": ["/**\n * Copyright (c) Microsoft Corporation.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { Writable } from 'stream';\n\nimport { stripAnsiEscapes } from '../../util';\n\nexport class StringWriteStream extends Writable {\n  private _output: string[];\n  private _prefix: string;\n\n  constructor(output: string[], stdio: 'stdout' | 'stderr') {\n    super();\n    this._output = output;\n    this._prefix = stdio === 'stdout' ? '' : '[err] ';\n  }\n\n  override _write(chunk: any, encoding: any, callback: any) {\n    let text = stripAnsiEscapes(chunk.toString());\n    if (text.endsWith('\\n'))\n      text = text.slice(0, -1);\n    if (text)\n      this._output.push(this._prefix + text);\n    callback();\n  }\n}\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAgBA,oBAAyB;AAEzB,kBAAiC;AAE1B,MAAM,0BAA0B,uBAAS;AAAA,EAI9C,YAAY,QAAkB,OAA4B;AACxD,UAAM;AACN,SAAK,UAAU;AACf,SAAK,UAAU,UAAU,WAAW,KAAK;AAAA,EAC3C;AAAA,EAES,OAAO,OAAY,UAAe,UAAe;AACxD,QAAI,WAAO,8BAAiB,MAAM,SAAS,CAAC;AAC5C,QAAI,KAAK,SAAS,IAAI;AACpB,aAAO,KAAK,MAAM,GAAG,EAAE;AACzB,QAAI;AACF,WAAK,QAAQ,KAAK,KAAK,UAAU,IAAI;AACvC,aAAS;AAAA,EACX;AACF;",
+  "names": []
+}

package/lib/mcp/test/testBackend.js

@@ -0,0 +1,100 @@
+"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 testBackend_exports = {};
+__export(testBackend_exports, {
+  TestServerBackend: () => TestServerBackend
+});
+module.exports = __toCommonJS(testBackend_exports);
+var import_mcpBundle = require("playwright-core/lib/mcpBundle");
+var mcp = __toESM(require("../sdk/exports"));
+var import_testContext = require("./testContext");
+var testTools = __toESM(require("./testTools.js"));
+var generatorTools = __toESM(require("./generatorTools.js"));
+var plannerTools = __toESM(require("./plannerTools.js"));
+var import_tools = require("../browser/tools");
+class TestServerBackend {
+  constructor(configPath, options) {
+    this.name = "Playwright";
+    this.version = "0.0.1";
+    this._tools = [
+      plannerTools.saveTestPlan,
+      plannerTools.setupPage,
+      plannerTools.submitTestPlan,
+      generatorTools.setupPage,
+      generatorTools.generatorReadLog,
+      generatorTools.generatorWriteTest,
+      testTools.listTests,
+      testTools.runTests,
+      testTools.debugTest,
+      ...import_tools.browserTools.map((tool) => wrapBrowserTool(tool))
+    ];
+    this._options = options || {};
+    this._configPath = configPath;
+  }
+  async initialize(clientInfo) {
+    this._context = new import_testContext.TestContext(clientInfo, this._configPath, this._options);
+  }
+  async listTools() {
+    return this._tools.map((tool) => mcp.toMcpTool(tool.schema));
+  }
+  async callTool(name, args) {
+    const tool = this._tools.find((tool2) => tool2.schema.name === name);
+    if (!tool)
+      throw new Error(`Tool not found: ${name}. Available tools: ${this._tools.map((tool2) => tool2.schema.name).join(", ")}`);
+    try {
+      return await tool.handle(this._context, tool.schema.inputSchema.parse(args || {}));
+    } catch (e) {
+      return { content: [{ type: "text", text: String(e) }], isError: true };
+    }
+  }
+  serverClosed() {
+    void this._context?.close();
+  }
+}
+const typesWithIntent = ["action", "assertion", "input"];
+function wrapBrowserTool(tool) {
+  const inputSchema = typesWithIntent.includes(tool.schema.type) ? tool.schema.inputSchema.extend({
+    intent: import_mcpBundle.z.string().describe("The intent of the call, for example the test step description plan idea")
+  }) : tool.schema.inputSchema;
+  return {
+    schema: {
+      ...tool.schema,
+      inputSchema
+    },
+    handle: async (context, params) => {
+      const response = await context.sendMessageToPausedTest({ callTool: { name: tool.schema.name, arguments: params } });
+      return response.callTool;
+    }
+  };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  TestServerBackend
+});
+//# sourceMappingURL=testBackend.js.map

package/lib/mcp/test/testBackend.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/mcp/test/testBackend.ts"],
+  "sourcesContent": ["/**\n * Copyright (c) Microsoft Corporation.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { z as zod } from 'playwright-core/lib/mcpBundle';\n\nimport * as mcp from '../sdk/exports';\nimport { TestContext } from './testContext';\nimport * as testTools from './testTools.js';\nimport * as generatorTools from './generatorTools.js';\nimport * as plannerTools from './plannerTools.js';\nimport { browserTools } from '../browser/tools';\n\nimport type { TestTool } from './testTool';\nimport type { Tool as BrowserTool } from '../browser/tools/tool';\n\nexport class TestServerBackend implements mcp.ServerBackend {\n  readonly name = 'Playwright';\n  readonly version = '0.0.1';\n  private _tools: TestTool<any>[] = [\n    plannerTools.saveTestPlan,\n    plannerTools.setupPage,\n    plannerTools.submitTestPlan,\n    generatorTools.setupPage,\n    generatorTools.generatorReadLog,\n    generatorTools.generatorWriteTest,\n    testTools.listTests,\n    testTools.runTests,\n    testTools.debugTest,\n    ...browserTools.map(tool => wrapBrowserTool(tool)),\n  ];\n  private _options: { muteConsole?: boolean, headless?: boolean };\n  private _context: TestContext | undefined;\n  private _configPath: string | undefined;\n\n  constructor(configPath: string | undefined, options?: { muteConsole?: boolean, headless?: boolean }) {\n    this._options = options || {};\n    this._configPath = configPath;\n  }\n\n  async initialize(clientInfo: mcp.ClientInfo): Promise<void> {\n    this._context = new TestContext(clientInfo, this._configPath, this._options);\n  }\n\n  async listTools(): Promise<mcp.Tool[]> {\n    return this._tools.map(tool => mcp.toMcpTool(tool.schema));\n  }\n\n  async callTool(name: string, args: mcp.CallToolRequest['params']['arguments']): Promise<mcp.CallToolResult> {\n    const tool = this._tools.find(tool => tool.schema.name === name);\n    if (!tool)\n      throw new Error(`Tool not found: ${name}. Available tools: ${this._tools.map(tool => tool.schema.name).join(', ')}`);\n    try {\n      return await tool.handle(this._context!, tool.schema.inputSchema.parse(args || {}));\n    } catch (e) {\n      return { content: [{ type: 'text', text: String(e) }], isError: true };\n    }\n  }\n\n  serverClosed() {\n    void this._context?.close();\n  }\n}\n\nconst typesWithIntent = ['action', 'assertion', 'input'];\n\nfunction wrapBrowserTool(tool: BrowserTool): TestTool {\n  const inputSchema = typesWithIntent.includes(tool.schema.type) ? (tool.schema.inputSchema as any).extend({\n    intent: zod.string().describe('The intent of the call, for example the test step description plan idea')\n  }) : tool.schema.inputSchema;\n  return {\n    schema: {\n      ...tool.schema,\n      inputSchema,\n    },\n    handle: async (context: TestContext, params: any) => {\n      const response = await context.sendMessageToPausedTest({ callTool: { name: tool.schema.name, arguments: params } });\n      return response.callTool!;\n    },\n  };\n}\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAgBA,uBAAyB;AAEzB,UAAqB;AACrB,yBAA4B;AAC5B,gBAA2B;AAC3B,qBAAgC;AAChC,mBAA8B;AAC9B,mBAA6B;AAKtB,MAAM,kBAA+C;AAAA,EAmB1D,YAAY,YAAgC,SAAyD;AAlBrG,SAAS,OAAO;AAChB,SAAS,UAAU;AACnB,SAAQ,SAA0B;AAAA,MAChC,aAAa;AAAA,MACb,aAAa;AAAA,MACb,aAAa;AAAA,MACb,eAAe;AAAA,MACf,eAAe;AAAA,MACf,eAAe;AAAA,MACf,UAAU;AAAA,MACV,UAAU;AAAA,MACV,UAAU;AAAA,MACV,GAAG,0BAAa,IAAI,UAAQ,gBAAgB,IAAI,CAAC;AAAA,IACnD;AAME,SAAK,WAAW,WAAW,CAAC;AAC5B,SAAK,cAAc;AAAA,EACrB;AAAA,EAEA,MAAM,WAAW,YAA2C;AAC1D,SAAK,WAAW,IAAI,+BAAY,YAAY,KAAK,aAAa,KAAK,QAAQ;AAAA,EAC7E;AAAA,EAEA,MAAM,YAAiC;AACrC,WAAO,KAAK,OAAO,IAAI,UAAQ,IAAI,UAAU,KAAK,MAAM,CAAC;AAAA,EAC3D;AAAA,EAEA,MAAM,SAAS,MAAc,MAA+E;AAC1G,UAAM,OAAO,KAAK,OAAO,KAAK,CAAAA,UAAQA,MAAK,OAAO,SAAS,IAAI;AAC/D,QAAI,CAAC;AACH,YAAM,IAAI,MAAM,mBAAmB,IAAI,sBAAsB,KAAK,OAAO,IAAI,CAAAA,UAAQA,MAAK,OAAO,IAAI,EAAE,KAAK,IAAI,CAAC,EAAE;AACrH,QAAI;AACF,aAAO,MAAM,KAAK,OAAO,KAAK,UAAW,KAAK,OAAO,YAAY,MAAM,QAAQ,CAAC,CAAC,CAAC;AAAA,IACpF,SAAS,GAAG;AACV,aAAO,EAAE,SAAS,CAAC,EAAE,MAAM,QAAQ,MAAM,OAAO,CAAC,EAAE,CAAC,GAAG,SAAS,KAAK;AAAA,IACvE;AAAA,EACF;AAAA,EAEA,eAAe;AACb,SAAK,KAAK,UAAU,MAAM;AAAA,EAC5B;AACF;AAEA,MAAM,kBAAkB,CAAC,UAAU,aAAa,OAAO;AAEvD,SAAS,gBAAgB,MAA6B;AACpD,QAAM,cAAc,gBAAgB,SAAS,KAAK,OAAO,IAAI,IAAK,KAAK,OAAO,YAAoB,OAAO;AAAA,IACvG,QAAQ,iBAAAC,EAAI,OAAO,EAAE,SAAS,yEAAyE;AAAA,EACzG,CAAC,IAAI,KAAK,OAAO;AACjB,SAAO;AAAA,IACL,QAAQ;AAAA,MACN,GAAG,KAAK;AAAA,MACR;AAAA,IACF;AAAA,IACA,QAAQ,OAAO,SAAsB,WAAgB;AACnD,YAAM,WAAW,MAAM,QAAQ,wBAAwB,EAAE,UAAU,EAAE,MAAM,KAAK,OAAO,MAAM,WAAW,OAAO,EAAE,CAAC;AAClH,aAAO,SAAS;AAAA,IAClB;AAAA,EACF;AACF;",
+  "names": ["tool", "zod"]
+}