@visa/cli 2.0.0-rc.12 → 2.0.0-rc.13

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
@@ -122,6 +122,9 @@ The create command prints the raw `vk_...` key once. Store it in your app or age
122
122
  | `remove_card` | Remove an enrolled card (authentication required) |
123
123
  | `set_default_card` | Change the default card (authentication required) |
124
124
  | `get_status` | Auth, card, spend limits, and budget summary |
125
+ | `start_session` | Start a capped approval window for paid tools in this MCP process |
126
+ | `get_session_status` | Show the active session cap, estimated spend, and remaining amount |
127
+ | `close_session` | Close the active session and return to pay-as-you-go approvals |
125
128
  | `update_spending_controls` | Set daily and per-transaction limits (authentication required) |
126
129
  | `transaction_history` | Recent transactions with amounts and media URLs |
127
130
  | `feedback` | Submit feedback on a tool result |
@@ -180,6 +183,16 @@ Max per-transaction — hard cap per single tool call
180
183
 
181
184
  Both limits are enforced server-side. Authentication is always required per payment regardless of limits — this cannot be disabled. On macOS this means Touch ID; on other platforms, server-side verification with restricted spending limits applies.
182
185
 
186
+ ## Sessions
187
+
188
+ Paid tools are pay-as-you-go by default: each paid call requests payment approval. To approve a capped window for the current MCP process, use `start_session`:
189
+
190
+ ```bash
191
+ start_session capUsd=5
192
+ ```
193
+
194
+ Paid calls then spend from that approval window until the cap is used, `close_session` is called, the session expires, or the MCP process restarts. Sessions are not reused across Claude/MCP restarts.
195
+
183
196
  ---
184
197
 
185
198
  ## Config & data locations