@spfunctions/cli 1.4.5 → 1.5.1

package/README.md

@@ -2,6 +2,8 @@
 
 Prediction market intelligence CLI. Build causal thesis models, scan Kalshi/Polymarket for mispricings, detect edges, and trade — all from the terminal.
 
+![demo](https://raw.githubusercontent.com/spfunctions/simplefunctions-cli/main/demo.gif)
+
 ## Quick Start
 
 ```bash

package/dist/client.js

@@ -37,8 +37,17 @@ class SFClient {
             body: body ? JSON.stringify(body) : undefined,
         });
         if (!res.ok) {
-            const text = await res.text();
-            throw new Error(`API error ${res.status}: ${text}`);
+            let errorBody = null;
+            try {
+                const text = await res.text();
+                errorBody = text ? JSON.parse(text) : null;
+            }
+            catch { /* not JSON */ }
+            const err = new Error(errorBody?.error || errorBody?.message || `API error ${res.status}`);
+            err.status = res.status;
+            err.code = errorBody?.code || `HTTP_${res.status}`;
+            err.details = errorBody;
+            throw err;
         }
         return res.json();
     }

package/dist/client.test.js

@@ -66,7 +66,7 @@ vitest_1.vi.stubGlobal('fetch', mockFetch);
             status: 404,
             text: () => Promise.resolve('Not found'),
         });
-        await (0, vitest_1.expect)(client.getThesis('bad-id')).rejects.toThrow('API error 404: Not found');
+        await (0, vitest_1.expect)(client.getThesis('bad-id')).rejects.toThrow('API error 404');
     });
     (0, vitest_1.it)('getContext calls correct path', async () => {
         mockFetch.mockResolvedValue({

package/dist/commands/agent.js

@@ -23,6 +23,8 @@ const path_1 = __importDefault(require("path"));
 const os_1 = __importDefault(require("os"));
 const client_js_1 = require("../client.js");
 const kalshi_js_1 = require("../kalshi.js");
+const polymarket_js_1 = require("../polymarket.js");
+const topics_js_1 = require("../topics.js");
 const config_js_1 = require("../config.js");
 // ─── Session persistence ─────────────────────────────────────────────────────
 function getSessionDir() {
@@ -793,34 +795,55 @@ async function agentCommand(thesisId, opts) {
         {
             name: 'scan_markets',
             label: 'Scan Markets',
-            description: 'Search Kalshi prediction markets. Provide exactly one of: query (keyword search), series (series ticker), or market (specific ticker). If multiple are provided, priority is: market > series > query.',
+            description: 'Search Kalshi + Polymarket prediction markets. Provide exactly one of: query (keyword search), series (Kalshi series ticker), or market (specific Kalshi ticker). Keyword search returns results from BOTH venues.',
             parameters: scanParams,
             execute: async (_toolCallId, params) => {
-                let result;
                 if (params.market) {
-                    result = await (0, client_js_1.kalshiFetchMarket)(params.market);
+                    const result = await (0, client_js_1.kalshiFetchMarket)(params.market);
+                    return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }], details: {} };
                 }
-                else if (params.series) {
-                    result = await (0, client_js_1.kalshiFetchMarketsBySeries)(params.series);
+                if (params.series) {
+                    const result = await (0, client_js_1.kalshiFetchMarketsBySeries)(params.series);
+                    return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }], details: {} };
                 }
-                else if (params.query) {
+                if (params.query) {
+                    // Kalshi: keyword grep on series
                     const series = await (0, client_js_1.kalshiFetchAllSeries)();
                     const keywords = params.query.toLowerCase().split(/\s+/);
-                    const matched = series
-                        .filter((s) => keywords.every((kw) => (s.title || '').toLowerCase().includes(kw) ||
+                    const kalshiMatched = series
+                        .filter((s) => keywords.some((kw) => (s.title || '').toLowerCase().includes(kw) ||
                         (s.ticker || '').toLowerCase().includes(kw)))
                         .filter((s) => parseFloat(s.volume_24h_fp || s.volume_fp || '0') > 0)
                         .sort((a, b) => parseFloat(b.volume_24h_fp || b.volume_fp || '0') - parseFloat(a.volume_24h_fp || a.volume_fp || '0'))
-                        .slice(0, 15);
-                    result = matched;
-                }
-                else {
-                    result = { error: 'Provide query, series, or market parameter' };
+                        .slice(0, 10)
+                        .map((s) => ({ venue: 'kalshi', ticker: s.ticker, title: s.title, volume: s.volume_fp }));
+                    // Polymarket: Gamma API search
+                    let polyMatched = [];
+                    try {
+                        const events = await (0, polymarket_js_1.polymarketSearch)(params.query, 10);
+                        for (const event of events) {
+                            for (const m of (event.markets || []).slice(0, 3)) {
+                                if (!m.active || m.closed)
+                                    continue;
+                                const prices = (0, polymarket_js_1.parseOutcomePrices)(m.outcomePrices);
+                                polyMatched.push({
+                                    venue: 'polymarket',
+                                    id: m.conditionId || m.id,
+                                    title: m.groupItemTitle ? `${event.title}: ${m.groupItemTitle}` : m.question || event.title,
+                                    price: prices[0] ? Math.round(prices[0] * 100) : null,
+                                    volume24h: m.volume24hr,
+                                    liquidity: m.liquidityNum,
+                                });
+                            }
+                        }
+                    }
+                    catch { /* Polymarket search optional */ }
+                    return {
+                        content: [{ type: 'text', text: JSON.stringify({ kalshi: kalshiMatched, polymarket: polyMatched }, null, 2) }],
+                        details: {},
+                    };
                 }
-                return {
-                    content: [{ type: 'text', text: JSON.stringify(result, null, 2) }],
-                    details: {},
-                };
+                return { content: [{ type: 'text', text: '{"error":"Provide query, series, or market parameter"}' }], details: {} };
             },
         },
         {
@@ -839,36 +862,57 @@ async function agentCommand(thesisId, opts) {
         {
             name: 'get_positions',
             label: 'Get Positions',
-            description: 'Get Kalshi exchange positions with live prices and PnL',
+            description: 'Get positions across Kalshi + Polymarket with live prices and PnL',
             parameters: emptyParams,
             execute: async () => {
+                const result = { kalshi: [], polymarket: [] };
+                // Kalshi positions
                 const positions = await (0, kalshi_js_1.getPositions)();
-                if (!positions) {
+                if (positions) {
+                    for (const pos of positions) {
+                        const livePrice = await (0, kalshi_js_1.getMarketPrice)(pos.ticker);
+                        if (livePrice !== null) {
+                            pos.current_value = livePrice;
+                            pos.unrealized_pnl = Math.round((livePrice - pos.average_price_paid) * pos.quantity);
+                        }
+                    }
+                    cachedPositions = positions;
+                    result.kalshi = positions.map((p) => ({
+                        venue: 'kalshi',
+                        ticker: p.ticker,
+                        side: p.side,
+                        quantity: p.quantity,
+                        avg_price: `${p.average_price_paid}¢`,
+                        current_price: `${p.current_value}¢`,
+                        unrealized_pnl: `$${(p.unrealized_pnl / 100).toFixed(2)}`,
+                        total_cost: `$${(p.total_cost / 100).toFixed(2)}`,
+                    }));
+                }
+                // Polymarket positions
+                const config = (0, config_js_1.loadConfig)();
+                if (config.polymarketWalletAddress) {
+                    try {
+                        const polyPos = await (0, polymarket_js_1.polymarketGetPositions)(config.polymarketWalletAddress);
+                        result.polymarket = polyPos.map((p) => ({
+                            venue: 'polymarket',
+                            market: p.title || p.slug || p.asset,
+                            side: p.outcome || 'Yes',
+                            size: p.size,
+                            avg_price: `${Math.round((p.avgPrice || 0) * 100)}¢`,
+                            current_price: `${Math.round((p.curPrice || p.currentPrice || 0) * 100)}¢`,
+                            pnl: `$${(p.cashPnl || 0).toFixed(2)}`,
+                        }));
+                    }
+                    catch { /* skip */ }
+                }
+                if (result.kalshi.length === 0 && result.polymarket.length === 0) {
                     return {
-                        content: [{ type: 'text', text: 'Kalshi not configured. Set KALSHI_API_KEY_ID and KALSHI_PRIVATE_KEY_PATH.' }],
+                        content: [{ type: 'text', text: 'No positions found. Configure Kalshi (KALSHI_API_KEY_ID) or Polymarket (sf setup --polymarket) to see positions.' }],
                         details: {},
                     };
                 }
-                for (const pos of positions) {
-                    const livePrice = await (0, kalshi_js_1.getMarketPrice)(pos.ticker);
-                    if (livePrice !== null) {
-                        pos.current_value = livePrice;
-                        pos.unrealized_pnl = Math.round((livePrice - pos.average_price_paid) * pos.quantity);
-                    }
-                }
-                cachedPositions = positions;
-                const formatted = positions.map((p) => ({
-                    ticker: p.ticker,
-                    side: p.side,
-                    quantity: p.quantity,
-                    avg_price: `${p.average_price_paid}¢`,
-                    current_price: `${p.current_value}¢`,
-                    unrealized_pnl: `$${(p.unrealized_pnl / 100).toFixed(2)}`,
-                    total_cost: `$${(p.total_cost / 100).toFixed(2)}`,
-                    realized_pnl: `$${(p.realized_pnl / 100).toFixed(2)}`,
-                }));
                 return {
-                    content: [{ type: 'text', text: JSON.stringify(formatted, null, 2) }],
+                    content: [{ type: 'text', text: JSON.stringify(result, null, 2) }],
                     details: {},
                 };
             },
@@ -1129,6 +1173,139 @@ async function agentCommand(thesisId, opts) {
                 return { content: [{ type: 'text', text: JSON.stringify(result.fills, null, 2) }], details: {} };
             },
         },
+        {
+            name: 'get_liquidity',
+            label: 'Liquidity Scanner',
+            description: 'Scan orderbook liquidity for a topic across Kalshi + Polymarket. Returns spread, depth, liquidity scores. Topics: ' + Object.keys(topics_js_1.TOPIC_SERIES).join(', '),
+            parameters: Type.Object({
+                topic: Type.String({ description: 'Topic to scan (e.g. oil, crypto, fed, geopolitics)' }),
+            }),
+            execute: async (_toolCallId, params) => {
+                const topicKey = params.topic.toLowerCase();
+                const seriesList = topics_js_1.TOPIC_SERIES[topicKey];
+                if (!seriesList) {
+                    return { content: [{ type: 'text', text: `Unknown topic "${params.topic}". Available: ${Object.keys(topics_js_1.TOPIC_SERIES).join(', ')}` }], details: {} };
+                }
+                const results = [];
+                for (const series of seriesList) {
+                    try {
+                        const url = `https://api.elections.kalshi.com/trade-api/v2/markets?series_ticker=${series}&status=open&limit=200`;
+                        const res = await fetch(url, { headers: { Accept: 'application/json' } });
+                        if (!res.ok)
+                            continue;
+                        const markets = (await res.json()).markets || [];
+                        const obResults = await Promise.allSettled(markets.slice(0, 20).map((m) => (0, kalshi_js_1.getPublicOrderbook)(m.ticker).then(ob => ({ ticker: m.ticker, title: m.title, ob }))));
+                        for (const r of obResults) {
+                            if (r.status !== 'fulfilled' || !r.value.ob)
+                                continue;
+                            const { ticker, title, ob } = r.value;
+                            const yes = (ob.yes_dollars || []).map(([p, q]) => ({ price: Math.round(parseFloat(p) * 100), qty: parseFloat(q) })).filter((l) => l.price > 0).sort((a, b) => b.price - a.price);
+                            const no = (ob.no_dollars || []).map(([p, q]) => ({ price: Math.round(parseFloat(p) * 100), qty: parseFloat(q) })).filter((l) => l.price > 0).sort((a, b) => b.price - a.price);
+                            const bestBid = yes[0]?.price || 0;
+                            const bestAsk = no.length > 0 ? (100 - no[0].price) : 100;
+                            const spread = bestAsk - bestBid;
+                            const depth = yes.slice(0, 3).reduce((s, l) => s + l.qty, 0) + no.slice(0, 3).reduce((s, l) => s + l.qty, 0);
+                            const liq = spread <= 2 && depth >= 500 ? 'high' : spread <= 5 && depth >= 100 ? 'medium' : 'low';
+                            results.push({ venue: 'kalshi', ticker, title: (title || '').slice(0, 50), bestBid, bestAsk, spread, depth: Math.round(depth), liquidityScore: liq });
+                        }
+                    }
+                    catch { /* skip */ }
+                }
+                try {
+                    const events = await (0, polymarket_js_1.polymarketSearch)(topicKey, 5);
+                    for (const event of events) {
+                        for (const m of (event.markets || []).slice(0, 5)) {
+                            if (!m.active || m.closed || !m.clobTokenIds)
+                                continue;
+                            const ids = (0, polymarket_js_1.parseClobTokenIds)(m.clobTokenIds);
+                            if (!ids)
+                                continue;
+                            const d = await (0, polymarket_js_1.polymarketGetOrderbookWithDepth)(ids[0]);
+                            if (!d)
+                                continue;
+                            results.push({ venue: 'polymarket', ticker: (m.question || event.title).slice(0, 50), bestBid: d.bestBid, bestAsk: d.bestAsk, spread: d.spread, depth: d.bidDepthTop3 + d.askDepthTop3, liquidityScore: d.liquidityScore });
+                        }
+                    }
+                }
+                catch { /* skip */ }
+                results.sort((a, b) => a.spread - b.spread);
+                return { content: [{ type: 'text', text: JSON.stringify(results, null, 2) }], details: {} };
+            },
+        },
+        {
+            name: 'inspect_book',
+            label: 'Orderbook',
+            description: 'Get orderbook depth, spread, and liquidity for a specific market. Works with Kalshi tickers or Polymarket search queries. Returns bid/ask levels, depth, spread, liquidity score.',
+            parameters: Type.Object({
+                ticker: Type.Optional(Type.String({ description: 'Kalshi market ticker (e.g. KXWTIMAX-26DEC31-T135)' })),
+                polyQuery: Type.Optional(Type.String({ description: 'Search Polymarket by keyword (e.g. "oil price above 100")' })),
+            }),
+            execute: async (_toolCallId, params) => {
+                const results = [];
+                if (params.ticker) {
+                    try {
+                        const market = await (0, client_js_1.kalshiFetchMarket)(params.ticker);
+                        const ob = await (0, kalshi_js_1.getPublicOrderbook)(params.ticker);
+                        const yesBids = (ob?.yes_dollars || [])
+                            .map(([p, q]) => ({ price: Math.round(parseFloat(p) * 100), size: Math.round(parseFloat(q)) }))
+                            .filter((l) => l.price > 0).sort((a, b) => b.price - a.price);
+                        const noAsks = (ob?.no_dollars || [])
+                            .map(([p, q]) => ({ price: Math.round(parseFloat(p) * 100), size: Math.round(parseFloat(q)) }))
+                            .filter((l) => l.price > 0).sort((a, b) => b.price - a.price);
+                        const bestBid = yesBids[0]?.price || 0;
+                        const bestAsk = noAsks.length > 0 ? (100 - noAsks[0].price) : 100;
+                        const spread = bestAsk - bestBid;
+                        const top3Depth = yesBids.slice(0, 3).reduce((s, l) => s + l.size, 0) + noAsks.slice(0, 3).reduce((s, l) => s + l.size, 0);
+                        const liq = spread <= 2 && top3Depth >= 500 ? 'high' : spread <= 5 && top3Depth >= 100 ? 'medium' : 'low';
+                        results.push({
+                            venue: 'kalshi', ticker: params.ticker, title: market.title,
+                            bestBid, bestAsk, spread, liquidityScore: liq,
+                            bidLevels: yesBids.slice(0, 5), askLevels: noAsks.slice(0, 5).map((l) => ({ price: 100 - l.price, size: l.size })),
+                            totalBidDepth: yesBids.reduce((s, l) => s + l.size, 0),
+                            totalAskDepth: noAsks.reduce((s, l) => s + l.size, 0),
+                            lastPrice: Math.round(parseFloat(market.last_price_dollars || '0') * 100),
+                            volume24h: parseFloat(market.volume_24h_fp || '0'),
+                            openInterest: parseFloat(market.open_interest_fp || '0'),
+                            expiry: market.close_time || null,
+                        });
+                    }
+                    catch (err) {
+                        return { content: [{ type: 'text', text: `Failed: ${err.message}` }], details: {} };
+                    }
+                }
+                if (params.polyQuery) {
+                    try {
+                        const events = await (0, polymarket_js_1.polymarketSearch)(params.polyQuery, 5);
+                        for (const event of events) {
+                            for (const m of (event.markets || []).slice(0, 3)) {
+                                if (!m.active || m.closed || !m.clobTokenIds)
+                                    continue;
+                                const ids = (0, polymarket_js_1.parseClobTokenIds)(m.clobTokenIds);
+                                if (!ids)
+                                    continue;
+                                const depth = await (0, polymarket_js_1.polymarketGetOrderbookWithDepth)(ids[0]);
+                                if (!depth)
+                                    continue;
+                                const prices = (0, polymarket_js_1.parseOutcomePrices)(m.outcomePrices);
+                                results.push({
+                                    venue: 'polymarket', title: m.question || event.title,
+                                    bestBid: depth.bestBid, bestAsk: depth.bestAsk, spread: depth.spread,
+                                    liquidityScore: depth.liquidityScore,
+                                    totalBidDepth: depth.totalBidDepth, totalAskDepth: depth.totalAskDepth,
+                                    lastPrice: prices[0] ? Math.round(prices[0] * 100) : 0,
+                                    volume24h: m.volume24hr || 0,
+                                });
+                            }
+                        }
+                    }
+                    catch { /* skip */ }
+                }
+                if (results.length === 0) {
+                    return { content: [{ type: 'text', text: 'No markets found. Provide ticker (Kalshi) or polyQuery (Polymarket search).' }], details: {} };
+                }
+                return { content: [{ type: 'text', text: JSON.stringify(results, null, 2) }], details: {} };
+            },
+        },
         {
             name: 'get_schedule',
             label: 'Schedule',
@@ -2529,6 +2706,139 @@ async function runPlainTextAgent(params) {
                 return { content: [{ type: 'text', text: JSON.stringify(result.fills, null, 2) }], details: {} };
             },
         },
