@darksol/terminal 0.10.0 → 0.12.0

package/README.md

@@ -15,7 +15,7 @@ A unified CLI for market intel, trading, AI-powered analysis, on-chain oracle, c
 [![License: GPL-3.0](https://img.shields.io/badge/License-GPL--3.0-gold.svg)](https://www.gnu.org/licenses/gpl-3.0)
 [![Node](https://img.shields.io/badge/node-%3E%3D18.0.0-green.svg)](https://nodejs.org/)
 
-- Current release: **0.9.2**
+- Current release: **0.12.0**
 - Changelog: `CHANGELOG.md`
 
 ## Install
@@ -81,6 +81,27 @@ darksol serve
 
 # Start agent signer for OpenClaw
 darksol agent start main
+
+# Telegram bot — AI chat through Telegram
+darksol telegram setup
+darksol telegram start
+darksol telegram status
+darksol telegram send 123456789 "Hello from DARKSOL"
+
+# Background daemon — manage persistent services
+darksol daemon start
+darksol daemon status
+darksol daemon stop
+
+# Browser automation (requires: npm i playwright-core)
+darksol browser launch --headed
+darksol browser navigate https://app.uniswap.org
+darksol browser screenshot swap-page.png
+darksol browser click "#swap-button"
+darksol browser type "#amount-input" "1.0"
+darksol browser eval "document.title"
+darksol browser close
+darksol browser install
 ```
 
 ## `darksol serve` (Web Terminal UX)
@@ -129,6 +150,9 @@ ai <prompt>   # chat with trading assistant
 | `dca` | Dollar-cost averaging engine | Gas only |
 | `soul` | Agent identity & personality configuration | Free |
 | `memory` | Persistent cross-session memory store | Free |
+| `whale` | Whale Radar — track wallets, copy-trade, live feed | Free |
+| `dash` | Live TUI dashboard — portfolio, prices, gas, whale feed | Free |
+| `auto` | Autonomous Trader — goal-based automated execution | Provider dependent |
 | `agent task` | Autonomous ReAct agent loop with tool use | Provider dependent |
 | `ai` | LLM-powered trading assistant & intent execution | Provider dependent |
 | `agent` | Secure agent signer (PK-isolated proxy) | Free |
@@ -147,11 +171,192 @@ ai <prompt>   # chat with trading assistant
 | `cards` | Crypto → prepaid Visa/MC cards | Service fees |
 | `builders` | ERC-8021 builder directory + leaderboard | Free |
 | `facilitator` | x402 payment verification & settlement | Free |
+| `telegram` | Telegram bot — AI chat via Telegram Bot API | Provider dependent |
+| `daemon` | Background service daemon (manages TG, browser, etc.) | Free |
+| `browser` | Playwright-powered browser automation | Free |
 | `serve` | Local interactive web terminal (xterm.js) | Free |
 | `config` | Terminal configuration | Free |
 
 ---
 
+## 🐋 Whale Radar
+
+Track any wallet across 5 chains. Get alerts on swaps, transfers, new tokens. Enable copy-trading to mirror a whale's moves automatically.
+
+```bash
+# Track a wallet
+darksol whale track 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 --label "vitalik" --chain ethereum
+
+# List all tracked wallets
+darksol whale list
+
+# View recent activity
+darksol whale activity 0xd8dA... --limit 20
+
+# Enable copy-trading (mirrors swaps with your own limits)
+darksol whale mirror 0xd8dA... --max 50 --slippage 2 --dry-run
+
+# Open the live feed (blessed TUI)
+darksol whale feed
+
+# Stop tracking
+darksol whale stop 0xd8dA...
+```
+
+- **5-chain support:** Base, Ethereum, Arbitrum, Polygon, Optimism
+- **Swap decoding:** Uniswap V2 + V3 router signatures automatically parsed
+- **Copy-trading:** Mirror whale swaps with budget caps, slippage limits, dry-run mode
+- **Live feed:** Real-time blessed terminal UI with whale events streaming
+- **Daemon integration:** Runs as a background service, feeds alerts to Telegram bot
+- **Event system:** Subscribe to `whale:swap`, `whale:transfer`, `whale:newtoken`, `whale:mirror-executed`
+
+---
+
+## 📊 Live Dashboard
+
+Full-screen terminal dashboard. Portfolio, prices, gas, transactions, whale alerts — all updating in real-time.
+
+```bash
+# Launch the dashboard
+darksol dash
+
+# Custom refresh interval
+darksol dash --refresh 15
+
+# Compact mode (portfolio + prices only)
+darksol dash --compact
+```
+
+- **Portfolio summary** — total value, token balances, chain breakdown
+- **Price ticker** — sparkline micro-charts for tracked tokens
+- **Gas gauge** — current gas prices across all 5 chains
+- **Recent transactions** — last 10 txs from wallet history
+- **Whale feed** — live alerts when whale monitor is running
+- **Keyboard shortcuts:** `q` quit, `r` refresh, `tab` cycle focus, `w` toggle whales, `1-5` switch chains
+- **DARKSOL gold/dark theme** throughout
+
+---
+
+## 🤖 Autonomous Trader
+
+Set a goal in plain English. The AI builds a strategy, monitors the market, and executes trades within your budget and risk limits. Full audit trail on every decision.
+
+```bash
+# Start an autonomous strategy
+darksol auto start "accumulate ETH under 2400" --budget 500 --max-per-trade 50 --risk moderate
+
+# DCA into memecoins
+darksol auto start "DCA into BASE memecoins with >1M liquidity" --budget 200 --interval 15 --dry-run
+
+# Check status
+darksol auto status
+darksol auto status auto_1741...
+
+# View audit trail
+darksol auto log auto_1741... --limit 20
+
+# Stop a strategy
+darksol auto stop auto_1741...
+
+# List all strategies
+darksol auto list
+```
+
+- **Natural language goals** — parsed by LLM intent system into executable strategies
+- **Three risk levels:** conservative (5% stop-loss), moderate (10%), aggressive (20%)
+- **Kill switches:** budget exhaustion, max loss, error threshold — auto-stops immediately
+- **Dry-run mode** — test strategies without executing real trades
+- **Full audit log** — every decision, trade, and skip logged to `~/.darksol/autonomous/<id>/audit.json`
+- **Event system:** `auto:started`, `auto:trade`, `auto:skipped`, `auto:stopped`, `auto:budget-hit`, `auto:error`
+
+---
+
+## 📱 Telegram Bot
+
+Turn your terminal into a Telegram AI agent. Same brain (LLM + soul + memory), different mouth.
+
+```bash
+# Guided setup — walks you through BotFather
+darksol telegram setup
+
+# Start the bot (foreground, or managed by daemon)
+darksol telegram start
+
+# Check bot status
+darksol telegram status
+
+# Send a direct message
+darksol telegram send <chat_id> "Hello from DARKSOL"
+```
+
+**Setup walkthrough:**
+1. Open Telegram → search `@BotFather` → send `/newbot`
+2. Follow BotFather's prompts to name your bot
+3. Copy the bot token
+4. Run `darksol telegram setup` → paste token → auto-validates via `getMe`
+5. Token encrypted and stored in your key vault
+6. `darksol telegram start` → bot goes live
+
+**Features:**
+- Per-chat session memory (remembers conversation context)
+- Soul system prompt (your agent's personality carries over)
+- Built-in commands: `/start`, `/help`, `/status`
+- Typing indicators while LLM processes
+- Rate limiting (1 req/sec per chat)
+- 429 auto-retry for Telegram API limits
+- Daemon-aware: runs foreground solo, or as a managed service
+
+---
+
+## 🖥️ Background Daemon
+
+One process to rule them all. Manages persistent services (Telegram bot, browser, future channels).
+
+```bash
+darksol daemon start              # Detached background process
+darksol daemon status             # PID, uptime, active services
+darksol daemon stop               # Graceful shutdown
+darksol daemon restart            # Stop + start
+darksol daemon start --port 9999  # Custom health port
+```
+
+**Health endpoint:** `http://localhost:18792/health` — returns uptime, version, active services list.
+
+**Service registry:** Services (Telegram, browser, etc.) register with the daemon for managed lifecycle. Start once, everything runs.
+
+---
+
+## 🌐 Browser Automation
+
+Playwright-powered browser control — automate dApps, scrape data, take screenshots.
+
+```bash
+# Install browser binary (one-time)
+darksol browser install
+
+# Launch and control
+darksol browser launch --headed --type chromium
+darksol browser navigate https://app.uniswap.org
+darksol browser screenshot swap-page.png
+darksol browser click "#connect-wallet"
+darksol browser type "#search" "AERO"
+darksol browser eval "document.title"
+darksol browser status
+darksol browser close
+```
+
+**Requires:** `npm install playwright-core` (optional dependency — only needed if you use browser features).
+
+**Features:**
+- Chromium, Firefox, or WebKit
+- Headless (default) or headed mode
+- Named profiles with persistent cookies/sessions (`~/.darksol/browser/profiles/`)
+- IPC via named pipes — CLI commands talk to a running browser instance
+- Web shell integration (`browser` command in `darksol serve`)
+- Daemon-managed when running
+
+---
+
 ## 🔐 Secure Agent Signer
 
 **The killer feature.** A PK-isolated signing proxy for AI agents (OpenClaw, etc.).

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@darksol/terminal",
-  "version": "0.10.0",
+  "version": "0.12.0",
   "description": "DARKSOL Terminal — unified CLI for all DARKSOL services. Market intel, trading, oracle, casino, and more.",
   "type": "module",
   "bin": {
@@ -46,6 +46,9 @@
     "update-notifier": "^7.3.1",
     "ws": "^8.19.0"
   },
+  "optionalDependencies": {
+    "playwright-core": "^1.52.0"
+  },
   "engines": {
     "node": ">=18.0.0"
   }