@mercuryo-ai/agentbrowse-cli 0.1.6 → 0.1.7

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/README.md +49 -38
  2. package/package.json +10 -2
package/README.md CHANGED
@@ -1,48 +1,59 @@
1
1
  # @mercuryo-ai/agentbrowse-cli
2
2
 
3
- Browser-only CLI wrapper for `@mercuryo-ai/agentbrowse` on the shared
4
- `~/.magicpay` home.
3
+ Browser-only CLI for AI agents.
5
4
 
6
- `agentbrowse` is the browser operator surface for:
5
+ Choose this package when the task is navigation, observation, extraction, or
6
+ browser actions on visible page state. If the task includes protected login,
7
+ identity, or payment forms, pair it with `@mercuryo-ai/magicpay-cli` or use
8
+ `@mercuryo-ai/magicpay-agent-cli`.
7
9
 
8
- - bootstrapping shared MagicPay backend config for goal-based browser reasoning;
9
- - launching or attaching to a browser over CDP;
10
- - reading browser/page/runtime diagnostics;
11
- - navigating, observing, acting, extracting, and taking screenshots;
12
- - closing the shared browser session without owning payment/session/secrets
13
- flows.
10
+ ## Before You Start
14
11
 
15
- ## Install
12
+ - Node.js 18 or newer
13
+ - A MagicPay account. Create it at `https://agents.mercuryo.io/signup`, then
14
+ create an API key in the dashboard.
15
+ - A browser the agent can launch itself or attach to over the Chrome DevTools
16
+ Protocol (CDP)
17
+
18
+ ## Install And Initialize
16
19
 
17
20
  ```bash
18
- npm i -g @mercuryo-ai/agentbrowse-cli
21
+ npm i -g @mercuryo-ai/agentbrowse-cli@latest
19
22
  agentbrowse init <magicpay-api-key>
20
- agentbrowse --help
23
+ agentbrowse --version
24
+ ```
25
+
26
+ `agentbrowse init` stores the shared MagicPay config used by goal-based
27
+ `observe` and `extract`. After setup, start a fresh agent session if the new
28
+ CLI is not visible immediately.
29
+
30
+ ## Verify And First Use
31
+
32
+ Verify the install first:
33
+
34
+ ```bash
35
+ agentbrowse --version
21
36
  ```
22
37
 
23
- `observe` and `extract` use the shared MagicPay assistive backend. Configure it
24
- once with `agentbrowse init <apiKey>` or provide `MAGICPAY_API_KEY` and
25
- `MAGICPAY_API_URL` at runtime.
26
-
27
- ## Current surface
28
-
29
- - `init`
30
- - `launch`
31
- - `attach`
32
- - `browser-status`
33
- - `navigate`
34
- - `observe`
35
- - `act`
36
- - `extract`
37
- - `screenshot`
38
- - `close`
39
-
40
- ## Architecture boundary
41
-
42
- - `agentbrowse` is the operator CLI for browser-only workflows.
43
- - `@mercuryo-ai/agentbrowse` owns browser primitives and the reusable runtime.
44
- - `@mercuryo-ai/magicpay-home` owns the shared `~/.magicpay` local-home contract.
45
- - `@mercuryo-ai/magicpay-sdk` provides the shared MagicPay gateway contract used by
46
- browser goal-observe/extract assistive flows.
47
- - `@mercuryo-ai/agentbrowse-cli` owns only the branded browser CLI UX and shared
48
- home wiring, including shared gateway bootstrap for assistive browser goals.
38
+ Then run a simple browser-only task:
39
+
40
+ ```bash
41
+ agentbrowse launch "https://example.com"
42
+ agentbrowse observe "find the next visible action to continue"
43
+ ```
44
+
45
+ Use `agentbrowse doctor` only when `init` succeeded but goal-based `observe` or
46
+ `extract` still fail because the local MagicPay config looks wrong.
47
+
48
+ ## Command Groups
49
+
50
+ - Setup: `init`, `doctor`
51
+ - Browser lifecycle: `launch`, `attach`, `browser-status`, `close`
52
+ - Task loop: `navigate`, `observe`, `act`, `extract`, `screenshot`
53
+
54
+ ## Choose Another Package When
55
+
56
+ - You already have the browser on a protected login, identity, or payment form:
57
+ use `@mercuryo-ai/magicpay-cli`
58
+ - You want one CLI that covers both browser work and protected fills:
59
+ use `@mercuryo-ai/magicpay-agent-cli`
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@mercuryo-ai/agentbrowse-cli",
3
- "version": "0.1.6",
3
+ "version": "0.1.7",
4
4
  "description": "AgentBrowse CLI — browser-only operator shell on the shared MagicPay home",
5
5
  "type": "module",
6
6
  "license": "MIT",
@@ -23,14 +23,22 @@
23
23
  "publishConfig": {
24
24
  "access": "public"
25
25
  },
26
+ "repository": {
27
+ "type": "git",
28
+ "url": "git+https://github.com/MercuryoAI/skills.git"
29
+ },
30
+ "homepage": "https://agents.mercuryo.io/docs/agents",
31
+ "bugs": {
32
+ "url": "https://github.com/MercuryoAI/skills/issues"
33
+ },
26
34
  "engines": {
27
35
  "node": ">=18.0.0"
28
36
  },
29
37
  "dependencies": {
30
38
  "@browserbasehq/stagehand": "^3.0.0",
31
39
  "dotenv": "^16.4.0",
32
- "@mercuryo-ai/agentbrowse": "0.2.52",
33
40
  "@mercuryo-ai/magicpay-home": "0.1.6",
41
+ "@mercuryo-ai/agentbrowse": "0.2.53",
34
42
  "@mercuryo-ai/magicpay-sdk": "0.1.0-test.5"
35
43
  },
36
44
  "devDependencies": {