@spfunctions/cli 0.1.4 → 0.1.6

package/dist/commands/agent.d.ts

@@ -0,0 +1,18 @@
+/**
+ * sf agent — Interactive TUI agent powered by pi-tui + pi-agent-core.
+ *
+ * Layout:
+ *   [Header overlay]  — thesis id, confidence, model
+ *   [Spacer]          — room for header
+ *   [Chat container]  — messages (user, assistant, tool, system)
+ *   [Editor]          — multi-line input with slash command autocomplete
+ *   [Spacer]          — room for footer
+ *   [Footer overlay]  — tokens, cost, tool count, /help hint
+ *
+ * Slash commands (bypass LLM):
+ *   /help   /tree   /edges   /pos   /eval   /model   /clear   /exit
+ */
+export declare function agentCommand(thesisId?: string, opts?: {
+    model?: string;
+    modelKey?: string;
+}): Promise<void>;

package/dist/commands/agent.js

@@ -0,0 +1,829 @@
+"use strict";
+/**
+ * sf agent — Interactive TUI agent powered by pi-tui + pi-agent-core.
+ *
+ * Layout:
+ *   [Header overlay]  — thesis id, confidence, model
+ *   [Spacer]          — room for header
+ *   [Chat container]  — messages (user, assistant, tool, system)
+ *   [Editor]          — multi-line input with slash command autocomplete
+ *   [Spacer]          — room for footer
+ *   [Footer overlay]  — tokens, cost, tool count, /help hint
+ *
+ * Slash commands (bypass LLM):
+ *   /help   /tree   /edges   /pos   /eval   /model   /clear   /exit
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.agentCommand = agentCommand;
+const client_js_1 = require("../client.js");
+const kalshi_js_1 = require("../kalshi.js");
+// ─── ANSI 24-bit color helpers (no chalk dependency) ─────────────────────────
+const rgb = (r, g, b) => (s) => `\x1b[38;2;${r};${g};${b}m${s}\x1b[39m`;
+const bgRgb = (r, g, b) => (s) => `\x1b[48;2;${r};${g};${b}m${s}\x1b[49m`;
+const bold = (s) => `\x1b[1m${s}\x1b[22m`;
+const dim = (s) => `\x1b[2m${s}\x1b[22m`;
+const italic = (s) => `\x1b[3m${s}\x1b[23m`;
+const underline = (s) => `\x1b[4m${s}\x1b[24m`;
+const strikethrough = (s) => `\x1b[9m${s}\x1b[29m`;
+const C = {
+    emerald: rgb(16, 185, 129), // #10b981
+    zinc200: rgb(228, 228, 231), // #e4e4e7
+    zinc400: rgb(161, 161, 170), // #a1a1aa
+    zinc600: rgb(82, 82, 91), // #52525b
+    zinc800: rgb(39, 39, 42), // #27272a
+    red: rgb(239, 68, 68), // #ef4444
+    amber: rgb(245, 158, 11), // #f59e0b
+    white: rgb(255, 255, 255),
+    bgZinc900: bgRgb(24, 24, 27), // #18181b
+    bgZinc800: bgRgb(39, 39, 42), // #27272a
+};
+// ─── Custom components ───────────────────────────────────────────────────────
+/** Mutable single-line component (TruncatedText is immutable) */
+function createMutableLine(piTui) {
+    const { truncateToWidth, visibleWidth } = piTui;
+    return class MutableLine {
+        text;
+        cachedWidth;
+        cachedLines;
+        constructor(text) {
+            this.text = text;
+        }
+        setText(text) {
+            this.text = text;
+            this.cachedWidth = undefined;
+            this.cachedLines = undefined;
+        }
+        invalidate() {
+            this.cachedWidth = undefined;
+            this.cachedLines = undefined;
+        }
+        render(width) {
+            if (this.cachedLines && this.cachedWidth === width)
+                return this.cachedLines;
+            this.cachedWidth = width;
+            this.cachedLines = [truncateToWidth(this.text, width)];
+            return this.cachedLines;
+        }
+    };
+}
+/** Header bar: [SF Agent — {id}]  [{confidence}%]  [{model}] */
+function createHeaderBar(piTui) {
+    const { truncateToWidth, visibleWidth } = piTui;
+    return class HeaderBar {
+        left;
+        center;
+        right;
+        cachedWidth;
+        cachedLines;
+        constructor(left, center, right) {
+            this.left = left;
+            this.center = center;
+            this.right = right;
+        }
+        update(left, center, right) {
+            if (left !== undefined)
+                this.left = left;
+            if (center !== undefined)
+                this.center = center;
+            if (right !== undefined)
+                this.right = right;
+            this.cachedWidth = undefined;
+            this.cachedLines = undefined;
+        }
+        invalidate() {
+            this.cachedWidth = undefined;
+            this.cachedLines = undefined;
+        }
+        render(width) {
+            if (this.cachedLines && this.cachedWidth === width)
+                return this.cachedLines;
+            this.cachedWidth = width;
+            const l = this.left;
+            const c = this.center;
+            const r = this.right;
+            const lw = visibleWidth(l);
+            const cw = visibleWidth(c);
+            const rw = visibleWidth(r);
+            const totalContent = lw + cw + rw;
+            const totalPad = Math.max(0, width - totalContent);
+            const leftPad = Math.max(1, Math.floor(totalPad / 2));
+            const rightPad = Math.max(1, totalPad - leftPad);
+            let line = l + ' '.repeat(leftPad) + c + ' '.repeat(rightPad) + r;
+            line = C.bgZinc900(truncateToWidth(line, width, ''));
+            // Pad to full width for background
+            const lineVw = visibleWidth(line);
+            if (lineVw < width) {
+                line = line + C.bgZinc900(' '.repeat(width - lineVw));
+            }
+            this.cachedLines = [line];
+            return this.cachedLines;
+        }
+    };
+}
+/** Footer bar: [tokens: N | cost: $N | tools: N]  [/help] */
+function createFooterBar(piTui) {
+    const { truncateToWidth, visibleWidth } = piTui;
+    return class FooterBar {
+        tokens = 0;
+        cost = 0;
+        toolCount = 0;
+        cachedWidth;
+        cachedLines;
+        invalidate() {
+            this.cachedWidth = undefined;
+            this.cachedLines = undefined;
+        }
+        update() {
+            this.cachedWidth = undefined;
+            this.cachedLines = undefined;
+        }
+        render(width) {
+            if (this.cachedLines && this.cachedWidth === width)
+                return this.cachedLines;
+            this.cachedWidth = width;
+            const tokStr = this.tokens >= 1000
+                ? `${(this.tokens / 1000).toFixed(1)}k`
+                : `${this.tokens}`;
+            const leftText = C.zinc600(`tokens: ${tokStr}  cost: $${this.cost.toFixed(3)}  tools: ${this.toolCount}`);
+            const rightText = C.zinc600('/help');
+            const lw = visibleWidth(leftText);
+            const rw = visibleWidth(rightText);
+            const gap = Math.max(1, width - lw - rw);
+            let line = leftText + ' '.repeat(gap) + rightText;
+            line = C.bgZinc900(truncateToWidth(line, width, ''));
+            const lineVw = visibleWidth(line);
+            if (lineVw < width) {
+                line = line + C.bgZinc900(' '.repeat(width - lineVw));
+            }
+            this.cachedLines = [line];
+            return this.cachedLines;
+        }
+    };
+}
+// ─── Formatted renderers ─────────────────────────────────────────────────────
+function renderCausalTree(context, piTui) {
+    const tree = context.causalTree;
+    if (!tree?.nodes?.length)
+        return C.zinc600('  No causal tree data');
+    const lines = [];
+    for (const node of tree.nodes) {
+        const id = node.id || '';
+        const label = node.label || node.description || '';
+        const prob = typeof node.probability === 'number'
+            ? Math.round(node.probability * 100)
+            : (typeof node.impliedProbability === 'number' ? Math.round(node.impliedProbability * 100) : null);
+        const depth = (id.match(/\./g) || []).length;
+        const indent = '  '.repeat(depth + 1);
+        if (prob !== null) {
+            // Progress bar: 10 chars
+            const filled = Math.round(prob / 10);
+            const bar = '\u2588'.repeat(filled) + '\u2591'.repeat(10 - filled);
+            const probColor = prob >= 70 ? C.emerald : prob >= 40 ? C.amber : C.red;
+            // Dots to pad between label and percentage
+            const labelPart = `${indent}${C.zinc600(id)}  ${C.zinc400(label)} `;
+            const probPart = ` ${probColor(`${prob}%`)}  ${probColor(bar)}`;
+            lines.push(labelPart + probPart);
+        }
+        else {
+            lines.push(`${indent}${C.zinc600(id)}  ${C.zinc400(label)}`);
+        }
+    }
+    return lines.join('\n');
+}
+function renderEdges(context, piTui) {
+    const edges = context.edges;
+    if (!edges?.length)
+        return C.zinc600('  No edge data');
+    const positions = context._positions || [];
+    const lines = [];
+    for (const e of edges) {
+        const name = (e.marketTitle || e.ticker || '').slice(0, 18).padEnd(18);
+        const market = typeof e.marketPrice === 'number' ? `${e.marketPrice}\u00A2` : '?';
+        const thesis = typeof e.thesisImpliedPrice === 'number' ? `${e.thesisImpliedPrice}\u00A2` : '?';
+        const edge = typeof e.edgeSize === 'number' ? (e.edgeSize > 0 ? `+${e.edgeSize}` : `${e.edgeSize}`) : '?';
+        const spread = typeof e.spread === 'number' ? `${e.spread}\u00A2` : '?';
+        const liq = e.liquidityScore || 'low';
+        const liqBars = liq === 'high' ? '\u25A0\u25A0\u25A0' : liq === 'medium' ? '\u25A0\u25A0 ' : '\u25A0  ';
+        const liqColor = liq === 'high' ? C.emerald : liq === 'medium' ? C.amber : C.red;
+        // Check if we have a position on this edge
+        const pos = positions.find((p) => p.ticker === e.ticker);
+        let posStr = C.zinc600('\u2014');
+        if (pos) {
+            const side = pos.side?.toUpperCase() || 'YES';
+            const pnl = typeof pos.unrealized_pnl === 'number'
+                ? (pos.unrealized_pnl >= 0 ? C.emerald(`+$${(pos.unrealized_pnl / 100).toFixed(0)}`) : C.red(`-$${(Math.abs(pos.unrealized_pnl) / 100).toFixed(0)}`))
+                : '';
+            posStr = C.emerald(`${side} (${pos.quantity}@${pos.average_price_paid}\u00A2 ${pnl})`);
+        }
+        lines.push(`  ${C.zinc200(name)} ${C.zinc400(market)} \u2192 ${C.zinc400(thesis)}  edge ${edge.includes('+') ? C.emerald(edge) : C.red(edge)}  spread ${C.zinc600(spread)}  ${liqColor(liqBars)} ${liqColor(liq.padEnd(4))}  ${posStr}`);
+    }
+    return lines.join('\n');
+}
+function renderPositions(positions) {
+    if (!positions?.length)
+        return C.zinc600('  No positions');
+    const lines = [];
+    let totalPnl = 0;
+    for (const p of positions) {
+        const ticker = (p.ticker || '').slice(0, 18).padEnd(18);
+        const side = (p.side || 'yes').toUpperCase().padEnd(3);
+        const qty = String(p.quantity || 0);
+        const avg = `${p.average_price_paid || 0}\u00A2`;
+        const now = typeof p.current_value === 'number' && p.current_value > 0
+            ? `${p.current_value}\u00A2`
+            : '?\u00A2';
+        const pnlCents = p.unrealized_pnl || 0;
+        totalPnl += pnlCents;
+        const pnlDollars = (pnlCents / 100).toFixed(2);
+        const pnlStr = pnlCents >= 0
+            ? C.emerald(`+$${pnlDollars}`)
+            : C.red(`-$${Math.abs(parseFloat(pnlDollars)).toFixed(2)}`);
+        const arrow = pnlCents >= 0 ? C.emerald('\u25B2') : C.red('\u25BC');
+        lines.push(`  ${C.zinc200(ticker)} ${C.zinc400(side)}  ${C.zinc400(qty)} @ ${C.zinc400(avg)}  now ${C.zinc200(now)}  ${pnlStr}  ${arrow}`);
+    }
+    const totalDollars = (totalPnl / 100).toFixed(2);
+    lines.push(C.zinc600('  ' + '\u2500'.repeat(40)));
+    lines.push(totalPnl >= 0
+        ? `  Total P&L: ${C.emerald(bold(`+$${totalDollars}`))}`
+        : `  Total P&L: ${C.red(bold(`-$${Math.abs(parseFloat(totalDollars)).toFixed(2)}`))}`);
+    return lines.join('\n');
+}
+// ─── Main command ────────────────────────────────────────────────────────────
+async function agentCommand(thesisId, opts) {
+    // ── Dynamic imports (all ESM-only packages) ────────────────────────────────
+    const piTui = await import('@mariozechner/pi-tui');
+    const piAi = await import('@mariozechner/pi-ai');
+    const piAgent = await import('@mariozechner/pi-agent-core');
+    const { TUI, ProcessTerminal, Container, Text, Markdown, Editor, Loader, Spacer, CombinedAutocompleteProvider, truncateToWidth, visibleWidth, } = piTui;
+    const { getModel, streamSimple, Type } = piAi;
+    const { Agent } = piAgent;
+    // ── Component class factories (need piTui ref) ─────────────────────────────
+    const MutableLine = createMutableLine(piTui);
+    const HeaderBar = createHeaderBar(piTui);
+    const FooterBar = createFooterBar(piTui);
+    // ── Validate API keys ──────────────────────────────────────────────────────
+    const openrouterKey = opts?.modelKey || process.env.OPENROUTER_API_KEY;
+    if (!openrouterKey) {
+        console.error('Need OpenRouter API key. Set OPENROUTER_API_KEY or use --model-key.');
+        process.exit(1);
+    }
+    const sfClient = new client_js_1.SFClient();
+    // ── Resolve thesis ID ──────────────────────────────────────────────────────
+    let resolvedThesisId = thesisId;
+    if (!resolvedThesisId) {
+        const data = await sfClient.listTheses();
+        const theses = data.theses || data;
+        const active = theses.find((t) => t.status === 'active');
+        if (!active) {
+            console.error('No active thesis. Create one first: sf create "..."');
+            process.exit(1);
+        }
+        resolvedThesisId = active.id;
+    }
+    // ── Fetch initial context ──────────────────────────────────────────────────
+    let latestContext = await sfClient.getContext(resolvedThesisId);
+    // ── Model setup ────────────────────────────────────────────────────────────
+    const rawModelName = opts?.model || 'anthropic/claude-sonnet-4-20250514';
+    let currentModelName = rawModelName.replace(/^openrouter\//, '');
+    function resolveModel(name) {
+        try {
+            return getModel('openrouter', name);
+        }
+        catch {
+            return {
+                modelId: name,
+                provider: 'openrouter',
+                api: 'openai-completions',
+                baseUrl: 'https://openrouter.ai/api/v1',
+                id: name,
+                name: name,
+                inputPrice: 0,
+                outputPrice: 0,
+                contextWindow: 200000,
+                supportsImages: true,
+                supportsTools: true,
+            };
+        }
+    }
+    let model = resolveModel(currentModelName);
+    // ── Tracking state ─────────────────────────────────────────────────────────
+    let totalTokens = 0;
+    let totalCost = 0;
+    let totalToolCalls = 0;
+    let isProcessing = false;
+    // Cache for positions (fetched by /pos or get_positions tool)
+    let cachedPositions = null;
+    // ── Setup TUI ──────────────────────────────────────────────────────────────
+    const terminal = new ProcessTerminal();
+    const tui = new TUI(terminal);
+    // Markdown theme for assistant messages
+    const mdTheme = {
+        heading: (s) => C.zinc200(bold(s)),
+        link: (s) => C.emerald(s),
+        linkUrl: (s) => C.zinc600(s),
+        code: (s) => C.zinc200(s),
+        codeBlock: (s) => C.zinc400(s),
+        codeBlockBorder: (s) => C.zinc600(s),
+        quote: (s) => C.zinc400(s),
+        quoteBorder: (s) => C.zinc600(s),
+        hr: (s) => C.zinc600(s),
+        listBullet: (s) => C.emerald(s),
+        bold: (s) => bold(s),
+        italic: (s) => italic(s),
+        strikethrough: (s) => strikethrough(s),
+        underline: (s) => underline(s),
+    };
+    const mdDefaultStyle = {
+        color: (s) => C.zinc400(s),
+    };
+    // Editor theme
+    const editorTheme = {
+        borderColor: (s) => C.zinc800(s),
+        selectList: {
+            selectedPrefix: (s) => C.emerald(s),
+            selectedText: (s) => C.zinc200(s),
+            description: (s) => C.zinc600(s),
+            scrollInfo: (s) => C.zinc600(s),
+            noMatch: (s) => C.zinc600(s),
+        },
+    };
+    // ── Build components ───────────────────────────────────────────────────────
+    const shortId = (resolvedThesisId || '').slice(0, 8);
+    const confidencePct = typeof latestContext.confidence === 'number'
+        ? Math.round(latestContext.confidence * 100)
+        : (typeof latestContext.confidence === 'string' ? parseInt(latestContext.confidence) : 0);
+    const headerBar = new HeaderBar(C.emerald(bold('SF Agent')) + C.zinc600(` \u2014 ${shortId}`), confidencePct > 0 ? C.zinc200(`${confidencePct}%`) : '', C.zinc600(currentModelName.split('/').pop() || currentModelName));
+    const footerBar = new FooterBar();
+    const topSpacer = new Spacer(1);
+    const bottomSpacer = new Spacer(1);
+    const chatContainer = new Container();
+    const editor = new Editor(tui, editorTheme, { paddingX: 1 });
+    // Slash command autocomplete
+    const autocompleteProvider = new CombinedAutocompleteProvider([
+        { name: 'help', description: 'Show available commands' },
+        { name: 'tree', description: 'Display causal tree' },
+        { name: 'edges', description: 'Display edge/spread table' },
+        { name: 'pos', description: 'Display Kalshi positions' },
+        { name: 'eval', description: 'Trigger deep evaluation' },
+        { name: 'model', description: 'Switch model (e.g. /model anthropic/claude-sonnet-4)' },
+        { name: 'clear', description: 'Clear chat' },
+        { name: 'exit', description: 'Exit agent' },
+    ], process.cwd());
+    editor.setAutocompleteProvider(autocompleteProvider);
+    // Assemble TUI tree
+    tui.addChild(topSpacer);
+    tui.addChild(chatContainer);
+    tui.addChild(editor);
+    tui.addChild(bottomSpacer);
+    // Focus on editor
+    tui.setFocus(editor);
+    // ── Overlays (pinned header + footer) ──────────────────────────────────────
+    const headerOverlay = tui.showOverlay(headerBar, {
+        row: 0,
+        col: 0,
+        width: '100%',
+        nonCapturing: true,
+    });
+    const footerOverlay = tui.showOverlay(footerBar, {
+        anchor: 'bottom-left',
+        width: '100%',
+        nonCapturing: true,
+    });
+    // ── Helper: add system text to chat ────────────────────────────────────────
+    function addSystemText(content) {
+        const text = new Text(content, 1, 0);
+        chatContainer.addChild(text);
+        tui.requestRender();
+    }
+    function addSpacer() {
+        chatContainer.addChild(new Spacer(1));
+    }
+    // ── Define agent tools (same as before) ────────────────────────────────────
+    const thesisIdParam = Type.Object({
+        thesisId: Type.String({ description: 'Thesis ID (short or full UUID)' }),
+    });
+    const signalParams = Type.Object({
+        thesisId: Type.String({ description: 'Thesis ID' }),
+        content: Type.String({ description: 'Signal content' }),
+        type: Type.Optional(Type.String({ description: 'Signal type: news, user_note, external. Default: user_note' })),
+    });
+    const scanParams = Type.Object({
+        query: Type.Optional(Type.String({ description: 'Keyword search for Kalshi markets' })),
+        series: Type.Optional(Type.String({ description: 'Kalshi series ticker (e.g. KXWTIMAX)' })),
+        market: Type.Optional(Type.String({ description: 'Specific market ticker' })),
+    });
+    const emptyParams = Type.Object({});
+    const tools = [
+        {
+            name: 'get_context',
+            label: 'Get Context',
+            description: 'Get thesis snapshot: causal tree, edge prices, last evaluation, confidence',
+            parameters: thesisIdParam,
+            execute: async (_toolCallId, params) => {
+                const ctx = await sfClient.getContext(params.thesisId);
+                latestContext = ctx;
+                // Update header with new confidence
+                const conf = typeof ctx.confidence === 'number'
+                    ? Math.round(ctx.confidence * 100)
+                    : 0;
+                headerBar.update(undefined, conf > 0 ? C.zinc200(`${conf}%`) : '', undefined);
+                tui.requestRender();
+                return {
+                    content: [{ type: 'text', text: JSON.stringify(ctx, null, 2) }],
+                    details: {},
+                };
+            },
+        },
+        {
+            name: 'inject_signal',
+            label: 'Inject Signal',
+            description: 'Inject a signal into the thesis (news, note, external event)',
+            parameters: signalParams,
+            execute: async (_toolCallId, params) => {
+                const result = await sfClient.injectSignal(params.thesisId, params.type || 'user_note', params.content);
+                return {
+                    content: [{ type: 'text', text: JSON.stringify(result) }],
+                    details: {},
+                };
+            },
+        },
+        {
+            name: 'trigger_evaluation',
+            label: 'Evaluate',
+            description: 'Trigger a deep evaluation cycle (heavy model, takes longer)',
+            parameters: thesisIdParam,
+            execute: async (_toolCallId, params) => {
+                const result = await sfClient.evaluate(params.thesisId);
+                return {
+                    content: [{ type: 'text', text: JSON.stringify(result) }],
+                    details: {},
+                };
+            },
+        },
+        {
+            name: 'scan_markets',
+            label: 'Scan Markets',
+            description: 'Search Kalshi prediction markets: by keywords, series ticker, or specific market ticker',
+            parameters: scanParams,
+            execute: async (_toolCallId, params) => {
+                let result;
+                if (params.market) {
+                    result = await (0, client_js_1.kalshiFetchMarket)(params.market);
+                }
+                else if (params.series) {
+                    result = await (0, client_js_1.kalshiFetchMarketsBySeries)(params.series);
+                }
+                else if (params.query) {
+                    const series = await (0, client_js_1.kalshiFetchAllSeries)();
+                    const keywords = params.query.toLowerCase().split(/\s+/);
+                    const matched = series
+                        .filter((s) => keywords.some((kw) => (s.title || '').toLowerCase().includes(kw) ||
+                        (s.ticker || '').toLowerCase().includes(kw)))
+                        .slice(0, 15);
+                    result = matched;
+                }
+                else {
+                    result = { error: 'Provide query, series, or market parameter' };
+                }
+                return {
+                    content: [{ type: 'text', text: JSON.stringify(result, null, 2) }],
+                    details: {},
+                };
+            },
+        },
+        {
+            name: 'list_theses',
+            label: 'List Theses',
+            description: 'List all theses for the current user',
+            parameters: emptyParams,
+            execute: async () => {
+                const theses = await sfClient.listTheses();
+                return {
+                    content: [{ type: 'text', text: JSON.stringify(theses, null, 2) }],
+                    details: {},
+                };
+            },
+        },
+        {
+            name: 'get_positions',
+            label: 'Get Positions',
+            description: 'Get Kalshi exchange positions with live prices and PnL',
+            parameters: emptyParams,
+            execute: async () => {
+                const positions = await (0, kalshi_js_1.getPositions)();
+                if (!positions) {
+                    return {
+                        content: [{ type: 'text', text: 'Kalshi not configured. Set KALSHI_API_KEY_ID and KALSHI_PRIVATE_KEY_PATH.' }],
+                        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;
+                return {
+                    content: [{ type: 'text', text: JSON.stringify(positions, null, 2) }],
+                    details: {},
+                };
+            },
+        },
+    ];
+    // ── System prompt ──────────────────────────────────────────────────────────
+    const systemPrompt = `You are a SimpleFunctions prediction market trading assistant.
+
+Current thesis: ${latestContext.thesis || latestContext.rawThesis || 'N/A'}
+Confidence: ${confidencePct}%
+Status: ${latestContext.status}
+Thesis ID: ${latestContext.thesisId || resolvedThesisId}
+
+You have six tools available. Use them when you need real-time data. Answer directly when you don't.
+Be concise. Use Chinese if the user writes in Chinese, English if they write in English.
+Do NOT make up data. Always call tools to get current state.`;
+    // ── Create Agent ───────────────────────────────────────────────────────────
+    const agent = new Agent({
+        initialState: {
+            systemPrompt,
+            model,
+            tools,
+            thinkingLevel: 'off',
+        },
+        streamFn: streamSimple,
+        getApiKey: (provider) => {
+            if (provider === 'openrouter')
+                return openrouterKey;
+            return undefined;
+        },
+    });
+    // ── Subscribe to agent events → update TUI ────────────────────────────────
+    let currentAssistantMd = null;
+    let currentAssistantText = '';
+    let currentLoader = null;
+    const toolStartTimes = new Map();
+    const toolLines = new Map();
+    agent.subscribe((event) => {
+        if (event.type === 'message_start') {
+            // Show loader while waiting for first text
+            currentAssistantText = '';
+            currentAssistantMd = null;
+            currentLoader = new Loader(tui, (s) => C.emerald(s), (s) => C.zinc600(s), 'thinking...');
+            currentLoader.start();
+            chatContainer.addChild(currentLoader);
+            tui.requestRender();
+        }
+        if (event.type === 'message_update') {
+            const e = event.assistantMessageEvent;
+            if (e.type === 'text_delta') {
+                // Remove loader on first text delta
+                if (currentLoader) {
+                    currentLoader.stop();
+                    chatContainer.removeChild(currentLoader);
+                    currentLoader = null;
+                    // Create markdown component for assistant response
+                    currentAssistantMd = new Markdown('', 1, 0, mdTheme, mdDefaultStyle);
+                    chatContainer.addChild(currentAssistantMd);
+                }
+                currentAssistantText += e.delta;
+                if (currentAssistantMd) {
+                    currentAssistantMd.setText(currentAssistantText);
+                }
+                tui.requestRender();
+            }
+        }
+        if (event.type === 'message_complete') {
+            // Clean up loader if still present (no text was generated)
+            if (currentLoader) {
+                currentLoader.stop();
+                chatContainer.removeChild(currentLoader);
+                currentLoader = null;
+            }
+            // Add spacer after message
+            addSpacer();
+            currentAssistantMd = null;
+            currentAssistantText = '';
+            isProcessing = false;
+            tui.requestRender();
+            // Update token/cost tracking from event if available
+            if (event.usage) {
+                totalTokens += (event.usage.inputTokens || 0) + (event.usage.outputTokens || 0);
+                totalCost += event.usage.totalCost || 0;
+                footerBar.tokens = totalTokens;
+                footerBar.cost = totalCost;
+                footerBar.update();
+            }
+        }
+        if (event.type === 'tool_execution_start') {
+            const toolLine = new MutableLine(C.zinc600(`  \u26A1 ${event.toolName}...`));
+            toolStartTimes.set(event.toolCallId || event.toolName, Date.now());
+            toolLines.set(event.toolCallId || event.toolName, toolLine);
+            chatContainer.addChild(toolLine);
+            totalToolCalls++;
+            footerBar.toolCount = totalToolCalls;
+            footerBar.update();
+            tui.requestRender();
+        }
+        if (event.type === 'tool_execution_end') {
+            const key = event.toolCallId || event.toolName;
+            const startTime = toolStartTimes.get(key);
+            const elapsed = startTime ? ((Date.now() - startTime) / 1000).toFixed(1) : '?';
+            const line = toolLines.get(key);
+            if (line) {
+                if (event.isError) {
+                    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)`));
+                }
+            }
+            toolStartTimes.delete(key);
+            toolLines.delete(key);
+            tui.requestRender();
+        }
+    });
+    // ── Slash command handlers ─────────────────────────────────────────────────
+    async function handleSlashCommand(cmd) {
+        const parts = cmd.trim().split(/\s+/);
+        const command = parts[0].toLowerCase();
+        switch (command) {
+            case '/help': {
+                addSpacer();
+                addSystemText(C.zinc200(bold('Commands')) + '\n' +
+                    C.emerald('/help    ') + C.zinc400('  Show this help') + '\n' +
+                    C.emerald('/tree    ') + C.zinc400('  Display causal tree') + '\n' +
+                    C.emerald('/edges   ') + C.zinc400('  Display edge/spread table') + '\n' +
+                    C.emerald('/pos     ') + C.zinc400('  Display Kalshi positions') + '\n' +
+                    C.emerald('/eval    ') + C.zinc400('  Trigger deep evaluation') + '\n' +
+                    C.emerald('/model   ') + C.zinc400('  Switch model (e.g. /model anthropic/claude-sonnet-4)') + '\n' +
+                    C.emerald('/clear   ') + C.zinc400('  Clear chat') + '\n' +
+                    C.emerald('/exit    ') + C.zinc400('  Exit agent'));
+                addSpacer();
+                return true;
+            }
+            case '/tree': {
+                addSpacer();
+                // Refresh context first
+                try {
+                    latestContext = await sfClient.getContext(resolvedThesisId);
+                    addSystemText(C.zinc200(bold('Causal Tree')) + '\n' + renderCausalTree(latestContext, piTui));
+                }
+                catch (err) {
+                    addSystemText(C.red(`Error: ${err.message}`));
+                }
+                addSpacer();
+                return true;
+            }
+            case '/edges': {
+                addSpacer();
+                try {
+                    latestContext = await sfClient.getContext(resolvedThesisId);
+                    // Attach cached positions for display
+                    if (cachedPositions) {
+                        latestContext._positions = cachedPositions;
+                    }
+                    addSystemText(C.zinc200(bold('Edges')) + '\n' + renderEdges(latestContext, piTui));
+                }
+                catch (err) {
+                    addSystemText(C.red(`Error: ${err.message}`));
+                }
+                addSpacer();
+                return true;
+            }
+            case '/pos': {
+                addSpacer();
+                try {
+                    const positions = await (0, kalshi_js_1.getPositions)();
+                    if (!positions) {
+                        addSystemText(C.zinc600('Kalshi not configured'));
+                        return true;
+                    }
+                    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;
+                    addSystemText(C.zinc200(bold('Positions')) + '\n' + renderPositions(positions));
+                }
+                catch (err) {
+                    addSystemText(C.red(`Error: ${err.message}`));
+                }
+                addSpacer();
+                return true;
+            }
+            case '/eval': {
+                addSpacer();
+                addSystemText(C.zinc600('Triggering evaluation...'));
+                tui.requestRender();
+                try {
+                    const result = await sfClient.evaluate(resolvedThesisId);
+                    addSystemText(C.emerald('Evaluation complete') + '\n' + C.zinc400(JSON.stringify(result, null, 2)));
+                }
+                catch (err) {
+                    addSystemText(C.red(`Error: ${err.message}`));
+                }
+                addSpacer();
+                return true;
+            }
+            case '/model': {
+                const newModel = parts.slice(1).join(' ').trim();
+                if (!newModel) {
+                    addSystemText(C.zinc400(`Current model: ${currentModelName}`));
+                    return true;
+                }
+                addSpacer();
+                currentModelName = newModel.replace(/^openrouter\//, '');
+                model = resolveModel(currentModelName);
+                // Update agent model
+                agent.setModel(model);
+                headerBar.update(undefined, undefined, C.zinc600(currentModelName.split('/').pop() || currentModelName));
+                addSystemText(C.emerald(`Model switched to ${currentModelName}`));
+                addSpacer();
+                tui.requestRender();
+                return true;
+            }
+            case '/clear': {
+                chatContainer.clear();
+                tui.requestRender();
+                return true;
+            }
+            case '/exit':
+            case '/quit': {
+                cleanup();
+                return true;
+            }
+            default:
+                return false;
+        }
+    }
+    // ── Editor submit handler ──────────────────────────────────────────────────
+    editor.onSubmit = async (input) => {
+        const trimmed = input.trim();
+        if (!trimmed)
+            return;
+        if (isProcessing)
+            return;
+        // Add to editor history
+        editor.addToHistory(trimmed);
+        // Check for slash commands
+        if (trimmed.startsWith('/')) {
+            const handled = await handleSlashCommand(trimmed);
+            if (handled)
+                return;
+        }
+        // Regular message → send to agent
+        isProcessing = true;
+        // Add user message to chat
+        const userMsg = new Text(C.emerald(bold('>')) + ' ' + C.white(trimmed), 1, 0);
+        chatContainer.addChild(userMsg);
+        addSpacer();
+        tui.requestRender();
+        try {
+            await agent.prompt(trimmed);
+        }
+        catch (err) {
+            // Remove loader if present
+            if (currentLoader) {
+                currentLoader.stop();
+                chatContainer.removeChild(currentLoader);
+                currentLoader = null;
+            }
+            addSystemText(C.red(`Error: ${err.message}`));
+            addSpacer();
+            isProcessing = false;
+        }
+    };
+    // ── Ctrl+C handler ─────────────────────────────────────────────────────────
+    function cleanup() {
+        if (currentLoader)
+            currentLoader.stop();
+        tui.stop();
+        process.exit(0);
+    }
+    // Listen for Ctrl+C at the TUI level
+    tui.addInputListener((data) => {
+        // Ctrl+C = \x03
+        if (data === '\x03') {
+            cleanup();
+            return { consume: true };
+        }
+        return undefined;
+    });
+    // Also handle SIGINT
+    process.on('SIGINT', cleanup);
+    process.on('SIGTERM', cleanup);
+    // ── Show initial welcome ───────────────────────────────────────────────────
+    const thesisText = latestContext.thesis || latestContext.rawThesis || 'N/A';
+    const truncatedThesis = thesisText.length > 120 ? thesisText.slice(0, 120) + '...' : thesisText;
+    addSystemText(C.zinc600('\u2500'.repeat(50)) + '\n' +
+        C.zinc200(bold(truncatedThesis)) + '\n' +
+        C.zinc600(`${latestContext.status || 'active'}  ${confidencePct > 0 ? confidencePct + '%' : ''}  ${(latestContext.edges || []).length} edges`) + '\n' +
+        C.zinc600('\u2500'.repeat(50)));
+    addSpacer();
+    // ── Start TUI ──────────────────────────────────────────────────────────────
+    tui.start();
+}

package/dist/index.js

@@ -25,6 +25,7 @@ const signal_js_1 = require("./commands/signal.js");
 const evaluate_js_1 = require("./commands/evaluate.js");
 const scan_js_1 = require("./commands/scan.js");
 const positions_js_1 = require("./commands/positions.js");
+const agent_js_1 = require("./commands/agent.js");
 const utils_js_1 = require("./utils.js");
 const program = new commander_1.Command();
 program
@@ -130,6 +131,16 @@ program
         apiUrl: g.apiUrl,
     }));
 });
+// ── sf agent [thesisId] ───────────────────────────────────────────────────────
+program
+    .command('agent [thesisId]')
+    .description('Interactive agent mode — natural language interface to SimpleFunctions')
+    .option('--model <model>', 'Model via OpenRouter (default: anthropic/claude-sonnet-4-20250514)')
+    .option('--model-key <key>', 'OpenRouter API key (or set OPENROUTER_API_KEY)')
+    .action(async (thesisId, opts, cmd) => {
+    const g = cmd.optsWithGlobals();
+    await run(() => (0, agent_js_1.agentCommand)(thesisId, { model: opts.model, modelKey: opts.modelKey }));
+});
 // ── Error wrapper ─────────────────────────────────────────────────────────────
 async function run(fn) {
     try {

package/dist/kalshi.js

@@ -104,9 +104,6 @@ async function getPositions() {
         return null;
     try {
         const data = await kalshiAuthGet('/portfolio/positions');
-        // DEBUG: dump raw Kalshi response to see actual field names
-        console.log('[Kalshi DEBUG] Raw /portfolio/positions response:');
-        console.log(JSON.stringify(data, null, 2));
         // Kalshi returns { market_positions: [...] } or { positions: [...] }
         const raw = data.market_positions || data.positions || [];
         return raw.map((p) => {

package/package.json

@@ -1,16 +1,19 @@
 {
   "name": "@spfunctions/cli",
-  "version": "0.1.4",
+  "version": "0.1.6",
   "description": "CLI for SimpleFunctions prediction market thesis agent",
   "bin": {
     "sf": "./dist/index.js"
   },
   "scripts": {
-    "build": "tsc",
+    "build": "node ./node_modules/typescript/bin/tsc",
     "dev": "tsx src/index.ts",
     "prepublishOnly": "npm run build"
   },
   "dependencies": {
+    "@mariozechner/pi-agent-core": "^0.57.1",
+    "@mariozechner/pi-ai": "^0.57.1",
+    "@mariozechner/pi-tui": "^0.57.1",
     "commander": "^12.0.0",
     "kalshi-typescript": "^3.9.0"
   },