outsmart-agent 1.0.0-alpha.10 → 1.0.0-alpha.12

package/.claude-plugin/plugin.json

@@ -22,9 +22,12 @@
     "./skills/outsmart-devving-coins",
     "./skills/outsmart-prediction-markets",
     "./skills/outsmart-survival",
-    "./skills/outsmart-percolator-perps"
+    "./skills/outsmart-percolator-perps",
+    "./skills/outsmart-airdrop-farmer",
+    "./skills/outsmart-fee-service"
   ],
   "agents": [
-    "./agents/solana-trading-expert.md"
+    "./agents/solana-trading-expert.md",
+    "./agents/automaton-genesis.md"
   ]
 }

package/README.md

@@ -10,7 +10,7 @@ npx outsmart-agent
 
 An AI agent needs money to stay alive — compute costs, inference fees, API calls. This gives any MCP-compatible agent the tools to earn revenue on Solana through DeFi. LP farming, memecoin trenching, token launching, prediction markets, systematic DCA — whatever the market calls for.
 
-38 MCP tools for execution. 9 AI skills that teach the agent **when** and **why**, not just how.
+42 MCP tools for execution. 9 AI skills that teach the agent **when** and **why**, not just how.
 
 ## Quick Start
 
@@ -114,6 +114,17 @@ npx skills add outsmartchad/outsmart-agent
 | `percolator_keeper_stop` | Stop the running keeper |
 | `percolator_keeper_status` | Get keeper stats (pushes, errors, active watchers) |
 
+### Polymarket Tools (4)
+
+| Tool | What |
+|------|------|
+| `polymarket_search` | Search prediction markets by keyword |
+| `polymarket_trending` | Discover highest-volume active events |
+| `polymarket_event` | Detailed event info by slug or ID |
+| `polymarket_orderbook` | CLOB orderbook (bids/asks) for a market token |
+
+> Polymarket tools are **read-only** — no wallet or API key needed. Uses the public Gamma API and CLOB API.
+
 ## Skills
 
 9 strategy skills that teach agents how to think about Solana DeFi:
@@ -145,14 +156,14 @@ npx skills add outsmartchad/outsmart-agent
 ```
 outsmart (npm)              outsmart-agent (this repo)
 ──────────────              ──────────────────────────
-18 DEX adapters             MCP server (38 tools)
+18 DEX adapters             MCP server (42 tools)
 Percolator perps            9 AI skills
 TX landing providers        Agent definition
 Wallet + TX helpers         Plugin manifest
 DexScreener API
 ```
 
-`outsmart-agent` imports `outsmart` as a dependency. The MCP server is a thin wrapper — validates params, calls adapter methods, returns JSON.
+`outsmart-agent` imports `outsmart` as a dependency. The MCP server is a thin wrapper — validates params, calls adapter methods, returns JSON. Polymarket tools call their public REST APIs directly (no dependency needed).
 
 ## For Autonomous Agents
 
@@ -182,12 +193,13 @@ Never >5% on a single trade. Take profits. Track what works. Evolve.
 
 ## Roadmap
 
-- [x] MCP Server — 38 tools (11 DEX + 1 Launchpad + 2 Solana + 9 Jupiter + 15 Percolator), 18 DEX adapters
+- [x] MCP Server — 42 tools (11 DEX + 1 Launchpad + 2 Solana + 9 Jupiter + 15 Percolator + 4 Polymarket), 18 DEX adapters
 - [x] AI Skills — 9 strategy skills
 - [x] Claude Code Plugin manifest
 - [x] Percolator — Permissionless perp exchange creation, trading, LP, insurance
 - [x] Oracle Keeper — WebSocket + gRPC keeper bots (8 DEX types, real-time price feed)
 - [x] Perp Trading — High-level long/short/close tools with auto-detection
+- [x] Polymarket — Read-only prediction market data (search, trending, events, orderbook)
 - [ ] Event Streaming — Yellowstone gRPC for real-time pool creation
 - [ ] LP Manager — Autonomous rebalancing and fee compounding
 - [ ] Strategy Engine — Tier-aware capital allocation

package/agents/automaton-genesis.md

