browse 0.9.5-alpha-04c8ee4 → 0.9.6

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 (2) hide show
  1. package/oclif.manifest.json +466 -466
  2. package/package.json +1 -1
@@ -3285,25 +3285,13 @@
3285
3285
  "publish.js"
3286
3286
  ]
3287
3287
  },
3288
- "mouse:click": {
3288
+ "network:clear": {
3289
3289
  "aliases": [],
3290
- "args": {
3291
- "x": {
3292
- "description": "Viewport x coordinate.",
3293
- "name": "x",
3294
- "required": true
3295
- },
3296
- "y": {
3297
- "description": "Viewport y coordinate.",
3298
- "name": "y",
3299
- "required": true
3300
- }
3301
- },
3302
- "description": "Click raw viewport coordinates in the active page.",
3290
+ "args": {},
3291
+ "description": "Clear captured network request directories for the active browser session.",
3303
3292
  "examples": [
3304
- "browse mouse click 240 320",
3305
- "browse mouse click 240 320 --button right",
3306
- "browse mouse click 240 320 --click-count 2 --return-xpath"
3293
+ "browse network clear",
3294
+ "browse network clear --session research"
3307
3295
  ],
3308
3296
  "flags": {
3309
3297
  "auto-connect": {
@@ -3394,40 +3382,11 @@
3394
3382
  "name": "verified",
3395
3383
  "allowNo": false,
3396
3384
  "type": "boolean"
3397
- },
3398
- "button": {
3399
- "description": "Mouse button to use.",
3400
- "name": "button",
3401
- "default": "left",
3402
- "hasDynamicHelp": false,
3403
- "helpValue": "<button>",
3404
- "multiple": false,
3405
- "options": [
3406
- "left",
3407
- "middle",
3408
- "right"
3409
- ],
3410
- "type": "option"
3411
- },
3412
- "click-count": {
3413
- "description": "Number of clicks to send.",
3414
- "name": "click-count",
3415
- "default": 1,
3416
- "hasDynamicHelp": false,
3417
- "helpValue": "<count>",
3418
- "multiple": false,
3419
- "type": "option"
3420
- },
3421
- "return-xpath": {
3422
- "description": "Include the XPath under the coordinate when the driver can return it.",
3423
- "name": "return-xpath",
3424
- "allowNo": false,
3425
- "type": "boolean"
3426
3385
  }
3427
3386
  },
3428
3387
  "hasDynamicHelp": false,
3429
3388
  "hiddenAliases": [],
3430
- "id": "mouse:click",
3389
+ "id": "network:clear",
3431
3390
  "pluginAlias": "browse",
3432
3391
  "pluginName": "browse",
3433
3392
  "pluginType": "core",
@@ -3436,39 +3395,17 @@
3436
3395
  "relativePath": [
3437
3396
  "dist",
3438
3397
  "commands",
3439
- "mouse",
3440
- "click.js"
3398
+ "network",
3399
+ "clear.js"
3441
3400
  ]
3442
3401
  },
3443
- "mouse:drag": {
3402
+ "network:off": {
3444
3403
  "aliases": [],
3445
- "args": {
3446
- "fromX": {
3447
- "description": "Starting viewport x coordinate.",
3448
- "name": "fromX",
3449
- "required": true
3450
- },
3451
- "fromY": {
3452
- "description": "Starting viewport y coordinate.",
3453
- "name": "fromY",
3454
- "required": true
3455
- },
3456
- "toX": {
3457
- "description": "Ending viewport x coordinate.",
3458
- "name": "toX",
3459
- "required": true
3460
- },
3461
- "toY": {
3462
- "description": "Ending viewport y coordinate.",
3463
- "name": "toY",
3464
- "required": true
3465
- }
3466
- },
3467
- "description": "Drag from one raw viewport coordinate to another.",
3404
+ "args": {},
3405
+ "description": "Disable network capture for the active browser session.",
3468
3406
  "examples": [
3469
- "browse mouse drag 100 100 400 400",
3470
- "browse mouse drag 100 100 400 400 --steps 20 --delay 10",
3471
- "browse mouse drag 100 100 400 400 --return-xpath"
3407
+ "browse network off",
3408
+ "browse network off --session research"
3472
3409
  ],
3473
3410
  "flags": {
3474
3411
  "auto-connect": {
@@ -3559,49 +3496,11 @@
3559
3496
  "name": "verified",
3560
3497
  "allowNo": false,
3561
3498
  "type": "boolean"
3562
- },
3563
- "button": {
3564
- "description": "Mouse button to use.",
3565
- "name": "button",
3566
- "default": "left",
3567
- "hasDynamicHelp": false,
3568
- "helpValue": "<button>",
3569
- "multiple": false,
3570
- "options": [
3571
- "left",
3572
- "middle",
3573
- "right"
3574
- ],
3575
- "type": "option"
3576
- },
3577
- "delay": {
3578
- "description": "Delay between drag steps in milliseconds.",
3579
- "name": "delay",
3580
- "default": 0,
3581
- "hasDynamicHelp": false,
3582
- "helpValue": "<ms>",
3583
- "multiple": false,
3584
- "type": "option"
3585
- },
3586
- "return-xpath": {
3587
- "description": "Include the XPath under the start/end coordinates when the driver can return it.",
3588
- "name": "return-xpath",
3589
- "allowNo": false,
3590
- "type": "boolean"
3591
- },
3592
- "steps": {
3593
- "description": "Number of intermediate drag steps.",
3594
- "name": "steps",
3595
- "default": 10,
3596
- "hasDynamicHelp": false,
3597
- "helpValue": "<steps>",
3598
- "multiple": false,
3599
- "type": "option"
3600
3499
  }
3601
3500
  },
3602
3501
  "hasDynamicHelp": false,
3603
3502
  "hiddenAliases": [],
3604
- "id": "mouse:drag",
3503
+ "id": "network:off",
3605
3504
  "pluginAlias": "browse",
3606
3505
  "pluginName": "browse",
3607
3506
  "pluginType": "core",
@@ -3610,29 +3509,17 @@
3610
3509
  "relativePath": [
3611
3510
  "dist",
3612
3511
  "commands",
3613
- "mouse",
3614
- "drag.js"
3512
+ "network",
3513
+ "off.js"
3615
3514
  ]
3616
3515
  },
3617
- "mouse:hover": {
3516
+ "network:on": {
3618
3517
  "aliases": [],
3619
- "args": {
3620
- "x": {
3621
- "description": "Viewport x coordinate.",
3622
- "name": "x",
3623
- "required": true
3624
- },
3625
- "y": {
3626
- "description": "Viewport y coordinate.",
3627
- "name": "y",
3628
- "required": true
3629
- }
3630
- },
3631
- "description": "Move the mouse to raw viewport coordinates in the active page.",
3518
+ "args": {},
3519
+ "description": "Enable network capture for the active browser session.",
3632
3520
  "examples": [
3633
- "browse mouse hover 240 320",
3634
- "browse mouse hover 240 320 --return-xpath",
3635
- "browse mouse hover 240 320 --session research"
3521
+ "browse network on",
3522
+ "browse network on --session research"
3636
3523
  ],
3637
3524
  "flags": {
3638
3525
  "auto-connect": {
@@ -3723,17 +3610,11 @@
3723
3610
  "name": "verified",
3724
3611
  "allowNo": false,
3725
3612
  "type": "boolean"
3726
- },
3727
- "return-xpath": {
3728
- "description": "Include the XPath under the coordinate when the driver can return it.",
3729
- "name": "return-xpath",
3730
- "allowNo": false,
3731
- "type": "boolean"
3732
3613
  }
3733
3614
  },
3734
3615
  "hasDynamicHelp": false,
3735
3616
  "hiddenAliases": [],
3736
- "id": "mouse:hover",
3617
+ "id": "network:on",
3737
3618
  "pluginAlias": "browse",
3738
3619
  "pluginName": "browse",
3739
3620
  "pluginType": "core",
@@ -3742,39 +3623,17 @@
3742
3623
  "relativePath": [
3743
3624
  "dist",
3744
3625
  "commands",
3745
- "mouse",
3746
- "hover.js"
3626
+ "network",
3627
+ "on.js"
3747
3628
  ]
3748
3629
  },
3749
- "mouse:scroll": {
3630
+ "network:path": {
3750
3631
  "aliases": [],
3751
- "args": {
3752
- "x": {
3753
- "description": "Viewport x coordinate.",
3754
- "name": "x",
3755
- "required": true
3756
- },
3757
- "y": {
3758
- "description": "Viewport y coordinate.",
3759
- "name": "y",
3760
- "required": true
3761
- },
3762
- "deltaX": {
3763
- "description": "Horizontal scroll delta.",
3764
- "name": "deltaX",
3765
- "required": true
3766
- },
3767
- "deltaY": {
3768
- "description": "Vertical scroll delta.",
3769
- "name": "deltaY",
3770
- "required": true
3771
- }
3772
- },
3773
- "description": "Scroll from raw viewport coordinates in the active page.",
3632
+ "args": {},
3633
+ "description": "Print the network capture directory for the active browser session.",
3774
3634
  "examples": [
3775
- "browse mouse scroll 400 500 0 600",
3776
- "browse mouse scroll 400 500 0 -600",
3777
- "browse mouse scroll 400 500 0 600 --return-xpath"
3635
+ "browse network path",
3636
+ "browse network path --session research"
3778
3637
  ],
3779
3638
  "flags": {
3780
3639
  "auto-connect": {
@@ -3865,17 +3724,11 @@
3865
3724
  "name": "verified",
3866
3725
  "allowNo": false,
3867
3726
  "type": "boolean"
3868
- },
3869
- "return-xpath": {
3870
- "description": "Include the XPath under the coordinate when the driver can return it.",
3871
- "name": "return-xpath",
3872
- "allowNo": false,
3873
- "type": "boolean"
3874
3727
  }
3875
3728
  },
3876
3729
  "hasDynamicHelp": false,
3877
3730
  "hiddenAliases": [],
3878
- "id": "mouse:scroll",
3731
+ "id": "network:path",
3879
3732
  "pluginAlias": "browse",
3880
3733
  "pluginName": "browse",
3881
3734
  "pluginType": "core",
@@ -3884,112 +3737,190 @@
3884
3737
  "relativePath": [
3885
3738
  "dist",
3886
3739
  "commands",
3887
- "mouse",
3888
- "scroll.js"
3740
+ "network",
3741
+ "path.js"
3889
3742
  ]
3890
3743
  },
3891
- "network:clear": {
3744
+ "skills:add": {
3892
3745
  "aliases": [],
3893
- "args": {},
3894
- "description": "Clear captured network request directories for the active browser session.",
3746
+ "args": {
3747
+ "skill": {
3748
+ "description": "Skill id in the form <domain>/<task>.",
3749
+ "name": "skill",
3750
+ "required": false
3751
+ }
3752
+ },
3753
+ "description": "Install a browser automation skill.",
3895
3754
  "examples": [
3896
- "browse network clear",
3897
- "browse network clear --session research"
3755
+ "browse skills add yelp.com/extract-reviews",
3756
+ "browse skills add mcdonalds.order.online/order-delivery-42q71n"
3898
3757
  ],
3899
- "flags": {
3900
- "auto-connect": {
3901
- "description": "Auto-discover and attach to a local browser with remote debugging enabled.",
3902
- "name": "auto-connect",
3903
- "allowNo": false,
3904
- "type": "boolean"
3905
- },
3906
- "cdp": {
3907
- "description": "Attach directly to a CDP endpoint. Accepts a port, http(s) URL, or ws(s) URL.",
3908
- "name": "cdp",
3909
- "hasDynamicHelp": false,
3910
- "helpValue": "<url|port>",
3911
- "multiple": false,
3912
- "type": "option"
3913
- },
3914
- "chrome-arg": {
3915
- "description": "Add a Chrome launch arg for managed local sessions. Repeatable.",
3916
- "name": "chrome-arg",
3917
- "hasDynamicHelp": false,
3918
- "helpValue": "<flag>",
3919
- "multiple": true,
3920
- "type": "option"
3921
- },
3922
- "headed": {
3923
- "description": "Show a visible browser window for managed local sessions.",
3924
- "name": "headed",
3925
- "allowNo": false,
3926
- "type": "boolean"
3927
- },
3928
- "headless": {
3929
- "description": "Run managed local sessions in headless mode.",
3930
- "name": "headless",
3931
- "allowNo": false,
3932
- "type": "boolean"
3933
- },
3934
- "ignore-default-chrome-arg": {
3935
- "description": "Drop one of Chrome's default launch args for managed local sessions. Repeatable.",
3936
- "name": "ignore-default-chrome-arg",
3758
+ "flags": {},
3759
+ "hasDynamicHelp": false,
3760
+ "hiddenAliases": [],
3761
+ "id": "skills:add",
3762
+ "pluginAlias": "browse",
3763
+ "pluginName": "browse",
3764
+ "pluginType": "core",
3765
+ "strict": true,
3766
+ "isESM": true,
3767
+ "relativePath": [
3768
+ "dist",
3769
+ "commands",
3770
+ "skills",
3771
+ "add.js"
3772
+ ]
3773
+ },
3774
+ "skills:find": {
3775
+ "aliases": [],
3776
+ "args": {
3777
+ "query": {
3778
+ "description": "Skill slug or search query.",
3779
+ "name": "query",
3780
+ "required": true
3781
+ }
3782
+ },
3783
+ "description": "Find Browse.sh catalog skills by slug, domain, title, description, category, alias, or tag.",
3784
+ "examples": [
3785
+ "browse skills find yelp",
3786
+ "browse skills find reviews",
3787
+ "browse skills find yelp.com/extract-reviews",
3788
+ "browse skills find travel --limit 5",
3789
+ "browse skills find \"restaurant reviews\" --json"
3790
+ ],
3791
+ "flags": {
3792
+ "format": {
3793
+ "description": "Output format. Defaults to table in a terminal and JSON when piped.",
3794
+ "name": "format",
3937
3795
  "hasDynamicHelp": false,
3938
- "helpValue": "<flag>",
3939
- "multiple": true,
3796
+ "helpValue": "<format>",
3797
+ "multiple": false,
3798
+ "options": [
3799
+ "table",
3800
+ "json"
3801
+ ],
3940
3802
  "type": "option"
3941
3803
  },
3942
- "local": {
3943
- "description": "Use a managed local browser session.",
3944
- "name": "local",
3945
- "allowNo": false,
3946
- "type": "boolean"
3947
- },
3948
- "no-default-chrome-args": {
3949
- "description": "Launch managed local Chrome without any of its default launch args.",
3950
- "name": "no-default-chrome-args",
3804
+ "json": {
3805
+ "description": "Print raw JSON output.",
3806
+ "name": "json",
3951
3807
  "allowNo": false,
3952
3808
  "type": "boolean"
3953
3809
  },
3954
- "proxies": {
3955
- "description": "Route the remote session through Browserbase proxies. Requires --remote.",
3956
- "name": "proxies",
3810
+ "wide": {
3811
+ "description": "Show full table values without truncation.",
3812
+ "name": "wide",
3957
3813
  "allowNo": false,
3958
3814
  "type": "boolean"
3959
3815
  },
3960
- "remote": {
3961
- "description": "Use a remote Browserbase browser session.",
3962
- "name": "remote",
3816
+ "all": {
3817
+ "description": "Show all matching skills in table output.",
3818
+ "name": "all",
3963
3819
  "allowNo": false,
3964
3820
  "type": "boolean"
3965
3821
  },
3966
- "session": {
3967
- "char": "s",
3968
- "description": "Named browser session to use. Defaults to BROWSE_SESSION or default.",
3969
- "name": "session",
3822
+ "limit": {
3823
+ "description": "Maximum matching skills to show in table output.",
3824
+ "name": "limit",
3825
+ "default": 25,
3970
3826
  "hasDynamicHelp": false,
3971
- "helpValue": "<name>",
3827
+ "helpValue": "<count>",
3972
3828
  "multiple": false,
3973
3829
  "type": "option"
3974
- },
3975
- "target-id": {
3976
- "description": "Select a specific CDP target when attaching to an existing browser.",
3977
- "name": "target-id",
3830
+ }
3831
+ },
3832
+ "hasDynamicHelp": false,
3833
+ "hiddenAliases": [],
3834
+ "id": "skills:find",
3835
+ "pluginAlias": "browse",
3836
+ "pluginName": "browse",
3837
+ "pluginType": "core",
3838
+ "strict": true,
3839
+ "isESM": true,
3840
+ "relativePath": [
3841
+ "dist",
3842
+ "commands",
3843
+ "skills",
3844
+ "find.js"
3845
+ ]
3846
+ },
3847
+ "skills:install": {
3848
+ "aliases": [],
3849
+ "args": {},
3850
+ "description": "Install the bundled browse CLI skill.",
3851
+ "examples": [
3852
+ "browse skills install"
3853
+ ],
3854
+ "flags": {},
3855
+ "hasDynamicHelp": false,
3856
+ "hiddenAliases": [],
3857
+ "id": "skills:install",
3858
+ "pluginAlias": "browse",
3859
+ "pluginName": "browse",
3860
+ "pluginType": "core",
3861
+ "strict": true,
3862
+ "isESM": true,
3863
+ "relativePath": [
3864
+ "dist",
3865
+ "commands",
3866
+ "skills",
3867
+ "install.js"
3868
+ ]
3869
+ },
3870
+ "skills:list": {
3871
+ "aliases": [],
3872
+ "args": {},
3873
+ "description": "List Browse.sh catalog skills.",
3874
+ "examples": [
3875
+ "browse skills list",
3876
+ "browse skills list --limit 10",
3877
+ "browse skills list --all",
3878
+ "browse skills list --json"
3879
+ ],
3880
+ "flags": {
3881
+ "format": {
3882
+ "description": "Output format. Defaults to table in a terminal and JSON when piped.",
3883
+ "name": "format",
3978
3884
  "hasDynamicHelp": false,
3979
- "helpValue": "<target-id>",
3885
+ "helpValue": "<format>",
3980
3886
  "multiple": false,
3887
+ "options": [
3888
+ "table",
3889
+ "json"
3890
+ ],
3981
3891
  "type": "option"
3982
3892
  },
3983
- "verified": {
3984
- "description": "Open the remote session as a Verified (advanced-stealth) browser. Requires --remote and a Browserbase Scale plan.",
3985
- "name": "verified",
3893
+ "json": {
3894
+ "description": "Print raw JSON output.",
3895
+ "name": "json",
3896
+ "allowNo": false,
3897
+ "type": "boolean"
3898
+ },
3899
+ "wide": {
3900
+ "description": "Show full table values without truncation.",
3901
+ "name": "wide",
3902
+ "allowNo": false,
3903
+ "type": "boolean"
3904
+ },
3905
+ "all": {
3906
+ "description": "Show all returned skills in table output.",
3907
+ "name": "all",
3986
3908
  "allowNo": false,
3987
3909
  "type": "boolean"
3910
+ },
3911
+ "limit": {
3912
+ "description": "Maximum skills to show in table output.",
3913
+ "name": "limit",
3914
+ "default": 25,
3915
+ "hasDynamicHelp": false,
3916
+ "helpValue": "<count>",
3917
+ "multiple": false,
3918
+ "type": "option"
3988
3919
  }
3989
3920
  },
3990
3921
  "hasDynamicHelp": false,
3991
3922
  "hiddenAliases": [],
3992
- "id": "network:clear",
3923
+ "id": "skills:list",
3993
3924
  "pluginAlias": "browse",
3994
3925
  "pluginName": "browse",
3995
3926
  "pluginType": "core",
@@ -3998,17 +3929,52 @@
3998
3929
  "relativePath": [
3999
3930
  "dist",
4000
3931
  "commands",
4001
- "network",
4002
- "clear.js"
3932
+ "skills",
3933
+ "list.js"
4003
3934
  ]
4004
3935
  },
4005
- "network:off": {
3936
+ "skills:show": {
4006
3937
  "aliases": [],
4007
3938
  "args": {},
4008
- "description": "Disable network capture for the active browser session.",
3939
+ "description": "Print the bundled browse skill (usage patterns, workflows, gotchas) to stdout. Run before using browse in an agent.",
4009
3940
  "examples": [
4010
- "browse network off",
4011
- "browse network off --session research"
3941
+ "browse skills show"
3942
+ ],
3943
+ "flags": {},
3944
+ "hasDynamicHelp": false,
3945
+ "hiddenAliases": [],
3946
+ "id": "skills:show",
3947
+ "pluginAlias": "browse",
3948
+ "pluginName": "browse",
3949
+ "pluginType": "core",
3950
+ "strict": true,
3951
+ "isESM": true,
3952
+ "relativePath": [
3953
+ "dist",
3954
+ "commands",
3955
+ "skills",
3956
+ "show.js"
3957
+ ]
3958
+ },
3959
+ "mouse:click": {
3960
+ "aliases": [],
3961
+ "args": {
3962
+ "x": {
3963
+ "description": "Viewport x coordinate.",
3964
+ "name": "x",
3965
+ "required": true
3966
+ },
3967
+ "y": {
3968
+ "description": "Viewport y coordinate.",
3969
+ "name": "y",
3970
+ "required": true
3971
+ }
3972
+ },
3973
+ "description": "Click raw viewport coordinates in the active page.",
3974
+ "examples": [
3975
+ "browse mouse click 240 320",
3976
+ "browse mouse click 240 320 --button right",
3977
+ "browse mouse click 240 320 --click-count 2 --return-xpath"
4012
3978
  ],
4013
3979
  "flags": {
4014
3980
  "auto-connect": {
@@ -4099,34 +4065,85 @@
4099
4065
  "name": "verified",
4100
4066
  "allowNo": false,
4101
4067
  "type": "boolean"
4102
- }
4103
- },
4104
- "hasDynamicHelp": false,
4105
- "hiddenAliases": [],
4106
- "id": "network:off",
4107
- "pluginAlias": "browse",
4108
- "pluginName": "browse",
4109
- "pluginType": "core",
4110
- "strict": true,
4111
- "isESM": true,
4112
- "relativePath": [
4113
- "dist",
4114
- "commands",
4115
- "network",
4116
- "off.js"
4117
- ]
4118
- },
4119
- "network:on": {
4120
- "aliases": [],
4121
- "args": {},
4122
- "description": "Enable network capture for the active browser session.",
4123
- "examples": [
4124
- "browse network on",
4125
- "browse network on --session research"
4126
- ],
4127
- "flags": {
4128
- "auto-connect": {
4129
- "description": "Auto-discover and attach to a local browser with remote debugging enabled.",
4068
+ },
4069
+ "button": {
4070
+ "description": "Mouse button to use.",
4071
+ "name": "button",
4072
+ "default": "left",
4073
+ "hasDynamicHelp": false,
4074
+ "helpValue": "<button>",
4075
+ "multiple": false,
4076
+ "options": [
4077
+ "left",
4078
+ "middle",
4079
+ "right"
4080
+ ],
4081
+ "type": "option"
4082
+ },
4083
+ "click-count": {
4084
+ "description": "Number of clicks to send.",
4085
+ "name": "click-count",
4086
+ "default": 1,
4087
+ "hasDynamicHelp": false,
4088
+ "helpValue": "<count>",
4089
+ "multiple": false,
4090
+ "type": "option"
4091
+ },
4092
+ "return-xpath": {
4093
+ "description": "Include the XPath under the coordinate when the driver can return it.",
4094
+ "name": "return-xpath",
4095
+ "allowNo": false,
4096
+ "type": "boolean"
4097
+ }
4098
+ },
4099
+ "hasDynamicHelp": false,
4100
+ "hiddenAliases": [],
4101
+ "id": "mouse:click",
4102
+ "pluginAlias": "browse",
4103
+ "pluginName": "browse",
4104
+ "pluginType": "core",
4105
+ "strict": true,
4106
+ "isESM": true,
4107
+ "relativePath": [
4108
+ "dist",
4109
+ "commands",
4110
+ "mouse",
4111
+ "click.js"
4112
+ ]
4113
+ },
4114
+ "mouse:drag": {
4115
+ "aliases": [],
4116
+ "args": {
4117
+ "fromX": {
4118
+ "description": "Starting viewport x coordinate.",
4119
+ "name": "fromX",
4120
+ "required": true
4121
+ },
4122
+ "fromY": {
4123
+ "description": "Starting viewport y coordinate.",
4124
+ "name": "fromY",
4125
+ "required": true
4126
+ },
4127
+ "toX": {
4128
+ "description": "Ending viewport x coordinate.",
4129
+ "name": "toX",
4130
+ "required": true
4131
+ },
4132
+ "toY": {
4133
+ "description": "Ending viewport y coordinate.",
4134
+ "name": "toY",
4135
+ "required": true
4136
+ }
4137
+ },
4138
+ "description": "Drag from one raw viewport coordinate to another.",
4139
+ "examples": [
4140
+ "browse mouse drag 100 100 400 400",
4141
+ "browse mouse drag 100 100 400 400 --steps 20 --delay 10",
4142
+ "browse mouse drag 100 100 400 400 --return-xpath"
4143
+ ],
4144
+ "flags": {
4145
+ "auto-connect": {
4146
+ "description": "Auto-discover and attach to a local browser with remote debugging enabled.",
4130
4147
  "name": "auto-connect",
4131
4148
  "allowNo": false,
4132
4149
  "type": "boolean"
@@ -4213,11 +4230,49 @@
4213
4230
  "name": "verified",
4214
4231
  "allowNo": false,
4215
4232
  "type": "boolean"
4233
+ },
4234
+ "button": {
4235
+ "description": "Mouse button to use.",
4236
+ "name": "button",
4237
+ "default": "left",
4238
+ "hasDynamicHelp": false,
4239
+ "helpValue": "<button>",
4240
+ "multiple": false,
4241
+ "options": [
4242
+ "left",
4243
+ "middle",
4244
+ "right"
4245
+ ],
4246
+ "type": "option"
4247
+ },
4248
+ "delay": {
4249
+ "description": "Delay between drag steps in milliseconds.",
4250
+ "name": "delay",
4251
+ "default": 0,
4252
+ "hasDynamicHelp": false,
4253
+ "helpValue": "<ms>",
4254
+ "multiple": false,
4255
+ "type": "option"
4256
+ },
4257
+ "return-xpath": {
4258
+ "description": "Include the XPath under the start/end coordinates when the driver can return it.",
4259
+ "name": "return-xpath",
4260
+ "allowNo": false,
4261
+ "type": "boolean"
4262
+ },
4263
+ "steps": {
4264
+ "description": "Number of intermediate drag steps.",
4265
+ "name": "steps",
4266
+ "default": 10,
4267
+ "hasDynamicHelp": false,
4268
+ "helpValue": "<steps>",
4269
+ "multiple": false,
4270
+ "type": "option"
4216
4271
  }
4217
4272
  },
4218
4273
  "hasDynamicHelp": false,
4219
4274
  "hiddenAliases": [],
4220
- "id": "network:on",
4275
+ "id": "mouse:drag",
4221
4276
  "pluginAlias": "browse",
4222
4277
  "pluginName": "browse",
4223
4278
  "pluginType": "core",
@@ -4226,17 +4281,29 @@
4226
4281
  "relativePath": [
4227
4282
  "dist",
4228
4283
  "commands",
4229
- "network",
4230
- "on.js"
4284
+ "mouse",
4285
+ "drag.js"
4231
4286
  ]
4232
4287
  },
4233
- "network:path": {
4288
+ "mouse:hover": {
4234
4289
  "aliases": [],
4235
- "args": {},
4236
- "description": "Print the network capture directory for the active browser session.",
4290
+ "args": {
4291
+ "x": {
4292
+ "description": "Viewport x coordinate.",
4293
+ "name": "x",
4294
+ "required": true
4295
+ },
4296
+ "y": {
4297
+ "description": "Viewport y coordinate.",
4298
+ "name": "y",
4299
+ "required": true
4300
+ }
4301
+ },
4302
+ "description": "Move the mouse to raw viewport coordinates in the active page.",
4237
4303
  "examples": [
4238
- "browse network path",
4239
- "browse network path --session research"
4304
+ "browse mouse hover 240 320",
4305
+ "browse mouse hover 240 320 --return-xpath",
4306
+ "browse mouse hover 240 320 --session research"
4240
4307
  ],
4241
4308
  "flags": {
4242
4309
  "auto-connect": {
@@ -4327,41 +4394,17 @@
4327
4394
  "name": "verified",
4328
4395
  "allowNo": false,
4329
4396
  "type": "boolean"
4397
+ },
4398
+ "return-xpath": {
4399
+ "description": "Include the XPath under the coordinate when the driver can return it.",
4400
+ "name": "return-xpath",
4401
+ "allowNo": false,
4402
+ "type": "boolean"
4330
4403
  }
4331
4404
  },
4332
4405
  "hasDynamicHelp": false,
4333
4406
  "hiddenAliases": [],
4334
- "id": "network:path",
4335
- "pluginAlias": "browse",
4336
- "pluginName": "browse",
4337
- "pluginType": "core",
4338
- "strict": true,
4339
- "isESM": true,
4340
- "relativePath": [
4341
- "dist",
4342
- "commands",
4343
- "network",
4344
- "path.js"
4345
- ]
4346
- },
4347
- "skills:add": {
4348
- "aliases": [],
4349
- "args": {
4350
- "skill": {
4351
- "description": "Skill id in the form <domain>/<task>.",
4352
- "name": "skill",
4353
- "required": false
4354
- }
4355
- },
4356
- "description": "Install a browser automation skill.",
4357
- "examples": [
4358
- "browse skills add yelp.com/extract-reviews",
4359
- "browse skills add mcdonalds.order.online/order-delivery-42q71n"
4360
- ],
4361
- "flags": {},
4362
- "hasDynamicHelp": false,
4363
- "hiddenAliases": [],
4364
- "id": "skills:add",
4407
+ "id": "mouse:hover",
4365
4408
  "pluginAlias": "browse",
4366
4409
  "pluginName": "browse",
4367
4410
  "pluginType": "core",
@@ -4370,183 +4413,140 @@
4370
4413
  "relativePath": [
4371
4414
  "dist",
4372
4415
  "commands",
4373
- "skills",
4374
- "add.js"
4416
+ "mouse",
4417
+ "hover.js"
4375
4418
  ]
4376
4419
  },
4377
- "skills:find": {
4420
+ "mouse:scroll": {
4378
4421
  "aliases": [],
4379
4422
  "args": {
4380
- "query": {
4381
- "description": "Skill slug or search query.",
4382
- "name": "query",
4423
+ "x": {
4424
+ "description": "Viewport x coordinate.",
4425
+ "name": "x",
4426
+ "required": true
4427
+ },
4428
+ "y": {
4429
+ "description": "Viewport y coordinate.",
4430
+ "name": "y",
4431
+ "required": true
4432
+ },
4433
+ "deltaX": {
4434
+ "description": "Horizontal scroll delta.",
4435
+ "name": "deltaX",
4436
+ "required": true
4437
+ },
4438
+ "deltaY": {
4439
+ "description": "Vertical scroll delta.",
4440
+ "name": "deltaY",
4383
4441
  "required": true
4384
4442
  }
4385
4443
  },
4386
- "description": "Find Browse.sh catalog skills by slug, domain, title, description, category, alias, or tag.",
4444
+ "description": "Scroll from raw viewport coordinates in the active page.",
4387
4445
  "examples": [
4388
- "browse skills find yelp",
4389
- "browse skills find reviews",
4390
- "browse skills find yelp.com/extract-reviews",
4391
- "browse skills find travel --limit 5",
4392
- "browse skills find \"restaurant reviews\" --json"
4446
+ "browse mouse scroll 400 500 0 600",
4447
+ "browse mouse scroll 400 500 0 -600",
4448
+ "browse mouse scroll 400 500 0 600 --return-xpath"
4393
4449
  ],
4394
4450
  "flags": {
4395
- "format": {
4396
- "description": "Output format. Defaults to table in a terminal and JSON when piped.",
4397
- "name": "format",
4451
+ "auto-connect": {
4452
+ "description": "Auto-discover and attach to a local browser with remote debugging enabled.",
4453
+ "name": "auto-connect",
4454
+ "allowNo": false,
4455
+ "type": "boolean"
4456
+ },
4457
+ "cdp": {
4458
+ "description": "Attach directly to a CDP endpoint. Accepts a port, http(s) URL, or ws(s) URL.",
4459
+ "name": "cdp",
4398
4460
  "hasDynamicHelp": false,
4399
- "helpValue": "<format>",
4461
+ "helpValue": "<url|port>",
4400
4462
  "multiple": false,
4401
- "options": [
4402
- "table",
4403
- "json"
4404
- ],
4405
4463
  "type": "option"
4406
4464
  },
4407
- "json": {
4408
- "description": "Print raw JSON output.",
4409
- "name": "json",
4410
- "allowNo": false,
4411
- "type": "boolean"
4465
+ "chrome-arg": {
4466
+ "description": "Add a Chrome launch arg for managed local sessions. Repeatable.",
4467
+ "name": "chrome-arg",
4468
+ "hasDynamicHelp": false,
4469
+ "helpValue": "<flag>",
4470
+ "multiple": true,
4471
+ "type": "option"
4412
4472
  },
4413
- "wide": {
4414
- "description": "Show full table values without truncation.",
4415
- "name": "wide",
4473
+ "headed": {
4474
+ "description": "Show a visible browser window for managed local sessions.",
4475
+ "name": "headed",
4416
4476
  "allowNo": false,
4417
4477
  "type": "boolean"
4418
4478
  },
4419
- "all": {
4420
- "description": "Show all matching skills in table output.",
4421
- "name": "all",
4479
+ "headless": {
4480
+ "description": "Run managed local sessions in headless mode.",
4481
+ "name": "headless",
4422
4482
  "allowNo": false,
4423
4483
  "type": "boolean"
4424
4484
  },
4425
- "limit": {
4426
- "description": "Maximum matching skills to show in table output.",
4427
- "name": "limit",
4428
- "default": 25,
4429
- "hasDynamicHelp": false,
4430
- "helpValue": "<count>",
4431
- "multiple": false,
4432
- "type": "option"
4433
- }
4434
- },
4435
- "hasDynamicHelp": false,
4436
- "hiddenAliases": [],
4437
- "id": "skills:find",
4438
- "pluginAlias": "browse",
4439
- "pluginName": "browse",
4440
- "pluginType": "core",
4441
- "strict": true,
4442
- "isESM": true,
4443
- "relativePath": [
4444
- "dist",
4445
- "commands",
4446
- "skills",
4447
- "find.js"
4448
- ]
4449
- },
4450
- "skills:install": {
4451
- "aliases": [],
4452
- "args": {},
4453
- "description": "Install the bundled browse CLI skill.",
4454
- "examples": [
4455
- "browse skills install"
4456
- ],
4457
- "flags": {},
4458
- "hasDynamicHelp": false,
4459
- "hiddenAliases": [],
4460
- "id": "skills:install",
4461
- "pluginAlias": "browse",
4462
- "pluginName": "browse",
4463
- "pluginType": "core",
4464
- "strict": true,
4465
- "isESM": true,
4466
- "relativePath": [
4467
- "dist",
4468
- "commands",
4469
- "skills",
4470
- "install.js"
4471
- ]
4472
- },
4473
- "skills:list": {
4474
- "aliases": [],
4475
- "args": {},
4476
- "description": "List Browse.sh catalog skills.",
4477
- "examples": [
4478
- "browse skills list",
4479
- "browse skills list --limit 10",
4480
- "browse skills list --all",
4481
- "browse skills list --json"
4482
- ],
4483
- "flags": {
4484
- "format": {
4485
- "description": "Output format. Defaults to table in a terminal and JSON when piped.",
4486
- "name": "format",
4485
+ "ignore-default-chrome-arg": {
4486
+ "description": "Drop one of Chrome's default launch args for managed local sessions. Repeatable.",
4487
+ "name": "ignore-default-chrome-arg",
4487
4488
  "hasDynamicHelp": false,
4488
- "helpValue": "<format>",
4489
- "multiple": false,
4490
- "options": [
4491
- "table",
4492
- "json"
4493
- ],
4489
+ "helpValue": "<flag>",
4490
+ "multiple": true,
4494
4491
  "type": "option"
4495
4492
  },
4496
- "json": {
4497
- "description": "Print raw JSON output.",
4498
- "name": "json",
4493
+ "local": {
4494
+ "description": "Use a managed local browser session.",
4495
+ "name": "local",
4499
4496
  "allowNo": false,
4500
4497
  "type": "boolean"
4501
4498
  },
4502
- "wide": {
4503
- "description": "Show full table values without truncation.",
4504
- "name": "wide",
4499
+ "no-default-chrome-args": {
4500
+ "description": "Launch managed local Chrome without any of its default launch args.",
4501
+ "name": "no-default-chrome-args",
4505
4502
  "allowNo": false,
4506
4503
  "type": "boolean"
4507
4504
  },
4508
- "all": {
4509
- "description": "Show all returned skills in table output.",
4510
- "name": "all",
4505
+ "proxies": {
4506
+ "description": "Route the remote session through Browserbase proxies. Requires --remote.",
4507
+ "name": "proxies",
4511
4508
  "allowNo": false,
4512
4509
  "type": "boolean"
4513
4510
  },
4514
- "limit": {
4515
- "description": "Maximum skills to show in table output.",
4516
- "name": "limit",
4517
- "default": 25,
4511
+ "remote": {
4512
+ "description": "Use a remote Browserbase browser session.",
4513
+ "name": "remote",
4514
+ "allowNo": false,
4515
+ "type": "boolean"
4516
+ },
4517
+ "session": {
4518
+ "char": "s",
4519
+ "description": "Named browser session to use. Defaults to BROWSE_SESSION or default.",
4520
+ "name": "session",
4518
4521
  "hasDynamicHelp": false,
4519
- "helpValue": "<count>",
4522
+ "helpValue": "<name>",
4520
4523
  "multiple": false,
4521
4524
  "type": "option"
4525
+ },
4526
+ "target-id": {
4527
+ "description": "Select a specific CDP target when attaching to an existing browser.",
4528
+ "name": "target-id",
4529
+ "hasDynamicHelp": false,
4530
+ "helpValue": "<target-id>",
4531
+ "multiple": false,
4532
+ "type": "option"
4533
+ },
4534
+ "verified": {
4535
+ "description": "Open the remote session as a Verified (advanced-stealth) browser. Requires --remote and a Browserbase Scale plan.",
4536
+ "name": "verified",
4537
+ "allowNo": false,
4538
+ "type": "boolean"
4539
+ },
4540
+ "return-xpath": {
4541
+ "description": "Include the XPath under the coordinate when the driver can return it.",
4542
+ "name": "return-xpath",
4543
+ "allowNo": false,
4544
+ "type": "boolean"
4522
4545
  }
4523
4546
  },
4524
4547
  "hasDynamicHelp": false,
4525
4548
  "hiddenAliases": [],
4526
- "id": "skills:list",
4527
- "pluginAlias": "browse",
4528
- "pluginName": "browse",
4529
- "pluginType": "core",
4530
- "strict": true,
4531
- "isESM": true,
4532
- "relativePath": [
4533
- "dist",
4534
- "commands",
4535
- "skills",
4536
- "list.js"
4537
- ]
4538
- },
4539
- "skills:show": {
4540
- "aliases": [],
4541
- "args": {},
4542
- "description": "Print the bundled browse skill (usage patterns, workflows, gotchas) to stdout. Run before using browse in an agent.",
4543
- "examples": [
4544
- "browse skills show"
4545
- ],
4546
- "flags": {},
4547
- "hasDynamicHelp": false,
4548
- "hiddenAliases": [],
4549
- "id": "skills:show",
4549
+ "id": "mouse:scroll",
4550
4550
  "pluginAlias": "browse",
4551
4551
  "pluginName": "browse",
4552
4552
  "pluginType": "core",
@@ -4555,8 +4555,8 @@
4555
4555
  "relativePath": [
4556
4556
  "dist",
4557
4557
  "commands",
4558
- "skills",
4559
- "show.js"
4558
+ "mouse",
4559
+ "scroll.js"
4560
4560
  ]
4561
4561
  },
4562
4562
  "tab:close": {
@@ -6438,5 +6438,5 @@
6438
6438
  ]
6439
6439
  }
6440
6440
  },
6441
- "version": "0.9.5"
6441
+ "version": "0.9.6"
6442
6442
  }
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "browse",
3
- "version": "0.9.5-alpha-04c8ee4",
3
+ "version": "0.9.6",
4
4
  "description": "Unified Browserbase CLI for browser automation and cloud APIs.",
5
5
  "type": "module",
6
6
  "private": false,