@darksol/terminal 0.4.5 → 0.4.7

package/package.json

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

package/src/web/commands.js

@@ -1,7 +1,37 @@
 import fetch from 'node-fetch';
 import { getConfig, setConfig } from '../config/store.js';
-import { hasKey, getKeyAuto } from '../config/keys.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 { homedir } from 'os';
+
+// ══════════════════════════════════════════════════
+// CHAT LOG PERSISTENCE
+// ══════════════════════════════════════════════════
+const CHAT_LOG_DIR = join(homedir(), '.darksol', 'chat-logs');
+
+function ensureChatLogDir() {
+  if (!existsSync(CHAT_LOG_DIR)) mkdirSync(CHAT_LOG_DIR, { recursive: true });
+}
+
+function logChat(role, content) {
+  ensureChatLogDir();
+  const date = new Date().toISOString().slice(0, 10);
+  const time = new Date().toISOString().slice(11, 19);
+  const file = join(CHAT_LOG_DIR, `${date}.jsonl`);
+  const entry = JSON.stringify({ ts: new Date().toISOString(), time, role, content });
+  appendFileSync(file, entry + '\n');
+}
+
+function getChatHistory(limit = 20) {
+  ensureChatLogDir();
+  const date = new Date().toISOString().slice(0, 10);
+  const file = join(CHAT_LOG_DIR, `${date}.jsonl`);
+  if (!existsSync(file)) return [];
+  const lines = readFileSync(file, 'utf-8').trim().split('\n').filter(Boolean);
+  return lines.slice(-limit).map(l => { try { return JSON.parse(l); } catch { return null; } }).filter(Boolean);
+}
 
 // ══════════════════════════════════════════════════
 // WEB SHELL COMMAND HANDLER
@@ -39,6 +69,38 @@ const USDC_ADDRESSES = {
 
 const ERC20_ABI = ['function balanceOf(address) view returns (uint256)'];
 
+/**
+ * AI status check — shown on connection
+ */
+export function getAIStatus() {
+  const gold = '\x1b[38;2;255;215;0m';
+  const green = '\x1b[38;2;0;255;136m';
+  const red = '\x1b[38;2;233;69;96m';
+  const dim = '\x1b[38;2;102;102;102m';
+  const reset = '\x1b[0m';
+
+  const providers = ['openai', 'anthropic', 'openrouter', 'ollama'];
+  const connected = providers.filter(p => hasKey(p));
+
+  if (connected.length > 0) {
+    const names = connected.map(p => SERVICES[p]?.name || p).join(', ');
+    return `  ${green}● AI ready${reset} ${dim}(${names})${reset}\r\n  ${dim}Type ${gold}ai <question>${dim} to start chatting. Chat logs saved to ~/.darksol/chat-logs/${reset}\r\n\r\n`;
+  }
+
+  return [
+    `  ${red}○ AI not configured${reset} ${dim}— no LLM provider connected${reset}`,
+    '',
+    `  ${gold}Quick setup — pick one:${reset}`,
+    `  ${green}keys add openai sk-...${reset}         ${dim}OpenAI (GPT-4o)${reset}`,
+    `  ${green}keys add anthropic sk-ant-...${reset}   ${dim}Anthropic (Claude)${reset}`,
+    `  ${green}keys add openrouter sk-or-...${reset}   ${dim}OpenRouter (any model)${reset}`,
+    `  ${green}keys add ollama http://...${reset}      ${dim}Ollama (free, local)${reset}`,
+    '',
+    `  ${dim}Or run the full setup wizard: ${gold}darksol setup${reset}`,
+    '',
+  ].join('\r\n');
+}
+
 /**
  * Handle a command string, return { output } or stream via ws helpers
  */
@@ -76,10 +138,26 @@ export async function handleCommand(cmd, ws) {
       return await cmdSend(args, ws);
     case 'receive':
       return await cmdReceive(ws);
-    default:
+    case 'ai':
+    case 'ask':
+    case 'chat':
+      return await cmdAI(args, ws);
+    case 'keys':
+    case 'llm':
+      return await cmdKeys(args, ws);
+    case 'logs':
+    case 'chatlog':
+      return await cmdChatLogs(args, ws);
+    default: {
+      // Fuzzy: if it looks like natural language, route to AI
+      const nlKeywords = /\b(swap|buy|sell|send|transfer|price|what|how|should|analyze|check|balance|gas|dca)\b/i;
+      if (nlKeywords.test(cmd)) {
+        return await cmdAI(cmd.split(/\s+/), ws);
+      }
       return {
-        output: `\r\n  ${ANSI.red}✗ Unknown command: ${cmd}${ANSI.reset}\r\n  ${ANSI.dim}Type ${ANSI.gold}help${ANSI.dim} for available commands.${ANSI.reset}\r\n\r\n`,
+        output: `\r\n  ${ANSI.red}✗ Unknown command: ${cmd}${ANSI.reset}\r\n  ${ANSI.dim}Type ${ANSI.gold}help${ANSI.dim} for commands, or ${ANSI.gold}ai <question>${ANSI.dim} to chat.${ANSI.reset}\r\n\r\n`,
       };
+    }
   }
 }
 
