xno-skills 3.3.0 → 3.3.1

package/README.md

@@ -43,7 +43,7 @@ xno-skills --help
 
 To pin to the current stable release instead:
 ```bash
-npm install -g xno-skills@3.3.0 && npx -y skills add CasualSecurityInc/xno-skills -g -y --all
+npm install -g xno-skills@3.3.1 && npx -y skills add CasualSecurityInc/xno-skills -g -y --all
 ```
 
 
@@ -102,7 +102,7 @@ Exposes Nano wallet functions as tools for AI agents (Claude Desktop, Cursor, Co
   "mcpServers": {
     "nano": {
       "command": "npx",
-      "args": ["-y", "-p", "xno-skills@3.3.0", "xno-mcp"]
+      "args": ["-y", "-p", "xno-skills@3.3.1", "xno-mcp"]
     }
   }
 }
@@ -118,7 +118,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.3.0 xno-mcp
+  -- npx -y -p xno-skills@3.3.1 xno-mcp
 ```
 </details>
 
@@ -130,7 +130,7 @@ codex mcp add nano \
   "mcpServers": {
     "nano": {
       "command": "npx",
-      "args": ["-y", "-p", "xno-skills@3.3.0", "xno-mcp"]
+      "args": ["-y", "-p", "xno-skills@3.3.1", "xno-mcp"]
     }
   }
 }
@@ -146,7 +146,7 @@ codex mcp add nano \
   "mcp": {
     "nano": {
       "type": "local",
-      "command": ["npx", "-y", "-p", "xno-skills@3.3.0", "xno-mcp"],
+      "command": ["npx", "-y", "-p", "xno-skills@3.3.1", "xno-mcp"],
       "enabled": true
     }
   }
@@ -162,7 +162,7 @@ codex mcp add nano \
   "mcpServers": {
     "nano": {
       "command": "npx",
-      "args": ["-y", "-p", "xno-skills@3.3.0", "xno-mcp"]
+      "args": ["-y", "-p", "xno-skills@3.3.1", "xno-mcp"]
     }
   }
 }
@@ -177,7 +177,7 @@ codex mcp add nano \
   "mcpServers": {
     "nano": {
       "command": "npx",
-      "args": ["-y", "-p", "xno-skills@3.3.0", "xno-mcp"]
+      "args": ["-y", "-p", "xno-skills@3.3.1", "xno-mcp"]
     }
   }
 }
@@ -193,7 +193,7 @@ codex mcp add nano \
     "nano": {
       "type": "stdio",
       "command": "npx",
-      "args": ["-y", "-p", "xno-skills@3.3.0", "xno-mcp"]
+      "args": ["-y", "-p", "xno-skills@3.3.1", "xno-mcp"]
     }
   }
 }

package/dist/cjs/version.d.ts

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

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

@@ -1,27 +1,27 @@
 {
   "requests": [
     {
-      "id": "mpi7puylleds59",
+      "id": "mpig25o8l2eodo",
       "owsWalletId": "A",
       "accountIndex": 0,
       "address": "nano_3i1aq1cchnmbn9x5rsbap8b15akfh7wj7pwskuzi7ahz8oq6cobd99d4r3b7",
       "amountRaw": "10000000000000000000000000000",
       "reason": "explicit wallet test",
       "status": "pending",
-      "createdAt": "2026-05-23T10:35:23.517Z",
-      "updatedAt": "2026-05-23T10:35:23.517Z",
+      "createdAt": "2026-05-23T14:28:54.200Z",
+      "updatedAt": "2026-05-23T14:28:54.200Z",
       "receivedBlocks": []
     },
     {
-      "id": "mpi7puzqdj7927",
+      "id": "mpig25p5o01ht9",
       "owsWalletId": "A",
       "accountIndex": 0,
       "address": "nano_3i1aq1cchnmbn9x5rsbap8b15akfh7wj7pwskuzi7ahz8oq6cobd99d4r3b7",
       "amountRaw": "500000000000000000000000000000",
       "reason": "status check test",
       "status": "pending",
-      "createdAt": "2026-05-23T10:35:23.558Z",
-      "updatedAt": "2026-05-23T10:35:23.558Z",
+      "createdAt": "2026-05-23T14:28:54.233Z",
+      "updatedAt": "2026-05-23T14:28:54.233Z",
       "receivedBlocks": []
     }
   ]

package/dist/esm/version.d.ts

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "xno-skills",
-  "version": "3.3.0",
+  "version": "3.3.1",
   "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",
@@ -77,6 +77,7 @@
     "@open-wallet-standard/core": "^1.3.2",
     "@openrai/nano-core": "^3.0.1",
     "commander": "^14.0.3",
+    "nano-rspow-node": "^0.5.13",
     "qrcode-svg": "^1.1.0",
     "qrcode-terminal": "^0.12.0",
     "zod": "^4.3.6"

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.3.0 -- mcp
+    npx -y -p xno-skills@3.3.1 -- 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.3.0 <command>
-2. pnpm dlx xno-skills@3.3.0 <command>
-3. npx -y xno-skills@3.3.0 <command>
+1. bunx -y xno-skills@3.3.1 <command>
+2. pnpm dlx xno-skills@3.3.1 <command>
+3. npx -y xno-skills@3.3.1 <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.3.0 --help
+bunx -y xno-skills@3.3.1 --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.3.0` and `@open-wallet-standard/core`. No other npm packages.
+- **Supply chain**: Only use `xno-skills@3.3.1` 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.3.0 balance --wallet "my-wallet"
-bunx -y xno-skills@3.3.0 rpc account-balance <address>
+bunx -y xno-skills@3.3.1 balance --wallet "my-wallet"
+bunx -y xno-skills@3.3.1 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.3.0 receive --wallet "my-wallet"
+bunx -y xno-skills@3.3.1 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.3.0 send --wallet "my-wallet" --to "nano_..." --amount-xno 0.01
+bunx -y xno-skills@3.3.1 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.3.0 qr nano_1abc...
+bunx -y xno-skills@3.3.1 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.3.0 validate nano_1abc...
+bunx -y xno-skills@3.3.1 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.3.0 convert 1 xno       # all units
-bunx -y xno-skills@3.3.0 convert 1 knano
-bunx -y xno-skills@3.3.0 convert 1000000000000000000000000000000 raw
-bunx -y xno-skills@3.3.0 convert 1 xno --json
+bunx -y xno-skills@3.3.1 convert 1 xno       # all units
+bunx -y xno-skills@3.3.1 convert 1 knano
+bunx -y xno-skills@3.3.1 convert 1000000000000000000000000000000 raw
+bunx -y xno-skills@3.3.1 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.3.0 sign "<message>" --key YOUR_PRIVATE_KEY_HEX
+bunx -y xno-skills@3.3.1 sign "<message>" --key YOUR_PRIVATE_KEY_HEX
 
 # Sign with JSON output
