clodds 1.1.0 → 1.2.0

package/README.md

@@ -9,16 +9,17 @@
 </p>
 
 <p align="center">
-  <a href="https://www.npmjs.com/package/@alsk1992/clodds"><img src="https://img.shields.io/npm/v/@alsk1992/clodds?color=blue" alt="npm version"></a>
+  <a href="https://www.npmjs.com/package/clodds"><img src="https://img.shields.io/npm/v/clodds?color=blue" alt="npm version"></a>
   <img src="https://img.shields.io/badge/node-%3E%3D22-brightgreen" alt="Node.js">
   <img src="https://img.shields.io/badge/typescript-5.3-blue" alt="TypeScript">
   <a href="https://opensource.org/licenses/MIT"><img src="https://img.shields.io/badge/license-MIT-yellow" alt="MIT License"></a>
-  <img src="https://img.shields.io/badge/channels-22-purple" alt="22 Channels">
-  <img src="https://img.shields.io/badge/markets-10-orange" alt="9 Markets">
+  <img src="https://img.shields.io/badge/channels-21-purple" alt="21 Channels">
+  <img src="https://img.shields.io/badge/markets-10-orange" alt="10 Markets">
 </p>
 
 <p align="center">
   <a href="#quick-start">Quick Start</a> •
+  <a href="#webchat">WebChat</a> •
   <a href="#everything-we-built">Features</a> •
   <a href="#channels">Channels</a> •
   <a href="#prediction-markets-10">Markets</a> •
@@ -27,7 +28,7 @@
 
 ---
 
