@nexum-hub/browser 0.0.0-stage → 0.0.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (100) hide show
  1. package/README.md +22 -2
  2. package/browser-extension/assets.js +654 -0
  3. package/browser-extension/build.mjs +111 -0
  4. package/browser-extension/clipboard.js +397 -0
  5. package/browser-extension/connection.js +880 -0
  6. package/browser-extension/dist/development/assets.js +654 -0
  7. package/browser-extension/dist/development/clipboard.js +397 -0
  8. package/browser-extension/dist/development/connection.js +880 -0
  9. package/browser-extension/dist/development/errors.js +106 -0
  10. package/browser-extension/dist/development/evaluate.js +160 -0
  11. package/browser-extension/dist/development/frames.js +256 -0
  12. package/browser-extension/dist/development/keyboard.js +167 -0
  13. package/browser-extension/dist/development/manifest.json +35 -0
  14. package/browser-extension/dist/development/native-node.js +85 -0
  15. package/browser-extension/dist/development/page-data.js +497 -0
  16. package/browser-extension/dist/development/page.js +772 -0
  17. package/browser-extension/dist/development/profile.js +2 -0
  18. package/browser-extension/dist/development/router.js +5961 -0
  19. package/browser-extension/dist/development/site-source.js +149 -0
  20. package/browser-extension/dist/development/transport.js +405 -0
  21. package/browser-extension/dist/development/visual.js +976 -0
  22. package/browser-extension/dist/development/worker.js +24 -0
  23. package/browser-extension/dist/production/assets.js +654 -0
  24. package/browser-extension/dist/production/clipboard.js +397 -0
  25. package/browser-extension/dist/production/connection.js +880 -0
  26. package/browser-extension/dist/production/errors.js +106 -0
  27. package/browser-extension/dist/production/evaluate.js +160 -0
  28. package/browser-extension/dist/production/frames.js +256 -0
  29. package/browser-extension/dist/production/keyboard.js +167 -0
  30. package/browser-extension/dist/production/manifest.json +35 -0
  31. package/browser-extension/dist/production/native-node.js +85 -0
  32. package/browser-extension/dist/production/page-data.js +497 -0
  33. package/browser-extension/dist/production/page.js +772 -0
  34. package/browser-extension/dist/production/profile.js +2 -0
  35. package/browser-extension/dist/production/router.js +5961 -0
  36. package/browser-extension/dist/production/site-source.js +149 -0
  37. package/browser-extension/dist/production/transport.js +405 -0
  38. package/browser-extension/dist/production/visual.js +976 -0
  39. package/browser-extension/dist/production/worker.js +24 -0
  40. package/browser-extension/errors.js +106 -0
  41. package/browser-extension/evaluate.js +160 -0
  42. package/browser-extension/frames.js +256 -0
  43. package/browser-extension/keyboard.js +167 -0
  44. package/browser-extension/native-node.js +85 -0
  45. package/browser-extension/page-data.js +497 -0
  46. package/browser-extension/page.js +772 -0
  47. package/browser-extension/release-info.json +21 -0
  48. package/browser-extension/route-manifest.json +807 -0
  49. package/browser-extension/router.js +5961 -0
  50. package/browser-extension/site-source.js +149 -0
  51. package/browser-extension/transport.js +405 -0
  52. package/browser-extension/visual.js +976 -0
  53. package/browser-extension/worker.js +24 -0
  54. package/dist/client/index.d.ts +6 -0
  55. package/dist/client/index.js +894 -0
  56. package/dist/client/index.js.map +1 -0
  57. package/dist/client/routes.d.ts +6 -0
  58. package/dist/client/routes.js +777 -0
  59. package/dist/client/routes.js.map +1 -0
  60. package/dist/client/serialize.d.ts +16 -0
  61. package/dist/client/serialize.js +355 -0
  62. package/dist/client/serialize.js.map +1 -0
  63. package/dist/client/types.d.ts +1342 -0
  64. package/dist/client/types.js +2 -0
  65. package/dist/client/types.js.map +1 -0
  66. package/dist/extension/artifacts.d.ts +60 -0
  67. package/dist/extension/artifacts.js +493 -0
  68. package/dist/extension/artifacts.js.map +1 -0
  69. package/dist/extension/assets.d.ts +10 -0
  70. package/dist/extension/assets.js +90 -0
  71. package/dist/extension/assets.js.map +1 -0
  72. package/dist/extension/batch.d.ts +6 -0
  73. package/dist/extension/batch.js +138 -0
  74. package/dist/extension/batch.js.map +1 -0
  75. package/dist/extension/files.d.ts +16 -0
  76. package/dist/extension/files.js +594 -0
  77. package/dist/extension/files.js.map +1 -0
  78. package/dist/extension/index.d.ts +3 -0
  79. package/dist/extension/index.js +623 -0
  80. package/dist/extension/index.js.map +1 -0
  81. package/dist/extension/protocol.d.ts +81 -0
  82. package/dist/extension/protocol.js +475 -0
  83. package/dist/extension/protocol.js.map +1 -0
  84. package/dist/extension/scope.d.ts +55 -0
  85. package/dist/extension/scope.js +563 -0
  86. package/dist/extension/scope.js.map +1 -0
  87. package/dist/extension/service.d.ts +113 -0
  88. package/dist/extension/service.js +905 -0
  89. package/dist/extension/service.js.map +1 -0
  90. package/docs/README.md +10 -0
  91. package/docs/api.md +1375 -0
  92. package/docs/connection.md +9 -0
  93. package/docs/lifecycle.md +17 -0
  94. package/docs/usage.md +75 -0
  95. package/implementation.json +2962 -0
  96. package/instructions/README.md +8 -0
  97. package/package.json +80 -4
  98. package/scripts/discover.js +12 -0
  99. package/scripts/screenshot.js +9 -0
  100. package/skills/browser-control/SKILL.md +12 -0
