agent-browser 0.0.0 → 0.1.0

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 (52) hide show
  1. package/.prettierrc +7 -0
  2. package/README.md +271 -1
  3. package/bin/agent-browser +2 -0
  4. package/dist/actions.d.ts +7 -0
  5. package/dist/actions.d.ts.map +1 -0
  6. package/dist/actions.js +1138 -0
  7. package/dist/actions.js.map +1 -0
  8. package/dist/browser.d.ts +232 -0
  9. package/dist/browser.d.ts.map +1 -0
  10. package/dist/browser.js +477 -0
  11. package/dist/browser.js.map +1 -0
  12. package/dist/browser.test.d.ts +2 -0
  13. package/dist/browser.test.d.ts.map +1 -0
  14. package/dist/browser.test.js +136 -0
  15. package/dist/browser.test.js.map +1 -0
  16. package/dist/client.d.ts +17 -0
  17. package/dist/client.d.ts.map +1 -0
  18. package/dist/client.js +133 -0
  19. package/dist/client.js.map +1 -0
  20. package/dist/daemon.d.ts +29 -0
  21. package/dist/daemon.d.ts.map +1 -0
  22. package/dist/daemon.js +165 -0
  23. package/dist/daemon.js.map +1 -0
  24. package/dist/index.d.ts +3 -0
  25. package/dist/index.d.ts.map +1 -0
  26. package/dist/index.js +972 -0
  27. package/dist/index.js.map +1 -0
  28. package/dist/protocol.d.ts +26 -0
  29. package/dist/protocol.d.ts.map +1 -0
  30. package/dist/protocol.js +717 -0
  31. package/dist/protocol.js.map +1 -0
  32. package/dist/protocol.test.d.ts +2 -0
  33. package/dist/protocol.test.d.ts.map +1 -0
  34. package/dist/protocol.test.js +176 -0
  35. package/dist/protocol.test.js.map +1 -0
  36. package/dist/types.d.ts +604 -0
  37. package/dist/types.d.ts.map +1 -0
  38. package/dist/types.js +2 -0
  39. package/dist/types.js.map +1 -0
  40. package/package.json +36 -7
  41. package/src/actions.ts +1658 -0
  42. package/src/browser.test.ts +157 -0
  43. package/src/browser.ts +586 -0
  44. package/src/client.ts +150 -0
  45. package/src/daemon.ts +187 -0
  46. package/src/index.ts +984 -0
  47. package/src/protocol.test.ts +216 -0
  48. package/src/protocol.ts +848 -0
  49. package/src/types.ts +913 -0
  50. package/tsconfig.json +19 -0
  51. package/vitest.config.ts +9 -0
  52. package/index.js +0 -2
