@pedropaulovc/playwright 1.59.0-next

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (181) hide show
  1. package/ThirdPartyNotices.txt +5042 -0
  2. package/cli.js +19 -0
  3. package/index.d.ts +17 -0
  4. package/index.js +17 -0
  5. package/index.mjs +18 -0
  6. package/jsx-runtime.js +42 -0
  7. package/jsx-runtime.mjs +21 -0
  8. package/lib/agents/agentParser.js +89 -0
  9. package/lib/agents/copilot-setup-steps.yml +34 -0
  10. package/lib/agents/generateAgents.js +348 -0
  11. package/lib/agents/playwright-test-coverage.prompt.md +31 -0
  12. package/lib/agents/playwright-test-generate.prompt.md +8 -0
  13. package/lib/agents/playwright-test-generator.agent.md +88 -0
  14. package/lib/agents/playwright-test-heal.prompt.md +6 -0
  15. package/lib/agents/playwright-test-healer.agent.md +55 -0
  16. package/lib/agents/playwright-test-plan.prompt.md +9 -0
  17. package/lib/agents/playwright-test-planner.agent.md +73 -0
  18. package/lib/common/config.js +282 -0
  19. package/lib/common/configLoader.js +344 -0
  20. package/lib/common/esmLoaderHost.js +104 -0
  21. package/lib/common/expectBundle.js +28 -0
  22. package/lib/common/expectBundleImpl.js +407 -0
  23. package/lib/common/fixtures.js +302 -0
  24. package/lib/common/globals.js +58 -0
  25. package/lib/common/ipc.js +60 -0
  26. package/lib/common/poolBuilder.js +85 -0
  27. package/lib/common/process.js +132 -0
  28. package/lib/common/suiteUtils.js +140 -0
  29. package/lib/common/test.js +321 -0
  30. package/lib/common/testLoader.js +101 -0
  31. package/lib/common/testType.js +298 -0
  32. package/lib/common/validators.js +68 -0
  33. package/lib/fsWatcher.js +67 -0
  34. package/lib/index.js +726 -0
  35. package/lib/internalsForTest.js +42 -0
  36. package/lib/isomorphic/events.js +77 -0
  37. package/lib/isomorphic/folders.js +30 -0
  38. package/lib/isomorphic/stringInternPool.js +69 -0
  39. package/lib/isomorphic/teleReceiver.js +521 -0
  40. package/lib/isomorphic/teleSuiteUpdater.js +157 -0
  41. package/lib/isomorphic/testServerConnection.js +225 -0
  42. package/lib/isomorphic/testServerInterface.js +16 -0
  43. package/lib/isomorphic/testTree.js +329 -0
  44. package/lib/isomorphic/types.d.js +16 -0
  45. package/lib/loader/loaderMain.js +59 -0
  46. package/lib/matchers/expect.js +311 -0
  47. package/lib/matchers/matcherHint.js +44 -0
  48. package/lib/matchers/matchers.js +383 -0
  49. package/lib/matchers/toBeTruthy.js +75 -0
  50. package/lib/matchers/toEqual.js +100 -0
  51. package/lib/matchers/toHaveURL.js +101 -0
  52. package/lib/matchers/toMatchAriaSnapshot.js +159 -0
  53. package/lib/matchers/toMatchSnapshot.js +342 -0
  54. package/lib/matchers/toMatchText.js +99 -0
  55. package/lib/mcp/browser/actions.d.js +16 -0
  56. package/lib/mcp/browser/browserContextFactory.js +329 -0
  57. package/lib/mcp/browser/browserServerBackend.js +84 -0
  58. package/lib/mcp/browser/config.js +421 -0
  59. package/lib/mcp/browser/context.js +244 -0
  60. package/lib/mcp/browser/response.js +278 -0
  61. package/lib/mcp/browser/sessionLog.js +75 -0
  62. package/lib/mcp/browser/tab.js +351 -0
  63. package/lib/mcp/browser/tools/common.js +65 -0
  64. package/lib/mcp/browser/tools/console.js +61 -0
  65. package/lib/mcp/browser/tools/dialogs.js +60 -0
  66. package/lib/mcp/browser/tools/evaluate.js +61 -0
  67. package/lib/mcp/browser/tools/files.js +58 -0
  68. package/lib/mcp/browser/tools/form.js +63 -0
  69. package/lib/mcp/browser/tools/install.js +72 -0
  70. package/lib/mcp/browser/tools/keyboard.js +144 -0
  71. package/lib/mcp/browser/tools/mouse.js +159 -0
  72. package/lib/mcp/browser/tools/navigate.js +136 -0
  73. package/lib/mcp/browser/tools/navigateAndWait.js +66 -0
  74. package/lib/mcp/browser/tools/network.js +78 -0
  75. package/lib/mcp/browser/tools/pdf.js +49 -0
  76. package/lib/mcp/browser/tools/runCode.js +78 -0
  77. package/lib/mcp/browser/tools/screenshot.js +93 -0
  78. package/lib/mcp/browser/tools/snapshot.js +205 -0
  79. package/lib/mcp/browser/tools/snapshotViewport.js +63 -0
  80. package/lib/mcp/browser/tools/tabs.js +67 -0
  81. package/lib/mcp/browser/tools/tool.js +47 -0
  82. package/lib/mcp/browser/tools/tracing.js +74 -0
  83. package/lib/mcp/browser/tools/utils.js +94 -0
  84. package/lib/mcp/browser/tools/verify.js +143 -0
  85. package/lib/mcp/browser/tools/wait.js +63 -0
  86. package/lib/mcp/browser/tools.js +82 -0
  87. package/lib/mcp/browser/watchdog.js +44 -0
  88. package/lib/mcp/config.d.js +16 -0
  89. package/lib/mcp/extension/cdpRelay.js +351 -0
  90. package/lib/mcp/extension/extensionContextFactory.js +76 -0
  91. package/lib/mcp/extension/protocol.js +28 -0
  92. package/lib/mcp/index.js +61 -0
  93. package/lib/mcp/log.js +35 -0
  94. package/lib/mcp/program.js +110 -0
  95. package/lib/mcp/sdk/exports.js +28 -0
  96. package/lib/mcp/sdk/http.js +152 -0
  97. package/lib/mcp/sdk/inProcessTransport.js +71 -0
  98. package/lib/mcp/sdk/server.js +223 -0
  99. package/lib/mcp/sdk/tool.js +47 -0
  100. package/lib/mcp/terminal/cli.js +296 -0
  101. package/lib/mcp/terminal/command.js +56 -0
  102. package/lib/mcp/terminal/commands.js +519 -0
  103. package/lib/mcp/terminal/daemon.js +135 -0
  104. package/lib/mcp/terminal/help.json +47 -0
  105. package/lib/mcp/terminal/helpGenerator.js +115 -0
  106. package/lib/mcp/terminal/socketConnection.js +80 -0
  107. package/lib/mcp/test/browserBackend.js +98 -0
  108. package/lib/mcp/test/generatorTools.js +122 -0
  109. package/lib/mcp/test/plannerTools.js +145 -0
  110. package/lib/mcp/test/seed.js +82 -0
  111. package/lib/mcp/test/streams.js +44 -0
  112. package/lib/mcp/test/testBackend.js +99 -0
  113. package/lib/mcp/test/testContext.js +285 -0
  114. package/lib/mcp/test/testTool.js +30 -0
  115. package/lib/mcp/test/testTools.js +108 -0
  116. package/lib/plugins/gitCommitInfoPlugin.js +198 -0
  117. package/lib/plugins/index.js +28 -0
  118. package/lib/plugins/webServerPlugin.js +237 -0
  119. package/lib/program.js +417 -0
  120. package/lib/reporters/base.js +634 -0
  121. package/lib/reporters/blob.js +138 -0
  122. package/lib/reporters/dot.js +99 -0
  123. package/lib/reporters/empty.js +32 -0
  124. package/lib/reporters/github.js +128 -0
  125. package/lib/reporters/html.js +633 -0
  126. package/lib/reporters/internalReporter.js +138 -0
  127. package/lib/reporters/json.js +254 -0
  128. package/lib/reporters/junit.js +232 -0
  129. package/lib/reporters/line.js +131 -0
  130. package/lib/reporters/list.js +253 -0
  131. package/lib/reporters/listModeReporter.js +69 -0
  132. package/lib/reporters/markdown.js +144 -0
  133. package/lib/reporters/merge.js +558 -0
  134. package/lib/reporters/multiplexer.js +112 -0
  135. package/lib/reporters/reporterV2.js +102 -0
  136. package/lib/reporters/teleEmitter.js +317 -0
  137. package/lib/reporters/versions/blobV1.js +16 -0
  138. package/lib/runner/dispatcher.js +530 -0
  139. package/lib/runner/failureTracker.js +72 -0
  140. package/lib/runner/lastRun.js +77 -0
  141. package/lib/runner/loadUtils.js +334 -0
  142. package/lib/runner/loaderHost.js +89 -0
  143. package/lib/runner/processHost.js +180 -0
  144. package/lib/runner/projectUtils.js +241 -0
  145. package/lib/runner/rebase.js +189 -0
  146. package/lib/runner/reporters.js +138 -0
  147. package/lib/runner/sigIntWatcher.js +96 -0
  148. package/lib/runner/storage.js +91 -0
  149. package/lib/runner/taskRunner.js +127 -0
  150. package/lib/runner/tasks.js +410 -0
  151. package/lib/runner/testGroups.js +125 -0
  152. package/lib/runner/testRunner.js +398 -0
  153. package/lib/runner/testServer.js +269 -0
  154. package/lib/runner/uiModeReporter.js +30 -0
  155. package/lib/runner/vcs.js +72 -0
  156. package/lib/runner/watchMode.js +396 -0
  157. package/lib/runner/workerHost.js +104 -0
  158. package/lib/third_party/pirates.js +62 -0
  159. package/lib/third_party/tsconfig-loader.js +103 -0
  160. package/lib/transform/babelBundle.js +46 -0
  161. package/lib/transform/babelBundleImpl.js +461 -0
  162. package/lib/transform/compilationCache.js +274 -0
  163. package/lib/transform/esmLoader.js +103 -0
  164. package/lib/transform/md.js +221 -0
  165. package/lib/transform/portTransport.js +67 -0
  166. package/lib/transform/transform.js +303 -0
  167. package/lib/util.js +400 -0
  168. package/lib/utilsBundle.js +50 -0
  169. package/lib/utilsBundleImpl.js +103 -0
  170. package/lib/worker/fixtureRunner.js +262 -0
  171. package/lib/worker/testInfo.js +536 -0
  172. package/lib/worker/testTracing.js +345 -0
  173. package/lib/worker/timeoutManager.js +174 -0
  174. package/lib/worker/util.js +31 -0
  175. package/lib/worker/workerMain.js +530 -0
  176. package/package.json +72 -0
  177. package/test.d.ts +18 -0
  178. package/test.js +24 -0
  179. package/test.mjs +34 -0
  180. package/types/test.d.ts +10251 -0
  181. package/types/testReporter.d.ts +822 -0
