rae-playwright-mcp 0.0.1 → 0.0.2

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 (160) hide show
  1. package/README.md +63 -21
  2. package/cli.js +7 -3
  3. package/index.js +1 -1
  4. package/lib/common/config.js +282 -0
  5. package/lib/common/config.js.map +7 -0
  6. package/lib/common/configLoader.js +345 -0
  7. package/lib/common/configLoader.js.map +7 -0
  8. package/lib/common/esmLoaderHost.js +105 -0
  9. package/lib/common/esmLoaderHost.js.map +7 -0
  10. package/lib/common/expectBundle.js +44 -0
  11. package/lib/common/expectBundle.js.map +7 -0
  12. package/lib/common/expectBundleImpl.js +15781 -0
  13. package/lib/common/expectBundleImpl.js.map +7 -0
  14. package/lib/common/fixtures.js +303 -0
  15. package/lib/common/fixtures.js.map +7 -0
  16. package/lib/common/globals.js +59 -0
  17. package/lib/common/globals.js.map +7 -0
  18. package/lib/common/ipc.js +61 -0
  19. package/lib/common/ipc.js.map +7 -0
  20. package/lib/common/poolBuilder.js +86 -0
  21. package/lib/common/poolBuilder.js.map +7 -0
  22. package/lib/common/process.js +133 -0
  23. package/lib/common/process.js.map +7 -0
  24. package/lib/common/suiteUtils.js +141 -0
  25. package/lib/common/suiteUtils.js.map +7 -0
  26. package/lib/common/test.js +323 -0
  27. package/lib/common/test.js.map +7 -0
  28. package/lib/common/testLoader.js +102 -0
  29. package/lib/common/testLoader.js.map +7 -0
  30. package/lib/common/testType.js +299 -0
  31. package/lib/common/testType.js.map +7 -0
  32. package/lib/common/validators.js +69 -0
  33. package/lib/common/validators.js.map +7 -0
  34. package/lib/mcp/browser/actions.d.js +17 -0
  35. package/lib/mcp/browser/actions.d.js.map +7 -0
  36. package/lib/mcp/browser/browserContextFactory.js +343 -0
  37. package/lib/mcp/browser/browserContextFactory.js.map +7 -0
  38. package/lib/mcp/browser/browserServerBackend.js +78 -0
  39. package/lib/mcp/browser/browserServerBackend.js.map +7 -0
  40. package/lib/mcp/browser/config.js +421 -0
  41. package/lib/mcp/browser/config.js.map +7 -0
  42. package/lib/mcp/browser/context.js +287 -0
  43. package/lib/mcp/browser/context.js.map +7 -0
  44. package/lib/mcp/browser/response.js +353 -0
  45. package/lib/mcp/browser/response.js.map +7 -0
  46. package/lib/mcp/browser/sessionLog.js +161 -0
  47. package/lib/mcp/browser/sessionLog.js.map +7 -0
  48. package/lib/mcp/browser/tab.js +329 -0
  49. package/lib/mcp/browser/tab.js.map +7 -0
  50. package/lib/mcp/browser/tools/common.js +64 -0
  51. package/lib/mcp/browser/tools/common.js.map +7 -0
  52. package/lib/mcp/browser/tools/console.js +45 -0
  53. package/lib/mcp/browser/tools/console.js.map +7 -0
  54. package/lib/mcp/browser/tools/dialogs.js +61 -0
  55. package/lib/mcp/browser/tools/dialogs.js.map +7 -0
  56. package/lib/mcp/browser/tools/evaluate.js +60 -0
  57. package/lib/mcp/browser/tools/evaluate.js.map +7 -0
  58. package/lib/mcp/browser/tools/files.js +59 -0
  59. package/lib/mcp/browser/tools/files.js.map +7 -0
  60. package/lib/mcp/browser/tools/form.js +64 -0
  61. package/lib/mcp/browser/tools/form.js.map +7 -0
  62. package/lib/mcp/browser/tools/install.js +70 -0
  63. package/lib/mcp/browser/tools/install.js.map +7 -0
  64. package/lib/mcp/browser/tools/keyboard.js +85 -0
  65. package/lib/mcp/browser/tools/keyboard.js.map +7 -0
  66. package/lib/mcp/browser/tools/mouse.js +108 -0
  67. package/lib/mcp/browser/tools/mouse.js.map +7 -0
  68. package/lib/mcp/browser/tools/navigate.js +63 -0
  69. package/lib/mcp/browser/tools/navigate.js.map +7 -0
  70. package/lib/mcp/browser/tools/network.js +61 -0
  71. package/lib/mcp/browser/tools/network.js.map +7 -0
  72. package/lib/mcp/browser/tools/pdf.js +49 -0
  73. package/lib/mcp/browser/tools/pdf.js.map +7 -0
  74. package/lib/mcp/browser/tools/runCode.js +78 -0
  75. package/lib/mcp/browser/tools/runCode.js.map +7 -0
  76. package/lib/mcp/browser/tools/screenshot.js +106 -0
  77. package/lib/mcp/browser/tools/screenshot.js.map +7 -0
  78. package/lib/mcp/browser/tools/snapshot.js +192 -0
  79. package/lib/mcp/browser/tools/snapshot.js.map +7 -0
  80. package/lib/mcp/browser/tools/tabs.js +68 -0
  81. package/lib/mcp/browser/tools/tabs.js.map +7 -0
  82. package/lib/mcp/browser/tools/tool.js +51 -0
  83. package/lib/mcp/browser/tools/tool.js.map +7 -0
  84. package/lib/mcp/browser/tools/tracing.js +76 -0
  85. package/lib/mcp/browser/tools/tracing.js.map +7 -0
  86. package/lib/mcp/browser/tools/utils.js +95 -0
  87. package/lib/mcp/browser/tools/utils.js.map +7 -0
  88. package/lib/mcp/browser/tools/verify.js +144 -0
  89. package/lib/mcp/browser/tools/verify.js.map +7 -0
  90. package/lib/mcp/browser/tools/wait.js +64 -0
  91. package/lib/mcp/browser/tools/wait.js.map +7 -0
  92. package/lib/mcp/browser/tools.js +83 -0
  93. package/lib/mcp/browser/tools.js.map +7 -0
  94. package/lib/mcp/browser/watchdog.js +45 -0
  95. package/lib/mcp/browser/watchdog.js.map +7 -0
  96. package/lib/mcp/config.d.js +17 -0
  97. package/lib/mcp/config.d.js.map +7 -0
  98. package/lib/mcp/config.d.ts +197 -0
  99. package/lib/mcp/extension/cdpRelay.js +352 -0
  100. package/lib/mcp/extension/cdpRelay.js.map +7 -0
  101. package/lib/mcp/extension/extensionContextFactory.js +77 -0
  102. package/lib/mcp/extension/extensionContextFactory.js.map +7 -0
  103. package/lib/mcp/extension/protocol.js +29 -0
  104. package/lib/mcp/extension/protocol.js.map +7 -0
  105. package/lib/mcp/index.js +62 -0
  106. package/lib/mcp/index.js.map +7 -0
  107. package/lib/mcp/log.js +36 -0
  108. package/lib/mcp/log.js.map +7 -0
  109. package/lib/mcp/program.js +94 -0
  110. package/lib/mcp/program.js.map +7 -0
  111. package/lib/mcp/sdk/exports.js +29 -0
  112. package/lib/mcp/sdk/exports.js.map +7 -0
  113. package/lib/mcp/sdk/http.js +153 -0
  114. package/lib/mcp/sdk/http.js.map +7 -0
  115. package/lib/mcp/sdk/inProcessTransport.js +72 -0
  116. package/lib/mcp/sdk/inProcessTransport.js.map +7 -0
  117. package/lib/mcp/sdk/server.js +208 -0
  118. package/lib/mcp/sdk/server.js.map +7 -0
  119. package/lib/mcp/sdk/tool.js +48 -0
  120. package/lib/mcp/sdk/tool.js.map +7 -0
  121. package/lib/mcp/test/browserBackend.js +99 -0
  122. package/lib/mcp/test/browserBackend.js.map +7 -0
  123. package/lib/mcp/test/generatorTools.js +123 -0
  124. package/lib/mcp/test/generatorTools.js.map +7 -0
  125. package/lib/mcp/test/plannerTools.js +145 -0
  126. package/lib/mcp/test/plannerTools.js.map +7 -0
  127. package/lib/mcp/test/seed.js +83 -0
  128. package/lib/mcp/test/seed.js.map +7 -0
  129. package/lib/mcp/test/streams.js +45 -0
  130. package/lib/mcp/test/streams.js.map +7 -0
  131. package/lib/mcp/test/testBackend.js +100 -0
  132. package/lib/mcp/test/testBackend.js.map +7 -0
  133. package/lib/mcp/test/testContext.js +280 -0
  134. package/lib/mcp/test/testContext.js.map +7 -0
  135. package/lib/mcp/test/testTool.js +31 -0
  136. package/lib/mcp/test/testTool.js.map +7 -0
  137. package/lib/mcp/test/testTools.js +109 -0
  138. package/lib/mcp/test/testTools.js.map +7 -0
  139. package/lib/third_party/pirates.js +63 -0
  140. package/lib/third_party/pirates.js.map +7 -0
  141. package/lib/third_party/tsconfig-loader.js +104 -0
  142. package/lib/third_party/tsconfig-loader.js.map +7 -0
  143. package/lib/transform/babelBundle.js +44 -0
  144. package/lib/transform/babelBundle.js.map +7 -0
  145. package/lib/transform/babelBundleImpl.js +68726 -0
  146. package/lib/transform/babelBundleImpl.js.map +7 -0
  147. package/lib/transform/babelHighlightUtils.js +64 -0
  148. package/lib/transform/babelHighlightUtils.js.map +7 -0
  149. package/lib/transform/compilationCache.js +273 -0
  150. package/lib/transform/compilationCache.js.map +7 -0
  151. package/lib/transform/esmLoader.js +104 -0
  152. package/lib/transform/esmLoader.js.map +7 -0
  153. package/lib/transform/portTransport.js +68 -0
  154. package/lib/transform/portTransport.js.map +7 -0
  155. package/lib/transform/transform.js +297 -0
  156. package/lib/transform/transform.js.map +7 -0
  157. package/lib/util.js +404 -0
  158. package/lib/utilsBundle.js +44 -0
  159. package/lib/utilsBundleImpl.js +13122 -0
  160. package/package.json +4 -3
