@visa/cli 4.0.0-rc.20 → 4.0.0-rc.22

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.
package/README.md CHANGED
@@ -16,6 +16,46 @@ AI-powered payments over MCP. Exposes Visa-funded paid tools as MCP (Model Conte
16
16
  curl -fsSL https://app.visacli.sh/cli | bash
17
17
  ```
18
18
 
19
+ ## v4 wallet and paid services
20
+
21
+ The `visa` executable now ships the v4 wallet runtime inside the supported npm
22
+ artifact. It does not depend on monorepo workspace links. Discovery is advisory;
23
+ `inspect` and `pay` always fetch a fresh runtime challenge, and every payment
24
+ requires an explicit maximum.
25
+
26
+ ```bash
27
+ # Find stable directory listings. This does not spend money.
28
+ visa find "current weather by city"
29
+
30
+ # Inspect a listing and its fresh challenge without paying.
31
+ visa inspect <listing-id> --input @request.json
32
+
33
+ # Pay only when the fresh challenge is within the hard ceiling.
34
+ visa pay <listing-id> --max 0.05 --input @request.json
35
+
36
+ # Advanced direct-URL mode uses the same probe, policy, and receipt path.
37
+ visa inspect --url https://provider.example/paid
38
+ visa pay --url https://provider.example/paid --max 0.05
39
+
40
+ # Principal wallet policy and receipts.
41
+ visa wallet show
42
+ visa wallet fund
43
+ visa wallet limits
44
+ visa wallet limits --per-transaction 1.00 --daily 10.00 --session 2.00
45
+ visa activity
46
+ visa receipt <receipt-id>
47
+
48
+ # MCP client connections.
49
+ visa connections
50
+ visa connect codex
51
+ visa disconnect codex
52
+ ```
53
+
54
+ The wallet never exposes an export command. Mainnet is the production default
55
+ and moves real USDC; set `VISA_V4_NETWORK=base-sepolia` for staging/testnet.
56
+ MPP, L402, and VIC listings are discoverable, but the wallet currently executes
57
+ x402 only and refuses unsupported rails before signing.
58
+
19
59
  ## MCP setup
20
60
 
21
61
  The fastest path is to let the CLI write the client config for you:
@@ -197,7 +237,7 @@ Reviewer handoff: `docs/api/visa-key-api-review-handoff.md`.
197
237
  | Tool | Description |
198
238
  |------|-------------|
199
239
  | `login` | GitHub OAuth login — opens browser |
200
- | `enroll_agent` | Open the Visa Verified Agent enrollment web flow opens browser (tester-gated) |
240
+ | `enroll_agent` | Two-step Visa Verified Agent enrollment (tester-gated): default opens the browser flow with a hand-off challenge; `{"action":"claim"}` then stores the enrollment credential (token id + assurance data) at `~/.visa-mcp/agent-credential.json` for the CLI purchase leg |
201
241
  | `add_card` | Enroll a card via VGS tokenization |
202
242
  | `get_cards` | List enrolled cards (masked) |
203
243
  | `remove_card` | Remove an enrolled card (authentication required) |