@one2x/playwright 1.57.0-alpha.1

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 (331) hide show
  1. package/LICENSE +202 -0
  2. package/NOTICE +5 -0
  3. package/README.md +168 -0
  4. package/ThirdPartyNotices.txt +6277 -0
  5. package/cli.js +19 -0
  6. package/index.d.ts +17 -0
  7. package/index.js +17 -0
  8. package/index.mjs +18 -0
  9. package/jsx-runtime.js +42 -0
  10. package/jsx-runtime.mjs +21 -0
  11. package/lib/agents/copilot-setup-steps.yml +34 -0
  12. package/lib/agents/generateAgents.js +394 -0
  13. package/lib/agents/generateAgents.js.map +7 -0
  14. package/lib/agents/playwright-test-coverage.prompt.md +31 -0
  15. package/lib/agents/playwright-test-generate.prompt.md +8 -0
  16. package/lib/agents/playwright-test-generator.agent.md +88 -0
  17. package/lib/agents/playwright-test-heal.prompt.md +6 -0
  18. package/lib/agents/playwright-test-healer.agent.md +55 -0
  19. package/lib/agents/playwright-test-plan.prompt.md +9 -0
  20. package/lib/agents/playwright-test-planner.agent.md +117 -0
  21. package/lib/common/config.js +280 -0
  22. package/lib/common/config.js.map +7 -0
  23. package/lib/common/configLoader.js +344 -0
  24. package/lib/common/configLoader.js.map +7 -0
  25. package/lib/common/esmLoaderHost.js +102 -0
  26. package/lib/common/esmLoaderHost.js.map +7 -0
  27. package/lib/common/expectBundle.js +52 -0
  28. package/lib/common/expectBundle.js.map +7 -0
  29. package/lib/common/expectBundleImpl.js +389 -0
  30. package/lib/common/expectBundleImpl.js.map +7 -0
  31. package/lib/common/fixtures.js +302 -0
  32. package/lib/common/fixtures.js.map +7 -0
  33. package/lib/common/globals.js +58 -0
  34. package/lib/common/globals.js.map +7 -0
  35. package/lib/common/ipc.js +60 -0
  36. package/lib/common/ipc.js.map +7 -0
  37. package/lib/common/poolBuilder.js +85 -0
  38. package/lib/common/poolBuilder.js.map +7 -0
  39. package/lib/common/process.js +104 -0
  40. package/lib/common/process.js.map +7 -0
  41. package/lib/common/suiteUtils.js +140 -0
  42. package/lib/common/suiteUtils.js.map +7 -0
  43. package/lib/common/test.js +321 -0
  44. package/lib/common/test.js.map +7 -0
  45. package/lib/common/testLoader.js +101 -0
  46. package/lib/common/testLoader.js.map +7 -0
  47. package/lib/common/testType.js +298 -0
  48. package/lib/common/testType.js.map +7 -0
  49. package/lib/common/validators.js +68 -0
  50. package/lib/common/validators.js.map +7 -0
  51. package/lib/fsWatcher.js +67 -0
  52. package/lib/fsWatcher.js.map +7 -0
  53. package/lib/index.js +682 -0
  54. package/lib/index.js.map +7 -0
  55. package/lib/internalsForTest.js +42 -0
  56. package/lib/internalsForTest.js.map +7 -0
  57. package/lib/isomorphic/events.js +77 -0
  58. package/lib/isomorphic/events.js.map +7 -0
  59. package/lib/isomorphic/folders.js +30 -0
  60. package/lib/isomorphic/folders.js.map +7 -0
  61. package/lib/isomorphic/stringInternPool.js +69 -0
  62. package/lib/isomorphic/stringInternPool.js.map +7 -0
  63. package/lib/isomorphic/teleReceiver.js +508 -0
  64. package/lib/isomorphic/teleReceiver.js.map +7 -0
  65. package/lib/isomorphic/teleSuiteUpdater.js +137 -0
  66. package/lib/isomorphic/teleSuiteUpdater.js.map +7 -0
  67. package/lib/isomorphic/testServerConnection.js +211 -0
  68. package/lib/isomorphic/testServerConnection.js.map +7 -0
  69. package/lib/isomorphic/testServerInterface.js +16 -0
  70. package/lib/isomorphic/testServerInterface.js.map +7 -0
  71. package/lib/isomorphic/testTree.js +334 -0
  72. package/lib/isomorphic/testTree.js.map +7 -0
  73. package/lib/isomorphic/types.d.js +16 -0
  74. package/lib/isomorphic/types.d.js.map +7 -0
  75. package/lib/loader/loaderMain.js +59 -0
  76. package/lib/loader/loaderMain.js.map +7 -0
  77. package/lib/matchers/expect.js +325 -0
  78. package/lib/matchers/expect.js.map +7 -0
  79. package/lib/matchers/matcherHint.js +87 -0
  80. package/lib/matchers/matcherHint.js.map +7 -0
  81. package/lib/matchers/matchers.js +366 -0
  82. package/lib/matchers/matchers.js.map +7 -0
  83. package/lib/matchers/toBeTruthy.js +73 -0
  84. package/lib/matchers/toBeTruthy.js.map +7 -0
  85. package/lib/matchers/toEqual.js +99 -0
  86. package/lib/matchers/toEqual.js.map +7 -0
  87. package/lib/matchers/toHaveURL.js +102 -0
  88. package/lib/matchers/toHaveURL.js.map +7 -0
  89. package/lib/matchers/toMatchAriaSnapshot.js +159 -0
  90. package/lib/matchers/toMatchAriaSnapshot.js.map +7 -0
  91. package/lib/matchers/toMatchSnapshot.js +341 -0
  92. package/lib/matchers/toMatchSnapshot.js.map +7 -0
  93. package/lib/matchers/toMatchText.js +99 -0
  94. package/lib/matchers/toMatchText.js.map +7 -0
  95. package/lib/mcp/browser/actions.d.js +16 -0
  96. package/lib/mcp/browser/actions.d.js.map +7 -0
  97. package/lib/mcp/browser/browserContextFactory.js +357 -0
  98. package/lib/mcp/browser/browserContextFactory.js.map +7 -0
  99. package/lib/mcp/browser/browserServerBackend.js +76 -0
  100. package/lib/mcp/browser/browserServerBackend.js.map +7 -0
  101. package/lib/mcp/browser/codegen.js +66 -0
  102. package/lib/mcp/browser/codegen.js.map +7 -0
  103. package/lib/mcp/browser/config.js +425 -0
  104. package/lib/mcp/browser/config.js.map +7 -0
  105. package/lib/mcp/browser/context.js +287 -0
  106. package/lib/mcp/browser/context.js.map +7 -0
  107. package/lib/mcp/browser/response.js +228 -0
  108. package/lib/mcp/browser/response.js.map +7 -0
  109. package/lib/mcp/browser/sessionLog.js +160 -0
  110. package/lib/mcp/browser/sessionLog.js.map +7 -0
  111. package/lib/mcp/browser/tab.js +280 -0
  112. package/lib/mcp/browser/tab.js.map +7 -0
  113. package/lib/mcp/browser/tools/actionRetry.js +40 -0
  114. package/lib/mcp/browser/tools/actionRetry.js.map +7 -0
  115. package/lib/mcp/browser/tools/common.js +63 -0
  116. package/lib/mcp/browser/tools/common.js.map +7 -0
  117. package/lib/mcp/browser/tools/console.js +44 -0
  118. package/lib/mcp/browser/tools/console.js.map +7 -0
  119. package/lib/mcp/browser/tools/dialogs.js +60 -0
  120. package/lib/mcp/browser/tools/dialogs.js.map +7 -0
  121. package/lib/mcp/browser/tools/evaluate.js +69 -0
  122. package/lib/mcp/browser/tools/evaluate.js.map +7 -0
  123. package/lib/mcp/browser/tools/files.js +58 -0
  124. package/lib/mcp/browser/tools/files.js.map +7 -0
  125. package/lib/mcp/browser/tools/form.js +79 -0
  126. package/lib/mcp/browser/tools/form.js.map +7 -0
  127. package/lib/mcp/browser/tools/install.js +69 -0
  128. package/lib/mcp/browser/tools/install.js.map +7 -0
  129. package/lib/mcp/browser/tools/keyboard.js +84 -0
  130. package/lib/mcp/browser/tools/keyboard.js.map +7 -0
  131. package/lib/mcp/browser/tools/mouse.js +107 -0
  132. package/lib/mcp/browser/tools/mouse.js.map +7 -0
  133. package/lib/mcp/browser/tools/navigate.js +62 -0
  134. package/lib/mcp/browser/tools/navigate.js.map +7 -0
  135. package/lib/mcp/browser/tools/network.js +54 -0
  136. package/lib/mcp/browser/tools/network.js.map +7 -0
  137. package/lib/mcp/browser/tools/pdf.js +59 -0
  138. package/lib/mcp/browser/tools/pdf.js.map +7 -0
  139. package/lib/mcp/browser/tools/screenshot.js +106 -0
  140. package/lib/mcp/browser/tools/screenshot.js.map +7 -0
  141. package/lib/mcp/browser/tools/snapshot.js +312 -0
  142. package/lib/mcp/browser/tools/snapshot.js.map +7 -0
  143. package/lib/mcp/browser/tools/tabs.js +67 -0
  144. package/lib/mcp/browser/tools/tabs.js.map +7 -0
  145. package/lib/mcp/browser/tools/tool.js +49 -0
  146. package/lib/mcp/browser/tools/tool.js.map +7 -0
  147. package/lib/mcp/browser/tools/tracing.js +74 -0
  148. package/lib/mcp/browser/tools/tracing.js.map +7 -0
  149. package/lib/mcp/browser/tools/utils.js +96 -0
  150. package/lib/mcp/browser/tools/utils.js.map +7 -0
  151. package/lib/mcp/browser/tools/verify.js +153 -0
  152. package/lib/mcp/browser/tools/verify.js.map +7 -0
  153. package/lib/mcp/browser/tools/wait.js +63 -0
  154. package/lib/mcp/browser/tools/wait.js.map +7 -0
  155. package/lib/mcp/browser/tools.js +80 -0
  156. package/lib/mcp/browser/tools.js.map +7 -0
  157. package/lib/mcp/browser/watchdog.js +44 -0
  158. package/lib/mcp/browser/watchdog.js.map +7 -0
  159. package/lib/mcp/config.d.js +16 -0
  160. package/lib/mcp/config.d.js.map +7 -0
  161. package/lib/mcp/extension/cdpRelay.js +351 -0
  162. package/lib/mcp/extension/cdpRelay.js.map +7 -0
  163. package/lib/mcp/extension/extensionContextFactory.js +75 -0
  164. package/lib/mcp/extension/extensionContextFactory.js.map +7 -0
  165. package/lib/mcp/extension/protocol.js +28 -0
  166. package/lib/mcp/extension/protocol.js.map +7 -0
  167. package/lib/mcp/index.js +61 -0
  168. package/lib/mcp/index.js.map +7 -0
  169. package/lib/mcp/log.js +35 -0
  170. package/lib/mcp/log.js.map +7 -0
  171. package/lib/mcp/program.js +118 -0
  172. package/lib/mcp/program.js.map +7 -0
  173. package/lib/mcp/sdk/bundle.js +81 -0
  174. package/lib/mcp/sdk/bundle.js.map +7 -0
  175. package/lib/mcp/sdk/exports.js +32 -0
  176. package/lib/mcp/sdk/exports.js.map +7 -0
  177. package/lib/mcp/sdk/http.js +276 -0
  178. package/lib/mcp/sdk/http.js.map +7 -0
  179. package/lib/mcp/sdk/inProcessTransport.js +71 -0
  180. package/lib/mcp/sdk/inProcessTransport.js.map +7 -0
  181. package/lib/mcp/sdk/mdb.js +208 -0
  182. package/lib/mcp/sdk/mdb.js.map +7 -0
  183. package/lib/mcp/sdk/proxyBackend.js +128 -0
  184. package/lib/mcp/sdk/proxyBackend.js.map +7 -0
  185. package/lib/mcp/sdk/server.js +190 -0
  186. package/lib/mcp/sdk/server.js.map +7 -0
  187. package/lib/mcp/sdk/tool.js +51 -0
  188. package/lib/mcp/sdk/tool.js.map +7 -0
  189. package/lib/mcp/test/browserBackend.js +98 -0
  190. package/lib/mcp/test/browserBackend.js.map +7 -0
  191. package/lib/mcp/test/generatorTools.js +122 -0
  192. package/lib/mcp/test/generatorTools.js.map +7 -0
  193. package/lib/mcp/test/plannerTools.js +46 -0
  194. package/lib/mcp/test/plannerTools.js.map +7 -0
  195. package/lib/mcp/test/seed.js +82 -0
  196. package/lib/mcp/test/seed.js.map +7 -0
  197. package/lib/mcp/test/streams.js +41 -0
  198. package/lib/mcp/test/streams.js.map +7 -0
  199. package/lib/mcp/test/testBackend.js +97 -0
  200. package/lib/mcp/test/testBackend.js.map +7 -0
  201. package/lib/mcp/test/testContext.js +216 -0
  202. package/lib/mcp/test/testContext.js.map +7 -0
  203. package/lib/mcp/test/testTool.js +30 -0
  204. package/lib/mcp/test/testTool.js.map +7 -0
  205. package/lib/mcp/test/testTools.js +111 -0
  206. package/lib/mcp/test/testTools.js.map +7 -0
  207. package/lib/mcpBundleImpl.js +41 -0
  208. package/lib/mcpBundleImpl.js.map +7 -0
  209. package/lib/plugins/gitCommitInfoPlugin.js +198 -0
  210. package/lib/plugins/gitCommitInfoPlugin.js.map +7 -0
  211. package/lib/plugins/index.js +28 -0
  212. package/lib/plugins/index.js.map +7 -0
  213. package/lib/plugins/webServerPlugin.js +233 -0
  214. package/lib/plugins/webServerPlugin.js.map +7 -0
  215. package/lib/program.js +412 -0
  216. package/lib/program.js.map +7 -0
  217. package/lib/reporters/base.js +609 -0
  218. package/lib/reporters/base.js.map +7 -0
  219. package/lib/reporters/blob.js +135 -0
  220. package/lib/reporters/blob.js.map +7 -0
  221. package/lib/reporters/dot.js +82 -0
  222. package/lib/reporters/dot.js.map +7 -0
  223. package/lib/reporters/empty.js +32 -0
  224. package/lib/reporters/empty.js.map +7 -0
  225. package/lib/reporters/github.js +128 -0
  226. package/lib/reporters/github.js.map +7 -0
  227. package/lib/reporters/html.js +623 -0
  228. package/lib/reporters/html.js.map +7 -0
  229. package/lib/reporters/internalReporter.js +130 -0
  230. package/lib/reporters/internalReporter.js.map +7 -0
  231. package/lib/reporters/json.js +254 -0
  232. package/lib/reporters/json.js.map +7 -0
  233. package/lib/reporters/junit.js +232 -0
  234. package/lib/reporters/junit.js.map +7 -0
  235. package/lib/reporters/line.js +113 -0
  236. package/lib/reporters/line.js.map +7 -0
  237. package/lib/reporters/list.js +231 -0
  238. package/lib/reporters/list.js.map +7 -0
  239. package/lib/reporters/listModeReporter.js +69 -0
  240. package/lib/reporters/listModeReporter.js.map +7 -0
  241. package/lib/reporters/markdown.js +144 -0
  242. package/lib/reporters/markdown.js.map +7 -0
  243. package/lib/reporters/merge.js +541 -0
  244. package/lib/reporters/merge.js.map +7 -0
  245. package/lib/reporters/multiplexer.js +104 -0
  246. package/lib/reporters/multiplexer.js.map +7 -0
  247. package/lib/reporters/reporterV2.js +102 -0
  248. package/lib/reporters/reporterV2.js.map +7 -0
  249. package/lib/reporters/teleEmitter.js +298 -0
  250. package/lib/reporters/teleEmitter.js.map +7 -0
  251. package/lib/reporters/versions/blobV1.js +16 -0
  252. package/lib/reporters/versions/blobV1.js.map +7 -0
  253. package/lib/runner/dispatcher.js +491 -0
  254. package/lib/runner/dispatcher.js.map +7 -0
  255. package/lib/runner/failureTracker.js +72 -0
  256. package/lib/runner/failureTracker.js.map +7 -0
  257. package/lib/runner/lastRun.js +77 -0
  258. package/lib/runner/lastRun.js.map +7 -0
  259. package/lib/runner/loadUtils.js +334 -0
  260. package/lib/runner/loadUtils.js.map +7 -0
  261. package/lib/runner/loaderHost.js +89 -0
  262. package/lib/runner/loaderHost.js.map +7 -0
  263. package/lib/runner/processHost.js +161 -0
  264. package/lib/runner/processHost.js.map +7 -0
  265. package/lib/runner/projectUtils.js +241 -0
  266. package/lib/runner/projectUtils.js.map +7 -0
  267. package/lib/runner/rebase.js +189 -0
  268. package/lib/runner/rebase.js.map +7 -0
  269. package/lib/runner/reporters.js +138 -0
  270. package/lib/runner/reporters.js.map +7 -0
  271. package/lib/runner/runner.js +110 -0
  272. package/lib/runner/sigIntWatcher.js +96 -0
  273. package/lib/runner/sigIntWatcher.js.map +7 -0
  274. package/lib/runner/taskRunner.js +127 -0
  275. package/lib/runner/taskRunner.js.map +7 -0
  276. package/lib/runner/tasks.js +410 -0
  277. package/lib/runner/tasks.js.map +7 -0
  278. package/lib/runner/testGroups.js +117 -0
  279. package/lib/runner/testGroups.js.map +7 -0
  280. package/lib/runner/testRunner.js +390 -0
  281. package/lib/runner/testRunner.js.map +7 -0
  282. package/lib/runner/testServer.js +267 -0
  283. package/lib/runner/testServer.js.map +7 -0
  284. package/lib/runner/uiModeReporter.js +30 -0
  285. package/lib/runner/uiModeReporter.js.map +7 -0
  286. package/lib/runner/vcs.js +72 -0
  287. package/lib/runner/vcs.js.map +7 -0
  288. package/lib/runner/watchMode.js +395 -0
  289. package/lib/runner/watchMode.js.map +7 -0
  290. package/lib/runner/workerHost.js +95 -0
  291. package/lib/runner/workerHost.js.map +7 -0
  292. package/lib/third_party/pirates.js +62 -0
  293. package/lib/third_party/pirates.js.map +7 -0
  294. package/lib/third_party/tsconfig-loader.js +103 -0
  295. package/lib/third_party/tsconfig-loader.js.map +7 -0
  296. package/lib/transform/babelBundle.js +43 -0
  297. package/lib/transform/babelBundle.js.map +7 -0
  298. package/lib/transform/babelBundleImpl.js +461 -0
  299. package/lib/transform/babelBundleImpl.js.map +7 -0
  300. package/lib/transform/compilationCache.js +272 -0
  301. package/lib/transform/compilationCache.js.map +7 -0
  302. package/lib/transform/esmLoader.js +104 -0
  303. package/lib/transform/esmLoader.js.map +7 -0
  304. package/lib/transform/portTransport.js +67 -0
  305. package/lib/transform/portTransport.js.map +7 -0
  306. package/lib/transform/transform.js +293 -0
  307. package/lib/transform/transform.js.map +7 -0
  308. package/lib/util.js +403 -0
  309. package/lib/util.js.map +7 -0
  310. package/lib/utilsBundle.js +43 -0
  311. package/lib/utilsBundle.js.map +7 -0
  312. package/lib/utilsBundleImpl.js +100 -0
  313. package/lib/utilsBundleImpl.js.map +7 -0
  314. package/lib/worker/fixtureRunner.js +258 -0
  315. package/lib/worker/fixtureRunner.js.map +7 -0
  316. package/lib/worker/testInfo.js +514 -0
  317. package/lib/worker/testInfo.js.map +7 -0
  318. package/lib/worker/testTracing.js +344 -0
  319. package/lib/worker/testTracing.js.map +7 -0
  320. package/lib/worker/timeoutManager.js +174 -0
  321. package/lib/worker/timeoutManager.js.map +7 -0
  322. package/lib/worker/util.js +31 -0
  323. package/lib/worker/util.js.map +7 -0
  324. package/lib/worker/workerMain.js +520 -0
  325. package/lib/worker/workerMain.js.map +7 -0
  326. package/package.json +74 -0
  327. package/test.d.ts +18 -0
  328. package/test.js +24 -0
  329. package/test.mjs +33 -0
  330. package/types/test.d.ts +10196 -0
  331. package/types/testReporter.d.ts +821 -0
