@spfunctions/cli 1.7.16 → 1.7.19

package/dist/commands/agent.js

@@ -26,6 +26,7 @@ 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");
+const loader_js_1 = require("../skills/loader.js");
 // ─── Session persistence ─────────────────────────────────────────────────────
 function getSessionDir() {
     return path_1.default.join(os_1.default.homedir(), '.sf', 'sessions');
@@ -318,7 +319,7 @@ function createFooterBar(piTui) {
             const tokStr = this.tokens >= 1000 ? `${(this.tokens / 1000).toFixed(1)}k` : `${this.tokens}`;
             const tokens = C.zinc600(`${tokStr} tok`);
             const exchange = this.exchangeOpen === true ? C.emerald('OPEN') : this.exchangeOpen === false ? C.red('CLOSED') : C.zinc600('...');
-            const trading = this.tradingEnabled ? C.amber('\u26A1 trading') : C.zinc600('\u26A1 read-only');
+            const trading = this.tradingEnabled ? C.amber('trading') : C.zinc600('read-only');
             const help = C.zinc600('/help');
             const leftText = [model, tokens, exchange, trading].join(sep);
             const lw = visibleWidth(leftText);
@@ -739,6 +740,12 @@ async function agentCommand(thesisId, opts) {
         slashCommands.splice(-2, 0, // insert before /clear and /exit
         { name: 'buy', description: 'TICKER QTY PRICE — quick buy' }, { name: 'sell', description: 'TICKER QTY PRICE — quick sell' }, { name: 'cancel', description: 'ORDER_ID — cancel order' });
     }
+    // Load skills and register as slash commands
+    const skills = (0, loader_js_1.loadSkills)();
+    for (const skill of skills) {
+        const trigger = skill.trigger.replace(/^\//, ''); // remove leading /
+        slashCommands.splice(-2, 0, { name: trigger, description: `[skill] ${skill.description.slice(0, 50)}` });
+    }
     const autocompleteProvider = new CombinedAutocompleteProvider(slashCommands, process.cwd());
     editor.setAutocompleteProvider(autocompleteProvider);
     // Assemble TUI tree
@@ -1267,16 +1274,34 @@ async function agentCommand(thesisId, opts) {
         {
             name: 'get_orders',
             label: 'Orders',
-            description: 'Get current resting orders on Kalshi.',
+            description: 'Get current resting orders on Kalshi. Stale orders (>7 days old AND >10¢ from market) are flagged.',
             parameters: Type.Object({
                 status: Type.Optional(Type.String({ description: 'Filter by status: resting, canceled, executed. Default: resting' })),
             }),
             execute: async (_toolCallId, params) => {
-                const { getOrders } = await import('../kalshi.js');
+                const { getOrders, getMarketPrice } = await import('../kalshi.js');
                 const result = await getOrders({ status: params.status || 'resting', limit: 100 });
                 if (!result)
                     return { content: [{ type: 'text', text: 'Kalshi not configured.' }], details: {} };
-                return { content: [{ type: 'text', text: JSON.stringify(result.orders, null, 2) }], details: {} };
+                // Enrich orders with staleness detection
+                const enriched = await Promise.all((result.orders || []).map(async (order) => {
+                    const daysSinceCreated = order.created_time
+                        ? Math.round((Date.now() - new Date(order.created_time).getTime()) / 86400000)
+                        : null;
+                    let distanceFromMarket = null;
+                    let stale = false;
+                    try {
+                        const price = await getMarketPrice(order.ticker);
+                        if (price != null && order.yes_price_dollars) {
+                            distanceFromMarket = Math.round(Math.abs(price - parseFloat(order.yes_price_dollars)) * 100);
+                            if (daysSinceCreated != null && daysSinceCreated > 7 && distanceFromMarket > 10)
+                                stale = true;
+                        }
+                    }
+                    catch { }
+                    return { ...order, daysSinceCreated, distanceFromMarket, stale };
+                }));
+                return { content: [{ type: 'text', text: JSON.stringify(enriched, null, 2) }], details: {} };
             },
         },
         {
@@ -1356,42 +1381,71 @@ async function agentCommand(thesisId, opts) {
         {
             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.',
+            description: 'Get orderbook depth, spread, and liquidity. Returns a status field per market: "ok", "empty_orderbook", "market_closed", or "api_error". Supports multiple tickers in one call — use tickers array for batch position checks.',
             parameters: Type.Object({
-                ticker: Type.Optional(Type.String({ description: 'Kalshi market ticker (e.g. KXWTIMAX-26DEC31-T135)' })),
+                ticker: Type.Optional(Type.String({ description: 'Single Kalshi market ticker (e.g. KXWTIMAX-26DEC31-T135)' })),
+                tickers: Type.Optional(Type.Array(Type.String(), { description: 'Multiple Kalshi tickers for batch check (e.g. ["T$135", "T$140", "T$150"])' })),
                 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) {
+                // Batch: expand tickers array into individual lookups
+                const tickerList = [];
+                if (params.tickers?.length)
+                    tickerList.push(...params.tickers);
+                else if (params.ticker)
+                    tickerList.push(params.ticker);
+                for (const tkr of tickerList) {
                     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,
-                        });
+                        const market = await (0, client_js_1.kalshiFetchMarket)(tkr);
+                        const mStatus = market.status || 'unknown';
+                        if (mStatus !== 'open' && mStatus !== 'active') {
+                            results.push({
+                                venue: 'kalshi', ticker: tkr, title: market.title,
+                                status: 'market_closed', reason: `Market status: ${mStatus}. Orderbook unavailable for closed/settled markets.`,
+                                lastPrice: Math.round(parseFloat(market.last_price_dollars || '0') * 100),
+                            });
+                        }
+                        else {
+                            const ob = await (0, kalshi_js_1.getPublicOrderbook)(tkr);
+                            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);
+                            if (yesBids.length === 0 && noAsks.length === 0) {
+                                results.push({
+                                    venue: 'kalshi', ticker: tkr, title: market.title,
+                                    status: 'empty_orderbook', reason: 'Market open but no resting orders. Normal for illiquid/OTM contracts. Use lastPrice as reference.',
+                                    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,
+                                });
+                            }
+                            else {
+                                const bestBid = yesBids[0]?.price || 0;
+                                const bestAsk = noAsks.length > 0 ? (100 - noAsks[0].price) : (yesBids[0] ? yesBids[0].price + 1 : 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: tkr, title: market.title, status: 'ok',
+                                    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: {} };
+                        results.push({ venue: 'kalshi', ticker: tkr, status: 'api_error', reason: `Kalshi API error: ${err.message}` });
                     }
                 }
                 if (params.polyQuery) {
@@ -1512,14 +1566,64 @@ async function agentCommand(thesisId, opts) {
         {
             name: 'get_feed',
             label: 'Get Feed',
-            description: 'Get evaluation history / activity feed. Shows recent evaluations, signals, and changes across theses.',
+            description: 'Get evaluation history with topSignal highlighting. The most important signal (largest confidence change or most actionable) is surfaced first so you don\'t have to scan all entries.',
             parameters: Type.Object({
                 hours: Type.Optional(Type.Number({ description: 'Hours of history to fetch (default 24)' })),
             }),
             execute: async (_toolCallId, params) => {
                 const result = await sfClient.getFeed(params.hours || 24);
+                const items = Array.isArray(result) ? result : (result?.evaluations || result?.items || []);
+                // Find the most important signal: largest |confidenceDelta|, or newest with actual content
+                let topSignal = null;
+                let topScore = 0;
+                for (const item of items) {
+                    let score = 0;
+                    const delta = Math.abs(item.confidenceDelta || item.confidence_delta || 0);
+                    if (delta > 0)
+                        score = delta * 100; // confidence changes are most important
+                    else if (item.summary?.length > 50)
+                        score = 0.1; // has substance but no delta
+                    if (score > topScore) {
+                        topScore = score;
+                        topSignal = item;
+                    }
+                }
+                const output = { total: items.length };
+                if (topSignal) {
+                    output.topSignal = {
+                        summary: topSignal.summary || topSignal.content || '',
+                        confidenceDelta: topSignal.confidenceDelta || topSignal.confidence_delta || 0,
+                        evaluatedAt: topSignal.evaluatedAt || topSignal.evaluated_at || topSignal.createdAt || '',
+                        why: topScore > 1 ? 'Largest confidence movement in this period'
+                            : topScore > 0 ? 'Most substantive evaluation (no confidence change)'
+                                : 'Most recent evaluation',
+                    };
+                }
+                output.items = items;
                 return {
-                    content: [{ type: 'text', text: JSON.stringify(result, null, 2) }],
+                    content: [{ type: 'text', text: JSON.stringify(output, null, 2) }],
+                    details: {},
+                };
+            },
+        },
+        {
+            name: 'get_changes',
+            label: 'Get Changes',
+            description: 'Get recent market changes detected server-side. Returns real price moves (>5¢), new contracts, and removed/settled contracts across Kalshi, Polymarket, and traditional markets. Checked every 15 minutes. Use for situational awareness, discovering new opportunities, or checking if anything material happened recently.',
+            parameters: Type.Object({
+                hours: Type.Optional(Type.Number({ description: 'Hours of history (default 1)' })),
+            }),
+            execute: async (_toolCallId, params) => {
+                const hours = params.hours || 1;
+                const since = new Date(Date.now() - hours * 60 * 60 * 1000).toISOString();
+                const apiUrl = process.env.SF_API_URL || 'https://simplefunctions.dev';
+                const res = await fetch(`${apiUrl}/api/changes?since=${encodeURIComponent(since)}&limit=100`);
+                if (!res.ok) {
+                    return { content: [{ type: 'text', text: JSON.stringify({ error: `API error ${res.status}` }) }], details: {} };
+                }
+                const data = await res.json();
+                return {
+                    content: [{ type: 'text', text: JSON.stringify(data, null, 2) }],
                     details: {},
                 };
             },
@@ -1537,7 +1641,13 @@ async function agentCommand(thesisId, opts) {
             }), { description: 'Node probability overrides' }),
         }),
         execute: async (_toolCallId, params) => {
-            // Inline what-if simulation
+            // Refresh context before simulation to avoid stale confidence values
+            if (resolvedThesisId) {
+                try {
+                    latestContext = await sfClient.getContext(resolvedThesisId);
+                }
+                catch { }
+            }
             const ctx = latestContext;
             const allNodes = [];
             function flatten(nodes) {
@@ -1551,10 +1661,28 @@ async function agentCommand(thesisId, opts) {
             flatten(rawNodes);
             const treeNodes = rawNodes.filter((n) => n.depth === 0 || (n.depth === undefined && !n.id.includes('.')));
             const overrideMap = new Map(params.overrides.map((o) => [o.nodeId, o.newProbability]));
+            // Propagate child node overrides to parent nodes.
+            // If n2.2 is overridden, recalculate n2's effective probability
+            // as the average of its children's (possibly overridden) probabilities.
+            function effectiveProb(node) {
+                // Direct override on this node
+                if (overrideMap.has(node.id))
+                    return overrideMap.get(node.id);
+                // If node has children, aggregate from children
+                if (node.children?.length > 0) {
+                    const childProbs = node.children.map((c) => effectiveProb(c));
+                    const childImps = node.children.map((c) => c.importance || 1);
+                    const totalImp = childImps.reduce((s, w) => s + w, 0);
+                    if (totalImp > 0) {
+                        return childProbs.reduce((s, p, i) => s + p * childImps[i], 0) / totalImp;
+                    }
+                    return childProbs.reduce((s, p) => s + p, 0) / childProbs.length;
+                }
+                return node.probability ?? 0;
+            }
             const oldConf = treeNodes.reduce((s, n) => s + (n.probability || 0) * (n.importance || 0), 0);
             const newConf = treeNodes.reduce((s, n) => {
-                const p = overrideMap.get(n.id) ?? n.probability ?? 0;
-                return s + p * (n.importance || 0);
+                return s + effectiveProb(n) * (n.importance || 0);
             }, 0);
             const nodeScales = new Map();
             for (const [nid, np] of overrideMap.entries()) {
@@ -1589,12 +1717,20 @@ async function agentCommand(thesisId, opts) {
                     signal: Math.abs(newEdge - oldEdge) < 1 ? 'unchanged' : (oldEdge > 0 && newEdge < 0) || (oldEdge < 0 && newEdge > 0) ? 'REVERSED' : Math.abs(newEdge) < 2 ? 'GONE' : 'reduced',
                 };
             }).filter((e) => e.signal !== 'unchanged');
+            // Server confidence = LLM's holistic assessment (includes factors beyond the tree)
+            // Tree confidence = weighted sum of node probabilities (pure math from causal tree)
+            // These measure different things and will often differ.
+            const serverConf = ctx.confidence != null ? Math.round(Number(ctx.confidence) * 100) : null;
             const result = {
                 overrides: params.overrides.map((o) => {
                     const node = allNodes.find((n) => n.id === o.nodeId);
                     return { nodeId: o.nodeId, label: node?.label || o.nodeId, oldProb: node?.probability, newProb: o.newProbability };
                 }),
-                confidence: { old: Math.round(oldConf * 100), new: Math.round(newConf * 100), delta: Math.round((newConf - oldConf) * 100) },
+                serverConfidence: serverConf,
+                treeConfidence: { old: Math.round(oldConf * 100), new: Math.round(newConf * 100), delta: Math.round((newConf - oldConf) * 100) },
+                note: serverConf != null && Math.abs(serverConf - Math.round(oldConf * 100)) > 5
+                    ? `serverConfidence (${serverConf}%) differs from treeConfidence (${Math.round(oldConf * 100)}%) because the LLM evaluation considers factors beyond the causal tree.`
+                    : undefined,
                 affectedEdges: edges,
             };
             return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }], details: {} };
@@ -2071,7 +2207,7 @@ ${topEdges}
             }
         }
         if (event.type === 'tool_execution_start') {
-            const toolLine = new MutableLine(C.zinc600(`  \u26A1 ${event.toolName}...`));
+            const toolLine = new MutableLine(C.zinc600(`  \u25B8 ${event.toolName}...`));
             toolStartTimes.set(event.toolCallId || event.toolName, Date.now());
             toolLines.set(event.toolCallId || event.toolName, toolLine);
             chatContainer.addChild(toolLine);
@@ -2090,7 +2226,7 @@ ${topEdges}
                     line.setText(C.red(`  \u2717 ${event.toolName} (${elapsed}s) error`));
                 }
                 else {
-                    line.setText(C.zinc600(`  \u26A1 ${event.toolName}`) + C.emerald(` \u2713`) + C.zinc600(` (${elapsed}s)`));
+                    line.setText(C.zinc600(`  \u25B8 ${event.toolName} `) + C.emerald(`\u2713`) + C.zinc600(` ${elapsed}s`));
                 }
             }
             toolStartTimes.delete(key);
@@ -2121,6 +2257,10 @@ ${topEdges}
                         C.emerald('/sell      ') + C.zinc400('TICKER QTY PRICE \u2014 quick sell') + '\n' +
                         C.emerald('/cancel    ') + C.zinc400('ORDER_ID \u2014 cancel order') + '\n' +
                         C.zinc600('\u2500'.repeat(30)) + '\n') : '') +