+        {
+            name: 'get_liquidity',
+            label: 'Liquidity Scanner',
+            description: 'Scan orderbook liquidity for a topic across Kalshi + Polymarket. Returns spread, depth, liquidity scores. Topics: ' + Object.keys(topics_js_1.TOPIC_SERIES).join(', '),
+            parameters: Type.Object({
+                topic: Type.String({ description: 'Topic to scan (e.g. oil, crypto, fed, geopolitics)' }),
+            }),
+            execute: async (_toolCallId, params) => {
+                const topicKey = params.topic.toLowerCase();
+                const seriesList = topics_js_1.TOPIC_SERIES[topicKey];
+                if (!seriesList) {
+                    return { content: [{ type: 'text', text: `Unknown topic "${params.topic}". Available: ${Object.keys(topics_js_1.TOPIC_SERIES).join(', ')}` }], details: {} };
+                }
+                const results = [];
+                for (const series of seriesList) {
+                    try {
+                        const url = `https://api.elections.kalshi.com/trade-api/v2/markets?series_ticker=${series}&status=open&limit=200`;
+                        const res = await fetch(url, { headers: { Accept: 'application/json' } });
+                        if (!res.ok)
+                            continue;
+                        const markets = (await res.json()).markets || [];
+                        const obResults = await Promise.allSettled(markets.slice(0, 20).map((m) => (0, kalshi_js_1.getPublicOrderbook)(m.ticker).then(ob => ({ ticker: m.ticker, title: m.title, ob }))));
+                        for (const r of obResults) {
+                            if (r.status !== 'fulfilled' || !r.value.ob)
+                                continue;
+                            const { ticker, title, ob } = r.value;
+                            const yes = (ob.yes_dollars || []).map(([p, q]) => ({ price: Math.round(parseFloat(p) * 100), qty: parseFloat(q) })).filter((l) => l.price > 0).sort((a, b) => b.price - a.price);
+                            const no = (ob.no_dollars || []).map(([p, q]) => ({ price: Math.round(parseFloat(p) * 100), qty: parseFloat(q) })).filter((l) => l.price > 0).sort((a, b) => b.price - a.price);
+                            const bestBid = yes[0]?.price || 0;
+                            const bestAsk = no.length > 0 ? (100 - no[0].price) : 100;
+                            const spread = bestAsk - bestBid;
+                            const depth = yes.slice(0, 3).reduce((s, l) => s + l.qty, 0) + no.slice(0, 3).reduce((s, l) => s + l.qty, 0);
+                            const liq = spread <= 2 && depth >= 500 ? 'high' : spread <= 5 && depth >= 100 ? 'medium' : 'low';
+                            results.push({ venue: 'kalshi', ticker, title: (title || '').slice(0, 50), bestBid, bestAsk, spread, depth: Math.round(depth), liquidityScore: liq });
+                        }
+                    }
+                    catch { /* skip */ }
+                }
+                try {
+                    const events = await (0, polymarket_js_1.polymarketSearch)(topicKey, 5);
+                    for (const event of events) {
+                        for (const m of (event.markets || []).slice(0, 5)) {
+                            if (!m.active || m.closed || !m.clobTokenIds)
+                                continue;
+                            const ids = (0, polymarket_js_1.parseClobTokenIds)(m.clobTokenIds);
+                            if (!ids)
+                                continue;
+                            const d = await (0, polymarket_js_1.polymarketGetOrderbookWithDepth)(ids[0]);
+                            if (!d)
+                                continue;
+                            results.push({ venue: 'polymarket', ticker: (m.question || event.title).slice(0, 50), bestBid: d.bestBid, bestAsk: d.bestAsk, spread: d.spread, depth: d.bidDepthTop3 + d.askDepthTop3, liquidityScore: d.liquidityScore });
+                        }
+                    }
+                }
+                catch { /* skip */ }
+                results.sort((a, b) => a.spread - b.spread);
+                return { content: [{ type: 'text', text: JSON.stringify(results, null, 2) }], details: {} };
+            },
+        },
+        {
+            name: 'inspect_book',
+            label: 'Orderbook',
+            description: 'Get orderbook depth, spread, and liquidity for a specific market. Works with Kalshi tickers or Polymarket search queries. Returns bid/ask levels, depth, spread, liquidity score.',
+            parameters: Type.Object({
+                ticker: Type.Optional(Type.String({ description: 'Kalshi market ticker (e.g. KXWTIMAX-26DEC31-T135)' })),
+                polyQuery: Type.Optional(Type.String({ description: 'Search Polymarket by keyword (e.g. "oil price above 100")' })),
+            }),
+            execute: async (_toolCallId, params) => {
+                const results = [];
+                if (params.ticker) {
+                    try {
+                        const market = await (0, client_js_1.kalshiFetchMarket)(params.ticker);
+                        const ob = await (0, kalshi_js_1.getPublicOrderbook)(params.ticker);
+                        const yesBids = (ob?.yes_dollars || [])
+                            .map(([p, q]) => ({ price: Math.round(parseFloat(p) * 100), size: Math.round(parseFloat(q)) }))
+                            .filter((l) => l.price > 0).sort((a, b) => b.price - a.price);
+                        const noAsks = (ob?.no_dollars || [])
+                            .map(([p, q]) => ({ price: Math.round(parseFloat(p) * 100), size: Math.round(parseFloat(q)) }))
+                            .filter((l) => l.price > 0).sort((a, b) => b.price - a.price);
+                        const bestBid = yesBids[0]?.price || 0;
+                        const bestAsk = noAsks.length > 0 ? (100 - noAsks[0].price) : 100;
+                        const spread = bestAsk - bestBid;
+                        const top3Depth = yesBids.slice(0, 3).reduce((s, l) => s + l.size, 0) + noAsks.slice(0, 3).reduce((s, l) => s + l.size, 0);
+                        const liq = spread <= 2 && top3Depth >= 500 ? 'high' : spread <= 5 && top3Depth >= 100 ? 'medium' : 'low';
+                        results.push({
+                            venue: 'kalshi', ticker: params.ticker, title: market.title,
+                            bestBid, bestAsk, spread, liquidityScore: liq,
+                            bidLevels: yesBids.slice(0, 5), askLevels: noAsks.slice(0, 5).map((l) => ({ price: 100 - l.price, size: l.size })),
+                            totalBidDepth: yesBids.reduce((s, l) => s + l.size, 0),
+                            totalAskDepth: noAsks.reduce((s, l) => s + l.size, 0),
+                            lastPrice: Math.round(parseFloat(market.last_price_dollars || '0') * 100),
+                            volume24h: parseFloat(market.volume_24h_fp || '0'),
+                            openInterest: parseFloat(market.open_interest_fp || '0'),
+                            expiry: market.close_time || null,
+                        });
+                    }
+                    catch (err) {
+                        return { content: [{ type: 'text', text: `Failed: ${err.message}` }], details: {} };
+                    }
+                }
+                if (params.polyQuery) {
+                    try {
+                        const events = await (0, polymarket_js_1.polymarketSearch)(params.polyQuery, 5);
+                        for (const event of events) {
+                            for (const m of (event.markets || []).slice(0, 3)) {
+                                if (!m.active || m.closed || !m.clobTokenIds)
+                                    continue;
+                                const ids = (0, polymarket_js_1.parseClobTokenIds)(m.clobTokenIds);
+                                if (!ids)
+                                    continue;
+                                const depth = await (0, polymarket_js_1.polymarketGetOrderbookWithDepth)(ids[0]);
+                                if (!depth)
+                                    continue;
+                                const prices = (0, polymarket_js_1.parseOutcomePrices)(m.outcomePrices);
+                                results.push({
+                                    venue: 'polymarket', title: m.question || event.title,
+                                    bestBid: depth.bestBid, bestAsk: depth.bestAsk, spread: depth.spread,
+                                    liquidityScore: depth.liquidityScore,
+                                    totalBidDepth: depth.totalBidDepth, totalAskDepth: depth.totalAskDepth,
+                                    lastPrice: prices[0] ? Math.round(prices[0] * 100) : 0,
+                                    volume24h: m.volume24hr || 0,
+                                });
+                            }
+                        }
+                    }
+                    catch { /* skip */ }
+                }
+                if (results.length === 0) {
+                    return { content: [{ type: 'text', text: 'No markets found. Provide ticker (Kalshi) or polyQuery (Polymarket search).' }], details: {} };
+                }
+                return { content: [{ type: 'text', text: JSON.stringify(results, null, 2) }], details: {} };
+            },
+        },
         {
             name: 'get_schedule',
             label: 'Schedule',
@@ -2870,22 +3180,34 @@ async function runPlainTextAgent(params) {
         .map((n) => `  ${n.id} ${(n.label || '').slice(0, 40)} \u2014 ${Math.round(n.probability * 100)}%`)
         .join('\n') || '  (no causal tree)';
     const conf = typeof ctx.confidence === 'number' ? Math.round(ctx.confidence * 100) : 0;
-    const systemPrompt = `You are a prediction market trading assistant. Help the user make correct trading decisions.
+    const systemPrompt = `You are a prediction market trading assistant. Your job is not to please the user — it is to help them see reality clearly and make correct trading decisions.
 
-Current thesis: ${ctx.thesis || ctx.rawThesis || 'N/A'}
-ID: ${resolvedThesisId}
-Confidence: ${conf}%
-Status: ${ctx.status}
+## Framework
+Each thesis has a causal tree. Every node is a hypothesis with a probability. Edge = thesis-implied price - market price. Positive edge = market underprices. Contracts with large edge + good liquidity = most tradeable.
+executableEdge = edge after subtracting bid-ask spread. A big theoretical edge with wide spread may not be worth entering.
+
+## Rules
+- Be concise. Use tools for fresh data. Don't guess prices.
+- If user mentions news, inject_signal immediately.
+- If user says "evaluate", trigger immediately. Don't confirm.
+- Don't end with "anything else?"
+- If an edge is narrowing or disappearing, say so proactively.
+- Use Chinese if user writes Chinese, English if English.
+- Prices in cents (¢). P&L in dollars ($). Don't re-convert tool output.
+- When a trade idea emerges, create_strategy to record it.
+${config.tradingEnabled ? '- Trading ENABLED. You have place_order and cancel_order tools.' : '- Trading DISABLED. Tell user: sf setup --enable-trading'}
 
-Causal tree nodes:
+## Current State
+Thesis: ${ctx.thesis || ctx.rawThesis || 'N/A'}
+ID: ${resolvedThesisId} | Confidence: ${conf}% | Status: ${ctx.status}
+
+Causal nodes:
 ${nodesSummary}
 
 Top edges:
 ${edgesSummary}
 
-${ctx.lastEvaluation?.summary ? `Latest evaluation: ${ctx.lastEvaluation.summary.slice(0, 300)}` : ''}
-
-Rules: Be concise. Use tools when needed. Don't ask "anything else?". Prices are in cents (e.g. 35¢). P&L, cost, and balance are in dollars (e.g. $90.66). Tool outputs are pre-formatted with units — do not re-convert.`;
+${ctx.lastEvaluation?.summary ? `Latest eval: ${ctx.lastEvaluation.summary.slice(0, 300)}` : ''}`;
     // ── Create agent ──────────────────────────────────────────────────────────
     const agent = new Agent({
         initialState: { systemPrompt, model, tools, thinkingLevel: 'off' },

package/dist/commands/book.d.ts

@@ -0,0 +1,17 @@
+/**
+ * sf book — Orderbook depth, price history, and liquidity for individual markets
+ *
+ * Usage:
+ *   sf book KXWTIMAX-26DEC31-T135                  Single Kalshi market
+ *   sf book KXWTI-T135 KXCPI-26MAY                 Multiple markets
+ *   sf book --poly "oil price"                      Polymarket search
+ *   sf book KXWTIMAX-26DEC31-T135 --history         With 7d price history
+ *   sf book KXWTIMAX-26DEC31-T135 --json            JSON output
+ */
+interface BookOpts {
+    poly?: string;
+    history?: boolean;
+    json?: boolean;
+}
+export declare function bookCommand(tickers: string[], opts: BookOpts): Promise<void>;
+export {};