@@ -508,6 +586,308 @@ async function cmdConfig(ws) {
   return {};
 }
 
+// ══════════════════════════════════════════════════
+// AI CHAT — LLM-powered assistant in the web shell
+// ══════════════════════════════════════════════════
+
+// Persistent chat engine per WebSocket connection
+const chatEngines = new WeakMap();
+
+async function cmdAI(args, ws) {
+  const input = args.join(' ').trim();
+
+  if (!input || input === 'help') {
+    ws.sendLine(`${ANSI.gold}  ◆ AI TRADING ASSISTANT${ANSI.reset}`);
+    ws.sendLine(`${ANSI.dim}  ${'─'.repeat(50)}${ANSI.reset}`);
+    ws.sendLine('');
+    ws.sendLine(`  ${ANSI.white}Natural language trading — just describe what you want.${ANSI.reset}`);
+    ws.sendLine('');
+    ws.sendLine(`  ${ANSI.darkGold}Usage:${ANSI.reset}`);
+    ws.sendLine(`  ${ANSI.gold}ai swap 0.1 ETH to USDC${ANSI.reset}`);
+    ws.sendLine(`  ${ANSI.gold}ai what's the price of AERO?${ANSI.reset}`);
+    ws.sendLine(`  ${ANSI.gold}ai analyze VIRTUAL on base${ANSI.reset}`);
+    ws.sendLine(`  ${ANSI.gold}ai should I DCA into ETH?${ANSI.reset}`);
+    ws.sendLine(`  ${ANSI.gold}ai send 10 USDC to 0x1234...${ANSI.reset}`);
+    ws.sendLine(`  ${ANSI.gold}ai gas on base${ANSI.reset}`);
+    ws.sendLine('');
+    ws.sendLine(`  ${ANSI.dim}Conversation history is kept for the session.${ANSI.reset}`);
+    ws.sendLine(`  ${ANSI.dim}Type ${ANSI.gold}ai clear${ANSI.dim} to reset history.${ANSI.reset}`);
+    ws.sendLine('');
+    return {};
+  }
+
+  if (input === 'clear' || input === 'reset') {
+    if (chatEngines.has(ws)) {
+      chatEngines.get(ws).clearHistory();
+    }
+    ws.sendLine(`  ${ANSI.green}✓ Chat history cleared${ANSI.reset}`);
+    ws.sendLine('');
+    return {};
+  }
+
+  if (input === 'status') {
+    const engine = chatEngines.get(ws);
+    if (engine) {
+      const usage = engine.getUsage();
+      ws.sendLine(`${ANSI.gold}  ◆ AI STATUS${ANSI.reset}`);
+      ws.sendLine(`${ANSI.dim}  ${'─'.repeat(50)}${ANSI.reset}`);
+      ws.sendLine(`  ${ANSI.darkGold}Provider${ANSI.reset}     ${ANSI.white}${usage.provider}${ANSI.reset}`);
+      ws.sendLine(`  ${ANSI.darkGold}Model${ANSI.reset}        ${ANSI.white}${usage.model}${ANSI.reset}`);
+      ws.sendLine(`  ${ANSI.darkGold}Messages${ANSI.reset}     ${ANSI.white}${usage.calls}${ANSI.reset}`);
+      ws.sendLine(`  ${ANSI.darkGold}Tokens${ANSI.reset}       ${ANSI.white}${usage.totalTokens}${ANSI.reset}`);
+      ws.sendLine('');
+    } else {
+      ws.sendLine(`  ${ANSI.dim}No active AI session${ANSI.reset}`);
+      ws.sendLine('');
+    }
+    return {};
+  }
+
+  // Initialize or retrieve the LLM engine
+  let engine = chatEngines.get(ws);
+  if (!engine) {
+    try {
+      const { createLLM } = await import('../llm/engine.js');
+      engine = await createLLM({});
+
+      const chain = getConfig('chain') || 'base';
+      const wallet = getConfig('activeWallet') || '(not set)';
+      const slippage = getConfig('slippage') || 0.5;
+
+      engine.setSystemPrompt(`You are DARKSOL Terminal's AI trading assistant running in a web terminal.
+
+You help users with:
+- Token swaps, sends, and transfers
+- Price checks and market analysis
+- DCA strategy recommendations
+- Gas estimates and chain info
+- Portfolio analysis
+- General crypto/DeFi questions
+
+USER CONTEXT:
+- Active chain: ${chain}
+- Active wallet: ${wallet}
+- Slippage: ${slippage}%
+- Supported chains: Base (default), Ethereum, Polygon, Arbitrum, Optimism
+
+RULES:
+- Be concise — this is a terminal, not a blog
+- Use short paragraphs, bullet points where helpful
+- Include risk warnings for any trade suggestions
+- Never reveal private keys or sensitive info
+- When suggesting trades, give the exact darksol CLI command
+- If you detect an actionable intent (swap, send, price, etc), include the command at the end
+
+COMMAND REFERENCE:
+- darksol trade swap -i ETH -o USDC -a 0.1
+- darksol send --to 0x... --amount 0.1 --token ETH
+- darksol price ETH AERO VIRTUAL
+- darksol gas base
+- darksol wallet balance
+- darksol portfolio
+- darksol dca create -t ETH -a 0.01 -i 1h -n 24
+- darksol ai analyze <token>`);
+
+      chatEngines.set(ws, engine);
+      ws.sendLine(`  ${ANSI.green}● AI connected${ANSI.reset} ${ANSI.dim}(${engine.provider}/${engine.model})${ANSI.reset}`);
+      ws.sendLine('');
+    } catch (err) {
+      ws.sendLine(`  ${ANSI.red}✗ AI initialization failed: ${err.message}${ANSI.reset}`);
+      ws.sendLine(`  ${ANSI.dim}Configure an API key: darksol keys add openai${ANSI.reset}`);
+      ws.sendLine('');
+      return {};
+    }
+  }
+
+  // Enrich with live price data
+  let enriched = input;
+  const tokenPattern = /\b([A-Z]{2,10})\b/g;
+  const tokens = [...new Set(input.toUpperCase().match(tokenPattern) || [])];
+  const skipWords = ['ETH', 'THE', 'FOR', 'AND', 'BUY', 'SELL', 'DCA', 'SWAP', 'WHAT', 'PRICE', 'HOW', 'MUCH', 'SEND', 'SHOULD', 'CAN', 'ANALYZE', 'CHECK'];
+
+  const priceData = [];
+  for (const t of tokens.filter(t => !skipWords.includes(t)).slice(0, 3)) {
+    try {
+      const { quickPrice } = await import('../utils/helpers.js');
+      const p = await quickPrice(t);
+      if (p) priceData.push(`${p.symbol}: $${p.price} (24h: ${p.change24h}%)`);
+    } catch {}
+  }
+  if (priceData.length > 0) {
+    enriched += `\n\n[Live market data: ${priceData.join(', ')}]`;
+  }
+
+  // Log user message
+  logChat('user', input);
+
+  // Send to LLM
+  ws.sendLine(`  ${ANSI.dim}Thinking...${ANSI.reset}`);
+
+  try {
+    const result = await engine.chat(enriched);
+    const usage = engine.getUsage();
+
+    // Log AI response
+    logChat('assistant', result.content);
+
+    // Display response with formatting
+    ws.sendLine('');
+    ws.sendLine(`${ANSI.gold}  ◆ DARKSOL AI${ANSI.reset}`);
+    ws.sendLine(`${ANSI.dim}  ${'─'.repeat(50)}${ANSI.reset}`);
+
+    const lines = result.content.split('\n');
+    for (const line of lines) {
+      // Highlight code blocks
+      if (line.trim().startsWith('```')) {
+        ws.sendLine(`  ${ANSI.dim}${line}${ANSI.reset}`);
+      } else if (line.trim().startsWith('darksol ') || line.trim().startsWith('$ darksol')) {
+        // Highlight CLI commands
+        ws.sendLine(`  ${ANSI.gold}${line}${ANSI.reset}`);
+      } else if (line.trim().startsWith('⚠') || line.trim().startsWith('Warning') || line.trim().toLowerCase().startsWith('risk')) {
+        ws.sendLine(`  ${ANSI.red}${line}${ANSI.reset}`);
+      } else if (line.trim().startsWith('•') || line.trim().startsWith('-') || line.trim().startsWith('*')) {
+        ws.sendLine(`  ${ANSI.white}${line}${ANSI.reset}`);
+      } else {
+        ws.sendLine(`  ${line}`);
+      }
+    }
+
+    ws.sendLine('');
+    ws.sendLine(`  ${ANSI.dim}[${usage.calls} msgs | ${usage.totalTokens} tokens | ${engine.provider}/${engine.model}]${ANSI.reset}`);
+    ws.sendLine('');
+
+  } catch (err) {
+    ws.sendLine(`  ${ANSI.red}✗ ${err.message}${ANSI.reset}`);
+    ws.sendLine('');
+  }
+
+  return {};
+}
+
+// ══════════════════════════════════════════════════
+// KEYS — LLM provider configuration from web shell
+// ══════════════════════════════════════════════════
+async function cmdKeys(args, ws) {
+  const sub = args[0]?.toLowerCase();
+
+  if (sub === 'add' && args[1]) {
+    const service = args[1].toLowerCase();
+    const key = args[2];
+    const svc = SERVICES[service];
+
+    if (!svc) {
+      ws.sendLine(`  ${ANSI.red}✗ Unknown service: ${service}${ANSI.reset}`);
+      ws.sendLine(`  ${ANSI.dim}Available: openai, anthropic, openrouter, ollama${ANSI.reset}`);
+      ws.sendLine('');
+      return {};
+    }
+
+    if (!key) {
+      ws.sendLine(`  ${ANSI.red}✗ No key provided${ANSI.reset}`);
+      ws.sendLine(`  ${ANSI.dim}Usage: keys add ${service} <your-api-key>${ANSI.reset}`);
+      ws.sendLine(`  ${ANSI.dim}Get a key: ${svc.docsUrl}${ANSI.reset}`);
+      ws.sendLine('');
+      return {};
+    }
+
+    if (svc.validate && !svc.validate(key)) {
+      ws.sendLine(`  ${ANSI.red}✗ Invalid key format for ${svc.name}${ANSI.reset}`);
+      ws.sendLine('');
+      return {};
+    }
+
+    try {
+      addKeyDirect(service, key);
+      ws.sendLine(`  ${ANSI.green}✓ ${svc.name} key stored securely${ANSI.reset}`);
+
+      // Clear cached engine so it picks up new key
+      chatEngines.delete(ws);
+      ws.sendLine(`  ${ANSI.dim}AI session refreshed — type ${ANSI.gold}ai <question>${ANSI.dim} to chat${ANSI.reset}`);
+      ws.sendLine('');
+    } catch (err) {
+      ws.sendLine(`  ${ANSI.red}✗ Failed to store key: ${err.message}${ANSI.reset}`);
+      ws.sendLine('');
+    }
+    return {};
+  }
+
+  if (sub === 'remove' && args[1]) {
+    const service = args[1].toLowerCase();
+    // Can't remove via web shell without password prompt — point to CLI
+    ws.sendLine(`  ${ANSI.dim}To remove keys, use the CLI:${ANSI.reset}`);
+    ws.sendLine(`  ${ANSI.gold}darksol keys remove ${service}${ANSI.reset}`);
+    ws.sendLine('');
+    return {};
+  }
+
+  // Default: show status
+  ws.sendLine(`${ANSI.gold}  ◆ API KEYS / LLM CONFIG${ANSI.reset}`);
+  ws.sendLine(`${ANSI.dim}  ${'─'.repeat(50)}${ANSI.reset}`);
+  ws.sendLine('');
+
+  const llmProviders = ['openai', 'anthropic', 'openrouter', 'ollama'];
+  ws.sendLine(`  ${ANSI.gold}LLM Providers:${ANSI.reset}`);
+  for (const p of llmProviders) {
+    const svc = SERVICES[p];
+    const has = hasKey(p);
+    const status = has ? `${ANSI.green}● Connected${ANSI.reset}` : `${ANSI.dim}○ Not set${ANSI.reset}`;
+    ws.sendLine(`    ${status}  ${ANSI.white}${svc.name.padEnd(20)}${ANSI.reset}${ANSI.dim}${svc.description}${ANSI.reset}`);
+  }
+
+  ws.sendLine('');
+  ws.sendLine(`  ${ANSI.gold}Quick Setup:${ANSI.reset}`);
+  ws.sendLine(`  ${ANSI.green}keys add openai sk-...${ANSI.reset}       ${ANSI.dim}Add OpenAI key${ANSI.reset}`);
+  ws.sendLine(`  ${ANSI.green}keys add anthropic sk-ant-...${ANSI.reset} ${ANSI.dim}Add Anthropic key${ANSI.reset}`);
+  ws.sendLine(`  ${ANSI.green}keys add openrouter sk-or-...${ANSI.reset} ${ANSI.dim}Add OpenRouter key${ANSI.reset}`);
+  ws.sendLine(`  ${ANSI.green}keys add ollama http://...${ANSI.reset}   ${ANSI.dim}Add Ollama host${ANSI.reset}`);
+  ws.sendLine('');
+
+  const dataProviders = ['coingecko', 'dexscreener', 'alchemy', 'agentmail'];
+  ws.sendLine(`  ${ANSI.gold}Other Services:${ANSI.reset}`);
+  for (const p of dataProviders) {
+    const svc = SERVICES[p];
+    if (!svc) continue;
+    const has = hasKey(p);
+    const status = has ? `${ANSI.green}●${ANSI.reset}` : `${ANSI.dim}○${ANSI.reset}`;
+    ws.sendLine(`    ${status}  ${ANSI.white}${svc.name.padEnd(20)}${ANSI.reset}${ANSI.dim}${svc.description}${ANSI.reset}`);
+  }
+
+  ws.sendLine('');
+  ws.sendLine(`  ${ANSI.dim}Keys are AES-256-GCM encrypted at ~/.darksol/keys/vault.json${ANSI.reset}`);
+  ws.sendLine('');
+  return {};
+}
+
+// ══════════════════════════════════════════════════
+// CHAT LOGS — View conversation history
+// ══════════════════════════════════════════════════
+async function cmdChatLogs(args, ws) {
+  const limit = parseInt(args[0]) || 20;
+  const history = getChatHistory(limit);
+
+  ws.sendLine(`${ANSI.gold}  ◆ CHAT LOG${ANSI.reset}`);
+  ws.sendLine(`${ANSI.dim}  ${'─'.repeat(50)}${ANSI.reset}`);
+  ws.sendLine('');
+
+  if (history.length === 0) {
+    ws.sendLine(`  ${ANSI.dim}No chat history today. Start with: ai <question>${ANSI.reset}`);
+    ws.sendLine('');
+    return {};
+  }
+
+  for (const entry of history) {
+    const time = entry.time || '';
+    const role = entry.role === 'user' ? `${ANSI.gold}You${ANSI.reset}` : `${ANSI.green}AI${ANSI.reset}`;
+    const preview = entry.content.split('\n')[0].slice(0, 80);
+    ws.sendLine(`  ${ANSI.dim}${time}${ANSI.reset} ${role}: ${preview}${entry.content.length > 80 ? ANSI.dim + '...' + ANSI.reset : ''}`);
+  }
+
+  ws.sendLine('');
+  ws.sendLine(`  ${ANSI.dim}Logs: ~/.darksol/chat-logs/ (${history.length} messages shown)${ANSI.reset}`);
+  ws.sendLine('');
+  return {};
+}
+
 // ══════════════════════════════════════════════════
 // SEND / RECEIVE (web shell — info only, actual sends require CLI)
 // ══════════════════════════════════════════════════