@@ -0,0 +1,82 @@
1
+ "use strict";
2
+ var __create = Object.create;
3
+ var __defProp = Object.defineProperty;
4
+ var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
5
+ var __getOwnPropNames = Object.getOwnPropertyNames;
6
+ var __getProtoOf = Object.getPrototypeOf;
7
+ var __hasOwnProp = Object.prototype.hasOwnProperty;
8
+ var __export = (target, all) => {
9
+ for (var name in all)
10
+ __defProp(target, name, { get: all[name], enumerable: true });
11
+ };
12
+ var __copyProps = (to, from, except, desc) => {
13
+ if (from && typeof from === "object" || typeof from === "function") {
14
+ for (let key of __getOwnPropNames(from))
15
+ if (!__hasOwnProp.call(to, key) && key !== except)
16
+ __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
17
+ }
18
+ return to;
19
+ };
20
+ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
21
+ // If the importer is in node compatibility mode or this is not an ESM
22
+ // file that has been converted to a CommonJS file using a Babel-
23
+ // compatible transform (i.e. "__esModule" has not been set), then set
24
+ // "default" to the CommonJS "module.exports" for node compatibility.
25
+ isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
26
+ mod
27
+ ));
28
+ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
29
+ var seed_exports = {};
30
+ __export(seed_exports, {
31
+ defaultSeedFile: () => defaultSeedFile,
32
+ ensureSeedFile: () => ensureSeedFile,
33
+ findSeedFile: () => findSeedFile,
34
+ seedFileContent: () => seedFileContent,
35
+ seedProject: () => seedProject
36
+ });
37
+ module.exports = __toCommonJS(seed_exports);
38
+ var import_fs = __toESM(require("fs"));
39
+ var import_path = __toESM(require("path"));
40
+ var import_utils = require("playwright-core/lib/utils");
41
+ var import_projectUtils = require("../../runner/projectUtils");
42
+ function seedProject(config, projectName) {
43
+ if (!projectName)
44
+ return (0, import_projectUtils.findTopLevelProjects)(config)[0];
45
+ const project = config.projects.find((p) => p.project.name === projectName);
46
+ if (!project)
47
+ throw new Error(`Project ${projectName} not found`);
48
+ return project;
49
+ }
50
+ async function findSeedFile(project) {
51
+ const files = await (0, import_projectUtils.collectFilesForProject)(project);
52
+ return files.find((file) => import_path.default.basename(file).includes("seed"));
53
+ }
54
+ function defaultSeedFile(project) {
55
+ const testDir = project.project.testDir;
56
+ return import_path.default.resolve(testDir, "seed.spec.ts");
57
+ }
58
+ async function ensureSeedFile(project) {
59
+ const seedFile = await findSeedFile(project);
60
+ if (seedFile)
61
+ return seedFile;
62
+ const seedFilePath = defaultSeedFile(project);
63
+ await (0, import_utils.mkdirIfNeeded)(seedFilePath);
64
+ await import_fs.default.promises.writeFile(seedFilePath, seedFileContent);
65
+ return seedFilePath;
66
+ }
67
+ const seedFileContent = `import { test, expect } from '@playwright/test';
68
+
69
+ test.describe('Test group', () => {
70
+ test('seed', async ({ page }) => {
71
+ // generate code here.
72
+ });
73
+ });
74
+ `;
75
+ // Annotate the CommonJS export names for ESM import in node:
76
+ 0 && (module.exports = {
77
+ defaultSeedFile,
78
+ ensureSeedFile,
79
+ findSeedFile,
80
+ seedFileContent,
81
+ seedProject
82
+ });
@@ -0,0 +1,44 @@
1
+ "use strict";
2
+ var __defProp = Object.defineProperty;
3
+ var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
4
+ var __getOwnPropNames = Object.getOwnPropertyNames;
5
+ var __hasOwnProp = Object.prototype.hasOwnProperty;
6
+ var __export = (target, all) => {
7
+ for (var name in all)
8
+ __defProp(target, name, { get: all[name], enumerable: true });
9
+ };
10
+ var __copyProps = (to, from, except, desc) => {
11
+ if (from && typeof from === "object" || typeof from === "function") {
12
+ for (let key of __getOwnPropNames(from))
13
+ if (!__hasOwnProp.call(to, key) && key !== except)
14
+ __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
15
+ }
16
+ return to;
17
+ };
18
+ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
19
+ var streams_exports = {};
20
+ __export(streams_exports, {
21
+ StringWriteStream: () => StringWriteStream
22
+ });
23
+ module.exports = __toCommonJS(streams_exports);
24
+ var import_stream = require("stream");
25
+ var import_util = require("../../util");
26
+ class StringWriteStream extends import_stream.Writable {
27
+ constructor(output, stdio) {
28
+ super();
29
+ this._output = output;
30
+ this._prefix = stdio === "stdout" ? "" : "[err] ";
31
+ }
32
+ _write(chunk, encoding, callback) {
33
+ let text = (0, import_util.stripAnsiEscapes)(chunk.toString());
34
+ if (text.endsWith("\n"))
35
+ text = text.slice(0, -1);
36
+ if (text)
37
+ this._output.push(this._prefix + text);
38
+ callback();
39
+ }
40
+ }
41
+ // Annotate the CommonJS export names for ESM import in node:
42
+ 0 && (module.exports = {
43
+ StringWriteStream
44
+ });
@@ -0,0 +1,99 @@
1
+ "use strict";
2
+ var __create = Object.create;
3
+ var __defProp = Object.defineProperty;
4
+ var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
5
+ var __getOwnPropNames = Object.getOwnPropertyNames;
6
+ var __getProtoOf = Object.getPrototypeOf;
7
+ var __hasOwnProp = Object.prototype.hasOwnProperty;
8
+ var __export = (target, all) => {
9
+ for (var name in all)
10
+ __defProp(target, name, { get: all[name], enumerable: true });
11
+ };
12
+ var __copyProps = (to, from, except, desc) => {
13
+ if (from && typeof from === "object" || typeof from === "function") {
14
+ for (let key of __getOwnPropNames(from))
15
+ if (!__hasOwnProp.call(to, key) && key !== except)
16
+ __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
17
+ }
18
+ return to;
19
+ };
20
+ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
21
+ // If the importer is in node compatibility mode or this is not an ESM
22
+ // file that has been converted to a CommonJS file using a Babel-
23
+ // compatible transform (i.e. "__esModule" has not been set), then set
24
+ // "default" to the CommonJS "module.exports" for node compatibility.
25
+ isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
26
+ mod
27
+ ));
28
+ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
29
+ var testBackend_exports = {};
30
+ __export(testBackend_exports, {
31
+ TestServerBackend: () => TestServerBackend
32
+ });
33
+ module.exports = __toCommonJS(testBackend_exports);
34
+ var import_mcpBundle = require("playwright-core/lib/mcpBundle");
35
+ var mcp = __toESM(require("../sdk/exports"));
36
+ var import_testContext = require("./testContext");
37
+ var testTools = __toESM(require("./testTools.js"));
38
+ var generatorTools = __toESM(require("./generatorTools.js"));
39
+ var plannerTools = __toESM(require("./plannerTools.js"));
40
+ var import_tools = require("../browser/tools");
41
+ class TestServerBackend {
42
+ constructor(configPath, options) {
43
+ this.name = "Playwright";
44
+ this.version = "0.0.1";
45
+ this._tools = [
46
+ plannerTools.saveTestPlan,
47
+ plannerTools.setupPage,
48
+ plannerTools.submitTestPlan,
49
+ generatorTools.setupPage,
50
+ generatorTools.generatorReadLog,
51
+ generatorTools.generatorWriteTest,
52
+ testTools.listTests,
53
+ testTools.runTests,
54
+ testTools.debugTest,
55
+ ...import_tools.browserTools.map((tool) => wrapBrowserTool(tool))
56
+ ];
57
+ this._options = options || {};
58
+ this._configPath = configPath;
59
+ }
60
+ async initialize(clientInfo) {
61
+ this._context = new import_testContext.TestContext(clientInfo, this._configPath, this._options);
62
+ }
63
+ async listTools() {
64
+ return this._tools.map((tool) => mcp.toMcpTool(tool.schema));
65
+ }
66
+ async callTool(name, args) {
67
+ const tool = this._tools.find((tool2) => tool2.schema.name === name);
68
+ if (!tool)
69
+ throw new Error(`Tool not found: ${name}. Available tools: ${this._tools.map((tool2) => tool2.schema.name).join(", ")}`);
70
+ try {
71
+ return await tool.handle(this._context, tool.schema.inputSchema.parse(args || {}));
72
+ } catch (e) {
73
+ return { content: [{ type: "text", text: String(e) }], isError: true };
74
+ }
75
+ }
76
+ serverClosed() {
77
+ void this._context?.close();
78
+ }
79
+ }
80
+ const typesWithIntent = ["action", "assertion", "input"];
81
+ function wrapBrowserTool(tool) {
82
+ const inputSchema = typesWithIntent.includes(tool.schema.type) ? tool.schema.inputSchema.extend({
83
+ intent: import_mcpBundle.z.string().describe("The intent of the call, for example the test step description plan idea")
84
+ }) : tool.schema.inputSchema;
85
+ return {
86
+ schema: {
87
+ ...tool.schema,
88
+ inputSchema
89
+ },
90
+ handle: async (context, params) => {
91
+ const response = await context.sendMessageToPausedTest({ callTool: { name: tool.schema.name, arguments: params } });
92
+ return response.callTool;
93
+ }
94
+ };
95
+ }
96
+ // Annotate the CommonJS export names for ESM import in node:
97
+ 0 && (module.exports = {
98
+ TestServerBackend
99
+ });
@@ -0,0 +1,285 @@
1
+ "use strict";
2
+ var __create = Object.create;
3
+ var __defProp = Object.defineProperty;
4
+ var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
5
+ var __getOwnPropNames = Object.getOwnPropertyNames;
6
+ var __getProtoOf = Object.getPrototypeOf;
7
+ var __hasOwnProp = Object.prototype.hasOwnProperty;
8
+ var __export = (target, all) => {
9
+ for (var name in all)
10
+ __defProp(target, name, { get: all[name], enumerable: true });
11
+ };
12
+ var __copyProps = (to, from, except, desc) => {
13
+ if (from && typeof from === "object" || typeof from === "function") {
14
+ for (let key of __getOwnPropNames(from))
15
+ if (!__hasOwnProp.call(to, key) && key !== except)
16
+ __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
17
+ }
18
+ return to;
19
+ };
20
+ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
21
+ // If the importer is in node compatibility mode or this is not an ESM
22
+ // file that has been converted to a CommonJS file using a Babel-
23
+ // compatible transform (i.e. "__esModule" has not been set), then set
24
+ // "default" to the CommonJS "module.exports" for node compatibility.
25
+ isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
26
+ mod
27
+ ));
28
+ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
29
+ var testContext_exports = {};
30
+ __export(testContext_exports, {
31
+ GeneratorJournal: () => GeneratorJournal,
32
+ TestContext: () => TestContext,
33
+ createScreen: () => createScreen
34
+ });
35
+ module.exports = __toCommonJS(testContext_exports);
36
+ var import_fs = __toESM(require("fs"));
37
+ var import_os = __toESM(require("os"));
38
+ var import_path = __toESM(require("path"));
39
+ var import_utils = require("playwright-core/lib/utils");
40
+ var import_base = require("../../reporters/base");
41
+ var import_list = __toESM(require("../../reporters/list"));
42
+ var import_streams = require("./streams");
43
+ var import_util = require("../../util");
44
+ var import_testRunner = require("../../runner/testRunner");
45
+ var import_seed = require("./seed");
46
+ var import_exports = require("../sdk/exports");
47
+ var import_configLoader = require("../../common/configLoader");
48
+ var import_response = require("../browser/response");
49
+ var import_log = require("../log");
50
+ class GeneratorJournal {
51
+ constructor(rootPath, plan, seed) {
52
+ this._rootPath = rootPath;
53
+ this._plan = plan;
54
+ this._seed = seed;
55
+ this._steps = [];
56
+ }
57
+ logStep(title, code) {
58
+ if (title)
59
+ this._steps.push({ title, code });
60
+ }
61
+ journal() {
62
+ const result = [];
63
+ result.push(`# Plan`);
64
+ result.push(this._plan);
65
+ result.push(`# Seed file: ${(0, import_utils.toPosixPath)(import_path.default.relative(this._rootPath, this._seed.file))}`);
66
+ result.push("```ts");
67
+ result.push(this._seed.content);
68
+ result.push("```");
69
+ result.push(`# Steps`);
70
+ result.push(this._steps.map((step) => `### ${step.title}
71
+ \`\`\`ts
72
+ ${step.code}
73
+ \`\`\``).join("\n\n"));
74
+ result.push(bestPracticesMarkdown);
75
+ return result.join("\n\n");
76
+ }
77
+ }
78
+ class TestContext {
79
+ constructor(clientInfo, configPath, options) {
80
+ this._clientInfo = clientInfo;
81
+ const rootPath = (0, import_exports.firstRootPath)(clientInfo);
82
+ this._configLocation = (0, import_configLoader.resolveConfigLocation)(configPath || rootPath);
83
+ this.rootPath = rootPath || this._configLocation.configDir;
84
+ if (options?.headless !== void 0)
85
+ this.computedHeaded = !options.headless;
86
+ else
87
+ this.computedHeaded = !process.env.CI && !(import_os.default.platform() === "linux" && !process.env.DISPLAY);
88
+ }
89
+ existingTestRunner() {
90
+ return this._testRunnerAndScreen?.testRunner;
91
+ }
92
+ async _cleanupTestRunner() {
93
+ if (!this._testRunnerAndScreen)
94
+ return;
95
+ await this._testRunnerAndScreen.testRunner.stopTests();
96
+ this._testRunnerAndScreen.claimStdio();
97
+ try {
98
+ await this._testRunnerAndScreen.testRunner.runGlobalTeardown();
99
+ } finally {
100
+ this._testRunnerAndScreen.releaseStdio();
101
+ this._testRunnerAndScreen = void 0;
102
+ }
103
+ }
104
+ async createTestRunner() {
105
+ await this._cleanupTestRunner();
106
+ const testRunner = new import_testRunner.TestRunner(this._configLocation, {});
107
+ await testRunner.initialize({});
108
+ const testPaused = new import_utils.ManualPromise();
109
+ const testRunnerAndScreen = {
110
+ ...createScreen(),
111
+ testRunner,
112
+ waitForTestPaused: () => testPaused
113
+ };
114
+ this._testRunnerAndScreen = testRunnerAndScreen;
115
+ testRunner.on(import_testRunner.TestRunnerEvent.TestPaused, (params) => {
116
+ testRunnerAndScreen.sendMessageToPausedTest = params.sendMessage;
117
+ testPaused.resolve();
118
+ });
119
+ return testRunnerAndScreen;
120
+ }
121
+ async getOrCreateSeedFile(seedFile, projectName) {
122
+ const configDir = this._configLocation.configDir;
123
+ const { testRunner } = await this.createTestRunner();
124
+ const config = await testRunner.loadConfig();
125
+ const project = (0, import_seed.seedProject)(config, projectName);
126
+ if (!seedFile) {
127
+ seedFile = await (0, import_seed.ensureSeedFile)(project);
128
+ } else {
129
+ const candidateFiles = [];
130
+ const testDir = project.project.testDir;
131
+ candidateFiles.push(import_path.default.resolve(testDir, seedFile));
132
+ candidateFiles.push(import_path.default.resolve(configDir, seedFile));
133
+ candidateFiles.push(import_path.default.resolve(this.rootPath, seedFile));
134
+ let resolvedSeedFile;
135
+ for (const candidateFile of candidateFiles) {
136
+ if (await (0, import_util.fileExistsAsync)(candidateFile)) {
137
+ resolvedSeedFile = candidateFile;
138
+ break;
139
+ }
140
+ }
141
+ if (!resolvedSeedFile)
142
+ throw new Error("seed test not found.");
143
+ seedFile = resolvedSeedFile;
144
+ }
145
+ const seedFileContent = await import_fs.default.promises.readFile(seedFile, "utf8");
146
+ return {
147
+ file: seedFile,
148
+ content: seedFileContent,
149
+ projectName: project.project.name
150
+ };
151
+ }
152
+ async runSeedTest(seedFile, projectName) {
153
+ const result = await this.runTestsWithGlobalSetupAndPossiblePause({
154
+ headed: this.computedHeaded,
155
+ locations: ["/" + (0, import_utils.escapeRegExp)(seedFile) + "/"],
156
+ projects: [projectName],
157
+ timeout: 0,
158
+ workers: 1,
159
+ pauseAtEnd: true,
160
+ disableConfigReporters: true,
161
+ failOnLoadErrors: true
162
+ });
163
+ if (result.status === "passed")
164
+ result.output += "\nError: seed test not found.";
165
+ else if (result.status !== "paused")
166
+ result.output += "\nError while running the seed test.";
167
+ return result;
168
+ }
169
+ async runTestsWithGlobalSetupAndPossiblePause(params) {
170
+ const configDir = this._configLocation.configDir;
171
+ const testRunnerAndScreen = await this.createTestRunner();
172
+ const { testRunner, screen, claimStdio, releaseStdio } = testRunnerAndScreen;
173
+ claimStdio();
174
+ try {
175
+ const setupReporter = new MCPListReporter({ configDir, screen, includeTestId: true });
176
+ const { status: status2 } = await testRunner.runGlobalSetup([setupReporter]);
177
+ if (status2 !== "passed")
178
+ return { output: testRunnerAndScreen.output.join("\n"), status: status2 };
179
+ } finally {
180
+ releaseStdio();
181
+ }
182
+ let status = "passed";
183
+ const cleanup = async () => {
184
+ claimStdio();
185
+ try {
186
+ const result = await testRunner.runGlobalTeardown();
187
+ if (status === "passed")
188
+ status = result.status;
189
+ } finally {
190
+ releaseStdio();
191
+ }
192
+ };
193
+ try {
194
+ const reporter = new MCPListReporter({ configDir, screen, includeTestId: true });
195
+ status = await Promise.race([
196
+ testRunner.runTests(reporter, params).then((result) => result.status),
197
+ testRunnerAndScreen.waitForTestPaused().then(() => "paused")
198
+ ]);
199
+ if (status === "paused") {
200
+ const response = await testRunnerAndScreen.sendMessageToPausedTest({ request: { initialize: { clientInfo: this._clientInfo } } });
201
+ if (response.error)
202
+ throw new Error(response.error.message);
203
+ testRunnerAndScreen.output.push(response.response.initialize.pausedMessage);
204
+ return { output: testRunnerAndScreen.output.join("\n"), status };
205
+ }
206
+ } catch (e) {
207
+ status = "failed";
208
+ testRunnerAndScreen.output.push(String(e));
209
+ await cleanup();
210
+ return { output: testRunnerAndScreen.output.join("\n"), status };
211
+ }
212
+ await cleanup();
213
+ return { output: testRunnerAndScreen.output.join("\n"), status };
214
+ }
215
+ async close() {
216
+ await this._cleanupTestRunner().catch(import_log.logUnhandledError);
217
+ }
218
+ async sendMessageToPausedTest(request) {
219
+ const sendMessage = this._testRunnerAndScreen?.sendMessageToPausedTest;
220
+ if (!sendMessage)
221
+ throw new Error("Must setup test before interacting with the page");
222
+ const result = await sendMessage({ request });
223
+ if (result.error)
224
+ throw new Error(result.error.message);
225
+ if (typeof request?.callTool?.arguments?.["intent"] === "string") {
226
+ const response = (0, import_response.parseResponse)(result.response.callTool);
227
+ if (response && !response.isError && response.code)
228
+ this.generatorJournal?.logStep(request.callTool.arguments["intent"], response.code);
229
+ }
230
+ return result.response;
231
+ }
232
+ }
233
+ function createScreen() {
234
+ const output = [];
235
+ const stdout = new import_streams.StringWriteStream(output, "stdout");
236
+ const stderr = new import_streams.StringWriteStream(output, "stderr");
237
+ const screen = {
238
+ ...import_base.terminalScreen,
239
+ isTTY: false,
240
+ colors: import_utils.noColors,
241
+ stdout,
242
+ stderr
243
+ };
244
+ const originalStdoutWrite = process.stdout.write;
245
+ const originalStderrWrite = process.stderr.write;
246
+ const claimStdio = () => {
247
+ process.stdout.write = (chunk) => {
248
+ stdout.write(chunk);
249
+ return true;
250
+ };
251
+ process.stderr.write = (chunk) => {
252
+ stderr.write(chunk);
253
+ return true;
254
+ };
255
+ };
256
+ const releaseStdio = () => {
257
+ process.stdout.write = originalStdoutWrite;
258
+ process.stderr.write = originalStderrWrite;
259
+ };
260
+ return { screen, claimStdio, releaseStdio, output };
261
+ }
262
+ const bestPracticesMarkdown = `
263
+ # Best practices
264
+ - Do not improvise, do not add directives that were not asked for
265
+ - Use clear, descriptive assertions to validate the expected behavior
266
+ - Use reliable locators from this log
267
+ - Use local variables for locators that are used multiple times
268
+ - Use Playwright waiting assertions and best practices from this log
269
+ - NEVER! use page.waitForLoadState()
270
+ - NEVER! use page.waitForNavigation()
271
+ - NEVER! use page.waitForTimeout()
272
+ - NEVER! use page.evaluate()
273
+ `;
274
+ class MCPListReporter extends import_list.default {
275
+ async onTestPaused() {
276
+ await new Promise(() => {
277
+ });
278
+ }
279
+ }
280
+ // Annotate the CommonJS export names for ESM import in node:
281
+ 0 && (module.exports = {
282
+ GeneratorJournal,
283
+ TestContext,
284
+ createScreen
285
+ });
@@ -0,0 +1,30 @@
1
+ "use strict";
2
+ var __defProp = Object.defineProperty;
3
+ var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
4
+ var __getOwnPropNames = Object.getOwnPropertyNames;
5
+ var __hasOwnProp = Object.prototype.hasOwnProperty;
6
+ var __export = (target, all) => {
7
+ for (var name in all)
8
+ __defProp(target, name, { get: all[name], enumerable: true });
9
+ };
10
+ var __copyProps = (to, from, except, desc) => {
11
+ if (from && typeof from === "object" || typeof from === "function") {
12
+ for (let key of __getOwnPropNames(from))
13
+ if (!__hasOwnProp.call(to, key) && key !== except)
14
+ __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
15
+ }
16
+ return to;
17
+ };
18
+ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
19
+ var testTool_exports = {};
20
+ __export(testTool_exports, {
21
+ defineTestTool: () => defineTestTool
22
+ });
23
+ module.exports = __toCommonJS(testTool_exports);
24
+ function defineTestTool(tool) {
25
+ return tool;
26
+ }
27
+ // Annotate the CommonJS export names for ESM import in node:
28
+ 0 && (module.exports = {
29
+ defineTestTool
30
+ });
@@ -0,0 +1,108 @@
1
+ "use strict";
2
+ var __create = Object.create;
3
+ var __defProp = Object.defineProperty;
4
+ var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
5
+ var __getOwnPropNames = Object.getOwnPropertyNames;
6
+ var __getProtoOf = Object.getPrototypeOf;
7
+ var __hasOwnProp = Object.prototype.hasOwnProperty;
8
+ var __export = (target, all) => {
9
+ for (var name in all)
10
+ __defProp(target, name, { get: all[name], enumerable: true });
11
+ };
12
+ var __copyProps = (to, from, except, desc) => {
13
+ if (from && typeof from === "object" || typeof from === "function") {
14
+ for (let key of __getOwnPropNames(from))
15
+ if (!__hasOwnProp.call(to, key) && key !== except)
16
+ __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
17
+ }
18
+ return to;
19
+ };
20
+ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
21
+ // If the importer is in node compatibility mode or this is not an ESM
22
+ // file that has been converted to a CommonJS file using a Babel-
23
+ // compatible transform (i.e. "__esModule" has not been set), then set
24
+ // "default" to the CommonJS "module.exports" for node compatibility.
25
+ isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
26
+ mod
27
+ ));
28
+ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
29
+ var testTools_exports = {};
30
+ __export(testTools_exports, {
31
+ debugTest: () => debugTest,
32
+ listTests: () => listTests,
33
+ runTests: () => runTests
34
+ });
35
+ module.exports = __toCommonJS(testTools_exports);
36
+ var import_mcpBundle = require("playwright-core/lib/mcpBundle");
37
+ var import_listModeReporter = __toESM(require("../../reporters/listModeReporter"));
38
+ var import_testTool = require("./testTool");
39
+ const listTests = (0, import_testTool.defineTestTool)({
40
+ schema: {
41
+ name: "test_list",
42
+ title: "List tests",
43
+ description: "List tests",
44
+ inputSchema: import_mcpBundle.z.object({}),
45
+ type: "readOnly"
46
+ },
47
+ handle: async (context) => {
48
+ const { testRunner, screen, output } = await context.createTestRunner();
49
+ const reporter = new import_listModeReporter.default({ screen, includeTestId: true });
50
+ await testRunner.listTests(reporter, {});
51
+ return { content: output.map((text) => ({ type: "text", text })) };
52
+ }
53
+ });
54
+ const runTests = (0, import_testTool.defineTestTool)({
55
+ schema: {
56
+ name: "test_run",
57
+ title: "Run tests",
58
+ description: "Run tests",
59
+ inputSchema: import_mcpBundle.z.object({
60
+ locations: import_mcpBundle.z.array(import_mcpBundle.z.string()).optional().describe('Folder, file or location to run: "test/e2e" or "test/e2e/file.spec.ts" or "test/e2e/file.spec.ts:20"'),
61
+ projects: import_mcpBundle.z.array(import_mcpBundle.z.string()).optional().describe('Projects to run, projects from playwright.config.ts, by default runs all projects. Running with "chromium" is a good start')
62
+ }),
63
+ type: "readOnly"
64
+ },
65
+ handle: async (context, params) => {
66
+ const { output } = await context.runTestsWithGlobalSetupAndPossiblePause({
67
+ locations: params.locations ?? [],
68
+ projects: params.projects,
69
+ disableConfigReporters: true
70
+ });
71
+ return { content: [{ type: "text", text: output }] };
72
+ }
73
+ });
74
+ const debugTest = (0, import_testTool.defineTestTool)({
75
+ schema: {
76
+ name: "test_debug",
77
+ title: "Debug single test",
78
+ description: "Debug single test",
79
+ inputSchema: import_mcpBundle.z.object({
80
+ test: import_mcpBundle.z.object({
81
+ id: import_mcpBundle.z.string().describe("Test ID to debug."),
82
+ title: import_mcpBundle.z.string().describe("Human readable test title for granting permission to debug the test.")
83
+ })
84
+ }),
85
+ type: "readOnly"
86
+ },
87
+ handle: async (context, params) => {
88
+ const { output, status } = await context.runTestsWithGlobalSetupAndPossiblePause({
89
+ headed: context.computedHeaded,
90
+ locations: [],
91
+ // we can make this faster by passing the test's location, so we don't need to scan all tests to find the ID
92
+ testIds: [params.test.id],
93
+ // For automatic recovery
94
+ timeout: 0,
95
+ workers: 1,
96
+ pauseOnError: true,
97
+ disableConfigReporters: true,
98
+ actionTimeout: 5e3
99
+ });
100
+ return { content: [{ type: "text", text: output }], isError: status !== "paused" && status !== "passed" };
101
+ }
102
+ });
103
+ // Annotate the CommonJS export names for ESM import in node:
104
+ 0 && (module.exports = {
105
+ debugTest,
106
+ listTests,
107
+ runTests
108
+ });