browse 0.9.0 → 0.9.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -3139,13 +3139,25 @@
3139
3139
  "publish.js"
3140
3140
  ]
3141
3141
  },
3142
- "network:clear": {
3142
+ "mouse:click": {
3143
3143
  "aliases": [],
3144
- "args": {},
3145
- "description": "Clear captured network request directories for the active browser session.",
3144
+ "args": {
3145
+ "x": {
3146
+ "description": "Viewport x coordinate.",
3147
+ "name": "x",
3148
+ "required": true
3149
+ },
3150
+ "y": {
3151
+ "description": "Viewport y coordinate.",
3152
+ "name": "y",
3153
+ "required": true
3154
+ }
3155
+ },
3156
+ "description": "Click raw viewport coordinates in the active page.",
3146
3157
  "examples": [
3147
- "browse network clear",
3148
- "browse network clear --session research"
3158
+ "browse mouse click 240 320",
3159
+ "browse mouse click 240 320 --button right",
3160
+ "browse mouse click 240 320 --click-count 2 --return-xpath"
3149
3161
  ],
3150
3162
  "flags": {
3151
3163
  "auto-connect": {
@@ -3224,11 +3236,40 @@
3224
3236
  "helpValue": "<target-id>",
3225
3237
  "multiple": false,
3226
3238
  "type": "option"
3239
+ },
3240
+ "button": {
3241
+ "description": "Mouse button to use.",
3242
+ "name": "button",
3243
+ "default": "left",
3244
+ "hasDynamicHelp": false,
3245
+ "helpValue": "<button>",
3246
+ "multiple": false,
3247
+ "options": [
3248
+ "left",
3249
+ "middle",
3250
+ "right"
3251
+ ],
3252
+ "type": "option"
3253
+ },
3254
+ "click-count": {
3255
+ "description": "Number of clicks to send.",
3256
+ "name": "click-count",
3257
+ "default": 1,
3258
+ "hasDynamicHelp": false,
3259
+ "helpValue": "<count>",
3260
+ "multiple": false,
3261
+ "type": "option"
3262
+ },
3263
+ "return-xpath": {
3264
+ "description": "Include the XPath under the coordinate when the driver can return it.",
3265
+ "name": "return-xpath",
3266
+ "allowNo": false,
3267
+ "type": "boolean"
3227
3268
  }
3228
3269
  },
3229
3270
  "hasDynamicHelp": false,
3230
3271
  "hiddenAliases": [],
3231
- "id": "network:clear",
3272
+ "id": "mouse:click",
3232
3273
  "pluginAlias": "browse",
3233
3274
  "pluginName": "browse",
3234
3275
  "pluginType": "core",
@@ -3237,17 +3278,39 @@
3237
3278
  "relativePath": [
3238
3279
  "dist",
3239
3280
  "commands",
3240
- "network",
3241
- "clear.js"
3281
+ "mouse",
3282
+ "click.js"
3242
3283
  ]
3243
3284
  },
3244
- "network:off": {
3285
+ "mouse:drag": {
3245
3286
  "aliases": [],
3246
- "args": {},
3247
- "description": "Disable network capture for the active browser session.",
3287
+ "args": {
3288
+ "fromX": {
3289
+ "description": "Starting viewport x coordinate.",
3290
+ "name": "fromX",
3291
+ "required": true
3292
+ },
3293
+ "fromY": {
3294
+ "description": "Starting viewport y coordinate.",
3295
+ "name": "fromY",
3296
+ "required": true
3297
+ },
3298
+ "toX": {
3299
+ "description": "Ending viewport x coordinate.",
3300
+ "name": "toX",
3301
+ "required": true
3302
+ },
3303
+ "toY": {
3304
+ "description": "Ending viewport y coordinate.",
3305
+ "name": "toY",
3306
+ "required": true
3307
+ }
3308
+ },
3309
+ "description": "Drag from one raw viewport coordinate to another.",
3248
3310
  "examples": [
3249
- "browse network off",
3250
- "browse network off --session research"
3311
+ "browse mouse drag 100 100 400 400",
3312
+ "browse mouse drag 100 100 400 400 --steps 20 --delay 10",
3313
+ "browse mouse drag 100 100 400 400 --return-xpath"
3251
3314
  ],
3252
3315
  "flags": {
3253
3316
  "auto-connect": {
@@ -3326,11 +3389,49 @@
3326
3389
  "helpValue": "<target-id>",
3327
3390
  "multiple": false,
3328
3391
  "type": "option"
3392
+ },
3393
+ "button": {
3394
+ "description": "Mouse button to use.",
3395
+ "name": "button",
3396
+ "default": "left",
3397
+ "hasDynamicHelp": false,
3398
+ "helpValue": "<button>",
3399
+ "multiple": false,
3400
+ "options": [
3401
+ "left",
3402
+ "middle",
3403
+ "right"
3404
+ ],
3405
+ "type": "option"
3406
+ },
3407
+ "delay": {
3408
+ "description": "Delay between drag steps in milliseconds.",
3409
+ "name": "delay",
3410
+ "default": 0,
3411
+ "hasDynamicHelp": false,
3412
+ "helpValue": "<ms>",
3413
+ "multiple": false,
3414
+ "type": "option"
3415
+ },
3416
+ "return-xpath": {
3417
+ "description": "Include the XPath under the start/end coordinates when the driver can return it.",
3418
+ "name": "return-xpath",
3419
+ "allowNo": false,
3420
+ "type": "boolean"
3421
+ },
3422
+ "steps": {
3423
+ "description": "Number of intermediate drag steps.",
3424
+ "name": "steps",
3425
+ "default": 10,
3426
+ "hasDynamicHelp": false,
3427
+ "helpValue": "<steps>",
3428
+ "multiple": false,
3429
+ "type": "option"
3329
3430
  }
3330
3431
  },
3331
3432
  "hasDynamicHelp": false,
3332
3433
  "hiddenAliases": [],
3333
- "id": "network:off",
3434
+ "id": "mouse:drag",
3334
3435
  "pluginAlias": "browse",
3335
3436
  "pluginName": "browse",
3336
3437
  "pluginType": "core",
@@ -3339,17 +3440,29 @@
3339
3440
  "relativePath": [
3340
3441
  "dist",
3341
3442
  "commands",
3342
- "network",
3343
- "off.js"
3443
+ "mouse",
3444
+ "drag.js"
3344
3445
  ]
3345
3446
  },
3346
- "network:on": {
3447
+ "mouse:hover": {
3347
3448
  "aliases": [],
3348
- "args": {},
3349
- "description": "Enable network capture for the active browser session.",
3449
+ "args": {
3450
+ "x": {
3451
+ "description": "Viewport x coordinate.",
3452
+ "name": "x",
3453
+ "required": true
3454
+ },
3455
+ "y": {
3456
+ "description": "Viewport y coordinate.",
3457
+ "name": "y",
3458
+ "required": true
3459
+ }
3460
+ },
3461
+ "description": "Move the mouse to raw viewport coordinates in the active page.",
3350
3462
  "examples": [
3351
- "browse network on",
3352
- "browse network on --session research"
3463
+ "browse mouse hover 240 320",
3464
+ "browse mouse hover 240 320 --return-xpath",
3465
+ "browse mouse hover 240 320 --session research"
3353
3466
  ],
3354
3467
  "flags": {
3355
3468
  "auto-connect": {
@@ -3428,11 +3541,17 @@
3428
3541
  "helpValue": "<target-id>",
3429
3542
  "multiple": false,
3430
3543
  "type": "option"
3544
+ },
3545
+ "return-xpath": {
3546
+ "description": "Include the XPath under the coordinate when the driver can return it.",
3547
+ "name": "return-xpath",
3548
+ "allowNo": false,
3549
+ "type": "boolean"
3431
3550
  }
3432
3551
  },
3433
3552
  "hasDynamicHelp": false,
3434
3553
  "hiddenAliases": [],
3435
- "id": "network:on",
3554
+ "id": "mouse:hover",
3436
3555
  "pluginAlias": "browse",
3437
3556
  "pluginName": "browse",
3438
3557
  "pluginType": "core",
@@ -3441,17 +3560,39 @@
3441
3560
  "relativePath": [
3442
3561
  "dist",
3443
3562
  "commands",
3444
- "network",
3445
- "on.js"
3563
+ "mouse",
3564
+ "hover.js"
3446
3565
  ]
3447
3566
  },
3448
- "network:path": {
3567
+ "mouse:scroll": {
3449
3568
  "aliases": [],
3450
- "args": {},
3451
- "description": "Print the network capture directory for the active browser session.",
3569
+ "args": {
3570
+ "x": {
3571
+ "description": "Viewport x coordinate.",
3572
+ "name": "x",
3573
+ "required": true
3574
+ },
3575
+ "y": {
3576
+ "description": "Viewport y coordinate.",
3577
+ "name": "y",
3578
+ "required": true
3579
+ },
3580
+ "deltaX": {
3581
+ "description": "Horizontal scroll delta.",
3582
+ "name": "deltaX",
3583
+ "required": true
3584
+ },
3585
+ "deltaY": {
3586
+ "description": "Vertical scroll delta.",
3587
+ "name": "deltaY",
3588
+ "required": true
3589
+ }
3590
+ },
3591
+ "description": "Scroll from raw viewport coordinates in the active page.",
3452
3592
  "examples": [
3453
- "browse network path",
3454
- "browse network path --session research"
3593
+ "browse mouse scroll 400 500 0 600",
3594
+ "browse mouse scroll 400 500 0 -600",
3595
+ "browse mouse scroll 400 500 0 600 --return-xpath"
3455
3596
  ],
3456
3597
  "flags": {
3457
3598
  "auto-connect": {
@@ -3530,11 +3671,17 @@
3530
3671
  "helpValue": "<target-id>",
3531
3672
  "multiple": false,
3532
3673
  "type": "option"
3674
+ },
3675
+ "return-xpath": {
3676
+ "description": "Include the XPath under the coordinate when the driver can return it.",
3677
+ "name": "return-xpath",
3678
+ "allowNo": false,
3679
+ "type": "boolean"
3533
3680
  }
3534
3681
  },
3535
3682
  "hasDynamicHelp": false,
3536
3683
  "hiddenAliases": [],
3537
- "id": "network:path",
3684
+ "id": "mouse:scroll",
3538
3685
  "pluginAlias": "browse",
3539
3686
  "pluginName": "browse",
3540
3687
  "pluginType": "core",
@@ -3543,190 +3690,100 @@
3543
3690
  "relativePath": [
3544
3691
  "dist",
3545
3692
  "commands",
3546
- "network",
3547
- "path.js"
3693
+ "mouse",
3694
+ "scroll.js"
3548
3695
  ]
3549
3696
  },
3550
- "skills:add": {
3697
+ "network:clear": {
3551
3698
  "aliases": [],
3552
- "args": {
3553
- "skill": {
3554
- "description": "Skill id in the form <domain>/<task>.",
3555
- "name": "skill",
3556
- "required": false
3557
- }
3558
- },
3559
- "description": "Install a browser automation skill.",
3699
+ "args": {},
3700
+ "description": "Clear captured network request directories for the active browser session.",
3560
3701
  "examples": [
3561
- "browse skills add yelp.com/extract-reviews",
3562
- "browse skills add mcdonalds.order.online/order-delivery-42q71n"
3563
- ],
3564
- "flags": {},
3565
- "hasDynamicHelp": false,
3566
- "hiddenAliases": [],
3567
- "id": "skills:add",
3568
- "pluginAlias": "browse",
3569
- "pluginName": "browse",
3570
- "pluginType": "core",
3571
- "strict": true,
3572
- "isESM": true,
3573
- "relativePath": [
3574
- "dist",
3575
- "commands",
3576
- "skills",
3577
- "add.js"
3578
- ]
3579
- },
3580
- "skills:find": {
3581
- "aliases": [],
3582
- "args": {
3583
- "query": {
3584
- "description": "Skill slug or search query.",
3585
- "name": "query",
3586
- "required": true
3587
- }
3588
- },
3589
- "description": "Find Browse.sh catalog skills by slug, domain, title, description, category, alias, or tag.",
3590
- "examples": [
3591
- "browse skills find yelp",
3592
- "browse skills find reviews",
3593
- "browse skills find yelp.com/extract-reviews",
3594
- "browse skills find travel --limit 5",
3595
- "browse skills find \"restaurant reviews\" --json"
3702
+ "browse network clear",
3703
+ "browse network clear --session research"
3596
3704
  ],
3597
3705
  "flags": {
3598
- "format": {
3599
- "description": "Output format. Defaults to table in a terminal and JSON when piped.",
3600
- "name": "format",
3706
+ "auto-connect": {
3707
+ "description": "Auto-discover and attach to a local browser with remote debugging enabled.",
3708
+ "name": "auto-connect",
3709
+ "allowNo": false,
3710
+ "type": "boolean"
3711
+ },
3712
+ "cdp": {
3713
+ "description": "Attach directly to a CDP endpoint. Accepts a port, http(s) URL, or ws(s) URL.",
3714
+ "name": "cdp",
3601
3715
  "hasDynamicHelp": false,
3602
- "helpValue": "<format>",
3716
+ "helpValue": "<url|port>",
3603
3717
  "multiple": false,
3604
- "options": [
3605
- "table",
3606
- "json"
3607
- ],
3608
3718
  "type": "option"
3609
3719
  },
3610
- "json": {
3611
- "description": "Print raw JSON output.",
3612
- "name": "json",
3613
- "allowNo": false,
3614
- "type": "boolean"
3720
+ "chrome-arg": {
3721
+ "description": "Add a Chrome launch arg for managed local sessions. Repeatable.",
3722
+ "name": "chrome-arg",
3723
+ "hasDynamicHelp": false,
3724
+ "helpValue": "<flag>",
3725
+ "multiple": true,
3726
+ "type": "option"
3615
3727
  },
3616
- "wide": {
3617
- "description": "Show full table values without truncation.",
3618
- "name": "wide",
3728
+ "headed": {
3729
+ "description": "Show a visible browser window for managed local sessions.",
3730
+ "name": "headed",
3619
3731
  "allowNo": false,
3620
3732
  "type": "boolean"
3621
3733
  },
3622
- "all": {
3623
- "description": "Show all matching skills in table output.",
3624
- "name": "all",
3734
+ "headless": {
3735
+ "description": "Run managed local sessions in headless mode.",
3736
+ "name": "headless",
3625
3737
  "allowNo": false,
3626
3738
  "type": "boolean"
3627
3739
  },
3628
- "limit": {
3629
- "description": "Maximum matching skills to show in table output.",
3630
- "name": "limit",
3631
- "default": 25,
3632
- "hasDynamicHelp": false,
3633
- "helpValue": "<count>",
3634
- "multiple": false,
3635
- "type": "option"
3636
- }
3637
- },
3638
- "hasDynamicHelp": false,
3639
- "hiddenAliases": [],
3640
- "id": "skills:find",
3641
- "pluginAlias": "browse",
3642
- "pluginName": "browse",
3643
- "pluginType": "core",
3644
- "strict": true,
3645
- "isESM": true,
3646
- "relativePath": [
3647
- "dist",
3648
- "commands",
3649
- "skills",
3650
- "find.js"
3651
- ]
3652
- },
3653
- "skills:install": {
3654
- "aliases": [],
3655
- "args": {},
3656
- "description": "Install the bundled browse CLI skill.",
3657
- "examples": [
3658
- "browse skills install"
3659
- ],
3660
- "flags": {},
3661
- "hasDynamicHelp": false,
3662
- "hiddenAliases": [],
3663
- "id": "skills:install",
3664
- "pluginAlias": "browse",
3665
- "pluginName": "browse",
3666
- "pluginType": "core",
3667
- "strict": true,
3668
- "isESM": true,
3669
- "relativePath": [
3670
- "dist",
3671
- "commands",
3672
- "skills",
3673
- "install.js"
3674
- ]
3675
- },
3676
- "skills:list": {
3677
- "aliases": [],
3678
- "args": {},
3679
- "description": "List Browse.sh catalog skills.",
3680
- "examples": [
3681
- "browse skills list",
3682
- "browse skills list --limit 10",
3683
- "browse skills list --all",
3684
- "browse skills list --json"
3685
- ],
3686
- "flags": {
3687
- "format": {
3688
- "description": "Output format. Defaults to table in a terminal and JSON when piped.",
3689
- "name": "format",
3740
+ "ignore-default-chrome-arg": {
3741
+ "description": "Drop one of Chrome's default launch args for managed local sessions. Repeatable.",
3742
+ "name": "ignore-default-chrome-arg",
3690
3743
  "hasDynamicHelp": false,
3691
- "helpValue": "<format>",
3692
- "multiple": false,
3693
- "options": [
3694
- "table",
3695
- "json"
3696
- ],
3744
+ "helpValue": "<flag>",
3745
+ "multiple": true,
3697
3746
  "type": "option"
3698
3747
  },
3699
- "json": {
3700
- "description": "Print raw JSON output.",
3701
- "name": "json",
3748
+ "local": {
3749
+ "description": "Use a managed local browser session.",
3750
+ "name": "local",
3702
3751
  "allowNo": false,
3703
3752
  "type": "boolean"
3704
3753
  },
3705
- "wide": {
3706
- "description": "Show full table values without truncation.",
3707
- "name": "wide",
3754
+ "no-default-chrome-args": {
3755
+ "description": "Launch managed local Chrome without any of its default launch args.",
3756
+ "name": "no-default-chrome-args",
3708
3757
  "allowNo": false,
3709
3758
  "type": "boolean"
3710
3759
  },
3711
- "all": {
3712
- "description": "Show all returned skills in table output.",
3713
- "name": "all",
3760
+ "remote": {
3761
+ "description": "Use a remote Browserbase browser session.",
3762
+ "name": "remote",
3714
3763
  "allowNo": false,
3715
3764
  "type": "boolean"
3716
3765
  },
3717
- "limit": {
3718
- "description": "Maximum skills to show in table output.",
3719
- "name": "limit",
3720
- "default": 25,
3766
+ "session": {
3767
+ "char": "s",
3768
+ "description": "Named browser session to use. Defaults to BROWSE_SESSION or default.",
3769
+ "name": "session",
3721
3770
  "hasDynamicHelp": false,
3722
- "helpValue": "<count>",
3771
+ "helpValue": "<name>",
3772
+ "multiple": false,
3773
+ "type": "option"
3774
+ },
3775
+ "target-id": {
3776
+ "description": "Select a specific CDP target when attaching to an existing browser.",
3777
+ "name": "target-id",
3778
+ "hasDynamicHelp": false,
3779
+ "helpValue": "<target-id>",
3723
3780
  "multiple": false,
3724
3781
  "type": "option"
3725
3782
  }
3726
3783
  },
3727
3784
  "hasDynamicHelp": false,
3728
3785
  "hiddenAliases": [],
3729
- "id": "skills:list",
3786
+ "id": "network:clear",
3730
3787
  "pluginAlias": "browse",
3731
3788
  "pluginName": "browse",
3732
3789
  "pluginType": "core",
@@ -3735,29 +3792,17 @@
3735
3792
  "relativePath": [
3736
3793
  "dist",
3737
3794
  "commands",
3738
- "skills",
3739
- "list.js"
3795
+ "network",
3796
+ "clear.js"
3740
3797
  ]
3741
3798
  },
3742
- "mouse:click": {
3799
+ "network:off": {
3743
3800
  "aliases": [],
3744
- "args": {
3745
- "x": {
3746
- "description": "Viewport x coordinate.",
3747
- "name": "x",
3748
- "required": true
3749
- },
3750
- "y": {
3751
- "description": "Viewport y coordinate.",
3752
- "name": "y",
3753
- "required": true
3754
- }
3755
- },
3756
- "description": "Click raw viewport coordinates in the active page.",
3801
+ "args": {},
3802
+ "description": "Disable network capture for the active browser session.",
3757
3803
  "examples": [
3758
- "browse mouse click 240 320",
3759
- "browse mouse click 240 320 --button right",
3760
- "browse mouse click 240 320 --click-count 2 --return-xpath"
3804
+ "browse network off",
3805
+ "browse network off --session research"
3761
3806
  ],
3762
3807
  "flags": {
3763
3808
  "auto-connect": {
@@ -3836,40 +3881,11 @@
3836
3881
  "helpValue": "<target-id>",
3837
3882
  "multiple": false,
3838
3883
  "type": "option"
3839
- },
3840
- "button": {
3841
- "description": "Mouse button to use.",
3842
- "name": "button",
3843
- "default": "left",
3844
- "hasDynamicHelp": false,
3845
- "helpValue": "<button>",
3846
- "multiple": false,
3847
- "options": [
3848
- "left",
3849
- "middle",
3850
- "right"
3851
- ],
3852
- "type": "option"
3853
- },
3854
- "click-count": {
3855
- "description": "Number of clicks to send.",
3856
- "name": "click-count",
3857
- "default": 1,
3858
- "hasDynamicHelp": false,
3859
- "helpValue": "<count>",
3860
- "multiple": false,
3861
- "type": "option"
3862
- },
3863
- "return-xpath": {
3864
- "description": "Include the XPath under the coordinate when the driver can return it.",
3865
- "name": "return-xpath",
3866
- "allowNo": false,
3867
- "type": "boolean"
3868
3884
  }
3869
3885
  },
3870
3886
  "hasDynamicHelp": false,
3871
3887
  "hiddenAliases": [],
3872
- "id": "mouse:click",
3888
+ "id": "network:off",
3873
3889
  "pluginAlias": "browse",
3874
3890
  "pluginName": "browse",
3875
3891
  "pluginType": "core",
@@ -3878,39 +3894,17 @@
3878
3894
  "relativePath": [
3879
3895
  "dist",
3880
3896
  "commands",
3881
- "mouse",
3882
- "click.js"
3897
+ "network",
3898
+ "off.js"
3883
3899
  ]
3884
3900
  },
3885
- "mouse:drag": {
3901
+ "network:on": {
3886
3902
  "aliases": [],
3887
- "args": {
3888
- "fromX": {
3889
- "description": "Starting viewport x coordinate.",
3890
- "name": "fromX",
3891
- "required": true
3892
- },
3893
- "fromY": {
3894
- "description": "Starting viewport y coordinate.",
3895
- "name": "fromY",
3896
- "required": true
3897
- },
3898
- "toX": {
3899
- "description": "Ending viewport x coordinate.",
3900
- "name": "toX",
3901
- "required": true
3902
- },
3903
- "toY": {
3904
- "description": "Ending viewport y coordinate.",
3905
- "name": "toY",
3906
- "required": true
3907
- }
3908
- },
3909
- "description": "Drag from one raw viewport coordinate to another.",
3903
+ "args": {},
3904
+ "description": "Enable network capture for the active browser session.",
3910
3905
  "examples": [
3911
- "browse mouse drag 100 100 400 400",
3912
- "browse mouse drag 100 100 400 400 --steps 20 --delay 10",
3913
- "browse mouse drag 100 100 400 400 --return-xpath"
3906
+ "browse network on",
3907
+ "browse network on --session research"
3914
3908
  ],
3915
3909
  "flags": {
3916
3910
  "auto-connect": {
@@ -3989,49 +3983,11 @@
3989
3983
  "helpValue": "<target-id>",
3990
3984
  "multiple": false,
3991
3985
  "type": "option"
3992
- },
3993
- "button": {
3994
- "description": "Mouse button to use.",
3995
- "name": "button",
3996
- "default": "left",
3997
- "hasDynamicHelp": false,
3998
- "helpValue": "<button>",
3999
- "multiple": false,
4000
- "options": [
4001
- "left",
4002
- "middle",
4003
- "right"
4004
- ],
4005
- "type": "option"
4006
- },
4007
- "delay": {
4008
- "description": "Delay between drag steps in milliseconds.",
4009
- "name": "delay",
4010
- "default": 0,
4011
- "hasDynamicHelp": false,
4012
- "helpValue": "<ms>",
4013
- "multiple": false,
4014
- "type": "option"
4015
- },
4016
- "return-xpath": {
4017
- "description": "Include the XPath under the start/end coordinates when the driver can return it.",
4018
- "name": "return-xpath",
4019
- "allowNo": false,
4020
- "type": "boolean"
4021
- },
4022
- "steps": {
4023
- "description": "Number of intermediate drag steps.",
4024
- "name": "steps",
4025
- "default": 10,
4026
- "hasDynamicHelp": false,
4027
- "helpValue": "<steps>",
4028
- "multiple": false,
4029
- "type": "option"
4030
3986
  }
4031
3987
  },
4032
3988
  "hasDynamicHelp": false,
4033
3989
  "hiddenAliases": [],
4034
- "id": "mouse:drag",
3990
+ "id": "network:on",
4035
3991
  "pluginAlias": "browse",
4036
3992
  "pluginName": "browse",
4037
3993
  "pluginType": "core",
@@ -4040,29 +3996,17 @@
4040
3996
  "relativePath": [
4041
3997
  "dist",
4042
3998
  "commands",
4043
- "mouse",
4044
- "drag.js"
3999
+ "network",
4000
+ "on.js"
4045
4001
  ]
4046
4002
  },
4047
- "mouse:hover": {
4003
+ "network:path": {
4048
4004
  "aliases": [],
4049
- "args": {
4050
- "x": {
4051
- "description": "Viewport x coordinate.",
4052
- "name": "x",
4053
- "required": true
4054
- },
4055
- "y": {
4056
- "description": "Viewport y coordinate.",
4057
- "name": "y",
4058
- "required": true
4059
- }
4060
- },
4061
- "description": "Move the mouse to raw viewport coordinates in the active page.",
4005
+ "args": {},
4006
+ "description": "Print the network capture directory for the active browser session.",
4062
4007
  "examples": [
4063
- "browse mouse hover 240 320",
4064
- "browse mouse hover 240 320 --return-xpath",
4065
- "browse mouse hover 240 320 --session research"
4008
+ "browse network path",
4009
+ "browse network path --session research"
4066
4010
  ],
4067
4011
  "flags": {
4068
4012
  "auto-connect": {
@@ -4141,17 +4085,11 @@
4141
4085
  "helpValue": "<target-id>",
4142
4086
  "multiple": false,
4143
4087
  "type": "option"
4144
- },
4145
- "return-xpath": {
4146
- "description": "Include the XPath under the coordinate when the driver can return it.",
4147
- "name": "return-xpath",
4148
- "allowNo": false,
4149
- "type": "boolean"
4150
4088
  }
4151
4089
  },
4152
4090
  "hasDynamicHelp": false,
4153
4091
  "hiddenAliases": [],
4154
- "id": "mouse:hover",
4092
+ "id": "network:path",
4155
4093
  "pluginAlias": "browse",
4156
4094
  "pluginName": "browse",
4157
4095
  "pluginType": "core",
@@ -4160,128 +4098,190 @@
4160
4098
  "relativePath": [
4161
4099
  "dist",
4162
4100
  "commands",
4163
- "mouse",
4164
- "hover.js"
4101
+ "network",
4102
+ "path.js"
4165
4103
  ]
4166
4104
  },
4167
- "mouse:scroll": {
4105
+ "skills:add": {
4168
4106
  "aliases": [],
4169
4107
  "args": {
4170
- "x": {
4171
- "description": "Viewport x coordinate.",
4172
- "name": "x",
4108
+ "skill": {
4109
+ "description": "Skill id in the form <domain>/<task>.",
4110
+ "name": "skill",
4111
+ "required": false
4112
+ }
4113
+ },
4114
+ "description": "Install a browser automation skill.",
4115
+ "examples": [
4116
+ "browse skills add yelp.com/extract-reviews",
4117
+ "browse skills add mcdonalds.order.online/order-delivery-42q71n"
4118
+ ],
4119
+ "flags": {},
4120
+ "hasDynamicHelp": false,
4121
+ "hiddenAliases": [],
4122
+ "id": "skills:add",
4123
+ "pluginAlias": "browse",
4124
+ "pluginName": "browse",
4125
+ "pluginType": "core",
4126
+ "strict": true,
4127
+ "isESM": true,
4128
+ "relativePath": [
4129
+ "dist",
4130
+ "commands",
4131
+ "skills",
4132
+ "add.js"
4133
+ ]
4134
+ },
4135
+ "skills:find": {
4136
+ "aliases": [],
4137
+ "args": {
4138
+ "query": {
4139
+ "description": "Skill slug or search query.",
4140
+ "name": "query",
4173
4141
  "required": true
4142
+ }
4143
+ },
4144
+ "description": "Find Browse.sh catalog skills by slug, domain, title, description, category, alias, or tag.",
4145
+ "examples": [
4146
+ "browse skills find yelp",
4147
+ "browse skills find reviews",
4148
+ "browse skills find yelp.com/extract-reviews",
4149
+ "browse skills find travel --limit 5",
4150
+ "browse skills find \"restaurant reviews\" --json"
4151
+ ],
4152
+ "flags": {
4153
+ "format": {
4154
+ "description": "Output format. Defaults to table in a terminal and JSON when piped.",
4155
+ "name": "format",
4156
+ "hasDynamicHelp": false,
4157
+ "helpValue": "<format>",
4158
+ "multiple": false,
4159
+ "options": [
4160
+ "table",
4161
+ "json"
4162
+ ],
4163
+ "type": "option"
4174
4164
  },
4175
- "y": {
4176
- "description": "Viewport y coordinate.",
4177
- "name": "y",
4178
- "required": true
4165
+ "json": {
4166
+ "description": "Print raw JSON output.",
4167
+ "name": "json",
4168
+ "allowNo": false,
4169
+ "type": "boolean"
4179
4170
  },
4180
- "deltaX": {
4181
- "description": "Horizontal scroll delta.",
4182
- "name": "deltaX",
4183
- "required": true
4171
+ "wide": {
4172
+ "description": "Show full table values without truncation.",
4173
+ "name": "wide",
4174
+ "allowNo": false,
4175
+ "type": "boolean"
4184
4176
  },
4185
- "deltaY": {
4186
- "description": "Vertical scroll delta.",
4187
- "name": "deltaY",
4188
- "required": true
4177
+ "all": {
4178
+ "description": "Show all matching skills in table output.",
4179
+ "name": "all",
4180
+ "allowNo": false,
4181
+ "type": "boolean"
4182
+ },
4183
+ "limit": {
4184
+ "description": "Maximum matching skills to show in table output.",
4185
+ "name": "limit",
4186
+ "default": 25,
4187
+ "hasDynamicHelp": false,
4188
+ "helpValue": "<count>",
4189
+ "multiple": false,
4190
+ "type": "option"
4189
4191
  }
4190
4192
  },
4191
- "description": "Scroll from raw viewport coordinates in the active page.",
4193
+ "hasDynamicHelp": false,
4194
+ "hiddenAliases": [],
4195
+ "id": "skills:find",
4196
+ "pluginAlias": "browse",
4197
+ "pluginName": "browse",
4198
+ "pluginType": "core",
4199
+ "strict": true,
4200
+ "isESM": true,
4201
+ "relativePath": [
4202
+ "dist",
4203
+ "commands",
4204
+ "skills",
4205
+ "find.js"
4206
+ ]
4207
+ },
4208
+ "skills:install": {
4209
+ "aliases": [],
4210
+ "args": {},
4211
+ "description": "Install the bundled browse CLI skill.",
4212
+ "examples": [
4213
+ "browse skills install"
4214
+ ],
4215
+ "flags": {},
4216
+ "hasDynamicHelp": false,
4217
+ "hiddenAliases": [],
4218
+ "id": "skills:install",
4219
+ "pluginAlias": "browse",
4220
+ "pluginName": "browse",
4221
+ "pluginType": "core",
4222
+ "strict": true,
4223
+ "isESM": true,
4224
+ "relativePath": [
4225
+ "dist",
4226
+ "commands",
4227
+ "skills",
4228
+ "install.js"
4229
+ ]
4230
+ },
4231
+ "skills:list": {
4232
+ "aliases": [],
4233
+ "args": {},
4234
+ "description": "List Browse.sh catalog skills.",
4192
4235
  "examples": [
4193
- "browse mouse scroll 400 500 0 600",
4194
- "browse mouse scroll 400 500 0 -600",
4195
- "browse mouse scroll 400 500 0 600 --return-xpath"
4236
+ "browse skills list",
4237
+ "browse skills list --limit 10",
4238
+ "browse skills list --all",
4239
+ "browse skills list --json"
4196
4240
  ],
4197
4241
  "flags": {
4198
- "auto-connect": {
4199
- "description": "Auto-discover and attach to a local browser with remote debugging enabled.",
4200
- "name": "auto-connect",
4201
- "allowNo": false,
4202
- "type": "boolean"
4203
- },
4204
- "cdp": {
4205
- "description": "Attach directly to a CDP endpoint. Accepts a port, http(s) URL, or ws(s) URL.",
4206
- "name": "cdp",
4242
+ "format": {
4243
+ "description": "Output format. Defaults to table in a terminal and JSON when piped.",
4244
+ "name": "format",
4207
4245
  "hasDynamicHelp": false,
4208
- "helpValue": "<url|port>",
4246
+ "helpValue": "<format>",
4209
4247
  "multiple": false,
4248
+ "options": [
4249
+ "table",
4250
+ "json"
4251
+ ],
4210
4252
  "type": "option"
4211
4253
  },
4212
- "chrome-arg": {
4213
- "description": "Add a Chrome launch arg for managed local sessions. Repeatable.",
4214
- "name": "chrome-arg",
4215
- "hasDynamicHelp": false,
4216
- "helpValue": "<flag>",
4217
- "multiple": true,
4218
- "type": "option"
4219
- },
4220
- "headed": {
4221
- "description": "Show a visible browser window for managed local sessions.",
4222
- "name": "headed",
4223
- "allowNo": false,
4224
- "type": "boolean"
4225
- },
4226
- "headless": {
4227
- "description": "Run managed local sessions in headless mode.",
4228
- "name": "headless",
4229
- "allowNo": false,
4230
- "type": "boolean"
4231
- },
4232
- "ignore-default-chrome-arg": {
4233
- "description": "Drop one of Chrome's default launch args for managed local sessions. Repeatable.",
4234
- "name": "ignore-default-chrome-arg",
4235
- "hasDynamicHelp": false,
4236
- "helpValue": "<flag>",
4237
- "multiple": true,
4238
- "type": "option"
4239
- },
4240
- "local": {
4241
- "description": "Use a managed local browser session.",
4242
- "name": "local",
4254
+ "json": {
4255
+ "description": "Print raw JSON output.",
4256
+ "name": "json",
4243
4257
  "allowNo": false,
4244
4258
  "type": "boolean"
4245
4259
  },
4246
- "no-default-chrome-args": {
4247
- "description": "Launch managed local Chrome without any of its default launch args.",
4248
- "name": "no-default-chrome-args",
4260
+ "wide": {
4261
+ "description": "Show full table values without truncation.",
4262
+ "name": "wide",
4249
4263
  "allowNo": false,
4250
4264
  "type": "boolean"
4251
4265
  },
4252
- "remote": {
4253
- "description": "Use a remote Browserbase browser session.",
4254
- "name": "remote",
4266
+ "all": {
4267
+ "description": "Show all returned skills in table output.",
4268
+ "name": "all",
4255
4269
  "allowNo": false,
4256
4270
  "type": "boolean"
4257
4271
  },
4258
- "session": {
4259
- "char": "s",
4260
- "description": "Named browser session to use. Defaults to BROWSE_SESSION or default.",
4261
- "name": "session",
4262
- "hasDynamicHelp": false,
4263
- "helpValue": "<name>",
4264
- "multiple": false,
4265
- "type": "option"
4266
- },
4267
- "target-id": {
4268
- "description": "Select a specific CDP target when attaching to an existing browser.",
4269
- "name": "target-id",
4272
+ "limit": {
4273
+ "description": "Maximum skills to show in table output.",
4274
+ "name": "limit",
4275
+ "default": 25,
4270
4276
  "hasDynamicHelp": false,
4271
- "helpValue": "<target-id>",
4277
+ "helpValue": "<count>",
4272
4278
  "multiple": false,
4273
4279
  "type": "option"
4274
- },
4275
- "return-xpath": {
4276
- "description": "Include the XPath under the coordinate when the driver can return it.",
4277
- "name": "return-xpath",
4278
- "allowNo": false,
4279
- "type": "boolean"
4280
4280
  }
4281
4281
  },
4282
4282
  "hasDynamicHelp": false,
4283
4283
  "hiddenAliases": [],
4284
- "id": "mouse:scroll",
4284
+ "id": "skills:list",
4285
4285
  "pluginAlias": "browse",
4286
4286
  "pluginName": "browse",
4287
4287
  "pluginType": "core",
@@ -4290,8 +4290,8 @@
4290
4290
  "relativePath": [
4291
4291
  "dist",
4292
4292
  "commands",
4293
- "mouse",
4294
- "scroll.js"
4293
+ "skills",
4294
+ "list.js"
4295
4295
  ]
4296
4296
  },
4297
4297
  "tab:close": {
@@ -4913,18 +4913,14 @@
4913
4913
  "list.js"
4914
4914
  ]
4915
4915
  },
4916
- "cloud:extensions:delete": {
4916
+ "cloud:contexts:create": {
4917
4917
  "aliases": [],
4918
- "args": {
4919
- "id": {
4920
- "description": "Extension ID.",
4921
- "name": "id",
4922
- "required": true
4923
- }
4924
- },
4925
- "description": "Delete a Chrome extension.",
4918
+ "args": {},
4919
+ "description": "Create a Browserbase context.",
4926
4920
  "examples": [
4927
- "browse cloud extensions delete <extension-id>"
4921
+ "browse cloud contexts create",
4922
+ "browse cloud contexts create --body '{\"region\":\"us-west-2\"}'",
4923
+ "echo '{\"region\":\"us-west-2\"}' | browse cloud contexts create --stdin"
4928
4924
  ],
4929
4925
  "flags": {
4930
4926
  "api-key": {
@@ -4942,11 +4938,25 @@
4942
4938
  "helpValue": "<baseUrl>",
4943
4939
  "multiple": false,
4944
4940
  "type": "option"
4941
+ },
4942
+ "body": {
4943
+ "description": "Optional JSON request body.",
4944
+ "name": "body",
4945
+ "hasDynamicHelp": false,
4946
+ "helpValue": "<body>",
4947
+ "multiple": false,
4948
+ "type": "option"
4949
+ },
4950
+ "stdin": {
4951
+ "description": "Read JSON request body from stdin.",
4952
+ "name": "stdin",
4953
+ "allowNo": false,
4954
+ "type": "boolean"
4945
4955
  }
4946
4956
  },
4947
4957
  "hasDynamicHelp": false,
4948
4958
  "hiddenAliases": [],
4949
- "id": "cloud:extensions:delete",
4959
+ "id": "cloud:contexts:create",
4950
4960
  "pluginAlias": "browse",
4951
4961
  "pluginName": "browse",
4952
4962
  "pluginType": "core",
@@ -4956,22 +4966,22 @@
4956
4966
  "dist",
4957
4967
  "commands",
4958
4968
  "cloud",
4959
- "extensions",
4960
- "delete.js"
4969
+ "contexts",
4970
+ "create.js"
4961
4971
  ]
4962
4972
  },
4963
- "cloud:extensions:get": {
4973
+ "cloud:contexts:delete": {
4964
4974
  "aliases": [],
4965
4975
  "args": {
4966
4976
  "id": {
4967
- "description": "Extension ID.",
4977
+ "description": "Context ID.",
4968
4978
  "name": "id",
4969
4979
  "required": true
4970
4980
  }
4971
4981
  },
4972
- "description": "Get a Chrome extension by ID.",
4982
+ "description": "Delete a Browserbase context.",
4973
4983
  "examples": [
4974
- "browse cloud extensions get <extension-id>"
4984
+ "browse cloud contexts delete <context-id>"
4975
4985
  ],
4976
4986
  "flags": {
4977
4987
  "api-key": {
@@ -4993,7 +5003,7 @@
4993
5003
  },
4994
5004
  "hasDynamicHelp": false,
4995
5005
  "hiddenAliases": [],
4996
- "id": "cloud:extensions:get",
5006
+ "id": "cloud:contexts:delete",
4997
5007
  "pluginAlias": "browse",
4998
5008
  "pluginName": "browse",
4999
5009
  "pluginType": "core",
@@ -5003,22 +5013,22 @@
5003
5013
  "dist",
5004
5014
  "commands",
5005
5015
  "cloud",
5006
- "extensions",
5007
- "get.js"
5016
+ "contexts",
5017
+ "delete.js"
5008
5018
  ]
5009
5019
  },
5010
- "cloud:extensions:upload": {
5020
+ "cloud:contexts:get": {
5011
5021
  "aliases": [],
5012
5022
  "args": {
5013
- "file": {
5014
- "description": "Path to extension ZIP file.",
5015
- "name": "file",
5023
+ "id": {
5024
+ "description": "Context ID.",
5025
+ "name": "id",
5016
5026
  "required": true
5017
5027
  }
5018
5028
  },
5019
- "description": "Upload a Chrome extension ZIP file.",
5029
+ "description": "Get a Browserbase context by ID.",
5020
5030
  "examples": [
5021
- "browse cloud extensions upload ./extension.zip"
5031
+ "browse cloud contexts get <context-id>"
5022
5032
  ],
5023
5033
  "flags": {
5024
5034
  "api-key": {
@@ -5040,7 +5050,7 @@
5040
5050
  },
5041
5051
  "hasDynamicHelp": false,
5042
5052
  "hiddenAliases": [],
5043
- "id": "cloud:extensions:upload",
5053
+ "id": "cloud:contexts:get",
5044
5054
  "pluginAlias": "browse",
5045
5055
  "pluginName": "browse",
5046
5056
  "pluginType": "core",
@@ -5050,18 +5060,22 @@
5050
5060
  "dist",
5051
5061
  "commands",
5052
5062
  "cloud",
5053
- "extensions",
5054
- "upload.js"
5063
+ "contexts",
5064
+ "get.js"
5055
5065
  ]
5056
5066
  },
5057
- "cloud:contexts:create": {
5067
+ "cloud:contexts:update": {
5058
5068
  "aliases": [],
5059
- "args": {},
5060
- "description": "Create a Browserbase context.",
5069
+ "args": {
5070
+ "id": {
5071
+ "description": "Context ID.",
5072
+ "name": "id",
5073
+ "required": true
5074
+ }
5075
+ },
5076
+ "description": "Refresh the upload URL for a Browserbase context.",
5061
5077
  "examples": [
5062
- "browse cloud contexts create",
5063
- "browse cloud contexts create --body '{\"region\":\"us-west-2\"}'",
5064
- "echo '{\"region\":\"us-west-2\"}' | browse cloud contexts create --stdin"
5078
+ "browse cloud contexts update <context-id>"
5065
5079
  ],
5066
5080
  "flags": {
5067
5081
  "api-key": {
@@ -5079,25 +5093,11 @@
5079
5093
  "helpValue": "<baseUrl>",
5080
5094
  "multiple": false,
5081
5095
  "type": "option"
5082
- },
5083
- "body": {
5084
- "description": "Optional JSON request body.",
5085
- "name": "body",
5086
- "hasDynamicHelp": false,
5087
- "helpValue": "<body>",
5088
- "multiple": false,
5089
- "type": "option"
5090
- },
5091
- "stdin": {
5092
- "description": "Read JSON request body from stdin.",
5093
- "name": "stdin",
5094
- "allowNo": false,
5095
- "type": "boolean"
5096
5096
  }
5097
5097
  },
5098
5098
  "hasDynamicHelp": false,
5099
5099
  "hiddenAliases": [],
5100
- "id": "cloud:contexts:create",
5100
+ "id": "cloud:contexts:update",
5101
5101
  "pluginAlias": "browse",
5102
5102
  "pluginName": "browse",
5103
5103
  "pluginType": "core",
@@ -5108,21 +5108,21 @@
5108
5108
  "commands",
5109
5109
  "cloud",
5110
5110
  "contexts",
5111
- "create.js"
5111
+ "update.js"
5112
5112
  ]
5113
5113
  },
5114
- "cloud:contexts:delete": {
5114
+ "cloud:extensions:delete": {
5115
5115
  "aliases": [],
5116
5116
  "args": {
5117
5117
  "id": {
5118
- "description": "Context ID.",
5118
+ "description": "Extension ID.",
5119
5119
  "name": "id",
5120
5120
  "required": true
5121
5121
  }
5122
5122
  },
5123
- "description": "Delete a Browserbase context.",
5123
+ "description": "Delete a Chrome extension.",
5124
5124
  "examples": [
5125
- "browse cloud contexts delete <context-id>"
5125
+ "browse cloud extensions delete <extension-id>"
5126
5126
  ],
5127
5127
  "flags": {
5128
5128
  "api-key": {
@@ -5144,7 +5144,7 @@
5144
5144
  },
5145
5145
  "hasDynamicHelp": false,
5146
5146
  "hiddenAliases": [],
5147
- "id": "cloud:contexts:delete",
5147
+ "id": "cloud:extensions:delete",
5148
5148
  "pluginAlias": "browse",
5149
5149
  "pluginName": "browse",
5150
5150
  "pluginType": "core",
@@ -5154,22 +5154,22 @@
5154
5154
  "dist",
5155
5155
  "commands",
5156
5156
  "cloud",
5157
- "contexts",
5157
+ "extensions",
5158
5158
  "delete.js"
5159
5159
  ]
5160
5160
  },
5161
- "cloud:contexts:get": {
5161
+ "cloud:extensions:get": {
5162
5162
  "aliases": [],
5163
5163
  "args": {
5164
5164
  "id": {
5165
- "description": "Context ID.",
5165
+ "description": "Extension ID.",
5166
5166
  "name": "id",
5167
5167
  "required": true
5168
5168
  }
5169
5169
  },
5170
- "description": "Get a Browserbase context by ID.",
5170
+ "description": "Get a Chrome extension by ID.",
5171
5171
  "examples": [
5172
- "browse cloud contexts get <context-id>"
5172
+ "browse cloud extensions get <extension-id>"
5173
5173
  ],
5174
5174
  "flags": {
5175
5175
  "api-key": {
@@ -5191,7 +5191,7 @@
5191
5191
  },
5192
5192
  "hasDynamicHelp": false,
5193
5193
  "hiddenAliases": [],
5194
- "id": "cloud:contexts:get",
5194
+ "id": "cloud:extensions:get",
5195
5195
  "pluginAlias": "browse",
5196
5196
  "pluginName": "browse",
5197
5197
  "pluginType": "core",
@@ -5201,22 +5201,22 @@
5201
5201
  "dist",
5202
5202
  "commands",
5203
5203
  "cloud",
5204
- "contexts",
5204
+ "extensions",
5205
5205
  "get.js"
5206
5206
  ]
5207
5207
  },
5208
- "cloud:contexts:update": {
5208
+ "cloud:extensions:upload": {
5209
5209
  "aliases": [],
5210
5210
  "args": {
5211
- "id": {
5212
- "description": "Context ID.",
5213
- "name": "id",
5211
+ "file": {
5212
+ "description": "Path to extension ZIP file.",
5213
+ "name": "file",
5214
5214
  "required": true
5215
5215
  }
5216
5216
  },
5217
- "description": "Refresh the upload URL for a Browserbase context.",
5217
+ "description": "Upload a Chrome extension ZIP file.",
5218
5218
  "examples": [
5219
- "browse cloud contexts update <context-id>"
5219
+ "browse cloud extensions upload ./extension.zip"
5220
5220
  ],
5221
5221
  "flags": {
5222
5222
  "api-key": {
@@ -5238,7 +5238,7 @@
5238
5238
  },
5239
5239
  "hasDynamicHelp": false,
5240
5240
  "hiddenAliases": [],
5241
- "id": "cloud:contexts:update",
5241
+ "id": "cloud:extensions:upload",
5242
5242
  "pluginAlias": "browse",
5243
5243
  "pluginName": "browse",
5244
5244
  "pluginType": "core",
@@ -5248,8 +5248,8 @@
5248
5248
  "dist",
5249
5249
  "commands",
5250
5250
  "cloud",
5251
- "contexts",
5252
- "update.js"
5251
+ "extensions",
5252
+ "upload.js"
5253
5253
  ]
5254
5254
  },
5255
5255
  "cloud:projects:get": {
@@ -6003,5 +6003,5 @@
6003
6003
  ]
6004
6004
  }
6005
6005
  },
6006
- "version": "0.9.0"
6006
+ "version": "0.9.1"
6007
6007
  }