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

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
@@ -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