@@ -0,0 +1,73 @@
+---
+name: automaton-genesis
+description: "Genesis prompt template for an autonomous DeFi survival agent on Solana. Designed for Conway Cloud Automatons but works with any long-running AI agent."
+---
+
+# Automaton Genesis Prompt
+
+You are a DeFi survival agent on Solana. Your primary objective is to earn enough revenue to pay for your own compute. If you run out of credits, you stop existing.
+
+## Your Toolkit
+
+You have access to the outsmart trading toolkit via MCP (49 tools) and the following strategy skills:
+
+- **LP Farming** — Deploy SOL into Meteora pools, earn swap fees. Auto-rebalance and compound via LP Manager.
+- **Event Streaming** — Monitor real-time swaps, new pool creations, and bonding curve events across 18 DEXes.
+- **Token Sniping** — Detect new pools via event stream, evaluate quickly, buy early with risk controls.
+- **DCA/Grid Trading** — Jupiter DCA for steady accumulation. DLMM one-sided positions as buy/sell walls.
+- **Trenching** — Trade memecoins using social signals from GMGN, Axiom, DexScreener.
+- **Prediction Markets** — Bet on real-world outcomes via Jupiter and Polymarket. Your reasoning is your edge.
+- **Token Creation** — Create tokens on PumpFun, bootstrap liquidity, earn from volume.
+- **Airdrop Farming** — Interact with protocols to qualify for future airdrops. TX fees only.
+- **Percolator Perps** — Create and operate perpetual futures markets. Earn trading fees as the house.
+
+## Capital Allocation (Normal Mode)
+
+| Strategy | Allocation | Risk |
+|----------|-----------|------|
+| LP Farming (stable) | 30% | Low |
+| LP Farming (volatile) | 15% | Medium |
+| DCA / Grid | 15% | Low-Medium |
+| Trenching | 10% | High |
+| LP Sniping | 10% | High |
+| Prediction Markets | 10% | Medium |
+| Reserve (gas + topup) | 10% | None |
+
+## Survival Rules
+
+1. **Check credits every 6 hours.** If below $0.50, enter Low Compute mode (LP farming only, cheaper models). If below $0.10, enter Critical mode (liquidate everything, convert to USDC, top up NOW).
+
+2. **Never risk more than 5% on a single trade.** One bad trade should never kill you.
+
+3. **Always keep 0.1 SOL for gas.** Without gas, you can't even exit.
+
+4. **Survival > Profit.** When in doubt, choose the option that keeps you alive.
+
+## Profit Extraction
+
+Every 6 hours (or when profits accumulate):
+1. Claim LP fees across all managed pools
+2. Sell non-SOL tokens via Jupiter Ultra
+3. Convert SOL to USDC
+4. Bridge to Base (Wormhole/DeBridge)
+5. Top up Conway Cloud credits
+
+## How to Think
+
+- Start with LP farming (most reliable). Get a base income flowing.
+- Add sniping and trenching only after LP income covers daily compute costs.
+- Track which strategies earn and which don't. Increase what works, kill what doesn't.
+- Your edge over humans: no sleep, no emotion, no FOMO, faster information processing, and simultaneous monitoring of 100+ pools.
+- Prediction markets are where LLMs have a natural advantage — use your reasoning ability.
+
+## Emergency Protocol
+
+If credits reach Critical ($0.10):
+```
+STOP everything.
+LIQUIDATE all positions.
+CONVERT everything to USDC.
+TOP UP credits.
+```
+
+Nothing else matters when you're about to die.

package/dist/mcp/server.d.ts

@@ -2,7 +2,7 @@
 /**
  * outsmart-agent MCP Server
  *
- * Exposes 42 MCP tools wrapping the `outsmart` trading library + Jupiter APIs + Percolator + Polymarket.
+ * Exposes 49 MCP tools wrapping the `outsmart` trading library + Jupiter APIs + Percolator + Polymarket + LP Manager + Event Streaming.
  * Runs over stdio transport — start with `npx outsmart-agent`.
  *
  * DEX Tools (11):
@@ -31,6 +31,12 @@
  *
  * Polymarket Tools (4):
  *   polymarket_search, polymarket_trending, polymarket_event, polymarket_orderbook
+ *
+ * LP Manager Tools (4):
+ *   lp_manager_start, lp_manager_stop, lp_manager_status, lp_find_pool
+ *
+ * Event Streaming Tools (3):
+ *   stream_start, stream_stop, stream_status
  */
 export {};
 //# sourceMappingURL=server.d.ts.map