-**Clodds** is a personal AI trading terminal for prediction markets, crypto spot, and **perpetual futures with leverage**. Run it on your own machine, chat via any of **22 messaging platforms**, trade across **10 prediction markets + 6 futures exchanges** (including on-chain Solana perps via Percolator), and manage your portfolio — all through natural conversation.
+**Clodds** is a personal AI trading terminal for prediction markets, crypto spot, and **perpetual futures with leverage**. Run it on your own machine, chat via any of **21 messaging platforms**, trade across **10 prediction markets + 7 futures exchanges** (including on-chain Solana perps via Percolator), and manage your portfolio — all through natural conversation.
 
 Built on Claude with arbitrage detection algorithms based on [arXiv:2508.03474](https://arxiv.org/abs/2508.03474), which documented arbitrage patterns on Polymarket. See [Arbitrage Limitations](#arbitrage-limitations) for practical considerations.
 
@@ -37,7 +38,7 @@ Built on Claude with arbitrage detection algorithms based on [arXiv:2508.03474](
 
 | Option | Best For | Setup Time | Features |
 |--------|----------|------------|----------|
-| **[Self-Hosted](#quick-start)** | Full control, all features | 5 min | 22 channels, trading, DeFi, bots |
+| **[Self-Hosted](#quick-start)** | Full control, all features | 2 min | 21 channels, trading, DeFi, bots |
 | **[Cloudflare Worker](#cloudflare-worker)** | Lightweight, edge deployment | 2 min | 3 webhook channels, market data, arbitrage |
 | **[Compute API](#compute-api)** | Agents paying for compute | Live | LLM, code, web, data, storage |
 
@@ -78,32 +79,59 @@ See [docs/API.md](./docs/API.md#clodds-compute-api) for full documentation.
 
 ## Quick Start
 
-**Option 1: npm (recommended)**
 ```bash
-# One-time: configure npm for @alsk1992 scope
-echo "@alsk1992:registry=https://npm.pkg.github.com" >> ~/.npmrc
+npm install -g clodds
+clodds onboard
+```
 
-# Install globally
-npm install -g @alsk1992/clodds
+That's it. The setup wizard walks you through everything — API key, messaging channel, and starts the gateway. WebChat opens at `http://localhost:18789/webchat`.
 
-# Run
-export ANTHROPIC_API_KEY=sk-ant-...
-clodds start
-```
+<details>
+<summary><strong>From source (alternative)</strong></summary>
 
-**Option 2: From source**
 ```bash
 git clone https://github.com/alsk1992/CloddsBot.git && cd CloddsBot
 npm install && cp .env.example .env
 # Add ANTHROPIC_API_KEY to .env
 npm run build && npm start
 ```
+</details>
+
+## WebChat
+
+Built-in browser interface at `http://localhost:18789/webchat` -- no setup, no third-party dependencies.
+
+**Interface:**
+- Claude-style sidebar with 4 tabs: Chats, Projects, Artifacts, Code
+- Create and organize conversations into project folders
+- Artifacts and code blocks auto-extracted from chat history
+- One-click copy for code snippets, search across all conversations
 
-Open `http://localhost:18789/webchat` — no account needed.
+**Thinking Indicator:**
+- Live spinner with elapsed timer while the AI generates
+- Replaces generic typing dots with actual status feedback
+
+**Unlimited History:**
+- Every message stored in a dedicated database table (append-only, one row per message)
+- No message cap -- scroll back through entire conversation history
+- Paginated loading so even 1000+ message chats load instantly
+
+**Context Compacting:**
+- Older messages automatically summarized so the AI never fully forgets what you discussed
+- LLM receives a compressed recap of earlier conversation + the last 20 messages
+- Similar to how Claude.ai and ChatGPT handle long conversations
+
+**Session Management:**
+- Create, rename, delete conversations via REST API
+- Profile menu with language selector (9 languages), help, about
+- Persistent across restarts (SQLite-backed)
+
+---
 
 ## CLI
 
 ```bash
+clodds onboard     # Interactive setup wizard
 clodds start       # Start the gateway
 clodds repl        # Interactive REPL
 clodds doctor      # System diagnostics
@@ -123,19 +151,19 @@ See [docs/USER_GUIDE.md](./docs/USER_GUIDE.md) for all commands.
 
 | Category | What's Included |
 |----------|-----------------|
-| **Messaging** | 22 platforms (Telegram, Discord, WhatsApp, Slack, Teams, Signal, Matrix, iMessage, LINE, Nostr, and more) |
-| **Prediction Markets** | 9 platforms (Polymarket, Kalshi, Betfair, Smarkets, Drift, Manifold, Metaculus, PredictIt) |
-| **Perpetual Futures** | 5 exchanges (Binance, Bybit, Hyperliquid, MEXC, Percolator) with up to 200x leverage, database tracking, A/B testing |
+| **Messaging** | 21 platforms (Telegram, Discord, WhatsApp, Slack, Teams, Signal, Matrix, iMessage, LINE, Nostr, and more) + built-in WebChat with sidebar, unlimited history, context compacting |
+| **Prediction Markets** | 10 platforms (Polymarket, Kalshi, Betfair, Smarkets, Drift, Manifold, Metaculus, PredictIt, Opinion.xyz, Predict.fun) |
+| **Perpetual Futures** | 7 exchanges (Binance, Bybit, Hyperliquid, MEXC, Drift, Percolator, Lighter) with up to 200x leverage, database tracking, A/B testing |
 | **On-Chain Perps** | Percolator protocol — Solana-native perpetual futures with pluggable matchers, keeper cranking, real-time slab polling |
 | **Token Security** | GoPlus-powered audits — honeypot detection, rug-pull analysis, holder concentration, risk scoring |
 | **Security Shield** | Code scanning (75 rules), scam DB (70+ addresses), multi-chain address checking, pre-trade tx validation |
-| **Trading** | Order execution on 5 platforms, portfolio tracking, P&L, trade logging, DCA on 16 platforms |
-| **MCP Server** | Expose all 113 skills as MCP tools for Claude Desktop and Claude Code |
+| **Trading** | Order execution on 16+ platforms (prediction markets, futures, Solana DEXs, EVM DEXs), portfolio tracking, P&L, DCA |
+| **MCP Server** | Expose all 118 skills as MCP tools for Claude Desktop and Claude Code |
 | **Arbitrage** | Cross-platform detection, combinatorial analysis, semantic matching, real-time scanning |
-| **AI** | 6 LLM providers, 4 specialized agents, semantic memory, 21 tools |
+| **AI** | 8 LLM providers, 4 specialized agents, semantic memory, 18 tools |
 | **i18n** | 10 languages (EN, ZH, ES, JA, KO, DE, FR, PT, RU, AR) |
-| **Solana DeFi** | Jupiter, Raydium, Orca, Meteora, Pump.fun integration |
-| **EVM DeFi** | Uniswap V3, 1inch, Virtuals Protocol (ETH, ARB, OP, Base, Polygon) |
+| **Solana DeFi** | Jupiter, Raydium, Orca, Meteora, Kamino, MarginFi, Solend, Pump.fun, Bags.fm, AgentBets |
+| **EVM DeFi** | Uniswap V3, 1inch, PancakeSwap, Virtuals Protocol, Clanker, Veil, ENS (ETH, ARB, OP, Base, Polygon) |
 | **Smart Trading** | Whale tracking, copy trading, smart routing, MEV protection |
 | **Trade Ledger** | Decision audit trail with confidence calibration, SHA-256 integrity hashing, statistics |
 | **Crypto Whale Tracking** | Multi-chain whale monitoring (Solana, ETH, Polygon, ARB, Base, OP) |
@@ -146,11 +174,11 @@ See [docs/USER_GUIDE.md](./docs/USER_GUIDE.md) for all commands.
 
 ---
 
-## Channels (22)
+## Channels (21)
 
-Telegram, Discord, Slack, WhatsApp, Teams, Matrix, Signal, iMessage, LINE, Nostr, Twitch, WebChat, and more.
+Telegram, Discord, Slack, WhatsApp, Teams, Matrix, Signal, iMessage, LINE, Nostr, Twitch, **WebChat**, and more.
 
-All channels support real-time sync, rich media, and offline queuing.
+All channels support real-time sync, rich media, and offline queuing. WebChat is the built-in browser interface with a full sidebar UI, unlimited message history, and conversation management -- see [WebChat](#webchat) above.
 
 ---
 
@@ -167,6 +195,8 @@ All channels support real-time sync, rich media, and offline queuing.
 | Metaculus | data | Forecasting |
 | PredictIt | data | US Politics |
 | AgentBets | data | AI Agents / Solana (Colosseum Hackathon) |
+| Opinion.xyz | ✓ | BNB Chain |
+| Predict.fun | ✓ | BNB Chain |
 
 Supports limit/market orders, maker rebates, real-time orderbooks, P&L tracking, and smart routing.
 
@@ -174,9 +204,9 @@ Supports limit/market orders, maker rebates, real-time orderbooks, P&L tracking,
 
 ## Crypto & DeFi
 
-**Solana:** Jupiter, Raydium, Orca, Meteora, Pump.fun — with Jito MEV protection
+**Solana:** Jupiter, Raydium, Orca, Meteora, Kamino, MarginFi, Solend, Pump.fun, Bags.fm — with Jito MEV protection
 
-**EVM (5 chains):** Uniswap V3, 1inch, Virtuals Protocol on Ethereum, Arbitrum, Optimism, Base, Polygon — with Flashbots MEV protection
+**EVM (5 chains):** Uniswap V3, 1inch, PancakeSwap, Virtuals Protocol on Ethereum, Arbitrum, Optimism, Base, Polygon — with Flashbots MEV protection
 
 **Bridging:** Wormhole cross-chain transfers (ETH ↔ Solana, Polygon ↔ Base)
 
@@ -184,7 +214,7 @@ Supports limit/market orders, maker rebates, real-time orderbooks, P&L tracking,
 
 ---
 
-## Perpetual Futures (5 Exchanges)
+## Perpetual Futures (7 Exchanges)
 
 | Exchange | Max Leverage | KYC | Type |
 |----------|--------------|-----|------|
@@ -192,7 +222,9 @@ Supports limit/market orders, maker rebates, real-time orderbooks, P&L tracking,
 | Bybit | 100x | Yes | CEX |
 | Hyperliquid | 50x | No | DEX |
 | MEXC | 200x | No | CEX |
+| Drift | 20x | No | DEX (Solana) |
 | Percolator | Varies | No | On-chain (Solana) |
+| Lighter | 50x | No | DEX (Arbitrum) |
 
 Long/short, cross/isolated margin, TP/SL, liquidation alerts, funding tracking, database logging.
 
@@ -220,11 +252,11 @@ Configure: `PERCOLATOR_ENABLED=true PERCOLATOR_SLAB=<pubkey> PERCOLATOR_ORACLE=<
 
 ## AI System
 
-**6 LLM providers:** Claude (primary), GPT-4, Gemini, Groq, Together, Ollama
+**8 LLM providers:** Claude (primary), GPT-4, Gemini, Groq, Together, Fireworks, AWS Bedrock, Ollama
 
 **4 agents:** Main, Trading, Research, Alerts
 
-**21 tools:** Browser, docker, exec, files, git, email, sms, webhooks, sql, vision
+**18 tools:** Browser, docker, exec, files, git, email, sms, webhooks, sql, vision
 
 **Memory:** Semantic search (LanceDB), hybrid BM25, user profiles, persistent facts
 
@@ -315,16 +347,16 @@ Enable: `clodds config set ledger.enabled true`
 
 ## Skills & Extensions
 
-**111 bundled skills** across trading, data, automation, and infrastructure — lazy-loaded on first use so missing dependencies don't crash the app. Run `/skills` to see status.
+**118 bundled skills** across trading, data, automation, and infrastructure — lazy-loaded on first use so missing dependencies don't crash the app. Run `/skills` to see status.
 
 | Category | Skills |
 |----------|--------|
-| Trading | Polymarket, Kalshi, Betfair, Hyperliquid, Binance, Bybit, MEXC, Jupiter, Raydium, Orca, Percolator, DCA (16 platforms) |
+| Trading | Polymarket, Kalshi, Betfair, Hyperliquid, Binance, Bybit, MEXC, Drift, Jupiter, Raydium, Orca, Percolator, DCA (16 platforms) |
 | Analysis | Arbitrage detection, edge finding, whale tracking, copy trading, token security audits, security shield |
 | Automation | Cron jobs, triggers, bots, webhooks |
 | AI | Memory, embeddings, multi-agent routing |
 
-**7 extensions** for Copilot, OpenTelemetry, LanceDB, and more.
+**9 extensions** for Copilot, OpenTelemetry, LanceDB, Qwen Portal, and more.
 
 ---
 
@@ -340,16 +372,16 @@ Enable: `clodds config set ledger.enabled true`
         ▼                         ▼                         ▼
 ┌───────────────┐         ┌───────────────┐         ┌───────────────┐
 │   CHANNELS    │         │    AGENTS     │         │    FEEDS      │
-│   (22)        │         │    (4)        │         │    (9+)       │
+│   (21)        │         │    (4)        │         │    (12+)      │
 ├───────────────┤         ├───────────────┤         ├───────────────┤
 │ Telegram      │         │ Main          │         │ Polymarket    │
 │ Discord       │         │ Trading       │         │ Kalshi        │
 │ WhatsApp      │         │ Research      │         │ Betfair       │
 │ Slack         │         │ Alerts        │         │ Manifold      │
 │ Teams         │         │               │         │ Crypto (10)   │
-│ Matrix        │         │ Tools (21)    │         │               │
-│ Signal        │         │ Skills (110)  │         │ Arbitrage     │
-│ +15 more      │         │ Memory        │         │ Detector      │
+│ Matrix        │         │ Tools (18)    │         │               │
+│ Signal        │         │ Skills (118)  │         │ Arbitrage     │
+│ +14 more      │         │ Memory        │         │ Detector      │
 └───────────────┘         └───────────────┘         └───────────────┘
         │                         │                         │
         └─────────────────────────┼─────────────────────────┘
@@ -443,15 +475,15 @@ docker compose up --build
 
 | Category | Count |
 |----------|------:|
-| Messaging Channels | **22** |
-| Prediction Markets | **9** |
-| Futures Exchanges | **5** |
-| AI Tools | **21** |
-| Skills | **103** |
-| LLM Providers | **6** |
-| Solana DEX Protocols | **5** |
+| Messaging Channels | **21** |
+| Prediction Markets | **10** |
+| Futures Exchanges | **7** |
+| AI Tools | **18** |
+| Skills | **118** |
+| LLM Providers | **8** |
+| Solana DeFi Protocols | **9** |
 | Trading Strategies | **4** |
-| Extensions | **7** |
+| Extensions | **9** |
 
 ---
 

package/dist/agents/handlers/kalshi.d.ts

@@ -2,8 +2,7 @@
  * Kalshi Handlers
  *
  * All 78 Kalshi platform handlers migrated from agents/index.ts switch cases.
- * Includes execution-service-based trading, no-auth exchange info,
- * and credential-based Python CLI handlers.
+ * Uses direct HTTP calls to the Kalshi REST API with RSA-PSS authentication.
  */
 import type { HandlersMap } from './types';
 export declare const kalshiHandlers: HandlersMap;