@waiaas/skills 2.7.0-rc → 2.7.0

package/README.md

@@ -118,7 +118,16 @@ For agents that don't support MCP, or when you prefer REST API integration:
 npx @waiaas/skills add all
 ```
 
-This adds `.skill.md` instruction files to your project. Include them in your agent's context and it learns the WAIaaS API automatically. Available skills: `quickstart`, `wallet`, `transactions`, `policies`, `admin`, `actions`, `x402`.
+This adds `.skill.md` instruction files to your project. Include them in your agent's context and it learns the WAIaaS API automatically. Available skills: `setup`, `quickstart`, `wallet`, `transactions`, `policies`, `admin`, `actions`, `x402`.
+
+### Agent Self-Setup
+
+AI agents can set up WAIaaS from scratch by following the setup skill:
+
+1. Install skills: `npx @waiaas/skills add all`
+2. Read and follow `waiaas-setup/SKILL.md`
+
+The setup skill guides through CLI installation, daemon startup, wallet creation, and session configuration. Master password prompts require human input.
 
 ## Alternative: Docker
 

package/dist/registry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../src/registry.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B;AAED,eAAO,MAAM,cAAc,EAAE,SAAS,UAAU,EA2CtC,CAAC;AAEX;;;GAGG;AACH,wBAAgB,YAAY,IAAI,MAAM,CAErC"}
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../src/registry.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B;AAED,eAAO,MAAM,cAAc,EAAE,SAAS,UAAU,EAiDtC,CAAC;AAEX;;;GAGG;AACH,wBAAgB,YAAY,IAAI,MAAM,CAErC"}

package/dist/registry.js

@@ -1,5 +1,10 @@
 import path from "node:path";
 export const SKILL_REGISTRY = [
+    {
+        name: "setup",
+        filename: "setup.skill.md",
+        description: "Zero-state daemon setup: install CLI, initialize, start daemon, create wallet, configure session",
+    },
     {
         name: "quickstart",
         filename: "quickstart.skill.md",

package/dist/registry.js.map

@@ -1 +1 @@
-{"version":3,"file":"registry.js","sourceRoot":"","sources":["../src/registry.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAQ7B,MAAM,CAAC,MAAM,cAAc,GAA0B;IACnD;QACE,IAAI,EAAE,YAAY;QAClB,QAAQ,EAAE,qBAAqB;QAC/B,WAAW,EACT,iFAAiF;KACpF;IACD;QACE,IAAI,EAAE,QAAQ;QACd,QAAQ,EAAE,iBAAiB;QAC3B,WAAW,EACT,oGAAoG;KACvG;IACD;QACE,IAAI,EAAE,cAAc;QACpB,QAAQ,EAAE,uBAAuB;QACjC,WAAW,EACT,6GAA6G;KAChH;IACD;QACE,IAAI,EAAE,UAAU;QAChB,QAAQ,EAAE,mBAAmB;QAC7B,WAAW,EACT,kLAAkL;KACrL;IACD;QACE,IAAI,EAAE,OAAO;QACb,QAAQ,EAAE,gBAAgB;QAC1B,WAAW,EACT,sIAAsI;KACzI;IACD;QACE,IAAI,EAAE,SAAS;QACf,QAAQ,EAAE,kBAAkB;QAC5B,WAAW,EACT,0GAA0G;KAC7G;IACD;QACE,IAAI,EAAE,MAAM;QACZ,QAAQ,EAAE,eAAe;QACzB,WAAW,EACT,+EAA+E;KAClF;CACO,CAAC;AAEX;;;GAGG;AACH,MAAM,UAAU,YAAY;IAC1B,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC;AACxD,CAAC"}
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../src/registry.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAQ7B,MAAM,CAAC,MAAM,cAAc,GAA0B;IACnD;QACE,IAAI,EAAE,OAAO;QACb,QAAQ,EAAE,gBAAgB;QAC1B,WAAW,EACT,kGAAkG;KACrG;IACD;QACE,IAAI,EAAE,YAAY;QAClB,QAAQ,EAAE,qBAAqB;QAC/B,WAAW,EACT,iFAAiF;KACpF;IACD;QACE,IAAI,EAAE,QAAQ;QACd,QAAQ,EAAE,iBAAiB;QAC3B,WAAW,EACT,oGAAoG;KACvG;IACD;QACE,IAAI,EAAE,cAAc;QACpB,QAAQ,EAAE,uBAAuB;QACjC,WAAW,EACT,6GAA6G;KAChH;IACD;QACE,IAAI,EAAE,UAAU;QAChB,QAAQ,EAAE,mBAAmB;QAC7B,WAAW,EACT,kLAAkL;KACrL;IACD;QACE,IAAI,EAAE,OAAO;QACb,QAAQ,EAAE,gBAAgB;QAC1B,WAAW,EACT,sIAAsI;KACzI;IACD;QACE,IAAI,EAAE,SAAS;QACf,QAAQ,EAAE,kBAAkB;QAC5B,WAAW,EACT,0GAA0G;KAC7G;IACD;QACE,IAAI,EAAE,MAAM;QACZ,QAAQ,EAAE,eAAe;QACzB,WAAW,EACT,+EAA+E;KAClF;CACO,CAAC;AAEX;;;GAGG;AACH,MAAM,UAAU,YAAY;IAC1B,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC;AACxD,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@waiaas/skills",
-  "version": "2.7.0-rc",
+  "version": "2.7.0",
   "description": "WAIaaS skill files for AI agents - install via npx @waiaas/skills add <name>",
   "license": "MIT",
   "type": "module",

package/skills/actions.skill.md

@@ -3,7 +3,7 @@ name: "WAIaaS Actions"
 description: "Action Provider framework: list providers, execute DeFi actions through the 6-stage transaction pipeline"
 category: "api"
 tags: [wallet, blockchain, defi, actions, waiass, jupiter, 0x, swap, lifi, bridge, cross-chain, lido, jito, staking, liquid-staking]
-version: "2.7.0-rc"
+version: "2.7.0"
 dispatch:
   kind: "tool"
   allowedCommands: ["curl"]

package/skills/admin.skill.md

@@ -3,7 +3,7 @@ name: "WAIaaS Admin"
 description: "Admin API: daemon status, kill switch, notifications, settings management, JWT rotation, shutdown, oracle status, API key management"
 category: "api"
 tags: [wallet, blockchain, admin, security, oracle, defi, waiass]
-version: "2.7.0-rc"
+version: "2.7.0"
 dispatch:
   kind: "tool"
   allowedCommands: ["curl"]

package/skills/policies.skill.md

@@ -3,7 +3,7 @@ name: "WAIaaS Policies"
 description: "Policy engine CRUD: 12 policy types for spending limits, whitelists, time restrictions, rate limits, token/contract/approve controls, network restrictions, x402 domain controls"
 category: "api"
 tags: [wallet, blockchain, policies, security, waiass]
-version: "2.7.0-rc"
+version: "2.7.0"
 dispatch:
   kind: "tool"
   allowedCommands: ["curl"]

package/skills/quickstart.skill.md

@@ -3,7 +3,7 @@ name: "WAIaaS Quickset"
 description: "End-to-end quickset: create wallet, session, check balance, send first transfer"
 category: "api"
 tags: [wallet, blockchain, solana, ethereum, quickset, quickstart, waiass]
-version: "2.7.0-rc"
+version: "2.7.0"
 dispatch:
   kind: "tool"
   allowedCommands: ["curl"]

package/skills/setup.skill.md

@@ -0,0 +1,195 @@
+---
+name: "WAIaaS Setup"
+description: "Zero-state daemon setup: install CLI, initialize, start daemon, create wallet, configure session"
+category: "api"
+tags: [wallet, blockchain, solana, ethereum, setup, install, waiass]
+version: "2.7.0"
+dispatch:
+  kind: "tool"
+  allowedCommands: ["curl", "npm", "npx", "waiaas", "which"]
+---
+
+# WAIaaS Zero-State Setup
+
+This skill guides you through setting up WAIaaS from scratch -- from an empty machine to a fully configured wallet daemon with session credentials.
+
+> AI agents must NEVER request the master password. Use only your session token.
+
+## Prerequisites
+
+- **Node.js 22 LTS** or later (`node --version`)
+- **npm** package manager (bundled with Node.js)
+
+## Setup Flow
+
+Follow these steps in order. Steps 3 and 4 require human input for the master password.
+
+### Step 1: Install CLI
+
+Check if WAIaaS CLI is already installed:
+
+```bash
+which waiaas
+```
+
+If not found, install globally:
+
+```bash
+npm install -g @waiaas/cli
+```
+
+Verify installation:
+
+```bash
+waiaas --version
+```
+
+### Step 2: Initialize Data Directory
+
+Create the WAIaaS data directory and default configuration:
+
+```bash
+waiaas init
+```
+
+This creates `~/.waiaas/` with `config.toml` and required subdirectories. Safe to run multiple times -- skips if already initialized.
+
+### Step 3: Start Daemon
+
+```bash
+waiaas start
+```
+
+**IMPORTANT: On first run, the daemon prompts for a master password.**
+
+- The master password encrypts all private keys at rest
+- This is a human-only secret -- wait for the user to type it
+- Do NOT attempt to provide, generate, or capture the master password
+- The daemon starts after the password is set
+
+Verify the daemon is running:
+
+```bash
+curl -s http://localhost:3100/health
+```
+
+Expected: `{"status":"ok", ...}`
+
+### Step 4: Create Wallet and Session
+
+```bash
+waiaas quickset
+```
+
+**IMPORTANT: This command prompts for the master password.**
+
+- Wait for the user to enter the master password
+- Do NOT attempt to provide or capture it
+
+The command outputs:
+1. Wallet IDs and public keys (Solana + EVM)
+2. **Session tokens** (`wai_sess_...`) -- capture these
+3. MCP configuration JSON
+
+### Step 5: Configure Environment
+
+Set environment variables with the session token from Step 4:
+
+```bash
+export WAIAAS_BASE_URL=http://localhost:3100
+export WAIAAS_SESSION_TOKEN=<session-token-from-step-4>
+```
+
+Replace `<session-token-from-step-4>` with the actual `wai_sess_...` token printed by `quickset`.
+
+### Step 6: Verify Connection
+
+Call the self-discovery endpoint to confirm everything works:
+
+```bash
+curl -s http://localhost:3100/v1/connect-info \
+  -H "Authorization: Bearer $WAIAAS_SESSION_TOKEN"
+```
+
+This returns:
+- Accessible wallets and their networks
+- Active policies
+- Available capabilities
+- AI-ready usage prompt
+
+### Step 7: Install Skill Files
+
+Install WAIaaS skill files for your AI agent platform:
+
+**Agent Skills standard (Codex, Gemini CLI, Goose, Amp, Roo Code, Cursor, GitHub Copilot):**
+
+```bash
+npx @waiaas/skills agent-skills
+```
+
+**Claude Code:**
+
+```bash
+npx @waiaas/skills claude-code
+```
+
+**OpenClaw:**
+
+```bash
+npx @waiaas/skills openclaw
+```
+
+**Generic (copy to current directory):**
+
+```bash
+npx @waiaas/skills add all
+```
+
+## What's Next
+
+After setup is complete, refer to these skills for specific operations:
+
+| Skill | Description |
+|-------|-------------|
+| `quickstart` | Check balance, send first transfer |
+| `wallet` | Wallet CRUD, asset queries, session management |
+| `transactions` | All 5 transaction types with full parameters |
+| `policies` | 12 policy types for spending limits and access controls |
+| `admin` | Daemon status, kill switch, notifications, settings |
+| `actions` | DeFi actions (Jupiter Swap, 0x DEX, LI.FI Bridge, Lido/Jito Staking) |
+| `x402` | HTTP 402 auto-payment protocol |
+
+## Troubleshooting
+
+### `waiaas: command not found`
+
+npm global bin directory may not be in PATH:
+
+```bash
+npm config get prefix
+# Add <prefix>/bin to your PATH
+```
+
+### Daemon fails to start
+
+Check if port 3100 is already in use:
+
+```bash
+lsof -i :3100
+```
+
+Or change the port in `~/.waiaas/config.toml`:
+
+```toml
+[server]
+port = 3200
+```
+
+### `quickset` fails with authentication error
+
+The master password may be incorrect. The daemon validates the password on startup since v2.4. Restart the daemon with the correct password:
+
+```bash
+waiaas stop
+waiaas start
+```

package/skills/transactions.skill.md

@@ -3,7 +3,7 @@ name: "WAIaaS Transactions"
 description: "All 5 transaction types (TRANSFER, TOKEN_TRANSFER, CONTRACT_CALL, APPROVE, BATCH) with lifecycle management"
 category: "api"
 tags: [wallet, blockchain, solana, ethereum, transactions, waiass]
-version: "2.7.0-rc"
+version: "2.7.0"
 dispatch:
   kind: "tool"
   allowedCommands: ["curl"]

package/skills/wallet.skill.md

@@ -3,7 +3,7 @@ name: "WAIaaS Wallet Management"
 description: "Wallet CRUD, asset queries, session management, token registry, MCP provisioning, owner management"
 category: "api"
 tags: [wallet, blockchain, solana, ethereum, sessions, tokens, mcp, waiass]
-version: "2.7.0-rc"
+version: "2.7.0"
 dispatch:
   kind: "tool"
   allowedCommands: ["curl"]

package/skills/x402.skill.md

@@ -3,7 +3,7 @@ name: "WAIaaS x402"
 description: "x402 auto-payment protocol: fetch URLs with automatic cryptocurrency payments"
 category: "api"
 tags: [wallet, blockchain, x402, payments, waiass]
-version: "2.7.0-rc"
+version: "2.7.0"
 dispatch:
   kind: "tool"
   allowedCommands: ["curl"]