wide-cli 0.0.0-stage → 0.5.161126

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 (184) hide show
  1. package/LICENSE +674 -0
  2. package/README.md +81 -2
  3. package/bin/wide.js +17 -0
  4. package/dist/agent/context.d.ts +7 -0
  5. package/dist/agent/context.d.ts.map +1 -0
  6. package/dist/agent/context.js +42 -0
  7. package/dist/agent/context.js.map +1 -0
  8. package/dist/agent/index.d.ts +45 -0
  9. package/dist/agent/index.d.ts.map +1 -0
  10. package/dist/agent/index.js +272 -0
  11. package/dist/agent/index.js.map +1 -0
  12. package/dist/completion.d.ts +13 -0
  13. package/dist/completion.d.ts.map +1 -0
  14. package/dist/completion.js +170 -0
  15. package/dist/completion.js.map +1 -0
  16. package/dist/config/index.d.ts +32 -0
  17. package/dist/config/index.d.ts.map +1 -0
  18. package/dist/config/index.js +94 -0
  19. package/dist/config/index.js.map +1 -0
  20. package/dist/config/logger.d.ts +4 -0
  21. package/dist/config/logger.d.ts.map +1 -0
  22. package/dist/config/logger.js +13 -0
  23. package/dist/config/logger.js.map +1 -0
  24. package/dist/config/workspace.d.ts +7 -0
  25. package/dist/config/workspace.d.ts.map +1 -0
  26. package/dist/config/workspace.js +31 -0
  27. package/dist/config/workspace.js.map +1 -0
  28. package/dist/decision/index.d.ts +113 -0
  29. package/dist/decision/index.d.ts.map +1 -0
  30. package/dist/decision/index.js +487 -0
  31. package/dist/decision/index.js.map +1 -0
  32. package/dist/index.d.ts +2 -0
  33. package/dist/index.d.ts.map +1 -0
  34. package/dist/index.js +332 -0
  35. package/dist/index.js.map +1 -0
  36. package/dist/providers/claude.d.ts +10 -0
  37. package/dist/providers/claude.d.ts.map +1 -0
  38. package/dist/providers/claude.js +163 -0
  39. package/dist/providers/claude.js.map +1 -0
  40. package/dist/providers/gemini.d.ts +10 -0
  41. package/dist/providers/gemini.d.ts.map +1 -0
  42. package/dist/providers/gemini.js +145 -0
  43. package/dist/providers/gemini.js.map +1 -0
  44. package/dist/providers/index.d.ts +10 -0
  45. package/dist/providers/index.d.ts.map +1 -0
  46. package/dist/providers/index.js +63 -0
  47. package/dist/providers/index.js.map +1 -0
  48. package/dist/providers/ollama.d.ts +15 -0
  49. package/dist/providers/ollama.d.ts.map +1 -0
  50. package/dist/providers/ollama.js +169 -0
  51. package/dist/providers/ollama.js.map +1 -0
  52. package/dist/providers/openai.d.ts +11 -0
  53. package/dist/providers/openai.d.ts.map +1 -0
  54. package/dist/providers/openai.js +158 -0
  55. package/dist/providers/openai.js.map +1 -0
  56. package/dist/providers/retry.d.ts +7 -0
  57. package/dist/providers/retry.d.ts.map +1 -0
  58. package/dist/providers/retry.js +72 -0
  59. package/dist/providers/retry.js.map +1 -0
  60. package/dist/providers/types.d.ts +23 -0
  61. package/dist/providers/types.d.ts.map +1 -0
  62. package/dist/providers/types.js +2 -0
  63. package/dist/providers/types.js.map +1 -0
  64. package/dist/repl/commands.d.ts +18 -0
  65. package/dist/repl/commands.d.ts.map +1 -0
  66. package/dist/repl/commands.js +351 -0
  67. package/dist/repl/commands.js.map +1 -0
  68. package/dist/repl/history.d.ts +3 -0
  69. package/dist/repl/history.d.ts.map +1 -0
  70. package/dist/repl/history.js +57 -0
  71. package/dist/repl/history.js.map +1 -0
  72. package/dist/repl/index.d.ts +10 -0
  73. package/dist/repl/index.d.ts.map +1 -0
  74. package/dist/repl/index.js +345 -0
  75. package/dist/repl/index.js.map +1 -0
  76. package/dist/repl/mentions.d.ts +8 -0
  77. package/dist/repl/mentions.d.ts.map +1 -0
  78. package/dist/repl/mentions.js +100 -0
  79. package/dist/repl/mentions.js.map +1 -0
  80. package/dist/repl/sessions.d.ts +21 -0
  81. package/dist/repl/sessions.d.ts.map +1 -0
  82. package/dist/repl/sessions.js +117 -0
  83. package/dist/repl/sessions.js.map +1 -0
  84. package/dist/repl/setup.d.ts +4 -0
  85. package/dist/repl/setup.d.ts.map +1 -0
  86. package/dist/repl/setup.js +73 -0
  87. package/dist/repl/setup.js.map +1 -0
  88. package/dist/security/fuzzer.d.ts +30 -0
  89. package/dist/security/fuzzer.d.ts.map +1 -0
  90. package/dist/security/fuzzer.js +180 -0
  91. package/dist/security/fuzzer.js.map +1 -0
  92. package/dist/security/loader.d.ts +31 -0
  93. package/dist/security/loader.d.ts.map +1 -0
  94. package/dist/security/loader.js +366 -0
  95. package/dist/security/loader.js.map +1 -0
  96. package/dist/security/payloads.d.ts +9 -0
  97. package/dist/security/payloads.d.ts.map +1 -0
  98. package/dist/security/payloads.js +88 -0
  99. package/dist/security/payloads.js.map +1 -0
  100. package/dist/security/rules.d.ts +16 -0
  101. package/dist/security/rules.d.ts.map +1 -0
  102. package/dist/security/rules.js +381 -0
  103. package/dist/security/rules.js.map +1 -0
  104. package/dist/security/sca.d.ts +39 -0
  105. package/dist/security/sca.d.ts.map +1 -0
  106. package/dist/security/sca.js +464 -0
  107. package/dist/security/sca.js.map +1 -0
  108. package/dist/security/scanner.d.ts +47 -0
  109. package/dist/security/scanner.d.ts.map +1 -0
  110. package/dist/security/scanner.js +353 -0
  111. package/dist/security/scanner.js.map +1 -0
  112. package/dist/security/secrets.d.ts +5 -0
  113. package/dist/security/secrets.d.ts.map +1 -0
  114. package/dist/security/secrets.js +109 -0
  115. package/dist/security/secrets.js.map +1 -0
  116. package/dist/security/taint.d.ts +14 -0
  117. package/dist/security/taint.d.ts.map +1 -0
  118. package/dist/security/taint.js +517 -0
  119. package/dist/security/taint.js.map +1 -0
  120. package/dist/tools/browser.d.ts +110 -0
  121. package/dist/tools/browser.d.ts.map +1 -0
  122. package/dist/tools/browser.js +2105 -0
  123. package/dist/tools/browser.js.map +1 -0
  124. package/dist/tools/db.d.ts +106 -0
  125. package/dist/tools/db.d.ts.map +1 -0
  126. package/dist/tools/db.js +1526 -0
  127. package/dist/tools/db.js.map +1 -0
  128. package/dist/tools/fs.d.ts +5 -0
  129. package/dist/tools/fs.d.ts.map +1 -0
  130. package/dist/tools/fs.js +165 -0
  131. package/dist/tools/fs.js.map +1 -0
  132. package/dist/tools/git.d.ts +3 -0
  133. package/dist/tools/git.d.ts.map +1 -0
  134. package/dist/tools/git.js +50 -0
  135. package/dist/tools/git.js.map +1 -0
  136. package/dist/tools/http.d.ts +3 -0
  137. package/dist/tools/http.d.ts.map +1 -0
  138. package/dist/tools/http.js +74 -0
  139. package/dist/tools/http.js.map +1 -0
  140. package/dist/tools/index.d.ts +5 -0
  141. package/dist/tools/index.d.ts.map +1 -0
  142. package/dist/tools/index.js +72 -0
  143. package/dist/tools/index.js.map +1 -0
  144. package/dist/tools/risk.d.ts +9 -0
  145. package/dist/tools/risk.d.ts.map +1 -0
  146. package/dist/tools/risk.js +156 -0
  147. package/dist/tools/risk.js.map +1 -0
  148. package/dist/tools/search.d.ts +4 -0
  149. package/dist/tools/search.d.ts.map +1 -0
  150. package/dist/tools/search.js +133 -0
  151. package/dist/tools/search.js.map +1 -0
  152. package/dist/tools/security.d.ts +5 -0
  153. package/dist/tools/security.d.ts.map +1 -0
  154. package/dist/tools/security.js +147 -0
  155. package/dist/tools/security.js.map +1 -0
  156. package/dist/tools/shell.d.ts +10 -0
  157. package/dist/tools/shell.d.ts.map +1 -0
  158. package/dist/tools/shell.js +189 -0
  159. package/dist/tools/shell.js.map +1 -0
  160. package/dist/tools/types.d.ts +45 -0
  161. package/dist/tools/types.d.ts.map +1 -0
  162. package/dist/tools/types.js +2 -0
  163. package/dist/tools/types.js.map +1 -0
  164. package/dist/ui/banner.d.ts +24 -0
  165. package/dist/ui/banner.d.ts.map +1 -0
  166. package/dist/ui/banner.js +394 -0
  167. package/dist/ui/banner.js.map +1 -0
  168. package/dist/ui/colors.d.ts +18 -0
  169. package/dist/ui/colors.d.ts.map +1 -0
  170. package/dist/ui/colors.js +19 -0
  171. package/dist/ui/colors.js.map +1 -0
  172. package/dist/ui/diff.d.ts +14 -0
  173. package/dist/ui/diff.d.ts.map +1 -0
  174. package/dist/ui/diff.js +55 -0
  175. package/dist/ui/diff.js.map +1 -0
  176. package/dist/ui/markdown.d.ts +2 -0
  177. package/dist/ui/markdown.d.ts.map +1 -0
  178. package/dist/ui/markdown.js +32 -0
  179. package/dist/ui/markdown.js.map +1 -0
  180. package/dist/ui/spinner.d.ts +14 -0
  181. package/dist/ui/spinner.d.ts.map +1 -0
  182. package/dist/ui/spinner.js +59 -0
  183. package/dist/ui/spinner.js.map +1 -0
  184. package/package.json +61 -4