@@ -0,0 +1,97 @@
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 mcp = __toESM(require("../sdk/exports"));
35
+ var import_testContext = require("./testContext");
36
+ var testTools = __toESM(require("./testTools.js"));
37
+ var generatorTools = __toESM(require("./generatorTools.js"));
38
+ var plannerTools = __toESM(require("./plannerTools.js"));
39
+ var import_tools = require("../browser/tools");
40
+ var import_configLoader = require("../../common/configLoader");
41
+ var import_response = require("../browser/response");
42
+ class TestServerBackend {
43
+ constructor(configOption, options) {
44
+ this.name = "Playwright";
45
+ this.version = "0.0.1";
46
+ this._tools = [
47
+ plannerTools.setupPage,
48
+ generatorTools.setupPage,
49
+ generatorTools.generatorReadLog,
50
+ generatorTools.generatorWriteTest,
51
+ testTools.listTests,
52
+ testTools.runTests,
53
+ testTools.debugTest
54
+ ];
55
+ this._context = new import_testContext.TestContext(options);
56
+ this._configOption = configOption;
57
+ }
58
+ async initialize(server, clientInfo) {
59
+ const rootPath = mcp.firstRootPath(clientInfo);
60
+ if (this._configOption) {
61
+ this._context.initialize(rootPath, (0, import_configLoader.resolveConfigLocation)(this._configOption));
62
+ return;
63
+ }
64
+ if (rootPath) {
65
+ this._context.initialize(rootPath, (0, import_configLoader.resolveConfigLocation)(rootPath));
66
+ return;
67
+ }
68
+ this._context.initialize(rootPath, (0, import_configLoader.resolveConfigLocation)(void 0));
69
+ }
70
+ async listTools() {
71
+ return [
72
+ ...this._tools.map((tool) => mcp.toMcpTool(tool.schema)),
73
+ ...import_tools.browserTools.map((tool) => mcp.toMcpTool(tool.schema, { addIntent: true }))
74
+ ];
75
+ }
76
+ async afterCallTool(name, args, result) {
77
+ if (!import_tools.browserTools.find((tool) => tool.schema.name === name))
78
+ return;
79
+ const response = (0, import_response.parseResponse)(result);
80
+ if (response && !response.isError && response.code && typeof args?.["intent"] === "string")
81
+ this._context.generatorJournal?.logStep(args["intent"], response.code);
82
+ }
83
+ async callTool(name, args, progress) {
84
+ const tool = this._tools.find((tool2) => tool2.schema.name === name);
85
+ if (!tool)
86
+ throw new Error(`Tool not found: ${name}. Available tools: ${this._tools.map((tool2) => tool2.schema.name).join(", ")}`);
87
+ const parsedArguments = tool.schema.inputSchema.parse(args || {});
88
+ return await tool.handle(this._context, parsedArguments, progress);
89
+ }
90
+ serverClosed() {
91
+ void this._context.close();
92
+ }
93
+ }
94
+ // Annotate the CommonJS export names for ESM import in node:
95
+ 0 && (module.exports = {
96
+ TestServerBackend
97
+ });
@@ -0,0 +1,7 @@
1
+ {
2
+ "version": 3,
3
+ "sources": ["../../../src/mcp/test/testBackend.ts"],
4
+ "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 * 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';\nimport { resolveConfigLocation } from '../../common/configLoader';\nimport { parseResponse } from '../browser/response';\n\nimport type { TestTool } from './testTool';\n\nexport class TestServerBackend implements mcp.ServerBackend {\n readonly name = 'Playwright';\n readonly version = '0.0.1';\n private _tools: TestTool<any>[] = [\n plannerTools.setupPage,\n generatorTools.setupPage,\n generatorTools.generatorReadLog,\n generatorTools.generatorWriteTest,\n testTools.listTests,\n testTools.runTests,\n testTools.debugTest,\n ];\n private _context: TestContext;\n private _configOption: string | undefined;\n\n constructor(configOption: string | undefined, options?: { muteConsole?: boolean, headless?: boolean }) {\n this._context = new TestContext(options);\n this._configOption = configOption;\n }\n\n async initialize(server: mcp.Server, clientInfo: mcp.ClientInfo): Promise<void> {\n const rootPath = mcp.firstRootPath(clientInfo);\n\n if (this._configOption) {\n this._context.initialize(rootPath, resolveConfigLocation(this._configOption));\n return;\n }\n\n if (rootPath) {\n this._context.initialize(rootPath, resolveConfigLocation(rootPath));\n return;\n }\n\n this._context.initialize(rootPath, resolveConfigLocation(undefined));\n }\n\n async listTools(): Promise<mcp.Tool[]> {\n return [\n ...this._tools.map(tool => mcp.toMcpTool(tool.schema)),\n ...browserTools.map(tool => mcp.toMcpTool(tool.schema, { addIntent: true })),\n ];\n }\n\n async afterCallTool(name: string, args: mcp.CallToolRequest['params']['arguments'], result: mcp.CallToolResult) {\n if (!browserTools.find(tool => tool.schema.name === name))\n return;\n const response = parseResponse(result);\n if (response && !response.isError && response.code && typeof args?.['intent'] === 'string')\n this._context.generatorJournal?.logStep(args['intent'], response.code);\n }\n\n async callTool(name: string, args: mcp.CallToolRequest['params']['arguments'], progress: mcp.ProgressCallback): 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 const parsedArguments = tool.schema.inputSchema.parse(args || {});\n return await tool.handle(this._context!, parsedArguments, progress);\n }\n\n serverClosed() {\n void this._context!.close();\n }\n}\n"],
5
+ "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAgBA,UAAqB;AACrB,yBAA4B;AAC5B,gBAA2B;AAC3B,qBAAgC;AAChC,mBAA8B;AAC9B,mBAA6B;AAC7B,0BAAsC;AACtC,sBAA8B;AAIvB,MAAM,kBAA+C;AAAA,EAe1D,YAAY,cAAkC,SAAyD;AAdvG,SAAS,OAAO;AAChB,SAAS,UAAU;AACnB,SAAQ,SAA0B;AAAA,MAChC,aAAa;AAAA,MACb,eAAe;AAAA,MACf,eAAe;AAAA,MACf,eAAe;AAAA,MACf,UAAU;AAAA,MACV,UAAU;AAAA,MACV,UAAU;AAAA,IACZ;AAKE,SAAK,WAAW,IAAI,+BAAY,OAAO;AACvC,SAAK,gBAAgB;AAAA,EACvB;AAAA,EAEA,MAAM,WAAW,QAAoB,YAA2C;AAC9E,UAAM,WAAW,IAAI,cAAc,UAAU;AAE7C,QAAI,KAAK,eAAe;AACtB,WAAK,SAAS,WAAW,cAAU,2CAAsB,KAAK,aAAa,CAAC;AAC5E;AAAA,IACF;AAEA,QAAI,UAAU;AACZ,WAAK,SAAS,WAAW,cAAU,2CAAsB,QAAQ,CAAC;AAClE;AAAA,IACF;AAEA,SAAK,SAAS,WAAW,cAAU,2CAAsB,MAAS,CAAC;AAAA,EACrE;AAAA,EAEA,MAAM,YAAiC;AACrC,WAAO;AAAA,MACL,GAAG,KAAK,OAAO,IAAI,UAAQ,IAAI,UAAU,KAAK,MAAM,CAAC;AAAA,MACrD,GAAG,0BAAa,IAAI,UAAQ,IAAI,UAAU,KAAK,QAAQ,EAAE,WAAW,KAAK,CAAC,CAAC;AAAA,IAC7E;AAAA,EACF;AAAA,EAEA,MAAM,cAAc,MAAc,MAAkD,QAA4B;AAC9G,QAAI,CAAC,0BAAa,KAAK,UAAQ,KAAK,OAAO,SAAS,IAAI;AACtD;AACF,UAAM,eAAW,+BAAc,MAAM;AACrC,QAAI,YAAY,CAAC,SAAS,WAAW,SAAS,QAAQ,OAAO,OAAO,QAAQ,MAAM;AAChF,WAAK,SAAS,kBAAkB,QAAQ,KAAK,QAAQ,GAAG,SAAS,IAAI;AAAA,EACzE;AAAA,EAEA,MAAM,SAAS,MAAc,MAAkD,UAA6D;AAC1I,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,UAAM,kBAAkB,KAAK,OAAO,YAAY,MAAM,QAAQ,CAAC,CAAC;AAChE,WAAO,MAAM,KAAK,OAAO,KAAK,UAAW,iBAAiB,QAAQ;AAAA,EACpE;AAAA,EAEA,eAAe;AACb,SAAK,KAAK,SAAU,MAAM;AAAA,EAC5B;AACF;",
6
+ "names": ["tool"]
7
+ }
@@ -0,0 +1,216 @@
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_path = __toESM(require("path"));
38
+ var import_utils = require("playwright-core/lib/utils");
39
+ var import_base = require("../../reporters/base");
40
+ var import_list = __toESM(require("../../reporters/list"));
41
+ var import_streams = require("./streams");
42
+ var import_util = require("../../util");
43
+ var import_testRunner = require("../../runner/testRunner");
44
+ var import_seed = require("./seed");
45
+ class GeneratorJournal {
46
+ constructor(rootPath, plan, seed) {
47
+ this._rootPath = rootPath;
48
+ this._plan = plan;
49
+ this._seed = seed;
50
+ this._steps = [];
51
+ }
52
+ logStep(title, code) {
53
+ if (title)
54
+ this._steps.push({ title, code });
55
+ }
56
+ journal() {
57
+ const result = [];
58
+ result.push(`# Plan`);
59
+ result.push(this._plan);
60
+ result.push(`# Seed file: ${import_path.default.relative(this._rootPath, this._seed.file)}`);
61
+ result.push("```ts");
62
+ result.push(this._seed.content);
63
+ result.push("```");
64
+ result.push(`# Steps`);
65
+ result.push(this._steps.map((step) => `### ${step.title}
66
+ \`\`\`ts
67
+ ${step.code}
68
+ \`\`\``).join("\n\n"));
69
+ result.push(bestPracticesMarkdown);
70
+ return result.join("\n\n");
71
+ }
72
+ }
73
+ class TestContext {
74
+ constructor(options) {
75
+ this.options = options;
76
+ }
77
+ initialize(rootPath, configLocation) {
78
+ this.configLocation = configLocation;
79
+ this.rootPath = rootPath || configLocation.configDir;
80
+ }
81
+ existingTestRunner() {
82
+ return this._testRunner;
83
+ }
84
+ async createTestRunner() {
85
+ if (this._testRunner)
86
+ await this._testRunner.stopTests();
87
+ const testRunner = new import_testRunner.TestRunner(this.configLocation, {});
88
+ await testRunner.initialize({});
89
+ this._testRunner = testRunner;
90
+ testRunner.on(import_testRunner.TestRunnerEvent.TestFilesChanged, (testFiles) => {
91
+ this._testRunner?.emit(import_testRunner.TestRunnerEvent.TestFilesChanged, testFiles);
92
+ });
93
+ this._testRunner = testRunner;
94
+ return testRunner;
95
+ }
96
+ async getOrCreateSeedFile(seedFile, projectName) {
97
+ const configDir = this.configLocation.configDir;
98
+ const testRunner = await this.createTestRunner();
99
+ const config = await testRunner.loadConfig();
100
+ const project = (0, import_seed.seedProject)(config, projectName);
101
+ if (!seedFile) {
102
+ seedFile = await (0, import_seed.ensureSeedFile)(project);
103
+ } else {
104
+ const candidateFiles = [];
105
+ const testDir = project.project.testDir;
106
+ candidateFiles.push(import_path.default.resolve(testDir, seedFile));
107
+ candidateFiles.push(import_path.default.resolve(configDir, seedFile));
108
+ candidateFiles.push(import_path.default.resolve(this.rootPath, seedFile));
109
+ let resolvedSeedFile;
110
+ for (const candidateFile of candidateFiles) {
111
+ if (await (0, import_util.fileExistsAsync)(candidateFile)) {
112
+ resolvedSeedFile = candidateFile;
113
+ break;
114
+ }
115
+ }
116
+ if (!resolvedSeedFile)
117
+ throw new Error("seed test not found.");
118
+ seedFile = resolvedSeedFile;
119
+ }
120
+ const seedFileContent = await import_fs.default.promises.readFile(seedFile, "utf8");
121
+ return {
122
+ file: seedFile,
123
+ content: seedFileContent,
124
+ projectName: project.project.name
125
+ };
126
+ }
127
+ async runSeedTest(seedFile, projectName, progress) {
128
+ await this.runWithGlobalSetup(async (testRunner, reporter) => {
129
+ const result = await testRunner.runTests(reporter, {
130
+ headed: !this.options?.headless,
131
+ locations: ["/" + (0, import_utils.escapeRegExp)(seedFile) + "/"],
132
+ projects: [projectName],
133
+ timeout: 0,
134
+ workers: 1,
135
+ pauseAtEnd: true,
136
+ disableConfigReporters: true,
137
+ failOnLoadErrors: true
138
+ });
139
+ if (result.status === "passed" && !reporter.suite?.allTests().length)
140
+ throw new Error("seed test not found.");
141
+ if (result.status !== "passed")
142
+ throw new Error("Errors while running the seed test.");
143
+ }, progress);
144
+ }
145
+ async runWithGlobalSetup(callback, progress) {
146
+ const { screen, claimStdio, releaseStdio } = createScreen(progress);
147
+ const configDir = this.configLocation.configDir;
148
+ const testRunner = await this.createTestRunner();
149
+ claimStdio();
150
+ try {
151
+ const setupReporter = new import_list.default({ configDir, screen, includeTestId: true });
152
+ const { status } = await testRunner.runGlobalSetup([setupReporter]);
153
+ if (status !== "passed")
154
+ throw new Error("Failed to run global setup");
155
+ } finally {
156
+ releaseStdio();
157
+ }
158
+ try {
159
+ const reporter = new import_list.default({ configDir, screen, includeTestId: true });
160
+ return await callback(testRunner, reporter);
161
+ } finally {
162
+ claimStdio();
163
+ await testRunner.runGlobalTeardown().finally(() => {
164
+ releaseStdio();
165
+ });
166
+ }
167
+ }
168
+ async close() {
169
+ }
170
+ }
171
+ function createScreen(progress) {
172
+ const stdout = new import_streams.StringWriteStream(progress, "stdout");
173
+ const stderr = new import_streams.StringWriteStream(progress, "stderr");
174
+ const screen = {
175
+ ...import_base.terminalScreen,
176
+ isTTY: false,
177
+ colors: import_utils.noColors,
178
+ stdout,
179
+ stderr
180
+ };
181
+ const originalStdoutWrite = process.stdout.write;
182
+ const originalStderrWrite = process.stderr.write;
183
+ const claimStdio = () => {
184
+ process.stdout.write = (chunk) => {
185
+ stdout.write(chunk);
186
+ return true;
187
+ };
188
+ process.stderr.write = (chunk) => {
189
+ stderr.write(chunk);
190
+ return true;
191
+ };
192
+ };
193
+ const releaseStdio = () => {
194
+ process.stdout.write = originalStdoutWrite;
195
+ process.stderr.write = originalStderrWrite;
196
+ };
197
+ return { screen, claimStdio, releaseStdio };
198
+ }
199
+ const bestPracticesMarkdown = `
200
+ # Best practices
201
+ - Do not improvise, do not add directives that were not asked for
202
+ - Use clear, descriptive assertions to validate the expected behavior
203
+ - Use reliable locators from this log
204
+ - Use local variables for locators that are used multiple times
205
+ - Use Playwright waiting assertions and best practices from this log
206
+ - NEVER! use page.waitForLoadState()
207
+ - NEVER! use page.waitForNavigation()
208
+ - NEVER! use page.waitForTimeout()
209
+ - NEVER! use page.evaluate()
210
+ `;
211
+ // Annotate the CommonJS export names for ESM import in node:
212
+ 0 && (module.exports = {
213
+ GeneratorJournal,
214
+ TestContext,
215
+ createScreen
216
+ });
@@ -0,0 +1,7 @@
1
+ {
2
+ "version": 3,
3
+ "sources": ["../../../src/mcp/test/testContext.ts"],
4
+ "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 { noColors, escapeRegExp } from 'playwright-core/lib/utils';\n\nimport { terminalScreen } from '../../reporters/base';\nimport ListReporter from '../../reporters/list';\nimport { StringWriteStream } from './streams';\nimport { fileExistsAsync } from '../../util';\nimport { TestRunner, TestRunnerEvent } from '../../runner/testRunner';\nimport { ensureSeedFile, seedProject } from './seed';\n\nimport type { ProgressCallback } from '../sdk/server';\nimport type { ConfigLocation } from '../../common/config';\n\nexport type SeedFile = {\n file: string;\n content: string;\n};\n\nexport class GeneratorJournal {\n private _rootPath: string;\n private _plan: string;\n private _seed: SeedFile;\n private _steps: { title: string, code: string }[];\n\n constructor(rootPath: string, plan: string, seed: SeedFile) {\n this._rootPath = rootPath;\n this._plan = plan;\n this._seed = seed;\n this._steps = [];\n }\n\n logStep(title: string | undefined, code: string) {\n if (title)\n this._steps.push({ title, code });\n }\n\n journal() {\n const result: string[] = [];\n result.push(`# Plan`);\n result.push(this._plan);\n result.push(`# Seed file: ${path.relative(this._rootPath, this._seed.file)}`);\n result.push('```ts');\n result.push(this._seed.content);\n result.push('```');\n result.push(`# Steps`);\n result.push(this._steps.map(step => `### ${step.title}\n\\`\\`\\`ts\n${step.code}\n\\`\\`\\``).join('\\n\\n'));\n result.push(bestPracticesMarkdown);\n return result.join('\\n\\n');\n }\n}\n\nexport class TestContext {\n private _testRunner: TestRunner | undefined;\n readonly options?: { muteConsole?: boolean, headless?: boolean };\n configLocation!: ConfigLocation;\n rootPath!: string;\n generatorJournal: GeneratorJournal | undefined;\n\n constructor(options?: { muteConsole?: boolean, headless?: boolean }) {\n this.options = options;\n }\n\n initialize(rootPath: string | undefined, configLocation: ConfigLocation) {\n this.configLocation = configLocation;\n this.rootPath = rootPath || configLocation.configDir;\n }\n\n existingTestRunner(): TestRunner | undefined {\n return this._testRunner;\n }\n\n async createTestRunner(): Promise<TestRunner> {\n if (this._testRunner)\n await this._testRunner.stopTests();\n const testRunner = new TestRunner(this.configLocation!, {});\n await testRunner.initialize({});\n this._testRunner = testRunner;\n testRunner.on(TestRunnerEvent.TestFilesChanged, testFiles => {\n this._testRunner?.emit(TestRunnerEvent.TestFilesChanged, testFiles);\n });\n this._testRunner = testRunner;\n return testRunner;\n }\n\n async getOrCreateSeedFile(seedFile: string | undefined, projectName: string | undefined) {\n const configDir = this.configLocation.configDir;\n const testRunner = await this.createTestRunner();\n const config = await testRunner.loadConfig();\n const project = seedProject(config, projectName);\n\n if (!seedFile) {\n seedFile = await ensureSeedFile(project);\n } else {\n const candidateFiles: string[] = [];\n const testDir = project.project.testDir;\n candidateFiles.push(path.resolve(testDir, seedFile));\n candidateFiles.push(path.resolve(configDir, seedFile));\n candidateFiles.push(path.resolve(this.rootPath, seedFile));\n let resolvedSeedFile: string | undefined;\n for (const candidateFile of candidateFiles) {\n if (await fileExistsAsync(candidateFile)) {\n resolvedSeedFile = candidateFile;\n break;\n }\n }\n if (!resolvedSeedFile)\n throw new Error('seed test not found.');\n seedFile = resolvedSeedFile;\n }\n\n const seedFileContent = await fs.promises.readFile(seedFile, 'utf8');\n return {\n file: seedFile,\n content: seedFileContent,\n projectName: project.project.name,\n };\n }\n\n async runSeedTest(seedFile: string, projectName: string, progress: ProgressCallback) {\n await this.runWithGlobalSetup(async (testRunner, reporter) => {\n const result = await testRunner.runTests(reporter, {\n headed: !this.options?.headless,\n locations: ['/' + escapeRegExp(seedFile) + '/'],\n projects: [projectName],\n timeout: 0,\n workers: 1,\n pauseAtEnd: true,\n disableConfigReporters: true,\n failOnLoadErrors: true,\n });\n // Ideally, we should check that page was indeed created and browser mcp has kicked in.\n // However, that is handled in the upper layer, so hard to check here.\n if (result.status === 'passed' && !reporter.suite?.allTests().length)\n throw new Error('seed test not found.');\n\n if (result.status !== 'passed')\n throw new Error('Errors while running the seed test.');\n }, progress);\n }\n\n async runWithGlobalSetup(\n callback: (testRunner: TestRunner, reporter: ListReporter) => Promise<void>,\n progress: ProgressCallback): Promise<void> {\n const { screen, claimStdio, releaseStdio } = createScreen(progress);\n const configDir = this.configLocation.configDir;\n const testRunner = await this.createTestRunner();\n\n claimStdio();\n try {\n const setupReporter = new ListReporter({ configDir, screen, includeTestId: true });\n const { status } = await testRunner.runGlobalSetup([setupReporter]);\n if (status !== 'passed')\n throw new Error('Failed to run global setup');\n } finally {\n releaseStdio();\n }\n\n try {\n const reporter = new ListReporter({ configDir, screen, includeTestId: true });\n return await callback(testRunner, reporter);\n } finally {\n claimStdio();\n await testRunner.runGlobalTeardown().finally(() => {\n releaseStdio();\n });\n }\n }\n\n async close() {\n }\n}\n\nexport function createScreen(progress: ProgressCallback) {\n const stdout = new StringWriteStream(progress, 'stdout');\n const stderr = new StringWriteStream(progress, 'stderr');\n\n const screen = {\n ...terminalScreen,\n isTTY: false,\n colors: noColors,\n stdout: stdout as unknown as NodeJS.WriteStream,\n stderr: stderr as unknown as NodeJS.WriteStream,\n };\n\n /* eslint-disable no-restricted-properties */\n const originalStdoutWrite = process.stdout.write;\n const originalStderrWrite = process.stderr.write;\n\n const claimStdio = () => {\n process.stdout.write = (chunk: string | Buffer) => {\n stdout.write(chunk);\n return true;\n };\n process.stderr.write = (chunk: string | Buffer) => {\n stderr.write(chunk);\n return true;\n };\n };\n\n const releaseStdio = () => {\n process.stdout.write = originalStdoutWrite;\n process.stderr.write = originalStderrWrite;\n };\n /* eslint-enable no-restricted-properties */\n\n return { screen, claimStdio, releaseStdio };\n}\n\nconst bestPracticesMarkdown = `\n# Best practices\n- Do not improvise, do not add directives that were not asked for\n- Use clear, descriptive assertions to validate the expected behavior\n- Use reliable locators from this log\n- Use local variables for locators that are used multiple times\n- Use Playwright waiting assertions and best practices from this log\n- NEVER! use page.waitForLoadState()\n- NEVER! use page.waitForNavigation()\n- NEVER! use page.waitForTimeout()\n- NEVER! use page.evaluate()\n`;\n"],
5
+ "mappings": "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",
6
+ "names": ["path", "fs", "ListReporter"]
7
+ }
@@ -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,7 @@
1
+ {
2
+ "version": 3,
3
+ "sources": ["../../../src/mcp/test/testTool.ts"],
4
+ "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 type { z } from 'zod';\nimport type { TestContext } from './testContext.js';\nimport type { CallToolResult } from '@modelcontextprotocol/sdk/types.js';\nimport type { ToolSchema } from '../sdk/tool.js';\nimport type { ProgressCallback } from '../sdk/server.js';\n\nexport type TestTool<Input extends z.Schema = z.Schema> = {\n schema: ToolSchema<Input>;\n handle: (context: TestContext, params: z.output<Input>, progress: ProgressCallback) => Promise<CallToolResult>;\n};\n\nexport function defineTestTool<Input extends z.Schema>(tool: TestTool<Input>): TestTool<Input> {\n return tool;\n}\n"],
5
+ "mappings": ";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AA2BO,SAAS,eAAuC,MAAwC;AAC7F,SAAO;AACT;",
6
+ "names": []
7
+ }
@@ -0,0 +1,111 @@
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_bundle = require("../sdk/bundle");
37
+ var import_listModeReporter = __toESM(require("../../reporters/listModeReporter"));
38
+ var import_testTool = require("./testTool");
39
+ var import_testContext = require("./testContext");
40
+ const listTests = (0, import_testTool.defineTestTool)({
41
+ schema: {
42
+ name: "test_list",
43
+ title: "List tests",
44
+ description: "List tests",
45
+ inputSchema: import_bundle.z.object({}),
46
+ type: "readOnly"
47
+ },
48
+ handle: async (context, _, progress) => {
49
+ const { screen } = (0, import_testContext.createScreen)(progress);
50
+ const reporter = new import_listModeReporter.default({ screen, includeTestId: true });
51
+ const testRunner = await context.createTestRunner();
52
+ await testRunner.listTests(reporter, {});
53
+ return { content: [] };
54
+ }
55
+ });
56
+ const runTests = (0, import_testTool.defineTestTool)({
57
+ schema: {
58
+ name: "test_run",
59
+ title: "Run tests",
60
+ description: "Run tests",
61
+ inputSchema: import_bundle.z.object({
62
+ locations: import_bundle.z.array(import_bundle.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"'),
63
+ projects: import_bundle.z.array(import_bundle.z.string()).optional().describe('Projects to run, projects from playwright.config.ts, by default runs all projects. Running with "chromium" is a good start')
64
+ }),
65
+ type: "readOnly"
66
+ },
67
+ handle: async (context, params, progress) => {
68
+ await context.runWithGlobalSetup(async (testRunner, reporter) => {
69
+ await testRunner.runTests(reporter, {
70
+ locations: params.locations,
71
+ projects: params.projects,
72
+ disableConfigReporters: true
73
+ });
74
+ }, progress);
75
+ return { content: [] };
76
+ }
77
+ });
78
+ const debugTest = (0, import_testTool.defineTestTool)({
79
+ schema: {
80
+ name: "test_debug",
81
+ title: "Debug single test",
82
+ description: "Debug single test",
83
+ inputSchema: import_bundle.z.object({
84
+ test: import_bundle.z.object({
85
+ id: import_bundle.z.string().describe("Test ID to debug."),
86
+ title: import_bundle.z.string().describe("Human readable test title for granting permission to debug the test.")
87
+ })
88
+ }),
89
+ type: "readOnly"
90
+ },
91
+ handle: async (context, params, progress) => {
92
+ await context.runWithGlobalSetup(async (testRunner, reporter) => {
93
+ await testRunner.runTests(reporter, {
94
+ headed: !context.options?.headless,
95
+ testIds: [params.test.id],
96
+ // For automatic recovery
97
+ timeout: 0,
98
+ workers: 1,
99
+ pauseOnError: true,
100
+ disableConfigReporters: true
101
+ });
102
+ }, progress);
103
+ return { content: [] };
104
+ }
105
+ });
106
+ // Annotate the CommonJS export names for ESM import in node:
107
+ 0 && (module.exports = {
108
+ debugTest,
109
+ listTests,
110
+ runTests
111
+ });
@@ -0,0 +1,7 @@
1
+ {
2
+ "version": 3,
3
+ "sources": ["../../../src/mcp/test/testTools.ts"],
4
+ "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 } from '../sdk/bundle';\nimport ListModeReporter from '../../reporters/listModeReporter';\nimport { defineTestTool } from './testTool';\nimport { createScreen } from './testContext';\n\nexport const listTests = defineTestTool({\n schema: {\n name: 'test_list',\n title: 'List tests',\n description: 'List tests',\n inputSchema: z.object({}),\n type: 'readOnly',\n },\n\n handle: async (context, _, progress) => {\n const { screen } = createScreen(progress);\n const reporter = new ListModeReporter({ screen, includeTestId: true });\n const testRunner = await context.createTestRunner();\n await testRunner.listTests(reporter, {});\n\n return { content: [] };\n },\n});\n\nexport const runTests = defineTestTool({\n schema: {\n name: 'test_run',\n title: 'Run tests',\n description: 'Run tests',\n inputSchema: z.object({\n locations: z.array(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\"'),\n projects: z.array(z.string()).optional().describe('Projects to run, projects from playwright.config.ts, by default runs all projects. Running with \"chromium\" is a good start'),\n }),\n type: 'readOnly',\n },\n\n handle: async (context, params, progress) => {\n await context.runWithGlobalSetup(async (testRunner, reporter) => {\n await testRunner.runTests(reporter, {\n locations: params.locations,\n projects: params.projects,\n disableConfigReporters: true,\n });\n }, progress);\n\n return { content: [] };\n },\n});\n\nexport const debugTest = defineTestTool({\n schema: {\n name: 'test_debug',\n title: 'Debug single test',\n description: 'Debug single test',\n inputSchema: z.object({\n test: z.object({\n id: z.string().describe('Test ID to debug.'),\n title: z.string().describe('Human readable test title for granting permission to debug the test.'),\n }),\n }),\n type: 'readOnly',\n },\n\n handle: async (context, params, progress) => {\n await context.runWithGlobalSetup(async (testRunner, reporter) => {\n await testRunner.runTests(reporter, {\n headed: !context.options?.headless,\n testIds: [params.test.id],\n // For automatic recovery\n timeout: 0,\n workers: 1,\n pauseOnError: true,\n disableConfigReporters: true,\n });\n }, progress);\n\n return { content: [] };\n },\n});\n"],
5
+ "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAgBA,oBAAkB;AAClB,8BAA6B;AAC7B,sBAA+B;AAC/B,yBAA6B;AAEtB,MAAM,gBAAY,gCAAe;AAAA,EACtC,QAAQ;AAAA,IACN,MAAM;AAAA,IACN,OAAO;AAAA,IACP,aAAa;AAAA,IACb,aAAa,gBAAE,OAAO,CAAC,CAAC;AAAA,IACxB,MAAM;AAAA,EACR;AAAA,EAEA,QAAQ,OAAO,SAAS,GAAG,aAAa;AACtC,UAAM,EAAE,OAAO,QAAI,iCAAa,QAAQ;AACxC,UAAM,WAAW,IAAI,wBAAAA,QAAiB,EAAE,QAAQ,eAAe,KAAK,CAAC;AACrE,UAAM,aAAa,MAAM,QAAQ,iBAAiB;AAClD,UAAM,WAAW,UAAU,UAAU,CAAC,CAAC;AAEvC,WAAO,EAAE,SAAS,CAAC,EAAE;AAAA,EACvB;AACF,CAAC;AAEM,MAAM,eAAW,gCAAe;AAAA,EACrC,QAAQ;AAAA,IACN,MAAM;AAAA,IACN,OAAO;AAAA,IACP,aAAa;AAAA,IACb,aAAa,gBAAE,OAAO;AAAA,MACpB,WAAW,gBAAE,MAAM,gBAAE,OAAO,CAAC,EAAE,SAAS,EAAE,SAAS,sGAAsG;AAAA,MACzJ,UAAU,gBAAE,MAAM,gBAAE,OAAO,CAAC,EAAE,SAAS,EAAE,SAAS,4HAA4H;AAAA,IAChL,CAAC;AAAA,IACD,MAAM;AAAA,EACR;AAAA,EAEA,QAAQ,OAAO,SAAS,QAAQ,aAAa;AAC3C,UAAM,QAAQ,mBAAmB,OAAO,YAAY,aAAa;AAC/D,YAAM,WAAW,SAAS,UAAU;AAAA,QAClC,WAAW,OAAO;AAAA,QAClB,UAAU,OAAO;AAAA,QACjB,wBAAwB;AAAA,MAC1B,CAAC;AAAA,IACH,GAAG,QAAQ;AAEX,WAAO,EAAE,SAAS,CAAC,EAAE;AAAA,EACvB;AACF,CAAC;AAEM,MAAM,gBAAY,gCAAe;AAAA,EACtC,QAAQ;AAAA,IACN,MAAM;AAAA,IACN,OAAO;AAAA,IACP,aAAa;AAAA,IACb,aAAa,gBAAE,OAAO;AAAA,MACpB,MAAM,gBAAE,OAAO;AAAA,QACb,IAAI,gBAAE,OAAO,EAAE,SAAS,mBAAmB;AAAA,QAC3C,OAAO,gBAAE,OAAO,EAAE,SAAS,sEAAsE;AAAA,MACnG,CAAC;AAAA,IACH,CAAC;AAAA,IACD,MAAM;AAAA,EACR;AAAA,EAEA,QAAQ,OAAO,SAAS,QAAQ,aAAa;AAC3C,UAAM,QAAQ,mBAAmB,OAAO,YAAY,aAAa;AAC/D,YAAM,WAAW,SAAS,UAAU;AAAA,QAClC,QAAQ,CAAC,QAAQ,SAAS;AAAA,QAC1B,SAAS,CAAC,OAAO,KAAK,EAAE;AAAA;AAAA,QAExB,SAAS;AAAA,QACT,SAAS;AAAA,QACT,cAAc;AAAA,QACd,wBAAwB;AAAA,MAC1B,CAAC;AAAA,IACH,GAAG,QAAQ;AAEX,WAAO,EAAE,SAAS,CAAC,EAAE;AAAA,EACvB;AACF,CAAC;",
6
+ "names": ["ListModeReporter"]
7
+ }