@jaw.id/cli 0.1.26 → 0.2.1

package/oclif.manifest.json

@@ -144,7 +144,9 @@
       "examples": [
         "<%= config.bin %> config set apiKey=your-api-key defaultChain=8453",
         "<%= config.bin %> config set ens=yourdomain.eth sessionExpiry=14",
-        "<%= config.bin %> config set apiKey your-api-key"
+        "<%= config.bin %> config set apiKey your-api-key",
+        "<%= config.bin %> config set x402.maxAmountPerPayment=50000 x402.maxTotalPerSession=1000000",
+        "<%= config.bin %> config set x402.allowedNetworks=eip155:8453,eip155:84532"
       ],
       "flags": {
         "output": {
@@ -351,6 +353,30 @@
         "write.js"
       ]
     },
+    "mcp": {
+      "aliases": [],
+      "args": {},
+      "description": "Start the MCP server for AI agents (stdio transport)",
+      "examples": [
+        "<%= config.bin %> mcp"
+      ],
+      "flags": {},
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "mcp",
+      "pluginAlias": "@jaw.id/cli",
+      "pluginName": "@jaw.id/cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "mcp",
+        "index.js"
+      ]
+    },
     "rpc:call": {
       "aliases": [],
       "args": {
@@ -422,9 +448,8 @@
         },
         "timeout": {
           "char": "t",
-          "description": "Request timeout in seconds",
+          "description": "Request timeout in seconds (default 120, or JAW_BRIDGE_TIMEOUT_MS)",
           "name": "timeout",
-          "default": 120,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -454,17 +479,85 @@
         "call.js"
       ]
     },