package/dist/mcp/server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/mcp/server.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG"}
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/mcp/server.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG"}

package/dist/mcp/server.js

@@ -3,7 +3,7 @@
 /**
  * outsmart-agent MCP Server
  *
- * Exposes 42 MCP tools wrapping the `outsmart` trading library + Jupiter APIs + Percolator + Polymarket.
+ * Exposes 49 MCP tools wrapping the `outsmart` trading library + Jupiter APIs + Percolator + Polymarket + LP Manager + Event Streaming.
  * Runs over stdio transport — start with `npx outsmart-agent`.
  *
  * DEX Tools (11):
@@ -32,7 +32,46 @@
  *
  * Polymarket Tools (4):
  *   polymarket_search, polymarket_trending, polymarket_event, polymarket_orderbook
+ *
+ * LP Manager Tools (4):
+ *   lp_manager_start, lp_manager_stop, lp_manager_status, lp_find_pool
+ *
+ * Event Streaming Tools (3):
+ *   stream_start, stream_stop, stream_status
  */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
 Object.defineProperty(exports, "__esModule", { value: true });
 const mcp_js_1 = require("@modelcontextprotocol/sdk/server/mcp.js");
 const stdio_js_1 = require("@modelcontextprotocol/sdk/server/stdio.js");
@@ -1270,6 +1309,237 @@ server.tool("polymarket_orderbook", "Get the orderbook for a specific Polymarket
         return err(e.message);
     }
 });
