jaspervault_cli 1.0.33 → 1.1.1

package/dist/src/services/profile-manager.js

@@ -0,0 +1,179 @@
+import { existsSync, mkdirSync, readFileSync, writeFileSync, readdirSync, renameSync, rmSync } from 'fs';
+import { join } from 'path';
+const DEFAULT_PROFILE_NAME = 'default';
+function getJvDir() {
+    return join(process.env.HOME || process.env.USERPROFILE || '', '.jaspervault');
+}
+export function getProfilesDir() {
+    return join(getJvDir(), 'profiles');
+}
+function getActiveFile() {
+    return join(getJvDir(), 'active.json');
+}
+export function getProfileDir(name) {
+    return join(getProfilesDir(), name);
+}
+/**
+ * Read the active profile name from active.json.
+ * Returns null if no active profile is set.
+ */
+export function getActiveProfileName() {
+    const file = getActiveFile();
+    if (!existsSync(file))
+        return null;
+    try {
+        const data = JSON.parse(readFileSync(file, 'utf-8'));
+        return data.profile || null;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Set the active profile by writing active.json.
+ */
+export function setActiveProfile(name) {
+    const dir = getJvDir();
+    if (!existsSync(dir)) {
+        mkdirSync(dir, { recursive: true });
+    }
+    writeFileSync(getActiveFile(), JSON.stringify({ profile: name }, null, 2), { mode: 0o600 });
+}
+/**
+ * Check if a profile directory exists.
+ */
+export function profileExists(name) {
+    return existsSync(getProfileDir(name));
+}
+/**
+ * List all profiles with summary info.
+ */
+export function listProfiles() {
+    const dir = getProfilesDir();
+    if (!existsSync(dir))
+        return [];
+    const activeName = getActiveProfileName();
+    const entries = readdirSync(dir, { withFileTypes: true });
+    return entries
+        .filter((e) => e.isDirectory())
+        .map((e) => {
+        const name = e.name;
+        const profileFile = join(dir, name, 'profile.json');
+        let eoa = null;
+        let delegationAddress = null;
+        let network = null;
+        if (existsSync(profileFile)) {
+            try {
+                const data = JSON.parse(readFileSync(profileFile, 'utf-8'));
+                eoa = data.eoa || null;
+                delegationAddress = data.delegationAddress || null;
+                network = data.network || null;
+            }
+            catch {
+                // ignore parse errors
+            }
+        }
+        return { name, eoa, delegationAddress, network, isActive: name === activeName };
+    })
+        .sort((a, b) => a.name.localeCompare(b.name));
+}
+/**
+ * Rename a profile directory. Updates active.json if the renamed profile was active.
+ */
+export function renameProfile(oldName, newName) {
+    if (!profileExists(oldName)) {
+        throw new Error(`Profile "${oldName}" does not exist`);
+    }
+    if (profileExists(newName)) {
+        throw new Error(`Profile "${newName}" already exists`);
+    }
+    renameSync(getProfileDir(oldName), getProfileDir(newName));
+    if (getActiveProfileName() === oldName) {
+        setActiveProfile(newName);
+    }
+}
+/**
+ * Remove a profile directory. Cannot remove the active profile.
+ */
+export function removeProfile(name) {
+    if (!profileExists(name)) {
+        throw new Error(`Profile "${name}" does not exist`);
+    }
+    if (getActiveProfileName() === name) {
+        throw new Error(`Cannot remove active profile "${name}". Switch to another profile first.`);
+    }
+    rmSync(getProfileDir(name), { recursive: true, force: true });
+}
+/**
+ * Migrate legacy ~/.jaspervault/keys.json + profile.json into profiles/default/.
+ * Only runs once — skips if profiles/ directory already exists with content.
+ */
+export function migrateIfNeeded() {
+    const jvDir = getJvDir();
+    const legacyKeys = join(jvDir, 'keys.json');
+    const legacyProfile = join(jvDir, 'profile.json');
+    // Skip if no legacy files exist
+    if (!existsSync(legacyKeys) && !existsSync(legacyProfile))
+        return;
+    // Skip if profiles dir already has content (already migrated)
+    const profilesDir = getProfilesDir();
+    if (existsSync(profilesDir)) {
+        try {
+            const entries = readdirSync(profilesDir, { withFileTypes: true });
+            if (entries.some((e) => e.isDirectory()))
+                return;
+        }
+        catch {
+            // continue with migration
+        }
+    }
+    // Create default profile directory
+    const defaultDir = getProfileDir(DEFAULT_PROFILE_NAME);
+    mkdirSync(defaultDir, { recursive: true });
+    // Move legacy files
+    if (existsSync(legacyKeys)) {
+        const data = readFileSync(legacyKeys, 'utf-8');
+        writeFileSync(join(defaultDir, 'keys.json'), data, { mode: 0o600 });
+        rmSync(legacyKeys);
+    }
+    if (existsSync(legacyProfile)) {
+        const data = readFileSync(legacyProfile, 'utf-8');
+        writeFileSync(join(defaultDir, 'profile.json'), data, { mode: 0o600 });
+        rmSync(legacyProfile);
+    }
+    // Set active profile
+    setActiveProfile(DEFAULT_PROFILE_NAME);
+}
+/**
+ * Resolve the current active profile directory path.
+ * Runs migration if needed, then returns the path.
+ * If no active profile is set and profiles exist, activates the first one.
+ */
+export function resolveActiveProfileDir() {
+    migrateIfNeeded();
+    let name = getActiveProfileName();
+    if (!name) {
+        // Try to pick the first available profile
+        const profiles = listProfiles();
+        if (profiles.length > 0) {
+            name = profiles[0].name;
+            setActiveProfile(name);
+        }
+        else {
+            // No profiles at all — return default dir (will be created on save)
+            name = DEFAULT_PROFILE_NAME;
+        }
+    }
+    return getProfileDir(name);
+}
+/**
+ * Ensure the active profile directory exists.
+ */
+export function ensureActiveProfileDir() {
+    const dir = resolveActiveProfileDir();
+    if (!existsSync(dir)) {
+        mkdirSync(dir, { recursive: true });
+    }
+    return dir;
+}
+//# sourceMappingURL=profile-manager.js.map

package/dist/src/services/profile-manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"profile-manager.js","sourceRoot":"","sources":["../../../src/services/profile-manager.ts"],"names":[],"mappings":"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"}

package/dist/src/services/vault-profile.js

@@ -1,16 +1,8 @@
-import { existsSync, mkdirSync, readFileSync, chmodSync, writeFileSync } from 'fs';
+import { existsSync, readFileSync, chmodSync, writeFileSync } from 'fs';
 import { join } from 'path';
-function getJvDir() {
-    return join(process.env.HOME || process.env.USERPROFILE || '', '.jaspervault');
-}
+import { resolveActiveProfileDir, ensureActiveProfileDir } from './profile-manager.js';
 function getProfileFile() {
-    return join(getJvDir(), 'profile.json');
-}
-function ensureDir() {
-    const dir = getJvDir();
-    if (!existsSync(dir)) {
-        mkdirSync(dir, { recursive: true });
-    }
+    return join(resolveActiveProfileDir(), 'profile.json');
 }
 /**
  * Load vault profile from ~/.jaspervault/profile.json.
@@ -34,7 +26,7 @@ export function loadVaultProfile(network) {
  * Save vault profile to ~/.jaspervault/profile.json with mode 0600.
  */
 export function saveVaultProfile(profile) {
-    ensureDir();
+    ensureActiveProfileDir();
     const file = getProfileFile();
     writeFileSync(file, JSON.stringify(profile, null, 2), { mode: 0o600 });
     try {

package/dist/src/services/vault-profile.js.map

@@ -1 +1 @@
-{"version":3,"file":"vault-profile.js","sourceRoot":"","sources":["../../../src/services/vault-profile.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,YAAY,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,IAAI,CAAC;AACnF,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAG5B,SAAS,QAAQ;IACf,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,IAAI,OAAO,CAAC,GAAG,CAAC,WAAW,IAAI,EAAE,EAAE,cAAc,CAAC,CAAC;AACjF,CAAC;AAED,SAAS,cAAc;IACrB,OAAO,IAAI,CAAC,QAAQ,EAAE,EAAE,cAAc,CAAC,CAAC;AAC1C,CAAC;AAED,SAAS,SAAS;IAChB,MAAM,GAAG,GAAG,QAAQ,EAAE,CAAC;IACvB,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QACrB,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACtC,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAAC,OAAgB;IAC/C,IAAI,CAAC,UAAU,CAAC,cAAc,EAAE,CAAC,EAAE,CAAC;QAClC,OAAO,IAAI,CAAC;IACd,CAAC;IACD,MAAM,GAAG,GAAG,YAAY,CAAC,cAAc,EAAE,EAAE,OAAO,CAAC,CAAC;IACpD,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAiB,CAAC;IAChD,IAAI,CAAC,OAAO,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,iBAAiB,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;QACnE,OAAO,IAAI,CAAC;IACd,CAAC;IACD,IAAI,OAAO,IAAI,OAAO,CAAC,OAAO,KAAK,OAAO,EAAE,CAAC;QAC3C,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,OAAqB;IACpD,SAAS,EAAE,CAAC;IACZ,MAAM,IAAI,GAAG,cAAc,EAAE,CAAC;IAC9B,aAAa,CAAC,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IACvE,IAAI,CAAC;QACH,SAAS,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IACzB,CAAC;IAAC,MAAM,CAAC;QACP,gDAAgD;IAClD,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,6BAA6B,CAAC,OAAqB,EAAE,IAAsB;IACzF,MAAM,UAAU,GAAG,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IAC7C,MAAM,KAAK,GAAG,OAAO,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC,CAAa,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,UAAU,CAAC,CAAC;IAC7E,OAAO,KAAK,EAAE,OAAO,IAAI,IAAI,CAAC;AAChC,CAAC"}
+{"version":3,"file":"vault-profile.js","sourceRoot":"","sources":["../../../src/services/vault-profile.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,IAAI,CAAC;AACxE,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAE5B,OAAO,EAAE,uBAAuB,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AAEvF,SAAS,cAAc;IACrB,OAAO,IAAI,CAAC,uBAAuB,EAAE,EAAE,cAAc,CAAC,CAAC;AACzD,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAAC,OAAgB;IAC/C,IAAI,CAAC,UAAU,CAAC,cAAc,EAAE,CAAC,EAAE,CAAC;QAClC,OAAO,IAAI,CAAC;IACd,CAAC;IACD,MAAM,GAAG,GAAG,YAAY,CAAC,cAAc,EAAE,EAAE,OAAO,CAAC,CAAC;IACpD,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAiB,CAAC;IAChD,IAAI,CAAC,OAAO,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,iBAAiB,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;QACnE,OAAO,IAAI,CAAC;IACd,CAAC;IACD,IAAI,OAAO,IAAI,OAAO,CAAC,OAAO,KAAK,OAAO,EAAE,CAAC;QAC3C,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,OAAqB;IACpD,sBAAsB,EAAE,CAAC;IACzB,MAAM,IAAI,GAAG,cAAc,EAAE,CAAC;IAC9B,aAAa,CAAC,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IACvE,IAAI,CAAC;QACH,SAAS,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IACzB,CAAC;IAAC,MAAM,CAAC;QACP,gDAAgD;IAClD,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,6BAA6B,CAAC,OAAqB,EAAE,IAAsB;IACzF,MAAM,UAAU,GAAG,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IAC7C,MAAM,KAAK,GAAG,OAAO,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC,CAAa,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,UAAU,CAAC,CAAC;IAC7E,OAAO,KAAK,EAAE,OAAO,IAAI,IAAI,CAAC;AAChC,CAAC"}

package/dist/src/templates/skill-content/SKILL.core.md

@@ -50,6 +50,7 @@ When the user wants to trade, first check if their vault is ready:
 | Check job status | `get_job_status` | `job_id` | [queries](references/queries.md) |
 | List limit orders | `list_limit_orders` | `wallet` | [queries](references/queries.md) |
 | Cancel limit order | `cancel_limit_order` | `limit_order_id` | [queries](references/queries.md) |
+| Check for CLI update | `check_update` | — | [queries](references/queries.md) |
 
 ## Key Behaviors
 
@@ -109,8 +110,16 @@ Call `list_orders` to confirm the position is closed or reduced.
 | "Let me check if jv is installed" | IRRELEVANT. MCP server runs CLI internally. |
 | "I'll close the position without checking current margin" | WRONG. Always call `list_orders` first to get the exact side and margin before closing. |
 
+## Update Notices
+
+MCP tool responses may include an update notice when a newer CLI version is available. When you see this notice, inform the user:
+- Tell them a new version is available (include version numbers)
+- Ask them to run `jv update` to upgrade
+
+You can also proactively call `check_update` to verify the CLI is up to date.
+
 ## Security
 
 - Never log or display private keys, signatures, or API keys.
 - Delegation wallet is stored in `~/.jaspervault/keys.json` — never read or display this file.
-- Never ask the user to set `PRIVATE_KEY` — that's for CI/automation only.
+- Never ask the user for private keys.

package/dist/src/templates/skill-content/references/onboarding.md

@@ -54,7 +54,7 @@ The tool automatically:
 |---------|---------------|
 | Asking user for private key after setup | Delegation key is auto-generated. User never provides keys. |
 | Saying "profile.json is empty" | `wallet_setup` saves profile automatically on success. |
-| Suggesting `vault init` | That's for CI/automation with PRIVATE_KEY env var. Never suggest it. |
+| Suggesting private key setup | There is no private key mode. `wallet_setup` is the only way. |
 | Saying "CLI needs separate initialization" | `wallet_setup` IS the initialization. One step, fully done. |
 | Running `jv orders list` in terminal | Use `list_orders` MCP tool instead. |
 

package/dist/src/templates/skill-content/references/queries.md

@@ -162,6 +162,26 @@ Check execution status of an async job (market order, option creation, etc.).
 
 ---
 
+## 7. Check for Updates — `check_update`
+
+No parameters required. Checks if a newer version of jaspervault_cli is available.
+
+### Response
+
+```json
+{
+  "updateAvailable": true,
+  "currentVersion": "1.0.32",
+  "latestVersion": "1.0.35"
+}
+```
+
+When `updateAvailable` is `true`, tell the user to run `jv update` to upgrade.
+
+**Note:** Any MCP tool response may also include an update notice as a second text block when an update is available. When you see this, relay it to the user.
+
+---
+
 ## Error Handling
 
 When a tool fails, check the error message:

package/docs/OPENCLAW_GUIDE.md

@@ -0,0 +1,136 @@
+# OpenClaw Setup Guide
+
+Trade perpetual contracts with built-in hedge protection on JasperVault through OpenClaw. Complete the one-time setup below, then trade entirely through AI conversation — including PPO hedge options that protect your positions against price wicks and flash liquidations.
+
+## Prerequisites
+
+| Requirement | How to verify |
+|-------------|--------------|
+| Node.js 18+ | `node --version` — install from [nodejs.org](https://nodejs.org) if needed |
+| OpenClaw | Installed and running |
+| Browser wallet | MetaMask, Rabby, or similar — for one-time delegation signing |
+
+## Setup (One-Time)
+
+### Step 1: Install the CLI
+
+```bash
+npm install -g jaspervault_cli
+jv --version    # verify installation
+```
+
+### Step 2: Install the JasperVault Skill
+
+```bash
+jv install --ai openclaw
+```
+
+This installs the trading skill to `~/.openclaw/skills/jasper-vault-cli/SKILL.md`. OpenClaw will automatically detect it on next launch.
+
+> To update an existing installation: `jv install --ai openclaw --force`
+
+### Step 3: Initialize Your Wallet
+
+Open OpenClaw and say:
+
+> "I want to start trading"
+
+OpenClaw will:
+1. Call `wallet_setup` and provide a URL
+2. Open the link in your browser, connect your wallet, and sign the delegation authorization
+3. Wait while OpenClaw confirms the setup (up to 2 minutes)
+
+That's it. Your wallet is now initialized and all trading tools are ready.
+
+**Alternative — manual setup via terminal:**
+
+```bash
+jv enable --pretty
+```
+
+### Step 4: Deposit (Optional)
+
+Tell OpenClaw:
+
+> "Deposit 100 USDC"
+
+A browser page opens for you to approve the cross-chain transfer from Base to JasperVault. Funds typically arrive within a few minutes.
+
+## Trading
+
+Once setup is complete, talk to OpenClaw in natural language:
+
+| What you say | What happens |
+|-------------|-------------|
+| "Long BTC with 100 USDC and PPO" | Opens a protected long position |
+| "Long BTC with 100 USDC, 50x" | Opens a leveraged long position |
+| "Short BTC with 50 USDC at 95000" | Places a limit short order |
+| "Add PPO protection to order 42" | Adds hedge option to existing position |
+| "Protect order 42 with OTM tier 3, 8h" | Custom PPO: OTM strike offset, 8-hour expiry |
+| "Close my BTC position" | Queries position, then closes it |
+| "Set TP at 110000 for order 99" | Creates a take-profit limit order |
+| "Set SL at 88000 for order 99" | Creates a stop-loss limit order |
+| "Show my positions" | Lists all active positions |
+| "What's the BTC price?" | Fetches real-time market price |
+| "Withdraw 100 USDC" | Opens browser to sign withdrawal |
+
+OpenClaw translates your intent into the appropriate tool calls and returns results in natural language.
+
+### PPO Hedge Protection
+
+PPO (Perpetual Protection Option) is an on-chain hedge option unique to JasperVault. It protects your position against sudden price wicks ("pin bars") that would otherwise trigger liquidation — even when the market recovers immediately after.
+
+Unlike stop-loss orders that execute at the wick price and lock in losses, PPO uses a peer-to-peer fully collateralized option contract. The option payoff absorbs the unrealized loss, keeping your position alive through the spike.
+
+**How to use PPO:**
+
+| What you say | What happens |
+|-------------|-------------|
+| "Open long BTC with PPO" | Opens position + ATM hedge, 30-min expiry |
+| "Add protection to order 42" | Adds PPO to existing position |
+| "Protect with OTM tier 3 for 8 hours" | Custom: OTM strike (0.3% offset), 8h expiry |
+
+**Options:**
+- **Category:** ATM (strike = current price) or OTM (offset 0.1%–0.5% via tiers 1–5)
+- **Expiry:** 30 minutes (default) or 8 hours
+- **Hedge type:** Automatic — PUT for longs, CALL for shorts
+
+## Environment Variables (Optional)
+
+The CLI works with default settings. Only configure these if needed:
+
+```bash
+# Custom API endpoint (e.g., for local development)
+export JV_API_URL=https://your-endpoint.example.com
+
+# API authentication (if required by your deployment)
+export JV_API_KEY=your-token
+```
+
+Add to `~/.zshrc` or `~/.bashrc` for persistence, then `source ~/.zshrc`.
+
+> **Note:** Browser signing mode does not require `PRIVATE_KEY`. Your keys stay in your browser wallet at all times.
+
+## Troubleshooting
+
+**Wallet page doesn't open or wallet prompt doesn't appear**
+- Ensure your browser wallet extension is installed and unlocked
+- Some wallets require clicking the extension icon to see pending signature requests
+
+**"Delegation key not found" error**
+- Run `jv enable --pretty` to re-initialize
+- Verify `~/.jaspervault/keys.json` exists: `ls ~/.jaspervault/`
+
+**OpenClaw doesn't recognize trading commands**
+- Verify the skill is installed: `ls ~/.openclaw/skills/jasper-vault-cli/`
+- Reinstall if needed: `jv install --ai openclaw --force`
+- Restart OpenClaw after installation
+
+**Deposit shows "not arrived" after completion**
+- Cross-chain bridging via Hyperlane takes 1–3 minutes. Wait and retry.
+
+## Further Reading
+
+- [User Guide](USER_GUIDE.md) — Complete CLI reference and configuration
+- [JasperVault](https://www.jaspervault.io/) — Protocol documentation
+- CLI help: `jv --help`, `jv order --help`, `jv enable --help`