-    "mcp": {
+    "x402:log": {
       "aliases": [],
       "args": {},
-      "description": "Start the MCP server for AI agents (stdio transport)",
+      "description": "Show the local x402 payment ledger: every attempt, paid, failed or refused, with amounts and transactions.",
       "examples": [
-        "<%= config.bin %> mcp"
+        "<%= config.bin %> x402 log",
+        "<%= config.bin %> x402 log --limit 20",
+        "<%= config.bin %> x402 log --status failed",
+        "<%= config.bin %> x402 log --output json"
       ],
-      "flags": {},
+      "flags": {
+        "output": {
+          "char": "o",
+          "description": "Output format",
+          "env": "JAW_OUTPUT",
+          "name": "output",
+          "default": "human",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "json",
+            "human"
+          ],
+          "type": "option"
+        },
+        "chain": {
+          "char": "c",
+          "description": "Chain ID",
+          "env": "JAW_CHAIN_ID",
+          "name": "chain",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "api-key": {
+          "description": "JAW API key",
+          "env": "JAW_API_KEY",
+          "name": "api-key",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "yes": {
+          "char": "y",
+          "description": "Skip confirmations (for AI agents)",
+          "name": "yes",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "quiet": {
+          "char": "q",
+          "description": "Suppress non-essential output",
+          "name": "quiet",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "limit": {
+          "description": "Show only the most recent N entries.",
+          "name": "limit",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "status": {
+          "description": "Show only entries with this outcome.",
+          "name": "status",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "paid",
+            "failed",
+            "refused"
+          ],
+          "type": "option"
+        }
+      },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "mcp",
+      "id": "x402:log",
       "pluginAlias": "@jaw.id/cli",
       "pluginName": "@jaw.id/cli",
       "pluginType": "core",
@@ -474,8 +567,282 @@
       "relativePath": [
         "dist",
         "commands",
-        "mcp",
-        "index.js"
+        "x402",
+        "log.js"
+      ]
+    },
+    "x402:pay": {
+      "aliases": [],
+      "args": {
+        "url": {
+          "description": "Resource URL to fetch",
+          "name": "url",
+          "required": true
+        }
+      },
+      "description": "Fetch a URL, paying an x402 challenge with the session key. Dry run by default: pass --pay to actually spend.",
+      "examples": [
+        "<%= config.bin %> x402 pay https://api.example.com/resource",
+        "<%= config.bin %> x402 pay https://api.example.com/resource --pay",
+        "<%= config.bin %> x402 pay https://api.example.com/resource --pay --max-amount 50000"
+      ],
+      "flags": {
+        "output": {
+          "char": "o",
+          "description": "Output format",
+          "env": "JAW_OUTPUT",
+          "name": "output",
+          "default": "human",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "json",
+            "human"
+          ],
+          "type": "option"
+        },
+        "chain": {
+          "char": "c",
+          "description": "Chain ID",
+          "env": "JAW_CHAIN_ID",
+          "name": "chain",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "api-key": {
+          "description": "JAW API key",
+          "env": "JAW_API_KEY",
+          "name": "api-key",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "yes": {
+          "char": "y",
+          "description": "Skip confirmations (for AI agents)",
+          "name": "yes",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "quiet": {
+          "char": "q",
+          "description": "Suppress non-essential output",
+          "name": "quiet",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "pay": {
+          "description": "Actually sign and send the payment. Without this the command stops before spending.",
+          "name": "pay",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "max-amount": {
+          "description": "Hard ceiling in base units for this call, on top of the configured policy.",
+          "name": "max-amount",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "method": {
+          "description": "HTTP method (default GET).",
+          "name": "method",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "body": {
+          "description": "Request body.",
+          "name": "body",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "x402:pay",
+      "pluginAlias": "@jaw.id/cli",
+      "pluginName": "@jaw.id/cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "x402",
+        "pay.js"
+      ]
+    },
+    "x402:status": {
+      "aliases": [],
+      "args": {},
+      "description": "Show x402 payment readiness: which account holds the funds, the resolved caps, and what has been spent. Reads only, never pays.",
+      "examples": [
+        "<%= config.bin %> x402 status",
+        "<%= config.bin %> x402 status --output json"
+      ],
+      "flags": {
+        "output": {
+          "char": "o",
+          "description": "Output format",
+          "env": "JAW_OUTPUT",
+          "name": "output",
+          "default": "human",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "json",
+            "human"
+          ],
+          "type": "option"
+        },
+        "chain": {
+          "char": "c",
+          "description": "Chain ID",
+          "env": "JAW_CHAIN_ID",
+          "name": "chain",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "api-key": {
+          "description": "JAW API key",
+          "env": "JAW_API_KEY",
+          "name": "api-key",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "yes": {
+          "char": "y",
+          "description": "Skip confirmations (for AI agents)",
+          "name": "yes",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "quiet": {
+          "char": "q",
+          "description": "Suppress non-essential output",
+          "name": "quiet",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "x402:status",
+      "pluginAlias": "@jaw.id/cli",
+      "pluginName": "@jaw.id/cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "x402",
+        "status.js"
+      ]
+    },
+    "session:add": {
+      "aliases": [],
+      "args": {},
+      "description": "Add permissions to the current session, keeping the ones it already has (one browser approval to grant, one to revoke the old).",
+      "examples": [
+        "<%= config.bin %> session add --x402",
+        "<%= config.bin %> session add --x402 --limit 10/day",
+        "<%= config.bin %> session add --permissions '{\"calls\":[...]}'"
+      ],
+      "flags": {
+        "output": {
+          "char": "o",
+          "description": "Output format",
+          "env": "JAW_OUTPUT",
+          "name": "output",
+          "default": "human",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "json",
+            "human"
+          ],
+          "type": "option"
+        },
+        "chain": {
+          "char": "c",
+          "description": "Chain ID",
+          "env": "JAW_CHAIN_ID",
+          "name": "chain",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "api-key": {
+          "description": "JAW API key",
+          "env": "JAW_API_KEY",
+          "name": "api-key",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "yes": {
+          "char": "y",
+          "description": "Skip confirmations (for AI agents)",
+          "name": "yes",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "quiet": {
+          "char": "q",
+          "description": "Suppress non-essential output",
+          "name": "quiet",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "permissions": {
+          "description": "Permissions to add (inline JSON or file path).",
+          "exclusive": [
+            "x402"
+          ],
+          "name": "permissions",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "x402": {
+          "description": "Add exactly what x402 payments need on the session chain. Tune the cap with --limit.",
+          "exclusive": [
+            "permissions"
+          ],
+          "name": "x402",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "limit": {
+          "description": "Spend cap for --x402, as <amount>/<period> (default 10/day).",
+          "name": "limit",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "session:add",
+      "pluginAlias": "@jaw.id/cli",
+      "pluginName": "@jaw.id/cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "session",
+        "add.js"
       ]
     },
     "session:revoke": {
@@ -527,6 +894,12 @@
           "name": "quiet",
           "allowNo": false,
           "type": "boolean"
+        },
+        "force": {
+          "description": "Delete the local session even if some permissions could not be revoked. They stay live on chain until they expire, and their ids are printed because deleting the session is what loses them.",
+          "name": "force",
+          "allowNo": false,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
@@ -550,6 +923,8 @@
       "args": {},
       "description": "Generate a session key and grant scoped on-chain permissions (one-time browser approval).",
       "examples": [
+        "<%= config.bin %> session setup --chain 8453 --x402",
+        "<%= config.bin %> session setup --chain 8453 --x402 --limit 25/day --expiry 14",
         "<%= config.bin %> session setup --chain 84532",
         "<%= config.bin %> session setup --permissions '{\"calls\":[...]}' --expiry 14",
         "<%= config.bin %> session setup --permissions ./permissions.json"
@@ -602,11 +977,30 @@
         },
         "permissions": {
           "description": "Permission scope (inline JSON or file path). Overrides config.permissions.",
+          "exclusive": [
+            "x402"
+          ],
           "name": "permissions",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
+        "x402": {
+          "description": "Grant exactly what x402 payments need on this chain: a USDC transfer capped per period. Builds the permission from the asset registry so the USDC address and function signature do not have to be written by hand. Tune the cap with --limit.",
+          "exclusive": [
+            "permissions"
+          ],
+          "name": "x402",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "limit": {
+          "description": "Spend cap for --x402, as <amount>/<period> (default 10/day). Examples: 25/day, 2.5/week, 100/month.",
+          "name": "limit",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
         "expiry": {
           "description": "Permission expiry in days. Overrides config.sessionExpiry.",
           "name": "expiry",
@@ -699,5 +1093,5 @@
       ]
     }
   },
-  "version": "0.1.26"
+  "version": "0.2.1"
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@jaw.id/cli",
   "description": "CLI + MCP Server for JAW.id smart accounts — for humans and AI agents",
-  "version": "0.1.26",
+  "version": "0.2.1",
   "license": "Apache-2.0",
   "type": "module",
   "bin": {
@@ -55,6 +55,9 @@
       },
       "session": {
         "description": "Manage session keys for autonomous AI agents"
+      },
+      "x402": {
+        "description": "Inspect and test agentic x402 payments"
       }
     }
   },
@@ -109,7 +112,7 @@
     }
   },
   "dependencies": {
-    "@jaw.id/core": "1.2.3",
+    "@jaw.id/core": "1.3.1",
     "@modelcontextprotocol/sdk": "^1.12.1",
     "@oclif/core": "^4.3.0",
     "open": "^10.1.0",