@darksol/terminal 0.4.1 → 0.4.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@darksol/terminal",
-  "version": "0.4.1",
+  "version": "0.4.2",
   "description": "DARKSOL Terminal — unified CLI for all DARKSOL services. Market intel, trading, oracle, casino, and more.",
   "type": "module",
   "bin": {
@@ -43,7 +43,8 @@
     "open": "^11.0.0",
     "ora": "^8.1.0",
     "terminal-link": "^3.0.0",
-    "update-notifier": "^7.3.1"
+    "update-notifier": "^7.3.1",
+    "ws": "^8.19.0"
   },
   "engines": {
     "node": ">=18.0.0"

package/src/cli.js

@@ -9,6 +9,7 @@ import { showHistory } from './wallet/history.js';
 import { showGas } from './services/gas.js';
 import { watchPrice, checkPrices } from './services/watch.js';
 import { mailSetup, mailCreate, mailInboxes, mailSend, mailList, mailRead, mailReply, mailForward, mailThreads, mailDelete, mailUse, mailStats, mailStatus } from './services/mail.js';
+import { startWebShell } from './web/server.js';
 import { executeSwap } from './trading/swap.js';
 import { snipeToken, watchSnipe } from './trading/snipe.js';
 import { createDCA, listDCA, cancelDCA, runDCA } from './trading/dca.js';
@@ -398,6 +399,16 @@ export function cli(argv) {
     .description('Delete an inbox')
     .action((id) => mailDelete(id));
 
+  // ═══════════════════════════════════════
+  // WEB SHELL
+  // ═══════════════════════════════════════
+  program
+    .command('serve')
+    .description('🌐 Launch web terminal in browser')
+    .option('-p, --port <port>', 'Server port', '18791')
+    .option('--no-open', 'Don\'t auto-open browser')
+    .action((opts) => startWebShell(opts));
+
   // ═══════════════════════════════════════
   // PORTFOLIO SHORTCUT
   // ═══════════════════════════════════════
@@ -776,6 +787,42 @@ export function cli(argv) {
       }
     });
 
+  // ═══════════════════════════════════════
+  // FUZZY / NATURAL LANGUAGE FALLBACK
+  // ═══════════════════════════════════════
+  // If someone types something Commander doesn't recognize,
+  // try routing it through AI before saying "unknown command"
+  program.on('command:*', async (operands) => {
+    const input = operands.join(' ');
+    const { hasAnyLLM } = await import('./config/keys.js');
+
+    if (hasAnyLLM()) {
+      const { parseIntent } = await import('./llm/intent.js');
+      const { info, error: showError } = await import('./ui/components.js');
+
+      console.log('');
+      info(`"${input}" isn't a command — asking AI...`);
+      console.log('');
+
+      try {
+        const result = await parseIntent(input);
+        if (result && result.action !== 'error' && result.action !== 'unknown') {
+          const { executeIntent } = await import('./llm/intent.js');
+          await executeIntent(result);
+          return;
+        }
+      } catch {}
+
+      showError(`Unknown command: ${input}`);
+      info('Try: darksol help');
+    } else {
+      const { error: showError, info } = await import('./ui/components.js');
+      showError(`Unknown command: ${input}`);
+      info('Tip: Set up AI (darksol setup) for natural language commands');
+      info('Run: darksol help');
+    }
+  });
+
   program.parse(argv);
 }
 
@@ -932,6 +979,7 @@ function showCommandList() {
     ['mail', 'AgentMail — email for your agent'],
     ['facilitator', 'x402 payment facilitator'],
     ['skills', 'Agent skill directory'],
+    ['serve', 'Launch web terminal in browser'],
     ['setup', 'Re-run setup wizard'],
     ['config', 'Terminal configuration'],
   ];

package/src/services/builders.js

@@ -1,4 +1,4 @@
-import fetch from 'node-fetch';
+import { fetchJSON } from '../utils/fetch.js';
 import { getServiceURL } from '../config/store.js';
 import { theme } from '../ui/theme.js';
 import { spinner, table, kvDisplay, error } from '../ui/components.js';