+                    (skills.length > 0 ? (C.zinc600('\u2500'.repeat(30)) + '\n' +
+                        C.zinc200(bold('Skills')) + '\n' +
+                        skills.map(s => C.emerald(`/${s.name.padEnd(10)}`) + C.zinc400(s.description.slice(0, 45))).join('\n') + '\n' +
+                        C.zinc600('\u2500'.repeat(30)) + '\n') : '') +
                     C.emerald('/clear     ') + C.zinc400('Clear screen (keeps history)') + '\n' +
                     C.emerald('/exit      ') + C.zinc400('Exit (auto-saves)'));
                 addSpacer();
@@ -2603,8 +2743,29 @@ Output a structured summary. Be concise but preserve every important detail —
                 cleanup();
                 return true;
             }
-            default:
+            default: {
+                // Check if it's a skill trigger
+                const skill = skills.find(s => s.trigger === command);
+                if (skill) {
+                    addSpacer();
+                    addSystemText(C.zinc200(`Running skill: ${bold(skill.name)}`) + C.zinc600(` \u2014 ${skill.description.slice(0, 60)}`));
+                    addSpacer();
+                    tui.requestRender();
+                    // Inject the skill prompt → agent executes using existing tools
+                    isProcessing = true;
+                    try {
+                        await agent.prompt(skill.prompt);
+                    }
+                    catch (err) {
+                        addSystemText(C.red(`Skill error: ${err.message}`));
+                    }
+                    finally {
+                        isProcessing = false;
+                    }
+                    return true;
+                }
                 return false;
+            }
         }
     }
     // ── Editor submit handler ──────────────────────────────────────────────────
