@visa/cli 4.0.0-rc.19 → 4.0.0-rc.21
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 +13 -1
- package/dist/cli.js +164 -141
- package/dist/mcp-server/index.js +22 -22
- package/native/bin/win32-x64/visa-keychain-win.exe +0 -0
- package/package.json +1 -1
- package/server.json +2 -2
package/README.md
CHANGED
|
@@ -48,6 +48,12 @@ args = ["<npm root -g>/@visa/cli/dist/mcp-server/index.js"]
|
|
|
48
48
|
|
|
49
49
|
There is no CLI subcommand for starting the MCP server directly — the MCP server is the bundled `dist/mcp-server/index.js` entrypoint, which `visa-cli install <client>` registers for you. Once connected, your assistant will have access to all payment tools. The first time you use a paid tool, you'll be prompted to log in and enroll a card — you'll get $1 in free credits to start.
|
|
50
50
|
|
|
51
|
+
## Connect an agent runtime
|
|
52
|
+
|
|
53
|
+
Run `visa agent create` in the human-controlled terminal. Give the generated versioned skill URL to the shell-capable agent you want to connect. The agent returns a short verification code; enter it in the still-open prompt, then review the reported runtime, choose the `.visa` name and limits, and approve with your passkey in the browser.
|
|
54
|
+
|
|
55
|
+
If the human prompt closed, recover with `visa agent verify <pairing-id> <code>`. If the runtime lost its network response, use `visa agent resume <pairing-id>`; it reprints the same code and resumes delivery. Use `visa agent cancel [pairing-id]` to abandon an unapproved request. Agent private keys are generated and kept on the agent machine under `~/.visa-cli` with mode `0600`; the skill URL contains no credential.
|
|
56
|
+
|
|
51
57
|
## Enable the spend HUD (recommended)
|
|
52
58
|
|
|
53
59
|
Keep an eye on what your agents are spending. The HUD shows your balance, active card, and recent tool usage on every prompt.
|
|
@@ -79,6 +85,12 @@ visa-cli keys create my-demo-app # Create a Visa Key (prints the VisaKey_... ke
|
|
|
79
85
|
visa-cli keys list # List Visa Keys
|
|
80
86
|
visa-cli keys revoke <id> # Revoke a Visa Key
|
|
81
87
|
|
|
88
|
+
# Human-approved agent runtime pairing
|
|
89
|
+
visa agent create # Generate a shareable, credential-free skill link
|
|
90
|
+
visa agent verify <pairing-id> <code> # Recover a closed verification prompt
|
|
91
|
+
visa agent resume <pairing-id> # Reprint the code and resume runtime delivery
|
|
92
|
+
visa agent cancel [pairing-id] # Cancel an unapproved pairing
|
|
93
|
+
|
|
82
94
|
# Run merchant tools
|
|
83
95
|
visa-cli tools # List all available merchant tools
|
|
84
96
|
visa-cli tools --merchant fal # Scope to a single merchant
|
|
@@ -185,7 +197,7 @@ Reviewer handoff: `docs/api/visa-key-api-review-handoff.md`.
|
|
|
185
197
|
| Tool | Description |
|
|
186
198
|
|------|-------------|
|
|
187
199
|
| `login` | GitHub OAuth login — opens browser |
|
|
188
|
-
| `enroll_agent` |
|
|
200
|
+
| `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 |
|
|
189
201
|
| `add_card` | Enroll a card via VGS tokenization |
|
|
190
202
|
| `get_cards` | List enrolled cards (masked) |
|
|
191
203
|
| `remove_card` | Remove an enrolled card (authentication required) |
|