@darksol/terminal 0.4.10 → 0.5.0

package/README.md

@@ -15,6 +15,7 @@ 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/)
 
+- Current release: **0.5.0**
 - Changelog: `CHANGELOG.md`
 
 ## Install
@@ -70,6 +71,8 @@ darksol agent start main
 
 - 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
@@ -80,8 +83,10 @@ darksol agent start main
 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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@darksol/terminal",
-  "version": "0.4.10",
+  "version": "0.5.0",
   "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',
 ];