xno-skills 5.1.0 → 5.1.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
@@ -32,7 +32,6 @@ PoW runs locally through the `nano-core` work provider when recommended. Otherwi
32
32
 
33
33
  ## Agent Skills
34
34
 
35
- [![smithery badge](https://smithery.ai/badge/casualsecurityinc/xno-skills)](https://smithery.ai/servers/casualsecurityinc/xno-skills)
36
35
  [![skills.sh](https://skills.sh/b/casualsecurityinc/xno-skills)](https://skills.sh/casualsecurityinc/xno-skills)
37
36
 
38
37
  Built-in skill for Personal AI Agents (OpenClaw etc.) and humans with AI Coding Assistants (Claude Code, Cursor, etc.) alike:
@@ -77,7 +76,7 @@ xno-skills --help
77
76
  To pin to the current stable release instead:
78
77
 
79
78
  ```bash
80
- npm install -g xno-skills@5.1.0 && npx -y skills add CasualSecurityInc/xno-skills -g -y --all
79
+ npm install -g xno-skills@5.1.1 && npx -y skills add CasualSecurityInc/xno-skills -g -y --all
81
80
  ```
82
81
 
83
82
  ### Wallet Operations
@@ -134,12 +133,14 @@ Wallet lifecycle (create, import, rename, delete) is managed by [OWS](https://gi
134
133
 
135
134
  ## MCP Server
136
135
 
136
+ The Nano wallet MCP server runs on your machine over stdio and uses your local OWS wallet. There is no hosted endpoint. Use the npm setup below and see [skill installation](#agent-skills) for the GitHub install command.
137
+
137
138
  Exposes Nano wallet functions as tools for AI agents (Claude Desktop, Cursor, Codex, etc.). MCP resources (`xno-wallet://` URIs) are served but require client-side `resources/read` support — not yet available in OpenCode ([#15535](https://github.com/anomalyco/opencode/issues/15535)).
138
139
 
139
140
  **Preferred** (global install — avoids `npx` concurrency handshake failures):
140
141
 
141
142
  ```bash
142
- npm install -g xno-skills@5.1.0
143
+ npm install -g xno-skills@5.1.1
143
144
  ```
144
145
 
145
146
  ```json
@@ -160,7 +161,7 @@ npm install -g xno-skills@5.1.0
160
161
  "mcpServers": {
161
162
  "nano": {
162
163
  "command": "npx",
163
- "args": ["-y", "-p", "xno-skills@5.1.0", "xno-mcp"]
164
+ "args": ["-y", "-p", "xno-skills@5.1.1", "xno-mcp"]
164
165
  }
165
166
  }
166
167
  }
@@ -172,7 +173,7 @@ npm install -g xno-skills@5.1.0
172
173
  <summary>Codex</summary>
173
174
 
174
175
  ```bash
175
- # Preferred (after npm install -g xno-skills@5.1.0):
176
+ # Preferred (after npm install -g xno-skills@5.1.1):
176
177
  codex mcp add nano \
177
178
  -c sandbox_mode="danger-full-access" \
178
179
  -c 'sandbox_permissions=["network-access"]' \
@@ -182,7 +183,7 @@ codex mcp add nano \
182
183
  codex mcp add nano \
183
184
  -c sandbox_mode="danger-full-access" \
184
185
  -c 'sandbox_permissions=["network-access"]' \
185
- -- npx -y -p xno-skills@5.1.0 xno-mcp
186
+ -- npx -y -p xno-skills@5.1.1 xno-mcp
186
187
  ```
187
188
 
188
189
  </details>
package/dist/cjs/cli.js CHANGED
@@ -757,7 +757,7 @@ Configuration for popular AI agent harnesses:
757
757
 
758
758
  Preferred (global install — avoids npx concurrency handshake failures):
759
759
 
760
- npm install -g xno-skills@5.1.0
760
+ npm install -g xno-skills@5.1.1
761
761
 
762
762
  1. Claude Desktop / Cursor / Roo Code (in config.json):
763
763
  {
@@ -782,16 +782,16 @@ Fallback (if global install is not possible):
782
782
  "mcpServers": {
783
783
  "xno": {
784
784
  "command": "npx",
785
- "args": ["-y", "xno-skills@5.1.0", "mcp"]
785
+ "args": ["-y", "xno-skills@5.1.1", "mcp"]
786
786
  }
787
787
  }
788
788
  }
789
789
 
790
790
  2. Gemini CLI:
791
- gemini mcp add xno npx -y xno-skills@5.1.0 mcp
791
+ gemini mcp add xno npx -y xno-skills@5.1.1 mcp
792
792
 
793
793
  3. Claude Code:
794
- claude mcp add xno npx -y xno-skills@5.1.0 mcp
794
+ claude mcp add xno npx -y xno-skills@5.1.1 mcp
795
795
 
796
796
  To run the MCP server directly in this terminal:
797
797
  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: "5.1.0";
3
+ readonly version: "5.1.1";
4
4
  };
5
- export declare const version: "5.1.0";
5
+ export declare const version: "5.1.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: "5.1.0"
5
+ version: "5.1.1"
6
6
  };
7
7
  export const version = pkg.version;
8
8
  //# sourceMappingURL=version.js.map
package/dist/esm/cli.js CHANGED
@@ -757,7 +757,7 @@ Configuration for popular AI agent harnesses:
757
757
 
758
758
  Preferred (global install — avoids npx concurrency handshake failures):
759
759
 
760
- npm install -g xno-skills@5.1.0
760
+ npm install -g xno-skills@5.1.1
761
761
 
762
762
  1. Claude Desktop / Cursor / Roo Code (in config.json):
763
763
  {
@@ -782,16 +782,16 @@ Fallback (if global install is not possible):
782
782
  "mcpServers": {
783
783
  "xno": {
784
784
  "command": "npx",
785
- "args": ["-y", "xno-skills@5.1.0", "mcp"]
785
+ "args": ["-y", "xno-skills@5.1.1", "mcp"]
786
786
  }
787
787
  }
788
788
  }
789
789
 
790
790
  2. Gemini CLI:
791
- gemini mcp add xno npx -y xno-skills@5.1.0 mcp
791
+ gemini mcp add xno npx -y xno-skills@5.1.1 mcp
792
792
 
793
793
  3. Claude Code:
794
- claude mcp add xno npx -y xno-skills@5.1.0 mcp
794
+ claude mcp add xno npx -y xno-skills@5.1.1 mcp
795
795
 
796
796
  To run the MCP server directly in this terminal:
797
797
  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: "5.1.0";
3
+ readonly version: "5.1.1";
4
4
  };
5
- export declare const version: "5.1.0";
5
+ export declare const version: "5.1.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: "5.1.0"
5
+ version: "5.1.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": "5.1.0",
3
+ "version": "5.1.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",
@@ -106,12 +106,12 @@ If the client supports MCP, set it up as a "stdio" type MCP server.
106
106
 
107
107
  **Preferred — global install** (avoids `npx` concurrency issues that cause handshake failures):
108
108
 
109
- npm install -g xno-skills@5.1.0
109
+ npm install -g xno-skills@5.1.1
110
110
  xno-skills mcp
111
111
 
112
112
  **Fallback** (only if global install is not possible):
113
113
 
114
- npx -y xno-skills@5.1.0 mcp
114
+ npx -y xno-skills@5.1.1 mcp
115
115
 
116
116
  > **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.
117
117
 
@@ -123,22 +123,22 @@ If `xno-mcp` tools are not available, or the user explicitly asks for CLI usage,
123
123
 
124
124
  ```
125
125
  1. xno-skills <command> (global install — preferred)
126
- 2. bunx -y xno-skills@5.1.0 <command>
127
- 3. pnpm dlx xno-skills@5.1.0 <command>
128
- 4. npx -y xno-skills@5.1.0 <command>
126
+ 2. bunx -y xno-skills@5.1.1 <command>
127
+ 3. pnpm dlx xno-skills@5.1.1 <command>
128
+ 4. npx -y xno-skills@5.1.1 <command>
129
129
  ```
130
130
 
131
- If the global `xno-skills` binary is not available, fall through to the next option. Always pin the version (`xno-skills@5.1.0`) with `bunx`/`pnpm dlx`/`npx` to prevent interactive prompts from freezing.
131
+ If the global `xno-skills` binary is not available, fall through to the next option. Always pin the version (`xno-skills@5.1.1`) with `bunx`/`pnpm dlx`/`npx` to prevent interactive prompts from freezing.
132
132
 
133
133
  Before guessing a subcommand, run `--help`:
134
134
 
135
135
  ```bash
136
- xno-skills --help # or: bunx -y xno-skills@5.1.0 --help
136
+ xno-skills --help # or: bunx -y xno-skills@5.1.1 --help
137
137
  ```
138
138
 
139
139
  ### 3. Wallet creation and lifecycle
140
140
 
141
- Create a wallet only on explicit user request. Ask for a name if missing. Call `wallet_create` with `{"name":"treasury"}` or run `xno-skills wallet create --name treasury` when using the CLI. The installed `@open-wallet-standard/core` npm dependency writes to the local OWS vault and the command returns only `name` and the Nano `address`. Creation uses the installed runtime without downloading dependencies or requiring a global `ows` command. If the runtime is missing, show the pinned npm install command and wait for the user to run it. [Wallet creation source](https://github.com/CasualSecurityInc/xno-skills/blob/v5.1.0/src/nano-actions.ts)
141
+ Create a wallet only on explicit user request. Ask for a name if missing. Call `wallet_create` with `{"name":"treasury"}` or run `xno-skills wallet create --name treasury` when using the CLI. The installed `@open-wallet-standard/core` npm dependency writes to the local OWS vault and the command returns only `name` and the Nano `address`. Creation uses the installed runtime without downloading dependencies or requiring a global `ows` command. If the runtime is missing, show the pinned npm install command and wait for the user to run it. [Wallet creation source](https://github.com/CasualSecurityInc/xno-skills/blob/v5.1.1/src/nano-actions.ts)
142
142
 
143
143
  For wallet **import, rename, or delete**: delegate to the `ows` skill.
144
144
 
@@ -164,7 +164,7 @@ When the user asks for an account, block, transaction, or explorer link, always
164
164
  - **Pre-send state**: Before `wallet_send`, inspect the source wallet's confirmed balance and total receivable amount with `wallet_balance`. If confirmed funds cannot cover the requested send and receivables are needed, call `wallet_receive`, then recheck. Do not submit receive blocks merely because unrelated funds are pending.
165
165
  - **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.
166
166
  - **No mnemonic exports**: Never call `ows wallet export` or suggest exporting to a third-party wallet unless the user explicitly commands it.
167
- - **Supply chain**: Only use `xno-skills@5.1.0` and `@open-wallet-standard/core`. No other npm packages.
167
+ - **Supply chain**: Only use `xno-skills@5.1.1` and `@open-wallet-standard/core`. No other npm packages.
168
168
  - **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.
169
169
 
170
170
  ---
@@ -198,8 +198,8 @@ To **create** a new wallet on request, use `wallet_create` as described above.
198
198
  **Via CLI (required flags only):**
199
199
 
200
200
  ```bash
201
- bunx -y xno-skills@5.1.0 balance --wallet "my-wallet"
202
- bunx -y xno-skills@5.1.0 rpc account-balance <address>
201
+ bunx -y xno-skills@5.1.1 balance --wallet "my-wallet"
202
+ bunx -y xno-skills@5.1.1 rpc account-balance <address>
203
203
  ```
204
204
 
205
205
  Full options: [balance](references/balance.md), [rpc_account-balance](references/rpc_account-balance.md)
@@ -233,7 +233,7 @@ When receipt is requested or needed to fund a send, call `wallet_receive`. Do no
233
233
  **Via CLI (required flags only):**
234
234
 
235
235
  ```bash
236
- bunx -y xno-skills@5.1.0 receive --wallet "my-wallet"
236
+ bunx -y xno-skills@5.1.1 receive --wallet "my-wallet"
237
237
  ```
238
238
 
239
239
  Full options: [receive](references/receive.md)
@@ -269,7 +269,7 @@ The account must be opened (have a receive block) and have sufficient balance.
269
269
  **Via CLI (required flags only):**
270
270
 
271
271
  ```bash
272
- bunx -y xno-skills@5.1.0 send --wallet "my-wallet" --to "nano_..." --amount-xno 0.01
272
+ bunx -y xno-skills@5.1.1 send --wallet "my-wallet" --to "nano_..." --amount-xno 0.01
273
273
  ```
274
274
 
275
275
  Full options: [send](references/send.md)
@@ -401,7 +401,7 @@ Generates a terminal-friendly ASCII QR code for a Nano address, optionally with
401
401
  **Via CLI (required args only):**
402
402
 
403
403
  ```bash
404
- bunx -y xno-skills@5.1.0 qr nano_1abc...
404
+ bunx -y xno-skills@5.1.1 qr nano_1abc...
405
405
  ```
406
406
 
407
407
  Full options: [qr](references/qr.md)
@@ -432,7 +432,7 @@ All validation is **offline** — no network required.
432
432
  **Via CLI:**
433
433
 
434
434
  ```bash
435
- bunx -y xno-skills@5.1.0 validate nano_1abc...
435
+ bunx -y xno-skills@5.1.1 validate nano_1abc...
436
436
  ```
437
437
 
438
438
  Full options: [validate](references/validate.md)
@@ -461,10 +461,10 @@ XNO uses **30 decimal places**. Floating-point arithmetic is unsafe. Always use
461
461
  **Via CLI:**
462
462
 
463
463
  ```bash
464
- bunx -y xno-skills@5.1.0 convert 1 xno # all units
465
- bunx -y xno-skills@5.1.0 convert 1 knano
466
- bunx -y xno-skills@5.1.0 convert 1000000000000000000000000000000 raw
467
- bunx -y xno-skills@5.1.0 convert 1 xno --json
464
+ bunx -y xno-skills@5.1.1 convert 1 xno # all units
465
+ bunx -y xno-skills@5.1.1 convert 1 knano
466
+ bunx -y xno-skills@5.1.1 convert 1000000000000000000000000000000 raw
467
+ bunx -y xno-skills@5.1.1 convert 1 xno --json
468
468
  ```
469
469
 
470
470
  Full options: [convert](references/convert.md)
@@ -490,20 +490,20 @@ Present the user with this command to run locally:
490
490
 
491
491
  ```bash
492
492
  # Sign — run this yourself, replacing the placeholder with your actual key
493
- bunx -y xno-skills@5.1.0 sign "<message>" --key YOUR_PRIVATE_KEY_HEX
493
+ bunx -y xno-skills@5.1.1 sign "<message>" --key YOUR_PRIVATE_KEY_HEX
494
494
 
495
495
  # Sign with JSON output
496
- bunx -y xno-skills@5.1.0 sign "<message>" --key YOUR_PRIVATE_KEY_HEX --json
496
+ bunx -y xno-skills@5.1.1 sign "<message>" --key YOUR_PRIVATE_KEY_HEX --json
497
497
  ```
498
498
 
499
499
  For verify, the agent _can_ run this directly (no secret material involved):
500
500
 
501
501
  ```bash
502
502
  # Verify
503
- bunx -y xno-skills@5.1.0 verify <nano_address> "<message>" <signature-hex>
503
+ bunx -y xno-skills@5.1.1 verify <nano_address> "<message>" <signature-hex>
504
504
 
505
505
  # Verify with JSON output
506
- bunx -y xno-skills@5.1.0 verify <nano_address> "<message>" <signature-hex> --json
506
+ bunx -y xno-skills@5.1.1 verify <nano_address> "<message>" <signature-hex> --json
507
507
  ```
508
508
 
509
509
  **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.
@@ -529,7 +529,7 @@ Deep protocol details — state-block anatomy, open/send/receive/change semantic
529
529
  ```
530
530
 
531
531
  ```bash
532
- bunx -y xno-skills@5.1.0 change-rep --wallet "my-wallet" --representative "nano_..."
532
+ bunx -y xno-skills@5.1.1 change-rep --wallet "my-wallet" --representative "nano_..."
533
533
  ```
534
534
 
535
535
  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@5.1.0
15
+ npm install -g xno-skills@5.1.1
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@5.1.0", "mcp"]
40
+ "args": ["-y", "xno-skills@5.1.1", "mcp"]
41
41
  }
42
42
  }
43
43
  }
44
44
 
45
45
  2. Gemini CLI:
46
- gemini mcp add xno npx -y xno-skills@5.1.0 mcp
46
+ gemini mcp add xno npx -y xno-skills@5.1.1 mcp
47
47
 
48
48
  3. Claude Code:
49
- claude mcp add xno npx -y xno-skills@5.1.0 mcp
49
+ claude mcp add xno npx -y xno-skills@5.1.1 mcp
50
50
 
51
51
  To run the MCP server directly in this terminal:
52
52
  xno-skills mcp (if globally installed)