xno-skills 4.5.0 → 4.5.1

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
@@ -50,7 +50,7 @@ xno-skills --help
50
50
 
51
51
  To pin to the current stable release instead:
52
52
  ```bash
53
- npm install -g xno-skills@4.5.0 && npx -y skills add CasualSecurityInc/xno-skills -g -y --all
53
+ npm install -g xno-skills@4.5.1 && npx -y skills add CasualSecurityInc/xno-skills -g -y --all
54
54
  ```
55
55
 
56
56
 
@@ -112,7 +112,7 @@ Exposes Nano wallet functions as tools for AI agents (Claude Desktop, Cursor, Co
112
112
  "mcpServers": {
113
113
  "nano": {
114
114
  "command": "npx",
115
- "args": ["-y", "-p", "xno-skills@4.5.0", "xno-mcp"]
115
+ "args": ["-y", "-p", "xno-skills@4.5.1", "xno-mcp"]
116
116
  }
117
117
  }
118
118
  }
@@ -128,7 +128,7 @@ Exposes Nano wallet functions as tools for AI agents (Claude Desktop, Cursor, Co
128
128
  codex mcp add nano \
129
129
  -c sandbox_mode="danger-full-access" \
130
130
  -c 'sandbox_permissions=["network-access"]' \
131
- -- npx -y -p xno-skills@4.5.0 xno-mcp
131
+ -- npx -y -p xno-skills@4.5.1 xno-mcp
132
132
  ```
133
133
  </details>
134
134
 
@@ -140,7 +140,7 @@ codex mcp add nano \
140
140
  "mcpServers": {
141
141
  "nano": {
142
142
  "command": "npx",
143
- "args": ["-y", "-p", "xno-skills@4.5.0", "xno-mcp"]
143
+ "args": ["-y", "-p", "xno-skills@4.5.1", "xno-mcp"]
144
144
  }
145
145
  }
146
146
  }
@@ -156,7 +156,7 @@ codex mcp add nano \
156
156
  "mcp": {
157
157
  "nano": {
158
158
  "type": "local",
159
- "command": ["npx", "-y", "-p", "xno-skills@4.5.0", "xno-mcp"],
159
+ "command": ["npx", "-y", "-p", "xno-skills@4.5.1", "xno-mcp"],
160
160
  "enabled": true
161
161
  }
162
162
  }
@@ -172,7 +172,7 @@ codex mcp add nano \
172
172
  "mcpServers": {
173
173
  "nano": {
174
174
  "command": "npx",
175
- "args": ["-y", "-p", "xno-skills@4.5.0", "xno-mcp"]
175
+ "args": ["-y", "-p", "xno-skills@4.5.1", "xno-mcp"]
176
176
  }
177
177
  }
178
178
  }
@@ -187,7 +187,7 @@ codex mcp add nano \
187
187
  "mcpServers": {
188
188
  "nano": {
189
189
  "command": "npx",
190
- "args": ["-y", "-p", "xno-skills@4.5.0", "xno-mcp"]
190
+ "args": ["-y", "-p", "xno-skills@4.5.1", "xno-mcp"]
191
191
  }
192
192
  }
193
193
  }
@@ -203,7 +203,7 @@ codex mcp add nano \
203
203
  "nano": {
204
204
  "type": "stdio",
205
205
  "command": "npx",
206
- "args": ["-y", "-p", "xno-skills@4.5.0", "xno-mcp"]
206
+ "args": ["-y", "-p", "xno-skills@4.5.1", "xno-mcp"]
207
207
  }
208
208
  }
209
209
  }
@@ -1,6 +1,6 @@
1
1
  export declare const pkg: {
2
2
  readonly name: "xno-skills";
3
- readonly version: "4.5.0";
3
+ readonly version: "4.5.1";
4
4
  };
5
- export declare const version: "4.5.0";
5
+ export declare const version: "4.5.1";
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.5.0"
5
+ version: "4.5.1"
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": "mrlnhnzllrfp2b",
4
+ "id": "mrsq13036xl0kn",
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-07-15T05:39:38.289Z",
12
- "updatedAt": "2026-07-15T05:39:38.289Z",
11
+ "createdAt": "2026-07-20T04:25:06.675Z",
12
+ "updatedAt": "2026-07-20T04:25:06.675Z",
13
13
  "receivedBlocks": []
14
14
  },
15
15
  {
16
- "id": "mrlnho074td2uf",
16
+ "id": "mrsq130tjdtvns",
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-07-15T05:39:38.311Z",
24
- "updatedAt": "2026-07-15T05:39:38.311Z",
23
+ "createdAt": "2026-07-20T04:25:06.701Z",
24
+ "updatedAt": "2026-07-20T04:25:06.701Z",
25
25
  "receivedBlocks": []
26
26
  }
27
27
  ]
@@ -1,6 +1,6 @@
1
1
  export declare const pkg: {
2
2
  readonly name: "xno-skills";
3
- readonly version: "4.5.0";
3
+ readonly version: "4.5.1";
4
4
  };
5
- export declare const version: "4.5.0";
5
+ export declare const version: "4.5.1";
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.5.0"
5
+ version: "4.5.1"
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.5.0",
3
+ "version": "4.5.1",
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",
@@ -83,7 +83,7 @@ When the environment provides `xno-mcp` tools (`wallet_list`, `wallet_send`, `wa
83
83
 
84
84
  If the client supports MCP, set it up as a "stdio" type MCP server:
85
85
 
86
- npx -y -p xno-skills@4.5.0 -- mcp
86
+ npx -y -p xno-skills@4.5.1 -- mcp
87
87
 
88
88
  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.
89
89
 
@@ -92,16 +92,16 @@ MCP is the primary execution path because tools, schemas, and results are struct
92
92
  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:
93
93
 
94
94
  ```
95
- 1. bunx -y xno-skills@4.5.0 <command>
96
- 2. pnpm dlx xno-skills@4.5.0 <command>
97
- 3. npx -y xno-skills@4.5.0 <command>
95
+ 1. bunx -y xno-skills@4.5.1 <command>
96
+ 2. pnpm dlx xno-skills@4.5.1 <command>
97
+ 3. npx -y xno-skills@4.5.1 <command>
98
98
  ```
99
99
 
100
100
  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.
101
101
 
102
102
  Before guessing a subcommand, run `--help`:
103
103
  ```bash
104
- bunx -y xno-skills@4.5.0 --help
104
+ bunx -y xno-skills@4.5.1 --help
105
105
  ```
106
106
 
107
107
  ### 3. Wallet lifecycle → `ows` skill only
@@ -130,7 +130,7 @@ When the user asks for an account, block, transaction, or explorer link, always
130
130
  - **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.
131
131
  - **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.
132
132
  - **No mnemonic exports**: Never call `ows wallet export` or suggest exporting to a third-party wallet unless the user explicitly commands it.
133
- - **Supply chain**: Only use `xno-skills@4.5.0` and `@open-wallet-standard/core`. No other npm packages.
133
+ - **Supply chain**: Only use `xno-skills@4.5.1` and `@open-wallet-standard/core`. No other npm packages.
134
134
  - **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.
135
135
 
136
136
  ---
@@ -161,8 +161,8 @@ To **create** a new wallet, delegate to the `ows` skill. Then return here for al
161
161
 
162
162
  **Via CLI (required flags only):**
163
163
  ```bash
164
- bunx -y xno-skills@4.5.0 balance --wallet "my-wallet"
165
- bunx -y xno-skills@4.5.0 rpc account-balance <address>
164
+ bunx -y xno-skills@4.5.1 balance --wallet "my-wallet"
165
+ bunx -y xno-skills@4.5.1 rpc account-balance <address>
166
166
  ```
167
167
 
168
168
  Full options: [balance](references/balance.md), [rpc_account-balance](references/rpc_account-balance.md)
@@ -193,7 +193,7 @@ A Nano transfer shows as **pending** until the recipient publishes a receive blo
193
193
 
194
194
  **Via CLI (required flags only):**
195
195
  ```bash
196
- bunx -y xno-skills@4.5.0 receive --wallet "my-wallet"
196
+ bunx -y xno-skills@4.5.1 receive --wallet "my-wallet"
197
197
  ```
198
198
 
199
199
  Full options: [receive](references/receive.md)
@@ -225,7 +225,7 @@ The account must be opened (have a receive block) and have sufficient balance.
225
225
 
226
226
  **Via CLI (required flags only):**
227
227
  ```bash
228
- bunx -y xno-skills@4.5.0 send --wallet "my-wallet" --to "nano_..." --amount-xno 0.01
228
+ bunx -y xno-skills@4.5.1 send --wallet "my-wallet" --to "nano_..." --amount-xno 0.01
229
229
  ```
230
230
 
231
231
  Full options: [send](references/send.md)
@@ -341,7 +341,7 @@ Generates a terminal-friendly ASCII QR code for a Nano address, optionally with
341
341
 
342
342
  **Via CLI (required args only):**
343
343
  ```bash
344
- bunx -y xno-skills@4.5.0 qr nano_1abc...
344
+ bunx -y xno-skills@4.5.1 qr nano_1abc...
345
345
  ```
346
346
 
347
347
  Full options: [qr](references/qr.md)
@@ -368,7 +368,7 @@ All validation is **offline** — no network required.
368
368
 
369
369
  **Via CLI:**
370
370
  ```bash
371
- bunx -y xno-skills@4.5.0 validate nano_1abc...
371
+ bunx -y xno-skills@4.5.1 validate nano_1abc...
372
372
  ```
373
373
 
374
374
  Full options: [validate](references/validate.md)
@@ -395,10 +395,10 @@ XNO uses **30 decimal places**. Floating-point arithmetic is unsafe. Always use
395
395
 
396
396
  **Via CLI:**
397
397
  ```bash
398
- bunx -y xno-skills@4.5.0 convert 1 xno # all units
399
- bunx -y xno-skills@4.5.0 convert 1 knano
400
- bunx -y xno-skills@4.5.0 convert 1000000000000000000000000000000 raw
401
- bunx -y xno-skills@4.5.0 convert 1 xno --json
398
+ bunx -y xno-skills@4.5.1 convert 1 xno # all units
399
+ bunx -y xno-skills@4.5.1 convert 1 knano
400
+ bunx -y xno-skills@4.5.1 convert 1000000000000000000000000000000 raw
401
+ bunx -y xno-skills@4.5.1 convert 1 xno --json
402
402
  ```
403
403
 
404
404
  Full options: [convert](references/convert.md)
@@ -424,20 +424,20 @@ Present the user with this command to run locally:
424
424
 
425
425
  ```bash
426
426
  # Sign — run this yourself, replacing the placeholder with your actual key
427
- bunx -y xno-skills@4.5.0 sign "<message>" --key YOUR_PRIVATE_KEY_HEX
427
+ bunx -y xno-skills@4.5.1 sign "<message>" --key YOUR_PRIVATE_KEY_HEX
428
428
 
429
429
  # Sign with JSON output
430
- bunx -y xno-skills@4.5.0 sign "<message>" --key YOUR_PRIVATE_KEY_HEX --json
430
+ bunx -y xno-skills@4.5.1 sign "<message>" --key YOUR_PRIVATE_KEY_HEX --json
431
431
  ```
432
432
 
433
433
  For verify, the agent *can* run this directly (no secret material involved):
434
434
 
435
435
  ```bash
436
436
  # Verify
437
- bunx -y xno-skills@4.5.0 verify <nano_address> "<message>" <signature-hex>
437
+ bunx -y xno-skills@4.5.1 verify <nano_address> "<message>" <signature-hex>
438
438
 
439
439
  # Verify with JSON output
440
- bunx -y xno-skills@4.5.0 verify <nano_address> "<message>" <signature-hex> --json
440
+ bunx -y xno-skills@4.5.1 verify <nano_address> "<message>" <signature-hex> --json
441
441
  ```
442
442
 
443
443
  **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.
@@ -512,7 +512,7 @@ PoW input:
512
512
  { "name": "wallet_change_rep", "arguments": { "wallet": "my-wallet", "representative": "nano_..." } }
513
513
  ```
514
514
  ```bash
515
- bunx -y xno-skills@4.5.0 change-rep --wallet "my-wallet" --representative "nano_..."
515
+ bunx -y xno-skills@4.5.1 change-rep --wallet "my-wallet" --representative "nano_..."
516
516
  ```
517
517
 
518
518
  Full options: [change-rep](references/change-rep.md)