@quantish/agent 0.1.6 → 0.1.8

package/README.md

@@ -1,45 +1,19 @@
-# @quantish/cli
+# @quantish/agent
 
-AI-powered CLI agent for building trading bots on Polymarket.
+AI-powered CLI agent for building trading bots and applications on Polymarket.
 
 Combines **coding tools** (file system, shell, git) with **trading tools** (Polymarket orders, positions, wallet) powered by Claude AI.
 
-## How It Works
-
-Quantish CLI connects to the **Quantish Signing Server** to execute trades on Polymarket. Here's why:
-
-### Why We Use a Signing Server
-
-Polymarket uses a **gasless relayer system** - this means:
-- ✅ **Free wallet creation** - No MATIC needed to set up
-- ✅ **Free trading** - Polymarket covers gas fees on all transactions
-- ✅ **Simplified signing** - Our server handles the complex signature formats
-
-To make this work reliably, the Quantish Signing Server:
-1. **Handles wallet creation** - Your wallet is created and managed through our server
-2. **Signs transactions** - Orders are signed using Polymarket's required format
-3. **Relays to Polymarket** - Transactions go through Polymarket's official relayer
-4. **Bypasses geo-restrictions** - Our server is hosted in a compatible region
-
-### What This Means for You
-
-- **Your funds are secure** - Only you can authorize transactions via your API key
-- **Wallets are non-custodial** - You can export your private key anytime with `export_private_key`
-- **Trading is free** - No gas fees, ever
-- **It just works** - No VPN or complex setup needed
-
-> 🔒 **Security Note**: Your private keys are stored encrypted. You can export them and migrate to a self-hosted solution in the future if needed.
-
 ## Installation
 
 ```bash
-npm install -g @quantish/cli
+npm install -g @quantish/agent
 ```
 
 Or run directly with npx:
 
 ```bash
-npx @quantish/cli
+npx @quantish/agent
 ```
 
 ## Quick Start
@@ -67,15 +41,15 @@ quantish
 Example conversations:
 
 ```
-You: Create a trading bot that monitors my positions and sells when profit > 20%
-Assistant: I'll create that for you. Let me first check your current positions...
-[Calling get_positions...]
-[Writing bot.ts...]
+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...]
 
 You: What's my current balance?
-Assistant: Your Safe wallet has 0.68 USDC available for trading.
+Assistant: Your Safe wallet has 125.50 USDC available for trading.
 
-You: Place a $5 YES order on Trump winning at 55 cents
+You: Place a $10 YES order on Trump winning at 55 cents
 Assistant: Order placed! Order ID: abc123...
 ```
 
@@ -85,12 +59,6 @@ Assistant: Order placed! Order ID: abc123...
 quantish -p "check my open orders"
 ```
 
-**Piped input:**
-
-```bash
-echo "show my positions" | quantish
-```
-
 ## Commands
 
 | Command | Description |
@@ -98,6 +66,8 @@ echo "show my positions" | quantish
 | `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 |
 
@@ -112,124 +82,173 @@ echo "show my positions" | quantish
 | `--version` | Show version |
 | `--help` | Show help |
 
-## Available Tools
+## Building Standalone Applications
 
-### Local Tools (Coding)
+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.
 
-| Tool | Description |
-|------|-------------|
-| `read_file` | Read file contents |
-| `write_file` | Write/create files |
-| `list_dir` | List directory contents |
-| `delete_file` | Delete files |
-| `file_exists` | Check if file exists |
-| `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 |
-| `git_log` | Show commit history |
-| `git_checkout` | Switch branches |
-| `web_search` | Search the web (Exa/DuckDuckGo) |
-| `web_answer` | AI-powered Q&A (Exa) |
-| `fetch_url` | Fetch URL content |
+### MCP API Overview
 
-### MCP Tools (Trading)
+There are two MCP endpoints:
 
-| 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 |
-| `swap_tokens` | Swap tokens |
-| `claim_winnings` | Claim from resolved markets |
+| Endpoint | Purpose | Auth Required |
+|----------|---------|---------------|
+| Trading API | Wallet, orders, positions | Yes (QUANTISH_API_KEY) |
+| Discovery API | Search markets, prices | No (public key) |
 
-## Configuration
+### Trading API (Requires Your API Key)
 
-Configuration is stored in `~/.quantish/config.json`:
+```javascript
+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
+  },
+  body: JSON.stringify({
+    jsonrpc: '2.0',
+    method: 'tools/call',
+    params: { name: 'get_balances', arguments: {} },
+    id: Date.now()
+  })
+});
 