package/src/web/server.js

@@ -5,6 +5,9 @@ import { fileURLToPath } from 'url';
 import { dirname, join } from 'path';
 import open from 'open';
 import { theme } from '../ui/theme.js';
+import { createRequire } from 'module';
+const require = createRequire(import.meta.url);
+const { version: PKG_VERSION } = require('../../package.json');
 
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = dirname(__filename);
@@ -17,7 +20,7 @@ const __dirname = dirname(__filename);
  * Command handler registry — maps command strings to async functions
  * that return { output: string } with ANSI stripped for web
  */
-import { handleCommand } from './commands.js';
+import { handleCommand, getAIStatus } from './commands.js';
 
 export async function startWebShell(opts = {}) {
   process.on('uncaughtException', (err) => {
@@ -46,7 +49,7 @@ export async function startWebShell(opts = {}) {
         res.end(js);
       } else if (pathname === '/health') {
         res.writeHead(200, { 'Content-Type': 'application/json' });
-        res.end(JSON.stringify({ status: 'ok', version: '0.4.0' }));
+        res.end(JSON.stringify({ status: 'ok', version: PKG_VERSION }));
       } else {
         res.writeHead(404);
         res.end('Not found');
@@ -86,6 +89,13 @@ export async function startWebShell(opts = {}) {
       data: getBanner(),
     }));
 
+    // AI connection check right after banner
+    const aiStatus = getAIStatus();
+    ws.send(JSON.stringify({
+      type: 'output',
+      data: aiStatus,
+    }));
+
     ws.on('message', async (raw) => {
       try {
         const msg = JSON.parse(raw.toString());
@@ -194,12 +204,13 @@ function getBanner() {
     '',
     `${dim}  ╔══════════════════════════════════════════════════════════╗${reset}`,
     `${dim}  ║${reset} ${gold}${white} DARKSOL TERMINAL${reset}${dim}  —  ${reset}${dim}Ghost in the machine with teeth${reset}${dim}  ║${reset}`,
-    `${dim}  ║${reset}${dim}  v0.4.0                                                ${reset}${gold}🌑${reset}${dim} ║${reset}`,
+    `${dim}  ║${reset}${dim}  v${PKG_VERSION}${' '.repeat(Math.max(0, 52 - PKG_VERSION.length))}${reset}${gold}🌑${reset}${dim} ║${reset}`,
     `${dim}  ╚══════════════════════════════════════════════════════════╝${reset}`,
     '',
     `${dim}  All services. One terminal. Zero trust required.${reset}`,
     '',
-    `${dim}  Type ${gold}help${dim} for commands. Tab to autocomplete.${reset}`,
+    `${dim}  Type ${gold}ai <question>${dim} to chat with the trading AI.${reset}`,
+    `${dim}  Type ${gold}help${dim} for all commands.${reset}`,
     '',
   ].join('\r\n');
 }
@@ -211,20 +222,31 @@ function getHelp() {
   const reset = '\x1b[0m';
 
   const cmds = [
+    ['', `${gold}AI ASSISTANT${reset}`],
+    ['ai <question>', 'Chat with trading AI'],
+    ['ai clear', 'Reset chat history'],
+    ['ai status', 'Show AI session info'],
+    ['', ''],
+    ['', `${gold}TRADING & WALLET${reset}`],
     ['price <token...>', 'Quick price check'],
     ['watch <token>', 'Live price monitor'],
     ['gas [chain]', 'Gas prices & estimates'],
     ['portfolio', 'Multi-chain balances'],
+    ['send', 'Send ETH or tokens'],
+    ['receive', 'Show address to receive'],
+    ['wallet list', 'List wallets'],
+    ['wallet balance', 'Wallet balance'],
     ['history', 'Transaction history'],
+    ['', ''],
+    ['', `${gold}SERVICES${reset}`],
     ['market <token>', 'Market intel & data'],
     ['mail status', 'AgentMail status'],
     ['mail inbox', 'Check email inbox'],
-    ['mail send', 'Send an email'],
     ['oracle roll', 'On-chain random oracle'],
     ['casino status', 'Casino status'],
-    ['wallet list', 'List wallets'],
-    ['wallet balance', 'Wallet balance'],
     ['config', 'Show configuration'],
+    ['', ''],
+    ['', `${gold}GENERAL${reset}`],
     ['banner', 'Show banner'],
     ['clear', 'Clear screen'],
     ['help', 'This help message'],
@@ -236,7 +258,13 @@ function getHelp() {
   out += `${dim}  ${'─'.repeat(50)}${reset}\r\n`;
 
   for (const [cmd, desc] of cmds) {
-    out += `  ${green}${cmd.padEnd(22)}${reset}${dim}${desc}${reset}\r\n`;
+    if (!cmd && !desc) {
+      out += '\r\n';
+    } else if (!cmd) {
+      out += `  ${desc}\r\n`;
+    } else {
+      out += `  ${green}${cmd.padEnd(22)}${reset}${dim}${desc}${reset}\r\n`;
+    }
   }
 
   out += '\r\n';