@visa/cli 4.1.0-rc.185 → 4.1.0-rc.187

package/dist/skills/pair-visa-agent/SKILL.md

@@ -296,7 +296,7 @@ approve — you poll to completion yourself:
       confirming the caps — **card with a passkey, wallet with their sign-in session**. You
       cannot approve on their behalf.
 - [ ] **Poll to activation from MCP.** Call `agent_connect_poll` (`{"attachId":"<from
-      agent_connect>"}`; or resume by `agentId`) — one bounded poll per call. It returns
+    agent_connect>"}`; or resume by `agentId`) — one bounded poll per call. It returns
       `{"ok":false,"state":"...","blockedByKind":"awaiting_human_approval"}` while pending;
       call again until `{"ok":true,"state":"grant_activated","caps":...}` (wallet also
       returns `fundAddress`). Activation registers the delegated signer + caps: wallet writes
@@ -338,6 +338,20 @@ challenge without paying), `wallet_pay` / `wallet_directory_pay` (pay, policy-en
 `wallet_fund` (funding address + faucet), and `wallet_export` (export key material —
 dangerous). All spending is gated by the owner-approved local policy caps.
 
+## Cancelling pending ceremonies
+
+If a pairing or spending ceremony was started mistakenly, needs updated caps/rails, or the human chooses to abandon it, cancel it explicitly rather than letting it sit or waiting for its TTL:
+
+1. **Cancelling identity pairing:**
+   - **MCP:** `enroll_agent { action: "cancel", pairingId: "<pairingId>" }` or `agent_pairing_cancel { pairingId: "<pairingId>" }`.
+   - **CLI:** `visa agent cancel <pairingId>`.
+   - Requires the immutable `pairingId` from the start step. Clears local pending state and releases the ceremony server-side. Replays return typed `already_terminal`.
+
+2. **Cancelling spending-grant (connect) ceremonies:**
+   - **MCP:** `agent_connect_cancel { attachId: "<attachId>" }` or `agent_connect { action: "cancel", attachId: "<attachId>" }`.
+   - **CLI:** `visa agent grant-cancel <attachId>`.
+   - Requires the immutable `attachId` (`ca_...`). Releases the owner-side hold and purges local pending files so a fresh grant ceremony can be started immediately. Replaying returns `already_terminal` / `noop`. Subsequent polls report `rejected` without resurrecting local state.
+
 ## Core flow
 
 - [ ] Establish the owner session ("Sign in first" above) if this runtime does not have

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@visa/cli",
-  "version": "4.1.0-rc.185",
+  "version": "4.1.0-rc.187",
   "description": "Visa CLI runtime for stable agent identity and separately authorized payment capabilities",
   "bin": {
     "visa-cli": "./bin/visa-cli.js",

package/server.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://static.modelcontextprotocol.io/schemas/2025-10-17/server.schema.json",
   "name": "io.github.visa-crypto-labs/visa-cli",
-  "version": "4.1.0-rc.185",
+  "version": "4.1.0-rc.187",
   "title": "Visa CLI",
   "description": "Pair a human-approved agent identity, configure payment capabilities separately, and discover and pay x402 services from your AI coding assistant.",
   "websiteUrl": "https://github.com/Visa-Crypto-Labs/Visa-mono/tree/main/packages/cli#readme",
@@ -9,7 +9,7 @@
     {
       "registryType": "npm",
       "identifier": "@visa/cli",
-      "version": "4.1.0-rc.185",
+      "version": "4.1.0-rc.187",
       "transport": {
         "type": "stdio"
       },