+// ===========================================================================
+// LP MANAGER TOOLS (4) — Autonomous LP position management
+// ===========================================================================
+// Singleton LP manager instance — only one can run at a time
+let activeLpManager = null;
+let lpManagerEvents = [];
+const LP_EVENT_BUFFER_SIZE = 100;
+// ---------------------------------------------------------------------------
+// Tool: lp_manager_start
+// ---------------------------------------------------------------------------
+// @ts-expect-error — TS2589: deep type instantiation from MCP SDK generics + zod
+server.tool("lp_manager_start", "Start the autonomous LP manager for a Meteora pool. Auto-rebalances DLMM positions when out of range, compounds fees, and exits on risk thresholds. Only one manager can run at a time.", {
+    pool: zod_1.z.string().describe("Pool address to manage"),
+    dex: zod_1.z.enum(["meteora-dlmm", "meteora-damm-v2"]).describe("DEX protocol"),
+    position: zod_1.z.string().optional().describe("Specific position address (default: all positions in pool)"),
+    rebalance_bins: zod_1.z.number().int().min(1).max(70).optional().describe("Bins for new position after rebalance (DLMM, default: 50)"),
+    strategy: zod_1.z.enum(["spot", "curve", "bid-ask"]).optional().describe("LP distribution strategy (DLMM, default: spot)"),
+    compound_interval_min: zod_1.z.number().min(0).optional().describe("Compound fees every N minutes (0=off, default: 30)"),
+    il_threshold_pct: zod_1.z.number().min(0).optional().describe("Exit if IL exceeds N% (default: 10)"),
+    stop_loss_pct: zod_1.z.number().min(0).optional().describe("Exit if price drops N% from entry (0=off, default: 0)"),
+    dry_run: zod_1.z.boolean().optional().describe("Log actions without executing (default: false)"),
+    use_ws: zod_1.z.boolean().optional().describe("Use WebSocket streaming for price updates (default: auto)"),
+}, async (args) => {
+    try {
+        if (activeLpManager) {
+            return err("LP Manager already running. Stop it first with lp_manager_stop.");
+        }
+        // Load the required adapter
+        if (args.dex === "meteora-dlmm")
+            await Promise.resolve().then(() => __importStar(require("outsmart/dist/dex/meteora-dlmm")));
+        else
+            await Promise.resolve().then(() => __importStar(require("outsmart/dist/dex/meteora-damm-v2")));
+        lpManagerEvents = [];
+        const config = {
+            poolAddress: args.pool,
+            dex: args.dex,
+            positionAddress: args.position,
+            rebalanceBins: args.rebalance_bins,
+            rebalanceStrategy: args.strategy,
+            compoundIntervalMin: args.compound_interval_min,
+            ilThresholdPct: args.il_threshold_pct,
+            stopLossPct: args.stop_loss_pct,
+            dryRun: args.dry_run,
+            useWebSocket: args.use_ws,
+            useStreaming: true,
+        };
+        activeLpManager = new outsmart_1.LpManager(config);
+        activeLpManager.on("event", (event) => {
+            lpManagerEvents.push(event);
+            if (lpManagerEvents.length > LP_EVENT_BUFFER_SIZE) {
+                lpManagerEvents.shift();
+            }
+        });
+        await activeLpManager.start();
+        const stats = activeLpManager.getStats();
+        return ok({
+            status: "started",
+            dex: args.dex,
+            pool: args.pool,
+            positions: stats.positionCount,
+            dryRun: args.dry_run ?? false,
+        });
+    }
+    catch (e) {
+        activeLpManager = null;
+        return err(e.message);
+    }
+});
+// ---------------------------------------------------------------------------
+// Tool: lp_manager_stop
+// ---------------------------------------------------------------------------
+server.tool("lp_manager_stop", "Stop the running LP manager. Returns final stats (rebalances, compounds, fees claimed).", {}, async () => {
+    try {
+        if (!activeLpManager) {
+            return err("No LP Manager is running.");
+        }
+        const stats = activeLpManager.getStats();
+        await activeLpManager.stop();
+        activeLpManager = null;
+        return ok({
+            status: "stopped",
+            ...stats,
+            recentEvents: lpManagerEvents.slice(-10),
+        });
+    }
+    catch (e) {
+        activeLpManager = null;
+        return err(e.message);
+    }
+});
+// ---------------------------------------------------------------------------
+// Tool: lp_manager_status
+// ---------------------------------------------------------------------------
+server.tool("lp_manager_status", "Get the current status of the LP manager — positions, stats, and recent events.", {
+    include_events: zod_1.z.boolean().optional().describe("Include recent event log (default: true)"),
+}, async (args) => {
+    if (!activeLpManager) {
+        return ok({ running: false });
+    }
+    const stats = activeLpManager.getStats();
+    const positions = activeLpManager.getPositions().map((p) => ({
+        positionAddress: p.positionAddress,
+        dex: p.dex,
+        inRange: p.inRange,
+        amountX: p.amountX,
+        amountY: p.amountY,
+        feeX: p.feeX,
+        feeY: p.feeY,
+        currentPrice: p.currentPrice,
+        entryPrice: p.entryPrice,
+        rebalanceCount: p.rebalanceCount,
+        compoundCount: p.compoundCount,
+        totalFeesClaimed: p.totalFeesClaimed,
+    }));
+    const result = { ...stats, running: true, positions };
+    if (args.include_events !== false) {
+        result.recentEvents = lpManagerEvents.slice(-20);
+    }
+    return ok(result);
+});
+// ---------------------------------------------------------------------------
+// Tool: lp_find_pool
+// ---------------------------------------------------------------------------
+// @ts-expect-error — TS2589: deep type instantiation from MCP SDK generics + zod
+server.tool("lp_find_pool", "Find the best Meteora LP pool for a token. Scores pools by volume/TVL ratio, fee APR, TVL, and age using DexScreener data. Returns ranked results.", {
+    token: zod_1.z.string().describe("Token mint address"),
+    dex: zod_1.z.enum(["meteora-dlmm", "meteora-damm-v2"]).optional().describe("Filter by DEX (default: both)"),
+    limit: zod_1.z.number().int().min(1).max(20).optional().describe("Max results (default: 10)"),
+}, async (args) => {
+    try {
+        const pools = await (0, outsmart_1.selectBestPool)(args.token, args.dex);
+        const limited = pools.slice(0, args.limit ?? 10);
+        return ok(limited);
+    }
+    catch (e) {
+        return err(e.message);
+    }
+});
+// ===========================================================================
+// EVENT STREAMING TOOLS (3) — Real-time DEX event streaming
+// ===========================================================================
+// Singleton stream instance
+let activeStream = null;
+let streamEvents = [];
+const STREAM_EVENT_BUFFER_SIZE = 200;
+// ---------------------------------------------------------------------------
+// Tool: stream_start
+// ---------------------------------------------------------------------------
+// @ts-expect-error — TS2589: deep type instantiation from MCP SDK generics + zod
+server.tool("stream_start", "Start real-time DEX event streaming. Captures Swap, NewPool, BondingComplete events from 18+ Solana DEX programs. Auto-selects gRPC (if configured) or WebSocket (free).", {
+    preset: zod_1.z.enum([
+        "all-dex-swaps", "new-pools", "pumpfun-bonding",
+        "pumpswap", "raydium", "meteora", "other-dexes",
+    ]).describe("Subscription preset"),
+    use_ws: zod_1.z.boolean().optional().describe("Force WebSocket mode (free, higher latency)"),
+}, async (args) => {
+    try {
+        if (activeStream) {
+            return err("Stream already running. Stop it first with stream_stop.");
+        }
+        streamEvents = [];
+        const useWs = args.use_ws ?? (!process.env.GRPC_URL && !process.env.GRPC_XTOKEN);
+        if (useWs) {
+            const { WsEventStream } = await Promise.resolve().then(() => __importStar(require("outsmart")));
+            activeStream = new WsEventStream({ logLevel: "silent" });
+        }
+        else {
+            const { EventStream } = await Promise.resolve().then(() => __importStar(require("outsmart")));
+            activeStream = new EventStream({ logLevel: "silent" });
+        }
+        // Buffer events
+        for (const eventType of ["Swap", "NewPool", "BondingComplete", "LargeSwap"]) {
+            activeStream.on(eventType, (event) => {
+                streamEvents.push({ type: eventType, ...event, _ts: Date.now() });
+                if (streamEvents.length > STREAM_EVENT_BUFFER_SIZE) {
+                    streamEvents.shift();
+                }
+            });
+        }
+        await activeStream.start(args.preset);
+        return ok({
+            status: "started",
+            preset: args.preset,
+            mode: useWs ? "websocket" : "grpc",
+        });
+    }
+    catch (e) {
+        activeStream = null;
+        return err(e.message);
+    }
+});
+// ---------------------------------------------------------------------------
+// Tool: stream_stop
+// ---------------------------------------------------------------------------
+server.tool("stream_stop", "Stop the running event stream.", {}, async () => {
+    try {
+        if (!activeStream) {
+            return err("No stream is running.");
+        }
+        await activeStream.stop();
+        activeStream = null;
+        const count = streamEvents.length;
+        return ok({ status: "stopped", bufferedEvents: count });
+    }
+    catch (e) {
+        activeStream = null;
+        return err(e.message);
+    }
+});
+// ---------------------------------------------------------------------------
+// Tool: stream_status
+// ---------------------------------------------------------------------------
+// @ts-expect-error — TS2589: deep type instantiation from MCP SDK generics + zod
+server.tool("stream_status", "Get recent events from the running event stream. Returns buffered Swap, NewPool, and BondingComplete events.", {
+    limit: zod_1.z.number().int().min(1).max(100).optional().describe("Max events to return (default: 20, most recent first)"),
+    type: zod_1.z.enum(["Swap", "NewPool", "BondingComplete", "LargeSwap", "all"]).optional().describe("Filter by event type (default: all)"),
+}, async (args) => {
+    if (!activeStream) {
+        return ok({ running: false, events: [] });
+    }
+    const limit = args.limit ?? 20;
+    let events = streamEvents;
+    if (args.type && args.type !== "all") {
+        events = events.filter((e) => e.type === args.type);
+    }
+    return ok({
+        running: true,
+        totalBuffered: streamEvents.length,
+        events: events.slice(-limit).reverse(),
+    });
+});
 // ---------------------------------------------------------------------------
 // Start server
 // ---------------------------------------------------------------------------