@@ -0,0 +1,1138 @@
1
+ import { successResponse, errorResponse } from './protocol.js';
2
+ /**
3
+ * Execute a command and return a response
4
+ */
5
+ export async function executeCommand(command, browser) {
6
+ try {
7
+ switch (command.action) {
8
+ case 'launch':
9
+ return await handleLaunch(command, browser);
10
+ case 'navigate':
11
+ return await handleNavigate(command, browser);
12
+ case 'click':
13
+ return await handleClick(command, browser);
14
+ case 'type':
15
+ return await handleType(command, browser);
16
+ case 'fill':
17
+ return await handleFill(command, browser);
18
+ case 'check':
19
+ return await handleCheck(command, browser);
20
+ case 'uncheck':
21
+ return await handleUncheck(command, browser);
22
+ case 'upload':
23
+ return await handleUpload(command, browser);
24
+ case 'dblclick':
25
+ return await handleDoubleClick(command, browser);
26
+ case 'focus':
27
+ return await handleFocus(command, browser);
28
+ case 'drag':
29
+ return await handleDrag(command, browser);
30
+ case 'frame':
31
+ return await handleFrame(command, browser);
32
+ case 'mainframe':
33
+ return await handleMainFrame(command, browser);
34
+ case 'getbyrole':
35
+ return await handleGetByRole(command, browser);
36
+ case 'getbytext':
37
+ return await handleGetByText(command, browser);
38
+ case 'getbylabel':
39
+ return await handleGetByLabel(command, browser);
40
+ case 'getbyplaceholder':
41
+ return await handleGetByPlaceholder(command, browser);
42
+ case 'press':
43
+ return await handlePress(command, browser);
44
+ case 'screenshot':
45
+ return await handleScreenshot(command, browser);
46
+ case 'snapshot':
47
+ return await handleSnapshot(command, browser);
48
+ case 'evaluate':
49
+ return await handleEvaluate(command, browser);
50
+ case 'wait':
51
+ return await handleWait(command, browser);
52
+ case 'scroll':
53
+ return await handleScroll(command, browser);
54
+ case 'select':
55
+ return await handleSelect(command, browser);
56
+ case 'hover':
57
+ return await handleHover(command, browser);
58
+ case 'content':
59
+ return await handleContent(command, browser);
60
+ case 'close':
61
+ return await handleClose(command, browser);
62
+ case 'tab_new':
63
+ return await handleTabNew(command, browser);
64
+ case 'tab_list':
65
+ return await handleTabList(command, browser);
66
+ case 'tab_switch':
67
+ return await handleTabSwitch(command, browser);
68
+ case 'tab_close':
69
+ return await handleTabClose(command, browser);
70
+ case 'window_new':
71
+ return await handleWindowNew(command, browser);
72
+ case 'cookies_get':
73
+ return await handleCookiesGet(command, browser);
74
+ case 'cookies_set':
75
+ return await handleCookiesSet(command, browser);
76
+ case 'cookies_clear':
77
+ return await handleCookiesClear(command, browser);
78
+ case 'storage_get':
79
+ return await handleStorageGet(command, browser);
80
+ case 'storage_set':
81
+ return await handleStorageSet(command, browser);
82
+ case 'storage_clear':
83
+ return await handleStorageClear(command, browser);
84
+ case 'dialog':
85
+ return await handleDialog(command, browser);
86
+ case 'pdf':
87
+ return await handlePdf(command, browser);
88
+ case 'route':
89
+ return await handleRoute(command, browser);
90
+ case 'unroute':
91
+ return await handleUnroute(command, browser);
92
+ case 'requests':
93
+ return await handleRequests(command, browser);
94
+ case 'download':
95
+ return await handleDownload(command, browser);
96
+ case 'geolocation':
97
+ return await handleGeolocation(command, browser);
98
+ case 'permissions':
99
+ return await handlePermissions(command, browser);
100
+ case 'viewport':
101
+ return await handleViewport(command, browser);
102
+ case 'useragent':
103
+ return await handleUserAgent(command, browser);
104
+ case 'device':
105
+ return await handleDevice(command, browser);
106
+ case 'back':
107
+ return await handleBack(command, browser);
108
+ case 'forward':
109
+ return await handleForward(command, browser);
110
+ case 'reload':
111
+ return await handleReload(command, browser);
112
+ case 'url':
113
+ return await handleUrl(command, browser);
114
+ case 'title':
115
+ return await handleTitle(command, browser);
116
+ case 'getattribute':
117
+ return await handleGetAttribute(command, browser);
118
+ case 'gettext':
119
+ return await handleGetText(command, browser);
120
+ case 'isvisible':
121
+ return await handleIsVisible(command, browser);
122
+ case 'isenabled':
123
+ return await handleIsEnabled(command, browser);
124
+ case 'ischecked':
125
+ return await handleIsChecked(command, browser);
126
+ case 'count':
127
+ return await handleCount(command, browser);
128
+ case 'boundingbox':
129
+ return await handleBoundingBox(command, browser);
130
+ case 'video_start':
131
+ return await handleVideoStart(command, browser);
132
+ case 'video_stop':
133
+ return await handleVideoStop(command, browser);
134
+ case 'trace_start':
135
+ return await handleTraceStart(command, browser);
136
+ case 'trace_stop':
137
+ return await handleTraceStop(command, browser);
138
+ case 'har_start':
139
+ return await handleHarStart(command, browser);
140
+ case 'har_stop':
141
+ return await handleHarStop(command, browser);
142
+ case 'state_save':
143
+ return await handleStateSave(command, browser);
144
+ case 'state_load':
145
+ return await handleStateLoad(command, browser);
146
+ case 'console':
147
+ return await handleConsole(command, browser);
148
+ case 'errors':
149
+ return await handleErrors(command, browser);
150
+ case 'keyboard':
151
+ return await handleKeyboard(command, browser);
152
+ case 'wheel':
153
+ return await handleWheel(command, browser);
154
+ case 'tap':
155
+ return await handleTap(command, browser);
156
+ case 'clipboard':
157
+ return await handleClipboard(command, browser);
158
+ case 'highlight':
159
+ return await handleHighlight(command, browser);
160
+ case 'clear':
161
+ return await handleClear(command, browser);
162
+ case 'selectall':
163
+ return await handleSelectAll(command, browser);
164
+ case 'innertext':
165
+ return await handleInnerText(command, browser);
166
+ case 'innerhtml':
167
+ return await handleInnerHtml(command, browser);
168
+ case 'inputvalue':
169
+ return await handleInputValue(command, browser);
170
+ case 'setvalue':
171
+ return await handleSetValue(command, browser);
172
+ case 'dispatch':
173
+ return await handleDispatch(command, browser);
174
+ case 'evalhandle':
175
+ return await handleEvalHandle(command, browser);
176
+ case 'expose':
177
+ return await handleExpose(command, browser);
178
+ case 'addscript':
179
+ return await handleAddScript(command, browser);
180
+ case 'addstyle':
181
+ return await handleAddStyle(command, browser);
182
+ case 'emulatemedia':
183
+ return await handleEmulateMedia(command, browser);
184
+ case 'offline':
185
+ return await handleOffline(command, browser);
186
+ case 'headers':
187
+ return await handleHeaders(command, browser);
188
+ case 'pause':
189
+ return await handlePause(command, browser);
190
+ case 'getbyalttext':
191
+ return await handleGetByAltText(command, browser);
192
+ case 'getbytitle':
193
+ return await handleGetByTitle(command, browser);
194
+ case 'getbytestid':
195
+ return await handleGetByTestId(command, browser);
196
+ case 'nth':
197
+ return await handleNth(command, browser);
198
+ case 'waitforurl':
199
+ return await handleWaitForUrl(command, browser);
200
+ case 'waitforloadstate':
201
+ return await handleWaitForLoadState(command, browser);
202
+ case 'setcontent':
203
+ return await handleSetContent(command, browser);
204
+ case 'timezone':
205
+ return await handleTimezone(command, browser);
206
+ case 'locale':
207
+ return await handleLocale(command, browser);
208
+ case 'credentials':
209
+ return await handleCredentials(command, browser);
210
+ case 'mousemove':
211
+ return await handleMouseMove(command, browser);
212
+ case 'mousedown':
213
+ return await handleMouseDown(command, browser);
214
+ case 'mouseup':
215
+ return await handleMouseUp(command, browser);
216
+ case 'bringtofront':
217
+ return await handleBringToFront(command, browser);
218
+ case 'waitforfunction':
219
+ return await handleWaitForFunction(command, browser);
220
+ case 'scrollintoview':
221
+ return await handleScrollIntoView(command, browser);
222
+ case 'addinitscript':
223
+ return await handleAddInitScript(command, browser);
224
+ case 'keydown':
225
+ return await handleKeyDown(command, browser);
226
+ case 'keyup':
227
+ return await handleKeyUp(command, browser);
228
+ case 'inserttext':
229
+ return await handleInsertText(command, browser);
230
+ case 'multiselect':
231
+ return await handleMultiSelect(command, browser);
232
+ case 'waitfordownload':
233
+ return await handleWaitForDownload(command, browser);
234
+ case 'responsebody':
235
+ return await handleResponseBody(command, browser);
236
+ default: {
237
+ // TypeScript narrows to never here, but we handle it for safety
238
+ const unknownCommand = command;
239
+ return errorResponse(unknownCommand.id, `Unknown action: ${unknownCommand.action}`);
240
+ }
241
+ }
242
+ }
243
+ catch (error) {
244
+ const message = error instanceof Error ? error.message : String(error);
245
+ return errorResponse(command.id, message);
246
+ }
247
+ }
248
+ async function handleLaunch(command, browser) {
249
+ await browser.launch(command);
250
+ return successResponse(command.id, { launched: true });
251
+ }
252
+ async function handleNavigate(command, browser) {
253
+ const page = browser.getPage();
254
+ await page.goto(command.url, {
255
+ waitUntil: command.waitUntil ?? 'load',
256
+ });
257
+ return successResponse(command.id, {
258
+ url: page.url(),
259
+ title: await page.title(),
260
+ });
261
+ }
262
+ async function handleClick(command, browser) {
263
+ const page = browser.getPage();
264
+ await page.click(command.selector, {
265
+ button: command.button,
266
+ clickCount: command.clickCount,
267
+ delay: command.delay,
268
+ });
269
+ return successResponse(command.id, { clicked: true });
270
+ }
271
+ async function handleType(command, browser) {
272
+ const page = browser.getPage();
273
+ if (command.clear) {
274
+ await page.fill(command.selector, '');
275
+ }
276
+ await page.type(command.selector, command.text, {
277
+ delay: command.delay,
278
+ });
279
+ return successResponse(command.id, { typed: true });
280
+ }
281
+ async function handlePress(command, browser) {
282
+ const page = browser.getPage();
283
+ if (command.selector) {
284
+ await page.press(command.selector, command.key);
285
+ }
286
+ else {
287
+ await page.keyboard.press(command.key);
288
+ }
289
+ return successResponse(command.id, { pressed: true });
290
+ }
291
+ async function handleScreenshot(command, browser) {
292
+ const page = browser.getPage();
293
+ const options = {
294
+ fullPage: command.fullPage,
295
+ type: command.format ?? 'png',
296
+ };
297
+ if (command.format === 'jpeg' && command.quality !== undefined) {
298
+ options.quality = command.quality;
299
+ }
300
+ let target = page;
301
+ if (command.selector) {
302
+ target = page.locator(command.selector);
303
+ }
304
+ if (command.path) {
305
+ await target.screenshot({ ...options, path: command.path });
306
+ return successResponse(command.id, { path: command.path });
307
+ }
308
+ else {
309
+ const buffer = await target.screenshot(options);
310
+ return successResponse(command.id, { base64: buffer.toString('base64') });
311
+ }
312
+ }
313
+ async function handleSnapshot(command, browser) {
314
+ const page = browser.getPage();
315
+ // Use ariaSnapshot which returns a string representation of the accessibility tree
316
+ const snapshot = await page.locator(':root').ariaSnapshot();
317
+ return successResponse(command.id, {
318
+ snapshot: snapshot ?? 'Empty page',
319
+ });
320
+ }
321
+ async function handleEvaluate(command, browser) {
322
+ const page = browser.getPage();
323
+ // Evaluate the script directly as a string expression
324
+ const result = await page.evaluate(command.script);
325
+ return successResponse(command.id, { result });
326
+ }
327
+ async function handleWait(command, browser) {
328
+ const page = browser.getPage();
329
+ if (command.selector) {
330
+ await page.waitForSelector(command.selector, {
331
+ state: command.state ?? 'visible',
332
+ timeout: command.timeout,
333
+ });
334
+ }
335
+ else if (command.timeout) {
336
+ await page.waitForTimeout(command.timeout);
337
+ }
338
+ else {
339
+ // Default: wait for load state
340
+ await page.waitForLoadState('load');
341
+ }
342
+ return successResponse(command.id, { waited: true });
343
+ }
344
+ async function handleScroll(command, browser) {
345
+ const page = browser.getPage();
346
+ if (command.selector) {
347
+ const element = page.locator(command.selector);
348
+ await element.scrollIntoViewIfNeeded();
349
+ if (command.x !== undefined || command.y !== undefined) {
350
+ await element.evaluate((el, { x, y }) => {
351
+ el.scrollBy(x ?? 0, y ?? 0);
352
+ }, { x: command.x, y: command.y });
353
+ }
354
+ }
355
+ else {
356
+ // Scroll the page
357
+ let deltaX = command.x ?? 0;
358
+ let deltaY = command.y ?? 0;
359
+ if (command.direction) {
360
+ const amount = command.amount ?? 100;
361
+ switch (command.direction) {
362
+ case 'up':
363
+ deltaY = -amount;
364
+ break;
365
+ case 'down':
366
+ deltaY = amount;
367
+ break;
368
+ case 'left':
369
+ deltaX = -amount;
370
+ break;
371
+ case 'right':
372
+ deltaX = amount;
373
+ break;
374
+ }
375
+ }
376
+ await page.evaluate(`window.scrollBy(${deltaX}, ${deltaY})`);
377
+ }
378
+ return successResponse(command.id, { scrolled: true });
379
+ }
380
+ async function handleSelect(command, browser) {
381
+ const page = browser.getPage();
382
+ const values = Array.isArray(command.values) ? command.values : [command.values];
383
+ await page.selectOption(command.selector, values);
384
+ return successResponse(command.id, { selected: values });
385
+ }
386
+ async function handleHover(command, browser) {
387
+ const page = browser.getPage();
388
+ await page.hover(command.selector);
389
+ return successResponse(command.id, { hovered: true });
390
+ }
391
+ async function handleContent(command, browser) {
392
+ const page = browser.getPage();
393
+ let html;
394
+ if (command.selector) {
395
+ html = await page.locator(command.selector).innerHTML();
396
+ }
397
+ else {
398
+ html = await page.content();
399
+ }
400
+ return successResponse(command.id, { html });
401
+ }
402
+ async function handleClose(command, browser) {
403
+ await browser.close();
404
+ return successResponse(command.id, { closed: true });
405
+ }
406
+ async function handleTabNew(command, browser) {
407
+ const result = await browser.newTab();
408
+ return successResponse(command.id, result);
409
+ }
410
+ async function handleTabList(command, browser) {
411
+ const tabs = await browser.listTabs();
412
+ return successResponse(command.id, {
413
+ tabs,
414
+ active: browser.getActiveIndex(),
415
+ });
416
+ }
417
+ async function handleTabSwitch(command, browser) {
418
+ const result = browser.switchTo(command.index);
419
+ const page = browser.getPage();
420
+ return successResponse(command.id, {
421
+ ...result,
422
+ title: await page.title(),
423
+ });
424
+ }
425
+ async function handleTabClose(command, browser) {
426
+ const result = await browser.closeTab(command.index);
427
+ return successResponse(command.id, result);
428
+ }
429
+ async function handleWindowNew(command, browser) {
430
+ const result = await browser.newWindow(command.viewport);
431
+ return successResponse(command.id, result);
432
+ }
433
+ // New handlers for enhanced Playwright parity
434
+ async function handleFill(command, browser) {
435
+ const frame = browser.getFrame();
436
+ await frame.fill(command.selector, command.value);
437
+ return successResponse(command.id, { filled: true });
438
+ }
439
+ async function handleCheck(command, browser) {
440
+ const frame = browser.getFrame();
441
+ await frame.check(command.selector);
442
+ return successResponse(command.id, { checked: true });
443
+ }
444
+ async function handleUncheck(command, browser) {
445
+ const frame = browser.getFrame();
446
+ await frame.uncheck(command.selector);
447
+ return successResponse(command.id, { unchecked: true });
448
+ }
449
+ async function handleUpload(command, browser) {
450
+ const frame = browser.getFrame();
451
+ const files = Array.isArray(command.files) ? command.files : [command.files];
452
+ await frame.setInputFiles(command.selector, files);
453
+ return successResponse(command.id, { uploaded: files });
454
+ }
455
+ async function handleDoubleClick(command, browser) {
456
+ const frame = browser.getFrame();
457
+ await frame.dblclick(command.selector);
458
+ return successResponse(command.id, { clicked: true });
459
+ }
460
+ async function handleFocus(command, browser) {
461
+ const frame = browser.getFrame();
462
+ await frame.focus(command.selector);
463
+ return successResponse(command.id, { focused: true });
464
+ }
465
+ async function handleDrag(command, browser) {
466
+ const frame = browser.getFrame();
467
+ await frame.dragAndDrop(command.source, command.target);
468
+ return successResponse(command.id, { dragged: true });
469
+ }
470
+ async function handleFrame(command, browser) {
471
+ await browser.switchToFrame({
472
+ selector: command.selector,
473
+ name: command.name,
474
+ url: command.url,
475
+ });
476
+ return successResponse(command.id, { switched: true });
477
+ }
478
+ async function handleMainFrame(command, browser) {
479
+ browser.switchToMainFrame();
480
+ return successResponse(command.id, { switched: true });
481
+ }
482
+ async function handleGetByRole(command, browser) {
483
+ const page = browser.getPage();
484
+ const locator = page.getByRole(command.role, { name: command.name });
485
+ switch (command.subaction) {
486
+ case 'click':
487
+ await locator.click();
488
+ return successResponse(command.id, { clicked: true });
489
+ case 'fill':
490
+ await locator.fill(command.value ?? '');
491
+ return successResponse(command.id, { filled: true });
492
+ case 'check':
493
+ await locator.check();
494
+ return successResponse(command.id, { checked: true });
495
+ case 'hover':
496
+ await locator.hover();
497
+ return successResponse(command.id, { hovered: true });
498
+ }
499
+ }
500
+ async function handleGetByText(command, browser) {
501
+ const page = browser.getPage();
502
+ const locator = page.getByText(command.text, { exact: command.exact });
503
+ switch (command.subaction) {
504
+ case 'click':
505
+ await locator.click();
506
+ return successResponse(command.id, { clicked: true });
507
+ case 'hover':
508
+ await locator.hover();
509
+ return successResponse(command.id, { hovered: true });
510
+ }
511
+ }
512
+ async function handleGetByLabel(command, browser) {
513
+ const page = browser.getPage();
514
+ const locator = page.getByLabel(command.label);
515
+ switch (command.subaction) {
516
+ case 'click':
517
+ await locator.click();
518
+ return successResponse(command.id, { clicked: true });
519
+ case 'fill':
520
+ await locator.fill(command.value ?? '');
521
+ return successResponse(command.id, { filled: true });
522
+ case 'check':
523
+ await locator.check();
524
+ return successResponse(command.id, { checked: true });
525
+ }
526
+ }
527
+ async function handleGetByPlaceholder(command, browser) {
528
+ const page = browser.getPage();
529
+ const locator = page.getByPlaceholder(command.placeholder);
530
+ switch (command.subaction) {
531
+ case 'click':
532
+ await locator.click();
533
+ return successResponse(command.id, { clicked: true });
534
+ case 'fill':
535
+ await locator.fill(command.value ?? '');
536
+ return successResponse(command.id, { filled: true });
537
+ }
538
+ }
539
+ async function handleCookiesGet(command, browser) {
540
+ const page = browser.getPage();
541
+ const context = page.context();
542
+ const cookies = await context.cookies(command.urls);
543
+ return successResponse(command.id, { cookies });
544
+ }
545
+ async function handleCookiesSet(command, browser) {
546
+ const page = browser.getPage();
547
+ const context = page.context();
548
+ await context.addCookies(command.cookies);
549
+ return successResponse(command.id, { set: true });
550
+ }
551
+ async function handleCookiesClear(command, browser) {
552
+ const page = browser.getPage();
553
+ const context = page.context();
554
+ await context.clearCookies();
555
+ return successResponse(command.id, { cleared: true });
556
+ }
557
+ async function handleStorageGet(command, browser) {
558
+ const page = browser.getPage();
559
+ const storageType = command.type === 'local' ? 'localStorage' : 'sessionStorage';
560
+ if (command.key) {
561
+ const value = await page.evaluate(`${storageType}.getItem(${JSON.stringify(command.key)})`);
562
+ return successResponse(command.id, { key: command.key, value });
563
+ }
564
+ else {
565
+ const data = await page.evaluate(`
566
+ (() => {
567
+ const storage = ${storageType};
568
+ const result = {};
569
+ for (let i = 0; i < storage.length; i++) {
570
+ const key = storage.key(i);
571
+ if (key) result[key] = storage.getItem(key);
572
+ }
573
+ return result;
574
+ })()
575
+ `);
576
+ return successResponse(command.id, { data });
577
+ }
578
+ }
579
+ async function handleStorageSet(command, browser) {
580
+ const page = browser.getPage();
581
+ const storageType = command.type === 'local' ? 'localStorage' : 'sessionStorage';
582
+ await page.evaluate(`${storageType}.setItem(${JSON.stringify(command.key)}, ${JSON.stringify(command.value)})`);
583
+ return successResponse(command.id, { set: true });
584
+ }
585
+ async function handleStorageClear(command, browser) {
586
+ const page = browser.getPage();
587
+ const storageType = command.type === 'local' ? 'localStorage' : 'sessionStorage';
588
+ await page.evaluate(`${storageType}.clear()`);
589
+ return successResponse(command.id, { cleared: true });
590
+ }
591
+ async function handleDialog(command, browser) {
592
+ browser.setDialogHandler(command.response, command.promptText);
593
+ return successResponse(command.id, { handler: 'set', response: command.response });
594
+ }
595
+ async function handlePdf(command, browser) {
596
+ const page = browser.getPage();
597
+ await page.pdf({
598
+ path: command.path,
599
+ format: command.format ?? 'Letter',
600
+ });
601
+ return successResponse(command.id, { path: command.path });
602
+ }
603
+ // Network & Request handlers
604
+ async function handleRoute(command, browser) {
605
+ await browser.addRoute(command.url, {
606
+ response: command.response,
607
+ abort: command.abort,
608
+ });
609
+ return successResponse(command.id, { routed: command.url });
610
+ }
611
+ async function handleUnroute(command, browser) {
612
+ await browser.removeRoute(command.url);
613
+ return successResponse(command.id, { unrouted: command.url ?? 'all' });
614
+ }
615
+ async function handleRequests(command, browser) {
616
+ if (command.clear) {
617
+ browser.clearRequests();
618
+ return successResponse(command.id, { cleared: true });
619
+ }
620
+ // Start tracking if not already
621
+ browser.startRequestTracking();
622
+ const requests = browser.getRequests(command.filter);
623
+ return successResponse(command.id, { requests });
624
+ }
625
+ async function handleDownload(command, browser) {
626
+ const page = browser.getPage();
627
+ const [download] = await Promise.all([
628
+ page.waitForEvent('download'),
629
+ page.click(command.selector),
630
+ ]);
631
+ await download.saveAs(command.path);
632
+ return successResponse(command.id, {
633
+ path: command.path,
634
+ suggestedFilename: download.suggestedFilename(),
635
+ });
636
+ }
637
+ async function handleGeolocation(command, browser) {
638
+ await browser.setGeolocation(command.latitude, command.longitude, command.accuracy);
639
+ return successResponse(command.id, {
640
+ latitude: command.latitude,
641
+ longitude: command.longitude,
642
+ });
643
+ }
644
+ async function handlePermissions(command, browser) {
645
+ await browser.setPermissions(command.permissions, command.grant);
646
+ return successResponse(command.id, {
647
+ permissions: command.permissions,
648
+ granted: command.grant,
649
+ });
650
+ }
651
+ async function handleViewport(command, browser) {
652
+ await browser.setViewport(command.width, command.height);
653
+ return successResponse(command.id, {
654
+ width: command.width,
655
+ height: command.height,
656
+ });
657
+ }
658
+ async function handleUserAgent(command, browser) {
659
+ const page = browser.getPage();
660
+ const context = page.context();
661
+ // Note: Can't change user agent after context is created, but we can for new pages
662
+ return successResponse(command.id, {
663
+ note: 'User agent can only be set at launch time. Use device command instead.',
664
+ });
665
+ }
666
+ async function handleDevice(command, browser) {
667
+ const device = browser.getDevice(command.device);
668
+ if (!device) {
669
+ const available = browser.listDevices().slice(0, 10).join(', ');
670
+ throw new Error(`Unknown device: ${command.device}. Available: ${available}...`);
671
+ }
672
+ // Apply device viewport
673
+ await browser.setViewport(device.viewport.width, device.viewport.height);
674
+ return successResponse(command.id, {
675
+ device: command.device,
676
+ viewport: device.viewport,
677
+ userAgent: device.userAgent,
678
+ });
679
+ }
680
+ async function handleBack(command, browser) {
681
+ const page = browser.getPage();
682
+ await page.goBack();
683
+ return successResponse(command.id, { url: page.url() });
684
+ }
685
+ async function handleForward(command, browser) {
686
+ const page = browser.getPage();
687
+ await page.goForward();
688
+ return successResponse(command.id, { url: page.url() });
689
+ }
690
+ async function handleReload(command, browser) {
691
+ const page = browser.getPage();
692
+ await page.reload();
693
+ return successResponse(command.id, { url: page.url() });
694
+ }
695
+ async function handleUrl(command, browser) {
696
+ const page = browser.getPage();
697
+ return successResponse(command.id, { url: page.url() });
698
+ }
699
+ async function handleTitle(command, browser) {
700
+ const page = browser.getPage();
701
+ const title = await page.title();
702
+ return successResponse(command.id, { title });
703
+ }
704
+ async function handleGetAttribute(command, browser) {
705
+ const page = browser.getPage();
706
+ const value = await page.getAttribute(command.selector, command.attribute);
707
+ return successResponse(command.id, { attribute: command.attribute, value });
708
+ }
709
+ async function handleGetText(command, browser) {
710
+ const page = browser.getPage();
711
+ const text = await page.textContent(command.selector);
712
+ return successResponse(command.id, { text });
713
+ }
714
+ async function handleIsVisible(command, browser) {
715
+ const page = browser.getPage();
716
+ const visible = await page.isVisible(command.selector);
717
+ return successResponse(command.id, { visible });
718
+ }
719
+ async function handleIsEnabled(command, browser) {
720
+ const page = browser.getPage();
721
+ const enabled = await page.isEnabled(command.selector);
722
+ return successResponse(command.id, { enabled });
723
+ }
724
+ async function handleIsChecked(command, browser) {
725
+ const page = browser.getPage();
726
+ const checked = await page.isChecked(command.selector);
727
+ return successResponse(command.id, { checked });
728
+ }
729
+ async function handleCount(command, browser) {
730
+ const page = browser.getPage();
731
+ const count = await page.locator(command.selector).count();
732
+ return successResponse(command.id, { count });
733
+ }
734
+ async function handleBoundingBox(command, browser) {
735
+ const page = browser.getPage();
736
+ const box = await page.locator(command.selector).boundingBox();
737
+ return successResponse(command.id, { box });
738
+ }
739
+ // Advanced handlers
740
+ async function handleVideoStart(command, browser) {
741
+ // Video recording requires context-level setup at launch
742
+ // For now, return a note about this limitation
743
+ return successResponse(command.id, {
744
+ note: 'Video recording must be enabled at browser launch. Use --video flag when starting.',
745
+ path: command.path,
746
+ });
747
+ }
748
+ async function handleVideoStop(command, browser) {
749
+ const page = browser.getPage();
750
+ const video = page.video();
751
+ if (video) {
752
+ const path = await video.path();
753
+ return successResponse(command.id, { path });
754
+ }
755
+ return successResponse(command.id, { note: 'No video recording active' });
756
+ }
757
+ async function handleTraceStart(command, browser) {
758
+ await browser.startTracing({
759
+ screenshots: command.screenshots,
760
+ snapshots: command.snapshots,
761
+ });
762
+ return successResponse(command.id, { started: true });
763
+ }
764
+ async function handleTraceStop(command, browser) {
765
+ await browser.stopTracing(command.path);
766
+ return successResponse(command.id, { path: command.path });
767
+ }
768
+ async function handleHarStart(command, browser) {
769
+ await browser.startHarRecording();
770
+ browser.startRequestTracking();
771
+ return successResponse(command.id, { started: true });
772
+ }
773
+ async function handleHarStop(command, browser) {
774
+ // HAR recording is handled at context level
775
+ // For now, we save tracked requests as a simplified HAR-like format
776
+ const requests = browser.getRequests();
777
+ return successResponse(command.id, {
778
+ path: command.path,
779
+ requestCount: requests.length,
780
+ });
781
+ }
782
+ async function handleStateSave(command, browser) {
783
+ await browser.saveStorageState(command.path);
784
+ return successResponse(command.id, { path: command.path });
785
+ }
786
+ async function handleStateLoad(command, browser) {
787
+ // Storage state is loaded at context creation
788
+ return successResponse(command.id, {
789
+ note: 'Storage state must be loaded at browser launch. Use --state flag.',
790
+ path: command.path,
791
+ });
792
+ }
793
+ async function handleConsole(command, browser) {
794
+ if (command.clear) {
795
+ browser.clearConsoleMessages();
796
+ return successResponse(command.id, { cleared: true });
797
+ }
798
+ browser.startConsoleTracking();
799
+ const messages = browser.getConsoleMessages();
800
+ return successResponse(command.id, { messages });
801
+ }
802
+ async function handleErrors(command, browser) {
803
+ if (command.clear) {
804
+ browser.clearPageErrors();
805
+ return successResponse(command.id, { cleared: true });
806
+ }
807
+ browser.startErrorTracking();
808
+ const errors = browser.getPageErrors();
809
+ return successResponse(command.id, { errors });
810
+ }
811
+ async function handleKeyboard(command, browser) {
812
+ const page = browser.getPage();
813
+ await page.keyboard.press(command.keys);
814
+ return successResponse(command.id, { pressed: command.keys });
815
+ }
816
+ async function handleWheel(command, browser) {
817
+ const page = browser.getPage();
818
+ if (command.selector) {
819
+ const element = page.locator(command.selector);
820
+ await element.hover();
821
+ }
822
+ await page.mouse.wheel(command.deltaX ?? 0, command.deltaY ?? 0);
823
+ return successResponse(command.id, { scrolled: true });
824
+ }
825
+ async function handleTap(command, browser) {
826
+ const page = browser.getPage();
827
+ await page.tap(command.selector);
828
+ return successResponse(command.id, { tapped: true });
829
+ }
830
+ async function handleClipboard(command, browser) {
831
+ const page = browser.getPage();
832
+ switch (command.operation) {
833
+ case 'copy':
834
+ await page.keyboard.press('Control+c');
835
+ return successResponse(command.id, { copied: true });
836
+ case 'paste':
837
+ await page.keyboard.press('Control+v');
838
+ return successResponse(command.id, { pasted: true });
839
+ case 'read':
840
+ const text = await page.evaluate('navigator.clipboard.readText()');
841
+ return successResponse(command.id, { text });
842
+ default:
843
+ return errorResponse(command.id, 'Unknown clipboard operation');
844
+ }
845
+ }
846
+ async function handleHighlight(command, browser) {
847
+ const page = browser.getPage();
848
+ await page.locator(command.selector).highlight();
849
+ return successResponse(command.id, { highlighted: true });
850
+ }
851
+ async function handleClear(command, browser) {
852
+ const page = browser.getPage();
853
+ await page.locator(command.selector).clear();
854
+ return successResponse(command.id, { cleared: true });
855
+ }
856
+ async function handleSelectAll(command, browser) {
857
+ const page = browser.getPage();
858
+ await page.locator(command.selector).selectText();
859
+ return successResponse(command.id, { selected: true });
860
+ }
861
+ async function handleInnerText(command, browser) {
862
+ const page = browser.getPage();
863
+ const text = await page.locator(command.selector).innerText();
864
+ return successResponse(command.id, { text });
865
+ }
866
+ async function handleInnerHtml(command, browser) {
867
+ const page = browser.getPage();
868
+ const html = await page.locator(command.selector).innerHTML();
869
+ return successResponse(command.id, { html });
870
+ }
871
+ async function handleInputValue(command, browser) {
872
+ const page = browser.getPage();
873
+ const value = await page.locator(command.selector).inputValue();
874
+ return successResponse(command.id, { value });
875
+ }
876
+ async function handleSetValue(command, browser) {
877
+ const page = browser.getPage();
878
+ await page.locator(command.selector).fill(command.value);
879
+ return successResponse(command.id, { set: true });
880
+ }
881
+ async function handleDispatch(command, browser) {
882
+ const page = browser.getPage();
883
+ await page.locator(command.selector).dispatchEvent(command.event, command.eventInit);
884
+ return successResponse(command.id, { dispatched: command.event });
885
+ }
886
+ async function handleEvalHandle(command, browser) {
887
+ const page = browser.getPage();
888
+ const handle = await page.evaluateHandle(command.script);
889
+ const result = await handle.jsonValue().catch(() => 'Handle (non-serializable)');
890
+ return successResponse(command.id, { result });
891
+ }
892
+ async function handleExpose(command, browser) {
893
+ const page = browser.getPage();
894
+ await page.exposeFunction(command.name, () => {
895
+ // Exposed function - can be extended
896
+ return `Function ${command.name} called`;
897
+ });
898
+ return successResponse(command.id, { exposed: command.name });
899
+ }
900
+ async function handleAddScript(command, browser) {
901
+ const page = browser.getPage();
902
+ if (command.content) {
903
+ await page.addScriptTag({ content: command.content });
904
+ }
905
+ else if (command.url) {
906
+ await page.addScriptTag({ url: command.url });
907
+ }
908
+ return successResponse(command.id, { added: true });
909
+ }
910
+ async function handleAddStyle(command, browser) {
911
+ const page = browser.getPage();
912
+ if (command.content) {
913
+ await page.addStyleTag({ content: command.content });
914
+ }
915
+ else if (command.url) {
916
+ await page.addStyleTag({ url: command.url });
917
+ }
918
+ return successResponse(command.id, { added: true });
919
+ }
920
+ async function handleEmulateMedia(command, browser) {
921
+ const page = browser.getPage();
922
+ await page.emulateMedia({
923
+ media: command.media,
924
+ colorScheme: command.colorScheme,
925
+ reducedMotion: command.reducedMotion,
926
+ forcedColors: command.forcedColors,
927
+ });
928
+ return successResponse(command.id, { emulated: true });
929
+ }
930
+ async function handleOffline(command, browser) {
931
+ await browser.setOffline(command.offline);
932
+ return successResponse(command.id, { offline: command.offline });
933
+ }
934
+ async function handleHeaders(command, browser) {
935
+ await browser.setExtraHeaders(command.headers);
936
+ return successResponse(command.id, { set: true });
937
+ }
938
+ async function handlePause(command, browser) {
939
+ const page = browser.getPage();
940
+ await page.pause();
941
+ return successResponse(command.id, { paused: true });
942
+ }
943
+ async function handleGetByAltText(command, browser) {
944
+ const page = browser.getPage();
945
+ const locator = page.getByAltText(command.text, { exact: command.exact });
946
+ switch (command.subaction) {
947
+ case 'click':
948
+ await locator.click();
949
+ return successResponse(command.id, { clicked: true });
950
+ case 'hover':
951
+ await locator.hover();
952
+ return successResponse(command.id, { hovered: true });
953
+ }
954
+ }
955
+ async function handleGetByTitle(command, browser) {
956
+ const page = browser.getPage();
957
+ const locator = page.getByTitle(command.text, { exact: command.exact });
958
+ switch (command.subaction) {
959
+ case 'click':
960
+ await locator.click();
961
+ return successResponse(command.id, { clicked: true });
962
+ case 'hover':
963
+ await locator.hover();
964
+ return successResponse(command.id, { hovered: true });
965
+ }
966
+ }
967
+ async function handleGetByTestId(command, browser) {
968
+ const page = browser.getPage();
969
+ const locator = page.getByTestId(command.testId);
970
+ switch (command.subaction) {
971
+ case 'click':
972
+ await locator.click();
973
+ return successResponse(command.id, { clicked: true });
974
+ case 'fill':
975
+ await locator.fill(command.value ?? '');
976
+ return successResponse(command.id, { filled: true });
977
+ case 'check':
978
+ await locator.check();
979
+ return successResponse(command.id, { checked: true });
980
+ case 'hover':
981
+ await locator.hover();
982
+ return successResponse(command.id, { hovered: true });
983
+ }
984
+ }
985
+ async function handleNth(command, browser) {
986
+ const page = browser.getPage();
987
+ const base = page.locator(command.selector);
988
+ const locator = command.index === -1 ? base.last() : base.nth(command.index);
989
+ switch (command.subaction) {
990
+ case 'click':
991
+ await locator.click();
992
+ return successResponse(command.id, { clicked: true });
993
+ case 'fill':
994
+ await locator.fill(command.value ?? '');
995
+ return successResponse(command.id, { filled: true });
996
+ case 'check':
997
+ await locator.check();
998
+ return successResponse(command.id, { checked: true });
999
+ case 'hover':
1000
+ await locator.hover();
1001
+ return successResponse(command.id, { hovered: true });
1002
+ case 'text':
1003
+ const text = await locator.textContent();
1004
+ return successResponse(command.id, { text });
1005
+ }
1006
+ }
1007
+ async function handleWaitForUrl(command, browser) {
1008
+ const page = browser.getPage();
1009
+ await page.waitForURL(command.url, { timeout: command.timeout });
1010
+ return successResponse(command.id, { url: page.url() });
1011
+ }
1012
+ async function handleWaitForLoadState(command, browser) {
1013
+ const page = browser.getPage();
1014
+ await page.waitForLoadState(command.state, { timeout: command.timeout });
1015
+ return successResponse(command.id, { state: command.state });
1016
+ }
1017
+ async function handleSetContent(command, browser) {
1018
+ const page = browser.getPage();
1019
+ await page.setContent(command.html);
1020
+ return successResponse(command.id, { set: true });
1021
+ }
1022
+ async function handleTimezone(command, browser) {
1023
+ // Timezone must be set at context level before navigation
1024
+ // This is a limitation - it sets for the current context
1025
+ const page = browser.getPage();
1026
+ await page.context().setGeolocation({ latitude: 0, longitude: 0 }); // Trigger context awareness
1027
+ return successResponse(command.id, {
1028
+ note: 'Timezone must be set at browser launch. Use --timezone flag.',
1029
+ timezone: command.timezone,
1030
+ });
1031
+ }
1032
+ async function handleLocale(command, browser) {
1033
+ // Locale must be set at context creation
1034
+ return successResponse(command.id, {
1035
+ note: 'Locale must be set at browser launch. Use --locale flag.',
1036
+ locale: command.locale,
1037
+ });
1038
+ }
1039
+ async function handleCredentials(command, browser) {
1040
+ const context = browser.getPage().context();
1041
+ await context.setHTTPCredentials({
1042
+ username: command.username,
1043
+ password: command.password,
1044
+ });
1045
+ return successResponse(command.id, { set: true });
1046
+ }
1047
+ async function handleMouseMove(command, browser) {
1048
+ const page = browser.getPage();
1049
+ await page.mouse.move(command.x, command.y);
1050
+ return successResponse(command.id, { moved: true, x: command.x, y: command.y });
1051
+ }
1052
+ async function handleMouseDown(command, browser) {
1053
+ const page = browser.getPage();
1054
+ await page.mouse.down({ button: command.button ?? 'left' });
1055
+ return successResponse(command.id, { down: true });
1056
+ }
1057
+ async function handleMouseUp(command, browser) {
1058
+ const page = browser.getPage();
1059
+ await page.mouse.up({ button: command.button ?? 'left' });
1060
+ return successResponse(command.id, { up: true });
1061
+ }
1062
+ async function handleBringToFront(command, browser) {
1063
+ const page = browser.getPage();
1064
+ await page.bringToFront();
1065
+ return successResponse(command.id, { focused: true });
1066
+ }
1067
+ async function handleWaitForFunction(command, browser) {
1068
+ const page = browser.getPage();
1069
+ await page.waitForFunction(command.expression, { timeout: command.timeout });
1070
+ return successResponse(command.id, { waited: true });
1071
+ }
1072
+ async function handleScrollIntoView(command, browser) {
1073
+ const page = browser.getPage();
1074
+ await page.locator(command.selector).scrollIntoViewIfNeeded();
1075
+ return successResponse(command.id, { scrolled: true });
1076
+ }
1077
+ async function handleAddInitScript(command, browser) {
1078
+ const context = browser.getPage().context();
1079
+ await context.addInitScript(command.script);
1080
+ return successResponse(command.id, { added: true });
1081
+ }
1082
+ async function handleKeyDown(command, browser) {
1083
+ const page = browser.getPage();
1084
+ await page.keyboard.down(command.key);
1085
+ return successResponse(command.id, { down: true, key: command.key });
1086
+ }
1087
+ async function handleKeyUp(command, browser) {
1088
+ const page = browser.getPage();
1089
+ await page.keyboard.up(command.key);
1090
+ return successResponse(command.id, { up: true, key: command.key });
1091
+ }
1092
+ async function handleInsertText(command, browser) {
1093
+ const page = browser.getPage();
1094
+ await page.keyboard.insertText(command.text);
1095
+ return successResponse(command.id, { inserted: true });
1096
+ }
1097
+ async function handleMultiSelect(command, browser) {
1098
+ const page = browser.getPage();
1099
+ const selected = await page.locator(command.selector).selectOption(command.values);
1100
+ return successResponse(command.id, { selected });
1101
+ }
1102
+ async function handleWaitForDownload(command, browser) {
1103
+ const page = browser.getPage();
1104
+ const download = await page.waitForEvent('download', { timeout: command.timeout });
1105
+ let filePath;
1106
+ if (command.path) {
1107
+ filePath = command.path;
1108
+ await download.saveAs(filePath);
1109
+ }
1110
+ else {
1111
+ filePath = (await download.path()) || download.suggestedFilename();
1112
+ }
1113
+ return successResponse(command.id, {
1114
+ path: filePath,
1115
+ filename: download.suggestedFilename(),
1116
+ url: download.url(),
1117
+ });
1118
+ }
1119
+ async function handleResponseBody(command, browser) {
1120
+ const page = browser.getPage();
1121
+ const response = await page.waitForResponse((resp) => resp.url().includes(command.url), {
1122
+ timeout: command.timeout,
1123
+ });
1124
+ const body = await response.text();
1125
+ let parsed = body;
1126
+ try {
1127
+ parsed = JSON.parse(body);
1128
+ }
1129
+ catch {
1130
+ // Keep as string if not JSON
1131
+ }
1132
+ return successResponse(command.id, {
1133
+ url: response.url(),
1134
+ status: response.status(),
1135
+ body: parsed,
1136
+ });
1137
+ }
1138
+ //# sourceMappingURL=actions.js.map