xno-skills 2.8.3 → 2.8.5

package/README.md

@@ -31,7 +31,7 @@ Available skills:
 ## CLI
 
 ```bash
-npm install -g xno-skills@latest
+npm install -g xno-skills@2.8.5
 xno-skills --help
 ```
 
@@ -89,7 +89,7 @@ Exposes Nano wallet functions as tools for AI agents (Claude Desktop, Cursor, Co
   "mcpServers": {
     "nano": {
       "command": "npx",
-      "args": ["-y", "-p", "xno-skills@latest", "xno-mcp"]
+      "args": ["-y", "-p", "xno-skills@2.8.5", "xno-mcp"]
     }
   }
 }
@@ -105,7 +105,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@latest xno-mcp
+  -- npx -y -p xno-skills@2.8.5 xno-mcp
 ```
 </details>
 
@@ -117,7 +117,7 @@ codex mcp add nano \
   "mcpServers": {
     "nano": {
       "command": "npx",
-      "args": ["-y", "-p", "xno-skills@latest", "xno-mcp"]
+      "args": ["-y", "-p", "xno-skills@2.8.5", "xno-mcp"]
     }
   }
 }
@@ -133,7 +133,7 @@ codex mcp add nano \
   "mcp": {
     "nano": {
       "type": "local",
-      "command": ["npx", "-y", "-p", "xno-skills@latest", "xno-mcp"],
+      "command": ["npx", "-y", "-p", "xno-skills@2.8.5", "xno-mcp"],
       "enabled": true
     }
   }
@@ -149,7 +149,7 @@ codex mcp add nano \
   "mcpServers": {
     "nano": {
       "command": "npx",
-      "args": ["-y", "-p", "xno-skills@latest", "xno-mcp"]
+      "args": ["-y", "-p", "xno-skills@2.8.5", "xno-mcp"]
     }
   }
 }
@@ -164,7 +164,7 @@ codex mcp add nano \
   "mcpServers": {
     "nano": {
       "command": "npx",
-      "args": ["-y", "-p", "xno-skills@latest", "xno-mcp"]
+      "args": ["-y", "-p", "xno-skills@2.8.5", "xno-mcp"]
     }
   }
 }
@@ -180,7 +180,7 @@ codex mcp add nano \
     "nano": {
       "type": "stdio",
       "command": "npx",
-      "args": ["-y", "-p", "xno-skills@latest", "xno-mcp"]
+      "args": ["-y", "-p", "xno-skills@2.8.5", "xno-mcp"]
     }
   }
 }

package/dist/cjs/version.d.ts

@@ -1,6 +1,6 @@
 export declare const pkg: {
     readonly name: "xno-skills";
-    readonly version: "2.8.3";
+    readonly version: "2.8.5";
 };
-export declare const version: "2.8.3";
+export declare const version: "2.8.5";
 //# 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: "2.8.3"
+    version: "2.8.5"
 };
 export const version = pkg.version;
 //# sourceMappingURL=version.js.map

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

@@ -1,27 +1,27 @@
 {
   "requests": [
     {
-      "id": "mos7p8cnpkkken",
+      "id": "mos8z0lk5wb2gk",
       "owsWalletId": "A",
       "accountIndex": 0,
       "address": "nano_3i1aq1cchnmbn9x5rsbap8b15akfh7wj7pwskuzi7ahz8oq6cobd99d4r3b7",
       "amountRaw": "10000000000000000000000000000",
       "reason": "explicit wallet test",
       "status": "pending",
-      "createdAt": "2026-05-05T05:52:53.639Z",
-      "updatedAt": "2026-05-05T05:52:53.639Z",
+      "createdAt": "2026-05-05T06:28:29.768Z",
+      "updatedAt": "2026-05-05T06:28:29.768Z",
       "receivedBlocks": []
     },
     {
-      "id": "mos7p8djqk81nm",
+      "id": "mos8z0mppvtzd5",
       "owsWalletId": "A",
       "accountIndex": 0,
       "address": "nano_3i1aq1cchnmbn9x5rsbap8b15akfh7wj7pwskuzi7ahz8oq6cobd99d4r3b7",
       "amountRaw": "500000000000000000000000000000",
       "reason": "status check test",
       "status": "pending",
-      "createdAt": "2026-05-05T05:52:53.671Z",
-      "updatedAt": "2026-05-05T05:52:53.671Z",
+      "createdAt": "2026-05-05T06:28:29.809Z",
+      "updatedAt": "2026-05-05T06:28:29.809Z",
       "receivedBlocks": []
     }
   ]

package/dist/esm/version.d.ts

@@ -1,6 +1,6 @@
 export declare const pkg: {
     readonly name: "xno-skills";
-    readonly version: "2.8.3";
+    readonly version: "2.8.5";
 };
-export declare const version: "2.8.3";
+export declare const version: "2.8.5";
 //# 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: "2.8.3"
+    version: "2.8.5"
 };
 export const version = pkg.version;
 //# sourceMappingURL=version.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "xno-skills",
-  "version": "2.8.3",
+  "version": "2.8.5",
   "description": "XNO CLI - Interact with Nano (XNO)",
   "type": "module",
   "main": "./dist/cjs/index.js",
@@ -24,7 +24,7 @@
   ],
   "scripts": {
     "preversion": "npm test",
-    "version": "node scripts/update-version.js && git add src/version.ts skills/nano/SKILL.md",
+    "version": "node scripts/update-version.js && git add src/version.ts skills/nano/SKILL.md README.md",
     "postversion": "node -e \"const v=require('./package.json').version; console.log('Created tag v'+v+'. Next: git push --follow-tags (GitHub Actions will publish to npm + create the GitHub Release).');\"",
     "prebuild": "node scripts/update-version.js",
     "prebuild:esm": "node scripts/update-version.js",

package/skills/nano/SKILL.md

@@ -75,16 +75,16 @@ When the environment provides `xno-mcp` tools (`wallets`, `send`, `receive`, `ba
 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@2.8.3 <command>
