@darksol/terminal 0.4.9 → 0.4.11

package/README.md

@@ -15,6 +15,8 @@ A unified CLI for market intel, trading, AI-powered analysis, on-chain oracle, c
 [![License: MIT](https://img.shields.io/badge/License-MIT-gold.svg)](https://opensource.org/licenses/MIT)
 [![Node](https://img.shields.io/badge/node-%3E%3D18.0.0-green.svg)](https://nodejs.org/)
 
+- Changelog: `CHANGELOG.md`
+
 ## Install
 
 ```bash
@@ -34,6 +36,10 @@ darksol wallet create main
 darksol wallet balance
 darksol portfolio
 
+# Send / receive
+darksol receive
+darksol send --to 0xabc... --amount 10 --token USDC
+
 # Token prices & live monitoring
 darksol price ETH AERO VIRTUAL
 darksol watch AERO --above 2.0
@@ -58,34 +64,60 @@ darksol serve
 darksol agent start main
 ```
 
+## `darksol serve` (Web Terminal UX)
+
+`darksol serve` now supports an interactive keyboard-driven UI:
+
+- Arrow-key menus (`↑/↓` + `Enter`) for wallet/config flows
+- Interactive wallet picker + wallet action menu (receive/send/portfolio/history/switch chain)
+- Agent signer control center (`agent`) with guided wallet selection + start/stop/status
+- Click-through help menu (`help`) with arrow-key command selection
+- AI connection check at startup (shows ready/not configured)
+- Interactive key setup from web terminal:
+  - `keys` → select provider → paste key/host directly
+  - masked input for API keys, plain input for Ollama URL
+- Local chat memory logs at `~/.darksol/chat-logs/YYYY-MM-DD.jsonl`
+- Natural language fuzzy routing to AI for non-command prompts
+
+Useful web-shell commands:
+
+```bash
+help          # clickable command menu (arrow keys + Enter)
+keys          # provider status + interactive add/update
+wallet        # interactive wallet picker and actions
+agent         # signer start/stop/status controls
+config        # interactive config menu
+logs 20       # show recent AI chat log lines
+ai <prompt>   # chat with trading assistant
+```
+
 ## Modules
 
 | Module | Description | Pricing |
 |--------|-------------|---------|
-| `wallet` | Create, import, manage encrypted wallets | Free |
+| `wallet` | Create/import/manage encrypted EVM wallets | Free |
+| `send` | Send ETH or ERC-20 tokens | Gas only |
+| `receive` | Show receive address + chain safety hints | Free |
 | `trade` | Swap (Uniswap V3), snipe (V2), token trading | Gas only |
 | `dca` | Dollar-cost averaging engine | Gas only |
-| `ai` | LLM-powered trading assistant & analysis | Provider dependent |
+| `ai` | LLM-powered trading assistant & intent execution | Provider dependent |
 | `agent` | Secure agent signer (PK-isolated proxy) | Free |
-| `keys` | API key vault (LLMs, data, RPCs) | Free |
+| `keys` | Encrypted API key vault (LLMs/data/RPCs) | Free |
 | `script` | Execution scripts & automated strategies | Free |
 | `skills` | Agent skill directory & installer | Free |
-| `market` | Market intel, top movers, token analysis | x402 micropayments |
-| `oracle` | On-chain random number oracle | $0.05–$0.25 |
-| `casino` | The Clawsino — on-chain betting | $1 flat bets |
 | `portfolio` | Multi-chain balance view (5 EVM chains) | Free |
+| `history` | Transaction history via block explorers | Free |
 | `gas` | Gas prices & cost estimates | Free |
 | `price` | Quick token price check (DexScreener) | Free |
 | `watch` | Live price monitoring with alerts | Free |
-| `history` | Transaction history via block explorers | Free |
+| `market` | Market intel, top movers, token analysis | x402 micropayments |
 | `mail` | AgentMail — email for AI agents | Free tier |
-| `serve` | Web terminal in browser (xterm.js) | Free |
-| `facilitator` | x402 payment facilitator | Free |
-| `cards` | Prepaid Visa/MC cards | Service fees |
-| `builders` | ERC-8021 builder code directory | Free |
-| `cards` | Crypto → prepaid Visa/MC (no KYC) | 3% markup |
-| `builders` | ERC-8021 builder leaderboard | Free |
+| `oracle` | On-chain random number oracle | $0.05–$0.25 |
+| `casino` | The Clawsino — on-chain betting | $1 flat bets |
+| `cards` | Crypto → prepaid Visa/MC cards | Service fees |
+| `builders` | ERC-8021 builder directory + leaderboard | Free |
 | `facilitator` | x402 payment verification & settlement | Free |
+| `serve` | Local interactive web terminal (xterm.js) | Free |
 | `config` | Terminal configuration | Free |
 
 ---
@@ -152,9 +184,12 @@ Natural language trading powered by multi-provider LLM support.
 # Interactive chat with live market data
 darksol ai chat
 
-# One-shot intent parsing
+# One-shot intent parsing (+ optional execution prompt)
 darksol ai ask "buy 0.5 ETH worth of AERO on Base"
 
+# Parse + execute directly
+darksol ai execute "send 10 USDC to 0x..."
+
 # DCA strategy recommendation
 darksol ai strategy VIRTUAL --budget 500 --timeframe "30 days"
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@darksol/terminal",
-  "version": "0.4.9",
+  "version": "0.4.11",
   "description": "DARKSOL Terminal — unified CLI for all DARKSOL services. Market intel, trading, oracle, casino, and more.",
   "type": "module",
   "bin": {

package/src/wallet/agent-signer.js

@@ -402,12 +402,16 @@ export async function startAgentSigner(walletName, opts = {}) {
     return;
   }
 
-  const { password } = await inquirer.prompt([{
-    type: 'password',
-    name: 'password',
-    message: theme.gold('Wallet password:'),
-    mask: '●',
-  }]);
+  let password = process.env.DARKSOL_WALLET_PASSWORD;
+  if (!password) {
+    const promptRes = await inquirer.prompt([{
+      type: 'password',
+      name: 'password',
+      message: theme.gold('Wallet password:'),
+      mask: '●',
+    }]);
+    password = promptRes.password;
+  }
 
   const spin = spinner('Starting agent signer...').start();
 

package/src/web/commands.js

@@ -3,13 +3,27 @@ import { getConfig, setConfig } from '../config/store.js';
 import { hasKey, hasAnyLLM, getKeyAuto, addKeyDirect, SERVICES } from '../config/keys.js';
 import { ethers } from 'ethers';
 import { existsSync, mkdirSync, appendFileSync, readFileSync } from 'fs';
-import { join } from 'path';
+import { join, dirname } from 'path';
 import { homedir } from 'os';
+import { spawn } from 'child_process';
+import { fileURLToPath } from 'url';
 
 // ══════════════════════════════════════════════════
 // CHAT LOG PERSISTENCE
 // ══════════════════════════════════════════════════
 const CHAT_LOG_DIR = join(homedir(), '.darksol', 'chat-logs');
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+const PROJECT_ROOT = join(__dirname, '..', '..');
+
+// Agent signer runtime state (for web serve session)
+const signerState = {
+  proc: null,
+  wallet: null,
+  port: 18790,
+  startedAt: null,
+  lastOutput: [],
+};
 
 function ensureChatLogDir() {
   if (!existsSync(CHAT_LOG_DIR)) mkdirSync(CHAT_LOG_DIR, { recursive: true });
@@ -153,13 +167,45 @@ export async function handleMenuSelect(id, value, item, ws) {
       }
       ws.sendLine('');
       // Send a prompt request to the client
-      ws.send(JSON.stringify({
-        type: 'prompt',
-        id: 'keys_input',
-        label: `${svc.name} key:`,
+      ws.sendPrompt('keys_input', `${svc.name} key:`, {
         service: value,
         mask: value !== 'ollama', // mask API keys, not URLs
-      }));
+      });
+      return {};
+
+    case 'agent_action':
+      if (value === 'start') {
+        const { listWallets } = await import('../wallet/keystore.js');
+        const wallets = listWallets();
+        if (!wallets.length) {
+          ws.sendLine(`  ${ANSI.red}No wallets found. Create one in CLI first: darksol wallet create <name>${ANSI.reset}`);
+          ws.sendLine('');
+          return {};
+        }
+        ws.sendMenu('agent_wallet_select', '◆ Select Wallet for Signer', wallets.map(w => ({
+          value: w.name,
+          label: w.name,
+          desc: `${w.address.slice(0, 6)}...${w.address.slice(-4)}`,
+        })));
+        return {};
+      }
+      if (value === 'status') return await showSignerStatus(ws);
+      if (value === 'stop') return await cmdAgent(['stop'], ws);
+      if (value === 'docs') {
+        ws.sendLine('');
+        ws.sendLine(`${ANSI.gold}  ◆ OPENCLAW INTEGRATION${ANSI.reset}`);
+        ws.sendLine(`${ANSI.dim}  ${'─'.repeat(50)}${ANSI.reset}`);
+        ws.sendLine(`  ${ANSI.dim}Endpoint: http://127.0.0.1:${signerState.port}${ANSI.reset}`);
+        ws.sendLine(`  ${ANSI.dim}Health:   GET /health${ANSI.reset}`);
+        ws.sendLine(`  ${ANSI.dim}Send TX:  POST /send${ANSI.reset}`);
+        ws.sendLine(`  ${ANSI.dim}Policy:   GET /policy${ANSI.reset}`);
+        ws.sendLine('');
+        return {};
+      }
+      return {};
+
+    case 'agent_wallet_select':
+      ws.sendPrompt('agent_signer_password', `Password for wallet \"${value}\":`, { service: 'agent', wallet: value, mask: true });
       return {};
 
     case 'config_action':
@@ -180,6 +226,10 @@ export async function handleMenuSelect(id, value, item, ws) {
       return {};
 
     case 'main_menu':
+      if (value === 'back') {
+        ws.sendLine('');
+        return {};
+      }
       return await handleCommand(value, ws);
   }
 
@@ -216,10 +266,6 @@ export async function handlePromptResponse(id, value, meta, ws) {
       ws.sendLine(`  ${ANSI.green}✓ ${svc.name} key stored securely${ANSI.reset}`);
       ws.sendLine(`  ${ANSI.dim}Encrypted at ~/.darksol/keys/vault.json${ANSI.reset}`);
       ws.sendLine('');
-
-      // Clear cached AI engine
-      // (chatEngines is WeakMap keyed by ws, but we can't access the real ws here — 
-      //  the engine will reinit on next ai command since keys changed)
       ws.sendLine(`  ${ANSI.green}● AI ready!${ANSI.reset} ${ANSI.dim}Type ${ANSI.gold}ai <question>${ANSI.dim} to start chatting.${ANSI.reset}`);
       ws.sendLine('');
     } catch (err) {
@@ -229,6 +275,28 @@ export async function handlePromptResponse(id, value, meta, ws) {
     return {};
   }
 
+  if (id === 'agent_signer_password') {
+    const wallet = meta.wallet;
+    if (!wallet || !value) {
+      ws.sendLine(`  ${ANSI.red}✗ Cancelled${ANSI.reset}`);
+      ws.sendLine('');
+      return {};
+    }
+
+    ws.sendLine(`  ${ANSI.dim}Starting signer for ${wallet}...${ANSI.reset}`);
+    ws.sendLine('');
+    startSignerProcess({ wallet, password: value, port: 18790, maxValue: '1.0', dailyLimit: '5.0' }, ws);
+
+    // Give it a second then show status
+    setTimeout(() => {
+      showSignerStatus(ws);
+      ws.sendLine(`  ${ANSI.dim}Use ${ANSI.gold}agent${ANSI.dim} for controls (status/stop/docs).${ANSI.reset}`);
+      ws.sendLine('');
+    }, 1200);
+
+    return {};
+  }
+
   return {};
 }
 
@@ -299,6 +367,9 @@ export async function handleCommand(cmd, ws) {
       return await cmdSend(args, ws);
     case 'receive':
       return await cmdReceive(ws);
+    case 'agent':
+    case 'signer':
+      return await cmdAgent(args, ws);
     case 'ai':
     case 'ask':
     case 'chat':
@@ -680,6 +751,93 @@ async function showWalletDetail(name, ws) {
   return {};
 }
 
+// ══════════════════════════════════════════════════
+// AGENT SIGNER (web controls)
+// ══════════════════════════════════════════════════
+async function cmdAgent(args, ws) {
+  const sub = (args[0] || 'menu').toLowerCase();
+
+  if (sub === 'status') {
+    return await showSignerStatus(ws);
+  }
+
+  if (sub === 'stop') {
+    if (!signerState.proc) {
+      ws.sendLine(`  ${ANSI.dim}Signer is not running${ANSI.reset}`);
+      ws.sendLine('');
+      return {};
+    }
+    signerState.proc.kill('SIGTERM');
+    signerState.proc = null;
+    ws.sendLine(`  ${ANSI.green}✓ Signer stopped${ANSI.reset}`);
+    ws.sendLine('');
+    return {};
+  }
+
+  // default menu
+  await showSignerStatus(ws);
+  ws.sendMenu('agent_action', '◆ Agent Signer Controls', [
+    { value: 'start', label: signerState.proc ? '🔁 Restart signer' : '▶ Start signer', desc: signerState.proc ? `Running on :${signerState.port}` : 'Guided setup' },
+    { value: 'status', label: '📊 Status', desc: 'Health, wallet, endpoint' },
+    { value: 'stop', label: '⏹ Stop signer', desc: signerState.proc ? 'Stop current signer session' : 'Not running' },
+    { value: 'docs', label: '📘 Integration', desc: 'OpenClaw endpoint + usage tips' },
+    { value: 'back', label: '← Back', desc: '' },
+  ]);
+  return {};
+}
+
+async function showSignerStatus(ws) {
+  ws.sendLine(`${ANSI.gold}  ◆ AGENT SIGNER${ANSI.reset}`);
+  ws.sendLine(`${ANSI.dim}  ${'─'.repeat(50)}${ANSI.reset}`);
+  ws.sendLine(`  ${ANSI.darkGold}Status${ANSI.reset}       ${signerState.proc ? `${ANSI.green}● Running${ANSI.reset}` : `${ANSI.dim}○ Stopped${ANSI.reset}`}`);
+  ws.sendLine(`  ${ANSI.darkGold}Wallet${ANSI.reset}       ${ANSI.white}${signerState.wallet || '(none)'}${ANSI.reset}`);
+  ws.sendLine(`  ${ANSI.darkGold}Endpoint${ANSI.reset}     ${ANSI.white}http://127.0.0.1:${signerState.port}${ANSI.reset}`);
+  ws.sendLine(`  ${ANSI.darkGold}Started${ANSI.reset}      ${signerState.startedAt ? ANSI.dim + new Date(signerState.startedAt).toLocaleTimeString() + ANSI.reset : ANSI.dim + '(n/a)' + ANSI.reset}`);
+  ws.sendLine('');
+}
+
+function startSignerProcess({ wallet, password, port = 18790, maxValue = '1.0', dailyLimit = '5.0' }, ws) {
+  if (signerState.proc) {
+    try { signerState.proc.kill('SIGTERM'); } catch {}
+  }
+
+  const args = [
+    'bin/darksol.js',
+    'agent', 'start', wallet,
+    '--port', String(port),
+    '--max-value', String(maxValue),
+    '--daily-limit', String(dailyLimit),
+  ];
+
+  // Pass password non-interactively via env to avoid terminal prompt complexity
+  const child = spawn(process.execPath, args, {
+    cwd: PROJECT_ROOT,
+    env: { ...process.env, DARKSOL_WALLET_PASSWORD: password },
+    stdio: ['ignore', 'pipe', 'pipe'],
+  });
+
+  signerState.proc = child;
+  signerState.wallet = wallet;
+  signerState.port = Number(port);
+  signerState.startedAt = Date.now();
+  signerState.lastOutput = [];
+
+  const onOut = (buf) => {
+    const text = buf.toString();
+    signerState.lastOutput.push(text);
+    if (signerState.lastOutput.length > 30) signerState.lastOutput.shift();
+    // Show a compact boot stream
+    const lines = text.split('\n').map(s => s.trim()).filter(Boolean).slice(0, 2);
+    for (const l of lines) ws.sendLine(`  ${ANSI.dim}${l}${ANSI.reset}`);
+  };
+  child.stdout.on('data', onOut);
+  child.stderr.on('data', onOut);
+
+  child.on('exit', () => {
+    signerState.proc = null;
+  });
+}
+
 // ══════════════════════════════════════════════════
 // MAIL
 // ══════════════════════════════════════════════════

package/src/web/server.js

@@ -108,6 +108,7 @@ export async function startWebShell(opts = {}) {
               send: (text) => ws.send(JSON.stringify({ type: 'output', data: text })),
               sendLine: (text) => ws.send(JSON.stringify({ type: 'output', data: text + '\r\n' })),
               sendMenu: (id, title, items) => ws.send(JSON.stringify({ type: 'menu', id, title, items })),
+              sendPrompt: (id, label, meta = {}) => ws.send(JSON.stringify({ type: 'prompt', id, label, ...meta })),
             });
             if (result?.output) {
               ws.send(JSON.stringify({ type: 'output', data: result.output }));
@@ -129,6 +130,7 @@ export async function startWebShell(opts = {}) {
               send: (text) => ws.send(JSON.stringify({ type: 'output', data: text })),
               sendLine: (text) => ws.send(JSON.stringify({ type: 'output', data: text + '\r\n' })),
               sendMenu: (id, title, items) => ws.send(JSON.stringify({ type: 'menu', id, title, items })),
+              sendPrompt: (id, label, meta = {}) => ws.send(JSON.stringify({ type: 'prompt', id, label, ...meta })),
             });
             if (result?.output) {
               ws.send(JSON.stringify({ type: 'output', data: result.output }));
@@ -154,6 +156,25 @@ export async function startWebShell(opts = {}) {
 
           if (cmd === 'help') {
             ws.send(JSON.stringify({ type: 'output', data: getHelp() }));
+            ws.send(JSON.stringify({
+              type: 'menu',
+              id: 'main_menu',
+              title: '◆ Help Menu — Select Command',
+              items: [
+                { value: 'ai', label: '🧠 AI Chat', desc: 'Natural language assistant' },
+                { value: 'wallet', label: '👛 Wallet', desc: 'Picker + balance + actions' },
+                { value: 'agent', label: '🔐 Agent Signer', desc: 'Start/stop/status controls' },
+                { value: 'keys', label: '🔑 Keys', desc: 'Add/update LLM providers' },
+                { value: 'config', label: '⚙ Config', desc: 'Chain + settings' },
+                { value: 'portfolio', label: '📊 Portfolio', desc: 'Multi-chain balances' },
+                { value: 'market', label: '📈 Market', desc: 'Price + liquidity intel' },
+                { value: 'mail', label: '📧 Mail', desc: 'AgentMail status/inbox' },
+                { value: 'oracle', label: '🎲 Oracle', desc: 'Randomness service' },
+                { value: 'casino', label: '🎰 Casino', desc: 'Service status' },
+                { value: 'facilitator', label: '💸 Facilitator', desc: 'x402 health' },
+                { value: 'back', label: '← Back', desc: '' },
+              ],
+            }));
             return;
           }
 
@@ -176,6 +197,7 @@ export async function startWebShell(opts = {}) {
               send: (text) => ws.send(JSON.stringify({ type: 'output', data: text })),
               sendLine: (text) => ws.send(JSON.stringify({ type: 'output', data: text + '\r\n' })),
               sendMenu: (id, title, items) => ws.send(JSON.stringify({ type: 'menu', id, title, items })),
+              sendPrompt: (id, label, meta = {}) => ws.send(JSON.stringify({ type: 'prompt', id, label, ...meta })),
             });
 
             if (result?.output) {
@@ -277,9 +299,12 @@ function getHelp() {
     ['portfolio', 'Multi-chain balances'],
     ['send', 'Send ETH or tokens'],
     ['receive', 'Show address to receive'],
-    ['wallet list', 'List wallets'],
+    ['wallet', 'Interactive wallet menu'],
     ['wallet balance', 'Wallet balance'],
     ['history', 'Transaction history'],
+    ['agent', 'Agent signer controls'],
+    ['keys', 'Interactive LLM/API key setup'],
+    ['logs [n]', 'Recent AI chat memory logs'],
     ['', ''],
     ['', `${gold}SERVICES${reset}`],
     ['market <token>', 'Market intel & data'],

package/src/web/terminal.js

@@ -16,7 +16,7 @@ const A = {
 
 const COMMANDS = [
   'ai', 'price', 'watch', 'gas', 'portfolio', 'history', 'market',
-  'wallet', 'send', 'receive', 'mail', 'keys', 'oracle', 'casino',
+  'wallet', 'send', 'receive', 'agent', 'mail', 'keys', 'oracle', 'casino',
   'facilitator', 'config', 'logs', 'help', 'clear', 'banner', 'exit',
 ];