@@ -9,8 +9,7 @@ const getURL = () => getServiceURL('builders') || 'https://builders.darksol.net'
 export async function buildersLeaderboard(opts = {}) {
   const spin = spinner('Loading builder leaderboard...').start();
   try {
-    const resp = await fetch(`${getURL()}/api/leaderboard?limit=${opts.limit || 20}`);
-    const data = await resp.json();
+    const data = await fetchJSON(`${getURL()}/api/leaderboard?limit=${opts.limit || 20}`);
     spin.succeed('Leaderboard loaded');
 
     showSection('ERC-8021 BUILDER LEADERBOARD');
@@ -34,8 +33,7 @@ export async function buildersLeaderboard(opts = {}) {
 export async function buildersLookup(code) {
   const spin = spinner(`Looking up builder: ${code}...`).start();
   try {
-    const resp = await fetch(`${getURL()}/api/builders/${code}`);
-    const data = await resp.json();
+    const data = await fetchJSON(`${getURL()}/api/builders/${code}`);
     spin.succeed('Builder found');
 
     showSection(`BUILDER — ${code}`);
@@ -49,8 +47,7 @@ export async function buildersLookup(code) {
 export async function buildersFeed(opts = {}) {
   const spin = spinner('Loading builder feed...').start();
   try {
-    const resp = await fetch(`${getURL()}/api/feed?limit=${opts.limit || 20}`);
-    const data = await resp.json();
+    const data = await fetchJSON(`${getURL()}/api/feed?limit=${opts.limit || 20}`);
     spin.succeed('Feed loaded');
 
     showSection('BUILDER FEED');

package/src/services/cards.js

@@ -1,7 +1,7 @@
-import fetch from 'node-fetch';
+import { fetchJSON } from '../utils/fetch.js';
 import { getServiceURL } from '../config/store.js';
 import { theme } from '../ui/theme.js';
-import { spinner, kvDisplay, error, table } from '../ui/components.js';
+import { spinner, kvDisplay, error, info, table } from '../ui/components.js';
 import { showSection } from '../ui/banner.js';
 
 const getURL = () => getServiceURL('cards') || 'https://acp.darksol.net/cards';
@@ -9,8 +9,7 @@ const getURL = () => getServiceURL('cards') || 'https://acp.darksol.net/cards';
 export async function cardsCatalog() {
   const spin = spinner('Loading card catalog...').start();
   try {
-    const resp = await fetch(`${getURL()}/api/cards/catalog`);
-    const data = await resp.json();
+    const data = await fetchJSON(`${getURL()}/api/cards/catalog`);
     spin.succeed('Catalog loaded');
 
     showSection('PREPAID CARDS');
@@ -29,18 +28,18 @@ export async function cardsCatalog() {
   } catch (err) {
     spin.fail('Catalog failed');
     error(err.message);
+    info('Cards service: https://acp.darksol.net/cards');
   }
 }
 
 export async function cardsOrder(provider, amount) {
   const spin = spinner('Processing card order...').start();
   try {
-    const resp = await fetch(`${getURL()}/api/cards/order`, {
+    const data = await fetchJSON(`${getURL()}/api/cards/order`, {
       method: 'POST',
       headers: { 'Content-Type': 'application/json' },
       body: JSON.stringify({ provider, amount }),
     });
-    const data = await resp.json();
     spin.succeed('Order placed');
 
     showSection('CARD ORDER');
@@ -48,14 +47,14 @@ export async function cardsOrder(provider, amount) {
   } catch (err) {
     spin.fail('Order failed');
     error(err.message);
+    info('The cards order API may not be live yet. Check: https://acp.darksol.net/cards');
   }
 }
 
 export async function cardsStatus(orderId) {
   const spin = spinner('Checking order...').start();
   try {
-    const resp = await fetch(`${getURL()}/api/cards/status?orderId=${orderId}`);
-    const data = await resp.json();
+    const data = await fetchJSON(`${getURL()}/api/cards/status?orderId=${orderId}`);
     spin.succeed('Status loaded');
 
     showSection(`CARD ORDER — ${orderId}`);

package/src/services/casino.js

@@ -1,3 +1,4 @@
+import { fetchJSON } from '../utils/fetch.js';
 import fetch from 'node-fetch';
 import { getServiceURL } from '../config/store.js';
 import { theme } from '../ui/theme.js';
@@ -9,7 +10,7 @@ const getURL = () => getServiceURL('casino') || 'https://casino.darksol.net';
 export async function casinoBet(game, opts = {}) {
   const spin = spinner(`Placing ${game} bet...`).start();
   try {
-    const resp = await fetch(`${getURL()}/api/bet`, {
+    const data = await fetchJSON(`${getURL()}/api/bet`, {
       method: 'POST',
       headers: { 'Content-Type': 'application/json' },
       body: JSON.stringify({
@@ -19,7 +20,6 @@ export async function casinoBet(game, opts = {}) {
         wallet: opts.wallet,
       }),
     });
-    const data = await resp.json();
     spin.succeed('Bet placed');
 
     showSection(`CASINO — ${game.toUpperCase()}`);
@@ -40,8 +40,7 @@ export async function casinoBet(game, opts = {}) {
 export async function casinoTables() {
   const spin = spinner('Loading tables...').start();
   try {
-    const resp = await fetch(`${getURL()}/api/tables`);
-    const data = await resp.json();
+    const data = await fetchJSON(`${getURL()}/api/tables`);
     spin.succeed('Tables loaded');
 
     showSection('CASINO TABLES');
@@ -66,8 +65,7 @@ export async function casinoTables() {
 export async function casinoStats() {
   const spin = spinner('Loading stats...').start();
   try {
-    const resp = await fetch(`${getURL()}/api/stats`);
-    const data = await resp.json();
+    const data = await fetchJSON(`${getURL()}/api/stats`);
     spin.succeed('Stats loaded');
 
     showSection('CASINO STATS');
@@ -81,8 +79,7 @@ export async function casinoStats() {
 export async function casinoReceipt(id) {
   const spin = spinner(`Loading receipt ${id}...`).start();
   try {
-    const resp = await fetch(`${getURL()}/api/receipt/${id}`);
-    const data = await resp.json();
+    const data = await fetchJSON(`${getURL()}/api/receipt/${id}`);
     spin.succeed('Receipt loaded');
 
     showSection(`CASINO RECEIPT — ${id}`);
@@ -92,3 +89,4 @@ export async function casinoReceipt(id) {
     error(err.message);
   }
 }
+

package/src/services/facilitator.js

@@ -1,4 +1,4 @@
-import fetch from 'node-fetch';
+import { fetchJSON } from '../utils/fetch.js';
 import { getServiceURL } from '../config/store.js';
 import { theme } from '../ui/theme.js';
 import { spinner, kvDisplay, error } from '../ui/components.js';
@@ -9,8 +9,7 @@ const getURL = () => getServiceURL('facilitator') || 'https://facilitator.darkso
 export async function facilitatorHealth() {
   const spin = spinner('Checking facilitator...').start();
   try {
-    const resp = await fetch(`${getURL()}/api/health`);
-    const data = await resp.json();
+    const data = await fetchJSON(`${getURL()}/api/health`);
     spin.succeed('Facilitator online');
 
     showSection('FACILITATOR STATUS');
@@ -24,12 +23,11 @@ export async function facilitatorHealth() {
 export async function facilitatorVerify(payment) {
   const spin = spinner('Verifying payment...').start();
   try {
-    const resp = await fetch(`${getURL()}/api/verify`, {
+    const data = await fetchJSON(`${getURL()}/api/verify`, {
       method: 'POST',
       headers: { 'Content-Type': 'application/json' },
       body: JSON.stringify(typeof payment === 'string' ? JSON.parse(payment) : payment),
     });
-    const data = await resp.json();
     spin.succeed(data.valid ? 'Payment valid' : 'Payment invalid');
 
     showSection('PAYMENT VERIFICATION');
@@ -43,12 +41,11 @@ export async function facilitatorVerify(payment) {
 export async function facilitatorSettle(payment) {
   const spin = spinner('Settling on-chain...').start();
   try {
-    const resp = await fetch(`${getURL()}/api/settle`, {
+    const data = await fetchJSON(`${getURL()}/api/settle`, {
       method: 'POST',
       headers: { 'Content-Type': 'application/json' },
       body: JSON.stringify(typeof payment === 'string' ? JSON.parse(payment) : payment),
     });
-    const data = await resp.json();
     spin.succeed('Settlement complete');
 
     showSection('SETTLEMENT');

package/src/services/oracle.js

@@ -1,3 +1,4 @@
+import { fetchJSON } from '../utils/fetch.js';
 import fetch from 'node-fetch';
 import { getServiceURL } from '../config/store.js';
 import { theme } from '../ui/theme.js';
@@ -9,8 +10,7 @@ const getURL = () => getServiceURL('oracle') || 'https://acp.darksol.net/oracle'
 export async function oracleFlip() {
   const spin = spinner('Flipping coin...').start();
   try {
-    const resp = await fetch(`${getURL()}/api/coin`);
-    const data = await resp.json();
+    const data = await fetchJSON(`${getURL()}/api/coin`);
     spin.succeed('Coin flipped');
     showSection('ORACLE — COIN FLIP');
     kvDisplay([
@@ -26,8 +26,7 @@ export async function oracleFlip() {
 export async function oracleDice(sides = 6) {
   const spin = spinner(`Rolling d${sides}...`).start();
   try {
-    const resp = await fetch(`${getURL()}/api/dice?sides=${sides}`);
-    const data = await resp.json();
+    const data = await fetchJSON(`${getURL()}/api/dice?sides=${sides}`);
     spin.succeed('Dice rolled');
     showSection(`ORACLE — D${sides}`);
     kvDisplay([
@@ -44,8 +43,7 @@ export async function oracleDice(sides = 6) {
 export async function oracleNumber(min = 1, max = 100) {
   const spin = spinner(`Generating number ${min}-${max}...`).start();
   try {
-    const resp = await fetch(`${getURL()}/api/number?min=${min}&max=${max}`);
-    const data = await resp.json();
+    const data = await fetchJSON(`${getURL()}/api/number?min=${min}&max=${max}`);
     spin.succeed('Number generated');
     showSection('ORACLE — RANDOM NUMBER');
     kvDisplay([
@@ -62,12 +60,11 @@ export async function oracleNumber(min = 1, max = 100) {
 export async function oracleShuffle(items) {
   const spin = spinner('Shuffling...').start();
   try {
-    const resp = await fetch(`${getURL()}/api/shuffle`, {
+    const data = await fetchJSON(`${getURL()}/api/shuffle`, {
       method: 'POST',
       headers: { 'Content-Type': 'application/json' },
       body: JSON.stringify({ items }),
     });
-    const data = await resp.json();
     spin.succeed('Shuffled');
     showSection('ORACLE — SHUFFLE');
     console.log(theme.gold('  Result: ') + (data.result || data.value || []).join(', '));
@@ -80,8 +77,7 @@ export async function oracleShuffle(items) {
 export async function oracleHealth() {
   const spin = spinner('Checking oracle...').start();
   try {
-    const resp = await fetch(`${getURL()}/api/health`);
-    const data = await resp.json();
+    const data = await fetchJSON(`${getURL()}/api/health`);
     spin.succeed('Oracle online');
     showSection('ORACLE STATUS');
     kvDisplay(Object.entries(data).map(([k, v]) => [k, String(v)]));

package/src/ui/banner.js

@@ -26,7 +26,7 @@ export function showBanner(opts = {}) {
   );
   console.log(
     theme.dim('  ║ ') +
-    theme.subtle(' v0.4.0') +
+    theme.subtle(' v0.4.2') +
     theme.dim('                                                ') +
     theme.gold('🌑') +
     theme.dim(' ║')
@@ -44,7 +44,7 @@ export function showBanner(opts = {}) {
 
 export function showMiniBanner() {
   console.log('');
-  console.log(theme.gold.bold('  🌑 DARKSOL TERMINAL') + theme.dim(' v0.4.0'));
+  console.log(theme.gold.bold('  🌑 DARKSOL TERMINAL') + theme.dim(' v0.4.2'));
   console.log(theme.dim('  ─────────────────────────────'));
   console.log('');
 }
@@ -72,3 +72,6 @@ export function showDivider() {
 
 
 
+
+
+

package/src/utils/fetch.js

@@ -0,0 +1,28 @@
+import fetch from 'node-fetch';
+
+/**
+ * Fetch JSON safely — handles HTML error pages, non-JSON responses,
+ * and invalid JSON gracefully instead of crashing with cryptic errors.
+ */
+export async function fetchJSON(url, options = {}) {
+  const resp = await fetch(url, options);
+  const contentType = resp.headers.get('content-type') || '';
+  const text = await resp.text();
+
+  if (!contentType.includes('application/json') && !contentType.includes('text/json')) {
+    const preview = text.substring(0, 60).replace(/\n/g, ' ');
+    throw new Error(
+      `Expected JSON but got ${contentType.split(';')[0] || 'unknown'} (HTTP ${resp.status}). ` +
+      `Response: "${preview}..."`
+    );
+  }
+
+  try {
+    return JSON.parse(text);
+  } catch {
+    const preview = text.substring(0, 60).replace(/\n/g, ' ');
+    throw new Error(`Invalid JSON (HTTP ${resp.status}): "${preview}..."`);
+  }
+}
+
+export default fetchJSON;