-2. pnpm dlx xno-skills@2.8.3 <command>
-3. npx -y xno-skills@2.8.3 <command>
+1. bunx -y xno-skills@2.8.5 <command>
+2. pnpm dlx xno-skills@2.8.5 <command>
+3. npx -y xno-skills@2.8.5 <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@2.8.3 --help
+bunx -y xno-skills@2.8.5 --help
 ```
 
 ### 3. Wallet lifecycle → `ows` skill only
@@ -108,7 +108,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 `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 — `receive` will build the open block automatically. 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@2.8.3` and `@open-wallet-standard/core`. No other npm packages.
+- **Supply chain**: Only use `xno-skills@2.8.5` 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.
 
 ---
@@ -139,8 +139,8 @@ To **create** a new wallet, delegate to the `ows` skill. Then return here for al
 
 **Via CLI:**
 ```bash
-bunx -y xno-skills@2.8.3 balance --wallet "my-wallet"
-bunx -y xno-skills@2.8.3 rpc account-balance <address> --json
+bunx -y xno-skills@2.8.5 balance --wallet "my-wallet"
+bunx -y xno-skills@2.8.5 rpc account-balance <address> --json
 ```
 
 **Public zero-config RPC nodes** (used automatically by xno-skills defaults):
@@ -168,7 +168,7 @@ A Nano transfer shows as **pending** until the recipient publishes a receive blo
 
 **Via CLI:**
 ```bash
-bunx -y xno-skills@2.8.3 receive --wallet "my-wallet"
+bunx -y xno-skills@2.8.5 receive --wallet "my-wallet"
 ```
 
 **Unopened account — explicit representative:**
@@ -198,7 +198,7 @@ The account must be opened (have a receive block) and have sufficient balance.
 
 **Via CLI:**
 ```bash
-bunx -y xno-skills@2.8.3 send --wallet "my-wallet" --destination "nano_..." --amount-xno 0.01
+bunx -y xno-skills@2.8.5 send --wallet "my-wallet" --destination "nano_..." --amount-xno 0.01
 ```
 
 **Validate the destination address first** (see Address Validation section).
@@ -305,13 +305,13 @@ Generates a terminal-friendly ASCII QR code for a Nano address, optionally with
 **Via CLI:**
 ```bash
 # Address only
-bunx -y xno-skills@2.8.3 qr nano_1abc...
+bunx -y xno-skills@2.8.5 qr nano_1abc...
 
 # With amount
