@quantish/agent 0.1.27 → 0.1.29

package/README.md

@@ -1,8 +1,16 @@
 # @quantish/agent
 
-AI-powered CLI agent for building trading bots and applications on Polymarket.
+AI-powered coding & trading agent for Polymarket and Kalshi. Build trading bots, analyze markets, and execute trades using natural language.
 
-Combines **coding tools** (file system, shell, git) with **trading tools** (Polymarket orders, positions, wallet) powered by Claude AI.
+## ✨ Features
+
+- **🤖 Multi-Provider AI** - Use Anthropic Claude or 100+ OpenRouter models (GLM-4.7, MiniMax, DeepSeek, etc.)
+- **💹 Live Trading** - Trade on Polymarket (Polygon) and Kalshi (Solana via DFlow)
+- **🔧 Full Coding Tools** - Read/write files, run commands, git operations
+- **🌐 Web Search** - Search the web with Exa AI or DuckDuckGo fallback
+- **💾 Session Persistence** - Save and resume conversations across sessions
+- **⚡ Queued Input** - Type while the agent is working, queue messages
+- **📊 Cost Tracking** - Real-time token usage and cost display
 
 ## Installation
 
@@ -10,265 +18,420 @@ Combines **coding tools** (file system, shell, git) with **trading tools** (Poly
 npm install -g @quantish/agent
 ```
 
-Or run directly with npx:
+## Quick Start
 
 ```bash
-npx @quantish/agent
+# First-time setup
+quantish init
+
+# Start interactive chat
+quantish
 ```
 
-## Quick Start
+## How It Works
+
+The agent connects to three MCP (Model Context Protocol) servers:
+
+| MCP | URL | Auth | Purpose |
+|-----|-----|------|---------|
+| Discovery | `quantish.live/mcp` | Public (embedded key) | Search markets across all platforms |
+| Polymarket | `quantish-sdk-production.up.railway.app/mcp` | `QUANTISH_API_KEY` | Trade on Polymarket (Polygon) |
+| Kalshi | `kalshi-mcp-production-7c2c.up.railway.app/mcp` | `KALSHI_API_KEY` | Trade on Kalshi (Solana via DFlow) |
+
+**Polymarket** - Managed Polygon wallet:
+- ✅ Gasless transactions (Polymarket covers fees)
+- ✅ Signs orders using Polymarket's required format  
+- ✅ Works globally (no geo-restrictions)
+- 🔒 Non-custodial - export your private key anytime
+
+**Kalshi** - Managed Solana wallet via DFlow:
+- ✅ Trade on CFTC-regulated Kalshi markets
+- ✅ Uses DFlow protocol for on-chain settlement
+- ⚡ Small SOL fees (~0.01 SOL per trade)
+- 🔒 Non-custodial - export your private key anytime
+
+## Interactive Commands
+
+### Chat Commands
+
+| Command | Description |
+|---------|-------------|
+| `/help` | Show all commands |
+| `/clear` | Clear conversation history |
+| `/compact` | Summarize conversation to save tokens |
+| `/model <name>` | Switch model (opus, sonnet, haiku, glm, minimax, etc.) |
+| `/provider <name>` | Switch LLM provider (anthropic, openrouter) |
+| `/cost` | Show session cost breakdown |
+| `/tools` | List available tools |
+| `/config` | Show configuration info |
+
+### Session Commands
+
+| Command | Description |
+|---------|-------------|
+| `/save [name]` | Save current session |
+| `/resume` | Resume last session |
+| `/sessions` | List all saved sessions |
+| `/load <id>` | Load a session by ID |
+| `/forget` | Delete all saved sessions |
+
+### Process Commands
+
+| Command | Description |
+|---------|-------------|
+| `/processes` | List running background processes |
+| `/stop <id>` | Stop a background process |
+| `/stopall` | Stop all background processes |
+
+### Keyboard Shortcuts
 
-### 1. Initialize
+| Key | Action |
+|-----|--------|
+| `Enter` | Send message (or queue if agent is working) |
+| `Esc` | Interrupt current generation |
+| `Ctrl+C` | Exit CLI |
 
-Set up your API keys:
+## CLI Options
 
 ```bash
-quantish init
+quantish                    # Interactive mode
+quantish init               # First-time setup wizard
+quantish config             # View configuration
+quantish config --export    # Export as .env format
+quantish tools              # List all available tools
+quantish -p "message"       # One-shot mode
+quantish --version          # Show version
 ```
 
-You'll need:
-- **Anthropic API Key** - Get one at https://console.anthropic.com/
-- **Quantish API Key** - Created automatically during setup
+| Option | Description |
+|--------|-------------|
+| `-p, --prompt <message>` | Run a single prompt |
+| `-v, --verbose` | Show detailed tool calls |
+| `--no-mcp` | Disable trading tools |
+| `--no-local` | Disable coding tools |
+
+## Available Tools
+
+### Local Tools (Coding)
 
-### 2. Start Building
+| Tool | Description |
+|------|-------------|
+| `read_file` | Read file contents with line numbers |
+| `write_file` | Create or overwrite files |
+| `edit_file` | Search and replace in files |
+| `edit_lines` | Edit specific line ranges (efficient) |
+| `list_dir` | List directory contents |
+| `delete_file` | Delete files |
+| `file_exists` | Check if file exists |
+| `run_command` | Execute shell commands (blocking) |
+| `start_background_process` | Run long-running processes |
+| `get_process_output` | Get output from background process |
+| `stop_process` | Stop a background process |
+| `grep` | Search file contents |
+| `find_files` | Find files by pattern |
+| `setup_env` | Create/update .env files |
 
-**Interactive mode:**
+### Git Tools
+
+| Tool | Description |
+|------|-------------|
+| `git_status` | Get repository status |
+| `git_diff` | Show changes |
+| `git_add` | Stage files |
+| `git_commit` | Create commits |
+| `git_log` | Show commit history |
+| `git_checkout` | Switch branches |
+
+### Web Tools
+
+| Tool | Description |
+|------|-------------|
+| `web_search` | Search the web (Exa/DuckDuckGo) |
+| `web_answer` | AI-powered Q&A (requires Exa API key) |
+| `fetch_url` | Fetch URL content |
+
+### MCP Tools - Discovery
+
+| Tool | Description |
+|------|-------------|
+| `search_markets` | Search markets across Polymarket, Kalshi, Limitless |
+| `get_trending_markets` | Get trending/popular markets |
+| `get_market_details` | Get market info and prices |
+| `get_categories` | List available categories |
+| `get_market_stats` | Get platform statistics |
+
+### MCP Tools - Polymarket Trading
+
+| Tool | Description |
+|------|-------------|
+| `get_balances` | Check USDC and position balances |
+| `get_positions` | View current positions |
+| `place_order` | Place buy/sell orders |
+| `cancel_order` | Cancel open orders |
+| `get_orders` | List orders |
+| `get_orderbook` | Get market orderbook |
+| `get_price` | Get current price |
+| `transfer_usdc` | Transfer USDC |
+| `claim_winnings` | Claim from resolved markets |
+| `export_private_key` | Export wallet private key |
+
+### MCP Tools - Kalshi Trading
+
+| Tool | Description |
+|------|-------------|
+| `kalshi_signup` | Create new account with Solana wallet |
+| `kalshi_search_markets` | Search Kalshi markets |
+| `kalshi_get_market` | Get market details by ticker |
+| `kalshi_get_events` | Browse market categories |
+| `kalshi_get_live_data` | Get live market data |
+| `kalshi_get_quote` | Get quote for buy/sell order |
+| `kalshi_place_order` | Execute a trade on Solana |
+| `kalshi_get_wallet_info` | Get wallet address and balances |
+| `kalshi_get_positions` | View Kalshi positions |
+| `kalshi_check_market_initialization` | Check if market is tokenized |
+| `kalshi_initialize_market` | Initialize market on-chain |
+| `kalshi_check_redemption_status` | Check if market can be redeemed |
+| `kalshi_export_private_key` | Export Solana private key |
+
+## LLM Providers
+
+### Anthropic (Default for new installs)
+
+Uses Claude models directly via Anthropic API.
 
 ```bash
-quantish
+/model opus    # Claude Opus 4.5 - Most capable
+/model sonnet  # Claude Sonnet 4.5 - Balanced (default)
+/model haiku   # Claude Haiku 4.5 - Fastest/cheapest
 ```
 
-Example conversations:
+### OpenRouter
 
-```
-You: Create a trading bot that monitors Bitcoin markets and alerts on price changes
-Assistant: I'll create that for you. Let me first search for Bitcoin markets...
-[Calling search_markets...]
-[Writing bitcoin-monitor.js...]
+Access 100+ models from various providers.
 
-You: What's my current balance?
-Assistant: Your Safe wallet has 125.50 USDC available for trading.
+```bash
+/provider openrouter  # Switch to OpenRouter
 
-You: Place a $10 YES order on Trump winning at 55 cents
-Assistant: Order placed! Order ID: abc123...
+/model glm      # GLM-4.7 (default for OpenRouter) - Best for coding
+/model minimax  # MiniMax M2.1 - Fast and cheap
+/model deepseek # DeepSeek V3.2 - Great reasoning
+/model gemini   # Gemini 2.0 Flash - Google's latest
+/model grok     # Grok 3 Mini Beta - xAI
 ```
 
-**One-shot mode:**
-
+Or use any OpenRouter model ID:
 ```bash
-quantish -p "check my open orders"
+/model anthropic/claude-3.5-sonnet
+/model meta-llama/llama-3.3-70b-instruct
 ```
 
-## Commands
+## Configuration
 
-| Command | Description |
-|---------|-------------|
-| `quantish` | Start interactive chat |
-| `quantish init` | Configure API keys |
-| `quantish config` | View configuration |
-| `quantish config --server <url>` | Set custom MCP server URL |
-| `quantish config --export` | Export keys for standalone apps |
-| `quantish tools` | List available tools |
-| `quantish -p "..."` | Run one-shot prompt |
+Configuration is stored in `~/.quantish/config.json`.
 
-## Options
+### Environment Variables
 
-| Option | Description |
-|--------|-------------|
-| `-p, --prompt <message>` | Run a single prompt |
-| `-v, --verbose` | Show tool calls |
-| `--no-mcp` | Disable trading tools |
-| `--no-local` | Disable coding tools |
-| `--version` | Show version |
-| `--help` | Show help |
+| Variable | Description |
+|----------|-------------|
+| `ANTHROPIC_API_KEY` | Anthropic API key |
+| `OPENROUTER_API_KEY` | OpenRouter API key |
+| `QUANTISH_API_KEY` | Polymarket trading API key |
+| `KALSHI_API_KEY` | Kalshi trading API key |
+| `EXA_API_KEY` | Exa AI search key (optional) |
+| `MCP_SERVER_URL` | Custom Polymarket MCP server URL |
+| `KALSHI_MCP_URL` | Custom Kalshi MCP server URL |
 
-## Building Standalone Applications
+### Export Configuration
 
-The real power of Quantish is building standalone applications that interact with prediction markets. The agent can create trading bots, web dashboards, notification systems, and more.
+```bash
+quantish config --export > .env
+```
 
-### MCP API Overview
+## Building Applications
 
-There are two MCP endpoints:
+The agent can build standalone applications that use the Quantish MCP API. When building apps, ensure:
 
-| Endpoint | Purpose | Auth Required |
-|----------|---------|---------------|
-| Trading API | Wallet, orders, positions | Yes (QUANTISH_API_KEY) |
-| Discovery API | Search markets, prices | No (public key) |
+1. **Use HTTP API** - Don't use MCP SDK directly
+2. **Environment Variables** - Store API keys in `.env`
+3. **Three Endpoints**:
+   - Discovery: `https://quantish.live/mcp/execute` (public)
+   - Polymarket: `https://quantish-sdk-production.up.railway.app/mcp/execute` (requires `QUANTISH_API_KEY`)
+   - Kalshi: `https://kalshi-mcp-production-7c2c.up.railway.app/mcp` (requires `KALSHI_API_KEY`)
 
-### Trading API (Requires Your API Key)
+Example API calls:
 
 ```javascript
+// Discovery MCP (simple format)
+const response = await fetch('https://quantish.live/mcp/execute', {
+  method: 'POST',
+  headers: {
+    'Content-Type': 'application/json',
+    'X-API-Key': 'qm_ueQeqrmvZyHtR1zuVbLYkhx0fKyVAuV8'
+  },
+  body: JSON.stringify({
+    name: 'search_markets',
+    arguments: { query: 'bitcoin', limit: 5 }
+  })
+});
+
+// Polymarket Trading MCP (JSON-RPC format)
 const response = await fetch('https://quantish-sdk-production.up.railway.app/mcp/execute', {
   method: 'POST',
   headers: {
     'Content-Type': 'application/json',
-    'x-api-key': process.env.QUANTISH_API_KEY
+    'X-API-Key': process.env.QUANTISH_API_KEY
   },
   body: JSON.stringify({
     jsonrpc: '2.0',
+    id: 1,
     method: 'tools/call',
-    params: { name: 'get_balances', arguments: {} },
-    id: Date.now()
+    params: { name: 'get_positions', arguments: {} }
   })
 });
 
-const data = await response.json();
-const result = JSON.parse(data.result.content[0].text);
-```
-
-**Trading Tools:** `get_balances`, `get_positions`, `place_order`, `cancel_order`, `get_orders`, `get_orderbook`, `get_price`, `transfer_usdc`
-
-### Discovery API (Free, No Auth)
-
-```javascript
-const response = await fetch('https://quantish.live/mcp/execute', {
+// Kalshi Trading MCP (JSON-RPC format)
+const response = await fetch('https://kalshi-mcp-production-7c2c.up.railway.app/mcp', {
   method: 'POST',
   headers: {
     'Content-Type': 'application/json',
-    'X-API-Key': 'qm_ueQeqrmvZyHtR1zuVbLYkhx0fKyVAuV8'  // Public key
+    'X-API-Key': process.env.KALSHI_API_KEY
   },
   body: JSON.stringify({
-    name: 'search_markets',           // Simple format for Discovery
-    arguments: { query: 'bitcoin', limit: 5 }
+    jsonrpc: '2.0',
+    id: 1,
+    method: 'tools/call',
+    params: { name: 'kalshi_get_positions', arguments: {} }
   })
 });
-
-const data = await response.json();
-const result = JSON.parse(data.result.content[0].text);
 ```
 
-**Discovery Tools:** `search_markets`, `get_market_details`, `get_trending_markets`, `find_arbitrage`
+## Self-Hosting
+
+You can self-host your own Trading MCP servers for full control over your wallet keys.
 
-### Example: Ask the Agent to Build an App
+### Polymarket Server
 
 ```bash
-quantish
-> Create a Node.js script that monitors Bitcoin markets and sends a Discord notification when prices move more than 10%
+npm install @quantish/server
 ```
 
-The agent will create all necessary files:
-- Main application code with MCP helper functions
-- `package.json` with dependencies
-- `.env.example` with required environment variables
-- `README.md` with setup instructions
+```bash
+# Configure CLI to use your server
+export MCP_SERVER_URL=https://your-server.com/mcp
+```
+
+Resources:
+- **NPM**: [@quantish/server](https://www.npmjs.com/package/@quantish/server)
+- **GitHub**: [joinQuantish/quantish-server](https://github.com/joinQuantish/quantish-server)
+- **Polymarket API**: [docs.polymarket.com](https://docs.polymarket.com)
 
-## Architecture
+### Kalshi Server
 
+```bash
+npm install @quantish/kalshi-server
 ```
-quantish (CLI)
-    │
-    ├── Local Tools (filesystem, shell, git)
-    │   └── Runs directly on your machine
-    │
-    └── MCP Tools (trading + discovery)
-        ├── Trading MCP (your wallet, orders)
-        │   └── https://quantish-sdk-production.up.railway.app/mcp
-        │
-        └── Discovery MCP (public market data)
-            └── https://quantish.live/mcp
+
+```bash
+# Configure CLI to use your server
+export KALSHI_MCP_URL=https://your-kalshi-server.com/mcp
 ```
 
-## Self-Hosting
+Required environment variables for Kalshi server:
+- `DATABASE_URL` - PostgreSQL connection string
+- `ENCRYPTION_KEY` - 64-char hex string for wallet encryption
+- `DFLOW_API_KEY` - DFlow API key
+- `SOLANA_RPC_URL` - Solana RPC endpoint
 
-You can run your own Trading MCP server for full control over your wallet keys.
+Resources:
+- **NPM**: [@quantish/kalshi-server](https://www.npmjs.com/package/@quantish/kalshi-server)
+- **GitHub**: [joinQuantish/kalshi-mcp](https://github.com/joinQuantish/kalshi-mcp)
+- **DFlow Docs**: [docs.dflow.net](https://docs.dflow.net)
 
-### Configure Custom Server
+See the [Self-Hosting Guide](https://docs.quantish.live/self-hosting.html) for full deployment instructions.
 
-```bash
-# Set via CLI
-quantish config --server https://your-server.com/mcp
+## Platform Support
 
-# Or via environment variable
-export MCP_SERVER_URL=https://your-server.com/mcp
-```
+| Platform | Support |
+|----------|---------|
+| macOS | ✅ Full support |
+| Linux | ✅ Full support |
+| Windows | ⚠️ Requires WSL |
 
-### What You Need
+## Examples
 
-1. **Server**: Deploy the `quantish-server` to Railway, Render, or your own VPS
-2. **Database**: PostgreSQL for user data and encrypted keys
-3. **Polymarket Builder Credentials**: Apply at https://polymarket.com/builder
+```bash
+# Search for markets (both Polymarket and Kalshi)
+quantish -p "find markets about bitcoin"
 
-See [Self-Hosting Guide](https://quantish.live/docs/self-hosting.html) for full instructions.
+# Check Polymarket positions
+quantish -p "show my Polymarket positions with P&L"
 
-## Configuration
+# Check Kalshi positions
+quantish -p "show my Kalshi positions"
+
+# Create a Kalshi account
+quantish
+> Create a Kalshi account for me
+
+# Trade on Kalshi
+quantish
+> Buy $10 of YES on the next Fed rate decision market on Kalshi
 
-Configuration is stored in `~/.quantish/config.json`:
+# Build a trading bot
+quantish
+> Create a bot that monitors Trump markets and alerts me when prices change more than 5%
 
-```json
-{
-  "anthropicApiKey": "sk-ant-...",
-  "quantishApiKey": "qtsh_...",
-  "mcpServerUrl": "https://quantish-sdk-production.up.railway.app/mcp",
-  "model": "claude-sonnet-4-5-20250929"
-}
+# Code review
+quantish
+> Review my trading bot code and suggest improvements
 ```
 
-Environment variables take precedence:
-- `ANTHROPIC_API_KEY`
-- `QUANTISH_API_KEY`
-- `MCP_SERVER_URL`
+## Troubleshooting
 
-## Available Tools
+### Tool calls failing with malformed arguments
 
-### Local Tools (Coding)
+Some OpenRouter models (like GLM-4.7) occasionally emit malformed tool calls. The CLI includes robust parsing to handle these, but if issues persist:
 
-| Tool | Description |
-|------|-------------|
-| `read_file` | Read file contents |
-| `write_file` | Write/create files |
-| `edit_file` | Search and replace in files |
-| `list_dir` | List directory contents |
-| `delete_file` | Delete files |
-| `setup_env` | Create/update .env files |
-| `run_command` | Execute shell commands |
-| `grep` | Search file contents |
-| `find_files` | Find files by pattern |
-| `git_status` | Get git status |
-| `git_diff` | Show git diff |
-| `git_add` | Stage files |
-| `git_commit` | Create commits |
+```bash
+/model sonnet  # Switch to Claude Sonnet
+```
 
-### MCP Tools (Trading)
+### Session not resuming
 
-| Tool | Description |
-|------|-------------|
-| `get_balances` | Check wallet balances |
-| `get_positions` | View current positions |
-| `place_order` | Place buy/sell orders |
-| `cancel_order` | Cancel open orders |
-| `get_orders` | List orders |
-| `get_orderbook` | Get market orderbook |
-| `get_price` | Get current price |
-| `transfer_usdc` | Transfer USDC |
+Sessions are stored in `~/.quantish/sessions/`. To reset:
 
-### MCP Tools (Discovery)
+```bash
+rm -rf ~/.quantish/sessions
+```
 
-| Tool | Description |
-|------|-------------|
-| `search_markets` | Search markets by keyword |
-| `get_market_details` | Get full market info |
-| `get_trending_markets` | Popular markets |
-| `find_arbitrage` | Find price discrepancies |
+### High token usage
 
-## Platform Support
+```bash
+/compact       # Summarize conversation
+/model haiku   # Switch to cheaper model
+/clear         # Start fresh
+```
 
-| Platform | Support |
-|----------|---------|
-| macOS | ✅ Full support |
-| Linux | ✅ Full support |
-| Windows | ⚠️ Requires WSL |
+## Development
 
-**Windows users:** Install [WSL](https://learn.microsoft.com/en-us/windows/wsl/install) and run Quantish from within WSL.
+```bash
+git clone https://github.com/joinQuantish/quantish-agent
+cd quantish-agent
+npm install
+npm run build
+npm link  # Install locally
+```
 
-## How It Works
+## License
 
-Quantish CLI connects to the **Quantish Signing Server** to execute trades on Polymarket:
+This project is licensed under the [PolyForm Noncommercial License 1.0.0](https://polyformproject.org/licenses/noncommercial/1.0.0/).
 
-- **Your funds are secure** - Only you can authorize transactions via your API key
-- **Wallets are non-custodial** - Export your private key anytime with `export_private_key`
-- **Trading is free** - No gas fees (Polymarket covers them)
-- **Self-hosting available** - Run your own server for full control
+**Free for personal use, research, and non-commercial purposes.** Commercial use requires explicit permission from Quantish Inc. Contact hello@quantish.live for commercial licensing.
 
-## License
+## Links
 
-MIT
+- [Agent Website](https://agent.quantish.live)
+- [GitHub](https://github.com/joinQuantish/quantish-agent)
+- [NPM](https://www.npmjs.com/package/@quantish/agent)
+- [Documentation](https://docs.quantish.live)
+- [Quantish Platform](https://quantish.live)

package/dist/index.js

@@ -846,9 +846,13 @@ async function runSetup() {
       if (result.success && typeof result.data === "object" && result.data !== null) {
         const data = result.data;
         console.log(chalk.green("\u2713 Polymarket MCP connected"));
-        console.log(chalk.dim(`  Safe Address: ${data.safeAddress || "Not yet deployed"}`));
-        console.log(chalk.dim(`  Status: ${data.status}`));
-        console.log(chalk.dim(`  Ready to trade: ${data.isReady ? "Yes" : "Run setup_wallet first"}`));
+        if (data.safeAddress) {
+          console.log(chalk.dim(`  Safe Address: ${data.safeAddress}`));
+          console.log(chalk.dim(`  Status: READY`));
+        } else {
+          console.log(chalk.dim(`  Safe Address: Will deploy on first trade`));
+          console.log(chalk.dim(`  Status: CREATED (wallet ready, Safe deploys on first trade)`));
+        }
       } else {
         console.log(chalk.yellow("\u26A0 Polymarket MCP: " + (result.error || "Unknown error")));
       }
@@ -865,8 +869,13 @@ async function runSetup() {
       const result = await kalshiClient.callTool("kalshi_get_wallet_info", {});
       if (result.success && typeof result.data === "object" && result.data !== null) {
         const data = result.data;
+        const wallet = data.wallet;
+        const publicKey = wallet?.publicKey;
         console.log(chalk.green("\u2713 Kalshi MCP connected"));
-        console.log(chalk.dim(`  Solana Address: ${data.publicKey || "Unknown"}`));
+        console.log(chalk.dim(`  Solana Address: ${publicKey || "No wallet yet"}`));
+        if (wallet) {
+          console.log(chalk.dim(`  Status: READY`));
+        }
       } else {
         console.log(chalk.yellow("\u26A0 Kalshi MCP: " + (result.error || "Unknown error")));
       }
@@ -5443,7 +5452,7 @@ Stopped ${count} background process${count > 1 ? "es" : ""}.`);
 }
 
 // src/index.ts
-var VERSION = "0.1.25";
+var VERSION = "0.1.29";
 function cleanup() {
   if (processManager.hasRunning()) {
     const count = processManager.runningCount();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@quantish/agent",
-  "version": "0.1.27",
+  "version": "0.1.29",
   "description": "AI-powered agent for trading on Polymarket and Kalshi",
   "type": "module",
   "bin": {