@darksol/terminal 0.4.8 → 0.4.10

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,56 @@ 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)
+- 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
+keys          # provider status + interactive add/update
+wallet        # interactive wallet picker and actions
+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 +180,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.8",
+  "version": "0.4.10",
   "description": "DARKSOL Terminal — unified CLI for all DARKSOL services. Market intel, trading, oracle, casino, and more.",
   "type": "module",
   "bin": {

package/src/web/commands.js

@@ -135,6 +135,33 @@ export async function handleMenuSelect(id, value, item, ws) {
       ws.sendLine('');
       return {};
 
+    case 'keys_provider':
+      if (value === 'back') {
+        ws.sendLine('');
+        return {};
+      }
+      // Ask for the key via a prompt
+      const svc = SERVICES[value];
+      if (!svc) return {};
+      ws.sendLine('');
+      ws.sendLine(`  ${ANSI.gold}◆ ${svc.name}${ANSI.reset}`);
+      ws.sendLine(`  ${ANSI.dim}Docs: ${svc.docsUrl}${ANSI.reset}`);
+      if (value === 'ollama') {
+        ws.sendLine(`  ${ANSI.dim}Enter your Ollama host URL (e.g. http://localhost:11434)${ANSI.reset}`);
+      } else {
+        ws.sendLine(`  ${ANSI.dim}Paste your API key below:${ANSI.reset}`);
+      }
+      ws.sendLine('');
+      // Send a prompt request to the client
+      ws.send(JSON.stringify({
+        type: 'prompt',
+        id: 'keys_input',
+        label: `${svc.name} key:`,
+        service: value,
+        mask: value !== 'ollama', // mask API keys, not URLs
+      }));
+      return {};
+
     case 'config_action':
       if (value === 'chain') {
         const chains = ['base', 'ethereum', 'arbitrum', 'optimism', 'polygon'];
@@ -159,6 +186,52 @@ export async function handleMenuSelect(id, value, item, ws) {
   return {};
 }
 
+/**
+ * Handle text prompt responses from the client
+ */
+export async function handlePromptResponse(id, value, meta, ws) {
+  if (id === 'keys_input') {
+    const service = meta.service;
+    const svc = SERVICES[service];
+    if (!svc || !value) {
+      ws.sendLine(`  ${ANSI.red}✗ Cancelled${ANSI.reset}`);
+      ws.sendLine('');
+      return {};
+    }
+
+    // Validate
+    if (svc.validate && !svc.validate(value)) {
+      ws.sendLine(`  ${ANSI.red}✗ Invalid format for ${svc.name}${ANSI.reset}`);
+      if (service === 'openai') ws.sendLine(`  ${ANSI.dim}Key should start with sk-${ANSI.reset}`);
+      if (service === 'anthropic') ws.sendLine(`  ${ANSI.dim}Key should start with sk-ant-${ANSI.reset}`);
+      if (service === 'openrouter') ws.sendLine(`  ${ANSI.dim}Key should start with sk-or-${ANSI.reset}`);
+      if (service === 'ollama') ws.sendLine(`  ${ANSI.dim}Should be a URL like http://localhost:11434${ANSI.reset}`);
+      ws.sendLine('');
+      return {};
+    }
+
+    // Store it
+    try {
+      addKeyDirect(service, value);
+      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) {
+      ws.sendLine(`  ${ANSI.red}✗ Failed: ${err.message}${ANSI.reset}`);
+      ws.sendLine('');
+    }
+    return {};
+  }
+
+  return {};
+}
+
 /**
  * AI status check — shown on connection
  */
@@ -180,14 +253,12 @@ export function getAIStatus() {
   return [
     `  ${red}○ AI not configured${reset} ${dim}— no LLM provider connected${reset}`,
     '',
-    `  ${gold}Quick setup — pick one:${reset}`,
+    `  ${dim}Type ${gold}keys${dim} to set up an LLM provider, or paste directly:${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');
 }
 
@@ -1014,6 +1085,19 @@ async function cmdKeys(args, ws) {
   ws.sendLine(`  ${ANSI.green}keys add ollama http://...${ANSI.reset}   ${ANSI.dim}Add Ollama host${ANSI.reset}`);
   ws.sendLine('');
 
+  // Interactive menu to add keys
+  const llmItems = llmProviders.map(p => {
+    const svc = SERVICES[p];
+    const has = hasKey(p);
+    return {
+      value: p,
+      label: `${has ? '✓' : '+'} ${svc.name}`,
+      desc: has ? 'Connected — replace key' : `Add key (${svc.docsUrl})`,
+    };
+  });
+  llmItems.push({ value: 'back', label: '← Back', desc: '' });
+  ws.sendMenu('keys_provider', '◆ Add / Update API Key', llmItems);
+
   const dataProviders = ['coingecko', 'dexscreener', 'alchemy', 'agentmail'];
   ws.sendLine(`  ${ANSI.gold}Other Services:${ANSI.reset}`);
   for (const p of dataProviders) {

package/src/web/server.js

@@ -100,6 +100,27 @@ export async function startWebShell(opts = {}) {
       try {
         const msg = JSON.parse(raw.toString());
 
+        if (msg.type === 'prompt_response') {
+          // User typed a response to a prompt (e.g. API key input)
+          try {
+            const { handlePromptResponse } = await import('./commands.js');
+            const result = await handlePromptResponse(msg.id, msg.value, msg.meta || {}, {
+              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 })),
+            });
+            if (result?.output) {
+              ws.send(JSON.stringify({ type: 'output', data: result.output }));
+            }
+          } catch (err) {
+            ws.send(JSON.stringify({
+              type: 'output',
+              data: `\r\n  \x1b[31m✗ Error: ${err.message}\x1b[0m\r\n`,
+            }));
+          }
+          return;
+        }
+
         if (msg.type === 'menu_select') {
           // User selected something from an interactive menu
           try {

package/src/web/terminal.js

@@ -34,6 +34,13 @@ let menuIndex = 0;
 let menuId = '';
 let menuTitle = '';
 
+// ── PROMPT STATE (text input) ─────────────────
+let promptActive = false;
+let promptId = '';
+let promptMeta = {};
+let promptInput = '';
+let promptMask = false;
+
 async function init() {
   term = new Terminal({
     theme: {
@@ -85,6 +92,48 @@ async function init() {
     const code = domEvent.keyCode;
     const ctrl = domEvent.ctrlKey;
 
+    // ── PROMPT MODE (text input) ──
+    if (promptActive) {
+      if (code === 13) { // Enter — submit
+        promptActive = false;
+        term.write('\r\n');
+        if (promptInput) {
+          ws.send(JSON.stringify({
+            type: 'prompt_response',
+            id: promptId,
+            value: promptInput,
+            meta: promptMeta,
+          }));
+        } else {
+          term.write(`  ${A.dim}Cancelled${A.r}\r\n\r\n`);
+          writePrompt();
+        }
+        promptInput = '';
+        return;
+      }
+      if (code === 27 || (ctrl && code === 67)) { // Esc/Ctrl+C — cancel
+        promptActive = false;
+        promptInput = '';
+        term.write('\r\n');
+        term.write(`  ${A.dim}Cancelled${A.r}\r\n\r\n`);
+        writePrompt();
+        return;
+      }
+      if (code === 8) { // Backspace
+        if (promptInput.length > 0) {
+          promptInput = promptInput.slice(0, -1);
+          term.write('\b \b');
+        }
+        return;
+      }
+      // Printable chars
+      if (key.length === 1 && !ctrl) {
+        promptInput += key;
+        term.write(promptMask ? '●' : key);
+      }
+      return;
+    }
+
     // ── MENU MODE ──
     if (menuActive) {
       if (code === 38) { // Up
@@ -188,8 +237,13 @@ async function init() {
     if (menuActive) return;
     if (data.length > 1 && !data.startsWith('\x1b')) {
       const clean = data.replace(/[\r\n]/g, '');
-      currentLine += clean;
-      term.write(clean);
+      if (promptActive) {
+        promptInput += clean;
+        term.write(promptMask ? '●'.repeat(clean.length) : clean);
+      } else {
+        currentLine += clean;
+        term.write(clean);
+      }
     }
   });
 
@@ -277,8 +331,15 @@ function connectWS() {
         term.clear();
         writePrompt();
       } else if (msg.type === 'menu') {
-        // Server is requesting user to pick from a menu
         showMenu(msg.id, msg.title, msg.items);
+      } else if (msg.type === 'prompt') {
+        // Server wants text input (e.g. API key)
+        promptActive = true;
+        promptId = msg.id;
+        promptMeta = { service: msg.service, ...msg };
+        promptInput = '';
+        promptMask = msg.mask || false;
+        term.write(`  ${A.gold}${msg.label || 'Input:'}${A.r} `);
       }
     } catch {
       term.write(event.data);