-```json
-{
-  "anthropicApiKey": "sk-ant-...",
-  "quantishApiKey": "pk_live_...",
-  "mcpServerUrl": "https://quantish-sdk-production.up.railway.app/mcp"
-}
+const data = await response.json();
+const result = JSON.parse(data.result.content[0].text);
 ```
 
-Environment variables take precedence:
-- `ANTHROPIC_API_KEY`
-- `QUANTISH_API_KEY`
+**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', {
+  method: 'POST',
+  headers: {
+    'Content-Type': 'application/json',
+    'X-API-Key': 'qm_ueQeqrmvZyHtR1zuVbLYkhx0fKyVAuV8'  // Public key
+  },
+  body: JSON.stringify({
+    name: 'search_markets',           // Simple format for Discovery
+    arguments: { query: 'bitcoin', limit: 5 }
+  })
+});
+
+const data = await response.json();
+const result = JSON.parse(data.result.content[0].text);
+```
 
-## Examples
+**Discovery Tools:** `search_markets`, `get_market_details`, `get_trending_markets`, `find_arbitrage`
 
-### Build a Trading Bot
+### Example: Ask the Agent to Build an App
 
 ```bash
 quantish
-> Create a Python script that monitors the Trump market and alerts me when price drops below 40 cents
+> Create a Node.js script that monitors Bitcoin markets and sends a Discord notification when prices move more than 10%
 ```
 
-### Manage Positions
+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
+
+## Architecture
 
-```bash
-quantish -p "show me my positions with unrealized P&L"
+```
+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
 ```
 
-### Market Making
+## Self-Hosting
 
-```bash
-quantish
-> Help me set up a basic market making strategy. I want to place both bid and ask orders around the current mid price.
-```
+You can run your own Trading MCP server for full control over your wallet keys.
 
-### Code Review
+### Configure Custom Server
 
 ```bash
-quantish
-> Read my trading bot code in bot.ts and suggest improvements
+# Set via CLI
+quantish config --server https://your-server.com/mcp
+
+# Or via environment variable
+export MCP_SERVER_URL=https://your-server.com/mcp
 ```
 
-## Development
+### What You Need
 