@@ -0,0 +1,1342 @@
1
+ /** Public browser SDK data and facade contracts. Runtime control objects never cross managed calls. */
2
+ import type { OutputIntent } from "@nexum-hub/sdk";
3
+ export type { OutputIntent } from "@nexum-hub/sdk";
4
+ export type BrowserCapabilityCollection = {
5
+ get(id: "management"): Promise<ManagementCapability>;
6
+ get(id: "visibility"): Promise<VisibilityCapability>;
7
+ get(id: "viewport"): Promise<ViewportCapability>;
8
+ get(id: string): Promise<CapabilityInfo>;
9
+ list(): Promise<CapabilityInfo[]>;
10
+ };
11
+ export interface BrowserHistoryOptions {
12
+ from?: string | Date;
13
+ limit?: number;
14
+ queries?: Array<string>;
15
+ to?: string | Date;
16
+ }
17
+ export interface BrowserHistoryEntry {
18
+ dateVisited: string;
19
+ title?: string;
20
+ url: string;
21
+ }
22
+ /** A native download from the selected browser profile; filename is its local path. */
23
+ export interface BrowserDownloadRecord {
24
+ id: number;
25
+ filename: string;
26
+ state: "in_progress" | "interrupted" | "complete";
27
+ startTime: string;
28
+ endTime?: string;
29
+ fileSize: number;
30
+ totalBytes: number;
31
+ bytesReceived: number;
32
+ mime: string;
33
+ exists: boolean;
34
+ }
35
+ export interface BrowserUserTabInfo {
36
+ id: string;
37
+ lastOpened?: string;
38
+ providerTabId?: string;
39
+ tabGroup?: string;
40
+ title?: string;
41
+ url?: string;
42
+ }
43
+ export type BrowserUserTabContext = {
44
+ kind: "artifact";
45
+ artifact: BrowserArtifact;
46
+ title: string;
47
+ url: string;
48
+ } | {
49
+ kind: "text";
50
+ text: string;
51
+ title: string;
52
+ truncated: boolean;
53
+ artifact?: BrowserArtifact;
54
+ url: string;
55
+ } | {
56
+ kind: "document";
57
+ data: Uint8Array;
58
+ fileName: string;
59
+ mimeType: string;
60
+ title: string;
61
+ url: string;
62
+ } | {
63
+ kind: "resource";
64
+ uri: string;
65
+ fileName: string;
66
+ mimeType: string;
67
+ title: string;
68
+ url: string;
69
+ };
70
+ export interface TabsContentOptions {
71
+ contentType: TabsContentType;
72
+ timeoutMs?: number;
73
+ urls: Array<string>;
74
+ }
75
+ export interface TabsContentResult {
76
+ truncated: boolean;
77
+ content: null | string;
78
+ title: null | string;
79
+ url: string;
80
+ }
81
+ export interface TabInfo {
82
+ id: string;
83
+ providerTabId?: string;
84
+ title?: string;
85
+ url?: string;
86
+ }
87
+ export type TabCapabilityCollection = {
88
+ get(id: "pageAssets"): Promise<PageAssetsCapability>;
89
+ get(id: "cdp"): Promise<CdpCapability>;
90
+ get(id: "webmcp"): Promise<WebMcpCapability>;
91
+ get(id: string): Promise<CapabilityInfo>;
92
+ list(): Promise<CapabilityInfo[]>;
93
+ };
94
+ export type Dialog = AlertDialog | BeforeUnloadDialog | ConfirmDialog | PromptDialog;
95
+ export type ScreenshotOptions = {
96
+ clip?: ClipRect;
97
+ fullPage?: boolean;
98
+ quality?: number;
99
+ maxEdgePx?: number;
100
+ };
101
+ export type AXPoint = {
102
+ x: number;
103
+ y: number;
104
+ };
105
+ export type AXClickOptions = {
106
+ clickCount?: number;
107
+ duration?: number;
108
+ key?: string;
109
+ mouseButton?: AXMouseButton;
110
+ };
111
+ export type AXStateOptions = {
112
+ disableDiffing?: boolean;
113
+ };
114
+ export type AXPasteOptions = {
115
+ format?: "text" | "md" | "html";
116
+ };
117
+ export type AXPressKeyOptions = {
118
+ duration?: number;
119
+ };
120
+ export type AXDirection = "up" | "down" | "left" | "right" | "u" | "d" | "l" | "r";
121
+ export type AXSelectTextOptions = {
122
+ prefix?: string;
123
+ selectionType?: AXSelectionType;
124
+ suffix?: string;
125
+ };
126
+ export type ClickOptions = {
127
+ button?: 1 | 2 | 3 | 4 | 5;
128
+ keypress?: Array<string>;
129
+ x: number;
130
+ y: number;
131
+ };
132
+ export type DoubleClickOptions = {
133
+ keypress?: Array<string>;
134
+ x: number;
135
+ y: number;
136
+ };
137
+ export type CuaDownloadMediaOptions = {
138
+ timeoutMs?: number;
139
+ x: number;
140
+ y: number;
141
+ };
142
+ export type DragOptions = {
143
+ keys?: Array<string>;
144
+ path: Array<{
145
+ x: number;
146
+ y: number;
147
+ }>;
148
+ };
149
+ export type KeypressOptions = {
150
+ duration?: number;
151
+ keys: Array<string>;
152
+ };
153
+ export type MoveOptions = {
154
+ keys?: Array<string>;
155
+ x: number;
156
+ y: number;
157
+ };
158
+ export type ScrollOptions = {
159
+ keypress?: Array<string>;
160
+ scrollX: number;
161
+ scrollY: number;
162
+ x: number;
163
+ y: number;
164
+ };
165
+ export type TypeOptions = {
166
+ text: string;
167
+ };
168
+ export type DomClickOptions = {
169
+ node_id: NodeId;
170
+ };
171
+ export type DomDownloadMediaOptions = {
172
+ node_id: NodeId;
173
+ timeoutMs?: number;
174
+ };
175
+ export type DomKeypressOptions = {
176
+ keys: Array<string>;
177
+ };
178
+ export type DomScrollOptions = {
179
+ node_id?: NodeId;
180
+ x: number;
181
+ y: number;
182
+ };
183
+ export type DomTypeOptions = {
184
+ text: string;
185
+ };
186
+ export type ElementInfoOptions = {
187
+ includeNonInteractable?: boolean;
188
+ x: number;
189
+ y: number;
190
+ };
191
+ export type ElementInfo = {
192
+ ariaName?: string | null;
193
+ boundingBox?: ElementInfoRect | null;
194
+ nodeId?: number | null;
195
+ preview: string;
196
+ role?: string | null;
197
+ selector: ElementInfoSelector;
198
+ tagName: string;
199
+ testId?: string | null;
200
+ visibleText?: string | null;
201
+ };
202
+ export type ElementScreenshotOptions = {
203
+ includeNonInteractable?: boolean;
204
+ x: number;
205
+ y: number;
206
+ };
207
+ export type PlaywrightEvaluateFunction<TArg, TResult> = string;
208
+ export type PlaywrightEvaluateOptions = {
209
+ timeoutMs?: number;
210
+ };
211
+ export type LoadState = "load" | "domcontentloaded" | "networkidle";
212
+ export type TextMatcher = string | RegExp;
213
+ export type WaitForEventOptions = {
214
+ timeoutMs?: number;
215
+ };
216
+ export type PageWaitForLoadStateOptions = {
217
+ state?: LoadState;
218
+ timeoutMs?: number;
219
+ };
220
+ export type PageWaitForURLOptions = {
221
+ timeoutMs?: number;
222
+ waitUntil?: WaitUntil;
223
+ };
224
+ export type LocatorCheckOptions = {
225
+ timeoutMs?: number;
226
+ };
227
+ export type LocatorClickOptions = {
228
+ button?: MouseButton;
229
+ clickCount?: number;
230
+ position?: {
231
+ x: number;
232
+ y: number;
233
+ };
234
+ modifiers?: Array<KeyboardModifier>;
235
+ timeoutMs?: number;
236
+ };
237
+ export type LocatorDownloadMediaOptions = {
238
+ timeoutMs?: number;
239
+ };
240
+ export type LocatorEvaluateFunction<TArg, TResult> = string;
241
+ export type LocatorEvaluateAllFunction<TArg, TResult> = string;
242
+ export type LocatorFilterOptions = {
243
+ has?: PlaywrightLocator;
244
+ hasNot?: PlaywrightLocator;
245
+ hasNotText?: TextMatcher;
246
+ hasText?: TextMatcher;
247
+ visible?: boolean;
248
+ };
249
+ export type LocatorLocatorOptions = {
250
+ has?: PlaywrightLocator;
251
+ hasNot?: PlaywrightLocator;
252
+ hasNotText?: TextMatcher;
253
+ hasText?: TextMatcher;
254
+ };
255
+ export type LocatorPressSequentiallyOptions = {
256
+ timeoutMs?: number;
257
+ };
258
+ export type SelectOptionInput = string | SelectOptionDescriptor;
259
+ export type LocatorWaitForOptions = {
260
+ state: WaitForState;
261
+ timeoutMs?: number;
262
+ };
263
+ export type FileChooserFiles = string | Array<string | BrowserFileSource>;
264
+ export type TabClipboardItem = {
265
+ entries: Array<TabClipboardEntry>;
266
+ presentationStyle?: "unspecified" | "inline" | "attachment";
267
+ };
268
+ export interface TabDevLogsOptions {
269
+ filter?: string;
270
+ levels?: Array<"debug" | "info" | "log" | "warn" | "error" | "warning">;
271
+ limit?: number;
272
+ }
273
+ export interface TabDevLogEntry {
274
+ level: "debug" | "info" | "log" | "warn" | "error";
275
+ message: string;
276
+ timestamp: string;
277
+ url?: string;
278
+ }
279
+ export type TabsContentType = "html" | "text" | "domSnapshot";
280
+ export type ClipRect = {
281
+ height: number;
282
+ width: number;
283
+ x: number;
284
+ y: number;
285
+ };
286
+ export type AXMouseButton = "left" | "right" | "middle" | "l" | "r" | "m";
287
+ export type AXSelectionType = "text" | "cursor_before" | "cursor_after";
288
+ export type ElementInfoRect = {
289
+ height: number;
290
+ width: number;
291
+ x: number;
292
+ y: number;
293
+ };
294
+ export type ElementInfoSelector = {
295
+ candidates: Array<string>;
296
+ frameSelectors?: Array<string>;
297
+ primary?: string | null;
298
+ };
299
+ export type WaitUntil = LoadState | "commit";
300
+ export type MouseButton = "left" | "right" | "middle";
301
+ export type KeyboardModifier = "Alt" | "Control" | "ControlOrMeta" | "Meta" | "Shift";
302
+ export type SelectOptionDescriptor = {
303
+ index?: number;
304
+ label?: string;
305
+ value?: string;
306
+ };
307
+ export type WaitForState = "attached" | "detached" | "visible" | "hidden";
308
+ export type TabClipboardEntry = {
309
+ mimeType: string;
310
+ text: string;
311
+ data?: never;
312
+ } | {
313
+ mimeType: string;
314
+ data: Uint8Array;
315
+ text?: never;
316
+ };
317
+ export type BrowserTarget = {
318
+ browserId: string;
319
+ tabId?: string;
320
+ generation: number;
321
+ bootId: string;
322
+ browserSessionId: string;
323
+ /** Fixed native control identity; obtaining a new Tab never refreshes an older facade. */
324
+ controlEpoch?: string;
325
+ pageVersion?: number;
326
+ };
327
+ export type BrowserFileSource = {
328
+ path: string;
329
+ name?: string;
330
+ mimeType?: string;
331
+ } | {
332
+ data: Uint8Array | ArrayBuffer | Blob;
333
+ name: string;
334
+ mimeType?: string;
335
+ };
336
+ export type BrowserError = Error & {
337
+ code: string;
338
+ dispatched: boolean;
339
+ effect: "none" | "confirmed" | "unknown";
340
+ retryable: boolean;
341
+ operationId?: string;
342
+ method?: string;
343
+ ref?: ElementRef;
344
+ target?: BrowserTarget;
345
+ };
346
+ export type SdkError = BrowserError;
347
+ export type BrowserId = string;
348
+ export type TabId = string;
349
+ export type Generation = number;
350
+ export type ElementRef = string;
351
+ export type NodeId = string;
352
+ export interface BrowserTab {
353
+ browserId: string;
354
+ tabId: string;
355
+ generation: number;
356
+ bootId: string;
357
+ browserSessionId: string;
358
+ title?: string;
359
+ url?: string;
360
+ active: boolean;
361
+ windowId?: string;
362
+ groupId?: string;
363
+ index?: number;
364
+ pinned?: boolean;
365
+ muted?: boolean;
366
+ }
367
+ export interface SnapshotNode {
368
+ ref: ElementRef;
369
+ role: string;
370
+ name?: string;
371
+ value?: string;
372
+ disabled?: boolean;
373
+ checked?: boolean;
374
+ children?: SnapshotNode[];
375
+ }
376
+ export interface PageSnapshot {
377
+ browserId: string;
378
+ tabId: string;
379
+ generation: number;
380
+ bootId: string;
381
+ browserSessionId: string;
382
+ pageVersion: number;
383
+ url: string;
384
+ title: string;
385
+ root: SnapshotNode;
386
+ dialog?: {
387
+ type: Dialog["type"];
388
+ message: string;
389
+ };
390
+ truncated: boolean;
391
+ artifact?: BrowserArtifact;
392
+ }
393
+ export interface ActionResult {
394
+ ok: true;
395
+ operationId: string;
396
+ target: BrowserTarget & {
397
+ tabId: string;
398
+ pageVersion: number;
399
+ };
400
+ changed: boolean;
401
+ }
402
+ export interface CapabilityInfo {
403
+ id: string;
404
+ name: string;
405
+ title: string;
406
+ description: string;
407
+ supported: boolean;
408
+ reason?: string;
409
+ revision: string;
410
+ }
411
+ export type WaitCondition = ({
412
+ kind: "element";
413
+ selector: string;
414
+ state?: WaitForState;
415
+ } | {
416
+ kind: "selector";
417
+ value: string;
418
+ state?: WaitForState;
419
+ } | {
420
+ kind: "text" | "url";
421
+ value: string;
422
+ } | {
423
+ kind: "navigation";
424
+ url?: string;
425
+ waitUntil?: WaitUntil;
426
+ } | {
427
+ kind: "state";
428
+ state: LoadState;
429
+ }) & {
430
+ timeoutMs?: number;
431
+ pollingMs?: number;
432
+ };
433
+ export interface WaitResult {
434
+ matched: true;
435
+ snapshot: PageSnapshot;
436
+ }
437
+ export interface NavigationOptions {
438
+ waitUntil?: WaitUntil;
439
+ timeoutMs?: number;
440
+ }
441
+ export interface BrowserWindow {
442
+ id: string;
443
+ focused: boolean;
444
+ state: "normal" | "minimized" | "maximized" | "fullscreen";
445
+ left?: number;
446
+ top?: number;
447
+ width?: number;
448
+ height?: number;
449
+ tabs?: BrowserTab[];
450
+ }
451
+ export interface BrowserTabGroup {
452
+ id: string;
453
+ windowId: string;
454
+ title: string;
455
+ color: string;
456
+ collapsed: boolean;
457
+ }
458
+ export interface BrowserBookmark {
459
+ id: string;
460
+ parentId?: string;
461
+ index?: number;
462
+ title: string;
463
+ url?: string;
464
+ children?: BrowserBookmark[];
465
+ }
466
+ export interface BrowserArtifact {
467
+ path: string;
468
+ name: string;
469
+ mimeType: string;
470
+ size: number;
471
+ sha256: string;
472
+ }
473
+ export interface BrowserDownload {
474
+ id: string;
475
+ target: BrowserTarget;
476
+ url?: string;
477
+ suggestedFilename: string;
478
+ state: "in_progress" | "complete" | "cancelled" | "interrupted" | "unknown";
479
+ bytesReceived: number;
480
+ totalBytes?: number;
481
+ error?: string;
482
+ }
483
+ export interface ManagementAuditEntry {
484
+ id: string;
485
+ createdAt: number;
486
+ runId: string;
487
+ operationId: string;
488
+ namespace: "windows" | "tabs" | "tabGroups" | "bookmarks";
489
+ method: string;
490
+ before: {
491
+ windows?: BrowserWindow[];
492
+ tabs?: BrowserTab[];
493
+ groups?: BrowserTabGroup[];
494
+ bookmarks?: BrowserBookmark[];
495
+ };
496
+ changedIds: string[];
497
+ outcome: "confirmed" | "failed" | "unknown";
498
+ }
499
+ export interface ManagementCapability {
500
+ windows: {
501
+ list(): Promise<BrowserWindow[]>;
502
+ getAll(options?: {
503
+ populate?: boolean;
504
+ }): Promise<BrowserWindow[]>;
505
+ create(options?: {
506
+ tabId?: string;
507
+ focused?: boolean;
508
+ left?: number;
509
+ top?: number;
510
+ width?: number;
511
+ height?: number;
512
+ }): Promise<BrowserWindow>;
513
+ update(id: string, options: {
514
+ focused?: boolean;
515
+ state?: BrowserWindow["state"];
516
+ left?: number;
517
+ top?: number;
518
+ width?: number;
519
+ height?: number;
520
+ }): Promise<BrowserWindow>;
521
+ };
522
+ tabs: {
523
+ query(options?: {
524
+ windowId?: string;
525
+ url?: string | string[];
526
+ active?: boolean;
527
+ pinned?: boolean;
528
+ groupId?: string;
529
+ }): Promise<BrowserTab[]>;
530
+ get(id: string): Promise<BrowserTab>;
531
+ move(id: string, options: {
532
+ index: number;
533
+ windowId?: string;
534
+ }): Promise<BrowserTab>;
535
+ update(id: string, options: {
536
+ pinned?: boolean;
537
+ muted?: boolean;
538
+ }): Promise<BrowserTab>;
539
+ group(options: {
540
+ tabIds: string[];
541
+ groupId?: string;
542
+ createProperties?: {
543
+ windowId?: string;
544
+ };
545
+ }): Promise<{
546
+ groupId: string;
547
+ }>;
548
+ ungroup(ids: string[]): Promise<void>;
549
+ close(id: string): Promise<void>;
550
+ };
551
+ tabGroups: {
552
+ query(options?: {
553
+ windowId?: string;
554
+ title?: string;
555
+ color?: string;
556
+ collapsed?: boolean;
557
+ }): Promise<BrowserTabGroup[]>;
558
+ get(id: string): Promise<BrowserTabGroup>;
559
+ update(id: string, options: {
560
+ title?: string;
561
+ color?: string;
562
+ collapsed?: boolean;
563
+ }): Promise<BrowserTabGroup>;
564
+ move(id: string, options: {
565
+ index: number;
566
+ windowId?: string;
567
+ }): Promise<BrowserTabGroup>;
568
+ };
569
+ bookmarks: {
570
+ search(query: string | {
571
+ query?: string;
572
+ title?: string;
573
+ url?: string;
574
+ }): Promise<BrowserBookmark[]>;
575
+ getTree(): Promise<BrowserBookmark[]>;
576
+ create(options: {
577
+ parentId?: string;
578
+ index?: number;
579
+ title?: string;
580
+ url?: string;
581
+ }): Promise<BrowserBookmark>;
582
+ update(id: string, options: {
583
+ title?: string;
584
+ url?: string;
585
+ }): Promise<BrowserBookmark>;
586
+ move(id: string, options: {
587
+ parentId?: string;
588
+ index?: number;
589
+ }): Promise<BrowserBookmark>;
590
+ remove(id: string): Promise<void>;
591
+ };
592
+ getAuditTrail(options?: {
593
+ limit?: number;
594
+ cursor?: string;
595
+ }): Promise<{
596
+ changes: ManagementAuditEntry[];
597
+ nextCursor?: string;
598
+ truncated: boolean;
599
+ }>;
600
+ }
601
+ export type PageAssetKind = "other" | "script" | "font" | "image" | "stylesheet" | "video";
602
+ export interface PageAsset {
603
+ id: string;
604
+ kind: PageAssetKind;
605
+ name: string;
606
+ url: string;
607
+ sources: {
608
+ kind: "attribute" | "computedStyle" | "resource";
609
+ nodeId?: number;
610
+ property?: string;
611
+ }[];
612
+ }
613
+ export interface PageAssetInventory {
614
+ id: string;
615
+ target: BrowserTarget;
616
+ assets: PageAsset[];
617
+ inlineSvgs: {
618
+ id: string;
619
+ markup: string;
620
+ name: string;
621
+ }[];
622
+ pageUrl: string | null;
623
+ summary: {
624
+ byKind: Partial<Record<PageAssetKind, number>>;
625
+ inlineSvgCount: number;
626
+ totalCount: number;
627
+ };
628
+ }
629
+ export interface PageAssetBundle {
630
+ directoryPath: string;
631
+ manifestPath: string;
632
+ assets: (BrowserArtifact & {
633
+ id: string;
634
+ kind: PageAssetKind;
635
+ url: string;
636
+ })[];
637
+ failures: {
638
+ id: string;
639
+ url: string;
640
+ name: string;
641
+ reason: string;
642
+ }[];
643
+ summary: {
644
+ requestedCount: number;
645
+ downloadedCount: number;
646
+ failedCount: number;
647
+ elapsedMs: number;
648
+ };
649
+ }
650
+ export interface PageAssetsCapability {
651
+ list(): Promise<PageAssetInventory>;
652
+ download(urls: string[]): Promise<{
653
+ files: (BrowserArtifact & {
654
+ url: string;
655
+ })[];
656
+ failures: {
657
+ url: string;
658
+ reason: string;
659
+ }[];
660
+ }>;
661
+ bundle(options: {
662
+ inventoryId: string;
663
+ assetIds?: string[];
664
+ kinds?: ("font" | "image" | "stylesheet" | "video")[];
665
+ }): Promise<PageAssetBundle>;
666
+ }
667
+ export type CdpTarget = {
668
+ sessionId: string;
669
+ targetId?: never;
670
+ } | {
671
+ sessionId?: never;
672
+ targetId: string;
673
+ };
674
+ export interface CdpEvent {
675
+ method: string;
676
+ params?: Record<string, unknown>;
677
+ sequence: number;
678
+ source: {
679
+ browserId: string;
680
+ bootId: string;
681
+ browserSessionId: string;
682
+ generation: number;
683
+ tabId?: string;
684
+ sessionId?: string;
685
+ targetId?: string;
686
+ };
687
+ }
688
+ export interface CdpEventsOptions {
689
+ afterSequence?: number;
690
+ limit?: number;
691
+ methods?: string[];
692
+ target?: CdpTarget;
693
+ timeoutMs?: number;
694
+ }
695
+ export interface CdpCapability {
696
+ send(method: string, params?: Record<string, unknown>, options?: {
697
+ target?: CdpTarget;
698
+ timeoutMs?: number;
699
+ }): Promise<unknown>;
700
+ events(cursor?: string): Promise<{
701
+ events: CdpEvent[];
702
+ nextCursor?: string;
703
+ hasMore: boolean;
704
+ truncated: boolean;
705
+ }>;
706
+ cursor(): Promise<string>;
707
+ readEvents(options?: CdpEventsOptions): Promise<{
708
+ cursor: number;
709
+ events: CdpEvent[];
710
+ hasMore: boolean;
711
+ truncated: boolean;
712
+ }>;
713
+ }
714
+ export interface WebMcpTool {
715
+ documentRevision: string;
716
+ registrationRevision: string;
717
+ name: string;
718
+ description?: string;
719
+ inputSchema: Record<string, unknown>;
720
+ annotations?: Record<string, unknown>;
721
+ }
722
+ export interface WebMcpTools {
723
+ documentRevision: string;
724
+ registrationRevision: string;
725
+ tools: readonly WebMcpTool[];
726
+ invokeTool(name: string, args: unknown): Promise<unknown>;
727
+ }
728
+ export interface WebMcpCapability {
729
+ listTools(): Promise<WebMcpTool[]>;
730
+ invokeTool(name: string, args: unknown): Promise<unknown>;
731
+ fetchTools(): Promise<WebMcpTools>;
732
+ }
733
+ export interface VisibilityCapability {
734
+ get(): Promise<boolean>;
735
+ set(visible: boolean): Promise<void>;
736
+ }
737
+ export interface ViewportCapability {
738
+ set(options: {
739
+ tabId?: string;
740
+ width: number;
741
+ height: number;
742
+ }): Promise<ActionResult>;
743
+ reset(tabId?: string): Promise<ActionResult>;
744
+ }
745
+ export interface Browser {
746
+ name: string;
747
+ type: "extension";
748
+ profileName?: string;
749
+ windows: ManagementCapability["windows"];
750
+ tabGroups: ManagementCapability["tabGroups"];
751
+ bookmarks: ManagementCapability["bookmarks"];
752
+ management: ManagementCapability;
753
+ visibility: VisibilityCapability;
754
+ viewport: ViewportCapability;
755
+ }
756
+ export interface Tabs {
757
+ query(options?: {
758
+ windowId?: string;
759
+ url?: string | string[];
760
+ active?: boolean;
761
+ pinned?: boolean;
762
+ groupId?: string;
763
+ }): Promise<BrowserTab[]>;
764
+ move(id: string, options: {
765
+ index: number;
766
+ windowId?: string;
767
+ }): Promise<BrowserTab>;
768
+ update(id: string, options: {
769
+ pinned?: boolean;
770
+ muted?: boolean;
771
+ }): Promise<BrowserTab>;
772
+ group(options: {
773
+ tabIds: string[];
774
+ groupId?: string;
775
+ createProperties?: {
776
+ windowId?: string;
777
+ };
778
+ }): Promise<{
779
+ groupId: string;
780
+ }>;
781
+ ungroup(ids: string[]): Promise<void>;
782
+ close(id: string): Promise<void>;
783
+ }
784
+ export interface Tab {
785
+ snapshot(options?: {
786
+ maxBytes?: number;
787
+ root?: ElementRef;
788
+ frame?: string;
789
+ }): Promise<PageSnapshot>;
790
+ click(ref: ElementRef, options?: {
791
+ timeoutMs?: number;
792
+ button?: MouseButton;
793
+ modifiers?: KeyboardModifier[];
794
+ clickCount?: number;
795
+ position?: {
796
+ x: number;
797
+ y: number;
798
+ };
799
+ }): Promise<ActionResult>;
800
+ fill(ref: ElementRef, text: string, options?: {
801
+ timeoutMs?: number;
802
+ }): Promise<ActionResult>;
803
+ press(key: string, options?: {
804
+ timeoutMs?: number;
805
+ modifiers?: KeyboardModifier[];
806
+ }): Promise<ActionResult>;
807
+ selectOption(ref: ElementRef, values: SelectOptionInput | SelectOptionInput[]): Promise<ActionResult>;
808
+ scroll(options: {
809
+ x?: number;
810
+ y?: number;
811
+ ref?: ElementRef;
812
+ behavior?: "auto" | "smooth";
813
+ }): Promise<ActionResult>;
814
+ hover(ref: ElementRef, options?: {
815
+ timeoutMs?: number;
816
+ }): Promise<ActionResult>;
817
+ focus(ref: ElementRef): Promise<ActionResult>;
818
+ waitFor(condition: WaitCondition): Promise<WaitResult>;
819
+ locator(selector: string): PlaywrightLocator;
820
+ evaluate<TResult = unknown>(expression: string, args?: unknown): Promise<TResult>;
821
+ keyboardDown(key: string): Promise<ActionResult>;
822
+ keyboardUp(key: string): Promise<ActionResult>;
823
+ frame(selector: string): Promise<Frame>;
824
+ dialogAccept(text?: string): Promise<ActionResult>;
825
+ dialogDismiss(): Promise<ActionResult>;
826
+ contentExport(options: {
827
+ format: "html" | "markdown" | "text";
828
+ }): Promise<{
829
+ data: string;
830
+ truncated: boolean;
831
+ artifact?: BrowserArtifact;
832
+ }>;
833
+ exportGsuite(type: "pdf" | "md" | "xlsx" | "csv" | "docx" | "pptx"): Promise<BrowserArtifact>;
834
+ exportYouTubeTranscript(): Promise<BrowserArtifact>;
835
+ clipboardReadText(): Promise<string>;
836
+ clipboardWriteText(text: string): Promise<ActionResult>;
837
+ clipboardRead(): Promise<TabClipboardItem[]>;
838
+ clipboardWrite(items: TabClipboardItem[]): Promise<ActionResult>;
839
+ setFiles(ref: ElementRef, files: BrowserFileSource[]): Promise<ActionResult>;
840
+ downloads(): Promise<BrowserDownload[]>;
841
+ saveDownload(id: string, path?: string): Promise<BrowserArtifact>;
842
+ setViewport(size: {
843
+ width: number;
844
+ height: number;
845
+ }): Promise<ActionResult>;
846
+ resetViewport(): Promise<ActionResult>;
847
+ devLogs(options?: TabDevLogsOptions & {
848
+ since?: number;
849
+ }): Promise<TabDevLogEntry[]>;
850
+ assets: PageAssetsCapability;
851
+ exportFile(options: {
852
+ format: "pdf" | "html" | "markdown";
853
+ }): Promise<BrowserArtifact>;
854
+ webmcp: WebMcpCapability;
855
+ cdp: CdpCapability;
856
+ }
857
+ export interface Frame {
858
+ snapshot(options?: {
859
+ maxBytes?: number;
860
+ }): Promise<PageSnapshot>;
861
+ click(ref: ElementRef, options?: {
862
+ timeoutMs?: number;
863
+ }): Promise<ActionResult>;
864
+ fill(ref: ElementRef, text: string, options?: {
865
+ timeoutMs?: number;
866
+ }): Promise<ActionResult>;
867
+ locator(selector: string): PlaywrightLocator;
868
+ frameLocator(frameSelector: string): PlaywrightFrameLocator;
869
+ getByLabel(text: TextMatcher, options?: {
870
+ exact?: boolean;
871
+ }): PlaywrightLocator;
872
+ getByPlaceholder(text: TextMatcher, options?: {
873
+ exact?: boolean;
874
+ }): PlaywrightLocator;
875
+ getByRole(role: string, options?: {
876
+ exact?: boolean;
877
+ name?: TextMatcher;
878
+ }): PlaywrightLocator;
879
+ getByTestId(testId: string): PlaywrightLocator;
880
+ getByText(text: TextMatcher, options?: {
881
+ exact?: boolean;
882
+ }): PlaywrightLocator;
883
+ waitFor(condition: WaitCondition): Promise<WaitResult>;
884
+ }
885
+ export interface PlaywrightAPI {
886
+ waitForDownload(options?: WaitForEventOptions): Promise<PlaywrightDownload>;
887
+ waitForFileChooser(options?: WaitForEventOptions): Promise<PlaywrightFileChooser>;
888
+ }
889
+ export interface AXAPI {
890
+ snapshot(options?: AXStateOptions): Promise<{
891
+ target: BrowserTarget & {
892
+ tabId: string;
893
+ pageVersion: number;
894
+ };
895
+ nodes: {
896
+ index: number;
897
+ role: string;
898
+ name?: string;
899
+ }[];
900
+ truncated: boolean;
901
+ }>;
902
+ }
903
+ export interface DomCUAAPI {
904
+ fill(nodeId: NodeId, text: string): Promise<ActionResult>;
905
+ }
906
+ export interface BrowserInfo {
907
+ id: string;
908
+ name: string;
909
+ profileName?: string;
910
+ family?: string;
911
+ type: "extension";
912
+ status: "online";
913
+ generation: number;
914
+ bootId: string;
915
+ browserSessionId: string;
916
+ metadata?: {
917
+ browserVersion?: string;
918
+ extensionVersion: string;
919
+ versionSource: "clientHints" | "userAgent" | "unknown";
920
+ };
921
+ }
922
+ export type TextMatcherData = {
923
+ kind: "text";
924
+ value: string;
925
+ exact?: boolean;
926
+ } | {
927
+ kind: "regexp";
928
+ source: string;
929
+ flags: string;
930
+ };
931
+ export type LocatorData = {
932
+ kind: "selector";
933
+ selector: string;
934
+ } | {
935
+ kind: "role";
936
+ role: string;
937
+ name?: TextMatcherData;
938
+ exact?: boolean;
939
+ } | {
940
+ kind: "label" | "placeholder" | "text";
941
+ matcher: TextMatcherData;
942
+ } | {
943
+ kind: "testId";
944
+ value: string;
945
+ } | {
946
+ kind: "descendant";
947
+ root: LocatorData;
948
+ query: LocatorData;
949
+ } | {
950
+ kind: "and" | "or";
951
+ left: LocatorData;
952
+ right: LocatorData;
953
+ } | {
954
+ kind: "position";
955
+ query: LocatorData;
956
+ at: "first" | "last" | number;
957
+ } | {
958
+ kind: "filter";
959
+ query: LocatorData;
960
+ has?: LocatorData;
961
+ hasNot?: LocatorData;
962
+ hasText?: TextMatcherData;
963
+ hasNotText?: TextMatcherData;
964
+ visible?: boolean;
965
+ } | {
966
+ kind: "ref";
967
+ ref: ElementRef;
968
+ pageVersion: number;
969
+ };
970
+ export interface LocatorDescription {
971
+ target: BrowserTarget & {
972
+ tabId: string;
973
+ };
974
+ framePath: readonly string[];
975
+ query: LocatorData;
976
+ }
977
+ export interface BrowserWaiterInfo {
978
+ id: string;
979
+ target: BrowserTarget & {
980
+ tabId: string;
981
+ };
982
+ expiresAt: number;
983
+ }
984
+ export type BrowserWaiterEvent = {
985
+ type: "navigation";
986
+ target: BrowserTarget;
987
+ url: string;
988
+ pageVersion: number;
989
+ } | {
990
+ type: "download";
991
+ target: BrowserTarget;
992
+ downloadId: string;
993
+ suggestedFilename: string;
994
+ } | {
995
+ type: "filechooser";
996
+ target: BrowserTarget;
997
+ chooserId: string;
998
+ pageVersion: number;
999
+ multiple: boolean;
1000
+ };
1001
+ export interface BrowserWaiterMethods {
1002
+ arm(input: {
1003
+ target: BrowserTarget & {
1004
+ tabId: string;
1005
+ };
1006
+ event: "navigation" | "download" | "filechooser";
1007
+ timeoutMs?: number;
1008
+ url?: string;
1009
+ waitUntil?: WaitUntil;
1010
+ }): Promise<BrowserWaiterInfo>;
1011
+ get(input: {
1012
+ id: string;
1013
+ }): Promise<BrowserWaiterEvent>;
1014
+ cancel(input: {
1015
+ id: string;
1016
+ }): Promise<{
1017
+ cancelled: boolean;
1018
+ }>;
1019
+ }
1020
+ export interface VisibleDomTree {
1021
+ target: BrowserTarget;
1022
+ nodes: {
1023
+ nodeId: NodeId;
1024
+ role: string;
1025
+ name?: string;
1026
+ rect?: {
1027
+ x: number;
1028
+ y: number;
1029
+ width: number;
1030
+ height: number;
1031
+ };
1032
+ children?: NodeId[];
1033
+ }[];
1034
+ truncated: boolean;
1035
+ artifact?: BrowserArtifact;
1036
+ }
1037
+ export interface BrowserClient {
1038
+ browsers: Browsers;
1039
+ documentation: Documentation;
1040
+ }
1041
+ export interface Browsers {
1042
+ get(id: string): Promise<Browser>;
1043
+ getDefault(): Promise<Browser>;
1044
+ getForUrl(url: string): Promise<Browser>;
1045
+ list(): Promise<BrowserInfo[]>;
1046
+ }
1047
+ export interface Browser {
1048
+ browserId: string;
1049
+ capabilities: BrowserCapabilityCollection;
1050
+ downloads: {
1051
+ list(options?: {
1052
+ limit?: number;
1053
+ }): Promise<BrowserDownloadRecord[]>;
1054
+ };
1055
+ tabs: Tabs;
1056
+ user: BrowserUser;
1057
+ documentation(): Promise<string>;
1058
+ history(options?: BrowserHistoryOptions): Promise<Array<BrowserHistoryEntry>>;
1059
+ nameSession(name: string): Promise<void>;
1060
+ }
1061
+ export interface BrowserUser {
1062
+ claimTab(tab: string | BrowserUserTabInfo): Promise<Tab>;
1063
+ getTabContext(tab?: string | BrowserUserTabInfo): Promise<BrowserUserTabContext>;
1064
+ openTabs(): Promise<Array<BrowserUserTabInfo>>;
1065
+ }
1066
+ export interface Tabs {
1067
+ content(options: TabsContentOptions): Promise<Array<TabsContentResult>>;
1068
+ get(id: string): Promise<Tab>;
1069
+ list(): Promise<Array<TabInfo>>;
1070
+ new: (url?: string, options?: {
1071
+ active?: boolean;
1072
+ }) => Promise<Tab>;
1073
+ select(id: string): Promise<ActionResult>;
1074
+ selected(): Promise<undefined | Tab>;
1075
+ }
1076
+ export interface Tab {
1077
+ ax: AXAPI;
1078
+ capabilities: TabCapabilityCollection;
1079
+ clipboard: TabClipboardAPI;
1080
+ content: ContentAPI;
1081
+ cua: CUAAPI;
1082
+ dev: TabDevAPI;
1083
+ dom: DomCUAAPI;
1084
+ id: string;
1085
+ playwright: PlaywrightAPI;
1086
+ goBack(options?: NavigationOptions): Promise<ActionResult>;
1087
+ close(): Promise<void>;
1088
+ forward(options?: NavigationOptions): Promise<ActionResult>;
1089
+ getJsDialog(): Promise<undefined | Dialog>;
1090
+ navigate(url: string, options?: NavigationOptions): Promise<ActionResult>;
1091
+ markDeliverable(): Promise<void>;
1092
+ markHandoff(): Promise<void>;
1093
+ reload(options?: NavigationOptions): Promise<ActionResult>;
1094
+ requestUserTakeover(): Promise<void>;
1095
+ requestUserTakeover(reason?: "authentication" | "captcha" | "user_requested" | "other"): Promise<void>;
1096
+ screenshot(options?: ScreenshotOptions): Promise<Uint8Array>;
1097
+ title(): Promise<undefined | string>;
1098
+ url(): Promise<undefined | string>;
1099
+ }
1100
+ export interface AXAPI {
1101
+ click(target: number | AXPoint, options?: AXClickOptions): Promise<void>;
1102
+ drag(from: AXPoint, to: AXPoint): Promise<void>;
1103
+ get(mode?: "state", options?: AXStateOptions): Promise<string>;
1104
+ get(mode: "screenshot"): Promise<Uint8Array>;
1105
+ get(mode: "both", options?: AXStateOptions): Promise<{
1106
+ screenshot?: Uint8Array;
1107
+ state: string;
1108
+ }>;
1109
+ paste(elementIndex: null | number, text: string, options?: AXPasteOptions): Promise<void>;
1110
+ performSecondaryAction(elementIndex: number, action: string): Promise<void>;
1111
+ pressKey(elementIndex: null | number, key: string, options?: AXPressKeyOptions): Promise<void>;
1112
+ scroll(target: number | AXPoint, direction: AXDirection, pages?: number): Promise<void>;
1113
+ selectText(elementIndex: number, text: string, options?: AXSelectTextOptions): Promise<void>;
1114
+ setValue(elementIndex: number, value: string): Promise<void>;
1115
+ typeText(elementIndex: null | number, text: string): Promise<void>;
1116
+ write(mode?: "state", options?: AXStateOptions): Promise<OutputIntent>;
1117
+ write(mode: "screenshot"): Promise<OutputIntent>;
1118
+ write(mode: "both", options?: AXStateOptions): Promise<OutputIntent>;
1119
+ }
1120
+ export interface ContentAPI {
1121
+ export(): Promise<BrowserArtifact>;
1122
+ exportGsuite(type: "pdf" | "md" | "xlsx" | "csv" | "docx" | "pptx"): Promise<BrowserArtifact>;
1123
+ exportYouTubeTranscript(): Promise<BrowserArtifact>;
1124
+ }
1125
+ export interface CUAAPI {
1126
+ click(options: ClickOptions): Promise<void>;
1127
+ doubleClick(options: DoubleClickOptions): Promise<void>;
1128
+ downloadMedia(options: CuaDownloadMediaOptions): Promise<BrowserArtifact>;
1129
+ drag(options: DragOptions): Promise<void>;
1130
+ keypress(options: KeypressOptions): Promise<void>;
1131
+ move(options: MoveOptions): Promise<void>;
1132
+ scroll(options: ScrollOptions): Promise<void>;
1133
+ type(options: TypeOptions): Promise<void>;
1134
+ }
1135
+ export interface DomCUAAPI {
1136
+ click(options: DomClickOptions): Promise<void>;
1137
+ doubleClick(options: DomClickOptions): Promise<void>;
1138
+ downloadMedia(options: DomDownloadMediaOptions): Promise<BrowserArtifact>;
1139
+ getVisibleTree(): Promise<VisibleDomTree>;
1140
+ keypress(options: DomKeypressOptions): Promise<void>;
1141
+ scroll(options: DomScrollOptions): Promise<void>;
1142
+ type(options: DomTypeOptions): Promise<void>;
1143
+ }
1144
+ export interface PlaywrightAPI {
1145
+ domSnapshot(): Promise<string>;
1146
+ elementInfo(options: ElementInfoOptions): Promise<Array<ElementInfo>>;
1147
+ elementScreenshot(options: ElementScreenshotOptions): Promise<Uint8Array>;
1148
+ evaluate<TResult, TArg>(pageFunction: PlaywrightEvaluateFunction<TArg, TResult>, arg?: TArg, options?: PlaywrightEvaluateOptions): Promise<TResult>;
1149
+ expectNavigation<T>(action: () => Promise<T>, options?: {
1150
+ timeoutMs?: number;
1151
+ url?: string;
1152
+ waitUntil?: WaitUntil;
1153
+ }): Promise<T>;
1154
+ frameLocator(frameSelector: string): PlaywrightFrameLocator;
1155
+ getByLabel(text: TextMatcher, options?: {
1156
+ exact?: boolean;
1157
+ }): PlaywrightLocator;
1158
+ getByPlaceholder(text: TextMatcher, options?: {
1159
+ exact?: boolean;
1160
+ }): PlaywrightLocator;
1161
+ getByRole(role: string, options?: {
1162
+ exact?: boolean;
1163
+ name?: TextMatcher;
1164
+ }): PlaywrightLocator;
1165
+ getByTestId(testId: string): PlaywrightLocator;
1166
+ getByText(text: TextMatcher, options?: {
1167
+ exact?: boolean;
1168
+ }): PlaywrightLocator;
1169
+ locator(selector: string): PlaywrightLocator;
1170
+ waitForEvent(event: "download", options?: WaitForEventOptions): Promise<PlaywrightDownload>;
1171
+ waitForEvent(event: "filechooser", options?: WaitForEventOptions): Promise<PlaywrightFileChooser>;
1172
+ waitForLoadState(options?: PageWaitForLoadStateOptions): Promise<void>;
1173
+ waitForTimeout(timeoutMs: number): Promise<void>;
1174
+ waitForURL(url: string, options?: PageWaitForURLOptions): Promise<void>;
1175
+ }
1176
+ export interface PlaywrightFrameLocator {
1177
+ frameLocator(frameSelector: string): PlaywrightFrameLocator;
1178
+ getByLabel(text: TextMatcher, options?: {
1179
+ exact?: boolean;
1180
+ }): PlaywrightLocator;
1181
+ getByPlaceholder(text: TextMatcher, options?: {
1182
+ exact?: boolean;
1183
+ }): PlaywrightLocator;
1184
+ getByRole(role: string, options?: {
1185
+ exact?: boolean;
1186
+ name?: TextMatcher;
1187
+ }): PlaywrightLocator;
1188
+ getByTestId(testId: string): PlaywrightLocator;
1189
+ getByText(text: TextMatcher, options?: {
1190
+ exact?: boolean;
1191
+ }): PlaywrightLocator;
1192
+ locator(selector: string): PlaywrightLocator;
1193
+ }
1194
+ export interface PlaywrightLocator {
1195
+ all(): Promise<Array<PlaywrightLocator>>;
1196
+ allTextContents(options?: {
1197
+ timeoutMs?: number;
1198
+ }): Promise<Array<string>>;
1199
+ and(locator: PlaywrightLocator): PlaywrightLocator;
1200
+ check(options?: LocatorCheckOptions): Promise<void>;
1201
+ click(options?: LocatorClickOptions): Promise<void>;
1202
+ count(): Promise<number>;
1203
+ dblclick(options?: LocatorClickOptions): Promise<void>;
1204
+ downloadMedia(options?: LocatorDownloadMediaOptions): Promise<BrowserArtifact>;
1205
+ evaluate<TResult, TArg>(pageFunction: LocatorEvaluateFunction<TArg, TResult>, arg?: TArg, options?: PlaywrightEvaluateOptions): Promise<TResult>;
1206
+ evaluateAll<TResult, TArg>(pageFunction: LocatorEvaluateAllFunction<TArg, TResult>, arg?: TArg, options?: PlaywrightEvaluateOptions): Promise<TResult>;
1207
+ fill(value: string, options?: {
1208
+ timeoutMs?: number;
1209
+ }): Promise<void>;
1210
+ filter(options: LocatorFilterOptions): PlaywrightLocator;
1211
+ first(): PlaywrightLocator;
1212
+ getAttribute(name: string, options?: {
1213
+ timeoutMs?: number;
1214
+ }): Promise<null | string>;
1215
+ getByLabel(text: TextMatcher, options?: {
1216
+ exact?: boolean;
1217
+ }): PlaywrightLocator;
1218
+ getByPlaceholder(text: TextMatcher, options?: {
1219
+ exact?: boolean;
1220
+ }): PlaywrightLocator;
1221
+ getByRole(role: string, options?: {
1222
+ exact?: boolean;
1223
+ name?: TextMatcher;
1224
+ }): PlaywrightLocator;
1225
+ getByTestId(testId: string): PlaywrightLocator;
1226
+ getByText(text: TextMatcher, options?: {
1227
+ exact?: boolean;
1228
+ }): PlaywrightLocator;
1229
+ innerText(options?: {
1230
+ timeoutMs?: number;
1231
+ }): Promise<string>;
1232
+ isEnabled(): Promise<boolean>;
1233
+ isVisible(): Promise<boolean>;
1234
+ last(): PlaywrightLocator;
1235
+ locator(selector: string, options?: LocatorLocatorOptions): PlaywrightLocator;
1236
+ nth(index: number): PlaywrightLocator;
1237
+ or(locator: PlaywrightLocator): PlaywrightLocator;
1238
+ press(value: string, options?: {
1239
+ timeoutMs?: number;
1240
+ modifiers?: KeyboardModifier[];
1241
+ }): Promise<void>;
1242
+ pressSequentially(value: string, options?: LocatorPressSequentiallyOptions): Promise<void>;
1243
+ selectOption(value: SelectOptionInput | Array<SelectOptionInput>, options?: {
1244
+ timeoutMs?: number;
1245
+ }): Promise<void>;
1246
+ setChecked(checked: boolean, options?: LocatorCheckOptions): Promise<void>;
1247
+ textContent(options?: {
1248
+ timeoutMs?: number;
1249
+ }): Promise<null | string>;
1250
+ type(value: string, options?: {
1251
+ timeoutMs?: number;
1252
+ delayMs?: number;
1253
+ }): Promise<void>;
1254
+ uncheck(options?: LocatorCheckOptions): Promise<void>;
1255
+ waitFor(options: LocatorWaitForOptions): Promise<void>;
1256
+ }
1257
+ export interface PlaywrightDownload {
1258
+ path(options?: {
1259
+ timeoutMs?: number;
1260
+ }): Promise<null | string>;
1261
+ }
1262
+ export interface PlaywrightFileChooser {
1263
+ isMultiple(): boolean;
1264
+ setFiles(files: FileChooserFiles, options?: {
1265
+ timeoutMs?: number;
1266
+ }): Promise<void>;
1267
+ }
1268
+ export interface TabClipboardAPI {
1269
+ read(): Promise<Array<TabClipboardItem>>;
1270
+ readText(): Promise<string>;
1271
+ write(items: Array<TabClipboardItem>): Promise<void>;
1272
+ writeText(text: string): Promise<void>;
1273
+ }
1274
+ export interface TabDevAPI {
1275
+ logs(options?: TabDevLogsOptions): Promise<Array<TabDevLogEntry>>;
1276
+ }
1277
+ export interface AlertDialog {
1278
+ type: "alert";
1279
+ message: string;
1280
+ dismiss(): Promise<void>;
1281
+ }
1282
+ export interface BeforeUnloadDialog {
1283
+ type: "beforeunload";
1284
+ message: string;
1285
+ dismiss(): Promise<void>;
1286
+ }
1287
+ export interface ConfirmDialog {
1288
+ type: "confirm";
1289
+ message: string;
1290
+ accept(): Promise<void>;
1291
+ dismiss(): Promise<void>;
1292
+ }
1293
+ export interface Documentation {
1294
+ get(name: string): Promise<string>;
1295
+ }
1296
+ export interface PromptDialog {
1297
+ type: "prompt";
1298
+ message: string;
1299
+ accept(text: string): Promise<void>;
1300
+ dismiss(): Promise<void>;
1301
+ }
1302
+ /** Managed discovery result. This fixes a connection; it is not a live controller. */
1303
+ export interface TabDescriptor extends TabInfo {
1304
+ target: BrowserTarget & {
1305
+ tabId: string;
1306
+ };
1307
+ }
1308
+ export interface DialogDescriptor {
1309
+ target: BrowserTarget & {
1310
+ tabId: string;
1311
+ };
1312
+ dialogId: string;
1313
+ pageVersion: number;
1314
+ type: "alert" | "beforeunload" | "confirm" | "prompt";
1315
+ message: string;
1316
+ }
1317
+ export interface DownloadDescriptor {
1318
+ target: BrowserTarget & {
1319
+ tabId: string;
1320
+ };
1321
+ downloadId: string;
1322
+ suggestedFilename: string;
1323
+ }
1324
+ export interface FileChooserDescriptor {
1325
+ target: BrowserTarget & {
1326
+ tabId: string;
1327
+ };
1328
+ chooserId: string;
1329
+ pageVersion: number;
1330
+ multiple: boolean;
1331
+ }
1332
+ export interface FrameDescriptor {
1333
+ target: BrowserTarget & {
1334
+ tabId: string;
1335
+ };
1336
+ framePath: readonly string[];
1337
+ }
1338
+ export interface WebMcpToolsDescriptor {
1339
+ documentRevision: string;
1340
+ registrationRevision: string;
1341
+ tools: readonly WebMcpTool[];
1342
+ }