@@ -0,0 +1,208 @@
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 server_exports = {};
30
+ __export(server_exports, {
31
+ connect: () => connect,
32
+ createServer: () => createServer,
33
+ firstRootPath: () => firstRootPath,
34
+ start: () => start,
35
+ wrapInClient: () => wrapInClient,
36
+ wrapInProcess: () => wrapInProcess
37
+ });
38
+ module.exports = __toCommonJS(server_exports);
39
+ var import_url = require("url");
40
+ var import_utilsBundle = require("playwright-core/lib/utilsBundle");
41
+ var mcpBundle = __toESM(require("playwright-core/lib/mcpBundle"));
42
+ var import_http = require("./http");
43
+ var import_inProcessTransport = require("./inProcessTransport");
44
+ const serverDebug = (0, import_utilsBundle.debug)("pw:mcp:server");
45
+ const serverDebugResponse = (0, import_utilsBundle.debug)("pw:mcp:server:response");
46
+ async function connect(factory, transport, runHeartbeat) {
47
+ const server = createServer(factory.name, factory.version, factory.create(), runHeartbeat);
48
+ await server.connect(transport);
49
+ }
50
+ function wrapInProcess(backend) {
51
+ const server = createServer("Internal", "0.0.0", backend, false);
52
+ return new import_inProcessTransport.InProcessTransport(server);
53
+ }
54
+ async function wrapInClient(backend, options) {
55
+ const server = createServer("Internal", "0.0.0", backend, false);
56
+ const transport = new import_inProcessTransport.InProcessTransport(server);
57
+ const client = new mcpBundle.Client({ name: options.name, version: options.version });
58
+ await client.connect(transport);
59
+ await client.ping();
60
+ return client;
61
+ }
62
+ function createServer(name, version, backend, runHeartbeat) {
63
+ const server = new mcpBundle.Server({ name, version }, {
64
+ capabilities: {
65
+ tools: {}
66
+ }
67
+ });
68
+ server.setRequestHandler(mcpBundle.ListToolsRequestSchema, async () => {
69
+ serverDebug("listTools");
70
+ const tools = await backend.listTools();
71
+ return { tools };
72
+ });
73
+ let initializePromise;
74
+ server.setRequestHandler(mcpBundle.CallToolRequestSchema, async (request, extra) => {
75
+ serverDebug("callTool", request);
76
+ const progressToken = request.params._meta?.progressToken;
77
+ let progressCounter = 0;
78
+ const progress = progressToken ? (params) => {
79
+ extra.sendNotification({
80
+ method: "notifications/progress",
81
+ params: {
82
+ progressToken,
83
+ progress: params.progress ?? ++progressCounter,
84
+ total: params.total,
85
+ message: params.message
86
+ }
87
+ }).catch(serverDebug);
88
+ } : () => {
89
+ };
90
+ try {
91
+ if (!initializePromise)
92
+ initializePromise = initializeServer(server, backend, runHeartbeat);
93
+ await initializePromise;
94
+ const toolResult = await backend.callTool(request.params.name, request.params.arguments || {}, progress);
95
+ const mergedResult = mergeTextParts(toolResult);
96
+ serverDebugResponse("callResult", mergedResult);
97
+ return mergedResult;
98
+ } catch (error) {
99
+ return {
100
+ content: [{ type: "text", text: "### Result\n" + String(error) }],
101
+ isError: true
102
+ };
103
+ }
104
+ });
105
+ addServerListener(server, "close", () => backend.serverClosed?.(server));
106
+ return server;
107
+ }
108
+ const initializeServer = async (server, backend, runHeartbeat) => {
109
+ const capabilities = server.getClientCapabilities();
110
+ let clientRoots = [];
111
+ if (capabilities?.roots) {
112
+ const { roots } = await server.listRoots().catch((e) => {
113
+ serverDebug(e);
114
+ return { roots: [] };
115
+ });
116
+ clientRoots = roots;
117
+ }
118
+ const clientInfo = {
119
+ name: server.getClientVersion()?.name ?? "unknown",
120
+ version: server.getClientVersion()?.version ?? "unknown",
121
+ roots: clientRoots,
122
+ timestamp: Date.now()
123
+ };
124
+ await backend.initialize?.(clientInfo);
125
+ if (runHeartbeat)
126
+ startHeartbeat(server);
127
+ };
128
+ const startHeartbeat = (server) => {
129
+ const beat = () => {
130
+ Promise.race([
131
+ server.ping(),
132
+ new Promise((_, reject) => setTimeout(() => reject(new Error("ping timeout")), 5e3))
133
+ ]).then(() => {
134
+ setTimeout(beat, 3e3);
135
+ }).catch(() => {
136
+ void server.close();
137
+ });
138
+ };
139
+ beat();
140
+ };
141
+ function addServerListener(server, event, listener) {
142
+ const oldListener = server[`on${event}`];
143
+ server[`on${event}`] = () => {
144
+ oldListener?.();
145
+ listener();
146
+ };
147
+ }
148
+ async function start(serverBackendFactory, options) {
149
+ if (options.port === void 0) {
150
+ await connect(serverBackendFactory, new mcpBundle.StdioServerTransport(), false);
151
+ return;
152
+ }
153
+ const url = await (0, import_http.startMcpHttpServer)(options, serverBackendFactory, options.allowedHosts);
154
+ const mcpConfig = { mcpServers: {} };
155
+ mcpConfig.mcpServers[serverBackendFactory.nameInConfig] = {
156
+ url: `${url}/mcp`
157
+ };
158
+ const message = [
159
+ `Listening on ${url}`,
160
+ "Put this in your client config:",
161
+ JSON.stringify(mcpConfig, void 0, 2),
162
+ "For legacy SSE transport support, you can use the /sse endpoint instead."
163
+ ].join("\n");
164
+ console.error(message);
165
+ }
166
+ function firstRootPath(clientInfo) {
167
+ if (clientInfo.roots.length === 0)
168
+ return void 0;
169
+ const firstRootUri = clientInfo.roots[0]?.uri;
170
+ const url = firstRootUri ? new URL(firstRootUri) : void 0;
171
+ try {
172
+ return url ? (0, import_url.fileURLToPath)(url) : void 0;
173
+ } catch (error) {
174
+ serverDebug(error);
175
+ return void 0;
176
+ }
177
+ }
178
+ function mergeTextParts(result) {
179
+ const content = [];
180
+ const testParts = [];
181
+ for (const part of result.content) {
182
+ if (part.type === "text") {
183
+ testParts.push(part.text);
184
+ continue;
185
+ }
186
+ if (testParts.length > 0) {
187
+ content.push({ type: "text", text: testParts.join("\n") });
188
+ testParts.length = 0;
189
+ }
190
+ content.push(part);
191
+ }
192
+ if (testParts.length > 0)
193
+ content.push({ type: "text", text: testParts.join("\n") });
194
+ return {
195
+ ...result,
196
+ content
197
+ };
198
+ }
199
+ // Annotate the CommonJS export names for ESM import in node:
200
+ 0 && (module.exports = {
201
+ connect,
202
+ createServer,
203
+ firstRootPath,
204
+ start,
205
+ wrapInClient,
206
+ wrapInProcess
207
+ });
208
+ //# sourceMappingURL=server.js.map
@@ -0,0 +1,7 @@
1
+ {
2
+ "version": 3,
3
+ "sources": ["../../../src/mcp/sdk/server.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 { fileURLToPath } from 'url';\n\nimport { debug } from 'playwright-core/lib/utilsBundle';\nimport * as mcpBundle from 'playwright-core/lib/mcpBundle';\n\nimport { startMcpHttpServer } from './http';\nimport { InProcessTransport } from './inProcessTransport';\n\nimport type { Tool, CallToolResult, CallToolRequest, Root } from '@modelcontextprotocol/sdk/types.js';\nimport type { Transport } from '@modelcontextprotocol/sdk/shared/transport.js';\nexport type { Server } from '@modelcontextprotocol/sdk/server/index.js';\nexport type { Tool, CallToolResult, CallToolRequest, Root } from '@modelcontextprotocol/sdk/types.js';\nimport type { Server } from '@modelcontextprotocol/sdk/server/index.js';\nimport type { Client } from '@modelcontextprotocol/sdk/client/index.js';\n\nconst serverDebug = debug('pw:mcp:server');\nconst serverDebugResponse = debug('pw:mcp:server:response');\n\nexport type ClientInfo = {\n name: string;\n version: string;\n roots: Root[];\n timestamp: number;\n};\n\nexport type ProgressParams = { message?: string, progress?: number, total?: number };\nexport type ProgressCallback = (params: ProgressParams) => void;\n\nexport interface ServerBackend {\n initialize?(clientInfo: ClientInfo): Promise<void>;\n listTools(): Promise<Tool[]>;\n callTool(name: string, args: CallToolRequest['params']['arguments'], progress: ProgressCallback): Promise<CallToolResult>;\n serverClosed?(server: Server): void;\n}\n\nexport type ServerBackendFactory = {\n name: string;\n nameInConfig: string;\n version: string;\n create: () => ServerBackend;\n};\n\nexport async function connect(factory: ServerBackendFactory, transport: Transport, runHeartbeat: boolean) {\n const server = createServer(factory.name, factory.version, factory.create(), runHeartbeat);\n await server.connect(transport);\n}\n\nexport function wrapInProcess(backend: ServerBackend): Transport {\n const server = createServer('Internal', '0.0.0', backend, false);\n return new InProcessTransport(server);\n}\n\nexport async function wrapInClient(backend: ServerBackend, options: { name: string, version: string }): Promise<Client> {\n const server = createServer('Internal', '0.0.0', backend, false);\n const transport = new InProcessTransport(server);\n const client = new mcpBundle.Client({ name: options.name, version: options.version });\n await client.connect(transport);\n await client.ping();\n return client;\n}\n\nexport function createServer(name: string, version: string, backend: ServerBackend, runHeartbeat: boolean): Server {\n const server = new mcpBundle.Server({ name, version }, {\n capabilities: {\n tools: {},\n }\n });\n\n server.setRequestHandler(mcpBundle.ListToolsRequestSchema, async () => {\n serverDebug('listTools');\n const tools = await backend.listTools();\n return { tools };\n });\n\n let initializePromise: Promise<void> | undefined;\n server.setRequestHandler(mcpBundle.CallToolRequestSchema, async (request, extra) => {\n serverDebug('callTool', request);\n\n const progressToken = request.params._meta?.progressToken;\n let progressCounter = 0;\n\n const progress = progressToken ? (params: ProgressParams) => {\n extra.sendNotification({\n method: 'notifications/progress',\n params: {\n progressToken,\n progress: params.progress ?? ++progressCounter,\n total: params.total,\n message: params.message,\n },\n }).catch(serverDebug);\n } : () => {};\n\n try {\n if (!initializePromise)\n initializePromise = initializeServer(server, backend, runHeartbeat);\n await initializePromise;\n const toolResult = await backend.callTool(request.params.name, request.params.arguments || {}, progress);\n const mergedResult = mergeTextParts(toolResult);\n serverDebugResponse('callResult', mergedResult);\n return mergedResult;\n } catch (error) {\n return {\n content: [{ type: 'text', text: '### Result\\n' + String(error) }],\n isError: true,\n };\n }\n });\n addServerListener(server, 'close', () => backend.serverClosed?.(server));\n return server;\n}\n\nconst initializeServer = async (server: Server, backend: ServerBackend, runHeartbeat: boolean) => {\n const capabilities = server.getClientCapabilities();\n let clientRoots: Root[] = [];\n if (capabilities?.roots) {\n const { roots } = await server.listRoots().catch(e => {\n serverDebug(e);\n return { roots: [] };\n });\n clientRoots = roots;\n }\n\n const clientInfo: ClientInfo = {\n name: server.getClientVersion()?.name ?? 'unknown',\n version: server.getClientVersion()?.version ?? 'unknown',\n roots: clientRoots,\n timestamp: Date.now(),\n };\n\n await backend.initialize?.(clientInfo);\n if (runHeartbeat)\n startHeartbeat(server);\n};\n\nconst startHeartbeat = (server: Server) => {\n const beat = () => {\n Promise.race([\n server.ping(),\n new Promise((_, reject) => setTimeout(() => reject(new Error('ping timeout')), 5000)),\n ]).then(() => {\n setTimeout(beat, 3000);\n }).catch(() => {\n void server.close();\n });\n };\n\n beat();\n};\n\nfunction addServerListener(server: Server, event: 'close' | 'initialized', listener: () => void) {\n const oldListener = server[`on${event}`];\n server[`on${event}`] = () => {\n oldListener?.();\n listener();\n };\n}\n\nexport async function start(serverBackendFactory: ServerBackendFactory, options: { host?: string; port?: number, allowedHosts?: string[] }) {\n if (options.port === undefined) {\n await connect(serverBackendFactory, new mcpBundle.StdioServerTransport(), false);\n return;\n }\n\n const url = await startMcpHttpServer(options, serverBackendFactory, options.allowedHosts);\n\n const mcpConfig: any = { mcpServers: { } };\n mcpConfig.mcpServers[serverBackendFactory.nameInConfig] = {\n url: `${url}/mcp`\n };\n const message = [\n `Listening on ${url}`,\n 'Put this in your client config:',\n JSON.stringify(mcpConfig, undefined, 2),\n 'For legacy SSE transport support, you can use the /sse endpoint instead.',\n ].join('\\n');\n // eslint-disable-next-line no-console\n console.error(message);\n}\n\nexport function firstRootPath(clientInfo: ClientInfo): string | undefined {\n if (clientInfo.roots.length === 0)\n return undefined;\n const firstRootUri = clientInfo.roots[0]?.uri;\n const url = firstRootUri ? new URL(firstRootUri) : undefined;\n try {\n return url ? fileURLToPath(url) : undefined;\n } catch (error) {\n serverDebug(error);\n return undefined;\n }\n}\n\nfunction mergeTextParts(result: CallToolResult): CallToolResult {\n const content: CallToolResult['content'] = [];\n const testParts: string[] = [];\n for (const part of result.content) {\n if (part.type === 'text') {\n testParts.push(part.text);\n continue;\n }\n if (testParts.length > 0) {\n content.push({ type: 'text', text: testParts.join('\\n') });\n testParts.length = 0;\n }\n content.push(part);\n }\n if (testParts.length > 0)\n content.push({ type: 'text', text: testParts.join('\\n') });\n return {\n ...result,\n content,\n };\n}\n"],
5
+ "mappings": "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",
6
+ "names": []
7
+ }
@@ -0,0 +1,48 @@
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 tool_exports = {};
20
+ __export(tool_exports, {
21
+ defineToolSchema: () => defineToolSchema,
22
+ toMcpTool: () => toMcpTool
23
+ });
24
+ module.exports = __toCommonJS(tool_exports);
25
+ var import_mcpBundle = require("playwright-core/lib/mcpBundle");
26
+ function toMcpTool(tool) {
27
+ const readOnly = tool.type === "readOnly" || tool.type === "assertion";
28
+ return {
29
+ name: tool.name,
30
+ description: tool.description,
31
+ inputSchema: (0, import_mcpBundle.zodToJsonSchema)(tool.inputSchema, { strictUnions: true }),
32
+ annotations: {
33
+ title: tool.title,
34
+ readOnlyHint: readOnly,
35
+ destructiveHint: !readOnly,
36
+ openWorldHint: true
37
+ }
38
+ };
39
+ }
40
+ function defineToolSchema(tool) {
41
+ return tool;
42
+ }
43
+ // Annotate the CommonJS export names for ESM import in node:
44
+ 0 && (module.exports = {
45
+ defineToolSchema,
46
+ toMcpTool
47
+ });
48
+ //# sourceMappingURL=tool.js.map
@@ -0,0 +1,7 @@
1
+ {
2
+ "version": 3,
3
+ "sources": ["../../../src/mcp/sdk/tool.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 { zodToJsonSchema } from 'playwright-core/lib/mcpBundle';\n\nimport type { z } from 'zod';\nimport type * as mcpServer from './server';\n\nexport type ToolSchema<Input extends z.Schema> = {\n name: string;\n title: string;\n description: string;\n inputSchema: Input;\n type: 'input' | 'assertion' | 'action' | 'readOnly';\n};\n\nexport function toMcpTool(tool: ToolSchema<any>): mcpServer.Tool {\n const readOnly = tool.type === 'readOnly' || tool.type === 'assertion';\n return {\n name: tool.name,\n description: tool.description,\n inputSchema: zodToJsonSchema(tool.inputSchema, { strictUnions: true }) as mcpServer.Tool['inputSchema'],\n annotations: {\n title: tool.title,\n readOnlyHint: readOnly,\n destructiveHint: !readOnly,\n openWorldHint: true,\n },\n };\n}\n\nexport function defineToolSchema<Input extends z.Schema>(tool: ToolSchema<Input>): ToolSchema<Input> {\n return tool;\n}\n"],
5
+ "mappings": ";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAgBA,uBAAgC;AAazB,SAAS,UAAU,MAAuC;AAC/D,QAAM,WAAW,KAAK,SAAS,cAAc,KAAK,SAAS;AAC3D,SAAO;AAAA,IACL,MAAM,KAAK;AAAA,IACX,aAAa,KAAK;AAAA,IAClB,iBAAa,kCAAgB,KAAK,aAAa,EAAE,cAAc,KAAK,CAAC;AAAA,IACrE,aAAa;AAAA,MACX,OAAO,KAAK;AAAA,MACZ,cAAc;AAAA,MACd,iBAAiB,CAAC;AAAA,MAClB,eAAe;AAAA,IACjB;AAAA,EACF;AACF;AAEO,SAAS,iBAAyC,MAA4C;AACnG,SAAO;AACT;",
6
+ "names": []
7
+ }
@@ -0,0 +1,99 @@
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 browserBackend_exports = {};
20
+ __export(browserBackend_exports, {
21
+ createCustomMessageHandler: () => createCustomMessageHandler
22
+ });
23
+ module.exports = __toCommonJS(browserBackend_exports);
24
+ var import_config = require("../browser/config");
25
+ var import_browserServerBackend = require("../browser/browserServerBackend");
26
+ var import_tab = require("../browser/tab");
27
+ var import_util = require("../../util");
28
+ var import_browserContextFactory = require("../browser/browserContextFactory");
29
+ function createCustomMessageHandler(testInfo, context) {
30
+ let backend;
31
+ return async (data) => {
32
+ if (data.initialize) {
33
+ if (backend)
34
+ throw new Error("MCP backend is already initialized");
35
+ backend = new import_browserServerBackend.BrowserServerBackend({ ...import_config.defaultConfig, capabilities: ["testing"] }, (0, import_browserContextFactory.identityBrowserContextFactory)(context));
36
+ await backend.initialize(data.initialize.clientInfo);
37
+ const pausedMessage = await generatePausedMessage(testInfo, context);
38
+ return { initialize: { pausedMessage } };
39
+ }
40
+ if (data.listTools) {
41
+ if (!backend)
42
+ throw new Error("MCP backend is not initialized");
43
+ return { listTools: await backend.listTools() };
44
+ }
45
+ if (data.callTool) {
46
+ if (!backend)
47
+ throw new Error("MCP backend is not initialized");
48
+ return { callTool: await backend.callTool(data.callTool.name, data.callTool.arguments) };
49
+ }
50
+ if (data.close) {
51
+ backend?.serverClosed();
52
+ backend = void 0;
53
+ return { close: {} };
54
+ }
55
+ throw new Error("Unknown MCP request");
56
+ };
57
+ }
58
+ async function generatePausedMessage(testInfo, context) {
59
+ const lines = [];
60
+ if (testInfo.errors.length) {
61
+ lines.push(`### Paused on error:`);
62
+ for (const error of testInfo.errors)
63
+ lines.push((0, import_util.stripAnsiEscapes)(error.message || ""));
64
+ } else {
65
+ lines.push(`### Paused at end of test. ready for interaction`);
66
+ }
67
+ for (let i = 0; i < context.pages().length; i++) {
68
+ const page = context.pages()[i];
69
+ const stateSuffix = context.pages().length > 1 ? i + 1 + " of " + context.pages().length : "state";
70
+ lines.push(
71
+ "",
72
+ `### Page ${stateSuffix}`,
73
+ `- Page URL: ${page.url()}`,
74
+ `- Page Title: ${await page.title()}`.trim()
75
+ );
76
+ let console = testInfo.errors.length ? await import_tab.Tab.collectConsoleMessages(page) : [];
77
+ console = console.filter((msg) => msg.type === "error");
78
+ if (console.length) {
79
+ lines.push("- Console Messages:");
80
+ for (const message of console)
81
+ lines.push(` - ${message.toString()}`);
82
+ }
83
+ lines.push(
84
+ `- Page Snapshot:`,
85
+ "```yaml",
86
+ (await page._snapshotForAI()).full,
87
+ "```"
88
+ );
89
+ }
90
+ lines.push("");
91
+ if (testInfo.errors.length)
92
+ lines.push(`### Task`, `Try recovering from the error prior to continuing`);
93
+ return lines.join("\n");
94
+ }
95
+ // Annotate the CommonJS export names for ESM import in node:
96
+ 0 && (module.exports = {
97
+ createCustomMessageHandler
98
+ });
99
+ //# sourceMappingURL=browserBackend.js.map
@@ -0,0 +1,7 @@
1
+ {
2
+ "version": 3,
3
+ "sources": ["../../../src/mcp/test/browserBackend.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 { defaultConfig } from '../browser/config';\nimport { BrowserServerBackend } from '../browser/browserServerBackend';\nimport { Tab } from '../browser/tab';\nimport { stripAnsiEscapes } from '../../util';\nimport { identityBrowserContextFactory } from '../browser/browserContextFactory';\n\nimport type * as playwright from '../../../index';\nimport type { Page } from '../../../../playwright-core/src/client/page';\nimport type { TestInfo } from '../../../test';\n\nexport type BrowserMCPRequest = {\n initialize?: { clientInfo: mcp.ClientInfo },\n listTools?: {},\n callTool?: { name: string, arguments: mcp.CallToolRequest['params']['arguments'] },\n close?: {},\n};\n\nexport type BrowserMCPResponse = {\n initialize?: { pausedMessage: string },\n listTools?: mcp.Tool[],\n callTool?: mcp.CallToolResult,\n close?: {},\n};\n\nexport function createCustomMessageHandler(testInfo: TestInfo, context: playwright.BrowserContext) {\n let backend: BrowserServerBackend | undefined;\n return async (data: BrowserMCPRequest): Promise<BrowserMCPResponse> => {\n if (data.initialize) {\n if (backend)\n throw new Error('MCP backend is already initialized');\n backend = new BrowserServerBackend({ ...defaultConfig, capabilities: ['testing'] }, identityBrowserContextFactory(context));\n await backend.initialize(data.initialize.clientInfo);\n const pausedMessage = await generatePausedMessage(testInfo, context);\n return { initialize: { pausedMessage } };\n }\n\n if (data.listTools) {\n if (!backend)\n throw new Error('MCP backend is not initialized');\n return { listTools: await backend.listTools() };\n }\n\n if (data.callTool) {\n if (!backend)\n throw new Error('MCP backend is not initialized');\n return { callTool: await backend.callTool(data.callTool.name, data.callTool.arguments) };\n }\n\n if (data.close) {\n backend?.serverClosed();\n backend = undefined;\n return { close: {} };\n }\n\n throw new Error('Unknown MCP request');\n };\n}\n\nasync function generatePausedMessage(testInfo: TestInfo, context: playwright.BrowserContext) {\n const lines: string[] = [];\n\n if (testInfo.errors.length) {\n lines.push(`### Paused on error:`);\n for (const error of testInfo.errors)\n lines.push(stripAnsiEscapes(error.message || ''));\n } else {\n lines.push(`### Paused at end of test. ready for interaction`);\n }\n\n for (let i = 0; i < context.pages().length; i++) {\n const page = context.pages()[i];\n const stateSuffix = context.pages().length > 1 ? (i + 1) + ' of ' + (context.pages().length) : 'state';\n lines.push(\n '',\n `### Page ${stateSuffix}`,\n `- Page URL: ${page.url()}`,\n `- Page Title: ${await page.title()}`.trim()\n );\n // Only print console errors when pausing on error, not when everything works as expected.\n let console = testInfo.errors.length ? await Tab.collectConsoleMessages(page) : [];\n console = console.filter(msg => msg.type === 'error');\n if (console.length) {\n lines.push('- Console Messages:');\n for (const message of console)\n lines.push(` - ${message.toString()}`);\n }\n lines.push(\n `- Page Snapshot:`,\n '```yaml',\n (await (page as Page)._snapshotForAI()).full,\n '```',\n );\n }\n\n lines.push('');\n if (testInfo.errors.length)\n lines.push(`### Task`, `Try recovering from the error prior to continuing`);\n\n return lines.join('\\n');\n}\n"],
5
+ "mappings": ";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAiBA,oBAA8B;AAC9B,kCAAqC;AACrC,iBAAoB;AACpB,kBAAiC;AACjC,mCAA8C;AAoBvC,SAAS,2BAA2B,UAAoB,SAAoC;AACjG,MAAI;AACJ,SAAO,OAAO,SAAyD;AACrE,QAAI,KAAK,YAAY;AACnB,UAAI;AACF,cAAM,IAAI,MAAM,oCAAoC;AACtD,gBAAU,IAAI,iDAAqB,EAAE,GAAG,6BAAe,cAAc,CAAC,SAAS,EAAE,OAAG,4DAA8B,OAAO,CAAC;AAC1H,YAAM,QAAQ,WAAW,KAAK,WAAW,UAAU;AACnD,YAAM,gBAAgB,MAAM,sBAAsB,UAAU,OAAO;AACnE,aAAO,EAAE,YAAY,EAAE,cAAc,EAAE;AAAA,IACzC;AAEA,QAAI,KAAK,WAAW;AAClB,UAAI,CAAC;AACH,cAAM,IAAI,MAAM,gCAAgC;AAClD,aAAO,EAAE,WAAW,MAAM,QAAQ,UAAU,EAAE;AAAA,IAChD;AAEA,QAAI,KAAK,UAAU;AACjB,UAAI,CAAC;AACH,cAAM,IAAI,MAAM,gCAAgC;AAClD,aAAO,EAAE,UAAU,MAAM,QAAQ,SAAS,KAAK,SAAS,MAAM,KAAK,SAAS,SAAS,EAAE;AAAA,IACzF;AAEA,QAAI,KAAK,OAAO;AACd,eAAS,aAAa;AACtB,gBAAU;AACV,aAAO,EAAE,OAAO,CAAC,EAAE;AAAA,IACrB;AAEA,UAAM,IAAI,MAAM,qBAAqB;AAAA,EACvC;AACF;AAEA,eAAe,sBAAsB,UAAoB,SAAoC;AAC3F,QAAM,QAAkB,CAAC;AAEzB,MAAI,SAAS,OAAO,QAAQ;AAC1B,UAAM,KAAK,sBAAsB;AACjC,eAAW,SAAS,SAAS;AAC3B,YAAM,SAAK,8BAAiB,MAAM,WAAW,EAAE,CAAC;AAAA,EACpD,OAAO;AACL,UAAM,KAAK,kDAAkD;AAAA,EAC/D;AAEA,WAAS,IAAI,GAAG,IAAI,QAAQ,MAAM,EAAE,QAAQ,KAAK;AAC/C,UAAM,OAAO,QAAQ,MAAM,EAAE,CAAC;AAC9B,UAAM,cAAc,QAAQ,MAAM,EAAE,SAAS,IAAK,IAAI,IAAK,SAAU,QAAQ,MAAM,EAAE,SAAU;AAC/F,UAAM;AAAA,MACF;AAAA,MACA,YAAY,WAAW;AAAA,MACvB,eAAe,KAAK,IAAI,CAAC;AAAA,MACzB,iBAAiB,MAAM,KAAK,MAAM,CAAC,GAAG,KAAK;AAAA,IAC/C;AAEA,QAAI,UAAU,SAAS,OAAO,SAAS,MAAM,eAAI,uBAAuB,IAAI,IAAI,CAAC;AACjF,cAAU,QAAQ,OAAO,SAAO,IAAI,SAAS,OAAO;AACpD,QAAI,QAAQ,QAAQ;AAClB,YAAM,KAAK,qBAAqB;AAChC,iBAAW,WAAW;AACpB,cAAM,KAAK,OAAO,QAAQ,SAAS,CAAC,EAAE;AAAA,IAC1C;AACA,UAAM;AAAA,MACF;AAAA,MACA;AAAA,OACC,MAAO,KAAc,eAAe,GAAG;AAAA,MACxC;AAAA,IACJ;AAAA,EACF;AAEA,QAAM,KAAK,EAAE;AACb,MAAI,SAAS,OAAO;AAClB,UAAM,KAAK,YAAY,mDAAmD;AAE5E,SAAO,MAAM,KAAK,IAAI;AACxB;",
6
+ "names": []
7
+ }
@@ -0,0 +1,123 @@
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 generatorTools_exports = {};
30
+ __export(generatorTools_exports, {
31
+ generatorReadLog: () => generatorReadLog,
32
+ generatorWriteTest: () => generatorWriteTest,
33
+ setupPage: () => setupPage
34
+ });
35
+ module.exports = __toCommonJS(generatorTools_exports);
36
+ var import_fs = __toESM(require("fs"));
37
+ var import_path = __toESM(require("path"));
38
+ var import_mcpBundle = require("playwright-core/lib/mcpBundle");
39
+ var import_testTool = require("./testTool");
40
+ var import_testContext = require("./testContext");
41
+ const setupPage = (0, import_testTool.defineTestTool)({
42
+ schema: {
43
+ name: "generator_setup_page",
44
+ title: "Setup generator page",
45
+ description: "Setup the page for test.",
46
+ inputSchema: import_mcpBundle.z.object({
47
+ plan: import_mcpBundle.z.string().describe("The plan for the test. This should be the actual test plan with all the steps."),
48
+ 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.'),
49
+ 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.')
50
+ }),
51
+ type: "readOnly"
52
+ },
53
+ handle: async (context, params) => {
54
+ const seed = await context.getOrCreateSeedFile(params.seedFile, params.project);
55
+ context.generatorJournal = new import_testContext.GeneratorJournal(context.rootPath, params.plan, seed);
56
+ const { output, status } = await context.runSeedTest(seed.file, seed.projectName);
57
+ return { content: [{ type: "text", text: output }], isError: status !== "paused" };
58
+ }
59
+ });
60
+ const generatorReadLog = (0, import_testTool.defineTestTool)({
61
+ schema: {
62
+ name: "generator_read_log",
63
+ title: "Retrieve test log",
64
+ description: "Retrieve the performed test log",
65
+ inputSchema: import_mcpBundle.z.object({}),
66
+ type: "readOnly"
67
+ },
68
+ handle: async (context) => {
69
+ if (!context.generatorJournal)
70
+ throw new Error(`Please setup page using "${setupPage.schema.name}" first.`);
71
+ const result = context.generatorJournal.journal();
72
+ return { content: [{
73
+ type: "text",
74
+ text: result
75
+ }] };
76
+ }
77
+ });
78
+ const generatorWriteTest = (0, import_testTool.defineTestTool)({
79
+ schema: {
80
+ name: "generator_write_test",
81
+ title: "Write test",
82
+ description: "Write the generated test to the test file",
83
+ inputSchema: import_mcpBundle.z.object({
84
+ fileName: import_mcpBundle.z.string().describe("The file to write the test to"),
85
+ code: import_mcpBundle.z.string().describe("The generated test code")
86
+ }),
87
+ type: "readOnly"
88
+ },
89
+ handle: async (context, params) => {
90
+ if (!context.generatorJournal)
91
+ throw new Error(`Please setup page using "${setupPage.schema.name}" first.`);
92
+ const testRunner = context.existingTestRunner();
93
+ if (!testRunner)
94
+ throw new Error("No test runner found, please setup page and perform actions first.");
95
+ const config = await testRunner.loadConfig();
96
+ const dirs = [];
97
+ for (const project of config.projects) {
98
+ const testDir = import_path.default.relative(context.rootPath, project.project.testDir).replace(/\\/g, "/");
99
+ const fileName = params.fileName.replace(/\\/g, "/");
100
+ if (fileName.startsWith(testDir)) {
101
+ const resolvedFile = import_path.default.resolve(context.rootPath, fileName);
102
+ await import_fs.default.promises.mkdir(import_path.default.dirname(resolvedFile), { recursive: true });
103
+ await import_fs.default.promises.writeFile(resolvedFile, params.code);
104
+ return {
105
+ content: [{
106
+ type: "text",
107
+ text: `### Result
108
+ Test written to ${params.fileName}`
109
+ }]
110
+ };
111
+ }
112
+ dirs.push(testDir);
113
+ }
114
+ throw new Error(`Test file did not match any of the test dirs: ${dirs.join(", ")}`);
115
+ }
116
+ });
117
+ // Annotate the CommonJS export names for ESM import in node:
118
+ 0 && (module.exports = {
119
+ generatorReadLog,
120
+ generatorWriteTest,
121
+ setupPage
122
+ });
123
+ //# sourceMappingURL=generatorTools.js.map
@@ -0,0 +1,7 @@
1
+ {
2
+ "version": 3,
3
+ "sources": ["../../../src/mcp/test/generatorTools.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 { z } from 'playwright-core/lib/mcpBundle';\nimport { defineTestTool } from './testTool';\nimport { GeneratorJournal } from './testContext';\n\nexport const setupPage = defineTestTool({\n schema: {\n name: 'generator_setup_page',\n title: 'Setup generator page',\n description: 'Setup the page for test.',\n inputSchema: z.object({\n plan: z.string().describe('The plan for the test. This should be the actual test plan with all the steps.'),\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 context.generatorJournal = new GeneratorJournal(context.rootPath, params.plan, seed);\n const { output, status } = await context.runSeedTest(seed.file, seed.projectName);\n return { content: [{ type: 'text', text: output }], isError: status !== 'paused' };\n },\n});\n\nexport const generatorReadLog = defineTestTool({\n schema: {\n name: 'generator_read_log',\n title: 'Retrieve test log',\n description: 'Retrieve the performed test log',\n inputSchema: z.object({}),\n type: 'readOnly',\n },\n\n handle: async context => {\n if (!context.generatorJournal)\n throw new Error(`Please setup page using \"${setupPage.schema.name}\" first.`);\n const result = context.generatorJournal.journal();\n return { content: [{\n type: 'text',\n text: result,\n }] };\n },\n});\n\nexport const generatorWriteTest = defineTestTool({\n schema: {\n name: 'generator_write_test',\n title: 'Write test',\n description: 'Write the generated test to the test file',\n inputSchema: z.object({\n fileName: z.string().describe('The file to write the test to'),\n code: z.string().describe('The generated test code'),\n }),\n type: 'readOnly',\n },\n\n handle: async (context, params) => {\n if (!context.generatorJournal)\n throw new Error(`Please setup page using \"${setupPage.schema.name}\" first.`);\n\n const testRunner = context.existingTestRunner();\n if (!testRunner)\n throw new Error('No test runner found, please setup page and perform actions first.');\n const config = await testRunner.loadConfig();\n\n const dirs: string[] = [];\n for (const project of config.projects) {\n const testDir = path.relative(context.rootPath, project.project.testDir).replace(/\\\\/g, '/');\n const fileName = params.fileName.replace(/\\\\/g, '/');\n if (fileName.startsWith(testDir)) {\n const resolvedFile = path.resolve(context.rootPath, fileName);\n await fs.promises.mkdir(path.dirname(resolvedFile), { recursive: true });\n await fs.promises.writeFile(resolvedFile, params.code);\n return {\n content: [{\n type: 'text',\n text: `### Result\\nTest written to ${params.fileName}`,\n }]\n };\n }\n dirs.push(testDir);\n }\n throw new Error(`Test file did not match any of the test dirs: ${dirs.join(', ')}`);\n },\n});\n"],
5
+ "mappings": "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",
6
+ "names": ["path", "fs"]
7
+ }