-```bash
-# Clone the repo
-git clone https://github.com/quantish/cli
+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
 
-# Install dependencies
-cd packages/quantish-cli
-npm install
+See [Self-Hosting Guide](https://quantish.live/docs/self-hosting.html) for full instructions.
 
-# Build
-npm run build
+## Configuration
 
-# Run locally
-npm start
+Configuration is stored in `~/.quantish/config.json`:
 
-# Development mode (watch)
-npm run dev
+```json
+{
+  "anthropicApiKey": "sk-ant-...",
+  "quantishApiKey": "qtsh_...",
+  "mcpServerUrl": "https://quantish-sdk-production.up.railway.app/mcp",
+  "model": "claude-sonnet-4-5-20250929"
+}
 ```
 
-## Architecture
+Environment variables take precedence:
+- `ANTHROPIC_API_KEY`
+- `QUANTISH_API_KEY`
+- `MCP_SERVER_URL`
 
-```
-quantish (CLI)
-    │
-    ├── Local Tools (filesystem, shell, git)
-    │   └── Runs directly on your machine
-    │
-    └── MCP Tools (trading)
-        └── Calls Quantish MCP Server
-            └── Executes on Polymarket
-```
+## Available Tools
+
+### Local Tools (Coding)
+
+| 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 |
+
+### MCP Tools (Trading)
+
+| 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 |
 
-The agent uses Claude to understand your requests and decide which tools to use. It can combine coding and trading tools in a single conversation.
+### MCP Tools (Discovery)
+
+| 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 |
 
 ## Platform Support
 
@@ -239,23 +258,16 @@ The agent uses Claude to understand your requests and decide which tools to use.
 | Linux | ✅ Full support |
 | Windows | ⚠️ Requires WSL |
 
-**Windows users:** Install [WSL (Windows Subsystem for Linux)](https://learn.microsoft.com/en-us/windows/wsl/install) and run Quantish from within WSL. Native Windows (PowerShell/cmd.exe) is not supported.
-
-## Environment Variables
-
-| Variable | Description |
-|----------|-------------|
-| `ANTHROPIC_API_KEY` | Your Anthropic API key (required) |
-| `QUANTISH_API_KEY` | Your Quantish trading API key |
-| `EXA_API_KEY` | Optional: Exa AI search key for powerful web search |
+**Windows users:** Install [WSL](https://learn.microsoft.com/en-us/windows/wsl/install) and run Quantish from within WSL.
 
-### Web Search
-
-Web search works without API keys (using DuckDuckGo fallback), but **Exa is strongly recommended** for AI-quality search results.
+## How It Works
 
-Get your Exa API key at: https://dashboard.exa.ai
+Quantish CLI connects to the **Quantish Signing Server** to execute trades on Polymarket:
 
-Exa is the same search engine used by Cursor, Notion, Vercel, and other leading AI products.
+- **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
 
 ## License
 

package/dist/index.js

@@ -27,7 +27,7 @@ var schema = {
   },
   model: {
     type: "string",
-    default: "claude-sonnet-4-5-20250929"
+    default: "claude-sonnet-4-20250514"
   }
 };
 var ConfigManager = class {
@@ -70,8 +70,11 @@ var ConfigManager = class {
   }
   /**
    * Get the Trading MCP server URL (user's wallet/orders)
+   * Priority: MCP_SERVER_URL env var > config file > default
    */
   getMcpServerUrl() {
+    const envUrl = process.env.MCP_SERVER_URL;
+    if (envUrl) return envUrl;
     return this.conf.get("mcpServerUrl") ?? DEFAULT_MCP_URL;
   }
   /**
@@ -98,11 +101,17 @@ var ConfigManager = class {
   setMcpServerUrl(url) {
     this.conf.set("mcpServerUrl", url);
   }
+  /**
+   * Generic setter for any config key
+   */
+  set(key, value) {
+    this.conf.set(key, value);
+  }
   /**
    * Get the model to use
    */
   getModel() {
-    return this.conf.get("model") ?? "claude-sonnet-4-5-20250929";
+    return this.conf.get("model") ?? "claude-sonnet-4-20250514";
   }
   /**
    * Set the model to use
@@ -2278,7 +2287,7 @@ function parseCompactedSummary(response) {
   }
   return response.trim() || null;
 }
-async function createCompactedSummary(anthropic, history, model = "claude-sonnet-4-5-20250929", customPrompt) {
+async function createCompactedSummary(anthropic, history, model = "claude-sonnet-4-20250514", customPrompt) {
   const prompt2 = customPrompt || COMPACTION_PROMPT;
   const compactionMessages = [
     ...history,
@@ -2322,7 +2331,7 @@ async function compactConversation(anthropic, history, model, systemPrompt, tool
     const contentLength = JSON.stringify(history).length;
     originalTokens = Math.ceil(contentLength / 4);
   }
-  const summaryModel = "claude-sonnet-4-5-20250929";
+  const summaryModel = "claude-sonnet-4-20250514";
   const summary = await createCompactedSummary(anthropic, history, summaryModel);
   const newHistory = historyFromSummary(summary);
   let newTokens = 0;
@@ -2348,25 +2357,25 @@ async function compactConversation(anthropic, history, model, systemPrompt, tool
 
 // src/agent/pricing.ts
 var MODELS = {
-  "claude-opus-4-5-20250929": {
-    id: "claude-opus-4-5-20250929",
-    name: "opus-4.5",
-    displayName: "Claude Opus 4.5",
+  "claude-opus-4-20250514": {
+    id: "claude-opus-4-20250514",
+    name: "opus-4",
+    displayName: "Claude Opus 4",
     pricing: {
-      inputPerMTok: 5,
-      outputPerMTok: 25,
-      cacheWritePerMTok: 6.25,
+      inputPerMTok: 15,
+      outputPerMTok: 75,
+      cacheWritePerMTok: 18.75,
       // 1.25x input
-      cacheReadPerMTok: 0.5
+      cacheReadPerMTok: 1.5
       // 0.1x input
     },
     contextWindow: 2e5,
     description: "Most capable model. Best for complex reasoning and creative tasks."
   },
-  "claude-sonnet-4-5-20250929": {
-    id: "claude-sonnet-4-5-20250929",
-    name: "sonnet-4.5",
-    displayName: "Claude Sonnet 4.5",
+  "claude-sonnet-4-20250514": {
+    id: "claude-sonnet-4-20250514",
+    name: "sonnet-4",
+    displayName: "Claude Sonnet 4",
     pricing: {
       inputPerMTok: 3,
       outputPerMTok: 15,
@@ -2378,30 +2387,30 @@ var MODELS = {
     contextWindow: 2e5,
     description: "Balanced performance and cost. Great for most coding and trading tasks."
   },
-  "claude-haiku-4-5-20250929": {
-    id: "claude-haiku-4-5-20250929",
-    name: "haiku-4.5",
-    displayName: "Claude Haiku 4.5",
+  "claude-3-5-haiku-20241022": {
+    id: "claude-3-5-haiku-20241022",
+    name: "haiku-3.5",
+    displayName: "Claude Haiku 3.5",
     pricing: {
-      inputPerMTok: 1,
-      outputPerMTok: 5,
-      cacheWritePerMTok: 1.25,
+      inputPerMTok: 0.8,
+      outputPerMTok: 4,
+      cacheWritePerMTok: 1,
       // 1.25x input
-      cacheReadPerMTok: 0.1
+      cacheReadPerMTok: 0.08
       // 0.1x input
     },
     contextWindow: 2e5,
     description: "Fastest and most economical. Good for simple tasks and high volume."
   }
 };
-var DEFAULT_MODEL = "claude-sonnet-4-5-20250929";
+var DEFAULT_MODEL = "claude-sonnet-4-20250514";
 var MODEL_ALIASES = {
-  "opus": "claude-opus-4-5-20250929",
-  "opus-4.5": "claude-opus-4-5-20250929",
-  "sonnet": "claude-sonnet-4-5-20250929",
-  "sonnet-4.5": "claude-sonnet-4-5-20250929",
-  "haiku": "claude-haiku-4-5-20250929",
-  "haiku-4.5": "claude-haiku-4-5-20250929"
+  "opus": "claude-opus-4-20250514",
+  "opus-4": "claude-opus-4-20250514",
+  "sonnet": "claude-sonnet-4-20250514",
+  "sonnet-4": "claude-sonnet-4-20250514",
+  "haiku": "claude-3-5-haiku-20241022",
+  "haiku-3.5": "claude-3-5-haiku-20241022"
 };
 function resolveModelId(nameOrAlias) {
   const lower = nameOrAlias.toLowerCase();
@@ -3174,7 +3183,7 @@ var Agent = class {
    */
   async run(userMessage, options) {
     const maxIterations = this.config.maxIterations ?? 15;
-    const model = this.config.model ?? "claude-sonnet-4-5-20250929";
+    const model = this.config.model ?? "claude-sonnet-4-20250514";
     const maxTokens = this.config.maxTokens ?? 8192;
     const systemPrompt = this.config.systemPrompt ?? DEFAULT_SYSTEM_PROMPT;
     const useStreaming = this.config.streaming ?? true;
@@ -3434,7 +3443,7 @@ ${userMessage}`;
    * Count tokens in current conversation (uses Anthropic's token counting API)
    */
   async countTokens() {
-    const model = this.config.model ?? "claude-sonnet-4-5-20250929";
+    const model = this.config.model ?? "claude-sonnet-4-20250514";
     const systemPrompt = this.config.systemPrompt ?? DEFAULT_SYSTEM_PROMPT;
     const allTools = await this.getAllTools();
     try {
@@ -3505,7 +3514,7 @@ ${userMessage}`;
    * @returns Object with original/new token counts and the summary
    */
   async compactHistory() {
-    const model = this.config.model ?? "claude-sonnet-4-5-20250929";
+    const model = this.config.model ?? "claude-sonnet-4-20250514";
     const systemPrompt = this.config.systemPrompt ?? DEFAULT_SYSTEM_PROMPT;
     const allTools = await this.getAllTools();
     if (this.conversationHistory.length < 2) {
@@ -4206,8 +4215,19 @@ program.name("quantish").description("AI coding & trading agent for Polymarket")
 program.command("init").description("Configure Quantish CLI with your API keys").action(async () => {
   await runSetup();
 });
-program.command("config").description("View or edit configuration").option("-s, --show", "Show current configuration").option("-c, --clear", "Clear all configuration").option("--path", "Show config file path").option("--export", "Export configuration as .env format").option("--show-keys", "Show full API keys (use with caution)").action(async (options) => {
+program.command("config").description("View or edit configuration").option("-s, --show", "Show current configuration").option("-c, --clear", "Clear all configuration").option("--path", "Show config file path").option("--export", "Export configuration as .env format").option("--show-keys", "Show full API keys (use with caution)").option("--server <url>", "Set custom Trading MCP server URL").action(async (options) => {
   const config = getConfigManager();
+  if (options.server) {
+    try {
+      new URL(options.server);
+    } catch {
+      error("Invalid URL format. Please provide a valid URL (e.g., https://your-server.com/mcp)");
+      return;
+    }
+    config.set("mcpServerUrl", options.server);
+    success(`Trading MCP server URL set to: ${options.server}`);
+    return;
+  }
   if (options.path) {
     console.log(config.getConfigPath());
     return;
@@ -4230,7 +4250,7 @@ program.command("config").description("View or edit configuration").option("-s,
       console.log(`QUANTISH_API_KEY=${all2.quantishApiKey}`);
     }
     console.log(`QUANTISH_MCP_URL=${all2.mcpServerUrl}`);
-    console.log(`QUANTISH_MODEL=${all2.model || "claude-sonnet-4-5-20250929"}`);
+    console.log(`QUANTISH_MODEL=${all2.model || "claude-sonnet-4-20250514"}`);
     console.log();
     console.log(chalk3.dim("# Discovery MCP (public, read-only market data)"));
     console.log(`QUANTISH_DISCOVERY_URL=https://quantish.live/mcp`);
@@ -4251,7 +4271,7 @@ program.command("config").description("View or edit configuration").option("-s,
     tableRow("Quantish API Key", all.quantishApiKey ? `${all.quantishApiKey.slice(0, 12)}...` : chalk3.dim("Not set"));
   }
   tableRow("MCP Server URL", all.mcpServerUrl);
-  tableRow("Model", all.model || "claude-sonnet-4-5-20250929");
+  tableRow("Model", all.model || "claude-sonnet-4-20250514");
   printDivider();
   console.log(chalk3.dim(`Config file: ${config.getConfigPath()}`));
   console.log();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@quantish/agent",
-  "version": "0.1.6",
+  "version": "0.1.8",
   "description": "AI-powered agent for building trading bots on Polymarket",
   "type": "module",
   "bin": {