-bunx -y xno-skills@2.8.3 qr nano_1abc... --amount-xno 1.5
+bunx -y xno-skills@2.8.5 qr nano_1abc... --amount-xno 1.5
 
 # JSON output (recommended for agents — avoids stdout truncation)
-bunx -y xno-skills@2.8.3 qr nano_1abc... --amount-xno 1.5 --json
+bunx -y xno-skills@2.8.5 qr nano_1abc... --amount-xno 1.5 --json
 ```
 
 > **CRITICAL — stdout truncation**: Agents often have stdout truncated (e.g. `<truncated 14 lines>`). To display a full QR code:
@@ -342,7 +342,7 @@ All validation is **offline** — no network required.
 
 **Via CLI:**
 ```bash
-bunx -y xno-skills@2.8.3 validate nano_1abc...
+bunx -y xno-skills@2.8.5 validate nano_1abc...
 ```
 
 **Always validate before sending XNO to an untrusted address.**
@@ -367,10 +367,10 @@ XNO uses **30 decimal places**. Floating-point arithmetic is unsafe. Always use
 
 **Via CLI:**
 ```bash
-bunx -y xno-skills@2.8.3 convert 1 xno       # all units
-bunx -y xno-skills@2.8.3 convert 1 knano
-bunx -y xno-skills@2.8.3 convert 1000000000000000000000000000000 raw
-bunx -y xno-skills@2.8.3 convert 1 xno --json
+bunx -y xno-skills@2.8.5 convert 1 xno       # all units
+bunx -y xno-skills@2.8.5 convert 1 knano
+bunx -y xno-skills@2.8.5 convert 1000000000000000000000000000000 raw
+bunx -y xno-skills@2.8.5 convert 1 xno --json
 ```
 
 ---
@@ -386,27 +386,35 @@ The `sign_message` and `verify_message` MCP tools require OWS upstream support t
 
 ### Low-level CLI signing (raw private key)
 
-If the user provides a **hex private key**, signing and verification work via CLI today:
+Signing with a raw hex private key works via CLI today, but **the agent must never handle the key value**. A raw private key passed through an LLM context is exposed to logs, memory, and any downstream system — treat it like a password.
+
+**Agent's role**: construct the command with a placeholder and ask the user to run it themselves in their own terminal.
+
+Present the user with this command to run locally:
 
 ```bash
-# Sign
-bunx -y xno-skills@2.8.3 sign "<message>" --key <private-key-hex>
+# Sign — run this yourself, replacing the placeholder with your actual key
+bunx -y xno-skills@2.8.5 sign "<message>" --key YOUR_PRIVATE_KEY_HEX
 
 # Sign with JSON output
-bunx -y xno-skills@2.8.3 sign "<message>" --key <private-key-hex> --json
+bunx -y xno-skills@2.8.5 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@2.8.3 verify <nano_address> "<message>" <signature-hex>
+bunx -y xno-skills@2.8.5 verify <nano_address> "<message>" <signature-hex>
 
 # Verify with JSON output
-bunx -y xno-skills@2.8.3 verify <nano_address> "<message>" <signature-hex> --json
+bunx -y xno-skills@2.8.5 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.
 
 **Note**: `verify` accepts both `nano_`/`xrb_` addresses and raw 32-byte hex public keys.
 
-> Do not prompt the user to export their mnemonic to get a private key. Only use the raw-key CLI path if they provide a hex private key directly.
+> Do not prompt the user to export their mnemonic to get a private key. Never accept, repeat, or emit a private key value — only use the placeholder pattern above.
 
 ---
 
@@ -460,7 +468,7 @@ PoW input:
 
 To probe whether an RPC endpoint supports remote `work_generate`:
 ```bash
-bunx -y xno-skills@2.8.3 rpc probe-caps <url>
+bunx -y xno-skills@2.8.5 rpc probe-caps <url>
 ```
 Never use `curl` to probe this.
 
@@ -476,7 +484,7 @@ Never use `curl` to probe this.
 { "name": "change_rep", "arguments": { "wallet": "my-wallet", "representative": "nano_..." } }
 ```
 ```bash
-bunx -y xno-skills@2.8.3 change-rep --wallet "my-wallet" --representative "nano_..."
+bunx -y xno-skills@2.8.5 change-rep --wallet "my-wallet" --representative "nano_..."
 ```
 
 ### Data Representations