@@ -0,0 +1,2105 @@
1
+ import * as crypto from "node:crypto";
2
+ import * as fs from "node:fs";
3
+ import * as http from "node:http";
4
+ import * as os from "node:os";
5
+ import * as path from "node:path";
6
+ import { spawn } from "node:child_process";
7
+ import { createRequire } from "node:module";
8
+ const BROWSER_EMOJI_ZWJ_RE = /(?:\p{Extended_Pictographic}|\p{Emoji_Presentation}|[\u2600-\u27BF])(?:\uFE0F|\uFE0E|[\u{1F3FB}-\u{1F3FF}])?(?:\u200D(?:\p{Extended_Pictographic}|\p{Emoji_Presentation}|[\u2600-\u27BF])(?:\uFE0F|\uFE0E|[\u{1F3FB}-\u{1F3FF}])?)+/gu;
9
+ const BROWSER_EMOJI_KEYCAP_RE = /[0-9#*]\uFE0F?\u20E3/gu;
10
+ const BROWSER_EMOJI_SUPP_RE = /[\u{1F1E6}-\u{1F1FF}\u{1F3FB}-\u{1F3FF}\u{E0020}-\u{E007F}]/gu;
11
+ const BROWSER_EMOJI_PICT_RE = /\p{Extended_Pictographic}(?:\uFE0F|\uFE0E)?/gu;
12
+ const BROWSER_EMOJI_PRES_RE = /\p{Emoji_Presentation}(?:\uFE0F|\uFE0E)?/gu;
13
+ const BROWSER_EMOJI_BMP_RE = /[\u231A-\u23FF\u2600-\u27BF\u2B05-\u2B55][\uFE0E\uFE0F]?|[\u2139\u2194-\u21AA\u24C2\u25AA-\u25FE\u2934-\u2935\u3030\u303D\u3297\u3299]\uFE0F|[\uFE0E\uFE0F\u200D\u20E3]/gu;
14
+ export function stripBrowserEmojis(text) {
15
+ return String(text ?? "")
16
+ .replace(BROWSER_EMOJI_ZWJ_RE, "")
17
+ .replace(BROWSER_EMOJI_KEYCAP_RE, "")
18
+ .replace(BROWSER_EMOJI_SUPP_RE, "")
19
+ .replace(BROWSER_EMOJI_PICT_RE, "")
20
+ .replace(BROWSER_EMOJI_PRES_RE, "")
21
+ .replace(BROWSER_EMOJI_BMP_RE, "")
22
+ .replace(/[\uD800-\uDFFF]/g, "")
23
+ .replace(/[ \t]{2,}/g, " ")
24
+ .trim();
25
+ }
26
+ const HAR_SENSITIVE_HEADERS = new Set([
27
+ "authorization",
28
+ "proxy-authorization",
29
+ "cookie",
30
+ "set-cookie",
31
+ "x-api-key",
32
+ "x-auth-token",
33
+ "x-csrf-token",
34
+ ]);
35
+ function redactHarHeaders(headers) {
36
+ const out = [];
37
+ if (Array.isArray(headers)) {
38
+ for (const h of headers) {
39
+ if (!h?.name)
40
+ continue;
41
+ const name = String(h.name);
42
+ out.push({ name, value: HAR_SENSITIVE_HEADERS.has(name.toLowerCase()) ? "[REDACTED]" : String(h.value ?? "") });
43
+ }
44
+ return out;
45
+ }
46
+ if (headers && typeof headers === "object") {
47
+ for (const [name, value] of Object.entries(headers)) {
48
+ out.push({ name, value: HAR_SENSITIVE_HEADERS.has(name.toLowerCase()) ? "[REDACTED]" : String(value ?? "") });
49
+ }
50
+ }
51
+ return out;
52
+ }
53
+ function parseHarQuery(urlStr) {
54
+ try {
55
+ const parsed = new URL(urlStr);
56
+ const out = [];
57
+ for (const [name, value] of parsed.searchParams.entries()) {
58
+ out.push({ name, value });
59
+ }
60
+ return out;
61
+ }
62
+ catch {
63
+ return [];
64
+ }
65
+ }
66
+ const CLI_STEALTH_INIT_SCRIPT = `(() => {
67
+ try { Object.defineProperty(navigator, "webdriver", { get: () => undefined, configurable: true }); } catch {}
68
+ try {
69
+ if (!navigator.languages || navigator.languages.length === 0) {
70
+ Object.defineProperty(navigator, "languages", { get: () => ["en-US", "en"], configurable: true });
71
+ }
72
+ } catch {}
73
+ try {
74
+ if (!navigator.plugins || navigator.plugins.length === 0) {
75
+ Object.defineProperty(navigator, "plugins", {
76
+ get: () => [
77
+ { name: "Chrome PDF Plugin", filename: "internal-pdf-viewer", description: "Portable Document Format" },
78
+ { name: "Chrome PDF Viewer", filename: "mhjfbmdgcfjbbpaeojofohoefgiehjai", description: "" },
79
+ { name: "Native Client", filename: "internal-nacl-plugin", description: "" }
80
+ ],
81
+ configurable: true
82
+ });
83
+ }
84
+ } catch {}
85
+ try {
86
+ if (!window.chrome) {
87
+ Object.defineProperty(window, "chrome", { value: { runtime: {}, app: { isInstalled: false } }, configurable: true });
88
+ }
89
+ } catch {}
90
+ })();`;
91
+ class NodeCdpWebSocket {
92
+ readyState = 0;
93
+ socket = null;
94
+ rxBuf = Buffer.alloc(0);
95
+ fragOpcode = 0;
96
+ fragChunks = [];
97
+ listeners = {
98
+ open: [],
99
+ message: [],
100
+ error: [],
101
+ close: []
102
+ };
103
+ constructor(urlStr) {
104
+ const u = new URL(urlStr);
105
+ if (u.protocol !== "ws:") {
106
+ queueMicrotask(() => this.failConnect(new Error(`Unsupported WebSocket scheme: ${u.protocol}`)));
107
+ return;
108
+ }
109
+ const key = crypto.randomBytes(16).toString("base64");
110
+ const expectedAccept = crypto
111
+ .createHash("sha1")
112
+ .update(key + "258EAFA5-E914-47DA-95CA-C5AB0DC85B11")
113
+ .digest("base64");
114
+ const req = http.request({
115
+ hostname: u.hostname,
116
+ port: Number(u.port || 80),
117
+ path: `${u.pathname}${u.search}`,
118
+ method: "GET",
119
+ headers: {
120
+ Host: u.host,
121
+ Connection: "Upgrade",
122
+ Upgrade: "websocket",
123
+ "Sec-WebSocket-Key": key,
124
+ "Sec-WebSocket-Version": "13"
125
+ }
126
+ });
127
+ req.on("upgrade", (res, socket, head) => {
128
+ const accept = String(res.headers["sec-websocket-accept"] || "").trim();
129
+ if (accept !== expectedAccept) {
130
+ socket.destroy();
131
+ this.failConnect(new Error("WebSocket handshake validation failed"));
132
+ return;
133
+ }
134
+ this.socket = socket;
135
+ socket.setNoDelay(true);
136
+ this.readyState = 1;
137
+ this.emit("open", {});
138
+ socket.on("data", (chunk) => {
139
+ this.consume(chunk);
140
+ });
141
+ socket.on("error", (err) => {
142
+ if (this.readyState !== 3) {
143
+ this.emit("error", err);
144
+ }
145
+ });
146
+ socket.on("close", () => {
147
+ if (this.readyState !== 3) {
148
+ this.readyState = 3;
149
+ this.emit("close", {});
150
+ }
151
+ });
152
+ if (head && head.length > 0) {
153
+ this.consume(head);
154
+ }
155
+ });
156
+ req.on("response", (res) => {
157
+ res.resume();
158
+ this.failConnect(new Error(`WebSocket upgrade rejected with HTTP ${res.statusCode}`));
159
+ });
160
+ req.on("error", (err) => {
161
+ this.failConnect(err);
162
+ });
163
+ req.end();
164
+ }
165
+ addEventListener(type, handler) {
166
+ if (!this.listeners[type]) {
167
+ this.listeners[type] = [];
168
+ }
169
+ this.listeners[type].push(handler);
170
+ }
171
+ emit(type, ev) {
172
+ const handlers = this.listeners[type];
173
+ if (!handlers || handlers.length === 0)
174
+ return;
175
+ for (const fn of handlers.slice()) {
176
+ try {
177
+ fn(ev);
178
+ }
179
+ catch {
180
+ }
181
+ }
182
+ }
183
+ failConnect(err) {
184
+ if (this.readyState === 3)
185
+ return;
186
+ this.readyState = 3;
187
+ this.emit("error", err);
188
+ this.emit("close", {});
189
+ }
190
+ send(data) {
191
+ if (this.readyState !== 1 || !this.socket || this.socket.destroyed) {
192
+ throw new Error("WebSocket is not open");
193
+ }
194
+ this.sendFrame(0x1, Buffer.from(String(data), "utf8"));
195
+ }
196
+ sendFrame(opcode, payload) {
197
+ if (!this.socket || this.socket.destroyed)
198
+ return;
199
+ const len = payload.length;
200
+ const hdrLen = len < 126 ? 2 : len <= 65535 ? 4 : 10;
201
+ const frame = Buffer.allocUnsafe(hdrLen + 4 + len);
202
+ frame[0] = 0x80 | (opcode & 0x0f);
203
+ if (len < 126) {
204
+ frame[1] = 0x80 | len;
205
+ }
206
+ else if (len <= 65535) {
207
+ frame[1] = 0x80 | 126;
208
+ frame.writeUInt16BE(len, 2);
209
+ }
210
+ else {
211
+ frame[1] = 0x80 | 127;
212
+ frame.writeBigUInt64BE(BigInt(len), 2);
213
+ }
214
+ const mask = crypto.randomBytes(4);
215
+ mask.copy(frame, hdrLen);
216
+ const bodyOffset = hdrLen + 4;
217
+ for (let i = 0; i < len; i++) {
218
+ frame[bodyOffset + i] = payload[i] ^ mask[i & 3];
219
+ }
220
+ this.socket.write(frame);
221
+ }
222
+ consume(chunk) {
223
+ this.rxBuf = this.rxBuf.length > 0 ? Buffer.concat([this.rxBuf, chunk]) : chunk;
224
+ while (this.rxBuf.length >= 2) {
225
+ const b0 = this.rxBuf[0];
226
+ const b1 = this.rxBuf[1];
227
+ const fin = (b0 & 0x80) !== 0;
228
+ const opcode = b0 & 0x0f;
229
+ const masked = (b1 & 0x80) !== 0;
230
+ let len = b1 & 0x7f;
231
+ let offset = 2;
232
+ if (len === 126) {
233
+ if (this.rxBuf.length < offset + 2)
234
+ break;
235
+ len = this.rxBuf.readUInt16BE(offset);
236
+ offset += 2;
237
+ }
238
+ else if (len === 127) {
239
+ if (this.rxBuf.length < offset + 8)
240
+ break;
241
+ len = Number(this.rxBuf.readBigUInt64BE(offset));
242
+ offset += 8;
243
+ }
244
+ let maskKey = null;
245
+ if (masked) {
246
+ if (this.rxBuf.length < offset + 4)
247
+ break;
248
+ maskKey = this.rxBuf.subarray(offset, offset + 4);
249
+ offset += 4;
250
+ }
251
+ if (this.rxBuf.length < offset + len)
252
+ break;
253
+ const payload = Buffer.from(this.rxBuf.subarray(offset, offset + len));
254
+ this.rxBuf = this.rxBuf.subarray(offset + len);
255
+ if (maskKey) {
256
+ for (let i = 0; i < payload.length; i++) {
257
+ payload[i] ^= maskKey[i & 3];
258
+ }
259
+ }
260
+ if (opcode === 0x8) {
261
+ if (this.readyState === 1) {
262
+ this.readyState = 2;
263
+ try {
264
+ this.sendFrame(0x8, Buffer.alloc(0));
265
+ this.socket?.end();
266
+ }
267
+ catch {
268
+ }
269
+ }
270
+ this.readyState = 3;
271
+ this.emit("close", {});
272
+ return;
273
+ }
274
+ if (opcode === 0x9) {
275
+ if (this.readyState === 1) {
276
+ try {
277
+ this.sendFrame(0xa, payload);
278
+ }
279
+ catch {
280
+ }
281
+ }
282
+ continue;
283
+ }
284
+ if (opcode === 0xa) {
285
+ continue;
286
+ }
287
+ if (opcode === 0x1 || opcode === 0x2) {
288
+ this.fragOpcode = opcode;
289
+ this.fragChunks = [payload];
290
+ }
291
+ else if (opcode === 0x0) {
292
+ this.fragChunks.push(payload);
293
+ }
294
+ if (fin && (opcode === 0x0 || opcode === 0x1 || opcode === 0x2)) {
295
+ const full = this.fragChunks.length === 1 ? this.fragChunks[0] : Buffer.concat(this.fragChunks);
296
+ this.fragChunks = [];
297
+ if (this.fragOpcode === 0x1 || this.fragOpcode === 0x2) {
298
+ this.emit("message", { data: full.toString("utf8") });
299
+ }
300
+ }
301
+ }
302
+ }
303
+ close() {
304
+ if (this.readyState === 3)
305
+ return;
306
+ if (this.readyState === 1 && this.socket && !this.socket.destroyed) {
307
+ this.readyState = 2;
308
+ try {
309
+ this.sendFrame(0x8, Buffer.alloc(0));
310
+ }
311
+ catch {
312
+ }
313
+ }
314
+ this.readyState = 3;
315
+ try {
316
+ this.socket?.end();
317
+ this.socket?.destroy();
318
+ }
319
+ catch {
320
+ }
321
+ this.emit("close", {});
322
+ }
323
+ }
324
+ class NativeCdpSession {
325
+ proc = null;
326
+ profileDir = null;
327
+ ws = null;
328
+ nextId = 1;
329
+ pending = new Map();
330
+ eventListeners = new Map();
331
+ networkRequests = new Map();
332
+ harEntries = [];
333
+ consoleEntries = [];
334
+ lastStatusCode = 200;
335
+ async connect(executablePath, proxyUrl, stealth = false) {
336
+ const WS = typeof globalThis.WebSocket === "function" && process.env.WIDE_CLI_FORCE_NODE_WS !== "1"
337
+ ? globalThis.WebSocket
338
+ : NodeCdpWebSocket;
339
+ this.profileDir = fs.mkdtempSync(path.join(os.tmpdir(), "wide-cli-cdp-"));
340
+ try {
341
+ const args = [
342
+ "--headless=new",
343
+ "--no-sandbox",
344
+ "--disable-setuid-sandbox",
345
+ "--disable-dev-shm-usage",
346
+ "--remote-allow-origins=*",
347
+ "--no-first-run",
348
+ "--no-default-browser-check",
349
+ "--disable-gpu",
350
+ "--disable-extensions",
351
+ "--disable-background-networking",
352
+ "--remote-debugging-port=0",
353
+ `--user-data-dir=${this.profileDir}`
354
+ ];
355
+ if (stealth) {
356
+ args.push("--disable-blink-features=AutomationControlled");
357
+ }
358
+ if (proxyUrl) {
359
+ args.push(`--proxy-server=${proxyUrl}`);
360
+ }
361
+ args.push("about:blank");
362
+ const wsBaseUrl = await new Promise((resolvePromise, rejectPromise) => {
363
+ let settled = false;
364
+ let stderrBuf = "";
365
+ const timer = setTimeout(() => {
366
+ if (!settled) {
367
+ settled = true;
368
+ rejectPromise(new Error("Timed out waiting for browser DevTools endpoint"));
369
+ }
370
+ }, 15000);
371
+ timer.unref?.();
372
+ this.proc = spawn(executablePath, args, {
373
+ stdio: ["ignore", "pipe", "pipe"],
374
+ windowsHide: true
375
+ });
376
+ this.proc.on("error", (err) => {
377
+ clearTimeout(timer);
378
+ if (!settled) {
379
+ settled = true;
380
+ rejectPromise(err);
381
+ }
382
+ });
383
+ this.proc.on("exit", (code) => {
384
+ clearTimeout(timer);
385
+ if (!settled) {
386
+ settled = true;
387
+ rejectPromise(new Error(`Browser exited early (${code}): ${stderrBuf.slice(0, 300)}`));
388
+ }
389
+ });
390
+ this.proc.stderr?.on("data", (chunk) => {
391
+ stderrBuf += chunk.toString("utf8");
392
+ const m = /DevTools listening on (ws:\/\/[^\s]+)/i.exec(stderrBuf);
393
+ if (m && !settled) {
394
+ settled = true;
395
+ clearTimeout(timer);
396
+ resolvePromise(m[1]);
397
+ }
398
+ });
399
+ });
400
+ const parsed = new URL(wsBaseUrl);
401
+ const httpBase = `http://${parsed.host}`;
402
+ let pageWsUrl = "";
403
+ for (let attempt = 0; attempt < 20; attempt++) {
404
+ try {
405
+ const res = await fetch(`${httpBase}/json/list`, { signal: AbortSignal.timeout(2000) });
406
+ if (res.ok) {
407
+ const targets = (await res.json());
408
+ const pageTarget = targets.find((t) => t.type === "page" && t.webSocketDebuggerUrl);
409
+ if (pageTarget?.webSocketDebuggerUrl) {
410
+ pageWsUrl = pageTarget.webSocketDebuggerUrl;
411
+ break;
412
+ }
413
+ }
414
+ }
415
+ catch {
416
+ }
417
+ await new Promise((r) => setTimeout(r, 100));
418
+ }
419
+ if (!pageWsUrl) {
420
+ const created = await fetch(`${httpBase}/json/new?about:blank`, { method: "PUT", signal: AbortSignal.timeout(3000) }).catch(() => null);
421
+ if (created && created.ok) {
422
+ const t = (await created.json());
423
+ pageWsUrl = t?.webSocketDebuggerUrl || "";
424
+ }
425
+ }
426
+ if (!pageWsUrl) {
427
+ throw new Error("Could not acquire CDP page target");
428
+ }
429
+ await new Promise((resolvePromise, rejectPromise) => {
430
+ const timer = setTimeout(() => rejectPromise(new Error("CDP WebSocket connect timeout")), 10000);
431
+ timer.unref?.();
432
+ const ws = new WS(pageWsUrl);
433
+ this.ws = ws;
434
+ ws.addEventListener("open", () => {
435
+ clearTimeout(timer);
436
+ resolvePromise();
437
+ });
438
+ ws.addEventListener("error", () => {
439
+ clearTimeout(timer);
440
+ rejectPromise(new Error("CDP WebSocket connection failed"));
441
+ });
442
+ ws.addEventListener("message", (ev) => {
443
+ this.handleMessage(typeof ev.data === "string" ? ev.data : String(ev.data));
444
+ });
445
+ ws.addEventListener("close", () => {
446
+ for (const [, p] of this.pending) {
447
+ p.reject(new Error("CDP connection closed"));
448
+ }
449
+ this.pending.clear();
450
+ });
451
+ });
452
+ }
453
+ catch (err) {
454
+ await this.dispose();
455
+ throw err;
456
+ }
457
+ await this.send("Page.enable");
458
+ await this.send("Runtime.enable");
459
+ await this.send("Network.enable");
460
+ if (stealth) {
461
+ await this.send("Page.addScriptToEvaluateOnNewDocument", { source: CLI_STEALTH_INIT_SCRIPT }).catch(() => { });
462
+ }
463
+ await this.send("Emulation.setDeviceMetricsOverride", {
464
+ width: 1280,
465
+ height: 800,
466
+ deviceScaleFactor: 1,
467
+ mobile: false
468
+ });
469
+ this.on("Runtime.consoleAPICalled", (params) => {
470
+ const parts = Array.isArray(params?.args)
471
+ ? params.args.map((a) => a?.value ?? a?.description ?? "").filter(Boolean)
472
+ : [];
473
+ this.consoleEntries.push({
474
+ level: String(params?.type || "log"),
475
+ text: parts.join(" "),
476
+ timestamp: new Date().toISOString()
477
+ });
478
+ if (this.consoleEntries.length > 200) {
479
+ this.consoleEntries.shift();
480
+ }
481
+ });
482
+ this.on("Runtime.exceptionThrown", (params) => {
483
+ const desc = params?.exceptionDetails?.exception?.description || params?.exceptionDetails?.text || "Runtime exception";
484
+ this.consoleEntries.push({
485
+ level: "error",
486
+ text: String(desc),
487
+ timestamp: new Date().toISOString()
488
+ });
489
+ if (this.consoleEntries.length > 200) {
490
+ this.consoleEntries.shift();
491
+ }
492
+ });
493
+ this.on("Network.requestWillBeSent", (params) => {
494
+ if (!params?.requestId || !params?.request)
495
+ return;
496
+ this.networkRequests.set(params.requestId, {
497
+ startedDateTime: params.wallTime ? new Date(params.wallTime * 1000).toISOString() : new Date().toISOString(),
498
+ startTimestamp: Number(params.timestamp || 0),
499
+ request: params.request,
500
+ response: null,
501
+ endTimestamp: Number(params.timestamp || 0),
502
+ });
503
+ if (this.networkRequests.size > 400) {
504
+ const oldest = this.networkRequests.keys().next().value;
505
+ if (oldest !== undefined)
506
+ this.networkRequests.delete(oldest);
507
+ }
508
+ });
509
+ this.on("Network.responseReceived", (params) => {
510
+ if (params?.type === "Document" && typeof params?.response?.status === "number") {
511
+ this.lastStatusCode = params.response.status;
512
+ }
513
+ const rec = params?.requestId ? this.networkRequests.get(params.requestId) : null;
514
+ if (rec) {
515
+ rec.response = params.response || null;
516
+ rec.endTimestamp = Number(params.timestamp || rec.startTimestamp || 0);
517
+ }
518
+ });
519
+ const finalizeHar = (requestId, endTimestamp, encodedLength, failedText = "") => {
520
+ const rec = requestId ? this.networkRequests.get(requestId) : null;
521
+ if (!rec)
522
+ return;
523
+ this.networkRequests.delete(requestId);
524
+ const reqUrl = String(rec.request?.url || "");
525
+ if (reqUrl.startsWith("data:") || reqUrl.startsWith("blob:"))
526
+ return;
527
+ const endTs = Number(endTimestamp || rec.endTimestamp || rec.startTimestamp || 0);
528
+ const elapsedMs = rec.startTimestamp > 0 && endTs >= rec.startTimestamp ? Math.round((endTs - rec.startTimestamp) * 1000) : 0;
529
+ const resp = rec.response || {};
530
+ this.harEntries.push({
531
+ pageref: "page_1",
532
+ startedDateTime: rec.startedDateTime,
533
+ time: elapsedMs,
534
+ request: {
535
+ method: String(rec.request?.method || "GET"),
536
+ url: reqUrl,
537
+ httpVersion: String(resp.protocol || "HTTP/1.1"),
538
+ cookies: [],
539
+ headers: redactHarHeaders(rec.request?.headers),
540
+ queryString: parseHarQuery(reqUrl),
541
+ headersSize: -1,
542
+ bodySize: typeof rec.request?.postData === "string" ? Buffer.byteLength(rec.request.postData, "utf8") : 0,
543
+ },
544
+ response: {
545
+ status: Number(resp.status || 0),
546
+ statusText: failedText || String(resp.statusText || ""),
547
+ httpVersion: String(resp.protocol || "HTTP/1.1"),
548
+ cookies: [],
549
+ headers: redactHarHeaders(resp.headers),
550
+ content: {
551
+ size: Number(encodedLength || resp.encodedDataLength || 0),
552
+ mimeType: String(resp.mimeType || "x-unknown"),
553
+ },
554
+ redirectURL: "",
555
+ headersSize: -1,
556
+ bodySize: Number(encodedLength || resp.encodedDataLength || 0),
557
+ },
558
+ cache: {},
559
+ timings: { send: 0, wait: elapsedMs, receive: 0 },
560
+ });
561
+ if (this.harEntries.length > 500) {
562
+ this.harEntries.splice(0, this.harEntries.length - 500);
563
+ }
564
+ };
565
+ this.on("Network.loadingFinished", (params) => {
566
+ finalizeHar(params?.requestId, params?.timestamp, params?.encodedDataLength, "");
567
+ });
568
+ this.on("Network.loadingFailed", (params) => {
569
+ finalizeHar(params?.requestId, params?.timestamp, 0, params?.errorText || "Failed");
570
+ });
571
+ }
572
+ handleMessage(raw) {
573
+ let msg;
574
+ try {
575
+ msg = JSON.parse(raw);
576
+ }
577
+ catch {
578
+ return;
579
+ }
580
+ if (typeof msg.id === "number") {
581
+ const p = this.pending.get(msg.id);
582
+ if (p) {
583
+ this.pending.delete(msg.id);
584
+ if (msg.error) {
585
+ p.reject(new Error(msg.error.message || JSON.stringify(msg.error)));
586
+ }
587
+ else {
588
+ p.resolve(msg.result);
589
+ }
590
+ }
591
+ return;
592
+ }
593
+ if (msg.method) {
594
+ const list = this.eventListeners.get(msg.method);
595
+ if (list) {
596
+ for (const fn of list) {
597
+ try {
598
+ fn(msg.params);
599
+ }
600
+ catch {
601
+ }
602
+ }
603
+ }
604
+ }
605
+ }
606
+ on(method, handler) {
607
+ const arr = this.eventListeners.get(method) || [];
608
+ arr.push(handler);
609
+ this.eventListeners.set(method, arr);
610
+ return () => {
611
+ const cur = this.eventListeners.get(method) || [];
612
+ this.eventListeners.set(method, cur.filter((f) => f !== handler));
613
+ };
614
+ }
615
+ send(method, params = {}, timeoutMs = 15000) {
616
+ if (!this.ws || this.ws.readyState !== 1) {
617
+ return Promise.reject(new Error("CDP session is not open"));
618
+ }
619
+ const id = this.nextId++;
620
+ return new Promise((resolvePromise, rejectPromise) => {
621
+ const timer = setTimeout(() => {
622
+ this.pending.delete(id);
623
+ rejectPromise(new Error(`CDP command timed out: ${method}`));
624
+ }, timeoutMs);
625
+ this.pending.set(id, {
626
+ resolve: (val) => {
627
+ clearTimeout(timer);
628
+ resolvePromise(val);
629
+ },
630
+ reject: (err) => {
631
+ clearTimeout(timer);
632
+ rejectPromise(err);
633
+ }
634
+ });
635
+ this.ws.send(JSON.stringify({ id, method, params }));
636
+ });
637
+ }
638
+ async evalValue(expression) {
639
+ const res = await this.send("Runtime.evaluate", {
640
+ expression,
641
+ returnByValue: true,
642
+ awaitPromise: true
643
+ });
644
+ if (res?.exceptionDetails) {
645
+ const msg = res.exceptionDetails.exception?.description || res.exceptionDetails.text || "Evaluation failed";
646
+ throw new Error(String(msg));
647
+ }
648
+ return res?.result?.value;
649
+ }
650
+ async dispose() {
651
+ for (const [, p] of this.pending) {
652
+ try {
653
+ p.reject(new Error("CDP session disposed"));
654
+ }
655
+ catch {
656
+ }
657
+ }
658
+ this.pending.clear();
659
+ try {
660
+ if (this.ws) {
661
+ this.ws.close();
662
+ this.ws = null;
663
+ }
664
+ }
665
+ catch {
666
+ }
667
+ if (this.proc) {
668
+ try {
669
+ this.proc.kill("SIGKILL");
670
+ }
671
+ catch {
672
+ }
673
+ this.proc = null;
674
+ }
675
+ if (this.profileDir) {
676
+ try {
677
+ fs.rmSync(this.profileDir, { recursive: true, force: true });
678
+ }
679
+ catch {
680
+ }
681
+ this.profileDir = null;
682
+ }
683
+ }
684
+ }
685
+ const SNAPSHOT_DOM_SCRIPT = `(() => {
686
+ const prev = document.querySelectorAll('[data-wide-ref]');
687
+ for (const node of prev) node.removeAttribute('data-wide-ref');
688
+ const selector = 'a[href], button, input, select, textarea, [role="button"], [role="link"], [role="textbox"], [onclick], [tabindex]:not([tabindex="-1"])';
689
+ const nodes = Array.from(document.querySelectorAll(selector));
690
+ const elements = [];
691
+ let idx = 1;
692
+ for (const el of nodes) {
693
+ if (!(el instanceof Element)) continue;
694
+ const style = window.getComputedStyle(el);
695
+ if (style.display === 'none' || style.visibility === 'hidden') continue;
696
+ const rect = el.getBoundingClientRect();
697
+ if (rect.width <= 0 && rect.height <= 0 && el.tagName.toLowerCase() !== 'input') continue;
698
+ const tag = el.tagName.toLowerCase();
699
+ const typeAttr = (el.getAttribute('type') || 'text').toLowerCase();
700
+ if (tag === 'input' && typeAttr === 'hidden') continue;
701
+ const ref = '@e' + idx;
702
+ el.setAttribute('data-wide-ref', ref);
703
+ const role = tag === 'a' ? 'link' : tag === 'input' ? ('input[' + typeAttr + ']') : (el.getAttribute('role') || tag);
704
+ const rawText = (el.innerText || el.textContent || '').replace(/\\s+/g, ' ').trim();
705
+ const aria = el.getAttribute('aria-label') || '';
706
+ const placeholder = el.getAttribute('placeholder') || '';
707
+ const name = el.getAttribute('name') || '';
708
+ const val = ('value' in el && typeof el.value === 'string') ? el.value : (el.getAttribute('value') || '');
709
+ const href = tag === 'a' ? (el.getAttribute('href') || '') : '';
710
+ const text = (rawText || aria || placeholder || name || val || role).slice(0, 120);
711
+ elements.push({
712
+ index: idx,
713
+ ref,
714
+ tag,
715
+ role,
716
+ text,
717
+ href,
718
+ name,
719
+ value: val,
720
+ attributes: {
721
+ id: el.id || '',
722
+ name,
723
+ type: typeAttr,
724
+ placeholder,
725
+ href,
726
+ 'aria-label': aria
727
+ }
728
+ });
729
+ idx++;
730
+ if (idx > 120) break;
731
+ }
732
+ const bodyText = (document.body ? (document.body.innerText || document.body.textContent || '') : '')
733
+ .replace(/\\s+/g, ' ')
734
+ .trim()
735
+ .slice(0, 8000);
736
+ return {
737
+ url: location.href,
738
+ title: document.title || location.href,
739
+ textContent: bodyText,
740
+ rawHtml: document.documentElement ? document.documentElement.outerHTML.slice(0, 50000) : '',
741
+ elements
742
+ };
743
+ })()`;
744
+ const activeControllers = new Set();
745
+ let cleanupRegistered = false;
746
+ function registerProcessCleanup() {
747
+ if (cleanupRegistered)
748
+ return;
749
+ cleanupRegistered = true;
750
+ process.once("exit", () => {
751
+ for (const ctrl of activeControllers) {
752
+ ctrl.forceDisposeSync();
753
+ }
754
+ });
755
+ }
756
+ export class HeadlessBrowserController {
757
+ state = {
758
+ url: "about:blank",
759
+ title: "",
760
+ statusCode: 200,
761
+ elements: [],
762
+ textContent: "",
763
+ rawHtml: "",
764
+ formInputs: {},
765
+ history: [],
766
+ mode: "http"
767
+ };
768
+ cdp = null;
769
+ pwBrowser = null;
770
+ pwContext = null;
771
+ pwPage = null;
772
+ consoleBuffer = [];
773
+ cookieJar = new Map();
774
+ stealth = false;
775
+ harEntries = [];
776
+ harStartedAt = "";
777
+ userAgent = "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/131.0.0.0 Safari/537.36 Wide-CLI/0.5151126";
778
+ findSystemBrowserExecutable() {
779
+ const candidates = [];
780
+ if (process.platform === "win32") {
781
+ const localAppData = process.env.LOCALAPPDATA || "";
782
+ const programFiles = process.env["ProgramFiles"] || "C:\\Program Files";
783
+ const programFilesX86 = process.env["ProgramFiles(x86)"] || "C:\\Program Files (x86)";
784
+ candidates.push(path.join(programFiles, "Google", "Chrome", "Application", "chrome.exe"), path.join(programFilesX86, "Google", "Chrome", "Application", "chrome.exe"), path.join(localAppData, "Google", "Chrome", "Application", "chrome.exe"), path.join(programFilesX86, "Microsoft", "Edge", "Application", "msedge.exe"), path.join(programFiles, "Microsoft", "Edge", "Application", "msedge.exe"), path.join(localAppData, "Microsoft", "Edge", "Application", "msedge.exe"), path.join(programFiles, "BraveSoftware", "Brave-Browser", "Application", "brave.exe"));
785
+ }
786
+ else if (process.platform === "darwin") {
787
+ candidates.push("/Applications/Google Chrome.app/Contents/MacOS/Google Chrome", "/Applications/Microsoft Edge.app/Contents/MacOS/Microsoft Edge", "/Applications/Brave Browser.app/Contents/MacOS/Brave Browser", "/Applications/Chromium.app/Contents/MacOS/Chromium");
788
+ }
789
+ else {
790
+ candidates.push("/usr/bin/google-chrome", "/usr/bin/google-chrome-stable", "/usr/bin/chromium", "/usr/bin/chromium-browser", "/usr/bin/microsoft-edge", "/usr/bin/brave-browser");
791
+ }
792
+ for (const p of candidates) {
793
+ if (p && fs.existsSync(p))
794
+ return p;
795
+ }
796
+ return null;
797
+ }
798
+ normalizeTargetUrl(rawUrl) {
799
+ const trimmed = String(rawUrl || "").trim();
800
+ if (!trimmed)
801
+ return "about:blank";
802
+ if (/^(?:https?|about|data|file):\/\//i.test(trimmed) || trimmed === "about:blank") {
803
+ return trimmed;
804
+ }
805
+ const scheme = /^(?:localhost|127\.0\.0\.1|\[::1\]|0\.0\.0\.0)(?:[:/]|$)/i.test(trimmed)
806
+ ? "http://"
807
+ : "https://";
808
+ return scheme + trimmed;
809
+ }
810
+ async tryLoadPlaywright() {
811
+ if (process.env.WIDE_CLI_BROWSER_HTTP_ONLY === "1")
812
+ return null;
813
+ try {
814
+ const req = createRequire(import.meta.url);
815
+ const baseDir = path.dirname(req.resolve("./browser.js"));
816
+ const siblingIde = path.resolve(baseDir, "../../../../wide-ide/node_modules/playwright-core");
817
+ const siblingWide = path.resolve(baseDir, "../../../../wide/node_modules/playwright-core");
818
+ for (const id of ["playwright-core", siblingIde, siblingWide]) {
819
+ try {
820
+ return req(id);
821
+ }
822
+ catch {
823
+ }
824
+ }
825
+ }
826
+ catch {
827
+ }
828
+ return null;
829
+ }
830
+ async ensureLiveSession() {
831
+ if (this.pwPage)
832
+ return "playwright";
833
+ if (this.cdp)
834
+ return "cdp";
835
+ if (process.env.WIDE_CLI_BROWSER_HTTP_ONLY === "1")
836
+ return "http";
837
+ registerProcessCleanup();
838
+ activeControllers.add(this);
839
+ if (!this.harStartedAt) {
840
+ this.harStartedAt = new Date().toISOString();
841
+ }
842
+ const exe = this.findSystemBrowserExecutable();
843
+ const proxyUrl = process.env.WIDE_CATCHER_PROXY || process.env.HTTPS_PROXY || process.env.HTTP_PROXY || "";
844
+ const pw = await this.tryLoadPlaywright();
845
+ if (pw?.chromium && exe) {
846
+ try {
847
+ const pwArgs = ["--no-sandbox", "--disable-gpu"];
848
+ if (this.stealth) {
849
+ pwArgs.push("--disable-blink-features=AutomationControlled");
850
+ }
851
+ const launchOpts = {
852
+ executablePath: exe,
853
+ headless: true,
854
+ args: pwArgs
855
+ };
856
+ if (proxyUrl) {
857
+ launchOpts.proxy = { server: proxyUrl };
858
+ }
859
+ this.pwBrowser = await pw.chromium.launch(launchOpts);
860
+ const contextOpts = { viewport: { width: 1280, height: 800 } };
861
+ if (this.stealth) {
862
+ contextOpts.userAgent = "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/131.0.0.0 Safari/537.36";
863
+ contextOpts.locale = "en-US";
864
+ }
865
+ this.pwContext = await this.pwBrowser.newContext(contextOpts);
866
+ if (this.stealth) {
867
+ await this.pwContext.addInitScript(CLI_STEALTH_INIT_SCRIPT);
868
+ }
869
+ this.pwPage = await this.pwContext.newPage();
870
+ this.pwPage.on("console", (msg) => {
871
+ this.pushConsoleEntry(msg.type(), msg.text());
872
+ });
873
+ this.pwPage.on("pageerror", (err) => {
874
+ this.pushConsoleEntry("error", err.message);
875
+ });
876
+ this.pwPage.on("requestfinished", async (req) => {
877
+ try {
878
+ const reqUrl = String(req.url?.() || "");
879
+ if (reqUrl.startsWith("data:") || reqUrl.startsWith("blob:"))
880
+ return;
881
+ const resp = await req.response().catch(() => null);
882
+ const timing = typeof req.timing === "function" ? req.timing() : {};
883
+ const elapsedMs = timing && typeof timing.responseEnd === "number" && timing.responseEnd > 0 ? Math.round(timing.responseEnd) : 0;
884
+ this.harEntries.push({
885
+ pageref: "page_1",
886
+ startedDateTime: new Date().toISOString(),
887
+ time: elapsedMs,
888
+ request: {
889
+ method: String(req.method?.() || "GET"),
890
+ url: reqUrl,
891
+ httpVersion: "HTTP/1.1",
892
+ cookies: [],
893
+ headers: redactHarHeaders(req.headers?.() || {}),
894
+ queryString: parseHarQuery(reqUrl),
895
+ headersSize: -1,
896
+ bodySize: 0,
897
+ },
898
+ response: {
899
+ status: resp ? Number(resp.status?.() || 0) : 0,
900
+ statusText: resp ? String(resp.statusText?.() || "") : "",
901
+ httpVersion: "HTTP/1.1",
902
+ cookies: [],
903
+ headers: redactHarHeaders(resp ? resp.headers?.() : {}),
904
+ content: { size: 0, mimeType: String((resp && resp.headers?.()?.["content-type"]) || "x-unknown") },
905
+ redirectURL: "",
906
+ headersSize: -1,
907
+ bodySize: 0,
908
+ },
909
+ cache: {},
910
+ timings: { send: 0, wait: elapsedMs, receive: 0 },
911
+ });
912
+ if (this.harEntries.length > 500) {
913
+ this.harEntries.splice(0, this.harEntries.length - 500);
914
+ }
915
+ }
916
+ catch {
917
+ }
918
+ });
919
+ this.pwPage.on("response", (res) => {
920
+ try {
921
+ if (res.request()?.isNavigationRequest?.()) {
922
+ this.state.statusCode = res.status();
923
+ }
924
+ }
925
+ catch {
926
+ }
927
+ });
928
+ this.state.mode = "playwright";
929
+ this.state.stealth = this.stealth;
930
+ return "playwright";
931
+ }
932
+ catch {
933
+ await this.cleanupLiveDrivers();
934
+ }
935
+ }
936
+ if (exe) {
937
+ try {
938
+ const session = new NativeCdpSession();
939
+ await session.connect(exe, proxyUrl || undefined, this.stealth);
940
+ this.cdp = session;
941
+ this.state.mode = "cdp";
942
+ this.state.stealth = this.stealth;
943
+ return "cdp";
944
+ }
945
+ catch {
946
+ await this.cleanupLiveDrivers();
947
+ }
948
+ }
949
+ this.state.mode = "http";
950
+ this.state.stealth = this.stealth;
951
+ return "http";
952
+ }
953
+ pushConsoleEntry(level, text) {
954
+ this.consoleBuffer.push({
955
+ level: String(level || "log"),
956
+ text: String(text || ""),
957
+ timestamp: new Date().toISOString()
958
+ });
959
+ if (this.consoleBuffer.length > 200) {
960
+ this.consoleBuffer.shift();
961
+ }
962
+ }
963
+ async cleanupLiveDrivers() {
964
+ if (this.pwBrowser) {
965
+ try {
966
+ await this.pwBrowser.close();
967
+ }
968
+ catch {
969
+ }
970
+ this.pwPage = null;
971
+ this.pwContext = null;
972
+ this.pwBrowser = null;
973
+ }
974
+ if (this.cdp) {
975
+ await this.cdp.dispose();
976
+ this.cdp = null;
977
+ }
978
+ activeControllers.delete(this);
979
+ }
980
+ forceDisposeSync() {
981
+ try {
982
+ if (this.cdp) {
983
+ void this.cdp.dispose();
984
+ this.cdp = null;
985
+ }
986
+ if (this.pwBrowser) {
987
+ void this.pwBrowser.close();
988
+ this.pwBrowser = null;
989
+ this.pwContext = null;
990
+ this.pwPage = null;
991
+ }
992
+ }
993
+ catch {
994
+ }
995
+ }
996
+ async syncLiveDomState() {
997
+ let snap = null;
998
+ if (this.pwPage) {
999
+ snap = await this.pwPage.evaluate(SNAPSHOT_DOM_SCRIPT);
1000
+ }
1001
+ else if (this.cdp) {
1002
+ snap = await this.cdp.evalValue(SNAPSHOT_DOM_SCRIPT);
1003
+ this.state.statusCode = this.cdp.lastStatusCode;
1004
+ }
1005
+ if (!snap)
1006
+ return;
1007
+ this.state.url = String(snap.url || this.state.url);
1008
+ this.state.title = stripBrowserEmojis(String(snap.title || "")) || this.state.url;
1009
+ this.state.textContent = String(snap.textContent || "");
1010
+ this.state.rawHtml = String(snap.rawHtml || "");
1011
+ this.state.elements = Array.isArray(snap.elements) ? snap.elements : [];
1012
+ }
1013
+ resolveTargetRefOrSelector(target) {
1014
+ const clean = String(target || "").trim();
1015
+ const lower = clean.toLowerCase();
1016
+ if (/^@?e\d+$/i.test(clean)) {
1017
+ const normalizedRef = clean.startsWith("@") ? clean.toLowerCase() : `@${clean.toLowerCase()}`;
1018
+ const el = this.state.elements.find((e) => (e.ref || `@e${e.index}`).toLowerCase() === normalizedRef);
1019
+ return { ref: normalizedRef, matched: el, cssSelector: `[data-wide-ref="${normalizedRef}"]` };
1020
+ }
1021
+ if (/^\[\d+\]$/.test(clean) || /^\d+$/.test(clean)) {
1022
+ const idx = parseInt(clean.replace(/[\[\]]/g, ""), 10);
1023
+ const el = this.state.elements.find((e) => e.index === idx);
1024
+ const ref = el?.ref || `@e${idx}`;
1025
+ return { ref, matched: el, cssSelector: `[data-wide-ref="${ref}"]` };
1026
+ }
1027
+ const byMeta = this.state.elements.find((e) => e.text.toLowerCase().includes(lower) ||
1028
+ (e.name && e.name.toLowerCase().includes(lower)) ||
1029
+ (e.attributes?.placeholder && e.attributes.placeholder.toLowerCase().includes(lower)) ||
1030
+ (e.attributes?.id && e.attributes.id.toLowerCase() === lower));
1031
+ if (byMeta) {
1032
+ const ref = byMeta.ref || `@e${byMeta.index}`;
1033
+ return { ref, matched: byMeta, cssSelector: `[data-wide-ref="${ref}"]` };
1034
+ }
1035
+ if (/^[#.\[]|^[a-z]+\[/i.test(clean)) {
1036
+ return { cssSelector: clean };
1037
+ }
1038
+ return {};
1039
+ }
1040
+ parseHtml(rawHtml) {
1041
+ const clean = rawHtml
1042
+ .replace(/<script\b[^<]*(?:(?!<\/script>)<[^<]*)*<\/script>/gi, "")
1043
+ .replace(/<style\b[^<]*(?:(?!<\/style>)<[^<]*)*<\/style>/gi, "")
1044
+ .replace(/<noscript\b[^<]*(?:(?!<\/noscript>)<[^<]*)*<\/noscript>/gi, "")
1045
+ .replace(/<svg\b[^<]*(?:(?!<\/svg>)<[^<]*)*<\/svg>/gi, "");
1046
+ const titleMatch = /<title[^>]*>([^<]*)<\/title>/i.exec(clean);
1047
+ const title = titleMatch ? stripBrowserEmojis(titleMatch[1]) : "";
1048
+ const elements = [];
1049
+ let elemIdx = 1;
1050
+ const inputRegex = /<input\b([^>]*)>/gi;
1051
+ let inputMatch;
1052
+ while ((inputMatch = inputRegex.exec(clean)) !== null) {
1053
+ const attrsStr = inputMatch[1];
1054
+ const attrs = this.parseAttributes(attrsStr);
1055
+ const type = (attrs.type || "text").toLowerCase();
1056
+ const name = attrs.name || "";
1057
+ const val = attrs.value || "";
1058
+ const placeholder = attrs.placeholder || "";
1059
+ const role = `input[${type}]`;
1060
+ const desc = placeholder || name || val || role;
1061
+ elements.push({
1062
+ index: elemIdx,
1063
+ ref: `@e${elemIdx}`,
1064
+ tag: "input",
1065
+ text: desc,
1066
+ role,
1067
+ name,
1068
+ value: val,
1069
+ attributes: attrs
1070
+ });
1071
+ elemIdx++;
1072
+ }
1073
+ const tagRegex = /<(a|button|select|textarea)\b([^>]*)>([\s\S]*?)<\/\1>/gi;
1074
+ let tagMatch;
1075
+ while ((tagMatch = tagRegex.exec(clean)) !== null) {
1076
+ const tag = tagMatch[1].toLowerCase();
1077
+ const attrsStr = tagMatch[2];
1078
+ const inner = tagMatch[3].replace(/<[^>]+>/g, " ").trim();
1079
+ const attrs = this.parseAttributes(attrsStr);
1080
+ const role = tag === "a" ? "link" : tag;
1081
+ const text = inner || attrs["aria-label"] || attrs["title"] || role;
1082
+ elements.push({
1083
+ index: elemIdx,
1084
+ ref: `@e${elemIdx}`,
1085
+ tag,
1086
+ text,
1087
+ role,
1088
+ href: attrs.href,
1089
+ name: attrs.name,
1090
+ attributes: attrs
1091
+ });
1092
+ elemIdx++;
1093
+ }
1094
+ const plainText = clean
1095
+ .replace(/<[^>]+>/g, " ")
1096
+ .replace(/&nbsp;/g, " ")
1097
+ .replace(/&amp;/g, "&")
1098
+ .replace(/&lt;/g, "<")
1099
+ .replace(/&gt;/g, ">")
1100
+ .replace(/\s+/g, " ")
1101
+ .trim();
1102
+ return { title, elements, textContent: plainText };
1103
+ }
1104
+ parseAttributes(attrStr) {
1105
+ const attrs = {};
1106
+ const regex = /([a-zA-Z0-9_-]+)(?:\s*=\s*(?:"([^"]*)"|'([^']*)'|([^\s>]+)))?/g;
1107
+ let match;
1108
+ while ((match = regex.exec(attrStr)) !== null) {
1109
+ const key = match[1].toLowerCase();
1110
+ const val = match[2] ?? match[3] ?? match[4] ?? "";
1111
+ attrs[key] = val;
1112
+ }
1113
+ return attrs;
1114
+ }
1115
+ async open(url, opts) {
1116
+ if (typeof opts?.stealth === "boolean" && opts.stealth !== this.stealth) {
1117
+ await this.cleanupLiveDrivers();
1118
+ this.stealth = opts.stealth;
1119
+ }
1120
+ const mode = await this.ensureLiveSession();
1121
+ if (url && url.trim()) {
1122
+ return this.navigate(url);
1123
+ }
1124
+ return `Browser session initialized (engine: ${mode}, url: ${this.state.url}${this.stealth ? ", stealth: on" : ""}).`;
1125
+ }
1126
+ async navigate(url) {
1127
+ const target = this.normalizeTargetUrl(url);
1128
+ const mode = await this.ensureLiveSession();
1129
+ if (mode === "playwright" && this.pwPage) {
1130
+ try {
1131
+ const res = await this.pwPage.goto(target, { waitUntil: "domcontentloaded", timeout: 25000 });
1132
+ if (res)
1133
+ this.state.statusCode = res.status();
1134
+ await this.pwPage.waitForTimeout(150);
1135
+ this.state.history.push(target);
1136
+ this.state.formInputs = {};
1137
+ await this.syncLiveDomState();
1138
+ return this.renderView();
1139
+ }
1140
+ catch (err) {
1141
+ return `Navigation failed for ${target}: ${err.message}`;
1142
+ }
1143
+ }
1144
+ if (mode === "cdp" && this.cdp) {
1145
+ try {
1146
+ let loaded = false;
1147
+ const offLoad = this.cdp.on("Page.loadEventFired", () => {
1148
+ loaded = true;
1149
+ });
1150
+ await this.cdp.send("Page.navigate", { url: target });
1151
+ const deadline = Date.now() + 15000;
1152
+ while (!loaded && Date.now() < deadline) {
1153
+ const ready = await this.cdp.evalValue("document.readyState").catch(() => "loading");
1154
+ if (ready === "complete" || ready === "interactive") {
1155
+ loaded = true;
1156
+ break;
1157
+ }
1158
+ await new Promise((r) => setTimeout(r, 100));
1159
+ }
1160
+ offLoad();
1161
+ await new Promise((r) => setTimeout(r, 150));
1162
+ this.state.history.push(target);
1163
+ this.state.formInputs = {};
1164
+ await this.syncLiveDomState();
1165
+ return this.renderView();
1166
+ }
1167
+ catch (err) {
1168
+ return `Navigation failed for ${target}: ${err.message}`;
1169
+ }
1170
+ }
1171
+ const controller = new AbortController();
1172
+ const timer = setTimeout(() => controller.abort(), 20000);
1173
+ const reqStartedAt = Date.now();
1174
+ const startedIso = new Date(reqStartedAt).toISOString();
1175
+ if (!this.harStartedAt)
1176
+ this.harStartedAt = startedIso;
1177
+ try {
1178
+ const headers = {
1179
+ "User-Agent": this.stealth
1180
+ ? "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/131.0.0.0 Safari/537.36"
1181
+ : this.userAgent,
1182
+ Accept: "text/html,application/xhtml+xml,application/xml;q=0.9,*/*;q=0.8"
1183
+ };
1184
+ if (this.cookieJar.size > 0) {
1185
+ headers.Cookie = Array.from(this.cookieJar.entries()).map(([k, v]) => `${k}=${v}`).join("; ");
1186
+ }
1187
+ const res = await fetch(target, { headers, signal: controller.signal });
1188
+ clearTimeout(timer);
1189
+ this.state.statusCode = res.status;
1190
+ this.state.url = res.url || target;
1191
+ this.state.rawHtml = await res.text();
1192
+ this.state.history.push(this.state.url);
1193
+ this.state.formInputs = {};
1194
+ const parsed = this.parseHtml(this.state.rawHtml);
1195
+ this.state.title = stripBrowserEmojis(parsed.title) || this.state.url;
1196
+ this.state.elements = parsed.elements;
1197
+ this.state.textContent = parsed.textContent;
1198
+ const elapsedMs = Math.max(0, Date.now() - reqStartedAt);
1199
+ const respHeadersObj = {};
1200
+ res.headers.forEach((v, k) => {
1201
+ respHeadersObj[k] = v;
1202
+ });
1203
+ this.harEntries.push({
1204
+ pageref: "page_1",
1205
+ startedDateTime: startedIso,
1206
+ time: elapsedMs,
1207
+ request: {
1208
+ method: "GET",
1209
+ url: this.state.url,
1210
+ httpVersion: "HTTP/1.1",
1211
+ cookies: [],
1212
+ headers: redactHarHeaders(headers),
1213
+ queryString: parseHarQuery(this.state.url),
1214
+ headersSize: -1,
1215
+ bodySize: 0,
1216
+ },
1217
+ response: {
1218
+ status: res.status,
1219
+ statusText: res.statusText || "",
1220
+ httpVersion: "HTTP/1.1",
1221
+ cookies: [],
1222
+ headers: redactHarHeaders(respHeadersObj),
1223
+ content: {
1224
+ size: Buffer.byteLength(this.state.rawHtml, "utf8"),
1225
+ mimeType: res.headers.get("content-type") || "text/html",
1226
+ },
1227
+ redirectURL: "",
1228
+ headersSize: -1,
1229
+ bodySize: Buffer.byteLength(this.state.rawHtml, "utf8"),
1230
+ },
1231
+ cache: {},
1232
+ timings: { send: 0, wait: elapsedMs, receive: 0 },
1233
+ });
1234
+ if (this.harEntries.length > 500) {
1235
+ this.harEntries.splice(0, this.harEntries.length - 500);
1236
+ }
1237
+ return this.renderView();
1238
+ }
1239
+ catch (err) {
1240
+ clearTimeout(timer);
1241
+ return `Navigation failed for ${target}: ${err.message}`;
1242
+ }
1243
+ }
1244
+ async snapshot() {
1245
+ if (this.pwPage || this.cdp) {
1246
+ await this.syncLiveDomState();
1247
+ }
1248
+ return this.renderView();
1249
+ }
1250
+ async click(target) {
1251
+ if (this.pwPage) {
1252
+ const resolved = this.resolveTargetRefOrSelector(target);
1253
+ if (resolved.cssSelector) {
1254
+ await this.pwPage.locator(resolved.cssSelector).first().click({ timeout: 8000 });
1255
+ await this.pwPage.waitForTimeout(250);
1256
+ await this.syncLiveDomState();
1257
+ return `Clicked ${resolved.ref || target}.\n\n${this.renderView()}`;
1258
+ }
1259
+ const loc = this.pwPage.getByText(target, { exact: false }).first();
1260
+ await loc.click({ timeout: 8000 });
1261
+ await this.pwPage.waitForTimeout(250);
1262
+ await this.syncLiveDomState();
1263
+ return `Clicked '${target}'.\n\n${this.renderView()}`;
1264
+ }
1265
+ if (this.cdp) {
1266
+ const resolved = this.resolveTargetRefOrSelector(target);
1267
+ const selector = resolved.cssSelector || "";
1268
+ const coords = await this.cdp.evalValue(`(() => {
1269
+ let el = ${selector ? `document.querySelector(${JSON.stringify(selector)})` : "null"};
1270
+ if (!el) {
1271
+ const needle = ${JSON.stringify(target.trim().toLowerCase())};
1272
+ const list = Array.from(document.querySelectorAll('a,button,input,select,textarea,[role="button"],[role="link"]'));
1273
+ el = list.find((n) => (n.innerText || n.textContent || n.getAttribute('aria-label') || '').toLowerCase().includes(needle)) || null;
1274
+ }
1275
+ if (!el) return { found: false };
1276
+ el.scrollIntoView({ block: 'center', inline: 'center' });
1277
+ const r = el.getBoundingClientRect();
1278
+ return { found: true, x: r.left + r.width / 2, y: r.top + r.height / 2 };
1279
+ })()`);
1280
+ if (!coords?.found) {
1281
+ const available = this.state.elements.slice(0, 10).map((e) => `${e.ref || `[${e.index}]`} ${e.role}: ${e.text.slice(0, 25)}`).join(", ");
1282
+ return `Element '${target}' not found. Available elements: ${available}`;
1283
+ }
1284
+ const cx = Math.max(1, Math.round(coords.x));
1285
+ const cy = Math.max(1, Math.round(coords.y));
1286
+ await this.cdp.send("Input.dispatchMouseEvent", { type: "mousePressed", x: cx, y: cy, button: "left", clickCount: 1 });
1287
+ await this.cdp.send("Input.dispatchMouseEvent", { type: "mouseReleased", x: cx, y: cy, button: "left", clickCount: 1 });
1288
+ await new Promise((r) => setTimeout(r, 300));
1289
+ await this.syncLiveDomState();
1290
+ return `Clicked ${resolved.ref || target}.\n\n${this.renderView()}`;
1291
+ }
1292
+ if (this.state.elements.length === 0) {
1293
+ return "No interactive elements on the current page. Please navigate first.";
1294
+ }
1295
+ const resolved = this.resolveTargetRefOrSelector(target);
1296
+ const matched = resolved.matched;
1297
+ if (!matched) {
1298
+ const available = this.state.elements.slice(0, 10).map((e) => `[${e.index}] ${e.role}: ${e.text.slice(0, 25)}`).join(", ");
1299
+ return `Element '${target}' not found. Available elements: ${available}`;
1300
+ }
1301
+ if (matched.href) {
1302
+ const resolvedUrl = new URL(matched.href, this.state.url).toString();
1303
+ return await this.navigate(resolvedUrl);
1304
+ }
1305
+ if (matched.tag === "button" || (matched.tag === "input" && ["submit", "button"].includes(matched.attributes.type || ""))) {
1306
+ if (Object.keys(this.state.formInputs).length > 0) {
1307
+ const params = new URLSearchParams(this.state.formInputs);
1308
+ const controller = new AbortController();
1309
+ const timer = setTimeout(() => controller.abort(), 20000);
1310
+ try {
1311
+ const res = await fetch(this.state.url, {
1312
+ method: "POST",
1313
+ headers: {
1314
+ "User-Agent": this.userAgent,
1315
+ "Content-Type": "application/x-www-form-urlencoded"
1316
+ },
1317
+ body: params.toString(),
1318
+ signal: controller.signal
1319
+ });
1320
+ clearTimeout(timer);
1321
+ this.state.statusCode = res.status;
1322
+ this.state.url = res.url || this.state.url;
1323
+ this.state.rawHtml = await res.text();
1324
+ const parsed = this.parseHtml(this.state.rawHtml);
1325
+ this.state.title = parsed.title || this.state.url;
1326
+ this.state.elements = parsed.elements;
1327
+ this.state.textContent = parsed.textContent;
1328
+ return `Form submitted with payload ${JSON.stringify(this.state.formInputs)}.\n\n` + this.renderView();
1329
+ }
1330
+ catch (err) {
1331
+ clearTimeout(timer);
1332
+ return `Form submission failed: ${err.message}`;
1333
+ }
1334
+ }
1335
+ return `Clicked [${matched.index}] ${matched.role}: ${matched.text}`;
1336
+ }
1337
+ return `Clicked [${matched.index}] ${matched.role}: ${matched.text}`;
1338
+ }
1339
+ async fill(target, text, submit = false) {
1340
+ if (this.pwPage) {
1341
+ const resolved = this.resolveTargetRefOrSelector(target);
1342
+ if (!resolved.cssSelector) {
1343
+ return `Input element '${target}' not found in live page snapshot.`;
1344
+ }
1345
+ const loc = this.pwPage.locator(resolved.cssSelector).first();
1346
+ await loc.fill(text, { timeout: 8000 });
1347
+ if (submit) {
1348
+ await loc.press("Enter");
1349
+ await this.pwPage.waitForTimeout(250);
1350
+ }
1351
+ await this.syncLiveDomState();
1352
+ return `Filled ${resolved.ref || target} with value '${text}'${submit ? " and submitted" : ""}.`;
1353
+ }
1354
+ if (this.cdp) {
1355
+ const resolved = this.resolveTargetRefOrSelector(target);
1356
+ const selector = resolved.cssSelector || "";
1357
+ const focused = await this.cdp.evalValue(`(() => {
1358
+ let el = ${selector ? `document.querySelector(${JSON.stringify(selector)})` : "null"};
1359
+ if (!el) {
1360
+ const needle = ${JSON.stringify(target.trim().toLowerCase())};
1361
+ const list = Array.from(document.querySelectorAll('input,textarea'));
1362
+ el = list.find((n) => ((n.name || '') + ' ' + (n.placeholder || '') + ' ' + (n.getAttribute('aria-label') || '')).toLowerCase().includes(needle)) || null;
1363
+ }
1364
+ if (!el) return false;
1365
+ el.focus();
1366
+ el.value = ${JSON.stringify(text)};
1367
+ el.dispatchEvent(new Event('input', { bubbles: true }));
1368
+ el.dispatchEvent(new Event('change', { bubbles: true }));
1369
+ return true;
1370
+ })()`);
1371
+ if (!focused) {
1372
+ return `Input element '${target}' not found.`;
1373
+ }
1374
+ if (submit) {
1375
+ await this.press("Enter");
1376
+ }
1377
+ await this.syncLiveDomState();
1378
+ return `Filled ${resolved.ref || target} with value '${text}'${submit ? " and submitted" : ""}.`;
1379
+ }
1380
+ const resolved = this.resolveTargetRefOrSelector(target);
1381
+ let matched = resolved.matched;
1382
+ const cleanTarget = target.trim().toLowerCase();
1383
+ if (!matched) {
1384
+ matched = this.state.elements.find((e) => ["input", "textarea"].includes(e.tag) && (e.text.toLowerCase().includes(cleanTarget) ||
1385
+ (e.name && e.name.toLowerCase().includes(cleanTarget)) ||
1386
+ (e.attributes.placeholder && e.attributes.placeholder.toLowerCase().includes(cleanTarget))));
1387
+ }
1388
+ const fieldName = (matched && matched.name) ? matched.name : (cleanTarget || "field");
1389
+ this.state.formInputs[fieldName] = text;
1390
+ if (submit) {
1391
+ return this.click("submit");
1392
+ }
1393
+ const desc = matched ? `[${matched.index}] ${matched.role}` : fieldName;
1394
+ return `Filled ${desc} with value '${text}'.`;
1395
+ }
1396
+ async press(key) {
1397
+ if (this.pwPage) {
1398
+ await this.pwPage.keyboard.press(key);
1399
+ await this.pwPage.waitForTimeout(200);
1400
+ await this.syncLiveDomState();
1401
+ return `Pressed key '${key}'.`;
1402
+ }
1403
+ if (this.cdp) {
1404
+ const keyCode = key === "Enter" ? 13 : key === "Tab" ? 9 : key === "Escape" ? 27 : 0;
1405
+ await this.cdp.send("Input.dispatchKeyEvent", { type: "keyDown", key, windowsVirtualKeyCode: keyCode });
1406
+ await this.cdp.send("Input.dispatchKeyEvent", { type: "keyUp", key, windowsVirtualKeyCode: keyCode });
1407
+ await new Promise((r) => setTimeout(r, 200));
1408
+ await this.syncLiveDomState();
1409
+ return `Pressed key '${key}'.`;
1410
+ }
1411
+ if (key.toLowerCase() === "enter" && Object.keys(this.state.formInputs).length > 0) {
1412
+ return this.click("submit");
1413
+ }
1414
+ return `Simulated key press '${key}' on ${this.state.url}.`;
1415
+ }
1416
+ async hover(target) {
1417
+ if (this.pwPage) {
1418
+ const resolved = this.resolveTargetRefOrSelector(target);
1419
+ if (resolved.cssSelector) {
1420
+ await this.pwPage.locator(resolved.cssSelector).first().hover({ timeout: 6000 });
1421
+ return `Hovered over ${resolved.ref || target}.`;
1422
+ }
1423
+ }
1424
+ if (this.cdp) {
1425
+ const resolved = this.resolveTargetRefOrSelector(target);
1426
+ const selector = resolved.cssSelector || target;
1427
+ const coords = await this.cdp.evalValue(`(() => {
1428
+ const el = document.querySelector(${JSON.stringify(selector)});
1429
+ if (!el) return null;
1430
+ el.scrollIntoView({ block: 'center' });
1431
+ const r = el.getBoundingClientRect();
1432
+ return { x: r.left + r.width / 2, y: r.top + r.height / 2 };
1433
+ })()`);
1434
+ if (coords) {
1435
+ await this.cdp.send("Input.dispatchMouseEvent", { type: "mouseMoved", x: Math.round(coords.x), y: Math.round(coords.y) });
1436
+ return `Hovered over ${resolved.ref || target}.`;
1437
+ }
1438
+ }
1439
+ return `Hovered over '${target}' on ${this.state.url}.`;
1440
+ }
1441
+ async select(target, value) {
1442
+ if (this.pwPage) {
1443
+ const resolved = this.resolveTargetRefOrSelector(target);
1444
+ if (resolved.cssSelector) {
1445
+ await this.pwPage.locator(resolved.cssSelector).first().selectOption(value);
1446
+ await this.syncLiveDomState();
1447
+ return `Selected '${value}' on ${resolved.ref || target}.`;
1448
+ }
1449
+ }
1450
+ if (this.cdp) {
1451
+ const resolved = this.resolveTargetRefOrSelector(target);
1452
+ const selector = resolved.cssSelector || target;
1453
+ const ok = await this.cdp.evalValue(`(() => {
1454
+ const el = document.querySelector(${JSON.stringify(selector)});
1455
+ if (!el || el.tagName.toLowerCase() !== 'select') return false;
1456
+ el.value = ${JSON.stringify(value)};
1457
+ el.dispatchEvent(new Event('change', { bubbles: true }));
1458
+ return true;
1459
+ })()`);
1460
+ if (!ok)
1461
+ return `Select element '${target}' not found.`;
1462
+ await this.syncLiveDomState();
1463
+ return `Selected '${value}' on ${resolved.ref || target}.`;
1464
+ }
1465
+ this.state.formInputs[target] = value;
1466
+ return `Selected '${value}' for '${target}'.`;
1467
+ }
1468
+ async scroll(direction = "down", pixels = 500) {
1469
+ const js = direction === "top"
1470
+ ? "window.scrollTo(0, 0)"
1471
+ : direction === "bottom"
1472
+ ? "window.scrollTo(0, document.body.scrollHeight)"
1473
+ : `window.scrollBy(0, ${direction === "up" ? -Math.abs(pixels) : Math.abs(pixels)})`;
1474
+ if (this.pwPage) {
1475
+ await this.pwPage.evaluate(js);
1476
+ return `Scrolled ${direction} (${pixels}px).`;
1477
+ }
1478
+ if (this.cdp) {
1479
+ await this.cdp.evalValue(js);
1480
+ return `Scrolled ${direction} (${pixels}px).`;
1481
+ }
1482
+ return `Scrolled ${direction} in viewport state.`;
1483
+ }
1484
+ async wait(opts) {
1485
+ const ms = Math.min(Math.max(Number(opts.ms || 1000), 50), 15000);
1486
+ if (opts.selector) {
1487
+ if (this.pwPage) {
1488
+ await this.pwPage.waitForSelector(opts.selector, { timeout: ms });
1489
+ await this.syncLiveDomState();
1490
+ return `Selector '${opts.selector}' appeared.`;
1491
+ }
1492
+ if (this.cdp) {
1493
+ const deadline = Date.now() + ms;
1494
+ while (Date.now() < deadline) {
1495
+ const found = await this.cdp.evalValue(`Boolean(document.querySelector(${JSON.stringify(opts.selector)}))`).catch(() => false);
1496
+ if (found) {
1497
+ await this.syncLiveDomState();
1498
+ return `Selector '${opts.selector}' appeared.`;
1499
+ }
1500
+ await new Promise((r) => setTimeout(r, 150));
1501
+ }
1502
+ throw new Error(`Timed out waiting for selector '${opts.selector}'`);
1503
+ }
1504
+ }
1505
+ if (opts.text) {
1506
+ if (this.pwPage) {
1507
+ await this.pwPage.getByText(opts.text).first().waitFor({ timeout: ms });
1508
+ await this.syncLiveDomState();
1509
+ return `Text '${opts.text}' appeared.`;
1510
+ }
1511
+ if (this.cdp) {
1512
+ const deadline = Date.now() + ms;
1513
+ while (Date.now() < deadline) {
1514
+ const hasText = await this.cdp.evalValue(`document.body ? document.body.innerText.includes(${JSON.stringify(opts.text)}) : false`).catch(() => false);
1515
+ if (hasText) {
1516
+ await this.syncLiveDomState();
1517
+ return `Text '${opts.text}' appeared.`;
1518
+ }
1519
+ await new Promise((r) => setTimeout(r, 150));
1520
+ }
1521
+ throw new Error(`Timed out waiting for text '${opts.text}'`);
1522
+ }
1523
+ }
1524
+ await new Promise((r) => setTimeout(r, ms));
1525
+ return `Waited ${ms}ms.`;
1526
+ }
1527
+ extract(query = "") {
1528
+ if (!this.state.rawHtml && !this.state.textContent) {
1529
+ return "No webpage currently loaded. Use browser_navigate first.";
1530
+ }
1531
+ const lines = [
1532
+ `Page Title: ${this.state.title}`,
1533
+ `Page URL: ${this.state.url}`,
1534
+ `Status Code: ${this.state.statusCode}`,
1535
+ ""
1536
+ ];
1537
+ if (query.trim()) {
1538
+ const qLower = query.toLowerCase();
1539
+ const matched = this.state.textContent
1540
+ .split(/(?<=\.|\n)/)
1541
+ .map((s) => s.trim())
1542
+ .filter((s) => s.toLowerCase().includes(qLower));
1543
+ if (matched.length > 0) {
1544
+ lines.push(`Content matching '${query}':`);
1545
+ lines.push(...matched.slice(0, 25));
1546
+ }
1547
+ else {
1548
+ lines.push(`No exact matches for '${query}'. Showing preview:`);
1549
+ lines.push(this.state.textContent.slice(0, 2000));
1550
+ }
1551
+ }
1552
+ else {
1553
+ lines.push("Page Content:");
1554
+ lines.push(this.state.textContent.slice(0, 3000));
1555
+ }
1556
+ return lines.join("\n");
1557
+ }
1558
+ async captureScreenshotFile(outputDir) {
1559
+ let pngBuffer = null;
1560
+ if (this.pwPage) {
1561
+ pngBuffer = await this.pwPage.screenshot({ type: "png" });
1562
+ }
1563
+ else if (this.cdp) {
1564
+ const res = await this.cdp.send("Page.captureScreenshot", { format: "png" });
1565
+ if (res?.data) {
1566
+ pngBuffer = Buffer.from(res.data, "base64");
1567
+ }
1568
+ }
1569
+ if (!pngBuffer)
1570
+ return null;
1571
+ const baseDir = outputDir ? path.join(outputDir, ".wide", "screenshots") : os.tmpdir();
1572
+ fs.mkdirSync(baseDir, { recursive: true });
1573
+ const outPath = path.join(baseDir, `wide-browser-${Date.now()}.png`);
1574
+ fs.writeFileSync(outPath, pngBuffer);
1575
+ this.state.lastScreenshotPath = outPath;
1576
+ return outPath;
1577
+ }
1578
+ screenshot() {
1579
+ const lines = [
1580
+ "+----------------------------------------------------------------+",
1581
+ `| HEADLESS BROWSER SNAPSHOT: ${this.state.title.slice(0, 35).padEnd(35)} |`,
1582
+ `| URL: ${this.state.url.slice(0, 56).padEnd(56)} |`,
1583
+ `| Status: ${String(this.state.statusCode).padEnd(53)} |`,
1584
+ "+----------------------------------------------------------------+"
1585
+ ];
1586
+ for (const el of this.state.elements.slice(0, 15)) {
1587
+ const text = el.text.slice(0, 40).padEnd(40);
1588
+ const role = el.role.slice(0, 14).padEnd(14);
1589
+ lines.push(`| [${String(el.index).padStart(2, "0")}] ${role} | ${text} |`);
1590
+ }
1591
+ lines.push("+----------------------------------------------------------------+");
1592
+ if (this.state.lastScreenshotPath) {
1593
+ lines.push(`Screenshot saved: ${this.state.lastScreenshotPath}`);
1594
+ }
1595
+ return lines.join("\n");
1596
+ }
1597
+ getConsole(clear = false) {
1598
+ const merged = this.cdp ? [...this.consoleBuffer, ...this.cdp.consoleEntries] : [...this.consoleBuffer];
1599
+ if (clear) {
1600
+ this.consoleBuffer = [];
1601
+ if (this.cdp)
1602
+ this.cdp.consoleEntries = [];
1603
+ }
1604
+ return merged;
1605
+ }
1606
+ async cookies(action = "get", cookie) {
1607
+ if (action === "clear") {
1608
+ this.cookieJar.clear();
1609
+ if (this.pwContext)
1610
+ await this.pwContext.clearCookies();
1611
+ if (this.cdp)
1612
+ await this.cdp.send("Network.clearBrowserCookies");
1613
+ return "Cleared browser cookies.";
1614
+ }
1615
+ if (action === "set" && cookie?.name) {
1616
+ const targetUrl = cookie.url || (this.state.url.startsWith("http") ? this.state.url : "http://127.0.0.1/");
1617
+ this.cookieJar.set(cookie.name, cookie.value);
1618
+ if (this.pwContext) {
1619
+ await this.pwContext.addCookies([{ name: cookie.name, value: cookie.value, url: targetUrl }]);
1620
+ }
1621
+ else if (this.cdp) {
1622
+ await this.cdp.send("Network.setCookie", { name: cookie.name, value: cookie.value, url: targetUrl });
1623
+ }
1624
+ return `Set cookie '${cookie.name}'.`;
1625
+ }
1626
+ if (this.pwContext) {
1627
+ const list = await this.pwContext.cookies();
1628
+ return JSON.stringify(list, null, 2);
1629
+ }
1630
+ if (this.cdp) {
1631
+ const res = await this.cdp.send("Network.getCookies");
1632
+ return JSON.stringify(res?.cookies || [], null, 2);
1633
+ }
1634
+ return JSON.stringify(Array.from(this.cookieJar.entries()).map(([name, value]) => ({ name, value })), null, 2);
1635
+ }
1636
+ async evalJs(script) {
1637
+ if (this.pwPage) {
1638
+ const val = await this.pwPage.evaluate(script);
1639
+ return typeof val === "string" ? val : JSON.stringify(val, null, 2);
1640
+ }
1641
+ if (this.cdp) {
1642
+ const val = await this.cdp.evalValue(script);
1643
+ return typeof val === "string" ? val : JSON.stringify(val, null, 2);
1644
+ }
1645
+ throw new Error("JavaScript evaluation requires an active Chromium/Edge browser session (call browser_open or browser_navigate first).");
1646
+ }
1647
+ renderView() {
1648
+ const out = [
1649
+ `Page Title: ${this.state.title}`,
1650
+ `Current URL: ${this.state.url}`,
1651
+ `Status Code: ${this.state.statusCode}`,
1652
+ `Engine: ${this.state.mode || "http"}`,
1653
+ "",
1654
+ "Interactive Elements (target by @eN ref, [N], or label):"
1655
+ ];
1656
+ if (this.state.elements.length === 0) {
1657
+ out.push("(No interactive elements found)");
1658
+ }
1659
+ else {
1660
+ for (const el of this.state.elements.slice(0, 35)) {
1661
+ const ref = el.ref || `@e${el.index}`;
1662
+ const extra = el.href ? ` -> ${el.href}` : "";
1663
+ out.push(`[${el.index}] (${ref}) ${el.role}: ${el.text}${extra}`);
1664
+ }
1665
+ }
1666
+ out.push("");
1667
+ out.push("Page Content Preview:");
1668
+ out.push(this.state.textContent.slice(0, 1500) || "(Empty content)");
1669
+ return out.join("\n");
1670
+ }
1671
+ exportHar(opts) {
1672
+ const cdpEntries = this.cdp?.harEntries || [];
1673
+ const combined = [...cdpEntries, ...this.harEntries];
1674
+ const filter = String(opts?.urlFilter || "").trim().toLowerCase();
1675
+ const limit = Math.max(1, Math.min(500, Number(opts?.limit) || 100));
1676
+ const filtered = filter
1677
+ ? combined.filter((e) => String(e?.request?.url || "").toLowerCase().includes(filter))
1678
+ : combined;
1679
+ return {
1680
+ log: {
1681
+ version: "1.2",
1682
+ creator: { name: "Wide CLI Browser", version: "1.0" },
1683
+ pages: [
1684
+ {
1685
+ startedDateTime: this.harStartedAt || new Date().toISOString(),
1686
+ id: "page_1",
1687
+ title: stripBrowserEmojis(this.state.title || this.state.url || "New Tab") || "New Tab",
1688
+ pageTimings: { onContentLoad: -1, onLoad: -1 },
1689
+ },
1690
+ ],
1691
+ entries: filtered.slice(-limit),
1692
+ },
1693
+ };
1694
+ }
1695
+ close() {
1696
+ const u = this.state.url;
1697
+ void this.cleanupLiveDrivers();
1698
+ this.consoleBuffer = [];
1699
+ this.cookieJar.clear();
1700
+ this.harEntries = [];
1701
+ this.harStartedAt = "";
1702
+ this.stealth = false;
1703
+ this.state = {
1704
+ url: "about:blank",
1705
+ title: "",
1706
+ statusCode: 200,
1707
+ elements: [],
1708
+ textContent: "",
1709
+ rawHtml: "",
1710
+ formInputs: {},
1711
+ history: [],
1712
+ mode: "http",
1713
+ stealth: false,
1714
+ };
1715
+ return `Headless browser session closed. Cleared session for ${u}.`;
1716
+ }
1717
+ }
1718
+ export const defaultBrowser = new HeadlessBrowserController();
1719
+ export const browserOpenTool = {
1720
+ definition: {
1721
+ name: "browser_open",
1722
+ description: "Initialize the real Chromium/Edge browser session and optionally navigate to an initial URL.",
1723
+ parameters: {
1724
+ type: "object",
1725
+ properties: {
1726
+ url: { type: "string", description: "Optional URL to open immediately." },
1727
+ stealth: { type: "boolean", description: "Opt-in stealth evasion mode masking navigator.webdriver." }
1728
+ },
1729
+ required: []
1730
+ }
1731
+ },
1732
+ async execute(params) {
1733
+ try {
1734
+ const result = await defaultBrowser.open(params.url, {
1735
+ stealth: typeof params.stealth === "boolean" ? params.stealth : undefined,
1736
+ });
1737
+ return { success: true, output: result };
1738
+ }
1739
+ catch (err) {
1740
+ return { success: false, output: "", error: `Open error: ${err.message}` };
1741
+ }
1742
+ }
1743
+ };
1744
+ export const browserNavigateTool = {
1745
+ definition: {
1746
+ name: "browser_navigate",
1747
+ description: "Navigate the autonomous browser to a target URL. Returns page title, status, and @eN / [N] interactive element refs.",
1748
+ parameters: {
1749
+ type: "object",
1750
+ properties: {
1751
+ url: { type: "string", description: "Target URL to visit (e.g. https://example.com)." }
1752
+ },
1753
+ required: ["url"]
1754
+ }
1755
+ },
1756
+ async execute(params) {
1757
+ try {
1758
+ const result = await defaultBrowser.navigate(params.url);
1759
+ return { success: true, output: result };
1760
+ }
1761
+ catch (err) {
1762
+ return { success: false, output: "", error: `Navigation error: ${err.message}` };
1763
+ }
1764
+ }
1765
+ };
1766
+ export const browserSnapshotTool = {
1767
+ definition: {
1768
+ name: "browser_snapshot",
1769
+ description: "Capture a fresh interactive DOM snapshot with @eN element refs and visible text from the current page.",
1770
+ parameters: {
1771
+ type: "object",
1772
+ properties: {},
1773
+ required: []
1774
+ }
1775
+ },
1776
+ async execute() {
1777
+ try {
1778
+ const result = await defaultBrowser.snapshot();
1779
+ return { success: true, output: result };
1780
+ }
1781
+ catch (err) {
1782
+ return { success: false, output: "", error: `Snapshot error: ${err.message}` };
1783
+ }
1784
+ }
1785
+ };
1786
+ export const browserClickTool = {
1787
+ definition: {
1788
+ name: "browser_click",
1789
+ description: "Click an interactive element (link, button, tab) by its @eN ref, [N] index, CSS selector, or text label.",
1790
+ parameters: {
1791
+ type: "object",
1792
+ properties: {
1793
+ target: { type: "string", description: "Element ref ('@e3'), index ('[3]' or '3'), CSS selector, or text label." }
1794
+ },
1795
+ required: ["target"]
1796
+ }
1797
+ },
1798
+ async execute(params) {
1799
+ try {
1800
+ const result = await defaultBrowser.click(params.target);
1801
+ return { success: true, output: result };
1802
+ }
1803
+ catch (err) {
1804
+ return { success: false, output: "", error: `Click error: ${err.message}` };
1805
+ }
1806
+ }
1807
+ };
1808
+ export const browserTypeTool = {
1809
+ definition: {
1810
+ name: "browser_type",
1811
+ description: "Fill text into an input field or textarea identified by @eN ref, [N] index, CSS selector, or name/placeholder.",
1812
+ parameters: {
1813
+ type: "object",
1814
+ properties: {
1815
+ target: { type: "string", description: "Element ref ('@e2'), index ('[2]'), CSS selector, or input name/placeholder." },
1816
+ text: { type: "string", description: "Text string to fill into the input field." },
1817
+ submit: { type: "boolean", description: "Optional boolean flag to submit after typing." }
1818
+ },
1819
+ required: ["target", "text"]
1820
+ }
1821
+ },
1822
+ async execute(params) {
1823
+ try {
1824
+ const result = await defaultBrowser.fill(params.target, params.text, Boolean(params.submit));
1825
+ return { success: true, output: result };
1826
+ }
1827
+ catch (err) {
1828
+ return { success: false, output: "", error: `Type error: ${err.message}` };
1829
+ }
1830
+ }
1831
+ };
1832
+ export const browserPressTool = {
1833
+ definition: {
1834
+ name: "browser_press",
1835
+ description: "Dispatch a keyboard key press (e.g. Enter, Tab, Escape, ArrowDown) in the active browser page.",
1836
+ parameters: {
1837
+ type: "object",
1838
+ properties: {
1839
+ key: { type: "string", description: "Key name (e.g. 'Enter', 'Tab', 'Escape')." }
1840
+ },
1841
+ required: ["key"]
1842
+ }
1843
+ },
1844
+ async execute(params) {
1845
+ try {
1846
+ const result = await defaultBrowser.press(params.key);
1847
+ return { success: true, output: result };
1848
+ }
1849
+ catch (err) {
1850
+ return { success: false, output: "", error: `Key press error: ${err.message}` };
1851
+ }
1852
+ }
1853
+ };
1854
+ export const browserHoverTool = {
1855
+ definition: {
1856
+ name: "browser_hover",
1857
+ description: "Hover the mouse cursor over an element identified by @eN ref, index, or CSS selector.",
1858
+ parameters: {
1859
+ type: "object",
1860
+ properties: {
1861
+ target: { type: "string", description: "Element ref, index, or CSS selector." }
1862
+ },
1863
+ required: ["target"]
1864
+ }
1865
+ },
1866
+ async execute(params) {
1867
+ try {
1868
+ const result = await defaultBrowser.hover(params.target);
1869
+ return { success: true, output: result };
1870
+ }
1871
+ catch (err) {
1872
+ return { success: false, output: "", error: `Hover error: ${err.message}` };
1873
+ }
1874
+ }
1875
+ };
1876
+ export const browserSelectTool = {
1877
+ definition: {
1878
+ name: "browser_select",
1879
+ description: "Select an option value on a <select> dropdown element.",
1880
+ parameters: {
1881
+ type: "object",
1882
+ properties: {
1883
+ target: { type: "string", description: "Select element @eN ref, index, or CSS selector." },
1884
+ value: { type: "string", description: "Option value to select." }
1885
+ },
1886
+ required: ["target", "value"]
1887
+ }
1888
+ },
1889
+ async execute(params) {
1890
+ try {
1891
+ const result = await defaultBrowser.select(params.target, params.value);
1892
+ return { success: true, output: result };
1893
+ }
1894
+ catch (err) {
1895
+ return { success: false, output: "", error: `Select error: ${err.message}` };
1896
+ }
1897
+ }
1898
+ };
1899
+ export const browserScrollTool = {
1900
+ definition: {
1901
+ name: "browser_scroll",
1902
+ description: "Scroll the browser viewport up, down, top, or bottom.",
1903
+ parameters: {
1904
+ type: "object",
1905
+ properties: {
1906
+ direction: { type: "string", description: "Scroll direction.", enum: ["up", "down", "top", "bottom"] },
1907
+ pixels: { type: "number", description: "Pixels to scroll for up/down (default: 500)." }
1908
+ },
1909
+ required: []
1910
+ }
1911
+ },
1912
+ async execute(params) {
1913
+ try {
1914
+ const result = await defaultBrowser.scroll(params.direction || "down", params.pixels || 500);
1915
+ return { success: true, output: result };
1916
+ }
1917
+ catch (err) {
1918
+ return { success: false, output: "", error: `Scroll error: ${err.message}` };
1919
+ }
1920
+ }
1921
+ };
1922
+ export const browserWaitTool = {
1923
+ definition: {
1924
+ name: "browser_wait",
1925
+ description: "Wait for a CSS selector, visible text, or fixed duration in the browser.",
1926
+ parameters: {
1927
+ type: "object",
1928
+ properties: {
1929
+ ms: { type: "number", description: "Timeout or wait duration in milliseconds." },
1930
+ selector: { type: "string", description: "Optional CSS selector to wait for." },
1931
+ text: { type: "string", description: "Optional visible text to wait for." }
1932
+ },
1933
+ required: []
1934
+ }
1935
+ },
1936
+ async execute(params) {
1937
+ try {
1938
+ const result = await defaultBrowser.wait({ ms: params.ms, selector: params.selector, text: params.text });
1939
+ return { success: true, output: result };
1940
+ }
1941
+ catch (err) {
1942
+ return { success: false, output: "", error: `Wait error: ${err.message}` };
1943
+ }
1944
+ }
1945
+ };
1946
+ export const browserExtractTool = {
1947
+ definition: {
1948
+ name: "browser_extract",
1949
+ description: "Extract text content or search for specific keywords from the currently loaded page.",
1950
+ parameters: {
1951
+ type: "object",
1952
+ properties: {
1953
+ query: { type: "string", description: "Optional search query or term to filter extracted content." }
1954
+ },
1955
+ required: []
1956
+ }
1957
+ },
1958
+ async execute(params) {
1959
+ try {
1960
+ const result = defaultBrowser.extract(params.query || "");
1961
+ return { success: true, output: result };
1962
+ }
1963
+ catch (err) {
1964
+ return { success: false, output: "", error: `Extract error: ${err.message}` };
1965
+ }
1966
+ }
1967
+ };
1968
+ export const browserScreenshotTool = {
1969
+ definition: {
1970
+ name: "browser_screenshot",
1971
+ description: "Capture a screenshot PNG (when Chromium/Edge is active) and structured viewport snapshot.",
1972
+ parameters: {
1973
+ type: "object",
1974
+ properties: {},
1975
+ required: []
1976
+ }
1977
+ },
1978
+ async execute(_params, context) {
1979
+ try {
1980
+ await defaultBrowser.captureScreenshotFile(context?.workingDirectory);
1981
+ const result = defaultBrowser.screenshot();
1982
+ return { success: true, output: result };
1983
+ }
1984
+ catch (err) {
1985
+ return { success: false, output: "", error: `Screenshot error: ${err.message}` };
1986
+ }
1987
+ }
1988
+ };
1989
+ export const browserConsoleTool = {
1990
+ definition: {
1991
+ name: "browser_console",
1992
+ description: "Read console logs and runtime errors emitted by the active browser page.",
1993
+ parameters: {
1994
+ type: "object",
1995
+ properties: {
1996
+ clear: { type: "boolean", description: "Clear console buffer after reading." }
1997
+ },
1998
+ required: []
1999
+ }
2000
+ },
2001
+ async execute(params) {
2002
+ try {
2003
+ const entries = defaultBrowser.getConsole(Boolean(params.clear));
2004
+ return { success: true, output: entries.length > 0 ? JSON.stringify(entries, null, 2) : "No console messages." };
2005
+ }
2006
+ catch (err) {
2007
+ return { success: false, output: "", error: `Console error: ${err.message}` };
2008
+ }
2009
+ }
2010
+ };
2011
+ export const browserCookiesTool = {
2012
+ definition: {
2013
+ name: "browser_cookies",
2014
+ description: "Inspect, set, or clear browser cookies.",
2015
+ parameters: {
2016
+ type: "object",
2017
+ properties: {
2018
+ action: { type: "string", description: "Cookie action.", enum: ["get", "set", "clear"] },
2019
+ name: { type: "string", description: "Cookie name (for 'set')." },
2020
+ value: { type: "string", description: "Cookie value (for 'set')." },
2021
+ url: { type: "string", description: "Optional cookie URL (for 'set')." }
2022
+ },
2023
+ required: []
2024
+ }
2025
+ },
2026
+ async execute(params) {
2027
+ try {
2028
+ const action = (params.action || "get");
2029
+ const result = await defaultBrowser.cookies(action, params.name ? { name: params.name, value: String(params.value || ""), url: params.url } : undefined);
2030
+ return { success: true, output: result };
2031
+ }
2032
+ catch (err) {
2033
+ return { success: false, output: "", error: `Cookies error: ${err.message}` };
2034
+ }
2035
+ }
2036
+ };
2037
+ export const browserEvalTool = {
2038
+ definition: {
2039
+ name: "browser_eval",
2040
+ description: "Execute JavaScript in the active browser page context and return the serialized result.",
2041
+ parameters: {
2042
+ type: "object",
2043
+ properties: {
2044
+ script: { type: "string", description: "JavaScript expression or IIFE to run in the page." }
2045
+ },
2046
+ required: ["script"]
2047
+ }
2048
+ },
2049
+ async execute(params) {
2050
+ try {
2051
+ const result = await defaultBrowser.evalJs(params.script);
2052
+ return { success: true, output: result };
2053
+ }
2054
+ catch (err) {
2055
+ return { success: false, output: "", error: `Eval error: ${err.message}` };
2056
+ }
2057
+ }
2058
+ };
2059
+ export const browserExportHarTool = {
2060
+ definition: {
2061
+ name: "browser_export_har",
2062
+ description: "Export captured live browser network traffic in HAR 1.2 JSON format (with sensitive Auth/Cookie headers redacted).",
2063
+ parameters: {
2064
+ type: "object",
2065
+ properties: {
2066
+ urlFilter: { type: "string", description: "Optional substring to filter recorded request URLs." },
2067
+ limit: { type: "number", description: "Maximum number of HAR entries to include (default 100)." }
2068
+ },
2069
+ required: []
2070
+ }
2071
+ },
2072
+ async execute(params) {
2073
+ try {
2074
+ const har = defaultBrowser.exportHar({
2075
+ urlFilter: params.urlFilter,
2076
+ limit: params.limit,
2077
+ });
2078
+ return { success: true, output: JSON.stringify(har, null, 2).slice(0, 18000) };
2079
+ }
2080
+ catch (err) {
2081
+ return { success: false, output: "", error: `HAR export error: ${err.message}` };
2082
+ }
2083
+ }
2084
+ };
2085
+ export const browserCloseTool = {
2086
+ definition: {
2087
+ name: "browser_close",
2088
+ description: "Close the active browser session and release Chromium/Edge resources.",
2089
+ parameters: {
2090
+ type: "object",
2091
+ properties: {},
2092
+ required: []
2093
+ }
2094
+ },
2095
+ async execute() {
2096
+ try {
2097
+ const result = defaultBrowser.close();
2098
+ return { success: true, output: result };
2099
+ }
2100
+ catch (err) {
2101
+ return { success: false, output: "", error: `Close error: ${err.message}` };
2102
+ }
2103
+ }
2104
+ };
2105
+ //# sourceMappingURL=browser.js.map