xno-skills 4.6.1 → 4.7.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -72,7 +72,7 @@ xno-skills --help
72
72
 
73
73
  To pin to the current stable release instead:
74
74
  ```bash
75
- npm install -g xno-skills@4.6.1 && npx -y skills add CasualSecurityInc/xno-skills -g -y --all
75
+ npm install -g xno-skills@4.7.0 && npx -y skills add CasualSecurityInc/xno-skills -g -y --all
76
76
  ```
77
77
 
78
78
 
@@ -132,7 +132,7 @@ Exposes Nano wallet functions as tools for AI agents (Claude Desktop, Cursor, Co
132
132
  **Preferred** (global install — avoids `npx` concurrency handshake failures):
133
133
 
134
134
  ```bash
135
- npm install -g xno-skills@4.6.1
135
+ npm install -g xno-skills@4.7.0
136
136
  ```
137
137
 
138
138
  ```json
@@ -153,7 +153,7 @@ npm install -g xno-skills@4.6.1
153
153
  "mcpServers": {
154
154
  "nano": {
155
155
  "command": "npx",
156
- "args": ["-y", "-p", "xno-skills@4.6.1", "xno-mcp"]
156
+ "args": ["-y", "-p", "xno-skills@4.7.0", "xno-mcp"]
157
157
  }
158
158
  }
159
159
  }
@@ -166,7 +166,7 @@ npm install -g xno-skills@4.6.1
166
166
  <summary>Codex</summary>
167
167
 
168
168
  ```bash
169
- # Preferred (after npm install -g xno-skills@4.6.1):
169
+ # Preferred (after npm install -g xno-skills@4.7.0):
170
170
  codex mcp add nano \
171
171
  -c sandbox_mode="danger-full-access" \
172
172
  -c 'sandbox_permissions=["network-access"]' \
@@ -176,7 +176,7 @@ codex mcp add nano \
176
176
  codex mcp add nano \
177
177
  -c sandbox_mode="danger-full-access" \
178
178
  -c 'sandbox_permissions=["network-access"]' \
179
- -- npx -y -p xno-skills@4.6.1 xno-mcp
179
+ -- npx -y -p xno-skills@4.7.0 xno-mcp
180
180
  ```
181
181
  </details>
182
182
 
package/dist/cjs/cli.js CHANGED
@@ -797,7 +797,7 @@ Configuration for popular AI agent harnesses:
797
797
 
798
798
  Preferred (global install — avoids npx concurrency handshake failures):
799
799
 
800
- npm install -g xno-skills@4.6.1
800
+ npm install -g xno-skills@4.7.0
801
801
 
802
802
  1. Claude Desktop / Cursor / Roo Code (in config.json):
803
803
  {
@@ -822,16 +822,16 @@ Fallback (if global install is not possible):
822
822
  "mcpServers": {
823
823
  "xno": {
824
824
  "command": "npx",
825
- "args": ["-y", "xno-skills@4.6.1", "mcp"]
825
+ "args": ["-y", "xno-skills@4.7.0", "mcp"]
826
826
  }
827
827
  }
828
828
  }
829
829
 
830
830
  2. Gemini CLI:
831
- gemini mcp add xno npx -y xno-skills@4.6.1 mcp
831
+ gemini mcp add xno npx -y xno-skills@4.7.0 mcp
832
832
 
833
833
  3. Claude Code:
834
- claude mcp add xno npx -y xno-skills@4.6.1 mcp
834
+ claude mcp add xno npx -y xno-skills@4.7.0 mcp
835
835
 
836
836
  To run the MCP server directly in this terminal:
837
837
  xno-skills mcp (if globally installed)
@@ -1,6 +1,6 @@
1
1
  export declare const pkg: {
2
2
  readonly name: "xno-skills";
3
- readonly version: "4.6.1";
3
+ readonly version: "4.7.0";
4
4
  };
5
- export declare const version: "4.6.1";
5
+ export declare const version: "4.7.0";
6
6
  //# sourceMappingURL=version.d.ts.map
@@ -2,7 +2,7 @@
2
2
  // Keep this in sync by running "npm run build" (prebuild hook).
3
3
  export const pkg = {
4
4
  name: "xno-skills",
5
- version: "4.6.1"
5
+ version: "4.7.0"
6
6
  };
7
7
  export const version = pkg.version;
8
8
  //# sourceMappingURL=version.js.map
@@ -1,27 +1,27 @@
1
1
  {
2
2
  "requests": [
3
3
  {
4
- "id": "mt13fmevxw3d2q",
4
+ "id": "mt1449auiz2vbp",
5
5
  "owsWalletId": "A",
6
6
  "accountIndex": 0,
7
7
  "address": "nano_3i1aq1cchnmbn9x5rsbap8b15akfh7wj7pwskuzi7ahz8oq6cobd99d4r3b7",
8
8
  "amountRaw": "10000000000000000000000000000",
9
9
  "reason": "explicit wallet test",
10
10
  "status": "pending",
11
- "createdAt": "2026-08-20T05:42:11.767Z",
12
- "updatedAt": "2026-08-20T05:42:11.767Z",
11
+ "createdAt": "2026-08-20T06:01:21.174Z",
12
+ "updatedAt": "2026-08-20T06:01:21.174Z",
13
13
  "receivedBlocks": []
14
14
  },
15
15
  {
16
- "id": "mt13fmfn7r0ejm",
16
+ "id": "mt1449bp2eiwzq",
17
17
  "owsWalletId": "A",
18
18
  "accountIndex": 0,
19
19
  "address": "nano_3i1aq1cchnmbn9x5rsbap8b15akfh7wj7pwskuzi7ahz8oq6cobd99d4r3b7",
20
20
  "amountRaw": "500000000000000000000000000000",
21
21
  "reason": "status check test",
22
22
  "status": "pending",
23
- "createdAt": "2026-08-20T05:42:11.795Z",
24
- "updatedAt": "2026-08-20T05:42:11.795Z",
23
+ "createdAt": "2026-08-20T06:01:21.205Z",
24
+ "updatedAt": "2026-08-20T06:01:21.205Z",
25
25
  "receivedBlocks": []
26
26
  }
27
27
  ]
package/dist/esm/cli.js CHANGED
@@ -797,7 +797,7 @@ Configuration for popular AI agent harnesses:
797
797
 
798
798
  Preferred (global install — avoids npx concurrency handshake failures):
799
799
 
800
- npm install -g xno-skills@4.6.1
800
+ npm install -g xno-skills@4.7.0
801
801
 
802
802
  1. Claude Desktop / Cursor / Roo Code (in config.json):
803
803
  {
@@ -822,16 +822,16 @@ Fallback (if global install is not possible):
822
822
  "mcpServers": {
823
823
  "xno": {
824
824
  "command": "npx",
825
- "args": ["-y", "xno-skills@4.6.1", "mcp"]
825
+ "args": ["-y", "xno-skills@4.7.0", "mcp"]
826
826
  }
827
827
  }
828
828
  }
829
829
 
830
830
  2. Gemini CLI:
831
- gemini mcp add xno npx -y xno-skills@4.6.1 mcp
831
+ gemini mcp add xno npx -y xno-skills@4.7.0 mcp
832
832
 
833
833
  3. Claude Code:
834
- claude mcp add xno npx -y xno-skills@4.6.1 mcp
834
+ claude mcp add xno npx -y xno-skills@4.7.0 mcp
835
835
 
836
836
  To run the MCP server directly in this terminal:
837
837
  xno-skills mcp (if globally installed)
@@ -1,6 +1,6 @@
1
1
  export declare const pkg: {
2
2
  readonly name: "xno-skills";
3
- readonly version: "4.6.1";
3
+ readonly version: "4.7.0";
4
4
  };
5
- export declare const version: "4.6.1";
5
+ export declare const version: "4.7.0";
6
6
  //# sourceMappingURL=version.d.ts.map
@@ -2,7 +2,7 @@
2
2
  // Keep this in sync by running "npm run build" (prebuild hook).
3
3
  export const pkg = {
4
4
  name: "xno-skills",
5
- version: "4.6.1"
5
+ version: "4.7.0"
6
6
  };
7
7
  export const version = pkg.version;
8
8
  //# sourceMappingURL=version.js.map
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "xno-skills",
3
- "version": "4.6.1",
3
+ "version": "4.7.0",
4
4
  "description": "The Nano (XNO) toolkit for AI agents and developers. Send, receive, check balances, and manage payment requests without ever handling private keys.",
5
5
  "type": "module",
6
6
  "main": "./dist/cjs/index.js",
@@ -82,7 +82,7 @@
82
82
  "@noble/curves": "^2.0.1",
83
83
  "@noble/hashes": "^1.7.0",
84
84
  "@open-wallet-standard/core": "^1.3.2",
85
- "@openrai/nano-core": "^3.2.1",
85
+ "@openrai/nano-core": "^3.3.0",
86
86
  "commander": "^14.0.3",
87
87
  "qrcode-svg": "^1.1.0",
88
88
  "qrcode-terminal": "^0.12.0",
@@ -85,12 +85,12 @@ If the client supports MCP, set it up as a "stdio" type MCP server.
85
85
 
86
86
  **Preferred — global install** (avoids `npx` concurrency issues that cause handshake failures):
87
87
 
88
- npm install -g xno-skills@4.6.1
88
+ npm install -g xno-skills@4.7.0
89
89
  xno-skills mcp
90
90
 
91
91
  **Fallback** (only if global install is not possible):
92
92
 
93
- npx -y xno-skills@4.6.1 mcp
93
+ npx -y xno-skills@4.7.0 mcp
94
94
 
95
95
  > **Why not `npx` by default?** When multiple agent sessions start concurrently, `npx` can fail during package resolution — the second process exits before the MCP handshake completes. A global install eliminates this race.
96
96
 
@@ -102,16 +102,16 @@ If `xno-mcp` tools are not available, or the user explicitly asks for CLI usage,
102
102
 
103
103
  ```
104
104
  1. xno-skills <command> (global install — preferred)
105
- 2. bunx -y xno-skills@4.6.1 <command>
106
- 3. pnpm dlx xno-skills@4.6.1 <command>
107
- 4. npx -y xno-skills@4.6.1 <command>
105
+ 2. bunx -y xno-skills@4.7.0 <command>
106
+ 3. pnpm dlx xno-skills@4.7.0 <command>
107
+ 4. npx -y xno-skills@4.7.0 <command>
108
108
  ```
109
109
 
110
110
  If the global `xno-skills` binary is not available, fall through to the next option. Always pin the version (`@4.5.2`) with `bunx`/`pnpm dlx`/`npx` to prevent interactive prompts from freezing.
111
111
 
112
112
  Before guessing a subcommand, run `--help`:
113
113
  ```bash
114
- xno-skills --help # or: bunx -y xno-skills@4.6.1 --help
114
+ xno-skills --help # or: bunx -y xno-skills@4.7.0 --help
115
115
  ```
116
116
 
117
117
  ### 3. Wallet lifecycle → `ows` skill only
@@ -140,7 +140,7 @@ When the user asks for an account, block, transaction, or explorer link, always
140
140
  - **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.
141
141
  - **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.
142
142
  - **No mnemonic exports**: Never call `ows wallet export` or suggest exporting to a third-party wallet unless the user explicitly commands it.
143
- - **Supply chain**: Only use `xno-skills@4.6.1` and `@open-wallet-standard/core`. No other npm packages.
143
+ - **Supply chain**: Only use `xno-skills@4.7.0` and `@open-wallet-standard/core`. No other npm packages.
144
144
  - **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.
145
145
 
146
146
  ---
@@ -171,8 +171,8 @@ To **create** a new wallet, delegate to the `ows` skill. Then return here for al
171
171
 
172
172
  **Via CLI (required flags only):**
173
173
  ```bash
174
- bunx -y xno-skills@4.6.1 balance --wallet "my-wallet"
175
- bunx -y xno-skills@4.6.1 rpc account-balance <address>
174
+ bunx -y xno-skills@4.7.0 balance --wallet "my-wallet"
175
+ bunx -y xno-skills@4.7.0 rpc account-balance <address>
176
176
  ```
177
177
 
178
178
  Full options: [balance](references/balance.md), [rpc_account-balance](references/rpc_account-balance.md)
@@ -203,7 +203,7 @@ A Nano transfer shows as **pending** until the recipient publishes a receive blo
203
203
 
204
204
  **Via CLI (required flags only):**
205
205
  ```bash
206
- bunx -y xno-skills@4.6.1 receive --wallet "my-wallet"
206
+ bunx -y xno-skills@4.7.0 receive --wallet "my-wallet"
207
207
  ```
208
208
 
209
209
  Full options: [receive](references/receive.md)
@@ -235,7 +235,7 @@ The account must be opened (have a receive block) and have sufficient balance.
235
235
 
236
236
  **Via CLI (required flags only):**
237
237
  ```bash
238
- bunx -y xno-skills@4.6.1 send --wallet "my-wallet" --to "nano_..." --amount-xno 0.01
238
+ bunx -y xno-skills@4.7.0 send --wallet "my-wallet" --to "nano_..." --amount-xno 0.01
239
239
  ```
240
240
 
241
241
  Full options: [send](references/send.md)
@@ -351,7 +351,7 @@ Generates a terminal-friendly ASCII QR code for a Nano address, optionally with
351
351
 
352
352
  **Via CLI (required args only):**
353
353
  ```bash
354
- bunx -y xno-skills@4.6.1 qr nano_1abc...
354
+ bunx -y xno-skills@4.7.0 qr nano_1abc...
355
355
  ```
356
356
 
357
357
  Full options: [qr](references/qr.md)
@@ -378,7 +378,7 @@ All validation is **offline** — no network required.
378
378
 
379
379
  **Via CLI:**
380
380
  ```bash
381
- bunx -y xno-skills@4.6.1 validate nano_1abc...
381
+ bunx -y xno-skills@4.7.0 validate nano_1abc...
382
382
  ```
383
383
 
384
384
  Full options: [validate](references/validate.md)
@@ -405,10 +405,10 @@ XNO uses **30 decimal places**. Floating-point arithmetic is unsafe. Always use
405
405
 
406
406
  **Via CLI:**
407
407
  ```bash
408
- bunx -y xno-skills@4.6.1 convert 1 xno # all units
409
- bunx -y xno-skills@4.6.1 convert 1 knano
410
- bunx -y xno-skills@4.6.1 convert 1000000000000000000000000000000 raw
411
- bunx -y xno-skills@4.6.1 convert 1 xno --json
408
+ bunx -y xno-skills@4.7.0 convert 1 xno # all units
409
+ bunx -y xno-skills@4.7.0 convert 1 knano
410
+ bunx -y xno-skills@4.7.0 convert 1000000000000000000000000000000 raw
411
+ bunx -y xno-skills@4.7.0 convert 1 xno --json
412
412
  ```
413
413
 
414
414
  Full options: [convert](references/convert.md)
@@ -434,20 +434,20 @@ Present the user with this command to run locally:
434
434
 
435
435
  ```bash
436
436
  # Sign — run this yourself, replacing the placeholder with your actual key
437
- bunx -y xno-skills@4.6.1 sign "<message>" --key YOUR_PRIVATE_KEY_HEX
437
+ bunx -y xno-skills@4.7.0 sign "<message>" --key YOUR_PRIVATE_KEY_HEX
438
438
 
439
439
  # Sign with JSON output
440
- bunx -y xno-skills@4.6.1 sign "<message>" --key YOUR_PRIVATE_KEY_HEX --json
440
+ bunx -y xno-skills@4.7.0 sign "<message>" --key YOUR_PRIVATE_KEY_HEX --json
441
441
  ```
442
442
 
443
443
  For verify, the agent *can* run this directly (no secret material involved):
444
444
 
445
445
  ```bash
446
446
  # Verify
447
- bunx -y xno-skills@4.6.1 verify <nano_address> "<message>" <signature-hex>
447
+ bunx -y xno-skills@4.7.0 verify <nano_address> "<message>" <signature-hex>
448
448
 
449
449
  # Verify with JSON output
450
- bunx -y xno-skills@4.6.1 verify <nano_address> "<message>" <signature-hex> --json
450
+ bunx -y xno-skills@4.7.0 verify <nano_address> "<message>" <signature-hex> --json
451
451
  ```
452
452
 
453
453
  **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.
@@ -526,7 +526,7 @@ PoW input:
526
526
  { "name": "wallet_change_rep", "arguments": { "wallet": "my-wallet", "representative": "nano_..." } }
527
527
  ```
528
528
  ```bash
529
- bunx -y xno-skills@4.6.1 change-rep --wallet "my-wallet" --representative "nano_..."
529
+ bunx -y xno-skills@4.7.0 change-rep --wallet "my-wallet" --representative "nano_..."
530
530
  ```
531
531
 
532
532
  Full options: [change-rep](references/change-rep.md)
@@ -12,7 +12,7 @@ Configuration for popular AI agent harnesses:
12
12
 
13
13
  Preferred (global install — avoids npx concurrency handshake failures):
14
14
 
15
- npm install -g xno-skills@4.6.1
15
+ npm install -g xno-skills@4.7.0
16
16
 
17
17
  1. Claude Desktop / Cursor / Roo Code (in config.json):
18
18
  {
@@ -37,16 +37,16 @@ Fallback (if global install is not possible):
37
37
  "mcpServers": {
38
38
  "xno": {
39
39
  "command": "npx",
40
- "args": ["-y", "xno-skills@4.6.1", "mcp"]
40
+ "args": ["-y", "xno-skills@4.7.0", "mcp"]
41
41
  }
42
42
  }
43
43
  }
44
44
 
45
45
  2. Gemini CLI:
46
- gemini mcp add xno npx -y xno-skills@4.6.1 mcp
46
+ gemini mcp add xno npx -y xno-skills@4.7.0 mcp
47
47
 
48
48
  3. Claude Code:
49
- claude mcp add xno npx -y xno-skills@4.6.1 mcp
49
+ claude mcp add xno npx -y xno-skills@4.7.0 mcp
50
50
 
51
51
  To run the MCP server directly in this terminal:
52
52
  xno-skills mcp (if globally installed)