@darksol/terminal 0.8.1 → 0.9.1

package/src/setup/wizard.js

@@ -4,6 +4,7 @@ import { showSection, showDivider } from '../ui/banner.js';
 import { success, error, warn, info, kvDisplay } from '../ui/components.js';
 import { getConfig, setConfig } from '../config/store.js';
 import { addKeyDirect, hasKey, hasAnyLLM, SERVICES } from '../config/keys.js';
+import { hasSoul, runSoulSetup } from '../soul/index.js';
 import { createServer } from 'http';
 import open from 'open';
 import crypto from 'crypto';
@@ -18,7 +19,7 @@ import crypto from 'crypto';
 export function isFirstRun() {
   const llmReady = hasAnyLLM();
   const setupDone = getConfig('setupComplete');
-  return !llmReady && !setupDone;
+  return (!llmReady && !setupDone) || !hasSoul();
 }
 
 /**
@@ -42,17 +43,21 @@ export async function runSetupWizard(opts = {}) {
 
   showDivider();
 
-  // Step 1: Choose LLM provider
+  // Step 1: Soul / identity
+  await runSoulSetup({ showBanner: false, reset: force });
+
+  // Step 2: Choose LLM provider
   const { provider } = await inquirer.prompt([{
     type: 'list',
     name: 'provider',
     message: theme.gold('Choose your AI provider:'),
     choices: [
-      { name: '🤖 OpenAI (GPT-4o, GPT-5) — API key or OAuth', value: 'openai' },
-      { name: '🧠 Anthropic (Claude Opus, Sonnet) — API key or OAuth', value: 'anthropic' },
-      { name: '🔀 OpenRouter (any model, one key) — API key', value: 'openrouter' },
-      { name: '🏠 Ollama (local models, free, private) — no key needed', value: 'ollama' },
-      { name: '⏭️  Skip for now', value: 'skip' },
+      { name: 'OpenAI (GPT-4o, GPT-5) - API key or OAuth', value: 'openai' },
+      { name: 'Anthropic (Claude Opus, Sonnet) - API key or OAuth', value: 'anthropic' },
+      { name: 'OpenRouter (any model, one key) - API key', value: 'openrouter' },
+      { name: 'MiniMax (MiniMax-M2.5) - API key', value: 'minimax' },
+      { name: 'Ollama (local models, free, private) - no key needed', value: 'ollama' },
+      { name: 'Skip for now', value: 'skip' },
     ],
   }]);
 
@@ -69,7 +74,7 @@ export async function runSetupWizard(opts = {}) {
     await setupCloudProvider(provider);
   }
 
-  // Step 2: Chain selection
+  // Step 3: Chain selection
   console.log('');
   const { chain } = await inquirer.prompt([{
     type: 'list',
@@ -87,7 +92,7 @@ export async function runSetupWizard(opts = {}) {
   setConfig('chain', chain);
   success(`Chain set to ${chain}`);
 
-  // Step 3: Wallet
+  // Step 4: Wallet
   console.log('');
   const { wantWallet } = await inquirer.prompt([{
     type: 'confirm',
@@ -108,7 +113,7 @@ export async function runSetupWizard(opts = {}) {
 }
 
 /**
- * Setup a cloud provider (OpenAI, Anthropic, OpenRouter)
+ * Setup a cloud provider (OpenAI, Anthropic, OpenRouter, MiniMax)
  */
 async function setupCloudProvider(provider) {
   const supportsOAuth = ['openai', 'anthropic'].includes(provider);
@@ -116,6 +121,7 @@ async function setupCloudProvider(provider) {
     openai: 'OpenAI',
     anthropic: 'Anthropic',
     openrouter: 'OpenRouter',
+    minimax: 'MiniMax',
   }[provider];
 
   if (supportsOAuth) {
@@ -152,6 +158,7 @@ async function setupAPIKey(provider) {
     openai: 'OpenAI',
     anthropic: 'Anthropic',
     openrouter: 'OpenRouter',
+    minimax: 'MiniMax',
   }[provider];
 
   const { key } = await inquirer.prompt([{
@@ -169,6 +176,7 @@ async function setupAPIKey(provider) {
   success(`${providerName} key saved (encrypted)`);
 
   // Set as default provider
+  setConfig('llm.provider', provider);
   setConfig('llmProvider', provider);
   info(`Default AI provider set to ${provider}`);
 }
@@ -189,6 +197,7 @@ async function setupOllama() {
     default: 'http://localhost:11434',
   }]);
 
+  setConfig('llm.ollamaHost', host);
   setConfig('ollamaHost', host);
 
   const { model } = await inquirer.prompt([{
@@ -198,7 +207,9 @@ async function setupOllama() {
     default: 'llama3',
   }]);
 
+  setConfig('llm.model', model);
   setConfig('ollamaModel', model);
+  setConfig('llm.provider', 'ollama');
   setConfig('llmProvider', 'ollama');
 
   success(`Ollama configured: ${host} / ${model}`);
@@ -227,8 +238,14 @@ function showKeyInstructions(provider) {
     console.log(theme.dim('  3. Copy the key (starts with sk-ant-)'));
     console.log(theme.dim('  4. Paste it below'));
     console.log('');
-    console.log(theme.dim('  💡 If you have a Claude Pro/Team subscription,'));
+    console.log(theme.dim('  If you have a Claude Pro/Team subscription,'));
     console.log(theme.dim('     you can use OAuth instead.'));
+  } else if (provider === 'minimax') {
+    showSection('GET A MINIMAX API KEY');
+    console.log(theme.dim('  1. Go to https://platform.minimax.io/docs/guides/models-intro'));
+    console.log(theme.dim('  2. Open your MiniMax developer console / API key page'));
+    console.log(theme.dim('  3. Create or copy an API key'));
+    console.log(theme.dim('  4. Paste it below'));
   }
 
   console.log('');
@@ -428,6 +445,7 @@ async function executeOAuthFlow(provider, clientId, clientSecret) {
             if (tokenData.refresh_token) {
               addKeyDirect(`${provider}_refresh`, tokenData.refresh_token);
             }
+            setConfig('llm.provider', provider);
             setConfig('llmProvider', provider);
 
             res.writeHead(200, { 'Content-Type': 'text/html' });

package/src/soul/index.js

@@ -0,0 +1,139 @@
+import inquirer from 'inquirer';
+import { getConfig, setConfig, deleteConfig } from '../config/store.js';
+import { theme } from '../ui/theme.js';
+import { showMiniBanner, showSection } from '../ui/banner.js';
+import { kvDisplay, info, success, warn } from '../ui/components.js';
+
+const TONE_CHOICES = ['professional', 'casual', 'hacker', 'friendly', 'sarcastic', 'custom'];
+
+/**
+ * Return the current persisted soul configuration.
+ * @returns {{userName: string, agentName: string, tone: string, createdAt: string}}
+ */
+export function getSoul() {
+  const soul = getConfig('soul') || {};
+  return {
+    userName: soul.userName || '',
+    agentName: soul.agentName || 'Darksol',
+    tone: soul.tone || '',
+    createdAt: soul.createdAt || '',
+  };
+}
+
+/**
+ * Whether a usable soul profile has been created.
+ * @returns {boolean}
+ */
+export function hasSoul() {
+  const soul = getSoul();
+  return Boolean(soul.userName && soul.agentName && soul.tone);
+}
+
+/**
+ * Generate a soul-derived system prompt for LLM calls.
+ * @returns {string}
+ */
+export function formatSystemPrompt() {
+  if (!hasSoul()) return '';
+
+  const soul = getSoul();
+  return [
+    `You are ${soul.agentName}, the user's persistent DARKSOL Terminal agent.`,
+    `Address the user as ${soul.userName}.`,
+    `Maintain a ${soul.tone} tone unless the user explicitly asks for a different style.`,
+    'Stay concise, terminal-native, and practical.',
+    'Preserve the deep black DARKSOL aesthetic: sharp, calm, and low-noise.',
+  ].join('\n');
+}
+
+/**
+ * Pretty-print the current soul configuration.
+ * @returns {void}
+ */
+export function displaySoul() {
+  const soul = getSoul();
+
+  showMiniBanner();
+  showSection('SOUL CONFIG');
+  kvDisplay([
+    ['User', soul.userName || theme.dim('(not set)')],
+    ['Agent', soul.agentName],
+    ['Tone', soul.tone || theme.dim('(not set)')],
+    ['Created', soul.createdAt || theme.dim('(not set)')],
+  ]);
+  console.log('');
+}
+
+/**
+ * Interactive soul setup flow.
+ * @param {{showBanner?: boolean, reset?: boolean}} opts
+ * @returns {Promise<{userName: string, agentName: string, tone: string, createdAt: string}>}
+ */
+export async function runSoulSetup(opts = {}) {
+  const currentSoul = getSoul();
+
+  if (opts.showBanner !== false) {
+    showMiniBanner();
+    showSection(hasSoul() && !opts.reset ? 'UPDATE SOUL' : 'SOUL SETUP');
+    console.log(theme.dim('  Shape how DARKSOL knows you and how your agent should speak.'));
+    console.log('');
+  }
+
+  const answers = await inquirer.prompt([
+    {
+      type: 'input',
+      name: 'userName',
+      message: 'What should I call you?',
+      default: currentSoul.userName || undefined,
+      validate: (value) => value.trim().length > 0 || 'Name is required',
+    },
+    {
+      type: 'input',
+      name: 'agentName',
+      message: 'Name your agent:',
+      default: currentSoul.agentName || 'Darksol',
+      validate: (value) => value.trim().length > 0 || 'Agent name is required',
+    },
+    {
+      type: 'list',
+      name: 'tonePreset',
+      message: 'Agent tone:',
+      choices: TONE_CHOICES.map((tone) => ({
+        name: tone === 'custom' ? 'custom' : tone,
+        value: tone,
+      })),
+      default: TONE_CHOICES.includes(currentSoul.tone) ? currentSoul.tone : 'professional',
+    },
+    {
+      type: 'input',
+      name: 'customTone',
+      message: 'Describe the tone:',
+      when: (answers) => answers.tonePreset === 'custom',
+      default: TONE_CHOICES.includes(currentSoul.tone) ? undefined : currentSoul.tone || undefined,
+      validate: (value) => value.trim().length > 0 || 'Tone is required',
+    },
+  ]);
+
+  const soul = {
+    userName: answers.userName.trim(),
+    agentName: answers.agentName.trim() || 'Darksol',
+    tone: (answers.tonePreset === 'custom' ? answers.customTone : answers.tonePreset).trim(),
+    createdAt: currentSoul.createdAt && !opts.reset ? currentSoul.createdAt : new Date().toISOString(),
+  };
+
+  setConfig('soul', soul);
+  success(`Soul bound: ${soul.agentName} → ${soul.userName}`);
+  info(`Tone locked to ${soul.tone}`);
+  console.log('');
+
+  return soul;
+}
+
+/**
+ * Reset persisted soul configuration.
+ * @returns {void}
+ */
+export function resetSoul() {
+  deleteConfig('soul');
+  warn('Soul profile cleared.');
+}

package/src/web/commands.js

@@ -1,6 +1,8 @@
 import fetch from 'node-fetch';
 import { getConfig, setConfig } from '../config/store.js';
 import { hasKey, hasAnyLLM, getKeyAuto, addKeyDirect, SERVICES } from '../config/keys.js';
+import { getRecentMemories } from '../memory/index.js';
+import { getSoul, hasSoul } from '../soul/index.js';
 import { ethers } from 'ethers';
 import { existsSync, mkdirSync, appendFileSync, readFileSync } from 'fs';
 import { join, dirname } from 'path';
@@ -450,6 +452,7 @@ export async function handlePromptResponse(id, value, meta, ws) {
       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 === 'minimax') ws.sendLine(`  ${ANSI.dim}Get a key: ${svc.docsUrl}${ANSI.reset}`);
       if (service === 'ollama') ws.sendLine(`  ${ANSI.dim}Should be a URL like http://localhost:11434${ANSI.reset}`);
       ws.sendLine('');
       return {};
@@ -780,8 +783,9 @@ export function getAIStatus() {
   const dim = '\x1b[38;2;102;102;102m';
   const reset = '\x1b[0m';
 
-  const providers = ['openai', 'anthropic', 'openrouter', 'ollama', 'bankr'];
+  const providers = ['openai', 'anthropic', 'openrouter', 'minimax', 'ollama', 'bankr'];
   const connected = providers.filter(p => hasKey(p));
+  const soul = hasSoul() ? getSoul() : null;
 
   if (connected.length > 0) {
     const names = connected.map(p => SERVICES[p]?.name || p).join(', ');
@@ -795,6 +799,7 @@ export function getAIStatus() {
     `  ${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 minimax <key>${reset}          ${dim}MiniMax (MiniMax-M2.5)${reset}`,
     `  ${green}keys add bankr bk_...${reset}           ${dim}Bankr LLM Gateway (crypto credits)${reset}`,
     `  ${green}keys add ollama http://...${reset}      ${dim}Ollama (free, local)${reset}`,
     '',
@@ -847,6 +852,8 @@ export async function handleCommand(cmd, ws) {
     case 'agent':
     case 'signer':
       return await cmdAgent(args, ws);
+    case 'task':
+      return await cmdAgent(['task', ...args], ws);
     case 'ai':
     case 'ask':
     case 'chat':
@@ -1336,7 +1343,84 @@ async function showWalletDetail(name, ws) {
 async function cmdAgent(args, ws) {
   const sub = (args[0] || 'menu').toLowerCase();
 
+  if (sub === 'task') {
+    const goal = args.slice(1).join(' ').trim();
+    if (!goal) {
+      return {
+        output: `\r\n  ${ANSI.dim}Usage: agent task <goal> [--max-steps N] [--allow-actions]${ANSI.reset}\r\n  ${ANSI.dim}Shortcut: task <goal>${ANSI.reset}\r\n\r\n`,
+      };
+    }
+
+    const allowActions = args.includes('--allow-actions');
+    const maxIndex = args.findIndex((arg) => arg === '--max-steps');
+    const maxSteps = maxIndex >= 0 ? parseInt(args[maxIndex + 1], 10) || 10 : 10;
+    const filteredGoal = args
+      .slice(1)
+      .filter((arg, index, arr) => arg !== '--allow-actions' && !(arg === '--max-steps' || arr[index - 1] === '--max-steps'))
+      .join(' ')
+      .trim();
+
+    const { runAgentTask } = await import('../agent/index.js');
+    ws.sendLine(`${ANSI.gold}  ◆ AGENT TASK${ANSI.reset}`);
+    ws.sendLine(`${ANSI.dim}  ${'─'.repeat(50)}${ANSI.reset}`);
+    ws.sendLine(`  ${ANSI.white}Goal:${ANSI.reset} ${filteredGoal}`);
+    ws.sendLine(`  ${ANSI.darkGold}Mode:${ANSI.reset} ${allowActions ? 'actions enabled' : 'safe mode'}`);
+    ws.sendLine('');
+
+    const result = await runAgentTask(filteredGoal, {
+      maxSteps,
+      allowActions,
+      onProgress: (event) => {
+        if (event.type === 'thought') {
+          ws.sendLine(`  ${ANSI.darkGold}[step ${event.step}]${ANSI.reset} ${ANSI.white}${event.action}${ANSI.reset}`);
+          if (event.thought) {
+            ws.sendLine(`  ${ANSI.dim}${event.thought}${ANSI.reset}`);
+          }
+        }
+        if (event.type === 'observation') {
+          const summary = event.observation?.summary || event.observation?.error;
+          if (summary) ws.sendLine(`  ${ANSI.dim}${summary}${ANSI.reset}`);
+          ws.sendLine('');
+        }
+      },
+    });
+
+    ws.sendLine(`  ${ANSI.green}Final:${ANSI.reset} ${result.final}`);
+    ws.sendLine(`  ${ANSI.dim}Status ${result.status} • ${result.stepsTaken}/${result.maxSteps} steps • ${result.stopReason}${ANSI.reset}`);
+    ws.sendLine('');
+    return {};
+  }
+
+  if (sub === 'plan') {
+    const goal = args.slice(1).join(' ').trim();
+    if (!goal) {
+      return { output: `  ${ANSI.dim}Usage: agent plan <goal>${ANSI.reset}\r\n` };
+    }
+    const { planAgentGoal } = await import('../agent/index.js');
+    const plan = await planAgentGoal(goal);
+    ws.sendLine(`${ANSI.gold}  ◆ AGENT PLAN${ANSI.reset}`);
+    ws.sendLine(`${ANSI.dim}  ${'─'.repeat(50)}${ANSI.reset}`);
+    ws.sendLine(`  ${ANSI.white}${plan.summary}${ANSI.reset}`);
+    ws.sendLine('');
+    plan.steps.forEach((step, index) => ws.sendLine(`  ${ANSI.darkGold}${index + 1}.${ANSI.reset} ${step}`));
+    ws.sendLine('');
+    return {};
+  }
+
   if (sub === 'status') {
+    const { getAgentStatus } = await import('../agent/index.js');
+    const status = getAgentStatus();
+    if (status?.goal || status?.summary) {
+      ws.sendLine(`${ANSI.gold}  ◆ AGENT STATUS${ANSI.reset}`);
+      ws.sendLine(`${ANSI.dim}  ${'─'.repeat(50)}${ANSI.reset}`);
+      ws.sendLine(`  ${ANSI.darkGold}Status${ANSI.reset}       ${ANSI.white}${status.status || '-'}${ANSI.reset}`);
+      ws.sendLine(`  ${ANSI.darkGold}Goal${ANSI.reset}         ${ANSI.white}${status.goal || '-'}${ANSI.reset}`);
+      ws.sendLine(`  ${ANSI.darkGold}Summary${ANSI.reset}      ${ANSI.white}${status.summary || '-'}${ANSI.reset}`);
+      ws.sendLine(`  ${ANSI.darkGold}Steps${ANSI.reset}        ${ANSI.white}${status.stepsTaken || 0}${status.maxSteps ? `/${status.maxSteps}` : ''}${ANSI.reset}`);
+      ws.sendLine(`  ${ANSI.darkGold}Actions${ANSI.reset}      ${ANSI.white}${status.allowActions ? 'enabled' : 'safe mode'}${ANSI.reset}`);
+      ws.sendLine('');
+      return {};
+    }
     return await showSignerStatus(ws);
   }
 
@@ -1802,6 +1886,8 @@ async function cmdAI(args, ws) {
       const chain = getConfig('chain') || 'base';
       const wallet = getConfig('activeWallet') || '(not set)';
       const slippage = getConfig('slippage') || 0.5;
+      const soul = hasSoul() ? getSoul() : null;
+      const recentMemories = await getRecentMemories(3);
 
       engine.setSystemPrompt(`You are DARKSOL Terminal's AI trading assistant running in a web terminal.
 
@@ -1818,6 +1904,10 @@ USER CONTEXT:
 - Active wallet: ${wallet}
 - Slippage: ${slippage}%
 - Supported chains: Base (default), Ethereum, Polygon, Arbitrum, Optimism
+- Soul user: ${soul?.userName || '(unknown)'}
+- Soul agent: ${soul?.agentName || 'Darksol'}
+- Soul tone: ${soul?.tone || 'practical'}
+- Recent persistent memories loaded: ${recentMemories.length}
 
 RULES:
 - Be concise — this is a terminal, not a blog
@@ -1839,6 +1929,9 @@ COMMAND REFERENCE:
 
       chatEngines.set(ws, engine);
       ws.sendLine(`  ${ANSI.green}● AI connected${ANSI.reset} ${ANSI.dim}(${engine.provider}/${engine.model})${ANSI.reset}`);
+      if (soul) {
+        ws.sendLine(`  ${ANSI.dim}${soul.agentName} is live for ${soul.userName} with ${soul.tone} tone.${ANSI.reset}`);
+      }
       ws.sendLine('');
     } catch (err) {
       ws.sendLine(`  ${ANSI.red}✗ AI initialization failed: ${err.message}${ANSI.reset}`);
@@ -1926,7 +2019,7 @@ async function cmdKeys(args, ws) {
 
     if (!svc) {
       ws.sendLine(`  ${ANSI.red}✗ Unknown service: ${service}${ANSI.reset}`);
-      ws.sendLine(`  ${ANSI.dim}Available: openai, anthropic, openrouter, ollama${ANSI.reset}`);
+      ws.sendLine(`  ${ANSI.dim}Available: openai, anthropic, openrouter, minimax, ollama, bankr${ANSI.reset}`);
       ws.sendLine('');
       return {};
     }
@@ -1974,7 +2067,7 @@ async function cmdKeys(args, ws) {
   ws.sendLine(`${ANSI.dim}  ${'─'.repeat(50)}${ANSI.reset}`);
   ws.sendLine('');
 
-  const llmProviders = ['openai', 'anthropic', 'openrouter', 'ollama', 'bankr'];
+  const llmProviders = ['openai', 'anthropic', 'openrouter', 'minimax', 'ollama', 'bankr'];
   ws.sendLine(`  ${ANSI.gold}LLM Providers:${ANSI.reset}`);
   for (const p of llmProviders) {
     const svc = SERVICES[p];
@@ -1988,6 +2081,7 @@ async function cmdKeys(args, ws) {
   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 minimax <key>${ANSI.reset}      ${ANSI.dim}Add MiniMax key${ANSI.reset}`);
   ws.sendLine(`  ${ANSI.green}keys add ollama http://...${ANSI.reset}   ${ANSI.dim}Add Ollama host${ANSI.reset}`);
   ws.sendLine('');
 

package/src/web/server.js

@@ -5,6 +5,8 @@ import { fileURLToPath } from 'url';
 import { dirname, join } from 'path';
 import open from 'open';
 import { theme } from '../ui/theme.js';
+import { getRecentMemories } from '../memory/index.js';
+import { getSoul, hasSoul } from '../soul/index.js';
 import { createRequire } from 'module';
 const require = createRequire(import.meta.url);
 const { version: PKG_VERSION } = require('../../package.json');
@@ -89,6 +91,19 @@ export async function startWebShell(opts = {}) {
       data: getBanner(),
     }));
 
+    if (hasSoul()) {
+      const soul = getSoul();
+      getRecentMemories(3).then((memories) => {
+        const memoryHint = memories.length > 0
+          ? `\r\n  \x1b[38;2;102;102;102m${soul.agentName} loaded ${memories.length} recent memories.\x1b[0m`
+          : '';
+        ws.send(JSON.stringify({
+          type: 'output',
+          data: `  \x1b[38;2;255;215;0mWelcome back, ${soul.userName}.\x1b[0m\r\n  \x1b[38;2;102;102;102m${soul.agentName} is online with a ${soul.tone} tone.\x1b[0m${memoryHint}\r\n\r\n`,
+        }));
+      }).catch(() => {});
+    }
+
     // AI connection check right after banner
     const aiStatus = getAIStatus();
     ws.send(JSON.stringify({