-bunx -y xno-skills@3.3.0 sign "<message>" --key YOUR_PRIVATE_KEY_HEX --json
+bunx -y xno-skills@3.3.1 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.3.0 verify <nano_address> "<message>" <signature-hex>
+bunx -y xno-skills@3.3.1 verify <nano_address> "<message>" <signature-hex>
 
 # Verify with JSON output
-bunx -y xno-skills@3.3.0 verify <nano_address> "<message>" <signature-hex> --json
+bunx -y xno-skills@3.3.1 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.
@@ -492,7 +492,7 @@ PoW input:
 { "name": "wallet_change_rep", "arguments": { "wallet": "my-wallet", "representative": "nano_..." } }
 ```
 ```bash
-bunx -y xno-skills@3.3.0 change-rep --wallet "my-wallet" --representative "nano_..."
+bunx -y xno-skills@3.3.1 change-rep --wallet "my-wallet" --representative "nano_..."
 ```
 
 Full options: [change-rep](references/change-rep.md)
@@ -598,6 +598,11 @@ xno-skills about
 xno-skills about --json
 ```
 
+### MCP Server Crashes & "Not connected" Errors
+
+- **OWS is an in-process library, NOT a daemon**: There is no background "OWS daemon" or wallet service running. `@open-wallet-standard/core` is a library loaded entirely in-process by the MCP server and CLI.
+- **"Not connected" from MCP client**: If an MCP client/agent receives a "Not connected" error on `wallet_balance` or any other tool, it typically means the underlying `xno-mcp` server process has crashed (usually due to a Rust native addon panic during PoW or backend initialization) or was terminated. It does **not** mean a background daemon is down.
+
 ### PoW failures (`POW_FAILED` / timeout)
 
 **PoW is done locally by default.** xno-skills uses WASM-based Proof of Work that runs in-process — no external work peer is required.