@spfunctions/cli 1.7.10 → 1.7.12

package/dist/commands/agent.js

@@ -465,35 +465,46 @@ async function selectThesis(theses) {
 // ─── Main command ────────────────────────────────────────────────────────────
 async function agentCommand(thesisId, opts) {
     // ── Validate API keys ──────────────────────────────────────────────────────
-    const openrouterKey = opts?.modelKey || process.env.OPENROUTER_API_KEY;
+    const directOrKey = opts?.modelKey || process.env.OPENROUTER_API_KEY;
+    const sfApiKey = process.env.SF_API_KEY;
+    const sfApiUrl = process.env.SF_API_URL || 'https://simplefunctions.dev';
+    // Proxy mode: no local OpenRouter key, but have SF API key → route through server
+    const useProxy = !directOrKey && !!sfApiKey;
+    const openrouterKey = directOrKey || sfApiKey; // SF key used as Bearer for proxy
+    const llmBaseUrl = useProxy ? `${sfApiUrl}/api/proxy` : 'https://openrouter.ai/api/v1';
     if (!openrouterKey) {
-        console.error('Need OpenRouter API key to power the agent LLM.');
+        console.error('Need an API key to power the agent LLM.');
         console.error('');
-        console.error('  1. Get a key at https://openrouter.ai/keys');
-        console.error('  2. Then either:');
+        console.error('  Option 1 (recommended): sf login');
+        console.error('  Option 2: Get an OpenRouter key at https://openrouter.ai/keys');
         console.error('     export OPENROUTER_API_KEY=sk-or-v1-...');
         console.error('     sf agent --model-key sk-or-v1-...');
         console.error('     sf setup  (saves to ~/.sf/config.json)');
         process.exit(1);
     }
-    // Pre-flight: validate OpenRouter key
-    try {
-        const checkRes = await fetch('https://openrouter.ai/api/v1/auth/key', {
-            headers: { 'Authorization': `Bearer ${openrouterKey}` },
-            signal: AbortSignal.timeout(8000),
-        });
-        if (!checkRes.ok) {
-            console.error('OpenRouter API key is invalid or expired.');
-            console.error('Get a new key at https://openrouter.ai/keys');
-            process.exit(1);
+    // Pre-flight: validate key (skip for proxy mode — server validates)
+    if (!useProxy) {
+        try {
+            const checkRes = await fetch('https://openrouter.ai/api/v1/auth/key', {
+                headers: { 'Authorization': `Bearer ${openrouterKey}` },
+                signal: AbortSignal.timeout(8000),
+            });
+            if (!checkRes.ok) {
+                console.error('OpenRouter API key is invalid or expired.');
+                console.error('Get a new key at https://openrouter.ai/keys');
+                process.exit(1);
+            }
         }
-    }
-    catch (err) {
-        const msg = err instanceof Error ? err.message : String(err);
-        if (!msg.includes('timeout')) {
-            console.warn(`Warning: Could not verify OpenRouter key (${msg}). Continuing anyway.`);
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            if (!msg.includes('timeout')) {
+                console.warn(`Warning: Could not verify OpenRouter key (${msg}). Continuing anyway.`);
+            }
         }
     }
+    else {
+        console.log('  \x1b[2mUsing SimpleFunctions LLM proxy (no OpenRouter key needed)\x1b[22m');
+    }
     const sfClient = new client_js_1.SFClient();
     // ── Resolve thesis ID (interactive selection if needed) ─────────────────────
     let resolvedThesisId = thesisId;
@@ -536,7 +547,7 @@ async function agentCommand(thesisId, opts) {
     let latestContext = await sfClient.getContext(resolvedThesisId);
     // ── Branch: plain-text mode ────────────────────────────────────────────────
     if (opts?.noTui) {
-        return runPlainTextAgent({ openrouterKey, sfClient, resolvedThesisId: resolvedThesisId, latestContext, opts });
+        return runPlainTextAgent({ openrouterKey, sfClient, resolvedThesisId: resolvedThesisId, latestContext, useProxy, llmBaseUrl, sfApiKey, sfApiUrl, opts });
     }
     // ── Dynamic imports (all ESM-only packages) ────────────────────────────────
     const piTui = await import('@mariozechner/pi-tui');
@@ -552,11 +563,12 @@ async function agentCommand(thesisId, opts) {
     const rawModelName = opts?.model || 'anthropic/claude-sonnet-4.6';
     let currentModelName = rawModelName.replace(/^openrouter\//, '');
     function resolveModel(name) {
+        let m;
         try {
-            return getModel('openrouter', name);
+            m = getModel('openrouter', name);
         }
         catch {
-            return {
+            m = {
                 modelId: name,
                 provider: 'openrouter',
                 api: 'openai-completions',
@@ -570,6 +582,10 @@ async function agentCommand(thesisId, opts) {
                 supportsTools: true,
             };
         }
+        // Override baseUrl in proxy mode
+        if (useProxy)
+            m.baseUrl = llmBaseUrl;
+        return m;
     }
     let model = resolveModel(currentModelName);
     // ── Tracking state ─────────────────────────────────────────────────────────
@@ -958,24 +974,45 @@ async function agentCommand(thesisId, opts) {
             description: 'Search latest news and information. Use for real-time info not yet covered by the causal tree or heartbeat engine.',
             parameters: webSearchParams,
             execute: async (_toolCallId, params) => {
-                const apiKey = process.env.TAVILY_API_KEY;
-                if (!apiKey) {
+                const tavilyKey = process.env.TAVILY_API_KEY;
+                const canProxy = !tavilyKey && sfApiKey;
+                if (!tavilyKey && !canProxy) {
                     return {
-                        content: [{ type: 'text', text: 'Tavily not configured. Set TAVILY_API_KEY to enable web search. You can also manually inject a signal and let the heartbeat engine search.' }],
+                        content: [{ type: 'text', text: 'Web search not available. Run sf login (proxied search) or set TAVILY_API_KEY.' }],
                         details: {},
                     };
                 }
-                const res = await fetch('https://api.tavily.com/search', {
-                    method: 'POST',
-                    headers: { 'Content-Type': 'application/json' },
-                    body: JSON.stringify({
-                        api_key: apiKey,
-                        query: params.query,
-                        max_results: 5,
-                        search_depth: 'basic',
-                        include_answer: true,
-                    }),
-                });
+                let res;
+                if (tavilyKey) {
+                    // Direct mode
+                    res = await fetch('https://api.tavily.com/search', {
+                        method: 'POST',
+                        headers: { 'Content-Type': 'application/json' },
+                        body: JSON.stringify({
+                            api_key: tavilyKey,
+                            query: params.query,
+                            max_results: 5,
+                            search_depth: 'basic',
+                            include_answer: true,
+                        }),
+                    });
+                }
+                else {
+                    // Proxy mode
+                    res = await fetch(`${sfApiUrl}/api/proxy/search`, {
+                        method: 'POST',
+                        headers: {
+                            'Content-Type': 'application/json',
+                            'Authorization': `Bearer ${sfApiKey}`,
+                        },
+                        body: JSON.stringify({
+                            query: params.query,
+                            max_results: 5,
+                            search_depth: 'basic',
+                            include_answer: true,
+                        }),
+                    });
+                }
                 if (!res.ok) {
                     return {
                         content: [{ type: 'text', text: `Search failed: ${res.status}` }],
@@ -2152,7 +2189,19 @@ ${ctx.lastEvaluation?.summary ? `Latest evaluation summary: ${ctx.lastEvaluation
 Output a structured summary. Be concise but preserve every important detail — this summary replaces the original messages for continued conversation. Do NOT add commentary or meta-text. Just the summary.`;
                     let summaryText;
                     try {
-                        const orRes = await fetch('https://openrouter.ai/api/v1/chat/completions', {
+                        const compactUrl = useProxy
+                            ? `${sfApiUrl}/api/proxy/llm`
+                            : 'https://openrouter.ai/api/v1/chat/completions';
+                        const compactBody = {
+                            model: summaryModel,
+                            messages: [
+                                { role: 'system', content: summarySystemPrompt },
+                                { role: 'user', content: `Summarize this conversation (${toCompress.length} messages):\n\n${conversationDump}` },
+                            ],
+                            max_tokens: 2000,
+                            temperature: 0.2,
+                        };
+                        const orRes = await fetch(compactUrl, {
                             method: 'POST',
                             headers: {
                                 'Content-Type': 'application/json',
@@ -2160,15 +2209,7 @@ Output a structured summary. Be concise but preserve every important detail —
                                 'HTTP-Referer': 'https://simplefunctions.com',
                                 'X-Title': 'SF Agent Compact',
                             },
-                            body: JSON.stringify({
-                                model: summaryModel,
-                                messages: [
-                                    { role: 'system', content: summarySystemPrompt },
-                                    { role: 'user', content: `Summarize this conversation (${toCompress.length} messages):\n\n${conversationDump}` },
-                                ],
-                                max_tokens: 2000,
-                                temperature: 0.2,
-                            }),
+                            body: JSON.stringify(compactBody),
                         });
                         if (!orRes.ok) {
                             const errText = await orRes.text().catch(() => '');
@@ -2581,7 +2622,7 @@ Output a structured summary. Be concise but preserve every important detail —
 // PLAIN-TEXT MODE (--no-tui)
 // ============================================================================
 async function runPlainTextAgent(params) {
-    const { openrouterKey, sfClient, resolvedThesisId, opts } = params;
+    const { openrouterKey, sfClient, resolvedThesisId, opts, useProxy, llmBaseUrl, sfApiKey, sfApiUrl } = params;
     let latestContext = params.latestContext;
     const readline = await import('readline');
     const piAi = await import('@mariozechner/pi-ai');
@@ -2591,17 +2632,21 @@ async function runPlainTextAgent(params) {
     const rawModelName = opts?.model || 'anthropic/claude-sonnet-4.6';
     let currentModelName = rawModelName.replace(/^openrouter\//, '');
     function resolveModel(name) {
+        let m;
         try {
-            return getModel('openrouter', name);
+            m = getModel('openrouter', name);
         }
         catch {
-            return {
+            m = {
                 modelId: name, provider: 'openrouter', api: 'openai-completions',
                 baseUrl: 'https://openrouter.ai/api/v1', id: name, name,
                 inputPrice: 0, outputPrice: 0, contextWindow: 200000,
                 supportsImages: true, supportsTools: true,
             };
         }
+        if (useProxy)
+            m.baseUrl = llmBaseUrl;
+        return m;
     }
     let model = resolveModel(currentModelName);
     // ── Tools (same definitions as TUI mode) ──────────────────────────────────
@@ -2739,13 +2784,23 @@ async function runPlainTextAgent(params) {
             description: 'Search latest news and information',
             parameters: webSearchParams,
             execute: async (_id, p) => {
-                const apiKey = process.env.TAVILY_API_KEY;
-                if (!apiKey)
-                    return { content: [{ type: 'text', text: 'Tavily not configured. Set TAVILY_API_KEY.' }], details: {} };
-                const res = await fetch('https://api.tavily.com/search', {
-                    method: 'POST', headers: { 'Content-Type': 'application/json' },
-                    body: JSON.stringify({ api_key: apiKey, query: p.query, max_results: 5, search_depth: 'basic', include_answer: true }),
-                });
+                const tavilyKey2 = process.env.TAVILY_API_KEY;
+                const canProxy2 = !tavilyKey2 && sfApiKey;
+                if (!tavilyKey2 && !canProxy2)
+                    return { content: [{ type: 'text', text: 'Web search not available. Run sf login or set TAVILY_API_KEY.' }], details: {} };
+                let res;
+                if (tavilyKey2) {
+                    res = await fetch('https://api.tavily.com/search', {
+                        method: 'POST', headers: { 'Content-Type': 'application/json' },
+                        body: JSON.stringify({ api_key: tavilyKey2, query: p.query, max_results: 5, search_depth: 'basic', include_answer: true }),
+                    });
+                }
+                else {
+                    res = await fetch(`${sfApiUrl}/api/proxy/search`, {
+                        method: 'POST', headers: { 'Content-Type': 'application/json', 'Authorization': `Bearer ${sfApiKey}` },
+                        body: JSON.stringify({ query: p.query, max_results: 5, search_depth: 'basic', include_answer: true }),
+                    });
+                }
                 if (!res.ok)
                     return { content: [{ type: 'text', text: `Search failed: ${res.status}` }], details: {} };
                 const data = await res.json();

package/dist/commands/context.js

@@ -4,10 +4,11 @@ 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 SF_API_URL = process.env.SF_API_URL || 'https://simplefunctions.dev';
 async function contextCommand(id, opts) {
-    // No thesis ID → global market snapshot
+    // ── Mode 1: No thesis ID → global market intelligence ─────────────────────
     if (!id) {
-        const res = await fetch('https://simplefunctions.dev/api/public/context');
+        const res = await fetch(`${opts.apiUrl || SF_API_URL}/api/public/context`);
         if (!res.ok) {
             console.error(`  Error: ${res.status} ${await res.text()}`);
             return;
@@ -17,63 +18,109 @@ async function contextCommand(id, opts) {
             console.log(JSON.stringify(data, null, 2));
             return;
         }
-        console.log(`\n${utils_js_1.c.bold}Market Snapshot${utils_js_1.c.reset}  ${(0, utils_js_1.shortDate)(data.snapshotAt)}\n`);
-        if (data.edges?.length > 0) {
-            console.log(`${utils_js_1.c.bold}Thesis Edges${utils_js_1.c.reset}`);
-            for (const m of data.edges.slice(0, 10)) {
-                const venue = m.venue === 'kalshi' ? `${utils_js_1.c.cyan}K${utils_js_1.c.reset}` : `${utils_js_1.c.magenta}P${utils_js_1.c.reset}`;
-                const edgeStr = m.edge > 0 ? `${utils_js_1.c.green}+${m.edge}¢${utils_js_1.c.reset}` : `${utils_js_1.c.red}${m.edge}¢${utils_js_1.c.reset}`;
-                console.log(`  ${venue} ${String(m.price).padStart(3)}¢  edge ${edgeStr.padStart(14)}  ${m.title.slice(0, 50)}`);
-            }
+        const scanTime = data.scannedAt ? (0, utils_js_1.shortDate)(data.scannedAt) : 'no scan yet';
+        const meta = data.meta || {};
+        console.log();
+        console.log(`${utils_js_1.c.bold}Markets${utils_js_1.c.reset}  ${utils_js_1.c.dim}${meta.totalMarkets || 0} markets (K:${meta.kalshiMarkets || 0} P:${meta.polymarketMarkets || 0}) · scan: ${scanTime}${utils_js_1.c.reset}`);
+        console.log();
+        // ── Traditional markets ────────────────────────────────────────────────
+        const trad = data.traditional || [];
+        if (trad.length > 0) {
+            const line = trad.map((m) => {
+                const ch = m.changePct || 0;
+                const color = ch > 0 ? utils_js_1.c.green : ch < 0 ? utils_js_1.c.red : utils_js_1.c.dim;
+                const sign = ch > 0 ? '+' : '';
+                return `${utils_js_1.c.bold}${m.symbol}${utils_js_1.c.reset} ${m.price}  ${color}${sign}${ch.toFixed(1)}%${utils_js_1.c.reset}`;
+            }).join('    ');
+            console.log(`  ${line}`);
             console.log();
         }
-        if (data.movers?.length > 0) {
-            console.log(`${utils_js_1.c.bold}Movers (24h)${utils_js_1.c.reset}`);
-            for (const m of data.movers.slice(0, 8)) {
-                const venue = m.venue === 'kalshi' ? `${utils_js_1.c.cyan}K${utils_js_1.c.reset}` : `${utils_js_1.c.magenta}P${utils_js_1.c.reset}`;
-                const ch = m.change24h > 0 ? `${utils_js_1.c.green}+${m.change24h}¢${utils_js_1.c.reset}` : `${utils_js_1.c.red}${m.change24h}¢${utils_js_1.c.reset}`;
-                console.log(`  ${venue} ${String(m.price).padStart(3)}¢ ${ch.padStart(16)}  ${m.title.slice(0, 55)}`);
+        // ── Highlights (cross-category stories) ────────────────────────────────
+        const highlights = data.highlights || [];
+        if (highlights.length > 0) {
+            console.log(`${utils_js_1.c.bold}${utils_js_1.c.cyan}Highlights${utils_js_1.c.reset}`);
+            for (const h of highlights) {
+                console.log(`  ${utils_js_1.c.bold}${h.title}${utils_js_1.c.reset}`);
+                console.log(`  ${utils_js_1.c.dim}${h.detail}${utils_js_1.c.reset}`);
+                if (h.relatedTickers?.length > 0) {
+                    console.log(`  ${utils_js_1.c.dim}tickers: ${h.relatedTickers.join(', ')}${utils_js_1.c.reset}`);
+                }
+                console.log(`  ${utils_js_1.c.cyan}→ ${h.suggestedAction}${utils_js_1.c.reset}`);
+                console.log();
             }
-            console.log();
         }
-        if (data.milestones?.length > 0) {
-            console.log(`${utils_js_1.c.bold}Upcoming (48h)${utils_js_1.c.reset}`);
-            for (const m of data.milestones.slice(0, 8)) {
-                console.log(`  ${utils_js_1.c.dim}${String(m.hoursUntil).padStart(3)}h${utils_js_1.c.reset}  ${m.title.slice(0, 55)}  ${utils_js_1.c.dim}${m.category}${utils_js_1.c.reset}`);
+        // ── Categories ─────────────────────────────────────────────────────────
+        const cats = data.categories || [];
+        if (cats.length > 0) {
+            console.log(`${utils_js_1.c.bold}Categories${utils_js_1.c.reset}  ${utils_js_1.c.dim}(${cats.length} total)${utils_js_1.c.reset}`);
+            console.log(`${utils_js_1.c.dim}${'─'.repeat(70)}${utils_js_1.c.reset}`);
+            for (const cat of cats) {
+                const desc = cat.description ? `  ${utils_js_1.c.dim}${cat.description}${utils_js_1.c.reset}` : '';
+                console.log(`\n  ${utils_js_1.c.bold}${cat.name}${utils_js_1.c.reset}  ${utils_js_1.c.dim}${cat.marketCount} mkts · vol ${(0, utils_js_1.vol)(cat.totalVolume24h)}${utils_js_1.c.reset}${desc}`);
+                // Top movers in category
+                const movers = cat.topMovers || [];
+                if (movers.length > 0) {
+                    for (const m of movers) {
+                        const venue = m.venue === 'kalshi' ? `${utils_js_1.c.cyan}K${utils_js_1.c.reset}` : `${utils_js_1.c.magenta}P${utils_js_1.c.reset}`;
+                        const ch = m.change24h || 0;
+                        const chColor = ch > 0 ? utils_js_1.c.green : ch < 0 ? utils_js_1.c.red : utils_js_1.c.dim;
+                        const chStr = ch !== 0 ? `${chColor}${ch > 0 ? '+' : ''}${ch}¢${utils_js_1.c.reset}` : '';
+                        console.log(`    ${venue} ${(0, utils_js_1.rpad)(`${m.price}¢`, 5)} ${(0, utils_js_1.rpad)(chStr, 14)} ${(0, utils_js_1.trunc)(m.title, 45)}  ${utils_js_1.c.dim}${m.ticker.slice(0, 18)}${utils_js_1.c.reset}`);
+                        if (m.whyInteresting) {
+                            console.log(`      ${utils_js_1.c.dim}${m.whyInteresting}${utils_js_1.c.reset}`);
+                        }
+                    }
+                }
+                // Most liquid
+                const liquid = cat.mostLiquid || [];
+                if (liquid.length > 0) {
+                    for (const m of liquid) {
+                        const venue = m.venue === 'kalshi' ? `${utils_js_1.c.cyan}K${utils_js_1.c.reset}` : `${utils_js_1.c.magenta}P${utils_js_1.c.reset}`;
+                        console.log(`    ${venue} ${(0, utils_js_1.rpad)(`${m.price}¢`, 5)} spread ${m.spread}¢  vol ${(0, utils_js_1.vol)(Math.round(m.volume24h))}  ${utils_js_1.c.dim}${(0, utils_js_1.trunc)(m.title, 35)}${utils_js_1.c.reset}`);
+                    }
+                }
             }
             console.log();
         }
-        if (data.liquid?.length > 0) {
-            console.log(`${utils_js_1.c.bold}Liquid${utils_js_1.c.reset}`);
-            for (const m of data.liquid.slice(0, 8)) {
-                const venue = m.venue === 'kalshi' ? `${utils_js_1.c.cyan}K${utils_js_1.c.reset}` : `${utils_js_1.c.magenta}P${utils_js_1.c.reset}`;
-                console.log(`  ${venue} ${String(m.price).padStart(3)}¢  spread ${m.spread}¢  ${m.title.slice(0, 55)}`);
+        // ── Thesis edges ───────────────────────────────────────────────────────
+        const edges = data.edges || [];
+        if (edges.length > 0) {
+            console.log(`${utils_js_1.c.bold}Thesis Edges${utils_js_1.c.reset}`);
+            for (const e of edges.slice(0, 6)) {
+                const venue = e.venue === 'kalshi' ? `${utils_js_1.c.cyan}K${utils_js_1.c.reset}` : `${utils_js_1.c.magenta}P${utils_js_1.c.reset}`;
+                const edgeColor = e.edge > 0 ? utils_js_1.c.green : utils_js_1.c.red;
+                console.log(`  ${venue} ${(0, utils_js_1.rpad)(`${e.price}¢`, 5)}  ${edgeColor}edge ${e.edge > 0 ? '+' : ''}${e.edge}¢${utils_js_1.c.reset}  ${(0, utils_js_1.trunc)(e.title, 40)}  ${utils_js_1.c.dim}${e.thesisSlug || ''}${utils_js_1.c.reset}`);
             }
             console.log();
         }
-        if (data.signals?.length > 0) {
-            console.log(`${utils_js_1.c.bold}Recent Signals${utils_js_1.c.reset}`);
-            for (const s of data.signals.slice(0, 5)) {
-                const d = s.confidenceDelta > 0 ? `${utils_js_1.c.green}▲${s.confidenceDelta}${utils_js_1.c.reset}` : s.confidenceDelta < 0 ? `${utils_js_1.c.red}▼${s.confidenceDelta}${utils_js_1.c.reset}` : `${s.confidenceDelta}`;
-                console.log(`  ${d} ${s.confidence}%  ${s.summary.slice(0, 60)}`);
-                console.log(`  ${utils_js_1.c.dim}${s.thesisTitle.slice(0, 40)}  ${(0, utils_js_1.shortDate)(s.evaluatedAt)}${utils_js_1.c.reset}`);
+        // ── Recent evaluations ─────────────────────────────────────────────────
+        const signals = data.signals || [];
+        if (signals.length > 0) {
+            console.log(`${utils_js_1.c.bold}Recent Evaluations${utils_js_1.c.reset}`);
+            for (const s of signals.slice(0, 5)) {
+                const d = s.confidenceDelta;
+                const dStr = d > 0 ? `${utils_js_1.c.green}+${d}%${utils_js_1.c.reset}` : d < 0 ? `${utils_js_1.c.red}${d}%${utils_js_1.c.reset}` : `${utils_js_1.c.dim}0%${utils_js_1.c.reset}`;
+                const ago = timeAgo(s.evaluatedAt);
+                console.log(`  ${(0, utils_js_1.rpad)(ago, 5)} ${(0, utils_js_1.rpad)(s.thesisSlug || '?', 18)} ${(0, utils_js_1.rpad)(dStr, 14)} ${(0, utils_js_1.trunc)(s.summary, 50)}`);
             }
             console.log();
         }
-        console.log(`  ${utils_js_1.c.dim}Create a thesis for focused context: sf create "your market view"${utils_js_1.c.reset}\n`);
+        // ── Actions ────────────────────────────────────────────────────────────
+        console.log(`${utils_js_1.c.dim}${'─'.repeat(60)}${utils_js_1.c.reset}`);
+        console.log(`  ${utils_js_1.c.cyan}sf query${utils_js_1.c.reset} "topic"       ${utils_js_1.c.dim}ask anything${utils_js_1.c.reset}`);
+        console.log(`  ${utils_js_1.c.cyan}sf scan${utils_js_1.c.reset} "keywords"     ${utils_js_1.c.dim}search markets${utils_js_1.c.reset}`);
+        console.log(`  ${utils_js_1.c.cyan}sf explore${utils_js_1.c.reset}             ${utils_js_1.c.dim}public theses${utils_js_1.c.reset}`);
+        console.log(`  ${utils_js_1.c.cyan}sf create${utils_js_1.c.reset} "thesis"     ${utils_js_1.c.dim}start monitoring${utils_js_1.c.reset}`);
+        console.log();
         return;
     }
+    // ── Mode 2: Thesis-specific context (requires API key) ────────────────────
     const client = new client_js_1.SFClient(opts.apiKey, opts.apiUrl);
     const ctx = await client.getContext(id);
     if (opts.json) {
         console.log(JSON.stringify(ctx, null, 2));
         return;
     }
-    // Context API shape:
-    // { thesisId, thesis, title, status, confidence (number|null),
-    //   causalTree: { nodes: FlatNode[] }, edges: Edge[], edgeMeta,
-    //   lastEvaluation: { summary, confidenceDelta, ... }, updatedAt, ... }
-    // Thesis header
     console.log(`\n${utils_js_1.c.bold}Thesis:${utils_js_1.c.reset} ${ctx.thesis || ctx.rawThesis || '(unknown)'}`);
     const confStr = ctx.confidence !== null && ctx.confidence !== undefined ? (0, utils_js_1.pct)(ctx.confidence) : '-';
     const confDelta = ctx.lastEvaluation?.confidenceDelta;
@@ -81,7 +128,6 @@ async function contextCommand(id, opts) {
     console.log(`${utils_js_1.c.bold}Confidence:${utils_js_1.c.reset} ${confStr}${deltaStr}`);
     console.log(`${utils_js_1.c.bold}Status:${utils_js_1.c.reset} ${ctx.status}`);
     console.log(`${utils_js_1.c.bold}Last Updated:${utils_js_1.c.reset} ${(0, utils_js_1.shortDate)(ctx.updatedAt)}`);
-    // Causal tree nodes (flat array from API)
     const nodes = ctx.causalTree?.nodes;
     if (nodes && nodes.length > 0) {
         (0, utils_js_1.header)('Causal Tree');
@@ -92,53 +138,42 @@ async function contextCommand(id, opts) {
             console.log(`${indent}${utils_js_1.c.cyan}${node.id}${utils_js_1.c.reset}  ${(0, utils_js_1.pad)(label, 40)} ${(0, utils_js_1.rpad)(prob, 5)}`);
         }
     }
-    // Fetch positions if Kalshi is configured (local only, no server)
     let positions = null;
     if ((0, kalshi_js_1.isKalshiConfigured)()) {
         try {
             positions = await (0, kalshi_js_1.getPositions)();
         }
-        catch {
-            // silently skip — positions are optional
-        }
+        catch { /* optional */ }
     }
     const posMap = new Map();
     if (positions) {
-        for (const p of positions) {
+        for (const p of positions)
             posMap.set(p.ticker, p);
-        }
     }
-    // Top edges (sorted by absolute edge size)
     const edges = ctx.edges;
     if (edges && edges.length > 0) {
-        (0, utils_js_1.header)('Top Edges (by edge size)');
+        (0, utils_js_1.header)('Top Edges');
         const sorted = [...edges].sort((a, b) => Math.abs(b.edge ?? b.edgeSize ?? 0) - Math.abs(a.edge ?? a.edgeSize ?? 0));
         for (const edge of sorted.slice(0, 10)) {
             const edgeSize = edge.edge ?? edge.edgeSize ?? 0;
             const edgeColor = edgeSize > 10 ? utils_js_1.c.green : edgeSize > 0 ? utils_js_1.c.yellow : utils_js_1.c.red;
             const mktPrice = edge.marketPrice ?? edge.currentPrice ?? 0;
             const title = edge.market || edge.marketTitle || edge.marketId || '?';
-            // Orderbook info (if enriched by rescan)
             const ob = edge.orderbook;
             const obStr = ob ? `  ${utils_js_1.c.dim}spread ${ob.spread}¢ ${ob.liquidityScore}${utils_js_1.c.reset}` : '';
-            // Position overlay (if user has Kalshi positions)
             const pos = posMap.get(edge.marketId);
             let posStr = '';
             if (pos) {
                 const pnl = pos.unrealized_pnl || 0;
                 const pnlColor = pnl > 0 ? utils_js_1.c.green : pnl < 0 ? utils_js_1.c.red : utils_js_1.c.dim;
                 const pnlFmt = pnl >= 0 ? `+$${(pnl / 100).toFixed(0)}` : `-$${(Math.abs(pnl) / 100).toFixed(0)}`;
-                posStr = `  ${utils_js_1.c.cyan}← ${pos.quantity}张 @ ${pos.average_price_paid}¢  ${pnlColor}${pnlFmt}${utils_js_1.c.reset}`;
+                posStr = `  ${utils_js_1.c.cyan}← ${pos.quantity}@${pos.average_price_paid}¢ ${pnlColor}${pnlFmt}${utils_js_1.c.reset}`;
             }
-            console.log(`  ${(0, utils_js_1.pad)(title, 35)}` +
-                `  ${(0, utils_js_1.rpad)(mktPrice.toFixed(0) + '¢', 5)}` +
+            console.log(`  ${(0, utils_js_1.pad)(title, 35)}  ${(0, utils_js_1.rpad)(mktPrice.toFixed(0) + '¢', 5)}` +
                 `  ${edgeColor}edge ${edgeSize > 0 ? '+' : ''}${edgeSize.toFixed(1)}${utils_js_1.c.reset}` +
-                `  ${utils_js_1.c.dim}${edge.venue || ''}${utils_js_1.c.reset}` +
-                obStr +
-                posStr);
+                `  ${utils_js_1.c.dim}${edge.venue || ''}${utils_js_1.c.reset}` + obStr + posStr);
         }
     }
-    // Last evaluation summary
     if (ctx.lastEvaluation?.summary) {
         (0, utils_js_1.header)('Last Evaluation');
         console.log(`  ${utils_js_1.c.dim}${(0, utils_js_1.shortDate)(ctx.lastEvaluation.evaluatedAt)} | model: ${ctx.lastEvaluation.model || ''}${utils_js_1.c.reset}`);
@@ -151,9 +186,18 @@ async function contextCommand(id, opts) {
             }
         }
     }
-    // Edge meta (last rescan time)
     if (ctx.edgeMeta?.lastRescanAt) {
         console.log(`\n${utils_js_1.c.dim}Last rescan: ${(0, utils_js_1.shortDate)(ctx.edgeMeta.lastRescanAt)}${utils_js_1.c.reset}`);
     }
     console.log('');
 }
+function timeAgo(iso) {
+    const ms = Date.now() - new Date(iso).getTime();
+    const min = Math.round(ms / 60000);
+    if (min < 60)
+        return `${min}m`;
+    const hr = Math.round(min / 60);
+    if (hr < 24)
+        return `${hr}h`;
+    return `${Math.round(hr / 24)}d`;
+}

package/dist/commands/delta.d.ts

@@ -0,0 +1,16 @@
+/**
+ * sf delta <thesisId> — Changes since a timestamp.
+ *
+ * Calls GET /api/thesis/:id/changes?since=<ts>
+ * Shows: confidence delta, new signals, node probability changes, edge movements.
+ */
+interface DeltaOpts {
+    since?: string;
+    hours?: string;
+    json?: boolean;
+    watch?: boolean;
+    apiKey?: string;
+    apiUrl?: string;
+}
+export declare function deltaCommand(thesisId: string, opts: DeltaOpts): Promise<void>;
+export {};

package/dist/commands/delta.js

@@ -0,0 +1,115 @@
+"use strict";
+/**
+ * sf delta <thesisId> — Changes since a timestamp.
+ *
+ * Calls GET /api/thesis/:id/changes?since=<ts>
+ * Shows: confidence delta, new signals, node probability changes, edge movements.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.deltaCommand = deltaCommand;
+const client_js_1 = require("../client.js");
+const utils_js_1 = require("../utils.js");
+async function deltaCommand(thesisId, opts) {
+    const client = new client_js_1.SFClient(opts.apiKey, opts.apiUrl);
+    // Resolve "since" — either explicit timestamp or --hours offset
+    const sinceDate = opts.since
+        ? new Date(opts.since)
+        : new Date(Date.now() - (parseInt(opts.hours || '6') * 3600000));
+    if (isNaN(sinceDate.getTime())) {
+        throw new Error(`Invalid timestamp: "${opts.since}". Use ISO 8601 format (e.g., 2026-03-28T14:00:00Z)`);
+    }
+    const run = async () => {
+        const since = sinceDate.toISOString();
+        const data = await client.getChanges(thesisId, since);
+        if (opts.json) {
+            console.log(JSON.stringify(data, null, 2));
+            return;
+        }
+        if (!data.changed) {
+            console.log(`${utils_js_1.c.dim}No changes since ${sinceDate.toLocaleString()}.${utils_js_1.c.reset}`);
+            return;
+        }
+        // Header
+        const id = (0, utils_js_1.shortId)(thesisId);
+        console.log();
+        console.log(`${utils_js_1.c.bold}${utils_js_1.c.cyan}Delta: ${id}${utils_js_1.c.reset}${utils_js_1.c.dim} — since ${sinceDate.toLocaleString()}${utils_js_1.c.reset}`);
+        console.log(`${utils_js_1.c.dim}${'─'.repeat(65)}${utils_js_1.c.reset}`);
+        // Confidence change
+        if (data.confidence !== undefined) {
+            const conf = Math.round(data.confidence * 100);
+            const prev = data.previousConfidence !== undefined ? Math.round(data.previousConfidence * 100) : null;
+            const delta = prev !== null ? conf - prev : null;
+            let deltaStr = '';
+            if (delta !== null) {
+                deltaStr = delta > 0 ? `${utils_js_1.c.green} (+${delta}%)${utils_js_1.c.reset}` : delta < 0 ? `${utils_js_1.c.red} (${delta}%)${utils_js_1.c.reset}` : `${utils_js_1.c.dim} (0%)${utils_js_1.c.reset}`;
+            }
+            console.log(`  Confidence: ${utils_js_1.c.bold}${conf}%${utils_js_1.c.reset}${deltaStr}`);
+        }
+        // Evaluation count
+        if (data.evaluationCount) {
+            console.log(`  Evaluations: ${data.evaluationCount} cycle(s)`);
+        }
+        // Updated nodes
+        const nodes = data.updatedNodes || [];
+        if (nodes.length > 0) {
+            console.log();
+            console.log(`  ${utils_js_1.c.bold}Node Changes (${nodes.length}):${utils_js_1.c.reset}`);
+            for (const n of nodes) {
+                const prob = Math.round((n.newProbability ?? n.newProb ?? 0) * 100);
+                const prev = n.previousProbability ?? n.prevProb;
+                let changeStr = '';
+                if (prev !== undefined && prev !== null) {
+                    const prevPct = Math.round(prev * 100);
+                    const d = prob - prevPct;
+                    changeStr = d > 0 ? ` ${utils_js_1.c.green}+${d}%${utils_js_1.c.reset}` : d < 0 ? ` ${utils_js_1.c.red}${d}%${utils_js_1.c.reset}` : '';
+                }
+                const label = n.label || n.nodeId || '?';
+                console.log(`    ${label.slice(0, 40).padEnd(40)} ${prob}%${changeStr}`);
+            }
+        }
+        // New signals
+        const signals = data.newSignals || [];
+        if (signals.length > 0) {
+            console.log();
+            console.log(`  ${utils_js_1.c.bold}New Signals (${signals.length}):${utils_js_1.c.reset}`);
+            for (const s of signals) {
+                const type = s.type || 'signal';
+                const content = (s.content || s.title || '').replace(/\n/g, ' ').slice(0, 70);
+                console.log(`    ${utils_js_1.c.dim}[${type}]${utils_js_1.c.reset} ${content}`);
+            }
+        }
+        // Edge changes
+        const edges = data.edgeChanges || data.edges || [];
+        if (edges.length > 0) {
+            console.log();
+            console.log(`  ${utils_js_1.c.bold}Edge Movements (${edges.length}):${utils_js_1.c.reset}`);
+            for (const e of edges.slice(0, 15)) {
+                const market = (e.market || e.marketId || '').slice(0, 35).padEnd(35);
+                const edge = e.edge ?? 0;
+                const prev = e.previousEdge ?? null;
+                const edgeStr = edge > 0 ? `+${edge}` : `${edge}`;
+                let changeStr = '';
+                if (prev !== null) {
+                    const d = edge - prev;
+                    changeStr = d > 0 ? ` ${utils_js_1.c.green}(+${d})${utils_js_1.c.reset}` : d < 0 ? ` ${utils_js_1.c.red}(${d})${utils_js_1.c.reset}` : '';
+                }
+                const color = edge > 0 ? utils_js_1.c.green : edge < 0 ? utils_js_1.c.red : utils_js_1.c.dim;
+                console.log(`    ${market} ${color}${edgeStr}${utils_js_1.c.reset}${changeStr}`);
+            }
+        }
+        console.log(`${utils_js_1.c.dim}${'─'.repeat(65)}${utils_js_1.c.reset}`);
+        console.log();
+    };
+    if (opts.watch) {
+        console.log(`${utils_js_1.c.dim}Watching for changes every 60s... (Ctrl+C to stop)${utils_js_1.c.reset}`);
+        // eslint-disable-next-line no-constant-condition
+        while (true) {
+            await run();
+            await new Promise(r => setTimeout(r, 60_000));
+            console.clear();
+        }
+    }
+    else {
+        await run();
+    }
+}

package/dist/commands/edges.d.ts

@@ -14,6 +14,10 @@
 interface EdgesOpts {
     json?: boolean;
     limit?: string;
+    thesis?: string;
+    minEdge?: string;
+    minLiquidity?: string;
+    sort?: string;
     apiKey?: string;
     apiUrl?: string;
 }

package/dist/commands/edges.js

@@ -20,17 +20,30 @@ const utils_js_1 = require("../utils.js");
 async function edgesCommand(opts) {
     const client = new client_js_1.SFClient(opts.apiKey, opts.apiUrl);
     const limit = parseInt(opts.limit || '20');
-    // ── Step 1: Fetch all active theses ────────────────────────────────────────
-    console.log(`${utils_js_1.c.dim}Fetching theses...${utils_js_1.c.reset}`);
-    const data = await client.listTheses();
-    const rawTheses = data.theses || data;
-    const theses = (Array.isArray(rawTheses) ? rawTheses : []).filter((t) => t.status === 'active');
+    const minEdge = opts.minEdge ? parseInt(opts.minEdge) : 0;
+    const minLiq = opts.minLiquidity?.toLowerCase() || '';
+    const sortBy = opts.sort || 'edge';
+    // Support both letter grades (A/B/C/D) and word grades (high/medium/low)
+    const liqRank = { a: 4, high: 4, b: 3, medium: 3, c: 2, low: 2, d: 1 };
+    // ── Step 1: Fetch theses (or single thesis) ────────────────────────────────
+    let theses;
+    if (opts.thesis) {
+        // Single thesis mode — skip listing, fetch context directly
+        console.log(`${utils_js_1.c.dim}Fetching edges for thesis ${opts.thesis}...${utils_js_1.c.reset}`);
+        theses = [{ id: opts.thesis }];
+    }
+    else {
+        console.log(`${utils_js_1.c.dim}Fetching theses...${utils_js_1.c.reset}`);
+        const data = await client.listTheses();
+        const rawTheses = data.theses || data;
+        theses = (Array.isArray(rawTheses) ? rawTheses : []).filter((t) => t.status === 'active');
+    }
     if (theses.length === 0) {
         console.log(`${utils_js_1.c.yellow}No active theses found.${utils_js_1.c.reset} Create one: sf create "your thesis"`);
         return;
     }
     // ── Step 2: Fetch context for each thesis (parallel) ───────────────────────
-    console.log(`${utils_js_1.c.dim}Fetching edges from ${theses.length} theses...${utils_js_1.c.reset}`);
+    console.log(`${utils_js_1.c.dim}Fetching edges from ${theses.length} ${theses.length === 1 ? 'thesis' : 'theses'}...${utils_js_1.c.reset}`);
     const allEdges = [];
     const contextPromises = theses.map(async (t) => {
         try {
@@ -76,6 +89,13 @@ async function edgesCommand(opts) {
         }
     }
     let merged = Array.from(deduped.values());
+    // ── Step 3b: Apply filters ─────────────────────────────────────────────────
+    if (minEdge > 0) {
+        merged = merged.filter(e => Math.abs(e.edge) >= minEdge);
+    }
+    if (minLiq && liqRank[minLiq]) {
+        merged = merged.filter(e => e.liquidityScore && (liqRank[e.liquidityScore.toLowerCase()] || 0) >= liqRank[minLiq]);
+    }
     // ── Step 4: Fetch positions (optional) ─────────────────────────────────────
     let positions = null;
     if ((0, kalshi_js_1.isKalshiConfigured)()) {
@@ -107,12 +127,18 @@ async function edgesCommand(opts) {
             }
         }
     }
-    // ── Step 5: Sort by executableEdge (or edge) descending ────────────────────
-    merged.sort((a, b) => {
-        const aVal = a.executableEdge !== null ? a.executableEdge : a.edge;
-        const bVal = b.executableEdge !== null ? b.executableEdge : b.edge;
-        return Math.abs(bVal) - Math.abs(aVal);
-    });
+    // ── Step 5: Sort ────────────────────────────────────────────────────────────
+    if (sortBy === 'spread') {
+        merged.sort((a, b) => (a.spread ?? 999) - (b.spread ?? 999));
+    }
+    else {
+        // Default: sort by executableEdge (or edge) descending
+        merged.sort((a, b) => {
+            const aVal = a.executableEdge !== null ? a.executableEdge : a.edge;
+            const bVal = b.executableEdge !== null ? b.executableEdge : b.edge;
+            return Math.abs(bVal) - Math.abs(aVal);
+        });
+    }
     // Apply limit
     const display = merged.slice(0, limit);
     // ── Step 6: JSON output ────────────────────────────────────────────────────

package/dist/commands/login.d.ts

@@ -0,0 +1,9 @@
+/**
+ * sf login — Browser-based authentication.
+ *
+ * Opens the browser, user logs in via magic link, CLI receives an API key.
+ * Zero manual key configuration needed.
+ */
+export declare function loginCommand(opts: {
+    apiUrl?: string;
+}): Promise<void>;

package/dist/commands/login.js

@@ -0,0 +1,98 @@
+"use strict";
+/**
+ * sf login — Browser-based authentication.
+ *
+ * Opens the browser, user logs in via magic link, CLI receives an API key.
+ * Zero manual key configuration needed.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.loginCommand = loginCommand;
+const crypto_1 = require("crypto");
+const config_js_1 = require("../config.js");
+const utils_js_1 = require("../utils.js");
+const SF_API_URL = process.env.SF_API_URL || 'https://simplefunctions.dev';
+async function loginCommand(opts) {
+    const apiUrl = opts.apiUrl || (0, config_js_1.loadConfig)().apiUrl || SF_API_URL;
+    // Only block if the CONFIG FILE has an API key (not env vars)
+    const fileConfig = (0, config_js_1.loadFileConfig)();
+    if (fileConfig.apiKey) {
+        console.log(`\n  ${utils_js_1.c.dim}Already configured with API key ${fileConfig.apiKey.slice(0, 12)}...${utils_js_1.c.reset}`);
+        console.log(`  ${utils_js_1.c.dim}Run ${utils_js_1.c.cyan}sf setup --reset${utils_js_1.c.dim} first to reconfigure.${utils_js_1.c.reset}\n`);
+        return;
+    }
+    // Generate session token
+    const sessionToken = (0, crypto_1.randomBytes)(32).toString('base64url');
+    // Register session on server
+    console.log(`\n  ${utils_js_1.c.dim}Registering login session...${utils_js_1.c.reset}`);
+    try {
+        const res = await fetch(`${apiUrl}/api/auth/cli`, {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify({ sessionToken }),
+        });
+        if (!res.ok) {
+            const data = await res.json().catch(() => ({}));
+            console.error(`  ${utils_js_1.c.red}Failed to create session: ${data.error || res.status}${utils_js_1.c.reset}`);
+            return;
+        }
+    }
+    catch (err) {
+        console.error(`  ${utils_js_1.c.red}Could not reach ${apiUrl}${utils_js_1.c.reset}`);
+        return;
+    }
+    // Open browser
+    const loginUrl = `${apiUrl}/auth/cli?token=${sessionToken}`;
+    console.log(`\n  ${utils_js_1.c.bold}Opening browser...${utils_js_1.c.reset}`);
+    console.log(`  ${utils_js_1.c.dim}${loginUrl}${utils_js_1.c.reset}\n`);
+    try {
+        const { exec } = await import('child_process');
+        const platform = process.platform;
+        const cmd = platform === 'darwin' ? 'open'
+            : platform === 'win32' ? 'start'
+                : 'xdg-open';
+        exec(`${cmd} "${loginUrl}"`);
+    }
+    catch {
+        console.log(`  ${utils_js_1.c.dim}Could not open browser. Visit the URL above manually.${utils_js_1.c.reset}`);
+    }
+    // Poll for completion
+    console.log(`  ${utils_js_1.c.dim}Waiting for login...${utils_js_1.c.reset}`);
+    const maxWait = 5 * 60 * 1000; // 5 minutes
+    const pollInterval = 2000;
+    const startTime = Date.now();
+    while (Date.now() - startTime < maxWait) {
+        await new Promise(r => setTimeout(r, pollInterval));
+        try {
+            const res = await fetch(`${apiUrl}/api/auth/cli/poll?token=${sessionToken}`);
+            const data = await res.json();
+            if (data.status === 'ready' && data.apiKey) {
+                // Save to config
+                (0, config_js_1.saveConfig)({
+                    ...fileConfig,
+                    apiKey: data.apiKey,
+                    apiUrl: apiUrl !== SF_API_URL ? apiUrl : undefined,
+                });
+                console.log(`\n  ${utils_js_1.c.green}✓${utils_js_1.c.reset} ${utils_js_1.c.bold}Authenticated!${utils_js_1.c.reset}`);
+                console.log(`  ${utils_js_1.c.dim}API key saved to ~/.sf/config.json${utils_js_1.c.reset}`);
+                console.log(`\n  ${utils_js_1.c.dim}OpenRouter & Tavily are proxied through ${apiUrl}${utils_js_1.c.reset}`);
+                console.log(`  ${utils_js_1.c.dim}No additional API keys needed.${utils_js_1.c.reset}`);
+                console.log(`\n  ${utils_js_1.c.cyan}sf context${utils_js_1.c.reset}        ${utils_js_1.c.dim}market intelligence${utils_js_1.c.reset}`);
+                console.log(`  ${utils_js_1.c.cyan}sf agent${utils_js_1.c.reset} ${utils_js_1.c.dim}<thesis>${utils_js_1.c.reset}  ${utils_js_1.c.dim}start the agent${utils_js_1.c.reset}`);
+                console.log(`  ${utils_js_1.c.cyan}sf setup --check${utils_js_1.c.reset}   ${utils_js_1.c.dim}verify config${utils_js_1.c.reset}`);
+                console.log();
+                return;
+            }
+            if (data.status === 'expired') {
+                console.error(`\n  ${utils_js_1.c.red}Session expired. Run ${utils_js_1.c.cyan}sf login${utils_js_1.c.red} again.${utils_js_1.c.reset}\n`);
+                return;
+            }
+            // status === 'pending' — keep polling
+            process.stdout.write('.');
+        }
+        catch {
+            // Network error — keep trying
+            process.stdout.write('x');
+        }
+    }
+    console.error(`\n  ${utils_js_1.c.red}Timed out waiting for login. Run ${utils_js_1.c.cyan}sf login${utils_js_1.c.red} again.${utils_js_1.c.reset}\n`);
+}

package/dist/commands/setup.js

@@ -210,10 +210,13 @@ async function showCheck() {
     }
     // OpenRouter
     if (config.openrouterKey) {
-        ok(`OPENROUTER_KEY    ${dim(mask(config.openrouterKey))}`);
+        ok(`OPENROUTER        ${dim(mask(config.openrouterKey))} (direct)`);
+    }
+    else if (config.apiKey) {
+        ok(`OPENROUTER        ${dim('proxied via SimpleFunctions')}`);
     }
     else {
-        fail(`OPENROUTER_KEY    not configured (agent unavailable)`);
+        fail(`OPENROUTER        not configured (run sf login or set key)`);
     }
     // Kalshi
     if (config.kalshiKeyId && config.kalshiPrivateKeyPath) {
@@ -231,7 +234,10 @@ async function showCheck() {
     }
     // Tavily
     if (config.tavilyKey) {
-        ok(`TAVILY            ${dim(mask(config.tavilyKey))}`);
+        ok(`TAVILY            ${dim(mask(config.tavilyKey))} (direct)`);
+    }
+    else if (config.apiKey) {
+        ok(`TAVILY            ${dim('proxied via SimpleFunctions')}`);
     }
     else {
         info(`${dim('○')} TAVILY            ${dim('skipped')}`);

package/dist/index.js

@@ -57,6 +57,8 @@ const book_js_1 = require("./commands/book.js");
 const prompt_js_1 = require("./commands/prompt.js");
 const augment_js_1 = require("./commands/augment.js");
 const telegram_js_1 = require("./commands/telegram.js");
+const delta_js_1 = require("./commands/delta.js");
+const login_js_1 = require("./commands/login.js");
 const query_js_1 = require("./commands/query.js");
 const markets_js_1 = require("./commands/markets.js");
 const x_js_1 = require("./commands/x.js");
@@ -72,7 +74,8 @@ const GROUPED_HELP = `
         sf <command> --help for detailed options
 
 \x1b[1mSetup\x1b[22m
-  \x1b[36msetup\x1b[39m                     Interactive config wizard
+  \x1b[36mlogin\x1b[39m                      Browser login (recommended)
+  \x1b[36msetup\x1b[39m                      Interactive config wizard (power users)
   \x1b[36msetup --check\x1b[39m              Show config status
   \x1b[36msetup --polymarket\x1b[39m         Configure Polymarket wallet
 
@@ -128,6 +131,7 @@ const GROUPED_HELP = `
 
 \x1b[1mInfo\x1b[22m
   \x1b[36mfeed\x1b[39m                       Evaluation history stream
+  \x1b[36mdelta\x1b[39m <id>                  Changes since timestamp
   \x1b[36mmilestones\x1b[39m                 Upcoming Kalshi events
   \x1b[36mschedule\x1b[39m                   Exchange status
   \x1b[36mannouncements\x1b[39m              Exchange announcements
@@ -234,7 +238,7 @@ async function interactiveEntry() {
     console.log();
 }
 // ── Pre-action guard: check configuration ────────────────────────────────────
-const NO_CONFIG_COMMANDS = new Set(['setup', 'help', 'scan', 'explore', 'query', 'context', 'markets', 'milestones', 'forecast', 'settlements', 'balance', 'orders', 'fills', 'schedule', 'announcements', 'history', 'liquidity', 'book', 'prompt', 'sf']);
+const NO_CONFIG_COMMANDS = new Set(['setup', 'login', 'help', 'scan', 'explore', 'query', 'context', 'markets', 'milestones', 'forecast', 'settlements', 'balance', 'orders', 'fills', 'schedule', 'announcements', 'history', 'liquidity', 'book', 'prompt', 'sf']);
 program.hook('preAction', (thisCommand, actionCommand) => {
     const cmdName = actionCommand.name();
     if (NO_CONFIG_COMMANDS.has(cmdName))
@@ -250,9 +254,10 @@ program.hook('preAction', (thisCommand, actionCommand) => {
         }
         else {
             console.log();
-            console.log('  This command needs an API key. Two options:');
-            console.log('    1. \x1b[36msf setup\x1b[39m          Interactive wizard (2 min)');
-            console.log('    2. \x1b[36msf --api-key KEY\x1b[39m  Pass inline');
+            console.log('  This command needs an API key. Three options:');
+            console.log('    1. \x1b[36msf login\x1b[39m           Browser login (30 sec, recommended)');
+            console.log('    2. \x1b[36msf setup\x1b[39m           Interactive wizard (2 min)');
+            console.log('    3. \x1b[36msf --api-key KEY\x1b[39m   Pass inline');
             console.log();
             console.log('  \x1b[2mDon\'t have a key? Try \x1b[36msf scan "oil"\x1b[22m\x1b[2m — works without login.\x1b[22m');
         }
@@ -274,6 +279,14 @@ program
     .action(async (opts) => {
     await run(() => (0, setup_js_1.setupCommand)({ check: opts.check, reset: opts.reset, key: opts.key, enableTrading: opts.enableTrading, disableTrading: opts.disableTrading, kalshi: opts.kalshi, polymarket: opts.polymarket }));
 });
+// ── sf login ─────────────────────────────────────────────────────────────────
+program
+    .command('login')
+    .description('Browser-based login (recommended — no API keys needed)')
+    .action(async (_opts, cmd) => {
+    const g = cmd.optsWithGlobals();
+    await run(() => (0, login_js_1.loginCommand)({ apiUrl: g.apiUrl }));
+});
 // ── sf list ──────────────────────────────────────────────────────────────────
 program
     .command('list')
@@ -359,11 +372,19 @@ program
     .description('Top edges across all theses — what to trade now')
     .option('--json', 'JSON output for agents')
     .option('--limit <n>', 'Max edges to show', '20')
+    .option('--thesis <id>', 'Filter to a single thesis')
+    .option('--min-edge <cents>', 'Minimum absolute edge size in cents')
+    .option('--min-liquidity <grade>', 'Minimum liquidity (high/medium/low or A/B/C)')
+    .option('--sort <by>', 'Sort by: edge (default), spread')
     .action(async (opts, cmd) => {
     const g = cmd.optsWithGlobals();
     await run(() => (0, edges_js_1.edgesCommand)({
         json: opts.json,
         limit: opts.limit,
+        thesis: opts.thesis,
+        minEdge: opts.minEdge,
+        minLiquidity: opts.minLiquidity,
+        sort: opts.sort,
         apiKey: g.apiKey,
         apiUrl: g.apiUrl,
     }));
@@ -499,6 +520,18 @@ program
     const g = cmd.optsWithGlobals();
     await run(() => (0, feed_js_1.feedCommand)({ ...opts, apiKey: g.apiKey, apiUrl: g.apiUrl }));
 });
+// ── sf delta <thesisId> ───────────────────────────────────────────────────────
+program
+    .command('delta <thesisId>')
+    .description('Changes since a timestamp — confidence, nodes, signals, edges')
+    .option('--since <timestamp>', 'ISO 8601 start time (e.g., 2026-03-28T14:00:00Z)')
+    .option('--hours <n>', 'Hours to look back (default 6)', '6')
+    .option('--watch', 'Continuously poll every 60s')
+    .option('--json', 'JSON output')
+    .action(async (thesisId, opts, cmd) => {
+    const g = cmd.optsWithGlobals();
+    await run(() => (0, delta_js_1.deltaCommand)(thesisId, { ...opts, apiKey: g.apiKey, apiUrl: g.apiUrl }));
+});
 // ── sf whatif <thesisId> ──────────────────────────────────────────────────────
 program
     .command('whatif <thesisId>')

package/dist/telegram/agent-bridge.js

@@ -242,12 +242,24 @@ async function buildTools(sfClient, thesisId, latestContext) {
             parameters: Type.Object({ query: Type.String({ description: 'Search query' }) }),
             execute: async (_id, p) => {
                 const tavilyKey = process.env.TAVILY_API_KEY || config.tavilyKey;
-                if (!tavilyKey)
-                    return { content: [{ type: 'text', text: 'Tavily not configured.' }], details: {} };
-                const res = await fetch('https://api.tavily.com/search', {
-                    method: 'POST', headers: { 'Content-Type': 'application/json' },
-                    body: JSON.stringify({ api_key: tavilyKey, query: p.query, max_results: 3, search_depth: 'basic', include_answer: true }),
-                });
+                const tgSfKey = config.apiKey || process.env.SF_API_KEY;
+                const tgSfUrl = config.apiUrl || process.env.SF_API_URL || 'https://simplefunctions.dev';
+                const canProxySearch = !tavilyKey && tgSfKey;
+                if (!tavilyKey && !canProxySearch)
+                    return { content: [{ type: 'text', text: 'Web search not available. Run sf login or set TAVILY_API_KEY.' }], details: {} };
+                let res;
+                if (tavilyKey) {
+                    res = await fetch('https://api.tavily.com/search', {
+                        method: 'POST', headers: { 'Content-Type': 'application/json' },
+                        body: JSON.stringify({ api_key: tavilyKey, query: p.query, max_results: 3, search_depth: 'basic', include_answer: true }),
+                    });
+                }
+                else {
+                    res = await fetch(`${tgSfUrl}/api/proxy/search`, {
+                        method: 'POST', headers: { 'Content-Type': 'application/json', 'Authorization': `Bearer ${tgSfKey}` },
+                        body: JSON.stringify({ query: p.query, max_results: 3, search_depth: 'basic', include_answer: true }),
+                    });
+                }
                 if (!res.ok)
                     return { content: [{ type: 'text', text: `Search failed: ${res.status}` }], details: {} };
                 const data = await res.json();
@@ -407,9 +419,13 @@ async function getOrCreateAgent(sfClient, session) {
     const piAi = await import('@mariozechner/pi-ai');
     const { getModel } = piAi;
     const config = (0, config_js_1.loadConfig)();
-    const openrouterKey = config.openrouterKey || process.env.OPENROUTER_API_KEY;
+    const directOrKey = config.openrouterKey || process.env.OPENROUTER_API_KEY;
+    const sfApiKey = config.apiKey || process.env.SF_API_KEY;
+    const sfApiUrl = config.apiUrl || process.env.SF_API_URL || 'https://simplefunctions.dev';
+    const tgUseProxy = !directOrKey && !!sfApiKey;
+    const openrouterKey = directOrKey || sfApiKey;
     if (!openrouterKey)
-        throw new Error('OpenRouter not configured. Use slash commands or run sf setup.');
+        throw new Error('Need API key. Run sf login or sf setup.');
     const ctx = await sfClient.getContext(session.thesisId);
     const conf = typeof ctx.confidence === 'number' ? Math.round(ctx.confidence * 100) : 50;
     const tools = await buildTools(sfClient, session.thesisId, ctx);
@@ -427,6 +443,8 @@ async function getOrCreateAgent(sfClient, session) {
             supportsImages: true, supportsTools: true,
         };
     }
+    if (tgUseProxy)
+        model.baseUrl = `${sfApiUrl}/api/proxy`;
     const edgesSummary = (ctx.edges || [])
         .sort((a, b) => Math.abs(b.edge) - Math.abs(a.edge))
         .slice(0, 5)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@spfunctions/cli",
-  "version": "1.7.10",
+  "version": "1.7.12",
   "description": "Prediction market intelligence CLI. Causal thesis model, 24/7 Kalshi/Polymarket scan, live orderbook, edge detection. Interactive agent mode with tool calling.",
   "bin": {
     "sf": "./dist/index.js"