@@ -3184,42 +3345,71 @@ async function runPlainTextAgent(params) {
         {
             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.',
+            description: 'Get orderbook depth, spread, and liquidity. Returns a status field per market: "ok", "empty_orderbook", "market_closed", or "api_error". Supports multiple tickers in one call — use tickers array for batch position checks.',
             parameters: Type.Object({
-                ticker: Type.Optional(Type.String({ description: 'Kalshi market ticker (e.g. KXWTIMAX-26DEC31-T135)' })),
+                ticker: Type.Optional(Type.String({ description: 'Single Kalshi market ticker (e.g. KXWTIMAX-26DEC31-T135)' })),
+                tickers: Type.Optional(Type.Array(Type.String(), { description: 'Multiple Kalshi tickers for batch check (e.g. ["T$135", "T$140", "T$150"])' })),
                 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) {
+                // Batch: expand tickers array into individual lookups
+                const tickerList = [];
+                if (params.tickers?.length)
+                    tickerList.push(...params.tickers);
+                else if (params.ticker)
+                    tickerList.push(params.ticker);
+                for (const tkr of tickerList) {
                     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,
-                        });
+                        const market = await (0, client_js_1.kalshiFetchMarket)(tkr);
+                        const mStatus = market.status || 'unknown';
+                        if (mStatus !== 'open' && mStatus !== 'active') {
+                            results.push({
+                                venue: 'kalshi', ticker: tkr, title: market.title,
+                                status: 'market_closed', reason: `Market status: ${mStatus}. Orderbook unavailable for closed/settled markets.`,
+                                lastPrice: Math.round(parseFloat(market.last_price_dollars || '0') * 100),
+                            });
+                        }
+                        else {
+                            const ob = await (0, kalshi_js_1.getPublicOrderbook)(tkr);
+                            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);
+                            if (yesBids.length === 0 && noAsks.length === 0) {
+                                results.push({
+                                    venue: 'kalshi', ticker: tkr, title: market.title,
+                                    status: 'empty_orderbook', reason: 'Market open but no resting orders. Normal for illiquid/OTM contracts. Use lastPrice as reference.',
+                                    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,
+                                });
+                            }
+                            else {
+                                const bestBid = yesBids[0]?.price || 0;
+                                const bestAsk = noAsks.length > 0 ? (100 - noAsks[0].price) : (yesBids[0] ? yesBids[0].price + 1 : 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: tkr, title: market.title, status: 'ok',
+                                    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: {} };
+                        results.push({ venue: 'kalshi', ticker: tkr, status: 'api_error', reason: `Kalshi API error: ${err.message}` });
                     }
                 }
                 if (params.polyQuery) {
@@ -3327,18 +3517,61 @@ async function runPlainTextAgent(params) {
         {
             name: 'get_feed',
             label: 'Get Feed',
-            description: 'Get evaluation history / activity feed. Shows recent evaluations, signals, and changes across theses.',
+            description: 'Get evaluation history with topSignal highlighting. The most important signal is surfaced first.',
             parameters: Type.Object({
                 hours: Type.Optional(Type.Number({ description: 'Hours of history to fetch (default 24)' })),
             }),
             execute: async (_id, p) => {
                 const result = await sfClient.getFeed(p.hours || 24);
+                const items = Array.isArray(result) ? result : (result?.evaluations || result?.items || []);
+                let topSignal = null;
+                let topScore = 0;
+                for (const item of items) {
+                    let score = 0;
+                    const delta = Math.abs(item.confidenceDelta || item.confidence_delta || 0);
+                    if (delta > 0)
+                        score = delta * 100;
+                    else if (item.summary?.length > 50)
+                        score = 0.1;
+                    if (score > topScore) {
+                        topScore = score;
+                        topSignal = item;
+                    }
+                }
+                const output = { total: items.length };
+                if (topSignal) {
+                    output.topSignal = {
+                        summary: topSignal.summary || topSignal.content || '',
+                        confidenceDelta: topSignal.confidenceDelta || topSignal.confidence_delta || 0,
+                        evaluatedAt: topSignal.evaluatedAt || topSignal.evaluated_at || '',
+                        why: topScore > 1 ? 'Largest confidence movement' : topScore > 0 ? 'Most substantive (no confidence change)' : 'Most recent',
+                    };
+                }
+                output.items = items;
                 return {
-                    content: [{ type: 'text', text: JSON.stringify(result, null, 2) }],
+                    content: [{ type: 'text', text: JSON.stringify(output, null, 2) }],
                     details: {},
                 };
             },
         },
+        {
+            name: 'get_changes',
+            label: 'Get Changes',
+            description: 'Get recent market changes detected server-side. Returns real price moves (>5¢), new contracts, and removed/settled contracts across Kalshi, Polymarket, and traditional markets. Use for situational awareness and discovering new opportunities.',
+            parameters: Type.Object({
+                hours: Type.Optional(Type.Number({ description: 'Hours of history (default 1)' })),
+            }),
+            execute: async (_id, p) => {
+                const hours = p.hours || 1;
+                const since = new Date(Date.now() - hours * 60 * 60 * 1000).toISOString();
+                const apiUrl = process.env.SF_API_URL || 'https://simplefunctions.dev';
+                const res = await fetch(`${apiUrl}/api/changes?since=${encodeURIComponent(since)}&limit=100`);
+                if (!res.ok)
+                    return { content: [{ type: 'text', text: JSON.stringify({ error: `API error ${res.status}` }) }], details: {} };
+                const data = await res.json();
+                return { content: [{ type: 'text', text: JSON.stringify(data, null, 2) }], details: {} };
+            },
+        },
         {
             name: 'explore_public',
             label: 'Explore Public Theses',
@@ -3783,7 +4016,7 @@ ${ctx.lastEvaluation?.summary ? `Latest eval: ${ctx.lastEvaluation.summary.slice
             }
         }
         if (event.type === 'tool_execution_start') {
-            process.stderr.write(`  \u26A1 ${event.toolName}...\n`);
+            process.stderr.write(`  \u25B8 ${event.toolName}...\n`);
         }
         if (event.type === 'tool_execution_end') {
             const status = event.isError ? '\u2717' : '\u2713';

package/dist/commands/balance.js

@@ -6,7 +6,7 @@ const utils_js_1 = require("../utils.js");
 async function balanceCommand(opts) {
     const result = await (0, kalshi_js_1.getBalance)();
     if (!result)
-        throw new Error('Kalshi not configured. Set KALSHI_API_KEY_ID + KALSHI_PRIVATE_KEY_PATH.');
+        throw new Error('Kalshi not configured. Run: sf setup --kalshi');
     if (opts.json) {
         console.log(JSON.stringify(result, null, 2));
         return;

package/dist/commands/book.js

@@ -152,7 +152,7 @@ async function bookCommand(tickers, opts) {
         }
     }
     if (results.length === 0) {
-        console.log(`${utils_js_1.c.dim}No markets found.${utils_js_1.c.reset}`);
+        console.log(`\n  ${utils_js_1.c.dim}No markets found. Check the ticker and try again.${utils_js_1.c.reset}\n`);
         return;
     }
     // ── JSON output ──

package/dist/commands/context.d.ts

@@ -1,5 +1,6 @@
 export declare function contextCommand(id: string | undefined, opts: {
     json?: boolean;
+    share?: boolean;
     apiKey?: string;
     apiUrl?: string;
 }): Promise<void>;

package/dist/commands/context.js

@@ -4,6 +4,7 @@ exports.contextCommand = contextCommand;
 const client_js_1 = require("../client.js");
 const kalshi_js_1 = require("../kalshi.js");
 const utils_js_1 = require("../utils.js");
+const share_js_1 = require("../share.js");
 const SF_API_URL = process.env.SF_API_URL || 'https://simplefunctions.dev';
 async function contextCommand(id, opts) {
     // ── Mode 1: No thesis ID → global market intelligence ─────────────────────
@@ -14,6 +15,10 @@ async function contextCommand(id, opts) {
             return;
         }
         const data = await res.json();
+        if (opts.share) {
+            await (0, share_js_1.shareOutput)('context', '', data);
+            return;
+        }
         if (opts.json) {
             console.log(JSON.stringify(data, null, 2));
             return;

package/dist/commands/edges.d.ts

@@ -13,6 +13,7 @@
  */
 interface EdgesOpts {
     json?: boolean;
+    share?: boolean;
     limit?: string;
     thesis?: string;
     minEdge?: string;