xno-skills 3.1.3 → 3.1.4

package/README.md

@@ -3,7 +3,6 @@
 [![npm version](https://img.shields.io/npm/v/xno-skills.svg)](https://www.npmjs.com/package/xno-skills)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 [![TypeScript](https://img.shields.io/badge/TypeScript-5.0+-blue.svg)](https://www.typescriptlang.org/)
-[![smithery badge](https://smithery.ai/badge/casualsecurityinc/xno-skills)](https://smithery.ai/servers/casualsecurityinc/xno-skills)
 
 A CLI, MCP server, and AI skills for [Nano](https://nano.org/) (XNO). Built on top of [Open Wallet Standard (OWS)](https://github.com/open-wallet-standard/core) for secure key custody.
 
@@ -11,7 +10,10 @@ A CLI, MCP server, and AI skills for [Nano](https://nano.org/) (XNO). Built on t
 
 ## Agent Skills
 
-Built-in skill for Personal AI Agents (OpenClaw etc.) and humans running AI coding assistants (Claude Code, Cursor, etc.) alike:
+[![smithery badge](https://smithery.ai/badge/casualsecurityinc/xno-skills)](https://smithery.ai/servers/casualsecurityinc/xno-skills)
+[![skills.sh](https://skills.sh/b/casualsecurityinc/xno-skills)](https://skills.sh/casualsecurityinc/xno-skills)
+
+Built-in skill for Personal AI Agents (OpenClaw etc.) and humans with AI Coding Assistants (Claude Code, Cursor, etc.) alike:
 
 ```bash
 npx skills add -g CasualSecurityInc/xno-skills
@@ -32,7 +34,7 @@ Available skills:
 ## CLI
 
 ```bash
-npm install -g xno-skills@3.1.3
+npm install -g xno-skills@3.1.4
 xno-skills --help
 ```
 
@@ -91,7 +93,7 @@ Exposes Nano wallet functions as tools for AI agents (Claude Desktop, Cursor, Co
   "mcpServers": {
     "nano": {
       "command": "npx",
-      "args": ["-y", "-p", "xno-skills@3.1.3", "xno-mcp"]
+      "args": ["-y", "-p", "xno-skills@3.1.4", "xno-mcp"]
     }
   }
 }
@@ -107,7 +109,7 @@ Exposes Nano wallet functions as tools for AI agents (Claude Desktop, Cursor, Co
 codex mcp add nano \
   -c sandbox_mode="danger-full-access" \
   -c 'sandbox_permissions=["network-access"]' \
-  -- npx -y -p xno-skills@3.1.3 xno-mcp
+  -- npx -y -p xno-skills@3.1.4 xno-mcp
 ```
 </details>
 
@@ -119,7 +121,7 @@ codex mcp add nano \
   "mcpServers": {
     "nano": {
       "command": "npx",
-      "args": ["-y", "-p", "xno-skills@3.1.3", "xno-mcp"]
+      "args": ["-y", "-p", "xno-skills@3.1.4", "xno-mcp"]
     }
   }
 }
@@ -135,7 +137,7 @@ codex mcp add nano \
   "mcp": {
     "nano": {
       "type": "local",
-      "command": ["npx", "-y", "-p", "xno-skills@3.1.3", "xno-mcp"],
+      "command": ["npx", "-y", "-p", "xno-skills@3.1.4", "xno-mcp"],
       "enabled": true
     }
   }
@@ -151,7 +153,7 @@ codex mcp add nano \
   "mcpServers": {
     "nano": {
       "command": "npx",
-      "args": ["-y", "-p", "xno-skills@3.1.3", "xno-mcp"]
+      "args": ["-y", "-p", "xno-skills@3.1.4", "xno-mcp"]
     }
   }
 }
@@ -166,7 +168,7 @@ codex mcp add nano \
   "mcpServers": {
     "nano": {
       "command": "npx",
-      "args": ["-y", "-p", "xno-skills@3.1.3", "xno-mcp"]
+      "args": ["-y", "-p", "xno-skills@3.1.4", "xno-mcp"]
     }
   }
 }
@@ -182,7 +184,7 @@ codex mcp add nano \
     "nano": {
       "type": "stdio",
       "command": "npx",
-      "args": ["-y", "-p", "xno-skills@3.1.3", "xno-mcp"]
+      "args": ["-y", "-p", "xno-skills@3.1.4", "xno-mcp"]
     }
   }
 }

package/dist/cjs/version.d.ts

@@ -1,6 +1,6 @@
 export declare const pkg: {
     readonly name: "xno-skills";
-    readonly version: "3.1.3";
+    readonly version: "3.1.4";
 };
-export declare const version: "3.1.3";
+export declare const version: "3.1.4";
 //# sourceMappingURL=version.d.ts.map

package/dist/cjs/version.js

@@ -2,7 +2,7 @@
 // Keep this in sync by running "npm run build" (prebuild hook).
 export const pkg = {
     name: "xno-skills",
-    version: "3.1.3"
+    version: "3.1.4"
 };
 export const version = pkg.version;
 //# sourceMappingURL=version.js.map

package/dist/esm/.xno-mcp/requests.json

@@ -1,27 +1,27 @@
 {
   "requests": [
     {
-      "id": "mozz60g7gcuhr4",
+      "id": "mp0pmsvbtkgp98",
       "owsWalletId": "A",
       "accountIndex": 0,
       "address": "nano_3i1aq1cchnmbn9x5rsbap8b15akfh7wj7pwskuzi7ahz8oq6cobd99d4r3b7",
       "amountRaw": "10000000000000000000000000000",
       "reason": "explicit wallet test",
       "status": "pending",
-      "createdAt": "2026-05-10T16:16:09.415Z",
-      "updatedAt": "2026-05-10T16:16:09.415Z",
+      "createdAt": "2026-05-11T04:37:02.759Z",
+      "updatedAt": "2026-05-11T04:37:02.759Z",
       "receivedBlocks": []
     },
     {
-      "id": "mozz60gz5hqxw4",
+      "id": "mp0pmsw9617obu",
       "owsWalletId": "A",
       "accountIndex": 0,
       "address": "nano_3i1aq1cchnmbn9x5rsbap8b15akfh7wj7pwskuzi7ahz8oq6cobd99d4r3b7",
       "amountRaw": "500000000000000000000000000000",
       "reason": "status check test",
       "status": "pending",
-      "createdAt": "2026-05-10T16:16:09.443Z",
-      "updatedAt": "2026-05-10T16:16:09.443Z",
+      "createdAt": "2026-05-11T04:37:02.793Z",
+      "updatedAt": "2026-05-11T04:37:02.793Z",
       "receivedBlocks": []
     }
   ]

package/dist/esm/version.d.ts

@@ -1,6 +1,6 @@
 export declare const pkg: {
     readonly name: "xno-skills";
-    readonly version: "3.1.3";
+    readonly version: "3.1.4";
 };
-export declare const version: "3.1.3";
+export declare const version: "3.1.4";
 //# sourceMappingURL=version.d.ts.map

package/dist/esm/version.js

@@ -2,7 +2,7 @@
 // Keep this in sync by running "npm run build" (prebuild hook).
 export const pkg = {
     name: "xno-skills",
-    version: "3.1.3"
+    version: "3.1.4"
 };
 export const version = pkg.version;
 //# sourceMappingURL=version.js.map

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "xno-skills",
-  "version": "3.1.3",
-  "description": "XNO CLI - Interact with Nano (XNO)",
+  "version": "3.1.4",
+  "description": "The Nano (XNO) toolkit for AI agents and developers. Send, receive, check balances, and manage payment requests without ever handling private keys.",
   "type": "module",
   "main": "./dist/cjs/index.js",
   "module": "./dist/esm/index.js",

package/skills/nano/SKILL.md

@@ -73,7 +73,7 @@ When the environment provides `xno-mcp` tools (`wallet.list`, `wallet.send`, `wa
 
 If the client supports MCP, set it up as a "stdio" type MCP server:
 
-    npx -y -p xno-skills@3.1.3 -- mcp
+    npx -y -p xno-skills@3.1.4 -- mcp
 
 MCP is the primary execution path because tools, schemas, and results are structured for the client. Use the included CLI script (`xno-skills`) only as a fallback when MCP is unavailable or the client cannot attach MCP servers. MCP and the CLI target EXACTLY the same underlying code paths — two access paths, not two different products.
 
@@ -82,16 +82,16 @@ MCP is the primary execution path because tools, schemas, and results are struct
 If `xno-mcp` tools are not available, or the user explicitly asks for CLI usage, fall back to the `xno-skills` CLI in this priority order:
 
 ```
-1. bunx -y xno-skills@3.1.3 <command>
-2. pnpm dlx xno-skills@3.1.3 <command>
-3. npx -y xno-skills@3.1.3 <command>
+1. bunx -y xno-skills@3.1.4 <command>
+2. pnpm dlx xno-skills@3.1.4 <command>
+3. npx -y xno-skills@3.1.4 <command>
 ```
 
 Do **not** assume `xno-skills` is installed globally. Always use one of the above forms with `@latest` to get critical bugfixes and to prevent interactive prompts from freezing.
 
 Before guessing a subcommand, run `--help`:
 ```bash
-bunx -y xno-skills@3.1.3 --help
+bunx -y xno-skills@3.1.4 --help
 ```
 
 ### 3. Wallet lifecycle → `ows` skill only
@@ -115,7 +115,7 @@ For wallet **create, import, rename, or delete**: delegate to the `ows` skill. D
 - **Proactivity on pending funds**: If you see pending funds during any balance check, call `wallet.receive` immediately. Do not wait for the user to ask.
 - **Persistence on "Account not found"**: This is normal for a brand-new, unopened account. Continue — `wallet.receive` will automatically build an open block (sets `previous` to zeros), sign it via OWS, generate PoW, and broadcast. Never conclude you are unauthorized or that OWS cannot sign Nano blocks.
 - **No mnemonic exports**: Never call `ows wallet export` or suggest exporting to a third-party wallet unless the user explicitly commands it.
-- **Supply chain**: Only use `xno-skills@3.1.3` and `@open-wallet-standard/core`. No other npm packages.
+- **Supply chain**: Only use `xno-skills@3.1.4` and `@open-wallet-standard/core`. No other npm packages.
 - **Stop-loss**: If you have made 5 tool calls without completing the operation, stop and report what you tried, what failed, and ask for guidance. Hard limits: max 3 retries of the same failing tool; max 2 `config.set` RPC endpoint switches.
 
 ---
@@ -146,8 +146,8 @@ To **create** a new wallet, delegate to the `ows` skill. Then return here for al
 
 **Via CLI (required flags only):**
 ```bash
-bunx -y xno-skills@3.1.3 balance --wallet "my-wallet"
-bunx -y xno-skills@3.1.3 rpc account-balance <address>
+bunx -y xno-skills@3.1.4 balance --wallet "my-wallet"
+bunx -y xno-skills@3.1.4 rpc account-balance <address>
 ```
 
 Full options: [balance](references/balance.md), [rpc_account-balance](references/rpc_account-balance.md)
@@ -177,7 +177,7 @@ A Nano transfer shows as **pending** until the recipient publishes a receive blo
 
 **Via CLI (required flags only):**
 ```bash
-bunx -y xno-skills@3.1.3 receive --wallet "my-wallet"
+bunx -y xno-skills@3.1.4 receive --wallet "my-wallet"
 ```
 
 Full options: [receive](references/receive.md)
@@ -209,7 +209,7 @@ The account must be opened (have a receive block) and have sufficient balance.
 
 **Via CLI (required flags only):**
 ```bash
-bunx -y xno-skills@3.1.3 send --wallet "my-wallet" --to "nano_..." --amount-xno 0.01
+bunx -y xno-skills@3.1.4 send --wallet "my-wallet" --to "nano_..." --amount-xno 0.01
 ```
 
 Full options: [send](references/send.md)
@@ -321,7 +321,7 @@ Generates a terminal-friendly ASCII QR code for a Nano address, optionally with
 
 **Via CLI (required args only):**
 ```bash
-bunx -y xno-skills@3.1.3 qr nano_1abc...
+bunx -y xno-skills@3.1.4 qr nano_1abc...
 ```
 
 Full options: [qr](references/qr.md)
@@ -348,7 +348,7 @@ All validation is **offline** — no network required.
 
 **Via CLI:**
 ```bash
-bunx -y xno-skills@3.1.3 validate nano_1abc...
+bunx -y xno-skills@3.1.4 validate nano_1abc...
 ```
 
 Full options: [validate](references/validate.md)
@@ -375,10 +375,10 @@ XNO uses **30 decimal places**. Floating-point arithmetic is unsafe. Always use
 
 **Via CLI:**
 ```bash
-bunx -y xno-skills@3.1.3 convert 1 xno       # all units
-bunx -y xno-skills@3.1.3 convert 1 knano
-bunx -y xno-skills@3.1.3 convert 1000000000000000000000000000000 raw
-bunx -y xno-skills@3.1.3 convert 1 xno --json
+bunx -y xno-skills@3.1.4 convert 1 xno       # all units
+bunx -y xno-skills@3.1.4 convert 1 knano
+bunx -y xno-skills@3.1.4 convert 1000000000000000000000000000000 raw
+bunx -y xno-skills@3.1.4 convert 1 xno --json
 ```
 
 Full options: [convert](references/convert.md)
@@ -404,20 +404,20 @@ Present the user with this command to run locally:
 
 ```bash
 # Sign — run this yourself, replacing the placeholder with your actual key
-bunx -y xno-skills@3.1.3 sign "<message>" --key YOUR_PRIVATE_KEY_HEX
+bunx -y xno-skills@3.1.4 sign "<message>" --key YOUR_PRIVATE_KEY_HEX
 
 # Sign with JSON output
-bunx -y xno-skills@3.1.3 sign "<message>" --key YOUR_PRIVATE_KEY_HEX --json
+bunx -y xno-skills@3.1.4 sign "<message>" --key YOUR_PRIVATE_KEY_HEX --json
 ```
 
 For verify, the agent *can* run this directly (no secret material involved):
 
 ```bash
 # Verify
-bunx -y xno-skills@3.1.3 verify <nano_address> "<message>" <signature-hex>
+bunx -y xno-skills@3.1.4 verify <nano_address> "<message>" <signature-hex>
 
 # Verify with JSON output
-bunx -y xno-skills@3.1.3 verify <nano_address> "<message>" <signature-hex> --json
+bunx -y xno-skills@3.1.4 verify <nano_address> "<message>" <signature-hex> --json
 ```
 
 **NOMS standard (ORIS-001)**: Signatures are computed over a binary payload with a magic header, ensuring a valid signature cannot be misinterpreted as a Nano transaction block.
@@ -493,7 +493,7 @@ Never use `curl` to probe this.
 { "name": "wallet.change_rep", "arguments": { "wallet": "my-wallet", "representative": "nano_..." } }
 ```
 ```bash
-bunx -y xno-skills@3.1.3 change-rep --wallet "my-wallet" --representative "nano_..."
+bunx -y xno-skills@3.1.4 change-rep --wallet "my-wallet" --representative "nano_..."
 ```
 
 Full options: [change-rep](references/change-rep.md)
@@ -629,7 +629,7 @@ Public nodes that support `work_generate` (not guaranteed — depends on node op
 
 To probe whether an RPC endpoint supports remote `work_generate`:
 ```bash
-bunx -y xno-skills@3.1.3 rpc probe-caps <url>
+bunx -y xno-skills@3.1.4 rpc probe-caps <url>
 ```
 
 Reset to local-only after resolving: